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 74 68 65 rticular the the
0d50: 20 63 6f 6e 74 65 6e 74 20 6f 66 20 66 72 65 65 content of free
0d60: 6c 69 73 74 20 6c 65 61 66 0a 2a 2a 20 70 61 67 list leaf.** pag
0d70: 65 73 20 63 61 6e 20 62 65 20 63 68 61 6e 67 65 es can be change
0d80: 64 20 61 72 62 69 74 61 72 69 6c 79 20 77 69 74 d arbitarily wit
0d90: 68 6f 75 74 20 65 66 66 65 63 74 69 6e 67 20 74 hout effecting t
0da0: 68 65 20 6c 6f 67 69 63 61 6c 20 65 71 75 69 76 he logical equiv
0db0: 61 6c 65 6e 63 65 0a 2a 2a 20 6f 66 20 74 68 65 alence.** of the
0dc0: 20 64 61 74 61 62 61 73 65 2e 0a 2a 2a 20 0a 2a database..** .*
0dd0: 2a 20 28 37 29 20 41 74 20 61 6e 79 20 74 69 6d * (7) At any tim
0de0: 65 2c 20 69 66 20 61 6e 79 20 73 75 62 73 65 74 e, if any subset
0df0: 2c 20 69 6e 63 6c 75 64 69 6e 67 20 74 68 65 20 , including the
0e00: 65 6d 70 74 79 20 73 65 74 20 61 6e 64 20 74 68 empty set and th
0e10: 65 20 74 6f 74 61 6c 20 73 65 74 2c 0a 2a 2a 20 e total set,.**
0e20: 20 20 20 20 6f 66 20 74 68 65 20 75 6e 73 79 6e of the unsyn
0e30: 63 65 64 20 63 68 61 6e 67 65 73 20 74 6f 20 61 ced changes to a
0e40: 20 72 6f 6c 6c 62 61 63 6b 20 6a 6f 75 72 6e 61 rollback journa
0e50: 6c 20 61 72 65 20 72 65 6d 6f 76 65 64 20 61 6e l are removed an
0e60: 64 20 74 68 65 20 0a 2a 2a 20 20 20 20 20 6a 6f d the .** jo
0e70: 75 72 6e 61 6c 20 69 73 20 72 6f 6c 6c 65 64 20 urnal is rolled
0e80: 62 61 63 6b 2c 20 74 68 65 20 72 65 73 75 6c 74 back, the result
0e90: 69 6e 67 20 64 61 74 61 62 61 73 65 20 66 69 6c ing database fil
0ea0: 65 20 77 69 6c 6c 20 62 65 20 6c 6f 67 69 63 61 e will be logica
0eb0: 6c 0a 2a 2a 20 20 20 20 20 65 71 75 69 76 61 6c l.** equival
0ec0: 65 6e 74 20 74 6f 20 74 68 65 20 64 61 74 61 62 ent to the datab
0ed0: 61 73 65 20 66 69 6c 65 20 61 74 20 74 68 65 20 ase file at the
0ee0: 62 65 67 69 6e 6e 69 6e 67 20 6f 66 20 74 68 65 beginning of the
0ef0: 20 74 72 61 6e 73 61 63 74 69 6f 6e 2e 0a 2a 2a transaction..**
0f00: 20 0a 2a 2a 20 28 38 29 20 57 68 65 6e 20 61 20 .** (8) When a
0f10: 74 72 61 6e 73 61 63 74 69 6f 6e 20 69 73 20 72 transaction is r
0f20: 6f 6c 6c 65 64 20 62 61 63 6b 2c 20 74 68 65 20 olled back, the
0f30: 78 54 72 75 6e 63 61 74 65 20 6d 65 74 68 6f 64 xTruncate method
0f40: 20 6f 66 20 74 68 65 20 56 46 53 0a 2a 2a 20 20 of the VFS.**
0f50: 20 20 20 69 73 20 63 61 6c 6c 65 64 20 74 6f 20 is called to
0f60: 72 65 73 74 6f 72 65 20 74 68 65 20 64 61 74 61 restore the data
0f70: 62 61 73 65 20 66 69 6c 65 20 74 6f 20 74 68 65 base file to the
0f80: 20 73 61 6d 65 20 73 69 7a 65 20 69 74 20 77 61 same size it wa
0f90: 73 20 61 74 0a 2a 2a 20 20 20 20 20 74 68 65 20 s at.** the
0fa0: 62 65 67 69 6e 6e 69 6e 67 20 6f 66 20 74 68 65 beginning of the
0fb0: 20 74 72 61 6e 73 61 63 74 69 6f 6e 2e 20 20 28 transaction. (
0fc0: 49 6e 20 73 6f 6d 65 20 56 46 53 65 73 2c 20 74 In some VFSes, t
0fd0: 68 65 20 78 54 72 75 6e 63 61 74 65 0a 2a 2a 20 he xTruncate.**
0fe0: 20 20 20 20 6d 65 74 68 6f 64 20 69 73 20 61 20 method is a
0ff0: 6e 6f 2d 6f 70 2c 20 62 75 74 20 74 68 61 74 20 no-op, but that
1000: 64 6f 65 73 20 6e 6f 74 20 63 68 61 6e 67 65 20 does not change
1010: 74 68 65 20 66 61 63 74 20 74 68 65 20 53 51 4c the fact the SQL
1020: 69 74 65 20 77 69 6c 6c 0a 2a 2a 20 20 20 20 20 ite will.**
1030: 69 6e 76 6f 6b 65 20 69 74 2e 29 0a 2a 2a 20 0a invoke it.).** .
1040: 2a 2a 20 28 39 29 20 57 68 65 6e 65 76 65 72 20 ** (9) Whenever
1050: 74 68 65 20 64 61 74 61 62 61 73 65 20 66 69 6c the database fil
1060: 65 20 69 73 20 6d 6f 64 69 66 69 65 64 2c 20 61 e is modified, a
1070: 74 20 6c 65 61 73 74 20 6f 6e 65 20 62 69 74 20 t least one bit
1080: 69 6e 20 74 68 65 20 72 61 6e 67 65 0a 2a 2a 20 in the range.**
1090: 20 20 20 20 6f 66 20 62 79 74 65 73 20 66 72 6f of bytes fro
10a0: 6d 20 32 34 20 74 68 72 6f 75 67 68 20 33 39 20 m 24 through 39
10b0: 69 6e 63 6c 75 73 69 76 65 20 77 69 6c 6c 20 62 inclusive will b
10c0: 65 20 63 68 61 6e 67 65 64 20 70 72 69 6f 72 20 e changed prior
10d0: 74 6f 20 72 65 6c 65 61 73 69 6e 67 0a 2a 2a 20 to releasing.**
10e0: 20 20 20 20 74 68 65 20 45 58 43 4c 55 53 49 56 the EXCLUSIV
10f0: 45 20 6c 6f 63 6b 2c 20 74 68 75 73 20 73 69 67 E lock, thus sig
1100: 6e 61 6c 69 6e 67 20 6f 74 68 65 72 20 63 6f 6e naling other con
1110: 6e 65 63 74 69 6f 6e 73 20 6f 6e 20 74 68 65 20 nections on the
1120: 73 61 6d 65 0a 2a 2a 20 20 20 20 20 64 61 74 61 same.** data
1130: 62 61 73 65 20 74 6f 20 66 6c 75 73 68 20 74 68 base to flush th
1140: 65 69 72 20 63 61 63 68 65 73 2e 0a 2a 2a 0a 2a eir caches..**.*
1150: 2a 20 28 31 30 29 20 54 68 65 20 70 61 74 74 65 * (10) The patte
1160: 72 6e 20 6f 66 20 62 69 74 73 20 69 6e 20 62 79 rn of bits in by
1170: 74 65 73 20 32 34 20 74 68 72 6f 75 67 68 20 33 tes 24 through 3
1180: 39 20 73 68 61 6c 6c 20 6e 6f 74 20 72 65 70 65 9 shall not repe
1190: 61 74 20 69 6e 20 6c 65 73 73 0a 2a 2a 20 20 20 at in less.**
11a0: 20 20 20 74 68 61 6e 20 6f 6e 65 20 62 69 6c 6c than one bill
11b0: 69 6f 6e 20 74 72 61 6e 73 61 63 74 69 6f 6e 73 ion transactions
11c0: 2e 0a 2a 2a 0a 2a 2a 20 28 31 31 29 20 41 20 64 ..**.** (11) A d
11d0: 61 74 61 62 61 73 65 20 66 69 6c 65 20 69 73 20 atabase file is
11e0: 77 65 6c 6c 2d 66 6f 72 6d 65 64 20 61 74 20 74 well-formed at t
11f0: 68 65 20 62 65 67 69 6e 6e 69 6e 67 20 61 6e 64 he beginning and
1200: 20 61 74 20 74 68 65 20 63 6f 6e 63 6c 75 73 69 at the conclusi
1210: 6f 6e 0a 2a 2a 20 20 20 20 20 20 6f 66 20 65 76 on.** of ev
1220: 65 72 79 20 74 72 61 6e 73 61 63 74 69 6f 6e 2e ery transaction.
1230: 0a 2a 2a 0a 2a 2a 20 28 31 32 29 20 41 6e 20 45 .**.** (12) An E
1240: 58 43 4c 55 53 49 56 45 20 6c 6f 63 6b 20 69 73 XCLUSIVE lock is
1250: 20 68 65 6c 64 20 6f 6e 20 74 68 65 20 64 61 74 held on the dat
1260: 61 62 61 73 65 20 66 69 6c 65 20 77 68 65 6e 20 abase file when
1270: 77 72 69 74 69 6e 67 20 74 6f 0a 2a 2a 20 20 20 writing to.**
1280: 20 20 20 74 68 65 20 64 61 74 61 62 61 73 65 20 the database
1290: 66 69 6c 65 2e 0a 2a 2a 0a 2a 2a 20 28 31 33 29 file..**.** (13)
12a0: 20 41 20 53 48 41 52 45 44 20 6c 6f 63 6b 20 69 A SHARED lock i
12b0: 73 20 68 65 6c 64 20 6f 6e 20 74 68 65 20 64 61 s held on the da
12c0: 74 61 62 61 73 65 20 66 69 6c 65 20 77 68 69 6c tabase file whil
12d0: 65 20 72 65 61 64 69 6e 67 20 61 6e 79 0a 2a 2a e reading any.**
12e0: 20 20 20 20 20 20 63 6f 6e 74 65 6e 74 20 6f 75 content ou
12f0: 74 20 6f 66 20 74 68 65 20 64 61 74 61 62 61 73 t of the databas
1300: 65 20 66 69 6c 65 2e 0a 2a 2a 0a 2a 2a 2a 2a 2a e 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 2a 2f 0a 0a 2f 2a 0a 2a *********/../*.*
1360: 2a 20 4d 61 63 72 6f 73 20 66 6f 72 20 74 72 6f * Macros for tro
1370: 75 62 6c 65 73 68 6f 6f 74 69 6e 67 2e 20 20 4e ubleshooting. N
1380: 6f 72 6d 61 6c 6c 79 20 74 75 72 6e 65 64 20 6f ormally turned o
1390: 66 66 0a 2a 2f 0a 23 69 66 20 30 0a 69 6e 74 20 ff.*/.#if 0.int
13a0: 73 71 6c 69 74 65 33 50 61 67 65 72 54 72 61 63 sqlite3PagerTrac
13b0: 65 3d 31 3b 20 20 2f 2a 20 54 72 75 65 20 74 6f e=1; /* True to
13c0: 20 65 6e 61 62 6c 65 20 74 72 61 63 69 6e 67 20 enable tracing
13d0: 2a 2f 0a 23 64 65 66 69 6e 65 20 73 71 6c 69 74 */.#define sqlit
13e0: 65 33 44 65 62 75 67 50 72 69 6e 74 66 20 70 72 e3DebugPrintf pr
13f0: 69 6e 74 66 0a 23 64 65 66 69 6e 65 20 50 41 47 intf.#define PAG
1400: 45 52 54 52 41 43 45 28 58 29 20 20 20 20 20 69 ERTRACE(X) i
1410: 66 28 20 73 71 6c 69 74 65 33 50 61 67 65 72 54 f( sqlite3PagerT
1420: 72 61 63 65 20 29 7b 20 73 71 6c 69 74 65 33 44 race ){ sqlite3D
1430: 65 62 75 67 50 72 69 6e 74 66 20 58 3b 20 7d 0a ebugPrintf X; }.
1440: 23 65 6c 73 65 0a 23 64 65 66 69 6e 65 20 50 41 #else.#define PA
1450: 47 45 52 54 52 41 43 45 28 58 29 0a 23 65 6e 64 GERTRACE(X).#end
1460: 69 66 0a 0a 2f 2a 0a 2a 2a 20 54 68 65 20 66 6f if../*.** The fo
1470: 6c 6c 6f 77 69 6e 67 20 74 77 6f 20 6d 61 63 72 llowing two macr
1480: 6f 73 20 61 72 65 20 75 73 65 64 20 77 69 74 68 os are used with
1490: 69 6e 20 74 68 65 20 50 41 47 45 52 54 52 41 43 in the PAGERTRAC
14a0: 45 28 29 20 6d 61 63 72 6f 73 20 61 62 6f 76 65 E() macros above
14b0: 0a 2a 2a 20 74 6f 20 70 72 69 6e 74 20 6f 75 74 .** to print out
14c0: 20 66 69 6c 65 2d 64 65 73 63 72 69 70 74 6f 72 file-descriptor
14d0: 73 2e 20 0a 2a 2a 0a 2a 2a 20 50 41 47 45 52 49 s. .**.** PAGERI
14e0: 44 28 29 20 74 61 6b 65 73 20 61 20 70 6f 69 6e D() takes a poin
14f0: 74 65 72 20 74 6f 20 61 20 50 61 67 65 72 20 73 ter to a Pager s
1500: 74 72 75 63 74 20 61 73 20 69 74 73 20 61 72 67 truct as its arg
1510: 75 6d 65 6e 74 2e 20 54 68 65 0a 2a 2a 20 61 73 ument. The.** as
1520: 73 6f 63 69 61 74 65 64 20 66 69 6c 65 2d 64 65 sociated file-de
1530: 73 63 72 69 70 74 6f 72 20 69 73 20 72 65 74 75 scriptor is retu
1540: 72 6e 65 64 2e 20 46 49 4c 45 48 41 4e 44 4c 45 rned. FILEHANDLE
1550: 49 44 28 29 20 74 61 6b 65 73 20 61 6e 20 73 71 ID() takes an sq
1560: 6c 69 74 65 33 5f 66 69 6c 65 0a 2a 2a 20 73 74 lite3_file.** st
1570: 72 75 63 74 20 61 73 20 69 74 73 20 61 72 67 75 ruct as its argu
1580: 6d 65 6e 74 2e 0a 2a 2f 0a 23 64 65 66 69 6e 65 ment..*/.#define
1590: 20 50 41 47 45 52 49 44 28 70 29 20 28 28 69 6e PAGERID(p) ((in
15a0: 74 29 28 70 2d 3e 66 64 29 29 0a 23 64 65 66 69 t)(p->fd)).#defi
15b0: 6e 65 20 46 49 4c 45 48 41 4e 44 4c 45 49 44 28 ne FILEHANDLEID(
15c0: 66 64 29 20 28 28 69 6e 74 29 66 64 29 0a 0a 2f fd) ((int)fd)../
15d0: 2a 0a 2a 2a 20 54 68 65 20 50 61 67 65 72 2e 65 *.** The Pager.e
15e0: 53 74 61 74 65 20 76 61 72 69 61 62 6c 65 20 73 State variable s
15f0: 74 6f 72 65 73 20 74 68 65 20 63 75 72 72 65 6e tores the curren
1600: 74 20 27 73 74 61 74 65 27 20 6f 66 20 61 20 70 t 'state' of a p
1610: 61 67 65 72 2e 20 41 0a 2a 2a 20 70 61 67 65 72 ager. A.** pager
1620: 20 6d 61 79 20 62 65 20 69 6e 20 61 6e 79 20 6f may be in any o
1630: 6e 65 20 6f 66 20 74 68 65 20 73 65 76 65 6e 20 ne of the seven
1640: 73 74 61 74 65 73 20 73 68 6f 77 6e 20 69 6e 20 states shown in
1650: 74 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 0a 2a 2a the following.**
1660: 20 73 74 61 74 65 20 64 69 61 67 72 61 6d 2e 0a state diagram..
1670: 2a 2a 0a 2a 2a 20 20 20 20 20 20 20 20 20 20 20 **.**
1680: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
1690: 20 4f 50 45 4e 20 3c 2d 2d 2d 2d 2d 2d 2b 2d 2d OPEN <------+--
16a0: 2d 2d 2d 2d 2b 0a 2a 2a 20 20 20 20 20 20 20 20 ----+.**
16b0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
16c0: 20 20 20 20 20 20 7c 20 20 20 20 20 20 20 20 20 |
16d0: 7c 20 20 20 20 20 20 7c 0a 2a 2a 20 20 20 20 20 | |.**
16e0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
16f0: 20 20 20 20 20 20 20 20 20 56 20 20 20 20 20 20 V
1700: 20 20 20 7c 20 20 20 20 20 20 7c 0a 2a 2a 20 20 | |.**
1710: 20 20 20 20 20 20 20 20 20 20 20 20 20 2b 2d 2d +--
1720: 2d 2d 2d 2d 2d 2d 2d 3e 20 52 45 41 44 45 52 2d -------> READER-
1730: 2d 2d 2d 2d 2d 2d 2b 20 20 20 20 20 20 7c 0a 2a ------+ |.*
1740: 2a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 *
1750: 7c 20 20 20 20 20 20 20 20 20 20 20 20 20 20 7c | |
1760: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
1770: 7c 0a 2a 2a 20 20 20 20 20 20 20 20 20 20 20 20 |.**
1780: 20 20 20 7c 20 20 20 20 20 20 20 20 20 20 20 20 |
1790: 20 20 56 20 20 20 20 20 20 20 20 20 20 20 20 20 V
17a0: 20 20 20 7c 0a 2a 2a 20 20 20 20 20 20 20 20 20 |.**
17b0: 20 20 20 20 20 20 7c 3c 2d 2d 2d 2d 2d 2d 2d 57 |<-------W
17c0: 52 49 54 45 52 5f 4c 4f 43 4b 45 44 2d 2d 2d 2d RITER_LOCKED----
17d0: 2d 2d 3e 20 45 52 52 4f 52 0a 2a 2a 20 20 20 20 --> ERROR.**
17e0: 20 20 20 20 20 20 20 20 20 20 20 7c 20 20 20 20 |
17f0: 20 20 20 20 20 20 20 20 20 20 7c 20 20 20 20 20 |
1800: 20 20 20 20 20 20 20 20 20 20 20 5e 20 20 0a 2a ^ .*
1810: 2a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 *
1820: 7c 20 20 20 20 20 20 20 20 20 20 20 20 20 20 56 | V
1830: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
1840: 7c 0a 2a 2a 20 20 20 20 20 20 20 20 20 20 20 20 |.**
1850: 20 20 20 7c 3c 2d 2d 2d 2d 2d 2d 57 52 49 54 45 |<------WRITE
1860: 52 5f 43 41 43 48 45 4d 4f 44 2d 2d 2d 2d 2d 2d R_CACHEMOD------
1870: 2d 2d 3e 7c 0a 2a 2a 20 20 20 20 20 20 20 20 20 -->|.**
1880: 20 20 20 20 20 20 7c 20 20 20 20 20 20 20 20 20 |
1890: 20 20 20 20 20 7c 20 20 20 20 20 20 20 20 20 20 |
18a0: 20 20 20 20 20 20 7c 0a 2a 2a 20 20 20 20 20 20 |.**
18b0: 20 20 20 20 20 20 20 20 20 7c 20 20 20 20 20 20 |
18c0: 20 20 20 20 20 20 20 20 56 20 20 20 20 20 20 20 V
18d0: 20 20 20 20 20 20 20 20 20 7c 0a 2a 2a 20 20 20 |.**
18e0: 20 20 20 20 20 20 20 20 20 20 20 20 7c 3c 2d 2d |<--
18f0: 2d 2d 2d 2d 2d 57 52 49 54 45 52 5f 44 42 4d 4f -----WRITER_DBMO
1900: 44 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 3e 7c 0a 2a 2a D---------->|.**
1910: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 7c |
1920: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 7c 20 |
1930: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 7c |
1940: 0a 2a 2a 20 20 20 20 20 20 20 20 20 20 20 20 20 .**
1950: 20 20 7c 20 20 20 20 20 20 20 20 20 20 20 20 20 |
1960: 20 56 20 20 20 20 20 20 20 20 20 20 20 20 20 20 V
1970: 20 20 7c 0a 2a 2a 20 20 20 20 20 20 20 20 20 20 |.**
1980: 20 20 20 20 20 2b 3c 2d 2d 2d 2d 2d 2d 57 52 49 +<------WRI
1990: 54 45 52 5f 46 49 4e 49 53 48 45 44 2d 2d 2d 2d TER_FINISHED----
19a0: 2d 2d 2d 2d 3e 2b 0a 2a 2a 0a 2a 2a 0a 2a 2a 20 ---->+.**.**.**
19b0: 4c 69 73 74 20 6f 66 20 73 74 61 74 65 20 74 72 List of state tr
19c0: 61 6e 73 69 74 69 6f 6e 73 20 61 6e 64 20 74 68 ansitions and th
19d0: 65 20 43 20 5b 66 75 6e 63 74 69 6f 6e 5d 20 74 e C [function] t
19e0: 68 61 74 20 70 65 72 66 6f 72 6d 73 20 65 61 63 hat performs eac
19f0: 68 3a 0a 2a 2a 20 0a 2a 2a 20 20 20 4f 50 45 4e h:.** .** OPEN
1a00: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2d 3e ->
1a10: 20 52 45 41 44 45 52 20 20 20 20 20 20 20 20 20 READER
1a20: 20 20 20 20 20 5b 73 71 6c 69 74 65 33 50 61 67 [sqlite3Pag
1a30: 65 72 53 68 61 72 65 64 4c 6f 63 6b 5d 0a 2a 2a erSharedLock].**
1a40: 20 20 20 52 45 41 44 45 52 20 20 20 20 20 20 20 READER
1a50: 20 20 20 20 20 2d 3e 20 4f 50 45 4e 20 20 20 20 -> OPEN
1a60: 20 20 20 20 20 20 20 20 20 20 20 20 5b 70 61 67 [pag
1a70: 65 72 5f 75 6e 6c 6f 63 6b 5d 0a 2a 2a 0a 2a 2a er_unlock].**.**
1a80: 20 20 20 52 45 41 44 45 52 20 20 20 20 20 20 20 READER
1a90: 20 20 20 20 20 2d 3e 20 57 52 49 54 45 52 5f 4c -> WRITER_L
1aa0: 4f 43 4b 45 44 20 20 20 20 20 20 20 5b 73 71 6c OCKED [sql
1ab0: 69 74 65 33 50 61 67 65 72 42 65 67 69 6e 5d 0a ite3PagerBegin].
1ac0: 2a 2a 20 20 20 57 52 49 54 45 52 5f 4c 4f 43 4b ** WRITER_LOCK
1ad0: 45 44 20 20 20 20 20 2d 3e 20 57 52 49 54 45 52 ED -> WRITER
1ae0: 5f 43 41 43 48 45 4d 4f 44 20 20 20 20 20 5b 70 _CACHEMOD [p
1af0: 61 67 65 72 5f 6f 70 65 6e 5f 6a 6f 75 72 6e 61 ager_open_journa
1b00: 6c 5d 0a 2a 2a 20 20 20 57 52 49 54 45 52 5f 43 l].** WRITER_C
1b10: 41 43 48 45 4d 4f 44 20 20 20 2d 3e 20 57 52 49 ACHEMOD -> WRI
1b20: 54 45 52 5f 44 42 4d 4f 44 20 20 20 20 20 20 20 TER_DBMOD
1b30: 20 5b 73 79 6e 63 4a 6f 75 72 6e 61 6c 5d 0a 2a [syncJournal].*
1b40: 2a 20 20 20 57 52 49 54 45 52 5f 44 42 4d 4f 44 * WRITER_DBMOD
1b50: 20 20 20 20 20 20 2d 3e 20 57 52 49 54 45 52 5f -> WRITER_
1b60: 46 49 4e 49 53 48 45 44 20 20 20 20 20 5b 73 71 FINISHED [sq
1b70: 6c 69 74 65 33 50 61 67 65 72 43 6f 6d 6d 69 74 lite3PagerCommit
1b80: 50 68 61 73 65 4f 6e 65 5d 0a 2a 2a 20 20 20 57 PhaseOne].** W
1b90: 52 49 54 45 52 5f 2a 2a 2a 20 20 20 20 20 20 20 RITER_***
1ba0: 20 2d 3e 20 52 45 41 44 45 52 20 20 20 20 20 20 -> READER
1bb0: 20 20 20 20 20 20 20 20 5b 70 61 67 65 72 5f 65 [pager_e
1bc0: 6e 64 5f 74 72 61 6e 73 61 63 74 69 6f 6e 5d 0a nd_transaction].
1bd0: 2a 2a 0a 2a 2a 20 20 20 57 52 49 54 45 52 5f 2a **.** WRITER_*
1be0: 2a 2a 20 20 20 20 20 20 20 20 2d 3e 20 45 52 52 ** -> ERR
1bf0: 4f 52 20 20 20 20 20 20 20 20 20 20 20 20 20 20 OR
1c00: 20 5b 70 61 67 65 72 5f 65 72 72 6f 72 5d 0a 2a [pager_error].*
1c10: 2a 20 20 20 45 52 52 4f 52 20 20 20 20 20 20 20 * ERROR
1c20: 20 20 20 20 20 20 2d 3e 20 4f 50 45 4e 20 20 20 -> OPEN
1c30: 20 20 20 20 20 20 20 20 20 20 20 20 20 5b 70 61 [pa
1c40: 67 65 72 5f 75 6e 6c 6f 63 6b 5d 0a 2a 2a 20 0a ger_unlock].** .
1c50: 2a 2a 0a 2a 2a 20 20 4f 50 45 4e 3a 0a 2a 2a 0a **.** OPEN:.**.
1c60: 2a 2a 20 20 20 20 54 68 65 20 70 61 67 65 72 20 ** The pager
1c70: 73 74 61 72 74 73 20 75 70 20 69 6e 20 74 68 69 starts up in thi
1c80: 73 20 73 74 61 74 65 2e 20 4e 6f 74 68 69 6e 67 s state. Nothing
1c90: 20 69 73 20 67 75 61 72 61 6e 74 65 65 64 20 69 is guaranteed i
1ca0: 6e 20 74 68 69 73 0a 2a 2a 20 20 20 20 73 74 61 n this.** sta
1cb0: 74 65 20 2d 20 74 68 65 20 66 69 6c 65 20 6d 61 te - the file ma
1cc0: 79 20 6f 72 20 6d 61 79 20 6e 6f 74 20 62 65 20 y or may not be
1cd0: 6c 6f 63 6b 65 64 20 61 6e 64 20 74 68 65 20 64 locked and the d
1ce0: 61 74 61 62 61 73 65 20 73 69 7a 65 20 69 73 0a atabase size is.
1cf0: 2a 2a 20 20 20 20 75 6e 6b 6e 6f 77 6e 2e 20 54 ** unknown. T
1d00: 68 65 20 64 61 74 61 62 61 73 65 20 6d 61 79 20 he database may
1d10: 6e 6f 74 20 62 65 20 72 65 61 64 20 6f 72 20 77 not be read or w
1d20: 72 69 74 74 65 6e 2e 0a 2a 2a 0a 2a 2a 20 20 20 ritten..**.**
1d30: 20 2a 20 4e 6f 20 72 65 61 64 20 6f 72 20 77 72 * No read or wr
1d40: 69 74 65 20 74 72 61 6e 73 61 63 74 69 6f 6e 20 ite transaction
1d50: 69 73 20 61 63 74 69 76 65 2e 0a 2a 2a 20 20 20 is active..**
1d60: 20 2a 20 41 6e 79 20 6c 6f 63 6b 2c 20 6f 72 20 * Any lock, or
1d70: 6e 6f 20 6c 6f 63 6b 20 61 74 20 61 6c 6c 2c 20 no lock at all,
1d80: 6d 61 79 20 62 65 20 68 65 6c 64 20 6f 6e 20 74 may be held on t
1d90: 68 65 20 64 61 74 61 62 61 73 65 20 66 69 6c 65 he database file
1da0: 2e 0a 2a 2a 20 20 20 20 2a 20 54 68 65 20 64 62 ..** * The db
1db0: 53 69 7a 65 2c 20 64 62 4f 72 69 67 53 69 7a 65 Size, dbOrigSize
1dc0: 20 61 6e 64 20 64 62 46 69 6c 65 53 69 7a 65 20 and dbFileSize
1dd0: 76 61 72 69 61 62 6c 65 73 20 6d 61 79 20 6e 6f variables may no
1de0: 74 20 62 65 20 74 72 75 73 74 65 64 2e 0a 2a 2a t be trusted..**
1df0: 0a 2a 2a 20 20 52 45 41 44 45 52 3a 0a 2a 2a 0a .** READER:.**.
1e00: 2a 2a 20 20 20 20 49 6e 20 74 68 69 73 20 73 74 ** In this st
1e10: 61 74 65 20 61 6c 6c 20 74 68 65 20 72 65 71 75 ate all the requ
1e20: 69 72 65 6d 65 6e 74 73 20 66 6f 72 20 72 65 61 irements for rea
1e30: 64 69 6e 67 20 74 68 65 20 64 61 74 61 62 61 73 ding the databas
1e40: 65 20 69 6e 20 0a 2a 2a 20 20 20 20 72 6f 6c 6c e in .** roll
1e50: 62 61 63 6b 20 28 6e 6f 6e 2d 57 41 4c 29 20 6d back (non-WAL) m
1e60: 6f 64 65 20 61 72 65 20 6d 65 74 2e 20 55 6e 6c ode are met. Unl
1e70: 65 73 73 20 74 68 65 20 70 61 67 65 72 20 69 73 ess the pager is
1e80: 20 28 6f 72 20 72 65 63 65 6e 74 6c 79 0a 2a 2a (or recently.**
1e90: 20 20 20 20 77 61 73 29 20 69 6e 20 65 78 63 6c was) in excl
1ea0: 75 73 69 76 65 2d 6c 6f 63 6b 69 6e 67 20 6d 6f usive-locking mo
1eb0: 64 65 2c 20 61 20 75 73 65 72 2d 6c 65 76 65 6c de, a user-level
1ec0: 20 72 65 61 64 20 74 72 61 6e 73 61 63 74 69 6f read transactio
1ed0: 6e 20 69 73 20 0a 2a 2a 20 20 20 20 6f 70 65 6e n is .** open
1ee0: 2e 20 54 68 65 20 64 61 74 61 62 61 73 65 20 73 . The database s
1ef0: 69 7a 65 20 69 73 20 6b 6e 6f 77 6e 20 69 6e 20 ize is known in
1f00: 74 68 69 73 20 73 74 61 74 65 2e 0a 2a 2a 0a 2a this state..**.*
1f10: 2a 20 20 20 20 41 20 63 6f 6e 6e 65 63 74 69 6f * A connectio
1f20: 6e 20 72 75 6e 6e 69 6e 67 20 77 69 74 68 20 6c n running with l
1f30: 6f 63 6b 69 6e 67 5f 6d 6f 64 65 3d 6e 6f 72 6d ocking_mode=norm
1f40: 61 6c 20 65 6e 74 65 72 73 20 74 68 69 73 20 73 al enters this s
1f50: 74 61 74 65 20 77 68 65 6e 0a 2a 2a 20 20 20 20 tate when.**
1f60: 69 74 20 6f 70 65 6e 73 20 61 20 72 65 61 64 2d it opens a read-
1f70: 74 72 61 6e 73 61 63 74 69 6f 6e 20 6f 6e 20 74 transaction on t
1f80: 68 65 20 64 61 74 61 62 61 73 65 20 61 6e 64 20 he database and
1f90: 72 65 74 75 72 6e 73 20 74 6f 20 73 74 61 74 65 returns to state
1fa0: 0a 2a 2a 20 20 20 20 4f 50 45 4e 20 61 66 74 65 .** OPEN afte
1fb0: 72 20 74 68 65 20 72 65 61 64 2d 74 72 61 6e 73 r the read-trans
1fc0: 61 63 74 69 6f 6e 20 69 73 20 63 6f 6d 70 6c 65 action is comple
1fd0: 74 65 64 2e 20 48 6f 77 65 76 65 72 20 61 20 63 ted. However a c
1fe0: 6f 6e 6e 65 63 74 69 6f 6e 0a 2a 2a 20 20 20 20 onnection.**
1ff0: 72 75 6e 6e 69 6e 67 20 69 6e 20 6c 6f 63 6b 69 running in locki
2000: 6e 67 5f 6d 6f 64 65 3d 65 78 63 6c 75 73 69 76 ng_mode=exclusiv
2010: 65 20 28 69 6e 63 6c 75 64 69 6e 67 20 74 65 6d e (including tem
2020: 70 20 64 61 74 61 62 61 73 65 73 29 20 72 65 6d p databases) rem
2030: 61 69 6e 73 20 69 6e 0a 2a 2a 20 20 20 20 74 68 ains in.** th
2040: 69 73 20 73 74 61 74 65 20 65 76 65 6e 20 61 66 is state even af
2050: 74 65 72 20 74 68 65 20 72 65 61 64 2d 74 72 61 ter the read-tra
2060: 6e 73 61 63 74 69 6f 6e 20 69 73 20 63 6c 6f 73 nsaction is clos
2070: 65 64 2e 20 54 68 65 20 6f 6e 6c 79 20 77 61 79 ed. The only way
2080: 0a 2a 2a 20 20 20 20 61 20 6c 6f 63 6b 69 6e 67 .** a locking
2090: 5f 6d 6f 64 65 3d 65 78 63 6c 75 73 69 76 65 20 _mode=exclusive
20a0: 63 6f 6e 6e 65 63 74 69 6f 6e 20 63 61 6e 20 74 connection can t
20b0: 72 61 6e 73 69 74 69 6f 6e 20 66 72 6f 6d 20 52 ransition from R
20c0: 45 41 44 45 52 20 74 6f 20 4f 50 45 4e 0a 2a 2a EADER to OPEN.**
20d0: 20 20 20 20 69 73 20 76 69 61 20 74 68 65 20 45 is via the E
20e0: 52 52 4f 52 20 73 74 61 74 65 20 28 73 65 65 20 RROR state (see
20f0: 62 65 6c 6f 77 29 2e 0a 2a 2a 20 0a 2a 2a 20 20 below)..** .**
2100: 20 20 2a 20 41 20 72 65 61 64 20 74 72 61 6e 73 * A read trans
2110: 61 63 74 69 6f 6e 20 6d 61 79 20 62 65 20 61 63 action may be ac
2120: 74 69 76 65 20 28 62 75 74 20 61 20 77 72 69 74 tive (but a writ
2130: 65 2d 74 72 61 6e 73 61 63 74 69 6f 6e 20 63 61 e-transaction ca
2140: 6e 6e 6f 74 29 2e 0a 2a 2a 20 20 20 20 2a 20 41 nnot)..** * A
2150: 20 53 48 41 52 45 44 20 6f 72 20 67 72 65 61 74 SHARED or great
2160: 65 72 20 6c 6f 63 6b 20 69 73 20 68 65 6c 64 20 er lock is held
2170: 6f 6e 20 74 68 65 20 64 61 74 61 62 61 73 65 20 on the database
2180: 66 69 6c 65 2e 0a 2a 2a 20 20 20 20 2a 20 54 68 file..** * Th
2190: 65 20 64 62 53 69 7a 65 20 76 61 72 69 61 62 6c e dbSize variabl
21a0: 65 20 6d 61 79 20 62 65 20 74 72 75 73 74 65 64 e may be trusted
21b0: 20 28 65 76 65 6e 20 69 66 20 61 20 75 73 65 72 (even if a user
21c0: 2d 6c 65 76 65 6c 20 72 65 61 64 20 0a 2a 2a 20 -level read .**
21d0: 20 20 20 20 20 74 72 61 6e 73 61 63 74 69 6f 6e transaction
21e0: 20 69 73 20 6e 6f 74 20 61 63 74 69 76 65 29 2e is not active).
21f0: 20 54 68 65 20 64 62 4f 72 69 67 53 69 7a 65 20 The dbOrigSize
2200: 61 6e 64 20 64 62 46 69 6c 65 53 69 7a 65 20 76 and dbFileSize v
2210: 61 72 69 61 62 6c 65 73 0a 2a 2a 20 20 20 20 20 ariables.**
2220: 20 6d 61 79 20 6e 6f 74 20 62 65 20 74 72 75 73 may not be trus
2230: 74 65 64 20 61 74 20 74 68 69 73 20 70 6f 69 6e ted at this poin
2240: 74 2e 0a 2a 2a 20 20 20 20 2a 20 49 66 20 74 68 t..** * If th
2250: 65 20 64 61 74 61 62 61 73 65 20 69 73 20 61 20 e database is a
2260: 57 41 4c 20 64 61 74 61 62 61 73 65 2c 20 74 68 WAL database, th
2270: 65 6e 20 74 68 65 20 57 41 4c 20 63 6f 6e 6e 65 en the WAL conne
2280: 63 74 69 6f 6e 20 69 73 20 6f 70 65 6e 2e 0a 2a ction is open..*
2290: 2a 20 20 20 20 2a 20 45 76 65 6e 20 69 66 20 61 * * Even if a
22a0: 20 72 65 61 64 2d 74 72 61 6e 73 61 63 74 69 6f read-transactio
22b0: 6e 20 69 73 20 6e 6f 74 20 6f 70 65 6e 2c 20 69 n is not open, i
22c0: 74 20 69 73 20 67 75 61 72 61 6e 74 65 65 64 20 t is guaranteed
22d0: 74 68 61 74 20 0a 2a 2a 20 20 20 20 20 20 74 68 that .** th
22e0: 65 72 65 20 69 73 20 6e 6f 20 68 6f 74 2d 6a 6f ere is no hot-jo
22f0: 75 72 6e 61 6c 20 69 6e 20 74 68 65 20 66 69 6c urnal in the fil
2300: 65 2d 73 79 73 74 65 6d 2e 0a 2a 2a 0a 2a 2a 20 e-system..**.**
2310: 20 57 52 49 54 45 52 5f 4c 4f 43 4b 45 44 3a 0a WRITER_LOCKED:.
2320: 2a 2a 0a 2a 2a 20 20 20 20 54 68 65 20 70 61 67 **.** The pag
2330: 65 72 20 6d 6f 76 65 73 20 74 6f 20 74 68 69 73 er moves to this
2340: 20 73 74 61 74 65 20 66 72 6f 6d 20 52 45 41 44 state from READ
2350: 45 52 20 77 68 65 6e 20 61 20 77 72 69 74 65 2d ER when a write-
2360: 74 72 61 6e 73 61 63 74 69 6f 6e 0a 2a 2a 20 20 transaction.**
2370: 20 20 69 73 20 66 69 72 73 74 20 6f 70 65 6e 65 is first opene
2380: 64 20 6f 6e 20 74 68 65 20 64 61 74 61 62 61 73 d on the databas
2390: 65 2e 20 49 6e 20 57 52 49 54 45 52 5f 4c 4f 43 e. In WRITER_LOC
23a0: 4b 45 44 20 73 74 61 74 65 2c 20 61 6c 6c 20 6c KED state, all l
23b0: 6f 63 6b 73 20 0a 2a 2a 20 20 20 20 72 65 71 75 ocks .** requ
23c0: 69 72 65 64 20 74 6f 20 73 74 61 72 74 20 61 20 ired to start a
23d0: 77 72 69 74 65 2d 74 72 61 6e 73 61 63 74 69 6f write-transactio
23e0: 6e 20 61 72 65 20 68 65 6c 64 2c 20 62 75 74 20 n are held, but
23f0: 6e 6f 20 61 63 74 75 61 6c 20 0a 2a 2a 20 20 20 no actual .**
2400: 20 6d 6f 64 69 66 69 63 61 74 69 6f 6e 73 20 74 modifications t
2410: 6f 20 74 68 65 20 63 61 63 68 65 20 6f 72 20 64 o the cache or d
2420: 61 74 61 62 61 73 65 20 68 61 76 65 20 74 61 6b atabase have tak
2430: 65 6e 20 70 6c 61 63 65 2e 0a 2a 2a 0a 2a 2a 20 en place..**.**
2440: 20 20 20 49 6e 20 72 6f 6c 6c 62 61 63 6b 20 6d In rollback m
2450: 6f 64 65 2c 20 61 20 52 45 53 45 52 56 45 44 20 ode, a RESERVED
2460: 6f 72 20 28 69 66 20 74 68 65 20 74 72 61 6e 73 or (if the trans
2470: 61 63 74 69 6f 6e 20 77 61 73 20 6f 70 65 6e 65 action was opene
2480: 64 20 77 69 74 68 20 0a 2a 2a 20 20 20 20 42 45 d with .** BE
2490: 47 49 4e 20 45 58 43 4c 55 53 49 56 45 29 20 45 GIN EXCLUSIVE) E
24a0: 58 43 4c 55 53 49 56 45 20 6c 6f 63 6b 20 69 73 XCLUSIVE lock is
24b0: 20 6f 62 74 61 69 6e 65 64 20 6f 6e 20 74 68 65 obtained on the
24c0: 20 64 61 74 61 62 61 73 65 20 66 69 6c 65 20 77 database file w
24d0: 68 65 6e 0a 2a 2a 20 20 20 20 6d 6f 76 69 6e 67 hen.** moving
24e0: 20 74 6f 20 74 68 69 73 20 73 74 61 74 65 2c 20 to this state,
24f0: 62 75 74 20 74 68 65 20 6a 6f 75 72 6e 61 6c 20 but the journal
2500: 66 69 6c 65 20 69 73 20 6e 6f 74 20 77 72 69 74 file is not writ
2510: 74 65 6e 20 74 6f 20 6f 72 20 6f 70 65 6e 65 64 ten to or opened
2520: 20 0a 2a 2a 20 20 20 20 74 6f 20 69 6e 20 74 68 .** to in th
2530: 69 73 20 73 74 61 74 65 2e 20 49 66 20 74 68 65 is state. If the
2540: 20 74 72 61 6e 73 61 63 74 69 6f 6e 20 69 73 20 transaction is
2550: 63 6f 6d 6d 69 74 74 65 64 20 6f 72 20 72 6f 6c committed or rol
2560: 6c 65 64 20 62 61 63 6b 20 77 68 69 6c 65 20 0a led back while .
2570: 2a 2a 20 20 20 20 69 6e 20 57 52 49 54 45 52 5f ** in WRITER_
2580: 4c 4f 43 4b 45 44 20 73 74 61 74 65 2c 20 61 6c LOCKED state, al
2590: 6c 20 74 68 61 74 20 69 73 20 72 65 71 75 69 72 l that is requir
25a0: 65 64 20 69 73 20 74 6f 20 75 6e 6c 6f 63 6b 20 ed is to unlock
25b0: 74 68 65 20 64 61 74 61 62 61 73 65 20 0a 2a 2a the database .**
25c0: 20 20 20 20 66 69 6c 65 2e 0a 2a 2a 0a 2a 2a 20 file..**.**
25d0: 20 20 20 49 4e 20 57 41 4c 20 6d 6f 64 65 2c 20 IN WAL mode,
25e0: 57 61 6c 42 65 67 69 6e 57 72 69 74 65 54 72 61 WalBeginWriteTra
25f0: 6e 73 61 63 74 69 6f 6e 28 29 20 69 73 20 63 61 nsaction() is ca
2600: 6c 6c 65 64 20 74 6f 20 6c 6f 63 6b 20 74 68 65 lled to lock the
2610: 20 6c 6f 67 20 66 69 6c 65 2e 0a 2a 2a 20 20 20 log file..**
2620: 20 49 66 20 74 68 65 20 63 6f 6e 6e 65 63 74 69 If the connecti
2630: 6f 6e 20 69 73 20 72 75 6e 6e 69 6e 67 20 77 69 on is running wi
2640: 74 68 20 6c 6f 63 6b 69 6e 67 5f 6d 6f 64 65 3d th locking_mode=
2650: 65 78 63 6c 75 73 69 76 65 2c 20 61 6e 20 61 74 exclusive, an at
2660: 74 65 6d 70 74 0a 2a 2a 20 20 20 20 69 73 20 6d tempt.** is m
2670: 61 64 65 20 74 6f 20 6f 62 74 61 69 6e 20 61 6e ade to obtain an
2680: 20 45 58 43 4c 55 53 49 56 45 20 6c 6f 63 6b 20 EXCLUSIVE lock
2690: 6f 6e 20 74 68 65 20 64 61 74 61 62 61 73 65 20 on the database
26a0: 66 69 6c 65 2e 0a 2a 2a 0a 2a 2a 20 20 20 20 2a file..**.** *
26b0: 20 41 20 77 72 69 74 65 20 74 72 61 6e 73 61 63 A write transac
26c0: 74 69 6f 6e 20 69 73 20 61 63 74 69 76 65 2e 0a tion is active..
26d0: 2a 2a 20 20 20 20 2a 20 49 66 20 74 68 65 20 63 ** * If the c
26e0: 6f 6e 6e 65 63 74 69 6f 6e 20 69 73 20 6f 70 65 onnection is ope
26f0: 6e 20 69 6e 20 72 6f 6c 6c 62 61 63 6b 2d 6d 6f n in rollback-mo
2700: 64 65 2c 20 61 20 52 45 53 45 52 56 45 44 20 6f de, a RESERVED o
2710: 72 20 67 72 65 61 74 65 72 20 0a 2a 2a 20 20 20 r greater .**
2720: 20 20 20 6c 6f 63 6b 20 69 73 20 68 65 6c 64 20 lock is held
2730: 6f 6e 20 74 68 65 20 64 61 74 61 62 61 73 65 20 on the database
2740: 66 69 6c 65 2e 0a 2a 2a 20 20 20 20 2a 20 49 66 file..** * If
2750: 20 74 68 65 20 63 6f 6e 6e 65 63 74 69 6f 6e 20 the connection
2760: 69 73 20 6f 70 65 6e 20 69 6e 20 57 41 4c 2d 6d is open in WAL-m
2770: 6f 64 65 2c 20 61 20 57 41 4c 20 77 72 69 74 65 ode, a WAL write
2780: 20 74 72 61 6e 73 61 63 74 69 6f 6e 0a 2a 2a 20 transaction.**
2790: 20 20 20 20 20 69 73 20 6f 70 65 6e 20 28 69 2e is open (i.
27a0: 65 2e 20 73 71 6c 69 74 65 33 57 61 6c 42 65 67 e. sqlite3WalBeg
27b0: 69 6e 57 72 69 74 65 54 72 61 6e 73 61 63 74 69 inWriteTransacti
27c0: 6f 6e 28 29 20 68 61 73 20 62 65 65 6e 20 73 75 on() has been su
27d0: 63 63 65 73 73 66 75 6c 6c 79 0a 2a 2a 20 20 20 ccessfully.**
27e0: 20 20 20 63 61 6c 6c 65 64 29 2e 0a 2a 2a 20 20 called)..**
27f0: 20 20 2a 20 54 68 65 20 64 62 53 69 7a 65 2c 20 * The dbSize,
2800: 64 62 4f 72 69 67 53 69 7a 65 20 61 6e 64 20 64 dbOrigSize and d
2810: 62 46 69 6c 65 53 69 7a 65 20 76 61 72 69 61 62 bFileSize variab
2820: 6c 65 73 20 61 72 65 20 61 6c 6c 20 76 61 6c 69 les are all vali
2830: 64 2e 0a 2a 2a 20 20 20 20 2a 20 54 68 65 20 63 d..** * The c
2840: 6f 6e 74 65 6e 74 73 20 6f 66 20 74 68 65 20 70 ontents of the p
2850: 61 67 65 72 20 63 61 63 68 65 20 68 61 76 65 20 ager cache have
2860: 6e 6f 74 20 62 65 65 6e 20 6d 6f 64 69 66 69 65 not been modifie
2870: 64 2e 0a 2a 2a 20 20 20 20 2a 20 54 68 65 20 6a d..** * The j
2880: 6f 75 72 6e 61 6c 20 66 69 6c 65 20 6d 61 79 20 ournal file may
2890: 6f 72 20 6d 61 79 20 6e 6f 74 20 62 65 20 6f 70 or may not be op
28a0: 65 6e 2e 0a 2a 2a 20 20 20 20 2a 20 4e 6f 74 68 en..** * Noth
28b0: 69 6e 67 20 28 6e 6f 74 20 65 76 65 6e 20 74 68 ing (not even th
28c0: 65 20 66 69 72 73 74 20 68 65 61 64 65 72 29 20 e first header)
28d0: 68 61 73 20 62 65 65 6e 20 77 72 69 74 74 65 6e has been written
28e0: 20 74 6f 20 74 68 65 20 6a 6f 75 72 6e 61 6c 2e to the journal.
28f0: 0a 2a 2a 0a 2a 2a 20 20 57 52 49 54 45 52 5f 43 .**.** WRITER_C
2900: 41 43 48 45 4d 4f 44 3a 0a 2a 2a 0a 2a 2a 20 20 ACHEMOD:.**.**
2910: 20 20 41 20 70 61 67 65 72 20 6d 6f 76 65 73 20 A pager moves
2920: 66 72 6f 6d 20 57 52 49 54 45 52 5f 4c 4f 43 4b from WRITER_LOCK
2930: 45 44 20 73 74 61 74 65 20 74 6f 20 74 68 69 73 ED state to this
2940: 20 73 74 61 74 65 20 77 68 65 6e 20 61 20 70 61 state when a pa
2950: 67 65 20 69 73 0a 2a 2a 20 20 20 20 66 69 72 73 ge is.** firs
2960: 74 20 6d 6f 64 69 66 69 65 64 20 62 79 20 74 68 t modified by th
2970: 65 20 75 70 70 65 72 20 6c 61 79 65 72 2e 20 49 e upper layer. I
2980: 6e 20 72 6f 6c 6c 62 61 63 6b 20 6d 6f 64 65 20 n rollback mode
2990: 74 68 65 20 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 the journal file
29a0: 0a 2a 2a 20 20 20 20 69 73 20 6f 70 65 6e 65 64 .** is opened
29b0: 20 28 69 66 20 69 74 20 69 73 20 6e 6f 74 20 61 (if it is not a
29c0: 6c 72 65 61 64 79 20 6f 70 65 6e 29 20 61 6e 64 lready open) and
29d0: 20 61 20 68 65 61 64 65 72 20 77 72 69 74 74 65 a header writte
29e0: 6e 20 74 6f 20 74 68 65 0a 2a 2a 20 20 20 20 73 n to the.** s
29f0: 74 61 72 74 20 6f 66 20 69 74 2e 20 54 68 65 20 tart of it. The
2a00: 64 61 74 61 62 61 73 65 20 66 69 6c 65 20 6f 6e database file on
2a10: 20 64 69 73 6b 20 68 61 73 20 6e 6f 74 20 62 65 disk has not be
2a20: 65 6e 20 6d 6f 64 69 66 69 65 64 2e 0a 2a 2a 0a en modified..**.
2a30: 2a 2a 20 20 20 20 2a 20 41 20 77 72 69 74 65 20 ** * A write
2a40: 74 72 61 6e 73 61 63 74 69 6f 6e 20 69 73 20 61 transaction is a
2a50: 63 74 69 76 65 2e 0a 2a 2a 20 20 20 20 2a 20 41 ctive..** * A
2a60: 20 52 45 53 45 52 56 45 44 20 6f 72 20 67 72 65 RESERVED or gre
2a70: 61 74 65 72 20 6c 6f 63 6b 20 69 73 20 68 65 6c ater lock is hel
2a80: 64 20 6f 6e 20 74 68 65 20 64 61 74 61 62 61 73 d on the databas
2a90: 65 20 66 69 6c 65 2e 0a 2a 2a 20 20 20 20 2a 20 e file..** *
2aa0: 54 68 65 20 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 The journal file
2ab0: 20 69 73 20 6f 70 65 6e 20 61 6e 64 20 74 68 65 is open and the
2ac0: 20 66 69 72 73 74 20 68 65 61 64 65 72 20 68 61 first header ha
2ad0: 73 20 62 65 65 6e 20 77 72 69 74 74 65 6e 20 0a s been written .
2ae0: 2a 2a 20 20 20 20 20 20 74 6f 20 69 74 2c 20 62 ** to it, b
2af0: 75 74 20 74 68 65 20 68 65 61 64 65 72 20 68 61 ut the header ha
2b00: 73 20 6e 6f 74 20 62 65 65 6e 20 73 79 6e 63 65 s not been synce
2b10: 64 20 74 6f 20 64 69 73 6b 2e 0a 2a 2a 20 20 20 d to disk..**
2b20: 20 2a 20 54 68 65 20 63 6f 6e 74 65 6e 74 73 20 * The contents
2b30: 6f 66 20 74 68 65 20 70 61 67 65 20 63 61 63 68 of the page cach
2b40: 65 20 68 61 76 65 20 62 65 65 6e 20 6d 6f 64 69 e have been modi
2b50: 66 69 65 64 2e 0a 2a 2a 0a 2a 2a 20 20 57 52 49 fied..**.** WRI
2b60: 54 45 52 5f 44 42 4d 4f 44 3a 0a 2a 2a 0a 2a 2a TER_DBMOD:.**.**
2b70: 20 20 20 20 54 68 65 20 70 61 67 65 72 20 74 72 The pager tr
2b80: 61 6e 73 69 74 69 6f 6e 73 20 66 72 6f 6d 20 57 ansitions from W
2b90: 52 49 54 45 52 5f 43 41 43 48 45 4d 4f 44 20 69 RITER_CACHEMOD i
2ba0: 6e 74 6f 20 57 52 49 54 45 52 5f 44 42 4d 4f 44 nto WRITER_DBMOD
2bb0: 20 73 74 61 74 65 0a 2a 2a 20 20 20 20 77 68 65 state.** whe
2bc0: 6e 20 69 74 20 6d 6f 64 69 66 69 65 73 20 74 68 n it modifies th
2bd0: 65 20 63 6f 6e 74 65 6e 74 73 20 6f 66 20 74 68 e contents of th
2be0: 65 20 64 61 74 61 62 61 73 65 20 66 69 6c 65 2e e database file.
2bf0: 20 57 41 4c 20 63 6f 6e 6e 65 63 74 69 6f 6e 73 WAL connections
2c00: 0a 2a 2a 20 20 20 20 6e 65 76 65 72 20 65 6e 74 .** never ent
2c10: 65 72 20 74 68 69 73 20 73 74 61 74 65 20 28 73 er this state (s
2c20: 69 6e 63 65 20 74 68 65 79 20 64 6f 20 6e 6f 74 ince they do not
2c30: 20 6d 6f 64 69 66 79 20 74 68 65 20 64 61 74 61 modify the data
2c40: 62 61 73 65 20 66 69 6c 65 2c 0a 2a 2a 20 20 20 base file,.**
2c50: 20 6a 75 73 74 20 74 68 65 20 6c 6f 67 20 66 69 just the log fi
2c60: 6c 65 29 2e 0a 2a 2a 0a 2a 2a 20 20 20 20 2a 20 le)..**.** *
2c70: 41 20 77 72 69 74 65 20 74 72 61 6e 73 61 63 74 A write transact
2c80: 69 6f 6e 20 69 73 20 61 63 74 69 76 65 2e 0a 2a ion is active..*
2c90: 2a 20 20 20 20 2a 20 41 6e 20 45 58 43 4c 55 53 * * An EXCLUS
2ca0: 49 56 45 20 6f 72 20 67 72 65 61 74 65 72 20 6c IVE or greater l
2cb0: 6f 63 6b 20 69 73 20 68 65 6c 64 20 6f 6e 20 74 ock is held on t
2cc0: 68 65 20 64 61 74 61 62 61 73 65 20 66 69 6c 65 he database file
2cd0: 2e 0a 2a 2a 20 20 20 20 2a 20 54 68 65 20 6a 6f ..** * The jo
2ce0: 75 72 6e 61 6c 20 66 69 6c 65 20 69 73 20 6f 70 urnal file is op
2cf0: 65 6e 20 61 6e 64 20 74 68 65 20 66 69 72 73 74 en and the first
2d00: 20 68 65 61 64 65 72 20 68 61 73 20 62 65 65 6e header has been
2d10: 20 77 72 69 74 74 65 6e 20 0a 2a 2a 20 20 20 20 written .**
2d20: 20 20 61 6e 64 20 73 79 6e 63 65 64 20 74 6f 20 and synced to
2d30: 64 69 73 6b 2e 0a 2a 2a 20 20 20 20 2a 20 54 68 disk..** * Th
2d40: 65 20 63 6f 6e 74 65 6e 74 73 20 6f 66 20 74 68 e contents of th
2d50: 65 20 70 61 67 65 20 63 61 63 68 65 20 68 61 76 e page cache hav
2d60: 65 20 62 65 65 6e 20 6d 6f 64 69 66 69 65 64 20 e been modified
2d70: 28 61 6e 64 20 70 6f 73 73 69 62 6c 79 0a 2a 2a (and possibly.**
2d80: 20 20 20 20 20 20 77 72 69 74 74 65 6e 20 74 6f written to
2d90: 20 64 69 73 6b 29 2e 0a 2a 2a 0a 2a 2a 20 20 57 disk)..**.** W
2da0: 52 49 54 45 52 5f 46 49 4e 49 53 48 45 44 3a 0a RITER_FINISHED:.
2db0: 2a 2a 0a 2a 2a 20 20 20 20 49 74 20 69 73 20 6e **.** It is n
2dc0: 6f 74 20 70 6f 73 73 69 62 6c 65 20 66 6f 72 20 ot possible for
2dd0: 61 20 57 41 4c 20 63 6f 6e 6e 65 63 74 69 6f 6e a WAL connection
2de0: 20 74 6f 20 65 6e 74 65 72 20 74 68 69 73 20 73 to enter this s
2df0: 74 61 74 65 2e 0a 2a 2a 0a 2a 2a 20 20 20 20 41 tate..**.** A
2e00: 20 72 6f 6c 6c 62 61 63 6b 2d 6d 6f 64 65 20 70 rollback-mode p
2e10: 61 67 65 72 20 63 68 61 6e 67 65 73 20 74 6f 20 ager changes to
2e20: 57 52 49 54 45 52 5f 46 49 4e 49 53 48 45 44 20 WRITER_FINISHED
2e30: 73 74 61 74 65 20 66 72 6f 6d 20 57 52 49 54 45 state from WRITE
2e40: 52 5f 44 42 4d 4f 44 0a 2a 2a 20 20 20 20 73 74 R_DBMOD.** st
2e50: 61 74 65 20 61 66 74 65 72 20 74 68 65 20 65 6e ate after the en
2e60: 74 69 72 65 20 74 72 61 6e 73 61 63 74 69 6f 6e tire transaction
2e70: 20 68 61 73 20 62 65 65 6e 20 73 75 63 63 65 73 has been succes
2e80: 73 66 75 6c 6c 79 20 77 72 69 74 74 65 6e 20 69 sfully written i
2e90: 6e 74 6f 20 74 68 65 0a 2a 2a 20 20 20 20 64 61 nto the.** da
2ea0: 74 61 62 61 73 65 20 66 69 6c 65 2e 20 49 6e 20 tabase file. In
2eb0: 74 68 69 73 20 73 74 61 74 65 20 74 68 65 20 74 this state the t
2ec0: 72 61 6e 73 61 63 74 69 6f 6e 20 6d 61 79 20 62 ransaction may b
2ed0: 65 20 63 6f 6d 6d 69 74 74 65 64 20 73 69 6d 70 e committed simp
2ee0: 6c 79 0a 2a 2a 20 20 20 20 62 79 20 66 69 6e 61 ly.** by fina
2ef0: 6c 69 7a 69 6e 67 20 74 68 65 20 6a 6f 75 72 6e lizing the journ
2f00: 61 6c 20 66 69 6c 65 2e 20 4f 6e 63 65 20 69 6e al file. Once in
2f10: 20 57 52 49 54 45 52 5f 46 49 4e 49 53 48 45 44 WRITER_FINISHED
2f20: 20 73 74 61 74 65 2c 20 69 74 20 69 73 20 0a 2a state, it is .*
2f30: 2a 20 20 20 20 6e 6f 74 20 70 6f 73 73 69 62 6c * not possibl
2f40: 65 20 74 6f 20 6d 6f 64 69 66 79 20 74 68 65 20 e to modify the
2f50: 64 61 74 61 62 61 73 65 20 66 75 72 74 68 65 72 database further
2f60: 2e 20 41 74 20 74 68 69 73 20 70 6f 69 6e 74 2c . At this point,
2f70: 20 74 68 65 20 75 70 70 65 72 20 0a 2a 2a 20 20 the upper .**
2f80: 20 20 6c 61 79 65 72 20 6d 75 73 74 20 65 69 74 layer must eit
2f90: 68 65 72 20 63 6f 6d 6d 69 74 20 6f 72 20 72 6f her commit or ro
2fa0: 6c 6c 62 61 63 6b 20 74 68 65 20 74 72 61 6e 73 llback the trans
2fb0: 61 63 74 69 6f 6e 2e 0a 2a 2a 0a 2a 2a 20 20 20 action..**.**
2fc0: 20 2a 20 41 20 77 72 69 74 65 20 74 72 61 6e 73 * A write trans
2fd0: 61 63 74 69 6f 6e 20 69 73 20 61 63 74 69 76 65 action is active
2fe0: 2e 0a 2a 2a 20 20 20 20 2a 20 41 6e 20 45 58 43 ..** * An EXC
2ff0: 4c 55 53 49 56 45 20 6f 72 20 67 72 65 61 74 65 LUSIVE or greate
3000: 72 20 6c 6f 63 6b 20 69 73 20 68 65 6c 64 20 6f r lock is held o
3010: 6e 20 74 68 65 20 64 61 74 61 62 61 73 65 20 66 n the database f
3020: 69 6c 65 2e 0a 2a 2a 20 20 20 20 2a 20 41 6c 6c ile..** * All
3030: 20 77 72 69 74 69 6e 67 20 61 6e 64 20 73 79 6e writing and syn
3040: 63 69 6e 67 20 6f 66 20 6a 6f 75 72 6e 61 6c 20 cing of journal
3050: 61 6e 64 20 64 61 74 61 62 61 73 65 20 64 61 74 and database dat
3060: 61 20 68 61 73 20 66 69 6e 69 73 68 65 64 2e 0a a has finished..
3070: 2a 2a 20 20 20 20 20 20 49 66 20 6e 6f 20 65 72 ** If no er
3080: 72 6f 72 20 6f 63 63 75 72 65 64 2c 20 61 6c 6c ror occured, all
3090: 20 74 68 61 74 20 72 65 6d 61 69 6e 73 20 69 73 that remains is
30a0: 20 74 6f 20 66 69 6e 61 6c 69 7a 65 20 74 68 65 to finalize the
30b0: 20 6a 6f 75 72 6e 61 6c 20 74 6f 0a 2a 2a 20 20 journal to.**
30c0: 20 20 20 20 63 6f 6d 6d 69 74 20 74 68 65 20 74 commit the t
30d0: 72 61 6e 73 61 63 74 69 6f 6e 2e 20 49 66 20 61 ransaction. If a
30e0: 6e 20 65 72 72 6f 72 20 64 69 64 20 6f 63 63 75 n error did occu
30f0: 72 2c 20 74 68 65 20 63 61 6c 6c 65 72 20 77 69 r, the caller wi
3100: 6c 6c 20 6e 65 65 64 0a 2a 2a 20 20 20 20 20 20 ll need.**
3110: 74 6f 20 72 6f 6c 6c 62 61 63 6b 20 74 68 65 20 to rollback the
3120: 74 72 61 6e 73 61 63 74 69 6f 6e 2e 20 0a 2a 2a transaction. .**
3130: 0a 2a 2a 20 20 45 52 52 4f 52 3a 0a 2a 2a 0a 2a .** ERROR:.**.*
3140: 2a 20 20 20 20 54 68 65 20 45 52 52 4f 52 20 73 * The ERROR s
3150: 74 61 74 65 20 69 73 20 65 6e 74 65 72 65 64 20 tate is entered
3160: 77 68 65 6e 20 61 6e 20 49 4f 20 6f 72 20 64 69 when an IO or di
3170: 73 6b 2d 66 75 6c 6c 20 65 72 72 6f 72 20 28 69 sk-full error (i
3180: 6e 63 6c 75 64 69 6e 67 0a 2a 2a 20 20 20 20 53 ncluding.** S
3190: 51 4c 49 54 45 5f 49 4f 45 52 52 5f 4e 4f 4d 45 QLITE_IOERR_NOME
31a0: 4d 29 20 6f 63 63 75 72 73 20 61 74 20 61 20 70 M) occurs at a p
31b0: 6f 69 6e 74 20 69 6e 20 74 68 65 20 63 6f 64 65 oint in the code
31c0: 20 74 68 61 74 20 6d 61 6b 65 73 20 69 74 20 0a that makes it .
31d0: 2a 2a 20 20 20 20 64 69 66 66 69 63 75 6c 74 20 ** difficult
31e0: 74 6f 20 62 65 20 73 75 72 65 20 74 68 61 74 20 to be sure that
31f0: 74 68 65 20 69 6e 2d 6d 65 6d 6f 72 79 20 70 61 the in-memory pa
3200: 67 65 72 20 73 74 61 74 65 20 28 63 61 63 68 65 ger state (cache
3210: 20 63 6f 6e 74 65 6e 74 73 2c 20 0a 2a 2a 20 20 contents, .**
3220: 20 20 64 62 20 73 69 7a 65 20 65 74 63 2e 29 20 db size etc.)
3230: 61 72 65 20 63 6f 6e 73 69 73 74 65 6e 74 20 77 are consistent w
3240: 69 74 68 20 74 68 65 20 63 6f 6e 74 65 6e 74 73 ith the contents
3250: 20 6f 66 20 74 68 65 20 66 69 6c 65 2d 73 79 73 of the file-sys
3260: 74 65 6d 2e 0a 2a 2a 0a 2a 2a 20 20 20 20 54 65 tem..**.** Te
3270: 6d 70 6f 72 61 72 79 20 70 61 67 65 72 20 66 69 mporary pager fi
3280: 6c 65 73 20 6d 61 79 20 65 6e 74 65 72 20 74 68 les may enter th
3290: 65 20 45 52 52 4f 52 20 73 74 61 74 65 2c 20 62 e ERROR state, b
32a0: 75 74 20 69 6e 2d 6d 65 6d 6f 72 79 20 70 61 67 ut in-memory pag
32b0: 65 72 73 0a 2a 2a 20 20 20 20 63 61 6e 6e 6f 74 ers.** cannot
32c0: 2e 0a 2a 2a 0a 2a 2a 20 20 20 20 46 6f 72 20 65 ..**.** For e
32d0: 78 61 6d 70 6c 65 2c 20 69 66 20 61 6e 20 49 4f xample, if an IO
32e0: 20 65 72 72 6f 72 20 6f 63 63 75 72 73 20 77 68 error occurs wh
32f0: 69 6c 65 20 70 65 72 66 6f 72 6d 69 6e 67 20 61 ile performing a
3300: 20 72 6f 6c 6c 62 61 63 6b 2c 20 0a 2a 2a 20 20 rollback, .**
3310: 20 20 74 68 65 20 63 6f 6e 74 65 6e 74 73 20 6f the contents o
3320: 66 20 74 68 65 20 70 61 67 65 2d 63 61 63 68 65 f the page-cache
3330: 20 6d 61 79 20 62 65 20 6c 65 66 74 20 69 6e 20 may be left in
3340: 61 6e 20 69 6e 63 6f 6e 73 69 73 74 65 6e 74 20 an inconsistent
3350: 73 74 61 74 65 2e 0a 2a 2a 20 20 20 20 41 74 20 state..** At
3360: 74 68 69 73 20 70 6f 69 6e 74 20 69 74 20 77 6f this point it wo
3370: 75 6c 64 20 62 65 20 64 61 6e 67 65 72 6f 75 73 uld be dangerous
3380: 20 74 6f 20 63 68 61 6e 67 65 20 62 61 63 6b 20 to change back
3390: 74 6f 20 52 45 41 44 45 52 20 73 74 61 74 65 0a to READER state.
33a0: 2a 2a 20 20 20 20 28 61 73 20 75 73 75 61 6c 6c ** (as usuall
33b0: 79 20 68 61 70 70 65 6e 73 20 61 66 74 65 72 20 y happens after
33c0: 61 20 72 6f 6c 6c 62 61 63 6b 29 2e 20 41 6e 79 a rollback). Any
33d0: 20 73 75 62 73 65 71 75 65 6e 74 20 72 65 61 64 subsequent read
33e0: 65 72 73 20 6d 69 67 68 74 0a 2a 2a 20 20 20 20 ers might.**
33f0: 72 65 70 6f 72 74 20 64 61 74 61 62 61 73 65 20 report database
3400: 63 6f 72 72 75 70 74 69 6f 6e 20 28 64 75 65 20 corruption (due
3410: 74 6f 20 74 68 65 20 69 6e 63 6f 6e 73 69 73 74 to the inconsist
3420: 65 6e 74 20 63 61 63 68 65 29 2c 20 61 6e 64 20 ent cache), and
3430: 69 66 0a 2a 2a 20 20 20 20 74 68 65 79 20 75 70 if.** they up
3440: 67 72 61 64 65 20 74 6f 20 77 72 69 74 65 72 73 grade to writers
3450: 2c 20 74 68 65 79 20 6d 61 79 20 69 6e 61 64 76 , they may inadv
3460: 65 72 74 65 6e 74 6c 79 20 63 6f 72 72 75 70 74 ertently corrupt
3470: 20 74 68 65 20 64 61 74 61 62 61 73 65 0a 2a 2a the database.**
3480: 20 20 20 20 66 69 6c 65 2e 20 54 6f 20 61 76 6f file. To avo
3490: 69 64 20 74 68 69 73 20 68 61 7a 61 72 64 2c 20 id this hazard,
34a0: 74 68 65 20 70 61 67 65 72 20 73 77 69 74 63 68 the pager switch
34b0: 65 73 20 69 6e 74 6f 20 74 68 65 20 45 52 52 4f es into the ERRO
34c0: 52 20 73 74 61 74 65 0a 2a 2a 20 20 20 20 69 6e R state.** in
34d0: 73 74 65 61 64 20 6f 66 20 52 45 41 44 45 52 20 stead of READER
34e0: 66 6f 6c 6c 6f 77 69 6e 67 20 73 75 63 68 20 61 following such a
34f0: 6e 20 65 72 72 6f 72 2e 0a 2a 2a 0a 2a 2a 20 20 n error..**.**
3500: 20 20 4f 6e 63 65 20 69 74 20 68 61 73 20 65 6e Once it has en
3510: 74 65 72 65 64 20 74 68 65 20 45 52 52 4f 52 20 tered the ERROR
3520: 73 74 61 74 65 2c 20 61 6e 79 20 61 74 74 65 6d state, any attem
3530: 70 74 20 74 6f 20 75 73 65 20 74 68 65 20 70 61 pt to use the pa
3540: 67 65 72 0a 2a 2a 20 20 20 20 74 6f 20 72 65 61 ger.** to rea
3550: 64 20 6f 72 20 77 72 69 74 65 20 64 61 74 61 20 d or write data
3560: 72 65 74 75 72 6e 73 20 61 6e 20 65 72 72 6f 72 returns an error
3570: 2e 20 45 76 65 6e 74 75 61 6c 6c 79 2c 20 6f 6e . Eventually, on
3580: 63 65 20 61 6c 6c 20 0a 2a 2a 20 20 20 20 6f 75 ce all .** ou
3590: 74 73 74 61 6e 64 69 6e 67 20 74 72 61 6e 73 61 tstanding transa
35a0: 63 74 69 6f 6e 73 20 68 61 76 65 20 62 65 65 6e ctions have been
35b0: 20 61 62 61 6e 64 6f 6e 65 64 2c 20 74 68 65 20 abandoned, the
35c0: 70 61 67 65 72 20 69 73 20 61 62 6c 65 20 74 6f pager is able to
35d0: 0a 2a 2a 20 20 20 20 74 72 61 6e 73 69 74 69 6f .** transitio
35e0: 6e 20 62 61 63 6b 20 74 6f 20 4f 50 45 4e 20 73 n back to OPEN s
35f0: 74 61 74 65 2c 20 64 69 73 63 61 72 64 69 6e 67 tate, discarding
3600: 20 74 68 65 20 63 6f 6e 74 65 6e 74 73 20 6f 66 the contents of
3610: 20 74 68 65 20 0a 2a 2a 20 20 20 20 70 61 67 65 the .** page
3620: 2d 63 61 63 68 65 20 61 6e 64 20 61 6e 79 20 6f -cache and any o
3630: 74 68 65 72 20 69 6e 2d 6d 65 6d 6f 72 79 20 73 ther in-memory s
3640: 74 61 74 65 20 61 74 20 74 68 65 20 73 61 6d 65 tate at the same
3650: 20 74 69 6d 65 2e 20 45 76 65 72 79 74 68 69 6e time. Everythin
3660: 67 0a 2a 2a 20 20 20 20 69 73 20 72 65 6c 6f 61 g.** is reloa
3670: 64 65 64 20 66 72 6f 6d 20 64 69 73 6b 20 28 61 ded from disk (a
3680: 6e 64 2c 20 69 66 20 6e 65 63 65 73 73 61 72 79 nd, if necessary
3690: 2c 20 68 6f 74 2d 6a 6f 75 72 6e 61 6c 20 72 6f , hot-journal ro
36a0: 6c 6c 62 61 63 6b 20 70 65 66 6f 72 6d 65 64 29 llback peformed)
36b0: 0a 2a 2a 20 20 20 20 77 68 65 6e 20 61 20 72 65 .** when a re
36c0: 61 64 2d 74 72 61 6e 73 61 63 74 69 6f 6e 20 69 ad-transaction i
36d0: 73 20 6e 65 78 74 20 6f 70 65 6e 65 64 20 6f 6e s next opened on
36e0: 20 74 68 65 20 70 61 67 65 72 20 28 74 72 61 6e the pager (tran
36f0: 73 69 74 69 6f 6e 69 6e 67 0a 2a 2a 20 20 20 20 sitioning.**
3700: 74 68 65 20 70 61 67 65 72 20 69 6e 74 6f 20 52 the pager into R
3710: 45 41 44 45 52 20 73 74 61 74 65 29 2e 20 41 74 EADER state). At
3720: 20 74 68 61 74 20 70 6f 69 6e 74 20 74 68 65 20 that point the
3730: 73 79 73 74 65 6d 20 68 61 73 20 72 65 63 6f 76 system has recov
3740: 65 72 65 64 20 0a 2a 2a 20 20 20 20 66 72 6f 6d ered .** from
3750: 20 74 68 65 20 65 72 72 6f 72 2e 0a 2a 2a 0a 2a the error..**.*
3760: 2a 20 20 20 20 53 70 65 63 69 66 69 63 61 6c 6c * Specificall
3770: 79 2c 20 74 68 65 20 70 61 67 65 72 20 6a 75 6d y, the pager jum
3780: 70 73 20 69 6e 74 6f 20 74 68 65 20 45 52 52 4f ps into the ERRO
3790: 52 20 73 74 61 74 65 20 69 66 3a 0a 2a 2a 0a 2a R state if:.**.*
37a0: 2a 20 20 20 20 20 20 31 2e 20 41 6e 20 65 72 72 * 1. An err
37b0: 6f 72 20 6f 63 63 75 72 73 20 77 68 69 6c 65 20 or occurs while
37c0: 61 74 74 65 6d 70 74 69 6e 67 20 61 20 72 6f 6c attempting a rol
37d0: 6c 62 61 63 6b 2e 20 54 68 69 73 20 68 61 70 70 lback. This happ
37e0: 65 6e 73 20 69 6e 0a 2a 2a 20 20 20 20 20 20 20 ens in.**
37f0: 20 20 66 75 6e 63 74 69 6f 6e 20 73 71 6c 69 74 function sqlit
3800: 65 33 50 61 67 65 72 52 6f 6c 6c 62 61 63 6b 28 e3PagerRollback(
3810: 29 2e 0a 2a 2a 0a 2a 2a 20 20 20 20 20 20 32 2e )..**.** 2.
3820: 20 41 6e 20 65 72 72 6f 72 20 6f 63 63 75 72 73 An error occurs
3830: 20 77 68 69 6c 65 20 61 74 74 65 6d 70 74 69 6e while attemptin
3840: 67 20 74 6f 20 66 69 6e 61 6c 69 7a 65 20 61 20 g to finalize a
3850: 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 0a 2a 2a 20 journal file.**
3860: 20 20 20 20 20 20 20 20 66 6f 6c 6c 6f 77 69 6e followin
3870: 67 20 61 20 63 6f 6d 6d 69 74 20 69 6e 20 66 75 g a commit in fu
3880: 6e 63 74 69 6f 6e 20 73 71 6c 69 74 65 33 50 61 nction sqlite3Pa
3890: 67 65 72 43 6f 6d 6d 69 74 50 68 61 73 65 54 77 gerCommitPhaseTw
38a0: 6f 28 29 2e 0a 2a 2a 0a 2a 2a 20 20 20 20 20 20 o()..**.**
38b0: 33 2e 20 41 6e 20 65 72 72 6f 72 20 6f 63 63 75 3. An error occu
38c0: 72 73 20 77 68 69 6c 65 20 61 74 74 65 6d 70 74 rs while attempt
38d0: 69 6e 67 20 74 6f 20 77 72 69 74 65 20 74 6f 20 ing to write to
38e0: 74 68 65 20 6a 6f 75 72 6e 61 6c 20 6f 72 0a 2a the journal or.*
38f0: 2a 20 20 20 20 20 20 20 20 20 64 61 74 61 62 61 * databa
3900: 73 65 20 66 69 6c 65 20 69 6e 20 66 75 6e 63 74 se file in funct
3910: 69 6f 6e 20 70 61 67 65 72 53 74 72 65 73 73 28 ion pagerStress(
3920: 29 20 69 6e 20 6f 72 64 65 72 20 74 6f 20 66 72 ) in order to fr
3930: 65 65 20 75 70 0a 2a 2a 20 20 20 20 20 20 20 20 ee up.**
3940: 20 6d 65 6d 6f 72 79 2e 0a 2a 2a 0a 2a 2a 20 20 memory..**.**
3950: 20 20 49 6e 20 6f 74 68 65 72 20 63 61 73 65 73 In other cases
3960: 2c 20 74 68 65 20 65 72 72 6f 72 20 69 73 20 72 , the error is r
3970: 65 74 75 72 6e 65 64 20 74 6f 20 74 68 65 20 62 eturned to the b
3980: 2d 74 72 65 65 20 6c 61 79 65 72 2e 20 54 68 65 -tree layer. The
3990: 20 62 2d 74 72 65 65 0a 2a 2a 20 20 20 20 6c 61 b-tree.** la
39a0: 79 65 72 20 74 68 65 6e 20 61 74 74 65 6d 70 74 yer then attempt
39b0: 73 20 61 20 72 6f 6c 6c 62 61 63 6b 20 6f 70 65 s a rollback ope
39c0: 72 61 74 69 6f 6e 2e 20 49 66 20 74 68 65 20 65 ration. If the e
39d0: 72 72 6f 72 20 63 6f 6e 64 69 74 69 6f 6e 20 0a rror condition .
39e0: 2a 2a 20 20 20 20 70 65 72 73 69 73 74 73 2c 20 ** persists,
39f0: 74 68 65 20 70 61 67 65 72 20 65 6e 74 65 72 73 the pager enters
3a00: 20 74 68 65 20 45 52 52 4f 52 20 73 74 61 74 65 the ERROR state
3a10: 20 76 69 61 20 63 6f 6e 64 69 74 69 6f 6e 20 28 via condition (
3a20: 31 29 20 61 62 6f 76 65 2e 0a 2a 2a 0a 2a 2a 20 1) above..**.**
3a30: 20 20 20 43 6f 6e 64 69 74 69 6f 6e 20 28 33 29 Condition (3)
3a40: 20 69 73 20 6e 65 63 65 73 73 61 72 79 20 62 65 is necessary be
3a50: 63 61 75 73 65 20 69 74 20 63 61 6e 20 62 65 20 cause it can be
3a60: 74 72 69 67 67 65 72 65 64 20 62 79 20 61 20 72 triggered by a r
3a70: 65 61 64 2d 6f 6e 6c 79 0a 2a 2a 20 20 20 20 73 ead-only.** s
3a80: 74 61 74 65 6d 65 6e 74 20 65 78 65 63 75 74 65 tatement execute
3a90: 64 20 77 69 74 68 69 6e 20 61 20 74 72 61 6e 73 d within a trans
3aa0: 61 63 74 69 6f 6e 2e 20 49 6e 20 74 68 69 73 20 action. In this
3ab0: 63 61 73 65 2c 20 69 66 20 74 68 65 20 65 72 72 case, if the err
3ac0: 6f 72 0a 2a 2a 20 20 20 20 63 6f 64 65 20 77 65 or.** code we
3ad0: 72 65 20 73 69 6d 70 6c 79 20 72 65 74 75 72 6e re simply return
3ae0: 65 64 20 74 6f 20 74 68 65 20 75 73 65 72 2c 20 ed to the user,
3af0: 74 68 65 20 62 2d 74 72 65 65 20 6c 61 79 65 72 the b-tree layer
3b00: 20 77 6f 75 6c 64 20 6e 6f 74 0a 2a 2a 20 20 20 would not.**
3b10: 20 61 75 74 6f 6d 61 74 69 63 61 6c 6c 79 20 61 automatically a
3b20: 74 74 65 6d 70 74 20 61 20 72 6f 6c 6c 62 61 63 ttempt a rollbac
3b30: 6b 2c 20 61 73 20 69 74 20 61 73 73 75 6d 65 73 k, as it assumes
3b40: 20 74 68 61 74 20 61 6e 20 65 72 72 6f 72 20 69 that an error i
3b50: 6e 20 61 0a 2a 2a 20 20 20 20 72 65 61 64 2d 6f n a.** read-o
3b60: 6e 6c 79 20 73 74 61 74 65 6d 65 6e 74 20 63 61 nly statement ca
3b70: 6e 6e 6f 74 20 6c 65 61 76 65 20 74 68 65 20 70 nnot leave the p
3b80: 61 67 65 72 20 69 6e 20 61 6e 20 69 6e 74 65 72 ager in an inter
3b90: 6e 61 6c 6c 79 20 69 6e 63 6f 6e 73 69 73 74 65 nally inconsiste
3ba0: 6e 74 20 0a 2a 2a 20 20 20 20 73 74 61 74 65 2e nt .** state.
3bb0: 0a 2a 2a 0a 2a 2a 20 20 20 20 2a 20 54 68 65 20 .**.** * The
3bc0: 50 61 67 65 72 2e 65 72 72 43 6f 64 65 20 76 61 Pager.errCode va
3bd0: 72 69 61 62 6c 65 20 69 73 20 73 65 74 20 74 6f riable is set to
3be0: 20 73 6f 6d 65 74 68 69 6e 67 20 6f 74 68 65 72 something other
3bf0: 20 74 68 61 6e 20 53 51 4c 49 54 45 5f 4f 4b 2e than SQLITE_OK.
3c00: 0a 2a 2a 20 20 20 20 2a 20 54 68 65 72 65 20 61 .** * There a
3c10: 72 65 20 6f 6e 65 20 6f 72 20 6d 6f 72 65 20 6f re one or more o
3c20: 75 74 73 74 61 6e 64 69 6e 67 20 72 65 66 65 72 utstanding refer
3c30: 65 6e 63 65 73 20 74 6f 20 70 61 67 65 73 20 28 ences to pages (
3c40: 61 66 74 65 72 20 74 68 65 0a 2a 2a 20 20 20 20 after the.**
3c50: 20 20 6c 61 73 74 20 72 65 66 65 72 65 6e 63 65 last reference
3c60: 20 69 73 20 64 72 6f 70 70 65 64 20 74 68 65 20 is dropped the
3c70: 70 61 67 65 72 20 73 68 6f 75 6c 64 20 6d 6f 76 pager should mov
3c80: 65 20 62 61 63 6b 20 74 6f 20 4f 50 45 4e 20 73 e back to OPEN s
3c90: 74 61 74 65 29 2e 0a 2a 2a 20 20 20 20 2a 20 54 tate)..** * T
3ca0: 68 65 20 70 61 67 65 72 20 69 73 20 6e 6f 74 20 he pager is not
3cb0: 61 6e 20 69 6e 2d 6d 65 6d 6f 72 79 20 70 61 67 an in-memory pag
3cc0: 65 72 2e 0a 2a 2a 20 20 20 20 0a 2a 2a 0a 2a 2a er..** .**.**
3cd0: 20 4e 6f 74 65 73 3a 0a 2a 2a 0a 2a 2a 20 20 20 Notes:.**.**
3ce0: 2a 20 41 20 70 61 67 65 72 20 69 73 20 6e 65 76 * A pager is nev
3cf0: 65 72 20 69 6e 20 57 52 49 54 45 52 5f 44 42 4d er in WRITER_DBM
3d00: 4f 44 20 6f 72 20 57 52 49 54 45 52 5f 46 49 4e OD or WRITER_FIN
3d10: 49 53 48 45 44 20 73 74 61 74 65 20 69 66 20 74 ISHED state if t
3d20: 68 65 0a 2a 2a 20 20 20 20 20 63 6f 6e 6e 65 63 he.** connec
3d30: 74 69 6f 6e 20 69 73 20 6f 70 65 6e 20 69 6e 20 tion is open in
3d40: 57 41 4c 20 6d 6f 64 65 2e 20 41 20 57 41 4c 20 WAL mode. A WAL
3d50: 63 6f 6e 6e 65 63 74 69 6f 6e 20 69 73 20 61 6c connection is al
3d60: 77 61 79 73 20 69 6e 20 6f 6e 65 0a 2a 2a 20 20 ways in one.**
3d70: 20 20 20 6f 66 20 74 68 65 20 66 69 72 73 74 20 of the first
3d80: 66 6f 75 72 20 73 74 61 74 65 73 2e 0a 2a 2a 0a four states..**.
3d90: 2a 2a 20 20 20 2a 20 4e 6f 72 6d 61 6c 6c 79 2c ** * Normally,
3da0: 20 61 20 63 6f 6e 6e 65 63 74 69 6f 6e 20 6f 70 a connection op
3db0: 65 6e 20 69 6e 20 65 78 63 6c 75 73 69 76 65 20 en in exclusive
3dc0: 6d 6f 64 65 20 69 73 20 6e 65 76 65 72 20 69 6e mode is never in
3dd0: 20 50 41 47 45 52 5f 4f 50 45 4e 0a 2a 2a 20 20 PAGER_OPEN.**
3de0: 20 20 20 73 74 61 74 65 2e 20 54 68 65 72 65 20 state. There
3df0: 61 72 65 20 74 77 6f 20 65 78 63 65 70 74 69 6f are two exceptio
3e00: 6e 73 3a 20 69 6d 6d 65 64 69 61 74 65 6c 79 20 ns: immediately
3e10: 61 66 74 65 72 20 65 78 63 6c 75 73 69 76 65 2d after exclusive-
3e20: 6d 6f 64 65 20 68 61 73 0a 2a 2a 20 20 20 20 20 mode has.**
3e30: 62 65 65 6e 20 74 75 72 6e 65 64 20 6f 6e 20 28 been turned on (
3e40: 61 6e 64 20 62 65 66 6f 72 65 20 61 6e 79 20 72 and before any r
3e50: 65 61 64 20 6f 72 20 77 72 69 74 65 20 74 72 61 ead or write tra
3e60: 6e 73 61 63 74 69 6f 6e 73 20 61 72 65 20 0a 2a nsactions are .*
3e70: 2a 20 20 20 20 20 65 78 65 63 75 74 65 64 29 2c * executed),
3e80: 20 61 6e 64 20 77 68 65 6e 20 74 68 65 20 70 61 and when the pa
3e90: 67 65 72 20 69 73 20 6c 65 61 76 69 6e 67 20 74 ger is leaving t
3ea0: 68 65 20 22 65 72 72 6f 72 20 73 74 61 74 65 22 he "error state"
3eb0: 2e 0a 2a 2a 0a 2a 2a 20 20 20 2a 20 53 65 65 20 ..**.** * See
3ec0: 61 6c 73 6f 3a 20 61 73 73 65 72 74 5f 70 61 67 also: assert_pag
3ed0: 65 72 5f 73 74 61 74 65 28 29 2e 0a 2a 2f 0a 23 er_state()..*/.#
3ee0: 64 65 66 69 6e 65 20 50 41 47 45 52 5f 4f 50 45 define PAGER_OPE
3ef0: 4e 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 N
3f00: 20 20 20 30 0a 23 64 65 66 69 6e 65 20 50 41 47 0.#define PAG
3f10: 45 52 5f 52 45 41 44 45 52 20 20 20 20 20 20 20 ER_READER
3f20: 20 20 20 20 20 20 20 20 20 31 0a 23 64 65 66 69 1.#defi
3f30: 6e 65 20 50 41 47 45 52 5f 57 52 49 54 45 52 5f ne PAGER_WRITER_
3f40: 4c 4f 43 4b 45 44 20 20 20 20 20 20 20 20 20 32 LOCKED 2
3f50: 0a 23 64 65 66 69 6e 65 20 50 41 47 45 52 5f 57 .#define PAGER_W
3f60: 52 49 54 45 52 5f 43 41 43 48 45 4d 4f 44 20 20 RITER_CACHEMOD
3f70: 20 20 20 20 20 33 0a 23 64 65 66 69 6e 65 20 50 3.#define P
3f80: 41 47 45 52 5f 57 52 49 54 45 52 5f 44 42 4d 4f AGER_WRITER_DBMO
3f90: 44 20 20 20 20 20 20 20 20 20 20 34 0a 23 64 65 D 4.#de
3fa0: 66 69 6e 65 20 50 41 47 45 52 5f 57 52 49 54 45 fine PAGER_WRITE
3fb0: 52 5f 46 49 4e 49 53 48 45 44 20 20 20 20 20 20 R_FINISHED
3fc0: 20 35 0a 23 64 65 66 69 6e 65 20 50 41 47 45 52 5.#define PAGER
3fd0: 5f 45 52 52 4f 52 20 20 20 20 20 20 20 20 20 20 _ERROR
3fe0: 20 20 20 20 20 20 20 36 0a 0a 2f 2a 0a 2a 2a 20 6../*.**
3ff0: 54 68 65 20 50 61 67 65 72 2e 65 4c 6f 63 6b 20 The Pager.eLock
4000: 76 61 72 69 61 62 6c 65 20 69 73 20 61 6c 6d 6f variable is almo
4010: 73 74 20 61 6c 77 61 79 73 20 73 65 74 20 74 6f st always set to
4020: 20 6f 6e 65 20 6f 66 20 74 68 65 20 0a 2a 2a 20 one of the .**
4030: 66 6f 6c 6c 6f 77 69 6e 67 20 6c 6f 63 6b 69 6e following lockin
4040: 67 2d 73 74 61 74 65 73 2c 20 61 63 63 6f 72 64 g-states, accord
4050: 69 6e 67 20 74 6f 20 74 68 65 20 6c 6f 63 6b 20 ing to the lock
4060: 63 75 72 72 65 6e 74 6c 79 20 68 65 6c 64 20 6f currently held o
4070: 6e 0a 2a 2a 20 74 68 65 20 64 61 74 61 62 61 73 n.** the databas
4080: 65 20 66 69 6c 65 3a 20 4e 4f 5f 4c 4f 43 4b 2c e file: NO_LOCK,
4090: 20 53 48 41 52 45 44 5f 4c 4f 43 4b 2c 20 52 45 SHARED_LOCK, RE
40a0: 53 45 52 56 45 44 5f 4c 4f 43 4b 20 6f 72 20 45 SERVED_LOCK or E
40b0: 58 43 4c 55 53 49 56 45 5f 4c 4f 43 4b 2e 0a 2a XCLUSIVE_LOCK..*
40c0: 2a 20 54 68 69 73 20 76 61 72 69 61 62 6c 65 20 * This variable
40d0: 69 73 20 6b 65 70 74 20 75 70 20 74 6f 20 64 61 is kept up to da
40e0: 74 65 20 61 73 20 6c 6f 63 6b 73 20 61 72 65 20 te as locks are
40f0: 74 61 6b 65 6e 20 61 6e 64 20 72 65 6c 65 61 73 taken and releas
4100: 65 64 20 62 79 0a 2a 2a 20 74 68 65 20 70 61 67 ed by.** the pag
4110: 65 72 4c 6f 63 6b 44 62 28 29 20 61 6e 64 20 70 erLockDb() and p
4120: 61 67 65 72 55 6e 6c 6f 63 6b 44 62 28 29 20 77 agerUnlockDb() w
4130: 72 61 70 70 65 72 73 2e 0a 2a 2a 0a 2a 2a 20 49 rappers..**.** I
4140: 66 20 74 68 65 20 56 46 53 20 78 4c 6f 63 6b 28 f the VFS xLock(
4150: 29 20 6f 72 20 78 55 6e 6c 6f 63 6b 28 29 20 72 ) or xUnlock() r
4160: 65 74 75 72 6e 73 20 61 6e 20 65 72 72 6f 72 20 eturns an error
4170: 6f 74 68 65 72 20 74 68 61 6e 20 53 51 4c 49 54 other than SQLIT
4180: 45 5f 42 55 53 59 0a 2a 2a 20 28 69 2e 65 2e 20 E_BUSY.** (i.e.
4190: 6f 6e 65 20 6f 66 20 74 68 65 20 53 51 4c 49 54 one of the SQLIT
41a0: 45 5f 49 4f 45 52 52 20 73 75 62 74 79 70 65 73 E_IOERR subtypes
41b0: 29 2c 20 69 74 20 69 73 20 6e 6f 74 20 63 6c 65 ), it is not cle
41c0: 61 72 20 77 68 65 74 68 65 72 20 6f 72 20 6e 6f ar whether or no
41d0: 74 0a 2a 2a 20 74 68 65 20 6f 70 65 72 61 74 69 t.** the operati
41e0: 6f 6e 20 77 61 73 20 73 75 63 63 65 73 73 66 75 on was successfu
41f0: 6c 2e 20 49 6e 20 74 68 65 73 65 20 63 69 72 63 l. In these circ
4200: 75 6d 73 74 61 6e 63 65 73 20 70 61 67 65 72 4c umstances pagerL
4210: 6f 63 6b 44 62 28 29 20 61 6e 64 0a 2a 2a 20 70 ockDb() and.** p
4220: 61 67 65 72 55 6e 6c 6f 63 6b 44 62 28 29 20 74 agerUnlockDb() t
4230: 61 6b 65 20 61 20 63 6f 6e 73 65 72 76 61 74 69 ake a conservati
4240: 76 65 20 61 70 70 72 6f 61 63 68 20 2d 20 65 4c ve approach - eL
4250: 6f 63 6b 20 69 73 20 61 6c 77 61 79 73 20 75 70 ock is always up
4260: 64 61 74 65 64 0a 2a 2a 20 77 68 65 6e 20 75 6e dated.** when un
4270: 6c 6f 63 6b 69 6e 67 20 74 68 65 20 66 69 6c 65 locking the file
4280: 2c 20 61 6e 64 20 6f 6e 6c 79 20 75 70 64 61 74 , and only updat
4290: 65 64 20 77 68 65 6e 20 6c 6f 63 6b 69 6e 67 20 ed when locking
42a0: 74 68 65 20 66 69 6c 65 20 69 66 20 74 68 65 0a the file if the.
42b0: 2a 2a 20 56 46 53 20 63 61 6c 6c 20 69 73 20 73 ** VFS call is s
42c0: 75 63 63 65 73 73 66 75 6c 2e 20 54 68 69 73 20 uccessful. This
42d0: 77 61 79 2c 20 74 68 65 20 50 61 67 65 72 2e 65 way, the Pager.e
42e0: 4c 6f 63 6b 20 76 61 72 69 61 62 6c 65 20 6d 61 Lock variable ma
42f0: 79 20 62 65 20 73 65 74 0a 2a 2a 20 74 6f 20 61 y be set.** to a
4300: 20 6c 65 73 73 20 65 78 63 6c 75 73 69 76 65 20 less exclusive
4310: 28 6c 6f 77 65 72 29 20 76 61 6c 75 65 20 74 68 (lower) value th
4320: 61 6e 20 74 68 65 20 6c 6f 63 6b 20 74 68 61 74 an the lock that
4330: 20 69 73 20 61 63 74 75 61 6c 6c 79 20 68 65 6c is actually hel
4340: 64 0a 2a 2a 20 61 74 20 74 68 65 20 73 79 73 74 d.** at the syst
4350: 65 6d 20 6c 65 76 65 6c 2c 20 62 75 74 20 69 74 em level, but it
4360: 20 69 73 20 6e 65 76 65 72 20 73 65 74 20 74 6f is never set to
4370: 20 61 20 6d 6f 72 65 20 65 78 63 6c 75 73 69 76 a more exclusiv
4380: 65 20 76 61 6c 75 65 2e 0a 2a 2a 0a 2a 2a 20 54 e value..**.** T
4390: 68 69 73 20 69 73 20 75 73 75 61 6c 6c 79 20 73 his is usually s
43a0: 61 66 65 2e 20 49 66 20 61 6e 20 78 55 6e 6c 6f afe. If an xUnlo
43b0: 63 6b 20 66 61 69 6c 73 20 6f 72 20 61 70 70 65 ck fails or appe
43c0: 61 72 73 20 74 6f 20 66 61 69 6c 2c 20 74 68 65 ars to fail, the
43d0: 72 65 20 6d 61 79 20 0a 2a 2a 20 62 65 20 61 20 re may .** be a
43e0: 66 65 77 20 72 65 64 75 6e 64 61 6e 74 20 78 4c few redundant xL
43f0: 6f 63 6b 28 29 20 63 61 6c 6c 73 20 6f 72 20 61 ock() calls or a
4400: 20 6c 6f 63 6b 20 6d 61 79 20 62 65 20 68 65 6c lock may be hel
4410: 64 20 66 6f 72 20 6c 6f 6e 67 65 72 20 74 68 61 d for longer tha
4420: 6e 0a 2a 2a 20 72 65 71 75 69 72 65 64 2c 20 62 n.** required, b
4430: 75 74 20 6e 6f 74 68 69 6e 67 20 72 65 61 6c 6c ut nothing reall
4440: 79 20 67 6f 65 73 20 77 72 6f 6e 67 2e 0a 2a 2a y goes wrong..**
4450: 0a 2a 2a 20 54 68 65 20 65 78 63 65 70 74 69 6f .** The exceptio
4460: 6e 20 69 73 20 77 68 65 6e 20 74 68 65 20 64 61 n is when the da
4470: 74 61 62 61 73 65 20 66 69 6c 65 20 69 73 20 75 tabase file is u
4480: 6e 6c 6f 63 6b 65 64 20 61 73 20 74 68 65 20 70 nlocked as the p
4490: 61 67 65 72 20 6d 6f 76 65 73 0a 2a 2a 20 66 72 ager moves.** fr
44a0: 6f 6d 20 45 52 52 4f 52 20 74 6f 20 4f 50 45 4e om ERROR to OPEN
44b0: 20 73 74 61 74 65 2e 20 41 74 20 74 68 69 73 20 state. At this
44c0: 70 6f 69 6e 74 20 74 68 65 72 65 20 6d 61 79 20 point there may
44d0: 62 65 20 61 20 68 6f 74 2d 6a 6f 75 72 6e 61 6c be a hot-journal
44e0: 20 66 69 6c 65 20 0a 2a 2a 20 69 6e 20 74 68 65 file .** in the
44f0: 20 66 69 6c 65 2d 73 79 73 74 65 6d 20 74 68 61 file-system tha
4500: 74 20 6e 65 65 64 73 20 74 6f 20 62 65 20 72 6f t needs to be ro
4510: 6c 6c 65 64 20 62 61 63 6b 20 28 61 73 20 70 61 lled back (as pa
4520: 72 74 20 6f 66 20 61 20 4f 50 45 4e 2d 3e 53 48 rt of a OPEN->SH
4530: 41 52 45 44 0a 2a 2a 20 74 72 61 6e 73 69 74 69 ARED.** transiti
4540: 6f 6e 2c 20 62 79 20 74 68 65 20 73 61 6d 65 20 on, by the same
4550: 70 61 67 65 72 20 6f 72 20 61 6e 79 20 6f 74 68 pager or any oth
4560: 65 72 29 2e 20 49 66 20 74 68 65 20 63 61 6c 6c er). If the call
4570: 20 74 6f 20 78 55 6e 6c 6f 63 6b 28 29 0a 2a 2a to xUnlock().**
4580: 20 66 61 69 6c 73 20 61 74 20 74 68 69 73 20 70 fails at this p
4590: 6f 69 6e 74 20 61 6e 64 20 74 68 65 20 70 61 67 oint and the pag
45a0: 65 72 20 69 73 20 6c 65 66 74 20 68 6f 6c 64 69 er is left holdi
45b0: 6e 67 20 61 6e 20 45 58 43 4c 55 53 49 56 45 20 ng an EXCLUSIVE
45c0: 6c 6f 63 6b 2c 20 74 68 69 73 0a 2a 2a 20 63 61 lock, this.** ca
45d0: 6e 20 63 6f 6e 66 75 73 65 20 74 68 65 20 63 61 n confuse the ca
45e0: 6c 6c 20 74 6f 20 78 43 68 65 63 6b 52 65 73 65 ll to xCheckRese
45f0: 72 76 65 64 4c 6f 63 6b 28 29 20 63 61 6c 6c 20 rvedLock() call
4600: 6d 61 64 65 20 6c 61 74 65 72 20 61 73 20 70 61 made later as pa
4610: 72 74 0a 2a 2a 20 6f 66 20 68 6f 74 2d 6a 6f 75 rt.** of hot-jou
4620: 72 6e 61 6c 20 64 65 74 65 63 74 69 6f 6e 2e 0a rnal detection..
4630: 2a 2a 0a 2a 2a 20 78 43 68 65 63 6b 52 65 73 65 **.** xCheckRese
4640: 72 76 65 64 4c 6f 63 6b 28 29 20 69 73 20 64 65 rvedLock() is de
4650: 66 69 6e 65 64 20 61 73 20 72 65 74 75 72 6e 69 fined as returni
4660: 6e 67 20 74 72 75 65 20 22 69 66 20 74 68 65 72 ng true "if ther
4670: 65 20 69 73 20 61 20 52 45 53 45 52 56 45 44 20 e is a RESERVED
4680: 0a 2a 2a 20 6c 6f 63 6b 20 68 65 6c 64 20 62 79 .** lock held by
4690: 20 74 68 69 73 20 70 72 6f 63 65 73 73 20 6f 72 this process or
46a0: 20 61 6e 79 20 6f 74 68 65 72 73 22 2e 20 53 6f any others". So
46b0: 20 78 43 68 65 63 6b 52 65 73 65 72 76 65 64 4c xCheckReservedL
46c0: 6f 63 6b 20 6d 61 79 20 0a 2a 2a 20 72 65 74 75 ock may .** retu
46d0: 72 6e 20 74 72 75 65 20 62 65 63 61 75 73 65 20 rn true because
46e0: 74 68 65 20 63 61 6c 6c 65 72 20 69 74 73 65 6c the caller itsel
46f0: 66 20 69 73 20 68 6f 6c 64 69 6e 67 20 61 6e 20 f is holding an
4700: 45 58 43 4c 55 53 49 56 45 20 6c 6f 63 6b 20 28 EXCLUSIVE lock (
4710: 62 75 74 0a 2a 2a 20 64 6f 65 73 6e 27 74 20 6b but.** doesn't k
4720: 6e 6f 77 20 69 74 20 62 65 63 61 75 73 65 20 6f now it because o
4730: 66 20 61 20 70 72 65 76 69 6f 75 73 20 65 72 72 f a previous err
4740: 6f 72 20 69 6e 20 78 55 6e 6c 6f 63 6b 29 2e 20 or in xUnlock).
4750: 49 66 20 74 68 69 73 20 68 61 70 70 65 6e 73 0a If this happens.
4760: 2a 2a 20 61 20 68 6f 74 2d 6a 6f 75 72 6e 61 6c ** a hot-journal
4770: 20 6d 61 79 20 62 65 20 6d 69 73 74 61 6b 65 6e may be mistaken
4780: 20 66 6f 72 20 61 20 6a 6f 75 72 6e 61 6c 20 62 for a journal b
4790: 65 69 6e 67 20 63 72 65 61 74 65 64 20 62 79 20 eing created by
47a0: 61 6e 20 61 63 74 69 76 65 0a 2a 2a 20 74 72 61 an active.** tra
47b0: 6e 73 61 63 74 69 6f 6e 20 69 6e 20 61 6e 6f 74 nsaction in anot
47c0: 68 65 72 20 70 72 6f 63 65 73 73 2c 20 63 61 75 her process, cau
47d0: 73 69 6e 67 20 53 51 4c 69 74 65 20 74 6f 20 72 sing SQLite to r
47e0: 65 61 64 20 66 72 6f 6d 20 74 68 65 20 64 61 74 ead from the dat
47f0: 61 62 61 73 65 0a 2a 2a 20 77 69 74 68 6f 75 74 abase.** without
4800: 20 72 6f 6c 6c 69 6e 67 20 69 74 20 62 61 63 6b rolling it back
4810: 2e 0a 2a 2a 0a 2a 2a 20 54 6f 20 77 6f 72 6b 20 ..**.** To work
4820: 61 72 6f 75 6e 64 20 74 68 69 73 2c 20 69 66 20 around this, if
4830: 61 20 63 61 6c 6c 20 74 6f 20 78 55 6e 6c 6f 63 a call to xUnloc
4840: 6b 28 29 20 66 61 69 6c 73 20 77 68 65 6e 20 75 k() fails when u
4850: 6e 6c 6f 63 6b 69 6e 67 20 74 68 65 0a 2a 2a 20 nlocking the.**
4860: 64 61 74 61 62 61 73 65 20 69 6e 20 74 68 65 20 database in the
4870: 45 52 52 4f 52 20 73 74 61 74 65 2c 20 50 61 67 ERROR state, Pag
4880: 65 72 2e 65 4c 6f 63 6b 20 69 73 20 73 65 74 20 er.eLock is set
4890: 74 6f 20 55 4e 4b 4e 4f 57 4e 5f 4c 4f 43 4b 2e to UNKNOWN_LOCK.
48a0: 20 49 74 0a 2a 2a 20 69 73 20 6f 6e 6c 79 20 63 It.** is only c
48b0: 68 61 6e 67 65 64 20 62 61 63 6b 20 74 6f 20 61 hanged back to a
48c0: 20 72 65 61 6c 20 6c 6f 63 6b 69 6e 67 20 73 74 real locking st
48d0: 61 74 65 20 61 66 74 65 72 20 61 20 73 75 63 63 ate after a succ
48e0: 65 73 73 66 75 6c 20 63 61 6c 6c 0a 2a 2a 20 74 essful call.** t
48f0: 6f 20 78 4c 6f 63 6b 28 45 58 43 4c 55 53 49 56 o xLock(EXCLUSIV
4900: 45 29 2e 20 41 6c 73 6f 2c 20 74 68 65 20 63 6f E). Also, the co
4910: 64 65 20 74 6f 20 64 6f 20 74 68 65 20 4f 50 45 de to do the OPE
4920: 4e 2d 3e 53 48 41 52 45 44 20 73 74 61 74 65 20 N->SHARED state
4930: 74 72 61 6e 73 69 74 69 6f 6e 0a 2a 2a 20 6f 6d transition.** om
4940: 69 74 73 20 74 68 65 20 63 68 65 63 6b 20 66 6f its the check fo
4950: 72 20 61 20 68 6f 74 2d 6a 6f 75 72 6e 61 6c 20 r a hot-journal
4960: 69 66 20 50 61 67 65 72 2e 65 4c 6f 63 6b 20 69 if Pager.eLock i
4970: 73 20 73 65 74 20 74 6f 20 55 4e 4b 4e 4f 57 4e s set to UNKNOWN
4980: 5f 4c 4f 43 4b 20 0a 2a 2a 20 6c 6f 63 6b 2e 20 _LOCK .** lock.
4990: 49 6e 73 74 65 61 64 2c 20 69 74 20 61 73 73 75 Instead, it assu
49a0: 6d 65 73 20 61 20 68 6f 74 2d 6a 6f 75 72 6e 61 mes a hot-journa
49b0: 6c 20 65 78 69 73 74 73 20 61 6e 64 20 6f 62 74 l exists and obt
49c0: 61 69 6e 73 20 61 6e 20 45 58 43 4c 55 53 49 56 ains an EXCLUSIV
49d0: 45 0a 2a 2a 20 6c 6f 63 6b 20 6f 6e 20 74 68 65 E.** lock on the
49e0: 20 64 61 74 61 62 61 73 65 20 66 69 6c 65 20 62 database file b
49f0: 65 66 6f 72 65 20 61 74 74 65 6d 70 74 69 6e 67 efore attempting
4a00: 20 74 6f 20 72 6f 6c 6c 20 69 74 20 62 61 63 6b to roll it back
4a10: 2e 20 53 65 65 20 66 75 6e 63 74 69 6f 6e 0a 2a . See function.*
4a20: 2a 20 50 61 67 65 72 53 68 61 72 65 64 4c 6f 63 * PagerSharedLoc
4a30: 6b 28 29 20 66 6f 72 20 6d 6f 72 65 20 64 65 74 k() for more det
4a40: 61 69 6c 2e 0a 2a 2a 0a 2a 2a 20 50 61 67 65 72 ail..**.** Pager
4a50: 2e 65 4c 6f 63 6b 20 6d 61 79 20 6f 6e 6c 79 20 .eLock may only
4a60: 62 65 20 73 65 74 20 74 6f 20 55 4e 4b 4e 4f 57 be set to UNKNOW
4a70: 4e 5f 4c 4f 43 4b 20 77 68 65 6e 20 74 68 65 20 N_LOCK when the
4a80: 70 61 67 65 72 20 69 73 20 69 6e 20 0a 2a 2a 20 pager is in .**
4a90: 50 41 47 45 52 5f 4f 50 45 4e 20 73 74 61 74 65 PAGER_OPEN state
4aa0: 2e 0a 2a 2f 0a 23 64 65 66 69 6e 65 20 55 4e 4b ..*/.#define UNK
4ab0: 4e 4f 57 4e 5f 4c 4f 43 4b 20 20 20 20 20 20 20 NOWN_LOCK
4ac0: 20 20 20 20 20 20 20 20 20 28 45 58 43 4c 55 53 (EXCLUS
4ad0: 49 56 45 5f 4c 4f 43 4b 2b 31 29 0a 0a 2f 2a 0a IVE_LOCK+1)../*.
4ae0: 2a 2a 20 41 20 6d 61 63 72 6f 20 75 73 65 64 20 ** A macro used
4af0: 66 6f 72 20 69 6e 76 6f 6b 69 6e 67 20 74 68 65 for invoking the
4b00: 20 63 6f 64 65 63 20 69 66 20 74 68 65 72 65 20 codec if there
4b10: 69 73 20 6f 6e 65 0a 2a 2f 0a 23 69 66 64 65 66 is one.*/.#ifdef
4b20: 20 53 51 4c 49 54 45 5f 48 41 53 5f 43 4f 44 45 SQLITE_HAS_CODE
4b30: 43 0a 23 20 64 65 66 69 6e 65 20 43 4f 44 45 43 C.# define CODEC
4b40: 31 28 50 2c 44 2c 4e 2c 58 2c 45 29 20 5c 0a 20 1(P,D,N,X,E) \.
4b50: 20 20 20 69 66 28 20 50 2d 3e 78 43 6f 64 65 63 if( P->xCodec
4b60: 20 26 26 20 50 2d 3e 78 43 6f 64 65 63 28 50 2d && P->xCodec(P-
4b70: 3e 70 43 6f 64 65 63 2c 44 2c 4e 2c 58 29 3d 3d >pCodec,D,N,X)==
4b80: 30 20 29 7b 20 45 3b 20 7d 0a 23 20 64 65 66 69 0 ){ E; }.# defi
4b90: 6e 65 20 43 4f 44 45 43 32 28 50 2c 44 2c 4e 2c ne CODEC2(P,D,N,
4ba0: 58 2c 45 2c 4f 29 20 5c 0a 20 20 20 20 69 66 28 X,E,O) \. if(
4bb0: 20 50 2d 3e 78 43 6f 64 65 63 3d 3d 30 20 29 7b P->xCodec==0 ){
4bc0: 20 4f 3d 28 63 68 61 72 2a 29 44 3b 20 7d 65 6c O=(char*)D; }el
4bd0: 73 65 20 5c 0a 20 20 20 20 69 66 28 20 28 4f 3d se \. if( (O=
4be0: 28 63 68 61 72 2a 29 28 50 2d 3e 78 43 6f 64 65 (char*)(P->xCode
4bf0: 63 28 50 2d 3e 70 43 6f 64 65 63 2c 44 2c 4e 2c c(P->pCodec,D,N,
4c00: 58 29 29 29 3d 3d 30 20 29 7b 20 45 3b 20 7d 0a X)))==0 ){ E; }.
4c10: 23 65 6c 73 65 0a 23 20 64 65 66 69 6e 65 20 43 #else.# define C
4c20: 4f 44 45 43 31 28 50 2c 44 2c 4e 2c 58 2c 45 29 ODEC1(P,D,N,X,E)
4c30: 20 20 20 2f 2a 20 4e 4f 2d 4f 50 20 2a 2f 0a 23 /* NO-OP */.#
4c40: 20 64 65 66 69 6e 65 20 43 4f 44 45 43 32 28 50 define CODEC2(P
4c50: 2c 44 2c 4e 2c 58 2c 45 2c 4f 29 20 4f 3d 28 63 ,D,N,X,E,O) O=(c
4c60: 68 61 72 2a 29 44 0a 23 65 6e 64 69 66 0a 0a 2f har*)D.#endif../
4c70: 2a 0a 2a 2a 20 54 68 65 20 6d 61 78 69 6d 75 6d *.** The maximum
4c80: 20 61 6c 6c 6f 77 65 64 20 73 65 63 74 6f 72 20 allowed sector
4c90: 73 69 7a 65 2e 20 36 34 4b 69 42 2e 20 49 66 20 size. 64KiB. If
4ca0: 74 68 65 20 78 53 65 63 74 6f 72 73 69 7a 65 28 the xSectorsize(
4cb0: 29 20 6d 65 74 68 6f 64 20 0a 2a 2a 20 72 65 74 ) method .** ret
4cc0: 75 72 6e 73 20 61 20 76 61 6c 75 65 20 6c 61 72 urns a value lar
4cd0: 67 65 72 20 74 68 61 6e 20 74 68 69 73 2c 20 74 ger than this, t
4ce0: 68 65 6e 20 4d 41 58 5f 53 45 43 54 4f 52 5f 53 hen MAX_SECTOR_S
4cf0: 49 5a 45 20 69 73 20 75 73 65 64 20 69 6e 73 74 IZE is used inst
4d00: 65 61 64 2e 0a 2a 2a 20 54 68 69 73 20 63 6f 75 ead..** This cou
4d10: 6c 64 20 63 6f 6e 63 65 69 76 61 62 6c 79 20 63 ld conceivably c
4d20: 61 75 73 65 20 63 6f 72 72 75 70 74 69 6f 6e 20 ause corruption
4d30: 66 6f 6c 6c 6f 77 69 6e 67 20 61 20 70 6f 77 65 following a powe
4d40: 72 20 66 61 69 6c 75 72 65 20 6f 6e 0a 2a 2a 20 r failure on.**
4d50: 73 75 63 68 20 61 20 73 79 73 74 65 6d 2e 20 54 such a system. T
4d60: 68 69 73 20 69 73 20 63 75 72 72 65 6e 74 6c 79 his is currently
4d70: 20 61 6e 20 75 6e 64 6f 63 75 6d 65 6e 74 65 64 an undocumented
4d80: 20 6c 69 6d 69 74 2e 0a 2a 2f 0a 23 64 65 66 69 limit..*/.#defi
4d90: 6e 65 20 4d 41 58 5f 53 45 43 54 4f 52 5f 53 49 ne MAX_SECTOR_SI
4da0: 5a 45 20 30 78 31 30 30 30 30 0a 0a 2f 2a 0a 2a ZE 0x10000../*.*
4db0: 2a 20 41 6e 20 69 6e 73 74 61 6e 63 65 20 6f 66 * An instance of
4dc0: 20 74 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 73 the following s
4dd0: 74 72 75 63 74 75 72 65 20 69 73 20 61 6c 6c 6f tructure is allo
4de0: 63 61 74 65 64 20 66 6f 72 20 65 61 63 68 20 61 cated for each a
4df0: 63 74 69 76 65 0a 2a 2a 20 73 61 76 65 70 6f 69 ctive.** savepoi
4e00: 6e 74 20 61 6e 64 20 73 74 61 74 65 6d 65 6e 74 nt and statement
4e10: 20 74 72 61 6e 73 61 63 74 69 6f 6e 20 69 6e 20 transaction in
4e20: 74 68 65 20 73 79 73 74 65 6d 2e 20 41 6c 6c 20 the system. All
4e30: 73 75 63 68 20 73 74 72 75 63 74 75 72 65 73 0a such structures.
4e40: 2a 2a 20 61 72 65 20 73 74 6f 72 65 64 20 69 6e ** are stored in
4e50: 20 74 68 65 20 50 61 67 65 72 2e 61 53 61 76 65 the Pager.aSave
4e60: 70 6f 69 6e 74 5b 5d 20 61 72 72 61 79 2c 20 77 point[] array, w
4e70: 68 69 63 68 20 69 73 20 61 6c 6c 6f 63 61 74 65 hich is allocate
4e80: 64 20 61 6e 64 0a 2a 2a 20 72 65 73 69 7a 65 64 d and.** resized
4e90: 20 75 73 69 6e 67 20 73 71 6c 69 74 65 33 52 65 using sqlite3Re
4ea0: 61 6c 6c 6f 63 28 29 2e 0a 2a 2a 0a 2a 2a 20 57 alloc()..**.** W
4eb0: 68 65 6e 20 61 20 73 61 76 65 70 6f 69 6e 74 20 hen a savepoint
4ec0: 69 73 20 63 72 65 61 74 65 64 2c 20 74 68 65 20 is created, the
4ed0: 50 61 67 65 72 53 61 76 65 70 6f 69 6e 74 2e 69 PagerSavepoint.i
4ee0: 48 64 72 4f 66 66 73 65 74 20 66 69 65 6c 64 20 HdrOffset field
4ef0: 69 73 0a 2a 2a 20 73 65 74 20 74 6f 20 30 2e 20 is.** set to 0.
4f00: 49 66 20 61 20 6a 6f 75 72 6e 61 6c 2d 68 65 61 If a journal-hea
4f10: 64 65 72 20 69 73 20 77 72 69 74 74 65 6e 20 69 der is written i
4f20: 6e 74 6f 20 74 68 65 20 6d 61 69 6e 20 6a 6f 75 nto the main jou
4f30: 72 6e 61 6c 20 77 68 69 6c 65 0a 2a 2a 20 74 68 rnal while.** th
4f40: 65 20 73 61 76 65 70 6f 69 6e 74 20 69 73 20 61 e savepoint is a
4f50: 63 74 69 76 65 2c 20 74 68 65 6e 20 69 48 64 72 ctive, then iHdr
4f60: 4f 66 66 73 65 74 20 69 73 20 73 65 74 20 74 6f Offset is set to
4f70: 20 74 68 65 20 62 79 74 65 20 6f 66 66 73 65 74 the byte offset
4f80: 20 0a 2a 2a 20 69 6d 6d 65 64 69 61 74 65 6c 79 .** immediately
4f90: 20 66 6f 6c 6c 6f 77 69 6e 67 20 74 68 65 20 6c following the l
4fa0: 61 73 74 20 6a 6f 75 72 6e 61 6c 20 72 65 63 6f ast journal reco
4fb0: 72 64 20 77 72 69 74 74 65 6e 20 69 6e 74 6f 20 rd written into
4fc0: 74 68 65 20 6d 61 69 6e 0a 2a 2a 20 6a 6f 75 72 the main.** jour
4fd0: 6e 61 6c 20 62 65 66 6f 72 65 20 74 68 65 20 6a nal before the j
4fe0: 6f 75 72 6e 61 6c 2d 68 65 61 64 65 72 2e 20 54 ournal-header. T
4ff0: 68 69 73 20 69 73 20 72 65 71 75 69 72 65 64 20 his is required
5000: 64 75 72 69 6e 67 20 73 61 76 65 70 6f 69 6e 74 during savepoint
5010: 0a 2a 2a 20 72 6f 6c 6c 62 61 63 6b 20 28 73 65 .** rollback (se
5020: 65 20 70 61 67 65 72 50 6c 61 79 62 61 63 6b 53 e pagerPlaybackS
5030: 61 76 65 70 6f 69 6e 74 28 29 29 2e 0a 2a 2f 0a avepoint())..*/.
5040: 74 79 70 65 64 65 66 20 73 74 72 75 63 74 20 50 typedef struct P
5050: 61 67 65 72 53 61 76 65 70 6f 69 6e 74 20 50 61 agerSavepoint Pa
5060: 67 65 72 53 61 76 65 70 6f 69 6e 74 3b 0a 73 74 gerSavepoint;.st
5070: 72 75 63 74 20 50 61 67 65 72 53 61 76 65 70 6f ruct PagerSavepo
5080: 69 6e 74 20 7b 0a 20 20 69 36 34 20 69 4f 66 66 int {. i64 iOff
5090: 73 65 74 3b 20 20 20 20 20 20 20 20 20 20 20 20 set;
50a0: 20 20 20 20 20 2f 2a 20 53 74 61 72 74 69 6e 67 /* Starting
50b0: 20 6f 66 66 73 65 74 20 69 6e 20 6d 61 69 6e 20 offset in main
50c0: 6a 6f 75 72 6e 61 6c 20 2a 2f 0a 20 20 69 36 34 journal */. i64
50d0: 20 69 48 64 72 4f 66 66 73 65 74 3b 20 20 20 20 iHdrOffset;
50e0: 20 20 20 20 20 20 20 20 20 20 2f 2a 20 53 65 65 /* See
50f0: 20 61 62 6f 76 65 20 2a 2f 0a 20 20 42 69 74 76 above */. Bitv
5100: 65 63 20 2a 70 49 6e 53 61 76 65 70 6f 69 6e 74 ec *pInSavepoint
5110: 3b 20 20 20 20 20 20 20 20 2f 2a 20 53 65 74 20 ; /* Set
5120: 6f 66 20 70 61 67 65 73 20 69 6e 20 74 68 69 73 of pages in this
5130: 20 73 61 76 65 70 6f 69 6e 74 20 2a 2f 0a 20 20 savepoint */.
5140: 50 67 6e 6f 20 6e 4f 72 69 67 3b 20 20 20 20 20 Pgno nOrig;
5150: 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 /*
5160: 4f 72 69 67 69 6e 61 6c 20 6e 75 6d 62 65 72 20 Original number
5170: 6f 66 20 70 61 67 65 73 20 69 6e 20 66 69 6c 65 of pages in file
5180: 20 2a 2f 0a 20 20 50 67 6e 6f 20 69 53 75 62 52 */. Pgno iSubR
5190: 65 63 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 ec;
51a0: 20 20 20 2f 2a 20 49 6e 64 65 78 20 6f 66 20 66 /* Index of f
51b0: 69 72 73 74 20 72 65 63 6f 72 64 20 69 6e 20 73 irst record in s
51c0: 75 62 2d 6a 6f 75 72 6e 61 6c 20 2a 2f 0a 23 69 ub-journal */.#i
51d0: 66 6e 64 65 66 20 53 51 4c 49 54 45 5f 4f 4d 49 fndef SQLITE_OMI
51e0: 54 5f 57 41 4c 0a 20 20 75 33 32 20 61 57 61 6c T_WAL. u32 aWal
51f0: 44 61 74 61 5b 57 41 4c 5f 53 41 56 45 50 4f 49 Data[WAL_SAVEPOI
5200: 4e 54 5f 4e 44 41 54 41 5d 3b 20 20 20 20 20 20 NT_NDATA];
5210: 20 20 2f 2a 20 57 41 4c 20 73 61 76 65 70 6f 69 /* WAL savepoi
5220: 6e 74 20 63 6f 6e 74 65 78 74 20 2a 2f 0a 23 65 nt context */.#e
5230: 6e 64 69 66 0a 7d 3b 0a 0a 2f 2a 0a 2a 2a 20 41 ndif.};../*.** A
5240: 20 6f 70 65 6e 20 70 61 67 65 20 63 61 63 68 65 open page cache
5250: 20 69 73 20 61 6e 20 69 6e 73 74 61 6e 63 65 20 is an instance
5260: 6f 66 20 73 74 72 75 63 74 20 50 61 67 65 72 2e of struct Pager.
5270: 20 41 20 64 65 73 63 72 69 70 74 69 6f 6e 20 6f A description o
5280: 66 0a 2a 2a 20 73 6f 6d 65 20 6f 66 20 74 68 65 f.** some of the
5290: 20 6d 6f 72 65 20 69 6d 70 6f 72 74 61 6e 74 20 more important
52a0: 6d 65 6d 62 65 72 20 76 61 72 69 61 62 6c 65 73 member variables
52b0: 20 66 6f 6c 6c 6f 77 73 3a 0a 2a 2a 0a 2a 2a 20 follows:.**.**
52c0: 65 53 74 61 74 65 0a 2a 2a 0a 2a 2a 20 20 20 54 eState.**.** T
52d0: 68 65 20 63 75 72 72 65 6e 74 20 27 73 74 61 74 he current 'stat
52e0: 65 27 20 6f 66 20 74 68 65 20 70 61 67 65 72 20 e' of the pager
52f0: 6f 62 6a 65 63 74 2e 20 53 65 65 20 74 68 65 20 object. See the
5300: 63 6f 6d 6d 65 6e 74 20 61 6e 64 20 73 74 61 74 comment and stat
5310: 65 0a 2a 2a 20 20 20 64 69 61 67 72 61 6d 20 61 e.** diagram a
5320: 62 6f 76 65 20 66 6f 72 20 61 20 64 65 73 63 72 bove for a descr
5330: 69 70 74 69 6f 6e 20 6f 66 20 74 68 65 20 70 61 iption of the pa
5340: 67 65 72 20 73 74 61 74 65 2e 0a 2a 2a 0a 2a 2a ger state..**.**
5350: 20 65 4c 6f 63 6b 0a 2a 2a 0a 2a 2a 20 20 20 46 eLock.**.** F
5360: 6f 72 20 61 20 72 65 61 6c 20 6f 6e 2d 64 69 73 or a real on-dis
5370: 6b 20 64 61 74 61 62 61 73 65 2c 20 74 68 65 20 k database, the
5380: 63 75 72 72 65 6e 74 20 6c 6f 63 6b 20 68 65 6c current lock hel
5390: 64 20 6f 6e 20 74 68 65 20 64 61 74 61 62 61 73 d on the databas
53a0: 65 20 66 69 6c 65 20 2d 0a 2a 2a 20 20 20 4e 4f e file -.** NO
53b0: 5f 4c 4f 43 4b 2c 20 53 48 41 52 45 44 5f 4c 4f _LOCK, SHARED_LO
53c0: 43 4b 2c 20 52 45 53 45 52 56 45 44 5f 4c 4f 43 CK, RESERVED_LOC
53d0: 4b 20 6f 72 20 45 58 43 4c 55 53 49 56 45 5f 4c K or EXCLUSIVE_L
53e0: 4f 43 4b 2e 0a 2a 2a 0a 2a 2a 20 20 20 46 6f 72 OCK..**.** For
53f0: 20 61 20 74 65 6d 70 6f 72 61 72 79 20 6f 72 20 a temporary or
5400: 69 6e 2d 6d 65 6d 6f 72 79 20 64 61 74 61 62 61 in-memory databa
5410: 73 65 20 28 6e 65 69 74 68 65 72 20 6f 66 20 77 se (neither of w
5420: 68 69 63 68 20 72 65 71 75 69 72 65 20 61 6e 79 hich require any
5430: 0a 2a 2a 20 20 20 6c 6f 63 6b 73 29 2c 20 74 68 .** locks), th
5440: 69 73 20 76 61 72 69 61 62 6c 65 20 69 73 20 61 is variable is a
5450: 6c 77 61 79 73 20 73 65 74 20 74 6f 20 45 58 43 lways set to EXC
5460: 4c 55 53 49 56 45 5f 4c 4f 43 4b 2e 20 53 69 6e LUSIVE_LOCK. Sin
5470: 63 65 20 73 75 63 68 0a 2a 2a 20 20 20 64 61 74 ce such.** dat
5480: 61 62 61 73 65 73 20 61 6c 77 61 79 73 20 68 61 abases always ha
5490: 76 65 20 50 61 67 65 72 2e 65 78 63 6c 75 73 69 ve Pager.exclusi
54a0: 76 65 4d 6f 64 65 3d 3d 31 2c 20 74 68 69 73 20 veMode==1, this
54b0: 74 72 69 63 6b 73 20 74 68 65 20 70 61 67 65 72 tricks the pager
54c0: 0a 2a 2a 20 20 20 6c 6f 67 69 63 20 69 6e 74 6f .** logic into
54d0: 20 74 68 69 6e 6b 69 6e 67 20 74 68 61 74 20 69 thinking that i
54e0: 74 20 61 6c 72 65 61 64 79 20 68 61 73 20 61 6c t already has al
54f0: 6c 20 74 68 65 20 6c 6f 63 6b 73 20 69 74 20 77 l the locks it w
5500: 69 6c 6c 20 65 76 65 72 0a 2a 2a 20 20 20 6e 65 ill ever.** ne
5510: 65 64 20 28 61 6e 64 20 6e 6f 20 72 65 61 73 6f ed (and no reaso
5520: 6e 20 74 6f 20 72 65 6c 65 61 73 65 20 74 68 65 n to release the
5530: 6d 29 2e 0a 2a 2a 0a 2a 2a 20 20 20 49 6e 20 73 m)..**.** In s
5540: 6f 6d 65 20 28 6f 62 73 63 75 72 65 29 20 63 69 ome (obscure) ci
5550: 72 63 75 6d 73 74 61 6e 63 65 73 2c 20 74 68 69 rcumstances, thi
5560: 73 20 76 61 72 69 61 62 6c 65 20 6d 61 79 20 61 s variable may a
5570: 6c 73 6f 20 62 65 20 73 65 74 20 74 6f 0a 2a 2a lso be set to.**
5580: 20 20 20 55 4e 4b 4e 4f 57 4e 5f 4c 4f 43 4b 2e UNKNOWN_LOCK.
5590: 20 53 65 65 20 74 68 65 20 63 6f 6d 6d 65 6e 74 See the comment
55a0: 20 61 62 6f 76 65 20 74 68 65 20 23 64 65 66 69 above the #defi
55b0: 6e 65 20 6f 66 20 55 4e 4b 4e 4f 57 4e 5f 4c 4f ne of UNKNOWN_LO
55c0: 43 4b 20 66 6f 72 0a 2a 2a 20 20 20 64 65 74 61 CK for.** deta
55d0: 69 6c 73 2e 0a 2a 2a 0a 2a 2a 20 63 68 61 6e 67 ils..**.** chang
55e0: 65 43 6f 75 6e 74 44 6f 6e 65 0a 2a 2a 0a 2a 2a eCountDone.**.**
55f0: 20 20 20 54 68 69 73 20 62 6f 6f 6c 65 61 6e 20 This boolean
5600: 76 61 72 69 61 62 6c 65 20 69 73 20 75 73 65 64 variable is used
5610: 20 74 6f 20 6d 61 6b 65 20 73 75 72 65 20 74 68 to make sure th
5620: 61 74 20 74 68 65 20 63 68 61 6e 67 65 2d 63 6f at the change-co
5630: 75 6e 74 65 72 20 0a 2a 2a 20 20 20 28 74 68 65 unter .** (the
5640: 20 34 2d 62 79 74 65 20 68 65 61 64 65 72 20 66 4-byte header f
5650: 69 65 6c 64 20 61 74 20 62 79 74 65 20 6f 66 66 ield at byte off
5660: 73 65 74 20 32 34 20 6f 66 20 74 68 65 20 64 61 set 24 of the da
5670: 74 61 62 61 73 65 20 66 69 6c 65 29 20 69 73 20 tabase file) is
5680: 0a 2a 2a 20 20 20 6e 6f 74 20 75 70 64 61 74 65 .** not update
5690: 64 20 6d 6f 72 65 20 6f 66 74 65 6e 20 74 68 61 d more often tha
56a0: 6e 20 6e 65 63 65 73 73 61 72 79 2e 20 0a 2a 2a n necessary. .**
56b0: 0a 2a 2a 20 20 20 49 74 20 69 73 20 73 65 74 20 .** It is set
56c0: 74 6f 20 74 72 75 65 20 77 68 65 6e 20 74 68 65 to true when the
56d0: 20 63 68 61 6e 67 65 2d 63 6f 75 6e 74 65 72 20 change-counter
56e0: 66 69 65 6c 64 20 69 73 20 75 70 64 61 74 65 64 field is updated
56f0: 2c 20 77 68 69 63 68 20 0a 2a 2a 20 20 20 63 61 , which .** ca
5700: 6e 20 6f 6e 6c 79 20 68 61 70 70 65 6e 20 69 66 n only happen if
5710: 20 61 6e 20 65 78 63 6c 75 73 69 76 65 20 6c 6f an exclusive lo
5720: 63 6b 20 69 73 20 68 65 6c 64 20 6f 6e 20 74 68 ck is held on th
5730: 65 20 64 61 74 61 62 61 73 65 20 66 69 6c 65 2e e database file.
5740: 0a 2a 2a 20 20 20 49 74 20 69 73 20 63 6c 65 61 .** It is clea
5750: 72 65 64 20 28 73 65 74 20 74 6f 20 66 61 6c 73 red (set to fals
5760: 65 29 20 77 68 65 6e 65 76 65 72 20 61 6e 20 65 e) whenever an e
5770: 78 63 6c 75 73 69 76 65 20 6c 6f 63 6b 20 69 73 xclusive lock is
5780: 20 0a 2a 2a 20 20 20 72 65 6c 69 6e 71 75 69 73 .** relinquis
5790: 68 65 64 20 6f 6e 20 74 68 65 20 64 61 74 61 62 hed on the datab
57a0: 61 73 65 20 66 69 6c 65 2e 20 45 61 63 68 20 74 ase file. Each t
57b0: 69 6d 65 20 61 20 74 72 61 6e 73 61 63 74 69 6f ime a transactio
57c0: 6e 20 69 73 20 63 6f 6d 6d 69 74 74 65 64 2c 0a n is committed,.
57d0: 2a 2a 20 20 20 54 68 65 20 63 68 61 6e 67 65 43 ** The changeC
57e0: 6f 75 6e 74 44 6f 6e 65 20 66 6c 61 67 20 69 73 ountDone flag is
57f0: 20 69 6e 73 70 65 63 74 65 64 2e 20 49 66 20 69 inspected. If i
5800: 74 20 69 73 20 74 72 75 65 2c 20 74 68 65 20 77 t is true, the w
5810: 6f 72 6b 20 6f 66 0a 2a 2a 20 20 20 75 70 64 61 ork of.** upda
5820: 74 69 6e 67 20 74 68 65 20 63 68 61 6e 67 65 2d ting the change-
5830: 63 6f 75 6e 74 65 72 20 69 73 20 6f 6d 69 74 74 counter is omitt
5840: 65 64 20 66 6f 72 20 74 68 65 20 63 75 72 72 65 ed for the curre
5850: 6e 74 20 74 72 61 6e 73 61 63 74 69 6f 6e 2e 0a nt transaction..
5860: 2a 2a 0a 2a 2a 20 20 20 54 68 69 73 20 6d 65 63 **.** This mec
5870: 68 61 6e 69 73 6d 20 6d 65 61 6e 73 20 74 68 61 hanism means tha
5880: 74 20 77 68 65 6e 20 72 75 6e 6e 69 6e 67 20 69 t when running i
5890: 6e 20 65 78 63 6c 75 73 69 76 65 20 6d 6f 64 65 n exclusive mode
58a0: 2c 20 61 20 63 6f 6e 6e 65 63 74 69 6f 6e 20 0a , a connection .
58b0: 2a 2a 20 20 20 6e 65 65 64 20 6f 6e 6c 79 20 75 ** need only u
58c0: 70 64 61 74 65 20 74 68 65 20 63 68 61 6e 67 65 pdate the change
58d0: 2d 63 6f 75 6e 74 65 72 20 6f 6e 63 65 2c 20 66 -counter once, f
58e0: 6f 72 20 74 68 65 20 66 69 72 73 74 20 74 72 61 or the first tra
58f0: 6e 73 61 63 74 69 6f 6e 0a 2a 2a 20 20 20 63 6f nsaction.** co
5900: 6d 6d 69 74 74 65 64 2e 0a 2a 2a 0a 2a 2a 20 73 mmitted..**.** s
5910: 65 74 4d 61 73 74 65 72 0a 2a 2a 0a 2a 2a 20 20 etMaster.**.**
5920: 20 57 68 65 6e 20 50 61 67 65 72 43 6f 6d 6d 69 When PagerCommi
5930: 74 50 68 61 73 65 4f 6e 65 28 29 20 69 73 20 63 tPhaseOne() is c
5940: 61 6c 6c 65 64 20 74 6f 20 63 6f 6d 6d 69 74 20 alled to commit
5950: 61 20 74 72 61 6e 73 61 63 74 69 6f 6e 2c 20 69 a transaction, i
5960: 74 20 6d 61 79 0a 2a 2a 20 20 20 28 6f 72 20 6d t may.** (or m
5970: 61 79 20 6e 6f 74 29 20 73 70 65 63 69 66 79 20 ay not) specify
5980: 61 20 6d 61 73 74 65 72 2d 6a 6f 75 72 6e 61 6c a master-journal
5990: 20 6e 61 6d 65 20 74 6f 20 62 65 20 77 72 69 74 name to be writ
59a0: 74 65 6e 20 69 6e 74 6f 20 74 68 65 20 0a 2a 2a ten into the .**
59b0: 20 20 20 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 20 journal file
59c0: 62 65 66 6f 72 65 20 69 74 20 69 73 20 73 79 6e before it is syn
59d0: 63 65 64 20 74 6f 20 64 69 73 6b 2e 0a 2a 2a 0a ced to disk..**.
59e0: 2a 2a 20 20 20 57 68 65 74 68 65 72 20 6f 72 20 ** Whether or
59f0: 6e 6f 74 20 61 20 6a 6f 75 72 6e 61 6c 20 66 69 not a journal fi
5a00: 6c 65 20 63 6f 6e 74 61 69 6e 73 20 61 20 6d 61 le contains a ma
5a10: 73 74 65 72 2d 6a 6f 75 72 6e 61 6c 20 70 6f 69 ster-journal poi
5a20: 6e 74 65 72 20 61 66 66 65 63 74 73 20 0a 2a 2a nter affects .**
5a30: 20 20 20 74 68 65 20 77 61 79 20 69 6e 20 77 68 the way in wh
5a40: 69 63 68 20 74 68 65 20 6a 6f 75 72 6e 61 6c 20 ich the journal
5a50: 66 69 6c 65 20 69 73 20 66 69 6e 61 6c 69 7a 65 file is finalize
5a60: 64 20 61 66 74 65 72 20 74 68 65 20 74 72 61 6e d after the tran
5a70: 73 61 63 74 69 6f 6e 20 69 73 20 0a 2a 2a 20 20 saction is .**
5a80: 20 63 6f 6d 6d 69 74 74 65 64 20 6f 72 20 72 6f committed or ro
5a90: 6c 6c 65 64 20 62 61 63 6b 20 77 68 65 6e 20 72 lled back when r
5aa0: 75 6e 6e 69 6e 67 20 69 6e 20 22 6a 6f 75 72 6e unning in "journ
5ab0: 61 6c 5f 6d 6f 64 65 3d 50 45 52 53 49 53 54 22 al_mode=PERSIST"
5ac0: 20 6d 6f 64 65 2e 0a 2a 2a 20 20 20 49 66 20 61 mode..** If a
5ad0: 20 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 20 64 6f journal file do
5ae0: 65 73 20 6e 6f 74 20 63 6f 6e 74 61 69 6e 20 61 es not contain a
5af0: 20 6d 61 73 74 65 72 2d 6a 6f 75 72 6e 61 6c 20 master-journal
5b00: 70 6f 69 6e 74 65 72 2c 20 69 74 20 69 73 0a 2a pointer, it is.*
5b10: 2a 20 20 20 66 69 6e 61 6c 69 7a 65 64 20 62 79 * finalized by
5b20: 20 6f 76 65 72 77 72 69 74 69 6e 67 20 74 68 65 overwriting the
5b30: 20 66 69 72 73 74 20 6a 6f 75 72 6e 61 6c 20 68 first journal h
5b40: 65 61 64 65 72 20 77 69 74 68 20 7a 65 72 6f 65 eader with zeroe
5b50: 73 2e 20 49 66 0a 2a 2a 20 20 20 69 74 20 64 6f s. If.** it do
5b60: 65 73 20 63 6f 6e 74 61 69 6e 20 61 20 6d 61 73 es contain a mas
5b70: 74 65 72 2d 6a 6f 75 72 6e 61 6c 20 70 6f 69 6e ter-journal poin
5b80: 74 65 72 20 74 68 65 20 6a 6f 75 72 6e 61 6c 20 ter the journal
5b90: 66 69 6c 65 20 69 73 20 66 69 6e 61 6c 69 7a 65 file is finalize
5ba0: 64 20 0a 2a 2a 20 20 20 62 79 20 74 72 75 6e 63 d .** by trunc
5bb0: 61 74 69 6e 67 20 69 74 20 74 6f 20 7a 65 72 6f ating it to zero
5bc0: 20 62 79 74 65 73 2c 20 6a 75 73 74 20 61 73 20 bytes, just as
5bd0: 69 66 20 74 68 65 20 63 6f 6e 6e 65 63 74 69 6f if the connectio
5be0: 6e 20 77 65 72 65 20 0a 2a 2a 20 20 20 72 75 6e n were .** run
5bf0: 6e 69 6e 67 20 69 6e 20 22 6a 6f 75 72 6e 61 6c ning in "journal
5c00: 5f 6d 6f 64 65 3d 74 72 75 6e 63 61 74 65 22 20 _mode=truncate"
5c10: 6d 6f 64 65 2e 0a 2a 2a 0a 2a 2a 20 20 20 4a 6f mode..**.** Jo
5c20: 75 72 6e 61 6c 20 66 69 6c 65 73 20 74 68 61 74 urnal files that
5c30: 20 63 6f 6e 74 61 69 6e 20 6d 61 73 74 65 72 20 contain master
5c40: 6a 6f 75 72 6e 61 6c 20 70 6f 69 6e 74 65 72 73 journal pointers
5c50: 20 63 61 6e 6e 6f 74 20 62 65 20 66 69 6e 61 6c cannot be final
5c60: 69 7a 65 64 0a 2a 2a 20 20 20 73 69 6d 70 6c 79 ized.** simply
5c70: 20 62 79 20 6f 76 65 72 77 72 69 74 69 6e 67 20 by overwriting
5c80: 74 68 65 20 66 69 72 73 74 20 6a 6f 75 72 6e 61 the first journa
5c90: 6c 2d 68 65 61 64 65 72 20 77 69 74 68 20 7a 65 l-header with ze
5ca0: 72 6f 65 73 2c 20 61 73 20 74 68 65 0a 2a 2a 20 roes, as the.**
5cb0: 20 20 6d 61 73 74 65 72 20 6a 6f 75 72 6e 61 6c master journal
5cc0: 20 70 6f 69 6e 74 65 72 20 63 6f 75 6c 64 20 69 pointer could i
5cd0: 6e 74 65 72 66 65 72 65 20 77 69 74 68 20 68 6f nterfere with ho
5ce0: 74 2d 6a 6f 75 72 6e 61 6c 20 72 6f 6c 6c 62 61 t-journal rollba
5cf0: 63 6b 20 6f 66 20 61 6e 79 0a 2a 2a 20 20 20 73 ck of any.** s
5d00: 75 62 73 65 71 75 65 6e 74 6c 79 20 69 6e 74 65 ubsequently inte
5d10: 72 72 75 70 74 65 64 20 74 72 61 6e 73 61 63 74 rrupted transact
5d20: 69 6f 6e 20 74 68 61 74 20 72 65 75 73 65 73 20 ion that reuses
5d30: 74 68 65 20 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 the journal file
5d40: 2e 0a 2a 2a 0a 2a 2a 20 20 20 54 68 65 20 66 6c ..**.** The fl
5d50: 61 67 20 69 73 20 63 6c 65 61 72 65 64 20 61 73 ag is cleared as
5d60: 20 73 6f 6f 6e 20 61 73 20 74 68 65 20 6a 6f 75 soon as the jou
5d70: 72 6e 61 6c 20 66 69 6c 65 20 69 73 20 66 69 6e rnal file is fin
5d80: 61 6c 69 7a 65 64 20 28 65 69 74 68 65 72 0a 2a alized (either.*
5d90: 2a 20 20 20 62 79 20 50 61 67 65 72 43 6f 6d 6d * by PagerComm
5da0: 69 74 50 68 61 73 65 54 77 6f 20 6f 72 20 50 61 itPhaseTwo or Pa
5db0: 67 65 72 52 6f 6c 6c 62 61 63 6b 29 2e 20 49 66 gerRollback). If
5dc0: 20 61 6e 20 49 4f 20 65 72 72 6f 72 20 70 72 65 an IO error pre
5dd0: 76 65 6e 74 73 20 74 68 65 0a 2a 2a 20 20 20 6a vents the.** j
5de0: 6f 75 72 6e 61 6c 20 66 69 6c 65 20 66 72 6f 6d ournal file from
5df0: 20 62 65 69 6e 67 20 73 75 63 63 65 73 73 66 75 being successfu
5e00: 6c 6c 79 20 66 69 6e 61 6c 69 7a 65 64 2c 20 74 lly finalized, t
5e10: 68 65 20 73 65 74 4d 61 73 74 65 72 20 66 6c 61 he setMaster fla
5e20: 67 0a 2a 2a 20 20 20 69 73 20 63 6c 65 61 72 65 g.** is cleare
5e30: 64 20 61 6e 79 77 61 79 20 28 61 6e 64 20 74 68 d anyway (and th
5e40: 65 20 70 61 67 65 72 20 77 69 6c 6c 20 6d 6f 76 e pager will mov
5e50: 65 20 74 6f 20 45 52 52 4f 52 20 73 74 61 74 65 e to ERROR state
5e60: 29 2e 0a 2a 2a 0a 2a 2a 20 64 6f 4e 6f 74 53 70 )..**.** doNotSp
5e70: 69 6c 6c 2c 20 64 6f 4e 6f 74 53 79 6e 63 53 70 ill, doNotSyncSp
5e80: 69 6c 6c 0a 2a 2a 0a 2a 2a 20 20 20 54 68 65 73 ill.**.** Thes
5e90: 65 20 74 77 6f 20 62 6f 6f 6c 65 61 6e 20 76 61 e two boolean va
5ea0: 72 69 61 62 6c 65 73 20 63 6f 6e 74 72 6f 6c 20 riables control
5eb0: 74 68 65 20 62 65 68 61 76 69 6f 75 72 20 6f 66 the behaviour of
5ec0: 20 63 61 63 68 65 2d 73 70 69 6c 6c 73 0a 2a 2a cache-spills.**
5ed0: 20 20 20 28 63 61 6c 6c 73 20 6d 61 64 65 20 62 (calls made b
5ee0: 79 20 74 68 65 20 70 63 61 63 68 65 20 6d 6f 64 y the pcache mod
5ef0: 75 6c 65 20 74 6f 20 74 68 65 20 70 61 67 65 72 ule to the pager
5f00: 53 74 72 65 73 73 28 29 20 72 6f 75 74 69 6e 65 Stress() routine
5f10: 20 74 6f 0a 2a 2a 20 20 20 77 72 69 74 65 20 63 to.** write c
5f20: 61 63 68 65 64 20 64 61 74 61 20 74 6f 20 74 68 ached data to th
5f30: 65 20 66 69 6c 65 2d 73 79 73 74 65 6d 20 69 6e e file-system in
5f40: 20 6f 72 64 65 72 20 74 6f 20 66 72 65 65 20 75 order to free u
5f50: 70 20 6d 65 6d 6f 72 79 29 2e 0a 2a 2a 0a 2a 2a p memory)..**.**
5f60: 20 20 20 57 68 65 6e 20 64 6f 4e 6f 74 53 70 69 When doNotSpi
5f70: 6c 6c 20 69 73 20 6e 6f 6e 2d 7a 65 72 6f 2c 20 ll is non-zero,
5f80: 77 72 69 74 69 6e 67 20 74 6f 20 74 68 65 20 64 writing to the d
5f90: 61 74 61 62 61 73 65 20 66 72 6f 6d 20 70 61 67 atabase from pag
5fa0: 65 72 53 74 72 65 73 73 28 29 0a 2a 2a 20 20 20 erStress().**
5fb0: 69 73 20 64 69 73 61 62 6c 65 64 20 61 6c 74 6f is disabled alto
5fc0: 67 65 74 68 65 72 2e 20 54 68 69 73 20 69 73 20 gether. This is
5fd0: 64 6f 6e 65 20 69 6e 20 61 20 76 65 72 79 20 6f done in a very o
5fe0: 62 73 63 75 72 65 20 63 61 73 65 20 74 68 61 74 bscure case that
5ff0: 0a 2a 2a 20 20 20 63 6f 6d 65 73 20 75 70 20 64 .** comes up d
6000: 75 72 69 6e 67 20 73 61 76 65 70 6f 69 6e 74 20 uring savepoint
6010: 72 6f 6c 6c 62 61 63 6b 20 74 68 61 74 20 72 65 rollback that re
6020: 71 75 69 72 65 73 20 74 68 65 20 70 63 61 63 68 quires the pcach
6030: 65 20 6d 6f 64 75 6c 65 0a 2a 2a 20 20 20 74 6f e module.** to
6040: 20 61 6c 6c 6f 63 61 74 65 20 61 20 6e 65 77 20 allocate a new
6050: 70 61 67 65 20 74 6f 20 70 72 65 76 65 6e 74 20 page to prevent
6060: 74 68 65 20 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 the journal file
6070: 20 66 72 6f 6d 20 62 65 69 6e 67 20 77 72 69 74 from being writ
6080: 74 65 6e 0a 2a 2a 20 20 20 77 68 69 6c 65 20 69 ten.** while i
6090: 74 20 69 73 20 62 65 69 6e 67 20 74 72 61 76 65 t is being trave
60a0: 72 73 65 64 20 62 79 20 63 6f 64 65 20 69 6e 20 rsed by code in
60b0: 70 61 67 65 72 5f 70 6c 61 79 62 61 63 6b 28 29 pager_playback()
60c0: 2e 0a 2a 2a 20 0a 2a 2a 20 20 20 49 66 20 64 6f ..** .** If do
60d0: 4e 6f 74 53 79 6e 63 53 70 69 6c 6c 20 69 73 20 NotSyncSpill is
60e0: 6e 6f 6e 2d 7a 65 72 6f 2c 20 77 72 69 74 69 6e non-zero, writin
60f0: 67 20 74 6f 20 74 68 65 20 64 61 74 61 62 61 73 g to the databas
6100: 65 20 66 72 6f 6d 20 70 61 67 65 72 53 74 72 65 e from pagerStre
6110: 73 73 28 29 0a 2a 2a 20 20 20 69 73 20 70 65 72 ss().** is per
6120: 6d 69 74 74 65 64 2c 20 62 75 74 20 73 79 6e 63 mitted, but sync
6130: 69 6e 67 20 74 68 65 20 6a 6f 75 72 6e 61 6c 20 ing the journal
6140: 66 69 6c 65 20 69 73 20 6e 6f 74 2e 20 54 68 69 file is not. Thi
6150: 73 20 66 6c 61 67 20 69 73 20 73 65 74 0a 2a 2a s flag is set.**
6160: 20 20 20 62 79 20 73 71 6c 69 74 65 33 50 61 67 by sqlite3Pag
6170: 65 72 57 72 69 74 65 28 29 20 77 68 65 6e 20 74 erWrite() when t
6180: 68 65 20 66 69 6c 65 2d 73 79 73 74 65 6d 20 73 he file-system s
6190: 65 63 74 6f 72 2d 73 69 7a 65 20 69 73 20 6c 61 ector-size is la
61a0: 72 67 65 72 20 74 68 61 6e 0a 2a 2a 20 20 20 74 rger than.** t
61b0: 68 65 20 64 61 74 61 62 61 73 65 20 70 61 67 65 he database page
61c0: 2d 73 69 7a 65 20 69 6e 20 6f 72 64 65 72 20 74 -size in order t
61d0: 6f 20 70 72 65 76 65 6e 74 20 61 20 6a 6f 75 72 o prevent a jour
61e0: 6e 61 6c 20 73 79 6e 63 20 66 72 6f 6d 20 68 61 nal sync from ha
61f0: 70 70 65 6e 69 6e 67 20 0a 2a 2a 20 20 20 69 6e ppening .** in
6200: 20 62 65 74 77 65 65 6e 20 74 68 65 20 6a 6f 75 between the jou
6210: 72 6e 61 6c 6c 69 6e 67 20 6f 66 20 74 77 6f 20 rnalling of two
6220: 70 61 67 65 73 20 6f 6e 20 74 68 65 20 73 61 6d pages on the sam
6230: 65 20 73 65 63 74 6f 72 2e 20 0a 2a 2a 0a 2a 2a e sector. .**.**
6240: 20 73 75 62 6a 49 6e 4d 65 6d 6f 72 79 0a 2a 2a subjInMemory.**
6250: 0a 2a 2a 20 20 20 54 68 69 73 20 69 73 20 61 20 .** This is a
6260: 62 6f 6f 6c 65 61 6e 20 76 61 72 69 61 62 6c 65 boolean variable
6270: 2e 20 49 66 20 74 72 75 65 2c 20 74 68 65 6e 20 . If true, then
6280: 61 6e 79 20 72 65 71 75 69 72 65 64 20 73 75 62 any required sub
6290: 2d 6a 6f 75 72 6e 61 6c 0a 2a 2a 20 20 20 69 73 -journal.** is
62a0: 20 6f 70 65 6e 65 64 20 61 73 20 61 6e 20 69 6e opened as an in
62b0: 2d 6d 65 6d 6f 72 79 20 6a 6f 75 72 6e 61 6c 20 -memory journal
62c0: 66 69 6c 65 2e 20 49 66 20 66 61 6c 73 65 2c 20 file. If false,
62d0: 74 68 65 6e 20 69 6e 2d 6d 65 6d 6f 72 79 0a 2a then in-memory.*
62e0: 2a 20 20 20 73 75 62 2d 6a 6f 75 72 6e 61 6c 73 * sub-journals
62f0: 20 61 72 65 20 6f 6e 6c 79 20 75 73 65 64 20 66 are only used f
6300: 6f 72 20 69 6e 2d 6d 65 6d 6f 72 79 20 70 61 67 or in-memory pag
6310: 65 72 20 66 69 6c 65 73 2e 0a 2a 2a 0a 2a 2a 20 er files..**.**
6320: 20 20 54 68 69 73 20 76 61 72 69 61 62 6c 65 20 This variable
6330: 69 73 20 75 70 64 61 74 65 64 20 62 79 20 74 68 is updated by th
6340: 65 20 75 70 70 65 72 20 6c 61 79 65 72 20 65 61 e upper layer ea
6350: 63 68 20 74 69 6d 65 20 61 20 6e 65 77 20 0a 2a ch time a new .*
6360: 2a 20 20 20 77 72 69 74 65 2d 74 72 61 6e 73 61 * write-transa
6370: 63 74 69 6f 6e 20 69 73 20 6f 70 65 6e 65 64 2e ction is opened.
6380: 0a 2a 2a 0a 2a 2a 20 64 62 53 69 7a 65 2c 20 64 .**.** dbSize, d
6390: 62 4f 72 69 67 53 69 7a 65 2c 20 64 62 46 69 6c bOrigSize, dbFil
63a0: 65 53 69 7a 65 0a 2a 2a 0a 2a 2a 20 20 20 56 61 eSize.**.** Va
63b0: 72 69 61 62 6c 65 20 64 62 53 69 7a 65 20 69 73 riable dbSize is
63c0: 20 73 65 74 20 74 6f 20 74 68 65 20 6e 75 6d 62 set to the numb
63d0: 65 72 20 6f 66 20 70 61 67 65 73 20 69 6e 20 74 er of pages in t
63e0: 68 65 20 64 61 74 61 62 61 73 65 20 66 69 6c 65 he database file
63f0: 2e 0a 2a 2a 20 20 20 49 74 20 69 73 20 76 61 6c ..** It is val
6400: 69 64 20 69 6e 20 50 41 47 45 52 5f 52 45 41 44 id in PAGER_READ
6410: 45 52 20 61 6e 64 20 68 69 67 68 65 72 20 73 74 ER and higher st
6420: 61 74 65 73 20 28 61 6c 6c 20 73 74 61 74 65 73 ates (all states
6430: 20 65 78 63 65 70 74 20 66 6f 72 0a 2a 2a 20 20 except for.**
6440: 20 4f 50 45 4e 20 61 6e 64 20 45 52 52 4f 52 29 OPEN and ERROR)
6450: 2e 20 0a 2a 2a 0a 2a 2a 20 20 20 64 62 53 69 7a . .**.** dbSiz
6460: 65 20 69 73 20 73 65 74 20 62 61 73 65 64 20 6f e is set based o
6470: 6e 20 74 68 65 20 73 69 7a 65 20 6f 66 20 74 68 n the size of th
6480: 65 20 64 61 74 61 62 61 73 65 20 66 69 6c 65 2c e database file,
6490: 20 77 68 69 63 68 20 6d 61 79 20 62 65 20 0a 2a which may be .*
64a0: 2a 20 20 20 6c 61 72 67 65 72 20 74 68 61 6e 20 * larger than
64b0: 74 68 65 20 73 69 7a 65 20 6f 66 20 74 68 65 20 the size of the
64c0: 64 61 74 61 62 61 73 65 20 28 74 68 65 20 76 61 database (the va
64d0: 6c 75 65 20 73 74 6f 72 65 64 20 61 74 20 6f 66 lue stored at of
64e0: 66 73 65 74 0a 2a 2a 20 20 20 32 38 20 6f 66 20 fset.** 28 of
64f0: 74 68 65 20 64 61 74 61 62 61 73 65 20 68 65 61 the database hea
6500: 64 65 72 20 62 79 20 74 68 65 20 62 74 72 65 65 der by the btree
6510: 29 2e 20 49 66 20 74 68 65 20 73 69 7a 65 20 6f ). If the size o
6520: 66 20 74 68 65 20 66 69 6c 65 0a 2a 2a 20 20 20 f the file.**
6530: 69 73 20 6e 6f 74 20 61 6e 20 69 6e 74 65 67 65 is not an intege
6540: 72 20 6d 75 6c 74 69 70 6c 65 20 6f 66 20 74 68 r multiple of th
6550: 65 20 70 61 67 65 2d 73 69 7a 65 2c 20 74 68 65 e page-size, the
6560: 20 76 61 6c 75 65 20 73 74 6f 72 65 64 20 69 6e value stored in
6570: 0a 2a 2a 20 20 20 64 62 53 69 7a 65 20 69 73 20 .** dbSize is
6580: 72 6f 75 6e 64 65 64 20 64 6f 77 6e 20 28 69 2e rounded down (i.
6590: 65 2e 20 61 20 35 4b 42 20 66 69 6c 65 20 77 69 e. a 5KB file wi
65a0: 74 68 20 32 4b 20 70 61 67 65 2d 73 69 7a 65 20 th 2K page-size
65b0: 68 61 73 20 64 62 53 69 7a 65 3d 3d 32 29 2e 0a has dbSize==2)..
65c0: 2a 2a 20 20 20 45 78 63 65 70 74 2c 20 61 6e 79 ** Except, any
65d0: 20 66 69 6c 65 20 74 68 61 74 20 69 73 20 67 72 file that is gr
65e0: 65 61 74 65 72 20 74 68 61 6e 20 30 20 62 79 74 eater than 0 byt
65f0: 65 73 20 69 6e 20 73 69 7a 65 20 69 73 20 63 6f es in size is co
6600: 6e 73 69 64 65 72 65 64 0a 2a 2a 20 20 20 74 6f nsidered.** to
6610: 20 68 61 76 65 20 61 74 20 6c 65 61 73 74 20 6f have at least o
6620: 6e 65 20 70 61 67 65 2e 20 28 69 2e 65 2e 20 61 ne page. (i.e. a
6630: 20 31 4b 42 20 66 69 6c 65 20 77 69 74 68 20 32 1KB file with 2
6640: 4b 20 70 61 67 65 2d 73 69 7a 65 20 6c 65 61 64 K page-size lead
6650: 73 0a 2a 2a 20 20 20 74 6f 20 64 62 53 69 7a 65 s.** to dbSize
6660: 3d 3d 31 29 2e 0a 2a 2a 0a 2a 2a 20 20 20 44 75 ==1)..**.** Du
6670: 72 69 6e 67 20 61 20 77 72 69 74 65 2d 74 72 61 ring a write-tra
6680: 6e 73 61 63 74 69 6f 6e 2c 20 69 66 20 70 61 67 nsaction, if pag
6690: 65 73 20 77 69 74 68 20 70 61 67 65 2d 6e 75 6d es with page-num
66a0: 62 65 72 73 20 67 72 65 61 74 65 72 20 74 68 61 bers greater tha
66b0: 6e 0a 2a 2a 20 20 20 64 62 53 69 7a 65 20 61 72 n.** dbSize ar
66c0: 65 20 6d 6f 64 69 66 69 65 64 20 69 6e 20 74 68 e modified in th
66d0: 65 20 63 61 63 68 65 2c 20 64 62 53 69 7a 65 20 e cache, dbSize
66e0: 69 73 20 75 70 64 61 74 65 64 20 61 63 63 6f 72 is updated accor
66f0: 64 69 6e 67 6c 79 2e 0a 2a 2a 20 20 20 53 69 6d dingly..** Sim
6700: 69 6c 61 72 6c 79 2c 20 69 66 20 74 68 65 20 64 ilarly, if the d
6710: 61 74 61 62 61 73 65 20 69 73 20 74 72 75 6e 63 atabase is trunc
6720: 61 74 65 64 20 75 73 69 6e 67 20 50 61 67 65 72 ated using Pager
6730: 54 72 75 6e 63 61 74 65 49 6d 61 67 65 28 29 2c TruncateImage(),
6740: 20 0a 2a 2a 20 20 20 64 62 53 69 7a 65 20 69 73 .** dbSize is
6750: 20 75 70 64 61 74 65 64 2e 0a 2a 2a 0a 2a 2a 20 updated..**.**
6760: 20 20 56 61 72 69 61 62 6c 65 73 20 64 62 4f 72 Variables dbOr
6770: 69 67 53 69 7a 65 20 61 6e 64 20 64 62 46 69 6c igSize and dbFil
6780: 65 53 69 7a 65 20 61 72 65 20 76 61 6c 69 64 20 eSize are valid
6790: 69 6e 20 73 74 61 74 65 73 20 0a 2a 2a 20 20 20 in states .**
67a0: 50 41 47 45 52 5f 57 52 49 54 45 52 5f 4c 4f 43 PAGER_WRITER_LOC
67b0: 4b 45 44 20 61 6e 64 20 68 69 67 68 65 72 2e 20 KED and higher.
67c0: 64 62 4f 72 69 67 53 69 7a 65 20 69 73 20 61 20 dbOrigSize is a
67d0: 63 6f 70 79 20 6f 66 20 74 68 65 20 64 62 53 69 copy of the dbSi
67e0: 7a 65 0a 2a 2a 20 20 20 76 61 72 69 61 62 6c 65 ze.** variable
67f0: 20 61 74 20 74 68 65 20 73 74 61 72 74 20 6f 66 at the start of
6800: 20 74 68 65 20 74 72 61 6e 73 61 63 74 69 6f 6e the transaction
6810: 2e 20 49 74 20 69 73 20 75 73 65 64 20 64 75 72 . It is used dur
6820: 69 6e 67 20 72 6f 6c 6c 62 61 63 6b 2c 0a 2a 2a ing rollback,.**
6830: 20 20 20 61 6e 64 20 74 6f 20 64 65 74 65 72 6d and to determ
6840: 69 6e 65 20 77 68 65 74 68 65 72 20 6f 72 20 6e ine whether or n
6850: 6f 74 20 70 61 67 65 73 20 6e 65 65 64 20 74 6f ot pages need to
6860: 20 62 65 20 6a 6f 75 72 6e 61 6c 6c 65 64 20 62 be journalled b
6870: 65 66 6f 72 65 0a 2a 2a 20 20 20 62 65 69 6e 67 efore.** being
6880: 20 6d 6f 64 69 66 69 65 64 2e 0a 2a 2a 0a 2a 2a modified..**.**
6890: 20 20 20 54 68 72 6f 75 67 68 6f 75 74 20 61 20 Throughout a
68a0: 77 72 69 74 65 2d 74 72 61 6e 73 61 63 74 69 6f write-transactio
68b0: 6e 2c 20 64 62 46 69 6c 65 53 69 7a 65 20 63 6f n, dbFileSize co
68c0: 6e 74 61 69 6e 73 20 74 68 65 20 73 69 7a 65 20 ntains the size
68d0: 6f 66 0a 2a 2a 20 20 20 74 68 65 20 66 69 6c 65 of.** the file
68e0: 20 6f 6e 20 64 69 73 6b 20 69 6e 20 70 61 67 65 on disk in page
68f0: 73 2e 20 49 74 20 69 73 20 73 65 74 20 74 6f 20 s. It is set to
6900: 61 20 63 6f 70 79 20 6f 66 20 64 62 53 69 7a 65 a copy of dbSize
6910: 20 77 68 65 6e 20 74 68 65 0a 2a 2a 20 20 20 77 when the.** w
6920: 72 69 74 65 2d 74 72 61 6e 73 61 63 74 69 6f 6e rite-transaction
6930: 20 69 73 20 66 69 72 73 74 20 6f 70 65 6e 65 64 is first opened
6940: 2c 20 61 6e 64 20 75 70 64 61 74 65 64 20 77 68 , and updated wh
6950: 65 6e 20 56 46 53 20 63 61 6c 6c 73 20 61 72 65 en VFS calls are
6960: 20 6d 61 64 65 0a 2a 2a 20 20 20 74 6f 20 77 72 made.** to wr
6970: 69 74 65 20 6f 72 20 74 72 75 6e 63 61 74 65 20 ite or truncate
6980: 74 68 65 20 64 61 74 61 62 61 73 65 20 66 69 6c the database fil
6990: 65 20 6f 6e 20 64 69 73 6b 2e 20 0a 2a 2a 0a 2a e on disk. .**.*
69a0: 2a 20 20 20 54 68 65 20 6f 6e 6c 79 20 72 65 61 * The only rea
69b0: 73 6f 6e 20 74 68 65 20 64 62 46 69 6c 65 53 69 son the dbFileSi
69c0: 7a 65 20 76 61 72 69 61 62 6c 65 20 69 73 20 72 ze variable is r
69d0: 65 71 75 69 72 65 64 20 69 73 20 74 6f 20 73 75 equired is to su
69e0: 70 70 72 65 73 73 20 0a 2a 2a 20 20 20 75 6e 6e ppress .** unn
69f0: 65 63 65 73 73 61 72 79 20 63 61 6c 6c 73 20 74 ecessary calls t
6a00: 6f 20 78 54 72 75 6e 63 61 74 65 28 29 20 61 66 o xTruncate() af
6a10: 74 65 72 20 63 6f 6d 6d 69 74 74 69 6e 67 20 61 ter committing a
6a20: 20 74 72 61 6e 73 61 63 74 69 6f 6e 2e 20 49 66 transaction. If
6a30: 2c 20 0a 2a 2a 20 20 20 77 68 65 6e 20 61 20 74 , .** when a t
6a40: 72 61 6e 73 61 63 74 69 6f 6e 20 69 73 20 63 6f ransaction is co
6a50: 6d 6d 69 74 74 65 64 2c 20 74 68 65 20 64 62 46 mmitted, the dbF
6a60: 69 6c 65 53 69 7a 65 20 76 61 72 69 61 62 6c 65 ileSize variable
6a70: 20 69 6e 64 69 63 61 74 65 73 20 0a 2a 2a 20 20 indicates .**
6a80: 20 74 68 61 74 20 74 68 65 20 64 61 74 61 62 61 that the databa
6a90: 73 65 20 66 69 6c 65 20 69 73 20 6c 61 72 67 65 se file is large
6aa0: 72 20 74 68 61 6e 20 74 68 65 20 64 61 74 61 62 r than the datab
6ab0: 61 73 65 20 69 6d 61 67 65 20 28 50 61 67 65 72 ase image (Pager
6ac0: 2e 64 62 53 69 7a 65 29 2c 20 0a 2a 2a 20 20 20 .dbSize), .**
6ad0: 70 61 67 65 72 5f 74 72 75 6e 63 61 74 65 28 29 pager_truncate()
6ae0: 20 69 73 20 63 61 6c 6c 65 64 2e 20 54 68 65 20 is called. The
6af0: 70 61 67 65 72 5f 74 72 75 6e 63 61 74 65 28 29 pager_truncate()
6b00: 20 63 61 6c 6c 20 75 73 65 73 20 78 46 69 6c 65 call uses xFile
6b10: 73 69 7a 65 28 29 0a 2a 2a 20 20 20 74 6f 20 6d size().** to m
6b20: 65 61 73 75 72 65 20 74 68 65 20 64 61 74 61 62 easure the datab
6b30: 61 73 65 20 66 69 6c 65 20 6f 6e 20 64 69 73 6b ase file on disk
6b40: 2c 20 61 6e 64 20 74 68 65 6e 20 74 72 75 6e 63 , and then trunc
6b50: 61 74 65 73 20 69 74 20 69 66 20 72 65 71 75 69 ates it if requi
6b60: 72 65 64 2e 0a 2a 2a 20 20 20 64 62 46 69 6c 65 red..** dbFile
6b70: 53 69 7a 65 20 69 73 20 6e 6f 74 20 75 73 65 64 Size is not used
6b80: 20 77 68 65 6e 20 72 6f 6c 6c 69 6e 67 20 62 61 when rolling ba
6b90: 63 6b 20 61 20 74 72 61 6e 73 61 63 74 69 6f 6e ck a transaction
6ba0: 2e 20 49 6e 20 74 68 69 73 20 63 61 73 65 0a 2a . In this case.*
6bb0: 2a 20 20 20 70 61 67 65 72 5f 74 72 75 6e 63 61 * pager_trunca
6bc0: 74 65 28 29 20 69 73 20 63 61 6c 6c 65 64 20 75 te() is called u
6bd0: 6e 63 6f 6e 64 69 74 69 6f 6e 61 6c 6c 79 20 28 nconditionally (
6be0: 77 68 69 63 68 20 6d 65 61 6e 73 20 74 68 65 72 which means ther
6bf0: 65 20 6d 61 79 20 62 65 0a 2a 2a 20 20 20 61 20 e may be.** a
6c00: 63 61 6c 6c 20 74 6f 20 78 46 69 6c 65 73 69 7a call to xFilesiz
6c10: 65 28 29 20 74 68 61 74 20 69 73 20 6e 6f 74 20 e() that is not
6c20: 73 74 72 69 63 74 6c 79 20 72 65 71 75 69 72 65 strictly require
6c30: 64 29 2e 20 49 6e 20 65 69 74 68 65 72 20 63 61 d). In either ca
6c40: 73 65 2c 0a 2a 2a 20 20 20 70 61 67 65 72 5f 74 se,.** pager_t
6c50: 72 75 6e 63 61 74 65 28 29 20 6d 61 79 20 63 61 runcate() may ca
6c60: 75 73 65 20 74 68 65 20 66 69 6c 65 20 74 6f 20 use the file to
6c70: 62 65 63 6f 6d 65 20 73 6d 61 6c 6c 65 72 20 6f become smaller o
6c80: 72 20 6c 61 72 67 65 72 2e 0a 2a 2a 0a 2a 2a 20 r larger..**.**
6c90: 64 62 48 69 6e 74 53 69 7a 65 0a 2a 2a 0a 2a 2a dbHintSize.**.**
6ca0: 20 20 20 54 68 65 20 64 62 48 69 6e 74 53 69 7a The dbHintSiz
6cb0: 65 20 76 61 72 69 61 62 6c 65 20 69 73 20 75 73 e variable is us
6cc0: 65 64 20 74 6f 20 6c 69 6d 69 74 20 74 68 65 20 ed to limit the
6cd0: 6e 75 6d 62 65 72 20 6f 66 20 63 61 6c 6c 73 20 number of calls
6ce0: 6d 61 64 65 20 74 6f 0a 2a 2a 20 20 20 74 68 65 made to.** the
6cf0: 20 56 46 53 20 78 46 69 6c 65 43 6f 6e 74 72 6f VFS xFileContro
6d00: 6c 28 46 43 4e 54 4c 5f 53 49 5a 45 5f 48 49 4e l(FCNTL_SIZE_HIN
6d10: 54 29 20 6d 65 74 68 6f 64 2e 20 0a 2a 2a 0a 2a T) method. .**.*
6d20: 2a 20 20 20 64 62 48 69 6e 74 53 69 7a 65 20 69 * dbHintSize i
6d30: 73 20 73 65 74 20 74 6f 20 61 20 63 6f 70 79 20 s set to a copy
6d40: 6f 66 20 74 68 65 20 64 62 53 69 7a 65 20 76 61 of the dbSize va
6d50: 72 69 61 62 6c 65 20 77 68 65 6e 20 61 0a 2a 2a riable when a.**
6d60: 20 20 20 77 72 69 74 65 2d 74 72 61 6e 73 61 63 write-transac
6d70: 74 69 6f 6e 20 69 73 20 6f 70 65 6e 65 64 20 28 tion is opened (
6d80: 61 74 20 74 68 65 20 73 61 6d 65 20 74 69 6d 65 at the same time
6d90: 20 61 73 20 64 62 46 69 6c 65 53 69 7a 65 20 61 as dbFileSize a
6da0: 6e 64 0a 2a 2a 20 20 20 64 62 4f 72 69 67 53 69 nd.** dbOrigSi
6db0: 7a 65 29 2e 20 49 66 20 74 68 65 20 78 46 69 6c ze). If the xFil
6dc0: 65 43 6f 6e 74 72 6f 6c 28 46 43 4e 54 4c 5f 53 eControl(FCNTL_S
6dd0: 49 5a 45 5f 48 49 4e 54 29 20 6d 65 74 68 6f 64 IZE_HINT) method
6de0: 20 69 73 20 63 61 6c 6c 65 64 2c 0a 2a 2a 20 20 is called,.**
6df0: 20 64 62 48 69 6e 74 53 69 7a 65 20 69 73 20 69 dbHintSize is i
6e00: 6e 63 72 65 61 73 65 64 20 74 6f 20 74 68 65 20 ncreased to the
6e10: 6e 75 6d 62 65 72 20 6f 66 20 70 61 67 65 73 20 number of pages
6e20: 74 68 61 74 20 63 6f 72 72 65 73 70 6f 6e 64 20 that correspond
6e30: 74 6f 20 74 68 65 0a 2a 2a 20 20 20 73 69 7a 65 to the.** size
6e40: 2d 68 69 6e 74 20 70 61 73 73 65 64 20 74 6f 20 -hint passed to
6e50: 74 68 65 20 6d 65 74 68 6f 64 20 63 61 6c 6c 2e the method call.
6e60: 20 53 65 65 20 70 61 67 65 72 5f 77 72 69 74 65 See pager_write
6e70: 5f 70 61 67 65 6c 69 73 74 28 29 20 66 6f 72 20 _pagelist() for
6e80: 0a 2a 2a 20 20 20 64 65 74 61 69 6c 73 2e 0a 2a .** details..*
6e90: 2a 0a 2a 2a 20 65 72 72 43 6f 64 65 0a 2a 2a 0a *.** errCode.**.
6ea0: 2a 2a 20 20 20 54 68 65 20 50 61 67 65 72 2e 65 ** The Pager.e
6eb0: 72 72 43 6f 64 65 20 76 61 72 69 61 62 6c 65 20 rrCode variable
6ec0: 69 73 20 6f 6e 6c 79 20 65 76 65 72 20 75 73 65 is only ever use
6ed0: 64 20 69 6e 20 50 41 47 45 52 5f 45 52 52 4f 52 d in PAGER_ERROR
6ee0: 20 73 74 61 74 65 2e 20 49 74 0a 2a 2a 20 20 20 state. It.**
6ef0: 69 73 20 73 65 74 20 74 6f 20 7a 65 72 6f 20 69 is set to zero i
6f00: 6e 20 61 6c 6c 20 6f 74 68 65 72 20 73 74 61 74 n all other stat
6f10: 65 73 2e 20 49 6e 20 50 41 47 45 52 5f 45 52 52 es. In PAGER_ERR
6f20: 4f 52 20 73 74 61 74 65 2c 20 50 61 67 65 72 2e OR state, Pager.
6f30: 65 72 72 43 6f 64 65 20 0a 2a 2a 20 20 20 69 73 errCode .** is
6f40: 20 61 6c 77 61 79 73 20 73 65 74 20 74 6f 20 53 always set to S
6f50: 51 4c 49 54 45 5f 46 55 4c 4c 2c 20 53 51 4c 49 QLITE_FULL, SQLI
6f60: 54 45 5f 49 4f 45 52 52 20 6f 72 20 6f 6e 65 20 TE_IOERR or one
6f70: 6f 66 20 74 68 65 20 53 51 4c 49 54 45 5f 49 4f of the SQLITE_IO
6f80: 45 52 52 5f 58 58 58 20 0a 2a 2a 20 20 20 73 75 ERR_XXX .** su
6f90: 62 2d 63 6f 64 65 73 2e 0a 2a 2f 0a 73 74 72 75 b-codes..*/.stru
6fa0: 63 74 20 50 61 67 65 72 20 7b 0a 20 20 73 71 6c ct Pager {. sql
6fb0: 69 74 65 33 5f 76 66 73 20 2a 70 56 66 73 3b 20 ite3_vfs *pVfs;
6fc0: 20 20 20 20 20 20 20 20 20 2f 2a 20 4f 53 20 66 /* OS f
6fd0: 75 6e 63 74 69 6f 6e 73 20 74 6f 20 75 73 65 20 unctions to use
6fe0: 66 6f 72 20 49 4f 20 2a 2f 0a 20 20 75 38 20 65 for IO */. u8 e
6ff0: 78 63 6c 75 73 69 76 65 4d 6f 64 65 3b 20 20 20 xclusiveMode;
7000: 20 20 20 20 20 20 20 20 2f 2a 20 42 6f 6f 6c 65 /* Boole
7010: 61 6e 2e 20 54 72 75 65 20 69 66 20 6c 6f 63 6b an. True if lock
7020: 69 6e 67 5f 6d 6f 64 65 3d 3d 45 58 43 4c 55 53 ing_mode==EXCLUS
7030: 49 56 45 20 2a 2f 0a 20 20 75 38 20 6a 6f 75 72 IVE */. u8 jour
7040: 6e 61 6c 4d 6f 64 65 3b 20 20 20 20 20 20 20 20 nalMode;
7050: 20 20 20 20 20 2f 2a 20 4f 6e 65 20 6f 66 20 74 /* One of t
7060: 68 65 20 50 41 47 45 52 5f 4a 4f 55 52 4e 41 4c he PAGER_JOURNAL
7070: 4d 4f 44 45 5f 2a 20 76 61 6c 75 65 73 20 2a 2f MODE_* values */
7080: 0a 20 20 75 38 20 75 73 65 4a 6f 75 72 6e 61 6c . u8 useJournal
7090: 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f ; /
70a0: 2a 20 55 73 65 20 61 20 72 6f 6c 6c 62 61 63 6b * Use a rollback
70b0: 20 6a 6f 75 72 6e 61 6c 20 6f 6e 20 74 68 69 73 journal on this
70c0: 20 66 69 6c 65 20 2a 2f 0a 20 20 75 38 20 6e 6f file */. u8 no
70d0: 52 65 61 64 6c 6f 63 6b 3b 20 20 20 20 20 20 20 Readlock;
70e0: 20 20 20 20 20 20 20 2f 2a 20 44 6f 20 6e 6f 74 /* Do not
70f0: 20 62 6f 74 68 65 72 20 74 6f 20 6f 62 74 61 69 bother to obtai
7100: 6e 20 72 65 61 64 6c 6f 63 6b 73 20 2a 2f 0a 20 n readlocks */.
7110: 20 75 38 20 6e 6f 53 79 6e 63 3b 20 20 20 20 20 u8 noSync;
7120: 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 /*
7130: 44 6f 20 6e 6f 74 20 73 79 6e 63 20 74 68 65 20 Do not sync the
7140: 6a 6f 75 72 6e 61 6c 20 69 66 20 74 72 75 65 20 journal if true
7150: 2a 2f 0a 20 20 75 38 20 66 75 6c 6c 53 79 6e 63 */. u8 fullSync
7160: 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 ;
7170: 20 2f 2a 20 44 6f 20 65 78 74 72 61 20 73 79 6e /* Do extra syn
7180: 63 73 20 6f 66 20 74 68 65 20 6a 6f 75 72 6e 61 cs of the journa
7190: 6c 20 66 6f 72 20 72 6f 62 75 73 74 6e 65 73 73 l for robustness
71a0: 20 2a 2f 0a 20 20 75 38 20 63 6b 70 74 53 79 6e */. u8 ckptSyn
71b0: 63 46 6c 61 67 73 3b 20 20 20 20 20 20 20 20 20 cFlags;
71c0: 20 20 2f 2a 20 53 59 4e 43 5f 4e 4f 52 4d 41 4c /* SYNC_NORMAL
71d0: 20 6f 72 20 53 59 4e 43 5f 46 55 4c 4c 20 66 6f or SYNC_FULL fo
71e0: 72 20 63 68 65 63 6b 70 6f 69 6e 74 20 2a 2f 0a r checkpoint */.
71f0: 20 20 75 38 20 73 79 6e 63 46 6c 61 67 73 3b 20 u8 syncFlags;
7200: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a /*
7210: 20 53 59 4e 43 5f 4e 4f 52 4d 41 4c 20 6f 72 20 SYNC_NORMAL or
7220: 53 59 4e 43 5f 46 55 4c 4c 20 6f 74 68 65 72 77 SYNC_FULL otherw
7230: 69 73 65 20 2a 2f 0a 20 20 75 38 20 74 65 6d 70 ise */. u8 temp
7240: 46 69 6c 65 3b 20 20 20 20 20 20 20 20 20 20 20 File;
7250: 20 20 20 20 20 2f 2a 20 7a 46 69 6c 65 6e 61 6d /* zFilenam
7260: 65 20 69 73 20 61 20 74 65 6d 70 6f 72 61 72 79 e is a temporary
7270: 20 66 69 6c 65 20 2a 2f 0a 20 20 75 38 20 72 65 file */. u8 re
7280: 61 64 4f 6e 6c 79 3b 20 20 20 20 20 20 20 20 20 adOnly;
7290: 20 20 20 20 20 20 20 2f 2a 20 54 72 75 65 20 66 /* True f
72a0: 6f 72 20 61 20 72 65 61 64 2d 6f 6e 6c 79 20 64 or a read-only d
72b0: 61 74 61 62 61 73 65 20 2a 2f 0a 20 20 75 38 20 atabase */. u8
72c0: 6d 65 6d 44 62 3b 20 20 20 20 20 20 20 20 20 20 memDb;
72d0: 20 20 20 20 20 20 20 20 20 2f 2a 20 54 72 75 65 /* True
72e0: 20 74 6f 20 69 6e 68 69 62 69 74 20 61 6c 6c 20 to inhibit all
72f0: 66 69 6c 65 20 49 2f 4f 20 2a 2f 0a 0a 20 20 2f file I/O */.. /
7300: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
7310: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
7320: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
7330: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
7340: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 0a 20 20 2a 2a 20 **********. **
7350: 54 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 62 6c The following bl
7360: 6f 63 6b 20 63 6f 6e 74 61 69 6e 73 20 74 68 6f ock contains tho
7370: 73 65 20 63 6c 61 73 73 20 6d 65 6d 62 65 72 73 se class members
7380: 20 74 68 61 74 20 63 68 61 6e 67 65 20 64 75 72 that change dur
7390: 69 6e 67 0a 20 20 2a 2a 20 72 6f 75 74 69 6e 65 ing. ** routine
73a0: 20 6f 70 65 72 74 69 6f 6e 2e 20 20 43 6c 61 73 opertion. Clas
73b0: 73 20 6d 65 6d 62 65 72 73 20 6e 6f 74 20 69 6e s members not in
73c0: 20 74 68 69 73 20 62 6c 6f 63 6b 20 61 72 65 20 this block are
73d0: 65 69 74 68 65 72 20 66 69 78 65 64 0a 20 20 2a either fixed. *
73e0: 2a 20 77 68 65 6e 20 74 68 65 20 70 61 67 65 72 * when the pager
73f0: 20 69 73 20 66 69 72 73 74 20 63 72 65 61 74 65 is first create
7400: 64 20 6f 72 20 65 6c 73 65 20 6f 6e 6c 79 20 63 d or else only c
7410: 68 61 6e 67 65 20 77 68 65 6e 20 74 68 65 72 65 hange when there
7420: 20 69 73 20 61 0a 20 20 2a 2a 20 73 69 67 6e 69 is a. ** signi
7430: 66 69 63 61 6e 74 20 6d 6f 64 65 20 63 68 61 6e ficant mode chan
7440: 67 65 20 28 73 75 63 68 20 61 73 20 63 68 61 6e ge (such as chan
7450: 67 69 6e 67 20 74 68 65 20 70 61 67 65 5f 73 69 ging the page_si
7460: 7a 65 2c 20 6c 6f 63 6b 69 6e 67 5f 6d 6f 64 65 ze, locking_mode
7470: 2c 0a 20 20 2a 2a 20 6f 72 20 74 68 65 20 6a 6f ,. ** or the jo
7480: 75 72 6e 61 6c 5f 6d 6f 64 65 29 2e 20 20 46 72 urnal_mode). Fr
7490: 6f 6d 20 61 6e 6f 74 68 65 72 20 76 69 65 77 2c om another view,
74a0: 20 74 68 65 73 65 20 63 6c 61 73 73 20 6d 65 6d these class mem
74b0: 62 65 72 73 20 64 65 73 63 72 69 62 65 0a 20 20 bers describe.
74c0: 2a 2a 20 74 68 65 20 22 73 74 61 74 65 22 20 6f ** the "state" o
74d0: 66 20 74 68 65 20 70 61 67 65 72 2c 20 77 68 69 f the pager, whi
74e0: 6c 65 20 6f 74 68 65 72 20 63 6c 61 73 73 20 6d le other class m
74f0: 65 6d 62 65 72 73 20 64 65 73 63 72 69 62 65 20 embers describe
7500: 74 68 65 0a 20 20 2a 2a 20 22 63 6f 6e 66 69 67 the. ** "config
7510: 75 72 61 74 69 6f 6e 22 20 6f 66 20 74 68 65 20 uration" of the
7520: 70 61 67 65 72 2e 0a 20 20 2a 2f 0a 20 20 75 38 pager.. */. u8
7530: 20 65 53 74 61 74 65 3b 20 20 20 20 20 20 20 20 eState;
7540: 20 20 20 20 20 20 20 20 20 20 2f 2a 20 50 61 67 /* Pag
7550: 65 72 20 73 74 61 74 65 20 28 4f 50 45 4e 2c 20 er state (OPEN,
7560: 52 45 41 44 45 52 2c 20 57 52 49 54 45 52 5f 4c READER, WRITER_L
7570: 4f 43 4b 45 44 2e 2e 29 20 2a 2f 0a 20 20 75 38 OCKED..) */. u8
7580: 20 65 4c 6f 63 6b 3b 20 20 20 20 20 20 20 20 20 eLock;
7590: 20 20 20 20 20 20 20 20 20 20 2f 2a 20 43 75 72 /* Cur
75a0: 72 65 6e 74 20 6c 6f 63 6b 20 68 65 6c 64 20 6f rent lock held o
75b0: 6e 20 64 61 74 61 62 61 73 65 20 66 69 6c 65 20 n database file
75c0: 2a 2f 0a 20 20 75 38 20 63 68 61 6e 67 65 43 6f */. u8 changeCo
75d0: 75 6e 74 44 6f 6e 65 3b 20 20 20 20 20 20 20 20 untDone;
75e0: 20 2f 2a 20 53 65 74 20 61 66 74 65 72 20 69 6e /* Set after in
75f0: 63 72 65 6d 65 6e 74 69 6e 67 20 74 68 65 20 63 crementing the c
7600: 68 61 6e 67 65 2d 63 6f 75 6e 74 65 72 20 2a 2f hange-counter */
7610: 0a 20 20 75 38 20 73 65 74 4d 61 73 74 65 72 3b . u8 setMaster;
7620: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f /
7630: 2a 20 54 72 75 65 20 69 66 20 61 20 6d 2d 6a 20 * True if a m-j
7640: 6e 61 6d 65 20 68 61 73 20 62 65 65 6e 20 77 72 name has been wr
7650: 69 74 74 65 6e 20 74 6f 20 6a 72 6e 6c 20 2a 2f itten to jrnl */
7660: 0a 20 20 75 38 20 64 6f 4e 6f 74 53 70 69 6c 6c . u8 doNotSpill
7670: 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f ; /
7680: 2a 20 44 6f 20 6e 6f 74 20 73 70 69 6c 6c 20 74 * Do not spill t
7690: 68 65 20 63 61 63 68 65 20 77 68 65 6e 20 6e 6f he cache when no
76a0: 6e 2d 7a 65 72 6f 20 2a 2f 0a 20 20 75 38 20 64 n-zero */. u8 d
76b0: 6f 4e 6f 74 53 79 6e 63 53 70 69 6c 6c 3b 20 20 oNotSyncSpill;
76c0: 20 20 20 20 20 20 20 20 2f 2a 20 44 6f 20 6e 6f /* Do no
76d0: 74 20 64 6f 20 61 20 73 70 69 6c 6c 20 74 68 61 t do a spill tha
76e0: 74 20 72 65 71 75 69 72 65 73 20 6a 72 6e 6c 20 t requires jrnl
76f0: 73 79 6e 63 20 2a 2f 0a 20 20 75 38 20 73 75 62 sync */. u8 sub
7700: 6a 49 6e 4d 65 6d 6f 72 79 3b 20 20 20 20 20 20 jInMemory;
7710: 20 20 20 20 20 20 2f 2a 20 54 72 75 65 20 74 6f /* True to
7720: 20 75 73 65 20 69 6e 2d 6d 65 6d 6f 72 79 20 73 use in-memory s
7730: 75 62 2d 6a 6f 75 72 6e 61 6c 73 20 2a 2f 0a 20 ub-journals */.
7740: 20 50 67 6e 6f 20 64 62 53 69 7a 65 3b 20 20 20 Pgno dbSize;
7750: 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 /*
7760: 4e 75 6d 62 65 72 20 6f 66 20 70 61 67 65 73 20 Number of pages
7770: 69 6e 20 74 68 65 20 64 61 74 61 62 61 73 65 20 in the database
7780: 2a 2f 0a 20 20 50 67 6e 6f 20 64 62 4f 72 69 67 */. Pgno dbOrig
7790: 53 69 7a 65 3b 20 20 20 20 20 20 20 20 20 20 20 Size;
77a0: 20 2f 2a 20 64 62 53 69 7a 65 20 62 65 66 6f 72 /* dbSize befor
77b0: 65 20 74 68 65 20 63 75 72 72 65 6e 74 20 74 72 e the current tr
77c0: 61 6e 73 61 63 74 69 6f 6e 20 2a 2f 0a 20 20 50 ansaction */. P
77d0: 67 6e 6f 20 64 62 46 69 6c 65 53 69 7a 65 3b 20 gno dbFileSize;
77e0: 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4e 75 /* Nu
77f0: 6d 62 65 72 20 6f 66 20 70 61 67 65 73 20 69 6e mber of pages in
7800: 20 74 68 65 20 64 61 74 61 62 61 73 65 20 66 69 the database fi
7810: 6c 65 20 2a 2f 0a 20 20 50 67 6e 6f 20 64 62 48 le */. Pgno dbH
7820: 69 6e 74 53 69 7a 65 3b 20 20 20 20 20 20 20 20 intSize;
7830: 20 20 20 20 2f 2a 20 56 61 6c 75 65 20 70 61 73 /* Value pas
7840: 73 65 64 20 74 6f 20 46 43 4e 54 4c 5f 53 49 5a sed to FCNTL_SIZ
7850: 45 5f 48 49 4e 54 20 63 61 6c 6c 20 2a 2f 0a 20 E_HINT call */.
7860: 20 69 6e 74 20 65 72 72 43 6f 64 65 3b 20 20 20 int errCode;
7870: 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 /*
7880: 4f 6e 65 20 6f 66 20 73 65 76 65 72 61 6c 20 6b One of several k
7890: 69 6e 64 73 20 6f 66 20 65 72 72 6f 72 73 20 2a inds of errors *
78a0: 2f 0a 20 20 69 6e 74 20 6e 52 65 63 3b 20 20 20 /. int nRec;
78b0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
78c0: 2f 2a 20 50 61 67 65 73 20 6a 6f 75 72 6e 61 6c /* Pages journal
78d0: 6c 65 64 20 73 69 6e 63 65 20 6c 61 73 74 20 6a led since last j
78e0: 2d 68 65 61 64 65 72 20 77 72 69 74 74 65 6e 20 -header written
78f0: 2a 2f 0a 20 20 75 33 32 20 63 6b 73 75 6d 49 6e */. u32 cksumIn
7900: 69 74 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 it;
7910: 20 2f 2a 20 51 75 61 73 69 2d 72 61 6e 64 6f 6d /* Quasi-random
7920: 20 76 61 6c 75 65 20 61 64 64 65 64 20 74 6f 20 value added to
7930: 65 76 65 72 79 20 63 68 65 63 6b 73 75 6d 20 2a every checksum *
7940: 2f 0a 20 20 75 33 32 20 6e 53 75 62 52 65 63 3b /. u32 nSubRec;
7950: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
7960: 2f 2a 20 4e 75 6d 62 65 72 20 6f 66 20 72 65 63 /* Number of rec
7970: 6f 72 64 73 20 77 72 69 74 74 65 6e 20 74 6f 20 ords written to
7980: 73 75 62 2d 6a 6f 75 72 6e 61 6c 20 2a 2f 0a 20 sub-journal */.
7990: 20 42 69 74 76 65 63 20 2a 70 49 6e 4a 6f 75 72 Bitvec *pInJour
79a0: 6e 61 6c 3b 20 20 20 20 20 20 20 20 20 2f 2a 20 nal; /*
79b0: 4f 6e 65 20 62 69 74 20 66 6f 72 20 65 61 63 68 One bit for each
79c0: 20 70 61 67 65 20 69 6e 20 74 68 65 20 64 61 74 page in the dat
79d0: 61 62 61 73 65 20 66 69 6c 65 20 2a 2f 0a 20 20 abase file */.
79e0: 73 71 6c 69 74 65 33 5f 66 69 6c 65 20 2a 66 64 sqlite3_file *fd
79f0: 3b 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 46 ; /* F
7a00: 69 6c 65 20 64 65 73 63 72 69 70 74 6f 72 20 66 ile descriptor f
7a10: 6f 72 20 64 61 74 61 62 61 73 65 20 2a 2f 0a 20 or database */.
7a20: 20 73 71 6c 69 74 65 33 5f 66 69 6c 65 20 2a 6a sqlite3_file *j
7a30: 66 64 3b 20 20 20 20 20 20 20 20 20 20 2f 2a 20 fd; /*
7a40: 46 69 6c 65 20 64 65 73 63 72 69 70 74 6f 72 20 File descriptor
7a50: 66 6f 72 20 6d 61 69 6e 20 6a 6f 75 72 6e 61 6c for main journal
7a60: 20 2a 2f 0a 20 20 73 71 6c 69 74 65 33 5f 66 69 */. sqlite3_fi
7a70: 6c 65 20 2a 73 6a 66 64 3b 20 20 20 20 20 20 20 le *sjfd;
7a80: 20 20 2f 2a 20 46 69 6c 65 20 64 65 73 63 72 69 /* File descri
7a90: 70 74 6f 72 20 66 6f 72 20 73 75 62 2d 6a 6f 75 ptor for sub-jou
7aa0: 72 6e 61 6c 20 2a 2f 0a 20 20 69 36 34 20 6a 6f rnal */. i64 jo
7ab0: 75 72 6e 61 6c 4f 66 66 3b 20 20 20 20 20 20 20 urnalOff;
7ac0: 20 20 20 20 20 20 2f 2a 20 43 75 72 72 65 6e 74 /* Current
7ad0: 20 77 72 69 74 65 20 6f 66 66 73 65 74 20 69 6e write offset in
7ae0: 20 74 68 65 20 6a 6f 75 72 6e 61 6c 20 66 69 6c the journal fil
7af0: 65 20 2a 2f 0a 20 20 69 36 34 20 6a 6f 75 72 6e e */. i64 journ
7b00: 61 6c 48 64 72 3b 20 20 20 20 20 20 20 20 20 20 alHdr;
7b10: 20 20 20 2f 2a 20 42 79 74 65 20 6f 66 66 73 65 /* Byte offse
7b20: 74 20 74 6f 20 70 72 65 76 69 6f 75 73 20 6a 6f t to previous jo
7b30: 75 72 6e 61 6c 20 68 65 61 64 65 72 20 2a 2f 0a urnal header */.
7b40: 20 20 73 71 6c 69 74 65 33 5f 62 61 63 6b 75 70 sqlite3_backup
7b50: 20 2a 70 42 61 63 6b 75 70 3b 20 20 20 20 2f 2a *pBackup; /*
7b60: 20 50 6f 69 6e 74 65 72 20 74 6f 20 6c 69 73 74 Pointer to list
7b70: 20 6f 66 20 6f 6e 67 6f 69 6e 67 20 62 61 63 6b of ongoing back
7b80: 75 70 20 70 72 6f 63 65 73 73 65 73 20 2a 2f 0a up processes */.
7b90: 20 20 50 61 67 65 72 53 61 76 65 70 6f 69 6e 74 PagerSavepoint
7ba0: 20 2a 61 53 61 76 65 70 6f 69 6e 74 3b 20 2f 2a *aSavepoint; /*
7bb0: 20 41 72 72 61 79 20 6f 66 20 61 63 74 69 76 65 Array of active
7bc0: 20 73 61 76 65 70 6f 69 6e 74 73 20 2a 2f 0a 20 savepoints */.
7bd0: 20 69 6e 74 20 6e 53 61 76 65 70 6f 69 6e 74 3b int nSavepoint;
7be0: 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 /*
7bf0: 4e 75 6d 62 65 72 20 6f 66 20 65 6c 65 6d 65 6e Number of elemen
7c00: 74 73 20 69 6e 20 61 53 61 76 65 70 6f 69 6e 74 ts in aSavepoint
7c10: 5b 5d 20 2a 2f 0a 20 20 63 68 61 72 20 64 62 46 [] */. char dbF
7c20: 69 6c 65 56 65 72 73 5b 31 36 5d 3b 20 20 20 20 ileVers[16];
7c30: 20 20 20 20 2f 2a 20 43 68 61 6e 67 65 73 20 77 /* Changes w
7c40: 68 65 6e 65 76 65 72 20 64 61 74 61 62 61 73 65 henever database
7c50: 20 66 69 6c 65 20 63 68 61 6e 67 65 73 20 2a 2f file changes */
7c60: 0a 20 20 2f 2a 0a 20 20 2a 2a 20 45 6e 64 20 6f . /*. ** End o
7c70: 66 20 74 68 65 20 72 6f 75 74 69 6e 65 6c 79 2d f the routinely-
7c80: 63 68 61 6e 67 69 6e 67 20 63 6c 61 73 73 20 6d changing class m
7c90: 65 6d 62 65 72 73 0a 20 20 2a 2a 2a 2a 2a 2a 2a embers. *******
7ca0: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
7cb0: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
7cc0: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
7cd0: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
7ce0: 2a 2a 2a 2a 2f 0a 0a 20 20 75 31 36 20 6e 45 78 ****/.. u16 nEx
7cf0: 74 72 61 3b 20 20 20 20 20 20 20 20 20 20 20 20 tra;
7d00: 20 20 20 20 20 2f 2a 20 41 64 64 20 74 68 69 73 /* Add this
7d10: 20 6d 61 6e 79 20 62 79 74 65 73 20 74 6f 20 65 many bytes to e
7d20: 61 63 68 20 69 6e 2d 6d 65 6d 6f 72 79 20 70 61 ach in-memory pa
7d30: 67 65 20 2a 2f 0a 20 20 69 31 36 20 6e 52 65 73 ge */. i16 nRes
7d40: 65 72 76 65 3b 20 20 20 20 20 20 20 20 20 20 20 erve;
7d50: 20 20 20 20 2f 2a 20 4e 75 6d 62 65 72 20 6f 66 /* Number of
7d60: 20 75 6e 75 73 65 64 20 62 79 74 65 73 20 61 74 unused bytes at
7d70: 20 65 6e 64 20 6f 66 20 65 61 63 68 20 70 61 67 end of each pag
7d80: 65 20 2a 2f 0a 20 20 75 33 32 20 76 66 73 46 6c e */. u32 vfsFl
7d90: 61 67 73 3b 20 20 20 20 20 20 20 20 20 20 20 20 ags;
7da0: 20 20 20 2f 2a 20 46 6c 61 67 73 20 66 6f 72 20 /* Flags for
7db0: 73 71 6c 69 74 65 33 5f 76 66 73 2e 78 4f 70 65 sqlite3_vfs.xOpe
7dc0: 6e 28 29 20 2a 2f 0a 20 20 75 33 32 20 73 65 63 n() */. u32 sec
7dd0: 74 6f 72 53 69 7a 65 3b 20 20 20 20 20 20 20 20 torSize;
7de0: 20 20 20 20 20 2f 2a 20 41 73 73 75 6d 65 64 20 /* Assumed
7df0: 73 65 63 74 6f 72 20 73 69 7a 65 20 64 75 72 69 sector size duri
7e00: 6e 67 20 72 6f 6c 6c 62 61 63 6b 20 2a 2f 0a 20 ng rollback */.
7e10: 20 69 6e 74 20 70 61 67 65 53 69 7a 65 3b 20 20 int pageSize;
7e20: 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 /*
7e30: 4e 75 6d 62 65 72 20 6f 66 20 62 79 74 65 73 20 Number of bytes
7e40: 69 6e 20 61 20 70 61 67 65 20 2a 2f 0a 20 20 50 in a page */. P
7e50: 67 6e 6f 20 6d 78 50 67 6e 6f 3b 20 20 20 20 20 gno mxPgno;
7e60: 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4d 61 /* Ma
7e70: 78 69 6d 75 6d 20 61 6c 6c 6f 77 65 64 20 73 69 ximum allowed si
7e80: 7a 65 20 6f 66 20 74 68 65 20 64 61 74 61 62 61 ze of the databa
7e90: 73 65 20 2a 2f 0a 20 20 69 36 34 20 6a 6f 75 72 se */. i64 jour
7ea0: 6e 61 6c 53 69 7a 65 4c 69 6d 69 74 3b 20 20 20 nalSizeLimit;
7eb0: 20 20 20 20 2f 2a 20 53 69 7a 65 20 6c 69 6d 69 /* Size limi
7ec0: 74 20 66 6f 72 20 70 65 72 73 69 73 74 65 6e 74 t for persistent
7ed0: 20 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 73 20 2a journal files *
7ee0: 2f 0a 20 20 63 68 61 72 20 2a 7a 46 69 6c 65 6e /. char *zFilen
7ef0: 61 6d 65 3b 20 20 20 20 20 20 20 20 20 20 20 20 ame;
7f00: 2f 2a 20 4e 61 6d 65 20 6f 66 20 74 68 65 20 64 /* Name of the d
7f10: 61 74 61 62 61 73 65 20 66 69 6c 65 20 2a 2f 0a atabase file */.
7f20: 20 20 63 68 61 72 20 2a 7a 4a 6f 75 72 6e 61 6c char *zJournal
7f30: 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a ; /*
7f40: 20 4e 61 6d 65 20 6f 66 20 74 68 65 20 6a 6f 75 Name of the jou
7f50: 72 6e 61 6c 20 66 69 6c 65 20 2a 2f 0a 20 20 69 rnal file */. i
7f60: 6e 74 20 28 2a 78 42 75 73 79 48 61 6e 64 6c 65 nt (*xBusyHandle
7f70: 72 29 28 76 6f 69 64 2a 29 3b 20 2f 2a 20 46 75 r)(void*); /* Fu
7f80: 6e 63 74 69 6f 6e 20 74 6f 20 63 61 6c 6c 20 77 nction to call w
7f90: 68 65 6e 20 62 75 73 79 20 2a 2f 0a 20 20 76 6f hen busy */. vo
7fa0: 69 64 20 2a 70 42 75 73 79 48 61 6e 64 6c 65 72 id *pBusyHandler
7fb0: 41 72 67 3b 20 20 20 20 20 20 2f 2a 20 43 6f 6e Arg; /* Con
7fc0: 74 65 78 74 20 61 72 67 75 6d 65 6e 74 20 66 6f text argument fo
7fd0: 72 20 78 42 75 73 79 48 61 6e 64 6c 65 72 20 2a r xBusyHandler *
7fe0: 2f 0a 23 69 66 64 65 66 20 53 51 4c 49 54 45 5f /.#ifdef SQLITE_
7ff0: 54 45 53 54 0a 20 20 69 6e 74 20 6e 48 69 74 2c TEST. int nHit,
8000: 20 6e 4d 69 73 73 3b 20 20 20 20 20 20 20 20 20 nMiss;
8010: 20 20 20 2f 2a 20 43 61 63 68 65 20 68 69 74 73 /* Cache hits
8020: 20 61 6e 64 20 6d 69 73 73 69 6e 67 20 2a 2f 0a and missing */.
8030: 20 20 69 6e 74 20 6e 52 65 61 64 2c 20 6e 57 72 int nRead, nWr
8040: 69 74 65 3b 20 20 20 20 20 20 20 20 20 20 2f 2a ite; /*
8050: 20 44 61 74 61 62 61 73 65 20 70 61 67 65 73 20 Database pages
8060: 72 65 61 64 2f 77 72 69 74 74 65 6e 20 2a 2f 0a read/written */.
8070: 23 65 6e 64 69 66 0a 20 20 76 6f 69 64 20 28 2a #endif. void (*
8080: 78 52 65 69 6e 69 74 65 72 29 28 44 62 50 61 67 xReiniter)(DbPag
8090: 65 2a 29 3b 20 2f 2a 20 43 61 6c 6c 20 74 68 69 e*); /* Call thi
80a0: 73 20 72 6f 75 74 69 6e 65 20 77 68 65 6e 20 72 s routine when r
80b0: 65 6c 6f 61 64 69 6e 67 20 70 61 67 65 73 20 2a eloading pages *
80c0: 2f 0a 23 69 66 64 65 66 20 53 51 4c 49 54 45 5f /.#ifdef SQLITE_
80d0: 48 41 53 5f 43 4f 44 45 43 0a 20 20 76 6f 69 64 HAS_CODEC. void
80e0: 20 2a 28 2a 78 43 6f 64 65 63 29 28 76 6f 69 64 *(*xCodec)(void
80f0: 2a 2c 76 6f 69 64 2a 2c 50 67 6e 6f 2c 69 6e 74 *,void*,Pgno,int
8100: 29 3b 20 2f 2a 20 52 6f 75 74 69 6e 65 20 66 6f ); /* Routine fo
8110: 72 20 65 6e 2f 64 65 63 6f 64 69 6e 67 20 64 61 r en/decoding da
8120: 74 61 20 2a 2f 0a 20 20 76 6f 69 64 20 28 2a 78 ta */. void (*x
8130: 43 6f 64 65 63 53 69 7a 65 43 68 6e 67 29 28 76 CodecSizeChng)(v
8140: 6f 69 64 2a 2c 69 6e 74 2c 69 6e 74 29 3b 20 2f oid*,int,int); /
8150: 2a 20 4e 6f 74 69 66 79 20 6f 66 20 70 61 67 65 * Notify of page
8160: 20 73 69 7a 65 20 63 68 61 6e 67 65 73 20 2a 2f size changes */
8170: 0a 20 20 76 6f 69 64 20 28 2a 78 43 6f 64 65 63 . void (*xCodec
8180: 46 72 65 65 29 28 76 6f 69 64 2a 29 3b 20 20 20 Free)(void*);
8190: 20 20 20 20 20 20 20 20 20 20 2f 2a 20 44 65 73 /* Des
81a0: 74 72 75 63 74 6f 72 20 66 6f 72 20 74 68 65 20 tructor for the
81b0: 63 6f 64 65 63 20 2a 2f 0a 20 20 76 6f 69 64 20 codec */. void
81c0: 2a 70 43 6f 64 65 63 3b 20 20 20 20 20 20 20 20 *pCodec;
81d0: 20 20 20 20 20 20 20 2f 2a 20 46 69 72 73 74 20 /* First
81e0: 61 72 67 75 6d 65 6e 74 20 74 6f 20 78 43 6f 64 argument to xCod
81f0: 65 63 2e 2e 2e 20 6d 65 74 68 6f 64 73 20 2a 2f ec... methods */
8200: 0a 23 65 6e 64 69 66 0a 20 20 63 68 61 72 20 2a .#endif. char *
8210: 70 54 6d 70 53 70 61 63 65 3b 20 20 20 20 20 20 pTmpSpace;
8220: 20 20 20 20 20 20 2f 2a 20 50 61 67 65 72 2e 70 /* Pager.p
8230: 61 67 65 53 69 7a 65 20 62 79 74 65 73 20 6f 66 ageSize bytes of
8240: 20 73 70 61 63 65 20 66 6f 72 20 74 6d 70 20 75 space for tmp u
8250: 73 65 20 2a 2f 0a 20 20 50 43 61 63 68 65 20 2a se */. PCache *
8260: 70 50 43 61 63 68 65 3b 20 20 20 20 20 20 20 20 pPCache;
8270: 20 20 20 20 2f 2a 20 50 6f 69 6e 74 65 72 20 74 /* Pointer t
8280: 6f 20 70 61 67 65 20 63 61 63 68 65 20 6f 62 6a o page cache obj
8290: 65 63 74 20 2a 2f 0a 23 69 66 6e 64 65 66 20 53 ect */.#ifndef S
82a0: 51 4c 49 54 45 5f 4f 4d 49 54 5f 57 41 4c 0a 20 QLITE_OMIT_WAL.
82b0: 20 57 61 6c 20 2a 70 57 61 6c 3b 20 20 20 20 20 Wal *pWal;
82c0: 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 /*
82d0: 57 72 69 74 65 2d 61 68 65 61 64 20 6c 6f 67 20 Write-ahead log
82e0: 75 73 65 64 20 62 79 20 22 6a 6f 75 72 6e 61 6c used by "journal
82f0: 5f 6d 6f 64 65 3d 77 61 6c 22 20 2a 2f 0a 20 20 _mode=wal" */.
8300: 63 68 61 72 20 2a 7a 57 61 6c 3b 20 20 20 20 20 char *zWal;
8310: 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 46 /* F
8320: 69 6c 65 20 6e 61 6d 65 20 66 6f 72 20 77 72 69 ile name for wri
8330: 74 65 2d 61 68 65 61 64 20 6c 6f 67 20 2a 2f 0a te-ahead log */.
8340: 23 65 6e 64 69 66 0a 7d 3b 0a 0a 2f 2a 0a 2a 2a #endif.};../*.**
8350: 20 54 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 67 The following g
8360: 6c 6f 62 61 6c 20 76 61 72 69 61 62 6c 65 73 20 lobal variables
8370: 68 6f 6c 64 20 63 6f 75 6e 74 65 72 73 20 75 73 hold counters us
8380: 65 64 20 66 6f 72 0a 2a 2a 20 74 65 73 74 69 6e ed for.** testin
8390: 67 20 70 75 72 70 6f 73 65 73 20 6f 6e 6c 79 2e g purposes only.
83a0: 20 20 54 68 65 73 65 20 76 61 72 69 61 62 6c 65 These variable
83b0: 73 20 64 6f 20 6e 6f 74 20 65 78 69 73 74 20 69 s do not exist i
83c0: 6e 0a 2a 2a 20 61 20 6e 6f 6e 2d 74 65 73 74 69 n.** a non-testi
83d0: 6e 67 20 62 75 69 6c 64 2e 20 20 54 68 65 73 65 ng build. These
83e0: 20 76 61 72 69 61 62 6c 65 73 20 61 72 65 20 6e variables are n
83f0: 6f 74 20 74 68 72 65 61 64 2d 73 61 66 65 2e 0a ot thread-safe..
8400: 2a 2f 0a 23 69 66 64 65 66 20 53 51 4c 49 54 45 */.#ifdef SQLITE
8410: 5f 54 45 53 54 0a 69 6e 74 20 73 71 6c 69 74 65 _TEST.int sqlite
8420: 33 5f 70 61 67 65 72 5f 72 65 61 64 64 62 5f 63 3_pager_readdb_c
8430: 6f 75 6e 74 20 3d 20 30 3b 20 20 20 20 2f 2a 20 ount = 0; /*
8440: 4e 75 6d 62 65 72 20 6f 66 20 66 75 6c 6c 20 70 Number of full p
8450: 61 67 65 73 20 72 65 61 64 20 66 72 6f 6d 20 44 ages read from D
8460: 42 20 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 B */.int sqlite3
8470: 5f 70 61 67 65 72 5f 77 72 69 74 65 64 62 5f 63 _pager_writedb_c
8480: 6f 75 6e 74 20 3d 20 30 3b 20 20 20 2f 2a 20 4e ount = 0; /* N
8490: 75 6d 62 65 72 20 6f 66 20 66 75 6c 6c 20 70 61 umber of full pa
84a0: 67 65 73 20 77 72 69 74 74 65 6e 20 74 6f 20 44 ges written to D
84b0: 42 20 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 B */.int sqlite3
84c0: 5f 70 61 67 65 72 5f 77 72 69 74 65 6a 5f 63 6f _pager_writej_co
84d0: 75 6e 74 20 3d 20 30 3b 20 20 20 20 2f 2a 20 4e unt = 0; /* N
84e0: 75 6d 62 65 72 20 6f 66 20 70 61 67 65 73 20 77 umber of pages w
84f0: 72 69 74 74 65 6e 20 74 6f 20 6a 6f 75 72 6e 61 ritten to journa
8500: 6c 20 2a 2f 0a 23 20 64 65 66 69 6e 65 20 50 41 l */.# define PA
8510: 47 45 52 5f 49 4e 43 52 28 76 29 20 20 76 2b 2b GER_INCR(v) v++
8520: 0a 23 65 6c 73 65 0a 23 20 64 65 66 69 6e 65 20 .#else.# define
8530: 50 41 47 45 52 5f 49 4e 43 52 28 76 29 0a 23 65 PAGER_INCR(v).#e
8540: 6e 64 69 66 0a 0a 0a 0a 2f 2a 0a 2a 2a 20 4a 6f ndif..../*.** Jo
8550: 75 72 6e 61 6c 20 66 69 6c 65 73 20 62 65 67 69 urnal files begi
8560: 6e 20 77 69 74 68 20 74 68 65 20 66 6f 6c 6c 6f n with the follo
8570: 77 69 6e 67 20 6d 61 67 69 63 20 73 74 72 69 6e wing magic strin
8580: 67 2e 20 20 54 68 65 20 64 61 74 61 0a 2a 2a 20 g. The data.**
8590: 77 61 73 20 6f 62 74 61 69 6e 65 64 20 66 72 6f was obtained fro
85a0: 6d 20 2f 64 65 76 2f 72 61 6e 64 6f 6d 2e 20 20 m /dev/random.
85b0: 49 74 20 69 73 20 75 73 65 64 20 6f 6e 6c 79 20 It is used only
85c0: 61 73 20 61 20 73 61 6e 69 74 79 20 63 68 65 63 as a sanity chec
85d0: 6b 2e 0a 2a 2a 0a 2a 2a 20 53 69 6e 63 65 20 76 k..**.** Since v
85e0: 65 72 73 69 6f 6e 20 32 2e 38 2e 30 2c 20 74 68 ersion 2.8.0, th
85f0: 65 20 6a 6f 75 72 6e 61 6c 20 66 6f 72 6d 61 74 e journal format
8600: 20 63 6f 6e 74 61 69 6e 73 20 61 64 64 69 74 69 contains additi
8610: 6f 6e 61 6c 20 73 61 6e 69 74 79 0a 2a 2a 20 63 onal sanity.** c
8620: 68 65 63 6b 69 6e 67 20 69 6e 66 6f 72 6d 61 74 hecking informat
8630: 69 6f 6e 2e 20 20 49 66 20 74 68 65 20 70 6f 77 ion. If the pow
8640: 65 72 20 66 61 69 6c 73 20 77 68 69 6c 65 20 74 er fails while t
8650: 68 65 20 6a 6f 75 72 6e 61 6c 20 69 73 20 62 65 he journal is be
8660: 69 6e 67 0a 2a 2a 20 77 72 69 74 74 65 6e 2c 20 ing.** written,
8670: 73 65 6d 69 2d 72 61 6e 64 6f 6d 20 67 61 72 62 semi-random garb
8680: 61 67 65 20 64 61 74 61 20 6d 69 67 68 74 20 61 age data might a
8690: 70 70 65 61 72 20 69 6e 20 74 68 65 20 6a 6f 75 ppear in the jou
86a0: 72 6e 61 6c 0a 2a 2a 20 66 69 6c 65 20 61 66 74 rnal.** file aft
86b0: 65 72 20 70 6f 77 65 72 20 69 73 20 72 65 73 74 er power is rest
86c0: 6f 72 65 64 2e 20 20 49 66 20 61 6e 20 61 74 74 ored. If an att
86d0: 65 6d 70 74 20 69 73 20 74 68 65 6e 20 6d 61 64 empt is then mad
86e0: 65 0a 2a 2a 20 74 6f 20 72 6f 6c 6c 20 74 68 65 e.** to roll the
86f0: 20 6a 6f 75 72 6e 61 6c 20 62 61 63 6b 2c 20 74 journal back, t
8700: 68 65 20 64 61 74 61 62 61 73 65 20 63 6f 75 6c he database coul
8710: 64 20 62 65 20 63 6f 72 72 75 70 74 65 64 2e 20 d be corrupted.
8720: 20 54 68 65 20 61 64 64 69 74 69 6f 6e 61 6c 0a The additional.
8730: 2a 2a 20 73 61 6e 69 74 79 20 63 68 65 63 6b 69 ** sanity checki
8740: 6e 67 20 64 61 74 61 20 69 73 20 61 6e 20 61 74 ng data is an at
8750: 74 65 6d 70 74 20 74 6f 20 64 69 73 63 6f 76 65 tempt to discove
8760: 72 20 74 68 65 20 67 61 72 62 61 67 65 20 69 6e r the garbage in
8770: 20 74 68 65 0a 2a 2a 20 6a 6f 75 72 6e 61 6c 20 the.** journal
8780: 61 6e 64 20 69 67 6e 6f 72 65 20 69 74 2e 0a 2a and ignore it..*
8790: 2a 0a 2a 2a 20 54 68 65 20 73 61 6e 69 74 79 20 *.** The sanity
87a0: 63 68 65 63 6b 69 6e 67 20 69 6e 66 6f 72 6d 61 checking informa
87b0: 74 69 6f 6e 20 66 6f 72 20 74 68 65 20 6e 65 77 tion for the new
87c0: 20 6a 6f 75 72 6e 61 6c 20 66 6f 72 6d 61 74 20 journal format
87d0: 63 6f 6e 73 69 73 74 73 0a 2a 2a 20 6f 66 20 61 consists.** of a
87e0: 20 33 32 2d 62 69 74 20 63 68 65 63 6b 73 75 6d 32-bit checksum
87f0: 20 6f 6e 20 65 61 63 68 20 70 61 67 65 20 6f 66 on each page of
8800: 20 64 61 74 61 2e 20 20 54 68 65 20 63 68 65 63 data. The chec
8810: 6b 73 75 6d 20 63 6f 76 65 72 73 20 62 6f 74 68 ksum covers both
8820: 0a 2a 2a 20 74 68 65 20 70 61 67 65 20 6e 75 6d .** the page num
8830: 62 65 72 20 61 6e 64 20 74 68 65 20 70 50 61 67 ber and the pPag
8840: 65 72 2d 3e 70 61 67 65 53 69 7a 65 20 62 79 74 er->pageSize byt
8850: 65 73 20 6f 66 20 64 61 74 61 20 66 6f 72 20 74 es of data for t
8860: 68 65 20 70 61 67 65 2e 0a 2a 2a 20 54 68 69 73 he page..** This
8870: 20 63 6b 73 75 6d 20 69 73 20 69 6e 69 74 69 61 cksum is initia
8880: 6c 69 7a 65 64 20 74 6f 20 61 20 33 32 2d 62 69 lized to a 32-bi
8890: 74 20 72 61 6e 64 6f 6d 20 76 61 6c 75 65 20 74 t random value t
88a0: 68 61 74 20 61 70 70 65 61 72 73 20 69 6e 20 74 hat appears in t
88b0: 68 65 0a 2a 2a 20 6a 6f 75 72 6e 61 6c 20 66 69 he.** journal fi
88c0: 6c 65 20 72 69 67 68 74 20 61 66 74 65 72 20 74 le right after t
88d0: 68 65 20 68 65 61 64 65 72 2e 20 20 54 68 65 20 he header. The
88e0: 72 61 6e 64 6f 6d 20 69 6e 69 74 69 61 6c 69 7a random initializ
88f0: 65 72 20 69 73 20 69 6d 70 6f 72 74 61 6e 74 2c er is important,
8900: 0a 2a 2a 20 62 65 63 61 75 73 65 20 67 61 72 62 .** because garb
8910: 61 67 65 20 64 61 74 61 20 74 68 61 74 20 61 70 age data that ap
8920: 70 65 61 72 73 20 61 74 20 74 68 65 20 65 6e 64 pears at the end
8930: 20 6f 66 20 61 20 6a 6f 75 72 6e 61 6c 20 69 73 of a journal is
8940: 20 6c 69 6b 65 6c 79 0a 2a 2a 20 64 61 74 61 20 likely.** data
8950: 74 68 61 74 20 77 61 73 20 6f 6e 63 65 20 69 6e that was once in
8960: 20 6f 74 68 65 72 20 66 69 6c 65 73 20 74 68 61 other files tha
8970: 74 20 68 61 76 65 20 6e 6f 77 20 62 65 65 6e 20 t have now been
8980: 64 65 6c 65 74 65 64 2e 20 20 49 66 20 74 68 65 deleted. If the
8990: 0a 2a 2a 20 67 61 72 62 61 67 65 20 64 61 74 61 .** garbage data
89a0: 20 63 61 6d 65 20 66 72 6f 6d 20 61 6e 20 6f 62 came from an ob
89b0: 73 6f 6c 65 74 65 20 6a 6f 75 72 6e 61 6c 20 66 solete journal f
89c0: 69 6c 65 2c 20 74 68 65 20 63 68 65 63 6b 73 75 ile, the checksu
89d0: 6d 73 20 6d 69 67 68 74 0a 2a 2a 20 62 65 20 63 ms might.** be c
89e0: 6f 72 72 65 63 74 2e 20 20 42 75 74 20 62 79 20 orrect. But by
89f0: 69 6e 69 74 69 61 6c 69 7a 69 6e 67 20 74 68 65 initializing the
8a00: 20 63 68 65 63 6b 73 75 6d 20 74 6f 20 72 61 6e checksum to ran
8a10: 64 6f 6d 20 76 61 6c 75 65 20 77 68 69 63 68 0a dom value which.
8a20: 2a 2a 20 69 73 20 64 69 66 66 65 72 65 6e 74 20 ** is different
8a30: 66 6f 72 20 65 76 65 72 79 20 6a 6f 75 72 6e 61 for every journa
8a40: 6c 2c 20 77 65 20 6d 69 6e 69 6d 69 7a 65 20 74 l, we minimize t
8a50: 68 61 74 20 72 69 73 6b 2e 0a 2a 2f 0a 73 74 61 hat risk..*/.sta
8a60: 74 69 63 20 63 6f 6e 73 74 20 75 6e 73 69 67 6e tic const unsign
8a70: 65 64 20 63 68 61 72 20 61 4a 6f 75 72 6e 61 6c ed char aJournal
8a80: 4d 61 67 69 63 5b 5d 20 3d 20 7b 0a 20 20 30 78 Magic[] = {. 0x
8a90: 64 39 2c 20 30 78 64 35 2c 20 30 78 30 35 2c 20 d9, 0xd5, 0x05,
8aa0: 30 78 66 39 2c 20 30 78 32 30 2c 20 30 78 61 31 0xf9, 0x20, 0xa1
8ab0: 2c 20 30 78 36 33 2c 20 30 78 64 37 2c 0a 7d 3b , 0x63, 0xd7,.};
8ac0: 0a 0a 2f 2a 0a 2a 2a 20 54 68 65 20 73 69 7a 65 ../*.** The size
8ad0: 20 6f 66 20 74 68 65 20 6f 66 20 65 61 63 68 20 of the of each
8ae0: 70 61 67 65 20 72 65 63 6f 72 64 20 69 6e 20 74 page record in t
8af0: 68 65 20 6a 6f 75 72 6e 61 6c 20 69 73 20 67 69 he journal is gi
8b00: 76 65 6e 20 62 79 0a 2a 2a 20 74 68 65 20 66 6f ven by.** the fo
8b10: 6c 6c 6f 77 69 6e 67 20 6d 61 63 72 6f 2e 0a 2a llowing macro..*
8b20: 2f 0a 23 64 65 66 69 6e 65 20 4a 4f 55 52 4e 41 /.#define JOURNA
8b30: 4c 5f 50 47 5f 53 5a 28 70 50 61 67 65 72 29 20 L_PG_SZ(pPager)
8b40: 20 28 28 70 50 61 67 65 72 2d 3e 70 61 67 65 53 ((pPager->pageS
8b50: 69 7a 65 29 20 2b 20 38 29 0a 0a 2f 2a 0a 2a 2a ize) + 8)../*.**
8b60: 20 54 68 65 20 6a 6f 75 72 6e 61 6c 20 68 65 61 The journal hea
8b70: 64 65 72 20 73 69 7a 65 20 66 6f 72 20 74 68 69 der size for thi
8b80: 73 20 70 61 67 65 72 2e 20 54 68 69 73 20 69 73 s pager. This is
8b90: 20 75 73 75 61 6c 6c 79 20 74 68 65 20 73 61 6d usually the sam
8ba0: 65 20 0a 2a 2a 20 73 69 7a 65 20 61 73 20 61 20 e .** size as a
8bb0: 73 69 6e 67 6c 65 20 64 69 73 6b 20 73 65 63 74 single disk sect
8bc0: 6f 72 2e 20 53 65 65 20 61 6c 73 6f 20 73 65 74 or. See also set
8bd0: 53 65 63 74 6f 72 53 69 7a 65 28 29 2e 0a 2a 2f SectorSize()..*/
8be0: 0a 23 64 65 66 69 6e 65 20 4a 4f 55 52 4e 41 4c .#define JOURNAL
8bf0: 5f 48 44 52 5f 53 5a 28 70 50 61 67 65 72 29 20 _HDR_SZ(pPager)
8c00: 28 70 50 61 67 65 72 2d 3e 73 65 63 74 6f 72 53 (pPager->sectorS
8c10: 69 7a 65 29 0a 0a 2f 2a 0a 2a 2a 20 54 68 65 20 ize)../*.** The
8c20: 6d 61 63 72 6f 20 4d 45 4d 44 42 20 69 73 20 74 macro MEMDB is t
8c30: 72 75 65 20 69 66 20 77 65 20 61 72 65 20 64 65 rue if we are de
8c40: 61 6c 69 6e 67 20 77 69 74 68 20 61 6e 20 69 6e aling with an in
8c50: 2d 6d 65 6d 6f 72 79 20 64 61 74 61 62 61 73 65 -memory database
8c60: 2e 0a 2a 2a 20 57 65 20 64 6f 20 74 68 69 73 20 ..** We do this
8c70: 61 73 20 61 20 6d 61 63 72 6f 20 73 6f 20 74 68 as a macro so th
8c80: 61 74 20 69 66 20 74 68 65 20 53 51 4c 49 54 45 at if the SQLITE
8c90: 5f 4f 4d 49 54 5f 4d 45 4d 4f 52 59 44 42 20 6d _OMIT_MEMORYDB m
8ca0: 61 63 72 6f 20 69 73 20 73 65 74 2c 0a 2a 2a 20 acro is set,.**
8cb0: 74 68 65 20 76 61 6c 75 65 20 6f 66 20 4d 45 4d the value of MEM
8cc0: 44 42 20 77 69 6c 6c 20 62 65 20 61 20 63 6f 6e DB will be a con
8cd0: 73 74 61 6e 74 20 61 6e 64 20 74 68 65 20 63 6f stant and the co
8ce0: 6d 70 69 6c 65 72 20 77 69 6c 6c 20 6f 70 74 69 mpiler will opti
8cf0: 6d 69 7a 65 0a 2a 2a 20 6f 75 74 20 63 6f 64 65 mize.** out code
8d00: 20 74 68 61 74 20 77 6f 75 6c 64 20 6e 65 76 65 that would neve
8d10: 72 20 65 78 65 63 75 74 65 2e 0a 2a 2f 0a 23 69 r execute..*/.#i
8d20: 66 64 65 66 20 53 51 4c 49 54 45 5f 4f 4d 49 54 fdef SQLITE_OMIT
8d30: 5f 4d 45 4d 4f 52 59 44 42 0a 23 20 64 65 66 69 _MEMORYDB.# defi
8d40: 6e 65 20 4d 45 4d 44 42 20 30 0a 23 65 6c 73 65 ne MEMDB 0.#else
8d50: 0a 23 20 64 65 66 69 6e 65 20 4d 45 4d 44 42 20 .# define MEMDB
8d60: 70 50 61 67 65 72 2d 3e 6d 65 6d 44 62 0a 23 65 pPager->memDb.#e
8d70: 6e 64 69 66 0a 0a 2f 2a 0a 2a 2a 20 54 68 65 20 ndif../*.** The
8d80: 6d 61 78 69 6d 75 6d 20 6c 65 67 61 6c 20 70 61 maximum legal pa
8d90: 67 65 20 6e 75 6d 62 65 72 20 69 73 20 28 32 5e ge number is (2^
8da0: 33 31 20 2d 20 31 29 2e 0a 2a 2f 0a 23 64 65 66 31 - 1)..*/.#def
8db0: 69 6e 65 20 50 41 47 45 52 5f 4d 41 58 5f 50 47 ine PAGER_MAX_PG
8dc0: 4e 4f 20 32 31 34 37 34 38 33 36 34 37 0a 0a 2f NO 2147483647../
8dd0: 2a 0a 2a 2a 20 54 68 65 20 61 72 67 75 6d 65 6e *.** The argumen
8de0: 74 20 74 6f 20 74 68 69 73 20 6d 61 63 72 6f 20 t to this macro
8df0: 69 73 20 61 20 66 69 6c 65 20 64 65 73 63 72 69 is a file descri
8e00: 70 74 6f 72 20 28 74 79 70 65 20 73 71 6c 69 74 ptor (type sqlit
8e10: 65 33 5f 66 69 6c 65 2a 29 2e 0a 2a 2a 20 52 65 e3_file*)..** Re
8e20: 74 75 72 6e 20 30 20 69 66 20 69 74 20 69 73 20 turn 0 if it is
8e30: 6e 6f 74 20 6f 70 65 6e 2c 20 6f 72 20 6e 6f 6e not open, or non
8e40: 2d 7a 65 72 6f 20 28 62 75 74 20 6e 6f 74 20 31 -zero (but not 1
8e50: 29 20 69 66 20 69 74 20 69 73 2e 0a 2a 2a 0a 2a ) if it is..**.*
8e60: 2a 20 54 68 69 73 20 69 73 20 73 6f 20 74 68 61 * This is so tha
8e70: 74 20 65 78 70 72 65 73 73 69 6f 6e 73 20 63 61 t expressions ca
8e80: 6e 20 62 65 20 77 72 69 74 74 65 6e 20 61 73 3a n be written as:
8e90: 0a 2a 2a 0a 2a 2a 20 20 20 69 66 28 20 69 73 4f .**.** if( isO
8ea0: 70 65 6e 28 70 50 61 67 65 72 2d 3e 6a 66 64 29 pen(pPager->jfd)
8eb0: 20 29 7b 20 2e 2e 2e 0a 2a 2a 0a 2a 2a 20 69 6e ){ ....**.** in
8ec0: 73 74 65 61 64 20 6f 66 0a 2a 2a 0a 2a 2a 20 20 stead of.**.**
8ed0: 20 69 66 28 20 70 50 61 67 65 72 2d 3e 6a 66 64 if( pPager->jfd
8ee0: 2d 3e 70 4d 65 74 68 6f 64 73 20 29 7b 20 2e 2e ->pMethods ){ ..
8ef0: 2e 0a 2a 2f 0a 23 64 65 66 69 6e 65 20 69 73 4f ..*/.#define isO
8f00: 70 65 6e 28 70 46 64 29 20 28 28 70 46 64 29 2d pen(pFd) ((pFd)-
8f10: 3e 70 4d 65 74 68 6f 64 73 29 0a 0a 2f 2a 0a 2a >pMethods)../*.*
8f20: 2a 20 52 65 74 75 72 6e 20 74 72 75 65 20 69 66 * Return true if
8f30: 20 74 68 69 73 20 70 61 67 65 72 20 75 73 65 73 this pager uses
8f40: 20 61 20 77 72 69 74 65 2d 61 68 65 61 64 20 6c a write-ahead l
8f50: 6f 67 20 69 6e 73 74 65 61 64 20 6f 66 20 74 68 og instead of th
8f60: 65 20 75 73 75 61 6c 0a 2a 2a 20 72 6f 6c 6c 62 e usual.** rollb
8f70: 61 63 6b 20 6a 6f 75 72 6e 61 6c 2e 20 4f 74 68 ack journal. Oth
8f80: 65 72 77 69 73 65 20 66 61 6c 73 65 2e 0a 2a 2f erwise false..*/
8f90: 0a 23 69 66 6e 64 65 66 20 53 51 4c 49 54 45 5f .#ifndef SQLITE_
8fa0: 4f 4d 49 54 5f 57 41 4c 0a 73 74 61 74 69 63 20 OMIT_WAL.static
8fb0: 69 6e 74 20 70 61 67 65 72 55 73 65 57 61 6c 28 int pagerUseWal(
8fc0: 50 61 67 65 72 20 2a 70 50 61 67 65 72 29 7b 0a Pager *pPager){.
8fd0: 20 20 72 65 74 75 72 6e 20 28 70 50 61 67 65 72 return (pPager
8fe0: 2d 3e 70 57 61 6c 21 3d 30 29 3b 0a 7d 0a 23 65 ->pWal!=0);.}.#e
8ff0: 6c 73 65 0a 23 20 64 65 66 69 6e 65 20 70 61 67 lse.# define pag
9000: 65 72 55 73 65 57 61 6c 28 78 29 20 30 0a 23 20 erUseWal(x) 0.#
9010: 64 65 66 69 6e 65 20 70 61 67 65 72 52 6f 6c 6c define pagerRoll
9020: 62 61 63 6b 57 61 6c 28 78 29 20 30 0a 23 20 64 backWal(x) 0.# d
9030: 65 66 69 6e 65 20 70 61 67 65 72 57 61 6c 46 72 efine pagerWalFr
9040: 61 6d 65 73 28 76 2c 77 2c 78 2c 79 2c 7a 29 20 ames(v,w,x,y,z)
9050: 30 0a 23 20 64 65 66 69 6e 65 20 70 61 67 65 72 0.# define pager
9060: 4f 70 65 6e 57 61 6c 49 66 50 72 65 73 65 6e 74 OpenWalIfPresent
9070: 28 7a 29 20 53 51 4c 49 54 45 5f 4f 4b 0a 23 20 (z) SQLITE_OK.#
9080: 64 65 66 69 6e 65 20 70 61 67 65 72 42 65 67 69 define pagerBegi
9090: 6e 52 65 61 64 54 72 61 6e 73 61 63 74 69 6f 6e nReadTransaction
90a0: 28 7a 29 20 53 51 4c 49 54 45 5f 4f 4b 0a 23 65 (z) SQLITE_OK.#e
90b0: 6e 64 69 66 0a 0a 23 69 66 6e 64 65 66 20 4e 44 ndif..#ifndef ND
90c0: 45 42 55 47 20 0a 2f 2a 0a 2a 2a 20 55 73 61 67 EBUG ./*.** Usag
90d0: 65 3a 0a 2a 2a 0a 2a 2a 20 20 20 61 73 73 65 72 e:.**.** asser
90e0: 74 28 20 61 73 73 65 72 74 5f 70 61 67 65 72 5f t( assert_pager_
90f0: 73 74 61 74 65 28 70 50 61 67 65 72 29 20 29 3b state(pPager) );
9100: 0a 2a 2a 0a 2a 2a 20 54 68 69 73 20 66 75 6e 63 .**.** This func
9110: 74 69 6f 6e 20 72 75 6e 73 20 6d 61 6e 79 20 61 tion runs many a
9120: 73 73 65 72 74 73 20 74 6f 20 74 72 79 20 74 6f sserts to try to
9130: 20 66 69 6e 64 20 69 6e 63 6f 6e 73 69 73 74 65 find inconsiste
9140: 6e 63 69 65 73 20 69 6e 0a 2a 2a 20 74 68 65 20 ncies in.** the
9150: 69 6e 74 65 72 6e 61 6c 20 73 74 61 74 65 20 6f internal state o
9160: 66 20 74 68 65 20 50 61 67 65 72 20 6f 62 6a 65 f the Pager obje
9170: 63 74 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e ct..*/.static in
9180: 74 20 61 73 73 65 72 74 5f 70 61 67 65 72 5f 73 t assert_pager_s
9190: 74 61 74 65 28 50 61 67 65 72 20 2a 70 29 7b 0a tate(Pager *p){.
91a0: 20 20 50 61 67 65 72 20 2a 70 50 61 67 65 72 20 Pager *pPager
91b0: 3d 20 70 3b 0a 0a 20 20 2f 2a 20 53 74 61 74 65 = p;.. /* State
91c0: 20 6d 75 73 74 20 62 65 20 76 61 6c 69 64 2e 20 must be valid.
91d0: 2a 2f 0a 20 20 61 73 73 65 72 74 28 20 70 2d 3e */. assert( p->
91e0: 65 53 74 61 74 65 3d 3d 50 41 47 45 52 5f 4f 50 eState==PAGER_OP
91f0: 45 4e 0a 20 20 20 20 20 20 20 7c 7c 20 70 2d 3e EN. || p->
9200: 65 53 74 61 74 65 3d 3d 50 41 47 45 52 5f 52 45 eState==PAGER_RE
9210: 41 44 45 52 0a 20 20 20 20 20 20 20 7c 7c 20 70 ADER. || p
9220: 2d 3e 65 53 74 61 74 65 3d 3d 50 41 47 45 52 5f ->eState==PAGER_
9230: 57 52 49 54 45 52 5f 4c 4f 43 4b 45 44 0a 20 20 WRITER_LOCKED.
9240: 20 20 20 20 20 7c 7c 20 70 2d 3e 65 53 74 61 74 || p->eStat
9250: 65 3d 3d 50 41 47 45 52 5f 57 52 49 54 45 52 5f e==PAGER_WRITER_
9260: 43 41 43 48 45 4d 4f 44 0a 20 20 20 20 20 20 20 CACHEMOD.
9270: 7c 7c 20 70 2d 3e 65 53 74 61 74 65 3d 3d 50 41 || p->eState==PA
9280: 47 45 52 5f 57 52 49 54 45 52 5f 44 42 4d 4f 44 GER_WRITER_DBMOD
9290: 0a 20 20 20 20 20 20 20 7c 7c 20 70 2d 3e 65 53 . || p->eS
92a0: 74 61 74 65 3d 3d 50 41 47 45 52 5f 57 52 49 54 tate==PAGER_WRIT
92b0: 45 52 5f 46 49 4e 49 53 48 45 44 0a 20 20 20 20 ER_FINISHED.
92c0: 20 20 20 7c 7c 20 70 2d 3e 65 53 74 61 74 65 3d || p->eState=
92d0: 3d 50 41 47 45 52 5f 45 52 52 4f 52 0a 20 20 29 =PAGER_ERROR. )
92e0: 3b 0a 0a 20 20 2f 2a 20 52 65 67 61 72 64 6c 65 ;.. /* Regardle
92f0: 73 73 20 6f 66 20 74 68 65 20 63 75 72 72 65 6e ss of the curren
9300: 74 20 73 74 61 74 65 2c 20 61 20 74 65 6d 70 2d t state, a temp-
9310: 66 69 6c 65 20 63 6f 6e 6e 65 63 74 69 6f 6e 20 file connection
9320: 61 6c 77 61 79 73 20 62 65 68 61 76 65 73 0a 20 always behaves.
9330: 20 2a 2a 20 61 73 20 69 66 20 69 74 20 68 61 73 ** as if it has
9340: 20 61 6e 20 65 78 63 6c 75 73 69 76 65 20 6c 6f an exclusive lo
9350: 63 6b 20 6f 6e 20 74 68 65 20 64 61 74 61 62 61 ck on the databa
9360: 73 65 20 66 69 6c 65 2e 20 49 74 20 6e 65 76 65 se file. It neve
9370: 72 20 75 70 64 61 74 65 73 0a 20 20 2a 2a 20 74 r updates. ** t
9380: 68 65 20 63 68 61 6e 67 65 2d 63 6f 75 6e 74 65 he change-counte
9390: 72 20 66 69 65 6c 64 2c 20 73 6f 20 74 68 65 20 r field, so the
93a0: 63 68 61 6e 67 65 43 6f 75 6e 74 44 6f 6e 65 20 changeCountDone
93b0: 66 6c 61 67 20 69 73 20 61 6c 77 61 79 73 20 73 flag is always s
93c0: 65 74 2e 0a 20 20 2a 2f 0a 20 20 61 73 73 65 72 et.. */. asser
93d0: 74 28 20 70 2d 3e 74 65 6d 70 46 69 6c 65 3d 3d t( p->tempFile==
93e0: 30 20 7c 7c 20 70 2d 3e 65 4c 6f 63 6b 3d 3d 45 0 || p->eLock==E
93f0: 58 43 4c 55 53 49 56 45 5f 4c 4f 43 4b 20 29 3b XCLUSIVE_LOCK );
9400: 0a 20 20 61 73 73 65 72 74 28 20 70 2d 3e 74 65 . assert( p->te
9410: 6d 70 46 69 6c 65 3d 3d 30 20 7c 7c 20 70 50 61 mpFile==0 || pPa
9420: 67 65 72 2d 3e 63 68 61 6e 67 65 43 6f 75 6e 74 ger->changeCount
9430: 44 6f 6e 65 20 29 3b 0a 0a 20 20 2f 2a 20 49 66 Done );.. /* If
9440: 20 74 68 65 20 75 73 65 4a 6f 75 72 6e 61 6c 20 the useJournal
9450: 66 6c 61 67 20 69 73 20 63 6c 65 61 72 2c 20 74 flag is clear, t
9460: 68 65 20 6a 6f 75 72 6e 61 6c 2d 6d 6f 64 65 20 he journal-mode
9470: 6d 75 73 74 20 62 65 20 22 4f 46 46 22 2e 20 0a must be "OFF". .
9480: 20 20 2a 2a 20 41 6e 64 20 69 66 20 74 68 65 20 ** And if the
9490: 6a 6f 75 72 6e 61 6c 2d 6d 6f 64 65 20 69 73 20 journal-mode is
94a0: 22 4f 46 46 22 2c 20 74 68 65 20 6a 6f 75 72 6e "OFF", the journ
94b0: 61 6c 20 66 69 6c 65 20 6d 75 73 74 20 6e 6f 74 al file must not
94c0: 20 62 65 20 6f 70 65 6e 2e 0a 20 20 2a 2f 0a 20 be open.. */.
94d0: 20 61 73 73 65 72 74 28 20 70 2d 3e 6a 6f 75 72 assert( p->jour
94e0: 6e 61 6c 4d 6f 64 65 3d 3d 50 41 47 45 52 5f 4a nalMode==PAGER_J
94f0: 4f 55 52 4e 41 4c 4d 4f 44 45 5f 4f 46 46 20 7c OURNALMODE_OFF |
9500: 7c 20 70 2d 3e 75 73 65 4a 6f 75 72 6e 61 6c 20 | p->useJournal
9510: 29 3b 0a 20 20 61 73 73 65 72 74 28 20 70 2d 3e );. assert( p->
9520: 6a 6f 75 72 6e 61 6c 4d 6f 64 65 21 3d 50 41 47 journalMode!=PAG
9530: 45 52 5f 4a 4f 55 52 4e 41 4c 4d 4f 44 45 5f 4f ER_JOURNALMODE_O
9540: 46 46 20 7c 7c 20 21 69 73 4f 70 65 6e 28 70 2d FF || !isOpen(p-
9550: 3e 6a 66 64 29 20 29 3b 0a 0a 20 20 2f 2a 20 43 >jfd) );.. /* C
9560: 68 65 63 6b 20 74 68 61 74 20 4d 45 4d 44 42 20 heck that MEMDB
9570: 69 6d 70 6c 69 65 73 20 6e 6f 53 79 6e 63 2e 20 implies noSync.
9580: 41 6e 64 20 61 6e 20 69 6e 2d 6d 65 6d 6f 72 79 And an in-memory
9590: 20 6a 6f 75 72 6e 61 6c 2e 20 53 69 6e 63 65 20 journal. Since
95a0: 0a 20 20 2a 2a 20 74 68 69 73 20 6d 65 61 6e 73 . ** this means
95b0: 20 61 6e 20 69 6e 2d 6d 65 6d 6f 72 79 20 70 61 an in-memory pa
95c0: 67 65 72 20 70 65 72 66 6f 72 6d 73 20 6e 6f 20 ger performs no
95d0: 49 4f 20 61 74 20 61 6c 6c 2c 20 69 74 20 63 61 IO at all, it ca
95e0: 6e 6e 6f 74 20 65 6e 63 6f 75 6e 74 65 72 20 0a nnot encounter .
95f0: 20 20 2a 2a 20 65 69 74 68 65 72 20 53 51 4c 49 ** either SQLI
9600: 54 45 5f 49 4f 45 52 52 20 6f 72 20 53 51 4c 49 TE_IOERR or SQLI
9610: 54 45 5f 46 55 4c 4c 20 64 75 72 69 6e 67 20 72 TE_FULL during r
9620: 6f 6c 6c 62 61 63 6b 20 6f 72 20 77 68 69 6c 65 ollback or while
9630: 20 66 69 6e 61 6c 69 7a 69 6e 67 20 0a 20 20 2a finalizing . *
9640: 2a 20 61 20 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 * a journal file
9650: 2e 20 28 61 6c 74 68 6f 75 67 68 20 74 68 65 20 . (although the
9660: 69 6e 2d 6d 65 6d 6f 72 79 20 6a 6f 75 72 6e 61 in-memory journa
9670: 6c 20 69 6d 70 6c 65 6d 65 6e 74 61 74 69 6f 6e l implementation
9680: 20 6d 61 79 20 0a 20 20 2a 2a 20 72 65 74 75 72 may . ** retur
9690: 6e 20 53 51 4c 49 54 45 5f 49 4f 45 52 52 5f 4e n SQLITE_IOERR_N
96a0: 4f 4d 45 4d 20 77 68 69 6c 65 20 74 68 65 20 6a OMEM while the j
96b0: 6f 75 72 6e 61 6c 20 66 69 6c 65 20 69 73 20 62 ournal file is b
96c0: 65 69 6e 67 20 77 72 69 74 74 65 6e 29 2e 20 49 eing written). I
96d0: 74 20 0a 20 20 2a 2a 20 69 73 20 74 68 65 72 65 t . ** is there
96e0: 66 6f 72 65 20 6e 6f 74 20 70 6f 73 73 69 62 6c fore not possibl
96f0: 65 20 66 6f 72 20 61 6e 20 69 6e 2d 6d 65 6d 6f e for an in-memo
9700: 72 79 20 70 61 67 65 72 20 74 6f 20 65 6e 74 65 ry pager to ente
9710: 72 20 74 68 65 20 45 52 52 4f 52 20 0a 20 20 2a r the ERROR . *
9720: 2a 20 73 74 61 74 65 2e 0a 20 20 2a 2f 0a 20 20 * state.. */.
9730: 69 66 28 20 4d 45 4d 44 42 20 29 7b 0a 20 20 20 if( MEMDB ){.
9740: 20 61 73 73 65 72 74 28 20 70 2d 3e 6e 6f 53 79 assert( p->noSy
9750: 6e 63 20 29 3b 0a 20 20 20 20 61 73 73 65 72 74 nc );. assert
9760: 28 20 70 2d 3e 6a 6f 75 72 6e 61 6c 4d 6f 64 65 ( p->journalMode
9770: 3d 3d 50 41 47 45 52 5f 4a 4f 55 52 4e 41 4c 4d ==PAGER_JOURNALM
9780: 4f 44 45 5f 4f 46 46 20 0a 20 20 20 20 20 20 20 ODE_OFF .
9790: 20 20 7c 7c 20 70 2d 3e 6a 6f 75 72 6e 61 6c 4d || p->journalM
97a0: 6f 64 65 3d 3d 50 41 47 45 52 5f 4a 4f 55 52 4e ode==PAGER_JOURN
97b0: 41 4c 4d 4f 44 45 5f 4d 45 4d 4f 52 59 20 0a 20 ALMODE_MEMORY .
97c0: 20 20 20 29 3b 0a 20 20 20 20 61 73 73 65 72 74 );. assert
97d0: 28 20 70 2d 3e 65 53 74 61 74 65 21 3d 50 41 47 ( p->eState!=PAG
97e0: 45 52 5f 45 52 52 4f 52 20 26 26 20 70 2d 3e 65 ER_ERROR && p->e
97f0: 53 74 61 74 65 21 3d 50 41 47 45 52 5f 4f 50 45 State!=PAGER_OPE
9800: 4e 20 29 3b 0a 20 20 20 20 61 73 73 65 72 74 28 N );. assert(
9810: 20 70 61 67 65 72 55 73 65 57 61 6c 28 70 29 3d pagerUseWal(p)=
9820: 3d 30 20 29 3b 0a 20 20 7d 0a 0a 20 20 2f 2a 20 =0 );. }.. /*
9830: 49 66 20 63 68 61 6e 67 65 43 6f 75 6e 74 44 6f If changeCountDo
9840: 6e 65 20 69 73 20 73 65 74 2c 20 61 20 52 45 53 ne is set, a RES
9850: 45 52 56 45 44 20 6c 6f 63 6b 20 6f 72 20 67 72 ERVED lock or gr
9860: 65 61 74 65 72 20 6d 75 73 74 20 62 65 20 68 65 eater must be he
9870: 6c 64 0a 20 20 2a 2a 20 6f 6e 20 74 68 65 20 66 ld. ** on the f
9880: 69 6c 65 2e 0a 20 20 2a 2f 0a 20 20 61 73 73 65 ile.. */. asse
9890: 72 74 28 20 70 50 61 67 65 72 2d 3e 63 68 61 6e rt( pPager->chan
98a0: 67 65 43 6f 75 6e 74 44 6f 6e 65 3d 3d 30 20 7c geCountDone==0 |
98b0: 7c 20 70 50 61 67 65 72 2d 3e 65 4c 6f 63 6b 3e | pPager->eLock>
98c0: 3d 52 45 53 45 52 56 45 44 5f 4c 4f 43 4b 20 29 =RESERVED_LOCK )
98d0: 3b 0a 20 20 61 73 73 65 72 74 28 20 70 2d 3e 65 ;. assert( p->e
98e0: 4c 6f 63 6b 21 3d 50 45 4e 44 49 4e 47 5f 4c 4f Lock!=PENDING_LO
98f0: 43 4b 20 29 3b 0a 0a 20 20 73 77 69 74 63 68 28 CK );.. switch(
9900: 20 70 2d 3e 65 53 74 61 74 65 20 29 7b 0a 20 20 p->eState ){.
9910: 20 20 63 61 73 65 20 50 41 47 45 52 5f 4f 50 45 case PAGER_OPE
9920: 4e 3a 0a 20 20 20 20 20 20 61 73 73 65 72 74 28 N:. assert(
9930: 20 21 4d 45 4d 44 42 20 29 3b 0a 20 20 20 20 20 !MEMDB );.
9940: 20 61 73 73 65 72 74 28 20 70 50 61 67 65 72 2d assert( pPager-
9950: 3e 65 72 72 43 6f 64 65 3d 3d 53 51 4c 49 54 45 >errCode==SQLITE
9960: 5f 4f 4b 20 29 3b 0a 20 20 20 20 20 20 61 73 73 _OK );. ass
9970: 65 72 74 28 20 73 71 6c 69 74 65 33 50 63 61 63 ert( sqlite3Pcac
9980: 68 65 52 65 66 43 6f 75 6e 74 28 70 50 61 67 65 heRefCount(pPage
9990: 72 2d 3e 70 50 43 61 63 68 65 29 3d 3d 30 20 7c r->pPCache)==0 |
99a0: 7c 20 70 50 61 67 65 72 2d 3e 74 65 6d 70 46 69 | pPager->tempFi
99b0: 6c 65 20 29 3b 0a 20 20 20 20 20 20 62 72 65 61 le );. brea
99c0: 6b 3b 0a 0a 20 20 20 20 63 61 73 65 20 50 41 47 k;.. case PAG
99d0: 45 52 5f 52 45 41 44 45 52 3a 0a 20 20 20 20 20 ER_READER:.
99e0: 20 61 73 73 65 72 74 28 20 70 50 61 67 65 72 2d assert( pPager-
99f0: 3e 65 72 72 43 6f 64 65 3d 3d 53 51 4c 49 54 45 >errCode==SQLITE
9a00: 5f 4f 4b 20 29 3b 0a 20 20 20 20 20 20 61 73 73 _OK );. ass
9a10: 65 72 74 28 20 70 2d 3e 65 4c 6f 63 6b 21 3d 55 ert( p->eLock!=U
9a20: 4e 4b 4e 4f 57 4e 5f 4c 4f 43 4b 20 29 3b 0a 20 NKNOWN_LOCK );.
9a30: 20 20 20 20 20 61 73 73 65 72 74 28 20 70 2d 3e assert( p->
9a40: 65 4c 6f 63 6b 3e 3d 53 48 41 52 45 44 5f 4c 4f eLock>=SHARED_LO
9a50: 43 4b 20 7c 7c 20 70 2d 3e 6e 6f 52 65 61 64 6c CK || p->noReadl
9a60: 6f 63 6b 20 29 3b 0a 20 20 20 20 20 20 62 72 65 ock );. bre
9a70: 61 6b 3b 0a 0a 20 20 20 20 63 61 73 65 20 50 41 ak;.. case PA
9a80: 47 45 52 5f 57 52 49 54 45 52 5f 4c 4f 43 4b 45 GER_WRITER_LOCKE
9a90: 44 3a 0a 20 20 20 20 20 20 61 73 73 65 72 74 28 D:. assert(
9aa0: 20 70 2d 3e 65 4c 6f 63 6b 21 3d 55 4e 4b 4e 4f p->eLock!=UNKNO
9ab0: 57 4e 5f 4c 4f 43 4b 20 29 3b 0a 20 20 20 20 20 WN_LOCK );.
9ac0: 20 61 73 73 65 72 74 28 20 70 50 61 67 65 72 2d assert( pPager-
9ad0: 3e 65 72 72 43 6f 64 65 3d 3d 53 51 4c 49 54 45 >errCode==SQLITE
9ae0: 5f 4f 4b 20 29 3b 0a 20 20 20 20 20 20 69 66 28 _OK );. if(
9af0: 20 21 70 61 67 65 72 55 73 65 57 61 6c 28 70 50 !pagerUseWal(pP
9b00: 61 67 65 72 29 20 29 7b 0a 20 20 20 20 20 20 20 ager) ){.
9b10: 20 61 73 73 65 72 74 28 20 70 2d 3e 65 4c 6f 63 assert( p->eLoc
9b20: 6b 3e 3d 52 45 53 45 52 56 45 44 5f 4c 4f 43 4b k>=RESERVED_LOCK
9b30: 20 29 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 );. }.
9b40: 20 20 61 73 73 65 72 74 28 20 70 50 61 67 65 72 assert( pPager
9b50: 2d 3e 64 62 53 69 7a 65 3d 3d 70 50 61 67 65 72 ->dbSize==pPager
9b60: 2d 3e 64 62 4f 72 69 67 53 69 7a 65 20 29 3b 0a ->dbOrigSize );.
9b70: 20 20 20 20 20 20 61 73 73 65 72 74 28 20 70 50 assert( pP
9b80: 61 67 65 72 2d 3e 64 62 4f 72 69 67 53 69 7a 65 ager->dbOrigSize
9b90: 3d 3d 70 50 61 67 65 72 2d 3e 64 62 46 69 6c 65 ==pPager->dbFile
9ba0: 53 69 7a 65 20 29 3b 0a 20 20 20 20 20 20 61 73 Size );. as
9bb0: 73 65 72 74 28 20 70 50 61 67 65 72 2d 3e 64 62 sert( pPager->db
9bc0: 4f 72 69 67 53 69 7a 65 3d 3d 70 50 61 67 65 72 OrigSize==pPager
9bd0: 2d 3e 64 62 48 69 6e 74 53 69 7a 65 20 29 3b 0a ->dbHintSize );.
9be0: 20 20 20 20 20 20 61 73 73 65 72 74 28 20 70 50 assert( pP
9bf0: 61 67 65 72 2d 3e 73 65 74 4d 61 73 74 65 72 3d ager->setMaster=
9c00: 3d 30 20 29 3b 0a 20 20 20 20 20 20 62 72 65 61 =0 );. brea
9c10: 6b 3b 0a 0a 20 20 20 20 63 61 73 65 20 50 41 47 k;.. case PAG
9c20: 45 52 5f 57 52 49 54 45 52 5f 43 41 43 48 45 4d ER_WRITER_CACHEM
9c30: 4f 44 3a 0a 20 20 20 20 20 20 61 73 73 65 72 74 OD:. assert
9c40: 28 20 70 2d 3e 65 4c 6f 63 6b 21 3d 55 4e 4b 4e ( p->eLock!=UNKN
9c50: 4f 57 4e 5f 4c 4f 43 4b 20 29 3b 0a 20 20 20 20 OWN_LOCK );.
9c60: 20 20 61 73 73 65 72 74 28 20 70 50 61 67 65 72 assert( pPager
9c70: 2d 3e 65 72 72 43 6f 64 65 3d 3d 53 51 4c 49 54 ->errCode==SQLIT
9c80: 45 5f 4f 4b 20 29 3b 0a 20 20 20 20 20 20 69 66 E_OK );. if
9c90: 28 20 21 70 61 67 65 72 55 73 65 57 61 6c 28 70 ( !pagerUseWal(p
9ca0: 50 61 67 65 72 29 20 29 7b 0a 20 20 20 20 20 20 Pager) ){.
9cb0: 20 20 2f 2a 20 49 74 20 69 73 20 70 6f 73 73 69 /* It is possi
9cc0: 62 6c 65 20 74 68 61 74 20 69 66 20 6a 6f 75 72 ble that if jour
9cd0: 6e 61 6c 5f 6d 6f 64 65 3d 77 61 6c 20 68 65 72 nal_mode=wal her
9ce0: 65 20 74 68 61 74 20 6e 65 69 74 68 65 72 20 74 e that neither t
9cf0: 68 65 0a 20 20 20 20 20 20 20 20 2a 2a 20 6a 6f he. ** jo
9d00: 75 72 6e 61 6c 20 66 69 6c 65 20 6e 6f 72 20 74 urnal file nor t
9d10: 68 65 20 57 41 4c 20 66 69 6c 65 20 61 72 65 20 he WAL file are
9d20: 6f 70 65 6e 2e 20 54 68 69 73 20 68 61 70 70 65 open. This happe
9d30: 6e 73 20 64 75 72 69 6e 67 0a 20 20 20 20 20 20 ns during.
9d40: 20 20 2a 2a 20 61 20 72 6f 6c 6c 62 61 63 6b 20 ** a rollback
9d50: 74 72 61 6e 73 61 63 74 69 6f 6e 20 74 68 61 74 transaction that
9d60: 20 73 77 69 74 63 68 65 73 20 66 72 6f 6d 20 6a switches from j
9d70: 6f 75 72 6e 61 6c 5f 6d 6f 64 65 3d 6f 66 66 0a ournal_mode=off.
9d80: 20 20 20 20 20 20 20 20 2a 2a 20 74 6f 20 6a 6f ** to jo
9d90: 75 72 6e 61 6c 5f 6d 6f 64 65 3d 77 61 6c 2e 0a urnal_mode=wal..
9da0: 20 20 20 20 20 20 20 20 2a 2f 0a 20 20 20 20 20 */.
9db0: 20 20 20 61 73 73 65 72 74 28 20 70 2d 3e 65 4c assert( p->eL
9dc0: 6f 63 6b 3e 3d 52 45 53 45 52 56 45 44 5f 4c 4f ock>=RESERVED_LO
9dd0: 43 4b 20 29 3b 0a 20 20 20 20 20 20 20 20 61 73 CK );. as
9de0: 73 65 72 74 28 20 69 73 4f 70 65 6e 28 70 2d 3e sert( isOpen(p->
9df0: 6a 66 64 29 20 0a 20 20 20 20 20 20 20 20 20 20 jfd) .
9e00: 20 20 20 7c 7c 20 70 2d 3e 6a 6f 75 72 6e 61 6c || p->journal
9e10: 4d 6f 64 65 3d 3d 50 41 47 45 52 5f 4a 4f 55 52 Mode==PAGER_JOUR
9e20: 4e 41 4c 4d 4f 44 45 5f 4f 46 46 20 0a 20 20 20 NALMODE_OFF .
9e30: 20 20 20 20 20 20 20 20 20 20 7c 7c 20 70 2d 3e || p->
9e40: 6a 6f 75 72 6e 61 6c 4d 6f 64 65 3d 3d 50 41 47 journalMode==PAG
9e50: 45 52 5f 4a 4f 55 52 4e 41 4c 4d 4f 44 45 5f 57 ER_JOURNALMODE_W
9e60: 41 4c 20 0a 20 20 20 20 20 20 20 20 29 3b 0a 20 AL . );.
9e70: 20 20 20 20 20 7d 0a 20 20 20 20 20 20 61 73 73 }. ass
9e80: 65 72 74 28 20 70 50 61 67 65 72 2d 3e 64 62 4f ert( pPager->dbO
9e90: 72 69 67 53 69 7a 65 3d 3d 70 50 61 67 65 72 2d rigSize==pPager-
9ea0: 3e 64 62 46 69 6c 65 53 69 7a 65 20 29 3b 0a 20 >dbFileSize );.
9eb0: 20 20 20 20 20 61 73 73 65 72 74 28 20 70 50 61 assert( pPa
9ec0: 67 65 72 2d 3e 64 62 4f 72 69 67 53 69 7a 65 3d ger->dbOrigSize=
9ed0: 3d 70 50 61 67 65 72 2d 3e 64 62 48 69 6e 74 53 =pPager->dbHintS
9ee0: 69 7a 65 20 29 3b 0a 20 20 20 20 20 20 62 72 65 ize );. bre
9ef0: 61 6b 3b 0a 0a 20 20 20 20 63 61 73 65 20 50 41 ak;.. case PA
9f00: 47 45 52 5f 57 52 49 54 45 52 5f 44 42 4d 4f 44 GER_WRITER_DBMOD
9f10: 3a 0a 20 20 20 20 20 20 61 73 73 65 72 74 28 20 :. assert(
9f20: 70 2d 3e 65 4c 6f 63 6b 3d 3d 45 58 43 4c 55 53 p->eLock==EXCLUS
9f30: 49 56 45 5f 4c 4f 43 4b 20 29 3b 0a 20 20 20 20 IVE_LOCK );.
9f40: 20 20 61 73 73 65 72 74 28 20 70 50 61 67 65 72 assert( pPager
9f50: 2d 3e 65 72 72 43 6f 64 65 3d 3d 53 51 4c 49 54 ->errCode==SQLIT
9f60: 45 5f 4f 4b 20 29 3b 0a 20 20 20 20 20 20 61 73 E_OK );. as
9f70: 73 65 72 74 28 20 21 70 61 67 65 72 55 73 65 57 sert( !pagerUseW
9f80: 61 6c 28 70 50 61 67 65 72 29 20 29 3b 0a 20 20 al(pPager) );.
9f90: 20 20 20 20 61 73 73 65 72 74 28 20 70 2d 3e 65 assert( p->e
9fa0: 4c 6f 63 6b 3e 3d 45 58 43 4c 55 53 49 56 45 5f Lock>=EXCLUSIVE_
9fb0: 4c 4f 43 4b 20 29 3b 0a 20 20 20 20 20 20 61 73 LOCK );. as
9fc0: 73 65 72 74 28 20 69 73 4f 70 65 6e 28 70 2d 3e sert( isOpen(p->
9fd0: 6a 66 64 29 20 0a 20 20 20 20 20 20 20 20 20 20 jfd) .
9fe0: 20 7c 7c 20 70 2d 3e 6a 6f 75 72 6e 61 6c 4d 6f || p->journalMo
9ff0: 64 65 3d 3d 50 41 47 45 52 5f 4a 4f 55 52 4e 41 de==PAGER_JOURNA
a000: 4c 4d 4f 44 45 5f 4f 46 46 20 0a 20 20 20 20 20 LMODE_OFF .
a010: 20 20 20 20 20 20 7c 7c 20 70 2d 3e 6a 6f 75 72 || p->jour
a020: 6e 61 6c 4d 6f 64 65 3d 3d 50 41 47 45 52 5f 4a nalMode==PAGER_J
a030: 4f 55 52 4e 41 4c 4d 4f 44 45 5f 57 41 4c 20 0a OURNALMODE_WAL .
a040: 20 20 20 20 20 20 29 3b 0a 20 20 20 20 20 20 61 );. a
a050: 73 73 65 72 74 28 20 70 50 61 67 65 72 2d 3e 64 ssert( pPager->d
a060: 62 4f 72 69 67 53 69 7a 65 3c 3d 70 50 61 67 65 bOrigSize<=pPage
a070: 72 2d 3e 64 62 48 69 6e 74 53 69 7a 65 20 29 3b r->dbHintSize );
a080: 0a 20 20 20 20 20 20 62 72 65 61 6b 3b 0a 0a 20 . break;..
a090: 20 20 20 63 61 73 65 20 50 41 47 45 52 5f 57 52 case PAGER_WR
a0a0: 49 54 45 52 5f 46 49 4e 49 53 48 45 44 3a 0a 20 ITER_FINISHED:.
a0b0: 20 20 20 20 20 61 73 73 65 72 74 28 20 70 2d 3e assert( p->
a0c0: 65 4c 6f 63 6b 3d 3d 45 58 43 4c 55 53 49 56 45 eLock==EXCLUSIVE
a0d0: 5f 4c 4f 43 4b 20 29 3b 0a 20 20 20 20 20 20 61 _LOCK );. a
a0e0: 73 73 65 72 74 28 20 70 50 61 67 65 72 2d 3e 65 ssert( pPager->e
a0f0: 72 72 43 6f 64 65 3d 3d 53 51 4c 49 54 45 5f 4f rrCode==SQLITE_O
a100: 4b 20 29 3b 0a 20 20 20 20 20 20 61 73 73 65 72 K );. asser
a110: 74 28 20 21 70 61 67 65 72 55 73 65 57 61 6c 28 t( !pagerUseWal(
a120: 70 50 61 67 65 72 29 20 29 3b 0a 20 20 20 20 20 pPager) );.
a130: 20 61 73 73 65 72 74 28 20 69 73 4f 70 65 6e 28 assert( isOpen(
a140: 70 2d 3e 6a 66 64 29 20 0a 20 20 20 20 20 20 20 p->jfd) .
a150: 20 20 20 20 7c 7c 20 70 2d 3e 6a 6f 75 72 6e 61 || p->journa
a160: 6c 4d 6f 64 65 3d 3d 50 41 47 45 52 5f 4a 4f 55 lMode==PAGER_JOU
a170: 52 4e 41 4c 4d 4f 44 45 5f 4f 46 46 20 0a 20 20 RNALMODE_OFF .
a180: 20 20 20 20 20 20 20 20 20 7c 7c 20 70 2d 3e 6a || p->j
a190: 6f 75 72 6e 61 6c 4d 6f 64 65 3d 3d 50 41 47 45 ournalMode==PAGE
a1a0: 52 5f 4a 4f 55 52 4e 41 4c 4d 4f 44 45 5f 57 41 R_JOURNALMODE_WA
a1b0: 4c 20 0a 20 20 20 20 20 20 29 3b 0a 20 20 20 20 L . );.
a1c0: 20 20 62 72 65 61 6b 3b 0a 0a 20 20 20 20 63 61 break;.. ca
a1d0: 73 65 20 50 41 47 45 52 5f 45 52 52 4f 52 3a 0a se PAGER_ERROR:.
a1e0: 20 20 20 20 20 20 2f 2a 20 54 68 65 72 65 20 6d /* There m
a1f0: 75 73 74 20 62 65 20 61 74 20 6c 65 61 73 74 20 ust be at least
a200: 6f 6e 65 20 6f 75 74 73 74 61 6e 64 69 6e 67 20 one outstanding
a210: 72 65 66 65 72 65 6e 63 65 20 74 6f 20 74 68 65 reference to the
a220: 20 70 61 67 65 72 20 69 66 0a 20 20 20 20 20 20 pager if.
a230: 2a 2a 20 69 6e 20 45 52 52 4f 52 20 73 74 61 74 ** in ERROR stat
a240: 65 2e 20 4f 74 68 65 72 77 69 73 65 20 74 68 65 e. Otherwise the
a250: 20 70 61 67 65 72 20 73 68 6f 75 6c 64 20 68 61 pager should ha
a260: 76 65 20 61 6c 72 65 61 64 79 20 64 72 6f 70 70 ve already dropp
a270: 65 64 0a 20 20 20 20 20 20 2a 2a 20 62 61 63 6b ed. ** back
a280: 20 74 6f 20 4f 50 45 4e 20 73 74 61 74 65 2e 0a to OPEN state..
a290: 20 20 20 20 20 20 2a 2f 0a 20 20 20 20 20 20 61 */. a
a2a0: 73 73 65 72 74 28 20 70 50 61 67 65 72 2d 3e 65 ssert( pPager->e
a2b0: 72 72 43 6f 64 65 21 3d 53 51 4c 49 54 45 5f 4f rrCode!=SQLITE_O
a2c0: 4b 20 29 3b 0a 20 20 20 20 20 20 61 73 73 65 72 K );. asser
a2d0: 74 28 20 73 71 6c 69 74 65 33 50 63 61 63 68 65 t( sqlite3Pcache
a2e0: 52 65 66 43 6f 75 6e 74 28 70 50 61 67 65 72 2d RefCount(pPager-
a2f0: 3e 70 50 43 61 63 68 65 29 3e 30 20 29 3b 0a 20 >pPCache)>0 );.
a300: 20 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 7d 0a break;. }.
a310: 0a 20 20 72 65 74 75 72 6e 20 31 3b 0a 7d 0a 23 . return 1;.}.#
a320: 65 6e 64 69 66 20 2f 2a 20 69 66 6e 64 65 66 20 endif /* ifndef
a330: 4e 44 45 42 55 47 20 2a 2f 0a 0a 23 69 66 64 65 NDEBUG */..#ifde
a340: 66 20 53 51 4c 49 54 45 5f 44 45 42 55 47 20 0a f SQLITE_DEBUG .
a350: 2f 2a 0a 2a 2a 20 52 65 74 75 72 6e 20 61 20 70 /*.** Return a p
a360: 6f 69 6e 74 65 72 20 74 6f 20 61 20 68 75 6d 61 ointer to a huma
a370: 6e 20 72 65 61 64 61 62 6c 65 20 73 74 72 69 6e n readable strin
a380: 67 20 69 6e 20 61 20 73 74 61 74 69 63 20 62 75 g in a static bu
a390: 66 66 65 72 0a 2a 2a 20 63 6f 6e 74 61 69 6e 69 ffer.** containi
a3a0: 6e 67 20 74 68 65 20 73 74 61 74 65 20 6f 66 20 ng the state of
a3b0: 74 68 65 20 50 61 67 65 72 20 6f 62 6a 65 63 74 the Pager object
a3c0: 20 70 61 73 73 65 64 20 61 73 20 61 6e 20 61 72 passed as an ar
a3d0: 67 75 6d 65 6e 74 2e 20 54 68 69 73 0a 2a 2a 20 gument. This.**
a3e0: 69 73 20 69 6e 74 65 6e 64 65 64 20 74 6f 20 62 is intended to b
a3f0: 65 20 75 73 65 64 20 77 69 74 68 69 6e 20 64 65 e used within de
a400: 62 75 67 67 65 72 73 2e 20 46 6f 72 20 65 78 61 buggers. For exa
a410: 6d 70 6c 65 2c 20 61 73 20 61 6e 20 61 6c 74 65 mple, as an alte
a420: 72 6e 61 74 69 76 65 0a 2a 2a 20 74 6f 20 22 70 rnative.** to "p
a430: 72 69 6e 74 20 2a 70 50 61 67 65 72 22 20 69 6e rint *pPager" in
a440: 20 67 64 62 3a 0a 2a 2a 0a 2a 2a 20 28 67 64 62 gdb:.**.** (gdb
a450: 29 20 70 72 69 6e 74 66 20 22 25 73 22 2c 20 70 ) printf "%s", p
a460: 72 69 6e 74 5f 70 61 67 65 72 5f 73 74 61 74 65 rint_pager_state
a470: 28 70 50 61 67 65 72 29 0a 2a 2f 0a 73 74 61 74 (pPager).*/.stat
a480: 69 63 20 63 68 61 72 20 2a 70 72 69 6e 74 5f 70 ic char *print_p
a490: 61 67 65 72 5f 73 74 61 74 65 28 50 61 67 65 72 ager_state(Pager
a4a0: 20 2a 70 29 7b 0a 20 20 73 74 61 74 69 63 20 63 *p){. static c
a4b0: 68 61 72 20 7a 52 65 74 5b 31 30 32 34 5d 3b 0a har zRet[1024];.
a4c0: 0a 20 20 73 71 6c 69 74 65 33 5f 73 6e 70 72 69 . sqlite3_snpri
a4d0: 6e 74 66 28 31 30 32 34 2c 20 7a 52 65 74 2c 0a ntf(1024, zRet,.
a4e0: 20 20 20 20 20 20 22 46 69 6c 65 6e 61 6d 65 3a "Filename:
a4f0: 20 20 20 20 20 20 25 73 5c 6e 22 0a 20 20 20 20 %s\n".
a500: 20 20 22 53 74 61 74 65 3a 20 20 20 20 20 20 20 "State:
a510: 20 20 25 73 20 65 72 72 43 6f 64 65 3d 25 64 5c %s errCode=%d\
a520: 6e 22 0a 20 20 20 20 20 20 22 4c 6f 63 6b 3a 20 n". "Lock:
a530: 20 20 20 20 20 20 20 20 20 25 73 5c 6e 22 0a 20 %s\n".
a540: 20 20 20 20 20 22 4c 6f 63 6b 69 6e 67 20 6d 6f "Locking mo
a550: 64 65 3a 20 20 6c 6f 63 6b 69 6e 67 5f 6d 6f 64 de: locking_mod
a560: 65 3d 25 73 5c 6e 22 0a 20 20 20 20 20 20 22 4a e=%s\n". "J
a570: 6f 75 72 6e 61 6c 20 6d 6f 64 65 3a 20 20 6a 6f ournal mode: jo
a580: 75 72 6e 61 6c 5f 6d 6f 64 65 3d 25 73 5c 6e 22 urnal_mode=%s\n"
a590: 0a 20 20 20 20 20 20 22 42 61 63 6b 69 6e 67 20 . "Backing
a5a0: 73 74 6f 72 65 3a 20 74 65 6d 70 46 69 6c 65 3d store: tempFile=
a5b0: 25 64 20 6d 65 6d 44 62 3d 25 64 20 75 73 65 4a %d memDb=%d useJ
a5c0: 6f 75 72 6e 61 6c 3d 25 64 5c 6e 22 0a 20 20 20 ournal=%d\n".
a5d0: 20 20 20 22 4a 6f 75 72 6e 61 6c 3a 20 20 20 20 "Journal:
a5e0: 20 20 20 6a 6f 75 72 6e 61 6c 4f 66 66 3d 25 6c journalOff=%l
a5f0: 6c 64 20 6a 6f 75 72 6e 61 6c 48 64 72 3d 25 6c ld journalHdr=%l
a600: 6c 64 5c 6e 22 0a 20 20 20 20 20 20 22 53 69 7a ld\n". "Siz
a610: 65 3a 20 20 20 20 20 20 20 20 20 20 64 62 73 69 e: dbsi
a620: 7a 65 3d 25 64 20 64 62 4f 72 69 67 53 69 7a 65 ze=%d dbOrigSize
a630: 3d 25 64 20 64 62 46 69 6c 65 53 69 7a 65 3d 25 =%d dbFileSize=%
a640: 64 5c 6e 22 0a 20 20 20 20 20 20 2c 20 70 2d 3e d\n". , p->
a650: 7a 46 69 6c 65 6e 61 6d 65 0a 20 20 20 20 20 20 zFilename.
a660: 2c 20 70 2d 3e 65 53 74 61 74 65 3d 3d 50 41 47 , p->eState==PAG
a670: 45 52 5f 4f 50 45 4e 20 20 20 20 20 20 20 20 20 ER_OPEN
a680: 20 20 20 3f 20 22 4f 50 45 4e 22 20 3a 0a 20 20 ? "OPEN" :.
a690: 20 20 20 20 20 20 70 2d 3e 65 53 74 61 74 65 3d p->eState=
a6a0: 3d 50 41 47 45 52 5f 52 45 41 44 45 52 20 20 20 =PAGER_READER
a6b0: 20 20 20 20 20 20 20 3f 20 22 52 45 41 44 45 52 ? "READER
a6c0: 22 20 3a 0a 20 20 20 20 20 20 20 20 70 2d 3e 65 " :. p->e
a6d0: 53 74 61 74 65 3d 3d 50 41 47 45 52 5f 57 52 49 State==PAGER_WRI
a6e0: 54 45 52 5f 4c 4f 43 4b 45 44 20 20 20 3f 20 22 TER_LOCKED ? "
a6f0: 57 52 49 54 45 52 5f 4c 4f 43 4b 45 44 22 20 3a WRITER_LOCKED" :
a700: 0a 20 20 20 20 20 20 20 20 70 2d 3e 65 53 74 61 . p->eSta
a710: 74 65 3d 3d 50 41 47 45 52 5f 57 52 49 54 45 52 te==PAGER_WRITER
a720: 5f 43 41 43 48 45 4d 4f 44 20 3f 20 22 57 52 49 _CACHEMOD ? "WRI
a730: 54 45 52 5f 43 41 43 48 45 4d 4f 44 22 20 3a 0a TER_CACHEMOD" :.
a740: 20 20 20 20 20 20 20 20 70 2d 3e 65 53 74 61 74 p->eStat
a750: 65 3d 3d 50 41 47 45 52 5f 57 52 49 54 45 52 5f e==PAGER_WRITER_
a760: 44 42 4d 4f 44 20 20 20 20 3f 20 22 57 52 49 54 DBMOD ? "WRIT
a770: 45 52 5f 44 42 4d 4f 44 22 20 3a 0a 20 20 20 20 ER_DBMOD" :.
a780: 20 20 20 20 70 2d 3e 65 53 74 61 74 65 3d 3d 50 p->eState==P
a790: 41 47 45 52 5f 57 52 49 54 45 52 5f 46 49 4e 49 AGER_WRITER_FINI
a7a0: 53 48 45 44 20 3f 20 22 57 52 49 54 45 52 5f 46 SHED ? "WRITER_F
a7b0: 49 4e 49 53 48 45 44 22 20 3a 0a 20 20 20 20 20 INISHED" :.
a7c0: 20 20 20 70 2d 3e 65 53 74 61 74 65 3d 3d 50 41 p->eState==PA
a7d0: 47 45 52 5f 45 52 52 4f 52 20 20 20 20 20 20 20 GER_ERROR
a7e0: 20 20 20 20 3f 20 22 45 52 52 4f 52 22 20 3a 20 ? "ERROR" :
a7f0: 22 3f 65 72 72 6f 72 3f 22 0a 20 20 20 20 20 20 "?error?".
a800: 2c 20 28 69 6e 74 29 70 2d 3e 65 72 72 43 6f 64 , (int)p->errCod
a810: 65 0a 20 20 20 20 20 20 2c 20 70 2d 3e 65 4c 6f e. , p->eLo
a820: 63 6b 3d 3d 4e 4f 5f 4c 4f 43 4b 20 20 20 20 20 ck==NO_LOCK
a830: 20 20 20 20 3f 20 22 4e 4f 5f 4c 4f 43 4b 22 20 ? "NO_LOCK"
a840: 3a 0a 20 20 20 20 20 20 20 20 70 2d 3e 65 4c 6f :. p->eLo
a850: 63 6b 3d 3d 52 45 53 45 52 56 45 44 5f 4c 4f 43 ck==RESERVED_LOC
a860: 4b 20 20 20 3f 20 22 52 45 53 45 52 56 45 44 22 K ? "RESERVED"
a870: 20 3a 0a 20 20 20 20 20 20 20 20 70 2d 3e 65 4c :. p->eL
a880: 6f 63 6b 3d 3d 45 58 43 4c 55 53 49 56 45 5f 4c ock==EXCLUSIVE_L
a890: 4f 43 4b 20 20 3f 20 22 45 58 43 4c 55 53 49 56 OCK ? "EXCLUSIV
a8a0: 45 22 20 3a 0a 20 20 20 20 20 20 20 20 70 2d 3e E" :. p->
a8b0: 65 4c 6f 63 6b 3d 3d 53 48 41 52 45 44 5f 4c 4f eLock==SHARED_LO
a8c0: 43 4b 20 20 20 20 20 3f 20 22 53 48 41 52 45 44 CK ? "SHARED
a8d0: 22 20 3a 0a 20 20 20 20 20 20 20 20 70 2d 3e 65 " :. p->e
a8e0: 4c 6f 63 6b 3d 3d 55 4e 4b 4e 4f 57 4e 5f 4c 4f Lock==UNKNOWN_LO
a8f0: 43 4b 20 20 20 20 3f 20 22 55 4e 4b 4e 4f 57 4e CK ? "UNKNOWN
a900: 22 20 3a 20 22 3f 65 72 72 6f 72 3f 22 0a 20 20 " : "?error?".
a910: 20 20 20 20 2c 20 70 2d 3e 65 78 63 6c 75 73 69 , p->exclusi
a920: 76 65 4d 6f 64 65 20 3f 20 22 65 78 63 6c 75 73 veMode ? "exclus
a930: 69 76 65 22 20 3a 20 22 6e 6f 72 6d 61 6c 22 0a ive" : "normal".
a940: 20 20 20 20 20 20 2c 20 70 2d 3e 6a 6f 75 72 6e , p->journ
a950: 61 6c 4d 6f 64 65 3d 3d 50 41 47 45 52 5f 4a 4f alMode==PAGER_JO
a960: 55 52 4e 41 4c 4d 4f 44 45 5f 4d 45 4d 4f 52 59 URNALMODE_MEMORY
a970: 20 20 20 3f 20 22 6d 65 6d 6f 72 79 22 20 3a 0a ? "memory" :.
a980: 20 20 20 20 20 20 20 20 70 2d 3e 6a 6f 75 72 6e p->journ
a990: 61 6c 4d 6f 64 65 3d 3d 50 41 47 45 52 5f 4a 4f alMode==PAGER_JO
a9a0: 55 52 4e 41 4c 4d 4f 44 45 5f 4f 46 46 20 20 20 URNALMODE_OFF
a9b0: 20 20 20 3f 20 22 6f 66 66 22 20 3a 0a 20 20 20 ? "off" :.
a9c0: 20 20 20 20 20 70 2d 3e 6a 6f 75 72 6e 61 6c 4d p->journalM
a9d0: 6f 64 65 3d 3d 50 41 47 45 52 5f 4a 4f 55 52 4e ode==PAGER_JOURN
a9e0: 41 4c 4d 4f 44 45 5f 44 45 4c 45 54 45 20 20 20 ALMODE_DELETE
a9f0: 3f 20 22 64 65 6c 65 74 65 22 20 3a 0a 20 20 20 ? "delete" :.
aa00: 20 20 20 20 20 70 2d 3e 6a 6f 75 72 6e 61 6c 4d p->journalM
aa10: 6f 64 65 3d 3d 50 41 47 45 52 5f 4a 4f 55 52 4e ode==PAGER_JOURN
aa20: 41 4c 4d 4f 44 45 5f 50 45 52 53 49 53 54 20 20 ALMODE_PERSIST
aa30: 3f 20 22 70 65 72 73 69 73 74 22 20 3a 0a 20 20 ? "persist" :.
aa40: 20 20 20 20 20 20 70 2d 3e 6a 6f 75 72 6e 61 6c p->journal
aa50: 4d 6f 64 65 3d 3d 50 41 47 45 52 5f 4a 4f 55 52 Mode==PAGER_JOUR
aa60: 4e 41 4c 4d 4f 44 45 5f 54 52 55 4e 43 41 54 45 NALMODE_TRUNCATE
aa70: 20 3f 20 22 74 72 75 6e 63 61 74 65 22 20 3a 0a ? "truncate" :.
aa80: 20 20 20 20 20 20 20 20 70 2d 3e 6a 6f 75 72 6e p->journ
aa90: 61 6c 4d 6f 64 65 3d 3d 50 41 47 45 52 5f 4a 4f alMode==PAGER_JO
aaa0: 55 52 4e 41 4c 4d 4f 44 45 5f 57 41 4c 20 20 20 URNALMODE_WAL
aab0: 20 20 20 3f 20 22 77 61 6c 22 20 3a 20 22 3f 65 ? "wal" : "?e
aac0: 72 72 6f 72 3f 22 0a 20 20 20 20 20 20 2c 20 28 rror?". , (
aad0: 69 6e 74 29 70 2d 3e 74 65 6d 70 46 69 6c 65 2c int)p->tempFile,
aae0: 20 28 69 6e 74 29 70 2d 3e 6d 65 6d 44 62 2c 20 (int)p->memDb,
aaf0: 28 69 6e 74 29 70 2d 3e 75 73 65 4a 6f 75 72 6e (int)p->useJourn
ab00: 61 6c 0a 20 20 20 20 20 20 2c 20 70 2d 3e 6a 6f al. , p->jo
ab10: 75 72 6e 61 6c 4f 66 66 2c 20 70 2d 3e 6a 6f 75 urnalOff, p->jou
ab20: 72 6e 61 6c 48 64 72 0a 20 20 20 20 20 20 2c 20 rnalHdr. ,
ab30: 28 69 6e 74 29 70 2d 3e 64 62 53 69 7a 65 2c 20 (int)p->dbSize,
ab40: 28 69 6e 74 29 70 2d 3e 64 62 4f 72 69 67 53 69 (int)p->dbOrigSi
ab50: 7a 65 2c 20 28 69 6e 74 29 70 2d 3e 64 62 46 69 ze, (int)p->dbFi
ab60: 6c 65 53 69 7a 65 0a 20 20 29 3b 0a 0a 20 20 72 leSize. );.. r
ab70: 65 74 75 72 6e 20 7a 52 65 74 3b 0a 7d 0a 23 65 eturn zRet;.}.#e
ab80: 6e 64 69 66 0a 0a 2f 2a 0a 2a 2a 20 52 65 74 75 ndif../*.** Retu
ab90: 72 6e 20 74 72 75 65 20 69 66 20 69 74 20 69 73 rn true if it is
aba0: 20 6e 65 63 65 73 73 61 72 79 20 74 6f 20 77 72 necessary to wr
abb0: 69 74 65 20 70 61 67 65 20 2a 70 50 67 20 69 6e ite page *pPg in
abc0: 74 6f 20 74 68 65 20 73 75 62 2d 6a 6f 75 72 6e to the sub-journ
abd0: 61 6c 2e 0a 2a 2a 20 41 20 70 61 67 65 20 6e 65 al..** A page ne
abe0: 65 64 73 20 74 6f 20 62 65 20 77 72 69 74 74 65 eds to be writte
abf0: 6e 20 69 6e 74 6f 20 74 68 65 20 73 75 62 2d 6a n into the sub-j
ac00: 6f 75 72 6e 61 6c 20 69 66 20 74 68 65 72 65 20 ournal if there
ac10: 65 78 69 73 74 73 20 6f 6e 65 0a 2a 2a 20 6f 72 exists one.** or
ac20: 20 6d 6f 72 65 20 6f 70 65 6e 20 73 61 76 65 70 more open savep
ac30: 6f 69 6e 74 73 20 66 6f 72 20 77 68 69 63 68 3a oints for which:
ac40: 0a 2a 2a 0a 2a 2a 20 20 20 2a 20 54 68 65 20 70 .**.** * The p
ac50: 61 67 65 2d 6e 75 6d 62 65 72 20 69 73 20 6c 65 age-number is le
ac60: 73 73 20 74 68 61 6e 20 6f 72 20 65 71 75 61 6c ss than or equal
ac70: 20 74 6f 20 50 61 67 65 72 53 61 76 65 70 6f 69 to PagerSavepoi
ac80: 6e 74 2e 6e 4f 72 69 67 2c 20 61 6e 64 0a 2a 2a nt.nOrig, and.**
ac90: 20 20 20 2a 20 54 68 65 20 62 69 74 20 63 6f 72 * The bit cor
aca0: 72 65 73 70 6f 6e 64 69 6e 67 20 74 6f 20 74 68 responding to th
acb0: 65 20 70 61 67 65 2d 6e 75 6d 62 65 72 20 69 73 e page-number is
acc0: 20 6e 6f 74 20 73 65 74 20 69 6e 0a 2a 2a 20 20 not set in.**
acd0: 20 20 20 50 61 67 65 72 53 61 76 65 70 6f 69 6e PagerSavepoin
ace0: 74 2e 70 49 6e 53 61 76 65 70 6f 69 6e 74 2e 0a t.pInSavepoint..
acf0: 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74 20 73 75 */.static int su
ad00: 62 6a 52 65 71 75 69 72 65 73 50 61 67 65 28 50 bjRequiresPage(P
ad10: 67 48 64 72 20 2a 70 50 67 29 7b 0a 20 20 50 67 gHdr *pPg){. Pg
ad20: 6e 6f 20 70 67 6e 6f 20 3d 20 70 50 67 2d 3e 70 no pgno = pPg->p
ad30: 67 6e 6f 3b 0a 20 20 50 61 67 65 72 20 2a 70 50 gno;. Pager *pP
ad40: 61 67 65 72 20 3d 20 70 50 67 2d 3e 70 50 61 67 ager = pPg->pPag
ad50: 65 72 3b 0a 20 20 69 6e 74 20 69 3b 0a 20 20 66 er;. int i;. f
ad60: 6f 72 28 69 3d 30 3b 20 69 3c 70 50 61 67 65 72 or(i=0; i<pPager
ad70: 2d 3e 6e 53 61 76 65 70 6f 69 6e 74 3b 20 69 2b ->nSavepoint; i+
ad80: 2b 29 7b 0a 20 20 20 20 50 61 67 65 72 53 61 76 +){. PagerSav
ad90: 65 70 6f 69 6e 74 20 2a 70 20 3d 20 26 70 50 61 epoint *p = &pPa
ada0: 67 65 72 2d 3e 61 53 61 76 65 70 6f 69 6e 74 5b ger->aSavepoint[
adb0: 69 5d 3b 0a 20 20 20 20 69 66 28 20 70 2d 3e 6e i];. if( p->n
adc0: 4f 72 69 67 3e 3d 70 67 6e 6f 20 26 26 20 30 3d Orig>=pgno && 0=
add0: 3d 73 71 6c 69 74 65 33 42 69 74 76 65 63 54 65 =sqlite3BitvecTe
ade0: 73 74 28 70 2d 3e 70 49 6e 53 61 76 65 70 6f 69 st(p->pInSavepoi
adf0: 6e 74 2c 20 70 67 6e 6f 29 20 29 7b 0a 20 20 20 nt, pgno) ){.
ae00: 20 20 20 72 65 74 75 72 6e 20 31 3b 0a 20 20 20 return 1;.
ae10: 20 7d 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e 20 }. }. return
ae20: 30 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 52 65 74 75 0;.}../*.** Retu
ae30: 72 6e 20 74 72 75 65 20 69 66 20 74 68 65 20 70 rn true if the p
ae40: 61 67 65 20 69 73 20 61 6c 72 65 61 64 79 20 69 age is already i
ae50: 6e 20 74 68 65 20 6a 6f 75 72 6e 61 6c 20 66 69 n the journal fi
ae60: 6c 65 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e le..*/.static in
ae70: 74 20 70 61 67 65 49 6e 4a 6f 75 72 6e 61 6c 28 t pageInJournal(
ae80: 50 67 48 64 72 20 2a 70 50 67 29 7b 0a 20 20 72 PgHdr *pPg){. r
ae90: 65 74 75 72 6e 20 73 71 6c 69 74 65 33 42 69 74 eturn sqlite3Bit
aea0: 76 65 63 54 65 73 74 28 70 50 67 2d 3e 70 50 61 vecTest(pPg->pPa
aeb0: 67 65 72 2d 3e 70 49 6e 4a 6f 75 72 6e 61 6c 2c ger->pInJournal,
aec0: 20 70 50 67 2d 3e 70 67 6e 6f 29 3b 0a 7d 0a 0a pPg->pgno);.}..
aed0: 2f 2a 0a 2a 2a 20 52 65 61 64 20 61 20 33 32 2d /*.** Read a 32-
aee0: 62 69 74 20 69 6e 74 65 67 65 72 20 66 72 6f 6d bit integer from
aef0: 20 74 68 65 20 67 69 76 65 6e 20 66 69 6c 65 20 the given file
af00: 64 65 73 63 72 69 70 74 6f 72 2e 20 20 53 74 6f descriptor. Sto
af10: 72 65 20 74 68 65 20 69 6e 74 65 67 65 72 0a 2a re the integer.*
af20: 2a 20 74 68 61 74 20 69 73 20 72 65 61 64 20 69 * that is read i
af30: 6e 20 2a 70 52 65 73 2e 20 20 52 65 74 75 72 6e n *pRes. Return
af40: 20 53 51 4c 49 54 45 5f 4f 4b 20 69 66 20 65 76 SQLITE_OK if ev
af50: 65 72 79 74 68 69 6e 67 20 77 6f 72 6b 65 64 2c erything worked,
af60: 20 6f 72 20 61 6e 0a 2a 2a 20 65 72 72 6f 72 20 or an.** error
af70: 63 6f 64 65 20 69 73 20 73 6f 6d 65 74 68 69 6e code is somethin
af80: 67 20 67 6f 65 73 20 77 72 6f 6e 67 2e 0a 2a 2a g goes wrong..**
af90: 0a 2a 2a 20 41 6c 6c 20 76 61 6c 75 65 73 20 61 .** All values a
afa0: 72 65 20 73 74 6f 72 65 64 20 6f 6e 20 64 69 73 re stored on dis
afb0: 6b 20 61 73 20 62 69 67 2d 65 6e 64 69 61 6e 2e k as big-endian.
afc0: 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74 20 72 .*/.static int r
afd0: 65 61 64 33 32 62 69 74 73 28 73 71 6c 69 74 65 ead32bits(sqlite
afe0: 33 5f 66 69 6c 65 20 2a 66 64 2c 20 69 36 34 20 3_file *fd, i64
aff0: 6f 66 66 73 65 74 2c 20 75 33 32 20 2a 70 52 65 offset, u32 *pRe
b000: 73 29 7b 0a 20 20 75 6e 73 69 67 6e 65 64 20 63 s){. unsigned c
b010: 68 61 72 20 61 63 5b 34 5d 3b 0a 20 20 69 6e 74 har ac[4];. int
b020: 20 72 63 20 3d 20 73 71 6c 69 74 65 33 4f 73 52 rc = sqlite3OsR
b030: 65 61 64 28 66 64 2c 20 61 63 2c 20 73 69 7a 65 ead(fd, ac, size
b040: 6f 66 28 61 63 29 2c 20 6f 66 66 73 65 74 29 3b of(ac), offset);
b050: 0a 20 20 69 66 28 20 72 63 3d 3d 53 51 4c 49 54 . if( rc==SQLIT
b060: 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 2a 70 52 65 E_OK ){. *pRe
b070: 73 20 3d 20 73 71 6c 69 74 65 33 47 65 74 34 62 s = sqlite3Get4b
b080: 79 74 65 28 61 63 29 3b 0a 20 20 7d 0a 20 20 72 yte(ac);. }. r
b090: 65 74 75 72 6e 20 72 63 3b 0a 7d 0a 0a 2f 2a 0a eturn rc;.}../*.
b0a0: 2a 2a 20 57 72 69 74 65 20 61 20 33 32 2d 62 69 ** Write a 32-bi
b0b0: 74 20 69 6e 74 65 67 65 72 20 69 6e 74 6f 20 61 t integer into a
b0c0: 20 73 74 72 69 6e 67 20 62 75 66 66 65 72 20 69 string buffer i
b0d0: 6e 20 62 69 67 2d 65 6e 64 69 61 6e 20 62 79 74 n big-endian byt
b0e0: 65 20 6f 72 64 65 72 2e 0a 2a 2f 0a 23 64 65 66 e order..*/.#def
b0f0: 69 6e 65 20 70 75 74 33 32 62 69 74 73 28 41 2c ine put32bits(A,
b100: 42 29 20 20 73 71 6c 69 74 65 33 50 75 74 34 62 B) sqlite3Put4b
b110: 79 74 65 28 28 75 38 2a 29 41 2c 42 29 0a 0a 0a yte((u8*)A,B)...
b120: 2f 2a 0a 2a 2a 20 57 72 69 74 65 20 61 20 33 32 /*.** Write a 32
b130: 2d 62 69 74 20 69 6e 74 65 67 65 72 20 69 6e 74 -bit integer int
b140: 6f 20 74 68 65 20 67 69 76 65 6e 20 66 69 6c 65 o the given file
b150: 20 64 65 73 63 72 69 70 74 6f 72 2e 20 20 52 65 descriptor. Re
b160: 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 0a 2a turn SQLITE_OK.*
b170: 2a 20 6f 6e 20 73 75 63 63 65 73 73 20 6f 72 20 * on success or
b180: 61 6e 20 65 72 72 6f 72 20 63 6f 64 65 20 69 73 an error code is
b190: 20 73 6f 6d 65 74 68 69 6e 67 20 67 6f 65 73 20 something goes
b1a0: 77 72 6f 6e 67 2e 0a 2a 2f 0a 73 74 61 74 69 63 wrong..*/.static
b1b0: 20 69 6e 74 20 77 72 69 74 65 33 32 62 69 74 73 int write32bits
b1c0: 28 73 71 6c 69 74 65 33 5f 66 69 6c 65 20 2a 66 (sqlite3_file *f
b1d0: 64 2c 20 69 36 34 20 6f 66 66 73 65 74 2c 20 75 d, i64 offset, u
b1e0: 33 32 20 76 61 6c 29 7b 0a 20 20 63 68 61 72 20 32 val){. char
b1f0: 61 63 5b 34 5d 3b 0a 20 20 70 75 74 33 32 62 69 ac[4];. put32bi
b200: 74 73 28 61 63 2c 20 76 61 6c 29 3b 0a 20 20 72 ts(ac, val);. r
b210: 65 74 75 72 6e 20 73 71 6c 69 74 65 33 4f 73 57 eturn sqlite3OsW
b220: 72 69 74 65 28 66 64 2c 20 61 63 2c 20 34 2c 20 rite(fd, ac, 4,
b230: 6f 66 66 73 65 74 29 3b 0a 7d 0a 0a 2f 2a 0a 2a offset);.}../*.*
b240: 2a 20 55 6e 6c 6f 63 6b 20 74 68 65 20 64 61 74 * Unlock the dat
b250: 61 62 61 73 65 20 66 69 6c 65 20 74 6f 20 6c 65 abase file to le
b260: 76 65 6c 20 65 4c 6f 63 6b 2c 20 77 68 69 63 68 vel eLock, which
b270: 20 6d 75 73 74 20 62 65 20 65 69 74 68 65 72 20 must be either
b280: 4e 4f 5f 4c 4f 43 4b 0a 2a 2a 20 6f 72 20 53 48 NO_LOCK.** or SH
b290: 41 52 45 44 5f 4c 4f 43 4b 2e 20 52 65 67 61 72 ARED_LOCK. Regar
b2a0: 64 6c 65 73 73 20 6f 66 20 77 68 65 74 68 65 72 dless of whether
b2b0: 20 6f 72 20 6e 6f 74 20 74 68 65 20 63 61 6c 6c or not the call
b2c0: 20 74 6f 20 78 55 6e 6c 6f 63 6b 28 29 0a 2a 2a to xUnlock().**
b2d0: 20 73 75 63 63 65 65 64 73 2c 20 73 65 74 20 74 succeeds, set t
b2e0: 68 65 20 50 61 67 65 72 2e 65 4c 6f 63 6b 20 76 he Pager.eLock v
b2f0: 61 72 69 61 62 6c 65 20 74 6f 20 6d 61 74 63 68 ariable to match
b300: 20 74 68 65 20 28 61 74 74 65 6d 70 74 65 64 29 the (attempted)
b310: 20 6e 65 77 20 6c 6f 63 6b 2e 0a 2a 2a 0a 2a 2a new lock..**.**
b320: 20 45 78 63 65 70 74 2c 20 69 66 20 50 61 67 65 Except, if Page
b330: 72 2e 65 4c 6f 63 6b 20 69 73 20 73 65 74 20 74 r.eLock is set t
b340: 6f 20 55 4e 4b 4e 4f 57 4e 5f 4c 4f 43 4b 20 77 o UNKNOWN_LOCK w
b350: 68 65 6e 20 74 68 69 73 20 66 75 6e 63 74 69 6f hen this functio
b360: 6e 20 69 73 0a 2a 2a 20 63 61 6c 6c 65 64 2c 20 n is.** called,
b370: 64 6f 20 6e 6f 74 20 6d 6f 64 69 66 79 20 69 74 do not modify it
b380: 2e 20 53 65 65 20 74 68 65 20 63 6f 6d 6d 65 6e . See the commen
b390: 74 20 61 62 6f 76 65 20 74 68 65 20 23 64 65 66 t above the #def
b3a0: 69 6e 65 20 6f 66 20 0a 2a 2a 20 55 4e 4b 4e 4f ine of .** UNKNO
b3b0: 57 4e 5f 4c 4f 43 4b 20 66 6f 72 20 61 6e 20 65 WN_LOCK for an e
b3c0: 78 70 6c 61 6e 61 74 69 6f 6e 20 6f 66 20 74 68 xplanation of th
b3d0: 69 73 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e is..*/.static in
b3e0: 74 20 70 61 67 65 72 55 6e 6c 6f 63 6b 44 62 28 t pagerUnlockDb(
b3f0: 50 61 67 65 72 20 2a 70 50 61 67 65 72 2c 20 69 Pager *pPager, i
b400: 6e 74 20 65 4c 6f 63 6b 29 7b 0a 20 20 69 6e 74 nt eLock){. int
b410: 20 72 63 20 3d 20 53 51 4c 49 54 45 5f 4f 4b 3b rc = SQLITE_OK;
b420: 0a 0a 20 20 61 73 73 65 72 74 28 20 21 70 50 61 .. assert( !pPa
b430: 67 65 72 2d 3e 65 78 63 6c 75 73 69 76 65 4d 6f ger->exclusiveMo
b440: 64 65 20 7c 7c 20 70 50 61 67 65 72 2d 3e 65 4c de || pPager->eL
b450: 6f 63 6b 3d 3d 65 4c 6f 63 6b 20 29 3b 0a 20 20 ock==eLock );.
b460: 61 73 73 65 72 74 28 20 65 4c 6f 63 6b 3d 3d 4e assert( eLock==N
b470: 4f 5f 4c 4f 43 4b 20 7c 7c 20 65 4c 6f 63 6b 3d O_LOCK || eLock=
b480: 3d 53 48 41 52 45 44 5f 4c 4f 43 4b 20 29 3b 0a =SHARED_LOCK );.
b490: 20 20 61 73 73 65 72 74 28 20 65 4c 6f 63 6b 21 assert( eLock!
b4a0: 3d 4e 4f 5f 4c 4f 43 4b 20 7c 7c 20 70 61 67 65 =NO_LOCK || page
b4b0: 72 55 73 65 57 61 6c 28 70 50 61 67 65 72 29 3d rUseWal(pPager)=
b4c0: 3d 30 20 29 3b 0a 20 20 69 66 28 20 69 73 4f 70 =0 );. if( isOp
b4d0: 65 6e 28 70 50 61 67 65 72 2d 3e 66 64 29 20 29 en(pPager->fd) )
b4e0: 7b 0a 20 20 20 20 61 73 73 65 72 74 28 20 70 50 {. assert( pP
b4f0: 61 67 65 72 2d 3e 65 4c 6f 63 6b 3e 3d 65 4c 6f ager->eLock>=eLo
b500: 63 6b 20 29 3b 0a 20 20 20 20 72 63 20 3d 20 73 ck );. rc = s
b510: 71 6c 69 74 65 33 4f 73 55 6e 6c 6f 63 6b 28 70 qlite3OsUnlock(p
b520: 50 61 67 65 72 2d 3e 66 64 2c 20 65 4c 6f 63 6b Pager->fd, eLock
b530: 29 3b 0a 20 20 20 20 69 66 28 20 70 50 61 67 65 );. if( pPage
b540: 72 2d 3e 65 4c 6f 63 6b 21 3d 55 4e 4b 4e 4f 57 r->eLock!=UNKNOW
b550: 4e 5f 4c 4f 43 4b 20 29 7b 0a 20 20 20 20 20 20 N_LOCK ){.
b560: 70 50 61 67 65 72 2d 3e 65 4c 6f 63 6b 20 3d 20 pPager->eLock =
b570: 28 75 38 29 65 4c 6f 63 6b 3b 0a 20 20 20 20 7d (u8)eLock;. }
b580: 0a 20 20 20 20 49 4f 54 52 41 43 45 28 28 22 55 . IOTRACE(("U
b590: 4e 4c 4f 43 4b 20 25 70 20 25 64 5c 6e 22 2c 20 NLOCK %p %d\n",
b5a0: 70 50 61 67 65 72 2c 20 65 4c 6f 63 6b 29 29 0a pPager, eLock)).
b5b0: 20 20 7d 0a 20 20 72 65 74 75 72 6e 20 72 63 3b }. return rc;
b5c0: 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 4c 6f 63 6b 20 74 .}../*.** Lock t
b5d0: 68 65 20 64 61 74 61 62 61 73 65 20 66 69 6c 65 he database file
b5e0: 20 74 6f 20 6c 65 76 65 6c 20 65 4c 6f 63 6b 2c to level eLock,
b5f0: 20 77 68 69 63 68 20 6d 75 73 74 20 62 65 20 65 which must be e
b600: 69 74 68 65 72 20 53 48 41 52 45 44 5f 4c 4f 43 ither SHARED_LOC
b610: 4b 2c 0a 2a 2a 20 52 45 53 45 52 56 45 44 5f 4c K,.** RESERVED_L
b620: 4f 43 4b 20 6f 72 20 45 58 43 4c 55 53 49 56 45 OCK or EXCLUSIVE
b630: 5f 4c 4f 43 4b 2e 20 49 66 20 74 68 65 20 63 61 _LOCK. If the ca
b640: 6c 6c 65 72 20 69 73 20 73 75 63 63 65 73 73 66 ller is successf
b650: 75 6c 2c 20 73 65 74 20 74 68 65 0a 2a 2a 20 50 ul, set the.** P
b660: 61 67 65 72 2e 65 4c 6f 63 6b 20 76 61 72 69 61 ager.eLock varia
b670: 62 6c 65 20 74 6f 20 74 68 65 20 6e 65 77 20 6c ble to the new l
b680: 6f 63 6b 69 6e 67 20 73 74 61 74 65 2e 20 0a 2a ocking state. .*
b690: 2a 0a 2a 2a 20 45 78 63 65 70 74 2c 20 69 66 20 *.** Except, if
b6a0: 50 61 67 65 72 2e 65 4c 6f 63 6b 20 69 73 20 73 Pager.eLock is s
b6b0: 65 74 20 74 6f 20 55 4e 4b 4e 4f 57 4e 5f 4c 4f et to UNKNOWN_LO
b6c0: 43 4b 20 77 68 65 6e 20 74 68 69 73 20 66 75 6e CK when this fun
b6d0: 63 74 69 6f 6e 20 69 73 20 0a 2a 2a 20 63 61 6c ction is .** cal
b6e0: 6c 65 64 2c 20 64 6f 20 6e 6f 74 20 6d 6f 64 69 led, do not modi
b6f0: 66 79 20 69 74 20 75 6e 6c 65 73 73 20 74 68 65 fy it unless the
b700: 20 6e 65 77 20 6c 6f 63 6b 69 6e 67 20 73 74 61 new locking sta
b710: 74 65 20 69 73 20 45 58 43 4c 55 53 49 56 45 5f te is EXCLUSIVE_
b720: 4c 4f 43 4b 2e 20 0a 2a 2a 20 53 65 65 20 74 68 LOCK. .** See th
b730: 65 20 63 6f 6d 6d 65 6e 74 20 61 62 6f 76 65 20 e comment above
b740: 74 68 65 20 23 64 65 66 69 6e 65 20 6f 66 20 55 the #define of U
b750: 4e 4b 4e 4f 57 4e 5f 4c 4f 43 4b 20 66 6f 72 20 NKNOWN_LOCK for
b760: 61 6e 20 65 78 70 6c 61 6e 61 74 69 6f 6e 20 0a an explanation .
b770: 2a 2a 20 6f 66 20 74 68 69 73 2e 0a 2a 2f 0a 73 ** of this..*/.s
b780: 74 61 74 69 63 20 69 6e 74 20 70 61 67 65 72 4c tatic int pagerL
b790: 6f 63 6b 44 62 28 50 61 67 65 72 20 2a 70 50 61 ockDb(Pager *pPa
b7a0: 67 65 72 2c 20 69 6e 74 20 65 4c 6f 63 6b 29 7b ger, int eLock){
b7b0: 0a 20 20 69 6e 74 20 72 63 20 3d 20 53 51 4c 49 . int rc = SQLI
b7c0: 54 45 5f 4f 4b 3b 0a 0a 20 20 61 73 73 65 72 74 TE_OK;.. assert
b7d0: 28 20 65 4c 6f 63 6b 3d 3d 53 48 41 52 45 44 5f ( eLock==SHARED_
b7e0: 4c 4f 43 4b 20 7c 7c 20 65 4c 6f 63 6b 3d 3d 52 LOCK || eLock==R
b7f0: 45 53 45 52 56 45 44 5f 4c 4f 43 4b 20 7c 7c 20 ESERVED_LOCK ||
b800: 65 4c 6f 63 6b 3d 3d 45 58 43 4c 55 53 49 56 45 eLock==EXCLUSIVE
b810: 5f 4c 4f 43 4b 20 29 3b 0a 20 20 69 66 28 20 70 _LOCK );. if( p
b820: 50 61 67 65 72 2d 3e 65 4c 6f 63 6b 3c 65 4c 6f Pager->eLock<eLo
b830: 63 6b 20 7c 7c 20 70 50 61 67 65 72 2d 3e 65 4c ck || pPager->eL
b840: 6f 63 6b 3d 3d 55 4e 4b 4e 4f 57 4e 5f 4c 4f 43 ock==UNKNOWN_LOC
b850: 4b 20 29 7b 0a 20 20 20 20 72 63 20 3d 20 73 71 K ){. rc = sq
b860: 6c 69 74 65 33 4f 73 4c 6f 63 6b 28 70 50 61 67 lite3OsLock(pPag
b870: 65 72 2d 3e 66 64 2c 20 65 4c 6f 63 6b 29 3b 0a er->fd, eLock);.
b880: 20 20 20 20 69 66 28 20 72 63 3d 3d 53 51 4c 49 if( rc==SQLI
b890: 54 45 5f 4f 4b 20 26 26 20 28 70 50 61 67 65 72 TE_OK && (pPager
b8a0: 2d 3e 65 4c 6f 63 6b 21 3d 55 4e 4b 4e 4f 57 4e ->eLock!=UNKNOWN
b8b0: 5f 4c 4f 43 4b 7c 7c 65 4c 6f 63 6b 3d 3d 45 58 _LOCK||eLock==EX
b8c0: 43 4c 55 53 49 56 45 5f 4c 4f 43 4b 29 20 29 7b CLUSIVE_LOCK) ){
b8d0: 0a 20 20 20 20 20 20 70 50 61 67 65 72 2d 3e 65 . pPager->e
b8e0: 4c 6f 63 6b 20 3d 20 28 75 38 29 65 4c 6f 63 6b Lock = (u8)eLock
b8f0: 3b 0a 20 20 20 20 20 20 49 4f 54 52 41 43 45 28 ;. IOTRACE(
b900: 28 22 4c 4f 43 4b 20 25 70 20 25 64 5c 6e 22 2c ("LOCK %p %d\n",
b910: 20 70 50 61 67 65 72 2c 20 65 4c 6f 63 6b 29 29 pPager, eLock))
b920: 0a 20 20 20 20 7d 0a 20 20 7d 0a 20 20 72 65 74 . }. }. ret
b930: 75 72 6e 20 72 63 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a urn rc;.}../*.**
b940: 20 54 68 69 73 20 66 75 6e 63 74 69 6f 6e 20 64 This function d
b950: 65 74 65 72 6d 69 6e 65 73 20 77 68 65 74 68 65 etermines whethe
b960: 72 20 6f 72 20 6e 6f 74 20 74 68 65 20 61 74 6f r or not the ato
b970: 6d 69 63 2d 77 72 69 74 65 20 6f 70 74 69 6d 69 mic-write optimi
b980: 7a 61 74 69 6f 6e 0a 2a 2a 20 63 61 6e 20 62 65 zation.** can be
b990: 20 75 73 65 64 20 77 69 74 68 20 74 68 69 73 20 used with this
b9a0: 70 61 67 65 72 2e 20 54 68 65 20 6f 70 74 69 6d pager. The optim
b9b0: 69 7a 61 74 69 6f 6e 20 63 61 6e 20 62 65 20 75 ization can be u
b9c0: 73 65 64 20 69 66 3a 0a 2a 2a 0a 2a 2a 20 20 28 sed if:.**.** (
b9d0: 61 29 20 74 68 65 20 76 61 6c 75 65 20 72 65 74 a) the value ret
b9e0: 75 72 6e 65 64 20 62 79 20 4f 73 44 65 76 69 63 urned by OsDevic
b9f0: 65 43 68 61 72 61 63 74 65 72 69 73 74 69 63 73 eCharacteristics
ba00: 28 29 20 69 6e 64 69 63 61 74 65 73 20 74 68 61 () indicates tha
ba10: 74 0a 2a 2a 20 20 20 20 20 20 61 20 64 61 74 61 t.** a data
ba20: 62 61 73 65 20 70 61 67 65 20 6d 61 79 20 62 65 base page may be
ba30: 20 77 72 69 74 74 65 6e 20 61 74 6f 6d 69 63 61 written atomica
ba40: 6c 6c 79 2c 20 61 6e 64 0a 2a 2a 20 20 28 62 29 lly, and.** (b)
ba50: 20 74 68 65 20 76 61 6c 75 65 20 72 65 74 75 72 the value retur
ba60: 6e 65 64 20 62 79 20 4f 73 53 65 63 74 6f 72 53 ned by OsSectorS
ba70: 69 7a 65 28 29 20 69 73 20 6c 65 73 73 20 74 68 ize() is less th
ba80: 61 6e 20 6f 72 20 65 71 75 61 6c 0a 2a 2a 20 20 an or equal.**
ba90: 20 20 20 20 74 6f 20 74 68 65 20 70 61 67 65 20 to the page
baa0: 73 69 7a 65 2e 0a 2a 2a 0a 2a 2a 20 54 68 65 20 size..**.** The
bab0: 6f 70 74 69 6d 69 7a 61 74 69 6f 6e 20 69 73 20 optimization is
bac0: 61 6c 73 6f 20 61 6c 77 61 79 73 20 65 6e 61 62 also always enab
bad0: 6c 65 64 20 66 6f 72 20 74 65 6d 70 6f 72 61 72 led for temporar
bae0: 79 20 66 69 6c 65 73 2e 20 49 74 20 69 73 0a 2a y files. It is.*
baf0: 2a 20 61 6e 20 65 72 72 6f 72 20 74 6f 20 63 61 * an error to ca
bb00: 6c 6c 20 74 68 69 73 20 66 75 6e 63 74 69 6f 6e ll this function
bb10: 20 69 66 20 70 50 61 67 65 72 20 69 73 20 6f 70 if pPager is op
bb20: 65 6e 65 64 20 6f 6e 20 61 6e 20 69 6e 2d 6d 65 ened on an in-me
bb30: 6d 6f 72 79 0a 2a 2a 20 64 61 74 61 62 61 73 65 mory.** database
bb40: 2e 0a 2a 2a 0a 2a 2a 20 49 66 20 74 68 65 20 6f ..**.** If the o
bb50: 70 74 69 6d 69 7a 61 74 69 6f 6e 20 63 61 6e 6e ptimization cann
bb60: 6f 74 20 62 65 20 75 73 65 64 2c 20 30 20 69 73 ot be used, 0 is
bb70: 20 72 65 74 75 72 6e 65 64 2e 20 49 66 20 69 74 returned. If it
bb80: 20 63 61 6e 20 62 65 20 75 73 65 64 2c 0a 2a 2a can be used,.**
bb90: 20 74 68 65 6e 20 74 68 65 20 76 61 6c 75 65 20 then the value
bba0: 72 65 74 75 72 6e 65 64 20 69 73 20 74 68 65 20 returned is the
bbb0: 73 69 7a 65 20 6f 66 20 74 68 65 20 6a 6f 75 72 size of the jour
bbc0: 6e 61 6c 20 66 69 6c 65 20 77 68 65 6e 20 69 74 nal file when it
bbd0: 0a 2a 2a 20 63 6f 6e 74 61 69 6e 73 20 72 6f 6c .** contains rol
bbe0: 6c 62 61 63 6b 20 64 61 74 61 20 66 6f 72 20 65 lback data for e
bbf0: 78 61 63 74 6c 79 20 6f 6e 65 20 70 61 67 65 2e xactly one page.
bc00: 0a 2a 2f 0a 23 69 66 64 65 66 20 53 51 4c 49 54 .*/.#ifdef SQLIT
bc10: 45 5f 45 4e 41 42 4c 45 5f 41 54 4f 4d 49 43 5f E_ENABLE_ATOMIC_
bc20: 57 52 49 54 45 0a 73 74 61 74 69 63 20 69 6e 74 WRITE.static int
bc30: 20 6a 72 6e 6c 42 75 66 66 65 72 53 69 7a 65 28 jrnlBufferSize(
bc40: 50 61 67 65 72 20 2a 70 50 61 67 65 72 29 7b 0a Pager *pPager){.
bc50: 20 20 61 73 73 65 72 74 28 20 21 4d 45 4d 44 42 assert( !MEMDB
bc60: 20 29 3b 0a 20 20 69 66 28 20 21 70 50 61 67 65 );. if( !pPage
bc70: 72 2d 3e 74 65 6d 70 46 69 6c 65 20 29 7b 0a 20 r->tempFile ){.
bc80: 20 20 20 69 6e 74 20 64 63 3b 20 20 20 20 20 20 int dc;
bc90: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
bca0: 20 20 20 20 20 2f 2a 20 44 65 76 69 63 65 20 63 /* Device c
bcb0: 68 61 72 61 63 74 65 72 69 73 74 69 63 73 20 2a haracteristics *
bcc0: 2f 0a 20 20 20 20 69 6e 74 20 6e 53 65 63 74 6f /. int nSecto
bcd0: 72 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 r;
bce0: 20 20 20 20 20 20 20 20 2f 2a 20 53 65 63 74 6f /* Secto
bcf0: 72 20 73 69 7a 65 20 2a 2f 0a 20 20 20 20 69 6e r size */. in
bd00: 74 20 73 7a 50 61 67 65 3b 20 20 20 20 20 20 20 t szPage;
bd10: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
bd20: 2f 2a 20 50 61 67 65 20 73 69 7a 65 20 2a 2f 0a /* Page size */.
bd30: 0a 20 20 20 20 61 73 73 65 72 74 28 20 69 73 4f . assert( isO
bd40: 70 65 6e 28 70 50 61 67 65 72 2d 3e 66 64 29 20 pen(pPager->fd)
bd50: 29 3b 0a 20 20 20 20 64 63 20 3d 20 73 71 6c 69 );. dc = sqli
bd60: 74 65 33 4f 73 44 65 76 69 63 65 43 68 61 72 61 te3OsDeviceChara
bd70: 63 74 65 72 69 73 74 69 63 73 28 70 50 61 67 65 cteristics(pPage
bd80: 72 2d 3e 66 64 29 3b 0a 20 20 20 20 6e 53 65 63 r->fd);. nSec
bd90: 74 6f 72 20 3d 20 70 50 61 67 65 72 2d 3e 73 65 tor = pPager->se
bda0: 63 74 6f 72 53 69 7a 65 3b 0a 20 20 20 20 73 7a ctorSize;. sz
bdb0: 50 61 67 65 20 3d 20 70 50 61 67 65 72 2d 3e 70 Page = pPager->p
bdc0: 61 67 65 53 69 7a 65 3b 0a 0a 20 20 20 20 61 73 ageSize;.. as
bdd0: 73 65 72 74 28 53 51 4c 49 54 45 5f 49 4f 43 41 sert(SQLITE_IOCA
bde0: 50 5f 41 54 4f 4d 49 43 35 31 32 3d 3d 28 35 31 P_ATOMIC512==(51
bdf0: 32 3e 3e 38 29 29 3b 0a 20 20 20 20 61 73 73 65 2>>8));. asse
be00: 72 74 28 53 51 4c 49 54 45 5f 49 4f 43 41 50 5f rt(SQLITE_IOCAP_
be10: 41 54 4f 4d 49 43 36 34 4b 3d 3d 28 36 35 35 33 ATOMIC64K==(6553
be20: 36 3e 3e 38 29 29 3b 0a 20 20 20 20 69 66 28 20 6>>8));. if(
be30: 30 3d 3d 28 64 63 26 28 53 51 4c 49 54 45 5f 49 0==(dc&(SQLITE_I
be40: 4f 43 41 50 5f 41 54 4f 4d 49 43 7c 28 73 7a 50 OCAP_ATOMIC|(szP
be50: 61 67 65 3e 3e 38 29 29 20 7c 7c 20 6e 53 65 63 age>>8)) || nSec
be60: 74 6f 72 3e 73 7a 50 61 67 65 29 20 29 7b 0a 20 tor>szPage) ){.
be70: 20 20 20 20 20 72 65 74 75 72 6e 20 30 3b 0a 20 return 0;.
be80: 20 20 20 7d 0a 20 20 7d 0a 0a 20 20 72 65 74 75 }. }.. retu
be90: 72 6e 20 4a 4f 55 52 4e 41 4c 5f 48 44 52 5f 53 rn JOURNAL_HDR_S
bea0: 5a 28 70 50 61 67 65 72 29 20 2b 20 4a 4f 55 52 Z(pPager) + JOUR
beb0: 4e 41 4c 5f 50 47 5f 53 5a 28 70 50 61 67 65 72 NAL_PG_SZ(pPager
bec0: 29 3b 0a 7d 0a 23 65 6e 64 69 66 0a 0a 2f 2a 0a );.}.#endif../*.
bed0: 2a 2a 20 49 66 20 53 51 4c 49 54 45 5f 43 48 45 ** If SQLITE_CHE
bee0: 43 4b 5f 50 41 47 45 53 20 69 73 20 64 65 66 69 CK_PAGES is defi
bef0: 6e 65 64 20 74 68 65 6e 20 77 65 20 64 6f 20 73 ned then we do s
bf00: 6f 6d 65 20 73 61 6e 69 74 79 20 63 68 65 63 6b ome sanity check
bf10: 69 6e 67 0a 2a 2a 20 6f 6e 20 74 68 65 20 63 61 ing.** on the ca
bf20: 63 68 65 20 75 73 69 6e 67 20 61 20 68 61 73 68 che using a hash
bf30: 20 66 75 6e 63 74 69 6f 6e 2e 20 20 54 68 69 73 function. This
bf40: 20 69 73 20 75 73 65 64 20 66 6f 72 20 74 65 73 is used for tes
bf50: 74 69 6e 67 0a 2a 2a 20 61 6e 64 20 64 65 62 75 ting.** and debu
bf60: 67 67 69 6e 67 20 6f 6e 6c 79 2e 0a 2a 2f 0a 23 gging only..*/.#
bf70: 69 66 64 65 66 20 53 51 4c 49 54 45 5f 43 48 45 ifdef SQLITE_CHE
bf80: 43 4b 5f 50 41 47 45 53 0a 2f 2a 0a 2a 2a 20 52 CK_PAGES./*.** R
bf90: 65 74 75 72 6e 20 61 20 33 32 2d 62 69 74 20 68 eturn a 32-bit h
bfa0: 61 73 68 20 6f 66 20 74 68 65 20 70 61 67 65 20 ash of the page
bfb0: 64 61 74 61 20 66 6f 72 20 70 50 61 67 65 2e 0a data for pPage..
bfc0: 2a 2f 0a 73 74 61 74 69 63 20 75 33 32 20 70 61 */.static u32 pa
bfd0: 67 65 72 5f 64 61 74 61 68 61 73 68 28 69 6e 74 ger_datahash(int
bfe0: 20 6e 42 79 74 65 2c 20 75 6e 73 69 67 6e 65 64 nByte, unsigned
bff0: 20 63 68 61 72 20 2a 70 44 61 74 61 29 7b 0a 20 char *pData){.
c000: 20 75 33 32 20 68 61 73 68 20 3d 20 30 3b 0a 20 u32 hash = 0;.
c010: 20 69 6e 74 20 69 3b 0a 20 20 66 6f 72 28 69 3d int i;. for(i=
c020: 30 3b 20 69 3c 6e 42 79 74 65 3b 20 69 2b 2b 29 0; i<nByte; i++)
c030: 7b 0a 20 20 20 20 68 61 73 68 20 3d 20 28 68 61 {. hash = (ha
c040: 73 68 2a 31 30 33 39 29 20 2b 20 70 44 61 74 61 sh*1039) + pData
c050: 5b 69 5d 3b 0a 20 20 7d 0a 20 20 72 65 74 75 72 [i];. }. retur
c060: 6e 20 68 61 73 68 3b 0a 7d 0a 73 74 61 74 69 63 n hash;.}.static
c070: 20 75 33 32 20 70 61 67 65 72 5f 70 61 67 65 68 u32 pager_pageh
c080: 61 73 68 28 50 67 48 64 72 20 2a 70 50 61 67 65 ash(PgHdr *pPage
c090: 29 7b 0a 20 20 72 65 74 75 72 6e 20 70 61 67 65 ){. return page
c0a0: 72 5f 64 61 74 61 68 61 73 68 28 70 50 61 67 65 r_datahash(pPage
c0b0: 2d 3e 70 50 61 67 65 72 2d 3e 70 61 67 65 53 69 ->pPager->pageSi
c0c0: 7a 65 2c 20 28 75 6e 73 69 67 6e 65 64 20 63 68 ze, (unsigned ch
c0d0: 61 72 20 2a 29 70 50 61 67 65 2d 3e 70 44 61 74 ar *)pPage->pDat
c0e0: 61 29 3b 0a 7d 0a 73 74 61 74 69 63 20 76 6f 69 a);.}.static voi
c0f0: 64 20 70 61 67 65 72 5f 73 65 74 5f 70 61 67 65 d pager_set_page
c100: 68 61 73 68 28 50 67 48 64 72 20 2a 70 50 61 67 hash(PgHdr *pPag
c110: 65 29 7b 0a 20 20 70 50 61 67 65 2d 3e 70 61 67 e){. pPage->pag
c120: 65 48 61 73 68 20 3d 20 70 61 67 65 72 5f 70 61 eHash = pager_pa
c130: 67 65 68 61 73 68 28 70 50 61 67 65 29 3b 0a 7d gehash(pPage);.}
c140: 0a 0a 2f 2a 0a 2a 2a 20 54 68 65 20 43 48 45 43 ../*.** The CHEC
c150: 4b 5f 50 41 47 45 20 6d 61 63 72 6f 20 74 61 6b K_PAGE macro tak
c160: 65 73 20 61 20 50 67 48 64 72 2a 20 61 73 20 61 es a PgHdr* as a
c170: 6e 20 61 72 67 75 6d 65 6e 74 2e 20 49 66 20 53 n argument. If S
c180: 51 4c 49 54 45 5f 43 48 45 43 4b 5f 50 41 47 45 QLITE_CHECK_PAGE
c190: 53 0a 2a 2a 20 69 73 20 64 65 66 69 6e 65 64 2c S.** is defined,
c1a0: 20 61 6e 64 20 4e 44 45 42 55 47 20 69 73 20 6e and NDEBUG is n
c1b0: 6f 74 20 64 65 66 69 6e 65 64 2c 20 61 6e 20 61 ot defined, an a
c1c0: 73 73 65 72 74 28 29 20 73 74 61 74 65 6d 65 6e ssert() statemen
c1d0: 74 20 63 68 65 63 6b 73 0a 2a 2a 20 74 68 61 74 t checks.** that
c1e0: 20 74 68 65 20 70 61 67 65 20 69 73 20 65 69 74 the page is eit
c1f0: 68 65 72 20 64 69 72 74 79 20 6f 72 20 73 74 69 her dirty or sti
c200: 6c 6c 20 6d 61 74 63 68 65 73 20 74 68 65 20 63 ll matches the c
c210: 61 6c 63 75 6c 61 74 65 64 20 70 61 67 65 2d 68 alculated page-h
c220: 61 73 68 2e 0a 2a 2f 0a 23 64 65 66 69 6e 65 20 ash..*/.#define
c230: 43 48 45 43 4b 5f 50 41 47 45 28 78 29 20 63 68 CHECK_PAGE(x) ch
c240: 65 63 6b 50 61 67 65 28 78 29 0a 73 74 61 74 69 eckPage(x).stati
c250: 63 20 76 6f 69 64 20 63 68 65 63 6b 50 61 67 65 c void checkPage
c260: 28 50 67 48 64 72 20 2a 70 50 67 29 7b 0a 20 20 (PgHdr *pPg){.
c270: 50 61 67 65 72 20 2a 70 50 61 67 65 72 20 3d 20 Pager *pPager =
c280: 70 50 67 2d 3e 70 50 61 67 65 72 3b 0a 20 20 61 pPg->pPager;. a
c290: 73 73 65 72 74 28 20 70 50 61 67 65 72 2d 3e 65 ssert( pPager->e
c2a0: 53 74 61 74 65 21 3d 50 41 47 45 52 5f 45 52 52 State!=PAGER_ERR
c2b0: 4f 52 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 OR );. assert(
c2c0: 28 70 50 67 2d 3e 66 6c 61 67 73 26 50 47 48 44 (pPg->flags&PGHD
c2d0: 52 5f 44 49 52 54 59 29 20 7c 7c 20 70 50 67 2d R_DIRTY) || pPg-
c2e0: 3e 70 61 67 65 48 61 73 68 3d 3d 70 61 67 65 72 >pageHash==pager
c2f0: 5f 70 61 67 65 68 61 73 68 28 70 50 67 29 20 29 _pagehash(pPg) )
c300: 3b 0a 7d 0a 0a 23 65 6c 73 65 0a 23 64 65 66 69 ;.}..#else.#defi
c310: 6e 65 20 70 61 67 65 72 5f 64 61 74 61 68 61 73 ne pager_datahas
c320: 68 28 58 2c 59 29 20 20 30 0a 23 64 65 66 69 6e h(X,Y) 0.#defin
c330: 65 20 70 61 67 65 72 5f 70 61 67 65 68 61 73 68 e pager_pagehash
c340: 28 58 29 20 20 30 0a 23 64 65 66 69 6e 65 20 70 (X) 0.#define p
c350: 61 67 65 72 5f 73 65 74 5f 70 61 67 65 68 61 73 ager_set_pagehas
c360: 68 28 58 29 0a 23 64 65 66 69 6e 65 20 43 48 45 h(X).#define CHE
c370: 43 4b 5f 50 41 47 45 28 78 29 0a 23 65 6e 64 69 CK_PAGE(x).#endi
c380: 66 20 20 2f 2a 20 53 51 4c 49 54 45 5f 43 48 45 f /* SQLITE_CHE
c390: 43 4b 5f 50 41 47 45 53 20 2a 2f 0a 0a 2f 2a 0a CK_PAGES */../*.
c3a0: 2a 2a 20 57 68 65 6e 20 74 68 69 73 20 69 73 20 ** When this is
c3b0: 63 61 6c 6c 65 64 20 74 68 65 20 6a 6f 75 72 6e called the journ
c3c0: 61 6c 20 66 69 6c 65 20 66 6f 72 20 70 61 67 65 al file for page
c3d0: 72 20 70 50 61 67 65 72 20 6d 75 73 74 20 62 65 r pPager must be
c3e0: 20 6f 70 65 6e 2e 0a 2a 2a 20 54 68 69 73 20 66 open..** This f
c3f0: 75 6e 63 74 69 6f 6e 20 61 74 74 65 6d 70 74 73 unction attempts
c400: 20 74 6f 20 72 65 61 64 20 61 20 6d 61 73 74 65 to read a maste
c410: 72 20 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 20 6e r journal file n
c420: 61 6d 65 20 66 72 6f 6d 20 74 68 65 20 0a 2a 2a ame from the .**
c430: 20 65 6e 64 20 6f 66 20 74 68 65 20 66 69 6c 65 end of the file
c440: 20 61 6e 64 2c 20 69 66 20 73 75 63 63 65 73 73 and, if success
c450: 66 75 6c 2c 20 63 6f 70 69 65 73 20 69 74 20 69 ful, copies it i
c460: 6e 74 6f 20 6d 65 6d 6f 72 79 20 73 75 70 70 6c nto memory suppl
c470: 69 65 64 20 0a 2a 2a 20 62 79 20 74 68 65 20 63 ied .** by the c
c480: 61 6c 6c 65 72 2e 20 53 65 65 20 63 6f 6d 6d 65 aller. See comme
c490: 6e 74 73 20 61 62 6f 76 65 20 77 72 69 74 65 4d nts above writeM
c4a0: 61 73 74 65 72 4a 6f 75 72 6e 61 6c 28 29 20 66 asterJournal() f
c4b0: 6f 72 20 74 68 65 20 66 6f 72 6d 61 74 0a 2a 2a or the format.**
c4c0: 20 75 73 65 64 20 74 6f 20 73 74 6f 72 65 20 61 used to store a
c4d0: 20 6d 61 73 74 65 72 20 6a 6f 75 72 6e 61 6c 20 master journal
c4e0: 66 69 6c 65 20 6e 61 6d 65 20 61 74 20 74 68 65 file name at the
c4f0: 20 65 6e 64 20 6f 66 20 61 20 6a 6f 75 72 6e 61 end of a journa
c500: 6c 20 66 69 6c 65 2e 0a 2a 2a 0a 2a 2a 20 7a 4d l file..**.** zM
c510: 61 73 74 65 72 20 6d 75 73 74 20 70 6f 69 6e 74 aster must point
c520: 20 74 6f 20 61 20 62 75 66 66 65 72 20 6f 66 20 to a buffer of
c530: 61 74 20 6c 65 61 73 74 20 6e 4d 61 73 74 65 72 at least nMaster
c540: 20 62 79 74 65 73 20 61 6c 6c 6f 63 61 74 65 64 bytes allocated
c550: 20 62 79 0a 2a 2a 20 74 68 65 20 63 61 6c 6c 65 by.** the calle
c560: 72 2e 20 54 68 69 73 20 73 68 6f 75 6c 64 20 62 r. This should b
c570: 65 20 73 71 6c 69 74 65 33 5f 76 66 73 2e 6d 78 e sqlite3_vfs.mx
c580: 50 61 74 68 6e 61 6d 65 2b 31 20 28 74 6f 20 65 Pathname+1 (to e
c590: 6e 73 75 72 65 20 74 68 65 72 65 20 69 73 0a 2a nsure there is.*
c5a0: 2a 20 65 6e 6f 75 67 68 20 73 70 61 63 65 20 74 * enough space t
c5b0: 6f 20 77 72 69 74 65 20 74 68 65 20 6d 61 73 74 o write the mast
c5c0: 65 72 20 6a 6f 75 72 6e 61 6c 20 6e 61 6d 65 29 er journal name)
c5d0: 2e 20 49 66 20 74 68 65 20 6d 61 73 74 65 72 20 . If the master
c5e0: 6a 6f 75 72 6e 61 6c 0a 2a 2a 20 6e 61 6d 65 20 journal.** name
c5f0: 69 6e 20 74 68 65 20 6a 6f 75 72 6e 61 6c 20 69 in the journal i
c600: 73 20 6c 6f 6e 67 65 72 20 74 68 61 6e 20 6e 4d s longer than nM
c610: 61 73 74 65 72 20 62 79 74 65 73 20 28 69 6e 63 aster bytes (inc
c620: 6c 75 64 69 6e 67 20 61 0a 2a 2a 20 6e 75 6c 2d luding a.** nul-
c630: 74 65 72 6d 69 6e 61 74 6f 72 29 2c 20 74 68 65 terminator), the
c640: 6e 20 74 68 69 73 20 69 73 20 68 61 6e 64 6c 65 n this is handle
c650: 64 20 61 73 20 69 66 20 6e 6f 20 6d 61 73 74 65 d as if no maste
c660: 72 20 6a 6f 75 72 6e 61 6c 20 6e 61 6d 65 0a 2a r journal name.*
c670: 2a 20 77 65 72 65 20 70 72 65 73 65 6e 74 20 69 * were present i
c680: 6e 20 74 68 65 20 6a 6f 75 72 6e 61 6c 2e 0a 2a n the journal..*
c690: 2a 0a 2a 2a 20 49 66 20 61 20 6d 61 73 74 65 72 *.** If a master
c6a0: 20 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 20 6e 61 journal file na
c6b0: 6d 65 20 69 73 20 70 72 65 73 65 6e 74 20 61 74 me is present at
c6c0: 20 74 68 65 20 65 6e 64 20 6f 66 20 74 68 65 20 the end of the
c6d0: 6a 6f 75 72 6e 61 6c 0a 2a 2a 20 66 69 6c 65 2c journal.** file,
c6e0: 20 74 68 65 6e 20 69 74 20 69 73 20 63 6f 70 69 then it is copi
c6f0: 65 64 20 69 6e 74 6f 20 74 68 65 20 62 75 66 66 ed into the buff
c700: 65 72 20 70 6f 69 6e 74 65 64 20 74 6f 20 62 79 er pointed to by
c710: 20 7a 4d 61 73 74 65 72 2e 20 41 0a 2a 2a 20 6e zMaster. A.** n
c720: 75 6c 2d 74 65 72 6d 69 6e 61 74 6f 72 20 62 79 ul-terminator by
c730: 74 65 20 69 73 20 61 70 70 65 6e 64 65 64 20 74 te is appended t
c740: 6f 20 74 68 65 20 62 75 66 66 65 72 20 66 6f 6c o the buffer fol
c750: 6c 6f 77 69 6e 67 20 74 68 65 20 6d 61 73 74 65 lowing the maste
c760: 72 0a 2a 2a 20 6a 6f 75 72 6e 61 6c 20 66 69 6c r.** journal fil
c770: 65 20 6e 61 6d 65 2e 0a 2a 2a 0a 2a 2a 20 49 66 e name..**.** If
c780: 20 69 74 20 69 73 20 64 65 74 65 72 6d 69 6e 65 it is determine
c790: 64 20 74 68 61 74 20 6e 6f 20 6d 61 73 74 65 72 d that no master
c7a0: 20 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 20 6e 61 journal file na
c7b0: 6d 65 20 69 73 20 70 72 65 73 65 6e 74 20 0a 2a me is present .*
c7c0: 2a 20 7a 4d 61 73 74 65 72 5b 30 5d 20 69 73 20 * zMaster[0] is
c7d0: 73 65 74 20 74 6f 20 30 20 61 6e 64 20 53 51 4c set to 0 and SQL
c7e0: 49 54 45 5f 4f 4b 20 72 65 74 75 72 6e 65 64 2e ITE_OK returned.
c7f0: 0a 2a 2a 0a 2a 2a 20 49 66 20 61 6e 20 65 72 72 .**.** If an err
c800: 6f 72 20 6f 63 63 75 72 73 20 77 68 69 6c 65 20 or occurs while
c810: 72 65 61 64 69 6e 67 20 66 72 6f 6d 20 74 68 65 reading from the
c820: 20 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 2c 20 61 journal file, a
c830: 6e 20 53 51 4c 69 74 65 0a 2a 2a 20 65 72 72 6f n SQLite.** erro
c840: 72 20 63 6f 64 65 20 69 73 20 72 65 74 75 72 6e r code is return
c850: 65 64 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e ed..*/.static in
c860: 74 20 72 65 61 64 4d 61 73 74 65 72 4a 6f 75 72 t readMasterJour
c870: 6e 61 6c 28 73 71 6c 69 74 65 33 5f 66 69 6c 65 nal(sqlite3_file
c880: 20 2a 70 4a 72 6e 6c 2c 20 63 68 61 72 20 2a 7a *pJrnl, char *z
c890: 4d 61 73 74 65 72 2c 20 75 33 32 20 6e 4d 61 73 Master, u32 nMas
c8a0: 74 65 72 29 7b 0a 20 20 69 6e 74 20 72 63 3b 20 ter){. int rc;
c8b0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
c8c0: 20 20 20 2f 2a 20 52 65 74 75 72 6e 20 63 6f 64 /* Return cod
c8d0: 65 20 2a 2f 0a 20 20 75 33 32 20 6c 65 6e 3b 20 e */. u32 len;
c8e0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
c8f0: 20 20 2f 2a 20 4c 65 6e 67 74 68 20 69 6e 20 62 /* Length in b
c900: 79 74 65 73 20 6f 66 20 6d 61 73 74 65 72 20 6a ytes of master j
c910: 6f 75 72 6e 61 6c 20 6e 61 6d 65 20 2a 2f 0a 20 ournal name */.
c920: 20 69 36 34 20 73 7a 4a 3b 20 20 20 20 20 20 20 i64 szJ;
c930: 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 54 /* T
c940: 6f 74 61 6c 20 73 69 7a 65 20 69 6e 20 62 79 74 otal size in byt
c950: 65 73 20 6f 66 20 6a 6f 75 72 6e 61 6c 20 66 69 es of journal fi
c960: 6c 65 20 70 4a 72 6e 6c 20 2a 2f 0a 20 20 75 33 le pJrnl */. u3
c970: 32 20 63 6b 73 75 6d 3b 20 20 20 20 20 20 20 20 2 cksum;
c980: 20 20 20 20 20 20 20 20 20 2f 2a 20 4d 4a 20 63 /* MJ c
c990: 68 65 63 6b 73 75 6d 20 76 61 6c 75 65 20 72 65 hecksum value re
c9a0: 61 64 20 66 72 6f 6d 20 6a 6f 75 72 6e 61 6c 20 ad from journal
c9b0: 2a 2f 0a 20 20 75 33 32 20 75 3b 20 20 20 20 20 */. u32 u;
c9c0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
c9d0: 2f 2a 20 55 6e 73 69 67 6e 65 64 20 6c 6f 6f 70 /* Unsigned loop
c9e0: 20 63 6f 75 6e 74 65 72 20 2a 2f 0a 20 20 75 6e counter */. un
c9f0: 73 69 67 6e 65 64 20 63 68 61 72 20 61 4d 61 67 signed char aMag
ca00: 69 63 5b 38 5d 3b 20 20 20 2f 2a 20 41 20 62 75 ic[8]; /* A bu
ca10: 66 66 65 72 20 74 6f 20 68 6f 6c 64 20 74 68 65 ffer to hold the
ca20: 20 6d 61 67 69 63 20 68 65 61 64 65 72 20 2a 2f magic header */
ca30: 0a 20 20 7a 4d 61 73 74 65 72 5b 30 5d 20 3d 20 . zMaster[0] =
ca40: 27 5c 30 27 3b 0a 0a 20 20 69 66 28 20 53 51 4c '\0';.. if( SQL
ca50: 49 54 45 5f 4f 4b 21 3d 28 72 63 20 3d 20 73 71 ITE_OK!=(rc = sq
ca60: 6c 69 74 65 33 4f 73 46 69 6c 65 53 69 7a 65 28 lite3OsFileSize(
ca70: 70 4a 72 6e 6c 2c 20 26 73 7a 4a 29 29 0a 20 20 pJrnl, &szJ)).
ca80: 20 7c 7c 20 73 7a 4a 3c 31 36 0a 20 20 20 7c 7c || szJ<16. ||
ca90: 20 53 51 4c 49 54 45 5f 4f 4b 21 3d 28 72 63 20 SQLITE_OK!=(rc
caa0: 3d 20 72 65 61 64 33 32 62 69 74 73 28 70 4a 72 = read32bits(pJr
cab0: 6e 6c 2c 20 73 7a 4a 2d 31 36 2c 20 26 6c 65 6e nl, szJ-16, &len
cac0: 29 29 0a 20 20 20 7c 7c 20 6c 65 6e 3e 3d 6e 4d )). || len>=nM
cad0: 61 73 74 65 72 20 0a 20 20 20 7c 7c 20 53 51 4c aster . || SQL
cae0: 49 54 45 5f 4f 4b 21 3d 28 72 63 20 3d 20 72 65 ITE_OK!=(rc = re
caf0: 61 64 33 32 62 69 74 73 28 70 4a 72 6e 6c 2c 20 ad32bits(pJrnl,
cb00: 73 7a 4a 2d 31 32 2c 20 26 63 6b 73 75 6d 29 29 szJ-12, &cksum))
cb10: 0a 20 20 20 7c 7c 20 53 51 4c 49 54 45 5f 4f 4b . || SQLITE_OK
cb20: 21 3d 28 72 63 20 3d 20 73 71 6c 69 74 65 33 4f !=(rc = sqlite3O
cb30: 73 52 65 61 64 28 70 4a 72 6e 6c 2c 20 61 4d 61 sRead(pJrnl, aMa
cb40: 67 69 63 2c 20 38 2c 20 73 7a 4a 2d 38 29 29 0a gic, 8, szJ-8)).
cb50: 20 20 20 7c 7c 20 6d 65 6d 63 6d 70 28 61 4d 61 || memcmp(aMa
cb60: 67 69 63 2c 20 61 4a 6f 75 72 6e 61 6c 4d 61 67 gic, aJournalMag
cb70: 69 63 2c 20 38 29 0a 20 20 20 7c 7c 20 53 51 4c ic, 8). || SQL
cb80: 49 54 45 5f 4f 4b 21 3d 28 72 63 20 3d 20 73 71 ITE_OK!=(rc = sq
cb90: 6c 69 74 65 33 4f 73 52 65 61 64 28 70 4a 72 6e lite3OsRead(pJrn
cba0: 6c 2c 20 7a 4d 61 73 74 65 72 2c 20 6c 65 6e 2c l, zMaster, len,
cbb0: 20 73 7a 4a 2d 31 36 2d 6c 65 6e 29 29 0a 20 20 szJ-16-len)).
cbc0: 29 7b 0a 20 20 20 20 72 65 74 75 72 6e 20 72 63 ){. return rc
cbd0: 3b 0a 20 20 7d 0a 0a 20 20 2f 2a 20 53 65 65 20 ;. }.. /* See
cbe0: 69 66 20 74 68 65 20 63 68 65 63 6b 73 75 6d 20 if the checksum
cbf0: 6d 61 74 63 68 65 73 20 74 68 65 20 6d 61 73 74 matches the mast
cc00: 65 72 20 6a 6f 75 72 6e 61 6c 20 6e 61 6d 65 20 er journal name
cc10: 2a 2f 0a 20 20 66 6f 72 28 75 3d 30 3b 20 75 3c */. for(u=0; u<
cc20: 6c 65 6e 3b 20 75 2b 2b 29 7b 0a 20 20 20 20 63 len; u++){. c
cc30: 6b 73 75 6d 20 2d 3d 20 7a 4d 61 73 74 65 72 5b ksum -= zMaster[
cc40: 75 5d 3b 0a 20 20 7d 0a 20 20 69 66 28 20 63 6b u];. }. if( ck
cc50: 73 75 6d 20 29 7b 0a 20 20 20 20 2f 2a 20 49 66 sum ){. /* If
cc60: 20 74 68 65 20 63 68 65 63 6b 73 75 6d 20 64 6f the checksum do
cc70: 65 73 6e 27 74 20 61 64 64 20 75 70 2c 20 74 68 esn't add up, th
cc80: 65 6e 20 6f 6e 65 20 6f 72 20 6d 6f 72 65 20 6f en one or more o
cc90: 66 20 74 68 65 20 64 69 73 6b 20 73 65 63 74 6f f the disk secto
cca0: 72 73 0a 20 20 20 20 2a 2a 20 63 6f 6e 74 61 69 rs. ** contai
ccb0: 6e 69 6e 67 20 74 68 65 20 6d 61 73 74 65 72 20 ning the master
ccc0: 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 6e 61 6d 65 journal filename
ccd0: 20 69 73 20 63 6f 72 72 75 70 74 65 64 2e 20 54 is corrupted. T
cce0: 68 69 73 20 6d 65 61 6e 73 0a 20 20 20 20 2a 2a his means. **
ccf0: 20 64 65 66 69 6e 69 74 65 6c 79 20 72 6f 6c 6c definitely roll
cd00: 20 62 61 63 6b 2c 20 73 6f 20 6a 75 73 74 20 72 back, so just r
cd10: 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 20 eturn SQLITE_OK
cd20: 61 6e 64 20 72 65 70 6f 72 74 20 61 20 28 6e 75 and report a (nu
cd30: 6c 29 0a 20 20 20 20 2a 2a 20 6d 61 73 74 65 72 l). ** master
cd40: 2d 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 6e 61 6d -journal filenam
cd50: 65 2e 0a 20 20 20 20 2a 2f 0a 20 20 20 20 6c 65 e.. */. le
cd60: 6e 20 3d 20 30 3b 0a 20 20 7d 0a 20 20 7a 4d 61 n = 0;. }. zMa
cd70: 73 74 65 72 5b 6c 65 6e 5d 20 3d 20 27 5c 30 27 ster[len] = '\0'
cd80: 3b 0a 20 20 20 0a 20 20 72 65 74 75 72 6e 20 53 ;. . return S
cd90: 51 4c 49 54 45 5f 4f 4b 3b 0a 7d 0a 0a 2f 2a 0a QLITE_OK;.}../*.
cda0: 2a 2a 20 52 65 74 75 72 6e 20 74 68 65 20 6f 66 ** Return the of
cdb0: 66 73 65 74 20 6f 66 20 74 68 65 20 73 65 63 74 fset of the sect
cdc0: 6f 72 20 62 6f 75 6e 64 61 72 79 20 61 74 20 6f or boundary at o
cdd0: 72 20 69 6d 6d 65 64 69 61 74 65 6c 79 20 0a 2a r immediately .*
cde0: 2a 20 66 6f 6c 6c 6f 77 69 6e 67 20 74 68 65 20 * following the
cdf0: 76 61 6c 75 65 20 69 6e 20 70 50 61 67 65 72 2d value in pPager-
ce00: 3e 6a 6f 75 72 6e 61 6c 4f 66 66 2c 20 61 73 73 >journalOff, ass
ce10: 75 6d 69 6e 67 20 61 20 73 65 63 74 6f 72 20 0a uming a sector .
ce20: 2a 2a 20 73 69 7a 65 20 6f 66 20 70 50 61 67 65 ** size of pPage
ce30: 72 2d 3e 73 65 63 74 6f 72 53 69 7a 65 20 62 79 r->sectorSize by
ce40: 74 65 73 2e 0a 2a 2a 0a 2a 2a 20 69 2e 65 20 66 tes..**.** i.e f
ce50: 6f 72 20 61 20 73 65 63 74 6f 72 20 73 69 7a 65 or a sector size
ce60: 20 6f 66 20 35 31 32 3a 0a 2a 2a 0a 2a 2a 20 20 of 512:.**.**
ce70: 20 50 61 67 65 72 2e 6a 6f 75 72 6e 61 6c 4f 66 Pager.journalOf
ce80: 66 20 20 20 20 20 20 20 20 20 20 52 65 74 75 72 f Retur
ce90: 6e 20 76 61 6c 75 65 0a 2a 2a 20 20 20 2d 2d 2d n value.** ---
cea0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
ceb0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
cec0: 2d 2d 2d 2d 0a 2a 2a 20 20 20 30 20 20 20 20 20 ----.** 0
ced0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
cee0: 20 20 20 20 30 0a 2a 2a 20 20 20 35 31 32 20 20 0.** 512
cef0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
cf00: 20 20 20 20 20 35 31 32 0a 2a 2a 20 20 20 31 30 512.** 10
cf10: 30 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 0
cf20: 20 20 20 20 20 20 20 20 35 31 32 0a 2a 2a 20 20 512.**
cf30: 20 32 30 30 30 20 20 20 20 20 20 20 20 20 20 20 2000
cf40: 20 20 20 20 20 20 20 20 20 20 20 32 30 34 38 0a 2048.
cf50: 2a 2a 20 0a 2a 2f 0a 73 74 61 74 69 63 20 69 36 ** .*/.static i6
cf60: 34 20 6a 6f 75 72 6e 61 6c 48 64 72 4f 66 66 73 4 journalHdrOffs
cf70: 65 74 28 50 61 67 65 72 20 2a 70 50 61 67 65 72 et(Pager *pPager
cf80: 29 7b 0a 20 20 69 36 34 20 6f 66 66 73 65 74 20 ){. i64 offset
cf90: 3d 20 30 3b 0a 20 20 69 36 34 20 63 20 3d 20 70 = 0;. i64 c = p
cfa0: 50 61 67 65 72 2d 3e 6a 6f 75 72 6e 61 6c 4f 66 Pager->journalOf
cfb0: 66 3b 0a 20 20 69 66 28 20 63 20 29 7b 0a 20 20 f;. if( c ){.
cfc0: 20 20 6f 66 66 73 65 74 20 3d 20 28 28 63 2d 31 offset = ((c-1
cfd0: 29 2f 4a 4f 55 52 4e 41 4c 5f 48 44 52 5f 53 5a )/JOURNAL_HDR_SZ
cfe0: 28 70 50 61 67 65 72 29 20 2b 20 31 29 20 2a 20 (pPager) + 1) *
cff0: 4a 4f 55 52 4e 41 4c 5f 48 44 52 5f 53 5a 28 70 JOURNAL_HDR_SZ(p
d000: 50 61 67 65 72 29 3b 0a 20 20 7d 0a 20 20 61 73 Pager);. }. as
d010: 73 65 72 74 28 20 6f 66 66 73 65 74 25 4a 4f 55 sert( offset%JOU
d020: 52 4e 41 4c 5f 48 44 52 5f 53 5a 28 70 50 61 67 RNAL_HDR_SZ(pPag
d030: 65 72 29 3d 3d 30 20 29 3b 0a 20 20 61 73 73 65 er)==0 );. asse
d040: 72 74 28 20 6f 66 66 73 65 74 3e 3d 63 20 29 3b rt( offset>=c );
d050: 0a 20 20 61 73 73 65 72 74 28 20 28 6f 66 66 73 . assert( (offs
d060: 65 74 2d 63 29 3c 4a 4f 55 52 4e 41 4c 5f 48 44 et-c)<JOURNAL_HD
d070: 52 5f 53 5a 28 70 50 61 67 65 72 29 20 29 3b 0a R_SZ(pPager) );.
d080: 20 20 72 65 74 75 72 6e 20 6f 66 66 73 65 74 3b return offset;
d090: 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 54 68 65 20 6a 6f .}../*.** The jo
d0a0: 75 72 6e 61 6c 20 66 69 6c 65 20 6d 75 73 74 20 urnal file must
d0b0: 62 65 20 6f 70 65 6e 20 77 68 65 6e 20 74 68 69 be open when thi
d0c0: 73 20 66 75 6e 63 74 69 6f 6e 20 69 73 20 63 61 s function is ca
d0d0: 6c 6c 65 64 2e 0a 2a 2a 0a 2a 2a 20 54 68 69 73 lled..**.** This
d0e0: 20 66 75 6e 63 74 69 6f 6e 20 69 73 20 61 20 6e function is a n
d0f0: 6f 2d 6f 70 20 69 66 20 74 68 65 20 6a 6f 75 72 o-op if the jour
d100: 6e 61 6c 20 66 69 6c 65 20 68 61 73 20 6e 6f 74 nal file has not
d110: 20 62 65 65 6e 20 77 72 69 74 74 65 6e 20 74 6f been written to
d120: 0a 2a 2a 20 77 69 74 68 69 6e 20 74 68 65 20 63 .** within the c
d130: 75 72 72 65 6e 74 20 74 72 61 6e 73 61 63 74 69 urrent transacti
d140: 6f 6e 20 28 69 2e 65 2e 20 69 66 20 50 61 67 65 on (i.e. if Page
d150: 72 2e 6a 6f 75 72 6e 61 6c 4f 66 66 3d 3d 30 29 r.journalOff==0)
d160: 2e 0a 2a 2a 0a 2a 2a 20 49 66 20 64 6f 54 72 75 ..**.** If doTru
d170: 6e 63 61 74 65 20 69 73 20 6e 6f 6e 2d 7a 65 72 ncate is non-zer
d180: 6f 20 6f 72 20 74 68 65 20 50 61 67 65 72 2e 6a o or the Pager.j
d190: 6f 75 72 6e 61 6c 53 69 7a 65 4c 69 6d 69 74 20 ournalSizeLimit
d1a0: 76 61 72 69 61 62 6c 65 20 69 73 0a 2a 2a 20 73 variable is.** s
d1b0: 65 74 20 74 6f 20 30 2c 20 74 68 65 6e 20 74 72 et to 0, then tr
d1c0: 75 6e 63 61 74 65 20 74 68 65 20 6a 6f 75 72 6e uncate the journ
d1d0: 61 6c 20 66 69 6c 65 20 74 6f 20 7a 65 72 6f 20 al file to zero
d1e0: 62 79 74 65 73 20 69 6e 20 73 69 7a 65 2e 20 4f bytes in size. O
d1f0: 74 68 65 72 77 69 73 65 2c 0a 2a 2a 20 7a 65 72 therwise,.** zer
d200: 6f 20 74 68 65 20 32 38 2d 62 79 74 65 20 68 65 o the 28-byte he
d210: 61 64 65 72 20 61 74 20 74 68 65 20 73 74 61 72 ader at the star
d220: 74 20 6f 66 20 74 68 65 20 6a 6f 75 72 6e 61 6c t of the journal
d230: 20 66 69 6c 65 2e 20 49 6e 20 65 69 74 68 65 72 file. In either
d240: 20 63 61 73 65 2c 20 0a 2a 2a 20 69 66 20 74 68 case, .** if th
d250: 65 20 70 61 67 65 72 20 69 73 20 6e 6f 74 20 69 e pager is not i
d260: 6e 20 6e 6f 2d 73 79 6e 63 20 6d 6f 64 65 2c 20 n no-sync mode,
d270: 73 79 6e 63 20 74 68 65 20 6a 6f 75 72 6e 61 6c sync the journal
d280: 20 66 69 6c 65 20 69 6d 6d 65 64 69 61 74 65 6c file immediatel
d290: 79 20 0a 2a 2a 20 61 66 74 65 72 20 77 72 69 74 y .** after writ
d2a0: 69 6e 67 20 6f 72 20 74 72 75 6e 63 61 74 69 6e ing or truncatin
d2b0: 67 20 69 74 2e 0a 2a 2a 0a 2a 2a 20 49 66 20 50 g it..**.** If P
d2c0: 61 67 65 72 2e 6a 6f 75 72 6e 61 6c 53 69 7a 65 ager.journalSize
d2d0: 4c 69 6d 69 74 20 69 73 20 73 65 74 20 74 6f 20 Limit is set to
d2e0: 61 20 70 6f 73 69 74 69 76 65 2c 20 6e 6f 6e 2d a positive, non-
d2f0: 7a 65 72 6f 20 76 61 6c 75 65 2c 20 61 6e 64 0a zero value, and.
d300: 2a 2a 20 66 6f 6c 6c 6f 77 69 6e 67 20 74 68 65 ** following the
d310: 20 74 72 75 6e 63 61 74 69 6f 6e 20 6f 72 20 7a truncation or z
d320: 65 72 6f 69 6e 67 20 64 65 73 63 72 69 62 65 64 eroing described
d330: 20 61 62 6f 76 65 20 74 68 65 20 73 69 7a 65 20 above the size
d340: 6f 66 20 74 68 65 20 0a 2a 2a 20 6a 6f 75 72 6e of the .** journ
d350: 61 6c 20 66 69 6c 65 20 69 6e 20 62 79 74 65 73 al file in bytes
d360: 20 69 73 20 6c 61 72 67 65 72 20 74 68 61 6e 20 is larger than
d370: 74 68 69 73 20 76 61 6c 75 65 2c 20 74 68 65 6e this value, then
d380: 20 74 72 75 6e 63 61 74 65 20 74 68 65 0a 2a 2a truncate the.**
d390: 20 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 20 74 6f journal file to
d3a0: 20 50 61 67 65 72 2e 6a 6f 75 72 6e 61 6c 53 69 Pager.journalSi
d3b0: 7a 65 4c 69 6d 69 74 20 62 79 74 65 73 2e 20 54 zeLimit bytes. T
d3c0: 68 65 20 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 20 he journal file
d3d0: 64 6f 65 73 0a 2a 2a 20 6e 6f 74 20 6e 65 65 64 does.** not need
d3e0: 20 74 6f 20 62 65 20 73 79 6e 63 65 64 20 66 6f to be synced fo
d3f0: 6c 6c 6f 77 69 6e 67 20 74 68 69 73 20 6f 70 65 llowing this ope
d400: 72 61 74 69 6f 6e 2e 0a 2a 2a 0a 2a 2a 20 49 66 ration..**.** If
d410: 20 61 6e 20 49 4f 20 65 72 72 6f 72 20 6f 63 63 an IO error occ
d420: 75 72 73 2c 20 61 62 61 6e 64 6f 6e 20 70 72 6f urs, abandon pro
d430: 63 65 73 73 69 6e 67 20 61 6e 64 20 72 65 74 75 cessing and retu
d440: 72 6e 20 74 68 65 20 49 4f 20 65 72 72 6f 72 20 rn the IO error
d450: 63 6f 64 65 2e 0a 2a 2a 20 4f 74 68 65 72 77 69 code..** Otherwi
d460: 73 65 2c 20 72 65 74 75 72 6e 20 53 51 4c 49 54 se, return SQLIT
d470: 45 5f 4f 4b 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 E_OK..*/.static
d480: 69 6e 74 20 7a 65 72 6f 4a 6f 75 72 6e 61 6c 48 int zeroJournalH
d490: 64 72 28 50 61 67 65 72 20 2a 70 50 61 67 65 72 dr(Pager *pPager
d4a0: 2c 20 69 6e 74 20 64 6f 54 72 75 6e 63 61 74 65 , int doTruncate
d4b0: 29 7b 0a 20 20 69 6e 74 20 72 63 20 3d 20 53 51 ){. int rc = SQ
d4c0: 4c 49 54 45 5f 4f 4b 3b 20 20 20 20 20 20 20 20 LITE_OK;
d4d0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
d4e0: 20 20 20 20 20 20 20 2f 2a 20 52 65 74 75 72 6e /* Return
d4f0: 20 63 6f 64 65 20 2a 2f 0a 20 20 61 73 73 65 72 code */. asser
d500: 74 28 20 69 73 4f 70 65 6e 28 70 50 61 67 65 72 t( isOpen(pPager
d510: 2d 3e 6a 66 64 29 20 29 3b 0a 20 20 69 66 28 20 ->jfd) );. if(
d520: 70 50 61 67 65 72 2d 3e 6a 6f 75 72 6e 61 6c 4f pPager->journalO
d530: 66 66 20 29 7b 0a 20 20 20 20 63 6f 6e 73 74 20 ff ){. const
d540: 69 36 34 20 69 4c 69 6d 69 74 20 3d 20 70 50 61 i64 iLimit = pPa
d550: 67 65 72 2d 3e 6a 6f 75 72 6e 61 6c 53 69 7a 65 ger->journalSize
d560: 4c 69 6d 69 74 3b 20 20 20 20 2f 2a 20 4c 6f 63 Limit; /* Loc
d570: 61 6c 20 63 61 63 68 65 20 6f 66 20 6a 73 6c 20 al cache of jsl
d580: 2a 2f 0a 0a 20 20 20 20 49 4f 54 52 41 43 45 28 */.. IOTRACE(
d590: 28 22 4a 5a 45 52 4f 48 44 52 20 25 70 5c 6e 22 ("JZEROHDR %p\n"
d5a0: 2c 20 70 50 61 67 65 72 29 29 0a 20 20 20 20 69 , pPager)). i
d5b0: 66 28 20 64 6f 54 72 75 6e 63 61 74 65 20 7c 7c f( doTruncate ||
d5c0: 20 69 4c 69 6d 69 74 3d 3d 30 20 29 7b 0a 20 20 iLimit==0 ){.
d5d0: 20 20 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33 rc = sqlite3
d5e0: 4f 73 54 72 75 6e 63 61 74 65 28 70 50 61 67 65 OsTruncate(pPage
d5f0: 72 2d 3e 6a 66 64 2c 20 30 29 3b 0a 20 20 20 20 r->jfd, 0);.
d600: 7d 65 6c 73 65 7b 0a 20 20 20 20 20 20 73 74 61 }else{. sta
d610: 74 69 63 20 63 6f 6e 73 74 20 63 68 61 72 20 7a tic const char z
d620: 65 72 6f 48 64 72 5b 32 38 5d 20 3d 20 7b 30 7d eroHdr[28] = {0}
d630: 3b 0a 20 20 20 20 20 20 72 63 20 3d 20 73 71 6c ;. rc = sql
d640: 69 74 65 33 4f 73 57 72 69 74 65 28 70 50 61 67 ite3OsWrite(pPag
d650: 65 72 2d 3e 6a 66 64 2c 20 7a 65 72 6f 48 64 72 er->jfd, zeroHdr
d660: 2c 20 73 69 7a 65 6f 66 28 7a 65 72 6f 48 64 72 , sizeof(zeroHdr
d670: 29 2c 20 30 29 3b 0a 20 20 20 20 7d 0a 20 20 20 ), 0);. }.
d680: 20 69 66 28 20 72 63 3d 3d 53 51 4c 49 54 45 5f if( rc==SQLITE_
d690: 4f 4b 20 26 26 20 21 70 50 61 67 65 72 2d 3e 6e OK && !pPager->n
d6a0: 6f 53 79 6e 63 20 29 7b 0a 20 20 20 20 20 20 72 oSync ){. r
d6b0: 63 20 3d 20 73 71 6c 69 74 65 33 4f 73 53 79 6e c = sqlite3OsSyn
d6c0: 63 28 70 50 61 67 65 72 2d 3e 6a 66 64 2c 20 53 c(pPager->jfd, S
d6d0: 51 4c 49 54 45 5f 53 59 4e 43 5f 44 41 54 41 4f QLITE_SYNC_DATAO
d6e0: 4e 4c 59 7c 70 50 61 67 65 72 2d 3e 73 79 6e 63 NLY|pPager->sync
d6f0: 46 6c 61 67 73 29 3b 0a 20 20 20 20 7d 0a 0a 20 Flags);. }..
d700: 20 20 20 2f 2a 20 41 74 20 74 68 69 73 20 70 6f /* At this po
d710: 69 6e 74 20 74 68 65 20 74 72 61 6e 73 61 63 74 int the transact
d720: 69 6f 6e 20 69 73 20 63 6f 6d 6d 69 74 74 65 64 ion is committed
d730: 20 62 75 74 20 74 68 65 20 77 72 69 74 65 20 6c but the write l
d740: 6f 63 6b 20 0a 20 20 20 20 2a 2a 20 69 73 20 73 ock . ** is s
d750: 74 69 6c 6c 20 68 65 6c 64 20 6f 6e 20 74 68 65 till held on the
d760: 20 66 69 6c 65 2e 20 49 66 20 74 68 65 72 65 20 file. If there
d770: 69 73 20 61 20 73 69 7a 65 20 6c 69 6d 69 74 20 is a size limit
d780: 63 6f 6e 66 69 67 75 72 65 64 20 66 6f 72 20 0a configured for .
d790: 20 20 20 20 2a 2a 20 74 68 65 20 70 65 72 73 69 ** the persi
d7a0: 73 74 65 6e 74 20 6a 6f 75 72 6e 61 6c 20 61 6e stent journal an
d7b0: 64 20 74 68 65 20 6a 6f 75 72 6e 61 6c 20 66 69 d the journal fi
d7c0: 6c 65 20 63 75 72 72 65 6e 74 6c 79 20 63 6f 6e le currently con
d7d0: 73 75 6d 65 73 20 6d 6f 72 65 0a 20 20 20 20 2a sumes more. *
d7e0: 2a 20 73 70 61 63 65 20 74 68 61 6e 20 74 68 61 * space than tha
d7f0: 74 20 6c 69 6d 69 74 20 61 6c 6c 6f 77 73 20 66 t limit allows f
d800: 6f 72 2c 20 74 72 75 6e 63 61 74 65 20 69 74 20 or, truncate it
d810: 6e 6f 77 2e 20 54 68 65 72 65 20 69 73 20 6e 6f now. There is no
d820: 20 6e 65 65 64 0a 20 20 20 20 2a 2a 20 74 6f 20 need. ** to
d830: 73 79 6e 63 20 74 68 65 20 66 69 6c 65 20 66 6f sync the file fo
d840: 6c 6c 6f 77 69 6e 67 20 74 68 69 73 20 6f 70 65 llowing this ope
d850: 72 61 74 69 6f 6e 2e 0a 20 20 20 20 2a 2f 0a 20 ration.. */.
d860: 20 20 20 69 66 28 20 72 63 3d 3d 53 51 4c 49 54 if( rc==SQLIT
d870: 45 5f 4f 4b 20 26 26 20 69 4c 69 6d 69 74 3e 30 E_OK && iLimit>0
d880: 20 29 7b 0a 20 20 20 20 20 20 69 36 34 20 73 7a ){. i64 sz
d890: 3b 0a 20 20 20 20 20 20 72 63 20 3d 20 73 71 6c ;. rc = sql
d8a0: 69 74 65 33 4f 73 46 69 6c 65 53 69 7a 65 28 70 ite3OsFileSize(p
d8b0: 50 61 67 65 72 2d 3e 6a 66 64 2c 20 26 73 7a 29 Pager->jfd, &sz)
d8c0: 3b 0a 20 20 20 20 20 20 69 66 28 20 72 63 3d 3d ;. if( rc==
d8d0: 53 51 4c 49 54 45 5f 4f 4b 20 26 26 20 73 7a 3e SQLITE_OK && sz>
d8e0: 69 4c 69 6d 69 74 20 29 7b 0a 20 20 20 20 20 20 iLimit ){.
d8f0: 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33 4f 73 rc = sqlite3Os
d900: 54 72 75 6e 63 61 74 65 28 70 50 61 67 65 72 2d Truncate(pPager-
d910: 3e 6a 66 64 2c 20 69 4c 69 6d 69 74 29 3b 0a 20 >jfd, iLimit);.
d920: 20 20 20 20 20 7d 0a 20 20 20 20 7d 0a 20 20 7d }. }. }
d930: 0a 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 7d 0a . return rc;.}.
d940: 0a 2f 2a 0a 2a 2a 20 54 68 65 20 6a 6f 75 72 6e ./*.** The journ
d950: 61 6c 20 66 69 6c 65 20 6d 75 73 74 20 62 65 20 al file must be
d960: 6f 70 65 6e 20 77 68 65 6e 20 74 68 69 73 20 72 open when this r
d970: 6f 75 74 69 6e 65 20 69 73 20 63 61 6c 6c 65 64 outine is called
d980: 2e 20 41 20 6a 6f 75 72 6e 61 6c 0a 2a 2a 20 68 . A journal.** h
d990: 65 61 64 65 72 20 28 4a 4f 55 52 4e 41 4c 5f 48 eader (JOURNAL_H
d9a0: 44 52 5f 53 5a 20 62 79 74 65 73 29 20 69 73 20 DR_SZ bytes) is
d9b0: 77 72 69 74 74 65 6e 20 69 6e 74 6f 20 74 68 65 written into the
d9c0: 20 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 20 61 74 journal file at
d9d0: 20 74 68 65 0a 2a 2a 20 63 75 72 72 65 6e 74 20 the.** current
d9e0: 6c 6f 63 61 74 69 6f 6e 2e 0a 2a 2a 0a 2a 2a 20 location..**.**
d9f0: 54 68 65 20 66 6f 72 6d 61 74 20 66 6f 72 20 74 The format for t
da00: 68 65 20 6a 6f 75 72 6e 61 6c 20 68 65 61 64 65 he journal heade
da10: 72 20 69 73 20 61 73 20 66 6f 6c 6c 6f 77 73 3a r is as follows:
da20: 0a 2a 2a 20 2d 20 38 20 62 79 74 65 73 3a 20 4d .** - 8 bytes: M
da30: 61 67 69 63 20 69 64 65 6e 74 69 66 79 69 6e 67 agic identifying
da40: 20 6a 6f 75 72 6e 61 6c 20 66 6f 72 6d 61 74 2e journal format.
da50: 0a 2a 2a 20 2d 20 34 20 62 79 74 65 73 3a 20 4e .** - 4 bytes: N
da60: 75 6d 62 65 72 20 6f 66 20 72 65 63 6f 72 64 73 umber of records
da70: 20 69 6e 20 6a 6f 75 72 6e 61 6c 2c 20 6f 72 20 in journal, or
da80: 2d 31 20 6e 6f 2d 73 79 6e 63 20 6d 6f 64 65 20 -1 no-sync mode
da90: 69 73 20 6f 6e 2e 0a 2a 2a 20 2d 20 34 20 62 79 is on..** - 4 by
daa0: 74 65 73 3a 20 52 61 6e 64 6f 6d 20 6e 75 6d 62 tes: Random numb
dab0: 65 72 20 75 73 65 64 20 66 6f 72 20 70 61 67 65 er used for page
dac0: 20 68 61 73 68 2e 0a 2a 2a 20 2d 20 34 20 62 79 hash..** - 4 by
dad0: 74 65 73 3a 20 49 6e 69 74 69 61 6c 20 64 61 74 tes: Initial dat
dae0: 61 62 61 73 65 20 70 61 67 65 20 63 6f 75 6e 74 abase page count
daf0: 2e 0a 2a 2a 20 2d 20 34 20 62 79 74 65 73 3a 20 ..** - 4 bytes:
db00: 53 65 63 74 6f 72 20 73 69 7a 65 20 75 73 65 64 Sector size used
db10: 20 62 79 20 74 68 65 20 70 72 6f 63 65 73 73 20 by the process
db20: 74 68 61 74 20 77 72 6f 74 65 20 74 68 69 73 20 that wrote this
db30: 6a 6f 75 72 6e 61 6c 2e 0a 2a 2a 20 2d 20 34 20 journal..** - 4
db40: 62 79 74 65 73 3a 20 44 61 74 61 62 61 73 65 20 bytes: Database
db50: 70 61 67 65 20 73 69 7a 65 2e 0a 2a 2a 20 0a 2a page size..** .*
db60: 2a 20 46 6f 6c 6c 6f 77 65 64 20 62 79 20 28 4a * Followed by (J
db70: 4f 55 52 4e 41 4c 5f 48 44 52 5f 53 5a 20 2d 20 OURNAL_HDR_SZ -
db80: 32 38 29 20 62 79 74 65 73 20 6f 66 20 75 6e 75 28) bytes of unu
db90: 73 65 64 20 73 70 61 63 65 2e 0a 2a 2f 0a 73 74 sed space..*/.st
dba0: 61 74 69 63 20 69 6e 74 20 77 72 69 74 65 4a 6f atic int writeJo
dbb0: 75 72 6e 61 6c 48 64 72 28 50 61 67 65 72 20 2a urnalHdr(Pager *
dbc0: 70 50 61 67 65 72 29 7b 0a 20 20 69 6e 74 20 72 pPager){. int r
dbd0: 63 20 3d 20 53 51 4c 49 54 45 5f 4f 4b 3b 20 20 c = SQLITE_OK;
dbe0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f /
dbf0: 2a 20 52 65 74 75 72 6e 20 63 6f 64 65 20 2a 2f * Return code */
dc00: 0a 20 20 63 68 61 72 20 2a 7a 48 65 61 64 65 72 . char *zHeader
dc10: 20 3d 20 70 50 61 67 65 72 2d 3e 70 54 6d 70 53 = pPager->pTmpS
dc20: 70 61 63 65 3b 20 20 2f 2a 20 54 65 6d 70 6f 72 pace; /* Tempor
dc30: 61 72 79 20 73 70 61 63 65 20 75 73 65 64 20 74 ary space used t
dc40: 6f 20 62 75 69 6c 64 20 68 65 61 64 65 72 20 2a o build header *
dc50: 2f 0a 20 20 75 33 32 20 6e 48 65 61 64 65 72 20 /. u32 nHeader
dc60: 3d 20 28 75 33 32 29 70 50 61 67 65 72 2d 3e 70 = (u32)pPager->p
dc70: 61 67 65 53 69 7a 65 3b 2f 2a 20 53 69 7a 65 20 ageSize;/* Size
dc80: 6f 66 20 62 75 66 66 65 72 20 70 6f 69 6e 74 65 of buffer pointe
dc90: 64 20 74 6f 20 62 79 20 7a 48 65 61 64 65 72 20 d to by zHeader
dca0: 2a 2f 0a 20 20 75 33 32 20 6e 57 72 69 74 65 3b */. u32 nWrite;
dcb0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
dcc0: 20 20 20 20 20 20 20 20 20 2f 2a 20 42 79 74 65 /* Byte
dcd0: 73 20 6f 66 20 68 65 61 64 65 72 20 73 65 63 74 s of header sect
dce0: 6f 72 20 77 72 69 74 74 65 6e 20 2a 2f 0a 20 20 or written */.
dcf0: 69 6e 74 20 69 69 3b 20 20 20 20 20 20 20 20 20 int ii;
dd00: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
dd10: 20 20 20 20 2f 2a 20 4c 6f 6f 70 20 63 6f 75 6e /* Loop coun
dd20: 74 65 72 20 2a 2f 0a 0a 20 20 61 73 73 65 72 74 ter */.. assert
dd30: 28 20 69 73 4f 70 65 6e 28 70 50 61 67 65 72 2d ( isOpen(pPager-
dd40: 3e 6a 66 64 29 20 29 3b 20 20 20 20 20 20 2f 2a >jfd) ); /*
dd50: 20 4a 6f 75 72 6e 61 6c 20 66 69 6c 65 20 6d 75 Journal file mu
dd60: 73 74 20 62 65 20 6f 70 65 6e 2e 20 2a 2f 0a 0a st be open. */..
dd70: 20 20 69 66 28 20 6e 48 65 61 64 65 72 3e 4a 4f if( nHeader>JO
dd80: 55 52 4e 41 4c 5f 48 44 52 5f 53 5a 28 70 50 61 URNAL_HDR_SZ(pPa
dd90: 67 65 72 29 20 29 7b 0a 20 20 20 20 6e 48 65 61 ger) ){. nHea
dda0: 64 65 72 20 3d 20 4a 4f 55 52 4e 41 4c 5f 48 44 der = JOURNAL_HD
ddb0: 52 5f 53 5a 28 70 50 61 67 65 72 29 3b 0a 20 20 R_SZ(pPager);.
ddc0: 7d 0a 0a 20 20 2f 2a 20 49 66 20 74 68 65 72 65 }.. /* If there
ddd0: 20 61 72 65 20 61 63 74 69 76 65 20 73 61 76 65 are active save
dde0: 70 6f 69 6e 74 73 20 61 6e 64 20 61 6e 79 20 6f points and any o
ddf0: 66 20 74 68 65 6d 20 77 65 72 65 20 63 72 65 61 f them were crea
de00: 74 65 64 20 0a 20 20 2a 2a 20 73 69 6e 63 65 20 ted . ** since
de10: 74 68 65 20 6d 6f 73 74 20 72 65 63 65 6e 74 20 the most recent
de20: 6a 6f 75 72 6e 61 6c 20 68 65 61 64 65 72 20 77 journal header w
de30: 61 73 20 77 72 69 74 74 65 6e 2c 20 75 70 64 61 as written, upda
de40: 74 65 20 74 68 65 20 0a 20 20 2a 2a 20 50 61 67 te the . ** Pag
de50: 65 72 53 61 76 65 70 6f 69 6e 74 2e 69 48 64 72 erSavepoint.iHdr
de60: 4f 66 66 73 65 74 20 66 69 65 6c 64 73 20 6e 6f Offset fields no
de70: 77 2e 0a 20 20 2a 2f 0a 20 20 66 6f 72 28 69 69 w.. */. for(ii
de80: 3d 30 3b 20 69 69 3c 70 50 61 67 65 72 2d 3e 6e =0; ii<pPager->n
de90: 53 61 76 65 70 6f 69 6e 74 3b 20 69 69 2b 2b 29 Savepoint; ii++)
dea0: 7b 0a 20 20 20 20 69 66 28 20 70 50 61 67 65 72 {. if( pPager
deb0: 2d 3e 61 53 61 76 65 70 6f 69 6e 74 5b 69 69 5d ->aSavepoint[ii]
dec0: 2e 69 48 64 72 4f 66 66 73 65 74 3d 3d 30 20 29 .iHdrOffset==0 )
ded0: 7b 0a 20 20 20 20 20 20 70 50 61 67 65 72 2d 3e {. pPager->
dee0: 61 53 61 76 65 70 6f 69 6e 74 5b 69 69 5d 2e 69 aSavepoint[ii].i
def0: 48 64 72 4f 66 66 73 65 74 20 3d 20 70 50 61 67 HdrOffset = pPag
df00: 65 72 2d 3e 6a 6f 75 72 6e 61 6c 4f 66 66 3b 0a er->journalOff;.
df10: 20 20 20 20 7d 0a 20 20 7d 0a 0a 20 20 70 50 61 }. }.. pPa
df20: 67 65 72 2d 3e 6a 6f 75 72 6e 61 6c 48 64 72 20 ger->journalHdr
df30: 3d 20 70 50 61 67 65 72 2d 3e 6a 6f 75 72 6e 61 = pPager->journa
df40: 6c 4f 66 66 20 3d 20 6a 6f 75 72 6e 61 6c 48 64 lOff = journalHd
df50: 72 4f 66 66 73 65 74 28 70 50 61 67 65 72 29 3b rOffset(pPager);
df60: 0a 0a 20 20 2f 2a 20 0a 20 20 2a 2a 20 57 72 69 .. /* . ** Wri
df70: 74 65 20 74 68 65 20 6e 52 65 63 20 46 69 65 6c te the nRec Fiel
df80: 64 20 2d 20 74 68 65 20 6e 75 6d 62 65 72 20 6f d - the number o
df90: 66 20 70 61 67 65 20 72 65 63 6f 72 64 73 20 74 f page records t
dfa0: 68 61 74 20 66 6f 6c 6c 6f 77 20 74 68 69 73 0a hat follow this.
dfb0: 20 20 2a 2a 20 6a 6f 75 72 6e 61 6c 20 68 65 61 ** journal hea
dfc0: 64 65 72 2e 20 4e 6f 72 6d 61 6c 6c 79 2c 20 7a der. Normally, z
dfd0: 65 72 6f 20 69 73 20 77 72 69 74 74 65 6e 20 74 ero is written t
dfe0: 6f 20 74 68 69 73 20 76 61 6c 75 65 20 61 74 20 o this value at
dff0: 74 68 69 73 20 74 69 6d 65 2e 0a 20 20 2a 2a 20 this time.. **
e000: 41 66 74 65 72 20 74 68 65 20 72 65 63 6f 72 64 After the record
e010: 73 20 61 72 65 20 61 64 64 65 64 20 74 6f 20 74 s are added to t
e020: 68 65 20 6a 6f 75 72 6e 61 6c 20 28 61 6e 64 20 he journal (and
e030: 74 68 65 20 6a 6f 75 72 6e 61 6c 20 73 79 6e 63 the journal sync
e040: 65 64 2c 20 0a 20 20 2a 2a 20 69 66 20 69 6e 20 ed, . ** if in
e050: 66 75 6c 6c 2d 73 79 6e 63 20 6d 6f 64 65 29 2c full-sync mode),
e060: 20 74 68 65 20 7a 65 72 6f 20 69 73 20 6f 76 65 the zero is ove
e070: 72 77 72 69 74 74 65 6e 20 77 69 74 68 20 74 68 rwritten with th
e080: 65 20 74 72 75 65 20 6e 75 6d 62 65 72 0a 20 20 e true number.
e090: 2a 2a 20 6f 66 20 72 65 63 6f 72 64 73 20 28 73 ** of records (s
e0a0: 65 65 20 73 79 6e 63 4a 6f 75 72 6e 61 6c 28 29 ee syncJournal()
e0b0: 29 2e 0a 20 20 2a 2a 0a 20 20 2a 2a 20 41 20 66 ).. **. ** A f
e0c0: 61 73 74 65 72 20 61 6c 74 65 72 6e 61 74 69 76 aster alternativ
e0d0: 65 20 69 73 20 74 6f 20 77 72 69 74 65 20 30 78 e is to write 0x
e0e0: 46 46 46 46 46 46 46 46 20 74 6f 20 74 68 65 20 FFFFFFFF to the
e0f0: 6e 52 65 63 20 66 69 65 6c 64 2e 20 57 68 65 6e nRec field. When
e100: 0a 20 20 2a 2a 20 72 65 61 64 69 6e 67 20 74 68 . ** reading th
e110: 65 20 6a 6f 75 72 6e 61 6c 20 74 68 69 73 20 76 e journal this v
e120: 61 6c 75 65 20 74 65 6c 6c 73 20 53 51 4c 69 74 alue tells SQLit
e130: 65 20 74 6f 20 61 73 73 75 6d 65 20 74 68 61 74 e to assume that
e140: 20 74 68 65 0a 20 20 2a 2a 20 72 65 73 74 20 6f the. ** rest o
e150: 66 20 74 68 65 20 6a 6f 75 72 6e 61 6c 20 66 69 f the journal fi
e160: 6c 65 20 63 6f 6e 74 61 69 6e 73 20 76 61 6c 69 le contains vali
e170: 64 20 70 61 67 65 20 72 65 63 6f 72 64 73 2e 20 d page records.
e180: 54 68 69 73 20 61 73 73 75 6d 70 74 69 6f 6e 0a This assumption.
e190: 20 20 2a 2a 20 69 73 20 64 61 6e 67 65 72 6f 75 ** is dangerou
e1a0: 73 2c 20 61 73 20 69 66 20 61 20 66 61 69 6c 75 s, as if a failu
e1b0: 72 65 20 6f 63 63 75 72 72 65 64 20 77 68 69 6c re occurred whil
e1c0: 73 74 20 77 72 69 74 69 6e 67 20 74 6f 20 74 68 st writing to th
e1d0: 65 20 6a 6f 75 72 6e 61 6c 0a 20 20 2a 2a 20 66 e journal. ** f
e1e0: 69 6c 65 20 69 74 20 6d 61 79 20 63 6f 6e 74 61 ile it may conta
e1f0: 69 6e 20 73 6f 6d 65 20 67 61 72 62 61 67 65 20 in some garbage
e200: 64 61 74 61 2e 20 54 68 65 72 65 20 61 72 65 20 data. There are
e210: 74 77 6f 20 73 63 65 6e 61 72 69 6f 73 0a 20 20 two scenarios.
e220: 2a 2a 20 77 68 65 72 65 20 74 68 69 73 20 72 69 ** where this ri
e230: 73 6b 20 63 61 6e 20 62 65 20 69 67 6e 6f 72 65 sk can be ignore
e240: 64 3a 0a 20 20 2a 2a 0a 20 20 2a 2a 20 20 20 2a d:. **. ** *
e250: 20 57 68 65 6e 20 74 68 65 20 70 61 67 65 72 20 When the pager
e260: 69 73 20 69 6e 20 6e 6f 2d 73 79 6e 63 20 6d 6f is in no-sync mo
e270: 64 65 2e 20 43 6f 72 72 75 70 74 69 6f 6e 20 63 de. Corruption c
e280: 61 6e 20 66 6f 6c 6c 6f 77 20 61 0a 20 20 2a 2a an follow a. **
e290: 20 20 20 20 20 70 6f 77 65 72 20 66 61 69 6c 75 power failu
e2a0: 72 65 20 69 6e 20 74 68 69 73 20 63 61 73 65 20 re in this case
e2b0: 61 6e 79 77 61 79 2e 0a 20 20 2a 2a 0a 20 20 2a anyway.. **. *
e2c0: 2a 20 20 20 2a 20 57 68 65 6e 20 74 68 65 20 53 * * When the S
e2d0: 51 4c 49 54 45 5f 49 4f 43 41 50 5f 53 41 46 45 QLITE_IOCAP_SAFE
e2e0: 5f 41 50 50 45 4e 44 20 66 6c 61 67 20 69 73 20 _APPEND flag is
e2f0: 73 65 74 2e 20 54 68 69 73 20 67 75 61 72 61 6e set. This guaran
e300: 74 65 65 73 0a 20 20 2a 2a 20 20 20 20 20 74 68 tees. ** th
e310: 61 74 20 67 61 72 62 61 67 65 20 64 61 74 61 20 at garbage data
e320: 69 73 20 6e 65 76 65 72 20 61 70 70 65 6e 64 65 is never appende
e330: 64 20 74 6f 20 74 68 65 20 6a 6f 75 72 6e 61 6c d to the journal
e340: 20 66 69 6c 65 2e 0a 20 20 2a 2f 0a 20 20 61 73 file.. */. as
e350: 73 65 72 74 28 20 69 73 4f 70 65 6e 28 70 50 61 sert( isOpen(pPa
e360: 67 65 72 2d 3e 66 64 29 20 7c 7c 20 70 50 61 67 ger->fd) || pPag
e370: 65 72 2d 3e 6e 6f 53 79 6e 63 20 29 3b 0a 20 20 er->noSync );.
e380: 69 66 28 20 70 50 61 67 65 72 2d 3e 6e 6f 53 79 if( pPager->noSy
e390: 6e 63 20 7c 7c 20 28 70 50 61 67 65 72 2d 3e 6a nc || (pPager->j
e3a0: 6f 75 72 6e 61 6c 4d 6f 64 65 3d 3d 50 41 47 45 ournalMode==PAGE
e3b0: 52 5f 4a 4f 55 52 4e 41 4c 4d 4f 44 45 5f 4d 45 R_JOURNALMODE_ME
e3c0: 4d 4f 52 59 29 0a 20 20 20 7c 7c 20 28 73 71 6c MORY). || (sql
e3d0: 69 74 65 33 4f 73 44 65 76 69 63 65 43 68 61 72 ite3OsDeviceChar
e3e0: 61 63 74 65 72 69 73 74 69 63 73 28 70 50 61 67 acteristics(pPag
e3f0: 65 72 2d 3e 66 64 29 26 53 51 4c 49 54 45 5f 49 er->fd)&SQLITE_I
e400: 4f 43 41 50 5f 53 41 46 45 5f 41 50 50 45 4e 44 OCAP_SAFE_APPEND
e410: 29 20 0a 20 20 29 7b 0a 20 20 20 20 6d 65 6d 63 ) . ){. memc
e420: 70 79 28 7a 48 65 61 64 65 72 2c 20 61 4a 6f 75 py(zHeader, aJou
e430: 72 6e 61 6c 4d 61 67 69 63 2c 20 73 69 7a 65 6f rnalMagic, sizeo
e440: 66 28 61 4a 6f 75 72 6e 61 6c 4d 61 67 69 63 29 f(aJournalMagic)
e450: 29 3b 0a 20 20 20 20 70 75 74 33 32 62 69 74 73 );. put32bits
e460: 28 26 7a 48 65 61 64 65 72 5b 73 69 7a 65 6f 66 (&zHeader[sizeof
e470: 28 61 4a 6f 75 72 6e 61 6c 4d 61 67 69 63 29 5d (aJournalMagic)]
e480: 2c 20 30 78 66 66 66 66 66 66 66 66 29 3b 0a 20 , 0xffffffff);.
e490: 20 7d 65 6c 73 65 7b 0a 20 20 20 20 6d 65 6d 73 }else{. mems
e4a0: 65 74 28 7a 48 65 61 64 65 72 2c 20 30 2c 20 73 et(zHeader, 0, s
e4b0: 69 7a 65 6f 66 28 61 4a 6f 75 72 6e 61 6c 4d 61 izeof(aJournalMa
e4c0: 67 69 63 29 2b 34 29 3b 0a 20 20 7d 0a 0a 20 20 gic)+4);. }..
e4d0: 2f 2a 20 54 68 65 20 72 61 6e 64 6f 6d 20 63 68 /* The random ch
e4e0: 65 63 6b 2d 68 61 73 68 20 69 6e 69 74 69 61 6c eck-hash initial
e4f0: 69 73 65 72 20 2a 2f 20 0a 20 20 73 71 6c 69 74 iser */ . sqlit
e500: 65 33 5f 72 61 6e 64 6f 6d 6e 65 73 73 28 73 69 e3_randomness(si
e510: 7a 65 6f 66 28 70 50 61 67 65 72 2d 3e 63 6b 73 zeof(pPager->cks
e520: 75 6d 49 6e 69 74 29 2c 20 26 70 50 61 67 65 72 umInit), &pPager
e530: 2d 3e 63 6b 73 75 6d 49 6e 69 74 29 3b 0a 20 20 ->cksumInit);.
e540: 70 75 74 33 32 62 69 74 73 28 26 7a 48 65 61 64 put32bits(&zHead
e550: 65 72 5b 73 69 7a 65 6f 66 28 61 4a 6f 75 72 6e er[sizeof(aJourn
e560: 61 6c 4d 61 67 69 63 29 2b 34 5d 2c 20 70 50 61 alMagic)+4], pPa
e570: 67 65 72 2d 3e 63 6b 73 75 6d 49 6e 69 74 29 3b ger->cksumInit);
e580: 0a 20 20 2f 2a 20 54 68 65 20 69 6e 69 74 69 61 . /* The initia
e590: 6c 20 64 61 74 61 62 61 73 65 20 73 69 7a 65 20 l database size
e5a0: 2a 2f 0a 20 20 70 75 74 33 32 62 69 74 73 28 26 */. put32bits(&
e5b0: 7a 48 65 61 64 65 72 5b 73 69 7a 65 6f 66 28 61 zHeader[sizeof(a
e5c0: 4a 6f 75 72 6e 61 6c 4d 61 67 69 63 29 2b 38 5d JournalMagic)+8]
e5d0: 2c 20 70 50 61 67 65 72 2d 3e 64 62 4f 72 69 67 , pPager->dbOrig
e5e0: 53 69 7a 65 29 3b 0a 20 20 2f 2a 20 54 68 65 20 Size);. /* The
e5f0: 61 73 73 75 6d 65 64 20 73 65 63 74 6f 72 20 73 assumed sector s
e600: 69 7a 65 20 66 6f 72 20 74 68 69 73 20 70 72 6f ize for this pro
e610: 63 65 73 73 20 2a 2f 0a 20 20 70 75 74 33 32 62 cess */. put32b
e620: 69 74 73 28 26 7a 48 65 61 64 65 72 5b 73 69 7a its(&zHeader[siz
e630: 65 6f 66 28 61 4a 6f 75 72 6e 61 6c 4d 61 67 69 eof(aJournalMagi
e640: 63 29 2b 31 32 5d 2c 20 70 50 61 67 65 72 2d 3e c)+12], pPager->
e650: 73 65 63 74 6f 72 53 69 7a 65 29 3b 0a 0a 20 20 sectorSize);..
e660: 2f 2a 20 54 68 65 20 70 61 67 65 20 73 69 7a 65 /* The page size
e670: 20 2a 2f 0a 20 20 70 75 74 33 32 62 69 74 73 28 */. put32bits(
e680: 26 7a 48 65 61 64 65 72 5b 73 69 7a 65 6f 66 28 &zHeader[sizeof(
e690: 61 4a 6f 75 72 6e 61 6c 4d 61 67 69 63 29 2b 31 aJournalMagic)+1
e6a0: 36 5d 2c 20 70 50 61 67 65 72 2d 3e 70 61 67 65 6], pPager->page
e6b0: 53 69 7a 65 29 3b 0a 0a 20 20 2f 2a 20 49 6e 69 Size);.. /* Ini
e6c0: 74 69 61 6c 69 7a 69 6e 67 20 74 68 65 20 74 61 tializing the ta
e6d0: 69 6c 20 6f 66 20 74 68 65 20 62 75 66 66 65 72 il of the buffer
e6e0: 20 69 73 20 6e 6f 74 20 6e 65 63 65 73 73 61 72 is not necessar
e6f0: 79 2e 20 20 45 76 65 72 79 74 68 69 6e 67 0a 20 y. Everything.
e700: 20 2a 2a 20 77 6f 72 6b 73 20 66 69 6e 64 20 69 ** works find i
e710: 66 20 74 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 f the following
e720: 6d 65 6d 73 65 74 28 29 20 69 73 20 6f 6d 69 74 memset() is omit
e730: 74 65 64 2e 20 20 42 75 74 20 69 6e 69 74 69 61 ted. But initia
e740: 6c 69 7a 69 6e 67 0a 20 20 2a 2a 20 74 68 65 20 lizing. ** the
e750: 6d 65 6d 6f 72 79 20 70 72 65 76 65 6e 74 73 20 memory prevents
e760: 76 61 6c 67 72 69 6e 64 20 66 72 6f 6d 20 63 6f valgrind from co
e770: 6d 70 6c 61 69 6e 69 6e 67 2c 20 73 6f 20 77 65 mplaining, so we
e780: 20 61 72 65 20 77 69 6c 6c 69 6e 67 20 74 6f 0a are willing to.
e790: 20 20 2a 2a 20 74 61 6b 65 20 74 68 65 20 70 65 ** take the pe
e7a0: 72 66 6f 72 6d 61 6e 63 65 20 68 69 74 2e 0a 20 rformance hit..
e7b0: 20 2a 2f 0a 20 20 6d 65 6d 73 65 74 28 26 7a 48 */. memset(&zH
e7c0: 65 61 64 65 72 5b 73 69 7a 65 6f 66 28 61 4a 6f eader[sizeof(aJo
e7d0: 75 72 6e 61 6c 4d 61 67 69 63 29 2b 32 30 5d 2c urnalMagic)+20],
e7e0: 20 30 2c 0a 20 20 20 20 20 20 20 20 20 6e 48 65 0,. nHe
e7f0: 61 64 65 72 2d 28 73 69 7a 65 6f 66 28 61 4a 6f ader-(sizeof(aJo
e800: 75 72 6e 61 6c 4d 61 67 69 63 29 2b 32 30 29 29 urnalMagic)+20))
e810: 3b 0a 0a 20 20 2f 2a 20 49 6e 20 74 68 65 6f 72 ;.. /* In theor
e820: 79 2c 20 69 74 20 69 73 20 6f 6e 6c 79 20 6e 65 y, it is only ne
e830: 63 65 73 73 61 72 79 20 74 6f 20 77 72 69 74 65 cessary to write
e840: 20 74 68 65 20 32 38 20 62 79 74 65 73 20 74 68 the 28 bytes th
e850: 61 74 20 74 68 65 20 0a 20 20 2a 2a 20 6a 6f 75 at the . ** jou
e860: 72 6e 61 6c 20 68 65 61 64 65 72 20 63 6f 6e 73 rnal header cons
e870: 75 6d 65 73 20 74 6f 20 74 68 65 20 6a 6f 75 72 umes to the jour
e880: 6e 61 6c 20 66 69 6c 65 20 68 65 72 65 2e 20 54 nal file here. T
e890: 68 65 6e 20 69 6e 63 72 65 6d 65 6e 74 20 74 68 hen increment th
e8a0: 65 20 0a 20 20 2a 2a 20 50 61 67 65 72 2e 6a 6f e . ** Pager.jo
e8b0: 75 72 6e 61 6c 4f 66 66 20 76 61 72 69 61 62 6c urnalOff variabl
e8c0: 65 20 62 79 20 4a 4f 55 52 4e 41 4c 5f 48 44 52 e by JOURNAL_HDR
e8d0: 5f 53 5a 20 73 6f 20 74 68 61 74 20 74 68 65 20 _SZ so that the
e8e0: 6e 65 78 74 20 0a 20 20 2a 2a 20 72 65 63 6f 72 next . ** recor
e8f0: 64 20 69 73 20 77 72 69 74 74 65 6e 20 74 6f 20 d is written to
e900: 74 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 73 65 the following se
e910: 63 74 6f 72 20 28 6c 65 61 76 69 6e 67 20 61 20 ctor (leaving a
e920: 67 61 70 20 69 6e 20 74 68 65 20 66 69 6c 65 0a gap in the file.
e930: 20 20 2a 2a 20 74 68 61 74 20 77 69 6c 6c 20 62 ** that will b
e940: 65 20 69 6d 70 6c 69 63 69 74 6c 79 20 66 69 6c e implicitly fil
e950: 6c 65 64 20 69 6e 20 62 79 20 74 68 65 20 4f 53 led in by the OS
e960: 29 2e 0a 20 20 2a 2a 0a 20 20 2a 2a 20 48 6f 77 ).. **. ** How
e970: 65 76 65 72 20 69 74 20 68 61 73 20 62 65 65 6e ever it has been
e980: 20 64 69 73 63 6f 76 65 72 65 64 20 74 68 61 74 discovered that
e990: 20 6f 6e 20 73 6f 6d 65 20 73 79 73 74 65 6d 73 on some systems
e9a0: 20 74 68 69 73 20 70 61 74 74 65 72 6e 20 63 61 this pattern ca
e9b0: 6e 20 0a 20 20 2a 2a 20 62 65 20 73 69 67 6e 69 n . ** be signi
e9c0: 66 69 63 61 6e 74 6c 79 20 73 6c 6f 77 65 72 20 ficantly slower
e9d0: 74 68 61 6e 20 63 6f 6e 74 69 67 75 6f 75 73 6c than contiguousl
e9e0: 79 20 77 72 69 74 69 6e 67 20 64 61 74 61 20 74 y writing data t
e9f0: 6f 20 74 68 65 20 66 69 6c 65 2c 0a 20 20 2a 2a o the file,. **
ea00: 20 65 76 65 6e 20 69 66 20 74 68 61 74 20 6d 65 even if that me
ea10: 61 6e 73 20 65 78 70 6c 69 63 69 74 6c 79 20 77 ans explicitly w
ea20: 72 69 74 69 6e 67 20 64 61 74 61 20 74 6f 20 74 riting data to t
ea30: 68 65 20 62 6c 6f 63 6b 20 6f 66 20 0a 20 20 2a he block of . *
ea40: 2a 20 28 4a 4f 55 52 4e 41 4c 5f 48 44 52 5f 53 * (JOURNAL_HDR_S
ea50: 5a 20 2d 20 32 38 29 20 62 79 74 65 73 20 74 68 Z - 28) bytes th
ea60: 61 74 20 77 69 6c 6c 20 6e 6f 74 20 62 65 20 75 at will not be u
ea70: 73 65 64 2e 20 53 6f 20 74 68 61 74 20 69 73 20 sed. So that is
ea80: 77 68 61 74 0a 20 20 2a 2a 20 69 73 20 64 6f 6e what. ** is don
ea90: 65 2e 20 0a 20 20 2a 2a 0a 20 20 2a 2a 20 54 68 e. . **. ** Th
eaa0: 65 20 6c 6f 6f 70 20 69 73 20 72 65 71 75 69 72 e loop is requir
eab0: 65 64 20 68 65 72 65 20 69 6e 20 63 61 73 65 20 ed here in case
eac0: 74 68 65 20 73 65 63 74 6f 72 2d 73 69 7a 65 20 the sector-size
ead0: 69 73 20 6c 61 72 67 65 72 20 74 68 61 6e 20 74 is larger than t
eae0: 68 65 20 0a 20 20 2a 2a 20 64 61 74 61 62 61 73 he . ** databas
eaf0: 65 20 70 61 67 65 20 73 69 7a 65 2e 20 53 69 6e e page size. Sin
eb00: 63 65 20 74 68 65 20 7a 48 65 61 64 65 72 20 62 ce the zHeader b
eb10: 75 66 66 65 72 20 69 73 20 6f 6e 6c 79 20 50 61 uffer is only Pa
eb20: 67 65 72 2e 70 61 67 65 53 69 7a 65 0a 20 20 2a ger.pageSize. *
eb30: 2a 20 62 79 74 65 73 20 69 6e 20 73 69 7a 65 2c * bytes in size,
eb40: 20 6d 6f 72 65 20 74 68 61 6e 20 6f 6e 65 20 63 more than one c
eb50: 61 6c 6c 20 74 6f 20 73 71 6c 69 74 65 33 4f 73 all to sqlite3Os
eb60: 57 72 69 74 65 28 29 20 6d 61 79 20 62 65 20 72 Write() may be r
eb70: 65 71 75 69 72 65 64 0a 20 20 2a 2a 20 74 6f 20 equired. ** to
eb80: 70 6f 70 75 6c 61 74 65 20 74 68 65 20 65 6e 74 populate the ent
eb90: 69 72 65 20 6a 6f 75 72 6e 61 6c 20 68 65 61 64 ire journal head
eba0: 65 72 20 73 65 63 74 6f 72 2e 0a 20 20 2a 2f 20 er sector.. */
ebb0: 0a 20 20 66 6f 72 28 6e 57 72 69 74 65 3d 30 3b . for(nWrite=0;
ebc0: 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b 26 26 rc==SQLITE_OK&&
ebd0: 6e 57 72 69 74 65 3c 4a 4f 55 52 4e 41 4c 5f 48 nWrite<JOURNAL_H
ebe0: 44 52 5f 53 5a 28 70 50 61 67 65 72 29 3b 20 6e DR_SZ(pPager); n
ebf0: 57 72 69 74 65 2b 3d 6e 48 65 61 64 65 72 29 7b Write+=nHeader){
ec00: 0a 20 20 20 20 49 4f 54 52 41 43 45 28 28 22 4a . IOTRACE(("J
ec10: 48 44 52 20 25 70 20 25 6c 6c 64 20 25 64 5c 6e HDR %p %lld %d\n
ec20: 22 2c 20 70 50 61 67 65 72 2c 20 70 50 61 67 65 ", pPager, pPage
ec30: 72 2d 3e 6a 6f 75 72 6e 61 6c 48 64 72 2c 20 6e r->journalHdr, n
ec40: 48 65 61 64 65 72 29 29 0a 20 20 20 20 72 63 20 Header)). rc
ec50: 3d 20 73 71 6c 69 74 65 33 4f 73 57 72 69 74 65 = sqlite3OsWrite
ec60: 28 70 50 61 67 65 72 2d 3e 6a 66 64 2c 20 7a 48 (pPager->jfd, zH
ec70: 65 61 64 65 72 2c 20 6e 48 65 61 64 65 72 2c 20 eader, nHeader,
ec80: 70 50 61 67 65 72 2d 3e 6a 6f 75 72 6e 61 6c 4f pPager->journalO
ec90: 66 66 29 3b 0a 20 20 20 20 61 73 73 65 72 74 28 ff);. assert(
eca0: 20 70 50 61 67 65 72 2d 3e 6a 6f 75 72 6e 61 6c pPager->journal
ecb0: 48 64 72 20 3c 3d 20 70 50 61 67 65 72 2d 3e 6a Hdr <= pPager->j
ecc0: 6f 75 72 6e 61 6c 4f 66 66 20 29 3b 0a 20 20 20 ournalOff );.
ecd0: 20 70 50 61 67 65 72 2d 3e 6a 6f 75 72 6e 61 6c pPager->journal
ece0: 4f 66 66 20 2b 3d 20 6e 48 65 61 64 65 72 3b 0a Off += nHeader;.
ecf0: 20 20 7d 0a 0a 20 20 72 65 74 75 72 6e 20 72 63 }.. return rc
ed00: 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 54 68 65 20 6a ;.}../*.** The j
ed10: 6f 75 72 6e 61 6c 20 66 69 6c 65 20 6d 75 73 74 ournal file must
ed20: 20 62 65 20 6f 70 65 6e 20 77 68 65 6e 20 74 68 be open when th
ed30: 69 73 20 69 73 20 63 61 6c 6c 65 64 2e 20 41 20 is is called. A
ed40: 6a 6f 75 72 6e 61 6c 20 68 65 61 64 65 72 20 66 journal header f
ed50: 69 6c 65 0a 2a 2a 20 28 4a 4f 55 52 4e 41 4c 5f ile.** (JOURNAL_
ed60: 48 44 52 5f 53 5a 20 62 79 74 65 73 29 20 69 73 HDR_SZ bytes) is
ed70: 20 72 65 61 64 20 66 72 6f 6d 20 74 68 65 20 63 read from the c
ed80: 75 72 72 65 6e 74 20 6c 6f 63 61 74 69 6f 6e 20 urrent location
ed90: 69 6e 20 74 68 65 20 6a 6f 75 72 6e 61 6c 0a 2a in the journal.*
eda0: 2a 20 66 69 6c 65 2e 20 54 68 65 20 63 75 72 72 * file. The curr
edb0: 65 6e 74 20 6c 6f 63 61 74 69 6f 6e 20 69 6e 20 ent location in
edc0: 74 68 65 20 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 the journal file
edd0: 20 69 73 20 67 69 76 65 6e 20 62 79 0a 2a 2a 20 is given by.**
ede0: 70 50 61 67 65 72 2d 3e 6a 6f 75 72 6e 61 6c 4f pPager->journalO
edf0: 66 66 2e 20 53 65 65 20 63 6f 6d 6d 65 6e 74 73 ff. See comments
ee00: 20 61 62 6f 76 65 20 66 75 6e 63 74 69 6f 6e 20 above function
ee10: 77 72 69 74 65 4a 6f 75 72 6e 61 6c 48 64 72 28 writeJournalHdr(
ee20: 29 20 66 6f 72 0a 2a 2a 20 61 20 64 65 73 63 72 ) for.** a descr
ee30: 69 70 74 69 6f 6e 20 6f 66 20 74 68 65 20 6a 6f iption of the jo
ee40: 75 72 6e 61 6c 20 68 65 61 64 65 72 20 66 6f 72 urnal header for
ee50: 6d 61 74 2e 0a 2a 2a 0a 2a 2a 20 49 66 20 74 68 mat..**.** If th
ee60: 65 20 68 65 61 64 65 72 20 69 73 20 72 65 61 64 e header is read
ee70: 20 73 75 63 63 65 73 73 66 75 6c 6c 79 2c 20 2a successfully, *
ee80: 70 4e 52 65 63 20 69 73 20 73 65 74 20 74 6f 20 pNRec is set to
ee90: 74 68 65 20 6e 75 6d 62 65 72 20 6f 66 0a 2a 2a the number of.**
eea0: 20 70 61 67 65 20 72 65 63 6f 72 64 73 20 66 6f page records fo
eeb0: 6c 6c 6f 77 69 6e 67 20 74 68 69 73 20 68 65 61 llowing this hea
eec0: 64 65 72 20 61 6e 64 20 2a 70 44 62 53 69 7a 65 der and *pDbSize
eed0: 20 69 73 20 73 65 74 20 74 6f 20 74 68 65 20 73 is set to the s
eee0: 69 7a 65 20 6f 66 20 74 68 65 0a 2a 2a 20 64 61 ize of the.** da
eef0: 74 61 62 61 73 65 20 62 65 66 6f 72 65 20 74 68 tabase before th
ef00: 65 20 74 72 61 6e 73 61 63 74 69 6f 6e 20 62 65 e transaction be
ef10: 67 61 6e 2c 20 69 6e 20 70 61 67 65 73 2e 20 41 gan, in pages. A
ef20: 6c 73 6f 2c 20 70 50 61 67 65 72 2d 3e 63 6b 73 lso, pPager->cks
ef30: 75 6d 49 6e 69 74 0a 2a 2a 20 69 73 20 73 65 74 umInit.** is set
ef40: 20 74 6f 20 74 68 65 20 76 61 6c 75 65 20 72 65 to the value re
ef50: 61 64 20 66 72 6f 6d 20 74 68 65 20 6a 6f 75 72 ad from the jour
ef60: 6e 61 6c 20 68 65 61 64 65 72 2e 20 53 51 4c 49 nal header. SQLI
ef70: 54 45 5f 4f 4b 20 69 73 20 72 65 74 75 72 6e 65 TE_OK is returne
ef80: 64 0a 2a 2a 20 69 6e 20 74 68 69 73 20 63 61 73 d.** in this cas
ef90: 65 2e 0a 2a 2a 0a 2a 2a 20 49 66 20 74 68 65 20 e..**.** If the
efa0: 6a 6f 75 72 6e 61 6c 20 68 65 61 64 65 72 20 66 journal header f
efb0: 69 6c 65 20 61 70 70 65 61 72 73 20 74 6f 20 62 ile appears to b
efc0: 65 20 63 6f 72 72 75 70 74 65 64 2c 20 53 51 4c e corrupted, SQL
efd0: 49 54 45 5f 44 4f 4e 45 20 69 73 0a 2a 2a 20 72 ITE_DONE is.** r
efe0: 65 74 75 72 6e 65 64 20 61 6e 64 20 2a 70 4e 52 eturned and *pNR
eff0: 65 63 20 61 6e 64 20 2a 50 44 62 53 69 7a 65 20 ec and *PDbSize
f000: 61 72 65 20 75 6e 64 65 66 69 6e 65 64 2e 20 20 are undefined.
f010: 49 66 20 4a 4f 55 52 4e 41 4c 5f 48 44 52 5f 53 If JOURNAL_HDR_S
f020: 5a 20 62 79 74 65 73 0a 2a 2a 20 63 61 6e 6e 6f Z bytes.** canno
f030: 74 20 62 65 20 72 65 61 64 20 66 72 6f 6d 20 74 t be read from t
f040: 68 65 20 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 20 he journal file
f050: 61 6e 20 65 72 72 6f 72 20 63 6f 64 65 20 69 73 an error code is
f060: 20 72 65 74 75 72 6e 65 64 2e 0a 2a 2f 0a 73 74 returned..*/.st
f070: 61 74 69 63 20 69 6e 74 20 72 65 61 64 4a 6f 75 atic int readJou
f080: 72 6e 61 6c 48 64 72 28 0a 20 20 50 61 67 65 72 rnalHdr(. Pager
f090: 20 2a 70 50 61 67 65 72 2c 20 20 20 20 20 20 20 *pPager,
f0a0: 20 20 20 20 20 20 20 20 2f 2a 20 50 61 67 65 72 /* Pager
f0b0: 20 6f 62 6a 65 63 74 20 2a 2f 0a 20 20 69 6e 74 object */. int
f0c0: 20 69 73 48 6f 74 2c 0a 20 20 69 36 34 20 6a 6f isHot,. i64 jo
f0d0: 75 72 6e 61 6c 53 69 7a 65 2c 20 20 20 20 20 20 urnalSize,
f0e0: 20 20 20 20 20 20 20 2f 2a 20 53 69 7a 65 20 6f /* Size o
f0f0: 66 20 74 68 65 20 6f 70 65 6e 20 6a 6f 75 72 6e f the open journ
f100: 61 6c 20 66 69 6c 65 20 69 6e 20 62 79 74 65 73 al file in bytes
f110: 20 2a 2f 0a 20 20 75 33 32 20 2a 70 4e 52 65 63 */. u32 *pNRec
f120: 2c 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 ,
f130: 20 20 20 2f 2a 20 4f 55 54 3a 20 56 61 6c 75 65 /* OUT: Value
f140: 20 72 65 61 64 20 66 72 6f 6d 20 74 68 65 20 6e read from the n
f150: 52 65 63 20 66 69 65 6c 64 20 2a 2f 0a 20 20 75 Rec field */. u
f160: 33 32 20 2a 70 44 62 53 69 7a 65 20 20 20 20 20 32 *pDbSize
f170: 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4f /* O
f180: 55 54 3a 20 56 61 6c 75 65 20 6f 66 20 6f 72 69 UT: Value of ori
f190: 67 69 6e 61 6c 20 64 61 74 61 62 61 73 65 20 73 ginal database s
f1a0: 69 7a 65 20 66 69 65 6c 64 20 2a 2f 0a 29 7b 0a ize field */.){.
f1b0: 20 20 69 6e 74 20 72 63 3b 20 20 20 20 20 20 20 int rc;
f1c0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f /
f1d0: 2a 20 52 65 74 75 72 6e 20 63 6f 64 65 20 2a 2f * Return code */
f1e0: 0a 20 20 75 6e 73 69 67 6e 65 64 20 63 68 61 72 . unsigned char
f1f0: 20 61 4d 61 67 69 63 5b 38 5d 3b 20 20 20 20 20 aMagic[8];
f200: 2f 2a 20 41 20 62 75 66 66 65 72 20 74 6f 20 68 /* A buffer to h
f210: 6f 6c 64 20 74 68 65 20 6d 61 67 69 63 20 68 65 old the magic he
f220: 61 64 65 72 20 2a 2f 0a 20 20 69 36 34 20 69 48 ader */. i64 iH
f230: 64 72 4f 66 66 3b 20 20 20 20 20 20 20 20 20 20 drOff;
f240: 20 20 20 20 20 20 20 2f 2a 20 4f 66 66 73 65 74 /* Offset
f250: 20 6f 66 20 6a 6f 75 72 6e 61 6c 20 68 65 61 64 of journal head
f260: 65 72 20 62 65 69 6e 67 20 72 65 61 64 20 2a 2f er being read */
f270: 0a 0a 20 20 61 73 73 65 72 74 28 20 69 73 4f 70 .. assert( isOp
f280: 65 6e 28 70 50 61 67 65 72 2d 3e 6a 66 64 29 20 en(pPager->jfd)
f290: 29 3b 20 20 20 20 20 20 2f 2a 20 4a 6f 75 72 6e ); /* Journ
f2a0: 61 6c 20 66 69 6c 65 20 6d 75 73 74 20 62 65 20 al file must be
f2b0: 6f 70 65 6e 2e 20 2a 2f 0a 0a 20 20 2f 2a 20 41 open. */.. /* A
f2c0: 64 76 61 6e 63 65 20 50 61 67 65 72 2e 6a 6f 75 dvance Pager.jou
f2d0: 72 6e 61 6c 4f 66 66 20 74 6f 20 74 68 65 20 73 rnalOff to the s
f2e0: 74 61 72 74 20 6f 66 20 74 68 65 20 6e 65 78 74 tart of the next
f2f0: 20 73 65 63 74 6f 72 2e 20 49 66 20 74 68 65 0a sector. If the.
f300: 20 20 2a 2a 20 6a 6f 75 72 6e 61 6c 20 66 69 6c ** journal fil
f310: 65 20 69 73 20 74 6f 6f 20 73 6d 61 6c 6c 20 66 e is too small f
f320: 6f 72 20 74 68 65 72 65 20 74 6f 20 62 65 20 61 or there to be a
f330: 20 68 65 61 64 65 72 20 73 74 6f 72 65 64 20 61 header stored a
f340: 74 20 74 68 69 73 0a 20 20 2a 2a 20 70 6f 69 6e t this. ** poin
f350: 74 2c 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 t, return SQLITE
f360: 5f 44 4f 4e 45 2e 0a 20 20 2a 2f 0a 20 20 70 50 _DONE.. */. pP
f370: 61 67 65 72 2d 3e 6a 6f 75 72 6e 61 6c 4f 66 66 ager->journalOff
f380: 20 3d 20 6a 6f 75 72 6e 61 6c 48 64 72 4f 66 66 = journalHdrOff
f390: 73 65 74 28 70 50 61 67 65 72 29 3b 0a 20 20 69 set(pPager);. i
f3a0: 66 28 20 70 50 61 67 65 72 2d 3e 6a 6f 75 72 6e f( pPager->journ
f3b0: 61 6c 4f 66 66 2b 4a 4f 55 52 4e 41 4c 5f 48 44 alOff+JOURNAL_HD
f3c0: 52 5f 53 5a 28 70 50 61 67 65 72 29 20 3e 20 6a R_SZ(pPager) > j
f3d0: 6f 75 72 6e 61 6c 53 69 7a 65 20 29 7b 0a 20 20 ournalSize ){.
f3e0: 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f return SQLITE_
f3f0: 44 4f 4e 45 3b 0a 20 20 7d 0a 20 20 69 48 64 72 DONE;. }. iHdr
f400: 4f 66 66 20 3d 20 70 50 61 67 65 72 2d 3e 6a 6f Off = pPager->jo
f410: 75 72 6e 61 6c 4f 66 66 3b 0a 0a 20 20 2f 2a 20 urnalOff;.. /*
f420: 52 65 61 64 20 69 6e 20 74 68 65 20 66 69 72 73 Read in the firs
f430: 74 20 38 20 62 79 74 65 73 20 6f 66 20 74 68 65 t 8 bytes of the
f440: 20 6a 6f 75 72 6e 61 6c 20 68 65 61 64 65 72 2e journal header.
f450: 20 49 66 20 74 68 65 79 20 64 6f 20 6e 6f 74 20 If they do not
f460: 6d 61 74 63 68 0a 20 20 2a 2a 20 74 68 65 20 20 match. ** the
f470: 6d 61 67 69 63 20 73 74 72 69 6e 67 20 66 6f 75 magic string fou
f480: 6e 64 20 61 74 20 74 68 65 20 73 74 61 72 74 20 nd at the start
f490: 6f 66 20 65 61 63 68 20 6a 6f 75 72 6e 61 6c 20 of each journal
f4a0: 68 65 61 64 65 72 2c 20 72 65 74 75 72 6e 0a 20 header, return.
f4b0: 20 2a 2a 20 53 51 4c 49 54 45 5f 44 4f 4e 45 2e ** SQLITE_DONE.
f4c0: 20 49 66 20 61 6e 20 49 4f 20 65 72 72 6f 72 20 If an IO error
f4d0: 6f 63 63 75 72 73 2c 20 72 65 74 75 72 6e 20 61 occurs, return a
f4e0: 6e 20 65 72 72 6f 72 20 63 6f 64 65 2e 20 4f 74 n error code. Ot
f4f0: 68 65 72 77 69 73 65 2c 0a 20 20 2a 2a 20 70 72 herwise,. ** pr
f500: 6f 63 65 65 64 2e 0a 20 20 2a 2f 0a 20 20 69 66 oceed.. */. if
f510: 28 20 69 73 48 6f 74 20 7c 7c 20 69 48 64 72 4f ( isHot || iHdrO
f520: 66 66 21 3d 70 50 61 67 65 72 2d 3e 6a 6f 75 72 ff!=pPager->jour
f530: 6e 61 6c 48 64 72 20 29 7b 0a 20 20 20 20 72 63 nalHdr ){. rc
f540: 20 3d 20 73 71 6c 69 74 65 33 4f 73 52 65 61 64 = sqlite3OsRead
f550: 28 70 50 61 67 65 72 2d 3e 6a 66 64 2c 20 61 4d (pPager->jfd, aM
f560: 61 67 69 63 2c 20 73 69 7a 65 6f 66 28 61 4d 61 agic, sizeof(aMa
f570: 67 69 63 29 2c 20 69 48 64 72 4f 66 66 29 3b 0a gic), iHdrOff);.
f580: 20 20 20 20 69 66 28 20 72 63 20 29 7b 0a 20 20 if( rc ){.
f590: 20 20 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 20 return rc;.
f5a0: 20 20 20 7d 0a 20 20 20 20 69 66 28 20 6d 65 6d }. if( mem
f5b0: 63 6d 70 28 61 4d 61 67 69 63 2c 20 61 4a 6f 75 cmp(aMagic, aJou
f5c0: 72 6e 61 6c 4d 61 67 69 63 2c 20 73 69 7a 65 6f rnalMagic, sizeo
f5d0: 66 28 61 4d 61 67 69 63 29 29 21 3d 30 20 29 7b f(aMagic))!=0 ){
f5e0: 0a 20 20 20 20 20 20 72 65 74 75 72 6e 20 53 51 . return SQ
f5f0: 4c 49 54 45 5f 44 4f 4e 45 3b 0a 20 20 20 20 7d LITE_DONE;. }
f600: 0a 20 20 7d 0a 0a 20 20 2f 2a 20 52 65 61 64 20 . }.. /* Read
f610: 74 68 65 20 66 69 72 73 74 20 74 68 72 65 65 20 the first three
f620: 33 32 2d 62 69 74 20 66 69 65 6c 64 73 20 6f 66 32-bit fields of
f630: 20 74 68 65 20 6a 6f 75 72 6e 61 6c 20 68 65 61 the journal hea
f640: 64 65 72 3a 20 54 68 65 20 6e 52 65 63 0a 20 20 der: The nRec.
f650: 2a 2a 20 66 69 65 6c 64 2c 20 74 68 65 20 63 68 ** field, the ch
f660: 65 63 6b 73 75 6d 2d 69 6e 69 74 69 61 6c 69 7a ecksum-initializ
f670: 65 72 20 61 6e 64 20 74 68 65 20 64 61 74 61 62 er and the datab
f680: 61 73 65 20 73 69 7a 65 20 61 74 20 74 68 65 20 ase size at the
f690: 73 74 61 72 74 0a 20 20 2a 2a 20 6f 66 20 74 68 start. ** of th
f6a0: 65 20 74 72 61 6e 73 61 63 74 69 6f 6e 2e 20 52 e transaction. R
f6b0: 65 74 75 72 6e 20 61 6e 20 65 72 72 6f 72 20 63 eturn an error c
f6c0: 6f 64 65 20 69 66 20 61 6e 79 74 68 69 6e 67 20 ode if anything
f6d0: 67 6f 65 73 20 77 72 6f 6e 67 2e 0a 20 20 2a 2f goes wrong.. */
f6e0: 0a 20 20 69 66 28 20 53 51 4c 49 54 45 5f 4f 4b . if( SQLITE_OK
f6f0: 21 3d 28 72 63 20 3d 20 72 65 61 64 33 32 62 69 !=(rc = read32bi
f700: 74 73 28 70 50 61 67 65 72 2d 3e 6a 66 64 2c 20 ts(pPager->jfd,
f710: 69 48 64 72 4f 66 66 2b 38 2c 20 70 4e 52 65 63 iHdrOff+8, pNRec
f720: 29 29 0a 20 20 20 7c 7c 20 53 51 4c 49 54 45 5f )). || SQLITE_
f730: 4f 4b 21 3d 28 72 63 20 3d 20 72 65 61 64 33 32 OK!=(rc = read32
f740: 62 69 74 73 28 70 50 61 67 65 72 2d 3e 6a 66 64 bits(pPager->jfd
f750: 2c 20 69 48 64 72 4f 66 66 2b 31 32 2c 20 26 70 , iHdrOff+12, &p
f760: 50 61 67 65 72 2d 3e 63 6b 73 75 6d 49 6e 69 74 Pager->cksumInit
f770: 29 29 0a 20 20 20 7c 7c 20 53 51 4c 49 54 45 5f )). || SQLITE_
f780: 4f 4b 21 3d 28 72 63 20 3d 20 72 65 61 64 33 32 OK!=(rc = read32
f790: 62 69 74 73 28 70 50 61 67 65 72 2d 3e 6a 66 64 bits(pPager->jfd
f7a0: 2c 20 69 48 64 72 4f 66 66 2b 31 36 2c 20 70 44 , iHdrOff+16, pD
f7b0: 62 53 69 7a 65 29 29 0a 20 20 29 7b 0a 20 20 20 bSize)). ){.
f7c0: 20 72 65 74 75 72 6e 20 72 63 3b 0a 20 20 7d 0a return rc;. }.
f7d0: 0a 20 20 69 66 28 20 70 50 61 67 65 72 2d 3e 6a . if( pPager->j
f7e0: 6f 75 72 6e 61 6c 4f 66 66 3d 3d 30 20 29 7b 0a ournalOff==0 ){.
f7f0: 20 20 20 20 75 33 32 20 69 50 61 67 65 53 69 7a u32 iPageSiz
f800: 65 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 e;
f810: 20 2f 2a 20 50 61 67 65 2d 73 69 7a 65 20 66 69 /* Page-size fi
f820: 65 6c 64 20 6f 66 20 6a 6f 75 72 6e 61 6c 20 68 eld of journal h
f830: 65 61 64 65 72 20 2a 2f 0a 20 20 20 20 75 33 32 eader */. u32
f840: 20 69 53 65 63 74 6f 72 53 69 7a 65 3b 20 20 20 iSectorSize;
f850: 20 20 20 20 20 20 20 20 20 20 2f 2a 20 53 65 63 /* Sec
f860: 74 6f 72 2d 73 69 7a 65 20 66 69 65 6c 64 20 6f tor-size field o
f870: 66 20 6a 6f 75 72 6e 61 6c 20 68 65 61 64 65 72 f journal header
f880: 20 2a 2f 0a 0a 20 20 20 20 2f 2a 20 52 65 61 64 */.. /* Read
f890: 20 74 68 65 20 70 61 67 65 2d 73 69 7a 65 20 61 the page-size a
f8a0: 6e 64 20 73 65 63 74 6f 72 2d 73 69 7a 65 20 6a nd sector-size j
f8b0: 6f 75 72 6e 61 6c 20 68 65 61 64 65 72 20 66 69 ournal header fi
f8c0: 65 6c 64 73 2e 20 2a 2f 0a 20 20 20 20 69 66 28 elds. */. if(
f8d0: 20 53 51 4c 49 54 45 5f 4f 4b 21 3d 28 72 63 20 SQLITE_OK!=(rc
f8e0: 3d 20 72 65 61 64 33 32 62 69 74 73 28 70 50 61 = read32bits(pPa
f8f0: 67 65 72 2d 3e 6a 66 64 2c 20 69 48 64 72 4f 66 ger->jfd, iHdrOf
f900: 66 2b 32 30 2c 20 26 69 53 65 63 74 6f 72 53 69 f+20, &iSectorSi
f910: 7a 65 29 29 0a 20 20 20 20 20 7c 7c 20 53 51 4c ze)). || SQL
f920: 49 54 45 5f 4f 4b 21 3d 28 72 63 20 3d 20 72 65 ITE_OK!=(rc = re
f930: 61 64 33 32 62 69 74 73 28 70 50 61 67 65 72 2d ad32bits(pPager-
f940: 3e 6a 66 64 2c 20 69 48 64 72 4f 66 66 2b 32 34 >jfd, iHdrOff+24
f950: 2c 20 26 69 50 61 67 65 53 69 7a 65 29 29 0a 20 , &iPageSize)).
f960: 20 20 20 29 7b 0a 20 20 20 20 20 20 72 65 74 75 ){. retu
f970: 72 6e 20 72 63 3b 0a 20 20 20 20 7d 0a 0a 20 20 rn rc;. }..
f980: 20 20 2f 2a 20 56 65 72 73 69 6f 6e 73 20 6f 66 /* Versions of
f990: 20 53 51 4c 69 74 65 20 70 72 69 6f 72 20 74 6f SQLite prior to
f9a0: 20 33 2e 35 2e 38 20 73 65 74 20 74 68 65 20 70 3.5.8 set the p
f9b0: 61 67 65 2d 73 69 7a 65 20 66 69 65 6c 64 20 6f age-size field o
f9c0: 66 20 74 68 65 0a 20 20 20 20 2a 2a 20 6a 6f 75 f the. ** jou
f9d0: 72 6e 61 6c 20 68 65 61 64 65 72 20 74 6f 20 7a rnal header to z
f9e0: 65 72 6f 2e 20 49 6e 20 74 68 69 73 20 63 61 73 ero. In this cas
f9f0: 65 2c 20 61 73 73 75 6d 65 20 74 68 61 74 20 74 e, assume that t
fa00: 68 65 20 50 61 67 65 72 2e 70 61 67 65 53 69 7a he Pager.pageSiz
fa10: 65 0a 20 20 20 20 2a 2a 20 76 61 72 69 61 62 6c e. ** variabl
fa20: 65 20 69 73 20 61 6c 72 65 61 64 79 20 73 65 74 e is already set
fa30: 20 74 6f 20 74 68 65 20 63 6f 72 72 65 63 74 20 to the correct
fa40: 70 61 67 65 20 73 69 7a 65 2e 0a 20 20 20 20 2a page size.. *
fa50: 2f 0a 20 20 20 20 69 66 28 20 69 50 61 67 65 53 /. if( iPageS
fa60: 69 7a 65 3d 3d 30 20 29 7b 0a 20 20 20 20 20 20 ize==0 ){.
fa70: 69 50 61 67 65 53 69 7a 65 20 3d 20 70 50 61 67 iPageSize = pPag
fa80: 65 72 2d 3e 70 61 67 65 53 69 7a 65 3b 0a 20 20 er->pageSize;.
fa90: 20 20 7d 0a 0a 20 20 20 20 2f 2a 20 43 68 65 63 }.. /* Chec
faa0: 6b 20 74 68 61 74 20 74 68 65 20 76 61 6c 75 65 k that the value
fab0: 73 20 72 65 61 64 20 66 72 6f 6d 20 74 68 65 20 s read from the
fac0: 70 61 67 65 2d 73 69 7a 65 20 61 6e 64 20 73 65 page-size and se
fad0: 63 74 6f 72 2d 73 69 7a 65 20 66 69 65 6c 64 73 ctor-size fields
fae0: 0a 20 20 20 20 2a 2a 20 61 72 65 20 77 69 74 68 . ** are with
faf0: 69 6e 20 72 61 6e 67 65 2e 20 54 6f 20 62 65 20 in range. To be
fb00: 27 69 6e 20 72 61 6e 67 65 27 2c 20 62 6f 74 68 'in range', both
fb10: 20 76 61 6c 75 65 73 20 6e 65 65 64 20 74 6f 20 values need to
fb20: 62 65 20 61 20 70 6f 77 65 72 0a 20 20 20 20 2a be a power. *
fb30: 2a 20 6f 66 20 74 77 6f 20 67 72 65 61 74 65 72 * of two greater
fb40: 20 74 68 61 6e 20 6f 72 20 65 71 75 61 6c 20 74 than or equal t
fb50: 6f 20 35 31 32 20 6f 72 20 33 32 2c 20 61 6e 64 o 512 or 32, and
fb60: 20 6e 6f 74 20 67 72 65 61 74 65 72 20 74 68 61 not greater tha
fb70: 6e 20 74 68 65 69 72 20 0a 20 20 20 20 2a 2a 20 n their . **
fb80: 72 65 73 70 65 63 74 69 76 65 20 63 6f 6d 70 69 respective compi
fb90: 6c 65 20 74 69 6d 65 20 6d 61 78 69 6d 75 6d 20 le time maximum
fba0: 6c 69 6d 69 74 73 2e 0a 20 20 20 20 2a 2f 0a 20 limits.. */.
fbb0: 20 20 20 69 66 28 20 69 50 61 67 65 53 69 7a 65 if( iPageSize
fbc0: 3c 35 31 32 20 20 20 20 20 20 20 20 20 20 20 20 <512
fbd0: 20 20 20 20 20 20 7c 7c 20 69 53 65 63 74 6f 72 || iSector
fbe0: 53 69 7a 65 3c 33 32 0a 20 20 20 20 20 7c 7c 20 Size<32. ||
fbf0: 69 50 61 67 65 53 69 7a 65 3e 53 51 4c 49 54 45 iPageSize>SQLITE
fc00: 5f 4d 41 58 5f 50 41 47 45 5f 53 49 5a 45 20 7c _MAX_PAGE_SIZE |
fc10: 7c 20 69 53 65 63 74 6f 72 53 69 7a 65 3e 4d 41 | iSectorSize>MA
fc20: 58 5f 53 45 43 54 4f 52 5f 53 49 5a 45 0a 20 20 X_SECTOR_SIZE.
fc30: 20 20 20 7c 7c 20 28 28 69 50 61 67 65 53 69 7a || ((iPageSiz
fc40: 65 2d 31 29 26 69 50 61 67 65 53 69 7a 65 29 21 e-1)&iPageSize)!
fc50: 3d 30 20 20 20 7c 7c 20 28 28 69 53 65 63 74 6f =0 || ((iSecto
fc60: 72 53 69 7a 65 2d 31 29 26 69 53 65 63 74 6f 72 rSize-1)&iSector
fc70: 53 69 7a 65 29 21 3d 30 20 0a 20 20 20 20 29 7b Size)!=0 . ){
fc80: 0a 20 20 20 20 20 20 2f 2a 20 49 66 20 74 68 65 . /* If the
fc90: 20 65 69 74 68 65 72 20 74 68 65 20 70 61 67 65 either the page
fca0: 2d 73 69 7a 65 20 6f 72 20 73 65 63 74 6f 72 2d -size or sector-
fcb0: 73 69 7a 65 20 69 6e 20 74 68 65 20 6a 6f 75 72 size in the jour
fcc0: 6e 61 6c 2d 68 65 61 64 65 72 20 69 73 20 0a 20 nal-header is .
fcd0: 20 20 20 20 20 2a 2a 20 69 6e 76 61 6c 69 64 2c ** invalid,
fce0: 20 74 68 65 6e 20 74 68 65 20 70 72 6f 63 65 73 then the proces
fcf0: 73 20 74 68 61 74 20 77 72 6f 74 65 20 74 68 65 s that wrote the
fd00: 20 6a 6f 75 72 6e 61 6c 2d 68 65 61 64 65 72 20 journal-header
fd10: 6d 75 73 74 20 68 61 76 65 20 0a 20 20 20 20 20 must have .
fd20: 20 2a 2a 20 63 72 61 73 68 65 64 20 62 65 66 6f ** crashed befo
fd30: 72 65 20 74 68 65 20 68 65 61 64 65 72 20 77 61 re the header wa
fd40: 73 20 73 79 6e 63 65 64 2e 20 49 6e 20 74 68 69 s synced. In thi
fd50: 73 20 63 61 73 65 20 73 74 6f 70 20 72 65 61 64 s case stop read
fd60: 69 6e 67 20 0a 20 20 20 20 20 20 2a 2a 20 74 68 ing . ** th
fd70: 65 20 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 20 68 e journal file h
fd80: 65 72 65 2e 0a 20 20 20 20 20 20 2a 2f 0a 20 20 ere.. */.
fd90: 20 20 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 return SQLIT
fda0: 45 5f 44 4f 4e 45 3b 0a 20 20 20 20 7d 0a 0a 20 E_DONE;. }..
fdb0: 20 20 20 2f 2a 20 55 70 64 61 74 65 20 74 68 65 /* Update the
fdc0: 20 70 61 67 65 2d 73 69 7a 65 20 74 6f 20 6d 61 page-size to ma
fdd0: 74 63 68 20 74 68 65 20 76 61 6c 75 65 20 72 65 tch the value re
fde0: 61 64 20 66 72 6f 6d 20 74 68 65 20 6a 6f 75 72 ad from the jour
fdf0: 6e 61 6c 2e 20 0a 20 20 20 20 2a 2a 20 55 73 65 nal. . ** Use
fe00: 20 61 20 74 65 73 74 63 61 73 65 28 29 20 6d 61 a testcase() ma
fe10: 63 72 6f 20 74 6f 20 6d 61 6b 65 20 73 75 72 65 cro to make sure
fe20: 20 74 68 61 74 20 6d 61 6c 6c 6f 63 20 66 61 69 that malloc fai
fe30: 6c 75 72 65 20 77 69 74 68 69 6e 20 0a 20 20 20 lure within .
fe40: 20 2a 2a 20 50 61 67 65 72 53 65 74 50 61 67 65 ** PagerSetPage
fe50: 73 69 7a 65 28 29 20 69 73 20 74 65 73 74 65 64 size() is tested
fe60: 2e 0a 20 20 20 20 2a 2f 0a 20 20 20 20 72 63 20 .. */. rc
fe70: 3d 20 73 71 6c 69 74 65 33 50 61 67 65 72 53 65 = sqlite3PagerSe
fe80: 74 50 61 67 65 73 69 7a 65 28 70 50 61 67 65 72 tPagesize(pPager
fe90: 2c 20 26 69 50 61 67 65 53 69 7a 65 2c 20 2d 31 , &iPageSize, -1
fea0: 29 3b 0a 20 20 20 20 74 65 73 74 63 61 73 65 28 );. testcase(
feb0: 20 72 63 21 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 rc!=SQLITE_OK )
fec0: 3b 0a 0a 20 20 20 20 2f 2a 20 55 70 64 61 74 65 ;.. /* Update
fed0: 20 74 68 65 20 61 73 73 75 6d 65 64 20 73 65 63 the assumed sec
fee0: 74 6f 72 2d 73 69 7a 65 20 74 6f 20 6d 61 74 63 tor-size to matc
fef0: 68 20 74 68 65 20 76 61 6c 75 65 20 75 73 65 64 h the value used
ff00: 20 62 79 20 0a 20 20 20 20 2a 2a 20 74 68 65 20 by . ** the
ff10: 70 72 6f 63 65 73 73 20 74 68 61 74 20 63 72 65 process that cre
ff20: 61 74 65 64 20 74 68 69 73 20 6a 6f 75 72 6e 61 ated this journa
ff30: 6c 2e 20 49 66 20 74 68 69 73 20 6a 6f 75 72 6e l. If this journ
ff40: 61 6c 20 77 61 73 0a 20 20 20 20 2a 2a 20 63 72 al was. ** cr
ff50: 65 61 74 65 64 20 62 79 20 61 20 70 72 6f 63 65 eated by a proce
ff60: 73 73 20 6f 74 68 65 72 20 74 68 61 6e 20 74 68 ss other than th
ff70: 69 73 20 6f 6e 65 2c 20 74 68 65 6e 20 74 68 69 is one, then thi
ff80: 73 20 72 6f 75 74 69 6e 65 0a 20 20 20 20 2a 2a s routine. **
ff90: 20 69 73 20 62 65 69 6e 67 20 63 61 6c 6c 65 64 is being called
ffa0: 20 66 72 6f 6d 20 77 69 74 68 69 6e 20 70 61 67 from within pag
ffb0: 65 72 5f 70 6c 61 79 62 61 63 6b 28 29 2e 20 54 er_playback(). T
ffc0: 68 65 20 6c 6f 63 61 6c 20 76 61 6c 75 65 0a 20 he local value.
ffd0: 20 20 20 2a 2a 20 6f 66 20 50 61 67 65 72 2e 73 ** of Pager.s
ffe0: 65 63 74 6f 72 53 69 7a 65 20 69 73 20 72 65 73 ectorSize is res
fff0: 74 6f 72 65 64 20 61 74 20 74 68 65 20 65 6e 64 tored at the end
10000 20 6f 66 20 74 68 61 74 20 72 6f 75 74 69 6e 65 of that routine
10010 2e 0a 20 20 20 20 2a 2f 0a 20 20 20 20 70 50 61 .. */. pPa
10020 67 65 72 2d 3e 73 65 63 74 6f 72 53 69 7a 65 20 ger->sectorSize
10030 3d 20 69 53 65 63 74 6f 72 53 69 7a 65 3b 0a 20 = iSectorSize;.
10040 20 7d 0a 0a 20 20 70 50 61 67 65 72 2d 3e 6a 6f }.. pPager->jo
10050 75 72 6e 61 6c 4f 66 66 20 2b 3d 20 4a 4f 55 52 urnalOff += JOUR
10060 4e 41 4c 5f 48 44 52 5f 53 5a 28 70 50 61 67 65 NAL_HDR_SZ(pPage
10070 72 29 3b 0a 20 20 72 65 74 75 72 6e 20 72 63 3b r);. return rc;
10080 0a 7d 0a 0a 0a 2f 2a 0a 2a 2a 20 57 72 69 74 65 .}.../*.** Write
10090 20 74 68 65 20 73 75 70 70 6c 69 65 64 20 6d 61 the supplied ma
100a0 73 74 65 72 20 6a 6f 75 72 6e 61 6c 20 6e 61 6d ster journal nam
100b0 65 20 69 6e 74 6f 20 74 68 65 20 6a 6f 75 72 6e e into the journ
100c0 61 6c 20 66 69 6c 65 20 66 6f 72 20 70 61 67 65 al file for page
100d0 72 0a 2a 2a 20 70 50 61 67 65 72 20 61 74 20 74 r.** pPager at t
100e0 68 65 20 63 75 72 72 65 6e 74 20 6c 6f 63 61 74 he current locat
100f0 69 6f 6e 2e 20 54 68 65 20 6d 61 73 74 65 72 20 ion. The master
10100 6a 6f 75 72 6e 61 6c 20 6e 61 6d 65 20 6d 75 73 journal name mus
10110 74 20 62 65 20 74 68 65 20 6c 61 73 74 0a 2a 2a t be the last.**
10120 20 74 68 69 6e 67 20 77 72 69 74 74 65 6e 20 74 thing written t
10130 6f 20 61 20 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 o a journal file
10140 2e 20 49 66 20 74 68 65 20 70 61 67 65 72 20 69 . If the pager i
10150 73 20 69 6e 20 66 75 6c 6c 2d 73 79 6e 63 20 6d s in full-sync m
10160 6f 64 65 2c 20 74 68 65 0a 2a 2a 20 6a 6f 75 72 ode, the.** jour
10170 6e 61 6c 20 66 69 6c 65 20 64 65 73 63 72 69 70 nal file descrip
10180 74 6f 72 20 69 73 20 61 64 76 61 6e 63 65 64 20 tor is advanced
10190 74 6f 20 74 68 65 20 6e 65 78 74 20 73 65 63 74 to the next sect
101a0 6f 72 20 62 6f 75 6e 64 61 72 79 20 62 65 66 6f or boundary befo
101b0 72 65 0a 2a 2a 20 61 6e 79 74 68 69 6e 67 20 69 re.** anything i
101c0 73 20 77 72 69 74 74 65 6e 2e 20 54 68 65 20 66 s written. The f
101d0 6f 72 6d 61 74 20 69 73 3a 0a 2a 2a 0a 2a 2a 20 ormat is:.**.**
101e0 20 20 2b 20 34 20 62 79 74 65 73 3a 20 50 41 47 + 4 bytes: PAG
101f0 45 52 5f 4d 4a 5f 50 47 4e 4f 2e 0a 2a 2a 20 20 ER_MJ_PGNO..**
10200 20 2b 20 4e 20 62 79 74 65 73 3a 20 4d 61 73 74 + N bytes: Mast
10210 65 72 20 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 6e er journal filen
10220 61 6d 65 20 69 6e 20 75 74 66 2d 38 2e 0a 2a 2a ame in utf-8..**
10230 20 20 20 2b 20 34 20 62 79 74 65 73 3a 20 4e 20 + 4 bytes: N
10240 28 6c 65 6e 67 74 68 20 6f 66 20 6d 61 73 74 65 (length of maste
10250 72 20 6a 6f 75 72 6e 61 6c 20 6e 61 6d 65 20 69 r journal name i
10260 6e 20 62 79 74 65 73 2c 20 6e 6f 20 6e 75 6c 2d n bytes, no nul-
10270 74 65 72 6d 69 6e 61 74 6f 72 29 2e 0a 2a 2a 20 terminator)..**
10280 20 20 2b 20 34 20 62 79 74 65 73 3a 20 4d 61 73 + 4 bytes: Mas
10290 74 65 72 20 6a 6f 75 72 6e 61 6c 20 6e 61 6d 65 ter journal name
102a0 20 63 68 65 63 6b 73 75 6d 2e 0a 2a 2a 20 20 20 checksum..**
102b0 2b 20 38 20 62 79 74 65 73 3a 20 61 4a 6f 75 72 + 8 bytes: aJour
102c0 6e 61 6c 4d 61 67 69 63 5b 5d 2e 0a 2a 2a 0a 2a nalMagic[]..**.*
102d0 2a 20 54 68 65 20 6d 61 73 74 65 72 20 6a 6f 75 * The master jou
102e0 72 6e 61 6c 20 70 61 67 65 20 63 68 65 63 6b 73 rnal page checks
102f0 75 6d 20 69 73 20 74 68 65 20 73 75 6d 20 6f 66 um is the sum of
10300 20 74 68 65 20 62 79 74 65 73 20 69 6e 20 74 68 the bytes in th
10310 65 20 6d 61 73 74 65 72 0a 2a 2a 20 6a 6f 75 72 e master.** jour
10320 6e 61 6c 20 6e 61 6d 65 2c 20 77 68 65 72 65 20 nal name, where
10330 65 61 63 68 20 62 79 74 65 20 69 73 20 69 6e 74 each byte is int
10340 65 72 70 72 65 74 65 64 20 61 73 20 61 20 73 69 erpreted as a si
10350 67 6e 65 64 20 38 2d 62 69 74 20 69 6e 74 65 67 gned 8-bit integ
10360 65 72 2e 0a 2a 2a 0a 2a 2a 20 49 66 20 7a 4d 61 er..**.** If zMa
10370 73 74 65 72 20 69 73 20 61 20 4e 55 4c 4c 20 70 ster is a NULL p
10380 6f 69 6e 74 65 72 20 28 6f 63 63 75 72 73 20 66 ointer (occurs f
10390 6f 72 20 61 20 73 69 6e 67 6c 65 20 64 61 74 61 or a single data
103a0 62 61 73 65 20 74 72 61 6e 73 61 63 74 69 6f 6e base transaction
103b0 29 2c 20 0a 2a 2a 20 74 68 69 73 20 63 61 6c 6c ), .** this call
103c0 20 69 73 20 61 20 6e 6f 2d 6f 70 2e 0a 2a 2f 0a is a no-op..*/.
103d0 73 74 61 74 69 63 20 69 6e 74 20 77 72 69 74 65 static int write
103e0 4d 61 73 74 65 72 4a 6f 75 72 6e 61 6c 28 50 61 MasterJournal(Pa
103f0 67 65 72 20 2a 70 50 61 67 65 72 2c 20 63 6f 6e ger *pPager, con
10400 73 74 20 63 68 61 72 20 2a 7a 4d 61 73 74 65 72 st char *zMaster
10410 29 7b 0a 20 20 69 6e 74 20 72 63 3b 20 20 20 20 ){. int rc;
10420 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
10430 20 20 20 20 20 20 2f 2a 20 52 65 74 75 72 6e 20 /* Return
10440 63 6f 64 65 20 2a 2f 0a 20 20 69 6e 74 20 6e 4d code */. int nM
10450 61 73 74 65 72 3b 20 20 20 20 20 20 20 20 20 20 aster;
10460 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4c 65 /* Le
10470 6e 67 74 68 20 6f 66 20 73 74 72 69 6e 67 20 7a ngth of string z
10480 4d 61 73 74 65 72 20 2a 2f 0a 20 20 69 36 34 20 Master */. i64
10490 69 48 64 72 4f 66 66 3b 20 20 20 20 20 20 20 20 iHdrOff;
104a0 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 /*
104b0 4f 66 66 73 65 74 20 6f 66 20 68 65 61 64 65 72 Offset of header
104c0 20 69 6e 20 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 in journal file
104d0 20 2a 2f 0a 20 20 69 36 34 20 6a 72 6e 6c 53 69 */. i64 jrnlSi
104e0 7a 65 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 ze;
104f0 20 20 20 20 20 20 20 2f 2a 20 53 69 7a 65 20 6f /* Size o
10500 66 20 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 20 6f f journal file o
10510 6e 20 64 69 73 6b 20 2a 2f 0a 20 20 75 33 32 20 n disk */. u32
10520 63 6b 73 75 6d 20 3d 20 30 3b 20 20 20 20 20 20 cksum = 0;
10530 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 /*
10540 43 68 65 63 6b 73 75 6d 20 6f 66 20 73 74 72 69 Checksum of stri
10550 6e 67 20 7a 4d 61 73 74 65 72 20 2a 2f 0a 0a 20 ng zMaster */..
10560 20 61 73 73 65 72 74 28 20 70 50 61 67 65 72 2d assert( pPager-
10570 3e 73 65 74 4d 61 73 74 65 72 3d 3d 30 20 29 3b >setMaster==0 );
10580 0a 20 20 61 73 73 65 72 74 28 20 21 70 61 67 65 . assert( !page
10590 72 55 73 65 57 61 6c 28 70 50 61 67 65 72 29 20 rUseWal(pPager)
105a0 29 3b 0a 0a 20 20 69 66 28 20 21 7a 4d 61 73 74 );.. if( !zMast
105b0 65 72 20 0a 20 20 20 7c 7c 20 70 50 61 67 65 72 er . || pPager
105c0 2d 3e 6a 6f 75 72 6e 61 6c 4d 6f 64 65 3d 3d 50 ->journalMode==P
105d0 41 47 45 52 5f 4a 4f 55 52 4e 41 4c 4d 4f 44 45 AGER_JOURNALMODE
105e0 5f 4d 45 4d 4f 52 59 20 0a 20 20 20 7c 7c 20 70 _MEMORY . || p
105f0 50 61 67 65 72 2d 3e 6a 6f 75 72 6e 61 6c 4d 6f Pager->journalMo
10600 64 65 3d 3d 50 41 47 45 52 5f 4a 4f 55 52 4e 41 de==PAGER_JOURNA
10610 4c 4d 4f 44 45 5f 4f 46 46 20 0a 20 20 29 7b 0a LMODE_OFF . ){.
10620 20 20 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 return SQLIT
10630 45 5f 4f 4b 3b 0a 20 20 7d 0a 20 20 70 50 61 67 E_OK;. }. pPag
10640 65 72 2d 3e 73 65 74 4d 61 73 74 65 72 20 3d 20 er->setMaster =
10650 31 3b 0a 20 20 61 73 73 65 72 74 28 20 69 73 4f 1;. assert( isO
10660 70 65 6e 28 70 50 61 67 65 72 2d 3e 6a 66 64 29 pen(pPager->jfd)
10670 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 70 50 );. assert( pP
10680 61 67 65 72 2d 3e 6a 6f 75 72 6e 61 6c 48 64 72 ager->journalHdr
10690 20 3c 3d 20 70 50 61 67 65 72 2d 3e 6a 6f 75 72 <= pPager->jour
106a0 6e 61 6c 4f 66 66 20 29 3b 0a 0a 20 20 2f 2a 20 nalOff );.. /*
106b0 43 61 6c 63 75 6c 61 74 65 20 74 68 65 20 6c 65 Calculate the le
106c0 6e 67 74 68 20 69 6e 20 62 79 74 65 73 20 61 6e ngth in bytes an
106d0 64 20 74 68 65 20 63 68 65 63 6b 73 75 6d 20 6f d the checksum o
106e0 66 20 7a 4d 61 73 74 65 72 20 2a 2f 0a 20 20 66 f zMaster */. f
106f0 6f 72 28 6e 4d 61 73 74 65 72 3d 30 3b 20 7a 4d or(nMaster=0; zM
10700 61 73 74 65 72 5b 6e 4d 61 73 74 65 72 5d 3b 20 aster[nMaster];
10710 6e 4d 61 73 74 65 72 2b 2b 29 7b 0a 20 20 20 20 nMaster++){.
10720 63 6b 73 75 6d 20 2b 3d 20 7a 4d 61 73 74 65 72 cksum += zMaster
10730 5b 6e 4d 61 73 74 65 72 5d 3b 0a 20 20 7d 0a 0a [nMaster];. }..
10740 20 20 2f 2a 20 49 66 20 69 6e 20 66 75 6c 6c 2d /* If in full-
10750 73 79 6e 63 20 6d 6f 64 65 2c 20 61 64 76 61 6e sync mode, advan
10760 63 65 20 74 6f 20 74 68 65 20 6e 65 78 74 20 64 ce to the next d
10770 69 73 6b 20 73 65 63 74 6f 72 20 62 65 66 6f 72 isk sector befor
10780 65 20 77 72 69 74 69 6e 67 0a 20 20 2a 2a 20 74 e writing. ** t
10790 68 65 20 6d 61 73 74 65 72 20 6a 6f 75 72 6e 61 he master journa
107a0 6c 20 6e 61 6d 65 2e 20 54 68 69 73 20 69 73 20 l name. This is
107b0 69 6e 20 63 61 73 65 20 74 68 65 20 70 72 65 76 in case the prev
107c0 69 6f 75 73 20 70 61 67 65 20 77 72 69 74 74 65 ious page writte
107d0 6e 20 74 6f 0a 20 20 2a 2a 20 74 68 65 20 6a 6f n to. ** the jo
107e0 75 72 6e 61 6c 20 68 61 73 20 61 6c 72 65 61 64 urnal has alread
107f0 79 20 62 65 65 6e 20 73 79 6e 63 65 64 2e 0a 20 y been synced..
10800 20 2a 2f 0a 20 20 69 66 28 20 70 50 61 67 65 72 */. if( pPager
10810 2d 3e 66 75 6c 6c 53 79 6e 63 20 29 7b 0a 20 20 ->fullSync ){.
10820 20 20 70 50 61 67 65 72 2d 3e 6a 6f 75 72 6e 61 pPager->journa
10830 6c 4f 66 66 20 3d 20 6a 6f 75 72 6e 61 6c 48 64 lOff = journalHd
10840 72 4f 66 66 73 65 74 28 70 50 61 67 65 72 29 3b rOffset(pPager);
10850 0a 20 20 7d 0a 20 20 69 48 64 72 4f 66 66 20 3d . }. iHdrOff =
10860 20 70 50 61 67 65 72 2d 3e 6a 6f 75 72 6e 61 6c pPager->journal
10870 4f 66 66 3b 0a 0a 20 20 2f 2a 20 57 72 69 74 65 Off;.. /* Write
10880 20 74 68 65 20 6d 61 73 74 65 72 20 6a 6f 75 72 the master jour
10890 6e 61 6c 20 64 61 74 61 20 74 6f 20 74 68 65 20 nal data to the
108a0 65 6e 64 20 6f 66 20 74 68 65 20 6a 6f 75 72 6e end of the journ
108b0 61 6c 20 66 69 6c 65 2e 20 49 66 0a 20 20 2a 2a al file. If. **
108c0 20 61 6e 20 65 72 72 6f 72 20 6f 63 63 75 72 73 an error occurs
108d0 2c 20 72 65 74 75 72 6e 20 74 68 65 20 65 72 72 , return the err
108e0 6f 72 20 63 6f 64 65 20 74 6f 20 74 68 65 20 63 or code to the c
108f0 61 6c 6c 65 72 2e 0a 20 20 2a 2f 0a 20 20 69 66 aller.. */. if
10900 28 20 28 30 20 21 3d 20 28 72 63 20 3d 20 77 72 ( (0 != (rc = wr
10910 69 74 65 33 32 62 69 74 73 28 70 50 61 67 65 72 ite32bits(pPager
10920 2d 3e 6a 66 64 2c 20 69 48 64 72 4f 66 66 2c 20 ->jfd, iHdrOff,
10930 50 41 47 45 52 5f 4d 4a 5f 50 47 4e 4f 28 70 50 PAGER_MJ_PGNO(pP
10940 61 67 65 72 29 29 29 29 0a 20 20 20 7c 7c 20 28 ager)))). || (
10950 30 20 21 3d 20 28 72 63 20 3d 20 73 71 6c 69 74 0 != (rc = sqlit
10960 65 33 4f 73 57 72 69 74 65 28 70 50 61 67 65 72 e3OsWrite(pPager
10970 2d 3e 6a 66 64 2c 20 7a 4d 61 73 74 65 72 2c 20 ->jfd, zMaster,
10980 6e 4d 61 73 74 65 72 2c 20 69 48 64 72 4f 66 66 nMaster, iHdrOff
10990 2b 34 29 29 29 0a 20 20 20 7c 7c 20 28 30 20 21 +4))). || (0 !
109a0 3d 20 28 72 63 20 3d 20 77 72 69 74 65 33 32 62 = (rc = write32b
109b0 69 74 73 28 70 50 61 67 65 72 2d 3e 6a 66 64 2c its(pPager->jfd,
109c0 20 69 48 64 72 4f 66 66 2b 34 2b 6e 4d 61 73 74 iHdrOff+4+nMast
109d0 65 72 2c 20 6e 4d 61 73 74 65 72 29 29 29 0a 20 er, nMaster))).
109e0 20 20 7c 7c 20 28 30 20 21 3d 20 28 72 63 20 3d || (0 != (rc =
109f0 20 77 72 69 74 65 33 32 62 69 74 73 28 70 50 61 write32bits(pPa
10a00 67 65 72 2d 3e 6a 66 64 2c 20 69 48 64 72 4f 66 ger->jfd, iHdrOf
10a10 66 2b 34 2b 6e 4d 61 73 74 65 72 2b 34 2c 20 63 f+4+nMaster+4, c
10a20 6b 73 75 6d 29 29 29 0a 20 20 20 7c 7c 20 28 30 ksum))). || (0
10a30 20 21 3d 20 28 72 63 20 3d 20 73 71 6c 69 74 65 != (rc = sqlite
10a40 33 4f 73 57 72 69 74 65 28 70 50 61 67 65 72 2d 3OsWrite(pPager-
10a50 3e 6a 66 64 2c 20 61 4a 6f 75 72 6e 61 6c 4d 61 >jfd, aJournalMa
10a60 67 69 63 2c 20 38 2c 20 69 48 64 72 4f 66 66 2b gic, 8, iHdrOff+
10a70 34 2b 6e 4d 61 73 74 65 72 2b 38 29 29 29 0a 20 4+nMaster+8))).
10a80 20 29 7b 0a 20 20 20 20 72 65 74 75 72 6e 20 72 ){. return r
10a90 63 3b 0a 20 20 7d 0a 20 20 70 50 61 67 65 72 2d c;. }. pPager-
10aa0 3e 6a 6f 75 72 6e 61 6c 4f 66 66 20 2b 3d 20 28 >journalOff += (
10ab0 6e 4d 61 73 74 65 72 2b 32 30 29 3b 0a 0a 20 20 nMaster+20);..
10ac0 2f 2a 20 49 66 20 74 68 65 20 70 61 67 65 72 20 /* If the pager
10ad0 69 73 20 69 6e 20 70 65 72 69 73 74 65 6e 74 2d is in peristent-
10ae0 6a 6f 75 72 6e 61 6c 20 6d 6f 64 65 2c 20 74 68 journal mode, th
10af0 65 6e 20 74 68 65 20 70 68 79 73 69 63 61 6c 20 en the physical
10b00 0a 20 20 2a 2a 20 6a 6f 75 72 6e 61 6c 2d 66 69 . ** journal-fi
10b10 6c 65 20 6d 61 79 20 65 78 74 65 6e 64 20 70 61 le may extend pa
10b20 73 74 20 74 68 65 20 65 6e 64 20 6f 66 20 74 68 st the end of th
10b30 65 20 6d 61 73 74 65 72 2d 6a 6f 75 72 6e 61 6c e master-journal
10b40 20 6e 61 6d 65 0a 20 20 2a 2a 20 61 6e 64 20 38 name. ** and 8
10b50 20 62 79 74 65 73 20 6f 66 20 6d 61 67 69 63 20 bytes of magic
10b60 64 61 74 61 20 6a 75 73 74 20 77 72 69 74 74 65 data just writte
10b70 6e 20 74 6f 20 74 68 65 20 66 69 6c 65 2e 20 54 n to the file. T
10b80 68 69 73 20 69 73 20 0a 20 20 2a 2a 20 64 61 6e his is . ** dan
10b90 67 65 72 6f 75 73 20 62 65 63 61 75 73 65 20 74 gerous because t
10ba0 68 65 20 63 6f 64 65 20 74 6f 20 72 6f 6c 6c 62 he code to rollb
10bb0 61 63 6b 20 61 20 68 6f 74 2d 6a 6f 75 72 6e 61 ack a hot-journa
10bc0 6c 20 66 69 6c 65 0a 20 20 2a 2a 20 77 69 6c 6c l file. ** will
10bd0 20 6e 6f 74 20 62 65 20 61 62 6c 65 20 74 6f 20 not be able to
10be0 66 69 6e 64 20 74 68 65 20 6d 61 73 74 65 72 2d find the master-
10bf0 6a 6f 75 72 6e 61 6c 20 6e 61 6d 65 20 74 6f 20 journal name to
10c00 64 65 74 65 72 6d 69 6e 65 20 0a 20 20 2a 2a 20 determine . **
10c10 77 68 65 74 68 65 72 20 6f 72 20 6e 6f 74 20 74 whether or not t
10c20 68 65 20 6a 6f 75 72 6e 61 6c 20 69 73 20 68 6f he journal is ho
10c30 74 2e 20 0a 20 20 2a 2a 0a 20 20 2a 2a 20 45 61 t. . **. ** Ea
10c40 73 69 65 73 74 20 74 68 69 6e 67 20 74 6f 20 64 siest thing to d
10c50 6f 20 69 6e 20 74 68 69 73 20 73 63 65 6e 61 72 o in this scenar
10c60 69 6f 20 69 73 20 74 6f 20 74 72 75 6e 63 61 74 io is to truncat
10c70 65 20 74 68 65 20 6a 6f 75 72 6e 61 6c 20 0a 20 e the journal .
10c80 20 2a 2a 20 66 69 6c 65 20 74 6f 20 74 68 65 20 ** file to the
10c90 72 65 71 75 69 72 65 64 20 73 69 7a 65 2e 0a 20 required size..
10ca0 20 2a 2f 20 0a 20 20 69 66 28 20 53 51 4c 49 54 */ . if( SQLIT
10cb0 45 5f 4f 4b 3d 3d 28 72 63 20 3d 20 73 71 6c 69 E_OK==(rc = sqli
10cc0 74 65 33 4f 73 46 69 6c 65 53 69 7a 65 28 70 50 te3OsFileSize(pP
10cd0 61 67 65 72 2d 3e 6a 66 64 2c 20 26 6a 72 6e 6c ager->jfd, &jrnl
10ce0 53 69 7a 65 29 29 0a 20 20 20 26 26 20 6a 72 6e Size)). && jrn
10cf0 6c 53 69 7a 65 3e 70 50 61 67 65 72 2d 3e 6a 6f lSize>pPager->jo
10d00 75 72 6e 61 6c 4f 66 66 0a 20 20 29 7b 0a 20 20 urnalOff. ){.
10d10 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33 4f 73 rc = sqlite3Os
10d20 54 72 75 6e 63 61 74 65 28 70 50 61 67 65 72 2d Truncate(pPager-
10d30 3e 6a 66 64 2c 20 70 50 61 67 65 72 2d 3e 6a 6f >jfd, pPager->jo
10d40 75 72 6e 61 6c 4f 66 66 29 3b 0a 20 20 7d 0a 20 urnalOff);. }.
10d50 20 72 65 74 75 72 6e 20 72 63 3b 0a 7d 0a 0a 2f return rc;.}../
10d60 2a 0a 2a 2a 20 46 69 6e 64 20 61 20 70 61 67 65 *.** Find a page
10d70 20 69 6e 20 74 68 65 20 68 61 73 68 20 74 61 62 in the hash tab
10d80 6c 65 20 67 69 76 65 6e 20 69 74 73 20 70 61 67 le given its pag
10d90 65 20 6e 75 6d 62 65 72 2e 20 52 65 74 75 72 6e e number. Return
10da0 0a 2a 2a 20 61 20 70 6f 69 6e 74 65 72 20 74 6f .** a pointer to
10db0 20 74 68 65 20 70 61 67 65 20 6f 72 20 4e 55 4c the page or NUL
10dc0 4c 20 69 66 20 74 68 65 20 72 65 71 75 65 73 74 L if the request
10dd0 65 64 20 70 61 67 65 20 69 73 20 6e 6f 74 20 0a ed page is not .
10de0 2a 2a 20 61 6c 72 65 61 64 79 20 69 6e 20 6d 65 ** already in me
10df0 6d 6f 72 79 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 mory..*/.static
10e00 50 67 48 64 72 20 2a 70 61 67 65 72 5f 6c 6f 6f PgHdr *pager_loo
10e10 6b 75 70 28 50 61 67 65 72 20 2a 70 50 61 67 65 kup(Pager *pPage
10e20 72 2c 20 50 67 6e 6f 20 70 67 6e 6f 29 7b 0a 20 r, Pgno pgno){.
10e30 20 50 67 48 64 72 20 2a 70 3b 20 20 20 20 20 20 PgHdr *p;
10e40 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
10e50 20 20 20 2f 2a 20 52 65 74 75 72 6e 20 76 61 6c /* Return val
10e60 75 65 20 2a 2f 0a 0a 20 20 2f 2a 20 49 74 20 69 ue */.. /* It i
10e70 73 20 6e 6f 74 20 70 6f 73 73 69 62 6c 65 20 66 s not possible f
10e80 6f 72 20 61 20 63 61 6c 6c 20 74 6f 20 50 63 61 or a call to Pca
10e90 63 68 65 46 65 74 63 68 28 29 20 77 69 74 68 20 cheFetch() with
10ea0 63 72 65 61 74 65 46 6c 61 67 3d 3d 30 20 74 6f createFlag==0 to
10eb0 0a 20 20 2a 2a 20 66 61 69 6c 2c 20 73 69 6e 63 . ** fail, sinc
10ec0 65 20 6e 6f 20 61 74 74 65 6d 70 74 20 74 6f 20 e no attempt to
10ed0 61 6c 6c 6f 63 61 74 65 20 64 79 6e 61 6d 69 63 allocate dynamic
10ee0 20 6d 65 6d 6f 72 79 20 77 69 6c 6c 20 62 65 20 memory will be
10ef0 6d 61 64 65 2e 0a 20 20 2a 2f 0a 20 20 28 76 6f made.. */. (vo
10f00 69 64 29 73 71 6c 69 74 65 33 50 63 61 63 68 65 id)sqlite3Pcache
10f10 46 65 74 63 68 28 70 50 61 67 65 72 2d 3e 70 50 Fetch(pPager->pP
10f20 43 61 63 68 65 2c 20 70 67 6e 6f 2c 20 30 2c 20 Cache, pgno, 0,
10f30 26 70 29 3b 0a 20 20 72 65 74 75 72 6e 20 70 3b &p);. return p;
10f40 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 44 69 73 63 61 72 .}../*.** Discar
10f50 64 20 74 68 65 20 65 6e 74 69 72 65 20 63 6f 6e d the entire con
10f60 74 65 6e 74 73 20 6f 66 20 74 68 65 20 69 6e 2d tents of the in-
10f70 6d 65 6d 6f 72 79 20 70 61 67 65 2d 63 61 63 68 memory page-cach
10f80 65 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 76 6f 69 e..*/.static voi
10f90 64 20 70 61 67 65 72 5f 72 65 73 65 74 28 50 61 d pager_reset(Pa
10fa0 67 65 72 20 2a 70 50 61 67 65 72 29 7b 0a 20 20 ger *pPager){.
10fb0 73 71 6c 69 74 65 33 42 61 63 6b 75 70 52 65 73 sqlite3BackupRes
10fc0 74 61 72 74 28 70 50 61 67 65 72 2d 3e 70 42 61 tart(pPager->pBa
10fd0 63 6b 75 70 29 3b 0a 20 20 73 71 6c 69 74 65 33 ckup);. sqlite3
10fe0 50 63 61 63 68 65 43 6c 65 61 72 28 70 50 61 67 PcacheClear(pPag
10ff0 65 72 2d 3e 70 50 43 61 63 68 65 29 3b 0a 7d 0a er->pPCache);.}.
11000 0a 2f 2a 0a 2a 2a 20 46 72 65 65 20 61 6c 6c 20 ./*.** Free all
11010 73 74 72 75 63 74 75 72 65 73 20 69 6e 20 74 68 structures in th
11020 65 20 50 61 67 65 72 2e 61 53 61 76 65 70 6f 69 e Pager.aSavepoi
11030 6e 74 5b 5d 20 61 72 72 61 79 20 61 6e 64 20 73 nt[] array and s
11040 65 74 20 62 6f 74 68 0a 2a 2a 20 50 61 67 65 72 et both.** Pager
11050 2e 61 53 61 76 65 70 6f 69 6e 74 20 61 6e 64 20 .aSavepoint and
11060 50 61 67 65 72 2e 6e 53 61 76 65 70 6f 69 6e 74 Pager.nSavepoint
11070 20 74 6f 20 7a 65 72 6f 2e 20 43 6c 6f 73 65 20 to zero. Close
11080 74 68 65 20 73 75 62 2d 6a 6f 75 72 6e 61 6c 0a the sub-journal.
11090 2a 2a 20 69 66 20 69 74 20 69 73 20 6f 70 65 6e ** if it is open
110a0 20 61 6e 64 20 74 68 65 20 70 61 67 65 72 20 69 and the pager i
110b0 73 20 6e 6f 74 20 69 6e 20 65 78 63 6c 75 73 69 s not in exclusi
110c0 76 65 20 6d 6f 64 65 2e 0a 2a 2f 0a 73 74 61 74 ve mode..*/.stat
110d0 69 63 20 76 6f 69 64 20 72 65 6c 65 61 73 65 41 ic void releaseA
110e0 6c 6c 53 61 76 65 70 6f 69 6e 74 73 28 50 61 67 llSavepoints(Pag
110f0 65 72 20 2a 70 50 61 67 65 72 29 7b 0a 20 20 69 er *pPager){. i
11100 6e 74 20 69 69 3b 20 20 20 20 20 20 20 20 20 20 nt ii;
11110 20 20 20 20 20 2f 2a 20 49 74 65 72 61 74 6f 72 /* Iterator
11120 20 66 6f 72 20 6c 6f 6f 70 69 6e 67 20 74 68 72 for looping thr
11130 6f 75 67 68 20 50 61 67 65 72 2e 61 53 61 76 65 ough Pager.aSave
11140 70 6f 69 6e 74 20 2a 2f 0a 20 20 66 6f 72 28 69 point */. for(i
11150 69 3d 30 3b 20 69 69 3c 70 50 61 67 65 72 2d 3e i=0; ii<pPager->
11160 6e 53 61 76 65 70 6f 69 6e 74 3b 20 69 69 2b 2b nSavepoint; ii++
11170 29 7b 0a 20 20 20 20 73 71 6c 69 74 65 33 42 69 ){. sqlite3Bi
11180 74 76 65 63 44 65 73 74 72 6f 79 28 70 50 61 67 tvecDestroy(pPag
11190 65 72 2d 3e 61 53 61 76 65 70 6f 69 6e 74 5b 69 er->aSavepoint[i
111a0 69 5d 2e 70 49 6e 53 61 76 65 70 6f 69 6e 74 29 i].pInSavepoint)
111b0 3b 0a 20 20 7d 0a 20 20 69 66 28 20 21 70 50 61 ;. }. if( !pPa
111c0 67 65 72 2d 3e 65 78 63 6c 75 73 69 76 65 4d 6f ger->exclusiveMo
111d0 64 65 20 7c 7c 20 73 71 6c 69 74 65 33 49 73 4d de || sqlite3IsM
111e0 65 6d 4a 6f 75 72 6e 61 6c 28 70 50 61 67 65 72 emJournal(pPager
111f0 2d 3e 73 6a 66 64 29 20 29 7b 0a 20 20 20 20 73 ->sjfd) ){. s
11200 71 6c 69 74 65 33 4f 73 43 6c 6f 73 65 28 70 50 qlite3OsClose(pP
11210 61 67 65 72 2d 3e 73 6a 66 64 29 3b 0a 20 20 7d ager->sjfd);. }
11220 0a 20 20 73 71 6c 69 74 65 33 5f 66 72 65 65 28 . sqlite3_free(
11230 70 50 61 67 65 72 2d 3e 61 53 61 76 65 70 6f 69 pPager->aSavepoi
11240 6e 74 29 3b 0a 20 20 70 50 61 67 65 72 2d 3e 61 nt);. pPager->a
11250 53 61 76 65 70 6f 69 6e 74 20 3d 20 30 3b 0a 20 Savepoint = 0;.
11260 20 70 50 61 67 65 72 2d 3e 6e 53 61 76 65 70 6f pPager->nSavepo
11270 69 6e 74 20 3d 20 30 3b 0a 20 20 70 50 61 67 65 int = 0;. pPage
11280 72 2d 3e 6e 53 75 62 52 65 63 20 3d 20 30 3b 0a r->nSubRec = 0;.
11290 7d 0a 0a 2f 2a 0a 2a 2a 20 53 65 74 20 74 68 65 }../*.** Set the
112a0 20 62 69 74 20 6e 75 6d 62 65 72 20 70 67 6e 6f bit number pgno
112b0 20 69 6e 20 74 68 65 20 50 61 67 65 72 53 61 76 in the PagerSav
112c0 65 70 6f 69 6e 74 2e 70 49 6e 53 61 76 65 70 6f epoint.pInSavepo
112d0 69 6e 74 20 0a 2a 2a 20 62 69 74 76 65 63 73 20 int .** bitvecs
112e0 6f 66 20 61 6c 6c 20 6f 70 65 6e 20 73 61 76 65 of all open save
112f0 70 6f 69 6e 74 73 2e 20 52 65 74 75 72 6e 20 53 points. Return S
11300 51 4c 49 54 45 5f 4f 4b 20 69 66 20 73 75 63 63 QLITE_OK if succ
11310 65 73 73 66 75 6c 0a 2a 2a 20 6f 72 20 53 51 4c essful.** or SQL
11320 49 54 45 5f 4e 4f 4d 45 4d 20 69 66 20 61 20 6d ITE_NOMEM if a m
11330 61 6c 6c 6f 63 20 66 61 69 6c 75 72 65 20 6f 63 alloc failure oc
11340 63 75 72 73 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 curs..*/.static
11350 69 6e 74 20 61 64 64 54 6f 53 61 76 65 70 6f 69 int addToSavepoi
11360 6e 74 42 69 74 76 65 63 73 28 50 61 67 65 72 20 ntBitvecs(Pager
11370 2a 70 50 61 67 65 72 2c 20 50 67 6e 6f 20 70 67 *pPager, Pgno pg
11380 6e 6f 29 7b 0a 20 20 69 6e 74 20 69 69 3b 20 20 no){. int ii;
11390 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
113a0 20 2f 2a 20 4c 6f 6f 70 20 63 6f 75 6e 74 65 72 /* Loop counter
113b0 20 2a 2f 0a 20 20 69 6e 74 20 72 63 20 3d 20 53 */. int rc = S
113c0 51 4c 49 54 45 5f 4f 4b 3b 20 20 20 20 20 20 20 QLITE_OK;
113d0 2f 2a 20 52 65 73 75 6c 74 20 63 6f 64 65 20 2a /* Result code *
113e0 2f 0a 0a 20 20 66 6f 72 28 69 69 3d 30 3b 20 69 /.. for(ii=0; i
113f0 69 3c 70 50 61 67 65 72 2d 3e 6e 53 61 76 65 70 i<pPager->nSavep
11400 6f 69 6e 74 3b 20 69 69 2b 2b 29 7b 0a 20 20 20 oint; ii++){.
11410 20 50 61 67 65 72 53 61 76 65 70 6f 69 6e 74 20 PagerSavepoint
11420 2a 70 20 3d 20 26 70 50 61 67 65 72 2d 3e 61 53 *p = &pPager->aS
11430 61 76 65 70 6f 69 6e 74 5b 69 69 5d 3b 0a 20 20 avepoint[ii];.
11440 20 20 69 66 28 20 70 67 6e 6f 3c 3d 70 2d 3e 6e if( pgno<=p->n
11450 4f 72 69 67 20 29 7b 0a 20 20 20 20 20 20 72 63 Orig ){. rc
11460 20 7c 3d 20 73 71 6c 69 74 65 33 42 69 74 76 65 |= sqlite3Bitve
11470 63 53 65 74 28 70 2d 3e 70 49 6e 53 61 76 65 70 cSet(p->pInSavep
11480 6f 69 6e 74 2c 20 70 67 6e 6f 29 3b 0a 20 20 20 oint, pgno);.
11490 20 20 20 74 65 73 74 63 61 73 65 28 20 72 63 3d testcase( rc=
114a0 3d 53 51 4c 49 54 45 5f 4e 4f 4d 45 4d 20 29 3b =SQLITE_NOMEM );
114b0 0a 20 20 20 20 20 20 61 73 73 65 72 74 28 20 72 . assert( r
114c0 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 7c 7c 20 c==SQLITE_OK ||
114d0 72 63 3d 3d 53 51 4c 49 54 45 5f 4e 4f 4d 45 4d rc==SQLITE_NOMEM
114e0 20 29 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a 20 20 );. }. }.
114f0 72 65 74 75 72 6e 20 72 63 3b 0a 7d 0a 0a 2f 2a return rc;.}../*
11500 0a 2a 2a 20 54 68 69 73 20 66 75 6e 63 74 69 6f .** This functio
11510 6e 20 69 73 20 61 20 6e 6f 2d 6f 70 20 69 66 20 n is a no-op if
11520 74 68 65 20 70 61 67 65 72 20 69 73 20 69 6e 20 the pager is in
11530 65 78 63 6c 75 73 69 76 65 20 6d 6f 64 65 20 61 exclusive mode a
11540 6e 64 20 6e 6f 74 0a 2a 2a 20 69 6e 20 74 68 65 nd not.** in the
11550 20 45 52 52 4f 52 20 73 74 61 74 65 2e 20 4f 74 ERROR state. Ot
11560 68 65 72 77 69 73 65 2c 20 69 74 20 73 77 69 74 herwise, it swit
11570 63 68 65 73 20 74 68 65 20 70 61 67 65 72 20 74 ches the pager t
11580 6f 20 50 41 47 45 52 5f 4f 50 45 4e 0a 2a 2a 20 o PAGER_OPEN.**
11590 73 74 61 74 65 2e 0a 2a 2a 0a 2a 2a 20 49 66 20 state..**.** If
115a0 74 68 65 20 70 61 67 65 72 20 69 73 20 6e 6f 74 the pager is not
115b0 20 69 6e 20 65 78 63 6c 75 73 69 76 65 2d 61 63 in exclusive-ac
115c0 63 65 73 73 20 6d 6f 64 65 2c 20 74 68 65 20 64 cess mode, the d
115d0 61 74 61 62 61 73 65 20 66 69 6c 65 20 69 73 0a atabase file is.
115e0 2a 2a 20 63 6f 6d 70 6c 65 74 65 6c 79 20 75 6e ** completely un
115f0 6c 6f 63 6b 65 64 2e 20 49 66 20 74 68 65 20 66 locked. If the f
11600 69 6c 65 20 69 73 20 75 6e 6c 6f 63 6b 65 64 20 ile is unlocked
11610 61 6e 64 20 74 68 65 20 66 69 6c 65 2d 73 79 73 and the file-sys
11620 74 65 6d 20 64 6f 65 73 0a 2a 2a 20 6e 6f 74 20 tem does.** not
11630 65 78 68 69 62 69 74 20 74 68 65 20 55 4e 44 45 exhibit the UNDE
11640 4c 45 54 41 42 4c 45 5f 57 48 45 4e 5f 4f 50 45 LETABLE_WHEN_OPE
11650 4e 20 70 72 6f 70 65 72 74 79 2c 20 74 68 65 20 N property, the
11660 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 20 69 73 0a journal file is.
11670 2a 2a 20 63 6c 6f 73 65 64 20 28 69 66 20 69 74 ** closed (if it
11680 20 69 73 20 6f 70 65 6e 29 2e 0a 2a 2a 0a 2a 2a is open)..**.**
11690 20 49 66 20 74 68 65 20 70 61 67 65 72 20 69 73 If the pager is
116a0 20 69 6e 20 45 52 52 4f 52 20 73 74 61 74 65 20 in ERROR state
116b0 77 68 65 6e 20 74 68 69 73 20 66 75 6e 63 74 69 when this functi
116c0 6f 6e 20 69 73 20 63 61 6c 6c 65 64 2c 20 74 68 on is called, th
116d0 65 20 0a 2a 2a 20 63 6f 6e 74 65 6e 74 73 20 6f e .** contents o
116e0 66 20 74 68 65 20 70 61 67 65 72 20 63 61 63 68 f the pager cach
116f0 65 20 61 72 65 20 64 69 73 63 61 72 64 65 64 20 e are discarded
11700 62 65 66 6f 72 65 20 73 77 69 74 63 68 69 6e 67 before switching
11710 20 62 61 63 6b 20 74 6f 20 0a 2a 2a 20 74 68 65 back to .** the
11720 20 4f 50 45 4e 20 73 74 61 74 65 2e 20 52 65 67 OPEN state. Reg
11730 61 72 64 6c 65 73 73 20 6f 66 20 77 68 65 74 68 ardless of wheth
11740 65 72 20 74 68 65 20 70 61 67 65 72 20 69 73 20 er the pager is
11750 69 6e 20 65 78 63 6c 75 73 69 76 65 2d 6d 6f 64 in exclusive-mod
11760 65 0a 2a 2a 20 6f 72 20 6e 6f 74 2c 20 61 6e 79 e.** or not, any
11770 20 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 20 6c 65 journal file le
11780 66 74 20 69 6e 20 74 68 65 20 66 69 6c 65 2d 73 ft in the file-s
11790 79 73 74 65 6d 20 77 69 6c 6c 20 62 65 20 74 72 ystem will be tr
117a0 65 61 74 65 64 0a 2a 2a 20 61 73 20 61 20 68 6f eated.** as a ho
117b0 74 2d 6a 6f 75 72 6e 61 6c 20 61 6e 64 20 72 6f t-journal and ro
117c0 6c 6c 65 64 20 62 61 63 6b 20 74 68 65 20 6e 65 lled back the ne
117d0 78 74 20 74 69 6d 65 20 61 20 72 65 61 64 2d 74 xt time a read-t
117e0 72 61 6e 73 61 63 74 69 6f 6e 0a 2a 2a 20 69 73 ransaction.** is
117f0 20 6f 70 65 6e 65 64 20 28 62 79 20 74 68 69 73 opened (by this
11800 20 6f 72 20 62 79 20 61 6e 79 20 6f 74 68 65 72 or by any other
11810 20 63 6f 6e 6e 65 63 74 69 6f 6e 29 2e 0a 2a 2f connection)..*/
11820 0a 73 74 61 74 69 63 20 76 6f 69 64 20 70 61 67 .static void pag
11830 65 72 5f 75 6e 6c 6f 63 6b 28 50 61 67 65 72 20 er_unlock(Pager
11840 2a 70 50 61 67 65 72 29 7b 0a 0a 20 20 61 73 73 *pPager){.. ass
11850 65 72 74 28 20 70 50 61 67 65 72 2d 3e 65 53 74 ert( pPager->eSt
11860 61 74 65 3d 3d 50 41 47 45 52 5f 52 45 41 44 45 ate==PAGER_READE
11870 52 20 0a 20 20 20 20 20 20 20 7c 7c 20 70 50 61 R . || pPa
11880 67 65 72 2d 3e 65 53 74 61 74 65 3d 3d 50 41 47 ger->eState==PAG
11890 45 52 5f 4f 50 45 4e 20 0a 20 20 20 20 20 20 20 ER_OPEN .
118a0 7c 7c 20 70 50 61 67 65 72 2d 3e 65 53 74 61 74 || pPager->eStat
118b0 65 3d 3d 50 41 47 45 52 5f 45 52 52 4f 52 20 0a e==PAGER_ERROR .
118c0 20 20 29 3b 0a 0a 20 20 73 71 6c 69 74 65 33 42 );.. sqlite3B
118d0 69 74 76 65 63 44 65 73 74 72 6f 79 28 70 50 61 itvecDestroy(pPa
118e0 67 65 72 2d 3e 70 49 6e 4a 6f 75 72 6e 61 6c 29 ger->pInJournal)
118f0 3b 0a 20 20 70 50 61 67 65 72 2d 3e 70 49 6e 4a ;. pPager->pInJ
11900 6f 75 72 6e 61 6c 20 3d 20 30 3b 0a 20 20 72 65 ournal = 0;. re
11910 6c 65 61 73 65 41 6c 6c 53 61 76 65 70 6f 69 6e leaseAllSavepoin
11920 74 73 28 70 50 61 67 65 72 29 3b 0a 0a 20 20 69 ts(pPager);.. i
11930 66 28 20 70 61 67 65 72 55 73 65 57 61 6c 28 70 f( pagerUseWal(p
11940 50 61 67 65 72 29 20 29 7b 0a 20 20 20 20 61 73 Pager) ){. as
11950 73 65 72 74 28 20 21 69 73 4f 70 65 6e 28 70 50 sert( !isOpen(pP
11960 61 67 65 72 2d 3e 6a 66 64 29 20 29 3b 0a 20 20 ager->jfd) );.
11970 20 20 73 71 6c 69 74 65 33 57 61 6c 45 6e 64 52 sqlite3WalEndR
11980 65 61 64 54 72 61 6e 73 61 63 74 69 6f 6e 28 70 eadTransaction(p
11990 50 61 67 65 72 2d 3e 70 57 61 6c 29 3b 0a 20 20 Pager->pWal);.
119a0 20 20 70 50 61 67 65 72 2d 3e 65 53 74 61 74 65 pPager->eState
119b0 20 3d 20 50 41 47 45 52 5f 4f 50 45 4e 3b 0a 20 = PAGER_OPEN;.
119c0 20 7d 65 6c 73 65 20 69 66 28 20 21 70 50 61 67 }else if( !pPag
119d0 65 72 2d 3e 65 78 63 6c 75 73 69 76 65 4d 6f 64 er->exclusiveMod
119e0 65 20 29 7b 0a 20 20 20 20 69 6e 74 20 72 63 3b e ){. int rc;
119f0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
11a00 20 20 20 20 20 20 20 2f 2a 20 45 72 72 6f 72 20 /* Error
11a10 63 6f 64 65 20 72 65 74 75 72 6e 65 64 20 62 79 code returned by
11a20 20 70 61 67 65 72 55 6e 6c 6f 63 6b 44 62 28 29 pagerUnlockDb()
11a30 20 2a 2f 0a 20 20 20 20 69 6e 74 20 69 44 63 20 */. int iDc
11a40 3d 20 69 73 4f 70 65 6e 28 70 50 61 67 65 72 2d = isOpen(pPager-
11a50 3e 66 64 29 3f 73 71 6c 69 74 65 33 4f 73 44 65 >fd)?sqlite3OsDe
11a60 76 69 63 65 43 68 61 72 61 63 74 65 72 69 73 74 viceCharacterist
11a70 69 63 73 28 70 50 61 67 65 72 2d 3e 66 64 29 3a ics(pPager->fd):
11a80 30 3b 0a 0a 20 20 20 20 2f 2a 20 49 66 20 74 68 0;.. /* If th
11a90 65 20 6f 70 65 72 61 74 69 6e 67 20 73 79 73 74 e operating syst
11aa0 65 6d 20 73 75 70 70 6f 72 74 20 64 65 6c 65 74 em support delet
11ab0 69 6f 6e 20 6f 66 20 6f 70 65 6e 20 66 69 6c 65 ion of open file
11ac0 73 2c 20 74 68 65 6e 0a 20 20 20 20 2a 2a 20 63 s, then. ** c
11ad0 6c 6f 73 65 20 74 68 65 20 6a 6f 75 72 6e 61 6c lose the journal
11ae0 20 66 69 6c 65 20 77 68 65 6e 20 64 72 6f 70 70 file when dropp
11af0 69 6e 67 20 74 68 65 20 64 61 74 61 62 61 73 65 ing the database
11b00 20 6c 6f 63 6b 2e 20 20 4f 74 68 65 72 77 69 73 lock. Otherwis
11b10 65 0a 20 20 20 20 2a 2a 20 61 6e 6f 74 68 65 72 e. ** another
11b20 20 63 6f 6e 6e 65 63 74 69 6f 6e 20 77 69 74 68 connection with
11b30 20 6a 6f 75 72 6e 61 6c 5f 6d 6f 64 65 3d 64 65 journal_mode=de
11b40 6c 65 74 65 20 6d 69 67 68 74 20 64 65 6c 65 74 lete might delet
11b50 65 20 74 68 65 20 66 69 6c 65 0a 20 20 20 20 2a e the file. *
11b60 2a 20 6f 75 74 20 66 72 6f 6d 20 75 6e 64 65 72 * out from under
11b70 20 75 73 2e 0a 20 20 20 20 2a 2f 0a 20 20 20 20 us.. */.
11b80 61 73 73 65 72 74 28 20 28 50 41 47 45 52 5f 4a assert( (PAGER_J
11b90 4f 55 52 4e 41 4c 4d 4f 44 45 5f 4d 45 4d 4f 52 OURNALMODE_MEMOR
11ba0 59 20 20 20 26 20 35 29 21 3d 31 20 29 3b 0a 20 Y & 5)!=1 );.
11bb0 20 20 20 61 73 73 65 72 74 28 20 28 50 41 47 45 assert( (PAGE
11bc0 52 5f 4a 4f 55 52 4e 41 4c 4d 4f 44 45 5f 4f 46 R_JOURNALMODE_OF
11bd0 46 20 20 20 20 20 20 26 20 35 29 21 3d 31 20 29 F & 5)!=1 )
11be0 3b 0a 20 20 20 20 61 73 73 65 72 74 28 20 28 50 ;. assert( (P
11bf0 41 47 45 52 5f 4a 4f 55 52 4e 41 4c 4d 4f 44 45 AGER_JOURNALMODE
11c00 5f 57 41 4c 20 20 20 20 20 20 26 20 35 29 21 3d _WAL & 5)!=
11c10 31 20 29 3b 0a 20 20 20 20 61 73 73 65 72 74 28 1 );. assert(
11c20 20 28 50 41 47 45 52 5f 4a 4f 55 52 4e 41 4c 4d (PAGER_JOURNALM
11c30 4f 44 45 5f 44 45 4c 45 54 45 20 20 20 26 20 35 ODE_DELETE & 5
11c40 29 21 3d 31 20 29 3b 0a 20 20 20 20 61 73 73 65 )!=1 );. asse
11c50 72 74 28 20 28 50 41 47 45 52 5f 4a 4f 55 52 4e rt( (PAGER_JOURN
11c60 41 4c 4d 4f 44 45 5f 54 52 55 4e 43 41 54 45 20 ALMODE_TRUNCATE
11c70 26 20 35 29 3d 3d 31 20 29 3b 0a 20 20 20 20 61 & 5)==1 );. a
11c80 73 73 65 72 74 28 20 28 50 41 47 45 52 5f 4a 4f ssert( (PAGER_JO
11c90 55 52 4e 41 4c 4d 4f 44 45 5f 50 45 52 53 49 53 URNALMODE_PERSIS
11ca0 54 20 20 26 20 35 29 3d 3d 31 20 29 3b 0a 20 20 T & 5)==1 );.
11cb0 20 20 69 66 28 20 30 3d 3d 28 69 44 63 20 26 20 if( 0==(iDc &
11cc0 53 51 4c 49 54 45 5f 49 4f 43 41 50 5f 55 4e 44 SQLITE_IOCAP_UND
11cd0 45 4c 45 54 41 42 4c 45 5f 57 48 45 4e 5f 4f 50 ELETABLE_WHEN_OP
11ce0 45 4e 29 0a 20 20 20 20 20 7c 7c 20 31 21 3d 28 EN). || 1!=(
11cf0 70 50 61 67 65 72 2d 3e 6a 6f 75 72 6e 61 6c 4d pPager->journalM
11d00 6f 64 65 20 26 20 35 29 0a 20 20 20 20 29 7b 0a ode & 5). ){.
11d10 20 20 20 20 20 20 73 71 6c 69 74 65 33 4f 73 43 sqlite3OsC
11d20 6c 6f 73 65 28 70 50 61 67 65 72 2d 3e 6a 66 64 lose(pPager->jfd
11d30 29 3b 0a 20 20 20 20 7d 0a 0a 20 20 20 20 2f 2a );. }.. /*
11d40 20 49 66 20 74 68 65 20 70 61 67 65 72 20 69 73 If the pager is
11d50 20 69 6e 20 74 68 65 20 45 52 52 4f 52 20 73 74 in the ERROR st
11d60 61 74 65 20 61 6e 64 20 74 68 65 20 63 61 6c 6c ate and the call
11d70 20 74 6f 20 75 6e 6c 6f 63 6b 20 74 68 65 20 64 to unlock the d
11d80 61 74 61 62 61 73 65 0a 20 20 20 20 2a 2a 20 66 atabase. ** f
11d90 69 6c 65 20 66 61 69 6c 73 2c 20 73 65 74 20 74 ile fails, set t
11da0 68 65 20 63 75 72 72 65 6e 74 20 6c 6f 63 6b 20 he current lock
11db0 74 6f 20 55 4e 4b 4e 4f 57 4e 5f 4c 4f 43 4b 2e to UNKNOWN_LOCK.
11dc0 20 53 65 65 20 74 68 65 20 63 6f 6d 6d 65 6e 74 See the comment
11dd0 0a 20 20 20 20 2a 2a 20 61 62 6f 76 65 20 74 68 . ** above th
11de0 65 20 23 64 65 66 69 6e 65 20 66 6f 72 20 55 4e e #define for UN
11df0 4b 4e 4f 57 4e 5f 4c 4f 43 4b 20 66 6f 72 20 61 KNOWN_LOCK for a
11e00 6e 20 65 78 70 6c 61 6e 61 74 69 6f 6e 20 6f 66 n explanation of
11e10 20 77 68 79 20 74 68 69 73 0a 20 20 20 20 2a 2a why this. **
11e20 20 69 73 20 6e 65 63 65 73 73 61 72 79 2e 0a 20 is necessary..
11e30 20 20 20 2a 2f 0a 20 20 20 20 72 63 20 3d 20 70 */. rc = p
11e40 61 67 65 72 55 6e 6c 6f 63 6b 44 62 28 70 50 61 agerUnlockDb(pPa
11e50 67 65 72 2c 20 4e 4f 5f 4c 4f 43 4b 29 3b 0a 20 ger, NO_LOCK);.
11e60 20 20 20 69 66 28 20 72 63 21 3d 53 51 4c 49 54 if( rc!=SQLIT
11e70 45 5f 4f 4b 20 26 26 20 70 50 61 67 65 72 2d 3e E_OK && pPager->
11e80 65 53 74 61 74 65 3d 3d 50 41 47 45 52 5f 45 52 eState==PAGER_ER
11e90 52 4f 52 20 29 7b 0a 20 20 20 20 20 20 70 50 61 ROR ){. pPa
11ea0 67 65 72 2d 3e 65 4c 6f 63 6b 20 3d 20 55 4e 4b ger->eLock = UNK
11eb0 4e 4f 57 4e 5f 4c 4f 43 4b 3b 0a 20 20 20 20 7d NOWN_LOCK;. }
11ec0 0a 0a 20 20 20 20 2f 2a 20 54 68 65 20 70 61 67 .. /* The pag
11ed0 65 72 20 73 74 61 74 65 20 6d 61 79 20 62 65 20 er state may be
11ee0 63 68 61 6e 67 65 64 20 66 72 6f 6d 20 50 41 47 changed from PAG
11ef0 45 52 5f 45 52 52 4f 52 20 74 6f 20 50 41 47 45 ER_ERROR to PAGE
11f00 52 5f 4f 50 45 4e 20 68 65 72 65 0a 20 20 20 20 R_OPEN here.
11f10 2a 2a 20 77 69 74 68 6f 75 74 20 63 6c 65 61 72 ** without clear
11f20 69 6e 67 20 74 68 65 20 65 72 72 6f 72 20 63 6f ing the error co
11f30 64 65 2e 20 54 68 69 73 20 69 73 20 69 6e 74 65 de. This is inte
11f40 6e 74 69 6f 6e 61 6c 20 2d 20 74 68 65 20 65 72 ntional - the er
11f50 72 6f 72 0a 20 20 20 20 2a 2a 20 63 6f 64 65 20 ror. ** code
11f60 69 73 20 63 6c 65 61 72 65 64 20 61 6e 64 20 74 is cleared and t
11f70 68 65 20 63 61 63 68 65 20 72 65 73 65 74 20 69 he cache reset i
11f80 6e 20 74 68 65 20 62 6c 6f 63 6b 20 62 65 6c 6f n the block belo
11f90 77 2e 0a 20 20 20 20 2a 2f 0a 20 20 20 20 61 73 w.. */. as
11fa0 73 65 72 74 28 20 70 50 61 67 65 72 2d 3e 65 72 sert( pPager->er
11fb0 72 43 6f 64 65 20 7c 7c 20 70 50 61 67 65 72 2d rCode || pPager-
11fc0 3e 65 53 74 61 74 65 21 3d 50 41 47 45 52 5f 45 >eState!=PAGER_E
11fd0 52 52 4f 52 20 29 3b 0a 20 20 20 20 70 50 61 67 RROR );. pPag
11fe0 65 72 2d 3e 63 68 61 6e 67 65 43 6f 75 6e 74 44 er->changeCountD
11ff0 6f 6e 65 20 3d 20 30 3b 0a 20 20 20 20 70 50 61 one = 0;. pPa
12000 67 65 72 2d 3e 65 53 74 61 74 65 20 3d 20 50 41 ger->eState = PA
12010 47 45 52 5f 4f 50 45 4e 3b 0a 20 20 7d 0a 0a 20 GER_OPEN;. }..
12020 20 2f 2a 20 49 66 20 50 61 67 65 72 2e 65 72 72 /* If Pager.err
12030 43 6f 64 65 20 69 73 20 73 65 74 2c 20 74 68 65 Code is set, the
12040 20 63 6f 6e 74 65 6e 74 73 20 6f 66 20 74 68 65 contents of the
12050 20 70 61 67 65 72 20 63 61 63 68 65 20 63 61 6e pager cache can
12060 6e 6f 74 20 62 65 0a 20 20 2a 2a 20 74 72 75 73 not be. ** trus
12070 74 65 64 2e 20 4e 6f 77 20 74 68 61 74 20 74 68 ted. Now that th
12080 65 72 65 20 61 72 65 20 6e 6f 20 6f 75 74 73 74 ere are no outst
12090 61 6e 64 69 6e 67 20 72 65 66 65 72 65 6e 63 65 anding reference
120a0 73 20 74 6f 20 74 68 65 20 70 61 67 65 72 2c 0a s to the pager,.
120b0 20 20 2a 2a 20 69 74 20 63 61 6e 20 73 61 66 65 ** it can safe
120c0 6c 79 20 6d 6f 76 65 20 62 61 63 6b 20 74 6f 20 ly move back to
120d0 50 41 47 45 52 5f 4f 50 45 4e 20 73 74 61 74 65 PAGER_OPEN state
120e0 2e 20 54 68 69 73 20 68 61 70 70 65 6e 73 20 69 . This happens i
120f0 6e 20 62 6f 74 68 0a 20 20 2a 2a 20 6e 6f 72 6d n both. ** norm
12100 61 6c 20 61 6e 64 20 65 78 63 6c 75 73 69 76 65 al and exclusive
12110 2d 6c 6f 63 6b 69 6e 67 20 6d 6f 64 65 2e 0a 20 -locking mode..
12120 20 2a 2f 0a 20 20 69 66 28 20 70 50 61 67 65 72 */. if( pPager
12130 2d 3e 65 72 72 43 6f 64 65 20 29 7b 0a 20 20 20 ->errCode ){.
12140 20 61 73 73 65 72 74 28 20 21 4d 45 4d 44 42 20 assert( !MEMDB
12150 29 3b 0a 20 20 20 20 70 61 67 65 72 5f 72 65 73 );. pager_res
12160 65 74 28 70 50 61 67 65 72 29 3b 0a 20 20 20 20 et(pPager);.
12170 70 50 61 67 65 72 2d 3e 63 68 61 6e 67 65 43 6f pPager->changeCo
12180 75 6e 74 44 6f 6e 65 20 3d 20 70 50 61 67 65 72 untDone = pPager
12190 2d 3e 74 65 6d 70 46 69 6c 65 3b 0a 20 20 20 20 ->tempFile;.
121a0 70 50 61 67 65 72 2d 3e 65 53 74 61 74 65 20 3d pPager->eState =
121b0 20 50 41 47 45 52 5f 4f 50 45 4e 3b 0a 20 20 20 PAGER_OPEN;.
121c0 20 70 50 61 67 65 72 2d 3e 65 72 72 43 6f 64 65 pPager->errCode
121d0 20 3d 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20 20 = SQLITE_OK;.
121e0 7d 0a 0a 20 20 70 50 61 67 65 72 2d 3e 6a 6f 75 }.. pPager->jou
121f0 72 6e 61 6c 4f 66 66 20 3d 20 30 3b 0a 20 20 70 rnalOff = 0;. p
12200 50 61 67 65 72 2d 3e 6a 6f 75 72 6e 61 6c 48 64 Pager->journalHd
12210 72 20 3d 20 30 3b 0a 20 20 70 50 61 67 65 72 2d r = 0;. pPager-
12220 3e 73 65 74 4d 61 73 74 65 72 20 3d 20 30 3b 0a >setMaster = 0;.
12230 7d 0a 0a 2f 2a 0a 2a 2a 20 54 68 69 73 20 66 75 }../*.** This fu
12240 6e 63 74 69 6f 6e 20 69 73 20 63 61 6c 6c 65 64 nction is called
12250 20 77 68 65 6e 65 76 65 72 20 61 6e 20 49 4f 45 whenever an IOE
12260 52 52 20 6f 72 20 46 55 4c 4c 20 65 72 72 6f 72 RR or FULL error
12270 20 74 68 61 74 20 72 65 71 75 69 72 65 73 0a 2a that requires.*
12280 2a 20 74 68 65 20 70 61 67 65 72 20 74 6f 20 74 * the pager to t
12290 72 61 6e 73 69 74 69 6f 6e 20 69 6e 74 6f 20 74 ransition into t
122a0 68 65 20 45 52 52 4f 52 20 73 74 61 74 65 20 6d he ERROR state m
122b0 61 79 20 61 68 76 65 20 6f 63 63 75 72 72 65 64 ay ahve occurred
122c0 2e 0a 2a 2a 20 54 68 65 20 66 69 72 73 74 20 61 ..** The first a
122d0 72 67 75 6d 65 6e 74 20 69 73 20 61 20 70 6f 69 rgument is a poi
122e0 6e 74 65 72 20 74 6f 20 74 68 65 20 70 61 67 65 nter to the page
122f0 72 20 73 74 72 75 63 74 75 72 65 2c 20 74 68 65 r structure, the
12300 20 73 65 63 6f 6e 64 20 0a 2a 2a 20 74 68 65 20 second .** the
12310 65 72 72 6f 72 2d 63 6f 64 65 20 61 62 6f 75 74 error-code about
12320 20 74 6f 20 62 65 20 72 65 74 75 72 6e 65 64 20 to be returned
12330 62 79 20 61 20 70 61 67 65 72 20 41 50 49 20 66 by a pager API f
12340 75 6e 63 74 69 6f 6e 2e 20 54 68 65 20 0a 2a 2a unction. The .**
12350 20 76 61 6c 75 65 20 72 65 74 75 72 6e 65 64 20 value returned
12360 69 73 20 61 20 63 6f 70 79 20 6f 66 20 74 68 65 is a copy of the
12370 20 73 65 63 6f 6e 64 20 61 72 67 75 6d 65 6e 74 second argument
12380 20 74 6f 20 74 68 69 73 20 66 75 6e 63 74 69 6f to this functio
12390 6e 2e 20 0a 2a 2a 0a 2a 2a 20 49 66 20 74 68 65 n. .**.** If the
123a0 20 73 65 63 6f 6e 64 20 61 72 67 75 6d 65 6e 74 second argument
123b0 20 69 73 20 53 51 4c 49 54 45 5f 46 55 4c 4c 2c is SQLITE_FULL,
123c0 20 53 51 4c 49 54 45 5f 49 4f 45 52 52 20 6f 72 SQLITE_IOERR or
123d0 20 6f 6e 65 20 6f 66 20 74 68 65 0a 2a 2a 20 49 one of the.** I
123e0 4f 45 52 52 20 73 75 62 2d 63 6f 64 65 73 2c 20 OERR sub-codes,
123f0 74 68 65 20 70 61 67 65 72 20 65 6e 74 65 72 73 the pager enters
12400 20 74 68 65 20 45 52 52 4f 52 20 73 74 61 74 65 the ERROR state
12410 20 61 6e 64 20 74 68 65 20 65 72 72 6f 72 20 63 and the error c
12420 6f 64 65 0a 2a 2a 20 69 73 20 73 74 6f 72 65 64 ode.** is stored
12430 20 69 6e 20 50 61 67 65 72 2e 65 72 72 43 6f 64 in Pager.errCod
12440 65 2e 20 57 68 69 6c 65 20 74 68 65 20 70 61 67 e. While the pag
12450 65 72 20 72 65 6d 61 69 6e 73 20 69 6e 20 74 68 er remains in th
12460 65 20 45 52 52 4f 52 20 73 74 61 74 65 2c 0a 2a e ERROR state,.*
12470 2a 20 61 6c 6c 20 6d 61 6a 6f 72 20 41 50 49 20 * all major API
12480 63 61 6c 6c 73 20 6f 6e 20 74 68 65 20 50 61 67 calls on the Pag
12490 65 72 20 77 69 6c 6c 20 69 6d 6d 65 64 69 61 74 er will immediat
124a0 65 6c 79 20 72 65 74 75 72 6e 20 50 61 67 65 72 ely return Pager
124b0 2e 65 72 72 43 6f 64 65 2e 0a 2a 2a 0a 2a 2a 20 .errCode..**.**
124c0 54 68 65 20 45 52 52 4f 52 20 73 74 61 74 65 20 The ERROR state
124d0 69 6e 64 69 63 61 74 65 73 20 74 68 61 74 20 74 indicates that t
124e0 68 65 20 63 6f 6e 74 65 6e 74 73 20 6f 66 20 74 he contents of t
124f0 68 65 20 70 61 67 65 72 2d 63 61 63 68 65 20 0a he pager-cache .
12500 2a 2a 20 63 61 6e 6e 6f 74 20 62 65 20 74 72 75 ** cannot be tru
12510 73 74 65 64 2e 20 54 68 69 73 20 73 74 61 74 65 sted. This state
12520 20 63 61 6e 20 62 65 20 63 6c 65 61 72 65 64 20 can be cleared
12530 62 79 20 63 6f 6d 70 6c 65 74 65 6c 79 20 64 69 by completely di
12540 73 63 61 72 64 69 6e 67 20 0a 2a 2a 20 74 68 65 scarding .** the
12550 20 63 6f 6e 74 65 6e 74 73 20 6f 66 20 74 68 65 contents of the
12560 20 70 61 67 65 72 2d 63 61 63 68 65 2e 20 49 66 pager-cache. If
12570 20 61 20 74 72 61 6e 73 61 63 74 69 6f 6e 20 77 a transaction w
12580 61 73 20 61 63 74 69 76 65 20 77 68 65 6e 0a 2a as active when.*
12590 2a 20 74 68 65 20 70 65 72 73 69 73 74 65 6e 74 * the persistent
125a0 20 65 72 72 6f 72 20 6f 63 63 75 72 72 65 64 2c error occurred,
125b0 20 74 68 65 6e 20 74 68 65 20 72 6f 6c 6c 62 61 then the rollba
125c0 63 6b 20 6a 6f 75 72 6e 61 6c 20 6d 61 79 20 6e ck journal may n
125d0 65 65 64 0a 2a 2a 20 74 6f 20 62 65 20 72 65 70 eed.** to be rep
125e0 6c 61 79 65 64 20 74 6f 20 72 65 73 74 6f 72 65 layed to restore
125f0 20 74 68 65 20 63 6f 6e 74 65 6e 74 73 20 6f 66 the contents of
12600 20 74 68 65 20 64 61 74 61 62 61 73 65 20 66 69 the database fi
12610 6c 65 20 28 61 73 20 69 66 0a 2a 2a 20 69 74 20 le (as if.** it
12620 77 65 72 65 20 61 20 68 6f 74 2d 6a 6f 75 72 6e were a hot-journ
12630 61 6c 29 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 69 al)..*/.static i
12640 6e 74 20 70 61 67 65 72 5f 65 72 72 6f 72 28 50 nt pager_error(P
12650 61 67 65 72 20 2a 70 50 61 67 65 72 2c 20 69 6e ager *pPager, in
12660 74 20 72 63 29 7b 0a 20 20 69 6e 74 20 72 63 32 t rc){. int rc2
12670 20 3d 20 72 63 20 26 20 30 78 66 66 3b 0a 20 20 = rc & 0xff;.
12680 61 73 73 65 72 74 28 20 72 63 3d 3d 53 51 4c 49 assert( rc==SQLI
12690 54 45 5f 4f 4b 20 7c 7c 20 21 4d 45 4d 44 42 20 TE_OK || !MEMDB
126a0 29 3b 0a 20 20 61 73 73 65 72 74 28 0a 20 20 20 );. assert(.
126b0 20 20 20 20 70 50 61 67 65 72 2d 3e 65 72 72 43 pPager->errC
126c0 6f 64 65 3d 3d 53 51 4c 49 54 45 5f 46 55 4c 4c ode==SQLITE_FULL
126d0 20 7c 7c 0a 20 20 20 20 20 20 20 70 50 61 67 65 ||. pPage
126e0 72 2d 3e 65 72 72 43 6f 64 65 3d 3d 53 51 4c 49 r->errCode==SQLI
126f0 54 45 5f 4f 4b 20 7c 7c 0a 20 20 20 20 20 20 20 TE_OK ||.
12700 28 70 50 61 67 65 72 2d 3e 65 72 72 43 6f 64 65 (pPager->errCode
12710 20 26 20 30 78 66 66 29 3d 3d 53 51 4c 49 54 45 & 0xff)==SQLITE
12720 5f 49 4f 45 52 52 0a 20 20 29 3b 0a 20 20 69 66 _IOERR. );. if
12730 28 20 72 63 32 3d 3d 53 51 4c 49 54 45 5f 46 55 ( rc2==SQLITE_FU
12740 4c 4c 20 7c 7c 20 72 63 32 3d 3d 53 51 4c 49 54 LL || rc2==SQLIT
12750 45 5f 49 4f 45 52 52 20 29 7b 0a 20 20 20 20 70 E_IOERR ){. p
12760 50 61 67 65 72 2d 3e 65 72 72 43 6f 64 65 20 3d Pager->errCode =
12770 20 72 63 3b 0a 20 20 20 20 70 50 61 67 65 72 2d rc;. pPager-
12780 3e 65 53 74 61 74 65 20 3d 20 50 41 47 45 52 5f >eState = PAGER_
12790 45 52 52 4f 52 3b 0a 20 20 7d 0a 20 20 72 65 74 ERROR;. }. ret
127a0 75 72 6e 20 72 63 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a urn rc;.}../*.**
127b0 20 54 68 69 73 20 72 6f 75 74 69 6e 65 20 65 6e This routine en
127c0 64 73 20 61 20 74 72 61 6e 73 61 63 74 69 6f 6e ds a transaction
127d0 2e 20 41 20 74 72 61 6e 73 61 63 74 69 6f 6e 20 . A transaction
127e0 69 73 20 75 73 75 61 6c 6c 79 20 65 6e 64 65 64 is usually ended
127f0 20 62 79 20 0a 2a 2a 20 65 69 74 68 65 72 20 61 by .** either a
12800 20 43 4f 4d 4d 49 54 20 6f 72 20 61 20 52 4f 4c COMMIT or a ROL
12810 4c 42 41 43 4b 20 6f 70 65 72 61 74 69 6f 6e 2e LBACK operation.
12820 20 54 68 69 73 20 72 6f 75 74 69 6e 65 20 6d 61 This routine ma
12830 79 20 62 65 20 63 61 6c 6c 65 64 20 0a 2a 2a 20 y be called .**
12840 61 66 74 65 72 20 72 6f 6c 6c 62 61 63 6b 20 6f after rollback o
12850 66 20 61 20 68 6f 74 2d 6a 6f 75 72 6e 61 6c 2c f a hot-journal,
12860 20 6f 72 20 69 66 20 61 6e 20 65 72 72 6f 72 20 or if an error
12870 6f 63 63 75 72 73 20 77 68 69 6c 65 20 6f 70 65 occurs while ope
12880 6e 69 6e 67 0a 2a 2a 20 74 68 65 20 6a 6f 75 72 ning.** the jour
12890 6e 61 6c 20 66 69 6c 65 20 6f 72 20 77 72 69 74 nal file or writ
128a0 69 6e 67 20 74 68 65 20 76 65 72 79 20 66 69 72 ing the very fir
128b0 73 74 20 6a 6f 75 72 6e 61 6c 2d 68 65 61 64 65 st journal-heade
128c0 72 20 6f 66 20 61 0a 2a 2a 20 64 61 74 61 62 61 r of a.** databa
128d0 73 65 20 74 72 61 6e 73 61 63 74 69 6f 6e 2e 0a se transaction..
128e0 2a 2a 20 0a 2a 2a 20 54 68 69 73 20 72 6f 75 74 ** .** This rout
128f0 69 6e 65 20 69 73 20 6e 65 76 65 72 20 63 61 6c ine is never cal
12900 6c 65 64 20 69 6e 20 50 41 47 45 52 5f 45 52 52 led in PAGER_ERR
12910 4f 52 20 73 74 61 74 65 2e 20 49 66 20 69 74 20 OR state. If it
12920 69 73 20 63 61 6c 6c 65 64 0a 2a 2a 20 69 6e 20 is called.** in
12930 50 41 47 45 52 5f 4e 4f 4e 45 20 6f 72 20 50 41 PAGER_NONE or PA
12940 47 45 52 5f 53 48 41 52 45 44 20 73 74 61 74 65 GER_SHARED state
12950 20 61 6e 64 20 74 68 65 20 6c 6f 63 6b 20 68 65 and the lock he
12960 6c 64 20 69 73 20 6c 65 73 73 0a 2a 2a 20 65 78 ld is less.** ex
12970 63 6c 75 73 69 76 65 20 74 68 61 6e 20 61 20 52 clusive than a R
12980 45 53 45 52 56 45 44 20 6c 6f 63 6b 2c 20 69 74 ESERVED lock, it
12990 20 69 73 20 61 20 6e 6f 2d 6f 70 2e 0a 2a 2a 0a is a no-op..**.
129a0 2a 2a 20 4f 74 68 65 72 77 69 73 65 2c 20 61 6e ** Otherwise, an
129b0 79 20 61 63 74 69 76 65 20 73 61 76 65 70 6f 69 y active savepoi
129c0 6e 74 73 20 61 72 65 20 72 65 6c 65 61 73 65 64 nts are released
129d0 2e 0a 2a 2a 0a 2a 2a 20 49 66 20 74 68 65 20 6a ..**.** If the j
129e0 6f 75 72 6e 61 6c 20 66 69 6c 65 20 69 73 20 6f ournal file is o
129f0 70 65 6e 2c 20 74 68 65 6e 20 69 74 20 69 73 20 pen, then it is
12a00 22 66 69 6e 61 6c 69 7a 65 64 22 2e 20 4f 6e 63 "finalized". Onc
12a10 65 20 61 20 6a 6f 75 72 6e 61 6c 20 0a 2a 2a 20 e a journal .**
12a20 66 69 6c 65 20 68 61 73 20 62 65 65 6e 20 66 69 file has been fi
12a30 6e 61 6c 69 7a 65 64 20 69 74 20 69 73 20 6e 6f nalized it is no
12a40 74 20 70 6f 73 73 69 62 6c 65 20 74 6f 20 75 73 t possible to us
12a50 65 20 69 74 20 74 6f 20 72 6f 6c 6c 20 62 61 63 e it to roll bac
12a60 6b 20 61 20 0a 2a 2a 20 74 72 61 6e 73 61 63 74 k a .** transact
12a70 69 6f 6e 2e 20 4e 6f 72 20 77 69 6c 6c 20 69 74 ion. Nor will it
12a80 20 62 65 20 63 6f 6e 73 69 64 65 72 65 64 20 74 be considered t
12a90 6f 20 62 65 20 61 20 68 6f 74 2d 6a 6f 75 72 6e o be a hot-journ
12aa0 61 6c 20 62 79 20 74 68 69 73 0a 2a 2a 20 6f 72 al by this.** or
12ab0 20 61 6e 79 20 6f 74 68 65 72 20 64 61 74 61 62 any other datab
12ac0 61 73 65 20 63 6f 6e 6e 65 63 74 69 6f 6e 2e 20 ase connection.
12ad0 45 78 61 63 74 6c 79 20 68 6f 77 20 61 20 6a 6f Exactly how a jo
12ae0 75 72 6e 61 6c 20 69 73 20 66 69 6e 61 6c 69 7a urnal is finaliz
12af0 65 64 0a 2a 2a 20 64 65 70 65 6e 64 73 20 6f 6e ed.** depends on
12b00 20 77 68 65 74 68 65 72 20 6f 72 20 6e 6f 74 20 whether or not
12b10 74 68 65 20 70 61 67 65 72 20 69 73 20 72 75 6e the pager is run
12b20 6e 69 6e 67 20 69 6e 20 65 78 63 6c 75 73 69 76 ning in exclusiv
12b30 65 20 6d 6f 64 65 20 61 6e 64 0a 2a 2a 20 74 68 e mode and.** th
12b40 65 20 63 75 72 72 65 6e 74 20 6a 6f 75 72 6e 61 e current journa
12b50 6c 2d 6d 6f 64 65 20 28 50 61 67 65 72 2e 6a 6f l-mode (Pager.jo
12b60 75 72 6e 61 6c 4d 6f 64 65 20 76 61 6c 75 65 29 urnalMode value)
12b70 2c 20 61 73 20 66 6f 6c 6c 6f 77 73 3a 0a 2a 2a , as follows:.**
12b80 0a 2a 2a 20 20 20 6a 6f 75 72 6e 61 6c 4d 6f 64 .** journalMod
12b90 65 3d 3d 4d 45 4d 4f 52 59 0a 2a 2a 20 20 20 20 e==MEMORY.**
12ba0 20 4a 6f 75 72 6e 61 6c 20 66 69 6c 65 20 64 65 Journal file de
12bb0 73 63 72 69 70 74 6f 72 20 69 73 20 73 69 6d 70 scriptor is simp
12bc0 6c 79 20 63 6c 6f 73 65 64 2e 20 54 68 69 73 20 ly closed. This
12bd0 64 65 73 74 72 6f 79 73 20 61 6e 20 0a 2a 2a 20 destroys an .**
12be0 20 20 20 20 69 6e 2d 6d 65 6d 6f 72 79 20 6a 6f in-memory jo
12bf0 75 72 6e 61 6c 2e 0a 2a 2a 0a 2a 2a 20 20 20 6a urnal..**.** j
12c00 6f 75 72 6e 61 6c 4d 6f 64 65 3d 3d 54 52 55 4e ournalMode==TRUN
12c10 43 41 54 45 0a 2a 2a 20 20 20 20 20 4a 6f 75 72 CATE.** Jour
12c20 6e 61 6c 20 66 69 6c 65 20 69 73 20 74 72 75 6e nal file is trun
12c30 63 61 74 65 64 20 74 6f 20 7a 65 72 6f 20 62 79 cated to zero by
12c40 74 65 73 20 69 6e 20 73 69 7a 65 2e 0a 2a 2a 0a tes in size..**.
12c50 2a 2a 20 20 20 6a 6f 75 72 6e 61 6c 4d 6f 64 65 ** journalMode
12c60 3d 3d 50 45 52 53 49 53 54 0a 2a 2a 20 20 20 20 ==PERSIST.**
12c70 20 54 68 65 20 66 69 72 73 74 20 32 38 20 62 79 The first 28 by
12c80 74 65 73 20 6f 66 20 74 68 65 20 6a 6f 75 72 6e tes of the journ
12c90 61 6c 20 66 69 6c 65 20 61 72 65 20 7a 65 72 6f al file are zero
12ca0 65 64 2e 20 54 68 69 73 20 69 6e 76 61 6c 69 64 ed. This invalid
12cb0 61 74 65 73 0a 2a 2a 20 20 20 20 20 74 68 65 20 ates.** the
12cc0 66 69 72 73 74 20 6a 6f 75 72 6e 61 6c 20 68 65 first journal he
12cd0 61 64 65 72 20 69 6e 20 74 68 65 20 66 69 6c 65 ader in the file
12ce0 2c 20 61 6e 64 20 68 65 6e 63 65 20 74 68 65 20 , and hence the
12cf0 65 6e 74 69 72 65 20 6a 6f 75 72 6e 61 6c 0a 2a entire journal.*
12d00 2a 20 20 20 20 20 66 69 6c 65 2e 20 41 6e 20 69 * file. An i
12d10 6e 76 61 6c 69 64 20 6a 6f 75 72 6e 61 6c 20 66 nvalid journal f
12d20 69 6c 65 20 63 61 6e 6e 6f 74 20 62 65 20 72 6f ile cannot be ro
12d30 6c 6c 65 64 20 62 61 63 6b 2e 0a 2a 2a 0a 2a 2a lled back..**.**
12d40 20 20 20 6a 6f 75 72 6e 61 6c 4d 6f 64 65 3d 3d journalMode==
12d50 44 45 4c 45 54 45 0a 2a 2a 20 20 20 20 20 54 68 DELETE.** Th
12d60 65 20 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 20 69 e journal file i
12d70 73 20 63 6c 6f 73 65 64 20 61 6e 64 20 64 65 6c s closed and del
12d80 65 74 65 64 20 75 73 69 6e 67 20 73 71 6c 69 74 eted using sqlit
12d90 65 33 4f 73 44 65 6c 65 74 65 28 29 2e 0a 2a 2a e3OsDelete()..**
12da0 0a 2a 2a 20 20 20 20 20 49 66 20 74 68 65 20 70 .** If the p
12db0 61 67 65 72 20 69 73 20 72 75 6e 6e 69 6e 67 20 ager is running
12dc0 69 6e 20 65 78 63 6c 75 73 69 76 65 20 6d 6f 64 in exclusive mod
12dd0 65 2c 20 74 68 69 73 20 6d 65 74 68 6f 64 20 6f e, this method o
12de0 66 20 66 69 6e 61 6c 69 7a 69 6e 67 0a 2a 2a 20 f finalizing.**
12df0 20 20 20 20 74 68 65 20 6a 6f 75 72 6e 61 6c 20 the journal
12e00 66 69 6c 65 20 69 73 20 6e 65 76 65 72 20 75 73 file is never us
12e10 65 64 2e 20 49 6e 73 74 65 61 64 2c 20 69 66 20 ed. Instead, if
12e20 74 68 65 20 6a 6f 75 72 6e 61 6c 4d 6f 64 65 20 the journalMode
12e30 69 73 0a 2a 2a 20 20 20 20 20 44 45 4c 45 54 45 is.** DELETE
12e40 20 61 6e 64 20 74 68 65 20 70 61 67 65 72 20 69 and the pager i
12e50 73 20 69 6e 20 65 78 63 6c 75 73 69 76 65 20 6d s in exclusive m
12e60 6f 64 65 2c 20 74 68 65 20 6d 65 74 68 6f 64 20 ode, the method
12e70 64 65 73 63 72 69 62 65 64 20 75 6e 64 65 72 0a described under.
12e80 2a 2a 20 20 20 20 20 6a 6f 75 72 6e 61 6c 4d 6f ** journalMo
12e90 64 65 3d 3d 50 45 52 53 49 53 54 20 69 73 20 75 de==PERSIST is u
12ea0 73 65 64 20 69 6e 73 74 65 61 64 2e 0a 2a 2a 0a sed instead..**.
12eb0 2a 2a 20 41 66 74 65 72 20 74 68 65 20 6a 6f 75 ** After the jou
12ec0 72 6e 61 6c 20 69 73 20 66 69 6e 61 6c 69 7a 65 rnal is finalize
12ed0 64 2c 20 74 68 65 20 70 61 67 65 72 20 6d 6f 76 d, the pager mov
12ee0 65 73 20 74 6f 20 50 41 47 45 52 5f 52 45 41 44 es to PAGER_READ
12ef0 45 52 20 73 74 61 74 65 2e 0a 2a 2a 20 49 66 20 ER state..** If
12f00 72 75 6e 6e 69 6e 67 20 69 6e 20 6e 6f 6e 2d 65 running in non-e
12f10 78 63 6c 75 73 69 76 65 20 72 6f 6c 6c 62 61 63 xclusive rollbac
12f20 6b 20 6d 6f 64 65 2c 20 74 68 65 20 6c 6f 63 6b k mode, the lock
12f30 20 6f 6e 20 74 68 65 20 66 69 6c 65 20 69 73 20 on the file is
12f40 0a 2a 2a 20 64 6f 77 6e 67 72 61 64 65 64 20 74 .** downgraded t
12f50 6f 20 61 20 53 48 41 52 45 44 5f 4c 4f 43 4b 2e o a SHARED_LOCK.
12f60 0a 2a 2a 0a 2a 2a 20 53 51 4c 49 54 45 5f 4f 4b .**.** SQLITE_OK
12f70 20 69 73 20 72 65 74 75 72 6e 65 64 20 69 66 20 is returned if
12f80 6e 6f 20 65 72 72 6f 72 20 6f 63 63 75 72 73 2e no error occurs.
12f90 20 49 66 20 61 6e 20 65 72 72 6f 72 20 6f 63 63 If an error occ
12fa0 75 72 73 20 64 75 72 69 6e 67 0a 2a 2a 20 61 6e urs during.** an
12fb0 79 20 6f 66 20 74 68 65 20 49 4f 20 6f 70 65 72 y of the IO oper
12fc0 61 74 69 6f 6e 73 20 74 6f 20 66 69 6e 61 6c 69 ations to finali
12fd0 7a 65 20 74 68 65 20 6a 6f 75 72 6e 61 6c 20 66 ze the journal f
12fe0 69 6c 65 20 6f 72 20 75 6e 6c 6f 63 6b 20 74 68 ile or unlock th
12ff0 65 0a 2a 2a 20 64 61 74 61 62 61 73 65 20 74 68 e.** database th
13000 65 6e 20 74 68 65 20 49 4f 20 65 72 72 6f 72 20 en the IO error
13010 63 6f 64 65 20 69 73 20 72 65 74 75 72 6e 65 64 code is returned
13020 20 74 6f 20 74 68 65 20 75 73 65 72 2e 20 49 66 to the user. If
13030 20 74 68 65 20 0a 2a 2a 20 6f 70 65 72 61 74 69 the .** operati
13040 6f 6e 20 74 6f 20 66 69 6e 61 6c 69 7a 65 20 74 on to finalize t
13050 68 65 20 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 20 he journal file
13060 66 61 69 6c 73 2c 20 74 68 65 6e 20 74 68 65 20 fails, then the
13070 63 6f 64 65 20 73 74 69 6c 6c 0a 2a 2a 20 74 72 code still.** tr
13080 69 65 73 20 74 6f 20 75 6e 6c 6f 63 6b 20 74 68 ies to unlock th
13090 65 20 64 61 74 61 62 61 73 65 20 66 69 6c 65 20 e database file
130a0 69 66 20 6e 6f 74 20 69 6e 20 65 78 63 6c 75 73 if not in exclus
130b0 69 76 65 20 6d 6f 64 65 2e 20 49 66 20 74 68 65 ive mode. If the
130c0 0a 2a 2a 20 75 6e 6c 6f 63 6b 20 6f 70 65 72 61 .** unlock opera
130d0 74 69 6f 6e 20 66 61 69 6c 73 20 61 73 20 77 65 tion fails as we
130e0 6c 6c 2c 20 74 68 65 6e 20 74 68 65 20 66 69 72 ll, then the fir
130f0 73 74 20 65 72 72 6f 72 20 63 6f 64 65 20 72 65 st error code re
13100 6c 61 74 65 64 0a 2a 2a 20 74 6f 20 74 68 65 20 lated.** to the
13110 66 69 72 73 74 20 65 72 72 6f 72 20 65 6e 63 6f first error enco
13120 75 6e 74 65 72 65 64 20 28 74 68 65 20 6a 6f 75 untered (the jou
13130 72 6e 61 6c 20 66 69 6e 61 6c 69 7a 61 74 69 6f rnal finalizatio
13140 6e 20 6f 6e 65 29 20 69 73 0a 2a 2a 20 72 65 74 n one) is.** ret
13150 75 72 6e 65 64 2e 0a 2a 2f 0a 73 74 61 74 69 63 urned..*/.static
13160 20 69 6e 74 20 70 61 67 65 72 5f 65 6e 64 5f 74 int pager_end_t
13170 72 61 6e 73 61 63 74 69 6f 6e 28 50 61 67 65 72 ransaction(Pager
13180 20 2a 70 50 61 67 65 72 2c 20 69 6e 74 20 68 61 *pPager, int ha
13190 73 4d 61 73 74 65 72 29 7b 0a 20 20 69 6e 74 20 sMaster){. int
131a0 72 63 20 3d 20 53 51 4c 49 54 45 5f 4f 4b 3b 20 rc = SQLITE_OK;
131b0 20 20 20 20 20 2f 2a 20 45 72 72 6f 72 20 63 6f /* Error co
131c0 64 65 20 66 72 6f 6d 20 6a 6f 75 72 6e 61 6c 20 de from journal
131d0 66 69 6e 61 6c 69 7a 61 74 69 6f 6e 20 6f 70 65 finalization ope
131e0 72 61 74 69 6f 6e 20 2a 2f 0a 20 20 69 6e 74 20 ration */. int
131f0 72 63 32 20 3d 20 53 51 4c 49 54 45 5f 4f 4b 3b rc2 = SQLITE_OK;
13200 20 20 20 20 20 2f 2a 20 45 72 72 6f 72 20 63 6f /* Error co
13210 64 65 20 66 72 6f 6d 20 64 62 20 66 69 6c 65 20 de from db file
13220 75 6e 6c 6f 63 6b 20 6f 70 65 72 61 74 69 6f 6e unlock operation
13230 20 2a 2f 0a 0a 20 20 2f 2a 20 44 6f 20 6e 6f 74 */.. /* Do not
13240 68 69 6e 67 20 69 66 20 74 68 65 20 70 61 67 65 hing if the page
13250 72 20 64 6f 65 73 20 6e 6f 74 20 68 61 76 65 20 r does not have
13260 61 6e 20 6f 70 65 6e 20 77 72 69 74 65 20 74 72 an open write tr
13270 61 6e 73 61 63 74 69 6f 6e 0a 20 20 2a 2a 20 6f ansaction. ** o
13280 72 20 61 74 20 6c 65 61 73 74 20 61 20 52 45 53 r at least a RES
13290 45 52 56 45 44 20 6c 6f 63 6b 2e 20 54 68 69 73 ERVED lock. This
132a0 20 66 75 6e 63 74 69 6f 6e 20 6d 61 79 20 62 65 function may be
132b0 20 63 61 6c 6c 65 64 20 77 68 65 6e 20 74 68 65 called when the
132c0 72 65 0a 20 20 2a 2a 20 69 73 20 6e 6f 20 77 72 re. ** is no wr
132d0 69 74 65 2d 74 72 61 6e 73 61 63 74 69 6f 6e 20 ite-transaction
132e0 61 63 74 69 76 65 20 62 75 74 20 61 20 52 45 53 active but a RES
132f0 45 52 56 45 44 20 6f 72 20 67 72 65 61 74 65 72 ERVED or greater
13300 20 6c 6f 63 6b 20 69 73 0a 20 20 2a 2a 20 68 65 lock is. ** he
13310 6c 64 20 75 6e 64 65 72 20 74 77 6f 20 63 69 72 ld under two cir
13320 63 75 6d 73 74 61 6e 63 65 73 3a 0a 20 20 2a 2a cumstances:. **
13330 0a 20 20 2a 2a 20 20 20 31 2e 20 41 66 74 65 72 . ** 1. After
13340 20 61 20 73 75 63 63 65 73 73 66 75 6c 20 68 6f a successful ho
13350 74 2d 6a 6f 75 72 6e 61 6c 20 72 6f 6c 6c 62 61 t-journal rollba
13360 63 6b 2c 20 69 74 20 69 73 20 63 61 6c 6c 65 64 ck, it is called
13370 20 77 69 74 68 0a 20 20 2a 2a 20 20 20 20 20 20 with. **
13380 65 53 74 61 74 65 3d 3d 50 41 47 45 52 5f 4e 4f eState==PAGER_NO
13390 4e 45 20 61 6e 64 20 65 4c 6f 63 6b 3d 3d 45 58 NE and eLock==EX
133a0 43 4c 55 53 49 56 45 5f 4c 4f 43 4b 2e 0a 20 20 CLUSIVE_LOCK..
133b0 2a 2a 0a 20 20 2a 2a 20 20 20 32 2e 20 49 66 20 **. ** 2. If
133c0 61 20 63 6f 6e 6e 65 63 74 69 6f 6e 20 77 69 74 a connection wit
133d0 68 20 6c 6f 63 6b 69 6e 67 5f 6d 6f 64 65 3d 65 h locking_mode=e
133e0 78 63 6c 75 73 69 76 65 20 68 6f 6c 64 69 6e 67 xclusive holding
133f0 20 61 6e 20 45 58 43 4c 55 53 49 56 45 20 0a 20 an EXCLUSIVE .
13400 20 2a 2a 20 20 20 20 20 20 6c 6f 63 6b 20 73 77 ** lock sw
13410 69 74 63 68 65 73 20 62 61 63 6b 20 74 6f 20 6c itches back to l
13420 6f 63 6b 69 6e 67 5f 6d 6f 64 65 3d 6e 6f 72 6d ocking_mode=norm
13430 61 6c 20 61 6e 64 20 74 68 65 6e 20 65 78 65 63 al and then exec
13440 75 74 65 73 20 61 0a 20 20 2a 2a 20 20 20 20 20 utes a. **
13450 20 72 65 61 64 2d 74 72 61 6e 73 61 63 74 69 6f read-transactio
13460 6e 2c 20 74 68 69 73 20 66 75 6e 63 74 69 6f 6e n, this function
13470 20 69 73 20 63 61 6c 6c 65 64 20 77 69 74 68 20 is called with
13480 65 53 74 61 74 65 3d 3d 50 41 47 45 52 5f 52 45 eState==PAGER_RE
13490 41 44 45 52 20 0a 20 20 2a 2a 20 20 20 20 20 20 ADER . **
134a0 61 6e 64 20 65 4c 6f 63 6b 3d 3d 45 58 43 4c 55 and eLock==EXCLU
134b0 53 49 56 45 5f 4c 4f 43 4b 20 77 68 65 6e 20 74 SIVE_LOCK when t
134c0 68 65 20 72 65 61 64 2d 74 72 61 6e 73 61 63 74 he read-transact
134d0 69 6f 6e 20 69 73 20 63 6c 6f 73 65 64 2e 0a 20 ion is closed..
134e0 20 2a 2f 0a 20 20 61 73 73 65 72 74 28 20 61 73 */. assert( as
134f0 73 65 72 74 5f 70 61 67 65 72 5f 73 74 61 74 65 sert_pager_state
13500 28 70 50 61 67 65 72 29 20 29 3b 0a 20 20 61 73 (pPager) );. as
13510 73 65 72 74 28 20 70 50 61 67 65 72 2d 3e 65 53 sert( pPager->eS
13520 74 61 74 65 21 3d 50 41 47 45 52 5f 45 52 52 4f tate!=PAGER_ERRO
13530 52 20 29 3b 0a 20 20 69 66 28 20 70 50 61 67 65 R );. if( pPage
13540 72 2d 3e 65 53 74 61 74 65 3c 50 41 47 45 52 5f r->eState<PAGER_
13550 57 52 49 54 45 52 5f 4c 4f 43 4b 45 44 20 26 26 WRITER_LOCKED &&
13560 20 70 50 61 67 65 72 2d 3e 65 4c 6f 63 6b 3c 52 pPager->eLock<R
13570 45 53 45 52 56 45 44 5f 4c 4f 43 4b 20 29 7b 0a ESERVED_LOCK ){.
13580 20 20 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 return SQLIT
13590 45 5f 4f 4b 3b 0a 20 20 7d 0a 0a 20 20 72 65 6c E_OK;. }.. rel
135a0 65 61 73 65 41 6c 6c 53 61 76 65 70 6f 69 6e 74 easeAllSavepoint
135b0 73 28 70 50 61 67 65 72 29 3b 0a 20 20 61 73 73 s(pPager);. ass
135c0 65 72 74 28 20 69 73 4f 70 65 6e 28 70 50 61 67 ert( isOpen(pPag
135d0 65 72 2d 3e 6a 66 64 29 20 7c 7c 20 70 50 61 67 er->jfd) || pPag
135e0 65 72 2d 3e 70 49 6e 4a 6f 75 72 6e 61 6c 3d 3d er->pInJournal==
135f0 30 20 29 3b 0a 20 20 69 66 28 20 69 73 4f 70 65 0 );. if( isOpe
13600 6e 28 70 50 61 67 65 72 2d 3e 6a 66 64 29 20 29 n(pPager->jfd) )
13610 7b 0a 20 20 20 20 61 73 73 65 72 74 28 20 21 70 {. assert( !p
13620 61 67 65 72 55 73 65 57 61 6c 28 70 50 61 67 65 agerUseWal(pPage
13630 72 29 20 29 3b 0a 0a 20 20 20 20 2f 2a 20 46 69 r) );.. /* Fi
13640 6e 61 6c 69 7a 65 20 74 68 65 20 6a 6f 75 72 6e nalize the journ
13650 61 6c 20 66 69 6c 65 2e 20 2a 2f 0a 20 20 20 20 al file. */.
13660 69 66 28 20 73 71 6c 69 74 65 33 49 73 4d 65 6d if( sqlite3IsMem
13670 4a 6f 75 72 6e 61 6c 28 70 50 61 67 65 72 2d 3e Journal(pPager->
13680 6a 66 64 29 20 29 7b 0a 20 20 20 20 20 20 61 73 jfd) ){. as
13690 73 65 72 74 28 20 70 50 61 67 65 72 2d 3e 6a 6f sert( pPager->jo
136a0 75 72 6e 61 6c 4d 6f 64 65 3d 3d 50 41 47 45 52 urnalMode==PAGER
136b0 5f 4a 4f 55 52 4e 41 4c 4d 4f 44 45 5f 4d 45 4d _JOURNALMODE_MEM
136c0 4f 52 59 20 29 3b 0a 20 20 20 20 20 20 73 71 6c ORY );. sql
136d0 69 74 65 33 4f 73 43 6c 6f 73 65 28 70 50 61 67 ite3OsClose(pPag
136e0 65 72 2d 3e 6a 66 64 29 3b 0a 20 20 20 20 7d 65 er->jfd);. }e
136f0 6c 73 65 20 69 66 28 20 70 50 61 67 65 72 2d 3e lse if( pPager->
13700 6a 6f 75 72 6e 61 6c 4d 6f 64 65 3d 3d 50 41 47 journalMode==PAG
13710 45 52 5f 4a 4f 55 52 4e 41 4c 4d 4f 44 45 5f 54 ER_JOURNALMODE_T
13720 52 55 4e 43 41 54 45 20 29 7b 0a 20 20 20 20 20 RUNCATE ){.
13730 20 69 66 28 20 70 50 61 67 65 72 2d 3e 6a 6f 75 if( pPager->jou
13740 72 6e 61 6c 4f 66 66 3d 3d 30 20 29 7b 0a 20 20 rnalOff==0 ){.
13750 20 20 20 20 20 20 72 63 20 3d 20 53 51 4c 49 54 rc = SQLIT
13760 45 5f 4f 4b 3b 0a 20 20 20 20 20 20 7d 65 6c 73 E_OK;. }els
13770 65 7b 0a 20 20 20 20 20 20 20 20 72 63 20 3d 20 e{. rc =
13780 73 71 6c 69 74 65 33 4f 73 54 72 75 6e 63 61 74 sqlite3OsTruncat
13790 65 28 70 50 61 67 65 72 2d 3e 6a 66 64 2c 20 30 e(pPager->jfd, 0
137a0 29 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 20 );. }.
137b0 20 70 50 61 67 65 72 2d 3e 6a 6f 75 72 6e 61 6c pPager->journal
137c0 4f 66 66 20 3d 20 30 3b 0a 20 20 20 20 7d 65 6c Off = 0;. }el
137d0 73 65 20 69 66 28 20 70 50 61 67 65 72 2d 3e 6a se if( pPager->j
137e0 6f 75 72 6e 61 6c 4d 6f 64 65 3d 3d 50 41 47 45 ournalMode==PAGE
137f0 52 5f 4a 4f 55 52 4e 41 4c 4d 4f 44 45 5f 50 45 R_JOURNALMODE_PE
13800 52 53 49 53 54 0a 20 20 20 20 20 20 7c 7c 20 28 RSIST. || (
13810 70 50 61 67 65 72 2d 3e 65 78 63 6c 75 73 69 76 pPager->exclusiv
13820 65 4d 6f 64 65 20 26 26 20 70 50 61 67 65 72 2d eMode && pPager-
13830 3e 6a 6f 75 72 6e 61 6c 4d 6f 64 65 21 3d 50 41 >journalMode!=PA
13840 47 45 52 5f 4a 4f 55 52 4e 41 4c 4d 4f 44 45 5f GER_JOURNALMODE_
13850 57 41 4c 29 0a 20 20 20 20 29 7b 0a 20 20 20 20 WAL). ){.
13860 20 20 72 63 20 3d 20 7a 65 72 6f 4a 6f 75 72 6e rc = zeroJourn
13870 61 6c 48 64 72 28 70 50 61 67 65 72 2c 20 68 61 alHdr(pPager, ha
13880 73 4d 61 73 74 65 72 29 3b 0a 20 20 20 20 20 20 sMaster);.
13890 70 50 61 67 65 72 2d 3e 6a 6f 75 72 6e 61 6c 4f pPager->journalO
138a0 66 66 20 3d 20 30 3b 0a 20 20 20 20 7d 65 6c 73 ff = 0;. }els
138b0 65 7b 0a 20 20 20 20 20 20 2f 2a 20 54 68 69 73 e{. /* This
138c0 20 62 72 61 6e 63 68 20 6d 61 79 20 62 65 20 65 branch may be e
138d0 78 65 63 75 74 65 64 20 77 69 74 68 20 50 61 67 xecuted with Pag
138e0 65 72 2e 6a 6f 75 72 6e 61 6c 4d 6f 64 65 3d 3d er.journalMode==
138f0 4d 45 4d 4f 52 59 20 69 66 0a 20 20 20 20 20 20 MEMORY if.
13900 2a 2a 20 61 20 68 6f 74 2d 6a 6f 75 72 6e 61 6c ** a hot-journal
13910 20 77 61 73 20 6a 75 73 74 20 72 6f 6c 6c 65 64 was just rolled
13920 20 62 61 63 6b 2e 20 49 6e 20 74 68 69 73 20 63 back. In this c
13930 61 73 65 20 74 68 65 20 6a 6f 75 72 6e 61 6c 0a ase the journal.
13940 20 20 20 20 20 20 2a 2a 20 66 69 6c 65 20 73 68 ** file sh
13950 6f 75 6c 64 20 62 65 20 63 6c 6f 73 65 64 20 61 ould be closed a
13960 6e 64 20 64 65 6c 65 74 65 64 2e 20 49 66 20 74 nd deleted. If t
13970 68 69 73 20 63 6f 6e 6e 65 63 74 69 6f 6e 20 77 his connection w
13980 72 69 74 65 73 20 74 6f 0a 20 20 20 20 20 20 2a rites to. *
13990 2a 20 74 68 65 20 64 61 74 61 62 61 73 65 20 66 * the database f
139a0 69 6c 65 2c 20 69 74 20 77 69 6c 6c 20 64 6f 20 ile, it will do
139b0 73 6f 20 75 73 69 6e 67 20 61 6e 20 69 6e 2d 6d so using an in-m
139c0 65 6d 6f 72 79 20 6a 6f 75 72 6e 61 6c 2e 20 0a emory journal. .
139d0 20 20 20 20 20 20 2a 2f 0a 20 20 20 20 20 20 61 */. a
139e0 73 73 65 72 74 28 20 70 50 61 67 65 72 2d 3e 6a ssert( pPager->j
139f0 6f 75 72 6e 61 6c 4d 6f 64 65 3d 3d 50 41 47 45 ournalMode==PAGE
13a00 52 5f 4a 4f 55 52 4e 41 4c 4d 4f 44 45 5f 44 45 R_JOURNALMODE_DE
13a10 4c 45 54 45 20 0a 20 20 20 20 20 20 20 20 20 20 LETE .
13a20 20 7c 7c 20 70 50 61 67 65 72 2d 3e 6a 6f 75 72 || pPager->jour
13a30 6e 61 6c 4d 6f 64 65 3d 3d 50 41 47 45 52 5f 4a nalMode==PAGER_J
13a40 4f 55 52 4e 41 4c 4d 4f 44 45 5f 4d 45 4d 4f 52 OURNALMODE_MEMOR
13a50 59 20 0a 20 20 20 20 20 20 20 20 20 20 20 7c 7c Y . ||
13a60 20 70 50 61 67 65 72 2d 3e 6a 6f 75 72 6e 61 6c pPager->journal
13a70 4d 6f 64 65 3d 3d 50 41 47 45 52 5f 4a 4f 55 52 Mode==PAGER_JOUR
13a80 4e 41 4c 4d 4f 44 45 5f 57 41 4c 20 0a 20 20 20 NALMODE_WAL .
13a90 20 20 20 29 3b 0a 20 20 20 20 20 20 73 71 6c 69 );. sqli
13aa0 74 65 33 4f 73 43 6c 6f 73 65 28 70 50 61 67 65 te3OsClose(pPage
13ab0 72 2d 3e 6a 66 64 29 3b 0a 20 20 20 20 20 20 69 r->jfd);. i
13ac0 66 28 20 21 70 50 61 67 65 72 2d 3e 74 65 6d 70 f( !pPager->temp
13ad0 46 69 6c 65 20 29 7b 0a 20 20 20 20 20 20 20 20 File ){.
13ae0 72 63 20 3d 20 73 71 6c 69 74 65 33 4f 73 44 65 rc = sqlite3OsDe
13af0 6c 65 74 65 28 70 50 61 67 65 72 2d 3e 70 56 66 lete(pPager->pVf
13b00 73 2c 20 70 50 61 67 65 72 2d 3e 7a 4a 6f 75 72 s, pPager->zJour
13b10 6e 61 6c 2c 20 30 29 3b 0a 20 20 20 20 20 20 7d nal, 0);. }
13b20 0a 20 20 20 20 7d 0a 20 20 7d 0a 0a 23 69 66 64 . }. }..#ifd
13b30 65 66 20 53 51 4c 49 54 45 5f 43 48 45 43 4b 5f ef SQLITE_CHECK_
13b40 50 41 47 45 53 0a 20 20 73 71 6c 69 74 65 33 50 PAGES. sqlite3P
13b50 63 61 63 68 65 49 74 65 72 61 74 65 44 69 72 74 cacheIterateDirt
13b60 79 28 70 50 61 67 65 72 2d 3e 70 50 43 61 63 68 y(pPager->pPCach
13b70 65 2c 20 70 61 67 65 72 5f 73 65 74 5f 70 61 67 e, pager_set_pag
13b80 65 68 61 73 68 29 3b 0a 20 20 69 66 28 20 70 50 ehash);. if( pP
13b90 61 67 65 72 2d 3e 64 62 53 69 7a 65 3d 3d 30 20 ager->dbSize==0
13ba0 26 26 20 73 71 6c 69 74 65 33 50 63 61 63 68 65 && sqlite3Pcache
13bb0 52 65 66 43 6f 75 6e 74 28 70 50 61 67 65 72 2d RefCount(pPager-
13bc0 3e 70 50 43 61 63 68 65 29 3e 30 20 29 7b 0a 20 >pPCache)>0 ){.
13bd0 20 20 20 50 67 48 64 72 20 2a 70 20 3d 20 70 61 PgHdr *p = pa
13be0 67 65 72 5f 6c 6f 6f 6b 75 70 28 70 50 61 67 65 ger_lookup(pPage
13bf0 72 2c 20 31 29 3b 0a 20 20 20 20 69 66 28 20 70 r, 1);. if( p
13c00 20 29 7b 0a 20 20 20 20 20 20 70 2d 3e 70 61 67 ){. p->pag
13c10 65 48 61 73 68 20 3d 20 30 3b 0a 20 20 20 20 20 eHash = 0;.
13c20 20 73 71 6c 69 74 65 33 50 61 67 65 72 55 6e 72 sqlite3PagerUnr
13c30 65 66 28 70 29 3b 0a 20 20 20 20 7d 0a 20 20 7d ef(p);. }. }
13c40 0a 23 65 6e 64 69 66 0a 0a 20 20 73 71 6c 69 74 .#endif.. sqlit
13c50 65 33 42 69 74 76 65 63 44 65 73 74 72 6f 79 28 e3BitvecDestroy(
13c60 70 50 61 67 65 72 2d 3e 70 49 6e 4a 6f 75 72 6e pPager->pInJourn
13c70 61 6c 29 3b 0a 20 20 70 50 61 67 65 72 2d 3e 70 al);. pPager->p
13c80 49 6e 4a 6f 75 72 6e 61 6c 20 3d 20 30 3b 0a 20 InJournal = 0;.
13c90 20 70 50 61 67 65 72 2d 3e 6e 52 65 63 20 3d 20 pPager->nRec =
13ca0 30 3b 0a 20 20 73 71 6c 69 74 65 33 50 63 61 63 0;. sqlite3Pcac
13cb0 68 65 43 6c 65 61 6e 41 6c 6c 28 70 50 61 67 65 heCleanAll(pPage
13cc0 72 2d 3e 70 50 43 61 63 68 65 29 3b 0a 20 20 73 r->pPCache);. s
13cd0 71 6c 69 74 65 33 50 63 61 63 68 65 54 72 75 6e qlite3PcacheTrun
13ce0 63 61 74 65 28 70 50 61 67 65 72 2d 3e 70 50 43 cate(pPager->pPC
13cf0 61 63 68 65 2c 20 70 50 61 67 65 72 2d 3e 64 62 ache, pPager->db
13d00 53 69 7a 65 29 3b 0a 0a 20 20 69 66 28 20 70 61 Size);.. if( pa
13d10 67 65 72 55 73 65 57 61 6c 28 70 50 61 67 65 72 gerUseWal(pPager
13d20 29 20 29 7b 0a 20 20 20 20 2f 2a 20 44 72 6f 70 ) ){. /* Drop
13d30 20 74 68 65 20 57 41 4c 20 77 72 69 74 65 2d 6c the WAL write-l
13d40 6f 63 6b 2c 20 69 66 20 61 6e 79 2e 20 41 6c 73 ock, if any. Als
13d50 6f 2c 20 69 66 20 74 68 65 20 63 6f 6e 6e 65 63 o, if the connec
13d60 74 69 6f 6e 20 77 61 73 20 69 6e 20 0a 20 20 20 tion was in .
13d70 20 2a 2a 20 6c 6f 63 6b 69 6e 67 5f 6d 6f 64 65 ** locking_mode
13d80 3d 65 78 63 6c 75 73 69 76 65 20 6d 6f 64 65 20 =exclusive mode
13d90 62 75 74 20 69 73 20 6e 6f 20 6c 6f 6e 67 65 72 but is no longer
13da0 2c 20 64 72 6f 70 20 74 68 65 20 45 58 43 4c 55 , drop the EXCLU
13db0 53 49 56 45 20 0a 20 20 20 20 2a 2a 20 6c 6f 63 SIVE . ** loc
13dc0 6b 20 68 65 6c 64 20 6f 6e 20 74 68 65 20 64 61 k held on the da
13dd0 74 61 62 61 73 65 20 66 69 6c 65 2e 0a 20 20 20 tabase file..
13de0 20 2a 2f 0a 20 20 20 20 72 63 32 20 3d 20 73 71 */. rc2 = sq
13df0 6c 69 74 65 33 57 61 6c 45 6e 64 57 72 69 74 65 lite3WalEndWrite
13e00 54 72 61 6e 73 61 63 74 69 6f 6e 28 70 50 61 67 Transaction(pPag
13e10 65 72 2d 3e 70 57 61 6c 29 3b 0a 20 20 20 20 61 er->pWal);. a
13e20 73 73 65 72 74 28 20 72 63 32 3d 3d 53 51 4c 49 ssert( rc2==SQLI
13e30 54 45 5f 4f 4b 20 29 3b 0a 20 20 7d 0a 20 20 69 TE_OK );. }. i
13e40 66 28 20 21 70 50 61 67 65 72 2d 3e 65 78 63 6c f( !pPager->excl
13e50 75 73 69 76 65 4d 6f 64 65 20 0a 20 20 20 26 26 usiveMode . &&
13e60 20 28 21 70 61 67 65 72 55 73 65 57 61 6c 28 70 (!pagerUseWal(p
13e70 50 61 67 65 72 29 20 7c 7c 20 73 71 6c 69 74 65 Pager) || sqlite
13e80 33 57 61 6c 45 78 63 6c 75 73 69 76 65 4d 6f 64 3WalExclusiveMod
13e90 65 28 70 50 61 67 65 72 2d 3e 70 57 61 6c 2c 20 e(pPager->pWal,
13ea0 30 29 29 0a 20 20 29 7b 0a 20 20 20 20 72 63 32 0)). ){. rc2
13eb0 20 3d 20 70 61 67 65 72 55 6e 6c 6f 63 6b 44 62 = pagerUnlockDb
13ec0 28 70 50 61 67 65 72 2c 20 53 48 41 52 45 44 5f (pPager, SHARED_
13ed0 4c 4f 43 4b 29 3b 0a 20 20 20 20 70 50 61 67 65 LOCK);. pPage
13ee0 72 2d 3e 63 68 61 6e 67 65 43 6f 75 6e 74 44 6f r->changeCountDo
13ef0 6e 65 20 3d 20 30 3b 0a 20 20 7d 0a 20 20 70 50 ne = 0;. }. pP
13f00 61 67 65 72 2d 3e 65 53 74 61 74 65 20 3d 20 50 ager->eState = P
13f10 41 47 45 52 5f 52 45 41 44 45 52 3b 0a 20 20 70 AGER_READER;. p
13f20 50 61 67 65 72 2d 3e 73 65 74 4d 61 73 74 65 72 Pager->setMaster
13f30 20 3d 20 30 3b 0a 0a 20 20 72 65 74 75 72 6e 20 = 0;.. return
13f40 28 72 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b 3f 72 (rc==SQLITE_OK?r
13f50 63 32 3a 72 63 29 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a c2:rc);.}../*.**
13f60 20 45 78 65 63 75 74 65 20 61 20 72 6f 6c 6c 62 Execute a rollb
13f70 61 63 6b 20 69 66 20 61 20 74 72 61 6e 73 61 63 ack if a transac
13f80 74 69 6f 6e 20 69 73 20 61 63 74 69 76 65 20 61 tion is active a
13f90 6e 64 20 75 6e 6c 6f 63 6b 20 74 68 65 20 0a 2a nd unlock the .*
13fa0 2a 20 64 61 74 61 62 61 73 65 20 66 69 6c 65 2e * database file.
13fb0 20 0a 2a 2a 0a 2a 2a 20 49 66 20 74 68 65 20 70 .**.** If the p
13fc0 61 67 65 72 20 68 61 73 20 61 6c 72 65 61 64 79 ager has already
13fd0 20 65 6e 74 65 72 65 64 20 74 68 65 20 45 52 52 entered the ERR
13fe0 4f 52 20 73 74 61 74 65 2c 20 64 6f 20 6e 6f 74 OR state, do not
13ff0 20 61 74 74 65 6d 70 74 20 0a 2a 2a 20 74 68 65 attempt .** the
14000 20 72 6f 6c 6c 62 61 63 6b 20 61 74 20 74 68 69 rollback at thi
14010 73 20 74 69 6d 65 2e 20 49 6e 73 74 65 61 64 2c s time. Instead,
14020 20 70 61 67 65 72 5f 75 6e 6c 6f 63 6b 28 29 20 pager_unlock()
14030 69 73 20 63 61 6c 6c 65 64 2e 20 54 68 65 0a 2a is called. The.*
14040 2a 20 63 61 6c 6c 20 74 6f 20 70 61 67 65 72 5f * call to pager_
14050 75 6e 6c 6f 63 6b 28 29 20 77 69 6c 6c 20 64 69 unlock() will di
14060 73 63 61 72 64 20 61 6c 6c 20 69 6e 2d 6d 65 6d scard all in-mem
14070 6f 72 79 20 70 61 67 65 73 2c 20 75 6e 6c 6f 63 ory pages, unloc
14080 6b 0a 2a 2a 20 74 68 65 20 64 61 74 61 62 61 73 k.** the databas
14090 65 20 66 69 6c 65 20 61 6e 64 20 6d 6f 76 65 20 e file and move
140a0 74 68 65 20 70 61 67 65 72 20 62 61 63 6b 20 74 the pager back t
140b0 6f 20 4f 50 45 4e 20 73 74 61 74 65 2e 20 49 66 o OPEN state. If
140c0 20 74 68 69 73 20 0a 2a 2a 20 6d 65 61 6e 73 20 this .** means
140d0 74 68 61 74 20 74 68 65 72 65 20 69 73 20 61 20 that there is a
140e0 68 6f 74 2d 6a 6f 75 72 6e 61 6c 20 6c 65 66 74 hot-journal left
140f0 20 69 6e 20 74 68 65 20 66 69 6c 65 2d 73 79 73 in the file-sys
14100 74 65 6d 2c 20 74 68 65 20 6e 65 78 74 20 0a 2a tem, the next .*
14110 2a 20 63 6f 6e 6e 65 63 74 69 6f 6e 20 74 6f 20 * connection to
14120 6f 62 74 61 69 6e 20 61 20 73 68 61 72 65 64 20 obtain a shared
14130 6c 6f 63 6b 20 6f 6e 20 74 68 65 20 70 61 67 65 lock on the page
14140 72 20 28 77 68 69 63 68 20 6d 61 79 20 62 65 20 r (which may be
14150 74 68 69 73 20 6f 6e 65 29 20 0a 2a 2a 20 77 69 this one) .** wi
14160 6c 6c 20 72 6f 6c 6c 20 69 74 20 62 61 63 6b 2e ll roll it back.
14170 0a 2a 2a 0a 2a 2a 20 49 66 20 74 68 65 20 70 61 .**.** If the pa
14180 67 65 72 20 68 61 73 20 6e 6f 74 20 61 6c 72 65 ger has not alre
14190 61 64 79 20 65 6e 74 65 72 65 64 20 74 68 65 20 ady entered the
141a0 45 52 52 4f 52 20 73 74 61 74 65 2c 20 62 75 74 ERROR state, but
141b0 20 61 6e 20 49 4f 20 6f 72 0a 2a 2a 20 6d 61 6c an IO or.** mal
141c0 6c 6f 63 20 65 72 72 6f 72 20 6f 63 63 75 72 73 loc error occurs
141d0 20 64 75 72 69 6e 67 20 61 20 72 6f 6c 6c 62 61 during a rollba
141e0 63 6b 2c 20 74 68 65 6e 20 74 68 69 73 20 77 69 ck, then this wi
141f0 6c 6c 20 69 74 73 65 6c 66 20 63 61 75 73 65 20 ll itself cause
14200 0a 2a 2a 20 74 68 65 20 70 61 67 65 72 20 74 6f .** the pager to
14210 20 65 6e 74 65 72 20 74 68 65 20 45 52 52 4f 52 enter the ERROR
14220 20 73 74 61 74 65 2e 20 57 68 69 63 68 20 77 69 state. Which wi
14230 6c 6c 20 62 65 20 63 6c 65 61 72 65 64 20 62 79 ll be cleared by
14240 20 74 68 65 0a 2a 2a 20 63 61 6c 6c 20 74 6f 20 the.** call to
14250 70 61 67 65 72 5f 75 6e 6c 6f 63 6b 28 29 2c 20 pager_unlock(),
14260 61 73 20 64 65 73 63 72 69 62 65 64 20 61 62 6f as described abo
14270 76 65 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 76 6f ve..*/.static vo
14280 69 64 20 70 61 67 65 72 55 6e 6c 6f 63 6b 41 6e id pagerUnlockAn
14290 64 52 6f 6c 6c 62 61 63 6b 28 50 61 67 65 72 20 dRollback(Pager
142a0 2a 70 50 61 67 65 72 29 7b 0a 20 20 69 66 28 20 *pPager){. if(
142b0 70 50 61 67 65 72 2d 3e 65 53 74 61 74 65 21 3d pPager->eState!=
142c0 50 41 47 45 52 5f 45 52 52 4f 52 20 26 26 20 70 PAGER_ERROR && p
142d0 50 61 67 65 72 2d 3e 65 53 74 61 74 65 21 3d 50 Pager->eState!=P
142e0 41 47 45 52 5f 4f 50 45 4e 20 29 7b 0a 20 20 20 AGER_OPEN ){.
142f0 20 61 73 73 65 72 74 28 20 61 73 73 65 72 74 5f assert( assert_
14300 70 61 67 65 72 5f 73 74 61 74 65 28 70 50 61 67 pager_state(pPag
14310 65 72 29 20 29 3b 0a 20 20 20 20 69 66 28 20 70 er) );. if( p
14320 50 61 67 65 72 2d 3e 65 53 74 61 74 65 3e 3d 50 Pager->eState>=P
14330 41 47 45 52 5f 57 52 49 54 45 52 5f 4c 4f 43 4b AGER_WRITER_LOCK
14340 45 44 20 29 7b 0a 20 20 20 20 20 20 73 71 6c 69 ED ){. sqli
14350 74 65 33 42 65 67 69 6e 42 65 6e 69 67 6e 4d 61 te3BeginBenignMa
14360 6c 6c 6f 63 28 29 3b 0a 20 20 20 20 20 20 73 71 lloc();. sq
14370 6c 69 74 65 33 50 61 67 65 72 52 6f 6c 6c 62 61 lite3PagerRollba
14380 63 6b 28 70 50 61 67 65 72 29 3b 0a 20 20 20 20 ck(pPager);.
14390 20 20 73 71 6c 69 74 65 33 45 6e 64 42 65 6e 69 sqlite3EndBeni
143a0 67 6e 4d 61 6c 6c 6f 63 28 29 3b 0a 20 20 20 20 gnMalloc();.
143b0 7d 65 6c 73 65 20 69 66 28 20 21 70 50 61 67 65 }else if( !pPage
143c0 72 2d 3e 65 78 63 6c 75 73 69 76 65 4d 6f 64 65 r->exclusiveMode
143d0 20 29 7b 0a 20 20 20 20 20 20 61 73 73 65 72 74 ){. assert
143e0 28 20 70 50 61 67 65 72 2d 3e 65 53 74 61 74 65 ( pPager->eState
143f0 3d 3d 50 41 47 45 52 5f 52 45 41 44 45 52 20 29 ==PAGER_READER )
14400 3b 0a 20 20 20 20 20 20 70 61 67 65 72 5f 65 6e ;. pager_en
14410 64 5f 74 72 61 6e 73 61 63 74 69 6f 6e 28 70 50 d_transaction(pP
14420 61 67 65 72 2c 20 30 29 3b 0a 20 20 20 20 7d 0a ager, 0);. }.
14430 20 20 7d 0a 20 20 70 61 67 65 72 5f 75 6e 6c 6f }. pager_unlo
14440 63 6b 28 70 50 61 67 65 72 29 3b 0a 7d 0a 0a 2f ck(pPager);.}../
14450 2a 0a 2a 2a 20 50 61 72 61 6d 65 74 65 72 20 61 *.** Parameter a
14460 44 61 74 61 20 6d 75 73 74 20 70 6f 69 6e 74 20 Data must point
14470 74 6f 20 61 20 62 75 66 66 65 72 20 6f 66 20 70 to a buffer of p
14480 50 61 67 65 72 2d 3e 70 61 67 65 53 69 7a 65 20 Pager->pageSize
14490 62 79 74 65 73 0a 2a 2a 20 6f 66 20 64 61 74 61 bytes.** of data
144a0 2e 20 43 6f 6d 70 75 74 65 20 61 6e 64 20 72 65 . Compute and re
144b0 74 75 72 6e 20 61 20 63 68 65 63 6b 73 75 6d 20 turn a checksum
144c0 62 61 73 65 64 20 6f 6e 74 20 74 68 65 20 63 6f based ont the co
144d0 6e 74 65 6e 74 73 20 6f 66 20 74 68 65 20 0a 2a ntents of the .*
144e0 2a 20 70 61 67 65 20 6f 66 20 64 61 74 61 20 61 * page of data a
144f0 6e 64 20 74 68 65 20 63 75 72 72 65 6e 74 20 76 nd the current v
14500 61 6c 75 65 20 6f 66 20 70 50 61 67 65 72 2d 3e alue of pPager->
14510 63 6b 73 75 6d 49 6e 69 74 2e 0a 2a 2a 0a 2a 2a cksumInit..**.**
14520 20 54 68 69 73 20 69 73 20 6e 6f 74 20 61 20 72 This is not a r
14530 65 61 6c 20 63 68 65 63 6b 73 75 6d 2e 20 49 74 eal checksum. It
14540 20 69 73 20 72 65 61 6c 6c 79 20 6a 75 73 74 20 is really just
14550 74 68 65 20 73 75 6d 20 6f 66 20 74 68 65 20 0a the sum of the .
14560 2a 2a 20 72 61 6e 64 6f 6d 20 69 6e 69 74 69 61 ** random initia
14570 6c 20 76 61 6c 75 65 20 28 70 50 61 67 65 72 2d l value (pPager-
14580 3e 63 6b 73 75 6d 49 6e 69 74 29 20 61 6e 64 20 >cksumInit) and
14590 65 76 65 72 79 20 32 30 30 74 68 20 62 79 74 65 every 200th byte
145a0 0a 2a 2a 20 6f 66 20 74 68 65 20 70 61 67 65 20 .** of the page
145b0 64 61 74 61 2c 20 73 74 61 72 74 69 6e 67 20 77 data, starting w
145c0 69 74 68 20 62 79 74 65 20 6f 66 66 73 65 74 20 ith byte offset
145d0 28 70 50 61 67 65 72 2d 3e 70 61 67 65 53 69 7a (pPager->pageSiz
145e0 65 25 32 30 30 29 2e 0a 2a 2a 20 45 61 63 68 20 e%200)..** Each
145f0 62 79 74 65 20 69 73 20 69 6e 74 65 72 70 72 65 byte is interpre
14600 74 65 64 20 61 73 20 61 6e 20 38 2d 62 69 74 20 ted as an 8-bit
14610 75 6e 73 69 67 6e 65 64 20 69 6e 74 65 67 65 72 unsigned integer
14620 2e 0a 2a 2a 0a 2a 2a 20 43 68 61 6e 67 69 6e 67 ..**.** Changing
14630 20 74 68 65 20 66 6f 72 6d 75 6c 61 20 75 73 65 the formula use
14640 64 20 74 6f 20 63 6f 6d 70 75 74 65 20 74 68 69 d to compute thi
14650 73 20 63 68 65 63 6b 73 75 6d 20 72 65 73 75 6c s checksum resul
14660 74 73 20 69 6e 20 61 6e 0a 2a 2a 20 69 6e 63 6f ts in an.** inco
14670 6d 70 61 74 69 62 6c 65 20 6a 6f 75 72 6e 61 6c mpatible journal
14680 20 66 69 6c 65 20 66 6f 72 6d 61 74 2e 0a 2a 2a file format..**
14690 0a 2a 2a 20 49 66 20 6a 6f 75 72 6e 61 6c 20 63 .** If journal c
146a0 6f 72 72 75 70 74 69 6f 6e 20 6f 63 63 75 72 73 orruption occurs
146b0 20 64 75 65 20 74 6f 20 61 20 70 6f 77 65 72 20 due to a power
146c0 66 61 69 6c 75 72 65 2c 20 74 68 65 20 6d 6f 73 failure, the mos
146d0 74 20 6c 69 6b 65 6c 79 20 0a 2a 2a 20 73 63 65 t likely .** sce
146e0 6e 61 72 69 6f 20 69 73 20 74 68 61 74 20 6f 6e nario is that on
146f0 65 20 65 6e 64 20 6f 72 20 74 68 65 20 6f 74 68 e end or the oth
14700 65 72 20 6f 66 20 74 68 65 20 72 65 63 6f 72 64 er of the record
14710 20 77 69 6c 6c 20 62 65 20 63 68 61 6e 67 65 64 will be changed
14720 2e 20 0a 2a 2a 20 49 74 20 69 73 20 6d 75 63 68 . .** It is much
14730 20 6c 65 73 73 20 6c 69 6b 65 6c 79 20 74 68 61 less likely tha
14740 74 20 74 68 65 20 74 77 6f 20 65 6e 64 73 20 6f t the two ends o
14750 66 20 74 68 65 20 6a 6f 75 72 6e 61 6c 20 72 65 f the journal re
14760 63 6f 72 64 20 77 69 6c 6c 20 62 65 0a 2a 2a 20 cord will be.**
14770 63 6f 72 72 65 63 74 20 61 6e 64 20 74 68 65 20 correct and the
14780 6d 69 64 64 6c 65 20 62 65 20 63 6f 72 72 75 70 middle be corrup
14790 74 2e 20 20 54 68 75 73 2c 20 74 68 69 73 20 22 t. Thus, this "
147a0 63 68 65 63 6b 73 75 6d 22 20 73 63 68 65 6d 65 checksum" scheme
147b0 2c 0a 2a 2a 20 74 68 6f 75 67 68 20 66 61 73 74 ,.** though fast
147c0 20 61 6e 64 20 73 69 6d 70 6c 65 2c 20 63 61 74 and simple, cat
147d0 63 68 65 73 20 74 68 65 20 6d 6f 73 74 6c 79 20 ches the mostly
147e0 6c 69 6b 65 6c 79 20 6b 69 6e 64 20 6f 66 20 63 likely kind of c
147f0 6f 72 72 75 70 74 69 6f 6e 2e 0a 2a 2f 0a 73 74 orruption..*/.st
14800 61 74 69 63 20 75 33 32 20 70 61 67 65 72 5f 63 atic u32 pager_c
14810 6b 73 75 6d 28 50 61 67 65 72 20 2a 70 50 61 67 ksum(Pager *pPag
14820 65 72 2c 20 63 6f 6e 73 74 20 75 38 20 2a 61 44 er, const u8 *aD
14830 61 74 61 29 7b 0a 20 20 75 33 32 20 63 6b 73 75 ata){. u32 cksu
14840 6d 20 3d 20 70 50 61 67 65 72 2d 3e 63 6b 73 75 m = pPager->cksu
14850 6d 49 6e 69 74 3b 20 20 20 20 20 20 20 20 20 2f mInit; /
14860 2a 20 43 68 65 63 6b 73 75 6d 20 76 61 6c 75 65 * Checksum value
14870 20 74 6f 20 72 65 74 75 72 6e 20 2a 2f 0a 20 20 to return */.
14880 69 6e 74 20 69 20 3d 20 70 50 61 67 65 72 2d 3e int i = pPager->
14890 70 61 67 65 53 69 7a 65 2d 32 30 30 3b 20 20 20 pageSize-200;
148a0 20 20 20 20 20 20 20 2f 2a 20 4c 6f 6f 70 20 63 /* Loop c
148b0 6f 75 6e 74 65 72 20 2a 2f 0a 20 20 77 68 69 6c ounter */. whil
148c0 65 28 20 69 3e 30 20 29 7b 0a 20 20 20 20 63 6b e( i>0 ){. ck
148d0 73 75 6d 20 2b 3d 20 61 44 61 74 61 5b 69 5d 3b sum += aData[i];
148e0 0a 20 20 20 20 69 20 2d 3d 20 32 30 30 3b 0a 20 . i -= 200;.
148f0 20 7d 0a 20 20 72 65 74 75 72 6e 20 63 6b 73 75 }. return cksu
14900 6d 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 52 65 70 6f m;.}../*.** Repo
14910 72 74 20 74 68 65 20 63 75 72 72 65 6e 74 20 70 rt the current p
14920 61 67 65 20 73 69 7a 65 20 61 6e 64 20 6e 75 6d age size and num
14930 62 65 72 20 6f 66 20 72 65 73 65 72 76 65 64 20 ber of reserved
14940 62 79 74 65 73 20 62 61 63 6b 0a 2a 2a 20 74 6f bytes back.** to
14950 20 74 68 65 20 63 6f 64 65 63 2e 0a 2a 2f 0a 23 the codec..*/.#
14960 69 66 64 65 66 20 53 51 4c 49 54 45 5f 48 41 53 ifdef SQLITE_HAS
14970 5f 43 4f 44 45 43 0a 73 74 61 74 69 63 20 76 6f _CODEC.static vo
14980 69 64 20 70 61 67 65 72 52 65 70 6f 72 74 53 69 id pagerReportSi
14990 7a 65 28 50 61 67 65 72 20 2a 70 50 61 67 65 72 ze(Pager *pPager
149a0 29 7b 0a 20 20 69 66 28 20 70 50 61 67 65 72 2d ){. if( pPager-
149b0 3e 78 43 6f 64 65 63 53 69 7a 65 43 68 6e 67 20 >xCodecSizeChng
149c0 29 7b 0a 20 20 20 20 70 50 61 67 65 72 2d 3e 78 ){. pPager->x
149d0 43 6f 64 65 63 53 69 7a 65 43 68 6e 67 28 70 50 CodecSizeChng(pP
149e0 61 67 65 72 2d 3e 70 43 6f 64 65 63 2c 20 70 50 ager->pCodec, pP
149f0 61 67 65 72 2d 3e 70 61 67 65 53 69 7a 65 2c 0a ager->pageSize,.
14a00 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
14a10 20 20 20 20 20 20 20 20 20 20 20 28 69 6e 74 29 (int)
14a20 70 50 61 67 65 72 2d 3e 6e 52 65 73 65 72 76 65 pPager->nReserve
14a30 29 3b 0a 20 20 7d 0a 7d 0a 23 65 6c 73 65 0a 23 );. }.}.#else.#
14a40 20 64 65 66 69 6e 65 20 70 61 67 65 72 52 65 70 define pagerRep
14a50 6f 72 74 53 69 7a 65 28 58 29 20 20 20 20 20 2f ortSize(X) /
14a60 2a 20 4e 6f 2d 6f 70 20 69 66 20 77 65 20 64 6f * No-op if we do
14a70 20 6e 6f 74 20 73 75 70 70 6f 72 74 20 61 20 63 not support a c
14a80 6f 64 65 63 20 2a 2f 0a 23 65 6e 64 69 66 0a 0a odec */.#endif..
14a90 2f 2a 0a 2a 2a 20 52 65 61 64 20 61 20 73 69 6e /*.** Read a sin
14aa0 67 6c 65 20 70 61 67 65 20 66 72 6f 6d 20 65 69 gle page from ei
14ab0 74 68 65 72 20 74 68 65 20 6a 6f 75 72 6e 61 6c ther the journal
14ac0 20 66 69 6c 65 20 28 69 66 20 69 73 4d 61 69 6e file (if isMain
14ad0 4a 72 6e 6c 3d 3d 31 29 20 6f 72 0a 2a 2a 20 66 Jrnl==1) or.** f
14ae0 72 6f 6d 20 74 68 65 20 73 75 62 2d 6a 6f 75 72 rom the sub-jour
14af0 6e 61 6c 20 28 69 66 20 69 73 4d 61 69 6e 4a 72 nal (if isMainJr
14b00 6e 6c 3d 3d 30 29 20 61 6e 64 20 70 6c 61 79 62 nl==0) and playb
14b10 61 63 6b 20 74 68 61 74 20 70 61 67 65 2e 0a 2a ack that page..*
14b20 2a 20 54 68 65 20 70 61 67 65 20 62 65 67 69 6e * The page begin
14b30 73 20 61 74 20 6f 66 66 73 65 74 20 2a 70 4f 66 s at offset *pOf
14b40 66 73 65 74 20 69 6e 74 6f 20 74 68 65 20 66 69 fset into the fi
14b50 6c 65 2e 20 54 68 65 20 2a 70 4f 66 66 73 65 74 le. The *pOffset
14b60 0a 2a 2a 20 76 61 6c 75 65 20 69 73 20 69 6e 63 .** value is inc
14b70 72 65 61 73 65 64 20 74 6f 20 74 68 65 20 73 74 reased to the st
14b80 61 72 74 20 6f 66 20 74 68 65 20 6e 65 78 74 20 art of the next
14b90 70 61 67 65 20 69 6e 20 74 68 65 20 6a 6f 75 72 page in the jour
14ba0 6e 61 6c 2e 0a 2a 2a 0a 2a 2a 20 54 68 65 20 6d nal..**.** The m
14bb0 61 69 6e 20 72 6f 6c 6c 62 61 63 6b 20 6a 6f 75 ain rollback jou
14bc0 72 6e 61 6c 20 75 73 65 73 20 63 68 65 63 6b 73 rnal uses checks
14bd0 75 6d 73 20 2d 20 74 68 65 20 73 74 61 74 65 6d ums - the statem
14be0 65 6e 74 20 6a 6f 75 72 6e 61 6c 20 64 6f 65 73 ent journal does
14bf0 20 0a 2a 2a 20 6e 6f 74 2e 0a 2a 2a 0a 2a 2a 20 .** not..**.**
14c00 49 66 20 74 68 65 20 70 61 67 65 20 6e 75 6d 62 If the page numb
14c10 65 72 20 6f 66 20 74 68 65 20 70 61 67 65 20 72 er of the page r
14c20 65 63 6f 72 64 20 72 65 61 64 20 66 72 6f 6d 20 ecord read from
14c30 74 68 65 20 28 73 75 62 2d 29 6a 6f 75 72 6e 61 the (sub-)journa
14c40 6c 20 66 69 6c 65 0a 2a 2a 20 69 73 20 67 72 65 l file.** is gre
14c50 61 74 65 72 20 74 68 61 6e 20 74 68 65 20 63 75 ater than the cu
14c60 72 72 65 6e 74 20 76 61 6c 75 65 20 6f 66 20 50 rrent value of P
14c70 61 67 65 72 2e 64 62 53 69 7a 65 2c 20 74 68 65 ager.dbSize, the
14c80 6e 20 70 6c 61 79 62 61 63 6b 20 69 73 0a 2a 2a n playback is.**
14c90 20 73 6b 69 70 70 65 64 20 61 6e 64 20 53 51 4c skipped and SQL
14ca0 49 54 45 5f 4f 4b 20 69 73 20 72 65 74 75 72 6e ITE_OK is return
14cb0 65 64 2e 0a 2a 2a 0a 2a 2a 20 49 66 20 70 44 6f ed..**.** If pDo
14cc0 6e 65 20 69 73 20 6e 6f 74 20 4e 55 4c 4c 2c 20 ne is not NULL,
14cd0 74 68 65 6e 20 69 74 20 69 73 20 61 20 72 65 63 then it is a rec
14ce0 6f 72 64 20 6f 66 20 70 61 67 65 73 20 74 68 61 ord of pages tha
14cf0 74 20 68 61 76 65 20 61 6c 72 65 61 64 79 0a 2a t have already.*
14d00 2a 20 62 65 65 6e 20 70 6c 61 79 65 64 20 62 61 * been played ba
14d10 63 6b 2e 20 20 49 66 20 74 68 65 20 70 61 67 65 ck. If the page
14d20 20 61 74 20 2a 70 4f 66 66 73 65 74 20 68 61 73 at *pOffset has
14d30 20 61 6c 72 65 61 64 79 20 62 65 65 6e 20 70 6c already been pl
14d40 61 79 65 64 20 62 61 63 6b 0a 2a 2a 20 28 69 66 ayed back.** (if
14d50 20 74 68 65 20 63 6f 72 72 65 73 70 6f 6e 64 69 the correspondi
14d60 6e 67 20 70 44 6f 6e 65 20 62 69 74 20 69 73 20 ng pDone bit is
14d70 73 65 74 29 20 74 68 65 6e 20 73 6b 69 70 20 74 set) then skip t
14d80 68 65 20 70 6c 61 79 62 61 63 6b 2e 0a 2a 2a 20 he playback..**
14d90 4d 61 6b 65 20 73 75 72 65 20 74 68 65 20 70 44 Make sure the pD
14da0 6f 6e 65 20 62 69 74 20 63 6f 72 72 65 73 70 6f one bit correspo
14db0 6e 64 69 6e 67 20 74 6f 20 74 68 65 20 2a 70 4f nding to the *pO
14dc0 66 66 73 65 74 20 70 61 67 65 20 69 73 20 73 65 ffset page is se
14dd0 74 0a 2a 2a 20 70 72 69 6f 72 20 74 6f 20 72 65 t.** prior to re
14de0 74 75 72 6e 69 6e 67 2e 0a 2a 2a 0a 2a 2a 20 49 turning..**.** I
14df0 66 20 74 68 65 20 70 61 67 65 20 72 65 63 6f 72 f the page recor
14e00 64 20 69 73 20 73 75 63 63 65 73 73 66 75 6c 6c d is successfull
14e10 79 20 72 65 61 64 20 66 72 6f 6d 20 74 68 65 20 y read from the
14e20 28 73 75 62 2d 29 6a 6f 75 72 6e 61 6c 20 66 69 (sub-)journal fi
14e30 6c 65 0a 2a 2a 20 61 6e 64 20 70 6c 61 79 65 64 le.** and played
14e40 20 62 61 63 6b 2c 20 74 68 65 6e 20 53 51 4c 49 back, then SQLI
14e50 54 45 5f 4f 4b 20 69 73 20 72 65 74 75 72 6e 65 TE_OK is returne
14e60 64 2e 20 49 66 20 61 6e 20 49 4f 20 65 72 72 6f d. If an IO erro
14e70 72 20 6f 63 63 75 72 73 0a 2a 2a 20 77 68 69 6c r occurs.** whil
14e80 65 20 72 65 61 64 69 6e 67 20 74 68 65 20 72 65 e reading the re
14e90 63 6f 72 64 20 66 72 6f 6d 20 74 68 65 20 28 73 cord from the (s
14ea0 75 62 2d 29 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 ub-)journal file
14eb0 20 6f 72 20 77 68 69 6c 65 20 77 72 69 74 69 6e or while writin
14ec0 67 0a 2a 2a 20 74 6f 20 74 68 65 20 64 61 74 61 g.** to the data
14ed0 62 61 73 65 20 66 69 6c 65 2c 20 74 68 65 6e 20 base file, then
14ee0 74 68 65 20 49 4f 20 65 72 72 6f 72 20 63 6f 64 the IO error cod
14ef0 65 20 69 73 20 72 65 74 75 72 6e 65 64 2e 20 49 e is returned. I
14f00 66 20 64 61 74 61 0a 2a 2a 20 69 73 20 73 75 63 f data.** is suc
14f10 63 65 73 73 66 75 6c 6c 79 20 72 65 61 64 20 66 cessfully read f
14f20 72 6f 6d 20 74 68 65 20 28 73 75 62 2d 29 6a 6f rom the (sub-)jo
14f30 75 72 6e 61 6c 20 66 69 6c 65 20 62 75 74 20 61 urnal file but a
14f40 70 70 65 61 72 73 20 74 6f 20 62 65 0a 2a 2a 20 ppears to be.**
14f50 63 6f 72 72 75 70 74 65 64 2c 20 53 51 4c 49 54 corrupted, SQLIT
14f60 45 5f 44 4f 4e 45 20 69 73 20 72 65 74 75 72 6e E_DONE is return
14f70 65 64 2e 20 44 61 74 61 20 69 73 20 63 6f 6e 73 ed. Data is cons
14f80 69 64 65 72 65 64 20 63 6f 72 72 75 70 74 65 64 idered corrupted
14f90 20 69 6e 0a 2a 2a 20 74 77 6f 20 63 69 72 63 75 in.** two circu
14fa0 6d 73 74 61 6e 63 65 73 3a 0a 2a 2a 20 0a 2a 2a mstances:.** .**
14fb0 20 20 20 2a 20 49 66 20 74 68 65 20 72 65 63 6f * If the reco
14fc0 72 64 20 70 61 67 65 2d 6e 75 6d 62 65 72 20 69 rd page-number i
14fd0 73 20 69 6c 6c 65 67 61 6c 20 28 30 20 6f 72 20 s illegal (0 or
14fe0 50 41 47 45 52 5f 4d 4a 5f 50 47 4e 4f 29 2c 20 PAGER_MJ_PGNO),
14ff0 6f 72 0a 2a 2a 20 20 20 2a 20 49 66 20 74 68 65 or.** * If the
15000 20 72 65 63 6f 72 64 20 69 73 20 62 65 69 6e 67 record is being
15010 20 72 6f 6c 6c 65 64 20 62 61 63 6b 20 66 72 6f rolled back fro
15020 6d 20 74 68 65 20 6d 61 69 6e 20 6a 6f 75 72 6e m the main journ
15030 61 6c 20 66 69 6c 65 0a 2a 2a 20 20 20 20 20 61 al file.** a
15040 6e 64 20 74 68 65 20 63 68 65 63 6b 73 75 6d 20 nd the checksum
15050 66 69 65 6c 64 20 64 6f 65 73 20 6e 6f 74 20 6d field does not m
15060 61 74 63 68 20 74 68 65 20 72 65 63 6f 72 64 20 atch the record
15070 63 6f 6e 74 65 6e 74 2e 0a 2a 2a 0a 2a 2a 20 4e content..**.** N
15080 65 69 74 68 65 72 20 6f 66 20 74 68 65 73 65 20 either of these
15090 74 77 6f 20 73 63 65 6e 61 72 69 6f 73 20 61 72 two scenarios ar
150a0 65 20 70 6f 73 73 69 62 6c 65 20 64 75 72 69 6e e possible durin
150b0 67 20 61 20 73 61 76 65 70 6f 69 6e 74 20 72 6f g a savepoint ro
150c0 6c 6c 62 61 63 6b 2e 0a 2a 2a 0a 2a 2a 20 49 66 llback..**.** If
150d0 20 74 68 69 73 20 69 73 20 61 20 73 61 76 65 70 this is a savep
150e0 6f 69 6e 74 20 72 6f 6c 6c 62 61 63 6b 2c 20 74 oint rollback, t
150f0 68 65 6e 20 6d 65 6d 6f 72 79 20 6d 61 79 20 68 hen memory may h
15100 61 76 65 20 74 6f 20 62 65 20 64 79 6e 61 6d 69 ave to be dynami
15110 63 61 6c 6c 79 0a 2a 2a 20 61 6c 6c 6f 63 61 74 cally.** allocat
15120 65 64 20 62 79 20 74 68 69 73 20 66 75 6e 63 74 ed by this funct
15130 69 6f 6e 2e 20 49 66 20 74 68 69 73 20 69 73 20 ion. If this is
15140 74 68 65 20 63 61 73 65 20 61 6e 64 20 61 6e 20 the case and an
15150 61 6c 6c 6f 63 61 74 69 6f 6e 20 66 61 69 6c 73 allocation fails
15160 2c 0a 2a 2a 20 53 51 4c 49 54 45 5f 4e 4f 4d 45 ,.** SQLITE_NOME
15170 4d 20 69 73 20 72 65 74 75 72 6e 65 64 2e 0a 2a M is returned..*
15180 2f 0a 73 74 61 74 69 63 20 69 6e 74 20 70 61 67 /.static int pag
15190 65 72 5f 70 6c 61 79 62 61 63 6b 5f 6f 6e 65 5f er_playback_one_
151a0 70 61 67 65 28 0a 20 20 50 61 67 65 72 20 2a 70 page(. Pager *p
151b0 50 61 67 65 72 2c 20 20 20 20 20 20 20 20 20 20 Pager,
151c0 20 20 20 20 20 20 2f 2a 20 54 68 65 20 70 61 67 /* The pag
151d0 65 72 20 62 65 69 6e 67 20 70 6c 61 79 65 64 20 er being played
151e0 62 61 63 6b 20 2a 2f 0a 20 20 69 36 34 20 2a 70 back */. i64 *p
151f0 4f 66 66 73 65 74 2c 20 20 20 20 20 20 20 20 20 Offset,
15200 20 20 20 20 20 20 20 20 2f 2a 20 4f 66 66 73 65 /* Offse
15210 74 20 6f 66 20 72 65 63 6f 72 64 20 74 6f 20 70 t of record to p
15220 6c 61 79 62 61 63 6b 20 2a 2f 0a 20 20 42 69 74 layback */. Bit
15230 76 65 63 20 2a 70 44 6f 6e 65 2c 20 20 20 20 20 vec *pDone,
15240 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 42 69 /* Bi
15250 74 76 65 63 20 6f 66 20 70 61 67 65 73 20 61 6c tvec of pages al
15260 72 65 61 64 79 20 70 6c 61 79 65 64 20 62 61 63 ready played bac
15270 6b 20 2a 2f 0a 20 20 69 6e 74 20 69 73 4d 61 69 k */. int isMai
15280 6e 4a 72 6e 6c 2c 20 20 20 20 20 20 20 20 20 20 nJrnl,
15290 20 20 20 20 20 2f 2a 20 31 20 2d 3e 20 6d 61 69 /* 1 -> mai
152a0 6e 20 6a 6f 75 72 6e 61 6c 2e 20 30 20 2d 3e 20 n journal. 0 ->
152b0 73 75 62 2d 6a 6f 75 72 6e 61 6c 2e 20 2a 2f 0a sub-journal. */.
152c0 20 20 69 6e 74 20 69 73 53 61 76 65 70 6e 74 20 int isSavepnt
152d0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
152e0 2f 2a 20 54 72 75 65 20 66 6f 72 20 61 20 73 61 /* True for a sa
152f0 76 65 70 6f 69 6e 74 20 72 6f 6c 6c 62 61 63 6b vepoint rollback
15300 20 2a 2f 0a 29 7b 0a 20 20 69 6e 74 20 72 63 3b */.){. int rc;
15310 0a 20 20 50 67 48 64 72 20 2a 70 50 67 3b 20 20 . PgHdr *pPg;
15320 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
15330 20 2f 2a 20 41 6e 20 65 78 69 73 74 69 6e 67 20 /* An existing
15340 70 61 67 65 20 69 6e 20 74 68 65 20 63 61 63 68 page in the cach
15350 65 20 2a 2f 0a 20 20 50 67 6e 6f 20 70 67 6e 6f e */. Pgno pgno
15360 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 ;
15370 20 20 20 20 20 2f 2a 20 54 68 65 20 70 61 67 65 /* The page
15380 20 6e 75 6d 62 65 72 20 6f 66 20 61 20 70 61 67 number of a pag
15390 65 20 69 6e 20 6a 6f 75 72 6e 61 6c 20 2a 2f 0a e in journal */.
153a0 20 20 75 33 32 20 63 6b 73 75 6d 3b 20 20 20 20 u32 cksum;
153b0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
153c0 2f 2a 20 43 68 65 63 6b 73 75 6d 20 75 73 65 64 /* Checksum used
153d0 20 66 6f 72 20 73 61 6e 69 74 79 20 63 68 65 63 for sanity chec
153e0 6b 69 6e 67 20 2a 2f 0a 20 20 63 68 61 72 20 2a king */. char *
153f0 61 44 61 74 61 3b 20 20 20 20 20 20 20 20 20 20 aData;
15400 20 20 20 20 20 20 20 20 2f 2a 20 54 65 6d 70 6f /* Tempo
15410 72 61 72 79 20 73 74 6f 72 61 67 65 20 66 6f 72 rary storage for
15420 20 74 68 65 20 70 61 67 65 20 2a 2f 0a 20 20 73 the page */. s
15430 71 6c 69 74 65 33 5f 66 69 6c 65 20 2a 6a 66 64 qlite3_file *jfd
15440 3b 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 ; /*
15450 54 68 65 20 66 69 6c 65 20 64 65 73 63 72 69 70 The file descrip
15460 74 6f 72 20 66 6f 72 20 74 68 65 20 6a 6f 75 72 tor for the jour
15470 6e 61 6c 20 66 69 6c 65 20 2a 2f 0a 20 20 69 6e nal file */. in
15480 74 20 69 73 53 79 6e 63 65 64 3b 20 20 20 20 20 t isSynced;
15490 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 54 /* T
154a0 72 75 65 20 69 66 20 6a 6f 75 72 6e 61 6c 20 70 rue if journal p
154b0 61 67 65 20 69 73 20 73 79 6e 63 65 64 20 2a 2f age is synced */
154c0 0a 0a 20 20 61 73 73 65 72 74 28 20 28 69 73 4d .. assert( (isM
154d0 61 69 6e 4a 72 6e 6c 26 7e 31 29 3d 3d 30 20 29 ainJrnl&~1)==0 )
154e0 3b 20 20 20 20 20 20 2f 2a 20 69 73 4d 61 69 6e ; /* isMain
154f0 4a 72 6e 6c 20 69 73 20 30 20 6f 72 20 31 20 2a Jrnl is 0 or 1 *
15500 2f 0a 20 20 61 73 73 65 72 74 28 20 28 69 73 53 /. assert( (isS
15510 61 76 65 70 6e 74 26 7e 31 29 3d 3d 30 20 29 3b avepnt&~1)==0 );
15520 20 20 20 20 20 20 20 2f 2a 20 69 73 53 61 76 65 /* isSave
15530 70 6e 74 20 69 73 20 30 20 6f 72 20 31 20 2a 2f pnt is 0 or 1 */
15540 0a 20 20 61 73 73 65 72 74 28 20 69 73 4d 61 69 . assert( isMai
15550 6e 4a 72 6e 6c 20 7c 7c 20 70 44 6f 6e 65 20 29 nJrnl || pDone )
15560 3b 20 20 20 20 20 2f 2a 20 70 44 6f 6e 65 20 61 ; /* pDone a
15570 6c 77 61 79 73 20 75 73 65 64 20 6f 6e 20 73 75 lways used on su
15580 62 2d 6a 6f 75 72 6e 61 6c 73 20 2a 2f 0a 20 20 b-journals */.
15590 61 73 73 65 72 74 28 20 69 73 53 61 76 65 70 6e assert( isSavepn
155a0 74 20 7c 7c 20 70 44 6f 6e 65 3d 3d 30 20 29 3b t || pDone==0 );
155b0 20 20 20 2f 2a 20 70 44 6f 6e 65 20 6e 65 76 65 /* pDone neve
155c0 72 20 75 73 65 64 20 6f 6e 20 6e 6f 6e 2d 73 61 r used on non-sa
155d0 76 65 70 6f 69 6e 74 20 2a 2f 0a 0a 20 20 61 44 vepoint */.. aD
155e0 61 74 61 20 3d 20 70 50 61 67 65 72 2d 3e 70 54 ata = pPager->pT
155f0 6d 70 53 70 61 63 65 3b 0a 20 20 61 73 73 65 72 mpSpace;. asser
15600 74 28 20 61 44 61 74 61 20 29 3b 20 20 20 20 20 t( aData );
15610 20 20 20 20 2f 2a 20 54 65 6d 70 20 73 74 6f 72 /* Temp stor
15620 61 67 65 20 6d 75 73 74 20 68 61 76 65 20 61 6c age must have al
15630 72 65 61 64 79 20 62 65 65 6e 20 61 6c 6c 6f 63 ready been alloc
15640 61 74 65 64 20 2a 2f 0a 20 20 61 73 73 65 72 74 ated */. assert
15650 28 20 70 61 67 65 72 55 73 65 57 61 6c 28 70 50 ( pagerUseWal(pP
15660 61 67 65 72 29 3d 3d 30 20 7c 7c 20 28 21 69 73 ager)==0 || (!is
15670 4d 61 69 6e 4a 72 6e 6c 20 26 26 20 69 73 53 61 MainJrnl && isSa
15680 76 65 70 6e 74 29 20 29 3b 0a 0a 20 20 2f 2a 20 vepnt) );.. /*
15690 45 69 74 68 65 72 20 74 68 65 20 73 74 61 74 65 Either the state
156a0 20 69 73 20 67 72 65 61 74 65 72 20 74 68 61 6e is greater than
156b0 20 50 41 47 45 52 5f 57 52 49 54 45 52 5f 43 41 PAGER_WRITER_CA
156c0 43 48 45 4d 4f 44 20 28 61 20 74 72 61 6e 73 61 CHEMOD (a transa
156d0 63 74 69 6f 6e 20 0a 20 20 2a 2a 20 6f 72 20 73 ction . ** or s
156e0 61 76 65 70 6f 69 6e 74 20 72 6f 6c 6c 62 61 63 avepoint rollbac
156f0 6b 20 64 6f 6e 65 20 61 74 20 74 68 65 20 72 65 k done at the re
15700 71 75 65 73 74 20 6f 66 20 74 68 65 20 63 61 6c quest of the cal
15710 6c 65 72 29 20 6f 72 20 74 68 69 73 20 69 73 0a ler) or this is.
15720 20 20 2a 2a 20 61 20 68 6f 74 2d 6a 6f 75 72 6e ** a hot-journ
15730 61 6c 20 72 6f 6c 6c 62 61 63 6b 2e 20 49 66 20 al rollback. If
15740 69 74 20 69 73 20 61 20 68 6f 74 2d 6a 6f 75 72 it is a hot-jour
15750 6e 61 6c 20 72 6f 6c 6c 62 61 63 6b 2c 20 74 68 nal rollback, th
15760 65 20 70 61 67 65 72 0a 20 20 2a 2a 20 69 73 20 e pager. ** is
15770 69 6e 20 73 74 61 74 65 20 4f 50 45 4e 20 61 6e in state OPEN an
15780 64 20 68 6f 6c 64 73 20 61 6e 20 45 58 43 4c 55 d holds an EXCLU
15790 53 49 56 45 20 6c 6f 63 6b 2e 20 48 6f 74 2d 6a SIVE lock. Hot-j
157a0 6f 75 72 6e 61 6c 20 72 6f 6c 6c 62 61 63 6b 0a ournal rollback.
157b0 20 20 2a 2a 20 6f 6e 6c 79 20 72 65 61 64 73 20 ** only reads
157c0 66 72 6f 6d 20 74 68 65 20 6d 61 69 6e 20 6a 6f from the main jo
157d0 75 72 6e 61 6c 2c 20 6e 6f 74 20 74 68 65 20 73 urnal, not the s
157e0 75 62 2d 6a 6f 75 72 6e 61 6c 2e 0a 20 20 2a 2f ub-journal.. */
157f0 0a 20 20 61 73 73 65 72 74 28 20 70 50 61 67 65 . assert( pPage
15800 72 2d 3e 65 53 74 61 74 65 3e 3d 50 41 47 45 52 r->eState>=PAGER
15810 5f 57 52 49 54 45 52 5f 43 41 43 48 45 4d 4f 44 _WRITER_CACHEMOD
15820 0a 20 20 20 20 20 20 20 7c 7c 20 28 70 50 61 67 . || (pPag
15830 65 72 2d 3e 65 53 74 61 74 65 3d 3d 50 41 47 45 er->eState==PAGE
15840 52 5f 4f 50 45 4e 20 26 26 20 70 50 61 67 65 72 R_OPEN && pPager
15850 2d 3e 65 4c 6f 63 6b 3d 3d 45 58 43 4c 55 53 49 ->eLock==EXCLUSI
15860 56 45 5f 4c 4f 43 4b 29 0a 20 20 29 3b 0a 20 20 VE_LOCK). );.
15870 61 73 73 65 72 74 28 20 70 50 61 67 65 72 2d 3e assert( pPager->
15880 65 53 74 61 74 65 3e 3d 50 41 47 45 52 5f 57 52 eState>=PAGER_WR
15890 49 54 45 52 5f 43 41 43 48 45 4d 4f 44 20 7c 7c ITER_CACHEMOD ||
158a0 20 69 73 4d 61 69 6e 4a 72 6e 6c 20 29 3b 0a 0a isMainJrnl );..
158b0 20 20 2f 2a 20 52 65 61 64 20 74 68 65 20 70 61 /* Read the pa
158c0 67 65 20 6e 75 6d 62 65 72 20 61 6e 64 20 70 61 ge number and pa
158d0 67 65 20 64 61 74 61 20 66 72 6f 6d 20 74 68 65 ge data from the
158e0 20 6a 6f 75 72 6e 61 6c 20 6f 72 20 73 75 62 2d journal or sub-
158f0 6a 6f 75 72 6e 61 6c 0a 20 20 2a 2a 20 66 69 6c journal. ** fil
15900 65 2e 20 52 65 74 75 72 6e 20 61 6e 20 65 72 72 e. Return an err
15910 6f 72 20 63 6f 64 65 20 74 6f 20 74 68 65 20 63 or code to the c
15920 61 6c 6c 65 72 20 69 66 20 61 6e 20 49 4f 20 65 aller if an IO e
15930 72 72 6f 72 20 6f 63 63 75 72 73 2e 0a 20 20 2a rror occurs.. *
15940 2f 0a 20 20 6a 66 64 20 3d 20 69 73 4d 61 69 6e /. jfd = isMain
15950 4a 72 6e 6c 20 3f 20 70 50 61 67 65 72 2d 3e 6a Jrnl ? pPager->j
15960 66 64 20 3a 20 70 50 61 67 65 72 2d 3e 73 6a 66 fd : pPager->sjf
15970 64 3b 0a 20 20 72 63 20 3d 20 72 65 61 64 33 32 d;. rc = read32
15980 62 69 74 73 28 6a 66 64 2c 20 2a 70 4f 66 66 73 bits(jfd, *pOffs
15990 65 74 2c 20 26 70 67 6e 6f 29 3b 0a 20 20 69 66 et, &pgno);. if
159a0 28 20 72 63 21 3d 53 51 4c 49 54 45 5f 4f 4b 20 ( rc!=SQLITE_OK
159b0 29 20 72 65 74 75 72 6e 20 72 63 3b 0a 20 20 72 ) return rc;. r
159c0 63 20 3d 20 73 71 6c 69 74 65 33 4f 73 52 65 61 c = sqlite3OsRea
159d0 64 28 6a 66 64 2c 20 28 75 38 2a 29 61 44 61 74 d(jfd, (u8*)aDat
159e0 61 2c 20 70 50 61 67 65 72 2d 3e 70 61 67 65 53 a, pPager->pageS
159f0 69 7a 65 2c 20 28 2a 70 4f 66 66 73 65 74 29 2b ize, (*pOffset)+
15a00 34 29 3b 0a 20 20 69 66 28 20 72 63 21 3d 53 51 4);. if( rc!=SQ
15a10 4c 49 54 45 5f 4f 4b 20 29 20 72 65 74 75 72 6e LITE_OK ) return
15a20 20 72 63 3b 0a 20 20 2a 70 4f 66 66 73 65 74 20 rc;. *pOffset
15a30 2b 3d 20 70 50 61 67 65 72 2d 3e 70 61 67 65 53 += pPager->pageS
15a40 69 7a 65 20 2b 20 34 20 2b 20 69 73 4d 61 69 6e ize + 4 + isMain
15a50 4a 72 6e 6c 2a 34 3b 0a 0a 20 20 2f 2a 20 53 61 Jrnl*4;.. /* Sa
15a60 6e 69 74 79 20 63 68 65 63 6b 69 6e 67 20 6f 6e nity checking on
15a70 20 74 68 65 20 70 61 67 65 2e 20 20 54 68 69 73 the page. This
15a80 20 69 73 20 6d 6f 72 65 20 69 6d 70 6f 72 74 61 is more importa
15a90 6e 74 20 74 68 61 74 20 49 20 6f 72 69 67 69 6e nt that I origin
15aa0 61 6c 6c 79 0a 20 20 2a 2a 20 74 68 6f 75 67 68 ally. ** though
15ab0 74 2e 20 20 49 66 20 61 20 70 6f 77 65 72 20 66 t. If a power f
15ac0 61 69 6c 75 72 65 20 6f 63 63 75 72 73 20 77 68 ailure occurs wh
15ad0 69 6c 65 20 74 68 65 20 6a 6f 75 72 6e 61 6c 20 ile the journal
15ae0 69 73 20 62 65 69 6e 67 20 77 72 69 74 74 65 6e is being written
15af0 2c 0a 20 20 2a 2a 20 69 74 20 63 6f 75 6c 64 20 ,. ** it could
15b00 63 61 75 73 65 20 69 6e 76 61 6c 69 64 20 64 61 cause invalid da
15b10 74 61 20 74 6f 20 62 65 20 77 72 69 74 74 65 6e ta to be written
15b20 20 69 6e 74 6f 20 74 68 65 20 6a 6f 75 72 6e 61 into the journa
15b30 6c 2e 20 20 57 65 20 6e 65 65 64 20 74 6f 0a 20 l. We need to.
15b40 20 2a 2a 20 64 65 74 65 63 74 20 74 68 69 73 20 ** detect this
15b50 69 6e 76 61 6c 69 64 20 64 61 74 61 20 28 77 69 invalid data (wi
15b60 74 68 20 68 69 67 68 20 70 72 6f 62 61 62 69 6c th high probabil
15b70 69 74 79 29 20 61 6e 64 20 69 67 6e 6f 72 65 20 ity) and ignore
15b80 69 74 2e 0a 20 20 2a 2f 0a 20 20 69 66 28 20 70 it.. */. if( p
15b90 67 6e 6f 3d 3d 30 20 7c 7c 20 70 67 6e 6f 3d 3d gno==0 || pgno==
15ba0 50 41 47 45 52 5f 4d 4a 5f 50 47 4e 4f 28 70 50 PAGER_MJ_PGNO(pP
15bb0 61 67 65 72 29 20 29 7b 0a 20 20 20 20 61 73 73 ager) ){. ass
15bc0 65 72 74 28 20 21 69 73 53 61 76 65 70 6e 74 20 ert( !isSavepnt
15bd0 29 3b 0a 20 20 20 20 72 65 74 75 72 6e 20 53 51 );. return SQ
15be0 4c 49 54 45 5f 44 4f 4e 45 3b 0a 20 20 7d 0a 20 LITE_DONE;. }.
15bf0 20 69 66 28 20 70 67 6e 6f 3e 28 50 67 6e 6f 29 if( pgno>(Pgno)
15c00 70 50 61 67 65 72 2d 3e 64 62 53 69 7a 65 20 7c pPager->dbSize |
15c10 7c 20 73 71 6c 69 74 65 33 42 69 74 76 65 63 54 | sqlite3BitvecT
15c20 65 73 74 28 70 44 6f 6e 65 2c 20 70 67 6e 6f 29 est(pDone, pgno)
15c30 20 29 7b 0a 20 20 20 20 72 65 74 75 72 6e 20 53 ){. return S
15c40 51 4c 49 54 45 5f 4f 4b 3b 0a 20 20 7d 0a 20 20 QLITE_OK;. }.
15c50 69 66 28 20 69 73 4d 61 69 6e 4a 72 6e 6c 20 29 if( isMainJrnl )
15c60 7b 0a 20 20 20 20 72 63 20 3d 20 72 65 61 64 33 {. rc = read3
15c70 32 62 69 74 73 28 6a 66 64 2c 20 28 2a 70 4f 66 2bits(jfd, (*pOf
15c80 66 73 65 74 29 2d 34 2c 20 26 63 6b 73 75 6d 29 fset)-4, &cksum)
15c90 3b 0a 20 20 20 20 69 66 28 20 72 63 20 29 20 72 ;. if( rc ) r
15ca0 65 74 75 72 6e 20 72 63 3b 0a 20 20 20 20 69 66 eturn rc;. if
15cb0 28 20 21 69 73 53 61 76 65 70 6e 74 20 26 26 20 ( !isSavepnt &&
15cc0 70 61 67 65 72 5f 63 6b 73 75 6d 28 70 50 61 67 pager_cksum(pPag
15cd0 65 72 2c 20 28 75 38 2a 29 61 44 61 74 61 29 21 er, (u8*)aData)!
15ce0 3d 63 6b 73 75 6d 20 29 7b 0a 20 20 20 20 20 20 =cksum ){.
15cf0 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 44 4f return SQLITE_DO
15d00 4e 45 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a 0a 20 NE;. }. }..
15d10 20 2f 2a 20 49 66 20 74 68 69 73 20 70 61 67 65 /* If this page
15d20 20 68 61 73 20 61 6c 72 65 61 64 79 20 62 65 65 has already bee
15d30 6e 20 70 6c 61 79 65 64 20 62 79 20 62 65 66 6f n played by befo
15d40 72 65 20 64 75 72 69 6e 67 20 74 68 65 20 63 75 re during the cu
15d50 72 72 65 6e 74 0a 20 20 2a 2a 20 72 6f 6c 6c 62 rrent. ** rollb
15d60 61 63 6b 2c 20 74 68 65 6e 20 64 6f 6e 27 74 20 ack, then don't
15d70 62 6f 74 68 65 72 20 74 6f 20 70 6c 61 79 20 69 bother to play i
15d80 74 20 62 61 63 6b 20 61 67 61 69 6e 2e 0a 20 20 t back again..
15d90 2a 2f 0a 20 20 69 66 28 20 70 44 6f 6e 65 20 26 */. if( pDone &
15da0 26 20 28 72 63 20 3d 20 73 71 6c 69 74 65 33 42 & (rc = sqlite3B
15db0 69 74 76 65 63 53 65 74 28 70 44 6f 6e 65 2c 20 itvecSet(pDone,
15dc0 70 67 6e 6f 29 29 21 3d 53 51 4c 49 54 45 5f 4f pgno))!=SQLITE_O
15dd0 4b 20 29 7b 0a 20 20 20 20 72 65 74 75 72 6e 20 K ){. return
15de0 72 63 3b 0a 20 20 7d 0a 0a 20 20 2f 2a 20 57 68 rc;. }.. /* Wh
15df0 65 6e 20 70 6c 61 79 69 6e 67 20 62 61 63 6b 20 en playing back
15e00 70 61 67 65 20 31 2c 20 72 65 73 74 6f 72 65 20 page 1, restore
15e10 74 68 65 20 6e 52 65 73 65 72 76 65 20 73 65 74 the nReserve set
15e20 74 69 6e 67 0a 20 20 2a 2f 0a 20 20 69 66 28 20 ting. */. if(
15e30 70 67 6e 6f 3d 3d 31 20 26 26 20 70 50 61 67 65 pgno==1 && pPage
15e40 72 2d 3e 6e 52 65 73 65 72 76 65 21 3d 28 28 75 r->nReserve!=((u
15e50 38 2a 29 61 44 61 74 61 29 5b 32 30 5d 20 29 7b 8*)aData)[20] ){
15e60 0a 20 20 20 20 70 50 61 67 65 72 2d 3e 6e 52 65 . pPager->nRe
15e70 73 65 72 76 65 20 3d 20 28 28 75 38 2a 29 61 44 serve = ((u8*)aD
15e80 61 74 61 29 5b 32 30 5d 3b 0a 20 20 20 20 70 61 ata)[20];. pa
15e90 67 65 72 52 65 70 6f 72 74 53 69 7a 65 28 70 50 gerReportSize(pP
15ea0 61 67 65 72 29 3b 0a 20 20 7d 0a 0a 20 20 2f 2a ager);. }.. /*
15eb0 20 49 66 20 74 68 65 20 70 61 67 65 72 20 69 73 If the pager is
15ec0 20 69 6e 20 43 41 43 48 45 4d 4f 44 20 73 74 61 in CACHEMOD sta
15ed0 74 65 2c 20 74 68 65 6e 20 74 68 65 72 65 20 6d te, then there m
15ee0 75 73 74 20 62 65 20 61 20 63 6f 70 79 20 6f 66 ust be a copy of
15ef0 20 74 68 69 73 0a 20 20 2a 2a 20 70 61 67 65 20 this. ** page
15f00 69 6e 20 74 68 65 20 70 61 67 65 72 20 63 61 63 in the pager cac
15f10 68 65 2e 20 49 6e 20 74 68 69 73 20 63 61 73 65 he. In this case
15f20 20 6a 75 73 74 20 75 70 64 61 74 65 20 74 68 65 just update the
15f30 20 70 61 67 65 72 20 63 61 63 68 65 2c 0a 20 20 pager cache,.
15f40 2a 2a 20 6e 6f 74 20 74 68 65 20 64 61 74 61 62 ** not the datab
15f50 61 73 65 20 66 69 6c 65 2e 20 54 68 65 20 70 61 ase file. The pa
15f60 67 65 20 69 73 20 6c 65 66 74 20 6d 61 72 6b 65 ge is left marke
15f70 64 20 64 69 72 74 79 20 69 6e 20 74 68 69 73 20 d dirty in this
15f80 63 61 73 65 2e 0a 20 20 2a 2a 0a 20 20 2a 2a 20 case.. **. **
15f90 41 6e 20 65 78 63 65 70 74 69 6f 6e 20 74 6f 20 An exception to
15fa0 74 68 65 20 61 62 6f 76 65 20 72 75 6c 65 3a 20 the above rule:
15fb0 49 66 20 74 68 65 20 64 61 74 61 62 61 73 65 20 If the database
15fc0 69 73 20 69 6e 20 6e 6f 2d 73 79 6e 63 20 6d 6f is in no-sync mo
15fd0 64 65 0a 20 20 2a 2a 20 61 6e 64 20 61 20 70 61 de. ** and a pa
15fe0 67 65 20 69 73 20 6d 6f 76 65 64 20 64 75 72 69 ge is moved duri
15ff0 6e 67 20 61 6e 20 69 6e 63 72 65 6d 65 6e 74 61 ng an incrementa
16000 6c 20 76 61 63 75 75 6d 20 74 68 65 6e 20 74 68 l vacuum then th
16010 65 20 70 61 67 65 20 6d 61 79 0a 20 20 2a 2a 20 e page may. **
16020 6e 6f 74 20 62 65 20 69 6e 20 74 68 65 20 70 61 not be in the pa
16030 67 65 72 20 63 61 63 68 65 2e 20 4c 61 74 65 72 ger cache. Later
16040 3a 20 69 66 20 61 20 6d 61 6c 6c 6f 63 28 29 20 : if a malloc()
16050 6f 72 20 49 4f 20 65 72 72 6f 72 20 6f 63 63 75 or IO error occu
16060 72 73 0a 20 20 2a 2a 20 64 75 72 69 6e 67 20 61 rs. ** during a
16070 20 4d 6f 76 65 70 61 67 65 28 29 20 63 61 6c 6c Movepage() call
16080 2c 20 74 68 65 6e 20 74 68 65 20 70 61 67 65 20 , then the page
16090 6d 61 79 20 6e 6f 74 20 62 65 20 69 6e 20 74 68 may not be in th
160a0 65 20 63 61 63 68 65 0a 20 20 2a 2a 20 65 69 74 e cache. ** eit
160b0 68 65 72 2e 20 53 6f 20 74 68 65 20 63 6f 6e 64 her. So the cond
160c0 69 74 69 6f 6e 20 64 65 73 63 72 69 62 65 64 20 ition described
160d0 69 6e 20 74 68 65 20 61 62 6f 76 65 20 70 61 72 in the above par
160e0 61 67 72 61 70 68 20 69 73 20 6e 6f 74 0a 20 20 agraph is not.
160f0 2a 2a 20 61 73 73 65 72 74 28 29 61 62 6c 65 2e ** assert()able.
16100 0a 20 20 2a 2a 0a 20 20 2a 2a 20 49 66 20 69 6e . **. ** If in
16110 20 57 52 49 54 45 52 5f 44 42 4d 4f 44 2c 20 57 WRITER_DBMOD, W
16120 52 49 54 45 52 5f 46 49 4e 49 53 48 45 44 20 6f RITER_FINISHED o
16130 72 20 4f 50 45 4e 20 73 74 61 74 65 2c 20 74 68 r OPEN state, th
16140 65 6e 20 77 65 20 75 70 64 61 74 65 20 74 68 65 en we update the
16150 0a 20 20 2a 2a 20 70 61 67 65 72 20 63 61 63 68 . ** pager cach
16160 65 20 69 66 20 69 74 20 65 78 69 73 74 73 20 61 e if it exists a
16170 6e 64 20 74 68 65 20 6d 61 69 6e 20 66 69 6c 65 nd the main file
16180 2e 20 54 68 65 20 70 61 67 65 20 69 73 20 74 68 . The page is th
16190 65 6e 20 6d 61 72 6b 65 64 20 0a 20 20 2a 2a 20 en marked . **
161a0 6e 6f 74 20 64 69 72 74 79 2e 20 53 69 6e 63 65 not dirty. Since
161b0 20 74 68 69 73 20 63 6f 64 65 20 69 73 20 6f 6e this code is on
161c0 6c 79 20 65 78 65 63 75 74 65 64 20 69 6e 20 50 ly executed in P
161d0 41 47 45 52 5f 4f 50 45 4e 20 73 74 61 74 65 20 AGER_OPEN state
161e0 66 6f 72 0a 20 20 2a 2a 20 61 20 68 6f 74 2d 6a for. ** a hot-j
161f0 6f 75 72 6e 61 6c 20 72 6f 6c 6c 62 61 63 6b 2c ournal rollback,
16200 20 69 74 20 69 73 20 67 75 61 72 61 6e 74 65 65 it is guarantee
16210 64 20 74 68 61 74 20 74 68 65 20 70 61 67 65 2d d that the page-
16220 63 61 63 68 65 20 69 73 20 65 6d 70 74 79 0a 20 cache is empty.
16230 20 2a 2a 20 69 66 20 74 68 65 20 70 61 67 65 72 ** if the pager
16240 20 69 73 20 69 6e 20 4f 50 45 4e 20 73 74 61 74 is in OPEN stat
16250 65 2e 0a 20 20 2a 2a 0a 20 20 2a 2a 20 54 69 63 e.. **. ** Tic
16260 6b 65 74 20 23 31 31 37 31 3a 20 20 54 68 65 20 ket #1171: The
16270 73 74 61 74 65 6d 65 6e 74 20 6a 6f 75 72 6e 61 statement journa
16280 6c 20 6d 69 67 68 74 20 63 6f 6e 74 61 69 6e 20 l might contain
16290 70 61 67 65 20 63 6f 6e 74 65 6e 74 20 74 68 61 page content tha
162a0 74 20 69 73 0a 20 20 2a 2a 20 64 69 66 66 65 72 t is. ** differ
162b0 65 6e 74 20 66 72 6f 6d 20 74 68 65 20 70 61 67 ent from the pag
162c0 65 20 63 6f 6e 74 65 6e 74 20 61 74 20 74 68 65 e content at the
162d0 20 73 74 61 72 74 20 6f 66 20 74 68 65 20 74 72 start of the tr
162e0 61 6e 73 61 63 74 69 6f 6e 2e 0a 20 20 2a 2a 20 ansaction.. **
162f0 54 68 69 73 20 6f 63 63 75 72 73 20 77 68 65 6e This occurs when
16300 20 61 20 70 61 67 65 20 69 73 20 63 68 61 6e 67 a page is chang
16310 65 64 20 70 72 69 6f 72 20 74 6f 20 74 68 65 20 ed prior to the
16320 73 74 61 72 74 20 6f 66 20 61 20 73 74 61 74 65 start of a state
16330 6d 65 6e 74 0a 20 20 2a 2a 20 74 68 65 6e 20 63 ment. ** then c
16340 68 61 6e 67 65 64 20 61 67 61 69 6e 20 77 69 74 hanged again wit
16350 68 69 6e 20 74 68 65 20 73 74 61 74 65 6d 65 6e hin the statemen
16360 74 2e 20 20 57 68 65 6e 20 72 6f 6c 6c 69 6e 67 t. When rolling
16370 20 62 61 63 6b 20 73 75 63 68 20 61 0a 20 20 2a back such a. *
16380 2a 20 73 74 61 74 65 6d 65 6e 74 20 77 65 20 6d * statement we m
16390 75 73 74 20 6e 6f 74 20 77 72 69 74 65 20 74 6f ust not write to
163a0 20 74 68 65 20 6f 72 69 67 69 6e 61 6c 20 64 61 the original da
163b0 74 61 62 61 73 65 20 75 6e 6c 65 73 73 20 77 65 tabase unless we
163c0 20 6b 6e 6f 77 0a 20 20 2a 2a 20 66 6f 72 20 63 know. ** for c
163d0 65 72 74 61 69 6e 20 74 68 61 74 20 6f 72 69 67 ertain that orig
163e0 69 6e 61 6c 20 70 61 67 65 20 63 6f 6e 74 65 6e inal page conten
163f0 74 73 20 61 72 65 20 73 79 6e 63 65 64 20 69 6e ts are synced in
16400 74 6f 20 74 68 65 20 6d 61 69 6e 20 72 6f 6c 6c to the main roll
16410 62 61 63 6b 0a 20 20 2a 2a 20 6a 6f 75 72 6e 61 back. ** journa
16420 6c 2e 20 20 4f 74 68 65 72 77 69 73 65 2c 20 61 l. Otherwise, a
16430 20 70 6f 77 65 72 20 6c 6f 73 73 20 6d 69 67 68 power loss migh
16440 74 20 6c 65 61 76 65 20 6d 6f 64 69 66 69 65 64 t leave modified
16450 20 64 61 74 61 20 69 6e 20 74 68 65 0a 20 20 2a data in the. *
16460 2a 20 64 61 74 61 62 61 73 65 20 66 69 6c 65 20 * database file
16470 77 69 74 68 6f 75 74 20 61 6e 20 65 6e 74 72 79 without an entry
16480 20 69 6e 20 74 68 65 20 72 6f 6c 6c 62 61 63 6b in the rollback
16490 20 6a 6f 75 72 6e 61 6c 20 74 68 61 74 20 63 61 journal that ca
164a0 6e 0a 20 20 2a 2a 20 72 65 73 74 6f 72 65 20 74 n. ** restore t
164b0 68 65 20 64 61 74 61 62 61 73 65 20 74 6f 20 69 he database to i
164c0 74 73 20 6f 72 69 67 69 6e 61 6c 20 66 6f 72 6d ts original form
164d0 2e 20 20 54 77 6f 20 63 6f 6e 64 69 74 69 6f 6e . Two condition
164e0 73 20 6d 75 73 74 20 62 65 0a 20 20 2a 2a 20 6d s must be. ** m
164f0 65 74 20 62 65 66 6f 72 65 20 77 72 69 74 69 6e et before writin
16500 67 20 74 6f 20 74 68 65 20 64 61 74 61 62 61 73 g to the databas
16510 65 20 66 69 6c 65 73 2e 20 28 31 29 20 74 68 65 e files. (1) the
16520 20 64 61 74 61 62 61 73 65 20 6d 75 73 74 20 62 database must b
16530 65 0a 20 20 2a 2a 20 6c 6f 63 6b 65 64 2e 20 20 e. ** locked.
16540 28 32 29 20 77 65 20 6b 6e 6f 77 20 74 68 61 74 (2) we know that
16550 20 74 68 65 20 6f 72 69 67 69 6e 61 6c 20 70 61 the original pa
16560 67 65 20 63 6f 6e 74 65 6e 74 20 69 73 20 66 75 ge content is fu
16570 6c 6c 79 20 73 79 6e 63 65 64 0a 20 20 2a 2a 20 lly synced. **
16580 69 6e 20 74 68 65 20 6d 61 69 6e 20 6a 6f 75 72 in the main jour
16590 6e 61 6c 20 65 69 74 68 65 72 20 62 65 63 61 75 nal either becau
165a0 73 65 20 74 68 65 20 70 61 67 65 20 69 73 20 6e se the page is n
165b0 6f 74 20 69 6e 20 63 61 63 68 65 20 6f 72 20 65 ot in cache or e
165c0 6c 73 65 0a 20 20 2a 2a 20 74 68 65 20 70 61 67 lse. ** the pag
165d0 65 20 69 73 20 6d 61 72 6b 65 64 20 61 73 20 6e e is marked as n
165e0 65 65 64 53 79 6e 63 3d 3d 30 2e 0a 20 20 2a 2a eedSync==0.. **
165f0 0a 20 20 2a 2a 20 32 30 30 38 2d 30 34 2d 31 34 . ** 2008-04-14
16600 3a 20 20 57 68 65 6e 20 61 74 74 65 6d 70 74 69 : When attempti
16610 6e 67 20 74 6f 20 76 61 63 75 75 6d 20 61 20 63 ng to vacuum a c
16620 6f 72 72 75 70 74 20 64 61 74 61 62 61 73 65 20 orrupt database
16630 66 69 6c 65 2c 20 69 74 0a 20 20 2a 2a 20 69 73 file, it. ** is
16640 20 70 6f 73 73 69 62 6c 65 20 74 6f 20 66 61 69 possible to fai
16650 6c 20 61 20 73 74 61 74 65 6d 65 6e 74 20 6f 6e l a statement on
16660 20 61 20 64 61 74 61 62 61 73 65 20 74 68 61 74 a database that
16670 20 64 6f 65 73 20 6e 6f 74 20 79 65 74 20 65 78 does not yet ex
16680 69 73 74 2e 0a 20 20 2a 2a 20 44 6f 20 6e 6f 74 ist.. ** Do not
16690 20 61 74 74 65 6d 70 74 20 74 6f 20 77 72 69 74 attempt to writ
166a0 65 20 69 66 20 64 61 74 61 62 61 73 65 20 66 69 e if database fi
166b0 6c 65 20 68 61 73 20 6e 65 76 65 72 20 62 65 65 le has never bee
166c0 6e 20 6f 70 65 6e 65 64 2e 0a 20 20 2a 2f 0a 20 n opened.. */.
166d0 20 69 66 28 20 70 61 67 65 72 55 73 65 57 61 6c if( pagerUseWal
166e0 28 70 50 61 67 65 72 29 20 29 7b 0a 20 20 20 20 (pPager) ){.
166f0 70 50 67 20 3d 20 30 3b 0a 20 20 7d 65 6c 73 65 pPg = 0;. }else
16700 7b 0a 20 20 20 20 70 50 67 20 3d 20 70 61 67 65 {. pPg = page
16710 72 5f 6c 6f 6f 6b 75 70 28 70 50 61 67 65 72 2c r_lookup(pPager,
16720 20 70 67 6e 6f 29 3b 0a 20 20 7d 0a 20 20 61 73 pgno);. }. as
16730 73 65 72 74 28 20 70 50 67 20 7c 7c 20 21 4d 45 sert( pPg || !ME
16740 4d 44 42 20 29 3b 0a 20 20 61 73 73 65 72 74 28 MDB );. assert(
16750 20 70 50 61 67 65 72 2d 3e 65 53 74 61 74 65 21 pPager->eState!
16760 3d 50 41 47 45 52 5f 4f 50 45 4e 20 7c 7c 20 70 =PAGER_OPEN || p
16770 50 67 3d 3d 30 20 29 3b 0a 20 20 50 41 47 45 52 Pg==0 );. PAGER
16780 54 52 41 43 45 28 28 22 50 4c 41 59 42 41 43 4b TRACE(("PLAYBACK
16790 20 25 64 20 70 61 67 65 20 25 64 20 68 61 73 68 %d page %d hash
167a0 28 25 30 38 78 29 20 25 73 5c 6e 22 2c 0a 20 20 (%08x) %s\n",.
167b0 20 20 20 20 20 20 20 20 20 50 41 47 45 52 49 44 PAGERID
167c0 28 70 50 61 67 65 72 29 2c 20 70 67 6e 6f 2c 20 (pPager), pgno,
167d0 70 61 67 65 72 5f 64 61 74 61 68 61 73 68 28 70 pager_datahash(p
167e0 50 61 67 65 72 2d 3e 70 61 67 65 53 69 7a 65 2c Pager->pageSize,
167f0 20 28 75 38 2a 29 61 44 61 74 61 29 2c 0a 20 20 (u8*)aData),.
16800 20 20 20 20 20 20 20 20 20 28 69 73 4d 61 69 6e (isMain
16810 4a 72 6e 6c 3f 22 6d 61 69 6e 2d 6a 6f 75 72 6e Jrnl?"main-journ
16820 61 6c 22 3a 22 73 75 62 2d 6a 6f 75 72 6e 61 6c al":"sub-journal
16830 22 29 0a 20 20 29 29 3b 0a 20 20 69 66 28 20 69 "). ));. if( i
16840 73 4d 61 69 6e 4a 72 6e 6c 20 29 7b 0a 20 20 20 sMainJrnl ){.
16850 20 69 73 53 79 6e 63 65 64 20 3d 20 70 50 61 67 isSynced = pPag
16860 65 72 2d 3e 6e 6f 53 79 6e 63 20 7c 7c 20 28 2a er->noSync || (*
16870 70 4f 66 66 73 65 74 20 3c 3d 20 70 50 61 67 65 pOffset <= pPage
16880 72 2d 3e 6a 6f 75 72 6e 61 6c 48 64 72 29 3b 0a r->journalHdr);.
16890 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 69 73 53 }else{. isS
168a0 79 6e 63 65 64 20 3d 20 28 70 50 67 3d 3d 30 20 ynced = (pPg==0
168b0 7c 7c 20 30 3d 3d 28 70 50 67 2d 3e 66 6c 61 67 || 0==(pPg->flag
168c0 73 20 26 20 50 47 48 44 52 5f 4e 45 45 44 5f 53 s & PGHDR_NEED_S
168d0 59 4e 43 29 29 3b 0a 20 20 7d 0a 20 20 69 66 28 YNC));. }. if(
168e0 20 69 73 4f 70 65 6e 28 70 50 61 67 65 72 2d 3e isOpen(pPager->
168f0 66 64 29 0a 20 20 20 26 26 20 28 70 50 61 67 65 fd). && (pPage
16900 72 2d 3e 65 53 74 61 74 65 3e 3d 50 41 47 45 52 r->eState>=PAGER
16910 5f 57 52 49 54 45 52 5f 44 42 4d 4f 44 20 7c 7c _WRITER_DBMOD ||
16920 20 70 50 61 67 65 72 2d 3e 65 53 74 61 74 65 3d pPager->eState=
16930 3d 50 41 47 45 52 5f 4f 50 45 4e 29 0a 20 20 20 =PAGER_OPEN).
16940 26 26 20 69 73 53 79 6e 63 65 64 0a 20 20 29 7b && isSynced. ){
16950 0a 20 20 20 20 69 36 34 20 6f 66 73 74 20 3d 20 . i64 ofst =
16960 28 70 67 6e 6f 2d 31 29 2a 28 69 36 34 29 70 50 (pgno-1)*(i64)pP
16970 61 67 65 72 2d 3e 70 61 67 65 53 69 7a 65 3b 0a ager->pageSize;.
16980 20 20 20 20 74 65 73 74 63 61 73 65 28 20 21 69 testcase( !i
16990 73 53 61 76 65 70 6e 74 20 26 26 20 70 50 67 21 sSavepnt && pPg!
169a0 3d 30 20 26 26 20 28 70 50 67 2d 3e 66 6c 61 67 =0 && (pPg->flag
169b0 73 26 50 47 48 44 52 5f 4e 45 45 44 5f 53 59 4e s&PGHDR_NEED_SYN
169c0 43 29 21 3d 30 20 29 3b 0a 20 20 20 20 61 73 73 C)!=0 );. ass
169d0 65 72 74 28 20 21 70 61 67 65 72 55 73 65 57 61 ert( !pagerUseWa
169e0 6c 28 70 50 61 67 65 72 29 20 29 3b 0a 20 20 20 l(pPager) );.
169f0 20 72 63 20 3d 20 73 71 6c 69 74 65 33 4f 73 57 rc = sqlite3OsW
16a00 72 69 74 65 28 70 50 61 67 65 72 2d 3e 66 64 2c rite(pPager->fd,
16a10 20 28 75 38 2a 29 61 44 61 74 61 2c 20 70 50 61 (u8*)aData, pPa
16a20 67 65 72 2d 3e 70 61 67 65 53 69 7a 65 2c 20 6f ger->pageSize, o
16a30 66 73 74 29 3b 0a 20 20 20 20 69 66 28 20 70 67 fst);. if( pg
16a40 6e 6f 3e 70 50 61 67 65 72 2d 3e 64 62 46 69 6c no>pPager->dbFil
16a50 65 53 69 7a 65 20 29 7b 0a 20 20 20 20 20 20 70 eSize ){. p
16a60 50 61 67 65 72 2d 3e 64 62 46 69 6c 65 53 69 7a Pager->dbFileSiz
16a70 65 20 3d 20 70 67 6e 6f 3b 0a 20 20 20 20 7d 0a e = pgno;. }.
16a80 20 20 20 20 69 66 28 20 70 50 61 67 65 72 2d 3e if( pPager->
16a90 70 42 61 63 6b 75 70 20 29 7b 0a 20 20 20 20 20 pBackup ){.
16aa0 20 43 4f 44 45 43 31 28 70 50 61 67 65 72 2c 20 CODEC1(pPager,
16ab0 61 44 61 74 61 2c 20 70 67 6e 6f 2c 20 33 2c 20 aData, pgno, 3,
16ac0 72 63 3d 53 51 4c 49 54 45 5f 4e 4f 4d 45 4d 29 rc=SQLITE_NOMEM)
16ad0 3b 0a 20 20 20 20 20 20 73 71 6c 69 74 65 33 42 ;. sqlite3B
16ae0 61 63 6b 75 70 55 70 64 61 74 65 28 70 50 61 67 ackupUpdate(pPag
16af0 65 72 2d 3e 70 42 61 63 6b 75 70 2c 20 70 67 6e er->pBackup, pgn
16b00 6f 2c 20 28 75 38 2a 29 61 44 61 74 61 29 3b 0a o, (u8*)aData);.
16b10 20 20 20 20 20 20 43 4f 44 45 43 32 28 70 50 61 CODEC2(pPa
16b20 67 65 72 2c 20 61 44 61 74 61 2c 20 70 67 6e 6f ger, aData, pgno
16b30 2c 20 37 2c 20 72 63 3d 53 51 4c 49 54 45 5f 4e , 7, rc=SQLITE_N
16b40 4f 4d 45 4d 2c 20 61 44 61 74 61 29 3b 0a 20 20 OMEM, aData);.
16b50 20 20 7d 0a 20 20 7d 65 6c 73 65 20 69 66 28 20 }. }else if(
16b60 21 69 73 4d 61 69 6e 4a 72 6e 6c 20 26 26 20 70 !isMainJrnl && p
16b70 50 67 3d 3d 30 20 29 7b 0a 20 20 20 20 2f 2a 20 Pg==0 ){. /*
16b80 49 66 20 74 68 69 73 20 69 73 20 61 20 72 6f 6c If this is a rol
16b90 6c 62 61 63 6b 20 6f 66 20 61 20 73 61 76 65 70 lback of a savep
16ba0 6f 69 6e 74 20 61 6e 64 20 64 61 74 61 20 77 61 oint and data wa
16bb0 73 20 6e 6f 74 20 77 72 69 74 74 65 6e 20 74 6f s not written to
16bc0 0a 20 20 20 20 2a 2a 20 74 68 65 20 64 61 74 61 . ** the data
16bd0 62 61 73 65 20 61 6e 64 20 74 68 65 20 70 61 67 base and the pag
16be0 65 20 69 73 20 6e 6f 74 20 69 6e 2d 6d 65 6d 6f e is not in-memo
16bf0 72 79 2c 20 74 68 65 72 65 20 69 73 20 61 20 70 ry, there is a p
16c00 6f 74 65 6e 74 69 61 6c 0a 20 20 20 20 2a 2a 20 otential. **
16c10 70 72 6f 62 6c 65 6d 2e 20 57 68 65 6e 20 74 68 problem. When th
16c20 65 20 70 61 67 65 20 69 73 20 6e 65 78 74 20 66 e page is next f
16c30 65 74 63 68 65 64 20 62 79 20 74 68 65 20 62 2d etched by the b-
16c40 74 72 65 65 20 6c 61 79 65 72 2c 20 69 74 20 0a tree layer, it .
16c50 20 20 20 20 2a 2a 20 77 69 6c 6c 20 62 65 20 72 ** will be r
16c60 65 61 64 20 66 72 6f 6d 20 74 68 65 20 64 61 74 ead from the dat
16c70 61 62 61 73 65 20 66 69 6c 65 2c 20 77 68 69 63 abase file, whic
16c80 68 20 6d 61 79 20 6f 72 20 6d 61 79 20 6e 6f 74 h may or may not
16c90 20 62 65 20 0a 20 20 20 20 2a 2a 20 63 75 72 72 be . ** curr
16ca0 65 6e 74 2e 20 0a 20 20 20 20 2a 2a 0a 20 20 20 ent. . **.
16cb0 20 2a 2a 20 54 68 65 72 65 20 61 72 65 20 61 20 ** There are a
16cc0 63 6f 75 70 6c 65 20 6f 66 20 64 69 66 66 65 72 couple of differ
16cd0 65 6e 74 20 77 61 79 73 20 74 68 69 73 20 63 61 ent ways this ca
16ce0 6e 20 68 61 70 70 65 6e 2e 20 41 6c 6c 20 61 72 n happen. All ar
16cf0 65 20 71 75 69 74 65 0a 20 20 20 20 2a 2a 20 6f e quite. ** o
16d00 62 73 63 75 72 65 2e 20 57 68 65 6e 20 72 75 6e bscure. When run
16d10 6e 69 6e 67 20 69 6e 20 73 79 6e 63 68 72 6f 6e ning in synchron
16d20 6f 75 73 20 6d 6f 64 65 2c 20 74 68 69 73 20 63 ous mode, this c
16d30 61 6e 20 6f 6e 6c 79 20 68 61 70 70 65 6e 20 0a an only happen .
16d40 20 20 20 20 2a 2a 20 69 66 20 74 68 65 20 70 61 ** if the pa
16d50 67 65 20 69 73 20 6f 6e 20 74 68 65 20 66 72 65 ge is on the fre
16d60 65 2d 6c 69 73 74 20 61 74 20 74 68 65 20 73 74 e-list at the st
16d70 61 72 74 20 6f 66 20 74 68 65 20 74 72 61 6e 73 art of the trans
16d80 61 63 74 69 6f 6e 2c 20 74 68 65 6e 0a 20 20 20 action, then.
16d90 20 2a 2a 20 70 6f 70 75 6c 61 74 65 64 2c 20 74 ** populated, t
16da0 68 65 6e 20 6d 6f 76 65 64 20 75 73 69 6e 67 20 hen moved using
16db0 73 71 6c 69 74 65 33 50 61 67 65 72 4d 6f 76 65 sqlite3PagerMove
16dc0 70 61 67 65 28 29 2e 0a 20 20 20 20 2a 2a 0a 20 page().. **.
16dd0 20 20 20 2a 2a 20 54 68 65 20 73 6f 6c 75 74 69 ** The soluti
16de0 6f 6e 20 69 73 20 74 6f 20 61 64 64 20 61 6e 20 on is to add an
16df0 69 6e 2d 6d 65 6d 6f 72 79 20 70 61 67 65 20 74 in-memory page t
16e00 6f 20 74 68 65 20 63 61 63 68 65 20 63 6f 6e 74 o the cache cont
16e10 61 69 6e 69 6e 67 0a 20 20 20 20 2a 2a 20 74 68 aining. ** th
16e20 65 20 64 61 74 61 20 6a 75 73 74 20 72 65 61 64 e data just read
16e30 20 66 72 6f 6d 20 74 68 65 20 73 75 62 2d 6a 6f from the sub-jo
16e40 75 72 6e 61 6c 2e 20 4d 61 72 6b 20 74 68 65 20 urnal. Mark the
16e50 70 61 67 65 20 61 73 20 64 69 72 74 79 20 0a 20 page as dirty .
16e60 20 20 20 2a 2a 20 61 6e 64 20 69 66 20 74 68 65 ** and if the
16e70 20 70 61 67 65 72 20 72 65 71 75 69 72 65 73 20 pager requires
16e80 61 20 6a 6f 75 72 6e 61 6c 2d 73 79 6e 63 2c 20 a journal-sync,
16e90 74 68 65 6e 20 6d 61 72 6b 20 74 68 65 20 70 61 then mark the pa
16ea0 67 65 20 61 73 20 0a 20 20 20 20 2a 2a 20 72 65 ge as . ** re
16eb0 71 75 69 72 69 6e 67 20 61 20 6a 6f 75 72 6e 61 quiring a journa
16ec0 6c 2d 73 79 6e 63 20 62 65 66 6f 72 65 20 69 74 l-sync before it
16ed0 20 69 73 20 77 72 69 74 74 65 6e 2e 0a 20 20 20 is written..
16ee0 20 2a 2f 0a 20 20 20 20 61 73 73 65 72 74 28 20 */. assert(
16ef0 69 73 53 61 76 65 70 6e 74 20 29 3b 0a 20 20 20 isSavepnt );.
16f00 20 61 73 73 65 72 74 28 20 70 50 61 67 65 72 2d assert( pPager-
16f10 3e 64 6f 4e 6f 74 53 70 69 6c 6c 3d 3d 30 20 29 >doNotSpill==0 )
16f20 3b 0a 20 20 20 20 70 50 61 67 65 72 2d 3e 64 6f ;. pPager->do
16f30 4e 6f 74 53 70 69 6c 6c 2b 2b 3b 0a 20 20 20 20 NotSpill++;.
16f40 72 63 20 3d 20 73 71 6c 69 74 65 33 50 61 67 65 rc = sqlite3Page
16f50 72 41 63 71 75 69 72 65 28 70 50 61 67 65 72 2c rAcquire(pPager,
16f60 20 70 67 6e 6f 2c 20 26 70 50 67 2c 20 31 29 3b pgno, &pPg, 1);
16f70 0a 20 20 20 20 61 73 73 65 72 74 28 20 70 50 61 . assert( pPa
16f80 67 65 72 2d 3e 64 6f 4e 6f 74 53 70 69 6c 6c 3d ger->doNotSpill=
16f90 3d 31 20 29 3b 0a 20 20 20 20 70 50 61 67 65 72 =1 );. pPager
16fa0 2d 3e 64 6f 4e 6f 74 53 70 69 6c 6c 2d 2d 3b 0a ->doNotSpill--;.
16fb0 20 20 20 20 69 66 28 20 72 63 21 3d 53 51 4c 49 if( rc!=SQLI
16fc0 54 45 5f 4f 4b 20 29 20 72 65 74 75 72 6e 20 72 TE_OK ) return r
16fd0 63 3b 0a 20 20 20 20 70 50 67 2d 3e 66 6c 61 67 c;. pPg->flag
16fe0 73 20 26 3d 20 7e 50 47 48 44 52 5f 4e 45 45 44 s &= ~PGHDR_NEED
16ff0 5f 52 45 41 44 3b 0a 20 20 20 20 73 71 6c 69 74 _READ;. sqlit
17000 65 33 50 63 61 63 68 65 4d 61 6b 65 44 69 72 74 e3PcacheMakeDirt
17010 79 28 70 50 67 29 3b 0a 20 20 7d 0a 20 20 69 66 y(pPg);. }. if
17020 28 20 70 50 67 20 29 7b 0a 20 20 20 20 2f 2a 20 ( pPg ){. /*
17030 4e 6f 20 70 61 67 65 20 73 68 6f 75 6c 64 20 65 No page should e
17040 76 65 72 20 62 65 20 65 78 70 6c 69 63 69 74 6c ver be explicitl
17050 79 20 72 6f 6c 6c 65 64 20 62 61 63 6b 20 74 68 y rolled back th
17060 61 74 20 69 73 20 69 6e 20 75 73 65 2c 20 65 78 at is in use, ex
17070 63 65 70 74 0a 20 20 20 20 2a 2a 20 66 6f 72 20 cept. ** for
17080 70 61 67 65 20 31 20 77 68 69 63 68 20 69 73 20 page 1 which is
17090 68 65 6c 64 20 69 6e 20 75 73 65 20 69 6e 20 6f held in use in o
170a0 72 64 65 72 20 74 6f 20 6b 65 65 70 20 74 68 65 rder to keep the
170b0 20 6c 6f 63 6b 20 6f 6e 20 74 68 65 0a 20 20 20 lock on the.
170c0 20 2a 2a 20 64 61 74 61 62 61 73 65 20 61 63 74 ** database act
170d0 69 76 65 2e 20 48 6f 77 65 76 65 72 20 73 75 63 ive. However suc
170e0 68 20 61 20 70 61 67 65 20 6d 61 79 20 62 65 20 h a page may be
170f0 72 6f 6c 6c 65 64 20 62 61 63 6b 20 61 73 20 61 rolled back as a
17100 20 72 65 73 75 6c 74 0a 20 20 20 20 2a 2a 20 6f result. ** o
17110 66 20 61 6e 20 69 6e 74 65 72 6e 61 6c 20 65 72 f an internal er
17120 72 6f 72 20 72 65 73 75 6c 74 69 6e 67 20 69 6e ror resulting in
17130 20 61 6e 20 61 75 74 6f 6d 61 74 69 63 20 63 61 an automatic ca
17140 6c 6c 20 74 6f 0a 20 20 20 20 2a 2a 20 73 71 6c ll to. ** sql
17150 69 74 65 33 50 61 67 65 72 52 6f 6c 6c 62 61 63 ite3PagerRollbac
17160 6b 28 29 2e 0a 20 20 20 20 2a 2f 0a 20 20 20 20 k().. */.
17170 76 6f 69 64 20 2a 70 44 61 74 61 3b 0a 20 20 20 void *pData;.
17180 20 70 44 61 74 61 20 3d 20 70 50 67 2d 3e 70 44 pData = pPg->pD
17190 61 74 61 3b 0a 20 20 20 20 6d 65 6d 63 70 79 28 ata;. memcpy(
171a0 70 44 61 74 61 2c 20 28 75 38 2a 29 61 44 61 74 pData, (u8*)aDat
171b0 61 2c 20 70 50 61 67 65 72 2d 3e 70 61 67 65 53 a, pPager->pageS
171c0 69 7a 65 29 3b 0a 20 20 20 20 70 50 61 67 65 72 ize);. pPager
171d0 2d 3e 78 52 65 69 6e 69 74 65 72 28 70 50 67 29 ->xReiniter(pPg)
171e0 3b 0a 20 20 20 20 69 66 28 20 69 73 4d 61 69 6e ;. if( isMain
171f0 4a 72 6e 6c 20 26 26 20 28 21 69 73 53 61 76 65 Jrnl && (!isSave
17200 70 6e 74 20 7c 7c 20 2a 70 4f 66 66 73 65 74 3c pnt || *pOffset<
17210 3d 70 50 61 67 65 72 2d 3e 6a 6f 75 72 6e 61 6c =pPager->journal
17220 48 64 72 29 20 29 7b 0a 20 20 20 20 20 20 2f 2a Hdr) ){. /*
17230 20 49 66 20 74 68 65 20 63 6f 6e 74 65 6e 74 73 If the contents
17240 20 6f 66 20 74 68 69 73 20 70 61 67 65 20 77 65 of this page we
17250 72 65 20 6a 75 73 74 20 72 65 73 74 6f 72 65 64 re just restored
17260 20 66 72 6f 6d 20 74 68 65 20 6d 61 69 6e 20 0a from the main .
17270 20 20 20 20 20 20 2a 2a 20 6a 6f 75 72 6e 61 6c ** journal
17280 20 66 69 6c 65 2c 20 74 68 65 6e 20 69 74 73 20 file, then its
17290 63 6f 6e 74 65 6e 74 20 6d 75 73 74 20 62 65 20 content must be
172a0 61 73 20 74 68 65 79 20 77 65 72 65 20 77 68 65 as they were whe
172b0 6e 20 74 68 65 20 0a 20 20 20 20 20 20 2a 2a 20 n the . **
172c0 74 72 61 6e 73 61 63 74 69 6f 6e 20 77 61 73 20 transaction was
172d0 66 69 72 73 74 20 6f 70 65 6e 65 64 2e 20 49 6e first opened. In
172e0 20 74 68 69 73 20 63 61 73 65 20 77 65 20 63 61 this case we ca
172f0 6e 20 6d 61 72 6b 20 74 68 65 20 70 61 67 65 0a n mark the page.
17300 20 20 20 20 20 20 2a 2a 20 61 73 20 63 6c 65 61 ** as clea
17310 6e 2c 20 73 69 6e 63 65 20 74 68 65 72 65 20 77 n, since there w
17320 69 6c 6c 20 62 65 20 6e 6f 20 6e 65 65 64 20 74 ill be no need t
17330 6f 20 77 72 69 74 65 20 69 74 20 6f 75 74 20 74 o write it out t
17340 6f 20 74 68 65 0a 20 20 20 20 20 20 2a 2a 20 64 o the. ** d
17350 61 74 61 62 61 73 65 2e 0a 20 20 20 20 20 20 2a atabase.. *
17360 2a 0a 20 20 20 20 20 20 2a 2a 20 54 68 65 72 65 *. ** There
17370 20 69 73 20 6f 6e 65 20 65 78 63 65 70 74 69 6f is one exceptio
17380 6e 20 74 6f 20 74 68 69 73 20 72 75 6c 65 2e 20 n to this rule.
17390 49 66 20 74 68 65 20 70 61 67 65 20 69 73 20 62 If the page is b
173a0 65 69 6e 67 20 72 6f 6c 6c 65 64 0a 20 20 20 20 eing rolled.
173b0 20 20 2a 2a 20 62 61 63 6b 20 61 73 20 70 61 72 ** back as par
173c0 74 20 6f 66 20 61 20 73 61 76 65 70 6f 69 6e 74 t of a savepoint
173d0 20 28 6f 72 20 73 74 61 74 65 6d 65 6e 74 29 20 (or statement)
173e0 72 6f 6c 6c 62 61 63 6b 20 66 72 6f 6d 20 61 6e rollback from an
173f0 20 0a 20 20 20 20 20 20 2a 2a 20 75 6e 73 79 6e . ** unsyn
17400 63 65 64 20 70 6f 72 74 69 6f 6e 20 6f 66 20 74 ced portion of t
17410 68 65 20 6d 61 69 6e 20 6a 6f 75 72 6e 61 6c 20 he main journal
17420 66 69 6c 65 2c 20 74 68 65 6e 20 69 74 20 69 73 file, then it is
17430 20 6e 6f 74 20 73 61 66 65 0a 20 20 20 20 20 20 not safe.
17440 2a 2a 20 74 6f 20 6d 61 72 6b 20 74 68 65 20 70 ** to mark the p
17450 61 67 65 20 61 73 20 63 6c 65 61 6e 2e 20 54 68 age as clean. Th
17460 69 73 20 69 73 20 62 65 63 61 75 73 65 20 6d 61 is is because ma
17470 72 6b 69 6e 67 20 74 68 65 20 70 61 67 65 20 61 rking the page a
17480 73 0a 20 20 20 20 20 20 2a 2a 20 63 6c 65 61 6e s. ** clean
17490 20 77 69 6c 6c 20 63 6c 65 61 72 20 74 68 65 20 will clear the
174a0 50 47 48 44 52 5f 4e 45 45 44 5f 53 59 4e 43 20 PGHDR_NEED_SYNC
174b0 66 6c 61 67 2e 20 53 69 6e 63 65 20 74 68 65 20 flag. Since the
174c0 70 61 67 65 20 69 73 0a 20 20 20 20 20 20 2a 2a page is. **
174d0 20 61 6c 72 65 61 64 79 20 69 6e 20 74 68 65 20 already in the
174e0 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 20 28 72 65 journal file (re
174f0 63 6f 72 64 65 64 20 69 6e 20 50 61 67 65 72 2e corded in Pager.
17500 70 49 6e 4a 6f 75 72 6e 61 6c 29 20 61 6e 64 0a pInJournal) and.
17510 20 20 20 20 20 20 2a 2a 20 74 68 65 20 50 47 48 ** the PGH
17520 44 52 5f 4e 45 45 44 5f 53 59 4e 43 20 66 6c 61 DR_NEED_SYNC fla
17530 67 20 69 73 20 63 6c 65 61 72 65 64 2c 20 69 66 g is cleared, if
17540 20 74 68 65 20 70 61 67 65 20 69 73 20 77 72 69 the page is wri
17550 74 74 65 6e 20 74 6f 0a 20 20 20 20 20 20 2a 2a tten to. **
17560 20 61 67 61 69 6e 20 77 69 74 68 69 6e 20 74 68 again within th
17570 69 73 20 74 72 61 6e 73 61 63 74 69 6f 6e 2c 20 is transaction,
17580 69 74 20 77 69 6c 6c 20 62 65 20 6d 61 72 6b 65 it will be marke
17590 64 20 61 73 20 64 69 72 74 79 20 62 75 74 0a 20 d as dirty but.
175a0 20 20 20 20 20 2a 2a 20 74 68 65 20 50 47 48 44 ** the PGHD
175b0 52 5f 4e 45 45 44 5f 53 59 4e 43 20 66 6c 61 67 R_NEED_SYNC flag
175c0 20 77 69 6c 6c 20 6e 6f 74 20 62 65 20 73 65 74 will not be set
175d0 2e 20 49 74 20 63 6f 75 6c 64 20 74 68 65 6e 20 . It could then
175e0 70 6f 74 65 6e 74 69 61 6c 6c 79 0a 20 20 20 20 potentially.
175f0 20 20 2a 2a 20 62 65 20 77 72 69 74 74 65 6e 20 ** be written
17600 6f 75 74 20 69 6e 74 6f 20 74 68 65 20 64 61 74 out into the dat
17610 61 62 61 73 65 20 66 69 6c 65 20 62 65 66 6f 72 abase file befor
17620 65 20 69 74 73 20 6a 6f 75 72 6e 61 6c 20 66 69 e its journal fi
17630 6c 65 0a 20 20 20 20 20 20 2a 2a 20 73 65 67 6d le. ** segm
17640 65 6e 74 20 69 73 20 73 79 6e 63 65 64 2e 20 49 ent is synced. I
17650 66 20 61 20 63 72 61 73 68 20 6f 63 63 75 72 73 f a crash occurs
17660 20 64 75 72 69 6e 67 20 6f 72 20 66 6f 6c 6c 6f during or follo
17670 77 69 6e 67 20 74 68 69 73 2c 0a 20 20 20 20 20 wing this,.
17680 20 2a 2a 20 64 61 74 61 62 61 73 65 20 63 6f 72 ** database cor
17690 72 75 70 74 69 6f 6e 20 6d 61 79 20 65 6e 73 75 ruption may ensu
176a0 65 2e 0a 20 20 20 20 20 20 2a 2f 0a 20 20 20 20 e.. */.
176b0 20 20 61 73 73 65 72 74 28 20 21 70 61 67 65 72 assert( !pager
176c0 55 73 65 57 61 6c 28 70 50 61 67 65 72 29 20 29 UseWal(pPager) )
176d0 3b 0a 20 20 20 20 20 20 73 71 6c 69 74 65 33 50 ;. sqlite3P
176e0 63 61 63 68 65 4d 61 6b 65 43 6c 65 61 6e 28 70 cacheMakeClean(p
176f0 50 67 29 3b 0a 20 20 20 20 7d 0a 20 20 20 20 70 Pg);. }. p
17700 61 67 65 72 5f 73 65 74 5f 70 61 67 65 68 61 73 ager_set_pagehas
17710 68 28 70 50 67 29 3b 0a 0a 20 20 20 20 2f 2a 20 h(pPg);.. /*
17720 49 66 20 74 68 69 73 20 77 61 73 20 70 61 67 65 If this was page
17730 20 31 2c 20 74 68 65 6e 20 72 65 73 74 6f 72 65 1, then restore
17740 20 74 68 65 20 76 61 6c 75 65 20 6f 66 20 50 61 the value of Pa
17750 67 65 72 2e 64 62 46 69 6c 65 56 65 72 73 2e 0a ger.dbFileVers..
17760 20 20 20 20 2a 2a 20 44 6f 20 74 68 69 73 20 62 ** Do this b
17770 65 66 6f 72 65 20 61 6e 79 20 64 65 63 6f 64 69 efore any decodi
17780 6e 67 2e 20 2a 2f 0a 20 20 20 20 69 66 28 20 70 ng. */. if( p
17790 67 6e 6f 3d 3d 31 20 29 7b 0a 20 20 20 20 20 20 gno==1 ){.
177a0 6d 65 6d 63 70 79 28 26 70 50 61 67 65 72 2d 3e memcpy(&pPager->
177b0 64 62 46 69 6c 65 56 65 72 73 2c 20 26 28 28 75 dbFileVers, &((u
177c0 38 2a 29 70 44 61 74 61 29 5b 32 34 5d 2c 73 69 8*)pData)[24],si
177d0 7a 65 6f 66 28 70 50 61 67 65 72 2d 3e 64 62 46 zeof(pPager->dbF
177e0 69 6c 65 56 65 72 73 29 29 3b 0a 20 20 20 20 7d ileVers));. }
177f0 0a 0a 20 20 20 20 2f 2a 20 44 65 63 6f 64 65 20 .. /* Decode
17800 74 68 65 20 70 61 67 65 20 6a 75 73 74 20 72 65 the page just re
17810 61 64 20 66 72 6f 6d 20 64 69 73 6b 20 2a 2f 0a ad from disk */.
17820 20 20 20 20 43 4f 44 45 43 31 28 70 50 61 67 65 CODEC1(pPage
17830 72 2c 20 70 44 61 74 61 2c 20 70 50 67 2d 3e 70 r, pData, pPg->p
17840 67 6e 6f 2c 20 33 2c 20 72 63 3d 53 51 4c 49 54 gno, 3, rc=SQLIT
17850 45 5f 4e 4f 4d 45 4d 29 3b 0a 20 20 20 20 73 71 E_NOMEM);. sq
17860 6c 69 74 65 33 50 63 61 63 68 65 52 65 6c 65 61 lite3PcacheRelea
17870 73 65 28 70 50 67 29 3b 0a 20 20 7d 0a 20 20 72 se(pPg);. }. r
17880 65 74 75 72 6e 20 72 63 3b 0a 7d 0a 0a 2f 2a 0a eturn rc;.}../*.
17890 2a 2a 20 50 61 72 61 6d 65 74 65 72 20 7a 4d 61 ** Parameter zMa
178a0 73 74 65 72 20 69 73 20 74 68 65 20 6e 61 6d 65 ster is the name
178b0 20 6f 66 20 61 20 6d 61 73 74 65 72 20 6a 6f 75 of a master jou
178c0 72 6e 61 6c 20 66 69 6c 65 2e 20 41 20 73 69 6e rnal file. A sin
178d0 67 6c 65 20 6a 6f 75 72 6e 61 6c 0a 2a 2a 20 66 gle journal.** f
178e0 69 6c 65 20 74 68 61 74 20 72 65 66 65 72 72 65 ile that referre
178f0 64 20 74 6f 20 74 68 65 20 6d 61 73 74 65 72 20 d to the master
17900 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 20 68 61 73 journal file has
17910 20 6a 75 73 74 20 62 65 65 6e 20 72 6f 6c 6c 65 just been rolle
17920 64 20 62 61 63 6b 2e 0a 2a 2a 20 54 68 69 73 20 d back..** This
17930 72 6f 75 74 69 6e 65 20 63 68 65 63 6b 73 20 69 routine checks i
17940 66 20 69 74 20 69 73 20 70 6f 73 73 69 62 6c 65 f it is possible
17950 20 74 6f 20 64 65 6c 65 74 65 20 74 68 65 20 6d to delete the m
17960 61 73 74 65 72 20 6a 6f 75 72 6e 61 6c 20 66 69 aster journal fi
17970 6c 65 2c 0a 2a 2a 20 61 6e 64 20 64 6f 65 73 20 le,.** and does
17980 73 6f 20 69 66 20 69 74 20 69 73 2e 0a 2a 2a 0a so if it is..**.
17990 2a 2a 20 41 72 67 75 6d 65 6e 74 20 7a 4d 61 73 ** Argument zMas
179a0 74 65 72 20 6d 61 79 20 70 6f 69 6e 74 20 74 6f ter may point to
179b0 20 50 61 67 65 72 2e 70 54 6d 70 53 70 61 63 65 Pager.pTmpSpace
179c0 2e 20 53 6f 20 74 68 61 74 20 62 75 66 66 65 72 . So that buffer
179d0 20 69 73 20 6e 6f 74 20 0a 2a 2a 20 61 76 61 69 is not .** avai
179e0 6c 61 62 6c 65 20 66 6f 72 20 75 73 65 20 77 69 lable for use wi
179f0 74 68 69 6e 20 74 68 69 73 20 66 75 6e 63 74 69 thin this functi
17a00 6f 6e 2e 0a 2a 2a 0a 2a 2a 20 57 68 65 6e 20 61 on..**.** When a
17a10 20 6d 61 73 74 65 72 20 6a 6f 75 72 6e 61 6c 20 master journal
17a20 66 69 6c 65 20 69 73 20 63 72 65 61 74 65 64 2c file is created,
17a30 20 69 74 20 69 73 20 70 6f 70 75 6c 61 74 65 64 it is populated
17a40 20 77 69 74 68 20 74 68 65 20 6e 61 6d 65 73 20 with the names
17a50 0a 2a 2a 20 6f 66 20 61 6c 6c 20 6f 66 20 69 74 .** of all of it
17a60 73 20 63 68 69 6c 64 20 6a 6f 75 72 6e 61 6c 73 s child journals
17a70 2c 20 6f 6e 65 20 61 66 74 65 72 20 61 6e 6f 74 , one after anot
17a80 68 65 72 2c 20 66 6f 72 6d 61 74 74 65 64 20 61 her, formatted a
17a90 73 20 75 74 66 2d 38 20 0a 2a 2a 20 65 6e 63 6f s utf-8 .** enco
17aa0 64 65 64 20 74 65 78 74 2e 20 54 68 65 20 65 6e ded text. The en
17ab0 64 20 6f 66 20 65 61 63 68 20 63 68 69 6c 64 20 d of each child
17ac0 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 20 69 73 20 journal file is
17ad0 6d 61 72 6b 65 64 20 77 69 74 68 20 61 20 0a 2a marked with a .*
17ae0 2a 20 6e 75 6c 2d 74 65 72 6d 69 6e 61 74 6f 72 * nul-terminator
17af0 20 62 79 74 65 20 28 30 78 30 30 29 2e 20 69 2e byte (0x00). i.
17b00 65 2e 20 74 68 65 20 65 6e 74 69 72 65 20 63 6f e. the entire co
17b10 6e 74 65 6e 74 73 20 6f 66 20 61 20 6d 61 73 74 ntents of a mast
17b20 65 72 20 6a 6f 75 72 6e 61 6c 0a 2a 2a 20 66 69 er journal.** fi
17b30 6c 65 20 66 6f 72 20 61 20 74 72 61 6e 73 61 63 le for a transac
17b40 74 69 6f 6e 20 69 6e 76 6f 6c 76 69 6e 67 20 74 tion involving t
17b50 77 6f 20 64 61 74 61 62 61 73 65 73 20 6d 69 67 wo databases mig
17b60 68 74 20 62 65 3a 0a 2a 2a 0a 2a 2a 20 20 20 22 ht be:.**.** "
17b70 2f 68 6f 6d 65 2f 62 69 6c 6c 2f 61 2e 64 62 2d /home/bill/a.db-
17b80 6a 6f 75 72 6e 61 6c 5c 78 30 30 2f 68 6f 6d 65 journal\x00/home
17b90 2f 62 69 6c 6c 2f 62 2e 64 62 2d 6a 6f 75 72 6e /bill/b.db-journ
17ba0 61 6c 5c 78 30 30 22 0a 2a 2a 0a 2a 2a 20 41 20 al\x00".**.** A
17bb0 6d 61 73 74 65 72 20 6a 6f 75 72 6e 61 6c 20 66 master journal f
17bc0 69 6c 65 20 6d 61 79 20 6f 6e 6c 79 20 62 65 20 ile may only be
17bd0 64 65 6c 65 74 65 64 20 6f 6e 63 65 20 61 6c 6c deleted once all
17be0 20 6f 66 20 69 74 73 20 63 68 69 6c 64 20 0a 2a of its child .*
17bf0 2a 20 6a 6f 75 72 6e 61 6c 73 20 68 61 76 65 20 * journals have
17c00 62 65 65 6e 20 72 6f 6c 6c 65 64 20 62 61 63 6b been rolled back
17c10 2e 0a 2a 2a 0a 2a 2a 20 54 68 69 73 20 66 75 6e ..**.** This fun
17c20 63 74 69 6f 6e 20 72 65 61 64 73 20 74 68 65 20 ction reads the
17c30 63 6f 6e 74 65 6e 74 73 20 6f 66 20 74 68 65 20 contents of the
17c40 6d 61 73 74 65 72 2d 6a 6f 75 72 6e 61 6c 20 66 master-journal f
17c50 69 6c 65 20 69 6e 74 6f 20 0a 2a 2a 20 6d 65 6d ile into .** mem
17c60 6f 72 79 20 61 6e 64 20 6c 6f 6f 70 73 20 74 68 ory and loops th
17c70 72 6f 75 67 68 20 65 61 63 68 20 6f 66 20 74 68 rough each of th
17c80 65 20 63 68 69 6c 64 20 6a 6f 75 72 6e 61 6c 20 e child journal
17c90 6e 61 6d 65 73 2e 20 46 6f 72 0a 2a 2a 20 65 61 names. For.** ea
17ca0 63 68 20 63 68 69 6c 64 20 6a 6f 75 72 6e 61 6c ch child journal
17cb0 2c 20 69 74 20 63 68 65 63 6b 73 20 69 66 3a 0a , it checks if:.
17cc0 2a 2a 0a 2a 2a 20 20 20 2a 20 69 66 20 74 68 65 **.** * if the
17cd0 20 63 68 69 6c 64 20 6a 6f 75 72 6e 61 6c 20 65 child journal e
17ce0 78 69 73 74 73 2c 20 61 6e 64 20 69 66 20 73 6f xists, and if so
17cf0 0a 2a 2a 20 20 20 2a 20 69 66 20 74 68 65 20 63 .** * if the c
17d00 68 69 6c 64 20 6a 6f 75 72 6e 61 6c 20 63 6f 6e hild journal con
17d10 74 61 69 6e 73 20 61 20 72 65 66 65 72 65 6e 63 tains a referenc
17d20 65 20 74 6f 20 6d 61 73 74 65 72 20 6a 6f 75 72 e to master jour
17d30 6e 61 6c 20 0a 2a 2a 20 20 20 20 20 66 69 6c 65 nal .** file
17d40 20 7a 4d 61 73 74 65 72 0a 2a 2a 0a 2a 2a 20 49 zMaster.**.** I
17d50 66 20 61 20 63 68 69 6c 64 20 6a 6f 75 72 6e 61 f a child journa
17d60 6c 20 63 61 6e 20 62 65 20 66 6f 75 6e 64 20 74 l can be found t
17d70 68 61 74 20 6d 61 74 63 68 65 73 20 62 6f 74 68 hat matches both
17d80 20 6f 66 20 74 68 65 20 63 72 69 74 65 72 69 61 of the criteria
17d90 0a 2a 2a 20 61 62 6f 76 65 2c 20 74 68 69 73 20 .** above, this
17da0 66 75 6e 63 74 69 6f 6e 20 72 65 74 75 72 6e 73 function returns
17db0 20 77 69 74 68 6f 75 74 20 64 6f 69 6e 67 20 61 without doing a
17dc0 6e 79 74 68 69 6e 67 2e 20 4f 74 68 65 72 77 69 nything. Otherwi
17dd0 73 65 2c 20 69 66 0a 2a 2a 20 6e 6f 20 73 75 63 se, if.** no suc
17de0 68 20 63 68 69 6c 64 20 6a 6f 75 72 6e 61 6c 20 h child journal
17df0 63 61 6e 20 62 65 20 66 6f 75 6e 64 2c 20 66 69 can be found, fi
17e00 6c 65 20 7a 4d 61 73 74 65 72 20 69 73 20 64 65 le zMaster is de
17e10 6c 65 74 65 64 20 66 72 6f 6d 0a 2a 2a 20 74 68 leted from.** th
17e20 65 20 66 69 6c 65 2d 73 79 73 74 65 6d 20 75 73 e file-system us
17e30 69 6e 67 20 73 71 6c 69 74 65 33 4f 73 44 65 6c ing sqlite3OsDel
17e40 65 74 65 28 29 2e 0a 2a 2a 0a 2a 2a 20 49 66 20 ete()..**.** If
17e50 61 6e 20 49 4f 20 65 72 72 6f 72 20 77 69 74 68 an IO error with
17e60 69 6e 20 74 68 69 73 20 66 75 6e 63 74 69 6f 6e in this function
17e70 2c 20 61 6e 20 65 72 72 6f 72 20 63 6f 64 65 20 , an error code
17e80 69 73 20 72 65 74 75 72 6e 65 64 2e 20 54 68 69 is returned. Thi
17e90 73 0a 2a 2a 20 66 75 6e 63 74 69 6f 6e 20 61 6c s.** function al
17ea0 6c 6f 63 61 74 65 73 20 6d 65 6d 6f 72 79 20 62 locates memory b
17eb0 79 20 63 61 6c 6c 69 6e 67 20 73 71 6c 69 74 65 y calling sqlite
17ec0 33 4d 61 6c 6c 6f 63 28 29 2e 20 49 66 20 61 6e 3Malloc(). If an
17ed0 20 61 6c 6c 6f 63 61 74 69 6f 6e 0a 2a 2a 20 66 allocation.** f
17ee0 61 69 6c 73 2c 20 53 51 4c 49 54 45 5f 4e 4f 4d ails, SQLITE_NOM
17ef0 45 4d 20 69 73 20 72 65 74 75 72 6e 65 64 2e 20 EM is returned.
17f00 4f 74 68 65 72 77 69 73 65 2c 20 69 66 20 6e 6f Otherwise, if no
17f10 20 49 4f 20 6f 72 20 6d 61 6c 6c 6f 63 20 65 72 IO or malloc er
17f20 72 6f 72 73 20 0a 2a 2a 20 6f 63 63 75 72 2c 20 rors .** occur,
17f30 53 51 4c 49 54 45 5f 4f 4b 20 69 73 20 72 65 74 SQLITE_OK is ret
17f40 75 72 6e 65 64 2e 0a 2a 2a 0a 2a 2a 20 54 4f 44 urned..**.** TOD
17f50 4f 3a 20 54 68 69 73 20 66 75 6e 63 74 69 6f 6e O: This function
17f60 20 61 6c 6c 6f 63 61 74 65 73 20 61 20 73 69 6e allocates a sin
17f70 67 6c 65 20 62 6c 6f 63 6b 20 6f 66 20 6d 65 6d gle block of mem
17f80 6f 72 79 20 74 6f 20 6c 6f 61 64 0a 2a 2a 20 74 ory to load.** t
17f90 68 65 20 65 6e 74 69 72 65 20 63 6f 6e 74 65 6e he entire conten
17fa0 74 73 20 6f 66 20 74 68 65 20 6d 61 73 74 65 72 ts of the master
17fb0 20 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 2e 20 54 journal file. T
17fc0 68 69 73 20 63 6f 75 6c 64 20 62 65 0a 2a 2a 20 his could be.**
17fd0 61 20 63 6f 75 70 6c 65 20 6f 66 20 6b 69 6c 6f a couple of kilo
17fe0 62 79 74 65 73 20 6f 72 20 73 6f 20 2d 20 70 6f bytes or so - po
17ff0 74 65 6e 74 69 61 6c 6c 79 20 6c 61 72 67 65 72 tentially larger
18000 20 74 68 61 6e 20 74 68 65 20 70 61 67 65 20 0a than the page .
18010 2a 2a 20 73 69 7a 65 2e 0a 2a 2f 0a 73 74 61 74 ** size..*/.stat
18020 69 63 20 69 6e 74 20 70 61 67 65 72 5f 64 65 6c ic int pager_del
18030 6d 61 73 74 65 72 28 50 61 67 65 72 20 2a 70 50 master(Pager *pP
18040 61 67 65 72 2c 20 63 6f 6e 73 74 20 63 68 61 72 ager, const char
18050 20 2a 7a 4d 61 73 74 65 72 29 7b 0a 20 20 73 71 *zMaster){. sq
18060 6c 69 74 65 33 5f 76 66 73 20 2a 70 56 66 73 20 lite3_vfs *pVfs
18070 3d 20 70 50 61 67 65 72 2d 3e 70 56 66 73 3b 0a = pPager->pVfs;.
18080 20 20 69 6e 74 20 72 63 3b 20 20 20 20 20 20 20 int rc;
18090 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 52 /* R
180a0 65 74 75 72 6e 20 63 6f 64 65 20 2a 2f 0a 20 20 eturn code */.
180b0 73 71 6c 69 74 65 33 5f 66 69 6c 65 20 2a 70 4d sqlite3_file *pM
180c0 61 73 74 65 72 3b 20 20 20 20 2f 2a 20 4d 61 6c aster; /* Mal
180d0 6c 6f 63 27 64 20 6d 61 73 74 65 72 2d 6a 6f 75 loc'd master-jou
180e0 72 6e 61 6c 20 66 69 6c 65 20 64 65 73 63 72 69 rnal file descri
180f0 70 74 6f 72 20 2a 2f 0a 20 20 73 71 6c 69 74 65 ptor */. sqlite
18100 33 5f 66 69 6c 65 20 2a 70 4a 6f 75 72 6e 61 6c 3_file *pJournal
18110 3b 20 20 20 2f 2a 20 4d 61 6c 6c 6f 63 27 64 20 ; /* Malloc'd
18120 63 68 69 6c 64 2d 6a 6f 75 72 6e 61 6c 20 66 69 child-journal fi
18130 6c 65 20 64 65 73 63 72 69 70 74 6f 72 20 2a 2f le descriptor */
18140 0a 20 20 63 68 61 72 20 2a 7a 4d 61 73 74 65 72 . char *zMaster
18150 4a 6f 75 72 6e 61 6c 20 3d 20 30 3b 20 2f 2a 20 Journal = 0; /*
18160 43 6f 6e 74 65 6e 74 73 20 6f 66 20 6d 61 73 74 Contents of mast
18170 65 72 20 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 20 er journal file
18180 2a 2f 0a 20 20 69 36 34 20 6e 4d 61 73 74 65 72 */. i64 nMaster
18190 4a 6f 75 72 6e 61 6c 3b 20 20 20 20 20 20 20 2f Journal; /
181a0 2a 20 53 69 7a 65 20 6f 66 20 6d 61 73 74 65 72 * Size of master
181b0 20 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 20 2a 2f journal file */
181c0 0a 20 20 63 68 61 72 20 2a 7a 4a 6f 75 72 6e 61 . char *zJourna
181d0 6c 3b 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 l; /*
181e0 50 6f 69 6e 74 65 72 20 74 6f 20 6f 6e 65 20 6a Pointer to one j
181f0 6f 75 72 6e 61 6c 20 77 69 74 68 69 6e 20 4d 4a ournal within MJ
18200 20 66 69 6c 65 20 2a 2f 0a 20 20 63 68 61 72 20 file */. char
18210 2a 7a 4d 61 73 74 65 72 50 74 72 3b 20 20 20 20 *zMasterPtr;
18220 20 20 20 20 20 2f 2a 20 53 70 61 63 65 20 74 6f /* Space to
18230 20 68 6f 6c 64 20 4d 4a 20 66 69 6c 65 6e 61 6d hold MJ filenam
18240 65 20 66 72 6f 6d 20 61 20 6a 6f 75 72 6e 61 6c e from a journal
18250 20 66 69 6c 65 20 2a 2f 0a 20 20 69 6e 74 20 6e file */. int n
18260 4d 61 73 74 65 72 50 74 72 3b 20 20 20 20 20 20 MasterPtr;
18270 20 20 20 20 20 2f 2a 20 41 6d 6f 75 6e 74 20 6f /* Amount o
18280 66 20 73 70 61 63 65 20 61 6c 6c 6f 63 61 74 65 f space allocate
18290 64 20 74 6f 20 7a 4d 61 73 74 65 72 50 74 72 5b d to zMasterPtr[
182a0 5d 20 2a 2f 0a 0a 20 20 2f 2a 20 41 6c 6c 6f 63 ] */.. /* Alloc
182b0 61 74 65 20 73 70 61 63 65 20 66 6f 72 20 62 6f ate space for bo
182c0 74 68 20 74 68 65 20 70 4a 6f 75 72 6e 61 6c 20 th the pJournal
182d0 61 6e 64 20 70 4d 61 73 74 65 72 20 66 69 6c 65 and pMaster file
182e0 20 64 65 73 63 72 69 70 74 6f 72 73 2e 0a 20 20 descriptors..
182f0 2a 2a 20 49 66 20 73 75 63 63 65 73 73 66 75 6c ** If successful
18300 2c 20 6f 70 65 6e 20 74 68 65 20 6d 61 73 74 65 , open the maste
18310 72 20 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 20 66 r journal file f
18320 6f 72 20 72 65 61 64 69 6e 67 2e 0a 20 20 2a 2f or reading.. */
18330 0a 20 20 70 4d 61 73 74 65 72 20 3d 20 28 73 71 . pMaster = (sq
18340 6c 69 74 65 33 5f 66 69 6c 65 20 2a 29 73 71 6c lite3_file *)sql
18350 69 74 65 33 4d 61 6c 6c 6f 63 5a 65 72 6f 28 70 ite3MallocZero(p
18360 56 66 73 2d 3e 73 7a 4f 73 46 69 6c 65 20 2a 20 Vfs->szOsFile *
18370 32 29 3b 0a 20 20 70 4a 6f 75 72 6e 61 6c 20 3d 2);. pJournal =
18380 20 28 73 71 6c 69 74 65 33 5f 66 69 6c 65 20 2a (sqlite3_file *
18390 29 28 28 28 75 38 20 2a 29 70 4d 61 73 74 65 72 )(((u8 *)pMaster
183a0 29 20 2b 20 70 56 66 73 2d 3e 73 7a 4f 73 46 69 ) + pVfs->szOsFi
183b0 6c 65 29 3b 0a 20 20 69 66 28 20 21 70 4d 61 73 le);. if( !pMas
183c0 74 65 72 20 29 7b 0a 20 20 20 20 72 63 20 3d 20 ter ){. rc =
183d0 53 51 4c 49 54 45 5f 4e 4f 4d 45 4d 3b 0a 20 20 SQLITE_NOMEM;.
183e0 7d 65 6c 73 65 7b 0a 20 20 20 20 63 6f 6e 73 74 }else{. const
183f0 20 69 6e 74 20 66 6c 61 67 73 20 3d 20 28 53 51 int flags = (SQ
18400 4c 49 54 45 5f 4f 50 45 4e 5f 52 45 41 44 4f 4e LITE_OPEN_READON
18410 4c 59 7c 53 51 4c 49 54 45 5f 4f 50 45 4e 5f 4d LY|SQLITE_OPEN_M
18420 41 53 54 45 52 5f 4a 4f 55 52 4e 41 4c 29 3b 0a ASTER_JOURNAL);.
18430 20 20 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33 rc = sqlite3
18440 4f 73 4f 70 65 6e 28 70 56 66 73 2c 20 7a 4d 61 OsOpen(pVfs, zMa
18450 73 74 65 72 2c 20 70 4d 61 73 74 65 72 2c 20 66 ster, pMaster, f
18460 6c 61 67 73 2c 20 30 29 3b 0a 20 20 7d 0a 20 20 lags, 0);. }.
18470 69 66 28 20 72 63 21 3d 53 51 4c 49 54 45 5f 4f if( rc!=SQLITE_O
18480 4b 20 29 20 67 6f 74 6f 20 64 65 6c 6d 61 73 74 K ) goto delmast
18490 65 72 5f 6f 75 74 3b 0a 0a 20 20 2f 2a 20 4c 6f er_out;.. /* Lo
184a0 61 64 20 74 68 65 20 65 6e 74 69 72 65 20 6d 61 ad the entire ma
184b0 73 74 65 72 20 6a 6f 75 72 6e 61 6c 20 66 69 6c ster journal fil
184c0 65 20 69 6e 74 6f 20 73 70 61 63 65 20 6f 62 74 e into space obt
184d0 61 69 6e 65 64 20 66 72 6f 6d 0a 20 20 2a 2a 20 ained from. **
184e0 73 71 6c 69 74 65 33 5f 6d 61 6c 6c 6f 63 28 29 sqlite3_malloc()
184f0 20 61 6e 64 20 70 6f 69 6e 74 65 64 20 74 6f 20 and pointed to
18500 62 79 20 7a 4d 61 73 74 65 72 4a 6f 75 72 6e 61 by zMasterJourna
18510 6c 2e 20 20 20 41 6c 73 6f 20 6f 62 74 61 69 6e l. Also obtain
18520 0a 20 20 2a 2a 20 73 75 66 66 69 63 69 65 6e 74 . ** sufficient
18530 20 73 70 61 63 65 20 28 69 6e 20 7a 4d 61 73 74 space (in zMast
18540 65 72 50 74 72 29 20 74 6f 20 68 6f 6c 64 20 74 erPtr) to hold t
18550 68 65 20 6e 61 6d 65 73 20 6f 66 20 6d 61 73 74 he names of mast
18560 65 72 0a 20 20 2a 2a 20 6a 6f 75 72 6e 61 6c 20 er. ** journal
18570 66 69 6c 65 73 20 65 78 74 72 61 63 74 65 64 20 files extracted
18580 66 72 6f 6d 20 72 65 67 75 6c 61 72 20 72 6f 6c from regular rol
18590 6c 62 61 63 6b 2d 6a 6f 75 72 6e 61 6c 73 2e 0a lback-journals..
185a0 20 20 2a 2f 0a 20 20 72 63 20 3d 20 73 71 6c 69 */. rc = sqli
185b0 74 65 33 4f 73 46 69 6c 65 53 69 7a 65 28 70 4d te3OsFileSize(pM
185c0 61 73 74 65 72 2c 20 26 6e 4d 61 73 74 65 72 4a aster, &nMasterJ
185d0 6f 75 72 6e 61 6c 29 3b 0a 20 20 69 66 28 20 72 ournal);. if( r
185e0 63 21 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 20 67 c!=SQLITE_OK ) g
185f0 6f 74 6f 20 64 65 6c 6d 61 73 74 65 72 5f 6f 75 oto delmaster_ou
18600 74 3b 0a 20 20 6e 4d 61 73 74 65 72 50 74 72 20 t;. nMasterPtr
18610 3d 20 70 56 66 73 2d 3e 6d 78 50 61 74 68 6e 61 = pVfs->mxPathna
18620 6d 65 2b 31 3b 0a 20 20 7a 4d 61 73 74 65 72 4a me+1;. zMasterJ
18630 6f 75 72 6e 61 6c 20 3d 20 73 71 6c 69 74 65 33 ournal = sqlite3
18640 4d 61 6c 6c 6f 63 28 28 69 6e 74 29 6e 4d 61 73 Malloc((int)nMas
18650 74 65 72 4a 6f 75 72 6e 61 6c 20 2b 20 6e 4d 61 terJournal + nMa
18660 73 74 65 72 50 74 72 20 2b 20 31 29 3b 0a 20 20 sterPtr + 1);.
18670 69 66 28 20 21 7a 4d 61 73 74 65 72 4a 6f 75 72 if( !zMasterJour
18680 6e 61 6c 20 29 7b 0a 20 20 20 20 72 63 20 3d 20 nal ){. rc =
18690 53 51 4c 49 54 45 5f 4e 4f 4d 45 4d 3b 0a 20 20 SQLITE_NOMEM;.
186a0 20 20 67 6f 74 6f 20 64 65 6c 6d 61 73 74 65 72 goto delmaster
186b0 5f 6f 75 74 3b 0a 20 20 7d 0a 20 20 7a 4d 61 73 _out;. }. zMas
186c0 74 65 72 50 74 72 20 3d 20 26 7a 4d 61 73 74 65 terPtr = &zMaste
186d0 72 4a 6f 75 72 6e 61 6c 5b 6e 4d 61 73 74 65 72 rJournal[nMaster
186e0 4a 6f 75 72 6e 61 6c 2b 31 5d 3b 0a 20 20 72 63 Journal+1];. rc
186f0 20 3d 20 73 71 6c 69 74 65 33 4f 73 52 65 61 64 = sqlite3OsRead
18700 28 70 4d 61 73 74 65 72 2c 20 7a 4d 61 73 74 65 (pMaster, zMaste
18710 72 4a 6f 75 72 6e 61 6c 2c 20 28 69 6e 74 29 6e rJournal, (int)n
18720 4d 61 73 74 65 72 4a 6f 75 72 6e 61 6c 2c 20 30 MasterJournal, 0
18730 29 3b 0a 20 20 69 66 28 20 72 63 21 3d 53 51 4c );. if( rc!=SQL
18740 49 54 45 5f 4f 4b 20 29 20 67 6f 74 6f 20 64 65 ITE_OK ) goto de
18750 6c 6d 61 73 74 65 72 5f 6f 75 74 3b 0a 20 20 7a lmaster_out;. z
18760 4d 61 73 74 65 72 4a 6f 75 72 6e 61 6c 5b 6e 4d MasterJournal[nM
18770 61 73 74 65 72 4a 6f 75 72 6e 61 6c 5d 20 3d 20 asterJournal] =
18780 30 3b 0a 0a 20 20 7a 4a 6f 75 72 6e 61 6c 20 3d 0;.. zJournal =
18790 20 7a 4d 61 73 74 65 72 4a 6f 75 72 6e 61 6c 3b zMasterJournal;
187a0 0a 20 20 77 68 69 6c 65 28 20 28 7a 4a 6f 75 72 . while( (zJour
187b0 6e 61 6c 2d 7a 4d 61 73 74 65 72 4a 6f 75 72 6e nal-zMasterJourn
187c0 61 6c 29 3c 6e 4d 61 73 74 65 72 4a 6f 75 72 6e al)<nMasterJourn
187d0 61 6c 20 29 7b 0a 20 20 20 20 69 6e 74 20 65 78 al ){. int ex
187e0 69 73 74 73 3b 0a 20 20 20 20 72 63 20 3d 20 73 ists;. rc = s
187f0 71 6c 69 74 65 33 4f 73 41 63 63 65 73 73 28 70 qlite3OsAccess(p
18800 56 66 73 2c 20 7a 4a 6f 75 72 6e 61 6c 2c 20 53 Vfs, zJournal, S
18810 51 4c 49 54 45 5f 41 43 43 45 53 53 5f 45 58 49 QLITE_ACCESS_EXI
18820 53 54 53 2c 20 26 65 78 69 73 74 73 29 3b 0a 20 STS, &exists);.
18830 20 20 20 69 66 28 20 72 63 21 3d 53 51 4c 49 54 if( rc!=SQLIT
18840 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 20 20 67 6f E_OK ){. go
18850 74 6f 20 64 65 6c 6d 61 73 74 65 72 5f 6f 75 74 to delmaster_out
18860 3b 0a 20 20 20 20 7d 0a 20 20 20 20 69 66 28 20 ;. }. if(
18870 65 78 69 73 74 73 20 29 7b 0a 20 20 20 20 20 20 exists ){.
18880 2f 2a 20 4f 6e 65 20 6f 66 20 74 68 65 20 6a 6f /* One of the jo
18890 75 72 6e 61 6c 73 20 70 6f 69 6e 74 65 64 20 74 urnals pointed t
188a0 6f 20 62 79 20 74 68 65 20 6d 61 73 74 65 72 20 o by the master
188b0 6a 6f 75 72 6e 61 6c 20 65 78 69 73 74 73 2e 0a journal exists..
188c0 20 20 20 20 20 20 2a 2a 20 4f 70 65 6e 20 69 74 ** Open it
188d0 20 61 6e 64 20 63 68 65 63 6b 20 69 66 20 69 74 and check if it
188e0 20 70 6f 69 6e 74 73 20 61 74 20 74 68 65 20 6d points at the m
188f0 61 73 74 65 72 20 6a 6f 75 72 6e 61 6c 2e 20 49 aster journal. I
18900 66 0a 20 20 20 20 20 20 2a 2a 20 73 6f 2c 20 72 f. ** so, r
18910 65 74 75 72 6e 20 77 69 74 68 6f 75 74 20 64 65 eturn without de
18920 6c 65 74 69 6e 67 20 74 68 65 20 6d 61 73 74 65 leting the maste
18930 72 20 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 2e 0a r journal file..
18940 20 20 20 20 20 20 2a 2f 0a 20 20 20 20 20 20 69 */. i
18950 6e 74 20 63 3b 0a 20 20 20 20 20 20 69 6e 74 20 nt c;. int
18960 66 6c 61 67 73 20 3d 20 28 53 51 4c 49 54 45 5f flags = (SQLITE_
18970 4f 50 45 4e 5f 52 45 41 44 4f 4e 4c 59 7c 53 51 OPEN_READONLY|SQ
18980 4c 49 54 45 5f 4f 50 45 4e 5f 4d 41 49 4e 5f 4a LITE_OPEN_MAIN_J
18990 4f 55 52 4e 41 4c 29 3b 0a 20 20 20 20 20 20 72 OURNAL);. r
189a0 63 20 3d 20 73 71 6c 69 74 65 33 4f 73 4f 70 65 c = sqlite3OsOpe
189b0 6e 28 70 56 66 73 2c 20 7a 4a 6f 75 72 6e 61 6c n(pVfs, zJournal
189c0 2c 20 70 4a 6f 75 72 6e 61 6c 2c 20 66 6c 61 67 , pJournal, flag
189d0 73 2c 20 30 29 3b 0a 20 20 20 20 20 20 69 66 28 s, 0);. if(
189e0 20 72 63 21 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 rc!=SQLITE_OK )
189f0 7b 0a 20 20 20 20 20 20 20 20 67 6f 74 6f 20 64 {. goto d
18a00 65 6c 6d 61 73 74 65 72 5f 6f 75 74 3b 0a 20 20 elmaster_out;.
18a10 20 20 20 20 7d 0a 0a 20 20 20 20 20 20 72 63 20 }.. rc
18a20 3d 20 72 65 61 64 4d 61 73 74 65 72 4a 6f 75 72 = readMasterJour
18a30 6e 61 6c 28 70 4a 6f 75 72 6e 61 6c 2c 20 7a 4d nal(pJournal, zM
18a40 61 73 74 65 72 50 74 72 2c 20 6e 4d 61 73 74 65 asterPtr, nMaste
18a50 72 50 74 72 29 3b 0a 20 20 20 20 20 20 73 71 6c rPtr);. sql
18a60 69 74 65 33 4f 73 43 6c 6f 73 65 28 70 4a 6f 75 ite3OsClose(pJou
18a70 72 6e 61 6c 29 3b 0a 20 20 20 20 20 20 69 66 28 rnal);. if(
18a80 20 72 63 21 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 rc!=SQLITE_OK )
18a90 7b 0a 20 20 20 20 20 20 20 20 67 6f 74 6f 20 64 {. goto d
18aa0 65 6c 6d 61 73 74 65 72 5f 6f 75 74 3b 0a 20 20 elmaster_out;.
18ab0 20 20 20 20 7d 0a 0a 20 20 20 20 20 20 63 20 3d }.. c =
18ac0 20 7a 4d 61 73 74 65 72 50 74 72 5b 30 5d 21 3d zMasterPtr[0]!=
18ad0 30 20 26 26 20 73 74 72 63 6d 70 28 7a 4d 61 73 0 && strcmp(zMas
18ae0 74 65 72 50 74 72 2c 20 7a 4d 61 73 74 65 72 29 terPtr, zMaster)
18af0 3d 3d 30 3b 0a 20 20 20 20 20 20 69 66 28 20 63 ==0;. if( c
18b00 20 29 7b 0a 20 20 20 20 20 20 20 20 2f 2a 20 57 ){. /* W
18b10 65 20 68 61 76 65 20 61 20 6d 61 74 63 68 2e 20 e have a match.
18b20 44 6f 20 6e 6f 74 20 64 65 6c 65 74 65 20 74 68 Do not delete th
18b30 65 20 6d 61 73 74 65 72 20 6a 6f 75 72 6e 61 6c e master journal
18b40 20 66 69 6c 65 2e 20 2a 2f 0a 20 20 20 20 20 20 file. */.
18b50 20 20 67 6f 74 6f 20 64 65 6c 6d 61 73 74 65 72 goto delmaster
18b60 5f 6f 75 74 3b 0a 20 20 20 20 20 20 7d 0a 20 20 _out;. }.
18b70 20 20 7d 0a 20 20 20 20 7a 4a 6f 75 72 6e 61 6c }. zJournal
18b80 20 2b 3d 20 28 73 71 6c 69 74 65 33 53 74 72 6c += (sqlite3Strl
18b90 65 6e 33 30 28 7a 4a 6f 75 72 6e 61 6c 29 2b 31 en30(zJournal)+1
18ba0 29 3b 0a 20 20 7d 0a 20 0a 20 20 73 71 6c 69 74 );. }. . sqlit
18bb0 65 33 4f 73 43 6c 6f 73 65 28 70 4d 61 73 74 65 e3OsClose(pMaste
18bc0 72 29 3b 0a 20 20 72 63 20 3d 20 73 71 6c 69 74 r);. rc = sqlit
18bd0 65 33 4f 73 44 65 6c 65 74 65 28 70 56 66 73 2c e3OsDelete(pVfs,
18be0 20 7a 4d 61 73 74 65 72 2c 20 30 29 3b 0a 0a 64 zMaster, 0);..d
18bf0 65 6c 6d 61 73 74 65 72 5f 6f 75 74 3a 0a 20 20 elmaster_out:.
18c00 73 71 6c 69 74 65 33 5f 66 72 65 65 28 7a 4d 61 sqlite3_free(zMa
18c10 73 74 65 72 4a 6f 75 72 6e 61 6c 29 3b 0a 20 20 sterJournal);.
18c20 69 66 28 20 70 4d 61 73 74 65 72 20 29 7b 0a 20 if( pMaster ){.
18c30 20 20 20 73 71 6c 69 74 65 33 4f 73 43 6c 6f 73 sqlite3OsClos
18c40 65 28 70 4d 61 73 74 65 72 29 3b 0a 20 20 20 20 e(pMaster);.
18c50 61 73 73 65 72 74 28 20 21 69 73 4f 70 65 6e 28 assert( !isOpen(
18c60 70 4a 6f 75 72 6e 61 6c 29 20 29 3b 0a 20 20 20 pJournal) );.
18c70 20 73 71 6c 69 74 65 33 5f 66 72 65 65 28 70 4d sqlite3_free(pM
18c80 61 73 74 65 72 29 3b 0a 20 20 7d 0a 20 20 72 65 aster);. }. re
18c90 74 75 72 6e 20 72 63 3b 0a 7d 0a 0a 0a 2f 2a 0a turn rc;.}.../*.
18ca0 2a 2a 20 54 68 69 73 20 66 75 6e 63 74 69 6f 6e ** This function
18cb0 20 69 73 20 75 73 65 64 20 74 6f 20 63 68 61 6e is used to chan
18cc0 67 65 20 74 68 65 20 61 63 74 75 61 6c 20 73 69 ge the actual si
18cd0 7a 65 20 6f 66 20 74 68 65 20 64 61 74 61 62 61 ze of the databa
18ce0 73 65 20 0a 2a 2a 20 66 69 6c 65 20 69 6e 20 74 se .** file in t
18cf0 68 65 20 66 69 6c 65 2d 73 79 73 74 65 6d 2e 20 he file-system.
18d00 54 68 69 73 20 6f 6e 6c 79 20 68 61 70 70 65 6e This only happen
18d10 73 20 77 68 65 6e 20 63 6f 6d 6d 69 74 74 69 6e s when committin
18d20 67 20 61 20 74 72 61 6e 73 61 63 74 69 6f 6e 2c g a transaction,
18d30 0a 2a 2a 20 6f 72 20 72 6f 6c 6c 69 6e 67 20 62 .** or rolling b
18d40 61 63 6b 20 61 20 74 72 61 6e 73 61 63 74 69 6f ack a transactio
18d50 6e 20 28 69 6e 63 6c 75 64 69 6e 67 20 72 6f 6c n (including rol
18d60 6c 69 6e 67 20 62 61 63 6b 20 61 20 68 6f 74 2d ling back a hot-
18d70 6a 6f 75 72 6e 61 6c 29 2e 0a 2a 2a 0a 2a 2a 20 journal)..**.**
18d80 49 66 20 74 68 65 20 6d 61 69 6e 20 64 61 74 61 If the main data
18d90 62 61 73 65 20 66 69 6c 65 20 69 73 20 6e 6f 74 base file is not
18da0 20 6f 70 65 6e 2c 20 6f 72 20 74 68 65 20 70 61 open, or the pa
18db0 67 65 72 20 69 73 20 6e 6f 74 20 69 6e 20 65 69 ger is not in ei
18dc0 74 68 65 72 0a 2a 2a 20 44 42 4d 4f 44 20 6f 72 ther.** DBMOD or
18dd0 20 4f 50 45 4e 20 73 74 61 74 65 2c 20 74 68 69 OPEN state, thi
18de0 73 20 66 75 6e 63 74 69 6f 6e 20 69 73 20 61 20 s function is a
18df0 6e 6f 2d 6f 70 2e 20 4f 74 68 65 72 77 69 73 65 no-op. Otherwise
18e00 2c 20 74 68 65 20 73 69 7a 65 20 0a 2a 2a 20 6f , the size .** o
18e10 66 20 74 68 65 20 66 69 6c 65 20 69 73 20 63 68 f the file is ch
18e20 61 6e 67 65 64 20 74 6f 20 6e 50 61 67 65 20 70 anged to nPage p
18e30 61 67 65 73 20 28 6e 50 61 67 65 2a 70 50 61 67 ages (nPage*pPag
18e40 65 72 2d 3e 70 61 67 65 53 69 7a 65 20 62 79 74 er->pageSize byt
18e50 65 73 29 2e 20 0a 2a 2a 20 49 66 20 74 68 65 20 es). .** If the
18e60 66 69 6c 65 20 6f 6e 20 64 69 73 6b 20 69 73 20 file on disk is
18e70 63 75 72 72 65 6e 74 6c 79 20 6c 61 72 67 65 72 currently larger
18e80 20 74 68 61 6e 20 6e 50 61 67 65 20 70 61 67 65 than nPage page
18e90 73 2c 20 74 68 65 6e 20 75 73 65 20 74 68 65 20 s, then use the
18ea0 56 46 53 0a 2a 2a 20 78 54 72 75 6e 63 61 74 65 VFS.** xTruncate
18eb0 28 29 20 6d 65 74 68 6f 64 20 74 6f 20 74 72 75 () method to tru
18ec0 6e 63 61 74 65 20 69 74 2e 0a 2a 2a 0a 2a 2a 20 ncate it..**.**
18ed0 4f 72 2c 20 69 74 20 6d 69 67 68 74 20 6d 69 67 Or, it might mig
18ee0 68 74 20 62 65 20 74 68 65 20 63 61 73 65 20 74 ht be the case t
18ef0 68 61 74 20 74 68 65 20 66 69 6c 65 20 6f 6e 20 hat the file on
18f00 64 69 73 6b 20 69 73 20 73 6d 61 6c 6c 65 72 20 disk is smaller
18f10 74 68 61 6e 20 0a 2a 2a 20 6e 50 61 67 65 20 70 than .** nPage p
18f20 61 67 65 73 2e 20 53 6f 6d 65 20 6f 70 65 72 61 ages. Some opera
18f30 74 69 6e 67 20 73 79 73 74 65 6d 20 69 6d 70 6c ting system impl
18f40 65 6d 65 6e 74 61 74 69 6f 6e 73 20 63 61 6e 20 ementations can
18f50 67 65 74 20 63 6f 6e 66 75 73 65 64 20 69 66 20 get confused if
18f60 0a 2a 2a 20 79 6f 75 20 74 72 79 20 74 6f 20 74 .** you try to t
18f70 72 75 6e 63 61 74 65 20 61 20 66 69 6c 65 20 74 runcate a file t
18f80 6f 20 73 6f 6d 65 20 73 69 7a 65 20 74 68 61 74 o some size that
18f90 20 69 73 20 6c 61 72 67 65 72 20 74 68 61 6e 20 is larger than
18fa0 69 74 20 0a 2a 2a 20 63 75 72 72 65 6e 74 6c 79 it .** currently
18fb0 20 69 73 2c 20 73 6f 20 64 65 74 65 63 74 20 74 is, so detect t
18fc0 68 69 73 20 63 61 73 65 20 61 6e 64 20 77 72 69 his case and wri
18fd0 74 65 20 61 20 73 69 6e 67 6c 65 20 7a 65 72 6f te a single zero
18fe0 20 62 79 74 65 20 74 6f 20 0a 2a 2a 20 74 68 65 byte to .** the
18ff0 20 65 6e 64 20 6f 66 20 74 68 65 20 6e 65 77 20 end of the new
19000 66 69 6c 65 20 69 6e 73 74 65 61 64 2e 0a 2a 2a file instead..**
19010 0a 2a 2a 20 49 66 20 73 75 63 63 65 73 73 66 75 .** If successfu
19020 6c 2c 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 l, return SQLITE
19030 5f 4f 4b 2e 20 49 66 20 61 6e 20 49 4f 20 65 72 _OK. If an IO er
19040 72 6f 72 20 6f 63 63 75 72 73 20 77 68 69 6c 65 ror occurs while
19050 20 6d 6f 64 69 66 79 69 6e 67 0a 2a 2a 20 74 68 modifying.** th
19060 65 20 64 61 74 61 62 61 73 65 20 66 69 6c 65 2c e database file,
19070 20 72 65 74 75 72 6e 20 74 68 65 20 65 72 72 6f return the erro
19080 72 20 63 6f 64 65 20 74 6f 20 74 68 65 20 63 61 r code to the ca
19090 6c 6c 65 72 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 ller..*/.static
190a0 69 6e 74 20 70 61 67 65 72 5f 74 72 75 6e 63 61 int pager_trunca
190b0 74 65 28 50 61 67 65 72 20 2a 70 50 61 67 65 72 te(Pager *pPager
190c0 2c 20 50 67 6e 6f 20 6e 50 61 67 65 29 7b 0a 20 , Pgno nPage){.
190d0 20 69 6e 74 20 72 63 20 3d 20 53 51 4c 49 54 45 int rc = SQLITE
190e0 5f 4f 4b 3b 0a 20 20 61 73 73 65 72 74 28 20 70 _OK;. assert( p
190f0 50 61 67 65 72 2d 3e 65 53 74 61 74 65 21 3d 50 Pager->eState!=P
19100 41 47 45 52 5f 45 52 52 4f 52 20 29 3b 0a 20 20 AGER_ERROR );.
19110 61 73 73 65 72 74 28 20 70 50 61 67 65 72 2d 3e assert( pPager->
19120 65 53 74 61 74 65 21 3d 50 41 47 45 52 5f 52 45 eState!=PAGER_RE
19130 41 44 45 52 20 29 3b 0a 20 20 0a 20 20 69 66 28 ADER );. . if(
19140 20 69 73 4f 70 65 6e 28 70 50 61 67 65 72 2d 3e isOpen(pPager->
19150 66 64 29 20 0a 20 20 20 26 26 20 28 70 50 61 67 fd) . && (pPag
19160 65 72 2d 3e 65 53 74 61 74 65 3e 3d 50 41 47 45 er->eState>=PAGE
19170 52 5f 57 52 49 54 45 52 5f 44 42 4d 4f 44 20 7c R_WRITER_DBMOD |
19180 7c 20 70 50 61 67 65 72 2d 3e 65 53 74 61 74 65 | pPager->eState
19190 3d 3d 50 41 47 45 52 5f 4f 50 45 4e 29 20 0a 20 ==PAGER_OPEN) .
191a0 20 29 7b 0a 20 20 20 20 69 36 34 20 63 75 72 72 ){. i64 curr
191b0 65 6e 74 53 69 7a 65 2c 20 6e 65 77 53 69 7a 65 entSize, newSize
191c0 3b 0a 20 20 20 20 69 6e 74 20 73 7a 50 61 67 65 ;. int szPage
191d0 20 3d 20 70 50 61 67 65 72 2d 3e 70 61 67 65 53 = pPager->pageS
191e0 69 7a 65 3b 0a 20 20 20 20 61 73 73 65 72 74 28 ize;. assert(
191f0 20 70 50 61 67 65 72 2d 3e 65 4c 6f 63 6b 3d 3d pPager->eLock==
19200 45 58 43 4c 55 53 49 56 45 5f 4c 4f 43 4b 20 29 EXCLUSIVE_LOCK )
19210 3b 0a 20 20 20 20 2f 2a 20 54 4f 44 4f 3a 20 49 ;. /* TODO: I
19220 73 20 69 74 20 73 61 66 65 20 74 6f 20 75 73 65 s it safe to use
19230 20 50 61 67 65 72 2e 64 62 46 69 6c 65 53 69 7a Pager.dbFileSiz
19240 65 20 68 65 72 65 3f 20 2a 2f 0a 20 20 20 20 72 e here? */. r
19250 63 20 3d 20 73 71 6c 69 74 65 33 4f 73 46 69 6c c = sqlite3OsFil
19260 65 53 69 7a 65 28 70 50 61 67 65 72 2d 3e 66 64 eSize(pPager->fd
19270 2c 20 26 63 75 72 72 65 6e 74 53 69 7a 65 29 3b , ¤tSize);
19280 0a 20 20 20 20 6e 65 77 53 69 7a 65 20 3d 20 73 . newSize = s
19290 7a 50 61 67 65 2a 28 69 36 34 29 6e 50 61 67 65 zPage*(i64)nPage
192a0 3b 0a 20 20 20 20 69 66 28 20 72 63 3d 3d 53 51 ;. if( rc==SQ
192b0 4c 49 54 45 5f 4f 4b 20 26 26 20 63 75 72 72 65 LITE_OK && curre
192c0 6e 74 53 69 7a 65 21 3d 6e 65 77 53 69 7a 65 20 ntSize!=newSize
192d0 29 7b 0a 20 20 20 20 20 20 69 66 28 20 63 75 72 ){. if( cur
192e0 72 65 6e 74 53 69 7a 65 3e 6e 65 77 53 69 7a 65 rentSize>newSize
192f0 20 29 7b 0a 20 20 20 20 20 20 20 20 72 63 20 3d ){. rc =
19300 20 73 71 6c 69 74 65 33 4f 73 54 72 75 6e 63 61 sqlite3OsTrunca
19310 74 65 28 70 50 61 67 65 72 2d 3e 66 64 2c 20 6e te(pPager->fd, n
19320 65 77 53 69 7a 65 29 3b 0a 20 20 20 20 20 20 7d ewSize);. }
19330 65 6c 73 65 7b 0a 20 20 20 20 20 20 20 20 63 68 else{. ch
19340 61 72 20 2a 70 54 6d 70 20 3d 20 70 50 61 67 65 ar *pTmp = pPage
19350 72 2d 3e 70 54 6d 70 53 70 61 63 65 3b 0a 20 20 r->pTmpSpace;.
19360 20 20 20 20 20 20 6d 65 6d 73 65 74 28 70 54 6d memset(pTm
19370 70 2c 20 30 2c 20 73 7a 50 61 67 65 29 3b 0a 20 p, 0, szPage);.
19380 20 20 20 20 20 20 20 74 65 73 74 63 61 73 65 28 testcase(
19390 20 28 6e 65 77 53 69 7a 65 2d 73 7a 50 61 67 65 (newSize-szPage
193a0 29 20 3c 20 20 63 75 72 72 65 6e 74 53 69 7a 65 ) < currentSize
193b0 20 29 3b 0a 20 20 20 20 20 20 20 20 74 65 73 74 );. test
193c0 63 61 73 65 28 20 28 6e 65 77 53 69 7a 65 2d 73 case( (newSize-s
193d0 7a 50 61 67 65 29 20 3d 3d 20 63 75 72 72 65 6e zPage) == curren
193e0 74 53 69 7a 65 20 29 3b 0a 20 20 20 20 20 20 20 tSize );.
193f0 20 74 65 73 74 63 61 73 65 28 20 28 6e 65 77 53 testcase( (newS
19400 69 7a 65 2d 73 7a 50 61 67 65 29 20 3e 20 20 63 ize-szPage) > c
19410 75 72 72 65 6e 74 53 69 7a 65 20 29 3b 0a 20 20 urrentSize );.
19420 20 20 20 20 20 20 72 63 20 3d 20 73 71 6c 69 74 rc = sqlit
19430 65 33 4f 73 57 72 69 74 65 28 70 50 61 67 65 72 e3OsWrite(pPager
19440 2d 3e 66 64 2c 20 70 54 6d 70 2c 20 73 7a 50 61 ->fd, pTmp, szPa
19450 67 65 2c 20 6e 65 77 53 69 7a 65 2d 73 7a 50 61 ge, newSize-szPa
19460 67 65 29 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20 ge);. }.
19470 20 20 20 69 66 28 20 72 63 3d 3d 53 51 4c 49 54 if( rc==SQLIT
19480 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 20 20 20 20 E_OK ){.
19490 70 50 61 67 65 72 2d 3e 64 62 46 69 6c 65 53 69 pPager->dbFileSi
194a0 7a 65 20 3d 20 6e 50 61 67 65 3b 0a 20 20 20 20 ze = nPage;.
194b0 20 20 7d 0a 20 20 20 20 7d 0a 20 20 7d 0a 20 20 }. }. }.
194c0 72 65 74 75 72 6e 20 72 63 3b 0a 7d 0a 0a 2f 2a return rc;.}../*
194d0 0a 2a 2a 20 53 65 74 20 74 68 65 20 76 61 6c 75 .** Set the valu
194e0 65 20 6f 66 20 74 68 65 20 50 61 67 65 72 2e 73 e of the Pager.s
194f0 65 63 74 6f 72 53 69 7a 65 20 76 61 72 69 61 62 ectorSize variab
19500 6c 65 20 66 6f 72 20 74 68 65 20 67 69 76 65 6e le for the given
19510 0a 2a 2a 20 70 61 67 65 72 20 62 61 73 65 64 20 .** pager based
19520 6f 6e 20 74 68 65 20 76 61 6c 75 65 20 72 65 74 on the value ret
19530 75 72 6e 65 64 20 62 79 20 74 68 65 20 78 53 65 urned by the xSe
19540 63 74 6f 72 53 69 7a 65 20 6d 65 74 68 6f 64 0a ctorSize method.
19550 2a 2a 20 6f 66 20 74 68 65 20 6f 70 65 6e 20 64 ** of the open d
19560 61 74 61 62 61 73 65 20 66 69 6c 65 2e 20 54 68 atabase file. Th
19570 65 20 73 65 63 74 6f 72 20 73 69 7a 65 20 77 69 e sector size wi
19580 6c 6c 20 62 65 20 75 73 65 64 20 75 73 65 64 20 ll be used used
19590 0a 2a 2a 20 74 6f 20 64 65 74 65 72 6d 69 6e 65 .** to determine
195a0 20 74 68 65 20 73 69 7a 65 20 61 6e 64 20 61 6c the size and al
195b0 69 67 6e 6d 65 6e 74 20 6f 66 20 6a 6f 75 72 6e ignment of journ
195c0 61 6c 20 68 65 61 64 65 72 20 61 6e 64 20 0a 2a al header and .*
195d0 2a 20 6d 61 73 74 65 72 20 6a 6f 75 72 6e 61 6c * master journal
195e0 20 70 6f 69 6e 74 65 72 73 20 77 69 74 68 69 6e pointers within
195f0 20 63 72 65 61 74 65 64 20 6a 6f 75 72 6e 61 6c created journal
19600 20 66 69 6c 65 73 2e 0a 2a 2a 0a 2a 2a 20 46 6f files..**.** Fo
19610 72 20 74 65 6d 70 6f 72 61 72 79 20 66 69 6c 65 r temporary file
19620 73 20 74 68 65 20 65 66 66 65 63 74 69 76 65 20 s the effective
19630 73 65 63 74 6f 72 20 73 69 7a 65 20 69 73 20 61 sector size is a
19640 6c 77 61 79 73 20 35 31 32 20 62 79 74 65 73 2e lways 512 bytes.
19650 0a 2a 2a 0a 2a 2a 20 4f 74 68 65 72 77 69 73 65 .**.** Otherwise
19660 2c 20 66 6f 72 20 6e 6f 6e 2d 74 65 6d 70 6f 72 , for non-tempor
19670 61 72 79 20 66 69 6c 65 73 2c 20 74 68 65 20 65 ary files, the e
19680 66 66 65 63 74 69 76 65 20 73 65 63 74 6f 72 20 ffective sector
19690 73 69 7a 65 20 69 73 0a 2a 2a 20 74 68 65 20 76 size is.** the v
196a0 61 6c 75 65 20 72 65 74 75 72 6e 65 64 20 62 79 alue returned by
196b0 20 74 68 65 20 78 53 65 63 74 6f 72 53 69 7a 65 the xSectorSize
196c0 28 29 20 6d 65 74 68 6f 64 20 72 6f 75 6e 64 65 () method rounde
196d0 64 20 75 70 20 74 6f 20 33 32 20 69 66 0a 2a 2a d up to 32 if.**
196e0 20 69 74 20 69 73 20 6c 65 73 73 20 74 68 61 6e it is less than
196f0 20 33 32 2c 20 6f 72 20 72 6f 75 6e 64 65 64 20 32, or rounded
19700 64 6f 77 6e 20 74 6f 20 4d 41 58 5f 53 45 43 54 down to MAX_SECT
19710 4f 52 5f 53 49 5a 45 20 69 66 20 69 74 0a 2a 2a OR_SIZE if it.**
19720 20 69 73 20 67 72 65 61 74 65 72 20 74 68 61 6e is greater than
19730 20 4d 41 58 5f 53 45 43 54 4f 52 5f 53 49 5a 45 MAX_SECTOR_SIZE
19740 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 76 6f 69 64 ..*/.static void
19750 20 73 65 74 53 65 63 74 6f 72 53 69 7a 65 28 50 setSectorSize(P
19760 61 67 65 72 20 2a 70 50 61 67 65 72 29 7b 0a 20 ager *pPager){.
19770 20 61 73 73 65 72 74 28 20 69 73 4f 70 65 6e 28 assert( isOpen(
19780 70 50 61 67 65 72 2d 3e 66 64 29 20 7c 7c 20 70 pPager->fd) || p
19790 50 61 67 65 72 2d 3e 74 65 6d 70 46 69 6c 65 20 Pager->tempFile
197a0 29 3b 0a 0a 20 20 69 66 28 20 21 70 50 61 67 65 );.. if( !pPage
197b0 72 2d 3e 74 65 6d 70 46 69 6c 65 20 29 7b 0a 20 r->tempFile ){.
197c0 20 20 20 2f 2a 20 53 65 63 74 6f 72 20 73 69 7a /* Sector siz
197d0 65 20 64 6f 65 73 6e 27 74 20 6d 61 74 74 65 72 e doesn't matter
197e0 20 66 6f 72 20 74 65 6d 70 6f 72 61 72 79 20 66 for temporary f
197f0 69 6c 65 73 2e 20 41 6c 73 6f 2c 20 74 68 65 20 iles. Also, the
19800 66 69 6c 65 0a 20 20 20 20 2a 2a 20 6d 61 79 20 file. ** may
19810 6e 6f 74 20 68 61 76 65 20 62 65 65 6e 20 6f 70 not have been op
19820 65 6e 65 64 20 79 65 74 2c 20 69 6e 20 77 68 69 ened yet, in whi
19830 63 68 20 63 61 73 65 20 74 68 65 20 4f 73 53 65 ch case the OsSe
19840 63 74 6f 72 53 69 7a 65 28 29 0a 20 20 20 20 2a ctorSize(). *
19850 2a 20 63 61 6c 6c 20 77 69 6c 6c 20 73 65 67 66 * call will segf
19860 61 75 6c 74 2e 0a 20 20 20 20 2a 2f 0a 20 20 20 ault.. */.
19870 20 70 50 61 67 65 72 2d 3e 73 65 63 74 6f 72 53 pPager->sectorS
19880 69 7a 65 20 3d 20 73 71 6c 69 74 65 33 4f 73 53 ize = sqlite3OsS
19890 65 63 74 6f 72 53 69 7a 65 28 70 50 61 67 65 72 ectorSize(pPager
198a0 2d 3e 66 64 29 3b 0a 20 20 7d 0a 20 20 69 66 28 ->fd);. }. if(
198b0 20 70 50 61 67 65 72 2d 3e 73 65 63 74 6f 72 53 pPager->sectorS
198c0 69 7a 65 3c 33 32 20 29 7b 0a 20 20 20 20 70 50 ize<32 ){. pP
198d0 61 67 65 72 2d 3e 73 65 63 74 6f 72 53 69 7a 65 ager->sectorSize
198e0 20 3d 20 35 31 32 3b 0a 20 20 7d 0a 20 20 69 66 = 512;. }. if
198f0 28 20 70 50 61 67 65 72 2d 3e 73 65 63 74 6f 72 ( pPager->sector
19900 53 69 7a 65 3e 4d 41 58 5f 53 45 43 54 4f 52 5f Size>MAX_SECTOR_
19910 53 49 5a 45 20 29 7b 0a 20 20 20 20 61 73 73 65 SIZE ){. asse
19920 72 74 28 20 4d 41 58 5f 53 45 43 54 4f 52 5f 53 rt( MAX_SECTOR_S
19930 49 5a 45 3e 3d 35 31 32 20 29 3b 0a 20 20 20 20 IZE>=512 );.
19940 70 50 61 67 65 72 2d 3e 73 65 63 74 6f 72 53 69 pPager->sectorSi
19950 7a 65 20 3d 20 4d 41 58 5f 53 45 43 54 4f 52 5f ze = MAX_SECTOR_
19960 53 49 5a 45 3b 0a 20 20 7d 0a 7d 0a 0a 2f 2a 0a SIZE;. }.}../*.
19970 2a 2a 20 50 6c 61 79 62 61 63 6b 20 74 68 65 20 ** Playback the
19980 6a 6f 75 72 6e 61 6c 20 61 6e 64 20 74 68 75 73 journal and thus
19990 20 72 65 73 74 6f 72 65 20 74 68 65 20 64 61 74 restore the dat
199a0 61 62 61 73 65 20 66 69 6c 65 20 74 6f 0a 2a 2a abase file to.**
199b0 20 74 68 65 20 73 74 61 74 65 20 69 74 20 77 61 the state it wa
199c0 73 20 69 6e 20 62 65 66 6f 72 65 20 77 65 20 73 s in before we s
199d0 74 61 72 74 65 64 20 6d 61 6b 69 6e 67 20 63 68 tarted making ch
199e0 61 6e 67 65 73 2e 20 20 0a 2a 2a 0a 2a 2a 20 54 anges. .**.** T
199f0 68 65 20 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 20 he journal file
19a00 66 6f 72 6d 61 74 20 69 73 20 61 73 20 66 6f 6c format is as fol
19a10 6c 6f 77 73 3a 20 0a 2a 2a 0a 2a 2a 20 20 28 31 lows: .**.** (1
19a20 29 20 20 38 20 62 79 74 65 20 70 72 65 66 69 78 ) 8 byte prefix
19a30 2e 20 20 41 20 63 6f 70 79 20 6f 66 20 61 4a 6f . A copy of aJo
19a40 75 72 6e 61 6c 4d 61 67 69 63 5b 5d 2e 0a 2a 2a urnalMagic[]..**
19a50 20 20 28 32 29 20 20 34 20 62 79 74 65 20 62 69 (2) 4 byte bi
19a60 67 2d 65 6e 64 69 61 6e 20 69 6e 74 65 67 65 72 g-endian integer
19a70 20 77 68 69 63 68 20 69 73 20 74 68 65 20 6e 75 which is the nu
19a80 6d 62 65 72 20 6f 66 20 76 61 6c 69 64 20 70 61 mber of valid pa
19a90 67 65 20 72 65 63 6f 72 64 73 0a 2a 2a 20 20 20 ge records.**
19aa0 20 20 20 20 69 6e 20 74 68 65 20 6a 6f 75 72 6e in the journ
19ab0 61 6c 2e 20 20 49 66 20 74 68 69 73 20 76 61 6c al. If this val
19ac0 75 65 20 69 73 20 30 78 66 66 66 66 66 66 66 66 ue is 0xffffffff
19ad0 2c 20 74 68 65 6e 20 63 6f 6d 70 75 74 65 20 74 , then compute t
19ae0 68 65 0a 2a 2a 20 20 20 20 20 20 20 6e 75 6d 62 he.** numb
19af0 65 72 20 6f 66 20 70 61 67 65 20 72 65 63 6f 72 er of page recor
19b00 64 73 20 66 72 6f 6d 20 74 68 65 20 6a 6f 75 72 ds from the jour
19b10 6e 61 6c 20 73 69 7a 65 2e 0a 2a 2a 20 20 28 33 nal size..** (3
19b20 29 20 20 34 20 62 79 74 65 20 62 69 67 2d 65 6e ) 4 byte big-en
19b30 64 69 61 6e 20 69 6e 74 65 67 65 72 20 77 68 69 dian integer whi
19b40 63 68 20 69 73 20 74 68 65 20 69 6e 69 74 69 61 ch is the initia
19b50 6c 20 76 61 6c 75 65 20 66 6f 72 20 74 68 65 20 l value for the
19b60 0a 2a 2a 20 20 20 20 20 20 20 73 61 6e 69 74 79 .** sanity
19b70 20 63 68 65 63 6b 73 75 6d 2e 0a 2a 2a 20 20 28 checksum..** (
19b80 34 29 20 20 34 20 62 79 74 65 20 69 6e 74 65 67 4) 4 byte integ
19b90 65 72 20 77 68 69 63 68 20 69 73 20 74 68 65 20 er which is the
19ba0 6e 75 6d 62 65 72 20 6f 66 20 70 61 67 65 73 20 number of pages
19bb0 74 6f 20 74 72 75 6e 63 61 74 65 20 74 68 65 0a to truncate the.
19bc0 2a 2a 20 20 20 20 20 20 20 64 61 74 61 62 61 73 ** databas
19bd0 65 20 74 6f 20 64 75 72 69 6e 67 20 61 20 72 6f e to during a ro
19be0 6c 6c 62 61 63 6b 2e 0a 2a 2a 20 20 28 35 29 20 llback..** (5)
19bf0 20 34 20 62 79 74 65 20 62 69 67 2d 65 6e 64 69 4 byte big-endi
19c00 61 6e 20 69 6e 74 65 67 65 72 20 77 68 69 63 68 an integer which
19c10 20 69 73 20 74 68 65 20 73 65 63 74 6f 72 20 73 is the sector s
19c20 69 7a 65 2e 20 20 54 68 65 20 68 65 61 64 65 72 ize. The header
19c30 0a 2a 2a 20 20 20 20 20 20 20 69 73 20 74 68 69 .** is thi
19c40 73 20 6d 61 6e 79 20 62 79 74 65 73 20 69 6e 20 s many bytes in
19c50 73 69 7a 65 2e 0a 2a 2a 20 20 28 36 29 20 20 34 size..** (6) 4
19c60 20 62 79 74 65 20 62 69 67 2d 65 6e 64 69 61 6e byte big-endian
19c70 20 69 6e 74 65 67 65 72 20 77 68 69 63 68 20 69 integer which i
19c80 73 20 74 68 65 20 70 61 67 65 20 73 69 7a 65 2e s the page size.
19c90 0a 2a 2a 20 20 28 37 29 20 20 7a 65 72 6f 20 70 .** (7) zero p
19ca0 61 64 64 69 6e 67 20 6f 75 74 20 74 6f 20 74 68 adding out to th
19cb0 65 20 6e 65 78 74 20 73 65 63 74 6f 72 20 73 69 e next sector si
19cc0 7a 65 2e 0a 2a 2a 20 20 28 38 29 20 20 5a 65 72 ze..** (8) Zer
19cd0 6f 20 6f 72 20 6d 6f 72 65 20 70 61 67 65 73 20 o or more pages
19ce0 69 6e 73 74 61 6e 63 65 73 2c 20 65 61 63 68 20 instances, each
19cf0 61 73 20 66 6f 6c 6c 6f 77 73 3a 0a 2a 2a 20 20 as follows:.**
19d00 20 20 20 20 20 20 2b 20 20 34 20 62 79 74 65 20 + 4 byte
19d10 70 61 67 65 20 6e 75 6d 62 65 72 2e 0a 2a 2a 20 page number..**
19d20 20 20 20 20 20 20 20 2b 20 20 70 50 61 67 65 72 + pPager
19d30 2d 3e 70 61 67 65 53 69 7a 65 20 62 79 74 65 73 ->pageSize bytes
19d40 20 6f 66 20 64 61 74 61 2e 0a 2a 2a 20 20 20 20 of data..**
19d50 20 20 20 20 2b 20 20 34 20 62 79 74 65 20 63 68 + 4 byte ch
19d60 65 63 6b 73 75 6d 0a 2a 2a 0a 2a 2a 20 57 68 65 ecksum.**.** Whe
19d70 6e 20 77 65 20 73 70 65 61 6b 20 6f 66 20 74 68 n we speak of th
19d80 65 20 6a 6f 75 72 6e 61 6c 20 68 65 61 64 65 72 e journal header
19d90 2c 20 77 65 20 6d 65 61 6e 20 74 68 65 20 66 69 , we mean the fi
19da0 72 73 74 20 37 20 69 74 65 6d 73 20 61 62 6f 76 rst 7 items abov
19db0 65 2e 0a 2a 2a 20 45 61 63 68 20 65 6e 74 72 79 e..** Each entry
19dc0 20 69 6e 20 74 68 65 20 6a 6f 75 72 6e 61 6c 20 in the journal
19dd0 69 73 20 61 6e 20 69 6e 73 74 61 6e 63 65 20 6f is an instance o
19de0 66 20 74 68 65 20 38 74 68 20 69 74 65 6d 2e 0a f the 8th item..
19df0 2a 2a 0a 2a 2a 20 43 61 6c 6c 20 74 68 65 20 76 **.** Call the v
19e00 61 6c 75 65 20 66 72 6f 6d 20 74 68 65 20 73 65 alue from the se
19e10 63 6f 6e 64 20 62 75 6c 6c 65 74 20 22 6e 52 65 cond bullet "nRe
19e20 63 22 2e 20 20 6e 52 65 63 20 69 73 20 74 68 65 c". nRec is the
19e30 20 6e 75 6d 62 65 72 20 6f 66 0a 2a 2a 20 76 61 number of.** va
19e40 6c 69 64 20 70 61 67 65 20 65 6e 74 72 69 65 73 lid page entries
19e50 20 69 6e 20 74 68 65 20 6a 6f 75 72 6e 61 6c 2e in the journal.
19e60 20 20 49 6e 20 6d 6f 73 74 20 63 61 73 65 73 2c In most cases,
19e70 20 79 6f 75 20 63 61 6e 20 63 6f 6d 70 75 74 65 you can compute
19e80 20 74 68 65 0a 2a 2a 20 76 61 6c 75 65 20 6f 66 the.** value of
19e90 20 6e 52 65 63 20 66 72 6f 6d 20 74 68 65 20 73 nRec from the s
19ea0 69 7a 65 20 6f 66 20 74 68 65 20 6a 6f 75 72 6e ize of the journ
19eb0 61 6c 20 66 69 6c 65 2e 20 20 42 75 74 20 69 66 al file. But if
19ec0 20 61 20 70 6f 77 65 72 0a 2a 2a 20 66 61 69 6c a power.** fail
19ed0 75 72 65 20 6f 63 63 75 72 72 65 64 20 77 68 69 ure occurred whi
19ee0 6c 65 20 74 68 65 20 6a 6f 75 72 6e 61 6c 20 77 le the journal w
19ef0 61 73 20 62 65 69 6e 67 20 77 72 69 74 74 65 6e as being written
19f00 2c 20 69 74 20 63 6f 75 6c 64 20 62 65 20 74 68 , it could be th
19f10 65 0a 2a 2a 20 63 61 73 65 20 74 68 61 74 20 74 e.** case that t
19f20 68 65 20 73 69 7a 65 20 6f 66 20 74 68 65 20 6a he size of the j
19f30 6f 75 72 6e 61 6c 20 66 69 6c 65 20 68 61 64 20 ournal file had
19f40 61 6c 72 65 61 64 79 20 62 65 65 6e 20 69 6e 63 already been inc
19f50 72 65 61 73 65 64 20 62 75 74 0a 2a 2a 20 74 68 reased but.** th
19f60 65 20 65 78 74 72 61 20 65 6e 74 72 69 65 73 20 e extra entries
19f70 68 61 64 20 6e 6f 74 20 79 65 74 20 6d 61 64 65 had not yet made
19f80 20 69 74 20 73 61 66 65 6c 79 20 74 6f 20 64 69 it safely to di
19f90 73 6b 2e 20 20 49 6e 20 73 75 63 68 20 61 20 63 sk. In such a c
19fa0 61 73 65 2c 0a 2a 2a 20 74 68 65 20 76 61 6c 75 ase,.** the valu
19fb0 65 20 6f 66 20 6e 52 65 63 20 63 6f 6d 70 75 74 e of nRec comput
19fc0 65 64 20 66 72 6f 6d 20 74 68 65 20 66 69 6c 65 ed from the file
19fd0 20 73 69 7a 65 20 77 6f 75 6c 64 20 62 65 20 74 size would be t
19fe0 6f 6f 20 6c 61 72 67 65 2e 20 20 46 6f 72 0a 2a oo large. For.*
19ff0 2a 20 74 68 61 74 20 72 65 61 73 6f 6e 2c 20 77 * that reason, w
1a000 65 20 61 6c 77 61 79 73 20 75 73 65 20 74 68 65 e always use the
1a010 20 6e 52 65 63 20 76 61 6c 75 65 20 69 6e 20 74 nRec value in t
1a020 68 65 20 68 65 61 64 65 72 2e 0a 2a 2a 0a 2a 2a he header..**.**
1a030 20 49 66 20 74 68 65 20 6e 52 65 63 20 76 61 6c If the nRec val
1a040 75 65 20 69 73 20 30 78 66 66 66 66 66 66 66 66 ue is 0xffffffff
1a050 20 69 74 20 6d 65 61 6e 73 20 74 68 61 74 20 6e it means that n
1a060 52 65 63 20 73 68 6f 75 6c 64 20 62 65 20 63 6f Rec should be co
1a070 6d 70 75 74 65 64 0a 2a 2a 20 66 72 6f 6d 20 74 mputed.** from t
1a080 68 65 20 66 69 6c 65 20 73 69 7a 65 2e 20 20 54 he file size. T
1a090 68 69 73 20 76 61 6c 75 65 20 69 73 20 75 73 65 his value is use
1a0a0 64 20 77 68 65 6e 20 74 68 65 20 75 73 65 72 20 d when the user
1a0b0 73 65 6c 65 63 74 73 20 74 68 65 0a 2a 2a 20 6e selects the.** n
1a0c0 6f 2d 73 79 6e 63 20 6f 70 74 69 6f 6e 20 66 6f o-sync option fo
1a0d0 72 20 74 68 65 20 6a 6f 75 72 6e 61 6c 2e 20 20 r the journal.
1a0e0 41 20 70 6f 77 65 72 20 66 61 69 6c 75 72 65 20 A power failure
1a0f0 63 6f 75 6c 64 20 6c 65 61 64 20 74 6f 20 63 6f could lead to co
1a100 72 72 75 70 74 69 6f 6e 0a 2a 2a 20 69 6e 20 74 rruption.** in t
1a110 68 69 73 20 63 61 73 65 2e 20 20 42 75 74 20 66 his case. But f
1a120 6f 72 20 74 68 69 6e 67 73 20 6c 69 6b 65 20 74 or things like t
1a130 65 6d 70 6f 72 61 72 79 20 74 61 62 6c 65 20 28 emporary table (
1a140 77 68 69 63 68 20 77 69 6c 6c 20 62 65 0a 2a 2a which will be.**
1a150 20 64 65 6c 65 74 65 64 20 77 68 65 6e 20 74 68 deleted when th
1a160 65 20 70 6f 77 65 72 20 69 73 20 72 65 73 74 6f e power is resto
1a170 72 65 64 29 20 77 65 20 64 6f 6e 27 74 20 63 61 red) we don't ca
1a180 72 65 2e 20 20 0a 2a 2a 0a 2a 2a 20 49 66 20 74 re. .**.** If t
1a190 68 65 20 66 69 6c 65 20 6f 70 65 6e 65 64 20 61 he file opened a
1a1a0 73 20 74 68 65 20 6a 6f 75 72 6e 61 6c 20 66 69 s the journal fi
1a1b0 6c 65 20 69 73 20 6e 6f 74 20 61 20 77 65 6c 6c le is not a well
1a1c0 2d 66 6f 72 6d 65 64 0a 2a 2a 20 6a 6f 75 72 6e -formed.** journ
1a1d0 61 6c 20 66 69 6c 65 20 74 68 65 6e 20 61 6c 6c al file then all
1a1e0 20 70 61 67 65 73 20 75 70 20 74 6f 20 74 68 65 pages up to the
1a1f0 20 66 69 72 73 74 20 63 6f 72 72 75 70 74 65 64 first corrupted
1a200 20 70 61 67 65 20 61 72 65 20 72 6f 6c 6c 65 64 page are rolled
1a210 0a 2a 2a 20 62 61 63 6b 20 28 6f 72 20 6e 6f 20 .** back (or no
1a220 70 61 67 65 73 20 69 66 20 74 68 65 20 6a 6f 75 pages if the jou
1a230 72 6e 61 6c 20 68 65 61 64 65 72 20 69 73 20 63 rnal header is c
1a240 6f 72 72 75 70 74 65 64 29 2e 20 54 68 65 20 6a orrupted). The j
1a250 6f 75 72 6e 61 6c 20 66 69 6c 65 0a 2a 2a 20 69 ournal file.** i
1a260 73 20 74 68 65 6e 20 64 65 6c 65 74 65 64 20 61 s then deleted a
1a270 6e 64 20 53 51 4c 49 54 45 5f 4f 4b 20 72 65 74 nd SQLITE_OK ret
1a280 75 72 6e 65 64 2c 20 6a 75 73 74 20 61 73 20 69 urned, just as i
1a290 66 20 6e 6f 20 63 6f 72 72 75 70 74 69 6f 6e 20 f no corruption
1a2a0 68 61 64 0a 2a 2a 20 62 65 65 6e 20 65 6e 63 6f had.** been enco
1a2b0 75 6e 74 65 72 65 64 2e 0a 2a 2a 0a 2a 2a 20 49 untered..**.** I
1a2c0 66 20 61 6e 20 49 2f 4f 20 6f 72 20 6d 61 6c 6c f an I/O or mall
1a2d0 6f 63 28 29 20 65 72 72 6f 72 20 6f 63 63 75 72 oc() error occur
1a2e0 73 2c 20 74 68 65 20 6a 6f 75 72 6e 61 6c 2d 66 s, the journal-f
1a2f0 69 6c 65 20 69 73 20 6e 6f 74 20 64 65 6c 65 74 ile is not delet
1a300 65 64 0a 2a 2a 20 61 6e 64 20 61 6e 20 65 72 72 ed.** and an err
1a310 6f 72 20 63 6f 64 65 20 69 73 20 72 65 74 75 72 or code is retur
1a320 6e 65 64 2e 0a 2a 2a 0a 2a 2a 20 54 68 65 20 69 ned..**.** The i
1a330 73 48 6f 74 20 70 61 72 61 6d 65 74 65 72 20 69 sHot parameter i
1a340 6e 64 69 63 61 74 65 73 20 74 68 61 74 20 77 65 ndicates that we
1a350 20 61 72 65 20 74 72 79 69 6e 67 20 74 6f 20 72 are trying to r
1a360 6f 6c 6c 62 61 63 6b 20 61 20 6a 6f 75 72 6e 61 ollback a journa
1a370 6c 0a 2a 2a 20 74 68 61 74 20 6d 69 67 68 74 20 l.** that might
1a380 62 65 20 61 20 68 6f 74 20 6a 6f 75 72 6e 61 6c be a hot journal
1a390 2e 20 20 4f 72 2c 20 69 74 20 63 6f 75 6c 64 20 . Or, it could
1a3a0 62 65 20 74 68 61 74 20 74 68 65 20 6a 6f 75 72 be that the jour
1a3b0 6e 61 6c 20 69 73 20 0a 2a 2a 20 70 72 65 73 65 nal is .** prese
1a3c0 72 76 65 64 20 62 65 63 61 75 73 65 20 6f 66 20 rved because of
1a3d0 4a 4f 55 52 4e 41 4c 4d 4f 44 45 5f 50 45 52 53 JOURNALMODE_PERS
1a3e0 49 53 54 20 6f 72 20 4a 4f 55 52 4e 41 4c 4d 4f IST or JOURNALMO
1a3f0 44 45 5f 54 52 55 4e 43 41 54 45 2e 0a 2a 2a 20 DE_TRUNCATE..**
1a400 49 66 20 74 68 65 20 6a 6f 75 72 6e 61 6c 20 72 If the journal r
1a410 65 61 6c 6c 79 20 69 73 20 68 6f 74 2c 20 72 65 eally is hot, re
1a420 73 65 74 20 74 68 65 20 70 61 67 65 72 20 63 61 set the pager ca
1a430 63 68 65 20 70 72 69 6f 72 20 72 6f 6c 6c 69 6e che prior rollin
1a440 67 0a 2a 2a 20 62 61 63 6b 20 61 6e 79 20 63 6f g.** back any co
1a450 6e 74 65 6e 74 2e 20 20 49 66 20 74 68 65 20 6a ntent. If the j
1a460 6f 75 72 6e 61 6c 20 69 73 20 6d 65 72 65 6c 79 ournal is merely
1a470 20 70 65 72 73 69 73 74 65 6e 74 2c 20 6e 6f 20 persistent, no
1a480 72 65 73 65 74 20 69 73 0a 2a 2a 20 6e 65 65 64 reset is.** need
1a490 65 64 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e ed..*/.static in
1a4a0 74 20 70 61 67 65 72 5f 70 6c 61 79 62 61 63 6b t pager_playback
1a4b0 28 50 61 67 65 72 20 2a 70 50 61 67 65 72 2c 20 (Pager *pPager,
1a4c0 69 6e 74 20 69 73 48 6f 74 29 7b 0a 20 20 73 71 int isHot){. sq
1a4d0 6c 69 74 65 33 5f 76 66 73 20 2a 70 56 66 73 20 lite3_vfs *pVfs
1a4e0 3d 20 70 50 61 67 65 72 2d 3e 70 56 66 73 3b 0a = pPager->pVfs;.
1a4f0 20 20 69 36 34 20 73 7a 4a 3b 20 20 20 20 20 20 i64 szJ;
1a500 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 53 69 /* Si
1a510 7a 65 20 6f 66 20 74 68 65 20 6a 6f 75 72 6e 61 ze of the journa
1a520 6c 20 66 69 6c 65 20 69 6e 20 62 79 74 65 73 20 l file in bytes
1a530 2a 2f 0a 20 20 75 33 32 20 6e 52 65 63 3b 20 20 */. u32 nRec;
1a540 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a /*
1a550 20 4e 75 6d 62 65 72 20 6f 66 20 52 65 63 6f 72 Number of Recor
1a560 64 73 20 69 6e 20 74 68 65 20 6a 6f 75 72 6e 61 ds in the journa
1a570 6c 20 2a 2f 0a 20 20 75 33 32 20 75 3b 20 20 20 l */. u32 u;
1a580 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
1a590 2f 2a 20 55 6e 73 69 67 6e 65 64 20 6c 6f 6f 70 /* Unsigned loop
1a5a0 20 63 6f 75 6e 74 65 72 20 2a 2f 0a 20 20 50 67 counter */. Pg
1a5b0 6e 6f 20 6d 78 50 67 20 3d 20 30 3b 20 20 20 20 no mxPg = 0;
1a5c0 20 20 20 20 20 20 20 2f 2a 20 53 69 7a 65 20 6f /* Size o
1a5d0 66 20 74 68 65 20 6f 72 69 67 69 6e 61 6c 20 66 f the original f
1a5e0 69 6c 65 20 69 6e 20 70 61 67 65 73 20 2a 2f 0a ile in pages */.
1a5f0 20 20 69 6e 74 20 72 63 3b 20 20 20 20 20 20 20 int rc;
1a600 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 52 65 /* Re
1a610 73 75 6c 74 20 63 6f 64 65 20 6f 66 20 61 20 73 sult code of a s
1a620 75 62 72 6f 75 74 69 6e 65 20 2a 2f 0a 20 20 69 ubroutine */. i
1a630 6e 74 20 72 65 73 20 3d 20 31 3b 20 20 20 20 20 nt res = 1;
1a640 20 20 20 20 20 20 20 20 2f 2a 20 56 61 6c 75 65 /* Value
1a650 20 72 65 74 75 72 6e 65 64 20 62 79 20 73 71 6c returned by sql
1a660 69 74 65 33 4f 73 41 63 63 65 73 73 28 29 20 2a ite3OsAccess() *
1a670 2f 0a 20 20 63 68 61 72 20 2a 7a 4d 61 73 74 65 /. char *zMaste
1a680 72 20 3d 20 30 3b 20 20 20 20 20 20 20 2f 2a 20 r = 0; /*
1a690 4e 61 6d 65 20 6f 66 20 6d 61 73 74 65 72 20 6a Name of master j
1a6a0 6f 75 72 6e 61 6c 20 66 69 6c 65 20 69 66 20 61 ournal file if a
1a6b0 6e 79 20 2a 2f 0a 20 20 69 6e 74 20 6e 65 65 64 ny */. int need
1a6c0 50 61 67 65 72 52 65 73 65 74 3b 20 20 20 20 20 PagerReset;
1a6d0 20 2f 2a 20 54 72 75 65 20 74 6f 20 72 65 73 65 /* True to rese
1a6e0 74 20 70 61 67 65 20 70 72 69 6f 72 20 74 6f 20 t page prior to
1a6f0 66 69 72 73 74 20 70 61 67 65 20 72 6f 6c 6c 62 first page rollb
1a700 61 63 6b 20 2a 2f 0a 0a 20 20 2f 2a 20 46 69 67 ack */.. /* Fig
1a710 75 72 65 20 6f 75 74 20 68 6f 77 20 6d 61 6e 79 ure out how many
1a720 20 72 65 63 6f 72 64 73 20 61 72 65 20 69 6e 20 records are in
1a730 74 68 65 20 6a 6f 75 72 6e 61 6c 2e 20 20 41 62 the journal. Ab
1a740 6f 72 74 20 65 61 72 6c 79 20 69 66 0a 20 20 2a ort early if. *
1a750 2a 20 74 68 65 20 6a 6f 75 72 6e 61 6c 20 69 73 * the journal is
1a760 20 65 6d 70 74 79 2e 0a 20 20 2a 2f 0a 20 20 61 empty.. */. a
1a770 73 73 65 72 74 28 20 69 73 4f 70 65 6e 28 70 50 ssert( isOpen(pP
1a780 61 67 65 72 2d 3e 6a 66 64 29 20 29 3b 0a 20 20 ager->jfd) );.
1a790 72 63 20 3d 20 73 71 6c 69 74 65 33 4f 73 46 69 rc = sqlite3OsFi
1a7a0 6c 65 53 69 7a 65 28 70 50 61 67 65 72 2d 3e 6a leSize(pPager->j
1a7b0 66 64 2c 20 26 73 7a 4a 29 3b 0a 20 20 69 66 28 fd, &szJ);. if(
1a7c0 20 72 63 21 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 rc!=SQLITE_OK )
1a7d0 7b 0a 20 20 20 20 67 6f 74 6f 20 65 6e 64 5f 70 {. goto end_p
1a7e0 6c 61 79 62 61 63 6b 3b 0a 20 20 7d 0a 0a 20 20 layback;. }..
1a7f0 2f 2a 20 52 65 61 64 20 74 68 65 20 6d 61 73 74 /* Read the mast
1a800 65 72 20 6a 6f 75 72 6e 61 6c 20 6e 61 6d 65 20 er journal name
1a810 66 72 6f 6d 20 74 68 65 20 6a 6f 75 72 6e 61 6c from the journal
1a820 2c 20 69 66 20 69 74 20 69 73 20 70 72 65 73 65 , if it is prese
1a830 6e 74 2e 0a 20 20 2a 2a 20 49 66 20 61 20 6d 61 nt.. ** If a ma
1a840 73 74 65 72 20 6a 6f 75 72 6e 61 6c 20 66 69 6c ster journal fil
1a850 65 20 6e 61 6d 65 20 69 73 20 73 70 65 63 69 66 e name is specif
1a860 69 65 64 2c 20 62 75 74 20 74 68 65 20 66 69 6c ied, but the fil
1a870 65 20 69 73 20 6e 6f 74 0a 20 20 2a 2a 20 70 72 e is not. ** pr
1a880 65 73 65 6e 74 20 6f 6e 20 64 69 73 6b 2c 20 74 esent on disk, t
1a890 68 65 6e 20 74 68 65 20 6a 6f 75 72 6e 61 6c 20 hen the journal
1a8a0 69 73 20 6e 6f 74 20 68 6f 74 20 61 6e 64 20 64 is not hot and d
1a8b0 6f 65 73 20 6e 6f 74 20 6e 65 65 64 20 74 6f 20 oes not need to
1a8c0 62 65 0a 20 20 2a 2a 20 70 6c 61 79 65 64 20 62 be. ** played b
1a8d0 61 63 6b 2e 0a 20 20 2a 2a 0a 20 20 2a 2a 20 54 ack.. **. ** T
1a8e0 4f 44 4f 3a 20 54 65 63 68 6e 69 63 61 6c 6c 79 ODO: Technically
1a8f0 20 74 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 69 the following i
1a900 73 20 61 6e 20 65 72 72 6f 72 20 62 65 63 61 75 s an error becau
1a910 73 65 20 69 74 20 61 73 73 75 6d 65 73 20 74 68 se it assumes th
1a920 61 74 0a 20 20 2a 2a 20 62 75 66 66 65 72 20 50 at. ** buffer P
1a930 61 67 65 72 2e 70 54 6d 70 53 70 61 63 65 20 69 ager.pTmpSpace i
1a940 73 20 28 6d 78 50 61 74 68 6e 61 6d 65 2b 31 29 s (mxPathname+1)
1a950 20 62 79 74 65 73 20 6f 72 20 6c 61 72 67 65 72 bytes or larger
1a960 2e 20 69 2e 65 2e 20 74 68 61 74 0a 20 20 2a 2a . i.e. that. **
1a970 20 28 70 50 61 67 65 72 2d 3e 70 61 67 65 53 69 (pPager->pageSi
1a980 7a 65 20 3e 3d 20 70 50 61 67 65 72 2d 3e 70 56 ze >= pPager->pV
1a990 66 73 2d 3e 6d 78 50 61 74 68 6e 61 6d 65 2b 31 fs->mxPathname+1
1a9a0 29 2e 20 55 73 69 6e 67 20 6f 73 5f 75 6e 69 78 ). Using os_unix
1a9b0 2e 63 2c 0a 20 20 2a 2a 20 20 6d 78 50 61 74 68 .c,. ** mxPath
1a9c0 6e 61 6d 65 20 69 73 20 35 31 32 2c 20 77 68 69 name is 512, whi
1a9d0 63 68 20 69 73 20 74 68 65 20 73 61 6d 65 20 61 ch is the same a
1a9e0 73 20 74 68 65 20 6d 69 6e 69 6d 75 6d 20 61 6c s the minimum al
1a9f0 6c 6f 77 61 62 6c 65 20 76 61 6c 75 65 0a 20 20 lowable value.
1aa00 2a 2a 20 66 6f 72 20 70 61 67 65 53 69 7a 65 2e ** for pageSize.
1aa10 0a 20 20 2a 2f 0a 20 20 7a 4d 61 73 74 65 72 20 . */. zMaster
1aa20 3d 20 70 50 61 67 65 72 2d 3e 70 54 6d 70 53 70 = pPager->pTmpSp
1aa30 61 63 65 3b 0a 20 20 72 63 20 3d 20 72 65 61 64 ace;. rc = read
1aa40 4d 61 73 74 65 72 4a 6f 75 72 6e 61 6c 28 70 50 MasterJournal(pP
1aa50 61 67 65 72 2d 3e 6a 66 64 2c 20 7a 4d 61 73 74 ager->jfd, zMast
1aa60 65 72 2c 20 70 50 61 67 65 72 2d 3e 70 56 66 73 er, pPager->pVfs
1aa70 2d 3e 6d 78 50 61 74 68 6e 61 6d 65 2b 31 29 3b ->mxPathname+1);
1aa80 0a 20 20 69 66 28 20 72 63 3d 3d 53 51 4c 49 54 . if( rc==SQLIT
1aa90 45 5f 4f 4b 20 26 26 20 7a 4d 61 73 74 65 72 5b E_OK && zMaster[
1aaa0 30 5d 20 29 7b 0a 20 20 20 20 72 63 20 3d 20 73 0] ){. rc = s
1aab0 71 6c 69 74 65 33 4f 73 41 63 63 65 73 73 28 70 qlite3OsAccess(p
1aac0 56 66 73 2c 20 7a 4d 61 73 74 65 72 2c 20 53 51 Vfs, zMaster, SQ
1aad0 4c 49 54 45 5f 41 43 43 45 53 53 5f 45 58 49 53 LITE_ACCESS_EXIS
1aae0 54 53 2c 20 26 72 65 73 29 3b 0a 20 20 7d 0a 20 TS, &res);. }.
1aaf0 20 7a 4d 61 73 74 65 72 20 3d 20 30 3b 0a 20 20 zMaster = 0;.
1ab00 69 66 28 20 72 63 21 3d 53 51 4c 49 54 45 5f 4f if( rc!=SQLITE_O
1ab10 4b 20 7c 7c 20 21 72 65 73 20 29 7b 0a 20 20 20 K || !res ){.
1ab20 20 67 6f 74 6f 20 65 6e 64 5f 70 6c 61 79 62 61 goto end_playba
1ab30 63 6b 3b 0a 20 20 7d 0a 20 20 70 50 61 67 65 72 ck;. }. pPager
1ab40 2d 3e 6a 6f 75 72 6e 61 6c 4f 66 66 20 3d 20 30 ->journalOff = 0
1ab50 3b 0a 20 20 6e 65 65 64 50 61 67 65 72 52 65 73 ;. needPagerRes
1ab60 65 74 20 3d 20 69 73 48 6f 74 3b 0a 0a 20 20 2f et = isHot;.. /
1ab70 2a 20 54 68 69 73 20 6c 6f 6f 70 20 74 65 72 6d * This loop term
1ab80 69 6e 61 74 65 73 20 65 69 74 68 65 72 20 77 68 inates either wh
1ab90 65 6e 20 61 20 72 65 61 64 4a 6f 75 72 6e 61 6c en a readJournal
1aba0 48 64 72 28 29 20 6f 72 20 0a 20 20 2a 2a 20 70 Hdr() or . ** p
1abb0 61 67 65 72 5f 70 6c 61 79 62 61 63 6b 5f 6f 6e ager_playback_on
1abc0 65 5f 70 61 67 65 28 29 20 63 61 6c 6c 20 72 65 e_page() call re
1abd0 74 75 72 6e 73 20 53 51 4c 49 54 45 5f 44 4f 4e turns SQLITE_DON
1abe0 45 20 6f 72 20 61 6e 20 49 4f 20 65 72 72 6f 72 E or an IO error
1abf0 20 0a 20 20 2a 2a 20 6f 63 63 75 72 73 2e 20 0a . ** occurs. .
1ac00 20 20 2a 2f 0a 20 20 77 68 69 6c 65 28 20 31 20 */. while( 1
1ac10 29 7b 0a 20 20 20 20 2f 2a 20 52 65 61 64 20 74 ){. /* Read t
1ac20 68 65 20 6e 65 78 74 20 6a 6f 75 72 6e 61 6c 20 he next journal
1ac30 68 65 61 64 65 72 20 66 72 6f 6d 20 74 68 65 20 header from the
1ac40 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 2e 20 20 49 journal file. I
1ac50 66 20 74 68 65 72 65 20 61 72 65 0a 20 20 20 20 f there are.
1ac60 2a 2a 20 6e 6f 74 20 65 6e 6f 75 67 68 20 62 79 ** not enough by
1ac70 74 65 73 20 6c 65 66 74 20 69 6e 20 74 68 65 20 tes left in the
1ac80 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 20 66 6f 72 journal file for
1ac90 20 61 20 63 6f 6d 70 6c 65 74 65 20 68 65 61 64 a complete head
1aca0 65 72 2c 20 6f 72 0a 20 20 20 20 2a 2a 20 69 74 er, or. ** it
1acb0 20 69 73 20 63 6f 72 72 75 70 74 65 64 2c 20 74 is corrupted, t
1acc0 68 65 6e 20 61 20 70 72 6f 63 65 73 73 20 6d 75 hen a process mu
1acd0 73 74 20 68 61 76 65 20 66 61 69 6c 65 64 20 77 st have failed w
1ace0 68 69 6c 65 20 77 72 69 74 69 6e 67 20 69 74 2e hile writing it.
1acf0 0a 20 20 20 20 2a 2a 20 54 68 69 73 20 69 6e 64 . ** This ind
1ad00 69 63 61 74 65 73 20 6e 6f 74 68 69 6e 67 20 6d icates nothing m
1ad10 6f 72 65 20 6e 65 65 64 73 20 74 6f 20 62 65 20 ore needs to be
1ad20 72 6f 6c 6c 65 64 20 62 61 63 6b 2e 0a 20 20 20 rolled back..
1ad30 20 2a 2f 0a 20 20 20 20 72 63 20 3d 20 72 65 61 */. rc = rea
1ad40 64 4a 6f 75 72 6e 61 6c 48 64 72 28 70 50 61 67 dJournalHdr(pPag
1ad50 65 72 2c 20 69 73 48 6f 74 2c 20 73 7a 4a 2c 20 er, isHot, szJ,
1ad60 26 6e 52 65 63 2c 20 26 6d 78 50 67 29 3b 0a 20 &nRec, &mxPg);.
1ad70 20 20 20 69 66 28 20 72 63 21 3d 53 51 4c 49 54 if( rc!=SQLIT
1ad80 45 5f 4f 4b 20 29 7b 20 0a 20 20 20 20 20 20 69 E_OK ){ . i
1ad90 66 28 20 72 63 3d 3d 53 51 4c 49 54 45 5f 44 4f f( rc==SQLITE_DO
1ada0 4e 45 20 29 7b 0a 20 20 20 20 20 20 20 20 72 63 NE ){. rc
1adb0 20 3d 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20 20 = SQLITE_OK;.
1adc0 20 20 20 20 7d 0a 20 20 20 20 20 20 67 6f 74 6f }. goto
1add0 20 65 6e 64 5f 70 6c 61 79 62 61 63 6b 3b 0a 20 end_playback;.
1ade0 20 20 20 7d 0a 0a 20 20 20 20 2f 2a 20 49 66 20 }.. /* If
1adf0 6e 52 65 63 20 69 73 20 30 78 66 66 66 66 66 66 nRec is 0xffffff
1ae00 66 66 2c 20 74 68 65 6e 20 74 68 69 73 20 6a 6f ff, then this jo
1ae10 75 72 6e 61 6c 20 77 61 73 20 63 72 65 61 74 65 urnal was create
1ae20 64 20 62 79 20 61 20 70 72 6f 63 65 73 73 0a 20 d by a process.
1ae30 20 20 20 2a 2a 20 77 6f 72 6b 69 6e 67 20 69 6e ** working in
1ae40 20 6e 6f 2d 73 79 6e 63 20 6d 6f 64 65 2e 20 54 no-sync mode. T
1ae50 68 69 73 20 6d 65 61 6e 73 20 74 68 61 74 20 74 his means that t
1ae60 68 65 20 72 65 73 74 20 6f 66 20 74 68 65 20 6a he rest of the j
1ae70 6f 75 72 6e 61 6c 0a 20 20 20 20 2a 2a 20 66 69 ournal. ** fi
1ae80 6c 65 20 63 6f 6e 73 69 73 74 73 20 6f 66 20 70 le consists of p
1ae90 61 67 65 73 2c 20 74 68 65 72 65 20 61 72 65 20 ages, there are
1aea0 6e 6f 20 6d 6f 72 65 20 6a 6f 75 72 6e 61 6c 20 no more journal
1aeb0 68 65 61 64 65 72 73 2e 20 43 6f 6d 70 75 74 65 headers. Compute
1aec0 0a 20 20 20 20 2a 2a 20 74 68 65 20 76 61 6c 75 . ** the valu
1aed0 65 20 6f 66 20 6e 52 65 63 20 62 61 73 65 64 20 e of nRec based
1aee0 6f 6e 20 74 68 69 73 20 61 73 73 75 6d 70 74 69 on this assumpti
1aef0 6f 6e 2e 0a 20 20 20 20 2a 2f 0a 20 20 20 20 69 on.. */. i
1af00 66 28 20 6e 52 65 63 3d 3d 30 78 66 66 66 66 66 f( nRec==0xfffff
1af10 66 66 66 20 29 7b 0a 20 20 20 20 20 20 61 73 73 fff ){. ass
1af20 65 72 74 28 20 70 50 61 67 65 72 2d 3e 6a 6f 75 ert( pPager->jou
1af30 72 6e 61 6c 4f 66 66 3d 3d 4a 4f 55 52 4e 41 4c rnalOff==JOURNAL
1af40 5f 48 44 52 5f 53 5a 28 70 50 61 67 65 72 29 20 _HDR_SZ(pPager)
1af50 29 3b 0a 20 20 20 20 20 20 6e 52 65 63 20 3d 20 );. nRec =
1af60 28 69 6e 74 29 28 28 73 7a 4a 20 2d 20 4a 4f 55 (int)((szJ - JOU
1af70 52 4e 41 4c 5f 48 44 52 5f 53 5a 28 70 50 61 67 RNAL_HDR_SZ(pPag
1af80 65 72 29 29 2f 4a 4f 55 52 4e 41 4c 5f 50 47 5f er))/JOURNAL_PG_
1af90 53 5a 28 70 50 61 67 65 72 29 29 3b 0a 20 20 20 SZ(pPager));.
1afa0 20 7d 0a 0a 20 20 20 20 2f 2a 20 49 66 20 6e 52 }.. /* If nR
1afb0 65 63 20 69 73 20 30 20 61 6e 64 20 74 68 69 73 ec is 0 and this
1afc0 20 72 6f 6c 6c 62 61 63 6b 20 69 73 20 6f 66 20 rollback is of
1afd0 61 20 74 72 61 6e 73 61 63 74 69 6f 6e 20 63 72 a transaction cr
1afe0 65 61 74 65 64 20 62 79 20 74 68 69 73 0a 20 20 eated by this.
1aff0 20 20 2a 2a 20 70 72 6f 63 65 73 73 20 61 6e 64 ** process and
1b000 20 69 66 20 74 68 69 73 20 69 73 20 74 68 65 20 if this is the
1b010 66 69 6e 61 6c 20 68 65 61 64 65 72 20 69 6e 20 final header in
1b020 74 68 65 20 6a 6f 75 72 6e 61 6c 2c 20 74 68 65 the journal, the
1b030 6e 20 69 74 20 6d 65 61 6e 73 0a 20 20 20 20 2a n it means. *
1b040 2a 20 74 68 61 74 20 74 68 69 73 20 70 61 72 74 * that this part
1b050 20 6f 66 20 74 68 65 20 6a 6f 75 72 6e 61 6c 20 of the journal
1b060 77 61 73 20 62 65 69 6e 67 20 66 69 6c 6c 65 64 was being filled
1b070 20 62 75 74 20 68 61 73 20 6e 6f 74 20 79 65 74 but has not yet
1b080 20 62 65 65 6e 0a 20 20 20 20 2a 2a 20 73 79 6e been. ** syn
1b090 63 65 64 20 74 6f 20 64 69 73 6b 2e 20 20 43 6f ced to disk. Co
1b0a0 6d 70 75 74 65 20 74 68 65 20 6e 75 6d 62 65 72 mpute the number
1b0b0 20 6f 66 20 70 61 67 65 73 20 62 61 73 65 64 20 of pages based
1b0c0 6f 6e 20 74 68 65 20 72 65 6d 61 69 6e 69 6e 67 on the remaining
1b0d0 0a 20 20 20 20 2a 2a 20 73 69 7a 65 20 6f 66 20 . ** size of
1b0e0 74 68 65 20 66 69 6c 65 2e 0a 20 20 20 20 2a 2a the file.. **
1b0f0 0a 20 20 20 20 2a 2a 20 54 68 65 20 74 68 69 72 . ** The thir
1b100 64 20 74 65 72 6d 20 6f 66 20 74 68 65 20 74 65 d term of the te
1b110 73 74 20 77 61 73 20 61 64 64 65 64 20 74 6f 20 st was added to
1b120 66 69 78 20 74 69 63 6b 65 74 20 23 32 35 36 35 fix ticket #2565
1b130 2e 0a 20 20 20 20 2a 2a 20 57 68 65 6e 20 72 6f .. ** When ro
1b140 6c 6c 69 6e 67 20 62 61 63 6b 20 61 20 68 6f 74 lling back a hot
1b150 20 6a 6f 75 72 6e 61 6c 2c 20 6e 52 65 63 3d 3d journal, nRec==
1b160 30 20 61 6c 77 61 79 73 20 6d 65 61 6e 73 20 74 0 always means t
1b170 68 61 74 20 74 68 65 20 6e 65 78 74 0a 20 20 20 hat the next.
1b180 20 2a 2a 20 63 68 75 6e 6b 20 6f 66 20 74 68 65 ** chunk of the
1b190 20 6a 6f 75 72 6e 61 6c 20 63 6f 6e 74 61 69 6e journal contain
1b1a0 73 20 7a 65 72 6f 20 70 61 67 65 73 20 74 6f 20 s zero pages to
1b1b0 62 65 20 72 6f 6c 6c 65 64 20 62 61 63 6b 2e 20 be rolled back.
1b1c0 20 42 75 74 0a 20 20 20 20 2a 2a 20 77 68 65 6e But. ** when
1b1d0 20 64 6f 69 6e 67 20 61 20 52 4f 4c 4c 42 41 43 doing a ROLLBAC
1b1e0 4b 20 61 6e 64 20 74 68 65 20 6e 52 65 63 3d 3d K and the nRec==
1b1f0 30 20 63 68 75 6e 6b 20 69 73 20 74 68 65 20 6c 0 chunk is the l
1b200 61 73 74 20 63 68 75 6e 6b 20 69 6e 0a 20 20 20 ast chunk in.
1b210 20 2a 2a 20 74 68 65 20 6a 6f 75 72 6e 61 6c 2c ** the journal,
1b220 20 69 74 20 6d 65 61 6e 73 20 74 68 61 74 20 74 it means that t
1b230 68 65 20 6a 6f 75 72 6e 61 6c 20 6d 69 67 68 74 he journal might
1b240 20 63 6f 6e 74 61 69 6e 20 61 64 64 69 74 69 6f contain additio
1b250 6e 61 6c 0a 20 20 20 20 2a 2a 20 70 61 67 65 73 nal. ** pages
1b260 20 74 68 61 74 20 6e 65 65 64 20 74 6f 20 62 65 that need to be
1b270 20 72 6f 6c 6c 65 64 20 62 61 63 6b 20 61 6e 64 rolled back and
1b280 20 74 68 61 74 20 74 68 65 20 6e 75 6d 62 65 72 that the number
1b290 20 6f 66 20 70 61 67 65 73 20 0a 20 20 20 20 2a of pages . *
1b2a0 2a 20 73 68 6f 75 6c 64 20 62 65 20 63 6f 6d 70 * should be comp
1b2b0 75 74 65 64 20 62 61 73 65 64 20 6f 6e 20 74 68 uted based on th
1b2c0 65 20 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 20 73 e journal file s
1b2d0 69 7a 65 2e 0a 20 20 20 20 2a 2f 0a 20 20 20 20 ize.. */.
1b2e0 69 66 28 20 6e 52 65 63 3d 3d 30 20 26 26 20 21 if( nRec==0 && !
1b2f0 69 73 48 6f 74 20 26 26 0a 20 20 20 20 20 20 20 isHot &&.
1b300 20 70 50 61 67 65 72 2d 3e 6a 6f 75 72 6e 61 6c pPager->journal
1b310 48 64 72 2b 4a 4f 55 52 4e 41 4c 5f 48 44 52 5f Hdr+JOURNAL_HDR_
1b320 53 5a 28 70 50 61 67 65 72 29 3d 3d 70 50 61 67 SZ(pPager)==pPag
1b330 65 72 2d 3e 6a 6f 75 72 6e 61 6c 4f 66 66 20 29 er->journalOff )
1b340 7b 0a 20 20 20 20 20 20 6e 52 65 63 20 3d 20 28 {. nRec = (
1b350 69 6e 74 29 28 28 73 7a 4a 20 2d 20 70 50 61 67 int)((szJ - pPag
1b360 65 72 2d 3e 6a 6f 75 72 6e 61 6c 4f 66 66 29 20 er->journalOff)
1b370 2f 20 4a 4f 55 52 4e 41 4c 5f 50 47 5f 53 5a 28 / JOURNAL_PG_SZ(
1b380 70 50 61 67 65 72 29 29 3b 0a 20 20 20 20 7d 0a pPager));. }.
1b390 0a 20 20 20 20 2f 2a 20 49 66 20 74 68 69 73 20 . /* If this
1b3a0 69 73 20 74 68 65 20 66 69 72 73 74 20 68 65 61 is the first hea
1b3b0 64 65 72 20 72 65 61 64 20 66 72 6f 6d 20 74 68 der read from th
1b3c0 65 20 6a 6f 75 72 6e 61 6c 2c 20 74 72 75 6e 63 e journal, trunc
1b3d0 61 74 65 20 74 68 65 0a 20 20 20 20 2a 2a 20 64 ate the. ** d
1b3e0 61 74 61 62 61 73 65 20 66 69 6c 65 20 62 61 63 atabase file bac
1b3f0 6b 20 74 6f 20 69 74 73 20 6f 72 69 67 69 6e 61 k to its origina
1b400 6c 20 73 69 7a 65 2e 0a 20 20 20 20 2a 2f 0a 20 l size.. */.
1b410 20 20 20 69 66 28 20 70 50 61 67 65 72 2d 3e 6a if( pPager->j
1b420 6f 75 72 6e 61 6c 4f 66 66 3d 3d 4a 4f 55 52 4e ournalOff==JOURN
1b430 41 4c 5f 48 44 52 5f 53 5a 28 70 50 61 67 65 72 AL_HDR_SZ(pPager
1b440 29 20 29 7b 0a 20 20 20 20 20 20 72 63 20 3d 20 ) ){. rc =
1b450 70 61 67 65 72 5f 74 72 75 6e 63 61 74 65 28 70 pager_truncate(p
1b460 50 61 67 65 72 2c 20 6d 78 50 67 29 3b 0a 20 20 Pager, mxPg);.
1b470 20 20 20 20 69 66 28 20 72 63 21 3d 53 51 4c 49 if( rc!=SQLI
1b480 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 20 20 20 TE_OK ){.
1b490 20 67 6f 74 6f 20 65 6e 64 5f 70 6c 61 79 62 61 goto end_playba
1b4a0 63 6b 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 ck;. }.
1b4b0 20 20 70 50 61 67 65 72 2d 3e 64 62 53 69 7a 65 pPager->dbSize
1b4c0 20 3d 20 6d 78 50 67 3b 0a 20 20 20 20 7d 0a 0a = mxPg;. }..
1b4d0 20 20 20 20 2f 2a 20 43 6f 70 79 20 6f 72 69 67 /* Copy orig
1b4e0 69 6e 61 6c 20 70 61 67 65 73 20 6f 75 74 20 6f inal pages out o
1b4f0 66 20 74 68 65 20 6a 6f 75 72 6e 61 6c 20 61 6e f the journal an
1b500 64 20 62 61 63 6b 20 69 6e 74 6f 20 74 68 65 20 d back into the
1b510 0a 20 20 20 20 2a 2a 20 64 61 74 61 62 61 73 65 . ** database
1b520 20 66 69 6c 65 20 61 6e 64 2f 6f 72 20 70 61 67 file and/or pag
1b530 65 20 63 61 63 68 65 2e 0a 20 20 20 20 2a 2f 0a e cache.. */.
1b540 20 20 20 20 66 6f 72 28 75 3d 30 3b 20 75 3c 6e for(u=0; u<n
1b550 52 65 63 3b 20 75 2b 2b 29 7b 0a 20 20 20 20 20 Rec; u++){.
1b560 20 69 66 28 20 6e 65 65 64 50 61 67 65 72 52 65 if( needPagerRe
1b570 73 65 74 20 29 7b 0a 20 20 20 20 20 20 20 20 70 set ){. p
1b580 61 67 65 72 5f 72 65 73 65 74 28 70 50 61 67 65 ager_reset(pPage
1b590 72 29 3b 0a 20 20 20 20 20 20 20 20 6e 65 65 64 r);. need
1b5a0 50 61 67 65 72 52 65 73 65 74 20 3d 20 30 3b 0a PagerReset = 0;.
1b5b0 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 72 63 }. rc
1b5c0 20 3d 20 70 61 67 65 72 5f 70 6c 61 79 62 61 63 = pager_playbac
1b5d0 6b 5f 6f 6e 65 5f 70 61 67 65 28 70 50 61 67 65 k_one_page(pPage
1b5e0 72 2c 26 70 50 61 67 65 72 2d 3e 6a 6f 75 72 6e r,&pPager->journ
1b5f0 61 6c 4f 66 66 2c 30 2c 31 2c 30 29 3b 0a 20 20 alOff,0,1,0);.
1b600 20 20 20 20 69 66 28 20 72 63 21 3d 53 51 4c 49 if( rc!=SQLI
1b610 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 20 20 20 TE_OK ){.
1b620 20 69 66 28 20 72 63 3d 3d 53 51 4c 49 54 45 5f if( rc==SQLITE_
1b630 44 4f 4e 45 20 29 7b 0a 20 20 20 20 20 20 20 20 DONE ){.
1b640 20 20 72 63 20 3d 20 53 51 4c 49 54 45 5f 4f 4b rc = SQLITE_OK
1b650 3b 0a 20 20 20 20 20 20 20 20 20 20 70 50 61 67 ;. pPag
1b660 65 72 2d 3e 6a 6f 75 72 6e 61 6c 4f 66 66 20 3d er->journalOff =
1b670 20 73 7a 4a 3b 0a 20 20 20 20 20 20 20 20 20 20 szJ;.
1b680 62 72 65 61 6b 3b 0a 20 20 20 20 20 20 20 20 7d break;. }
1b690 65 6c 73 65 20 69 66 28 20 72 63 3d 3d 53 51 4c else if( rc==SQL
1b6a0 49 54 45 5f 49 4f 45 52 52 5f 53 48 4f 52 54 5f ITE_IOERR_SHORT_
1b6b0 52 45 41 44 20 29 7b 0a 20 20 20 20 20 20 20 20 READ ){.
1b6c0 20 20 2f 2a 20 49 66 20 74 68 65 20 6a 6f 75 72 /* If the jour
1b6d0 6e 61 6c 20 68 61 73 20 62 65 65 6e 20 74 72 75 nal has been tru
1b6e0 6e 63 61 74 65 64 2c 20 73 69 6d 70 6c 79 20 73 ncated, simply s
1b6f0 74 6f 70 20 72 65 61 64 69 6e 67 20 61 6e 64 0a top reading and.
1b700 20 20 20 20 20 20 20 20 20 20 2a 2a 20 70 72 6f ** pro
1b710 63 65 73 73 69 6e 67 20 74 68 65 20 6a 6f 75 72 cessing the jour
1b720 6e 61 6c 2e 20 54 68 69 73 20 6d 69 67 68 74 20 nal. This might
1b730 68 61 70 70 65 6e 20 69 66 20 74 68 65 20 6a 6f happen if the jo
1b740 75 72 6e 61 6c 20 77 61 73 0a 20 20 20 20 20 20 urnal was.
1b750 20 20 20 20 2a 2a 20 6e 6f 74 20 63 6f 6d 70 6c ** not compl
1b760 65 74 65 6c 79 20 77 72 69 74 74 65 6e 20 61 6e etely written an
1b770 64 20 73 79 6e 63 65 64 20 70 72 69 6f 72 20 74 d synced prior t
1b780 6f 20 61 20 63 72 61 73 68 2e 20 20 49 6e 20 74 o a crash. In t
1b790 68 61 74 0a 20 20 20 20 20 20 20 20 20 20 2a 2a hat. **
1b7a0 20 63 61 73 65 2c 20 74 68 65 20 64 61 74 61 62 case, the datab
1b7b0 61 73 65 20 73 68 6f 75 6c 64 20 68 61 76 65 20 ase should have
1b7c0 6e 65 76 65 72 20 62 65 65 6e 20 77 72 69 74 74 never been writt
1b7d0 65 6e 20 69 6e 20 74 68 65 0a 20 20 20 20 20 20 en in the.
1b7e0 20 20 20 20 2a 2a 20 66 69 72 73 74 20 70 6c 61 ** first pla
1b7f0 63 65 20 73 6f 20 69 74 20 69 73 20 4f 4b 20 74 ce so it is OK t
1b800 6f 20 73 69 6d 70 6c 79 20 61 62 61 6e 64 6f 6e o simply abandon
1b810 20 74 68 65 20 72 6f 6c 6c 62 61 63 6b 2e 20 2a the rollback. *
1b820 2f 0a 20 20 20 20 20 20 20 20 20 20 72 63 20 3d /. rc =
1b830 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20 20 20 20 SQLITE_OK;.
1b840 20 20 20 20 20 20 67 6f 74 6f 20 65 6e 64 5f 70 goto end_p
1b850 6c 61 79 62 61 63 6b 3b 0a 20 20 20 20 20 20 20 layback;.
1b860 20 7d 65 6c 73 65 7b 0a 20 20 20 20 20 20 20 20 }else{.
1b870 20 20 2f 2a 20 49 66 20 77 65 20 61 72 65 20 75 /* If we are u
1b880 6e 61 62 6c 65 20 74 6f 20 72 6f 6c 6c 62 61 63 nable to rollbac
1b890 6b 2c 20 71 75 69 74 20 61 6e 64 20 72 65 74 75 k, quit and retu
1b8a0 72 6e 20 74 68 65 20 65 72 72 6f 72 0a 20 20 20 rn the error.
1b8b0 20 20 20 20 20 20 20 2a 2a 20 63 6f 64 65 2e 20 ** code.
1b8c0 20 54 68 69 73 20 77 69 6c 6c 20 63 61 75 73 65 This will cause
1b8d0 20 74 68 65 20 70 61 67 65 72 20 74 6f 20 65 6e the pager to en
1b8e0 74 65 72 20 74 68 65 20 65 72 72 6f 72 20 73 74 ter the error st
1b8f0 61 74 65 0a 20 20 20 20 20 20 20 20 20 20 2a 2a ate. **
1b900 20 73 6f 20 74 68 61 74 20 6e 6f 20 66 75 72 74 so that no furt
1b910 68 65 72 20 68 61 72 6d 20 77 69 6c 6c 20 62 65 her harm will be
1b920 20 64 6f 6e 65 2e 20 20 50 65 72 68 61 70 73 20 done. Perhaps
1b930 74 68 65 20 6e 65 78 74 0a 20 20 20 20 20 20 20 the next.
1b940 20 20 20 2a 2a 20 70 72 6f 63 65 73 73 20 74 6f ** process to
1b950 20 63 6f 6d 65 20 61 6c 6f 6e 67 20 77 69 6c 6c come along will
1b960 20 62 65 20 61 62 6c 65 20 74 6f 20 72 6f 6c 6c be able to roll
1b970 62 61 63 6b 20 74 68 65 20 64 61 74 61 62 61 73 back the databas
1b980 65 2e 0a 20 20 20 20 20 20 20 20 20 20 2a 2f 0a e.. */.
1b990 20 20 20 20 20 20 20 20 20 20 67 6f 74 6f 20 65 goto e
1b9a0 6e 64 5f 70 6c 61 79 62 61 63 6b 3b 0a 20 20 20 nd_playback;.
1b9b0 20 20 20 20 20 7d 0a 20 20 20 20 20 20 7d 0a 20 }. }.
1b9c0 20 20 20 7d 0a 20 20 7d 0a 20 20 2f 2a 4e 4f 54 }. }. /*NOT
1b9d0 52 45 41 43 48 45 44 2a 2f 0a 20 20 61 73 73 65 REACHED*/. asse
1b9e0 72 74 28 20 30 20 29 3b 0a 0a 65 6e 64 5f 70 6c rt( 0 );..end_pl
1b9f0 61 79 62 61 63 6b 3a 0a 20 20 2f 2a 20 46 6f 6c ayback:. /* Fol
1ba00 6c 6f 77 69 6e 67 20 61 20 72 6f 6c 6c 62 61 63 lowing a rollbac
1ba10 6b 2c 20 74 68 65 20 64 61 74 61 62 61 73 65 20 k, the database
1ba20 66 69 6c 65 20 73 68 6f 75 6c 64 20 62 65 20 62 file should be b
1ba30 61 63 6b 20 69 6e 20 69 74 73 20 6f 72 69 67 69 ack in its origi
1ba40 6e 61 6c 0a 20 20 2a 2a 20 73 74 61 74 65 20 70 nal. ** state p
1ba50 72 69 6f 72 20 74 6f 20 74 68 65 20 73 74 61 72 rior to the star
1ba60 74 20 6f 66 20 74 68 65 20 74 72 61 6e 73 61 63 t of the transac
1ba70 74 69 6f 6e 2c 20 73 6f 20 69 6e 76 6f 6b 65 20 tion, so invoke
1ba80 74 68 65 0a 20 20 2a 2a 20 53 51 4c 49 54 45 5f the. ** SQLITE_
1ba90 46 43 4e 54 4c 5f 44 42 5f 55 4e 43 48 41 4e 47 FCNTL_DB_UNCHANG
1baa0 45 44 20 66 69 6c 65 2d 63 6f 6e 74 72 6f 6c 20 ED file-control
1bab0 6d 65 74 68 6f 64 20 74 6f 20 64 69 73 61 62 6c method to disabl
1bac0 65 20 74 68 65 0a 20 20 2a 2a 20 61 73 73 65 72 e the. ** asser
1bad0 74 69 6f 6e 20 74 68 61 74 20 74 68 65 20 74 72 tion that the tr
1bae0 61 6e 73 61 63 74 69 6f 6e 20 63 6f 75 6e 74 65 ansaction counte
1baf0 72 20 77 61 73 20 6d 6f 64 69 66 69 65 64 2e 0a r was modified..
1bb00 20 20 2a 2f 0a 20 20 61 73 73 65 72 74 28 0a 20 */. assert(.
1bb10 20 20 20 70 50 61 67 65 72 2d 3e 66 64 2d 3e 70 pPager->fd->p
1bb20 4d 65 74 68 6f 64 73 3d 3d 30 20 7c 7c 0a 20 20 Methods==0 ||.
1bb30 20 20 73 71 6c 69 74 65 33 4f 73 46 69 6c 65 43 sqlite3OsFileC
1bb40 6f 6e 74 72 6f 6c 28 70 50 61 67 65 72 2d 3e 66 ontrol(pPager->f
1bb50 64 2c 53 51 4c 49 54 45 5f 46 43 4e 54 4c 5f 44 d,SQLITE_FCNTL_D
1bb60 42 5f 55 4e 43 48 41 4e 47 45 44 2c 30 29 3e 3d B_UNCHANGED,0)>=
1bb70 53 51 4c 49 54 45 5f 4f 4b 0a 20 20 29 3b 0a 0a SQLITE_OK. );..
1bb80 20 20 2f 2a 20 49 66 20 74 68 69 73 20 70 6c 61 /* If this pla
1bb90 79 62 61 63 6b 20 69 73 20 68 61 70 70 65 6e 69 yback is happeni
1bba0 6e 67 20 61 75 74 6f 6d 61 74 69 63 61 6c 6c 79 ng automatically
1bbb0 20 61 73 20 61 20 72 65 73 75 6c 74 20 6f 66 20 as a result of
1bbc0 61 6e 20 49 4f 20 6f 72 20 0a 20 20 2a 2a 20 6d an IO or . ** m
1bbd0 61 6c 6c 6f 63 20 65 72 72 6f 72 20 74 68 61 74 alloc error that
1bbe0 20 6f 63 63 75 72 72 65 64 20 61 66 74 65 72 20 occurred after
1bbf0 74 68 65 20 63 68 61 6e 67 65 2d 63 6f 75 6e 74 the change-count
1bc00 65 72 20 77 61 73 20 75 70 64 61 74 65 64 20 62 er was updated b
1bc10 75 74 20 0a 20 20 2a 2a 20 62 65 66 6f 72 65 20 ut . ** before
1bc20 74 68 65 20 74 72 61 6e 73 61 63 74 69 6f 6e 20 the transaction
1bc30 77 61 73 20 63 6f 6d 6d 69 74 74 65 64 2c 20 74 was committed, t
1bc40 68 65 6e 20 74 68 65 20 63 68 61 6e 67 65 2d 63 hen the change-c
1bc50 6f 75 6e 74 65 72 20 0a 20 20 2a 2a 20 6d 6f 64 ounter . ** mod
1bc60 69 66 69 63 61 74 69 6f 6e 20 6d 61 79 20 6a 75 ification may ju
1bc70 73 74 20 68 61 76 65 20 62 65 65 6e 20 72 65 76 st have been rev
1bc80 65 72 74 65 64 2e 20 49 66 20 74 68 69 73 20 68 erted. If this h
1bc90 61 70 70 65 6e 73 20 69 6e 20 65 78 63 6c 75 73 appens in exclus
1bca0 69 76 65 20 0a 20 20 2a 2a 20 6d 6f 64 65 2c 20 ive . ** mode,
1bcb0 74 68 65 6e 20 73 75 62 73 65 71 75 65 6e 74 20 then subsequent
1bcc0 74 72 61 6e 73 61 63 74 69 6f 6e 73 20 70 65 72 transactions per
1bcd0 66 6f 72 6d 65 64 20 62 79 20 74 68 65 20 63 6f formed by the co
1bce0 6e 6e 65 63 74 69 6f 6e 20 77 69 6c 6c 20 6e 6f nnection will no
1bcf0 74 0a 20 20 2a 2a 20 75 70 64 61 74 65 20 74 68 t. ** update th
1bd00 65 20 63 68 61 6e 67 65 2d 63 6f 75 6e 74 65 72 e change-counter
1bd10 20 61 74 20 61 6c 6c 2e 20 54 68 69 73 20 6d 61 at all. This ma
1bd20 79 20 6c 65 61 64 20 74 6f 20 63 61 63 68 65 20 y lead to cache
1bd30 69 6e 63 6f 6e 73 69 73 74 65 6e 63 79 0a 20 20 inconsistency.
1bd40 2a 2a 20 70 72 6f 62 6c 65 6d 73 20 66 6f 72 20 ** problems for
1bd50 6f 74 68 65 72 20 70 72 6f 63 65 73 73 65 73 20 other processes
1bd60 61 74 20 73 6f 6d 65 20 70 6f 69 6e 74 20 69 6e at some point in
1bd70 20 74 68 65 20 66 75 74 75 72 65 2e 20 53 6f 2c the future. So,
1bd80 20 6a 75 73 74 0a 20 20 2a 2a 20 69 6e 20 63 61 just. ** in ca
1bd90 73 65 20 74 68 69 73 20 68 61 73 20 68 61 70 70 se this has happ
1bda0 65 6e 65 64 2c 20 63 6c 65 61 72 20 74 68 65 20 ened, clear the
1bdb0 63 68 61 6e 67 65 43 6f 75 6e 74 44 6f 6e 65 20 changeCountDone
1bdc0 66 6c 61 67 20 6e 6f 77 2e 0a 20 20 2a 2f 0a 20 flag now.. */.
1bdd0 20 70 50 61 67 65 72 2d 3e 63 68 61 6e 67 65 43 pPager->changeC
1bde0 6f 75 6e 74 44 6f 6e 65 20 3d 20 70 50 61 67 65 ountDone = pPage
1bdf0 72 2d 3e 74 65 6d 70 46 69 6c 65 3b 0a 0a 20 20 r->tempFile;..
1be00 69 66 28 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4f if( rc==SQLITE_O
1be10 4b 20 29 7b 0a 20 20 20 20 7a 4d 61 73 74 65 72 K ){. zMaster
1be20 20 3d 20 70 50 61 67 65 72 2d 3e 70 54 6d 70 53 = pPager->pTmpS
1be30 70 61 63 65 3b 0a 20 20 20 20 72 63 20 3d 20 72 pace;. rc = r
1be40 65 61 64 4d 61 73 74 65 72 4a 6f 75 72 6e 61 6c eadMasterJournal
1be50 28 70 50 61 67 65 72 2d 3e 6a 66 64 2c 20 7a 4d (pPager->jfd, zM
1be60 61 73 74 65 72 2c 20 70 50 61 67 65 72 2d 3e 70 aster, pPager->p
1be70 56 66 73 2d 3e 6d 78 50 61 74 68 6e 61 6d 65 2b Vfs->mxPathname+
1be80 31 29 3b 0a 20 20 20 20 74 65 73 74 63 61 73 65 1);. testcase
1be90 28 20 72 63 21 3d 53 51 4c 49 54 45 5f 4f 4b 20 ( rc!=SQLITE_OK
1bea0 29 3b 0a 20 20 7d 0a 20 20 69 66 28 20 72 63 3d );. }. if( rc=
1beb0 3d 53 51 4c 49 54 45 5f 4f 4b 0a 20 20 20 26 26 =SQLITE_OK. &&
1bec0 20 28 70 50 61 67 65 72 2d 3e 65 53 74 61 74 65 (pPager->eState
1bed0 3e 3d 50 41 47 45 52 5f 57 52 49 54 45 52 5f 44 >=PAGER_WRITER_D
1bee0 42 4d 4f 44 20 7c 7c 20 70 50 61 67 65 72 2d 3e BMOD || pPager->
1bef0 65 53 74 61 74 65 3d 3d 50 41 47 45 52 5f 4f 50 eState==PAGER_OP
1bf00 45 4e 29 0a 20 20 29 7b 0a 20 20 20 20 72 63 20 EN). ){. rc
1bf10 3d 20 73 71 6c 69 74 65 33 50 61 67 65 72 53 79 = sqlite3PagerSy
1bf20 6e 63 28 70 50 61 67 65 72 29 3b 0a 20 20 7d 0a nc(pPager);. }.
1bf30 20 20 69 66 28 20 72 63 3d 3d 53 51 4c 49 54 45 if( rc==SQLITE
1bf40 5f 4f 4b 20 29 7b 0a 20 20 20 20 72 63 20 3d 20 _OK ){. rc =
1bf50 70 61 67 65 72 5f 65 6e 64 5f 74 72 61 6e 73 61 pager_end_transa
1bf60 63 74 69 6f 6e 28 70 50 61 67 65 72 2c 20 7a 4d ction(pPager, zM
1bf70 61 73 74 65 72 5b 30 5d 21 3d 27 5c 30 27 29 3b aster[0]!='\0');
1bf80 0a 20 20 20 20 74 65 73 74 63 61 73 65 28 20 72 . testcase( r
1bf90 63 21 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 3b 0a c!=SQLITE_OK );.
1bfa0 20 20 7d 0a 20 20 69 66 28 20 72 63 3d 3d 53 51 }. if( rc==SQ
1bfb0 4c 49 54 45 5f 4f 4b 20 26 26 20 7a 4d 61 73 74 LITE_OK && zMast
1bfc0 65 72 5b 30 5d 20 26 26 20 72 65 73 20 29 7b 0a er[0] && res ){.
1bfd0 20 20 20 20 2f 2a 20 49 66 20 74 68 65 72 65 20 /* If there
1bfe0 77 61 73 20 61 20 6d 61 73 74 65 72 20 6a 6f 75 was a master jou
1bff0 72 6e 61 6c 20 61 6e 64 20 74 68 69 73 20 72 6f rnal and this ro
1c000 75 74 69 6e 65 20 77 69 6c 6c 20 72 65 74 75 72 utine will retur
1c010 6e 20 73 75 63 63 65 73 73 2c 0a 20 20 20 20 2a n success,. *
1c020 2a 20 73 65 65 20 69 66 20 69 74 20 69 73 20 70 * see if it is p
1c030 6f 73 73 69 62 6c 65 20 74 6f 20 64 65 6c 65 74 ossible to delet
1c040 65 20 74 68 65 20 6d 61 73 74 65 72 20 6a 6f 75 e the master jou
1c050 72 6e 61 6c 2e 0a 20 20 20 20 2a 2f 0a 20 20 20 rnal.. */.
1c060 20 72 63 20 3d 20 70 61 67 65 72 5f 64 65 6c 6d rc = pager_delm
1c070 61 73 74 65 72 28 70 50 61 67 65 72 2c 20 7a 4d aster(pPager, zM
1c080 61 73 74 65 72 29 3b 0a 20 20 20 20 74 65 73 74 aster);. test
1c090 63 61 73 65 28 20 72 63 21 3d 53 51 4c 49 54 45 case( rc!=SQLITE
1c0a0 5f 4f 4b 20 29 3b 0a 20 20 7d 0a 0a 20 20 2f 2a _OK );. }.. /*
1c0b0 20 54 68 65 20 50 61 67 65 72 2e 73 65 63 74 6f The Pager.secto
1c0c0 72 53 69 7a 65 20 76 61 72 69 61 62 6c 65 20 6d rSize variable m
1c0d0 61 79 20 68 61 76 65 20 62 65 65 6e 20 75 70 64 ay have been upd
1c0e0 61 74 65 64 20 77 68 69 6c 65 20 72 6f 6c 6c 69 ated while rolli
1c0f0 6e 67 0a 20 20 2a 2a 20 62 61 63 6b 20 61 20 6a ng. ** back a j
1c100 6f 75 72 6e 61 6c 20 63 72 65 61 74 65 64 20 62 ournal created b
1c110 79 20 61 20 70 72 6f 63 65 73 73 20 77 69 74 68 y a process with
1c120 20 61 20 64 69 66 66 65 72 65 6e 74 20 73 65 63 a different sec
1c130 74 6f 72 20 73 69 7a 65 0a 20 20 2a 2a 20 76 61 tor size. ** va
1c140 6c 75 65 2e 20 52 65 73 65 74 20 69 74 20 74 6f lue. Reset it to
1c150 20 74 68 65 20 63 6f 72 72 65 63 74 20 76 61 6c the correct val
1c160 75 65 20 66 6f 72 20 74 68 69 73 20 70 72 6f 63 ue for this proc
1c170 65 73 73 2e 0a 20 20 2a 2f 0a 20 20 73 65 74 53 ess.. */. setS
1c180 65 63 74 6f 72 53 69 7a 65 28 70 50 61 67 65 72 ectorSize(pPager
1c190 29 3b 0a 20 20 72 65 74 75 72 6e 20 72 63 3b 0a );. return rc;.
1c1a0 7d 0a 0a 0a 2f 2a 0a 2a 2a 20 52 65 61 64 20 74 }.../*.** Read t
1c1b0 68 65 20 63 6f 6e 74 65 6e 74 20 66 6f 72 20 70 he content for p
1c1c0 61 67 65 20 70 50 67 20 6f 75 74 20 6f 66 20 74 age pPg out of t
1c1d0 68 65 20 64 61 74 61 62 61 73 65 20 66 69 6c 65 he database file
1c1e0 20 61 6e 64 20 69 6e 74 6f 20 0a 2a 2a 20 70 50 and into .** pP
1c1f0 67 2d 3e 70 44 61 74 61 2e 20 41 20 73 68 61 72 g->pData. A shar
1c200 65 64 20 6c 6f 63 6b 20 6f 72 20 67 72 65 61 74 ed lock or great
1c210 65 72 20 6d 75 73 74 20 62 65 20 68 65 6c 64 20 er must be held
1c220 6f 6e 20 74 68 65 20 64 61 74 61 62 61 73 65 0a on the database.
1c230 2a 2a 20 66 69 6c 65 20 62 65 66 6f 72 65 20 74 ** file before t
1c240 68 69 73 20 66 75 6e 63 74 69 6f 6e 20 69 73 20 his function is
1c250 63 61 6c 6c 65 64 2e 0a 2a 2a 0a 2a 2a 20 49 66 called..**.** If
1c260 20 70 61 67 65 20 31 20 69 73 20 72 65 61 64 2c page 1 is read,
1c270 20 74 68 65 6e 20 74 68 65 20 76 61 6c 75 65 20 then the value
1c280 6f 66 20 50 61 67 65 72 2e 64 62 46 69 6c 65 56 of Pager.dbFileV
1c290 65 72 73 5b 5d 20 69 73 20 73 65 74 20 74 6f 0a ers[] is set to.
1c2a0 2a 2a 20 74 68 65 20 76 61 6c 75 65 20 72 65 61 ** the value rea
1c2b0 64 20 66 72 6f 6d 20 74 68 65 20 64 61 74 61 62 d from the datab
1c2c0 61 73 65 20 66 69 6c 65 2e 0a 2a 2a 0a 2a 2a 20 ase file..**.**
1c2d0 49 66 20 61 6e 20 49 4f 20 65 72 72 6f 72 20 6f If an IO error o
1c2e0 63 63 75 72 73 2c 20 74 68 65 6e 20 74 68 65 20 ccurs, then the
1c2f0 49 4f 20 65 72 72 6f 72 20 69 73 20 72 65 74 75 IO error is retu
1c300 72 6e 65 64 20 74 6f 20 74 68 65 20 63 61 6c 6c rned to the call
1c310 65 72 2e 0a 2a 2a 20 4f 74 68 65 72 77 69 73 65 er..** Otherwise
1c320 2c 20 53 51 4c 49 54 45 5f 4f 4b 20 69 73 20 72 , SQLITE_OK is r
1c330 65 74 75 72 6e 65 64 2e 0a 2a 2f 0a 73 74 61 74 eturned..*/.stat
1c340 69 63 20 69 6e 74 20 72 65 61 64 44 62 50 61 67 ic int readDbPag
1c350 65 28 50 67 48 64 72 20 2a 70 50 67 29 7b 0a 20 e(PgHdr *pPg){.
1c360 20 50 61 67 65 72 20 2a 70 50 61 67 65 72 20 3d Pager *pPager =
1c370 20 70 50 67 2d 3e 70 50 61 67 65 72 3b 20 2f 2a pPg->pPager; /*
1c380 20 50 61 67 65 72 20 6f 62 6a 65 63 74 20 61 73 Pager object as
1c390 73 6f 63 69 61 74 65 64 20 77 69 74 68 20 70 61 sociated with pa
1c3a0 67 65 20 70 50 67 20 2a 2f 0a 20 20 50 67 6e 6f ge pPg */. Pgno
1c3b0 20 70 67 6e 6f 20 3d 20 70 50 67 2d 3e 70 67 6e pgno = pPg->pgn
1c3c0 6f 3b 20 20 20 20 20 20 20 2f 2a 20 50 61 67 65 o; /* Page
1c3d0 20 6e 75 6d 62 65 72 20 74 6f 20 72 65 61 64 20 number to read
1c3e0 2a 2f 0a 20 20 69 6e 74 20 72 63 20 3d 20 53 51 */. int rc = SQ
1c3f0 4c 49 54 45 5f 4f 4b 3b 20 20 20 20 20 20 20 20 LITE_OK;
1c400 20 20 2f 2a 20 52 65 74 75 72 6e 20 63 6f 64 65 /* Return code
1c410 20 2a 2f 0a 20 20 69 6e 74 20 69 73 49 6e 57 61 */. int isInWa
1c420 6c 20 3d 20 30 3b 20 20 20 20 20 20 20 20 20 20 l = 0;
1c430 20 20 20 2f 2a 20 54 72 75 65 20 69 66 20 70 61 /* True if pa
1c440 67 65 20 69 73 20 69 6e 20 6c 6f 67 20 66 69 6c ge is in log fil
1c450 65 20 2a 2f 0a 20 20 69 6e 74 20 70 67 73 7a 20 e */. int pgsz
1c460 3d 20 70 50 61 67 65 72 2d 3e 70 61 67 65 53 69 = pPager->pageSi
1c470 7a 65 3b 20 2f 2a 20 4e 75 6d 62 65 72 20 6f 66 ze; /* Number of
1c480 20 62 79 74 65 73 20 74 6f 20 72 65 61 64 20 2a bytes to read *
1c490 2f 0a 0a 20 20 61 73 73 65 72 74 28 20 70 50 61 /.. assert( pPa
1c4a0 67 65 72 2d 3e 65 53 74 61 74 65 3e 3d 50 41 47 ger->eState>=PAG
1c4b0 45 52 5f 52 45 41 44 45 52 20 26 26 20 21 4d 45 ER_READER && !ME
1c4c0 4d 44 42 20 29 3b 0a 20 20 61 73 73 65 72 74 28 MDB );. assert(
1c4d0 20 69 73 4f 70 65 6e 28 70 50 61 67 65 72 2d 3e isOpen(pPager->
1c4e0 66 64 29 20 29 3b 0a 0a 20 20 69 66 28 20 4e 45 fd) );.. if( NE
1c4f0 56 45 52 28 21 69 73 4f 70 65 6e 28 70 50 61 67 VER(!isOpen(pPag
1c500 65 72 2d 3e 66 64 29 29 20 29 7b 0a 20 20 20 20 er->fd)) ){.
1c510 61 73 73 65 72 74 28 20 70 50 61 67 65 72 2d 3e assert( pPager->
1c520 74 65 6d 70 46 69 6c 65 20 29 3b 0a 20 20 20 20 tempFile );.
1c530 6d 65 6d 73 65 74 28 70 50 67 2d 3e 70 44 61 74 memset(pPg->pDat
1c540 61 2c 20 30 2c 20 70 50 61 67 65 72 2d 3e 70 61 a, 0, pPager->pa
1c550 67 65 53 69 7a 65 29 3b 0a 20 20 20 20 72 65 74 geSize);. ret
1c560 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20 urn SQLITE_OK;.
1c570 20 7d 0a 0a 20 20 69 66 28 20 70 61 67 65 72 55 }.. if( pagerU
1c580 73 65 57 61 6c 28 70 50 61 67 65 72 29 20 29 7b seWal(pPager) ){
1c590 0a 20 20 20 20 2f 2a 20 54 72 79 20 74 6f 20 70 . /* Try to p
1c5a0 75 6c 6c 20 74 68 65 20 70 61 67 65 20 66 72 6f ull the page fro
1c5b0 6d 20 74 68 65 20 77 72 69 74 65 2d 61 68 65 61 m the write-ahea
1c5c0 64 20 6c 6f 67 2e 20 2a 2f 0a 20 20 20 20 72 63 d log. */. rc
1c5d0 20 3d 20 73 71 6c 69 74 65 33 57 61 6c 52 65 61 = sqlite3WalRea
1c5e0 64 28 70 50 61 67 65 72 2d 3e 70 57 61 6c 2c 20 d(pPager->pWal,
1c5f0 70 67 6e 6f 2c 20 26 69 73 49 6e 57 61 6c 2c 20 pgno, &isInWal,
1c600 70 67 73 7a 2c 20 70 50 67 2d 3e 70 44 61 74 61 pgsz, pPg->pData
1c610 29 3b 0a 20 20 7d 0a 20 20 69 66 28 20 72 63 3d );. }. if( rc=
1c620 3d 53 51 4c 49 54 45 5f 4f 4b 20 26 26 20 21 69 =SQLITE_OK && !i
1c630 73 49 6e 57 61 6c 20 29 7b 0a 20 20 20 20 69 36 sInWal ){. i6
1c640 34 20 69 4f 66 66 73 65 74 20 3d 20 28 70 67 6e 4 iOffset = (pgn
1c650 6f 2d 31 29 2a 28 69 36 34 29 70 50 61 67 65 72 o-1)*(i64)pPager
1c660 2d 3e 70 61 67 65 53 69 7a 65 3b 0a 20 20 20 20 ->pageSize;.
1c670 72 63 20 3d 20 73 71 6c 69 74 65 33 4f 73 52 65 rc = sqlite3OsRe
1c680 61 64 28 70 50 61 67 65 72 2d 3e 66 64 2c 20 70 ad(pPager->fd, p
1c690 50 67 2d 3e 70 44 61 74 61 2c 20 70 67 73 7a 2c Pg->pData, pgsz,
1c6a0 20 69 4f 66 66 73 65 74 29 3b 0a 20 20 20 20 69 iOffset);. i
1c6b0 66 28 20 72 63 3d 3d 53 51 4c 49 54 45 5f 49 4f f( rc==SQLITE_IO
1c6c0 45 52 52 5f 53 48 4f 52 54 5f 52 45 41 44 20 29 ERR_SHORT_READ )
1c6d0 7b 0a 20 20 20 20 20 20 72 63 20 3d 20 53 51 4c {. rc = SQL
1c6e0 49 54 45 5f 4f 4b 3b 0a 20 20 20 20 7d 0a 20 20 ITE_OK;. }.
1c6f0 7d 0a 0a 20 20 69 66 28 20 70 67 6e 6f 3d 3d 31 }.. if( pgno==1
1c700 20 29 7b 0a 20 20 20 20 69 66 28 20 72 63 20 29 ){. if( rc )
1c710 7b 0a 20 20 20 20 20 20 2f 2a 20 49 66 20 74 68 {. /* If th
1c720 65 20 72 65 61 64 20 69 73 20 75 6e 73 75 63 63 e read is unsucc
1c730 65 73 73 66 75 6c 2c 20 73 65 74 20 74 68 65 20 essful, set the
1c740 64 62 46 69 6c 65 56 65 72 73 5b 5d 20 74 6f 20 dbFileVers[] to
1c750 73 6f 6d 65 74 68 69 6e 67 0a 20 20 20 20 20 20 something.
1c760 2a 2a 20 74 68 61 74 20 77 69 6c 6c 20 6e 65 76 ** that will nev
1c770 65 72 20 62 65 20 61 20 76 61 6c 69 64 20 66 69 er be a valid fi
1c780 6c 65 20 76 65 72 73 69 6f 6e 2e 20 20 64 62 46 le version. dbF
1c790 69 6c 65 56 65 72 73 5b 5d 20 69 73 20 61 20 63 ileVers[] is a c
1c7a0 6f 70 79 0a 20 20 20 20 20 20 2a 2a 20 6f 66 20 opy. ** of
1c7b0 62 79 74 65 73 20 32 34 2e 2e 33 39 20 6f 66 20 bytes 24..39 of
1c7c0 74 68 65 20 64 61 74 61 62 61 73 65 2e 20 20 42 the database. B
1c7d0 79 74 65 73 20 32 38 2e 2e 33 31 20 73 68 6f 75 ytes 28..31 shou
1c7e0 6c 64 20 61 6c 77 61 79 73 20 62 65 0a 20 20 20 ld always be.
1c7f0 20 20 20 2a 2a 20 7a 65 72 6f 20 6f 72 20 74 68 ** zero or th
1c800 65 20 73 69 7a 65 20 6f 66 20 74 68 65 20 64 61 e size of the da
1c810 74 61 62 61 73 65 20 69 6e 20 70 61 67 65 2e 20 tabase in page.
1c820 42 79 74 65 73 20 33 32 2e 2e 33 35 20 61 6e 64 Bytes 32..35 and
1c830 20 33 35 2e 2e 33 39 0a 20 20 20 20 20 20 2a 2a 35..39. **
1c840 20 73 68 6f 75 6c 64 20 62 65 20 70 61 67 65 20 should be page
1c850 6e 75 6d 62 65 72 73 20 77 68 69 63 68 20 61 72 numbers which ar
1c860 65 20 6e 65 76 65 72 20 30 78 66 66 66 66 66 66 e never 0xffffff
1c870 66 66 2e 20 20 53 6f 20 66 69 6c 6c 69 6e 67 0a ff. So filling.
1c880 20 20 20 20 20 20 2a 2a 20 70 50 61 67 65 72 2d ** pPager-
1c890 3e 64 62 46 69 6c 65 56 65 72 73 5b 5d 20 77 69 >dbFileVers[] wi
1c8a0 74 68 20 61 6c 6c 20 30 78 66 66 20 62 79 74 65 th all 0xff byte
1c8b0 73 20 73 68 6f 75 6c 64 20 73 75 66 66 69 63 65 s should suffice
1c8c0 2e 0a 20 20 20 20 20 20 2a 2a 0a 20 20 20 20 20 .. **.
1c8d0 20 2a 2a 20 46 6f 72 20 61 6e 20 65 6e 63 72 79 ** For an encry
1c8e0 70 74 65 64 20 64 61 74 61 62 61 73 65 2c 20 74 pted database, t
1c8f0 68 65 20 73 69 74 75 61 74 69 6f 6e 20 69 73 20 he situation is
1c900 6d 6f 72 65 20 63 6f 6d 70 6c 65 78 3a 20 20 62 more complex: b
1c910 79 74 65 73 0a 20 20 20 20 20 20 2a 2a 20 32 34 ytes. ** 24
1c920 2e 2e 33 39 20 6f 66 20 74 68 65 20 64 61 74 61 ..39 of the data
1c930 62 61 73 65 20 61 72 65 20 77 68 69 74 65 20 6e base are white n
1c940 6f 69 73 65 2e 20 20 42 75 74 20 74 68 65 20 70 oise. But the p
1c950 72 6f 62 61 62 69 6c 69 74 79 20 6f 66 0a 20 20 robability of.
1c960 20 20 20 20 2a 2a 20 77 68 69 74 65 20 6e 6f 69 ** white noi
1c970 73 69 6e 67 20 65 71 75 61 6c 69 6e 67 20 31 36 sing equaling 16
1c980 20 62 79 74 65 73 20 6f 66 20 30 78 66 66 20 69 bytes of 0xff i
1c990 73 20 76 61 6e 69 73 68 69 6e 67 6c 79 20 73 6d s vanishingly sm
1c9a0 61 6c 6c 20 73 6f 0a 20 20 20 20 20 20 2a 2a 20 all so. **
1c9b0 77 65 20 73 68 6f 75 6c 64 20 73 74 69 6c 6c 20 we should still
1c9c0 62 65 20 6f 6b 2e 0a 20 20 20 20 20 20 2a 2f 0a be ok.. */.
1c9d0 20 20 20 20 20 20 6d 65 6d 73 65 74 28 70 50 61 memset(pPa
1c9e0 67 65 72 2d 3e 64 62 46 69 6c 65 56 65 72 73 2c ger->dbFileVers,
1c9f0 20 30 78 66 66 2c 20 73 69 7a 65 6f 66 28 70 50 0xff, sizeof(pP
1ca00 61 67 65 72 2d 3e 64 62 46 69 6c 65 56 65 72 73 ager->dbFileVers
1ca10 29 29 3b 0a 20 20 20 20 7d 65 6c 73 65 7b 0a 20 ));. }else{.
1ca20 20 20 20 20 20 75 38 20 2a 64 62 46 69 6c 65 56 u8 *dbFileV
1ca30 65 72 73 20 3d 20 26 28 28 75 38 2a 29 70 50 67 ers = &((u8*)pPg
1ca40 2d 3e 70 44 61 74 61 29 5b 32 34 5d 3b 0a 20 20 ->pData)[24];.
1ca50 20 20 20 20 6d 65 6d 63 70 79 28 26 70 50 61 67 memcpy(&pPag
1ca60 65 72 2d 3e 64 62 46 69 6c 65 56 65 72 73 2c 20 er->dbFileVers,
1ca70 64 62 46 69 6c 65 56 65 72 73 2c 20 73 69 7a 65 dbFileVers, size
1ca80 6f 66 28 70 50 61 67 65 72 2d 3e 64 62 46 69 6c of(pPager->dbFil
1ca90 65 56 65 72 73 29 29 3b 0a 20 20 20 20 7d 0a 20 eVers));. }.
1caa0 20 7d 0a 20 20 43 4f 44 45 43 31 28 70 50 61 67 }. CODEC1(pPag
1cab0 65 72 2c 20 70 50 67 2d 3e 70 44 61 74 61 2c 20 er, pPg->pData,
1cac0 70 67 6e 6f 2c 20 33 2c 20 72 63 20 3d 20 53 51 pgno, 3, rc = SQ
1cad0 4c 49 54 45 5f 4e 4f 4d 45 4d 29 3b 0a 0a 20 20 LITE_NOMEM);..
1cae0 50 41 47 45 52 5f 49 4e 43 52 28 73 71 6c 69 74 PAGER_INCR(sqlit
1caf0 65 33 5f 70 61 67 65 72 5f 72 65 61 64 64 62 5f e3_pager_readdb_
1cb00 63 6f 75 6e 74 29 3b 0a 20 20 50 41 47 45 52 5f count);. PAGER_
1cb10 49 4e 43 52 28 70 50 61 67 65 72 2d 3e 6e 52 65 INCR(pPager->nRe
1cb20 61 64 29 3b 0a 20 20 49 4f 54 52 41 43 45 28 28 ad);. IOTRACE((
1cb30 22 50 47 49 4e 20 25 70 20 25 64 5c 6e 22 2c 20 "PGIN %p %d\n",
1cb40 70 50 61 67 65 72 2c 20 70 67 6e 6f 29 29 3b 0a pPager, pgno));.
1cb50 20 20 50 41 47 45 52 54 52 41 43 45 28 28 22 46 PAGERTRACE(("F
1cb60 45 54 43 48 20 25 64 20 70 61 67 65 20 25 64 20 ETCH %d page %d
1cb70 68 61 73 68 28 25 30 38 78 29 5c 6e 22 2c 0a 20 hash(%08x)\n",.
1cb80 20 20 20 20 20 20 20 20 20 20 20 20 20 20 50 41 PA
1cb90 47 45 52 49 44 28 70 50 61 67 65 72 29 2c 20 70 GERID(pPager), p
1cba0 67 6e 6f 2c 20 70 61 67 65 72 5f 70 61 67 65 68 gno, pager_pageh
1cbb0 61 73 68 28 70 50 67 29 29 29 3b 0a 0a 20 20 72 ash(pPg)));.. r
1cbc0 65 74 75 72 6e 20 72 63 3b 0a 7d 0a 0a 2f 2a 0a eturn rc;.}../*.
1cbd0 2a 2a 20 55 70 64 61 74 65 20 74 68 65 20 76 61 ** Update the va
1cbe0 6c 75 65 20 6f 66 20 74 68 65 20 63 68 61 6e 67 lue of the chang
1cbf0 65 2d 63 6f 75 6e 74 65 72 20 61 74 20 6f 66 66 e-counter at off
1cc00 73 65 74 73 20 32 34 20 61 6e 64 20 39 32 20 69 sets 24 and 92 i
1cc10 6e 0a 2a 2a 20 74 68 65 20 68 65 61 64 65 72 20 n.** the header
1cc20 61 6e 64 20 74 68 65 20 73 71 6c 69 74 65 20 76 and the sqlite v
1cc30 65 72 73 69 6f 6e 20 6e 75 6d 62 65 72 20 61 74 ersion number at
1cc40 20 6f 66 66 73 65 74 20 39 36 2e 0a 2a 2a 0a 2a offset 96..**.*
1cc50 2a 20 54 68 69 73 20 69 73 20 61 6e 20 75 6e 63 * This is an unc
1cc60 6f 6e 64 69 74 69 6f 6e 61 6c 20 75 70 64 61 74 onditional updat
1cc70 65 2e 20 20 53 65 65 20 61 6c 73 6f 20 74 68 65 e. See also the
1cc80 20 70 61 67 65 72 5f 69 6e 63 72 5f 63 68 61 6e pager_incr_chan
1cc90 67 65 63 6f 75 6e 74 65 72 28 29 0a 2a 2a 20 72 gecounter().** r
1cca0 6f 75 74 69 6e 65 20 77 68 69 63 68 20 6f 6e 6c outine which onl
1ccb0 79 20 75 70 64 61 74 65 73 20 74 68 65 20 63 68 y updates the ch
1ccc0 61 6e 67 65 2d 63 6f 75 6e 74 65 72 20 69 66 20 ange-counter if
1ccd0 74 68 65 20 75 70 64 61 74 65 20 69 73 20 61 63 the update is ac
1cce0 74 75 61 6c 6c 79 0a 2a 2a 20 6e 65 65 64 65 64 tually.** needed
1ccf0 2c 20 61 73 20 64 65 74 65 72 6d 69 6e 65 64 20 , as determined
1cd00 62 79 20 74 68 65 20 70 50 61 67 65 72 2d 3e 63 by the pPager->c
1cd10 68 61 6e 67 65 43 6f 75 6e 74 44 6f 6e 65 20 73 hangeCountDone s
1cd20 74 61 74 65 20 76 61 72 69 61 62 6c 65 2e 0a 2a tate variable..*
1cd30 2f 0a 73 74 61 74 69 63 20 76 6f 69 64 20 70 61 /.static void pa
1cd40 67 65 72 5f 77 72 69 74 65 5f 63 68 61 6e 67 65 ger_write_change
1cd50 63 6f 75 6e 74 65 72 28 50 67 48 64 72 20 2a 70 counter(PgHdr *p
1cd60 50 67 29 7b 0a 20 20 75 33 32 20 63 68 61 6e 67 Pg){. u32 chang
1cd70 65 5f 63 6f 75 6e 74 65 72 3b 0a 0a 20 20 2f 2a e_counter;.. /*
1cd80 20 49 6e 63 72 65 6d 65 6e 74 20 74 68 65 20 76 Increment the v
1cd90 61 6c 75 65 20 6a 75 73 74 20 72 65 61 64 20 61 alue just read a
1cda0 6e 64 20 77 72 69 74 65 20 69 74 20 62 61 63 6b nd write it back
1cdb0 20 74 6f 20 62 79 74 65 20 32 34 2e 20 2a 2f 0a to byte 24. */.
1cdc0 20 20 63 68 61 6e 67 65 5f 63 6f 75 6e 74 65 72 change_counter
1cdd0 20 3d 20 73 71 6c 69 74 65 33 47 65 74 34 62 79 = sqlite3Get4by
1cde0 74 65 28 28 75 38 2a 29 70 50 67 2d 3e 70 50 61 te((u8*)pPg->pPa
1cdf0 67 65 72 2d 3e 64 62 46 69 6c 65 56 65 72 73 29 ger->dbFileVers)
1ce00 2b 31 3b 0a 20 20 70 75 74 33 32 62 69 74 73 28 +1;. put32bits(
1ce10 28 28 63 68 61 72 2a 29 70 50 67 2d 3e 70 44 61 ((char*)pPg->pDa
1ce20 74 61 29 2b 32 34 2c 20 63 68 61 6e 67 65 5f 63 ta)+24, change_c
1ce30 6f 75 6e 74 65 72 29 3b 0a 0a 20 20 2f 2a 20 41 ounter);.. /* A
1ce40 6c 73 6f 20 73 74 6f 72 65 20 74 68 65 20 53 51 lso store the SQ
1ce50 4c 69 74 65 20 76 65 72 73 69 6f 6e 20 6e 75 6d Lite version num
1ce60 62 65 72 20 69 6e 20 62 79 74 65 73 20 39 36 2e ber in bytes 96.
1ce70 2e 39 39 20 61 6e 64 20 69 6e 0a 20 20 2a 2a 20 .99 and in. **
1ce80 62 79 74 65 73 20 39 32 2e 2e 39 35 20 73 74 6f bytes 92..95 sto
1ce90 72 65 20 74 68 65 20 63 68 61 6e 67 65 20 63 6f re the change co
1cea0 75 6e 74 65 72 20 66 6f 72 20 77 68 69 63 68 20 unter for which
1ceb0 74 68 65 20 76 65 72 73 69 6f 6e 20 6e 75 6d 62 the version numb
1cec0 65 72 0a 20 20 2a 2a 20 69 73 20 76 61 6c 69 64 er. ** is valid
1ced0 2e 20 2a 2f 0a 20 20 70 75 74 33 32 62 69 74 73 . */. put32bits
1cee0 28 28 28 63 68 61 72 2a 29 70 50 67 2d 3e 70 44 (((char*)pPg->pD
1cef0 61 74 61 29 2b 39 32 2c 20 63 68 61 6e 67 65 5f ata)+92, change_
1cf00 63 6f 75 6e 74 65 72 29 3b 0a 20 20 70 75 74 33 counter);. put3
1cf10 32 62 69 74 73 28 28 28 63 68 61 72 2a 29 70 50 2bits(((char*)pP
1cf20 67 2d 3e 70 44 61 74 61 29 2b 39 36 2c 20 53 51 g->pData)+96, SQ
1cf30 4c 49 54 45 5f 56 45 52 53 49 4f 4e 5f 4e 55 4d LITE_VERSION_NUM
1cf40 42 45 52 29 3b 0a 7d 0a 0a 23 69 66 6e 64 65 66 BER);.}..#ifndef
1cf50 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 57 41 4c SQLITE_OMIT_WAL
1cf60 0a 2f 2a 0a 2a 2a 20 54 68 69 73 20 66 75 6e 63 ./*.** This func
1cf70 74 69 6f 6e 20 69 73 20 69 6e 76 6f 6b 65 64 20 tion is invoked
1cf80 6f 6e 63 65 20 66 6f 72 20 65 61 63 68 20 70 61 once for each pa
1cf90 67 65 20 74 68 61 74 20 68 61 73 20 61 6c 72 65 ge that has alre
1cfa0 61 64 79 20 62 65 65 6e 20 0a 2a 2a 20 77 72 69 ady been .** wri
1cfb0 74 74 65 6e 20 69 6e 74 6f 20 74 68 65 20 6c 6f tten into the lo
1cfc0 67 20 66 69 6c 65 20 77 68 65 6e 20 61 20 57 41 g file when a WA
1cfd0 4c 20 74 72 61 6e 73 61 63 74 69 6f 6e 20 69 73 L transaction is
1cfe0 20 72 6f 6c 6c 65 64 20 62 61 63 6b 2e 0a 2a 2a rolled back..**
1cff0 20 50 61 72 61 6d 65 74 65 72 20 69 50 67 20 69 Parameter iPg i
1d000 73 20 74 68 65 20 70 61 67 65 20 6e 75 6d 62 65 s the page numbe
1d010 72 20 6f 66 20 73 61 69 64 20 70 61 67 65 2e 20 r of said page.
1d020 54 68 65 20 70 43 74 78 20 61 72 67 75 6d 65 6e The pCtx argumen
1d030 74 20 0a 2a 2a 20 69 73 20 61 63 74 75 61 6c 6c t .** is actuall
1d040 79 20 61 20 70 6f 69 6e 74 65 72 20 74 6f 20 74 y a pointer to t
1d050 68 65 20 50 61 67 65 72 20 73 74 72 75 63 74 75 he Pager structu
1d060 72 65 2e 0a 2a 2a 0a 2a 2a 20 49 66 20 70 61 67 re..**.** If pag
1d070 65 20 69 50 67 20 69 73 20 70 72 65 73 65 6e 74 e iPg is present
1d080 20 69 6e 20 74 68 65 20 63 61 63 68 65 2c 20 61 in the cache, a
1d090 6e 64 20 68 61 73 20 6e 6f 20 6f 75 74 73 74 61 nd has no outsta
1d0a0 6e 64 69 6e 67 20 72 65 66 65 72 65 6e 63 65 73 nding references
1d0b0 2c 0a 2a 2a 20 69 74 20 69 73 20 64 69 73 63 61 ,.** it is disca
1d0c0 72 64 65 64 2e 20 4f 74 68 65 72 77 69 73 65 2c rded. Otherwise,
1d0d0 20 69 66 20 74 68 65 72 65 20 61 72 65 20 6f 6e if there are on
1d0e0 65 20 6f 72 20 6d 6f 72 65 20 6f 75 74 73 74 61 e or more outsta
1d0f0 6e 64 69 6e 67 0a 2a 2a 20 72 65 66 65 72 65 6e nding.** referen
1d100 63 65 73 2c 20 74 68 65 20 70 61 67 65 20 63 6f ces, the page co
1d110 6e 74 65 6e 74 20 69 73 20 72 65 6c 6f 61 64 65 ntent is reloade
1d120 64 20 66 72 6f 6d 20 74 68 65 20 64 61 74 61 62 d from the datab
1d130 61 73 65 2e 20 49 66 20 74 68 65 0a 2a 2a 20 61 ase. If the.** a
1d140 74 74 65 6d 70 74 20 74 6f 20 72 65 6c 6f 61 64 ttempt to reload
1d150 20 63 6f 6e 74 65 6e 74 20 66 72 6f 6d 20 74 68 content from th
1d160 65 20 64 61 74 61 62 61 73 65 20 69 73 20 72 65 e database is re
1d170 71 75 69 72 65 64 20 61 6e 64 20 66 61 69 6c 73 quired and fails
1d180 2c 20 0a 2a 2a 20 72 65 74 75 72 6e 20 61 6e 20 , .** return an
1d190 53 51 4c 69 74 65 20 65 72 72 6f 72 20 63 6f 64 SQLite error cod
1d1a0 65 2e 20 4f 74 68 65 72 77 69 73 65 2c 20 53 51 e. Otherwise, SQ
1d1b0 4c 49 54 45 5f 4f 4b 2e 0a 2a 2f 0a 73 74 61 74 LITE_OK..*/.stat
1d1c0 69 63 20 69 6e 74 20 70 61 67 65 72 55 6e 64 6f ic int pagerUndo
1d1d0 43 61 6c 6c 62 61 63 6b 28 76 6f 69 64 20 2a 70 Callback(void *p
1d1e0 43 74 78 2c 20 50 67 6e 6f 20 69 50 67 29 7b 0a Ctx, Pgno iPg){.
1d1f0 20 20 69 6e 74 20 72 63 20 3d 20 53 51 4c 49 54 int rc = SQLIT
1d200 45 5f 4f 4b 3b 0a 20 20 50 61 67 65 72 20 2a 70 E_OK;. Pager *p
1d210 50 61 67 65 72 20 3d 20 28 50 61 67 65 72 20 2a Pager = (Pager *
1d220 29 70 43 74 78 3b 0a 20 20 50 67 48 64 72 20 2a )pCtx;. PgHdr *
1d230 70 50 67 3b 0a 0a 20 20 70 50 67 20 3d 20 73 71 pPg;.. pPg = sq
1d240 6c 69 74 65 33 50 61 67 65 72 4c 6f 6f 6b 75 70 lite3PagerLookup
1d250 28 70 50 61 67 65 72 2c 20 69 50 67 29 3b 0a 20 (pPager, iPg);.
1d260 20 69 66 28 20 70 50 67 20 29 7b 0a 20 20 20 20 if( pPg ){.
1d270 69 66 28 20 73 71 6c 69 74 65 33 50 63 61 63 68 if( sqlite3Pcach
1d280 65 50 61 67 65 52 65 66 63 6f 75 6e 74 28 70 50 ePageRefcount(pP
1d290 67 29 3d 3d 31 20 29 7b 0a 20 20 20 20 20 20 73 g)==1 ){. s
1d2a0 71 6c 69 74 65 33 50 63 61 63 68 65 44 72 6f 70 qlite3PcacheDrop
1d2b0 28 70 50 67 29 3b 0a 20 20 20 20 7d 65 6c 73 65 (pPg);. }else
1d2c0 7b 0a 20 20 20 20 20 20 72 63 20 3d 20 72 65 61 {. rc = rea
1d2d0 64 44 62 50 61 67 65 28 70 50 67 29 3b 0a 20 20 dDbPage(pPg);.
1d2e0 20 20 20 20 69 66 28 20 72 63 3d 3d 53 51 4c 49 if( rc==SQLI
1d2f0 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 20 20 20 TE_OK ){.
1d300 20 70 50 61 67 65 72 2d 3e 78 52 65 69 6e 69 74 pPager->xReinit
1d310 65 72 28 70 50 67 29 3b 0a 20 20 20 20 20 20 7d er(pPg);. }
1d320 0a 20 20 20 20 20 20 73 71 6c 69 74 65 33 50 61 . sqlite3Pa
1d330 67 65 72 55 6e 72 65 66 28 70 50 67 29 3b 0a 20 gerUnref(pPg);.
1d340 20 20 20 7d 0a 20 20 7d 0a 0a 20 20 2f 2a 20 4e }. }.. /* N
1d350 6f 72 6d 61 6c 6c 79 2c 20 69 66 20 61 20 74 72 ormally, if a tr
1d360 61 6e 73 61 63 74 69 6f 6e 20 69 73 20 72 6f 6c ansaction is rol
1d370 6c 65 64 20 62 61 63 6b 2c 20 61 6e 79 20 62 61 led back, any ba
1d380 63 6b 75 70 20 70 72 6f 63 65 73 73 65 73 20 61 ckup processes a
1d390 72 65 0a 20 20 2a 2a 20 75 70 64 61 74 65 64 20 re. ** updated
1d3a0 61 73 20 64 61 74 61 20 69 73 20 63 6f 70 69 65 as data is copie
1d3b0 64 20 6f 75 74 20 6f 66 20 74 68 65 20 72 6f 6c d out of the rol
1d3c0 6c 62 61 63 6b 20 6a 6f 75 72 6e 61 6c 20 61 6e lback journal an
1d3d0 64 20 69 6e 74 6f 20 74 68 65 0a 20 20 2a 2a 20 d into the. **
1d3e0 64 61 74 61 62 61 73 65 2e 20 54 68 69 73 20 69 database. This i
1d3f0 73 20 6e 6f 74 20 67 65 6e 65 72 61 6c 6c 79 20 s not generally
1d400 70 6f 73 73 69 62 6c 65 20 77 69 74 68 20 61 20 possible with a
1d410 57 41 4c 20 64 61 74 61 62 61 73 65 2c 20 61 73 WAL database, as
1d420 0a 20 20 2a 2a 20 72 6f 6c 6c 62 61 63 6b 20 69 . ** rollback i
1d430 6e 76 6f 6c 76 65 73 20 73 69 6d 70 6c 79 20 74 nvolves simply t
1d440 72 75 6e 63 61 74 69 6e 67 20 74 68 65 20 6c 6f runcating the lo
1d450 67 20 66 69 6c 65 2e 20 54 68 65 72 65 66 6f 72 g file. Therefor
1d460 65 2c 20 69 66 20 6f 6e 65 0a 20 20 2a 2a 20 6f e, if one. ** o
1d470 72 20 6d 6f 72 65 20 66 72 61 6d 65 73 20 68 61 r more frames ha
1d480 76 65 20 61 6c 72 65 61 64 79 20 62 65 65 6e 20 ve already been
1d490 77 72 69 74 74 65 6e 20 74 6f 20 74 68 65 20 6c written to the l
1d4a0 6f 67 20 28 61 6e 64 20 74 68 65 72 65 66 6f 72 og (and therefor
1d4b0 65 20 0a 20 20 2a 2a 20 61 6c 73 6f 20 63 6f 70 e . ** also cop
1d4c0 69 65 64 20 69 6e 74 6f 20 74 68 65 20 62 61 63 ied into the bac
1d4d0 6b 75 70 20 64 61 74 61 62 61 73 65 73 29 20 61 kup databases) a
1d4e0 73 20 70 61 72 74 20 6f 66 20 74 68 69 73 20 74 s part of this t
1d4f0 72 61 6e 73 61 63 74 69 6f 6e 2c 0a 20 20 2a 2a ransaction,. **
1d500 20 74 68 65 20 62 61 63 6b 75 70 73 20 6d 75 73 the backups mus
1d510 74 20 62 65 20 72 65 73 74 61 72 74 65 64 2e 0a t be restarted..
1d520 20 20 2a 2f 0a 20 20 73 71 6c 69 74 65 33 42 61 */. sqlite3Ba
1d530 63 6b 75 70 52 65 73 74 61 72 74 28 70 50 61 67 ckupRestart(pPag
1d540 65 72 2d 3e 70 42 61 63 6b 75 70 29 3b 0a 0a 20 er->pBackup);..
1d550 20 72 65 74 75 72 6e 20 72 63 3b 0a 7d 0a 0a 2f return rc;.}../
1d560 2a 0a 2a 2a 20 54 68 69 73 20 66 75 6e 63 74 69 *.** This functi
1d570 6f 6e 20 69 73 20 63 61 6c 6c 65 64 20 74 6f 20 on is called to
1d580 72 6f 6c 6c 62 61 63 6b 20 61 20 74 72 61 6e 73 rollback a trans
1d590 61 63 74 69 6f 6e 20 6f 6e 20 61 20 57 41 4c 20 action on a WAL
1d5a0 64 61 74 61 62 61 73 65 2e 0a 2a 2f 0a 73 74 61 database..*/.sta
1d5b0 74 69 63 20 69 6e 74 20 70 61 67 65 72 52 6f 6c tic int pagerRol
1d5c0 6c 62 61 63 6b 57 61 6c 28 50 61 67 65 72 20 2a lbackWal(Pager *
1d5d0 70 50 61 67 65 72 29 7b 0a 20 20 69 6e 74 20 72 pPager){. int r
1d5e0 63 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 c;
1d5f0 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 52 65 /* Re
1d600 74 75 72 6e 20 43 6f 64 65 20 2a 2f 0a 20 20 50 turn Code */. P
1d610 67 48 64 72 20 2a 70 4c 69 73 74 3b 20 20 20 20 gHdr *pList;
1d620 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f /
1d630 2a 20 4c 69 73 74 20 6f 66 20 64 69 72 74 79 20 * List of dirty
1d640 70 61 67 65 73 20 74 6f 20 72 65 76 65 72 74 20 pages to revert
1d650 2a 2f 0a 0a 20 20 2f 2a 20 46 6f 72 20 61 6c 6c */.. /* For all
1d660 20 70 61 67 65 73 20 69 6e 20 74 68 65 20 63 61 pages in the ca
1d670 63 68 65 20 74 68 61 74 20 61 72 65 20 63 75 72 che that are cur
1d680 72 65 6e 74 6c 79 20 64 69 72 74 79 20 6f 72 20 rently dirty or
1d690 68 61 76 65 20 61 6c 72 65 61 64 79 0a 20 20 2a have already. *
1d6a0 2a 20 62 65 65 6e 20 77 72 69 74 74 65 6e 20 28 * been written (
1d6b0 62 75 74 20 6e 6f 74 20 63 6f 6d 6d 69 74 74 65 but not committe
1d6c0 64 29 20 74 6f 20 74 68 65 20 6c 6f 67 20 66 69 d) to the log fi
1d6d0 6c 65 2c 20 64 6f 20 6f 6e 65 20 6f 66 20 74 68 le, do one of th
1d6e0 65 20 0a 20 20 2a 2a 20 66 6f 6c 6c 6f 77 69 6e e . ** followin
1d6f0 67 3a 0a 20 20 2a 2a 0a 20 20 2a 2a 20 20 20 2b g:. **. ** +
1d700 20 44 69 73 63 61 72 64 20 74 68 65 20 63 61 63 Discard the cac
1d710 68 65 64 20 70 61 67 65 20 28 69 66 20 72 65 66 hed page (if ref
1d720 63 6f 75 6e 74 3d 3d 30 29 2c 20 6f 72 0a 20 20 count==0), or.
1d730 2a 2a 20 20 20 2b 20 52 65 6c 6f 61 64 20 70 61 ** + Reload pa
1d740 67 65 20 63 6f 6e 74 65 6e 74 20 66 72 6f 6d 20 ge content from
1d750 74 68 65 20 64 61 74 61 62 61 73 65 20 28 69 66 the database (if
1d760 20 72 65 66 63 6f 75 6e 74 3e 30 29 2e 0a 20 20 refcount>0)..
1d770 2a 2f 0a 20 20 70 50 61 67 65 72 2d 3e 64 62 53 */. pPager->dbS
1d780 69 7a 65 20 3d 20 70 50 61 67 65 72 2d 3e 64 62 ize = pPager->db
1d790 4f 72 69 67 53 69 7a 65 3b 0a 20 20 72 63 20 3d OrigSize;. rc =
1d7a0 20 73 71 6c 69 74 65 33 57 61 6c 55 6e 64 6f 28 sqlite3WalUndo(
1d7b0 70 50 61 67 65 72 2d 3e 70 57 61 6c 2c 20 70 61 pPager->pWal, pa
1d7c0 67 65 72 55 6e 64 6f 43 61 6c 6c 62 61 63 6b 2c gerUndoCallback,
1d7d0 20 28 76 6f 69 64 20 2a 29 70 50 61 67 65 72 29 (void *)pPager)
1d7e0 3b 0a 20 20 70 4c 69 73 74 20 3d 20 73 71 6c 69 ;. pList = sqli
1d7f0 74 65 33 50 63 61 63 68 65 44 69 72 74 79 4c 69 te3PcacheDirtyLi
1d800 73 74 28 70 50 61 67 65 72 2d 3e 70 50 43 61 63 st(pPager->pPCac
1d810 68 65 29 3b 0a 20 20 77 68 69 6c 65 28 20 70 4c he);. while( pL
1d820 69 73 74 20 26 26 20 72 63 3d 3d 53 51 4c 49 54 ist && rc==SQLIT
1d830 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 50 67 48 64 E_OK ){. PgHd
1d840 72 20 2a 70 4e 65 78 74 20 3d 20 70 4c 69 73 74 r *pNext = pList
1d850 2d 3e 70 44 69 72 74 79 3b 0a 20 20 20 20 72 63 ->pDirty;. rc
1d860 20 3d 20 70 61 67 65 72 55 6e 64 6f 43 61 6c 6c = pagerUndoCall
1d870 62 61 63 6b 28 28 76 6f 69 64 20 2a 29 70 50 61 back((void *)pPa
1d880 67 65 72 2c 20 70 4c 69 73 74 2d 3e 70 67 6e 6f ger, pList->pgno
1d890 29 3b 0a 20 20 20 20 70 4c 69 73 74 20 3d 20 70 );. pList = p
1d8a0 4e 65 78 74 3b 0a 20 20 7d 0a 0a 20 20 72 65 74 Next;. }.. ret
1d8b0 75 72 6e 20 72 63 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a urn rc;.}../*.**
1d8c0 20 54 68 69 73 20 66 75 6e 63 74 69 6f 6e 20 69 This function i
1d8d0 73 20 61 20 77 72 61 70 70 65 72 20 61 72 6f 75 s a wrapper arou
1d8e0 6e 64 20 73 71 6c 69 74 65 33 57 61 6c 46 72 61 nd sqlite3WalFra
1d8f0 6d 65 73 28 29 2e 20 41 73 20 77 65 6c 6c 20 61 mes(). As well a
1d900 73 20 6c 6f 67 67 69 6e 67 0a 2a 2a 20 74 68 65 s logging.** the
1d910 20 63 6f 6e 74 65 6e 74 73 20 6f 66 20 74 68 65 contents of the
1d920 20 6c 69 73 74 20 6f 66 20 70 61 67 65 73 20 68 list of pages h
1d930 65 61 64 65 64 20 62 79 20 70 4c 69 73 74 20 28 eaded by pList (
1d940 63 6f 6e 6e 65 63 74 65 64 20 62 79 20 70 44 69 connected by pDi
1d950 72 74 79 29 2c 0a 2a 2a 20 74 68 69 73 20 66 75 rty),.** this fu
1d960 6e 63 74 69 6f 6e 20 6e 6f 74 69 66 69 65 73 20 nction notifies
1d970 61 6e 79 20 61 63 74 69 76 65 20 62 61 63 6b 75 any active backu
1d980 70 20 70 72 6f 63 65 73 73 65 73 20 74 68 61 74 p processes that
1d990 20 74 68 65 20 70 61 67 65 73 20 68 61 76 65 0a the pages have.
1d9a0 2a 2a 20 63 68 61 6e 67 65 64 2e 20 0a 2a 2a 0a ** changed. .**.
1d9b0 2a 2a 20 54 68 65 20 6c 69 73 74 20 6f 66 20 70 ** The list of p
1d9c0 61 67 65 73 20 70 61 73 73 65 64 20 69 6e 74 6f ages passed into
1d9d0 20 74 68 69 73 20 72 6f 75 74 69 6e 65 20 69 73 this routine is
1d9e0 20 61 6c 77 61 79 73 20 73 6f 72 74 65 64 20 62 always sorted b
1d9f0 79 20 70 61 67 65 20 6e 75 6d 62 65 72 2e 0a 2a y page number..*
1da00 2a 20 48 65 6e 63 65 2c 20 69 66 20 70 61 67 65 * Hence, if page
1da10 20 31 20 61 70 70 65 61 72 73 20 61 6e 79 77 68 1 appears anywh
1da20 65 72 65 20 6f 6e 20 74 68 65 20 6c 69 73 74 2c ere on the list,
1da30 20 69 74 20 77 69 6c 6c 20 62 65 20 74 68 65 20 it will be the
1da40 66 69 72 73 74 20 70 61 67 65 2e 0a 2a 2f 20 0a first page..*/ .
1da50 73 74 61 74 69 63 20 69 6e 74 20 70 61 67 65 72 static int pager
1da60 57 61 6c 46 72 61 6d 65 73 28 0a 20 20 50 61 67 WalFrames(. Pag
1da70 65 72 20 2a 70 50 61 67 65 72 2c 20 20 20 20 20 er *pPager,
1da80 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 /*
1da90 50 61 67 65 72 20 6f 62 6a 65 63 74 20 2a 2f 0a Pager object */.
1daa0 20 20 50 67 48 64 72 20 2a 70 4c 69 73 74 2c 20 PgHdr *pList,
1dab0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
1dac0 20 20 2f 2a 20 4c 69 73 74 20 6f 66 20 66 72 61 /* List of fra
1dad0 6d 65 73 20 74 6f 20 6c 6f 67 20 2a 2f 0a 20 20 mes to log */.
1dae0 50 67 6e 6f 20 6e 54 72 75 6e 63 61 74 65 2c 20 Pgno nTruncate,
1daf0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
1db00 2f 2a 20 44 61 74 61 62 61 73 65 20 73 69 7a 65 /* Database size
1db10 20 61 66 74 65 72 20 74 68 69 73 20 63 6f 6d 6d after this comm
1db20 69 74 20 2a 2f 0a 20 20 69 6e 74 20 69 73 43 6f it */. int isCo
1db30 6d 6d 69 74 2c 20 20 20 20 20 20 20 20 20 20 20 mmit,
1db40 20 20 20 20 20 20 20 20 2f 2a 20 54 72 75 65 20 /* True
1db50 69 66 20 74 68 69 73 20 69 73 20 61 20 63 6f 6d if this is a com
1db60 6d 69 74 20 2a 2f 0a 20 20 69 6e 74 20 73 79 6e mit */. int syn
1db70 63 46 6c 61 67 73 20 20 20 20 20 20 20 20 20 20 cFlags
1db80 20 20 20 20 20 20 20 20 20 2f 2a 20 46 6c 61 67 /* Flag
1db90 73 20 74 6f 20 70 61 73 73 20 74 6f 20 4f 73 53 s to pass to OsS
1dba0 79 6e 63 28 29 20 28 6f 72 20 30 29 20 2a 2f 0a ync() (or 0) */.
1dbb0 29 7b 0a 20 20 69 6e 74 20 72 63 3b 20 20 20 20 ){. int rc;
1dbc0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
1dbd0 20 20 20 20 20 2f 2a 20 52 65 74 75 72 6e 20 63 /* Return c
1dbe0 6f 64 65 20 2a 2f 0a 23 69 66 20 64 65 66 69 6e ode */.#if defin
1dbf0 65 64 28 53 51 4c 49 54 45 5f 44 45 42 55 47 29 ed(SQLITE_DEBUG)
1dc00 20 7c 7c 20 64 65 66 69 6e 65 64 28 53 51 4c 49 || defined(SQLI
1dc10 54 45 5f 43 48 45 43 4b 5f 50 41 47 45 53 29 0a TE_CHECK_PAGES).
1dc20 20 20 50 67 48 64 72 20 2a 70 3b 20 20 20 20 20 PgHdr *p;
1dc30 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
1dc40 20 20 2f 2a 20 46 6f 72 20 6c 6f 6f 70 69 6e 67 /* For looping
1dc50 20 6f 76 65 72 20 70 61 67 65 73 20 2a 2f 0a 23 over pages */.#
1dc60 65 6e 64 69 66 0a 0a 20 20 61 73 73 65 72 74 28 endif.. assert(
1dc70 20 70 50 61 67 65 72 2d 3e 70 57 61 6c 20 29 3b pPager->pWal );
1dc80 0a 23 69 66 64 65 66 20 53 51 4c 49 54 45 5f 44 .#ifdef SQLITE_D
1dc90 45 42 55 47 0a 20 20 2f 2a 20 56 65 72 69 66 79 EBUG. /* Verify
1dca0 20 74 68 61 74 20 74 68 65 20 70 61 67 65 20 6c that the page l
1dcb0 69 73 74 20 69 73 20 69 6e 20 61 63 63 65 6e 64 ist is in accend
1dcc0 69 6e 67 20 6f 72 64 65 72 20 2a 2f 0a 20 20 66 ing order */. f
1dcd0 6f 72 28 70 3d 70 4c 69 73 74 3b 20 70 20 26 26 or(p=pList; p &&
1dce0 20 70 2d 3e 70 44 69 72 74 79 3b 20 70 3d 70 2d p->pDirty; p=p-
1dcf0 3e 70 44 69 72 74 79 29 7b 0a 20 20 20 20 61 73 >pDirty){. as
1dd00 73 65 72 74 28 20 70 2d 3e 70 67 6e 6f 20 3c 20 sert( p->pgno <
1dd10 70 2d 3e 70 44 69 72 74 79 2d 3e 70 67 6e 6f 20 p->pDirty->pgno
1dd20 29 3b 0a 20 20 7d 0a 23 65 6e 64 69 66 0a 0a 20 );. }.#endif..
1dd30 20 69 66 28 20 69 73 43 6f 6d 6d 69 74 20 29 7b if( isCommit ){
1dd40 0a 20 20 20 20 2f 2a 20 49 66 20 61 20 57 41 4c . /* If a WAL
1dd50 20 74 72 61 6e 73 61 63 74 69 6f 6e 20 69 73 20 transaction is
1dd60 62 65 69 6e 67 20 63 6f 6d 6d 69 74 74 65 64 2c being committed,
1dd70 20 74 68 65 72 65 20 69 73 20 6e 6f 20 70 6f 69 there is no poi
1dd80 6e 74 20 69 6e 20 77 72 69 74 69 6e 67 0a 20 20 nt in writing.
1dd90 20 20 2a 2a 20 61 6e 79 20 70 61 67 65 73 20 77 ** any pages w
1dda0 69 74 68 20 70 61 67 65 20 6e 75 6d 62 65 72 73 ith page numbers
1ddb0 20 67 72 65 61 74 65 72 20 74 68 61 6e 20 6e 54 greater than nT
1ddc0 72 75 6e 63 61 74 65 20 69 6e 74 6f 20 74 68 65 runcate into the
1ddd0 20 57 41 4c 20 66 69 6c 65 2e 0a 20 20 20 20 2a WAL file.. *
1dde0 2a 20 54 68 65 79 20 77 69 6c 6c 20 6e 65 76 65 * They will neve
1ddf0 72 20 62 65 20 72 65 61 64 20 62 79 20 61 6e 79 r be read by any
1de00 20 63 6c 69 65 6e 74 2e 20 53 6f 20 72 65 6d 6f client. So remo
1de10 76 65 20 74 68 65 6d 20 66 72 6f 6d 20 74 68 65 ve them from the
1de20 20 70 44 69 72 74 79 0a 20 20 20 20 2a 2a 20 6c pDirty. ** l
1de30 69 73 74 20 68 65 72 65 2e 20 2a 2f 0a 20 20 20 ist here. */.
1de40 20 50 67 48 64 72 20 2a 70 3b 0a 20 20 20 20 50 PgHdr *p;. P
1de50 67 48 64 72 20 2a 2a 70 70 4e 65 78 74 20 3d 20 gHdr **ppNext =
1de60 26 70 4c 69 73 74 3b 0a 20 20 20 20 66 6f 72 28 &pList;. for(
1de70 70 3d 70 4c 69 73 74 3b 20 28 2a 70 70 4e 65 78 p=pList; (*ppNex
1de80 74 20 3d 20 70 29 3b 20 70 3d 70 2d 3e 70 44 69 t = p); p=p->pDi
1de90 72 74 79 29 7b 0a 20 20 20 20 20 20 69 66 28 20 rty){. if(
1dea0 70 2d 3e 70 67 6e 6f 3c 3d 6e 54 72 75 6e 63 61 p->pgno<=nTrunca
1deb0 74 65 20 29 20 70 70 4e 65 78 74 20 3d 20 26 70 te ) ppNext = &p
1dec0 2d 3e 70 44 69 72 74 79 3b 0a 20 20 20 20 7d 0a ->pDirty;. }.
1ded0 20 20 20 20 61 73 73 65 72 74 28 20 70 4c 69 73 assert( pLis
1dee0 74 20 29 3b 0a 20 20 7d 0a 0a 20 20 69 66 28 20 t );. }.. if(
1def0 70 4c 69 73 74 2d 3e 70 67 6e 6f 3d 3d 31 20 29 pList->pgno==1 )
1df00 20 70 61 67 65 72 5f 77 72 69 74 65 5f 63 68 61 pager_write_cha
1df10 6e 67 65 63 6f 75 6e 74 65 72 28 70 4c 69 73 74 ngecounter(pList
1df20 29 3b 0a 20 20 72 63 20 3d 20 73 71 6c 69 74 65 );. rc = sqlite
1df30 33 57 61 6c 46 72 61 6d 65 73 28 70 50 61 67 65 3WalFrames(pPage
1df40 72 2d 3e 70 57 61 6c 2c 20 0a 20 20 20 20 20 20 r->pWal, .
1df50 70 50 61 67 65 72 2d 3e 70 61 67 65 53 69 7a 65 pPager->pageSize
1df60 2c 20 70 4c 69 73 74 2c 20 6e 54 72 75 6e 63 61 , pList, nTrunca
1df70 74 65 2c 20 69 73 43 6f 6d 6d 69 74 2c 20 73 79 te, isCommit, sy
1df80 6e 63 46 6c 61 67 73 0a 20 20 29 3b 0a 20 20 69 ncFlags. );. i
1df90 66 28 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b f( rc==SQLITE_OK
1dfa0 20 26 26 20 70 50 61 67 65 72 2d 3e 70 42 61 63 && pPager->pBac
1dfb0 6b 75 70 20 29 7b 0a 20 20 20 20 50 67 48 64 72 kup ){. PgHdr
1dfc0 20 2a 70 3b 0a 20 20 20 20 66 6f 72 28 70 3d 70 *p;. for(p=p
1dfd0 4c 69 73 74 3b 20 70 3b 20 70 3d 70 2d 3e 70 44 List; p; p=p->pD
1dfe0 69 72 74 79 29 7b 0a 20 20 20 20 20 20 73 71 6c irty){. sql
1dff0 69 74 65 33 42 61 63 6b 75 70 55 70 64 61 74 65 ite3BackupUpdate
1e000 28 70 50 61 67 65 72 2d 3e 70 42 61 63 6b 75 70 (pPager->pBackup
1e010 2c 20 70 2d 3e 70 67 6e 6f 2c 20 28 75 38 20 2a , p->pgno, (u8 *
1e020 29 70 2d 3e 70 44 61 74 61 29 3b 0a 20 20 20 20 )p->pData);.
1e030 7d 0a 20 20 7d 0a 0a 23 69 66 64 65 66 20 53 51 }. }..#ifdef SQ
1e040 4c 49 54 45 5f 43 48 45 43 4b 5f 50 41 47 45 53 LITE_CHECK_PAGES
1e050 0a 20 20 70 4c 69 73 74 20 3d 20 73 71 6c 69 74 . pList = sqlit
1e060 65 33 50 63 61 63 68 65 44 69 72 74 79 4c 69 73 e3PcacheDirtyLis
1e070 74 28 70 50 61 67 65 72 2d 3e 70 50 43 61 63 68 t(pPager->pPCach
1e080 65 29 3b 0a 20 20 66 6f 72 28 70 3d 70 4c 69 73 e);. for(p=pLis
1e090 74 3b 20 70 3b 20 70 3d 70 2d 3e 70 44 69 72 74 t; p; p=p->pDirt
1e0a0 79 29 7b 0a 20 20 20 20 70 61 67 65 72 5f 73 65 y){. pager_se
1e0b0 74 5f 70 61 67 65 68 61 73 68 28 70 29 3b 0a 20 t_pagehash(p);.
1e0c0 20 7d 0a 23 65 6e 64 69 66 0a 0a 20 20 72 65 74 }.#endif.. ret
1e0d0 75 72 6e 20 72 63 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a urn rc;.}../*.**
1e0e0 20 42 65 67 69 6e 20 61 20 72 65 61 64 20 74 72 Begin a read tr
1e0f0 61 6e 73 61 63 74 69 6f 6e 20 6f 6e 20 74 68 65 ansaction on the
1e100 20 57 41 4c 2e 0a 2a 2a 0a 2a 2a 20 54 68 69 73 WAL..**.** This
1e110 20 72 6f 75 74 69 6e 65 20 75 73 65 64 20 74 6f routine used to
1e120 20 62 65 20 63 61 6c 6c 65 64 20 22 70 61 67 65 be called "page
1e130 72 4f 70 65 6e 53 6e 61 70 73 68 6f 74 28 29 22 rOpenSnapshot()"
1e140 20 62 65 63 61 75 73 65 20 69 74 20 65 73 73 65 because it esse
1e150 6e 74 69 61 6c 6c 79 0a 2a 2a 20 6d 61 6b 65 73 ntially.** makes
1e160 20 61 20 73 6e 61 70 73 68 6f 74 20 6f 66 20 74 a snapshot of t
1e170 68 65 20 64 61 74 61 62 61 73 65 20 61 74 20 74 he database at t
1e180 68 65 20 63 75 72 72 65 6e 74 20 70 6f 69 6e 74 he current point
1e190 20 69 6e 20 74 69 6d 65 20 61 6e 64 20 70 72 65 in time and pre
1e1a0 73 65 72 76 65 73 0a 2a 2a 20 74 68 61 74 20 73 serves.** that s
1e1b0 6e 61 70 73 68 6f 74 20 66 6f 72 20 75 73 65 20 napshot for use
1e1c0 62 79 20 74 68 65 20 72 65 61 64 65 72 20 69 6e by the reader in
1e1d0 20 73 70 69 74 65 20 6f 66 20 63 6f 6e 63 75 72 spite of concur
1e1e0 72 65 6e 74 6c 79 20 63 68 61 6e 67 65 73 20 62 rently changes b
1e1f0 79 0a 2a 2a 20 6f 74 68 65 72 20 77 72 69 74 65 y.** other write
1e200 72 73 20 6f 72 20 63 68 65 63 6b 70 6f 69 6e 74 rs or checkpoint
1e210 65 72 73 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 69 ers..*/.static i
1e220 6e 74 20 70 61 67 65 72 42 65 67 69 6e 52 65 61 nt pagerBeginRea
1e230 64 54 72 61 6e 73 61 63 74 69 6f 6e 28 50 61 67 dTransaction(Pag
1e240 65 72 20 2a 70 50 61 67 65 72 29 7b 0a 20 20 69 er *pPager){. i
1e250 6e 74 20 72 63 3b 20 20 20 20 20 20 20 20 20 20 nt rc;
1e260 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f /
1e270 2a 20 52 65 74 75 72 6e 20 63 6f 64 65 20 2a 2f * Return code */
1e280 0a 20 20 69 6e 74 20 63 68 61 6e 67 65 64 20 3d . int changed =
1e290 20 30 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 0;
1e2a0 20 20 20 2f 2a 20 54 72 75 65 20 69 66 20 63 61 /* True if ca
1e2b0 63 68 65 20 6d 75 73 74 20 62 65 20 72 65 73 65 che must be rese
1e2c0 74 20 2a 2f 0a 0a 20 20 61 73 73 65 72 74 28 20 t */.. assert(
1e2d0 70 61 67 65 72 55 73 65 57 61 6c 28 70 50 61 67 pagerUseWal(pPag
1e2e0 65 72 29 20 29 3b 0a 20 20 61 73 73 65 72 74 28 er) );. assert(
1e2f0 20 70 50 61 67 65 72 2d 3e 65 53 74 61 74 65 3d pPager->eState=
1e300 3d 50 41 47 45 52 5f 4f 50 45 4e 20 7c 7c 20 70 =PAGER_OPEN || p
1e310 50 61 67 65 72 2d 3e 65 53 74 61 74 65 3d 3d 50 Pager->eState==P
1e320 41 47 45 52 5f 52 45 41 44 45 52 20 29 3b 0a 0a AGER_READER );..
1e330 20 20 2f 2a 20 73 71 6c 69 74 65 33 57 61 6c 45 /* sqlite3WalE
1e340 6e 64 52 65 61 64 54 72 61 6e 73 61 63 74 69 6f ndReadTransactio
1e350 6e 28 29 20 77 61 73 20 6e 6f 74 20 63 61 6c 6c n() was not call
1e360 65 64 20 66 6f 72 20 74 68 65 20 70 72 65 76 69 ed for the previ
1e370 6f 75 73 0a 20 20 2a 2a 20 74 72 61 6e 73 61 63 ous. ** transac
1e380 74 69 6f 6e 20 69 6e 20 6c 6f 63 6b 69 6e 67 5f tion in locking_
1e390 6d 6f 64 65 3d 45 58 43 4c 55 53 49 56 45 2e 20 mode=EXCLUSIVE.
1e3a0 20 53 6f 20 63 61 6c 6c 20 69 74 20 6e 6f 77 2e So call it now.
1e3b0 20 20 49 66 20 77 65 0a 20 20 2a 2a 20 61 72 65 If we. ** are
1e3c0 20 69 6e 20 6c 6f 63 6b 69 6e 67 5f 6d 6f 64 65 in locking_mode
1e3d0 3d 4e 4f 52 4d 41 4c 20 61 6e 64 20 45 6e 64 52 =NORMAL and EndR
1e3e0 65 61 64 28 29 20 77 61 73 20 70 72 65 76 69 6f ead() was previo
1e3f0 75 73 6c 79 20 63 61 6c 6c 65 64 2c 0a 20 20 2a usly called,. *
1e400 2a 20 74 68 65 20 64 75 70 6c 69 63 61 74 65 20 * the duplicate
1e410 63 61 6c 6c 20 69 73 20 68 61 72 6d 6c 65 73 73 call is harmless
1e420 2e 0a 20 20 2a 2f 0a 20 20 73 71 6c 69 74 65 33 .. */. sqlite3
1e430 57 61 6c 45 6e 64 52 65 61 64 54 72 61 6e 73 61 WalEndReadTransa
1e440 63 74 69 6f 6e 28 70 50 61 67 65 72 2d 3e 70 57 ction(pPager->pW
1e450 61 6c 29 3b 0a 0a 20 20 72 63 20 3d 20 73 71 6c al);.. rc = sql
1e460 69 74 65 33 57 61 6c 42 65 67 69 6e 52 65 61 64 ite3WalBeginRead
1e470 54 72 61 6e 73 61 63 74 69 6f 6e 28 70 50 61 67 Transaction(pPag
1e480 65 72 2d 3e 70 57 61 6c 2c 20 26 63 68 61 6e 67 er->pWal, &chang
1e490 65 64 29 3b 0a 20 20 69 66 28 20 72 63 21 3d 53 ed);. if( rc!=S
1e4a0 51 4c 49 54 45 5f 4f 4b 20 7c 7c 20 63 68 61 6e QLITE_OK || chan
1e4b0 67 65 64 20 29 7b 0a 20 20 20 20 70 61 67 65 72 ged ){. pager
1e4c0 5f 72 65 73 65 74 28 70 50 61 67 65 72 29 3b 0a _reset(pPager);.
1e4d0 20 20 7d 0a 0a 20 20 72 65 74 75 72 6e 20 72 63 }.. return rc
1e4e0 3b 0a 7d 0a 23 65 6e 64 69 66 0a 0a 2f 2a 0a 2a ;.}.#endif../*.*
1e4f0 2a 20 54 68 69 73 20 66 75 6e 63 74 69 6f 6e 20 * This function
1e500 69 73 20 63 61 6c 6c 65 64 20 61 73 20 70 61 72 is called as par
1e510 74 20 6f 66 20 74 68 65 20 74 72 61 6e 73 69 74 t of the transit
1e520 69 6f 6e 20 66 72 6f 6d 20 50 41 47 45 52 5f 4f ion from PAGER_O
1e530 50 45 4e 0a 2a 2a 20 74 6f 20 50 41 47 45 52 5f PEN.** to PAGER_
1e540 52 45 41 44 45 52 20 73 74 61 74 65 20 74 6f 20 READER state to
1e550 64 65 74 65 72 6d 69 6e 65 20 74 68 65 20 73 69 determine the si
1e560 7a 65 20 6f 66 20 74 68 65 20 64 61 74 61 62 61 ze of the databa
1e570 73 65 20 66 69 6c 65 0a 2a 2a 20 69 6e 20 70 61 se file.** in pa
1e580 67 65 73 20 28 61 73 73 75 6d 69 6e 67 20 74 68 ges (assuming th
1e590 65 20 70 61 67 65 20 73 69 7a 65 20 63 75 72 72 e page size curr
1e5a0 65 6e 74 6c 79 20 73 74 6f 72 65 64 20 69 6e 20 ently stored in
1e5b0 50 61 67 65 72 2e 70 61 67 65 53 69 7a 65 29 2e Pager.pageSize).
1e5c0 0a 2a 2a 0a 2a 2a 20 49 66 20 6e 6f 20 65 72 72 .**.** If no err
1e5d0 6f 72 20 6f 63 63 75 72 73 2c 20 53 51 4c 49 54 or occurs, SQLIT
1e5e0 45 5f 4f 4b 20 69 73 20 72 65 74 75 72 6e 65 64 E_OK is returned
1e5f0 20 61 6e 64 20 74 68 65 20 73 69 7a 65 20 6f 66 and the size of
1e600 20 74 68 65 20 64 61 74 61 62 61 73 65 0a 2a 2a the database.**
1e610 20 69 6e 20 70 61 67 65 73 20 69 73 20 73 74 6f in pages is sto
1e620 72 65 64 20 69 6e 20 2a 70 6e 50 61 67 65 2e 20 red in *pnPage.
1e630 4f 74 68 65 72 77 69 73 65 2c 20 61 6e 20 65 72 Otherwise, an er
1e640 72 6f 72 20 63 6f 64 65 20 28 70 65 72 68 61 70 ror code (perhap
1e650 73 0a 2a 2a 20 53 51 4c 49 54 45 5f 49 4f 45 52 s.** SQLITE_IOER
1e660 52 5f 46 53 54 41 54 29 20 69 73 20 72 65 74 75 R_FSTAT) is retu
1e670 72 6e 65 64 20 61 6e 64 20 2a 70 6e 50 61 67 65 rned and *pnPage
1e680 20 69 73 20 6c 65 66 74 20 75 6e 6d 6f 64 69 66 is left unmodif
1e690 69 65 64 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 69 ied..*/.static i
1e6a0 6e 74 20 70 61 67 65 72 50 61 67 65 63 6f 75 6e nt pagerPagecoun
1e6b0 74 28 50 61 67 65 72 20 2a 70 50 61 67 65 72 2c t(Pager *pPager,
1e6c0 20 50 67 6e 6f 20 2a 70 6e 50 61 67 65 29 7b 0a Pgno *pnPage){.
1e6d0 20 20 50 67 6e 6f 20 6e 50 61 67 65 3b 20 20 20 Pgno nPage;
1e6e0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
1e6f0 20 20 2f 2a 20 56 61 6c 75 65 20 74 6f 20 72 65 /* Value to re
1e700 74 75 72 6e 20 76 69 61 20 2a 70 6e 50 61 67 65 turn via *pnPage
1e710 20 2a 2f 0a 0a 20 20 2f 2a 20 51 75 65 72 79 20 */.. /* Query
1e720 74 68 65 20 57 41 4c 20 73 75 62 2d 73 79 73 74 the WAL sub-syst
1e730 65 6d 20 66 6f 72 20 74 68 65 20 64 61 74 61 62 em for the datab
1e740 61 73 65 20 73 69 7a 65 2e 20 54 68 65 20 57 61 ase size. The Wa
1e750 6c 44 62 73 69 7a 65 28 29 0a 20 20 2a 2a 20 66 lDbsize(). ** f
1e760 75 6e 63 74 69 6f 6e 20 72 65 74 75 72 6e 73 20 unction returns
1e770 7a 65 72 6f 20 69 66 20 74 68 65 20 57 41 4c 20 zero if the WAL
1e780 69 73 20 6e 6f 74 20 6f 70 65 6e 20 28 69 2e 65 is not open (i.e
1e790 2e 20 50 61 67 65 72 2e 70 57 61 6c 3d 3d 30 29 . Pager.pWal==0)
1e7a0 2c 20 6f 72 0a 20 20 2a 2a 20 69 66 20 74 68 65 , or. ** if the
1e7b0 20 64 61 74 61 62 61 73 65 20 73 69 7a 65 20 69 database size i
1e7c0 73 20 6e 6f 74 20 61 76 61 69 6c 61 62 6c 65 2e s not available.
1e7d0 20 54 68 65 20 64 61 74 61 62 61 73 65 20 73 69 The database si
1e7e0 7a 65 20 69 73 20 6e 6f 74 0a 20 20 2a 2a 20 61 ze is not. ** a
1e7f0 76 61 69 6c 61 62 6c 65 20 66 72 6f 6d 20 74 68 vailable from th
1e800 65 20 57 41 4c 20 73 75 62 2d 73 79 73 74 65 6d e WAL sub-system
1e810 20 69 66 20 74 68 65 20 6c 6f 67 20 66 69 6c 65 if the log file
1e820 20 69 73 20 65 6d 70 74 79 20 6f 72 0a 20 20 2a is empty or. *
1e830 2a 20 63 6f 6e 74 61 69 6e 73 20 6e 6f 20 76 61 * contains no va
1e840 6c 69 64 20 63 6f 6d 6d 69 74 74 65 64 20 74 72 lid committed tr
1e850 61 6e 73 61 63 74 69 6f 6e 73 2e 0a 20 20 2a 2f ansactions.. */
1e860 0a 20 20 61 73 73 65 72 74 28 20 70 50 61 67 65 . assert( pPage
1e870 72 2d 3e 65 53 74 61 74 65 3d 3d 50 41 47 45 52 r->eState==PAGER
1e880 5f 4f 50 45 4e 20 29 3b 0a 20 20 61 73 73 65 72 _OPEN );. asser
1e890 74 28 20 70 50 61 67 65 72 2d 3e 65 4c 6f 63 6b t( pPager->eLock
1e8a0 3e 3d 53 48 41 52 45 44 5f 4c 4f 43 4b 20 7c 7c >=SHARED_LOCK ||
1e8b0 20 70 50 61 67 65 72 2d 3e 6e 6f 52 65 61 64 6c pPager->noReadl
1e8c0 6f 63 6b 20 29 3b 0a 20 20 6e 50 61 67 65 20 3d ock );. nPage =
1e8d0 20 73 71 6c 69 74 65 33 57 61 6c 44 62 73 69 7a sqlite3WalDbsiz
1e8e0 65 28 70 50 61 67 65 72 2d 3e 70 57 61 6c 29 3b e(pPager->pWal);
1e8f0 0a 0a 20 20 2f 2a 20 49 66 20 74 68 65 20 64 61 .. /* If the da
1e900 74 61 62 61 73 65 20 73 69 7a 65 20 77 61 73 20 tabase size was
1e910 6e 6f 74 20 61 76 61 69 6c 61 62 6c 65 20 66 72 not available fr
1e920 6f 6d 20 74 68 65 20 57 41 4c 20 73 75 62 2d 73 om the WAL sub-s
1e930 79 73 74 65 6d 2c 0a 20 20 2a 2a 20 64 65 74 65 ystem,. ** dete
1e940 72 6d 69 6e 65 20 69 74 20 62 61 73 65 64 20 6f rmine it based o
1e950 6e 20 74 68 65 20 73 69 7a 65 20 6f 66 20 74 68 n the size of th
1e960 65 20 64 61 74 61 62 61 73 65 20 66 69 6c 65 2e e database file.
1e970 20 49 66 20 74 68 65 20 73 69 7a 65 0a 20 20 2a If the size. *
1e980 2a 20 6f 66 20 74 68 65 20 64 61 74 61 62 61 73 * of the databas
1e990 65 20 66 69 6c 65 20 69 73 20 6e 6f 74 20 61 6e e file is not an
1e9a0 20 69 6e 74 65 67 65 72 20 6d 75 6c 74 69 70 6c integer multipl
1e9b0 65 20 6f 66 20 74 68 65 20 70 61 67 65 2d 73 69 e of the page-si
1e9c0 7a 65 2c 0a 20 20 2a 2a 20 72 6f 75 6e 64 20 64 ze,. ** round d
1e9d0 6f 77 6e 20 74 6f 20 74 68 65 20 6e 65 61 72 65 own to the neare
1e9e0 73 74 20 70 61 67 65 2e 20 45 78 63 65 70 74 2c st page. Except,
1e9f0 20 61 6e 79 20 66 69 6c 65 20 6c 61 72 67 65 72 any file larger
1ea00 20 74 68 61 6e 20 30 0a 20 20 2a 2a 20 62 79 74 than 0. ** byt
1ea10 65 73 20 69 6e 20 73 69 7a 65 20 69 73 20 63 6f es in size is co
1ea20 6e 73 69 64 65 72 65 64 20 74 6f 20 63 6f 6e 74 nsidered to cont
1ea30 61 69 6e 20 61 74 20 6c 65 61 73 74 20 6f 6e 65 ain at least one
1ea40 20 70 61 67 65 2e 0a 20 20 2a 2f 0a 20 20 69 66 page.. */. if
1ea50 28 20 6e 50 61 67 65 3d 3d 30 20 29 7b 0a 20 20 ( nPage==0 ){.
1ea60 20 20 69 36 34 20 6e 20 3d 20 30 3b 20 20 20 20 i64 n = 0;
1ea70 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
1ea80 2f 2a 20 53 69 7a 65 20 6f 66 20 64 62 20 66 69 /* Size of db fi
1ea90 6c 65 20 69 6e 20 62 79 74 65 73 20 2a 2f 0a 20 le in bytes */.
1eaa0 20 20 20 61 73 73 65 72 74 28 20 69 73 4f 70 65 assert( isOpe
1eab0 6e 28 70 50 61 67 65 72 2d 3e 66 64 29 20 7c 7c n(pPager->fd) ||
1eac0 20 70 50 61 67 65 72 2d 3e 74 65 6d 70 46 69 6c pPager->tempFil
1ead0 65 20 29 3b 0a 20 20 20 20 69 66 28 20 69 73 4f e );. if( isO
1eae0 70 65 6e 28 70 50 61 67 65 72 2d 3e 66 64 29 20 pen(pPager->fd)
1eaf0 29 7b 0a 20 20 20 20 20 20 69 6e 74 20 72 63 20 ){. int rc
1eb00 3d 20 73 71 6c 69 74 65 33 4f 73 46 69 6c 65 53 = sqlite3OsFileS
1eb10 69 7a 65 28 70 50 61 67 65 72 2d 3e 66 64 2c 20 ize(pPager->fd,
1eb20 26 6e 29 3b 0a 20 20 20 20 20 20 69 66 28 20 72 &n);. if( r
1eb30 63 21 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a c!=SQLITE_OK ){.
1eb40 20 20 20 20 20 20 20 20 72 65 74 75 72 6e 20 72 return r
1eb50 63 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 7d c;. }. }
1eb60 0a 20 20 20 20 6e 50 61 67 65 20 3d 20 28 50 67 . nPage = (Pg
1eb70 6e 6f 29 28 6e 20 2f 20 70 50 61 67 65 72 2d 3e no)(n / pPager->
1eb80 70 61 67 65 53 69 7a 65 29 3b 0a 20 20 20 20 69 pageSize);. i
1eb90 66 28 20 6e 50 61 67 65 3d 3d 30 20 26 26 20 6e f( nPage==0 && n
1eba0 3e 30 20 29 7b 0a 20 20 20 20 20 20 6e 50 61 67 >0 ){. nPag
1ebb0 65 20 3d 20 31 3b 0a 20 20 20 20 7d 0a 20 20 7d e = 1;. }. }
1ebc0 0a 0a 20 20 2f 2a 20 49 66 20 74 68 65 20 63 75 .. /* If the cu
1ebd0 72 72 65 6e 74 20 6e 75 6d 62 65 72 20 6f 66 20 rrent number of
1ebe0 70 61 67 65 73 20 69 6e 20 74 68 65 20 66 69 6c pages in the fil
1ebf0 65 20 69 73 20 67 72 65 61 74 65 72 20 74 68 61 e is greater tha
1ec00 6e 20 74 68 65 0a 20 20 2a 2a 20 63 6f 6e 66 69 n the. ** confi
1ec10 67 75 72 65 64 20 6d 61 78 69 6d 75 6d 20 70 61 gured maximum pa
1ec20 67 65 72 20 6e 75 6d 62 65 72 2c 20 69 6e 63 72 ger number, incr
1ec30 65 61 73 65 20 74 68 65 20 61 6c 6c 6f 77 65 64 ease the allowed
1ec40 20 6c 69 6d 69 74 20 73 6f 0a 20 20 2a 2a 20 74 limit so. ** t
1ec50 68 61 74 20 74 68 65 20 66 69 6c 65 20 63 61 6e hat the file can
1ec60 20 62 65 20 72 65 61 64 2e 0a 20 20 2a 2f 0a 20 be read.. */.
1ec70 20 69 66 28 20 6e 50 61 67 65 3e 70 50 61 67 65 if( nPage>pPage
1ec80 72 2d 3e 6d 78 50 67 6e 6f 20 29 7b 0a 20 20 20 r->mxPgno ){.
1ec90 20 70 50 61 67 65 72 2d 3e 6d 78 50 67 6e 6f 20 pPager->mxPgno
1eca0 3d 20 28 50 67 6e 6f 29 6e 50 61 67 65 3b 0a 20 = (Pgno)nPage;.
1ecb0 20 7d 0a 0a 20 20 2a 70 6e 50 61 67 65 20 3d 20 }.. *pnPage =
1ecc0 6e 50 61 67 65 3b 0a 20 20 72 65 74 75 72 6e 20 nPage;. return
1ecd0 53 51 4c 49 54 45 5f 4f 4b 3b 0a 7d 0a 0a 2f 2a SQLITE_OK;.}../*
1ece0 20 4c 6f 67 20 64 69 61 67 6e 6f 73 74 69 63 20 Log diagnostic
1ecf0 69 6e 66 6f 72 6d 61 74 69 6f 6e 20 61 62 6f 75 information abou
1ed00 74 20 74 68 65 20 70 61 67 65 72 20 2a 2f 0a 76 t the pager */.v
1ed10 6f 69 64 20 73 71 6c 69 74 65 33 50 61 67 65 72 oid sqlite3Pager
1ed20 4c 6f 67 44 69 61 67 6e 6f 73 74 69 63 73 28 50 LogDiagnostics(P
1ed30 61 67 65 72 20 2a 70 50 61 67 65 72 29 7b 0a 20 ager *pPager){.
1ed40 20 69 6e 74 20 72 63 3b 0a 20 20 69 36 34 20 6e int rc;. i64 n
1ed50 3b 0a 20 20 73 71 6c 69 74 65 33 5f 6c 6f 67 28 ;. sqlite3_log(
1ed60 53 51 4c 49 54 45 5f 49 4e 54 45 52 4e 41 4c 2c SQLITE_INTERNAL,
1ed70 20 22 50 61 67 65 72 20 66 69 6c 65 6e 61 6d 65 "Pager filename
1ed80 3d 5b 25 73 5d 22 2c 20 70 50 61 67 65 72 2d 3e =[%s]", pPager->
1ed90 7a 46 69 6c 65 6e 61 6d 65 29 3b 0a 20 20 73 71 zFilename);. sq
1eda0 6c 69 74 65 33 5f 6c 6f 67 28 53 51 4c 49 54 45 lite3_log(SQLITE
1edb0 5f 49 4e 54 45 52 4e 41 4c 2c 20 22 50 61 67 65 _INTERNAL, "Page
1edc0 72 20 6a 6f 75 72 6e 61 6c 3d 5b 25 73 5d 22 2c r journal=[%s]",
1edd0 20 70 50 61 67 65 72 2d 3e 7a 4a 6f 75 72 6e 61 pPager->zJourna
1ede0 6c 29 3b 0a 20 20 73 71 6c 69 74 65 33 5f 6c 6f l);. sqlite3_lo
1edf0 67 28 53 51 4c 49 54 45 5f 49 4e 54 45 52 4e 41 g(SQLITE_INTERNA
1ee00 4c 2c 0a 20 20 20 20 22 50 61 67 65 72 20 64 69 L,. "Pager di
1ee10 61 67 6e 6f 73 74 69 63 73 3a 20 70 57 61 6c 3d agnostics: pWal=
1ee20 25 70 20 69 73 4f 70 65 6e 3d 25 64 20 70 61 67 %p isOpen=%d pag
1ee30 65 53 69 7a 65 3d 25 64 20 64 62 53 69 7a 65 3d eSize=%d dbSize=
1ee40 25 64 20 65 53 74 61 74 65 3d 25 64 22 2c 0a 20 %d eState=%d",.
1ee50 20 20 20 70 50 61 67 65 72 2d 3e 70 57 61 6c 2c pPager->pWal,
1ee60 20 69 73 4f 70 65 6e 28 70 50 61 67 65 72 2d 3e isOpen(pPager->
1ee70 66 64 29 21 3d 30 2c 0a 20 20 20 20 70 50 61 67 fd)!=0,. pPag
1ee80 65 72 2d 3e 70 61 67 65 53 69 7a 65 2c 20 70 50 er->pageSize, pP
1ee90 61 67 65 72 2d 3e 64 62 53 69 7a 65 2c 20 70 50 ager->dbSize, pP
1eea0 61 67 65 72 2d 3e 65 53 74 61 74 65 0a 20 20 29 ager->eState. )
1eeb0 3b 0a 20 20 69 66 28 20 69 73 4f 70 65 6e 28 70 ;. if( isOpen(p
1eec0 50 61 67 65 72 2d 3e 66 64 29 20 29 7b 0a 20 20 Pager->fd) ){.
1eed0 20 20 6e 20 3d 20 30 3b 0a 20 20 20 20 72 63 20 n = 0;. rc
1eee0 3d 20 73 71 6c 69 74 65 33 4f 73 46 69 6c 65 53 = sqlite3OsFileS
1eef0 69 7a 65 28 70 50 61 67 65 72 2d 3e 66 64 2c 20 ize(pPager->fd,
1ef00 26 6e 29 3b 0a 20 20 20 20 73 71 6c 69 74 65 33 &n);. sqlite3
1ef10 5f 6c 6f 67 28 53 51 4c 49 54 45 5f 49 4e 54 45 _log(SQLITE_INTE
1ef20 52 4e 41 4c 2c 20 22 50 61 67 65 72 20 4f 73 46 RNAL, "Pager OsF
1ef30 69 6c 65 53 69 7a 65 3a 20 25 6c 6c 64 20 28 25 ileSize: %lld (%
1ef40 64 29 22 2c 20 6e 2c 20 72 63 29 3b 0a 20 20 7d d)", n, rc);. }
1ef50 0a 7d 0a 0a 0a 23 69 66 6e 64 65 66 20 53 51 4c .}...#ifndef SQL
1ef60 49 54 45 5f 4f 4d 49 54 5f 57 41 4c 0a 2f 2a 0a ITE_OMIT_WAL./*.
1ef70 2a 2a 20 43 68 65 63 6b 20 69 66 20 74 68 65 20 ** Check if the
1ef80 2a 2d 77 61 6c 20 66 69 6c 65 20 74 68 61 74 20 *-wal file that
1ef90 63 6f 72 72 65 73 70 6f 6e 64 73 20 74 6f 20 74 corresponds to t
1efa0 68 65 20 64 61 74 61 62 61 73 65 20 6f 70 65 6e he database open
1efb0 65 64 20 62 79 20 70 50 61 67 65 72 0a 2a 2a 20 ed by pPager.**
1efc0 65 78 69 73 74 73 20 69 66 20 74 68 65 20 64 61 exists if the da
1efd0 74 61 62 61 73 65 20 69 73 20 6e 6f 74 20 65 6d tabase is not em
1efe0 70 79 2c 20 6f 72 20 76 65 72 69 66 79 20 74 68 py, or verify th
1eff0 61 74 20 74 68 65 20 2a 2d 77 61 6c 20 66 69 6c at the *-wal fil
1f000 65 20 64 6f 65 73 0a 2a 2a 20 6e 6f 74 20 65 78 e does.** not ex
1f010 69 73 74 20 28 62 79 20 64 65 6c 65 74 69 6e 67 ist (by deleting
1f020 20 69 74 29 20 69 66 20 74 68 65 20 64 61 74 61 it) if the data
1f030 62 61 73 65 20 66 69 6c 65 20 69 73 20 65 6d 70 base file is emp
1f040 74 79 2e 0a 2a 2a 0a 2a 2a 20 49 66 20 74 68 65 ty..**.** If the
1f050 20 64 61 74 61 62 61 73 65 20 69 73 20 6e 6f 74 database is not
1f060 20 65 6d 70 74 79 20 61 6e 64 20 74 68 65 20 2a empty and the *
1f070 2d 77 61 6c 20 66 69 6c 65 20 65 78 69 73 74 73 -wal file exists
1f080 2c 20 6f 70 65 6e 20 74 68 65 20 70 61 67 65 72 , open the pager
1f090 0a 2a 2a 20 69 6e 20 57 41 4c 20 6d 6f 64 65 2e .** in WAL mode.
1f0a0 20 20 49 66 20 74 68 65 20 64 61 74 61 62 61 73 If the databas
1f0b0 65 20 69 73 20 65 6d 70 74 79 20 6f 72 20 69 66 e is empty or if
1f0c0 20 6e 6f 20 2a 2d 77 61 6c 20 66 69 6c 65 20 65 no *-wal file e
1f0d0 78 69 73 74 73 20 61 6e 64 0a 2a 2a 20 69 66 20 xists and.** if
1f0e0 6e 6f 20 65 72 72 6f 72 20 6f 63 63 75 72 73 2c no error occurs,
1f0f0 20 6d 61 6b 65 20 73 75 72 65 20 50 61 67 65 72 make sure Pager
1f100 2e 6a 6f 75 72 6e 61 6c 4d 6f 64 65 20 69 73 20 .journalMode is
1f110 6e 6f 74 20 73 65 74 20 74 6f 0a 2a 2a 20 50 41 not set to.** PA
1f120 47 45 52 5f 4a 4f 55 52 4e 41 4c 4d 4f 44 45 5f GER_JOURNALMODE_
1f130 57 41 4c 2e 0a 2a 2a 0a 2a 2a 20 52 65 74 75 72 WAL..**.** Retur
1f140 6e 20 53 51 4c 49 54 45 5f 4f 4b 20 6f 72 20 61 n SQLITE_OK or a
1f150 6e 20 65 72 72 6f 72 20 63 6f 64 65 2e 0a 2a 2a n error code..**
1f160 0a 2a 2a 20 54 68 65 20 63 61 6c 6c 65 72 20 6d .** The caller m
1f170 75 73 74 20 68 6f 6c 64 20 61 20 53 48 41 52 45 ust hold a SHARE
1f180 44 20 6c 6f 63 6b 20 6f 6e 20 74 68 65 20 64 61 D lock on the da
1f190 74 61 62 61 73 65 20 66 69 6c 65 20 74 6f 20 63 tabase file to c
1f1a0 61 6c 6c 20 74 68 69 73 0a 2a 2a 20 66 75 6e 63 all this.** func
1f1b0 74 69 6f 6e 2e 20 42 65 63 61 75 73 65 20 61 6e tion. Because an
1f1c0 20 45 58 43 4c 55 53 49 56 45 20 6c 6f 63 6b 20 EXCLUSIVE lock
1f1d0 6f 6e 20 74 68 65 20 64 62 20 66 69 6c 65 20 69 on the db file i
1f1e0 73 20 72 65 71 75 69 72 65 64 20 74 6f 20 64 65 s required to de
1f1f0 6c 65 74 65 20 0a 2a 2a 20 61 20 57 41 4c 20 6f lete .** a WAL o
1f200 6e 20 61 20 6e 6f 6e 65 2d 65 6d 70 74 79 20 64 n a none-empty d
1f210 61 74 61 62 61 73 65 2c 20 74 68 69 73 20 65 6e atabase, this en
1f220 73 75 72 65 73 20 74 68 65 72 65 20 69 73 20 6e sures there is n
1f230 6f 20 72 61 63 65 20 63 6f 6e 64 69 74 69 6f 6e o race condition
1f240 20 0a 2a 2a 20 62 65 74 77 65 65 6e 20 74 68 65 .** between the
1f250 20 78 41 63 63 65 73 73 28 29 20 62 65 6c 6f 77 xAccess() below
1f260 20 61 6e 64 20 61 6e 20 78 44 65 6c 65 74 65 28 and an xDelete(
1f270 29 20 62 65 69 6e 67 20 65 78 65 63 75 74 65 64 ) being executed
1f280 20 62 79 20 73 6f 6d 65 20 0a 2a 2a 20 6f 74 68 by some .** oth
1f290 65 72 20 63 6f 6e 6e 65 63 74 69 6f 6e 2e 0a 2a er connection..*
1f2a0 2f 0a 73 74 61 74 69 63 20 69 6e 74 20 70 61 67 /.static int pag
1f2b0 65 72 4f 70 65 6e 57 61 6c 49 66 50 72 65 73 65 erOpenWalIfPrese
1f2c0 6e 74 28 50 61 67 65 72 20 2a 70 50 61 67 65 72 nt(Pager *pPager
1f2d0 29 7b 0a 20 20 69 6e 74 20 72 63 20 3d 20 53 51 ){. int rc = SQ
1f2e0 4c 49 54 45 5f 4f 4b 3b 0a 20 20 61 73 73 65 72 LITE_OK;. asser
1f2f0 74 28 20 70 50 61 67 65 72 2d 3e 65 53 74 61 74 t( pPager->eStat
1f300 65 3d 3d 50 41 47 45 52 5f 4f 50 45 4e 20 29 3b e==PAGER_OPEN );
1f310 0a 20 20 61 73 73 65 72 74 28 20 70 50 61 67 65 . assert( pPage
1f320 72 2d 3e 65 4c 6f 63 6b 3e 3d 53 48 41 52 45 44 r->eLock>=SHARED
1f330 5f 4c 4f 43 4b 20 7c 7c 20 70 50 61 67 65 72 2d _LOCK || pPager-
1f340 3e 6e 6f 52 65 61 64 6c 6f 63 6b 20 29 3b 0a 0a >noReadlock );..
1f350 20 20 69 66 28 20 21 70 50 61 67 65 72 2d 3e 74 if( !pPager->t
1f360 65 6d 70 46 69 6c 65 20 29 7b 0a 20 20 20 20 69 empFile ){. i
1f370 6e 74 20 69 73 57 61 6c 3b 20 20 20 20 20 20 20 nt isWal;
1f380 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 /*
1f390 54 72 75 65 20 69 66 20 57 41 4c 20 66 69 6c 65 True if WAL file
1f3a0 20 65 78 69 73 74 73 20 2a 2f 0a 20 20 20 20 50 exists */. P
1f3b0 67 6e 6f 20 6e 50 61 67 65 3b 20 20 20 20 20 20 gno nPage;
1f3c0 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 /*
1f3d0 53 69 7a 65 20 6f 66 20 74 68 65 20 64 61 74 61 Size of the data
1f3e0 62 61 73 65 20 66 69 6c 65 20 2a 2f 0a 0a 20 20 base file */..
1f3f0 20 20 72 63 20 3d 20 70 61 67 65 72 50 61 67 65 rc = pagerPage
1f400 63 6f 75 6e 74 28 70 50 61 67 65 72 2c 20 26 6e count(pPager, &n
1f410 50 61 67 65 29 3b 0a 20 20 20 20 69 66 28 20 72 Page);. if( r
1f420 63 20 29 20 72 65 74 75 72 6e 20 72 63 3b 0a 20 c ) return rc;.
1f430 20 20 20 69 66 28 20 6e 50 61 67 65 3d 3d 30 20 if( nPage==0
1f440 29 7b 0a 20 20 20 20 20 20 72 63 20 3d 20 73 71 ){. rc = sq
1f450 6c 69 74 65 33 4f 73 44 65 6c 65 74 65 28 70 50 lite3OsDelete(pP
1f460 61 67 65 72 2d 3e 70 56 66 73 2c 20 70 50 61 67 ager->pVfs, pPag
1f470 65 72 2d 3e 7a 57 61 6c 2c 20 30 29 3b 0a 20 20 er->zWal, 0);.
1f480 20 20 20 20 69 73 57 61 6c 20 3d 20 30 3b 0a 20 isWal = 0;.
1f490 20 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 20 20 }else{.
1f4a0 72 63 20 3d 20 73 71 6c 69 74 65 33 4f 73 41 63 rc = sqlite3OsAc
1f4b0 63 65 73 73 28 0a 20 20 20 20 20 20 20 20 20 20 cess(.
1f4c0 70 50 61 67 65 72 2d 3e 70 56 66 73 2c 20 70 50 pPager->pVfs, pP
1f4d0 61 67 65 72 2d 3e 7a 57 61 6c 2c 20 53 51 4c 49 ager->zWal, SQLI
1f4e0 54 45 5f 41 43 43 45 53 53 5f 45 58 49 53 54 53 TE_ACCESS_EXISTS
1f4f0 2c 20 26 69 73 57 61 6c 0a 20 20 20 20 20 20 29 , &isWal. )
1f500 3b 0a 20 20 20 20 7d 0a 20 20 20 20 69 66 28 20 ;. }. if(
1f510 72 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b rc==SQLITE_OK ){
1f520 0a 20 20 20 20 20 20 69 66 28 20 69 73 57 61 6c . if( isWal
1f530 20 29 7b 0a 20 20 20 20 20 20 20 20 74 65 73 74 ){. test
1f540 63 61 73 65 28 20 73 71 6c 69 74 65 33 50 63 61 case( sqlite3Pca
1f550 63 68 65 50 61 67 65 63 6f 75 6e 74 28 70 50 61 chePagecount(pPa
1f560 67 65 72 2d 3e 70 50 43 61 63 68 65 29 3d 3d 30 ger->pPCache)==0
1f570 20 29 3b 0a 20 20 20 20 20 20 20 20 72 63 20 3d );. rc =
1f580 20 73 71 6c 69 74 65 33 50 61 67 65 72 4f 70 65 sqlite3PagerOpe
1f590 6e 57 61 6c 28 70 50 61 67 65 72 2c 20 30 29 3b nWal(pPager, 0);
1f5a0 0a 20 20 20 20 20 20 7d 65 6c 73 65 20 69 66 28 . }else if(
1f5b0 20 70 50 61 67 65 72 2d 3e 6a 6f 75 72 6e 61 6c pPager->journal
1f5c0 4d 6f 64 65 3d 3d 50 41 47 45 52 5f 4a 4f 55 52 Mode==PAGER_JOUR
1f5d0 4e 41 4c 4d 4f 44 45 5f 57 41 4c 20 29 7b 0a 20 NALMODE_WAL ){.
1f5e0 20 20 20 20 20 20 20 70 50 61 67 65 72 2d 3e 6a pPager->j
1f5f0 6f 75 72 6e 61 6c 4d 6f 64 65 20 3d 20 50 41 47 ournalMode = PAG
1f600 45 52 5f 4a 4f 55 52 4e 41 4c 4d 4f 44 45 5f 44 ER_JOURNALMODE_D
1f610 45 4c 45 54 45 3b 0a 20 20 20 20 20 20 7d 0a 20 ELETE;. }.
1f620 20 20 20 7d 0a 20 20 7d 0a 20 20 72 65 74 75 72 }. }. retur
1f630 6e 20 72 63 3b 0a 7d 0a 23 65 6e 64 69 66 0a 0a n rc;.}.#endif..
1f640 2f 2a 0a 2a 2a 20 50 6c 61 79 62 61 63 6b 20 73 /*.** Playback s
1f650 61 76 65 70 6f 69 6e 74 20 70 53 61 76 65 70 6f avepoint pSavepo
1f660 69 6e 74 2e 20 4f 72 2c 20 69 66 20 70 53 61 76 int. Or, if pSav
1f670 65 70 6f 69 6e 74 3d 3d 4e 55 4c 4c 2c 20 74 68 epoint==NULL, th
1f680 65 6e 20 70 6c 61 79 62 61 63 6b 0a 2a 2a 20 74 en playback.** t
1f690 68 65 20 65 6e 74 69 72 65 20 6d 61 73 74 65 72 he entire master
1f6a0 20 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 2e 20 54 journal file. T
1f6b0 68 65 20 63 61 73 65 20 70 53 61 76 65 70 6f 69 he case pSavepoi
1f6c0 6e 74 3d 3d 4e 55 4c 4c 20 6f 63 63 75 72 73 20 nt==NULL occurs
1f6d0 77 68 65 6e 20 0a 2a 2a 20 61 20 52 4f 4c 4c 42 when .** a ROLLB
1f6e0 41 43 4b 20 54 4f 20 63 6f 6d 6d 61 6e 64 20 69 ACK TO command i
1f6f0 73 20 69 6e 76 6f 6b 65 64 20 6f 6e 20 61 20 53 s invoked on a S
1f700 41 56 45 50 4f 49 4e 54 20 74 68 61 74 20 69 73 AVEPOINT that is
1f710 20 61 20 74 72 61 6e 73 61 63 74 69 6f 6e 20 0a a transaction .
1f720 2a 2a 20 73 61 76 65 70 6f 69 6e 74 2e 0a 2a 2a ** savepoint..**
1f730 0a 2a 2a 20 57 68 65 6e 20 70 53 61 76 65 70 6f .** When pSavepo
1f740 69 6e 74 20 69 73 20 6e 6f 74 20 4e 55 4c 4c 20 int is not NULL
1f750 28 6d 65 61 6e 69 6e 67 20 61 20 6e 6f 6e 2d 74 (meaning a non-t
1f760 72 61 6e 73 61 63 74 69 6f 6e 20 73 61 76 65 70 ransaction savep
1f770 6f 69 6e 74 20 69 73 20 0a 2a 2a 20 62 65 69 6e oint is .** bein
1f780 67 20 72 6f 6c 6c 65 64 20 62 61 63 6b 29 2c 20 g rolled back),
1f790 74 68 65 6e 20 74 68 65 20 72 6f 6c 6c 62 61 63 then the rollbac
1f7a0 6b 20 63 6f 6e 73 69 73 74 73 20 6f 66 20 75 70 k consists of up
1f7b0 20 74 6f 20 74 68 72 65 65 20 73 74 61 67 65 73 to three stages
1f7c0 2c 0a 2a 2a 20 70 65 72 66 6f 72 6d 65 64 20 69 ,.** performed i
1f7d0 6e 20 74 68 65 20 6f 72 64 65 72 20 73 70 65 63 n the order spec
1f7e0 69 66 69 65 64 3a 0a 2a 2a 0a 2a 2a 20 20 20 2a ified:.**.** *
1f7f0 20 50 61 67 65 73 20 61 72 65 20 70 6c 61 79 65 Pages are playe
1f800 64 20 62 61 63 6b 20 66 72 6f 6d 20 74 68 65 20 d back from the
1f810 6d 61 69 6e 20 6a 6f 75 72 6e 61 6c 20 73 74 61 main journal sta
1f820 72 74 69 6e 67 20 61 74 20 62 79 74 65 0a 2a 2a rting at byte.**
1f830 20 20 20 20 20 6f 66 66 73 65 74 20 50 61 67 65 offset Page
1f840 72 53 61 76 65 70 6f 69 6e 74 2e 69 4f 66 66 73 rSavepoint.iOffs
1f850 65 74 20 61 6e 64 20 63 6f 6e 74 69 6e 75 69 6e et and continuin
1f860 67 20 74 6f 20 0a 2a 2a 20 20 20 20 20 50 61 67 g to .** Pag
1f870 65 72 53 61 76 65 70 6f 69 6e 74 2e 69 48 64 72 erSavepoint.iHdr
1f880 4f 66 66 73 65 74 2c 20 6f 72 20 74 6f 20 74 68 Offset, or to th
1f890 65 20 65 6e 64 20 6f 66 20 74 68 65 20 6d 61 69 e end of the mai
1f8a0 6e 20 6a 6f 75 72 6e 61 6c 0a 2a 2a 20 20 20 20 n journal.**
1f8b0 20 66 69 6c 65 20 69 66 20 50 61 67 65 72 53 61 file if PagerSa
1f8c0 76 65 70 6f 69 6e 74 2e 69 48 64 72 4f 66 66 73 vepoint.iHdrOffs
1f8d0 65 74 20 69 73 20 7a 65 72 6f 2e 0a 2a 2a 0a 2a et is zero..**.*
1f8e0 2a 20 20 20 2a 20 49 66 20 50 61 67 65 72 53 61 * * If PagerSa
1f8f0 76 65 70 6f 69 6e 74 2e 69 48 64 72 4f 66 66 73 vepoint.iHdrOffs
1f900 65 74 20 69 73 20 6e 6f 74 20 7a 65 72 6f 2c 20 et is not zero,
1f910 74 68 65 6e 20 70 61 67 65 73 20 61 72 65 20 70 then pages are p
1f920 6c 61 79 65 64 0a 2a 2a 20 20 20 20 20 62 61 63 layed.** bac
1f930 6b 20 73 74 61 72 74 69 6e 67 20 66 72 6f 6d 20 k starting from
1f940 74 68 65 20 6a 6f 75 72 6e 61 6c 20 68 65 61 64 the journal head
1f950 65 72 20 69 6d 6d 65 64 69 61 74 65 6c 79 20 66 er immediately f
1f960 6f 6c 6c 6f 77 69 6e 67 20 0a 2a 2a 20 20 20 20 ollowing .**
1f970 20 50 61 67 65 72 53 61 76 65 70 6f 69 6e 74 2e PagerSavepoint.
1f980 69 48 64 72 4f 66 66 73 65 74 20 74 6f 20 74 68 iHdrOffset to th
1f990 65 20 65 6e 64 20 6f 66 20 74 68 65 20 6d 61 69 e end of the mai
1f9a0 6e 20 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 2e 0a n journal file..
1f9b0 2a 2a 0a 2a 2a 20 20 20 2a 20 50 61 67 65 73 20 **.** * Pages
1f9c0 61 72 65 20 74 68 65 6e 20 70 6c 61 79 65 64 20 are then played
1f9d0 62 61 63 6b 20 66 72 6f 6d 20 74 68 65 20 73 75 back from the su
1f9e0 62 2d 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 2c 20 b-journal file,
1f9f0 73 74 61 72 74 69 6e 67 0a 2a 2a 20 20 20 20 20 starting.**
1fa00 77 69 74 68 20 74 68 65 20 50 61 67 65 72 53 61 with the PagerSa
1fa10 76 65 70 6f 69 6e 74 2e 69 53 75 62 52 65 63 20 vepoint.iSubRec
1fa20 61 6e 64 20 63 6f 6e 74 69 6e 75 69 6e 67 20 74 and continuing t
1fa30 6f 20 74 68 65 20 65 6e 64 20 6f 66 0a 2a 2a 20 o the end of.**
1fa40 20 20 20 20 74 68 65 20 6a 6f 75 72 6e 61 6c 20 the journal
1fa50 66 69 6c 65 2e 0a 2a 2a 0a 2a 2a 20 54 68 72 6f file..**.** Thro
1fa60 75 67 68 6f 75 74 20 74 68 65 20 72 6f 6c 6c 62 ughout the rollb
1fa70 61 63 6b 20 70 72 6f 63 65 73 73 2c 20 65 61 63 ack process, eac
1fa80 68 20 74 69 6d 65 20 61 20 70 61 67 65 20 69 73 h time a page is
1fa90 20 72 6f 6c 6c 65 64 20 62 61 63 6b 2c 20 74 68 rolled back, th
1faa0 65 0a 2a 2a 20 63 6f 72 72 65 73 70 6f 6e 64 69 e.** correspondi
1fab0 6e 67 20 62 69 74 20 69 73 20 73 65 74 20 69 6e ng bit is set in
1fac0 20 61 20 62 69 74 76 65 63 20 73 74 72 75 63 74 a bitvec struct
1fad0 75 72 65 20 28 76 61 72 69 61 62 6c 65 20 70 44 ure (variable pD
1fae0 6f 6e 65 20 69 6e 20 74 68 65 0a 2a 2a 20 69 6d one in the.** im
1faf0 70 6c 65 6d 65 6e 74 61 74 69 6f 6e 20 62 65 6c plementation bel
1fb00 6f 77 29 2e 20 54 68 69 73 20 69 73 20 75 73 65 ow). This is use
1fb10 64 20 74 6f 20 65 6e 73 75 72 65 20 74 68 61 74 d to ensure that
1fb20 20 61 20 70 61 67 65 20 69 73 20 6f 6e 6c 79 0a a page is only.
1fb30 2a 2a 20 72 6f 6c 6c 65 64 20 62 61 63 6b 20 74 ** rolled back t
1fb40 68 65 20 66 69 72 73 74 20 74 69 6d 65 20 69 74 he first time it
1fb50 20 69 73 20 65 6e 63 6f 75 6e 74 65 72 65 64 20 is encountered
1fb60 69 6e 20 65 69 74 68 65 72 20 6a 6f 75 72 6e 61 in either journa
1fb70 6c 2e 0a 2a 2a 0a 2a 2a 20 49 66 20 70 53 61 76 l..**.** If pSav
1fb80 65 70 6f 69 6e 74 20 69 73 20 4e 55 4c 4c 2c 20 epoint is NULL,
1fb90 74 68 65 6e 20 70 61 67 65 73 20 61 72 65 20 6f then pages are o
1fba0 6e 6c 79 20 70 6c 61 79 65 64 20 62 61 63 6b 20 nly played back
1fbb0 66 72 6f 6d 20 74 68 65 20 6d 61 69 6e 0a 2a 2a from the main.**
1fbc0 20 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 2e 20 54 journal file. T
1fbd0 68 65 72 65 20 69 73 20 6e 6f 20 6e 65 65 64 20 here is no need
1fbe0 66 6f 72 20 61 20 62 69 74 76 65 63 20 69 6e 20 for a bitvec in
1fbf0 74 68 69 73 20 63 61 73 65 2e 0a 2a 2a 0a 2a 2a this case..**.**
1fc00 20 49 6e 20 65 69 74 68 65 72 20 63 61 73 65 2c In either case,
1fc10 20 62 65 66 6f 72 65 20 70 6c 61 79 62 61 63 6b before playback
1fc20 20 63 6f 6d 6d 65 6e 63 65 73 20 74 68 65 20 50 commences the P
1fc30 61 67 65 72 2e 64 62 53 69 7a 65 20 76 61 72 69 ager.dbSize vari
1fc40 61 62 6c 65 0a 2a 2a 20 69 73 20 72 65 73 65 74 able.** is reset
1fc50 20 74 6f 20 74 68 65 20 76 61 6c 75 65 20 74 68 to the value th
1fc60 61 74 20 69 74 20 68 65 6c 64 20 61 74 20 74 68 at it held at th
1fc70 65 20 73 74 61 72 74 20 6f 66 20 74 68 65 20 73 e start of the s
1fc80 61 76 65 70 6f 69 6e 74 20 0a 2a 2a 20 28 6f 72 avepoint .** (or
1fc90 20 74 72 61 6e 73 61 63 74 69 6f 6e 29 2e 20 4e transaction). N
1fca0 6f 20 70 61 67 65 20 77 69 74 68 20 61 20 70 61 o page with a pa
1fcb0 67 65 2d 6e 75 6d 62 65 72 20 67 72 65 61 74 65 ge-number greate
1fcc0 72 20 74 68 61 6e 20 74 68 69 73 20 76 61 6c 75 r than this valu
1fcd0 65 0a 2a 2a 20 69 73 20 70 6c 61 79 65 64 20 62 e.** is played b
1fce0 61 63 6b 2e 20 49 66 20 6f 6e 65 20 69 73 20 65 ack. If one is e
1fcf0 6e 63 6f 75 6e 74 65 72 65 64 20 69 74 20 69 73 ncountered it is
1fd00 20 73 69 6d 70 6c 79 20 73 6b 69 70 70 65 64 2e simply skipped.
1fd10 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74 20 70 .*/.static int p
1fd20 61 67 65 72 50 6c 61 79 62 61 63 6b 53 61 76 65 agerPlaybackSave
1fd30 70 6f 69 6e 74 28 50 61 67 65 72 20 2a 70 50 61 point(Pager *pPa
1fd40 67 65 72 2c 20 50 61 67 65 72 53 61 76 65 70 6f ger, PagerSavepo
1fd50 69 6e 74 20 2a 70 53 61 76 65 70 6f 69 6e 74 29 int *pSavepoint)
1fd60 7b 0a 20 20 69 36 34 20 73 7a 4a 3b 20 20 20 20 {. i64 szJ;
1fd70 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 /*
1fd80 45 66 66 65 63 74 69 76 65 20 73 69 7a 65 20 6f Effective size o
1fd90 66 20 74 68 65 20 6d 61 69 6e 20 6a 6f 75 72 6e f the main journ
1fda0 61 6c 20 2a 2f 0a 20 20 69 36 34 20 69 48 64 72 al */. i64 iHdr
1fdb0 4f 66 66 3b 20 20 20 20 20 20 20 20 20 20 20 20 Off;
1fdc0 20 2f 2a 20 45 6e 64 20 6f 66 20 66 69 72 73 74 /* End of first
1fdd0 20 73 65 67 6d 65 6e 74 20 6f 66 20 6d 61 69 6e segment of main
1fde0 2d 6a 6f 75 72 6e 61 6c 20 72 65 63 6f 72 64 73 -journal records
1fdf0 20 2a 2f 0a 20 20 69 6e 74 20 72 63 20 3d 20 53 */. int rc = S
1fe00 51 4c 49 54 45 5f 4f 4b 3b 20 20 20 20 20 20 2f QLITE_OK; /
1fe10 2a 20 52 65 74 75 72 6e 20 63 6f 64 65 20 2a 2f * Return code */
1fe20 0a 20 20 42 69 74 76 65 63 20 2a 70 44 6f 6e 65 . Bitvec *pDone
1fe30 20 3d 20 30 3b 20 20 20 20 20 20 20 2f 2a 20 42 = 0; /* B
1fe40 69 74 76 65 63 20 74 6f 20 65 6e 73 75 72 65 20 itvec to ensure
1fe50 70 61 67 65 73 20 70 6c 61 79 65 64 20 62 61 63 pages played bac
1fe60 6b 20 6f 6e 6c 79 20 6f 6e 63 65 20 2a 2f 0a 0a k only once */..
1fe70 20 20 61 73 73 65 72 74 28 20 70 50 61 67 65 72 assert( pPager
1fe80 2d 3e 65 53 74 61 74 65 21 3d 50 41 47 45 52 5f ->eState!=PAGER_
1fe90 45 52 52 4f 52 20 29 3b 0a 20 20 61 73 73 65 72 ERROR );. asser
1fea0 74 28 20 70 50 61 67 65 72 2d 3e 65 53 74 61 74 t( pPager->eStat
1feb0 65 3e 3d 50 41 47 45 52 5f 57 52 49 54 45 52 5f e>=PAGER_WRITER_
1fec0 4c 4f 43 4b 45 44 20 29 3b 0a 0a 20 20 2f 2a 20 LOCKED );.. /*
1fed0 41 6c 6c 6f 63 61 74 65 20 61 20 62 69 74 76 65 Allocate a bitve
1fee0 63 20 74 6f 20 75 73 65 20 74 6f 20 73 74 6f 72 c to use to stor
1fef0 65 20 74 68 65 20 73 65 74 20 6f 66 20 70 61 67 e the set of pag
1ff00 65 73 20 72 6f 6c 6c 65 64 20 62 61 63 6b 20 2a es rolled back *
1ff10 2f 0a 20 20 69 66 28 20 70 53 61 76 65 70 6f 69 /. if( pSavepoi
1ff20 6e 74 20 29 7b 0a 20 20 20 20 70 44 6f 6e 65 20 nt ){. pDone
1ff30 3d 20 73 71 6c 69 74 65 33 42 69 74 76 65 63 43 = sqlite3BitvecC
1ff40 72 65 61 74 65 28 70 53 61 76 65 70 6f 69 6e 74 reate(pSavepoint
1ff50 2d 3e 6e 4f 72 69 67 29 3b 0a 20 20 20 20 69 66 ->nOrig);. if
1ff60 28 20 21 70 44 6f 6e 65 20 29 7b 0a 20 20 20 20 ( !pDone ){.
1ff70 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f return SQLITE_
1ff80 4e 4f 4d 45 4d 3b 0a 20 20 20 20 7d 0a 20 20 7d NOMEM;. }. }
1ff90 0a 0a 20 20 2f 2a 20 53 65 74 20 74 68 65 20 64 .. /* Set the d
1ffa0 61 74 61 62 61 73 65 20 73 69 7a 65 20 62 61 63 atabase size bac
1ffb0 6b 20 74 6f 20 74 68 65 20 76 61 6c 75 65 20 69 k to the value i
1ffc0 74 20 77 61 73 20 62 65 66 6f 72 65 20 74 68 65 t was before the
1ffd0 20 73 61 76 65 70 6f 69 6e 74 20 0a 20 20 2a 2a savepoint . **
1ffe0 20 62 65 69 6e 67 20 72 65 76 65 72 74 65 64 20 being reverted
1fff0 77 61 73 20 6f 70 65 6e 65 64 2e 0a 20 20 2a 2f was opened.. */
20000 0a 20 20 70 50 61 67 65 72 2d 3e 64 62 53 69 7a . pPager->dbSiz
20010 65 20 3d 20 70 53 61 76 65 70 6f 69 6e 74 20 3f e = pSavepoint ?
20020 20 70 53 61 76 65 70 6f 69 6e 74 2d 3e 6e 4f 72 pSavepoint->nOr
20030 69 67 20 3a 20 70 50 61 67 65 72 2d 3e 64 62 4f ig : pPager->dbO
20040 72 69 67 53 69 7a 65 3b 0a 20 20 70 50 61 67 65 rigSize;. pPage
20050 72 2d 3e 63 68 61 6e 67 65 43 6f 75 6e 74 44 6f r->changeCountDo
20060 6e 65 20 3d 20 70 50 61 67 65 72 2d 3e 74 65 6d ne = pPager->tem
20070 70 46 69 6c 65 3b 0a 0a 20 20 69 66 28 20 21 70 pFile;.. if( !p
20080 53 61 76 65 70 6f 69 6e 74 20 26 26 20 70 61 67 Savepoint && pag
20090 65 72 55 73 65 57 61 6c 28 70 50 61 67 65 72 29 erUseWal(pPager)
200a0 20 29 7b 0a 20 20 20 20 72 65 74 75 72 6e 20 70 ){. return p
200b0 61 67 65 72 52 6f 6c 6c 62 61 63 6b 57 61 6c 28 agerRollbackWal(
200c0 70 50 61 67 65 72 29 3b 0a 20 20 7d 0a 0a 20 20 pPager);. }..
200d0 2f 2a 20 55 73 65 20 70 50 61 67 65 72 2d 3e 6a /* Use pPager->j
200e0 6f 75 72 6e 61 6c 4f 66 66 20 61 73 20 74 68 65 ournalOff as the
200f0 20 65 66 66 65 63 74 69 76 65 20 73 69 7a 65 20 effective size
20100 6f 66 20 74 68 65 20 6d 61 69 6e 20 72 6f 6c 6c of the main roll
20110 62 61 63 6b 0a 20 20 2a 2a 20 6a 6f 75 72 6e 61 back. ** journa
20120 6c 2e 20 20 54 68 65 20 61 63 74 75 61 6c 20 66 l. The actual f
20130 69 6c 65 20 6d 69 67 68 74 20 62 65 20 6c 61 72 ile might be lar
20140 67 65 72 20 74 68 61 6e 20 74 68 69 73 20 69 6e ger than this in
20150 0a 20 20 2a 2a 20 50 41 47 45 52 5f 4a 4f 55 52 . ** PAGER_JOUR
20160 4e 41 4c 4d 4f 44 45 5f 54 52 55 4e 43 41 54 45 NALMODE_TRUNCATE
20170 20 6f 72 20 50 41 47 45 52 5f 4a 4f 55 52 4e 41 or PAGER_JOURNA
20180 4c 4d 4f 44 45 5f 50 45 52 53 49 53 54 2e 20 20 LMODE_PERSIST.
20190 42 75 74 20 61 6e 79 74 68 69 6e 67 0a 20 20 2a But anything. *
201a0 2a 20 70 61 73 74 20 70 50 61 67 65 72 2d 3e 6a * past pPager->j
201b0 6f 75 72 6e 61 6c 4f 66 66 20 69 73 20 6f 66 66 ournalOff is off
201c0 2d 6c 69 6d 69 74 73 20 74 6f 20 75 73 2e 0a 20 -limits to us..
201d0 20 2a 2f 0a 20 20 73 7a 4a 20 3d 20 70 50 61 67 */. szJ = pPag
201e0 65 72 2d 3e 6a 6f 75 72 6e 61 6c 4f 66 66 3b 0a er->journalOff;.
201f0 20 20 61 73 73 65 72 74 28 20 70 61 67 65 72 55 assert( pagerU
20200 73 65 57 61 6c 28 70 50 61 67 65 72 29 3d 3d 30 seWal(pPager)==0
20210 20 7c 7c 20 73 7a 4a 3d 3d 30 20 29 3b 0a 0a 20 || szJ==0 );..
20220 20 2f 2a 20 42 65 67 69 6e 20 62 79 20 72 6f 6c /* Begin by rol
20230 6c 69 6e 67 20 62 61 63 6b 20 72 65 63 6f 72 64 ling back record
20240 73 20 66 72 6f 6d 20 74 68 65 20 6d 61 69 6e 20 s from the main
20250 6a 6f 75 72 6e 61 6c 20 73 74 61 72 74 69 6e 67 journal starting
20260 20 61 74 0a 20 20 2a 2a 20 50 61 67 65 72 53 61 at. ** PagerSa
20270 76 65 70 6f 69 6e 74 2e 69 4f 66 66 73 65 74 20 vepoint.iOffset
20280 61 6e 64 20 63 6f 6e 74 69 6e 75 69 6e 67 20 74 and continuing t
20290 6f 20 74 68 65 20 6e 65 78 74 20 6a 6f 75 72 6e o the next journ
202a0 61 6c 20 68 65 61 64 65 72 2e 0a 20 20 2a 2a 20 al header.. **
202b0 54 68 65 72 65 20 6d 69 67 68 74 20 62 65 20 72 There might be r
202c0 65 63 6f 72 64 73 20 69 6e 20 74 68 65 20 6d 61 ecords in the ma
202d0 69 6e 20 6a 6f 75 72 6e 61 6c 20 74 68 61 74 20 in journal that
202e0 68 61 76 65 20 61 20 70 61 67 65 20 6e 75 6d 62 have a page numb
202f0 65 72 0a 20 20 2a 2a 20 67 72 65 61 74 65 72 20 er. ** greater
20300 74 68 61 6e 20 74 68 65 20 63 75 72 72 65 6e 74 than the current
20310 20 64 61 74 61 62 61 73 65 20 73 69 7a 65 20 28 database size (
20320 70 50 61 67 65 72 2d 3e 64 62 53 69 7a 65 29 20 pPager->dbSize)
20330 62 75 74 20 74 68 6f 73 65 0a 20 20 2a 2a 20 77 but those. ** w
20340 69 6c 6c 20 62 65 20 73 6b 69 70 70 65 64 20 61 ill be skipped a
20350 75 74 6f 6d 61 74 69 63 61 6c 6c 79 2e 20 20 50 utomatically. P
20360 61 67 65 73 20 61 72 65 20 61 64 64 65 64 20 74 ages are added t
20370 6f 20 70 44 6f 6e 65 20 61 73 20 74 68 65 79 0a o pDone as they.
20380 20 20 2a 2a 20 61 72 65 20 70 6c 61 79 65 64 20 ** are played
20390 62 61 63 6b 2e 0a 20 20 2a 2f 0a 20 20 69 66 28 back.. */. if(
203a0 20 70 53 61 76 65 70 6f 69 6e 74 20 26 26 20 21 pSavepoint && !
203b0 70 61 67 65 72 55 73 65 57 61 6c 28 70 50 61 67 pagerUseWal(pPag
203c0 65 72 29 20 29 7b 0a 20 20 20 20 69 48 64 72 4f er) ){. iHdrO
203d0 66 66 20 3d 20 70 53 61 76 65 70 6f 69 6e 74 2d ff = pSavepoint-
203e0 3e 69 48 64 72 4f 66 66 73 65 74 20 3f 20 70 53 >iHdrOffset ? pS
203f0 61 76 65 70 6f 69 6e 74 2d 3e 69 48 64 72 4f 66 avepoint->iHdrOf
20400 66 73 65 74 20 3a 20 73 7a 4a 3b 0a 20 20 20 20 fset : szJ;.
20410 70 50 61 67 65 72 2d 3e 6a 6f 75 72 6e 61 6c 4f pPager->journalO
20420 66 66 20 3d 20 70 53 61 76 65 70 6f 69 6e 74 2d ff = pSavepoint-
20430 3e 69 4f 66 66 73 65 74 3b 0a 20 20 20 20 77 68 >iOffset;. wh
20440 69 6c 65 28 20 72 63 3d 3d 53 51 4c 49 54 45 5f ile( rc==SQLITE_
20450 4f 4b 20 26 26 20 70 50 61 67 65 72 2d 3e 6a 6f OK && pPager->jo
20460 75 72 6e 61 6c 4f 66 66 3c 69 48 64 72 4f 66 66 urnalOff<iHdrOff
20470 20 29 7b 0a 20 20 20 20 20 20 72 63 20 3d 20 70 ){. rc = p
20480 61 67 65 72 5f 70 6c 61 79 62 61 63 6b 5f 6f 6e ager_playback_on
20490 65 5f 70 61 67 65 28 70 50 61 67 65 72 2c 20 26 e_page(pPager, &
204a0 70 50 61 67 65 72 2d 3e 6a 6f 75 72 6e 61 6c 4f pPager->journalO
204b0 66 66 2c 20 70 44 6f 6e 65 2c 20 31 2c 20 31 29 ff, pDone, 1, 1)
204c0 3b 0a 20 20 20 20 7d 0a 20 20 20 20 61 73 73 65 ;. }. asse
204d0 72 74 28 20 72 63 21 3d 53 51 4c 49 54 45 5f 44 rt( rc!=SQLITE_D
204e0 4f 4e 45 20 29 3b 0a 20 20 7d 65 6c 73 65 7b 0a ONE );. }else{.
204f0 20 20 20 20 70 50 61 67 65 72 2d 3e 6a 6f 75 72 pPager->jour
20500 6e 61 6c 4f 66 66 20 3d 20 30 3b 0a 20 20 7d 0a nalOff = 0;. }.
20510 0a 20 20 2f 2a 20 43 6f 6e 74 69 6e 75 65 20 72 . /* Continue r
20520 6f 6c 6c 69 6e 67 20 62 61 63 6b 20 72 65 63 6f olling back reco
20530 72 64 73 20 6f 75 74 20 6f 66 20 74 68 65 20 6d rds out of the m
20540 61 69 6e 20 6a 6f 75 72 6e 61 6c 20 73 74 61 72 ain journal star
20550 74 69 6e 67 20 61 74 0a 20 20 2a 2a 20 74 68 65 ting at. ** the
20560 20 66 69 72 73 74 20 6a 6f 75 72 6e 61 6c 20 68 first journal h
20570 65 61 64 65 72 20 73 65 65 6e 20 61 6e 64 20 63 eader seen and c
20580 6f 6e 74 69 6e 75 69 6e 67 20 75 6e 74 69 6c 20 ontinuing until
20590 74 68 65 20 65 66 66 65 63 74 69 76 65 20 65 6e the effective en
205a0 64 0a 20 20 2a 2a 20 6f 66 20 74 68 65 20 6d 61 d. ** of the ma
205b0 69 6e 20 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 2e in journal file.
205c0 20 20 43 6f 6e 74 69 6e 75 65 20 74 6f 20 73 6b Continue to sk
205d0 69 70 20 6f 75 74 2d 6f 66 2d 72 61 6e 67 65 20 ip out-of-range
205e0 70 61 67 65 73 20 61 6e 64 0a 20 20 2a 2a 20 63 pages and. ** c
205f0 6f 6e 74 69 6e 75 65 20 61 64 64 69 6e 67 20 70 ontinue adding p
20600 61 67 65 73 20 72 6f 6c 6c 65 64 20 62 61 63 6b ages rolled back
20610 20 74 6f 20 70 44 6f 6e 65 2e 0a 20 20 2a 2f 0a to pDone.. */.
20620 20 20 77 68 69 6c 65 28 20 72 63 3d 3d 53 51 4c while( rc==SQL
20630 49 54 45 5f 4f 4b 20 26 26 20 70 50 61 67 65 72 ITE_OK && pPager
20640 2d 3e 6a 6f 75 72 6e 61 6c 4f 66 66 3c 73 7a 4a ->journalOff<szJ
20650 20 29 7b 0a 20 20 20 20 75 33 32 20 69 69 3b 20 ){. u32 ii;
20660 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4c 6f /* Lo
20670 6f 70 20 63 6f 75 6e 74 65 72 20 2a 2f 0a 20 20 op counter */.
20680 20 20 75 33 32 20 6e 4a 52 65 63 20 3d 20 30 3b u32 nJRec = 0;
20690 20 20 20 20 20 2f 2a 20 4e 75 6d 62 65 72 20 6f /* Number o
206a0 66 20 4a 6f 75 72 6e 61 6c 20 52 65 63 6f 72 64 f Journal Record
206b0 73 20 2a 2f 0a 20 20 20 20 75 33 32 20 64 75 6d s */. u32 dum
206c0 6d 79 3b 0a 20 20 20 20 72 63 20 3d 20 72 65 61 my;. rc = rea
206d0 64 4a 6f 75 72 6e 61 6c 48 64 72 28 70 50 61 67 dJournalHdr(pPag
206e0 65 72 2c 20 30 2c 20 73 7a 4a 2c 20 26 6e 4a 52 er, 0, szJ, &nJR
206f0 65 63 2c 20 26 64 75 6d 6d 79 29 3b 0a 20 20 20 ec, &dummy);.
20700 20 61 73 73 65 72 74 28 20 72 63 21 3d 53 51 4c assert( rc!=SQL
20710 49 54 45 5f 44 4f 4e 45 20 29 3b 0a 0a 20 20 20 ITE_DONE );..
20720 20 2f 2a 0a 20 20 20 20 2a 2a 20 54 68 65 20 22 /*. ** The "
20730 70 50 61 67 65 72 2d 3e 6a 6f 75 72 6e 61 6c 48 pPager->journalH
20740 64 72 2b 4a 4f 55 52 4e 41 4c 5f 48 44 52 5f 53 dr+JOURNAL_HDR_S
20750 5a 28 70 50 61 67 65 72 29 3d 3d 70 50 61 67 65 Z(pPager)==pPage
20760 72 2d 3e 6a 6f 75 72 6e 61 6c 4f 66 66 22 0a 20 r->journalOff".
20770 20 20 20 2a 2a 20 74 65 73 74 20 69 73 20 72 65 ** test is re
20780 6c 61 74 65 64 20 74 6f 20 74 69 63 6b 65 74 20 lated to ticket
20790 23 32 35 36 35 2e 20 20 53 65 65 20 74 68 65 20 #2565. See the
207a0 64 69 73 63 75 73 73 69 6f 6e 20 69 6e 20 74 68 discussion in th
207b0 65 0a 20 20 20 20 2a 2a 20 70 61 67 65 72 5f 70 e. ** pager_p
207c0 6c 61 79 62 61 63 6b 28 29 20 66 75 6e 63 74 69 layback() functi
207d0 6f 6e 20 66 6f 72 20 61 64 64 69 74 69 6f 6e 61 on for additiona
207e0 6c 20 69 6e 66 6f 72 6d 61 74 69 6f 6e 2e 0a 20 l information..
207f0 20 20 20 2a 2f 0a 20 20 20 20 69 66 28 20 6e 4a */. if( nJ
20800 52 65 63 3d 3d 30 20 0a 20 20 20 20 20 26 26 20 Rec==0 . &&
20810 70 50 61 67 65 72 2d 3e 6a 6f 75 72 6e 61 6c 48 pPager->journalH
20820 64 72 2b 4a 4f 55 52 4e 41 4c 5f 48 44 52 5f 53 dr+JOURNAL_HDR_S
20830 5a 28 70 50 61 67 65 72 29 3d 3d 70 50 61 67 65 Z(pPager)==pPage
20840 72 2d 3e 6a 6f 75 72 6e 61 6c 4f 66 66 0a 20 20 r->journalOff.
20850 20 20 29 7b 0a 20 20 20 20 20 20 6e 4a 52 65 63 ){. nJRec
20860 20 3d 20 28 75 33 32 29 28 28 73 7a 4a 20 2d 20 = (u32)((szJ -
20870 70 50 61 67 65 72 2d 3e 6a 6f 75 72 6e 61 6c 4f pPager->journalO
20880 66 66 29 2f 4a 4f 55 52 4e 41 4c 5f 50 47 5f 53 ff)/JOURNAL_PG_S
20890 5a 28 70 50 61 67 65 72 29 29 3b 0a 20 20 20 20 Z(pPager));.
208a0 7d 0a 20 20 20 20 66 6f 72 28 69 69 3d 30 3b 20 }. for(ii=0;
208b0 72 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 26 26 rc==SQLITE_OK &&
208c0 20 69 69 3c 6e 4a 52 65 63 20 26 26 20 70 50 61 ii<nJRec && pPa
208d0 67 65 72 2d 3e 6a 6f 75 72 6e 61 6c 4f 66 66 3c ger->journalOff<
208e0 73 7a 4a 3b 20 69 69 2b 2b 29 7b 0a 20 20 20 20 szJ; ii++){.
208f0 20 20 72 63 20 3d 20 70 61 67 65 72 5f 70 6c 61 rc = pager_pla
20900 79 62 61 63 6b 5f 6f 6e 65 5f 70 61 67 65 28 70 yback_one_page(p
20910 50 61 67 65 72 2c 20 26 70 50 61 67 65 72 2d 3e Pager, &pPager->
20920 6a 6f 75 72 6e 61 6c 4f 66 66 2c 20 70 44 6f 6e journalOff, pDon
20930 65 2c 20 31 2c 20 31 29 3b 0a 20 20 20 20 7d 0a e, 1, 1);. }.
20940 20 20 20 20 61 73 73 65 72 74 28 20 72 63 21 3d assert( rc!=
20950 53 51 4c 49 54 45 5f 44 4f 4e 45 20 29 3b 0a 20 SQLITE_DONE );.
20960 20 7d 0a 20 20 61 73 73 65 72 74 28 20 72 63 21 }. assert( rc!
20970 3d 53 51 4c 49 54 45 5f 4f 4b 20 7c 7c 20 70 50 =SQLITE_OK || pP
20980 61 67 65 72 2d 3e 6a 6f 75 72 6e 61 6c 4f 66 66 ager->journalOff
20990 3e 3d 73 7a 4a 20 29 3b 0a 0a 20 20 2f 2a 20 46 >=szJ );.. /* F
209a0 69 6e 61 6c 6c 79 2c 20 20 72 6f 6c 6c 62 61 63 inally, rollbac
209b0 6b 20 70 61 67 65 73 20 66 72 6f 6d 20 74 68 65 k pages from the
209c0 20 73 75 62 2d 6a 6f 75 72 6e 61 6c 2e 20 20 50 sub-journal. P
209d0 61 67 65 20 74 68 61 74 20 77 65 72 65 0a 20 20 age that were.
209e0 2a 2a 20 70 72 65 76 69 6f 75 73 6c 79 20 72 6f ** previously ro
209f0 6c 6c 65 64 20 62 61 63 6b 20 6f 75 74 20 6f 66 lled back out of
20a00 20 74 68 65 20 6d 61 69 6e 20 6a 6f 75 72 6e 61 the main journa
20a10 6c 20 28 61 6e 64 20 61 72 65 20 68 65 6e 63 65 l (and are hence
20a20 20 69 6e 20 70 44 6f 6e 65 29 0a 20 20 2a 2a 20 in pDone). **
20a30 77 69 6c 6c 20 62 65 20 73 6b 69 70 70 65 64 2e will be skipped.
20a40 20 20 4f 75 74 2d 6f 66 2d 72 61 6e 67 65 20 70 Out-of-range p
20a50 61 67 65 73 20 61 72 65 20 61 6c 73 6f 20 73 6b ages are also sk
20a60 69 70 70 65 64 2e 0a 20 20 2a 2f 0a 20 20 69 66 ipped.. */. if
20a70 28 20 70 53 61 76 65 70 6f 69 6e 74 20 29 7b 0a ( pSavepoint ){.
20a80 20 20 20 20 75 33 32 20 69 69 3b 20 20 20 20 20 u32 ii;
20a90 20 20 20 20 20 20 20 2f 2a 20 4c 6f 6f 70 20 63 /* Loop c
20aa0 6f 75 6e 74 65 72 20 2a 2f 0a 20 20 20 20 69 36 ounter */. i6
20ab0 34 20 6f 66 66 73 65 74 20 3d 20 70 53 61 76 65 4 offset = pSave
20ac0 70 6f 69 6e 74 2d 3e 69 53 75 62 52 65 63 2a 28 point->iSubRec*(
20ad0 34 2b 70 50 61 67 65 72 2d 3e 70 61 67 65 53 69 4+pPager->pageSi
20ae0 7a 65 29 3b 0a 0a 20 20 20 20 69 66 28 20 70 61 ze);.. if( pa
20af0 67 65 72 55 73 65 57 61 6c 28 70 50 61 67 65 72 gerUseWal(pPager
20b00 29 20 29 7b 0a 20 20 20 20 20 20 72 63 20 3d 20 ) ){. rc =
20b10 73 71 6c 69 74 65 33 57 61 6c 53 61 76 65 70 6f sqlite3WalSavepo
20b20 69 6e 74 55 6e 64 6f 28 70 50 61 67 65 72 2d 3e intUndo(pPager->
20b30 70 57 61 6c 2c 20 70 53 61 76 65 70 6f 69 6e 74 pWal, pSavepoint
20b40 2d 3e 61 57 61 6c 44 61 74 61 29 3b 0a 20 20 20 ->aWalData);.
20b50 20 7d 0a 20 20 20 20 66 6f 72 28 69 69 3d 70 53 }. for(ii=pS
20b60 61 76 65 70 6f 69 6e 74 2d 3e 69 53 75 62 52 65 avepoint->iSubRe
20b70 63 3b 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b c; rc==SQLITE_OK
20b80 20 26 26 20 69 69 3c 70 50 61 67 65 72 2d 3e 6e && ii<pPager->n
20b90 53 75 62 52 65 63 3b 20 69 69 2b 2b 29 7b 0a 20 SubRec; ii++){.
20ba0 20 20 20 20 20 61 73 73 65 72 74 28 20 6f 66 66 assert( off
20bb0 73 65 74 3d 3d 69 69 2a 28 34 2b 70 50 61 67 65 set==ii*(4+pPage
20bc0 72 2d 3e 70 61 67 65 53 69 7a 65 29 20 29 3b 0a r->pageSize) );.
20bd0 20 20 20 20 20 20 72 63 20 3d 20 70 61 67 65 72 rc = pager
20be0 5f 70 6c 61 79 62 61 63 6b 5f 6f 6e 65 5f 70 61 _playback_one_pa
20bf0 67 65 28 70 50 61 67 65 72 2c 20 26 6f 66 66 73 ge(pPager, &offs
20c00 65 74 2c 20 70 44 6f 6e 65 2c 20 30 2c 20 31 29 et, pDone, 0, 1)
20c10 3b 0a 20 20 20 20 7d 0a 20 20 20 20 61 73 73 65 ;. }. asse
20c20 72 74 28 20 72 63 21 3d 53 51 4c 49 54 45 5f 44 rt( rc!=SQLITE_D
20c30 4f 4e 45 20 29 3b 0a 20 20 7d 0a 0a 20 20 73 71 ONE );. }.. sq
20c40 6c 69 74 65 33 42 69 74 76 65 63 44 65 73 74 72 lite3BitvecDestr
20c50 6f 79 28 70 44 6f 6e 65 29 3b 0a 20 20 69 66 28 oy(pDone);. if(
20c60 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 rc==SQLITE_OK )
20c70 7b 0a 20 20 20 20 70 50 61 67 65 72 2d 3e 6a 6f {. pPager->jo
20c80 75 72 6e 61 6c 4f 66 66 20 3d 20 73 7a 4a 3b 0a urnalOff = szJ;.
20c90 20 20 7d 0a 0a 20 20 72 65 74 75 72 6e 20 72 63 }.. return rc
20ca0 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 43 68 61 6e 67 ;.}../*.** Chang
20cb0 65 20 74 68 65 20 6d 61 78 69 6d 75 6d 20 6e 75 e the maximum nu
20cc0 6d 62 65 72 20 6f 66 20 69 6e 2d 6d 65 6d 6f 72 mber of in-memor
20cd0 79 20 70 61 67 65 73 20 74 68 61 74 20 61 72 65 y pages that are
20ce0 20 61 6c 6c 6f 77 65 64 2e 0a 2a 2f 0a 76 6f 69 allowed..*/.voi
20cf0 64 20 73 71 6c 69 74 65 33 50 61 67 65 72 53 65 d sqlite3PagerSe
20d00 74 43 61 63 68 65 73 69 7a 65 28 50 61 67 65 72 tCachesize(Pager
20d10 20 2a 70 50 61 67 65 72 2c 20 69 6e 74 20 6d 78 *pPager, int mx
20d20 50 61 67 65 29 7b 0a 20 20 73 71 6c 69 74 65 33 Page){. sqlite3
20d30 50 63 61 63 68 65 53 65 74 43 61 63 68 65 73 69 PcacheSetCachesi
20d40 7a 65 28 70 50 61 67 65 72 2d 3e 70 50 43 61 63 ze(pPager->pPCac
20d50 68 65 2c 20 6d 78 50 61 67 65 29 3b 0a 7d 0a 0a he, mxPage);.}..
20d60 2f 2a 0a 2a 2a 20 41 64 6a 75 73 74 20 74 68 65 /*.** Adjust the
20d70 20 72 6f 62 75 73 74 6e 65 73 73 20 6f 66 20 74 robustness of t
20d80 68 65 20 64 61 74 61 62 61 73 65 20 74 6f 20 64 he database to d
20d90 61 6d 61 67 65 20 64 75 65 20 74 6f 20 4f 53 20 amage due to OS
20da0 63 72 61 73 68 65 73 0a 2a 2a 20 6f 72 20 70 6f crashes.** or po
20db0 77 65 72 20 66 61 69 6c 75 72 65 73 20 62 79 20 wer failures by
20dc0 63 68 61 6e 67 69 6e 67 20 74 68 65 20 6e 75 6d changing the num
20dd0 62 65 72 20 6f 66 20 73 79 6e 63 73 28 29 73 20 ber of syncs()s
20de0 77 68 65 6e 20 77 72 69 74 69 6e 67 0a 2a 2a 20 when writing.**
20df0 74 68 65 20 72 6f 6c 6c 62 61 63 6b 20 6a 6f 75 the rollback jou
20e00 72 6e 61 6c 2e 20 20 54 68 65 72 65 20 61 72 65 rnal. There are
20e10 20 74 68 72 65 65 20 6c 65 76 65 6c 73 3a 0a 2a three levels:.*
20e20 2a 0a 2a 2a 20 20 20 20 4f 46 46 20 20 20 20 20 *.** OFF
20e30 20 20 73 71 6c 69 74 65 33 4f 73 53 79 6e 63 28 sqlite3OsSync(
20e40 29 20 69 73 20 6e 65 76 65 72 20 63 61 6c 6c 65 ) is never calle
20e50 64 2e 20 20 54 68 69 73 20 69 73 20 74 68 65 20 d. This is the
20e60 64 65 66 61 75 6c 74 0a 2a 2a 20 20 20 20 20 20 default.**
20e70 20 20 20 20 20 20 20 20 66 6f 72 20 74 65 6d 70 for temp
20e80 6f 72 61 72 79 20 61 6e 64 20 74 72 61 6e 73 69 orary and transi
20e90 65 6e 74 20 66 69 6c 65 73 2e 0a 2a 2a 0a 2a 2a ent files..**.**
20ea0 20 20 20 20 4e 4f 52 4d 41 4c 20 20 20 20 54 68 NORMAL Th
20eb0 65 20 6a 6f 75 72 6e 61 6c 20 69 73 20 73 79 6e e journal is syn
20ec0 63 65 64 20 6f 6e 63 65 20 62 65 66 6f 72 65 20 ced once before
20ed0 77 72 69 74 65 73 20 62 65 67 69 6e 20 6f 6e 20 writes begin on
20ee0 74 68 65 0a 2a 2a 20 20 20 20 20 20 20 20 20 20 the.**
20ef0 20 20 20 20 64 61 74 61 62 61 73 65 2e 20 20 54 database. T
20f00 68 69 73 20 69 73 20 6e 6f 72 6d 61 6c 6c 79 20 his is normally
20f10 61 64 65 71 75 61 74 65 20 70 72 6f 74 65 63 74 adequate protect
20f20 69 6f 6e 2c 20 62 75 74 0a 2a 2a 20 20 20 20 20 ion, but.**
20f30 20 20 20 20 20 20 20 20 20 69 74 20 69 73 20 74 it is t
20f40 68 65 6f 72 65 74 69 63 61 6c 6c 79 20 70 6f 73 heoretically pos
20f50 73 69 62 6c 65 2c 20 74 68 6f 75 67 68 20 76 65 sible, though ve
20f60 72 79 20 75 6e 6c 69 6b 65 6c 79 2c 0a 2a 2a 20 ry unlikely,.**
20f70 20 20 20 20 20 20 20 20 20 20 20 20 20 74 68 61 tha
20f80 74 20 61 6e 20 69 6e 6f 70 65 72 74 75 6e 65 20 t an inopertune
20f90 70 6f 77 65 72 20 66 61 69 6c 75 72 65 20 63 6f power failure co
20fa0 75 6c 64 20 6c 65 61 76 65 20 74 68 65 20 6a 6f uld leave the jo
20fb0 75 72 6e 61 6c 0a 2a 2a 20 20 20 20 20 20 20 20 urnal.**
20fc0 20 20 20 20 20 20 69 6e 20 61 20 73 74 61 74 65 in a state
20fd0 20 77 68 69 63 68 20 77 6f 75 6c 64 20 63 61 75 which would cau
20fe0 73 65 20 64 61 6d 61 67 65 20 74 6f 20 74 68 65 se damage to the
20ff0 20 64 61 74 61 62 61 73 65 0a 2a 2a 20 20 20 20 database.**
21000 20 20 20 20 20 20 20 20 20 20 77 68 65 6e 20 69 when i
21010 74 20 69 73 20 72 6f 6c 6c 65 64 20 62 61 63 6b t is rolled back
21020 2e 0a 2a 2a 0a 2a 2a 20 20 20 20 46 55 4c 4c 20 ..**.** FULL
21030 20 20 20 20 20 54 68 65 20 6a 6f 75 72 6e 61 6c The journal
21040 20 69 73 20 73 79 6e 63 65 64 20 74 77 69 63 65 is synced twice
21050 20 62 65 66 6f 72 65 20 77 72 69 74 65 73 20 62 before writes b
21060 65 67 69 6e 20 6f 6e 20 74 68 65 0a 2a 2a 20 20 egin on the.**
21070 20 20 20 20 20 20 20 20 20 20 20 20 64 61 74 61 data
21080 62 61 73 65 20 28 77 69 74 68 20 73 6f 6d 65 20 base (with some
21090 61 64 64 69 74 69 6f 6e 61 6c 20 69 6e 66 6f 72 additional infor
210a0 6d 61 74 69 6f 6e 20 2d 20 74 68 65 20 6e 52 65 mation - the nRe
210b0 63 20 66 69 65 6c 64 0a 2a 2a 20 20 20 20 20 20 c field.**
210c0 20 20 20 20 20 20 20 20 6f 66 20 74 68 65 20 6a of the j
210d0 6f 75 72 6e 61 6c 20 68 65 61 64 65 72 20 2d 20 ournal header -
210e0 62 65 69 6e 67 20 77 72 69 74 74 65 6e 20 69 6e being written in
210f0 20 62 65 74 77 65 65 6e 20 74 68 65 20 74 77 6f between the two
21100 0a 2a 2a 20 20 20 20 20 20 20 20 20 20 20 20 20 .**
21110 20 73 79 6e 63 73 29 2e 20 20 49 66 20 77 65 20 syncs). If we
21120 61 73 73 75 6d 65 20 74 68 61 74 20 77 72 69 74 assume that writ
21130 69 6e 67 20 61 0a 2a 2a 20 20 20 20 20 20 20 20 ing a.**
21140 20 20 20 20 20 20 73 69 6e 67 6c 65 20 64 69 73 single dis
21150 6b 20 73 65 63 74 6f 72 20 69 73 20 61 74 6f 6d k sector is atom
21160 69 63 2c 20 74 68 65 6e 20 74 68 69 73 20 6d 6f ic, then this mo
21170 64 65 20 70 72 6f 76 69 64 65 73 0a 2a 2a 20 20 de provides.**
21180 20 20 20 20 20 20 20 20 20 20 20 20 61 73 73 75 assu
21190 72 61 6e 63 65 20 74 68 61 74 20 74 68 65 20 6a rance that the j
211a0 6f 75 72 6e 61 6c 20 77 69 6c 6c 20 6e 6f 74 20 ournal will not
211b0 62 65 20 63 6f 72 72 75 70 74 65 64 20 74 6f 20 be corrupted to
211c0 74 68 65 0a 2a 2a 20 20 20 20 20 20 20 20 20 20 the.**
211d0 20 20 20 20 70 6f 69 6e 74 20 6f 66 20 63 61 75 point of cau
211e0 73 69 6e 67 20 64 61 6d 61 67 65 20 74 6f 20 74 sing damage to t
211f0 68 65 20 64 61 74 61 62 61 73 65 20 64 75 72 69 he database duri
21200 6e 67 20 72 6f 6c 6c 62 61 63 6b 2e 0a 2a 2a 0a ng rollback..**.
21210 2a 2a 20 54 68 65 20 61 62 6f 76 65 20 69 73 20 ** The above is
21220 66 6f 72 20 61 20 72 6f 6c 6c 62 61 63 6b 2d 6a for a rollback-j
21230 6f 75 72 6e 61 6c 20 6d 6f 64 65 2e 20 20 46 6f ournal mode. Fo
21240 72 20 57 41 4c 20 6d 6f 64 65 2c 20 4f 46 46 20 r WAL mode, OFF
21250 63 6f 6e 74 69 6e 75 65 73 0a 2a 2a 20 74 6f 20 continues.** to
21260 6d 65 61 6e 20 74 68 61 74 20 6e 6f 20 73 79 6e mean that no syn
21270 63 73 20 65 76 65 72 20 6f 63 63 75 72 2e 20 20 cs ever occur.
21280 4e 4f 52 4d 41 4c 20 6d 65 61 6e 73 20 74 68 61 NORMAL means tha
21290 74 20 74 68 65 20 57 41 4c 20 69 73 20 73 79 6e t the WAL is syn
212a0 63 65 64 0a 2a 2a 20 70 72 69 6f 72 20 74 6f 20 ced.** prior to
212b0 74 68 65 20 73 74 61 72 74 20 6f 66 20 63 68 65 the start of che
212c0 63 6b 70 6f 69 6e 74 20 61 6e 64 20 74 68 61 74 ckpoint and that
212d0 20 74 68 65 20 64 61 74 61 62 61 73 65 20 66 69 the database fi
212e0 6c 65 20 69 73 20 73 79 6e 63 65 64 0a 2a 2a 20 le is synced.**
212f0 61 74 20 74 68 65 20 63 6f 6e 63 6c 75 73 69 6f at the conclusio
21300 6e 20 6f 66 20 74 68 65 20 63 68 65 63 6b 70 6f n of the checkpo
21310 69 6e 74 20 69 66 20 74 68 65 20 65 6e 74 69 72 int if the entir
21320 65 20 63 6f 6e 74 65 6e 74 20 6f 66 20 74 68 65 e content of the
21330 20 57 41 4c 0a 2a 2a 20 77 61 73 20 77 72 69 74 WAL.** was writ
21340 74 65 6e 20 62 61 63 6b 20 69 6e 74 6f 20 74 68 ten back into th
21350 65 20 64 61 74 61 62 61 73 65 2e 20 20 42 75 74 e database. But
21360 20 6e 6f 20 73 79 6e 63 20 6f 70 65 72 61 74 69 no sync operati
21370 6f 6e 73 20 6f 63 63 75 72 20 66 6f 72 0a 2a 2a ons occur for.**
21380 20 61 6e 20 6f 72 64 69 6e 61 72 79 20 63 6f 6d an ordinary com
21390 6d 69 74 20 69 6e 20 4e 4f 52 4d 41 4c 20 6d 6f mit in NORMAL mo
213a0 64 65 20 77 69 74 68 20 57 41 4c 2e 20 20 46 55 de with WAL. FU
213b0 4c 4c 20 6d 65 61 6e 73 20 74 68 61 74 20 74 68 LL means that th
213c0 65 20 57 41 4c 0a 2a 2a 20 66 69 6c 65 20 69 73 e WAL.** file is
213d0 20 73 79 6e 63 65 64 20 66 6f 6c 6c 6f 77 69 6e synced followin
213e0 67 20 65 61 63 68 20 63 6f 6d 6d 69 74 20 6f 70 g each commit op
213f0 65 72 61 74 69 6f 6e 2c 20 69 6e 20 61 64 64 69 eration, in addi
21400 74 69 6f 6e 20 74 6f 20 74 68 65 0a 2a 2a 20 73 tion to the.** s
21410 79 6e 63 73 20 61 73 73 6f 63 69 61 74 65 64 20 yncs associated
21420 77 69 74 68 20 4e 4f 52 4d 41 4c 2e 0a 2a 2a 0a with NORMAL..**.
21430 2a 2a 20 44 6f 20 6e 6f 74 20 63 6f 6e 66 75 73 ** Do not confus
21440 65 20 73 79 6e 63 68 72 6f 6e 6f 75 73 3d 46 55 e synchronous=FU
21450 4c 4c 20 77 69 74 68 20 53 51 4c 49 54 45 5f 53 LL with SQLITE_S
21460 59 4e 43 5f 46 55 4c 4c 2e 20 20 54 68 65 0a 2a YNC_FULL. The.*
21470 2a 20 53 51 4c 49 54 45 5f 53 59 4e 43 5f 46 55 * SQLITE_SYNC_FU
21480 4c 4c 20 6d 61 63 72 6f 20 6d 65 61 6e 73 20 74 LL macro means t
21490 6f 20 75 73 65 20 74 68 65 20 4d 61 63 4f 53 58 o use the MacOSX
214a0 2d 73 74 79 6c 65 20 66 75 6c 6c 2d 66 73 79 6e -style full-fsyn
214b0 63 0a 2a 2a 20 75 73 69 6e 67 20 66 63 6e 74 6c c.** using fcntl
214c0 28 46 5f 46 55 4c 4c 46 53 59 4e 43 29 2e 20 20 (F_FULLFSYNC).
214d0 53 51 4c 49 54 45 5f 53 59 4e 43 5f 4e 4f 52 4d SQLITE_SYNC_NORM
214e0 41 4c 20 6d 65 61 6e 73 20 74 6f 20 64 6f 20 61 AL means to do a
214f0 6e 0a 2a 2a 20 6f 72 64 69 6e 61 72 79 20 66 73 n.** ordinary fs
21500 79 6e 63 28 29 20 63 61 6c 6c 2e 20 20 54 68 65 ync() call. The
21510 72 65 20 69 73 20 6e 6f 20 64 69 66 66 65 72 65 re is no differe
21520 6e 63 65 20 62 65 74 77 65 65 6e 20 53 51 4c 49 nce between SQLI
21530 54 45 5f 53 59 4e 43 5f 46 55 4c 4c 0a 2a 2a 20 TE_SYNC_FULL.**
21540 61 6e 64 20 53 51 4c 49 54 45 5f 53 59 4e 43 5f and SQLITE_SYNC_
21550 4e 4f 52 4d 41 4c 20 6f 6e 20 70 6c 61 74 66 6f NORMAL on platfo
21560 72 6d 73 20 6f 74 68 65 72 20 74 68 61 6e 20 4d rms other than M
21570 61 63 4f 53 58 2e 20 20 42 75 74 20 74 68 65 0a acOSX. But the.
21580 2a 2a 20 73 79 6e 63 68 72 6f 6e 6f 75 73 3d 46 ** synchronous=F
21590 55 4c 4c 20 76 65 72 73 75 73 20 73 79 6e 63 68 ULL versus synch
215a0 72 6f 6e 6f 75 73 3d 4e 4f 52 4d 41 4c 20 73 65 ronous=NORMAL se
215b0 74 74 69 6e 67 20 64 65 74 65 72 6d 69 6e 65 73 tting determines
215c0 20 77 68 65 6e 0a 2a 2a 20 74 68 65 20 78 53 79 when.** the xSy
215d0 6e 63 20 70 72 69 6d 69 74 69 76 65 20 69 73 20 nc primitive is
215e0 63 61 6c 6c 65 64 20 61 6e 64 20 69 73 20 72 65 called and is re
215f0 6c 65 76 61 6e 74 20 74 6f 20 61 6c 6c 20 70 6c levant to all pl
21600 61 74 66 6f 72 6d 73 2e 0a 2a 2a 0a 2a 2a 20 4e atforms..**.** N
21610 75 6d 65 72 69 63 20 76 61 6c 75 65 73 20 61 73 umeric values as
21620 73 6f 63 69 61 74 65 64 20 77 69 74 68 20 74 68 sociated with th
21630 65 73 65 20 73 74 61 74 65 73 20 61 72 65 20 4f ese states are O
21640 46 46 3d 3d 31 2c 20 4e 4f 52 4d 41 4c 3d 32 2c FF==1, NORMAL=2,
21650 0a 2a 2a 20 61 6e 64 20 46 55 4c 4c 3d 33 2e 0a .** and FULL=3..
21660 2a 2f 0a 23 69 66 6e 64 65 66 20 53 51 4c 49 54 */.#ifndef SQLIT
21670 45 5f 4f 4d 49 54 5f 50 41 47 45 52 5f 50 52 41 E_OMIT_PAGER_PRA
21680 47 4d 41 53 0a 76 6f 69 64 20 73 71 6c 69 74 65 GMAS.void sqlite
21690 33 50 61 67 65 72 53 65 74 53 61 66 65 74 79 4c 3PagerSetSafetyL
216a0 65 76 65 6c 28 0a 20 20 50 61 67 65 72 20 2a 70 evel(. Pager *p
216b0 50 61 67 65 72 2c 20 20 20 20 20 20 20 20 2f 2a Pager, /*
216c0 20 54 68 65 20 70 61 67 65 72 20 74 6f 20 73 65 The pager to se
216d0 74 20 73 61 66 65 74 79 20 6c 65 76 65 6c 20 66 t safety level f
216e0 6f 72 20 2a 2f 0a 20 20 69 6e 74 20 6c 65 76 65 or */. int leve
216f0 6c 2c 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a l, /*
21700 20 50 52 41 47 4d 41 20 73 79 6e 63 68 72 6f 6e PRAGMA synchron
21710 6f 75 73 2e 20 20 31 3d 4f 46 46 2c 20 32 3d 4e ous. 1=OFF, 2=N
21720 4f 52 4d 41 4c 2c 20 33 3d 46 55 4c 4c 20 2a 2f ORMAL, 3=FULL */
21730 20 20 0a 20 20 69 6e 74 20 62 46 75 6c 6c 46 73 . int bFullFs
21740 79 6e 63 2c 20 20 20 20 20 20 20 2f 2a 20 50 52 ync, /* PR
21750 41 47 4d 41 20 66 75 6c 6c 66 73 79 6e 63 20 2a AGMA fullfsync *
21760 2f 0a 20 20 69 6e 74 20 62 43 6b 70 74 46 75 6c /. int bCkptFul
21770 6c 46 73 79 6e 63 20 20 20 20 2f 2a 20 50 52 41 lFsync /* PRA
21780 47 4d 41 20 63 68 65 63 6b 70 6f 69 6e 74 5f 66 GMA checkpoint_f
21790 75 6c 6c 66 73 79 6e 63 20 2a 2f 0a 29 7b 0a 20 ullfsync */.){.
217a0 20 61 73 73 65 72 74 28 20 6c 65 76 65 6c 3e 3d assert( level>=
217b0 31 20 26 26 20 6c 65 76 65 6c 3c 3d 33 20 29 3b 1 && level<=3 );
217c0 0a 20 20 70 50 61 67 65 72 2d 3e 6e 6f 53 79 6e . pPager->noSyn
217d0 63 20 3d 20 20 28 6c 65 76 65 6c 3d 3d 31 20 7c c = (level==1 |
217e0 7c 20 70 50 61 67 65 72 2d 3e 74 65 6d 70 46 69 | pPager->tempFi
217f0 6c 65 29 20 3f 31 3a 30 3b 0a 20 20 70 50 61 67 le) ?1:0;. pPag
21800 65 72 2d 3e 66 75 6c 6c 53 79 6e 63 20 3d 20 28 er->fullSync = (
21810 6c 65 76 65 6c 3d 3d 33 20 26 26 20 21 70 50 61 level==3 && !pPa
21820 67 65 72 2d 3e 74 65 6d 70 46 69 6c 65 29 20 3f ger->tempFile) ?
21830 31 3a 30 3b 0a 20 20 69 66 28 20 70 50 61 67 65 1:0;. if( pPage
21840 72 2d 3e 6e 6f 53 79 6e 63 20 29 7b 0a 20 20 20 r->noSync ){.
21850 20 70 50 61 67 65 72 2d 3e 73 79 6e 63 46 6c 61 pPager->syncFla
21860 67 73 20 3d 20 30 3b 0a 20 20 20 20 70 50 61 67 gs = 0;. pPag
21870 65 72 2d 3e 63 6b 70 74 53 79 6e 63 46 6c 61 67 er->ckptSyncFlag
21880 73 20 3d 20 30 3b 0a 20 20 7d 65 6c 73 65 20 69 s = 0;. }else i
21890 66 28 20 62 46 75 6c 6c 46 73 79 6e 63 20 29 7b f( bFullFsync ){
218a0 0a 20 20 20 20 70 50 61 67 65 72 2d 3e 73 79 6e . pPager->syn
218b0 63 46 6c 61 67 73 20 3d 20 53 51 4c 49 54 45 5f cFlags = SQLITE_
218c0 53 59 4e 43 5f 46 55 4c 4c 3b 0a 20 20 20 20 70 SYNC_FULL;. p
218d0 50 61 67 65 72 2d 3e 63 6b 70 74 53 79 6e 63 46 Pager->ckptSyncF
218e0 6c 61 67 73 20 3d 20 53 51 4c 49 54 45 5f 53 59 lags = SQLITE_SY
218f0 4e 43 5f 46 55 4c 4c 3b 0a 20 20 7d 65 6c 73 65 NC_FULL;. }else
21900 20 69 66 28 20 62 43 6b 70 74 46 75 6c 6c 46 73 if( bCkptFullFs
21910 79 6e 63 20 29 7b 0a 20 20 20 20 70 50 61 67 65 ync ){. pPage
21920 72 2d 3e 73 79 6e 63 46 6c 61 67 73 20 3d 20 53 r->syncFlags = S
21930 51 4c 49 54 45 5f 53 59 4e 43 5f 4e 4f 52 4d 41 QLITE_SYNC_NORMA
21940 4c 3b 0a 20 20 20 20 70 50 61 67 65 72 2d 3e 63 L;. pPager->c
21950 6b 70 74 53 79 6e 63 46 6c 61 67 73 20 3d 20 53 kptSyncFlags = S
21960 51 4c 49 54 45 5f 53 59 4e 43 5f 46 55 4c 4c 3b QLITE_SYNC_FULL;
21970 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 70 50 . }else{. pP
21980 61 67 65 72 2d 3e 73 79 6e 63 46 6c 61 67 73 20 ager->syncFlags
21990 3d 20 53 51 4c 49 54 45 5f 53 59 4e 43 5f 4e 4f = SQLITE_SYNC_NO
219a0 52 4d 41 4c 3b 0a 20 20 20 20 70 50 61 67 65 72 RMAL;. pPager
219b0 2d 3e 63 6b 70 74 53 79 6e 63 46 6c 61 67 73 20 ->ckptSyncFlags
219c0 3d 20 53 51 4c 49 54 45 5f 53 59 4e 43 5f 4e 4f = SQLITE_SYNC_NO
219d0 52 4d 41 4c 3b 0a 20 20 7d 0a 7d 0a 23 65 6e 64 RMAL;. }.}.#end
219e0 69 66 0a 0a 2f 2a 0a 2a 2a 20 54 68 65 20 66 6f if../*.** The fo
219f0 6c 6c 6f 77 69 6e 67 20 67 6c 6f 62 61 6c 20 76 llowing global v
21a00 61 72 69 61 62 6c 65 20 69 73 20 69 6e 63 72 65 ariable is incre
21a10 6d 65 6e 74 65 64 20 77 68 65 6e 65 76 65 72 20 mented whenever
21a20 74 68 65 20 6c 69 62 72 61 72 79 0a 2a 2a 20 61 the library.** a
21a30 74 74 65 6d 70 74 73 20 74 6f 20 6f 70 65 6e 20 ttempts to open
21a40 61 20 74 65 6d 70 6f 72 61 72 79 20 66 69 6c 65 a temporary file
21a50 2e 20 20 54 68 69 73 20 69 6e 66 6f 72 6d 61 74 . This informat
21a60 69 6f 6e 20 69 73 20 75 73 65 64 20 66 6f 72 0a ion is used for.
21a70 2a 2a 20 74 65 73 74 69 6e 67 20 61 6e 64 20 61 ** testing and a
21a80 6e 61 6c 79 73 69 73 20 6f 6e 6c 79 2e 20 20 0a nalysis only. .
21a90 2a 2f 0a 23 69 66 64 65 66 20 53 51 4c 49 54 45 */.#ifdef SQLITE
21aa0 5f 54 45 53 54 0a 69 6e 74 20 73 71 6c 69 74 65 _TEST.int sqlite
21ab0 33 5f 6f 70 65 6e 74 65 6d 70 5f 63 6f 75 6e 74 3_opentemp_count
21ac0 20 3d 20 30 3b 0a 23 65 6e 64 69 66 0a 0a 2f 2a = 0;.#endif../*
21ad0 0a 2a 2a 20 4f 70 65 6e 20 61 20 74 65 6d 70 6f .** Open a tempo
21ae0 72 61 72 79 20 66 69 6c 65 2e 0a 2a 2a 0a 2a 2a rary file..**.**
21af0 20 57 72 69 74 65 20 74 68 65 20 66 69 6c 65 20 Write the file
21b00 64 65 73 63 72 69 70 74 6f 72 20 69 6e 74 6f 20 descriptor into
21b10 2a 70 46 69 6c 65 2e 20 52 65 74 75 72 6e 20 53 *pFile. Return S
21b20 51 4c 49 54 45 5f 4f 4b 20 6f 6e 20 73 75 63 63 QLITE_OK on succ
21b30 65 73 73 20 0a 2a 2a 20 6f 72 20 73 6f 6d 65 20 ess .** or some
21b40 6f 74 68 65 72 20 65 72 72 6f 72 20 63 6f 64 65 other error code
21b50 20 69 66 20 77 65 20 66 61 69 6c 2e 20 54 68 65 if we fail. The
21b60 20 4f 53 20 77 69 6c 6c 20 61 75 74 6f 6d 61 74 OS will automat
21b70 69 63 61 6c 6c 79 20 0a 2a 2a 20 64 65 6c 65 74 ically .** delet
21b80 65 20 74 68 65 20 74 65 6d 70 6f 72 61 72 79 20 e the temporary
21b90 66 69 6c 65 20 77 68 65 6e 20 69 74 20 69 73 20 file when it is
21ba0 63 6c 6f 73 65 64 2e 0a 2a 2a 0a 2a 2a 20 54 68 closed..**.** Th
21bb0 65 20 66 6c 61 67 73 20 70 61 73 73 65 64 20 74 e flags passed t
21bc0 6f 20 74 68 65 20 56 46 53 20 6c 61 79 65 72 20 o the VFS layer
21bd0 78 4f 70 65 6e 28 29 20 63 61 6c 6c 20 61 72 65 xOpen() call are
21be0 20 74 68 6f 73 65 20 73 70 65 63 69 66 69 65 64 those specified
21bf0 0a 2a 2a 20 62 79 20 70 61 72 61 6d 65 74 65 72 .** by parameter
21c00 20 76 66 73 46 6c 61 67 73 20 4f 52 65 64 20 77 vfsFlags ORed w
21c10 69 74 68 20 74 68 65 20 66 6f 6c 6c 6f 77 69 6e ith the followin
21c20 67 3a 0a 2a 2a 0a 2a 2a 20 20 20 20 20 53 51 4c g:.**.** SQL
21c30 49 54 45 5f 4f 50 45 4e 5f 52 45 41 44 57 52 49 ITE_OPEN_READWRI
21c40 54 45 0a 2a 2a 20 20 20 20 20 53 51 4c 49 54 45 TE.** SQLITE
21c50 5f 4f 50 45 4e 5f 43 52 45 41 54 45 0a 2a 2a 20 _OPEN_CREATE.**
21c60 20 20 20 20 53 51 4c 49 54 45 5f 4f 50 45 4e 5f SQLITE_OPEN_
21c70 45 58 43 4c 55 53 49 56 45 0a 2a 2a 20 20 20 20 EXCLUSIVE.**
21c80 20 53 51 4c 49 54 45 5f 4f 50 45 4e 5f 44 45 4c SQLITE_OPEN_DEL
21c90 45 54 45 4f 4e 43 4c 4f 53 45 0a 2a 2f 0a 73 74 ETEONCLOSE.*/.st
21ca0 61 74 69 63 20 69 6e 74 20 70 61 67 65 72 4f 70 atic int pagerOp
21cb0 65 6e 74 65 6d 70 28 0a 20 20 50 61 67 65 72 20 entemp(. Pager
21cc0 2a 70 50 61 67 65 72 2c 20 20 20 20 20 20 20 20 *pPager,
21cd0 2f 2a 20 54 68 65 20 70 61 67 65 72 20 6f 62 6a /* The pager obj
21ce0 65 63 74 20 2a 2f 0a 20 20 73 71 6c 69 74 65 33 ect */. sqlite3
21cf0 5f 66 69 6c 65 20 2a 70 46 69 6c 65 2c 20 20 2f _file *pFile, /
21d00 2a 20 57 72 69 74 65 20 74 68 65 20 66 69 6c 65 * Write the file
21d10 20 64 65 73 63 72 69 70 74 6f 72 20 68 65 72 65 descriptor here
21d20 20 2a 2f 0a 20 20 69 6e 74 20 76 66 73 46 6c 61 */. int vfsFla
21d30 67 73 20 20 20 20 20 20 20 20 20 20 2f 2a 20 46 gs /* F
21d40 6c 61 67 73 20 70 61 73 73 65 64 20 74 68 72 6f lags passed thro
21d50 75 67 68 20 74 6f 20 74 68 65 20 56 46 53 20 2a ugh to the VFS *
21d60 2f 0a 29 7b 0a 20 20 69 6e 74 20 72 63 3b 20 20 /.){. int rc;
21d70 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 /*
21d80 52 65 74 75 72 6e 20 63 6f 64 65 20 2a 2f 0a 0a Return code */..
21d90 23 69 66 64 65 66 20 53 51 4c 49 54 45 5f 54 45 #ifdef SQLITE_TE
21da0 53 54 0a 20 20 73 71 6c 69 74 65 33 5f 6f 70 65 ST. sqlite3_ope
21db0 6e 74 65 6d 70 5f 63 6f 75 6e 74 2b 2b 3b 20 20 ntemp_count++;
21dc0 2f 2a 20 55 73 65 64 20 66 6f 72 20 74 65 73 74 /* Used for test
21dd0 69 6e 67 20 61 6e 64 20 61 6e 61 6c 79 73 69 73 ing and analysis
21de0 20 6f 6e 6c 79 20 2a 2f 0a 23 65 6e 64 69 66 0a only */.#endif.
21df0 0a 20 20 76 66 73 46 6c 61 67 73 20 7c 3d 20 20 . vfsFlags |=
21e00 53 51 4c 49 54 45 5f 4f 50 45 4e 5f 52 45 41 44 SQLITE_OPEN_READ
21e10 57 52 49 54 45 20 7c 20 53 51 4c 49 54 45 5f 4f WRITE | SQLITE_O
21e20 50 45 4e 5f 43 52 45 41 54 45 20 7c 0a 20 20 20 PEN_CREATE |.
21e30 20 20 20 20 20 20 20 20 20 53 51 4c 49 54 45 5f SQLITE_
21e40 4f 50 45 4e 5f 45 58 43 4c 55 53 49 56 45 20 7c OPEN_EXCLUSIVE |
21e50 20 53 51 4c 49 54 45 5f 4f 50 45 4e 5f 44 45 4c SQLITE_OPEN_DEL
21e60 45 54 45 4f 4e 43 4c 4f 53 45 3b 0a 20 20 72 63 ETEONCLOSE;. rc
21e70 20 3d 20 73 71 6c 69 74 65 33 4f 73 4f 70 65 6e = sqlite3OsOpen
21e80 28 70 50 61 67 65 72 2d 3e 70 56 66 73 2c 20 30 (pPager->pVfs, 0
21e90 2c 20 70 46 69 6c 65 2c 20 76 66 73 46 6c 61 67 , pFile, vfsFlag
21ea0 73 2c 20 30 29 3b 0a 20 20 61 73 73 65 72 74 28 s, 0);. assert(
21eb0 20 72 63 21 3d 53 51 4c 49 54 45 5f 4f 4b 20 7c rc!=SQLITE_OK |
21ec0 7c 20 69 73 4f 70 65 6e 28 70 46 69 6c 65 29 20 | isOpen(pFile)
21ed0 29 3b 0a 20 20 72 65 74 75 72 6e 20 72 63 3b 0a );. return rc;.
21ee0 7d 0a 0a 2f 2a 0a 2a 2a 20 53 65 74 20 74 68 65 }../*.** Set the
21ef0 20 62 75 73 79 20 68 61 6e 64 6c 65 72 20 66 75 busy handler fu
21f00 6e 63 74 69 6f 6e 2e 0a 2a 2a 0a 2a 2a 20 54 68 nction..**.** Th
21f10 65 20 70 61 67 65 72 20 69 6e 76 6f 6b 65 73 20 e pager invokes
21f20 74 68 65 20 62 75 73 79 2d 68 61 6e 64 6c 65 72 the busy-handler
21f30 20 69 66 20 73 71 6c 69 74 65 33 4f 73 4c 6f 63 if sqlite3OsLoc
21f40 6b 28 29 20 72 65 74 75 72 6e 73 20 0a 2a 2a 20 k() returns .**
21f50 53 51 4c 49 54 45 5f 42 55 53 59 20 77 68 65 6e SQLITE_BUSY when
21f60 20 74 72 79 69 6e 67 20 74 6f 20 75 70 67 72 61 trying to upgra
21f70 64 65 20 66 72 6f 6d 20 6e 6f 2d 6c 6f 63 6b 20 de from no-lock
21f80 74 6f 20 61 20 53 48 41 52 45 44 20 6c 6f 63 6b to a SHARED lock
21f90 2c 0a 2a 2a 20 6f 72 20 77 68 65 6e 20 74 72 79 ,.** or when try
21fa0 69 6e 67 20 74 6f 20 75 70 67 72 61 64 65 20 66 ing to upgrade f
21fb0 72 6f 6d 20 61 20 52 45 53 45 52 56 45 44 20 6c rom a RESERVED l
21fc0 6f 63 6b 20 74 6f 20 61 6e 20 45 58 43 4c 55 53 ock to an EXCLUS
21fd0 49 56 45 20 0a 2a 2a 20 6c 6f 63 6b 2e 20 49 74 IVE .** lock. It
21fe0 20 64 6f 65 73 20 2a 6e 6f 74 2a 20 69 6e 76 6f does *not* invo
21ff0 6b 65 20 74 68 65 20 62 75 73 79 20 68 61 6e 64 ke the busy hand
22000 6c 65 72 20 77 68 65 6e 20 75 70 67 72 61 64 69 ler when upgradi
22010 6e 67 20 66 72 6f 6d 0a 2a 2a 20 53 48 41 52 45 ng from.** SHARE
22020 44 20 74 6f 20 52 45 53 45 52 56 45 44 2c 20 6f D to RESERVED, o
22030 72 20 77 68 65 6e 20 75 70 67 72 61 64 69 6e 67 r when upgrading
22040 20 66 72 6f 6d 20 53 48 41 52 45 44 20 74 6f 20 from SHARED to
22050 45 58 43 4c 55 53 49 56 45 0a 2a 2a 20 28 77 68 EXCLUSIVE.** (wh
22060 69 63 68 20 6f 63 63 75 72 73 20 64 75 72 69 6e ich occurs durin
22070 67 20 68 6f 74 2d 6a 6f 75 72 6e 61 6c 20 72 6f g hot-journal ro
22080 6c 6c 62 61 63 6b 29 2e 20 53 75 6d 6d 61 72 79 llback). Summary
22090 3a 0a 2a 2a 0a 2a 2a 20 20 20 54 72 61 6e 73 69 :.**.** Transi
220a0 74 69 6f 6e 20 20 20 20 20 20 20 20 20 20 20 20 tion
220b0 20 20 20 20 20 20 20 20 20 20 20 20 7c 20 49 6e | In
220c0 76 6f 6b 65 73 20 78 42 75 73 79 48 61 6e 64 6c vokes xBusyHandl
220d0 65 72 0a 2a 2a 20 20 20 2d 2d 2d 2d 2d 2d 2d 2d er.** --------
220e0 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
220f0 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
22100 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
22110 0a 2a 2a 20 20 20 4e 4f 5f 4c 4f 43 4b 20 20 20 .** NO_LOCK
22120 20 20 20 20 2d 3e 20 53 48 41 52 45 44 5f 4c 4f -> SHARED_LO
22130 43 4b 20 20 20 20 20 20 7c 20 59 65 73 0a 2a 2a CK | Yes.**
22140 20 20 20 53 48 41 52 45 44 5f 4c 4f 43 4b 20 20 SHARED_LOCK
22150 20 2d 3e 20 52 45 53 45 52 56 45 44 5f 4c 4f 43 -> RESERVED_LOC
22160 4b 20 20 20 20 7c 20 4e 6f 0a 2a 2a 20 20 20 53 K | No.** S
22170 48 41 52 45 44 5f 4c 4f 43 4b 20 20 20 2d 3e 20 HARED_LOCK ->
22180 45 58 43 4c 55 53 49 56 45 5f 4c 4f 43 4b 20 20 EXCLUSIVE_LOCK
22190 20 7c 20 4e 6f 0a 2a 2a 20 20 20 52 45 53 45 52 | No.** RESER
221a0 56 45 44 5f 4c 4f 43 4b 20 2d 3e 20 45 58 43 4c VED_LOCK -> EXCL
221b0 55 53 49 56 45 5f 4c 4f 43 4b 20 20 20 7c 20 59 USIVE_LOCK | Y
221c0 65 73 0a 2a 2a 0a 2a 2a 20 49 66 20 74 68 65 20 es.**.** If the
221d0 62 75 73 79 2d 68 61 6e 64 6c 65 72 20 63 61 6c busy-handler cal
221e0 6c 62 61 63 6b 20 72 65 74 75 72 6e 73 20 6e 6f lback returns no
221f0 6e 2d 7a 65 72 6f 2c 20 74 68 65 20 6c 6f 63 6b n-zero, the lock
22200 20 69 73 20 0a 2a 2a 20 72 65 74 72 69 65 64 2e is .** retried.
22210 20 49 66 20 69 74 20 72 65 74 75 72 6e 73 20 7a If it returns z
22220 65 72 6f 2c 20 74 68 65 6e 20 74 68 65 20 53 51 ero, then the SQ
22230 4c 49 54 45 5f 42 55 53 59 20 65 72 72 6f 72 20 LITE_BUSY error
22240 69 73 0a 2a 2a 20 72 65 74 75 72 6e 65 64 20 74 is.** returned t
22250 6f 20 74 68 65 20 63 61 6c 6c 65 72 20 6f 66 20 o the caller of
22260 74 68 65 20 70 61 67 65 72 20 41 50 49 20 66 75 the pager API fu
22270 6e 63 74 69 6f 6e 2e 0a 2a 2f 0a 76 6f 69 64 20 nction..*/.void
22280 73 71 6c 69 74 65 33 50 61 67 65 72 53 65 74 42 sqlite3PagerSetB
22290 75 73 79 68 61 6e 64 6c 65 72 28 0a 20 20 50 61 usyhandler(. Pa
222a0 67 65 72 20 2a 70 50 61 67 65 72 2c 20 20 20 20 ger *pPager,
222b0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
222c0 20 20 20 2f 2a 20 50 61 67 65 72 20 6f 62 6a 65 /* Pager obje
222d0 63 74 20 2a 2f 0a 20 20 69 6e 74 20 28 2a 78 42 ct */. int (*xB
222e0 75 73 79 48 61 6e 64 6c 65 72 29 28 76 6f 69 64 usyHandler)(void
222f0 20 2a 29 2c 20 20 20 20 20 20 20 20 20 2f 2a 20 *), /*
22300 50 6f 69 6e 74 65 72 20 74 6f 20 62 75 73 79 2d Pointer to busy-
22310 68 61 6e 64 6c 65 72 20 66 75 6e 63 74 69 6f 6e handler function
22320 20 2a 2f 0a 20 20 76 6f 69 64 20 2a 70 42 75 73 */. void *pBus
22330 79 48 61 6e 64 6c 65 72 41 72 67 20 20 20 20 20 yHandlerArg
22340 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 41 72 /* Ar
22350 67 75 6d 65 6e 74 20 74 6f 20 70 61 73 73 20 74 gument to pass t
22360 6f 20 78 42 75 73 79 48 61 6e 64 6c 65 72 20 2a o xBusyHandler *
22370 2f 0a 29 7b 20 20 0a 20 20 70 50 61 67 65 72 2d /.){ . pPager-
22380 3e 78 42 75 73 79 48 61 6e 64 6c 65 72 20 3d 20 >xBusyHandler =
22390 78 42 75 73 79 48 61 6e 64 6c 65 72 3b 0a 20 20 xBusyHandler;.
223a0 70 50 61 67 65 72 2d 3e 70 42 75 73 79 48 61 6e pPager->pBusyHan
223b0 64 6c 65 72 41 72 67 20 3d 20 70 42 75 73 79 48 dlerArg = pBusyH
223c0 61 6e 64 6c 65 72 41 72 67 3b 0a 7d 0a 0a 2f 2a andlerArg;.}../*
223d0 0a 2a 2a 20 43 68 61 6e 67 65 20 74 68 65 20 70 .** Change the p
223e0 61 67 65 20 73 69 7a 65 20 75 73 65 64 20 62 79 age size used by
223f0 20 74 68 65 20 50 61 67 65 72 20 6f 62 6a 65 63 the Pager objec
22400 74 2e 20 54 68 65 20 6e 65 77 20 70 61 67 65 20 t. The new page
22410 73 69 7a 65 20 0a 2a 2a 20 69 73 20 70 61 73 73 size .** is pass
22420 65 64 20 69 6e 20 2a 70 50 61 67 65 53 69 7a 65 ed in *pPageSize
22430 2e 0a 2a 2a 0a 2a 2a 20 49 66 20 74 68 65 20 70 ..**.** If the p
22440 61 67 65 72 20 69 73 20 69 6e 20 74 68 65 20 65 ager is in the e
22450 72 72 6f 72 20 73 74 61 74 65 20 77 68 65 6e 20 rror state when
22460 74 68 69 73 20 66 75 6e 63 74 69 6f 6e 20 69 73 this function is
22470 20 63 61 6c 6c 65 64 2c 20 69 74 0a 2a 2a 20 69 called, it.** i
22480 73 20 61 20 6e 6f 2d 6f 70 2e 20 54 68 65 20 76 s a no-op. The v
22490 61 6c 75 65 20 72 65 74 75 72 6e 65 64 20 69 73 alue returned is
224a0 20 74 68 65 20 65 72 72 6f 72 20 73 74 61 74 65 the error state
224b0 20 65 72 72 6f 72 20 63 6f 64 65 20 28 69 2e 65 error code (i.e
224c0 2e 20 0a 2a 2a 20 6f 6e 65 20 6f 66 20 53 51 4c . .** one of SQL
224d0 49 54 45 5f 49 4f 45 52 52 2c 20 61 6e 20 53 51 ITE_IOERR, an SQ
224e0 4c 49 54 45 5f 49 4f 45 52 52 5f 78 78 78 20 73 LITE_IOERR_xxx s
224f0 75 62 2d 63 6f 64 65 20 6f 72 20 53 51 4c 49 54 ub-code or SQLIT
22500 45 5f 46 55 4c 4c 29 2e 0a 2a 2a 0a 2a 2a 20 4f E_FULL)..**.** O
22510 74 68 65 72 77 69 73 65 2c 20 69 66 20 61 6c 6c therwise, if all
22520 20 6f 66 20 74 68 65 20 66 6f 6c 6c 6f 77 69 6e of the followin
22530 67 20 61 72 65 20 74 72 75 65 3a 0a 2a 2a 0a 2a g are true:.**.*
22540 2a 20 20 20 2a 20 74 68 65 20 6e 65 77 20 70 61 * * the new pa
22550 67 65 20 73 69 7a 65 20 28 76 61 6c 75 65 20 6f ge size (value o
22560 66 20 2a 70 50 61 67 65 53 69 7a 65 29 20 69 73 f *pPageSize) is
22570 20 76 61 6c 69 64 20 28 61 20 70 6f 77 65 72 20 valid (a power
22580 0a 2a 2a 20 20 20 20 20 6f 66 20 74 77 6f 20 62 .** of two b
22590 65 74 77 65 65 6e 20 35 31 32 20 61 6e 64 20 53 etween 512 and S
225a0 51 4c 49 54 45 5f 4d 41 58 5f 50 41 47 45 5f 53 QLITE_MAX_PAGE_S
225b0 49 5a 45 2c 20 69 6e 63 6c 75 73 69 76 65 29 2c IZE, inclusive),
225c0 20 61 6e 64 0a 2a 2a 0a 2a 2a 20 20 20 2a 20 74 and.**.** * t
225d0 68 65 72 65 20 61 72 65 20 6e 6f 20 6f 75 74 73 here are no outs
225e0 74 61 6e 64 69 6e 67 20 70 61 67 65 20 72 65 66 tanding page ref
225f0 65 72 65 6e 63 65 73 2c 20 61 6e 64 0a 2a 2a 0a erences, and.**.
22600 2a 2a 20 20 20 2a 20 74 68 65 20 64 61 74 61 62 ** * the datab
22610 61 73 65 20 69 73 20 65 69 74 68 65 72 20 6e 6f ase is either no
22620 74 20 61 6e 20 69 6e 2d 6d 65 6d 6f 72 79 20 64 t an in-memory d
22630 61 74 61 62 61 73 65 20 6f 72 20 69 74 20 69 73 atabase or it is
22640 0a 2a 2a 20 20 20 20 20 61 6e 20 69 6e 2d 6d 65 .** an in-me
22650 6d 6f 72 79 20 64 61 74 61 62 61 73 65 20 74 68 mory database th
22660 61 74 20 63 75 72 72 65 6e 74 6c 79 20 63 6f 6e at currently con
22670 73 69 73 74 73 20 6f 66 20 7a 65 72 6f 20 70 61 sists of zero pa
22680 67 65 73 2e 0a 2a 2a 0a 2a 2a 20 74 68 65 6e 20 ges..**.** then
22690 74 68 65 20 70 61 67 65 72 20 6f 62 6a 65 63 74 the pager object
226a0 20 70 61 67 65 20 73 69 7a 65 20 69 73 20 73 65 page size is se
226b0 74 20 74 6f 20 2a 70 50 61 67 65 53 69 7a 65 2e t to *pPageSize.
226c0 0a 2a 2a 0a 2a 2a 20 49 66 20 74 68 65 20 70 61 .**.** If the pa
226d0 67 65 20 73 69 7a 65 20 69 73 20 63 68 61 6e 67 ge size is chang
226e0 65 64 2c 20 74 68 65 6e 20 74 68 69 73 20 66 75 ed, then this fu
226f0 6e 63 74 69 6f 6e 20 75 73 65 73 20 73 71 6c 69 nction uses sqli
22700 74 65 33 50 61 67 65 72 4d 61 6c 6c 6f 63 28 29 te3PagerMalloc()
22710 20 0a 2a 2a 20 74 6f 20 6f 62 74 61 69 6e 20 61 .** to obtain a
22720 20 6e 65 77 20 50 61 67 65 72 2e 70 54 6d 70 53 new Pager.pTmpS
22730 70 61 63 65 20 62 75 66 66 65 72 2e 20 49 66 20 pace buffer. If
22740 74 68 69 73 20 61 6c 6c 6f 63 61 74 69 6f 6e 20 this allocation
22750 61 74 74 65 6d 70 74 20 0a 2a 2a 20 66 61 69 6c attempt .** fail
22760 73 2c 20 53 51 4c 49 54 45 5f 4e 4f 4d 45 4d 20 s, SQLITE_NOMEM
22770 69 73 20 72 65 74 75 72 6e 65 64 20 61 6e 64 20 is returned and
22780 74 68 65 20 70 61 67 65 20 73 69 7a 65 20 72 65 the page size re
22790 6d 61 69 6e 73 20 75 6e 63 68 61 6e 67 65 64 2e mains unchanged.
227a0 20 0a 2a 2a 20 49 6e 20 61 6c 6c 20 6f 74 68 65 .** In all othe
227b0 72 20 63 61 73 65 73 2c 20 53 51 4c 49 54 45 5f r cases, SQLITE_
227c0 4f 4b 20 69 73 20 72 65 74 75 72 6e 65 64 2e 0a OK is returned..
227d0 2a 2a 0a 2a 2a 20 49 66 20 74 68 65 20 70 61 67 **.** If the pag
227e0 65 20 73 69 7a 65 20 69 73 20 6e 6f 74 20 63 68 e size is not ch
227f0 61 6e 67 65 64 2c 20 65 69 74 68 65 72 20 62 65 anged, either be
22800 63 61 75 73 65 20 6f 6e 65 20 6f 66 20 74 68 65 cause one of the
22810 20 65 6e 75 6d 65 72 61 74 65 64 0a 2a 2a 20 63 enumerated.** c
22820 6f 6e 64 69 74 69 6f 6e 73 20 61 62 6f 76 65 20 onditions above
22830 69 73 20 6e 6f 74 20 74 72 75 65 2c 20 74 68 65 is not true, the
22840 20 70 61 67 65 72 20 77 61 73 20 69 6e 20 65 72 pager was in er
22850 72 6f 72 20 73 74 61 74 65 20 77 68 65 6e 20 74 ror state when t
22860 68 69 73 0a 2a 2a 20 66 75 6e 63 74 69 6f 6e 20 his.** function
22870 77 61 73 20 63 61 6c 6c 65 64 2c 20 6f 72 20 62 was called, or b
22880 65 63 61 75 73 65 20 74 68 65 20 6d 65 6d 6f 72 ecause the memor
22890 79 20 61 6c 6c 6f 63 61 74 69 6f 6e 20 61 74 74 y allocation att
228a0 65 6d 70 74 20 66 61 69 6c 65 64 2c 20 0a 2a 2a empt failed, .**
228b0 20 74 68 65 6e 20 2a 70 50 61 67 65 53 69 7a 65 then *pPageSize
228c0 20 69 73 20 73 65 74 20 74 6f 20 74 68 65 20 6f is set to the o
228d0 6c 64 2c 20 72 65 74 61 69 6e 65 64 20 70 61 67 ld, retained pag
228e0 65 20 73 69 7a 65 20 62 65 66 6f 72 65 20 72 65 e size before re
228f0 74 75 72 6e 69 6e 67 2e 0a 2a 2f 0a 69 6e 74 20 turning..*/.int
22900 73 71 6c 69 74 65 33 50 61 67 65 72 53 65 74 50 sqlite3PagerSetP
22910 61 67 65 73 69 7a 65 28 50 61 67 65 72 20 2a 70 agesize(Pager *p
22920 50 61 67 65 72 2c 20 75 33 32 20 2a 70 50 61 67 Pager, u32 *pPag
22930 65 53 69 7a 65 2c 20 69 6e 74 20 6e 52 65 73 65 eSize, int nRese
22940 72 76 65 29 7b 0a 20 20 69 6e 74 20 72 63 20 3d rve){. int rc =
22950 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 0a 20 20 2f SQLITE_OK;.. /
22960 2a 20 49 74 20 69 73 20 6e 6f 74 20 70 6f 73 73 * It is not poss
22970 69 62 6c 65 20 74 6f 20 64 6f 20 61 20 66 75 6c ible to do a ful
22980 6c 20 61 73 73 65 72 74 5f 70 61 67 65 72 5f 73 l assert_pager_s
22990 74 61 74 65 28 29 20 68 65 72 65 2c 20 61 73 20 tate() here, as
229a0 74 68 69 73 0a 20 20 2a 2a 20 66 75 6e 63 74 69 this. ** functi
229b0 6f 6e 20 6d 61 79 20 62 65 20 63 61 6c 6c 65 64 on may be called
229c0 20 66 72 6f 6d 20 77 69 74 68 69 6e 20 50 61 67 from within Pag
229d0 65 72 4f 70 65 6e 28 29 2c 20 62 65 66 6f 72 65 erOpen(), before
229e0 20 74 68 65 20 73 74 61 74 65 0a 20 20 2a 2a 20 the state. **
229f0 6f 66 20 74 68 65 20 50 61 67 65 72 20 6f 62 6a of the Pager obj
22a00 65 63 74 20 69 73 20 69 6e 74 65 72 6e 61 6c 6c ect is internall
22a10 79 20 63 6f 6e 73 69 73 74 65 6e 74 2e 0a 20 20 y consistent..
22a20 2a 2a 0a 20 20 2a 2a 20 41 74 20 6f 6e 65 20 70 **. ** At one p
22a30 6f 69 6e 74 20 74 68 69 73 20 66 75 6e 63 74 69 oint this functi
22a40 6f 6e 20 72 65 74 75 72 6e 65 64 20 61 6e 20 65 on returned an e
22a50 72 72 6f 72 20 69 66 20 74 68 65 20 70 61 67 65 rror if the page
22a60 72 20 77 61 73 20 69 6e 20 0a 20 20 2a 2a 20 50 r was in . ** P
22a70 41 47 45 52 5f 45 52 52 4f 52 20 73 74 61 74 65 AGER_ERROR state
22a80 2e 20 42 75 74 20 73 69 6e 63 65 20 50 41 47 45 . But since PAGE
22a90 52 5f 45 52 52 4f 52 20 73 74 61 74 65 20 67 75 R_ERROR state gu
22aa0 61 72 61 6e 74 65 65 73 20 74 68 61 74 0a 20 20 arantees that.
22ab0 2a 2a 20 74 68 65 72 65 20 69 73 20 61 74 20 6c ** there is at l
22ac0 65 61 73 74 20 6f 6e 65 20 6f 75 74 73 74 61 6e east one outstan
22ad0 64 69 6e 67 20 70 61 67 65 20 72 65 66 65 72 65 ding page refere
22ae0 6e 63 65 2c 20 74 68 69 73 20 66 75 6e 63 74 69 nce, this functi
22af0 6f 6e 0a 20 20 2a 2a 20 69 73 20 61 20 6e 6f 2d on. ** is a no-
22b00 6f 70 20 66 6f 72 20 74 68 61 74 20 63 61 73 65 op for that case
22b10 20 61 6e 79 68 6f 77 2e 0a 20 20 2a 2f 0a 0a 20 anyhow.. */..
22b20 20 75 33 32 20 70 61 67 65 53 69 7a 65 20 3d 20 u32 pageSize =
22b30 2a 70 50 61 67 65 53 69 7a 65 3b 0a 20 20 61 73 *pPageSize;. as
22b40 73 65 72 74 28 20 70 61 67 65 53 69 7a 65 3d 3d sert( pageSize==
22b50 30 20 7c 7c 20 28 70 61 67 65 53 69 7a 65 3e 3d 0 || (pageSize>=
22b60 35 31 32 20 26 26 20 70 61 67 65 53 69 7a 65 3c 512 && pageSize<
22b70 3d 53 51 4c 49 54 45 5f 4d 41 58 5f 50 41 47 45 =SQLITE_MAX_PAGE
22b80 5f 53 49 5a 45 29 20 29 3b 0a 20 20 69 66 28 20 _SIZE) );. if(
22b90 28 70 50 61 67 65 72 2d 3e 6d 65 6d 44 62 3d 3d (pPager->memDb==
22ba0 30 20 7c 7c 20 70 50 61 67 65 72 2d 3e 64 62 53 0 || pPager->dbS
22bb0 69 7a 65 3d 3d 30 29 0a 20 20 20 26 26 20 73 71 ize==0). && sq
22bc0 6c 69 74 65 33 50 63 61 63 68 65 52 65 66 43 6f lite3PcacheRefCo
22bd0 75 6e 74 28 70 50 61 67 65 72 2d 3e 70 50 43 61 unt(pPager->pPCa
22be0 63 68 65 29 3d 3d 30 20 0a 20 20 20 26 26 20 70 che)==0 . && p
22bf0 61 67 65 53 69 7a 65 20 26 26 20 70 61 67 65 53 ageSize && pageS
22c00 69 7a 65 21 3d 28 75 33 32 29 70 50 61 67 65 72 ize!=(u32)pPager
22c10 2d 3e 70 61 67 65 53 69 7a 65 20 0a 20 20 29 7b ->pageSize . ){
22c20 0a 20 20 20 20 63 68 61 72 20 2a 70 4e 65 77 20 . char *pNew
22c30 3d 20 4e 55 4c 4c 3b 20 20 20 20 20 20 20 20 20 = NULL;
22c40 20 20 20 20 2f 2a 20 4e 65 77 20 74 65 6d 70 20 /* New temp
22c50 73 70 61 63 65 20 2a 2f 0a 20 20 20 20 69 36 34 space */. i64
22c60 20 6e 42 79 74 65 20 3d 20 30 3b 0a 0a 20 20 20 nByte = 0;..
22c70 20 69 66 28 20 70 50 61 67 65 72 2d 3e 65 53 74 if( pPager->eSt
22c80 61 74 65 3e 50 41 47 45 52 5f 4f 50 45 4e 20 26 ate>PAGER_OPEN &
22c90 26 20 69 73 4f 70 65 6e 28 70 50 61 67 65 72 2d & isOpen(pPager-
22ca0 3e 66 64 29 20 29 7b 0a 20 20 20 20 20 20 72 63 >fd) ){. rc
22cb0 20 3d 20 73 71 6c 69 74 65 33 4f 73 46 69 6c 65 = sqlite3OsFile
22cc0 53 69 7a 65 28 70 50 61 67 65 72 2d 3e 66 64 2c Size(pPager->fd,
22cd0 20 26 6e 42 79 74 65 29 3b 0a 20 20 20 20 7d 0a &nByte);. }.
22ce0 20 20 20 20 69 66 28 20 72 63 3d 3d 53 51 4c 49 if( rc==SQLI
22cf0 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 20 20 70 TE_OK ){. p
22d00 4e 65 77 20 3d 20 28 63 68 61 72 20 2a 29 73 71 New = (char *)sq
22d10 6c 69 74 65 33 50 61 67 65 4d 61 6c 6c 6f 63 28 lite3PageMalloc(
22d20 70 61 67 65 53 69 7a 65 29 3b 0a 20 20 20 20 20 pageSize);.
22d30 20 69 66 28 20 21 70 4e 65 77 20 29 20 72 63 20 if( !pNew ) rc
22d40 3d 20 53 51 4c 49 54 45 5f 4e 4f 4d 45 4d 3b 0a = SQLITE_NOMEM;.
22d50 20 20 20 20 7d 0a 0a 20 20 20 20 69 66 28 20 72 }.. if( r
22d60 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a c==SQLITE_OK ){.
22d70 20 20 20 20 20 20 70 61 67 65 72 5f 72 65 73 65 pager_rese
22d80 74 28 70 50 61 67 65 72 29 3b 0a 20 20 20 20 20 t(pPager);.
22d90 20 70 50 61 67 65 72 2d 3e 64 62 53 69 7a 65 20 pPager->dbSize
22da0 3d 20 28 50 67 6e 6f 29 28 6e 42 79 74 65 2f 70 = (Pgno)(nByte/p
22db0 61 67 65 53 69 7a 65 29 3b 0a 20 20 20 20 20 20 ageSize);.
22dc0 70 50 61 67 65 72 2d 3e 70 61 67 65 53 69 7a 65 pPager->pageSize
22dd0 20 3d 20 70 61 67 65 53 69 7a 65 3b 0a 20 20 20 = pageSize;.
22de0 20 20 20 73 71 6c 69 74 65 33 50 61 67 65 46 72 sqlite3PageFr
22df0 65 65 28 70 50 61 67 65 72 2d 3e 70 54 6d 70 53 ee(pPager->pTmpS
22e00 70 61 63 65 29 3b 0a 20 20 20 20 20 20 70 50 61 pace);. pPa
22e10 67 65 72 2d 3e 70 54 6d 70 53 70 61 63 65 20 3d ger->pTmpSpace =
22e20 20 70 4e 65 77 3b 0a 20 20 20 20 20 20 73 71 6c pNew;. sql
22e30 69 74 65 33 50 63 61 63 68 65 53 65 74 50 61 67 ite3PcacheSetPag
22e40 65 53 69 7a 65 28 70 50 61 67 65 72 2d 3e 70 50 eSize(pPager->pP
22e50 43 61 63 68 65 2c 20 70 61 67 65 53 69 7a 65 29 Cache, pageSize)
22e60 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a 0a 20 20 2a ;. }. }.. *
22e70 70 50 61 67 65 53 69 7a 65 20 3d 20 70 50 61 67 pPageSize = pPag
22e80 65 72 2d 3e 70 61 67 65 53 69 7a 65 3b 0a 20 20 er->pageSize;.
22e90 69 66 28 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4f if( rc==SQLITE_O
22ea0 4b 20 29 7b 0a 20 20 20 20 69 66 28 20 6e 52 65 K ){. if( nRe
22eb0 73 65 72 76 65 3c 30 20 29 20 6e 52 65 73 65 72 serve<0 ) nReser
22ec0 76 65 20 3d 20 70 50 61 67 65 72 2d 3e 6e 52 65 ve = pPager->nRe
22ed0 73 65 72 76 65 3b 0a 20 20 20 20 61 73 73 65 72 serve;. asser
22ee0 74 28 20 6e 52 65 73 65 72 76 65 3e 3d 30 20 26 t( nReserve>=0 &
22ef0 26 20 6e 52 65 73 65 72 76 65 3c 31 30 30 30 20 & nReserve<1000
22f00 29 3b 0a 20 20 20 20 70 50 61 67 65 72 2d 3e 6e );. pPager->n
22f10 52 65 73 65 72 76 65 20 3d 20 28 69 31 36 29 6e Reserve = (i16)n
22f20 52 65 73 65 72 76 65 3b 0a 20 20 20 20 70 61 67 Reserve;. pag
22f30 65 72 52 65 70 6f 72 74 53 69 7a 65 28 70 50 61 erReportSize(pPa
22f40 67 65 72 29 3b 0a 20 20 7d 0a 20 20 72 65 74 75 ger);. }. retu
22f50 72 6e 20 72 63 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 rn rc;.}../*.**
22f60 52 65 74 75 72 6e 20 61 20 70 6f 69 6e 74 65 72 Return a pointer
22f70 20 74 6f 20 74 68 65 20 22 74 65 6d 70 6f 72 61 to the "tempora
22f80 72 79 20 70 61 67 65 22 20 62 75 66 66 65 72 20 ry page" buffer
22f90 68 65 6c 64 20 69 6e 74 65 72 6e 61 6c 6c 79 0a held internally.
22fa0 2a 2a 20 62 79 20 74 68 65 20 70 61 67 65 72 2e ** by the pager.
22fb0 20 20 54 68 69 73 20 69 73 20 61 20 62 75 66 66 This is a buff
22fc0 65 72 20 74 68 61 74 20 69 73 20 62 69 67 20 65 er that is big e
22fd0 6e 6f 75 67 68 20 74 6f 20 68 6f 6c 64 20 74 68 nough to hold th
22fe0 65 0a 2a 2a 20 65 6e 74 69 72 65 20 63 6f 6e 74 e.** entire cont
22ff0 65 6e 74 20 6f 66 20 61 20 64 61 74 61 62 61 73 ent of a databas
23000 65 20 70 61 67 65 2e 20 20 54 68 69 73 20 62 75 e page. This bu
23010 66 66 65 72 20 69 73 20 75 73 65 64 20 69 6e 74 ffer is used int
23020 65 72 6e 61 6c 6c 79 0a 2a 2a 20 64 75 72 69 6e ernally.** durin
23030 67 20 72 6f 6c 6c 62 61 63 6b 20 61 6e 64 20 77 g rollback and w
23040 69 6c 6c 20 62 65 20 6f 76 65 72 77 72 69 74 74 ill be overwritt
23050 65 6e 20 77 68 65 6e 65 76 65 72 20 61 20 72 6f en whenever a ro
23060 6c 6c 62 61 63 6b 0a 2a 2a 20 6f 63 63 75 72 73 llback.** occurs
23070 2e 20 20 42 75 74 20 6f 74 68 65 72 20 6d 6f 64 . But other mod
23080 75 6c 65 73 20 61 72 65 20 66 72 65 65 20 74 6f ules are free to
23090 20 75 73 65 20 69 74 20 74 6f 6f 2c 20 61 73 20 use it too, as
230a0 6c 6f 6e 67 20 61 73 0a 2a 2a 20 6e 6f 20 72 6f long as.** no ro
230b0 6c 6c 62 61 63 6b 73 20 61 72 65 20 68 61 70 70 llbacks are happ
230c0 65 6e 69 6e 67 2e 0a 2a 2f 0a 76 6f 69 64 20 2a ening..*/.void *
230d0 73 71 6c 69 74 65 33 50 61 67 65 72 54 65 6d 70 sqlite3PagerTemp
230e0 53 70 61 63 65 28 50 61 67 65 72 20 2a 70 50 61 Space(Pager *pPa
230f0 67 65 72 29 7b 0a 20 20 72 65 74 75 72 6e 20 70 ger){. return p
23100 50 61 67 65 72 2d 3e 70 54 6d 70 53 70 61 63 65 Pager->pTmpSpace
23110 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 41 74 74 65 6d ;.}../*.** Attem
23120 70 74 20 74 6f 20 73 65 74 20 74 68 65 20 6d 61 pt to set the ma
23130 78 69 6d 75 6d 20 64 61 74 61 62 61 73 65 20 70 ximum database p
23140 61 67 65 20 63 6f 75 6e 74 20 69 66 20 6d 78 50 age count if mxP
23150 61 67 65 20 69 73 20 70 6f 73 69 74 69 76 65 2e age is positive.
23160 20 0a 2a 2a 20 4d 61 6b 65 20 6e 6f 20 63 68 61 .** Make no cha
23170 6e 67 65 73 20 69 66 20 6d 78 50 61 67 65 20 69 nges if mxPage i
23180 73 20 7a 65 72 6f 20 6f 72 20 6e 65 67 61 74 69 s zero or negati
23190 76 65 2e 20 20 41 6e 64 20 6e 65 76 65 72 20 72 ve. And never r
231a0 65 64 75 63 65 20 74 68 65 0a 2a 2a 20 6d 61 78 educe the.** max
231b0 69 6d 75 6d 20 70 61 67 65 20 63 6f 75 6e 74 20 imum page count
231c0 62 65 6c 6f 77 20 74 68 65 20 63 75 72 72 65 6e below the curren
231d0 74 20 73 69 7a 65 20 6f 66 20 74 68 65 20 64 61 t size of the da
231e0 74 61 62 61 73 65 2e 0a 2a 2a 0a 2a 2a 20 52 65 tabase..**.** Re
231f0 67 61 72 64 6c 65 73 73 20 6f 66 20 6d 78 50 61 gardless of mxPa
23200 67 65 2c 20 72 65 74 75 72 6e 20 74 68 65 20 63 ge, return the c
23210 75 72 72 65 6e 74 20 6d 61 78 69 6d 75 6d 20 70 urrent maximum p
23220 61 67 65 20 63 6f 75 6e 74 2e 0a 2a 2f 0a 69 6e age count..*/.in
23230 74 20 73 71 6c 69 74 65 33 50 61 67 65 72 4d 61 t sqlite3PagerMa
23240 78 50 61 67 65 43 6f 75 6e 74 28 50 61 67 65 72 xPageCount(Pager
23250 20 2a 70 50 61 67 65 72 2c 20 69 6e 74 20 6d 78 *pPager, int mx
23260 50 61 67 65 29 7b 0a 20 20 69 66 28 20 6d 78 50 Page){. if( mxP
23270 61 67 65 3e 30 20 29 7b 0a 20 20 20 20 70 50 61 age>0 ){. pPa
23280 67 65 72 2d 3e 6d 78 50 67 6e 6f 20 3d 20 6d 78 ger->mxPgno = mx
23290 50 61 67 65 3b 0a 20 20 7d 0a 20 20 61 73 73 65 Page;. }. asse
232a0 72 74 28 20 70 50 61 67 65 72 2d 3e 65 53 74 61 rt( pPager->eSta
232b0 74 65 21 3d 50 41 47 45 52 5f 4f 50 45 4e 20 29 te!=PAGER_OPEN )
232c0 3b 20 20 20 20 20 20 2f 2a 20 43 61 6c 6c 65 64 ; /* Called
232d0 20 6f 6e 6c 79 20 62 79 20 4f 50 5f 4d 61 78 50 only by OP_MaxP
232e0 67 63 6e 74 20 2a 2f 0a 20 20 61 73 73 65 72 74 gcnt */. assert
232f0 28 20 70 50 61 67 65 72 2d 3e 6d 78 50 67 6e 6f ( pPager->mxPgno
23300 3e 3d 70 50 61 67 65 72 2d 3e 64 62 53 69 7a 65 >=pPager->dbSize
23310 20 29 3b 20 20 2f 2a 20 4f 50 5f 4d 61 78 50 67 ); /* OP_MaxPg
23320 63 6e 74 20 65 6e 66 6f 72 63 65 73 20 74 68 69 cnt enforces thi
23330 73 20 2a 2f 0a 20 20 72 65 74 75 72 6e 20 70 50 s */. return pP
23340 61 67 65 72 2d 3e 6d 78 50 67 6e 6f 3b 0a 7d 0a ager->mxPgno;.}.
23350 0a 2f 2a 0a 2a 2a 20 54 68 65 20 66 6f 6c 6c 6f ./*.** The follo
23360 77 69 6e 67 20 73 65 74 20 6f 66 20 72 6f 75 74 wing set of rout
23370 69 6e 65 73 20 61 72 65 20 75 73 65 64 20 74 6f ines are used to
23380 20 64 69 73 61 62 6c 65 20 74 68 65 20 73 69 6d disable the sim
23390 75 6c 61 74 65 64 0a 2a 2a 20 49 2f 4f 20 65 72 ulated.** I/O er
233a0 72 6f 72 20 6d 65 63 68 61 6e 69 73 6d 2e 20 20 ror mechanism.
233b0 54 68 65 73 65 20 72 6f 75 74 69 6e 65 73 20 61 These routines a
233c0 72 65 20 75 73 65 64 20 74 6f 20 61 76 6f 69 64 re used to avoid
233d0 20 73 69 6d 75 6c 61 74 65 64 0a 2a 2a 20 65 72 simulated.** er
233e0 72 6f 72 73 20 69 6e 20 70 6c 61 63 65 73 20 77 rors in places w
233f0 68 65 72 65 20 77 65 20 64 6f 20 6e 6f 74 20 63 here we do not c
23400 61 72 65 20 61 62 6f 75 74 20 65 72 72 6f 72 73 are about errors
23410 2e 0a 2a 2a 0a 2a 2a 20 55 6e 6c 65 73 73 20 2d ..**.** Unless -
23420 44 53 51 4c 49 54 45 5f 54 45 53 54 3d 31 20 69 DSQLITE_TEST=1 i
23430 73 20 75 73 65 64 2c 20 74 68 65 73 65 20 72 6f s used, these ro
23440 75 74 69 6e 65 73 20 61 72 65 20 61 6c 6c 20 6e utines are all n
23450 6f 2d 6f 70 73 0a 2a 2a 20 61 6e 64 20 67 65 6e o-ops.** and gen
23460 65 72 61 74 65 20 6e 6f 20 63 6f 64 65 2e 0a 2a erate no code..*
23470 2f 0a 23 69 66 64 65 66 20 53 51 4c 49 54 45 5f /.#ifdef SQLITE_
23480 54 45 53 54 0a 65 78 74 65 72 6e 20 69 6e 74 20 TEST.extern int
23490 73 71 6c 69 74 65 33 5f 69 6f 5f 65 72 72 6f 72 sqlite3_io_error
234a0 5f 70 65 6e 64 69 6e 67 3b 0a 65 78 74 65 72 6e _pending;.extern
234b0 20 69 6e 74 20 73 71 6c 69 74 65 33 5f 69 6f 5f int sqlite3_io_
234c0 65 72 72 6f 72 5f 68 69 74 3b 0a 73 74 61 74 69 error_hit;.stati
234d0 63 20 69 6e 74 20 73 61 76 65 64 5f 63 6e 74 3b c int saved_cnt;
234e0 0a 76 6f 69 64 20 64 69 73 61 62 6c 65 5f 73 69 .void disable_si
234f0 6d 75 6c 61 74 65 64 5f 69 6f 5f 65 72 72 6f 72 mulated_io_error
23500 73 28 76 6f 69 64 29 7b 0a 20 20 73 61 76 65 64 s(void){. saved
23510 5f 63 6e 74 20 3d 20 73 71 6c 69 74 65 33 5f 69 _cnt = sqlite3_i
23520 6f 5f 65 72 72 6f 72 5f 70 65 6e 64 69 6e 67 3b o_error_pending;
23530 0a 20 20 73 71 6c 69 74 65 33 5f 69 6f 5f 65 72 . sqlite3_io_er
23540 72 6f 72 5f 70 65 6e 64 69 6e 67 20 3d 20 2d 31 ror_pending = -1
23550 3b 0a 7d 0a 76 6f 69 64 20 65 6e 61 62 6c 65 5f ;.}.void enable_
23560 73 69 6d 75 6c 61 74 65 64 5f 69 6f 5f 65 72 72 simulated_io_err
23570 6f 72 73 28 76 6f 69 64 29 7b 0a 20 20 73 71 6c ors(void){. sql
23580 69 74 65 33 5f 69 6f 5f 65 72 72 6f 72 5f 70 65 ite3_io_error_pe
23590 6e 64 69 6e 67 20 3d 20 73 61 76 65 64 5f 63 6e nding = saved_cn
235a0 74 3b 0a 7d 0a 23 65 6c 73 65 0a 23 20 64 65 66 t;.}.#else.# def
235b0 69 6e 65 20 64 69 73 61 62 6c 65 5f 73 69 6d 75 ine disable_simu
235c0 6c 61 74 65 64 5f 69 6f 5f 65 72 72 6f 72 73 28 lated_io_errors(
235d0 29 0a 23 20 64 65 66 69 6e 65 20 65 6e 61 62 6c ).# define enabl
235e0 65 5f 73 69 6d 75 6c 61 74 65 64 5f 69 6f 5f 65 e_simulated_io_e
235f0 72 72 6f 72 73 28 29 0a 23 65 6e 64 69 66 0a 0a rrors().#endif..
23600 2f 2a 0a 2a 2a 20 52 65 61 64 20 74 68 65 20 66 /*.** Read the f
23610 69 72 73 74 20 4e 20 62 79 74 65 73 20 66 72 6f irst N bytes fro
23620 6d 20 74 68 65 20 62 65 67 69 6e 6e 69 6e 67 20 m the beginning
23630 6f 66 20 74 68 65 20 66 69 6c 65 20 69 6e 74 6f of the file into
23640 20 6d 65 6d 6f 72 79 0a 2a 2a 20 74 68 61 74 20 memory.** that
23650 70 44 65 73 74 20 70 6f 69 6e 74 73 20 74 6f 2e pDest points to.
23660 20 0a 2a 2a 0a 2a 2a 20 49 66 20 74 68 65 20 70 .**.** If the p
23670 61 67 65 72 20 77 61 73 20 6f 70 65 6e 65 64 20 ager was opened
23680 6f 6e 20 61 20 74 72 61 6e 73 69 65 6e 74 20 66 on a transient f
23690 69 6c 65 20 28 7a 46 69 6c 65 6e 61 6d 65 3d 3d ile (zFilename==
236a0 22 22 29 2c 20 6f 72 0a 2a 2a 20 6f 70 65 6e 65 ""), or.** opene
236b0 64 20 6f 6e 20 61 20 66 69 6c 65 20 6c 65 73 73 d on a file less
236c0 20 74 68 61 6e 20 4e 20 62 79 74 65 73 20 69 6e than N bytes in
236d0 20 73 69 7a 65 2c 20 74 68 65 20 6f 75 74 70 75 size, the outpu
236e0 74 20 62 75 66 66 65 72 20 69 73 0a 2a 2a 20 7a t buffer is.** z
236f0 65 72 6f 65 64 20 61 6e 64 20 53 51 4c 49 54 45 eroed and SQLITE
23700 5f 4f 4b 20 72 65 74 75 72 6e 65 64 2e 20 54 68 _OK returned. Th
23710 65 20 72 61 74 69 6f 6e 61 6c 65 20 66 6f 72 20 e rationale for
23720 74 68 69 73 20 69 73 20 74 68 61 74 20 74 68 69 this is that thi
23730 73 20 0a 2a 2a 20 66 75 6e 63 74 69 6f 6e 20 69 s .** function i
23740 73 20 75 73 65 64 20 74 6f 20 72 65 61 64 20 64 s used to read d
23750 61 74 61 62 61 73 65 20 68 65 61 64 65 72 73 2c atabase headers,
23760 20 61 6e 64 20 61 20 6e 65 77 20 74 72 61 6e 73 and a new trans
23770 69 65 6e 74 20 6f 72 0a 2a 2a 20 7a 65 72 6f 20 ient or.** zero
23780 73 69 7a 65 64 20 64 61 74 61 62 61 73 65 20 68 sized database h
23790 61 73 20 61 20 68 65 61 64 65 72 20 74 68 61 6e as a header than
237a0 20 63 6f 6e 73 69 73 74 73 20 65 6e 74 69 72 65 consists entire
237b0 6c 79 20 6f 66 20 7a 65 72 6f 65 73 2e 0a 2a 2a ly of zeroes..**
237c0 0a 2a 2a 20 49 66 20 61 6e 79 20 49 4f 20 65 72 .** If any IO er
237d0 72 6f 72 20 61 70 61 72 74 20 66 72 6f 6d 20 53 ror apart from S
237e0 51 4c 49 54 45 5f 49 4f 45 52 52 5f 53 48 4f 52 QLITE_IOERR_SHOR
237f0 54 5f 52 45 41 44 20 69 73 20 65 6e 63 6f 75 6e T_READ is encoun
23800 74 65 72 65 64 2c 0a 2a 2a 20 74 68 65 20 65 72 tered,.** the er
23810 72 6f 72 20 63 6f 64 65 20 69 73 20 72 65 74 75 ror code is retu
23820 72 6e 65 64 20 74 6f 20 74 68 65 20 63 61 6c 6c rned to the call
23830 65 72 20 61 6e 64 20 74 68 65 20 63 6f 6e 74 65 er and the conte
23840 6e 74 73 20 6f 66 20 74 68 65 0a 2a 2a 20 6f 75 nts of the.** ou
23850 74 70 75 74 20 62 75 66 66 65 72 20 75 6e 64 65 tput buffer unde
23860 66 69 6e 65 64 2e 0a 2a 2f 0a 69 6e 74 20 73 71 fined..*/.int sq
23870 6c 69 74 65 33 50 61 67 65 72 52 65 61 64 46 69 lite3PagerReadFi
23880 6c 65 68 65 61 64 65 72 28 50 61 67 65 72 20 2a leheader(Pager *
23890 70 50 61 67 65 72 2c 20 69 6e 74 20 4e 2c 20 75 pPager, int N, u
238a0 6e 73 69 67 6e 65 64 20 63 68 61 72 20 2a 70 44 nsigned char *pD
238b0 65 73 74 29 7b 0a 20 20 69 6e 74 20 72 63 20 3d est){. int rc =
238c0 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20 20 6d 65 SQLITE_OK;. me
238d0 6d 73 65 74 28 70 44 65 73 74 2c 20 30 2c 20 4e mset(pDest, 0, N
238e0 29 3b 0a 20 20 61 73 73 65 72 74 28 20 69 73 4f );. assert( isO
238f0 70 65 6e 28 70 50 61 67 65 72 2d 3e 66 64 29 20 pen(pPager->fd)
23900 7c 7c 20 70 50 61 67 65 72 2d 3e 74 65 6d 70 46 || pPager->tempF
23910 69 6c 65 20 29 3b 0a 0a 20 20 2f 2a 20 54 68 69 ile );.. /* Thi
23920 73 20 72 6f 75 74 69 6e 65 20 69 73 20 6f 6e 6c s routine is onl
23930 79 20 63 61 6c 6c 65 64 20 62 79 20 62 74 72 65 y called by btre
23940 65 20 69 6d 6d 65 64 69 61 74 65 6c 79 20 61 66 e immediately af
23950 74 65 72 20 63 72 65 61 74 69 6e 67 0a 20 20 2a ter creating. *
23960 2a 20 74 68 65 20 50 61 67 65 72 20 6f 62 6a 65 * the Pager obje
23970 63 74 2e 20 20 54 68 65 72 65 20 68 61 73 20 6e ct. There has n
23980 6f 74 20 62 65 65 6e 20 61 6e 20 6f 70 70 6f 72 ot been an oppor
23990 74 75 6e 69 74 79 20 74 6f 20 74 72 61 6e 73 69 tunity to transi
239a0 74 69 6f 6e 0a 20 20 2a 2a 20 74 6f 20 57 41 4c tion. ** to WAL
239b0 20 6d 6f 64 65 20 79 65 74 2e 0a 20 20 2a 2f 0a mode yet.. */.
239c0 20 20 61 73 73 65 72 74 28 20 21 70 61 67 65 72 assert( !pager
239d0 55 73 65 57 61 6c 28 70 50 61 67 65 72 29 20 29 UseWal(pPager) )
239e0 3b 0a 0a 20 20 69 66 28 20 69 73 4f 70 65 6e 28 ;.. if( isOpen(
239f0 70 50 61 67 65 72 2d 3e 66 64 29 20 29 7b 0a 20 pPager->fd) ){.
23a00 20 20 20 49 4f 54 52 41 43 45 28 28 22 44 42 48 IOTRACE(("DBH
23a10 44 52 20 25 70 20 30 20 25 64 5c 6e 22 2c 20 70 DR %p 0 %d\n", p
23a20 50 61 67 65 72 2c 20 4e 29 29 0a 20 20 20 20 72 Pager, N)). r
23a30 63 20 3d 20 73 71 6c 69 74 65 33 4f 73 52 65 61 c = sqlite3OsRea
23a40 64 28 70 50 61 67 65 72 2d 3e 66 64 2c 20 70 44 d(pPager->fd, pD
23a50 65 73 74 2c 20 4e 2c 20 30 29 3b 0a 20 20 20 20 est, N, 0);.
23a60 69 66 28 20 72 63 3d 3d 53 51 4c 49 54 45 5f 49 if( rc==SQLITE_I
23a70 4f 45 52 52 5f 53 48 4f 52 54 5f 52 45 41 44 20 OERR_SHORT_READ
23a80 29 7b 0a 20 20 20 20 20 20 72 63 20 3d 20 53 51 ){. rc = SQ
23a90 4c 49 54 45 5f 4f 4b 3b 0a 20 20 20 20 7d 0a 20 LITE_OK;. }.
23aa0 20 7d 0a 20 20 72 65 74 75 72 6e 20 72 63 3b 0a }. return rc;.
23ab0 7d 0a 0a 2f 2a 0a 2a 2a 20 54 68 69 73 20 66 75 }../*.** This fu
23ac0 6e 63 74 69 6f 6e 20 6d 61 79 20 6f 6e 6c 79 20 nction may only
23ad0 62 65 20 63 61 6c 6c 65 64 20 77 68 65 6e 20 61 be called when a
23ae0 20 72 65 61 64 2d 74 72 61 6e 73 61 63 74 69 6f read-transactio
23af0 6e 20 69 73 20 6f 70 65 6e 20 6f 6e 0a 2a 2a 20 n is open on.**
23b00 74 68 65 20 70 61 67 65 72 2e 20 49 74 20 72 65 the pager. It re
23b10 74 75 72 6e 73 20 74 68 65 20 74 6f 74 61 6c 20 turns the total
23b20 6e 75 6d 62 65 72 20 6f 66 20 70 61 67 65 73 20 number of pages
23b30 69 6e 20 74 68 65 20 64 61 74 61 62 61 73 65 2e in the database.
23b40 0a 2a 2a 0a 2a 2a 20 48 6f 77 65 76 65 72 2c 20 .**.** However,
23b50 69 66 20 74 68 65 20 66 69 6c 65 20 69 73 20 62 if the file is b
23b60 65 74 77 65 65 6e 20 31 20 61 6e 64 20 3c 70 61 etween 1 and <pa
23b70 67 65 2d 73 69 7a 65 3e 20 62 79 74 65 73 20 69 ge-size> bytes i
23b80 6e 20 73 69 7a 65 2c 20 74 68 65 6e 20 0a 2a 2a n size, then .**
23b90 20 74 68 69 73 20 69 73 20 63 6f 6e 73 69 64 65 this is conside
23ba0 72 65 64 20 61 20 31 20 70 61 67 65 20 66 69 6c red a 1 page fil
23bb0 65 2e 0a 2a 2f 0a 76 6f 69 64 20 73 71 6c 69 74 e..*/.void sqlit
23bc0 65 33 50 61 67 65 72 50 61 67 65 63 6f 75 6e 74 e3PagerPagecount
23bd0 28 50 61 67 65 72 20 2a 70 50 61 67 65 72 2c 20 (Pager *pPager,
23be0 69 6e 74 20 2a 70 6e 50 61 67 65 29 7b 0a 20 20 int *pnPage){.
23bf0 61 73 73 65 72 74 28 20 70 50 61 67 65 72 2d 3e assert( pPager->
23c00 65 53 74 61 74 65 3e 3d 50 41 47 45 52 5f 52 45 eState>=PAGER_RE
23c10 41 44 45 52 20 29 3b 0a 20 20 61 73 73 65 72 74 ADER );. assert
23c20 28 20 70 50 61 67 65 72 2d 3e 65 53 74 61 74 65 ( pPager->eState
23c30 21 3d 50 41 47 45 52 5f 57 52 49 54 45 52 5f 46 !=PAGER_WRITER_F
23c40 49 4e 49 53 48 45 44 20 29 3b 0a 20 20 2a 70 6e INISHED );. *pn
23c50 50 61 67 65 20 3d 20 28 69 6e 74 29 70 50 61 67 Page = (int)pPag
23c60 65 72 2d 3e 64 62 53 69 7a 65 3b 0a 7d 0a 0a 0a er->dbSize;.}...
23c70 2f 2a 0a 2a 2a 20 54 72 79 20 74 6f 20 6f 62 74 /*.** Try to obt
23c80 61 69 6e 20 61 20 6c 6f 63 6b 20 6f 66 20 74 79 ain a lock of ty
23c90 70 65 20 6c 6f 63 6b 74 79 70 65 20 6f 6e 20 74 pe locktype on t
23ca0 68 65 20 64 61 74 61 62 61 73 65 20 66 69 6c 65 he database file
23cb0 2e 20 49 66 0a 2a 2a 20 61 20 73 69 6d 69 6c 61 . If.** a simila
23cc0 72 20 6f 72 20 67 72 65 61 74 65 72 20 6c 6f 63 r or greater loc
23cd0 6b 20 69 73 20 61 6c 72 65 61 64 79 20 68 65 6c k is already hel
23ce0 64 2c 20 74 68 69 73 20 66 75 6e 63 74 69 6f 6e d, this function
23cf0 20 69 73 20 61 20 6e 6f 2d 6f 70 0a 2a 2a 20 28 is a no-op.** (
23d00 72 65 74 75 72 6e 69 6e 67 20 53 51 4c 49 54 45 returning SQLITE
23d10 5f 4f 4b 20 69 6d 6d 65 64 69 61 74 65 6c 79 29 _OK immediately)
23d20 2e 0a 2a 2a 0a 2a 2a 20 4f 74 68 65 72 77 69 73 ..**.** Otherwis
23d30 65 2c 20 61 74 74 65 6d 70 74 20 74 6f 20 6f 62 e, attempt to ob
23d40 74 61 69 6e 20 74 68 65 20 6c 6f 63 6b 20 75 73 tain the lock us
23d50 69 6e 67 20 73 71 6c 69 74 65 33 4f 73 4c 6f 63 ing sqlite3OsLoc
23d60 6b 28 29 2e 20 49 6e 76 6f 6b 65 20 0a 2a 2a 20 k(). Invoke .**
23d70 74 68 65 20 62 75 73 79 20 63 61 6c 6c 62 61 63 the busy callbac
23d80 6b 20 69 66 20 74 68 65 20 6c 6f 63 6b 20 69 73 k if the lock is
23d90 20 63 75 72 72 65 6e 74 6c 79 20 6e 6f 74 20 61 currently not a
23da0 76 61 69 6c 61 62 6c 65 2e 20 52 65 70 65 61 74 vailable. Repeat
23db0 20 0a 2a 2a 20 75 6e 74 69 6c 20 74 68 65 20 62 .** until the b
23dc0 75 73 79 20 63 61 6c 6c 62 61 63 6b 20 72 65 74 usy callback ret
23dd0 75 72 6e 73 20 66 61 6c 73 65 20 6f 72 20 75 6e urns false or un
23de0 74 69 6c 20 74 68 65 20 61 74 74 65 6d 70 74 20 til the attempt
23df0 74 6f 20 0a 2a 2a 20 6f 62 74 61 69 6e 20 74 68 to .** obtain th
23e00 65 20 6c 6f 63 6b 20 73 75 63 63 65 65 64 73 2e e lock succeeds.
23e10 0a 2a 2a 0a 2a 2a 20 52 65 74 75 72 6e 20 53 51 .**.** Return SQ
23e20 4c 49 54 45 5f 4f 4b 20 6f 6e 20 73 75 63 63 65 LITE_OK on succe
23e30 73 73 20 61 6e 64 20 61 6e 20 65 72 72 6f 72 20 ss and an error
23e40 63 6f 64 65 20 69 66 20 77 65 20 63 61 6e 6e 6f code if we canno
23e50 74 20 6f 62 74 61 69 6e 0a 2a 2a 20 74 68 65 20 t obtain.** the
23e60 6c 6f 63 6b 2e 20 49 66 20 74 68 65 20 6c 6f 63 lock. If the loc
23e70 6b 20 69 73 20 6f 62 74 61 69 6e 65 64 20 73 75 k is obtained su
23e80 63 63 65 73 73 66 75 6c 6c 79 2c 20 73 65 74 20 ccessfully, set
23e90 74 68 65 20 50 61 67 65 72 2e 73 74 61 74 65 20 the Pager.state
23ea0 0a 2a 2a 20 76 61 72 69 61 62 6c 65 20 74 6f 20 .** variable to
23eb0 6c 6f 63 6b 74 79 70 65 20 62 65 66 6f 72 65 20 locktype before
23ec0 72 65 74 75 72 6e 69 6e 67 2e 0a 2a 2f 0a 73 74 returning..*/.st
23ed0 61 74 69 63 20 69 6e 74 20 70 61 67 65 72 5f 77 atic int pager_w
23ee0 61 69 74 5f 6f 6e 5f 6c 6f 63 6b 28 50 61 67 65 ait_on_lock(Page
23ef0 72 20 2a 70 50 61 67 65 72 2c 20 69 6e 74 20 6c r *pPager, int l
23f00 6f 63 6b 74 79 70 65 29 7b 0a 20 20 69 6e 74 20 ocktype){. int
23f10 72 63 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 rc;
23f20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
23f30 20 2f 2a 20 52 65 74 75 72 6e 20 63 6f 64 65 20 /* Return code
23f40 2a 2f 0a 0a 20 20 2f 2a 20 43 68 65 63 6b 20 74 */.. /* Check t
23f50 68 61 74 20 74 68 69 73 20 69 73 20 65 69 74 68 hat this is eith
23f60 65 72 20 61 20 6e 6f 2d 6f 70 20 28 62 65 63 61 er a no-op (beca
23f70 75 73 65 20 74 68 65 20 72 65 71 75 65 73 74 65 use the requeste
23f80 64 20 6c 6f 63 6b 20 69 73 20 0a 20 20 2a 2a 20 d lock is . **
23f90 61 6c 72 65 61 64 79 20 68 65 6c 64 2c 20 6f 72 already held, or
23fa0 20 6f 6e 65 20 6f 66 20 74 68 65 20 74 72 61 6e one of the tran
23fb0 73 69 73 74 69 6f 6e 73 20 74 68 61 74 20 74 68 sistions that th
23fc0 65 20 62 75 73 79 2d 68 61 6e 64 6c 65 72 0a 20 e busy-handler.
23fd0 20 2a 2a 20 6d 61 79 20 62 65 20 69 6e 76 6f 6b ** may be invok
23fe0 65 64 20 64 75 72 69 6e 67 2c 20 61 63 63 6f 72 ed during, accor
23ff0 64 69 6e 67 20 74 6f 20 74 68 65 20 63 6f 6d 6d ding to the comm
24000 65 6e 74 20 61 62 6f 76 65 0a 20 20 2a 2a 20 73 ent above. ** s
24010 71 6c 69 74 65 33 50 61 67 65 72 53 65 74 42 75 qlite3PagerSetBu
24020 73 79 68 61 6e 64 6c 65 72 28 29 2e 0a 20 20 2a syhandler().. *
24030 2f 0a 20 20 61 73 73 65 72 74 28 20 28 70 50 61 /. assert( (pPa
24040 67 65 72 2d 3e 65 4c 6f 63 6b 3e 3d 6c 6f 63 6b ger->eLock>=lock
24050 74 79 70 65 29 0a 20 20 20 20 20 20 20 7c 7c 20 type). ||
24060 28 70 50 61 67 65 72 2d 3e 65 4c 6f 63 6b 3d 3d (pPager->eLock==
24070 4e 4f 5f 4c 4f 43 4b 20 26 26 20 6c 6f 63 6b 74 NO_LOCK && lockt
24080 79 70 65 3d 3d 53 48 41 52 45 44 5f 4c 4f 43 4b ype==SHARED_LOCK
24090 29 0a 20 20 20 20 20 20 20 7c 7c 20 28 70 50 61 ). || (pPa
240a0 67 65 72 2d 3e 65 4c 6f 63 6b 3d 3d 52 45 53 45 ger->eLock==RESE
240b0 52 56 45 44 5f 4c 4f 43 4b 20 26 26 20 6c 6f 63 RVED_LOCK && loc
240c0 6b 74 79 70 65 3d 3d 45 58 43 4c 55 53 49 56 45 ktype==EXCLUSIVE
240d0 5f 4c 4f 43 4b 29 0a 20 20 29 3b 0a 0a 20 20 64 _LOCK). );.. d
240e0 6f 20 7b 0a 20 20 20 20 72 63 20 3d 20 70 61 67 o {. rc = pag
240f0 65 72 4c 6f 63 6b 44 62 28 70 50 61 67 65 72 2c erLockDb(pPager,
24100 20 6c 6f 63 6b 74 79 70 65 29 3b 0a 20 20 7d 77 locktype);. }w
24110 68 69 6c 65 28 20 72 63 3d 3d 53 51 4c 49 54 45 hile( rc==SQLITE
24120 5f 42 55 53 59 20 26 26 20 70 50 61 67 65 72 2d _BUSY && pPager-
24130 3e 78 42 75 73 79 48 61 6e 64 6c 65 72 28 70 50 >xBusyHandler(pP
24140 61 67 65 72 2d 3e 70 42 75 73 79 48 61 6e 64 6c ager->pBusyHandl
24150 65 72 41 72 67 29 20 29 3b 0a 20 20 72 65 74 75 erArg) );. retu
24160 72 6e 20 72 63 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 rn rc;.}../*.**
24170 46 75 6e 63 74 69 6f 6e 20 61 73 73 65 72 74 54 Function assertT
24180 72 75 6e 63 61 74 65 43 6f 6e 73 74 72 61 69 6e runcateConstrain
24190 74 28 70 50 61 67 65 72 29 20 63 68 65 63 6b 73 t(pPager) checks
241a0 20 74 68 61 74 20 6f 6e 65 20 6f 66 20 74 68 65 that one of the
241b0 20 0a 2a 2a 20 66 6f 6c 6c 6f 77 69 6e 67 20 69 .** following i
241c0 73 20 74 72 75 65 20 66 6f 72 20 61 6c 6c 20 64 s true for all d
241d0 69 72 74 79 20 70 61 67 65 73 20 63 75 72 72 65 irty pages curre
241e0 6e 74 6c 79 20 69 6e 20 74 68 65 20 70 61 67 65 ntly in the page
241f0 2d 63 61 63 68 65 3a 0a 2a 2a 0a 2a 2a 20 20 20 -cache:.**.**
24200 61 29 20 54 68 65 20 70 61 67 65 20 6e 75 6d 62 a) The page numb
24210 65 72 20 69 73 20 6c 65 73 73 20 74 68 61 6e 20 er is less than
24220 6f 72 20 65 71 75 61 6c 20 74 6f 20 74 68 65 20 or equal to the
24230 73 69 7a 65 20 6f 66 20 74 68 65 20 0a 2a 2a 20 size of the .**
24240 20 20 20 20 20 63 75 72 72 65 6e 74 20 64 61 74 current dat
24250 61 62 61 73 65 20 69 6d 61 67 65 2c 20 69 6e 20 abase image, in
24260 70 61 67 65 73 2c 20 4f 52 0a 2a 2a 0a 2a 2a 20 pages, OR.**.**
24270 20 20 62 29 20 69 66 20 74 68 65 20 70 61 67 65 b) if the page
24280 20 63 6f 6e 74 65 6e 74 20 77 65 72 65 20 77 72 content were wr
24290 69 74 74 65 6e 20 61 74 20 74 68 69 73 20 74 69 itten at this ti
242a0 6d 65 2c 20 69 74 20 77 6f 75 6c 64 20 6e 6f 74 me, it would not
242b0 0a 2a 2a 20 20 20 20 20 20 62 65 20 6e 65 63 65 .** be nece
242c0 73 73 61 72 79 20 74 6f 20 77 72 69 74 65 20 74 ssary to write t
242d0 68 65 20 63 75 72 72 65 6e 74 20 63 6f 6e 74 65 he current conte
242e0 6e 74 20 6f 75 74 20 74 6f 20 74 68 65 20 73 75 nt out to the su
242f0 62 2d 6a 6f 75 72 6e 61 6c 0a 2a 2a 20 20 20 20 b-journal.**
24300 20 20 28 61 73 20 64 65 74 65 72 6d 69 6e 65 64 (as determined
24310 20 62 79 20 66 75 6e 63 74 69 6f 6e 20 73 75 62 by function sub
24320 6a 52 65 71 75 69 72 65 73 50 61 67 65 28 29 29 jRequiresPage())
24330 2e 0a 2a 2a 0a 2a 2a 20 49 66 20 74 68 65 20 63 ..**.** If the c
24340 6f 6e 64 69 74 69 6f 6e 20 61 73 73 65 72 74 65 ondition asserte
24350 64 20 62 79 20 74 68 69 73 20 66 75 6e 63 74 69 d by this functi
24360 6f 6e 20 77 65 72 65 20 6e 6f 74 20 74 72 75 65 on were not true
24370 2c 20 61 6e 64 20 74 68 65 0a 2a 2a 20 64 69 72 , and the.** dir
24380 74 79 20 70 61 67 65 20 77 65 72 65 20 74 6f 20 ty page were to
24390 62 65 20 64 69 73 63 61 72 64 65 64 20 66 72 6f be discarded fro
243a0 6d 20 74 68 65 20 63 61 63 68 65 20 76 69 61 20 m the cache via
243b0 74 68 65 20 70 61 67 65 72 53 74 72 65 73 73 28 the pagerStress(
243c0 29 0a 2a 2a 20 72 6f 75 74 69 6e 65 2c 20 70 61 ).** routine, pa
243d0 67 65 72 53 74 72 65 73 73 28 29 20 77 6f 75 6c gerStress() woul
243e0 64 20 6e 6f 74 20 77 72 69 74 65 20 74 68 65 20 d not write the
243f0 63 75 72 72 65 6e 74 20 70 61 67 65 20 63 6f 6e current page con
24400 74 65 6e 74 20 74 6f 0a 2a 2a 20 74 68 65 20 64 tent to.** the d
24410 61 74 61 62 61 73 65 20 66 69 6c 65 2e 20 49 66 atabase file. If
24420 20 61 20 73 61 76 65 70 6f 69 6e 74 20 74 72 61 a savepoint tra
24430 6e 73 61 63 74 69 6f 6e 20 77 65 72 65 20 72 6f nsaction were ro
24440 6c 6c 65 64 20 62 61 63 6b 20 61 66 74 65 72 0a lled back after.
24450 2a 2a 20 74 68 69 73 20 68 61 70 70 65 6e 65 64 ** this happened
24460 2c 20 74 68 65 20 63 6f 72 72 65 63 74 20 62 65 , the correct be
24470 68 61 76 69 6f 75 72 20 77 6f 75 6c 64 20 62 65 haviour would be
24480 20 74 6f 20 72 65 73 74 6f 72 65 20 74 68 65 20 to restore the
24490 63 75 72 72 65 6e 74 0a 2a 2a 20 63 6f 6e 74 65 current.** conte
244a0 6e 74 20 6f 66 20 74 68 65 20 70 61 67 65 2e 20 nt of the page.
244b0 48 6f 77 65 76 65 72 2c 20 73 69 6e 63 65 20 74 However, since t
244c0 68 69 73 20 63 6f 6e 74 65 6e 74 20 69 73 20 6e his content is n
244d0 6f 74 20 70 72 65 73 65 6e 74 20 69 6e 20 65 69 ot present in ei
244e0 74 68 65 72 0a 2a 2a 20 74 68 65 20 64 61 74 61 ther.** the data
244f0 62 61 73 65 20 66 69 6c 65 20 6f 72 20 74 68 65 base file or the
24500 20 70 6f 72 74 69 6f 6e 20 6f 66 20 74 68 65 20 portion of the
24510 72 6f 6c 6c 62 61 63 6b 20 6a 6f 75 72 6e 61 6c rollback journal
24520 20 61 6e 64 20 0a 2a 2a 20 73 75 62 2d 6a 6f 75 and .** sub-jou
24530 72 6e 61 6c 20 72 6f 6c 6c 65 64 20 62 61 63 6b rnal rolled back
24540 20 74 68 65 20 63 6f 6e 74 65 6e 74 20 63 6f 75 the content cou
24550 6c 64 20 6e 6f 74 20 62 65 20 72 65 73 74 6f 72 ld not be restor
24560 65 64 20 61 6e 64 20 74 68 65 0a 2a 2a 20 64 61 ed and the.** da
24570 74 61 62 61 73 65 20 69 6d 61 67 65 20 77 6f 75 tabase image wou
24580 6c 64 20 62 65 63 6f 6d 65 20 63 6f 72 72 75 70 ld become corrup
24590 74 2e 20 49 74 20 69 73 20 74 68 65 72 65 66 6f t. It is therefo
245a0 72 65 20 66 6f 72 74 75 6e 61 74 65 20 74 68 61 re fortunate tha
245b0 74 20 0a 2a 2a 20 74 68 69 73 20 63 69 72 63 75 t .** this circu
245c0 6d 73 74 61 6e 63 65 20 63 61 6e 6e 6f 74 20 61 mstance cannot a
245d0 72 69 73 65 2e 0a 2a 2f 0a 23 69 66 20 64 65 66 rise..*/.#if def
245e0 69 6e 65 64 28 53 51 4c 49 54 45 5f 44 45 42 55 ined(SQLITE_DEBU
245f0 47 29 0a 73 74 61 74 69 63 20 76 6f 69 64 20 61 G).static void a
24600 73 73 65 72 74 54 72 75 6e 63 61 74 65 43 6f 6e ssertTruncateCon
24610 73 74 72 61 69 6e 74 43 62 28 50 67 48 64 72 20 straintCb(PgHdr
24620 2a 70 50 67 29 7b 0a 20 20 61 73 73 65 72 74 28 *pPg){. assert(
24630 20 70 50 67 2d 3e 66 6c 61 67 73 26 50 47 48 44 pPg->flags&PGHD
24640 52 5f 44 49 52 54 59 20 29 3b 0a 20 20 61 73 73 R_DIRTY );. ass
24650 65 72 74 28 20 21 73 75 62 6a 52 65 71 75 69 72 ert( !subjRequir
24660 65 73 50 61 67 65 28 70 50 67 29 20 7c 7c 20 70 esPage(pPg) || p
24670 50 67 2d 3e 70 67 6e 6f 3c 3d 70 50 67 2d 3e 70 Pg->pgno<=pPg->p
24680 50 61 67 65 72 2d 3e 64 62 53 69 7a 65 20 29 3b Pager->dbSize );
24690 0a 7d 0a 73 74 61 74 69 63 20 76 6f 69 64 20 61 .}.static void a
246a0 73 73 65 72 74 54 72 75 6e 63 61 74 65 43 6f 6e ssertTruncateCon
246b0 73 74 72 61 69 6e 74 28 50 61 67 65 72 20 2a 70 straint(Pager *p
246c0 50 61 67 65 72 29 7b 0a 20 20 73 71 6c 69 74 65 Pager){. sqlite
246d0 33 50 63 61 63 68 65 49 74 65 72 61 74 65 44 69 3PcacheIterateDi
246e0 72 74 79 28 70 50 61 67 65 72 2d 3e 70 50 43 61 rty(pPager->pPCa
246f0 63 68 65 2c 20 61 73 73 65 72 74 54 72 75 6e 63 che, assertTrunc
24700 61 74 65 43 6f 6e 73 74 72 61 69 6e 74 43 62 29 ateConstraintCb)
24710 3b 0a 7d 0a 23 65 6c 73 65 0a 23 20 64 65 66 69 ;.}.#else.# defi
24720 6e 65 20 61 73 73 65 72 74 54 72 75 6e 63 61 74 ne assertTruncat
24730 65 43 6f 6e 73 74 72 61 69 6e 74 28 70 50 61 67 eConstraint(pPag
24740 65 72 29 0a 23 65 6e 64 69 66 0a 0a 2f 2a 0a 2a er).#endif../*.*
24750 2a 20 54 72 75 6e 63 61 74 65 20 74 68 65 20 69 * Truncate the i
24760 6e 2d 6d 65 6d 6f 72 79 20 64 61 74 61 62 61 73 n-memory databas
24770 65 20 66 69 6c 65 20 69 6d 61 67 65 20 74 6f 20 e file image to
24780 6e 50 61 67 65 20 70 61 67 65 73 2e 20 54 68 69 nPage pages. Thi
24790 73 20 0a 2a 2a 20 66 75 6e 63 74 69 6f 6e 20 64 s .** function d
247a0 6f 65 73 20 6e 6f 74 20 61 63 74 75 61 6c 6c 79 oes not actually
247b0 20 6d 6f 64 69 66 79 20 74 68 65 20 64 61 74 61 modify the data
247c0 62 61 73 65 20 66 69 6c 65 20 6f 6e 20 64 69 73 base file on dis
247d0 6b 2e 20 49 74 20 0a 2a 2a 20 6a 75 73 74 20 73 k. It .** just s
247e0 65 74 73 20 74 68 65 20 69 6e 74 65 72 6e 61 6c ets the internal
247f0 20 73 74 61 74 65 20 6f 66 20 74 68 65 20 70 61 state of the pa
24800 67 65 72 20 6f 62 6a 65 63 74 20 73 6f 20 74 68 ger object so th
24810 61 74 20 74 68 65 20 0a 2a 2a 20 74 72 75 6e 63 at the .** trunc
24820 61 74 69 6f 6e 20 77 69 6c 6c 20 62 65 20 64 6f ation will be do
24830 6e 65 20 77 68 65 6e 20 74 68 65 20 63 75 72 72 ne when the curr
24840 65 6e 74 20 74 72 61 6e 73 61 63 74 69 6f 6e 20 ent transaction
24850 69 73 20 63 6f 6d 6d 69 74 74 65 64 2e 0a 2a 2f is committed..*/
24860 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 50 61 67 .void sqlite3Pag
24870 65 72 54 72 75 6e 63 61 74 65 49 6d 61 67 65 28 erTruncateImage(
24880 50 61 67 65 72 20 2a 70 50 61 67 65 72 2c 20 50 Pager *pPager, P
24890 67 6e 6f 20 6e 50 61 67 65 29 7b 0a 20 20 61 73 gno nPage){. as
248a0 73 65 72 74 28 20 70 50 61 67 65 72 2d 3e 64 62 sert( pPager->db
248b0 53 69 7a 65 3e 3d 6e 50 61 67 65 20 29 3b 0a 20 Size>=nPage );.
248c0 20 61 73 73 65 72 74 28 20 70 50 61 67 65 72 2d assert( pPager-
248d0 3e 65 53 74 61 74 65 3e 3d 50 41 47 45 52 5f 57 >eState>=PAGER_W
248e0 52 49 54 45 52 5f 43 41 43 48 45 4d 4f 44 20 29 RITER_CACHEMOD )
248f0 3b 0a 20 20 70 50 61 67 65 72 2d 3e 64 62 53 69 ;. pPager->dbSi
24900 7a 65 20 3d 20 6e 50 61 67 65 3b 0a 20 20 61 73 ze = nPage;. as
24910 73 65 72 74 54 72 75 6e 63 61 74 65 43 6f 6e 73 sertTruncateCons
24920 74 72 61 69 6e 74 28 70 50 61 67 65 72 29 3b 0a traint(pPager);.
24930 7d 0a 0a 0a 2f 2a 0a 2a 2a 20 54 68 69 73 20 66 }.../*.** This f
24940 75 6e 63 74 69 6f 6e 20 69 73 20 63 61 6c 6c 65 unction is calle
24950 64 20 62 65 66 6f 72 65 20 61 74 74 65 6d 70 74 d before attempt
24960 69 6e 67 20 61 20 68 6f 74 2d 6a 6f 75 72 6e 61 ing a hot-journa
24970 6c 20 72 6f 6c 6c 62 61 63 6b 2e 20 49 74 0a 2a l rollback. It.*
24980 2a 20 73 79 6e 63 73 20 74 68 65 20 6a 6f 75 72 * syncs the jour
24990 6e 61 6c 20 66 69 6c 65 20 74 6f 20 64 69 73 6b nal file to disk
249a0 2c 20 74 68 65 6e 20 73 65 74 73 20 70 50 61 67 , then sets pPag
249b0 65 72 2d 3e 6a 6f 75 72 6e 61 6c 48 64 72 20 74 er->journalHdr t
249c0 6f 20 74 68 65 0a 2a 2a 20 73 69 7a 65 20 6f 66 o the.** size of
249d0 20 74 68 65 20 6a 6f 75 72 6e 61 6c 20 66 69 6c the journal fil
249e0 65 20 73 6f 20 74 68 61 74 20 74 68 65 20 70 61 e so that the pa
249f0 67 65 72 5f 70 6c 61 79 62 61 63 6b 28 29 20 72 ger_playback() r
24a00 6f 75 74 69 6e 65 20 6b 6e 6f 77 73 0a 2a 2a 20 outine knows.**
24a10 74 68 61 74 20 74 68 65 20 65 6e 74 69 72 65 20 that the entire
24a20 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 20 68 61 73 journal file has
24a30 20 62 65 65 6e 20 73 79 6e 63 65 64 2e 0a 2a 2a been synced..**
24a40 0a 2a 2a 20 53 79 6e 63 69 6e 67 20 61 20 68 6f .** Syncing a ho
24a50 74 2d 6a 6f 75 72 6e 61 6c 20 74 6f 20 64 69 73 t-journal to dis
24a60 6b 20 62 65 66 6f 72 65 20 61 74 74 65 6d 70 74 k before attempt
24a70 69 6e 67 20 74 6f 20 72 6f 6c 6c 20 69 74 20 62 ing to roll it b
24a80 61 63 6b 20 65 6e 73 75 72 65 73 20 0a 2a 2a 20 ack ensures .**
24a90 74 68 61 74 20 69 66 20 61 20 70 6f 77 65 72 2d that if a power-
24aa0 66 61 69 6c 75 72 65 20 6f 63 63 75 72 73 20 64 failure occurs d
24ab0 75 72 69 6e 67 20 74 68 65 20 72 6f 6c 6c 62 61 uring the rollba
24ac0 63 6b 2c 20 74 68 65 20 70 72 6f 63 65 73 73 20 ck, the process
24ad0 74 68 61 74 0a 2a 2a 20 61 74 74 65 6d 70 74 73 that.** attempts
24ae0 20 72 6f 6c 6c 62 61 63 6b 20 66 6f 6c 6c 6f 77 rollback follow
24af0 69 6e 67 20 73 79 73 74 65 6d 20 72 65 63 6f 76 ing system recov
24b00 65 72 79 20 73 65 65 73 20 74 68 65 20 73 61 6d ery sees the sam
24b10 65 20 6a 6f 75 72 6e 61 6c 0a 2a 2a 20 63 6f 6e e journal.** con
24b20 74 65 6e 74 20 61 73 20 74 68 69 73 20 70 72 6f tent as this pro
24b30 63 65 73 73 2e 0a 2a 2a 0a 2a 2a 20 49 66 20 65 cess..**.** If e
24b40 76 65 72 79 74 68 69 6e 67 20 67 6f 65 73 20 61 verything goes a
24b50 73 20 70 6c 61 6e 6e 65 64 2c 20 53 51 4c 49 54 s planned, SQLIT
24b60 45 5f 4f 4b 20 69 73 20 72 65 74 75 72 6e 65 64 E_OK is returned
24b70 2e 20 4f 74 68 65 72 77 69 73 65 2c 20 0a 2a 2a . Otherwise, .**
24b80 20 61 6e 20 53 51 4c 69 74 65 20 65 72 72 6f 72 an SQLite error
24b90 20 63 6f 64 65 2e 0a 2a 2f 0a 73 74 61 74 69 63 code..*/.static
24ba0 20 69 6e 74 20 70 61 67 65 72 53 79 6e 63 48 6f int pagerSyncHo
24bb0 74 4a 6f 75 72 6e 61 6c 28 50 61 67 65 72 20 2a tJournal(Pager *
24bc0 70 50 61 67 65 72 29 7b 0a 20 20 69 6e 74 20 72 pPager){. int r
24bd0 63 20 3d 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20 c = SQLITE_OK;.
24be0 20 69 66 28 20 21 70 50 61 67 65 72 2d 3e 6e 6f if( !pPager->no
24bf0 53 79 6e 63 20 29 7b 0a 20 20 20 20 72 63 20 3d Sync ){. rc =
24c00 20 73 71 6c 69 74 65 33 4f 73 53 79 6e 63 28 70 sqlite3OsSync(p
24c10 50 61 67 65 72 2d 3e 6a 66 64 2c 20 53 51 4c 49 Pager->jfd, SQLI
24c20 54 45 5f 53 59 4e 43 5f 4e 4f 52 4d 41 4c 29 3b TE_SYNC_NORMAL);
24c30 0a 20 20 7d 0a 20 20 69 66 28 20 72 63 3d 3d 53 . }. if( rc==S
24c40 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 QLITE_OK ){.
24c50 72 63 20 3d 20 73 71 6c 69 74 65 33 4f 73 46 69 rc = sqlite3OsFi
24c60 6c 65 53 69 7a 65 28 70 50 61 67 65 72 2d 3e 6a leSize(pPager->j
24c70 66 64 2c 20 26 70 50 61 67 65 72 2d 3e 6a 6f 75 fd, &pPager->jou
24c80 72 6e 61 6c 48 64 72 29 3b 0a 20 20 7d 0a 20 20 rnalHdr);. }.
24c90 72 65 74 75 72 6e 20 72 63 3b 0a 7d 0a 0a 2f 2a return rc;.}../*
24ca0 0a 2a 2a 20 53 68 75 74 64 6f 77 6e 20 74 68 65 .** Shutdown the
24cb0 20 70 61 67 65 20 63 61 63 68 65 2e 20 20 46 72 page cache. Fr
24cc0 65 65 20 61 6c 6c 20 6d 65 6d 6f 72 79 20 61 6e ee all memory an
24cd0 64 20 63 6c 6f 73 65 20 61 6c 6c 20 66 69 6c 65 d close all file
24ce0 73 2e 0a 2a 2a 0a 2a 2a 20 49 66 20 61 20 74 72 s..**.** If a tr
24cf0 61 6e 73 61 63 74 69 6f 6e 20 77 61 73 20 69 6e ansaction was in
24d00 20 70 72 6f 67 72 65 73 73 20 77 68 65 6e 20 74 progress when t
24d10 68 69 73 20 72 6f 75 74 69 6e 65 20 69 73 20 63 his routine is c
24d20 61 6c 6c 65 64 2c 20 74 68 61 74 0a 2a 2a 20 74 alled, that.** t
24d30 72 61 6e 73 61 63 74 69 6f 6e 20 69 73 20 72 6f ransaction is ro
24d40 6c 6c 65 64 20 62 61 63 6b 2e 20 20 41 6c 6c 20 lled back. All
24d50 6f 75 74 73 74 61 6e 64 69 6e 67 20 70 61 67 65 outstanding page
24d60 73 20 61 72 65 20 69 6e 76 61 6c 69 64 61 74 65 s are invalidate
24d70 64 0a 2a 2a 20 61 6e 64 20 74 68 65 69 72 20 6d d.** and their m
24d80 65 6d 6f 72 79 20 69 73 20 66 72 65 65 64 2e 20 emory is freed.
24d90 20 41 6e 79 20 61 74 74 65 6d 70 74 20 74 6f 20 Any attempt to
24da0 75 73 65 20 61 20 70 61 67 65 20 61 73 73 6f 63 use a page assoc
24db0 69 61 74 65 64 0a 2a 2a 20 77 69 74 68 20 74 68 iated.** with th
24dc0 69 73 20 70 61 67 65 20 63 61 63 68 65 20 61 66 is page cache af
24dd0 74 65 72 20 74 68 69 73 20 66 75 6e 63 74 69 6f ter this functio
24de0 6e 20 72 65 74 75 72 6e 73 20 77 69 6c 6c 20 6c n returns will l
24df0 69 6b 65 6c 79 0a 2a 2a 20 72 65 73 75 6c 74 20 ikely.** result
24e00 69 6e 20 61 20 63 6f 72 65 64 75 6d 70 2e 0a 2a in a coredump..*
24e10 2a 0a 2a 2a 20 54 68 69 73 20 66 75 6e 63 74 69 *.** This functi
24e20 6f 6e 20 61 6c 77 61 79 73 20 73 75 63 63 65 65 on always succee
24e30 64 73 2e 20 49 66 20 61 20 74 72 61 6e 73 61 63 ds. If a transac
24e40 74 69 6f 6e 20 69 73 20 61 63 74 69 76 65 20 61 tion is active a
24e50 6e 20 61 74 74 65 6d 70 74 0a 2a 2a 20 69 73 20 n attempt.** is
24e60 6d 61 64 65 20 74 6f 20 72 6f 6c 6c 20 69 74 20 made to roll it
24e70 62 61 63 6b 2e 20 49 66 20 61 6e 20 65 72 72 6f back. If an erro
24e80 72 20 6f 63 63 75 72 73 20 64 75 72 69 6e 67 20 r occurs during
24e90 74 68 65 20 72 6f 6c 6c 62 61 63 6b 20 0a 2a 2a the rollback .**
24ea0 20 61 20 68 6f 74 20 6a 6f 75 72 6e 61 6c 20 6d a hot journal m
24eb0 61 79 20 62 65 20 6c 65 66 74 20 69 6e 20 74 68 ay be left in th
24ec0 65 20 66 69 6c 65 73 79 73 74 65 6d 20 62 75 74 e filesystem but
24ed0 20 6e 6f 20 65 72 72 6f 72 20 69 73 20 72 65 74 no error is ret
24ee0 75 72 6e 65 64 0a 2a 2a 20 74 6f 20 74 68 65 20 urned.** to the
24ef0 63 61 6c 6c 65 72 2e 0a 2a 2f 0a 69 6e 74 20 73 caller..*/.int s
24f00 71 6c 69 74 65 33 50 61 67 65 72 43 6c 6f 73 65 qlite3PagerClose
24f10 28 50 61 67 65 72 20 2a 70 50 61 67 65 72 29 7b (Pager *pPager){
24f20 0a 20 20 75 38 20 2a 70 54 6d 70 20 3d 20 28 75 . u8 *pTmp = (u
24f30 38 20 2a 29 70 50 61 67 65 72 2d 3e 70 54 6d 70 8 *)pPager->pTmp
24f40 53 70 61 63 65 3b 0a 0a 20 20 61 73 73 65 72 74 Space;.. assert
24f50 28 20 61 73 73 65 72 74 5f 70 61 67 65 72 5f 73 ( assert_pager_s
24f60 74 61 74 65 28 70 50 61 67 65 72 29 20 29 3b 0a tate(pPager) );.
24f70 20 20 64 69 73 61 62 6c 65 5f 73 69 6d 75 6c 61 disable_simula
24f80 74 65 64 5f 69 6f 5f 65 72 72 6f 72 73 28 29 3b ted_io_errors();
24f90 0a 20 20 73 71 6c 69 74 65 33 42 65 67 69 6e 42 . sqlite3BeginB
24fa0 65 6e 69 67 6e 4d 61 6c 6c 6f 63 28 29 3b 0a 20 enignMalloc();.
24fb0 20 2f 2a 20 70 50 61 67 65 72 2d 3e 65 72 72 43 /* pPager->errC
24fc0 6f 64 65 20 3d 20 30 3b 20 2a 2f 0a 20 20 70 50 ode = 0; */. pP
24fd0 61 67 65 72 2d 3e 65 78 63 6c 75 73 69 76 65 4d ager->exclusiveM
24fe0 6f 64 65 20 3d 20 30 3b 0a 23 69 66 6e 64 65 66 ode = 0;.#ifndef
24ff0 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 57 41 4c SQLITE_OMIT_WAL
25000 0a 20 20 73 71 6c 69 74 65 33 57 61 6c 43 6c 6f . sqlite3WalClo
25010 73 65 28 70 50 61 67 65 72 2d 3e 70 57 61 6c 2c se(pPager->pWal,
25020 20 70 50 61 67 65 72 2d 3e 63 6b 70 74 53 79 6e pPager->ckptSyn
25030 63 46 6c 61 67 73 2c 20 70 50 61 67 65 72 2d 3e cFlags, pPager->
25040 70 61 67 65 53 69 7a 65 2c 20 70 54 6d 70 29 3b pageSize, pTmp);
25050 0a 20 20 70 50 61 67 65 72 2d 3e 70 57 61 6c 20 . pPager->pWal
25060 3d 20 30 3b 0a 23 65 6e 64 69 66 0a 20 20 70 61 = 0;.#endif. pa
25070 67 65 72 5f 72 65 73 65 74 28 70 50 61 67 65 72 ger_reset(pPager
25080 29 3b 0a 20 20 69 66 28 20 4d 45 4d 44 42 20 29 );. if( MEMDB )
25090 7b 0a 20 20 20 20 70 61 67 65 72 5f 75 6e 6c 6f {. pager_unlo
250a0 63 6b 28 70 50 61 67 65 72 29 3b 0a 20 20 7d 65 ck(pPager);. }e
250b0 6c 73 65 7b 0a 20 20 20 20 2f 2a 20 49 66 20 69 lse{. /* If i
250c0 74 20 69 73 20 6f 70 65 6e 2c 20 73 79 6e 63 20 t is open, sync
250d0 74 68 65 20 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 the journal file
250e0 20 62 65 66 6f 72 65 20 63 61 6c 6c 69 6e 67 20 before calling
250f0 55 6e 6c 6f 63 6b 41 6e 64 52 6f 6c 6c 62 61 63 UnlockAndRollbac
25100 6b 2e 0a 20 20 20 20 2a 2a 20 49 66 20 74 68 69 k.. ** If thi
25110 73 20 69 73 20 6e 6f 74 20 64 6f 6e 65 2c 20 74 s is not done, t
25120 68 65 6e 20 61 6e 20 75 6e 73 79 6e 63 65 64 20 hen an unsynced
25130 70 6f 72 74 69 6f 6e 20 6f 66 20 74 68 65 20 6f portion of the o
25140 70 65 6e 20 6a 6f 75 72 6e 61 6c 20 0a 20 20 20 pen journal .
25150 20 2a 2a 20 66 69 6c 65 20 6d 61 79 20 62 65 20 ** file may be
25160 70 6c 61 79 65 64 20 62 61 63 6b 20 69 6e 74 6f played back into
25170 20 74 68 65 20 64 61 74 61 62 61 73 65 2e 20 49 the database. I
25180 66 20 61 20 70 6f 77 65 72 20 66 61 69 6c 75 72 f a power failur
25190 65 20 6f 63 63 75 72 73 20 0a 20 20 20 20 2a 2a e occurs . **
251a0 20 77 68 69 6c 65 20 74 68 69 73 20 69 73 20 68 while this is h
251b0 61 70 70 65 6e 69 6e 67 2c 20 74 68 65 20 64 61 appening, the da
251c0 74 61 62 61 73 65 20 63 6f 75 6c 64 20 62 65 63 tabase could bec
251d0 6f 6d 65 20 63 6f 72 72 75 70 74 2e 0a 20 20 20 ome corrupt..
251e0 20 2a 2a 0a 20 20 20 20 2a 2a 20 49 66 20 61 6e **. ** If an
251f0 20 65 72 72 6f 72 20 6f 63 63 75 72 73 20 77 68 error occurs wh
25200 69 6c 65 20 74 72 79 69 6e 67 20 74 6f 20 73 79 ile trying to sy
25210 6e 63 20 74 68 65 20 6a 6f 75 72 6e 61 6c 2c 20 nc the journal,
25220 73 68 69 66 74 20 74 68 65 20 70 61 67 65 72 0a shift the pager.
25230 20 20 20 20 2a 2a 20 69 6e 74 6f 20 74 68 65 20 ** into the
25240 45 52 52 4f 52 20 73 74 61 74 65 2e 20 54 68 69 ERROR state. Thi
25250 73 20 63 61 75 73 65 73 20 55 6e 6c 6f 63 6b 41 s causes UnlockA
25260 6e 64 52 6f 6c 6c 62 61 63 6b 20 74 6f 20 75 6e ndRollback to un
25270 6c 6f 63 6b 20 74 68 65 0a 20 20 20 20 2a 2a 20 lock the. **
25280 64 61 74 61 62 61 73 65 20 61 6e 64 20 63 6c 6f database and clo
25290 73 65 20 74 68 65 20 6a 6f 75 72 6e 61 6c 20 66 se the journal f
252a0 69 6c 65 20 77 69 74 68 6f 75 74 20 61 74 74 65 ile without atte
252b0 6d 70 74 69 6e 67 20 74 6f 20 72 6f 6c 6c 20 69 mpting to roll i
252c0 74 0a 20 20 20 20 2a 2a 20 62 61 63 6b 20 6f 72 t. ** back or
252d0 20 66 69 6e 61 6c 69 7a 65 20 69 74 2e 20 54 68 finalize it. Th
252e0 65 20 6e 65 78 74 20 64 61 74 61 62 61 73 65 20 e next database
252f0 75 73 65 72 20 77 69 6c 6c 20 68 61 76 65 20 74 user will have t
25300 6f 20 64 6f 20 68 6f 74 2d 6a 6f 75 72 6e 61 6c o do hot-journal
25310 0a 20 20 20 20 2a 2a 20 72 6f 6c 6c 62 61 63 6b . ** rollback
25320 20 62 65 66 6f 72 65 20 61 63 63 65 73 73 69 6e before accessin
25330 67 20 74 68 65 20 64 61 74 61 62 61 73 65 20 66 g the database f
25340 69 6c 65 2e 0a 20 20 20 20 2a 2f 0a 20 20 20 20 ile.. */.
25350 69 66 28 20 69 73 4f 70 65 6e 28 70 50 61 67 65 if( isOpen(pPage
25360 72 2d 3e 6a 66 64 29 20 29 7b 0a 20 20 20 20 20 r->jfd) ){.
25370 20 70 61 67 65 72 5f 65 72 72 6f 72 28 70 50 61 pager_error(pPa
25380 67 65 72 2c 20 70 61 67 65 72 53 79 6e 63 48 6f ger, pagerSyncHo
25390 74 4a 6f 75 72 6e 61 6c 28 70 50 61 67 65 72 29 tJournal(pPager)
253a0 29 3b 0a 20 20 20 20 7d 0a 20 20 20 20 70 61 67 );. }. pag
253b0 65 72 55 6e 6c 6f 63 6b 41 6e 64 52 6f 6c 6c 62 erUnlockAndRollb
253c0 61 63 6b 28 70 50 61 67 65 72 29 3b 0a 20 20 7d ack(pPager);. }
253d0 0a 20 20 73 71 6c 69 74 65 33 45 6e 64 42 65 6e . sqlite3EndBen
253e0 69 67 6e 4d 61 6c 6c 6f 63 28 29 3b 0a 20 20 65 ignMalloc();. e
253f0 6e 61 62 6c 65 5f 73 69 6d 75 6c 61 74 65 64 5f nable_simulated_
25400 69 6f 5f 65 72 72 6f 72 73 28 29 3b 0a 20 20 50 io_errors();. P
25410 41 47 45 52 54 52 41 43 45 28 28 22 43 4c 4f 53 AGERTRACE(("CLOS
25420 45 20 25 64 5c 6e 22 2c 20 50 41 47 45 52 49 44 E %d\n", PAGERID
25430 28 70 50 61 67 65 72 29 29 29 3b 0a 20 20 49 4f (pPager)));. IO
25440 54 52 41 43 45 28 28 22 43 4c 4f 53 45 20 25 70 TRACE(("CLOSE %p
25450 5c 6e 22 2c 20 70 50 61 67 65 72 29 29 0a 20 20 \n", pPager)).
25460 73 71 6c 69 74 65 33 4f 73 43 6c 6f 73 65 28 70 sqlite3OsClose(p
25470 50 61 67 65 72 2d 3e 6a 66 64 29 3b 0a 20 20 73 Pager->jfd);. s
25480 71 6c 69 74 65 33 4f 73 43 6c 6f 73 65 28 70 50 qlite3OsClose(pP
25490 61 67 65 72 2d 3e 66 64 29 3b 0a 20 20 73 71 6c ager->fd);. sql
254a0 69 74 65 33 50 61 67 65 46 72 65 65 28 70 54 6d ite3PageFree(pTm
254b0 70 29 3b 0a 20 20 73 71 6c 69 74 65 33 50 63 61 p);. sqlite3Pca
254c0 63 68 65 43 6c 6f 73 65 28 70 50 61 67 65 72 2d cheClose(pPager-
254d0 3e 70 50 43 61 63 68 65 29 3b 0a 0a 23 69 66 64 >pPCache);..#ifd
254e0 65 66 20 53 51 4c 49 54 45 5f 48 41 53 5f 43 4f ef SQLITE_HAS_CO
254f0 44 45 43 0a 20 20 69 66 28 20 70 50 61 67 65 72 DEC. if( pPager
25500 2d 3e 78 43 6f 64 65 63 46 72 65 65 20 29 20 70 ->xCodecFree ) p
25510 50 61 67 65 72 2d 3e 78 43 6f 64 65 63 46 72 65 Pager->xCodecFre
25520 65 28 70 50 61 67 65 72 2d 3e 70 43 6f 64 65 63 e(pPager->pCodec
25530 29 3b 0a 23 65 6e 64 69 66 0a 0a 20 20 61 73 73 );.#endif.. ass
25540 65 72 74 28 20 21 70 50 61 67 65 72 2d 3e 61 53 ert( !pPager->aS
25550 61 76 65 70 6f 69 6e 74 20 26 26 20 21 70 50 61 avepoint && !pPa
25560 67 65 72 2d 3e 70 49 6e 4a 6f 75 72 6e 61 6c 20 ger->pInJournal
25570 29 3b 0a 20 20 61 73 73 65 72 74 28 20 21 69 73 );. assert( !is
25580 4f 70 65 6e 28 70 50 61 67 65 72 2d 3e 6a 66 64 Open(pPager->jfd
25590 29 20 26 26 20 21 69 73 4f 70 65 6e 28 70 50 61 ) && !isOpen(pPa
255a0 67 65 72 2d 3e 73 6a 66 64 29 20 29 3b 0a 0a 20 ger->sjfd) );..
255b0 20 73 71 6c 69 74 65 33 5f 66 72 65 65 28 70 50 sqlite3_free(pP
255c0 61 67 65 72 29 3b 0a 20 20 72 65 74 75 72 6e 20 ager);. return
255d0 53 51 4c 49 54 45 5f 4f 4b 3b 0a 7d 0a 0a 23 69 SQLITE_OK;.}..#i
255e0 66 20 21 64 65 66 69 6e 65 64 28 4e 44 45 42 55 f !defined(NDEBU
255f0 47 29 20 7c 7c 20 64 65 66 69 6e 65 64 28 53 51 G) || defined(SQ
25600 4c 49 54 45 5f 54 45 53 54 29 0a 2f 2a 0a 2a 2a LITE_TEST)./*.**
25610 20 52 65 74 75 72 6e 20 74 68 65 20 70 61 67 65 Return the page
25620 20 6e 75 6d 62 65 72 20 66 6f 72 20 70 61 67 65 number for page
25630 20 70 50 67 2e 0a 2a 2f 0a 50 67 6e 6f 20 73 71 pPg..*/.Pgno sq
25640 6c 69 74 65 33 50 61 67 65 72 50 61 67 65 6e 75 lite3PagerPagenu
25650 6d 62 65 72 28 44 62 50 61 67 65 20 2a 70 50 67 mber(DbPage *pPg
25660 29 7b 0a 20 20 72 65 74 75 72 6e 20 70 50 67 2d ){. return pPg-
25670 3e 70 67 6e 6f 3b 0a 7d 0a 23 65 6e 64 69 66 0a >pgno;.}.#endif.
25680 0a 2f 2a 0a 2a 2a 20 49 6e 63 72 65 6d 65 6e 74 ./*.** Increment
25690 20 74 68 65 20 72 65 66 65 72 65 6e 63 65 20 63 the reference c
256a0 6f 75 6e 74 20 66 6f 72 20 70 61 67 65 20 70 50 ount for page pP
256b0 67 2e 0a 2a 2f 0a 76 6f 69 64 20 73 71 6c 69 74 g..*/.void sqlit
256c0 65 33 50 61 67 65 72 52 65 66 28 44 62 50 61 67 e3PagerRef(DbPag
256d0 65 20 2a 70 50 67 29 7b 0a 20 20 73 71 6c 69 74 e *pPg){. sqlit
256e0 65 33 50 63 61 63 68 65 52 65 66 28 70 50 67 29 e3PcacheRef(pPg)
256f0 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 53 79 6e 63 20 ;.}../*.** Sync
25700 74 68 65 20 6a 6f 75 72 6e 61 6c 2e 20 49 6e 20 the journal. In
25710 6f 74 68 65 72 20 77 6f 72 64 73 2c 20 6d 61 6b other words, mak
25720 65 20 73 75 72 65 20 61 6c 6c 20 74 68 65 20 70 e sure all the p
25730 61 67 65 73 20 74 68 61 74 20 68 61 76 65 0a 2a ages that have.*
25740 2a 20 62 65 65 6e 20 77 72 69 74 74 65 6e 20 74 * been written t
25750 6f 20 74 68 65 20 6a 6f 75 72 6e 61 6c 20 68 61 o the journal ha
25760 76 65 20 61 63 74 75 61 6c 6c 79 20 72 65 61 63 ve actually reac
25770 68 65 64 20 74 68 65 20 73 75 72 66 61 63 65 20 hed the surface
25780 6f 66 20 74 68 65 0a 2a 2a 20 64 69 73 6b 20 61 of the.** disk a
25790 6e 64 20 63 61 6e 20 62 65 20 72 65 73 74 6f 72 nd can be restor
257a0 65 64 20 69 6e 20 74 68 65 20 65 76 65 6e 74 20 ed in the event
257b0 6f 66 20 61 20 68 6f 74 2d 6a 6f 75 72 6e 61 6c of a hot-journal
257c0 20 72 6f 6c 6c 62 61 63 6b 2e 0a 2a 2a 0a 2a 2a rollback..**.**
257d0 20 49 66 20 74 68 65 20 50 61 67 65 72 2e 6e 6f If the Pager.no
257e0 53 79 6e 63 20 66 6c 61 67 20 69 73 20 73 65 74 Sync flag is set
257f0 2c 20 74 68 65 6e 20 74 68 69 73 20 66 75 6e 63 , then this func
25800 74 69 6f 6e 20 69 73 20 61 20 6e 6f 2d 6f 70 2e tion is a no-op.
25810 0a 2a 2a 20 4f 74 68 65 72 77 69 73 65 2c 20 74 .** Otherwise, t
25820 68 65 20 61 63 74 69 6f 6e 73 20 72 65 71 75 69 he actions requi
25830 72 65 64 20 64 65 70 65 6e 64 20 6f 6e 20 74 68 red depend on th
25840 65 20 6a 6f 75 72 6e 61 6c 2d 6d 6f 64 65 20 61 e journal-mode a
25850 6e 64 20 74 68 65 20 0a 2a 2a 20 64 65 76 69 63 nd the .** devic
25860 65 20 63 68 61 72 61 63 74 65 72 69 73 74 69 63 e characteristic
25870 73 20 6f 66 20 74 68 65 20 74 68 65 20 66 69 6c s of the the fil
25880 65 2d 73 79 73 74 65 6d 2c 20 61 73 20 66 6f 6c e-system, as fol
25890 6c 6f 77 73 3a 0a 2a 2a 0a 2a 2a 20 20 20 2a 20 lows:.**.** *
258a0 49 66 20 74 68 65 20 6a 6f 75 72 6e 61 6c 20 66 If the journal f
258b0 69 6c 65 20 69 73 20 61 6e 20 69 6e 2d 6d 65 6d ile is an in-mem
258c0 6f 72 79 20 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 ory journal file
258d0 2c 20 6e 6f 20 61 63 74 69 6f 6e 20 6e 65 65 64 , no action need
258e0 0a 2a 2a 20 20 20 20 20 62 65 20 74 61 6b 65 6e .** be taken
258f0 2e 0a 2a 2a 0a 2a 2a 20 20 20 2a 20 4f 74 68 65 ..**.** * Othe
25900 72 77 69 73 65 2c 20 69 66 20 74 68 65 20 64 65 rwise, if the de
25910 76 69 63 65 20 64 6f 65 73 20 6e 6f 74 20 73 75 vice does not su
25920 70 70 6f 72 74 20 74 68 65 20 53 41 46 45 5f 41 pport the SAFE_A
25930 50 50 45 4e 44 20 70 72 6f 70 65 72 74 79 2c 0a PPEND property,.
25940 2a 2a 20 20 20 20 20 74 68 65 6e 20 74 68 65 20 ** then the
25950 6e 52 65 63 20 66 69 65 6c 64 20 6f 66 20 74 68 nRec field of th
25960 65 20 6d 6f 73 74 20 72 65 63 65 6e 74 6c 79 20 e most recently
25970 77 72 69 74 74 65 6e 20 6a 6f 75 72 6e 61 6c 20 written journal
25980 68 65 61 64 65 72 0a 2a 2a 20 20 20 20 20 69 73 header.** is
25990 20 75 70 64 61 74 65 64 20 74 6f 20 63 6f 6e 74 updated to cont
259a0 61 69 6e 20 74 68 65 20 6e 75 6d 62 65 72 20 6f ain the number o
259b0 66 20 6a 6f 75 72 6e 61 6c 20 72 65 63 6f 72 64 f journal record
259c0 73 20 74 68 61 74 20 68 61 76 65 0a 2a 2a 20 20 s that have.**
259d0 20 20 20 62 65 65 6e 20 77 72 69 74 74 65 6e 20 been written
259e0 66 6f 6c 6c 6f 77 69 6e 67 20 69 74 2e 20 49 66 following it. If
259f0 20 74 68 65 20 70 61 67 65 72 20 69 73 20 6f 70 the pager is op
25a00 65 72 61 74 69 6e 67 20 69 6e 20 66 75 6c 6c 2d erating in full-
25a10 73 79 6e 63 0a 2a 2a 20 20 20 20 20 6d 6f 64 65 sync.** mode
25a20 2c 20 74 68 65 6e 20 74 68 65 20 6a 6f 75 72 6e , then the journ
25a30 61 6c 20 66 69 6c 65 20 69 73 20 73 79 6e 63 65 al file is synce
25a40 64 20 62 65 66 6f 72 65 20 74 68 69 73 20 66 69 d before this fi
25a50 65 6c 64 20 69 73 20 75 70 64 61 74 65 64 2e 0a eld is updated..
25a60 2a 2a 0a 2a 2a 20 20 20 2a 20 49 66 20 74 68 65 **.** * If the
25a70 20 64 65 76 69 63 65 20 64 6f 65 73 20 6e 6f 74 device does not
25a80 20 73 75 70 70 6f 72 74 20 74 68 65 20 53 45 51 support the SEQ
25a90 55 45 4e 54 49 41 4c 20 70 72 6f 70 65 72 74 79 UENTIAL property
25aa0 2c 20 74 68 65 6e 20 0a 2a 2a 20 20 20 20 20 6a , then .** j
25ab0 6f 75 72 6e 61 6c 20 66 69 6c 65 20 69 73 20 73 ournal file is s
25ac0 79 6e 63 65 64 2e 0a 2a 2a 0a 2a 2a 20 4f 72 2c ynced..**.** Or,
25ad0 20 69 6e 20 70 73 65 75 64 6f 2d 63 6f 64 65 3a in pseudo-code:
25ae0 0a 2a 2a 0a 2a 2a 20 20 20 69 66 28 20 4e 4f 54 .**.** if( NOT
25af0 20 3c 69 6e 2d 6d 65 6d 6f 72 79 20 6a 6f 75 72 <in-memory jour
25b00 6e 61 6c 3e 20 29 7b 0a 2a 2a 20 20 20 20 20 69 nal> ){.** i
25b10 66 28 20 4e 4f 54 20 53 41 46 45 5f 41 50 50 45 f( NOT SAFE_APPE
25b20 4e 44 20 29 7b 0a 2a 2a 20 20 20 20 20 20 20 69 ND ){.** i
25b30 66 28 20 3c 66 75 6c 6c 2d 73 79 6e 63 20 6d 6f f( <full-sync mo
25b40 64 65 3e 20 29 20 78 53 79 6e 63 28 3c 6a 6f 75 de> ) xSync(<jou
25b50 72 6e 61 6c 20 66 69 6c 65 3e 29 3b 0a 2a 2a 20 rnal file>);.**
25b60 20 20 20 20 20 20 3c 75 70 64 61 74 65 20 6e 52 <update nR
25b70 65 63 20 66 69 65 6c 64 3e 0a 2a 2a 20 20 20 20 ec field>.**
25b80 20 7d 20 0a 2a 2a 20 20 20 20 20 69 66 28 20 4e } .** if( N
25b90 4f 54 20 53 45 51 55 45 4e 54 49 41 4c 20 29 20 OT SEQUENTIAL )
25ba0 78 53 79 6e 63 28 3c 6a 6f 75 72 6e 61 6c 20 66 xSync(<journal f
25bb0 69 6c 65 3e 29 3b 0a 2a 2a 20 20 20 7d 0a 2a 2a ile>);.** }.**
25bc0 0a 2a 2a 20 49 66 20 73 75 63 63 65 73 73 66 75 .** If successfu
25bd0 6c 2c 20 74 68 69 73 20 72 6f 75 74 69 6e 65 20 l, this routine
25be0 63 6c 65 61 72 73 20 74 68 65 20 50 47 48 44 52 clears the PGHDR
25bf0 5f 4e 45 45 44 5f 53 59 4e 43 20 66 6c 61 67 20 _NEED_SYNC flag
25c00 6f 66 20 65 76 65 72 79 20 0a 2a 2a 20 70 61 67 of every .** pag
25c10 65 20 63 75 72 72 65 6e 74 6c 79 20 68 65 6c 64 e currently held
25c20 20 69 6e 20 6d 65 6d 6f 72 79 20 62 65 66 6f 72 in memory befor
25c30 65 20 72 65 74 75 72 6e 69 6e 67 20 53 51 4c 49 e returning SQLI
25c40 54 45 5f 4f 4b 2e 20 49 66 20 61 6e 20 49 4f 0a TE_OK. If an IO.
25c50 2a 2a 20 65 72 72 6f 72 20 69 73 20 65 6e 63 6f ** error is enco
25c60 75 6e 74 65 72 65 64 2c 20 74 68 65 6e 20 74 68 untered, then th
25c70 65 20 49 4f 20 65 72 72 6f 72 20 63 6f 64 65 20 e IO error code
25c80 69 73 20 72 65 74 75 72 6e 65 64 20 74 6f 20 74 is returned to t
25c90 68 65 20 63 61 6c 6c 65 72 2e 0a 2a 2f 0a 73 74 he caller..*/.st
25ca0 61 74 69 63 20 69 6e 74 20 73 79 6e 63 4a 6f 75 atic int syncJou
25cb0 72 6e 61 6c 28 50 61 67 65 72 20 2a 70 50 61 67 rnal(Pager *pPag
25cc0 65 72 2c 20 69 6e 74 20 6e 65 77 48 64 72 29 7b er, int newHdr){
25cd0 0a 20 20 69 6e 74 20 72 63 3b 20 20 20 20 20 20 . int rc;
25ce0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
25cf0 20 20 20 2f 2a 20 52 65 74 75 72 6e 20 63 6f 64 /* Return cod
25d00 65 20 2a 2f 0a 0a 20 20 61 73 73 65 72 74 28 20 e */.. assert(
25d10 70 50 61 67 65 72 2d 3e 65 53 74 61 74 65 3d 3d pPager->eState==
25d20 50 41 47 45 52 5f 57 52 49 54 45 52 5f 43 41 43 PAGER_WRITER_CAC
25d30 48 45 4d 4f 44 0a 20 20 20 20 20 20 20 7c 7c 20 HEMOD. ||
25d40 70 50 61 67 65 72 2d 3e 65 53 74 61 74 65 3d 3d pPager->eState==
25d50 50 41 47 45 52 5f 57 52 49 54 45 52 5f 44 42 4d PAGER_WRITER_DBM
25d60 4f 44 0a 20 20 29 3b 0a 20 20 61 73 73 65 72 74 OD. );. assert
25d70 28 20 61 73 73 65 72 74 5f 70 61 67 65 72 5f 73 ( assert_pager_s
25d80 74 61 74 65 28 70 50 61 67 65 72 29 20 29 3b 0a tate(pPager) );.
25d90 20 20 61 73 73 65 72 74 28 20 21 70 61 67 65 72 assert( !pager
25da0 55 73 65 57 61 6c 28 70 50 61 67 65 72 29 20 29 UseWal(pPager) )
25db0 3b 0a 0a 20 20 72 63 20 3d 20 73 71 6c 69 74 65 ;.. rc = sqlite
25dc0 33 50 61 67 65 72 45 78 63 6c 75 73 69 76 65 4c 3PagerExclusiveL
25dd0 6f 63 6b 28 70 50 61 67 65 72 29 3b 0a 20 20 69 ock(pPager);. i
25de0 66 28 20 72 63 21 3d 53 51 4c 49 54 45 5f 4f 4b f( rc!=SQLITE_OK
25df0 20 29 20 72 65 74 75 72 6e 20 72 63 3b 0a 0a 20 ) return rc;..
25e00 20 69 66 28 20 21 70 50 61 67 65 72 2d 3e 6e 6f if( !pPager->no
25e10 53 79 6e 63 20 29 7b 0a 20 20 20 20 61 73 73 65 Sync ){. asse
25e20 72 74 28 20 21 70 50 61 67 65 72 2d 3e 74 65 6d rt( !pPager->tem
25e30 70 46 69 6c 65 20 29 3b 0a 20 20 20 20 69 66 28 pFile );. if(
25e40 20 69 73 4f 70 65 6e 28 70 50 61 67 65 72 2d 3e isOpen(pPager->
25e50 6a 66 64 29 20 26 26 20 70 50 61 67 65 72 2d 3e jfd) && pPager->
25e60 6a 6f 75 72 6e 61 6c 4d 6f 64 65 21 3d 50 41 47 journalMode!=PAG
25e70 45 52 5f 4a 4f 55 52 4e 41 4c 4d 4f 44 45 5f 4d ER_JOURNALMODE_M
25e80 45 4d 4f 52 59 20 29 7b 0a 20 20 20 20 20 20 63 EMORY ){. c
25e90 6f 6e 73 74 20 69 6e 74 20 69 44 63 20 3d 20 73 onst int iDc = s
25ea0 71 6c 69 74 65 33 4f 73 44 65 76 69 63 65 43 68 qlite3OsDeviceCh
25eb0 61 72 61 63 74 65 72 69 73 74 69 63 73 28 70 50 aracteristics(pP
25ec0 61 67 65 72 2d 3e 66 64 29 3b 0a 20 20 20 20 20 ager->fd);.
25ed0 20 61 73 73 65 72 74 28 20 69 73 4f 70 65 6e 28 assert( isOpen(
25ee0 70 50 61 67 65 72 2d 3e 6a 66 64 29 20 29 3b 0a pPager->jfd) );.
25ef0 0a 20 20 20 20 20 20 69 66 28 20 30 3d 3d 28 69 . if( 0==(i
25f00 44 63 26 53 51 4c 49 54 45 5f 49 4f 43 41 50 5f Dc&SQLITE_IOCAP_
25f10 53 41 46 45 5f 41 50 50 45 4e 44 29 20 29 7b 0a SAFE_APPEND) ){.
25f20 20 20 20 20 20 20 20 20 2f 2a 20 54 68 69 73 20 /* This
25f30 62 6c 6f 63 6b 20 64 65 61 6c 73 20 77 69 74 68 block deals with
25f40 20 61 6e 20 6f 62 73 63 75 72 65 20 70 72 6f 62 an obscure prob
25f50 6c 65 6d 2e 20 49 66 20 74 68 65 20 6c 61 73 74 lem. If the last
25f60 20 63 6f 6e 6e 65 63 74 69 6f 6e 0a 20 20 20 20 connection.
25f70 20 20 20 20 2a 2a 20 74 68 61 74 20 77 72 6f 74 ** that wrot
25f80 65 20 74 6f 20 74 68 69 73 20 64 61 74 61 62 61 e to this databa
25f90 73 65 20 77 61 73 20 6f 70 65 72 61 74 69 6e 67 se was operating
25fa0 20 69 6e 20 70 65 72 73 69 73 74 65 6e 74 2d 6a in persistent-j
25fb0 6f 75 72 6e 61 6c 0a 20 20 20 20 20 20 20 20 2a ournal. *
25fc0 2a 20 6d 6f 64 65 2c 20 74 68 65 6e 20 74 68 65 * mode, then the
25fd0 20 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 20 6d 61 journal file ma
25fe0 79 20 61 74 20 74 68 69 73 20 70 6f 69 6e 74 20 y at this point
25ff0 61 63 74 75 61 6c 6c 79 20 62 65 20 6c 61 72 67 actually be larg
26000 65 72 0a 20 20 20 20 20 20 20 20 2a 2a 20 74 68 er. ** th
26010 61 6e 20 50 61 67 65 72 2e 6a 6f 75 72 6e 61 6c an Pager.journal
26020 4f 66 66 20 62 79 74 65 73 2e 20 49 66 20 74 68 Off bytes. If th
26030 65 20 6e 65 78 74 20 74 68 69 6e 67 20 69 6e 20 e next thing in
26040 74 68 65 20 6a 6f 75 72 6e 61 6c 0a 20 20 20 20 the journal.
26050 20 20 20 20 2a 2a 20 66 69 6c 65 20 68 61 70 70 ** file happ
26060 65 6e 73 20 74 6f 20 62 65 20 61 20 6a 6f 75 72 ens to be a jour
26070 6e 61 6c 2d 68 65 61 64 65 72 20 28 77 72 69 74 nal-header (writ
26080 74 65 6e 20 61 73 20 70 61 72 74 20 6f 66 20 74 ten as part of t
26090 68 65 0a 20 20 20 20 20 20 20 20 2a 2a 20 70 72 he. ** pr
260a0 65 76 69 6f 75 73 20 63 6f 6e 6e 65 63 74 69 6f evious connectio
260b0 6e 27 73 20 74 72 61 6e 73 61 63 74 69 6f 6e 29 n's transaction)
260c0 2c 20 61 6e 64 20 61 20 63 72 61 73 68 20 6f 72 , and a crash or
260d0 20 70 6f 77 65 72 2d 66 61 69 6c 75 72 65 20 0a power-failure .
260e0 20 20 20 20 20 20 20 20 2a 2a 20 6f 63 63 75 72 ** occur
260f0 73 20 61 66 74 65 72 20 6e 52 65 63 20 69 73 20 s after nRec is
26100 75 70 64 61 74 65 64 20 62 75 74 20 62 65 66 6f updated but befo
26110 72 65 20 74 68 69 73 20 63 6f 6e 6e 65 63 74 69 re this connecti
26120 6f 6e 20 77 72 69 74 65 73 20 0a 20 20 20 20 20 on writes .
26130 20 20 20 2a 2a 20 61 6e 79 74 68 69 6e 67 20 65 ** anything e
26140 6c 73 65 20 74 6f 20 74 68 65 20 6a 6f 75 72 6e lse to the journ
26150 61 6c 20 66 69 6c 65 20 28 6f 72 20 63 6f 6d 6d al file (or comm
26160 69 74 73 2f 72 6f 6c 6c 73 20 62 61 63 6b 20 69 its/rolls back i
26170 74 73 20 0a 20 20 20 20 20 20 20 20 2a 2a 20 74 ts . ** t
26180 72 61 6e 73 61 63 74 69 6f 6e 29 2c 20 74 68 65 ransaction), the
26190 6e 20 53 51 4c 69 74 65 20 6d 61 79 20 62 65 63 n SQLite may bec
261a0 6f 6d 65 20 63 6f 6e 66 75 73 65 64 20 77 68 65 ome confused whe
261b0 6e 20 64 6f 69 6e 67 20 74 68 65 20 0a 20 20 20 n doing the .
261c0 20 20 20 20 20 2a 2a 20 68 6f 74 2d 6a 6f 75 72 ** hot-jour
261d0 6e 61 6c 20 72 6f 6c 6c 62 61 63 6b 20 66 6f 6c nal rollback fol
261e0 6c 6f 77 69 6e 67 20 72 65 63 6f 76 65 72 79 2e lowing recovery.
261f0 20 49 74 20 6d 61 79 20 72 6f 6c 6c 20 62 61 63 It may roll bac
26200 6b 20 61 6c 6c 0a 20 20 20 20 20 20 20 20 2a 2a k all. **
26210 20 6f 66 20 74 68 69 73 20 63 6f 6e 6e 65 63 74 of this connect
26220 69 6f 6e 73 20 64 61 74 61 2c 20 74 68 65 6e 20 ions data, then
26230 70 72 6f 63 65 65 64 20 74 6f 20 72 6f 6c 6c 69 proceed to rolli
26240 6e 67 20 62 61 63 6b 20 74 68 65 20 6f 6c 64 2c ng back the old,
26250 0a 20 20 20 20 20 20 20 20 2a 2a 20 6f 75 74 2d . ** out-
26260 6f 66 2d 64 61 74 65 20 64 61 74 61 20 74 68 61 of-date data tha
26270 74 20 66 6f 6c 6c 6f 77 73 20 69 74 2e 20 44 61 t follows it. Da
26280 74 61 62 61 73 65 20 63 6f 72 72 75 70 74 69 6f tabase corruptio
26290 6e 2e 0a 20 20 20 20 20 20 20 20 2a 2a 0a 20 20 n.. **.
262a0 20 20 20 20 20 20 2a 2a 20 54 6f 20 77 6f 72 6b ** To work
262b0 20 61 72 6f 75 6e 64 20 74 68 69 73 2c 20 69 66 around this, if
262c0 20 74 68 65 20 6a 6f 75 72 6e 61 6c 20 66 69 6c the journal fil
262d0 65 20 64 6f 65 73 20 61 70 70 65 61 72 20 74 6f e does appear to
262e0 20 63 6f 6e 74 61 69 6e 0a 20 20 20 20 20 20 20 contain.
262f0 20 2a 2a 20 61 20 76 61 6c 69 64 20 68 65 61 64 ** a valid head
26300 65 72 20 66 6f 6c 6c 6f 77 69 6e 67 20 50 61 67 er following Pag
26310 65 72 2e 6a 6f 75 72 6e 61 6c 4f 66 66 2c 20 74 er.journalOff, t
26320 68 65 6e 20 77 72 69 74 65 20 61 20 30 78 30 30 hen write a 0x00
26330 0a 20 20 20 20 20 20 20 20 2a 2a 20 62 79 74 65 . ** byte
26340 20 74 6f 20 74 68 65 20 73 74 61 72 74 20 6f 66 to the start of
26350 20 69 74 20 74 6f 20 70 72 65 76 65 6e 74 20 69 it to prevent i
26360 74 20 66 72 6f 6d 20 62 65 69 6e 67 20 72 65 63 t from being rec
26370 6f 67 6e 69 7a 65 64 2e 0a 20 20 20 20 20 20 20 ognized..
26380 20 2a 2a 0a 20 20 20 20 20 20 20 20 2a 2a 20 56 **. ** V
26390 61 72 69 61 62 6c 65 20 69 4e 65 78 74 48 64 72 ariable iNextHdr
263a0 4f 66 66 73 65 74 20 69 73 20 73 65 74 20 74 6f Offset is set to
263b0 20 74 68 65 20 6f 66 66 73 65 74 20 61 74 20 77 the offset at w
263c0 68 69 63 68 20 74 68 69 73 0a 20 20 20 20 20 20 hich this.
263d0 20 20 2a 2a 20 70 72 6f 62 6c 65 6d 61 74 69 63 ** problematic
263e0 20 68 65 61 64 65 72 20 77 69 6c 6c 20 6f 63 63 header will occ
263f0 75 72 2c 20 69 66 20 69 74 20 65 78 69 73 74 73 ur, if it exists
26400 2e 20 61 4d 61 67 69 63 20 69 73 20 75 73 65 64 . aMagic is used
26410 20 0a 20 20 20 20 20 20 20 20 2a 2a 20 61 73 20 . ** as
26420 61 20 74 65 6d 70 6f 72 61 72 79 20 62 75 66 66 a temporary buff
26430 65 72 20 74 6f 20 69 6e 73 70 65 63 74 20 74 68 er to inspect th
26440 65 20 66 69 72 73 74 20 63 6f 75 70 6c 65 20 6f e first couple o
26450 66 20 62 79 74 65 73 20 6f 66 0a 20 20 20 20 20 f bytes of.
26460 20 20 20 2a 2a 20 74 68 65 20 70 6f 74 65 6e 74 ** the potent
26470 69 61 6c 20 6a 6f 75 72 6e 61 6c 20 68 65 61 64 ial journal head
26480 65 72 2e 0a 20 20 20 20 20 20 20 20 2a 2f 0a 20 er.. */.
26490 20 20 20 20 20 20 20 69 36 34 20 69 4e 65 78 74 i64 iNext
264a0 48 64 72 4f 66 66 73 65 74 3b 0a 20 20 20 20 20 HdrOffset;.
264b0 20 20 20 75 38 20 61 4d 61 67 69 63 5b 38 5d 3b u8 aMagic[8];
264c0 0a 20 20 20 20 20 20 20 20 75 38 20 7a 48 65 61 . u8 zHea
264d0 64 65 72 5b 73 69 7a 65 6f 66 28 61 4a 6f 75 72 der[sizeof(aJour
264e0 6e 61 6c 4d 61 67 69 63 29 2b 34 5d 3b 0a 0a 20 nalMagic)+4];..
264f0 20 20 20 20 20 20 20 6d 65 6d 63 70 79 28 7a 48 memcpy(zH
26500 65 61 64 65 72 2c 20 61 4a 6f 75 72 6e 61 6c 4d eader, aJournalM
26510 61 67 69 63 2c 20 73 69 7a 65 6f 66 28 61 4a 6f agic, sizeof(aJo
26520 75 72 6e 61 6c 4d 61 67 69 63 29 29 3b 0a 20 20 urnalMagic));.
26530 20 20 20 20 20 20 70 75 74 33 32 62 69 74 73 28 put32bits(
26540 26 7a 48 65 61 64 65 72 5b 73 69 7a 65 6f 66 28 &zHeader[sizeof(
26550 61 4a 6f 75 72 6e 61 6c 4d 61 67 69 63 29 5d 2c aJournalMagic)],
26560 20 70 50 61 67 65 72 2d 3e 6e 52 65 63 29 3b 0a pPager->nRec);.
26570 0a 20 20 20 20 20 20 20 20 69 4e 65 78 74 48 64 . iNextHd
26580 72 4f 66 66 73 65 74 20 3d 20 6a 6f 75 72 6e 61 rOffset = journa
26590 6c 48 64 72 4f 66 66 73 65 74 28 70 50 61 67 65 lHdrOffset(pPage
265a0 72 29 3b 0a 20 20 20 20 20 20 20 20 72 63 20 3d r);. rc =
265b0 20 73 71 6c 69 74 65 33 4f 73 52 65 61 64 28 70 sqlite3OsRead(p
265c0 50 61 67 65 72 2d 3e 6a 66 64 2c 20 61 4d 61 67 Pager->jfd, aMag
265d0 69 63 2c 20 38 2c 20 69 4e 65 78 74 48 64 72 4f ic, 8, iNextHdrO
265e0 66 66 73 65 74 29 3b 0a 20 20 20 20 20 20 20 20 ffset);.
265f0 69 66 28 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4f if( rc==SQLITE_O
26600 4b 20 26 26 20 30 3d 3d 6d 65 6d 63 6d 70 28 61 K && 0==memcmp(a
26610 4d 61 67 69 63 2c 20 61 4a 6f 75 72 6e 61 6c 4d Magic, aJournalM
26620 61 67 69 63 2c 20 38 29 20 29 7b 0a 20 20 20 20 agic, 8) ){.
26630 20 20 20 20 20 20 73 74 61 74 69 63 20 63 6f 6e static con
26640 73 74 20 75 38 20 7a 65 72 6f 62 79 74 65 20 3d st u8 zerobyte =
26650 20 30 3b 0a 20 20 20 20 20 20 20 20 20 20 72 63 0;. rc
26660 20 3d 20 73 71 6c 69 74 65 33 4f 73 57 72 69 74 = sqlite3OsWrit
26670 65 28 70 50 61 67 65 72 2d 3e 6a 66 64 2c 20 26 e(pPager->jfd, &
26680 7a 65 72 6f 62 79 74 65 2c 20 31 2c 20 69 4e 65 zerobyte, 1, iNe
26690 78 74 48 64 72 4f 66 66 73 65 74 29 3b 0a 20 20 xtHdrOffset);.
266a0 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 20 20 }.
266b0 69 66 28 20 72 63 21 3d 53 51 4c 49 54 45 5f 4f if( rc!=SQLITE_O
266c0 4b 20 26 26 20 72 63 21 3d 53 51 4c 49 54 45 5f K && rc!=SQLITE_
266d0 49 4f 45 52 52 5f 53 48 4f 52 54 5f 52 45 41 44 IOERR_SHORT_READ
266e0 20 29 7b 0a 20 20 20 20 20 20 20 20 20 20 72 65 ){. re
266f0 74 75 72 6e 20 72 63 3b 0a 20 20 20 20 20 20 20 turn rc;.
26700 20 7d 0a 0a 20 20 20 20 20 20 20 20 2f 2a 20 57 }.. /* W
26710 72 69 74 65 20 74 68 65 20 6e 52 65 63 20 76 61 rite the nRec va
26720 6c 75 65 20 69 6e 74 6f 20 74 68 65 20 6a 6f 75 lue into the jou
26730 72 6e 61 6c 20 66 69 6c 65 20 68 65 61 64 65 72 rnal file header
26740 2e 20 49 66 20 69 6e 0a 20 20 20 20 20 20 20 20 . If in.
26750 2a 2a 20 66 75 6c 6c 2d 73 79 6e 63 68 72 6f 6e ** full-synchron
26760 6f 75 73 20 6d 6f 64 65 2c 20 73 79 6e 63 20 74 ous mode, sync t
26770 68 65 20 6a 6f 75 72 6e 61 6c 20 66 69 72 73 74 he journal first
26780 2e 20 54 68 69 73 20 65 6e 73 75 72 65 73 20 74 . This ensures t
26790 68 61 74 0a 20 20 20 20 20 20 20 20 2a 2a 20 61 hat. ** a
267a0 6c 6c 20 64 61 74 61 20 68 61 73 20 72 65 61 6c ll data has real
267b0 6c 79 20 68 69 74 20 74 68 65 20 64 69 73 6b 20 ly hit the disk
267c0 62 65 66 6f 72 65 20 6e 52 65 63 20 69 73 20 75 before nRec is u
267d0 70 64 61 74 65 64 20 74 6f 20 6d 61 72 6b 0a 20 pdated to mark.
267e0 20 20 20 20 20 20 20 2a 2a 20 69 74 20 61 73 20 ** it as
267f0 61 20 63 61 6e 64 69 64 61 74 65 20 66 6f 72 20 a candidate for
26800 72 6f 6c 6c 62 61 63 6b 2e 0a 20 20 20 20 20 20 rollback..
26810 20 20 2a 2a 0a 20 20 20 20 20 20 20 20 2a 2a 20 **. **
26820 54 68 69 73 20 69 73 20 6e 6f 74 20 72 65 71 75 This is not requ
26830 69 72 65 64 20 69 66 20 74 68 65 20 70 65 72 73 ired if the pers
26840 69 73 74 65 6e 74 20 6d 65 64 69 61 20 73 75 70 istent media sup
26850 70 6f 72 74 73 20 74 68 65 0a 20 20 20 20 20 20 ports the.
26860 20 20 2a 2a 20 53 41 46 45 5f 41 50 50 45 4e 44 ** SAFE_APPEND
26870 20 70 72 6f 70 65 72 74 79 2e 20 42 65 63 61 75 property. Becau
26880 73 65 20 69 6e 20 74 68 69 73 20 63 61 73 65 20 se in this case
26890 69 74 20 69 73 20 6e 6f 74 20 70 6f 73 73 69 62 it is not possib
268a0 6c 65 20 0a 20 20 20 20 20 20 20 20 2a 2a 20 66 le . ** f
268b0 6f 72 20 67 61 72 62 61 67 65 20 64 61 74 61 20 or garbage data
268c0 74 6f 20 62 65 20 61 70 70 65 6e 64 65 64 20 74 to be appended t
268d0 6f 20 74 68 65 20 66 69 6c 65 2c 20 74 68 65 20 o the file, the
268e0 6e 52 65 63 20 66 69 65 6c 64 0a 20 20 20 20 20 nRec field.
268f0 20 20 20 2a 2a 20 69 73 20 70 6f 70 75 6c 61 74 ** is populat
26900 65 64 20 77 69 74 68 20 30 78 46 46 46 46 46 46 ed with 0xFFFFFF
26910 46 46 20 77 68 65 6e 20 74 68 65 20 6a 6f 75 72 FF when the jour
26920 6e 61 6c 20 68 65 61 64 65 72 20 69 73 20 77 72 nal header is wr
26930 69 74 74 65 6e 0a 20 20 20 20 20 20 20 20 2a 2a itten. **
26940 20 61 6e 64 20 6e 65 76 65 72 20 6e 65 65 64 73 and never needs
26950 20 74 6f 20 62 65 20 75 70 64 61 74 65 64 2e 0a to be updated..
26960 20 20 20 20 20 20 20 20 2a 2f 0a 20 20 20 20 20 */.
26970 20 20 20 69 66 28 20 70 50 61 67 65 72 2d 3e 66 if( pPager->f
26980 75 6c 6c 53 79 6e 63 20 26 26 20 30 3d 3d 28 69 ullSync && 0==(i
26990 44 63 26 53 51 4c 49 54 45 5f 49 4f 43 41 50 5f Dc&SQLITE_IOCAP_
269a0 53 45 51 55 45 4e 54 49 41 4c 29 20 29 7b 0a 20 SEQUENTIAL) ){.
269b0 20 20 20 20 20 20 20 20 20 50 41 47 45 52 54 52 PAGERTR
269c0 41 43 45 28 28 22 53 59 4e 43 20 6a 6f 75 72 6e ACE(("SYNC journ
269d0 61 6c 20 6f 66 20 25 64 5c 6e 22 2c 20 50 41 47 al of %d\n", PAG
269e0 45 52 49 44 28 70 50 61 67 65 72 29 29 29 3b 0a ERID(pPager)));.
269f0 20 20 20 20 20 20 20 20 20 20 49 4f 54 52 41 43 IOTRAC
26a00 45 28 28 22 4a 53 59 4e 43 20 25 70 5c 6e 22 2c E(("JSYNC %p\n",
26a10 20 70 50 61 67 65 72 29 29 0a 20 20 20 20 20 20 pPager)).
26a20 20 20 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33 rc = sqlite3
26a30 4f 73 53 79 6e 63 28 70 50 61 67 65 72 2d 3e 6a OsSync(pPager->j
26a40 66 64 2c 20 70 50 61 67 65 72 2d 3e 73 79 6e 63 fd, pPager->sync
26a50 46 6c 61 67 73 29 3b 0a 20 20 20 20 20 20 20 20 Flags);.
26a60 20 20 69 66 28 20 72 63 21 3d 53 51 4c 49 54 45 if( rc!=SQLITE
26a70 5f 4f 4b 20 29 20 72 65 74 75 72 6e 20 72 63 3b _OK ) return rc;
26a80 0a 20 20 20 20 20 20 20 20 7d 0a 20 20 20 20 20 . }.
26a90 20 20 20 49 4f 54 52 41 43 45 28 28 22 4a 48 44 IOTRACE(("JHD
26aa0 52 20 25 70 20 25 6c 6c 64 5c 6e 22 2c 20 70 50 R %p %lld\n", pP
26ab0 61 67 65 72 2c 20 70 50 61 67 65 72 2d 3e 6a 6f ager, pPager->jo
26ac0 75 72 6e 61 6c 48 64 72 29 29 3b 0a 20 20 20 20 urnalHdr));.
26ad0 20 20 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33 rc = sqlite3
26ae0 4f 73 57 72 69 74 65 28 0a 20 20 20 20 20 20 20 OsWrite(.
26af0 20 20 20 20 20 70 50 61 67 65 72 2d 3e 6a 66 64 pPager->jfd
26b00 2c 20 7a 48 65 61 64 65 72 2c 20 73 69 7a 65 6f , zHeader, sizeo
26b10 66 28 7a 48 65 61 64 65 72 29 2c 20 70 50 61 67 f(zHeader), pPag
26b20 65 72 2d 3e 6a 6f 75 72 6e 61 6c 48 64 72 0a 20 er->journalHdr.
26b30 20 20 20 20 20 20 20 29 3b 0a 20 20 20 20 20 20 );.
26b40 20 20 69 66 28 20 72 63 21 3d 53 51 4c 49 54 45 if( rc!=SQLITE
26b50 5f 4f 4b 20 29 20 72 65 74 75 72 6e 20 72 63 3b _OK ) return rc;
26b60 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 69 . }. i
26b70 66 28 20 30 3d 3d 28 69 44 63 26 53 51 4c 49 54 f( 0==(iDc&SQLIT
26b80 45 5f 49 4f 43 41 50 5f 53 45 51 55 45 4e 54 49 E_IOCAP_SEQUENTI
26b90 41 4c 29 20 29 7b 0a 20 20 20 20 20 20 20 20 50 AL) ){. P
26ba0 41 47 45 52 54 52 41 43 45 28 28 22 53 59 4e 43 AGERTRACE(("SYNC
26bb0 20 6a 6f 75 72 6e 61 6c 20 6f 66 20 25 64 5c 6e journal of %d\n
26bc0 22 2c 20 50 41 47 45 52 49 44 28 70 50 61 67 65 ", PAGERID(pPage
26bd0 72 29 29 29 3b 0a 20 20 20 20 20 20 20 20 49 4f r)));. IO
26be0 54 52 41 43 45 28 28 22 4a 53 59 4e 43 20 25 70 TRACE(("JSYNC %p
26bf0 5c 6e 22 2c 20 70 50 61 67 65 72 29 29 0a 20 20 \n", pPager)).
26c00 20 20 20 20 20 20 72 63 20 3d 20 73 71 6c 69 74 rc = sqlit
26c10 65 33 4f 73 53 79 6e 63 28 70 50 61 67 65 72 2d e3OsSync(pPager-
26c20 3e 6a 66 64 2c 20 70 50 61 67 65 72 2d 3e 73 79 >jfd, pPager->sy
26c30 6e 63 46 6c 61 67 73 7c 20 0a 20 20 20 20 20 20 ncFlags| .
26c40 20 20 20 20 28 70 50 61 67 65 72 2d 3e 73 79 6e (pPager->syn
26c50 63 46 6c 61 67 73 3d 3d 53 51 4c 49 54 45 5f 53 cFlags==SQLITE_S
26c60 59 4e 43 5f 46 55 4c 4c 3f 53 51 4c 49 54 45 5f YNC_FULL?SQLITE_
26c70 53 59 4e 43 5f 44 41 54 41 4f 4e 4c 59 3a 30 29 SYNC_DATAONLY:0)
26c80 0a 20 20 20 20 20 20 20 20 29 3b 0a 20 20 20 20 . );.
26c90 20 20 20 20 69 66 28 20 72 63 21 3d 53 51 4c 49 if( rc!=SQLI
26ca0 54 45 5f 4f 4b 20 29 20 72 65 74 75 72 6e 20 72 TE_OK ) return r
26cb0 63 3b 0a 20 20 20 20 20 20 7d 0a 0a 20 20 20 20 c;. }..
26cc0 20 20 70 50 61 67 65 72 2d 3e 6a 6f 75 72 6e 61 pPager->journa
26cd0 6c 48 64 72 20 3d 20 70 50 61 67 65 72 2d 3e 6a lHdr = pPager->j
26ce0 6f 75 72 6e 61 6c 4f 66 66 3b 0a 20 20 20 20 20 ournalOff;.
26cf0 20 69 66 28 20 6e 65 77 48 64 72 20 26 26 20 30 if( newHdr && 0
26d00 3d 3d 28 69 44 63 26 53 51 4c 49 54 45 5f 49 4f ==(iDc&SQLITE_IO
26d10 43 41 50 5f 53 41 46 45 5f 41 50 50 45 4e 44 29 CAP_SAFE_APPEND)
26d20 20 29 7b 0a 20 20 20 20 20 20 20 20 70 50 61 67 ){. pPag
26d30 65 72 2d 3e 6e 52 65 63 20 3d 20 30 3b 0a 20 20 er->nRec = 0;.
26d40 20 20 20 20 20 20 72 63 20 3d 20 77 72 69 74 65 rc = write
26d50 4a 6f 75 72 6e 61 6c 48 64 72 28 70 50 61 67 65 JournalHdr(pPage
26d60 72 29 3b 0a 20 20 20 20 20 20 20 20 69 66 28 20 r);. if(
26d70 72 63 21 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 20 rc!=SQLITE_OK )
26d80 72 65 74 75 72 6e 20 72 63 3b 0a 20 20 20 20 20 return rc;.
26d90 20 7d 0a 20 20 20 20 7d 65 6c 73 65 7b 0a 20 20 }. }else{.
26da0 20 20 20 20 70 50 61 67 65 72 2d 3e 6a 6f 75 72 pPager->jour
26db0 6e 61 6c 48 64 72 20 3d 20 70 50 61 67 65 72 2d nalHdr = pPager-
26dc0 3e 6a 6f 75 72 6e 61 6c 4f 66 66 3b 0a 20 20 20 >journalOff;.
26dd0 20 7d 0a 20 20 7d 0a 0a 20 20 2f 2a 20 55 6e 6c }. }.. /* Unl
26de0 65 73 73 20 74 68 65 20 70 61 67 65 72 20 69 73 ess the pager is
26df0 20 69 6e 20 6e 6f 53 79 6e 63 20 6d 6f 64 65 2c in noSync mode,
26e00 20 74 68 65 20 6a 6f 75 72 6e 61 6c 20 66 69 6c the journal fil
26e10 65 20 77 61 73 20 6a 75 73 74 20 0a 20 20 2a 2a e was just . **
26e20 20 73 75 63 63 65 73 73 66 75 6c 6c 79 20 73 79 successfully sy
26e30 6e 63 65 64 2e 20 45 69 74 68 65 72 20 77 61 79 nced. Either way
26e40 2c 20 63 6c 65 61 72 20 74 68 65 20 50 47 48 44 , clear the PGHD
26e50 52 5f 4e 45 45 44 5f 53 59 4e 43 20 66 6c 61 67 R_NEED_SYNC flag
26e60 20 6f 6e 20 0a 20 20 2a 2a 20 61 6c 6c 20 70 61 on . ** all pa
26e70 67 65 73 2e 0a 20 20 2a 2f 0a 20 20 73 71 6c 69 ges.. */. sqli
26e80 74 65 33 50 63 61 63 68 65 43 6c 65 61 72 53 79 te3PcacheClearSy
26e90 6e 63 46 6c 61 67 73 28 70 50 61 67 65 72 2d 3e ncFlags(pPager->
26ea0 70 50 43 61 63 68 65 29 3b 0a 20 20 70 50 61 67 pPCache);. pPag
26eb0 65 72 2d 3e 65 53 74 61 74 65 20 3d 20 50 41 47 er->eState = PAG
26ec0 45 52 5f 57 52 49 54 45 52 5f 44 42 4d 4f 44 3b ER_WRITER_DBMOD;
26ed0 0a 20 20 61 73 73 65 72 74 28 20 61 73 73 65 72 . assert( asser
26ee0 74 5f 70 61 67 65 72 5f 73 74 61 74 65 28 70 50 t_pager_state(pP
26ef0 61 67 65 72 29 20 29 3b 0a 20 20 72 65 74 75 72 ager) );. retur
26f00 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 7d 0a 0a n SQLITE_OK;.}..
26f10 2f 2a 0a 2a 2a 20 54 68 65 20 61 72 67 75 6d 65 /*.** The argume
26f20 6e 74 20 69 73 20 74 68 65 20 66 69 72 73 74 20 nt is the first
26f30 69 6e 20 61 20 6c 69 6e 6b 65 64 20 6c 69 73 74 in a linked list
26f40 20 6f 66 20 64 69 72 74 79 20 70 61 67 65 73 20 of dirty pages
26f50 63 6f 6e 6e 65 63 74 65 64 0a 2a 2a 20 62 79 20 connected.** by
26f60 74 68 65 20 50 67 48 64 72 2e 70 44 69 72 74 79 the PgHdr.pDirty
26f70 20 70 6f 69 6e 74 65 72 2e 20 54 68 69 73 20 66 pointer. This f
26f80 75 6e 63 74 69 6f 6e 20 77 72 69 74 65 73 20 65 unction writes e
26f90 61 63 68 20 6f 6e 65 20 6f 66 20 74 68 65 0a 2a ach one of the.*
26fa0 2a 20 69 6e 2d 6d 65 6d 6f 72 79 20 70 61 67 65 * in-memory page
26fb0 73 20 69 6e 20 74 68 65 20 6c 69 73 74 20 74 6f s in the list to
26fc0 20 74 68 65 20 64 61 74 61 62 61 73 65 20 66 69 the database fi
26fd0 6c 65 2e 20 54 68 65 20 61 72 67 75 6d 65 6e 74 le. The argument
26fe0 20 6d 61 79 0a 2a 2a 20 62 65 20 4e 55 4c 4c 2c may.** be NULL,
26ff0 20 72 65 70 72 65 73 65 6e 74 69 6e 67 20 61 6e representing an
27000 20 65 6d 70 74 79 20 6c 69 73 74 2e 20 49 6e 20 empty list. In
27010 74 68 69 73 20 63 61 73 65 20 74 68 69 73 20 66 this case this f
27020 75 6e 63 74 69 6f 6e 20 69 73 0a 2a 2a 20 61 20 unction is.** a
27030 6e 6f 2d 6f 70 2e 0a 2a 2a 0a 2a 2a 20 54 68 65 no-op..**.** The
27040 20 70 61 67 65 72 20 6d 75 73 74 20 68 6f 6c 64 pager must hold
27050 20 61 74 20 6c 65 61 73 74 20 61 20 52 45 53 45 at least a RESE
27060 52 56 45 44 20 6c 6f 63 6b 20 77 68 65 6e 20 74 RVED lock when t
27070 68 69 73 20 66 75 6e 63 74 69 6f 6e 0a 2a 2a 20 his function.**
27080 69 73 20 63 61 6c 6c 65 64 2e 20 42 65 66 6f 72 is called. Befor
27090 65 20 77 72 69 74 69 6e 67 20 61 6e 79 74 68 69 e writing anythi
270a0 6e 67 20 74 6f 20 74 68 65 20 64 61 74 61 62 61 ng to the databa
270b0 73 65 20 66 69 6c 65 2c 20 74 68 69 73 20 6c 6f se file, this lo
270c0 63 6b 0a 2a 2a 20 69 73 20 75 70 67 72 61 64 65 ck.** is upgrade
270d0 64 20 74 6f 20 61 6e 20 45 58 43 4c 55 53 49 56 d to an EXCLUSIV
270e0 45 20 6c 6f 63 6b 2e 20 49 66 20 74 68 65 20 6c E lock. If the l
270f0 6f 63 6b 20 63 61 6e 6e 6f 74 20 62 65 20 6f 62 ock cannot be ob
27100 74 61 69 6e 65 64 2c 0a 2a 2a 20 53 51 4c 49 54 tained,.** SQLIT
27110 45 5f 42 55 53 59 20 69 73 20 72 65 74 75 72 6e E_BUSY is return
27120 65 64 20 61 6e 64 20 6e 6f 20 64 61 74 61 20 69 ed and no data i
27130 73 20 77 72 69 74 74 65 6e 20 74 6f 20 74 68 65 s written to the
27140 20 64 61 74 61 62 61 73 65 20 66 69 6c 65 2e 0a database file..
27150 2a 2a 20 0a 2a 2a 20 49 66 20 74 68 65 20 70 61 ** .** If the pa
27160 67 65 72 20 69 73 20 61 20 74 65 6d 70 2d 66 69 ger is a temp-fi
27170 6c 65 20 70 61 67 65 72 20 61 6e 64 20 74 68 65 le pager and the
27180 20 61 63 74 75 61 6c 20 66 69 6c 65 2d 73 79 73 actual file-sys
27190 74 65 6d 20 66 69 6c 65 0a 2a 2a 20 69 73 20 6e tem file.** is n
271a0 6f 74 20 79 65 74 20 6f 70 65 6e 2c 20 69 74 20 ot yet open, it
271b0 69 73 20 63 72 65 61 74 65 64 20 61 6e 64 20 6f is created and o
271c0 70 65 6e 65 64 20 62 65 66 6f 72 65 20 61 6e 79 pened before any
271d0 20 64 61 74 61 20 69 73 20 0a 2a 2a 20 77 72 69 data is .** wri
271e0 74 74 65 6e 20 6f 75 74 2e 0a 2a 2a 0a 2a 2a 20 tten out..**.**
271f0 4f 6e 63 65 20 74 68 65 20 6c 6f 63 6b 20 68 61 Once the lock ha
27200 73 20 62 65 65 6e 20 75 70 67 72 61 64 65 64 20 s been upgraded
27210 61 6e 64 2c 20 69 66 20 6e 65 63 65 73 73 61 72 and, if necessar
27220 79 2c 20 74 68 65 20 66 69 6c 65 20 6f 70 65 6e y, the file open
27230 65 64 2c 0a 2a 2a 20 74 68 65 20 70 61 67 65 73 ed,.** the pages
27240 20 61 72 65 20 77 72 69 74 74 65 6e 20 6f 75 74 are written out
27250 20 74 6f 20 74 68 65 20 64 61 74 61 62 61 73 65 to the database
27260 20 66 69 6c 65 20 69 6e 20 6c 69 73 74 20 6f 72 file in list or
27270 64 65 72 2e 20 57 72 69 74 69 6e 67 0a 2a 2a 20 der. Writing.**
27280 61 20 70 61 67 65 20 69 73 20 73 6b 69 70 70 65 a page is skippe
27290 64 20 69 66 20 69 74 20 6d 65 65 74 73 20 65 69 d if it meets ei
272a0 74 68 65 72 20 6f 66 20 74 68 65 20 66 6f 6c 6c ther of the foll
272b0 6f 77 69 6e 67 20 63 72 69 74 65 72 69 61 3a 0a owing criteria:.
272c0 2a 2a 0a 2a 2a 20 20 20 2a 20 54 68 65 20 70 61 **.** * The pa
272d0 67 65 20 6e 75 6d 62 65 72 20 69 73 20 67 72 65 ge number is gre
272e0 61 74 65 72 20 74 68 61 6e 20 50 61 67 65 72 2e ater than Pager.
272f0 64 62 53 69 7a 65 2c 20 6f 72 0a 2a 2a 20 20 20 dbSize, or.**
27300 2a 20 54 68 65 20 50 47 48 44 52 5f 44 4f 4e 54 * The PGHDR_DONT
27310 5f 57 52 49 54 45 20 66 6c 61 67 20 69 73 20 73 _WRITE flag is s
27320 65 74 20 6f 6e 20 74 68 65 20 70 61 67 65 2e 0a et on the page..
27330 2a 2a 0a 2a 2a 20 49 66 20 77 72 69 74 69 6e 67 **.** If writing
27340 20 6f 75 74 20 61 20 70 61 67 65 20 63 61 75 73 out a page caus
27350 65 73 20 74 68 65 20 64 61 74 61 62 61 73 65 20 es the database
27360 66 69 6c 65 20 74 6f 20 67 72 6f 77 2c 20 50 61 file to grow, Pa
27370 67 65 72 2e 64 62 46 69 6c 65 53 69 7a 65 0a 2a ger.dbFileSize.*
27380 2a 20 69 73 20 75 70 64 61 74 65 64 20 61 63 63 * is updated acc
27390 6f 72 64 69 6e 67 6c 79 2e 20 49 66 20 70 61 67 ordingly. If pag
273a0 65 20 31 20 69 73 20 77 72 69 74 74 65 6e 20 6f e 1 is written o
273b0 75 74 2c 20 74 68 65 6e 20 74 68 65 20 76 61 6c ut, then the val
273c0 75 65 20 63 61 63 68 65 64 0a 2a 2a 20 69 6e 20 ue cached.** in
273d0 50 61 67 65 72 2e 64 62 46 69 6c 65 56 65 72 73 Pager.dbFileVers
273e0 5b 5d 20 69 73 20 75 70 64 61 74 65 64 20 74 6f [] is updated to
273f0 20 6d 61 74 63 68 20 74 68 65 20 6e 65 77 20 76 match the new v
27400 61 6c 75 65 20 73 74 6f 72 65 64 20 69 6e 0a 2a alue stored in.*
27410 2a 20 74 68 65 20 64 61 74 61 62 61 73 65 20 66 * the database f
27420 69 6c 65 2e 0a 2a 2a 0a 2a 2a 20 49 66 20 65 76 ile..**.** If ev
27430 65 72 79 74 68 69 6e 67 20 69 73 20 73 75 63 63 erything is succ
27440 65 73 73 66 75 6c 2c 20 53 51 4c 49 54 45 5f 4f essful, SQLITE_O
27450 4b 20 69 73 20 72 65 74 75 72 6e 65 64 2e 20 49 K is returned. I
27460 66 20 61 6e 20 49 4f 20 65 72 72 6f 72 20 0a 2a f an IO error .*
27470 2a 20 6f 63 63 75 72 73 2c 20 61 6e 20 49 4f 20 * occurs, an IO
27480 65 72 72 6f 72 20 63 6f 64 65 20 69 73 20 72 65 error code is re
27490 74 75 72 6e 65 64 2e 20 4f 72 2c 20 69 66 20 74 turned. Or, if t
274a0 68 65 20 45 58 43 4c 55 53 49 56 45 20 6c 6f 63 he EXCLUSIVE loc
274b0 6b 20 63 61 6e 6e 6f 74 0a 2a 2a 20 62 65 20 6f k cannot.** be o
274c0 62 74 61 69 6e 65 64 2c 20 53 51 4c 49 54 45 5f btained, SQLITE_
274d0 42 55 53 59 20 69 73 20 72 65 74 75 72 6e 65 64 BUSY is returned
274e0 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74 20 ..*/.static int
274f0 70 61 67 65 72 5f 77 72 69 74 65 5f 70 61 67 65 pager_write_page
27500 6c 69 73 74 28 50 61 67 65 72 20 2a 70 50 61 67 list(Pager *pPag
27510 65 72 2c 20 50 67 48 64 72 20 2a 70 4c 69 73 74 er, PgHdr *pList
27520 29 7b 0a 20 20 69 6e 74 20 72 63 20 3d 20 53 51 ){. int rc = SQ
27530 4c 49 54 45 5f 4f 4b 3b 20 20 20 20 20 20 20 20 LITE_OK;
27540 20 20 20 20 20 20 20 20 20 20 2f 2a 20 52 65 74 /* Ret
27550 75 72 6e 20 63 6f 64 65 20 2a 2f 0a 0a 20 20 2f urn code */.. /
27560 2a 20 54 68 69 73 20 66 75 6e 63 74 69 6f 6e 20 * This function
27570 69 73 20 6f 6e 6c 79 20 63 61 6c 6c 65 64 20 66 is only called f
27580 6f 72 20 72 6f 6c 6c 62 61 63 6b 20 70 61 67 65 or rollback page
27590 72 73 20 69 6e 20 57 52 49 54 45 52 5f 44 42 4d rs in WRITER_DBM
275a0 4f 44 20 73 74 61 74 65 2e 20 2a 2f 0a 20 20 61 OD state. */. a
275b0 73 73 65 72 74 28 20 21 70 61 67 65 72 55 73 65 ssert( !pagerUse
275c0 57 61 6c 28 70 50 61 67 65 72 29 20 29 3b 0a 20 Wal(pPager) );.
275d0 20 61 73 73 65 72 74 28 20 70 50 61 67 65 72 2d assert( pPager-
275e0 3e 65 53 74 61 74 65 3d 3d 50 41 47 45 52 5f 57 >eState==PAGER_W
275f0 52 49 54 45 52 5f 44 42 4d 4f 44 20 29 3b 0a 20 RITER_DBMOD );.
27600 20 61 73 73 65 72 74 28 20 70 50 61 67 65 72 2d assert( pPager-
27610 3e 65 4c 6f 63 6b 3d 3d 45 58 43 4c 55 53 49 56 >eLock==EXCLUSIV
27620 45 5f 4c 4f 43 4b 20 29 3b 0a 0a 20 20 2f 2a 20 E_LOCK );.. /*
27630 49 66 20 74 68 65 20 66 69 6c 65 20 69 73 20 61 If the file is a
27640 20 74 65 6d 70 2d 66 69 6c 65 20 68 61 73 20 6e temp-file has n
27650 6f 74 20 79 65 74 20 62 65 65 6e 20 6f 70 65 6e ot yet been open
27660 65 64 2c 20 6f 70 65 6e 20 69 74 20 6e 6f 77 2e ed, open it now.
27670 20 49 74 0a 20 20 2a 2a 20 69 73 20 6e 6f 74 20 It. ** is not
27680 70 6f 73 73 69 62 6c 65 20 66 6f 72 20 72 63 20 possible for rc
27690 74 6f 20 62 65 20 6f 74 68 65 72 20 74 68 61 6e to be other than
276a0 20 53 51 4c 49 54 45 5f 4f 4b 20 69 66 20 74 68 SQLITE_OK if th
276b0 69 73 20 62 72 61 6e 63 68 0a 20 20 2a 2a 20 69 is branch. ** i
276c0 73 20 74 61 6b 65 6e 2c 20 61 73 20 70 61 67 65 s taken, as page
276d0 72 5f 77 61 69 74 5f 6f 6e 5f 6c 6f 63 6b 28 29 r_wait_on_lock()
276e0 20 69 73 20 61 20 6e 6f 2d 6f 70 20 66 6f 72 20 is a no-op for
276f0 74 65 6d 70 2d 66 69 6c 65 73 2e 0a 20 20 2a 2f temp-files.. */
27700 0a 20 20 69 66 28 20 21 69 73 4f 70 65 6e 28 70 . if( !isOpen(p
27710 50 61 67 65 72 2d 3e 66 64 29 20 29 7b 0a 20 20 Pager->fd) ){.
27720 20 20 61 73 73 65 72 74 28 20 70 50 61 67 65 72 assert( pPager
27730 2d 3e 74 65 6d 70 46 69 6c 65 20 26 26 20 72 63 ->tempFile && rc
27740 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 3b 0a 20 ==SQLITE_OK );.
27750 20 20 20 72 63 20 3d 20 70 61 67 65 72 4f 70 65 rc = pagerOpe
27760 6e 74 65 6d 70 28 70 50 61 67 65 72 2c 20 70 50 ntemp(pPager, pP
27770 61 67 65 72 2d 3e 66 64 2c 20 70 50 61 67 65 72 ager->fd, pPager
27780 2d 3e 76 66 73 46 6c 61 67 73 29 3b 0a 20 20 7d ->vfsFlags);. }
27790 0a 0a 20 20 2f 2a 20 42 65 66 6f 72 65 20 74 68 .. /* Before th
277a0 65 20 66 69 72 73 74 20 77 72 69 74 65 2c 20 67 e first write, g
277b0 69 76 65 20 74 68 65 20 56 46 53 20 61 20 68 69 ive the VFS a hi
277c0 6e 74 20 6f 66 20 77 68 61 74 20 74 68 65 20 66 nt of what the f
277d0 69 6e 61 6c 0a 20 20 2a 2a 20 66 69 6c 65 20 73 inal. ** file s
277e0 69 7a 65 20 77 69 6c 6c 20 62 65 2e 0a 20 20 2a ize will be.. *
277f0 2f 0a 20 20 61 73 73 65 72 74 28 20 72 63 21 3d /. assert( rc!=
27800 53 51 4c 49 54 45 5f 4f 4b 20 7c 7c 20 69 73 4f SQLITE_OK || isO
27810 70 65 6e 28 70 50 61 67 65 72 2d 3e 66 64 29 20 pen(pPager->fd)
27820 29 3b 0a 20 20 69 66 28 20 72 63 3d 3d 53 51 4c );. if( rc==SQL
27830 49 54 45 5f 4f 4b 20 26 26 20 70 50 61 67 65 72 ITE_OK && pPager
27840 2d 3e 64 62 53 69 7a 65 3e 70 50 61 67 65 72 2d ->dbSize>pPager-
27850 3e 64 62 48 69 6e 74 53 69 7a 65 20 29 7b 0a 20 >dbHintSize ){.
27860 20 20 20 73 71 6c 69 74 65 33 5f 69 6e 74 36 34 sqlite3_int64
27870 20 73 7a 46 69 6c 65 20 3d 20 70 50 61 67 65 72 szFile = pPager
27880 2d 3e 70 61 67 65 53 69 7a 65 20 2a 20 28 73 71 ->pageSize * (sq
27890 6c 69 74 65 33 5f 69 6e 74 36 34 29 70 50 61 67 lite3_int64)pPag
278a0 65 72 2d 3e 64 62 53 69 7a 65 3b 0a 20 20 20 20 er->dbSize;.
278b0 73 71 6c 69 74 65 33 4f 73 46 69 6c 65 43 6f 6e sqlite3OsFileCon
278c0 74 72 6f 6c 28 70 50 61 67 65 72 2d 3e 66 64 2c trol(pPager->fd,
278d0 20 53 51 4c 49 54 45 5f 46 43 4e 54 4c 5f 53 49 SQLITE_FCNTL_SI
278e0 5a 45 5f 48 49 4e 54 2c 20 26 73 7a 46 69 6c 65 ZE_HINT, &szFile
278f0 29 3b 0a 20 20 20 20 70 50 61 67 65 72 2d 3e 64 );. pPager->d
27900 62 48 69 6e 74 53 69 7a 65 20 3d 20 70 50 61 67 bHintSize = pPag
27910 65 72 2d 3e 64 62 53 69 7a 65 3b 0a 20 20 7d 0a er->dbSize;. }.
27920 0a 20 20 77 68 69 6c 65 28 20 72 63 3d 3d 53 51 . while( rc==SQ
27930 4c 49 54 45 5f 4f 4b 20 26 26 20 70 4c 69 73 74 LITE_OK && pList
27940 20 29 7b 0a 20 20 20 20 50 67 6e 6f 20 70 67 6e ){. Pgno pgn
27950 6f 20 3d 20 70 4c 69 73 74 2d 3e 70 67 6e 6f 3b o = pList->pgno;
27960 0a 0a 20 20 20 20 2f 2a 20 49 66 20 74 68 65 72 .. /* If ther
27970 65 20 61 72 65 20 64 69 72 74 79 20 70 61 67 65 e are dirty page
27980 73 20 69 6e 20 74 68 65 20 70 61 67 65 20 63 61 s in the page ca
27990 63 68 65 20 77 69 74 68 20 70 61 67 65 20 6e 75 che with page nu
279a0 6d 62 65 72 73 20 67 72 65 61 74 65 72 0a 20 20 mbers greater.
279b0 20 20 2a 2a 20 74 68 61 6e 20 50 61 67 65 72 2e ** than Pager.
279c0 64 62 53 69 7a 65 2c 20 74 68 69 73 20 6d 65 61 dbSize, this mea
279d0 6e 73 20 73 71 6c 69 74 65 33 50 61 67 65 72 54 ns sqlite3PagerT
279e0 72 75 6e 63 61 74 65 49 6d 61 67 65 28 29 20 77 runcateImage() w
279f0 61 73 20 63 61 6c 6c 65 64 20 74 6f 0a 20 20 20 as called to.
27a00 20 2a 2a 20 6d 61 6b 65 20 74 68 65 20 66 69 6c ** make the fil
27a10 65 20 73 6d 61 6c 6c 65 72 20 28 70 72 65 73 75 e smaller (presu
27a20 6d 61 62 6c 79 20 62 79 20 61 75 74 6f 2d 76 61 mably by auto-va
27a30 63 75 75 6d 20 63 6f 64 65 29 2e 20 44 6f 20 6e cuum code). Do n
27a40 6f 74 20 77 72 69 74 65 0a 20 20 20 20 2a 2a 20 ot write. **
27a50 61 6e 79 20 73 75 63 68 20 70 61 67 65 73 20 74 any such pages t
27a60 6f 20 74 68 65 20 66 69 6c 65 2e 0a 20 20 20 20 o the file..
27a70 2a 2a 0a 20 20 20 20 2a 2a 20 41 6c 73 6f 2c 20 **. ** Also,
27a80 64 6f 20 6e 6f 74 20 77 72 69 74 65 20 6f 75 74 do not write out
27a90 20 61 6e 79 20 70 61 67 65 20 74 68 61 74 20 68 any page that h
27aa0 61 73 20 74 68 65 20 50 47 48 44 52 5f 44 4f 4e as the PGHDR_DON
27ab0 54 5f 57 52 49 54 45 20 66 6c 61 67 0a 20 20 20 T_WRITE flag.
27ac0 20 2a 2a 20 73 65 74 20 28 73 65 74 20 62 79 20 ** set (set by
27ad0 73 71 6c 69 74 65 33 50 61 67 65 72 44 6f 6e 74 sqlite3PagerDont
27ae0 57 72 69 74 65 28 29 29 2e 0a 20 20 20 20 2a 2f Write()).. */
27af0 0a 20 20 20 20 69 66 28 20 70 67 6e 6f 3c 3d 70 . if( pgno<=p
27b00 50 61 67 65 72 2d 3e 64 62 53 69 7a 65 20 26 26 Pager->dbSize &&
27b10 20 30 3d 3d 28 70 4c 69 73 74 2d 3e 66 6c 61 67 0==(pList->flag
27b20 73 26 50 47 48 44 52 5f 44 4f 4e 54 5f 57 52 49 s&PGHDR_DONT_WRI
27b30 54 45 29 20 29 7b 0a 20 20 20 20 20 20 69 36 34 TE) ){. i64
27b40 20 6f 66 66 73 65 74 20 3d 20 28 70 67 6e 6f 2d offset = (pgno-
27b50 31 29 2a 28 69 36 34 29 70 50 61 67 65 72 2d 3e 1)*(i64)pPager->
27b60 70 61 67 65 53 69 7a 65 3b 20 20 20 2f 2a 20 4f pageSize; /* O
27b70 66 66 73 65 74 20 74 6f 20 77 72 69 74 65 20 2a ffset to write *
27b80 2f 0a 20 20 20 20 20 20 63 68 61 72 20 2a 70 44 /. char *pD
27b90 61 74 61 3b 20 20 20 20 20 20 20 20 20 20 20 20 ata;
27ba0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
27bb0 20 20 20 20 20 20 20 2f 2a 20 44 61 74 61 20 74 /* Data t
27bc0 6f 20 77 72 69 74 65 20 2a 2f 20 20 20 20 0a 0a o write */ ..
27bd0 20 20 20 20 20 20 61 73 73 65 72 74 28 20 28 70 assert( (p
27be0 4c 69 73 74 2d 3e 66 6c 61 67 73 26 50 47 48 44 List->flags&PGHD
27bf0 52 5f 4e 45 45 44 5f 53 59 4e 43 29 3d 3d 30 20 R_NEED_SYNC)==0
27c00 29 3b 0a 20 20 20 20 20 20 69 66 28 20 70 4c 69 );. if( pLi
27c10 73 74 2d 3e 70 67 6e 6f 3d 3d 31 20 29 20 70 61 st->pgno==1 ) pa
27c20 67 65 72 5f 77 72 69 74 65 5f 63 68 61 6e 67 65 ger_write_change
27c30 63 6f 75 6e 74 65 72 28 70 4c 69 73 74 29 3b 0a counter(pList);.
27c40 0a 20 20 20 20 20 20 2f 2a 20 45 6e 63 6f 64 65 . /* Encode
27c50 20 74 68 65 20 64 61 74 61 62 61 73 65 20 2a 2f the database */
27c60 0a 20 20 20 20 20 20 43 4f 44 45 43 32 28 70 50 . CODEC2(pP
27c70 61 67 65 72 2c 20 70 4c 69 73 74 2d 3e 70 44 61 ager, pList->pDa
27c80 74 61 2c 20 70 67 6e 6f 2c 20 36 2c 20 72 65 74 ta, pgno, 6, ret
27c90 75 72 6e 20 53 51 4c 49 54 45 5f 4e 4f 4d 45 4d urn SQLITE_NOMEM
27ca0 2c 20 70 44 61 74 61 29 3b 0a 0a 20 20 20 20 20 , pData);..
27cb0 20 2f 2a 20 57 72 69 74 65 20 6f 75 74 20 74 68 /* Write out th
27cc0 65 20 70 61 67 65 20 64 61 74 61 2e 20 2a 2f 0a e page data. */.
27cd0 20 20 20 20 20 20 72 63 20 3d 20 73 71 6c 69 74 rc = sqlit
27ce0 65 33 4f 73 57 72 69 74 65 28 70 50 61 67 65 72 e3OsWrite(pPager
27cf0 2d 3e 66 64 2c 20 70 44 61 74 61 2c 20 70 50 61 ->fd, pData, pPa
27d00 67 65 72 2d 3e 70 61 67 65 53 69 7a 65 2c 20 6f ger->pageSize, o
27d10 66 66 73 65 74 29 3b 0a 0a 20 20 20 20 20 20 2f ffset);.. /
27d20 2a 20 49 66 20 70 61 67 65 20 31 20 77 61 73 20 * If page 1 was
27d30 6a 75 73 74 20 77 72 69 74 74 65 6e 2c 20 75 70 just written, up
27d40 64 61 74 65 20 50 61 67 65 72 2e 64 62 46 69 6c date Pager.dbFil
27d50 65 56 65 72 73 20 74 6f 20 6d 61 74 63 68 0a 20 eVers to match.
27d60 20 20 20 20 20 2a 2a 20 74 68 65 20 76 61 6c 75 ** the valu
27d70 65 20 6e 6f 77 20 73 74 6f 72 65 64 20 69 6e 20 e now stored in
27d80 74 68 65 20 64 61 74 61 62 61 73 65 20 66 69 6c the database fil
27d90 65 2e 20 49 66 20 77 72 69 74 69 6e 67 20 74 68 e. If writing th
27da0 69 73 20 0a 20 20 20 20 20 20 2a 2a 20 70 61 67 is . ** pag
27db0 65 20 63 61 75 73 65 64 20 74 68 65 20 64 61 74 e caused the dat
27dc0 61 62 61 73 65 20 66 69 6c 65 20 74 6f 20 67 72 abase file to gr
27dd0 6f 77 2c 20 75 70 64 61 74 65 20 64 62 46 69 6c ow, update dbFil
27de0 65 53 69 7a 65 2e 20 0a 20 20 20 20 20 20 2a 2f eSize. . */
27df0 0a 20 20 20 20 20 20 69 66 28 20 70 67 6e 6f 3d . if( pgno=
27e00 3d 31 20 29 7b 0a 20 20 20 20 20 20 20 20 6d 65 =1 ){. me
27e10 6d 63 70 79 28 26 70 50 61 67 65 72 2d 3e 64 62 mcpy(&pPager->db
27e20 46 69 6c 65 56 65 72 73 2c 20 26 70 44 61 74 61 FileVers, &pData
27e30 5b 32 34 5d 2c 20 73 69 7a 65 6f 66 28 70 50 61 [24], sizeof(pPa
27e40 67 65 72 2d 3e 64 62 46 69 6c 65 56 65 72 73 29 ger->dbFileVers)
27e50 29 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 20 );. }.
27e60 20 69 66 28 20 70 67 6e 6f 3e 70 50 61 67 65 72 if( pgno>pPager
27e70 2d 3e 64 62 46 69 6c 65 53 69 7a 65 20 29 7b 0a ->dbFileSize ){.
27e80 20 20 20 20 20 20 20 20 70 50 61 67 65 72 2d 3e pPager->
27e90 64 62 46 69 6c 65 53 69 7a 65 20 3d 20 70 67 6e dbFileSize = pgn
27ea0 6f 3b 0a 20 20 20 20 20 20 7d 0a 0a 20 20 20 20 o;. }..
27eb0 20 20 2f 2a 20 55 70 64 61 74 65 20 61 6e 79 20 /* Update any
27ec0 62 61 63 6b 75 70 20 6f 62 6a 65 63 74 73 20 63 backup objects c
27ed0 6f 70 79 69 6e 67 20 74 68 65 20 63 6f 6e 74 65 opying the conte
27ee0 6e 74 73 20 6f 66 20 74 68 69 73 20 70 61 67 65 nts of this page
27ef0 72 2e 20 2a 2f 0a 20 20 20 20 20 20 73 71 6c 69 r. */. sqli
27f00 74 65 33 42 61 63 6b 75 70 55 70 64 61 74 65 28 te3BackupUpdate(
27f10 70 50 61 67 65 72 2d 3e 70 42 61 63 6b 75 70 2c pPager->pBackup,
27f20 20 70 67 6e 6f 2c 20 28 75 38 2a 29 70 4c 69 73 pgno, (u8*)pLis
27f30 74 2d 3e 70 44 61 74 61 29 3b 0a 0a 20 20 20 20 t->pData);..
27f40 20 20 50 41 47 45 52 54 52 41 43 45 28 28 22 53 PAGERTRACE(("S
27f50 54 4f 52 45 20 25 64 20 70 61 67 65 20 25 64 20 TORE %d page %d
27f60 68 61 73 68 28 25 30 38 78 29 5c 6e 22 2c 0a 20 hash(%08x)\n",.
27f70 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
27f80 20 20 50 41 47 45 52 49 44 28 70 50 61 67 65 72 PAGERID(pPager
27f90 29 2c 20 70 67 6e 6f 2c 20 70 61 67 65 72 5f 70 ), pgno, pager_p
27fa0 61 67 65 68 61 73 68 28 70 4c 69 73 74 29 29 29 agehash(pList)))
27fb0 3b 0a 20 20 20 20 20 20 49 4f 54 52 41 43 45 28 ;. IOTRACE(
27fc0 28 22 50 47 4f 55 54 20 25 70 20 25 64 5c 6e 22 ("PGOUT %p %d\n"
27fd0 2c 20 70 50 61 67 65 72 2c 20 70 67 6e 6f 29 29 , pPager, pgno))
27fe0 3b 0a 20 20 20 20 20 20 50 41 47 45 52 5f 49 4e ;. PAGER_IN
27ff0 43 52 28 73 71 6c 69 74 65 33 5f 70 61 67 65 72 CR(sqlite3_pager
28000 5f 77 72 69 74 65 64 62 5f 63 6f 75 6e 74 29 3b _writedb_count);
28010 0a 20 20 20 20 20 20 50 41 47 45 52 5f 49 4e 43 . PAGER_INC
28020 52 28 70 50 61 67 65 72 2d 3e 6e 57 72 69 74 65 R(pPager->nWrite
28030 29 3b 0a 20 20 20 20 7d 65 6c 73 65 7b 0a 20 20 );. }else{.
28040 20 20 20 20 50 41 47 45 52 54 52 41 43 45 28 28 PAGERTRACE((
28050 22 4e 4f 53 54 4f 52 45 20 25 64 20 70 61 67 65 "NOSTORE %d page
28060 20 25 64 5c 6e 22 2c 20 50 41 47 45 52 49 44 28 %d\n", PAGERID(
28070 70 50 61 67 65 72 29 2c 20 70 67 6e 6f 29 29 3b pPager), pgno));
28080 0a 20 20 20 20 7d 0a 20 20 20 20 70 61 67 65 72 . }. pager
28090 5f 73 65 74 5f 70 61 67 65 68 61 73 68 28 70 4c _set_pagehash(pL
280a0 69 73 74 29 3b 0a 20 20 20 20 70 4c 69 73 74 20 ist);. pList
280b0 3d 20 70 4c 69 73 74 2d 3e 70 44 69 72 74 79 3b = pList->pDirty;
280c0 0a 20 20 7d 0a 0a 20 20 72 65 74 75 72 6e 20 72 . }.. return r
280d0 63 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 45 6e 73 75 c;.}../*.** Ensu
280e0 72 65 20 74 68 61 74 20 74 68 65 20 73 75 62 2d re that the sub-
280f0 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 20 69 73 20 journal file is
28100 6f 70 65 6e 2e 20 49 66 20 69 74 20 69 73 20 61 open. If it is a
28110 6c 72 65 61 64 79 20 6f 70 65 6e 2c 20 74 68 69 lready open, thi
28120 73 20 0a 2a 2a 20 66 75 6e 63 74 69 6f 6e 20 69 s .** function i
28130 73 20 61 20 6e 6f 2d 6f 70 2e 0a 2a 2a 0a 2a 2a s a no-op..**.**
28140 20 53 51 4c 49 54 45 5f 4f 4b 20 69 73 20 72 65 SQLITE_OK is re
28150 74 75 72 6e 65 64 20 69 66 20 65 76 65 72 79 74 turned if everyt
28160 68 69 6e 67 20 67 6f 65 73 20 61 63 63 6f 72 64 hing goes accord
28170 69 6e 67 20 74 6f 20 70 6c 61 6e 2e 20 41 6e 20 ing to plan. An
28180 0a 2a 2a 20 53 51 4c 49 54 45 5f 49 4f 45 52 52 .** SQLITE_IOERR
28190 5f 58 58 58 20 65 72 72 6f 72 20 63 6f 64 65 20 _XXX error code
281a0 69 73 20 72 65 74 75 72 6e 65 64 20 69 66 20 61 is returned if a
281b0 20 63 61 6c 6c 20 74 6f 20 73 71 6c 69 74 65 33 call to sqlite3
281c0 4f 73 4f 70 65 6e 28 29 20 0a 2a 2a 20 66 61 69 OsOpen() .** fai
281d0 6c 73 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e ls..*/.static in
281e0 74 20 6f 70 65 6e 53 75 62 4a 6f 75 72 6e 61 6c t openSubJournal
281f0 28 50 61 67 65 72 20 2a 70 50 61 67 65 72 29 7b (Pager *pPager){
28200 0a 20 20 69 6e 74 20 72 63 20 3d 20 53 51 4c 49 . int rc = SQLI
28210 54 45 5f 4f 4b 3b 0a 20 20 69 66 28 20 21 69 73 TE_OK;. if( !is
28220 4f 70 65 6e 28 70 50 61 67 65 72 2d 3e 73 6a 66 Open(pPager->sjf
28230 64 29 20 29 7b 0a 20 20 20 20 69 66 28 20 70 50 d) ){. if( pP
28240 61 67 65 72 2d 3e 6a 6f 75 72 6e 61 6c 4d 6f 64 ager->journalMod
28250 65 3d 3d 50 41 47 45 52 5f 4a 4f 55 52 4e 41 4c e==PAGER_JOURNAL
28260 4d 4f 44 45 5f 4d 45 4d 4f 52 59 20 7c 7c 20 70 MODE_MEMORY || p
28270 50 61 67 65 72 2d 3e 73 75 62 6a 49 6e 4d 65 6d Pager->subjInMem
28280 6f 72 79 20 29 7b 0a 20 20 20 20 20 20 73 71 6c ory ){. sql
28290 69 74 65 33 4d 65 6d 4a 6f 75 72 6e 61 6c 4f 70 ite3MemJournalOp
282a0 65 6e 28 70 50 61 67 65 72 2d 3e 73 6a 66 64 29 en(pPager->sjfd)
282b0 3b 0a 20 20 20 20 7d 65 6c 73 65 7b 0a 20 20 20 ;. }else{.
282c0 20 20 20 72 63 20 3d 20 70 61 67 65 72 4f 70 65 rc = pagerOpe
282d0 6e 74 65 6d 70 28 70 50 61 67 65 72 2c 20 70 50 ntemp(pPager, pP
282e0 61 67 65 72 2d 3e 73 6a 66 64 2c 20 53 51 4c 49 ager->sjfd, SQLI
282f0 54 45 5f 4f 50 45 4e 5f 53 55 42 4a 4f 55 52 4e TE_OPEN_SUBJOURN
28300 41 4c 29 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a 20 AL);. }. }.
28310 20 72 65 74 75 72 6e 20 72 63 3b 0a 7d 0a 0a 2f return rc;.}../
28320 2a 0a 2a 2a 20 41 70 70 65 6e 64 20 61 20 72 65 *.** Append a re
28330 63 6f 72 64 20 6f 66 20 74 68 65 20 63 75 72 72 cord of the curr
28340 65 6e 74 20 73 74 61 74 65 20 6f 66 20 70 61 67 ent state of pag
28350 65 20 70 50 67 20 74 6f 20 74 68 65 20 73 75 62 e pPg to the sub
28360 2d 6a 6f 75 72 6e 61 6c 2e 20 0a 2a 2a 20 49 74 -journal. .** It
28370 20 69 73 20 74 68 65 20 63 61 6c 6c 65 72 73 20 is the callers
28380 72 65 73 70 6f 6e 73 69 62 69 6c 69 74 79 20 74 responsibility t
28390 6f 20 75 73 65 20 73 75 62 6a 52 65 71 75 69 72 o use subjRequir
283a0 65 73 50 61 67 65 28 29 20 74 6f 20 63 68 65 63 esPage() to chec
283b0 6b 20 0a 2a 2a 20 74 68 61 74 20 69 74 20 69 73 k .** that it is
283c0 20 72 65 61 6c 6c 79 20 72 65 71 75 69 72 65 64 really required
283d0 20 62 65 66 6f 72 65 20 63 61 6c 6c 69 6e 67 20 before calling
283e0 74 68 69 73 20 66 75 6e 63 74 69 6f 6e 2e 0a 2a this function..*
283f0 2a 0a 2a 2a 20 49 66 20 73 75 63 63 65 73 73 66 *.** If successf
28400 75 6c 2c 20 73 65 74 20 74 68 65 20 62 69 74 20 ul, set the bit
28410 63 6f 72 72 65 73 70 6f 6e 64 69 6e 67 20 74 6f corresponding to
28420 20 70 50 67 2d 3e 70 67 6e 6f 20 69 6e 20 74 68 pPg->pgno in th
28430 65 20 62 69 74 76 65 63 73 0a 2a 2a 20 66 6f 72 e bitvecs.** for
28440 20 61 6c 6c 20 6f 70 65 6e 20 73 61 76 65 70 6f all open savepo
28450 69 6e 74 73 20 62 65 66 6f 72 65 20 72 65 74 75 ints before retu
28460 72 6e 69 6e 67 2e 0a 2a 2a 0a 2a 2a 20 54 68 69 rning..**.** Thi
28470 73 20 66 75 6e 63 74 69 6f 6e 20 72 65 74 75 72 s function retur
28480 6e 73 20 53 51 4c 49 54 45 5f 4f 4b 20 69 66 20 ns SQLITE_OK if
28490 65 76 65 72 79 74 68 69 6e 67 20 69 73 20 73 75 everything is su
284a0 63 63 65 73 73 66 75 6c 2c 20 61 6e 20 49 4f 0a ccessful, an IO.
284b0 2a 2a 20 65 72 72 6f 72 20 63 6f 64 65 20 69 66 ** error code if
284c0 20 74 68 65 20 61 74 74 65 6d 70 74 20 74 6f 20 the attempt to
284d0 77 72 69 74 65 20 74 6f 20 74 68 65 20 73 75 62 write to the sub
284e0 2d 6a 6f 75 72 6e 61 6c 20 66 61 69 6c 73 2c 20 -journal fails,
284f0 6f 72 20 0a 2a 2a 20 53 51 4c 49 54 45 5f 4e 4f or .** SQLITE_NO
28500 4d 45 4d 20 69 66 20 61 20 6d 61 6c 6c 6f 63 20 MEM if a malloc
28510 66 61 69 6c 73 20 77 68 69 6c 65 20 73 65 74 74 fails while sett
28520 69 6e 67 20 61 20 62 69 74 20 69 6e 20 61 20 73 ing a bit in a s
28530 61 76 65 70 6f 69 6e 74 0a 2a 2a 20 62 69 74 76 avepoint.** bitv
28540 65 63 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e ec..*/.static in
28550 74 20 73 75 62 6a 6f 75 72 6e 61 6c 50 61 67 65 t subjournalPage
28560 28 50 67 48 64 72 20 2a 70 50 67 29 7b 0a 20 20 (PgHdr *pPg){.
28570 69 6e 74 20 72 63 20 3d 20 53 51 4c 49 54 45 5f int rc = SQLITE_
28580 4f 4b 3b 0a 20 20 50 61 67 65 72 20 2a 70 50 61 OK;. Pager *pPa
28590 67 65 72 20 3d 20 70 50 67 2d 3e 70 50 61 67 65 ger = pPg->pPage
285a0 72 3b 0a 20 20 69 66 28 20 70 50 61 67 65 72 2d r;. if( pPager-
285b0 3e 6a 6f 75 72 6e 61 6c 4d 6f 64 65 21 3d 50 41 >journalMode!=PA
285c0 47 45 52 5f 4a 4f 55 52 4e 41 4c 4d 4f 44 45 5f GER_JOURNALMODE_
285d0 4f 46 46 20 29 7b 0a 0a 20 20 20 20 2f 2a 20 4f OFF ){.. /* O
285e0 70 65 6e 20 74 68 65 20 73 75 62 2d 6a 6f 75 72 pen the sub-jour
285f0 6e 61 6c 2c 20 69 66 20 69 74 20 68 61 73 20 6e nal, if it has n
28600 6f 74 20 61 6c 72 65 61 64 79 20 62 65 65 6e 20 ot already been
28610 6f 70 65 6e 65 64 20 2a 2f 0a 20 20 20 20 61 73 opened */. as
28620 73 65 72 74 28 20 70 50 61 67 65 72 2d 3e 75 73 sert( pPager->us
28630 65 4a 6f 75 72 6e 61 6c 20 29 3b 0a 20 20 20 20 eJournal );.
28640 61 73 73 65 72 74 28 20 69 73 4f 70 65 6e 28 70 assert( isOpen(p
28650 50 61 67 65 72 2d 3e 6a 66 64 29 20 7c 7c 20 70 Pager->jfd) || p
28660 61 67 65 72 55 73 65 57 61 6c 28 70 50 61 67 65 agerUseWal(pPage
28670 72 29 20 29 3b 0a 20 20 20 20 61 73 73 65 72 74 r) );. assert
28680 28 20 69 73 4f 70 65 6e 28 70 50 61 67 65 72 2d ( isOpen(pPager-
28690 3e 73 6a 66 64 29 20 7c 7c 20 70 50 61 67 65 72 >sjfd) || pPager
286a0 2d 3e 6e 53 75 62 52 65 63 3d 3d 30 20 29 3b 0a ->nSubRec==0 );.
286b0 20 20 20 20 61 73 73 65 72 74 28 20 70 61 67 65 assert( page
286c0 72 55 73 65 57 61 6c 28 70 50 61 67 65 72 29 20 rUseWal(pPager)
286d0 0a 20 20 20 20 20 20 20 20 20 7c 7c 20 70 61 67 . || pag
286e0 65 49 6e 4a 6f 75 72 6e 61 6c 28 70 50 67 29 20 eInJournal(pPg)
286f0 0a 20 20 20 20 20 20 20 20 20 7c 7c 20 70 50 67 . || pPg
28700 2d 3e 70 67 6e 6f 3e 70 50 61 67 65 72 2d 3e 64 ->pgno>pPager->d
28710 62 4f 72 69 67 53 69 7a 65 20 0a 20 20 20 20 29 bOrigSize . )
28720 3b 0a 20 20 20 20 72 63 20 3d 20 6f 70 65 6e 53 ;. rc = openS
28730 75 62 4a 6f 75 72 6e 61 6c 28 70 50 61 67 65 72 ubJournal(pPager
28740 29 3b 0a 0a 20 20 20 20 2f 2a 20 49 66 20 74 68 );.. /* If th
28750 65 20 73 75 62 2d 6a 6f 75 72 6e 61 6c 20 77 61 e sub-journal wa
28760 73 20 6f 70 65 6e 65 64 20 73 75 63 63 65 73 73 s opened success
28770 66 75 6c 6c 79 20 28 6f 72 20 77 61 73 20 61 6c fully (or was al
28780 72 65 61 64 79 20 6f 70 65 6e 29 2c 0a 20 20 20 ready open),.
28790 20 2a 2a 20 77 72 69 74 65 20 74 68 65 20 6a 6f ** write the jo
287a0 75 72 6e 61 6c 20 72 65 63 6f 72 64 20 69 6e 74 urnal record int
287b0 6f 20 74 68 65 20 66 69 6c 65 2e 20 20 2a 2f 0a o the file. */.
287c0 20 20 20 20 69 66 28 20 72 63 3d 3d 53 51 4c 49 if( rc==SQLI
287d0 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 20 20 76 TE_OK ){. v
287e0 6f 69 64 20 2a 70 44 61 74 61 20 3d 20 70 50 67 oid *pData = pPg
287f0 2d 3e 70 44 61 74 61 3b 0a 20 20 20 20 20 20 69 ->pData;. i
28800 36 34 20 6f 66 66 73 65 74 20 3d 20 70 50 61 67 64 offset = pPag
28810 65 72 2d 3e 6e 53 75 62 52 65 63 2a 28 34 2b 70 er->nSubRec*(4+p
28820 50 61 67 65 72 2d 3e 70 61 67 65 53 69 7a 65 29 Pager->pageSize)
28830 3b 0a 20 20 20 20 20 20 63 68 61 72 20 2a 70 44 ;. char *pD
28840 61 74 61 32 3b 0a 20 20 0a 20 20 20 20 20 20 43 ata2;. . C
28850 4f 44 45 43 32 28 70 50 61 67 65 72 2c 20 70 44 ODEC2(pPager, pD
28860 61 74 61 2c 20 70 50 67 2d 3e 70 67 6e 6f 2c 20 ata, pPg->pgno,
28870 37 2c 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 7, return SQLITE
28880 5f 4e 4f 4d 45 4d 2c 20 70 44 61 74 61 32 29 3b _NOMEM, pData2);
28890 0a 20 20 20 20 20 20 50 41 47 45 52 54 52 41 43 . PAGERTRAC
288a0 45 28 28 22 53 54 4d 54 2d 4a 4f 55 52 4e 41 4c E(("STMT-JOURNAL
288b0 20 25 64 20 70 61 67 65 20 25 64 5c 6e 22 2c 20 %d page %d\n",
288c0 50 41 47 45 52 49 44 28 70 50 61 67 65 72 29 2c PAGERID(pPager),
288d0 20 70 50 67 2d 3e 70 67 6e 6f 29 29 3b 0a 20 20 pPg->pgno));.
288e0 20 20 20 20 72 63 20 3d 20 77 72 69 74 65 33 32 rc = write32
288f0 62 69 74 73 28 70 50 61 67 65 72 2d 3e 73 6a 66 bits(pPager->sjf
28900 64 2c 20 6f 66 66 73 65 74 2c 20 70 50 67 2d 3e d, offset, pPg->
28910 70 67 6e 6f 29 3b 0a 20 20 20 20 20 20 69 66 28 pgno);. if(
28920 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 rc==SQLITE_OK )
28930 7b 0a 20 20 20 20 20 20 20 20 72 63 20 3d 20 73 {. rc = s
28940 71 6c 69 74 65 33 4f 73 57 72 69 74 65 28 70 50 qlite3OsWrite(pP
28950 61 67 65 72 2d 3e 73 6a 66 64 2c 20 70 44 61 74 ager->sjfd, pDat
28960 61 32 2c 20 70 50 61 67 65 72 2d 3e 70 61 67 65 a2, pPager->page
28970 53 69 7a 65 2c 20 6f 66 66 73 65 74 2b 34 29 3b Size, offset+4);
28980 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 7d 0a 20 . }. }.
28990 20 7d 0a 20 20 69 66 28 20 72 63 3d 3d 53 51 4c }. if( rc==SQL
289a0 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 70 50 ITE_OK ){. pP
289b0 61 67 65 72 2d 3e 6e 53 75 62 52 65 63 2b 2b 3b ager->nSubRec++;
289c0 0a 20 20 20 20 61 73 73 65 72 74 28 20 70 50 61 . assert( pPa
289d0 67 65 72 2d 3e 6e 53 61 76 65 70 6f 69 6e 74 3e ger->nSavepoint>
289e0 30 20 29 3b 0a 20 20 20 20 72 63 20 3d 20 61 64 0 );. rc = ad
289f0 64 54 6f 53 61 76 65 70 6f 69 6e 74 42 69 74 76 dToSavepointBitv
28a00 65 63 73 28 70 50 61 67 65 72 2c 20 70 50 67 2d ecs(pPager, pPg-
28a10 3e 70 67 6e 6f 29 3b 0a 20 20 7d 0a 20 20 72 65 >pgno);. }. re
28a20 74 75 72 6e 20 72 63 3b 0a 7d 0a 0a 2f 2a 0a 2a turn rc;.}../*.*
28a30 2a 20 54 68 69 73 20 66 75 6e 63 74 69 6f 6e 20 * This function
28a40 69 73 20 63 61 6c 6c 65 64 20 62 79 20 74 68 65 is called by the
28a50 20 70 63 61 63 68 65 20 6c 61 79 65 72 20 77 68 pcache layer wh
28a60 65 6e 20 69 74 20 68 61 73 20 72 65 61 63 68 65 en it has reache
28a70 64 20 73 6f 6d 65 0a 2a 2a 20 73 6f 66 74 20 6d d some.** soft m
28a80 65 6d 6f 72 79 20 6c 69 6d 69 74 2e 20 54 68 65 emory limit. The
28a90 20 66 69 72 73 74 20 61 72 67 75 6d 65 6e 74 20 first argument
28aa0 69 73 20 61 20 70 6f 69 6e 74 65 72 20 74 6f 20 is a pointer to
28ab0 61 20 50 61 67 65 72 20 6f 62 6a 65 63 74 0a 2a a Pager object.*
28ac0 2a 20 28 63 61 73 74 20 61 73 20 61 20 76 6f 69 * (cast as a voi
28ad0 64 2a 29 2e 20 54 68 65 20 70 61 67 65 72 20 69 d*). The pager i
28ae0 73 20 61 6c 77 61 79 73 20 27 70 75 72 67 65 61 s always 'purgea
28af0 62 6c 65 27 20 28 6e 6f 74 20 61 6e 20 69 6e 2d ble' (not an in-
28b00 6d 65 6d 6f 72 79 0a 2a 2a 20 64 61 74 61 62 61 memory.** databa
28b10 73 65 29 2e 20 54 68 65 20 73 65 63 6f 6e 64 20 se). The second
28b20 61 72 67 75 6d 65 6e 74 20 69 73 20 61 20 72 65 argument is a re
28b30 66 65 72 65 6e 63 65 20 74 6f 20 61 20 70 61 67 ference to a pag
28b40 65 20 74 68 61 74 20 69 73 20 0a 2a 2a 20 63 75 e that is .** cu
28b50 72 72 65 6e 74 6c 79 20 64 69 72 74 79 20 62 75 rrently dirty bu
28b60 74 20 68 61 73 20 6e 6f 20 6f 75 74 73 74 61 6e t has no outstan
28b70 64 69 6e 67 20 72 65 66 65 72 65 6e 63 65 73 2e ding references.
28b80 20 54 68 65 20 70 61 67 65 0a 2a 2a 20 69 73 20 The page.** is
28b90 61 6c 77 61 79 73 20 61 73 73 6f 63 69 61 74 65 always associate
28ba0 64 20 77 69 74 68 20 74 68 65 20 50 61 67 65 72 d with the Pager
28bb0 20 6f 62 6a 65 63 74 20 70 61 73 73 65 64 20 61 object passed a
28bc0 73 20 74 68 65 20 66 69 72 73 74 20 0a 2a 2a 20 s the first .**
28bd0 61 72 67 75 6d 65 6e 74 2e 0a 2a 2a 0a 2a 2a 20 argument..**.**
28be0 54 68 65 20 6a 6f 62 20 6f 66 20 74 68 69 73 20 The job of this
28bf0 66 75 6e 63 74 69 6f 6e 20 69 73 20 74 6f 20 6d function is to m
28c00 61 6b 65 20 70 50 67 20 63 6c 65 61 6e 20 62 79 ake pPg clean by
28c10 20 77 72 69 74 69 6e 67 20 69 74 73 20 63 6f 6e writing its con
28c20 74 65 6e 74 73 0a 2a 2a 20 6f 75 74 20 74 6f 20 tents.** out to
28c30 74 68 65 20 64 61 74 61 62 61 73 65 20 66 69 6c the database fil
28c40 65 2c 20 69 66 20 70 6f 73 73 69 62 6c 65 2e 20 e, if possible.
28c50 54 68 69 73 20 6d 61 79 20 69 6e 76 6f 6c 76 65 This may involve
28c60 20 73 79 6e 63 69 6e 67 20 74 68 65 0a 2a 2a 20 syncing the.**
28c70 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 2e 20 0a 2a journal file. .*
28c80 2a 0a 2a 2a 20 49 66 20 73 75 63 63 65 73 73 66 *.** If successf
28c90 75 6c 2c 20 73 71 6c 69 74 65 33 50 63 61 63 68 ul, sqlite3Pcach
28ca0 65 4d 61 6b 65 43 6c 65 61 6e 28 29 20 69 73 20 eMakeClean() is
28cb0 63 61 6c 6c 65 64 20 6f 6e 20 74 68 65 20 70 61 called on the pa
28cc0 67 65 20 61 6e 64 0a 2a 2a 20 53 51 4c 49 54 45 ge and.** SQLITE
28cd0 5f 4f 4b 20 72 65 74 75 72 6e 65 64 2e 20 49 66 _OK returned. If
28ce0 20 61 6e 20 49 4f 20 65 72 72 6f 72 20 6f 63 63 an IO error occ
28cf0 75 72 73 20 77 68 69 6c 65 20 74 72 79 69 6e 67 urs while trying
28d00 20 74 6f 20 6d 61 6b 65 20 74 68 65 0a 2a 2a 20 to make the.**
28d10 70 61 67 65 20 63 6c 65 61 6e 2c 20 74 68 65 20 page clean, the
28d20 49 4f 20 65 72 72 6f 72 20 63 6f 64 65 20 69 73 IO error code is
28d30 20 72 65 74 75 72 6e 65 64 2e 20 49 66 20 74 68 returned. If th
28d40 65 20 70 61 67 65 20 63 61 6e 6e 6f 74 20 62 65 e page cannot be
28d50 0a 2a 2a 20 6d 61 64 65 20 63 6c 65 61 6e 20 66 .** made clean f
28d60 6f 72 20 73 6f 6d 65 20 6f 74 68 65 72 20 72 65 or some other re
28d70 61 73 6f 6e 2c 20 62 75 74 20 6e 6f 20 65 72 72 ason, but no err
28d80 6f 72 20 6f 63 63 75 72 73 2c 20 74 68 65 6e 20 or occurs, then
28d90 53 51 4c 49 54 45 5f 4f 4b 0a 2a 2a 20 69 73 20 SQLITE_OK.** is
28da0 72 65 74 75 72 6e 65 64 20 62 79 20 73 71 6c 69 returned by sqli
28db0 74 65 33 50 63 61 63 68 65 4d 61 6b 65 43 6c 65 te3PcacheMakeCle
28dc0 61 6e 28 29 20 69 73 20 6e 6f 74 20 63 61 6c 6c an() is not call
28dd0 65 64 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e ed..*/.static in
28de0 74 20 70 61 67 65 72 53 74 72 65 73 73 28 76 6f t pagerStress(vo
28df0 69 64 20 2a 70 2c 20 50 67 48 64 72 20 2a 70 50 id *p, PgHdr *pP
28e00 67 29 7b 0a 20 20 50 61 67 65 72 20 2a 70 50 61 g){. Pager *pPa
28e10 67 65 72 20 3d 20 28 50 61 67 65 72 20 2a 29 70 ger = (Pager *)p
28e20 3b 0a 20 20 69 6e 74 20 72 63 20 3d 20 53 51 4c ;. int rc = SQL
28e30 49 54 45 5f 4f 4b 3b 0a 0a 20 20 61 73 73 65 72 ITE_OK;.. asser
28e40 74 28 20 70 50 67 2d 3e 70 50 61 67 65 72 3d 3d t( pPg->pPager==
28e50 70 50 61 67 65 72 20 29 3b 0a 20 20 61 73 73 65 pPager );. asse
28e60 72 74 28 20 70 50 67 2d 3e 66 6c 61 67 73 26 50 rt( pPg->flags&P
28e70 47 48 44 52 5f 44 49 52 54 59 20 29 3b 0a 0a 20 GHDR_DIRTY );..
28e80 20 2f 2a 20 54 68 65 20 64 6f 4e 6f 74 53 79 6e /* The doNotSyn
28e90 63 53 70 69 6c 6c 20 66 6c 61 67 20 69 73 20 73 cSpill flag is s
28ea0 65 74 20 64 75 72 69 6e 67 20 74 69 6d 65 73 20 et during times
28eb0 77 68 65 6e 20 64 6f 69 6e 67 20 61 20 73 79 6e when doing a syn
28ec0 63 20 6f 66 0a 20 20 2a 2a 20 6a 6f 75 72 6e 61 c of. ** journa
28ed0 6c 20 28 61 6e 64 20 61 64 64 69 6e 67 20 61 20 l (and adding a
28ee0 6e 65 77 20 68 65 61 64 65 72 29 20 69 73 20 6e new header) is n
28ef0 6f 74 20 61 6c 6c 6f 77 65 64 2e 20 20 54 68 69 ot allowed. Thi
28f00 73 20 6f 63 63 75 72 73 0a 20 20 2a 2a 20 64 75 s occurs. ** du
28f10 72 69 6e 67 20 63 61 6c 6c 73 20 74 6f 20 73 71 ring calls to sq
28f20 6c 69 74 65 33 50 61 67 65 72 57 72 69 74 65 28 lite3PagerWrite(
28f30 29 20 77 68 69 6c 65 20 74 72 79 69 6e 67 20 74 ) while trying t
28f40 6f 20 6a 6f 75 72 6e 61 6c 20 6d 75 6c 74 69 70 o journal multip
28f50 6c 65 0a 20 20 2a 2a 20 70 61 67 65 73 20 62 65 le. ** pages be
28f60 6c 6f 6e 67 69 6e 67 20 74 6f 20 74 68 65 20 73 longing to the s
28f70 61 6d 65 20 73 65 63 74 6f 72 2e 0a 20 20 2a 2a ame sector.. **
28f80 0a 20 20 2a 2a 20 54 68 65 20 64 6f 4e 6f 74 53 . ** The doNotS
28f90 70 69 6c 6c 20 66 6c 61 67 20 69 6e 68 69 62 69 pill flag inhibi
28fa0 74 73 20 61 6c 6c 20 63 61 63 68 65 20 73 70 69 ts all cache spi
28fb0 6c 6c 69 6e 67 20 72 65 67 61 72 64 6c 65 73 73 lling regardless
28fc0 20 6f 66 20 77 68 65 74 68 65 72 0a 20 20 2a 2a of whether. **
28fd0 20 6f 72 20 6e 6f 74 20 61 20 73 79 6e 63 20 69 or not a sync i
28fe0 73 20 72 65 71 75 69 72 65 64 2e 20 20 54 68 69 s required. Thi
28ff0 73 20 69 73 20 73 65 74 20 64 75 72 69 6e 67 20 s is set during
29000 61 20 72 6f 6c 6c 62 61 63 6b 2e 0a 20 20 2a 2a a rollback.. **
29010 0a 20 20 2a 2a 20 53 70 69 6c 6c 69 6e 67 20 69 . ** Spilling i
29020 73 20 61 6c 73 6f 20 70 72 6f 68 69 62 69 74 65 s also prohibite
29030 64 20 77 68 65 6e 20 69 6e 20 61 6e 20 65 72 72 d when in an err
29040 6f 72 20 73 74 61 74 65 20 73 69 6e 63 65 20 74 or state since t
29050 68 61 74 20 63 6f 75 6c 64 0a 20 20 2a 2a 20 6c hat could. ** l
29060 65 61 64 20 74 6f 20 64 61 74 61 62 61 73 65 20 ead to database
29070 63 6f 72 72 75 70 74 69 6f 6e 2e 20 20 20 49 6e corruption. In
29080 20 74 68 65 20 63 75 72 72 65 6e 74 20 69 6d 70 the current imp
29090 6c 65 6d 65 6e 74 61 74 6f 6e 20 69 74 20 0a 20 lementaton it .
290a0 20 2a 2a 20 69 73 20 69 6d 70 6f 73 73 69 62 6c ** is impossibl
290b0 65 20 66 6f 72 20 73 71 6c 69 74 65 33 50 43 61 e for sqlite3PCa
290c0 63 68 65 46 65 74 63 68 28 29 20 74 6f 20 62 65 cheFetch() to be
290d0 20 63 61 6c 6c 65 64 20 77 69 74 68 20 63 72 65 called with cre
290e0 61 74 65 46 6c 61 67 3d 3d 31 0a 20 20 2a 2a 20 ateFlag==1. **
290f0 77 68 69 6c 65 20 69 6e 20 74 68 65 20 65 72 72 while in the err
29100 6f 72 20 73 74 61 74 65 2c 20 68 65 6e 63 65 20 or state, hence
29110 69 74 20 69 73 20 69 6d 70 6f 73 73 69 62 6c 65 it is impossible
29120 20 66 6f 72 20 74 68 69 73 20 72 6f 75 74 69 6e for this routin
29130 65 20 74 6f 0a 20 20 2a 2a 20 62 65 20 63 61 6c e to. ** be cal
29140 6c 65 64 20 69 6e 20 74 68 65 20 65 72 72 6f 72 led in the error
29150 20 73 74 61 74 65 2e 20 20 4e 65 76 65 72 74 68 state. Neverth
29160 65 6c 65 73 73 2c 20 77 65 20 69 6e 63 6c 75 64 eless, we includ
29170 65 20 61 20 4e 45 56 45 52 28 29 0a 20 20 2a 2a e a NEVER(). **
29180 20 74 65 73 74 20 66 6f 72 20 74 68 65 20 65 72 test for the er
29190 72 6f 72 20 73 74 61 74 65 20 61 73 20 61 20 73 ror state as a s
291a0 61 66 65 67 75 61 72 64 20 61 67 61 69 6e 73 74 afeguard against
291b0 20 66 75 74 75 72 65 20 63 68 61 6e 67 65 73 2e future changes.
291c0 0a 20 20 2a 2f 0a 20 20 69 66 28 20 4e 45 56 45 . */. if( NEVE
291d0 52 28 70 50 61 67 65 72 2d 3e 65 72 72 43 6f 64 R(pPager->errCod
291e0 65 29 20 29 20 72 65 74 75 72 6e 20 53 51 4c 49 e) ) return SQLI
291f0 54 45 5f 4f 4b 3b 0a 20 20 69 66 28 20 70 50 61 TE_OK;. if( pPa
29200 67 65 72 2d 3e 64 6f 4e 6f 74 53 70 69 6c 6c 20 ger->doNotSpill
29210 29 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f ) return SQLITE_
29220 4f 4b 3b 0a 20 20 69 66 28 20 70 50 61 67 65 72 OK;. if( pPager
29230 2d 3e 64 6f 4e 6f 74 53 79 6e 63 53 70 69 6c 6c ->doNotSyncSpill
29240 20 26 26 20 28 70 50 67 2d 3e 66 6c 61 67 73 20 && (pPg->flags
29250 26 20 50 47 48 44 52 5f 4e 45 45 44 5f 53 59 4e & PGHDR_NEED_SYN
29260 43 29 21 3d 30 20 29 7b 0a 20 20 20 20 72 65 74 C)!=0 ){. ret
29270 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20 urn SQLITE_OK;.
29280 20 7d 0a 0a 20 20 70 50 67 2d 3e 70 44 69 72 74 }.. pPg->pDirt
29290 79 20 3d 20 30 3b 0a 20 20 69 66 28 20 70 61 67 y = 0;. if( pag
292a0 65 72 55 73 65 57 61 6c 28 70 50 61 67 65 72 29 erUseWal(pPager)
292b0 20 29 7b 0a 20 20 20 20 2f 2a 20 57 72 69 74 65 ){. /* Write
292c0 20 61 20 73 69 6e 67 6c 65 20 66 72 61 6d 65 20 a single frame
292d0 66 6f 72 20 74 68 69 73 20 70 61 67 65 20 74 6f for this page to
292e0 20 74 68 65 20 6c 6f 67 2e 20 2a 2f 0a 20 20 20 the log. */.
292f0 20 69 66 28 20 73 75 62 6a 52 65 71 75 69 72 65 if( subjRequire
29300 73 50 61 67 65 28 70 50 67 29 20 29 7b 20 0a 20 sPage(pPg) ){ .
29310 20 20 20 20 20 72 63 20 3d 20 73 75 62 6a 6f 75 rc = subjou
29320 72 6e 61 6c 50 61 67 65 28 70 50 67 29 3b 20 0a rnalPage(pPg); .
29330 20 20 20 20 7d 0a 20 20 20 20 69 66 28 20 72 63 }. if( rc
29340 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 ==SQLITE_OK ){.
29350 20 20 20 20 20 72 63 20 3d 20 70 61 67 65 72 57 rc = pagerW
29360 61 6c 46 72 61 6d 65 73 28 70 50 61 67 65 72 2c alFrames(pPager,
29370 20 70 50 67 2c 20 30 2c 20 30 2c 20 30 29 3b 0a pPg, 0, 0, 0);.
29380 20 20 20 20 7d 0a 20 20 7d 65 6c 73 65 7b 0a 20 }. }else{.
29390 20 0a 20 20 20 20 2f 2a 20 53 79 6e 63 20 74 68 . /* Sync th
293a0 65 20 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 20 69 e journal file i
293b0 66 20 72 65 71 75 69 72 65 64 2e 20 2a 2f 0a 20 f required. */.
293c0 20 20 20 69 66 28 20 70 50 67 2d 3e 66 6c 61 67 if( pPg->flag
293d0 73 26 50 47 48 44 52 5f 4e 45 45 44 5f 53 59 4e s&PGHDR_NEED_SYN
293e0 43 20 0a 20 20 20 20 20 7c 7c 20 70 50 61 67 65 C . || pPage
293f0 72 2d 3e 65 53 74 61 74 65 3d 3d 50 41 47 45 52 r->eState==PAGER
29400 5f 57 52 49 54 45 52 5f 43 41 43 48 45 4d 4f 44 _WRITER_CACHEMOD
29410 0a 20 20 20 20 29 7b 0a 20 20 20 20 20 20 72 63 . ){. rc
29420 20 3d 20 73 79 6e 63 4a 6f 75 72 6e 61 6c 28 70 = syncJournal(p
29430 50 61 67 65 72 2c 20 31 29 3b 0a 20 20 20 20 7d Pager, 1);. }
29440 0a 20 20 0a 20 20 20 20 2f 2a 20 49 66 20 74 68 . . /* If th
29450 65 20 70 61 67 65 20 6e 75 6d 62 65 72 20 6f 66 e page number of
29460 20 74 68 69 73 20 70 61 67 65 20 69 73 20 6c 61 this page is la
29470 72 67 65 72 20 74 68 61 6e 20 74 68 65 20 63 75 rger than the cu
29480 72 72 65 6e 74 20 73 69 7a 65 20 6f 66 0a 20 20 rrent size of.
29490 20 20 2a 2a 20 74 68 65 20 64 61 74 61 62 61 73 ** the databas
294a0 65 20 69 6d 61 67 65 2c 20 69 74 20 6d 61 79 20 e image, it may
294b0 6e 65 65 64 20 74 6f 20 62 65 20 77 72 69 74 74 need to be writt
294c0 65 6e 20 74 6f 20 74 68 65 20 73 75 62 2d 6a 6f en to the sub-jo
294d0 75 72 6e 61 6c 2e 0a 20 20 20 20 2a 2a 20 54 68 urnal.. ** Th
294e0 69 73 20 69 73 20 62 65 63 61 75 73 65 20 74 68 is is because th
294f0 65 20 63 61 6c 6c 20 74 6f 20 70 61 67 65 72 5f e call to pager_
29500 77 72 69 74 65 5f 70 61 67 65 6c 69 73 74 28 29 write_pagelist()
29510 20 62 65 6c 6f 77 20 77 69 6c 6c 20 6e 6f 74 0a below will not.
29520 20 20 20 20 2a 2a 20 61 63 74 75 61 6c 6c 79 20 ** actually
29530 77 72 69 74 65 20 64 61 74 61 20 74 6f 20 74 68 write data to th
29540 65 20 66 69 6c 65 20 69 6e 20 74 68 69 73 20 63 e file in this c
29550 61 73 65 2e 0a 20 20 20 20 2a 2a 0a 20 20 20 20 ase.. **.
29560 2a 2a 20 43 6f 6e 73 69 64 65 72 20 74 68 65 20 ** Consider the
29570 66 6f 6c 6c 6f 77 69 6e 67 20 73 65 71 75 65 6e following sequen
29580 63 65 20 6f 66 20 65 76 65 6e 74 73 3a 0a 20 20 ce of events:.
29590 20 20 2a 2a 0a 20 20 20 20 2a 2a 20 20 20 42 45 **. ** BE
295a0 47 49 4e 3b 0a 20 20 20 20 2a 2a 20 20 20 20 20 GIN;. **
295b0 3c 6a 6f 75 72 6e 61 6c 20 70 61 67 65 20 58 3e <journal page X>
295c0 0a 20 20 20 20 2a 2a 20 20 20 20 20 3c 6d 6f 64 . ** <mod
295d0 69 66 79 20 70 61 67 65 20 58 3e 0a 20 20 20 20 ify page X>.
295e0 2a 2a 20 20 20 20 20 53 41 56 45 50 4f 49 4e 54 ** SAVEPOINT
295f0 20 73 70 3b 0a 20 20 20 20 2a 2a 20 20 20 20 20 sp;. **
29600 20 20 3c 73 68 72 69 6e 6b 20 64 61 74 61 62 61 <shrink databa
29610 73 65 20 66 69 6c 65 20 74 6f 20 59 20 70 61 67 se file to Y pag
29620 65 73 3e 0a 20 20 20 20 2a 2a 20 20 20 20 20 20 es>. **
29630 20 70 61 67 65 72 53 74 72 65 73 73 28 70 61 67 pagerStress(pag
29640 65 20 58 29 0a 20 20 20 20 2a 2a 20 20 20 20 20 e X). **
29650 52 4f 4c 4c 42 41 43 4b 20 54 4f 20 73 70 3b 0a ROLLBACK TO sp;.
29660 20 20 20 20 2a 2a 0a 20 20 20 20 2a 2a 20 49 66 **. ** If
29670 20 28 58 3e 59 29 2c 20 74 68 65 6e 20 77 68 65 (X>Y), then whe
29680 6e 20 70 61 67 65 72 53 74 72 65 73 73 20 69 73 n pagerStress is
29690 20 63 61 6c 6c 65 64 20 70 61 67 65 20 58 20 77 called page X w
296a0 69 6c 6c 20 6e 6f 74 20 62 65 20 77 72 69 74 74 ill not be writt
296b0 65 6e 0a 20 20 20 20 2a 2a 20 6f 75 74 20 74 6f en. ** out to
296c0 20 74 68 65 20 64 61 74 61 62 61 73 65 20 66 69 the database fi
296d0 6c 65 2c 20 62 75 74 20 77 69 6c 6c 20 62 65 20 le, but will be
296e0 64 72 6f 70 70 65 64 20 66 72 6f 6d 20 74 68 65 dropped from the
296f0 20 63 61 63 68 65 2e 20 54 68 65 6e 2c 0a 20 20 cache. Then,.
29700 20 20 2a 2a 20 66 6f 6c 6c 6f 77 69 6e 67 20 74 ** following t
29710 68 65 20 22 52 4f 4c 4c 42 41 43 4b 20 54 4f 20 he "ROLLBACK TO
29720 73 70 22 20 73 74 61 74 65 6d 65 6e 74 2c 20 72 sp" statement, r
29730 65 61 64 69 6e 67 20 70 61 67 65 20 58 20 77 69 eading page X wi
29740 6c 6c 20 72 65 61 64 0a 20 20 20 20 2a 2a 20 64 ll read. ** d
29750 61 74 61 20 66 72 6f 6d 20 74 68 65 20 64 61 74 ata from the dat
29760 61 62 61 73 65 20 66 69 6c 65 2e 20 54 68 69 73 abase file. This
29770 20 77 69 6c 6c 20 62 65 20 74 68 65 20 63 6f 70 will be the cop
29780 79 20 6f 66 20 70 61 67 65 20 58 20 61 73 20 69 y of page X as i
29790 74 0a 20 20 20 20 2a 2a 20 77 61 73 20 77 68 65 t. ** was whe
297a0 6e 20 74 68 65 20 74 72 61 6e 73 61 63 74 69 6f n the transactio
297b0 6e 20 73 74 61 72 74 65 64 2c 20 6e 6f 74 20 61 n started, not a
297c0 73 20 69 74 20 77 61 73 20 77 68 65 6e 20 22 53 s it was when "S
297d0 41 56 45 50 4f 49 4e 54 20 73 70 22 0a 20 20 20 AVEPOINT sp".
297e0 20 2a 2a 20 77 61 73 20 65 78 65 63 75 74 65 64 ** was executed
297f0 2e 0a 20 20 20 20 2a 2a 0a 20 20 20 20 2a 2a 20 .. **. **
29800 54 68 65 20 73 6f 6c 75 74 69 6f 6e 20 69 73 20 The solution is
29810 74 6f 20 77 72 69 74 65 20 74 68 65 20 63 75 72 to write the cur
29820 72 65 6e 74 20 64 61 74 61 20 66 6f 72 20 70 61 rent data for pa
29830 67 65 20 58 20 69 6e 74 6f 20 74 68 65 20 0a 20 ge X into the .
29840 20 20 20 2a 2a 20 73 75 62 2d 6a 6f 75 72 6e 61 ** sub-journa
29850 6c 20 66 69 6c 65 20 6e 6f 77 20 28 69 66 20 69 l file now (if i
29860 74 20 69 73 20 6e 6f 74 20 61 6c 72 65 61 64 79 t is not already
29870 20 74 68 65 72 65 29 2c 20 73 6f 20 74 68 61 74 there), so that
29880 20 69 74 20 77 69 6c 6c 0a 20 20 20 20 2a 2a 20 it will. **
29890 62 65 20 72 65 73 74 6f 72 65 64 20 74 6f 20 69 be restored to i
298a0 74 73 20 63 75 72 72 65 6e 74 20 76 61 6c 75 65 ts current value
298b0 20 77 68 65 6e 20 74 68 65 20 22 52 4f 4c 4c 42 when the "ROLLB
298c0 41 43 4b 20 54 4f 20 73 70 22 20 69 73 20 0a 20 ACK TO sp" is .
298d0 20 20 20 2a 2a 20 65 78 65 63 75 74 65 64 2e 0a ** executed..
298e0 20 20 20 20 2a 2f 0a 20 20 20 20 69 66 28 20 4e */. if( N
298f0 45 56 45 52 28 0a 20 20 20 20 20 20 20 20 72 63 EVER(. rc
29900 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 26 26 20 70 ==SQLITE_OK && p
29910 50 67 2d 3e 70 67 6e 6f 3e 70 50 61 67 65 72 2d Pg->pgno>pPager-
29920 3e 64 62 53 69 7a 65 20 26 26 20 73 75 62 6a 52 >dbSize && subjR
29930 65 71 75 69 72 65 73 50 61 67 65 28 70 50 67 29 equiresPage(pPg)
29940 0a 20 20 20 20 29 20 29 7b 0a 20 20 20 20 20 20 . ) ){.
29950 72 63 20 3d 20 73 75 62 6a 6f 75 72 6e 61 6c 50 rc = subjournalP
29960 61 67 65 28 70 50 67 29 3b 0a 20 20 20 20 7d 0a age(pPg);. }.
29970 20 20 0a 20 20 20 20 2f 2a 20 57 72 69 74 65 20 . /* Write
29980 74 68 65 20 63 6f 6e 74 65 6e 74 73 20 6f 66 20 the contents of
29990 74 68 65 20 70 61 67 65 20 6f 75 74 20 74 6f 20 the page out to
299a0 74 68 65 20 64 61 74 61 62 61 73 65 20 66 69 6c the database fil
299b0 65 2e 20 2a 2f 0a 20 20 20 20 69 66 28 20 72 63 e. */. if( rc
299c0 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 ==SQLITE_OK ){.
299d0 20 20 20 20 20 61 73 73 65 72 74 28 20 28 70 50 assert( (pP
299e0 67 2d 3e 66 6c 61 67 73 26 50 47 48 44 52 5f 4e g->flags&PGHDR_N
299f0 45 45 44 5f 53 59 4e 43 29 3d 3d 30 20 29 3b 0a EED_SYNC)==0 );.
29a00 20 20 20 20 20 20 72 63 20 3d 20 70 61 67 65 72 rc = pager
29a10 5f 77 72 69 74 65 5f 70 61 67 65 6c 69 73 74 28 _write_pagelist(
29a20 70 50 61 67 65 72 2c 20 70 50 67 29 3b 0a 20 20 pPager, pPg);.
29a30 20 20 7d 0a 20 20 7d 0a 0a 20 20 2f 2a 20 4d 61 }. }.. /* Ma
29a40 72 6b 20 74 68 65 20 70 61 67 65 20 61 73 20 63 rk the page as c
29a50 6c 65 61 6e 2e 20 2a 2f 0a 20 20 69 66 28 20 72 lean. */. if( r
29a60 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a c==SQLITE_OK ){.
29a70 20 20 20 20 50 41 47 45 52 54 52 41 43 45 28 28 PAGERTRACE((
29a80 22 53 54 52 45 53 53 20 25 64 20 70 61 67 65 20 "STRESS %d page
29a90 25 64 5c 6e 22 2c 20 50 41 47 45 52 49 44 28 70 %d\n", PAGERID(p
29aa0 50 61 67 65 72 29 2c 20 70 50 67 2d 3e 70 67 6e Pager), pPg->pgn
29ab0 6f 29 29 3b 0a 20 20 20 20 73 71 6c 69 74 65 33 o));. sqlite3
29ac0 50 63 61 63 68 65 4d 61 6b 65 43 6c 65 61 6e 28 PcacheMakeClean(
29ad0 70 50 67 29 3b 0a 20 20 7d 0a 0a 20 20 72 65 74 pPg);. }.. ret
29ae0 75 72 6e 20 70 61 67 65 72 5f 65 72 72 6f 72 28 urn pager_error(
29af0 70 50 61 67 65 72 2c 20 72 63 29 3b 20 0a 7d 0a pPager, rc); .}.
29b00 0a 0a 2f 2a 0a 2a 2a 20 41 6c 6c 6f 63 61 74 65 ../*.** Allocate
29b10 20 61 6e 64 20 69 6e 69 74 69 61 6c 69 7a 65 20 and initialize
29b20 61 20 6e 65 77 20 50 61 67 65 72 20 6f 62 6a 65 a new Pager obje
29b30 63 74 20 61 6e 64 20 70 75 74 20 61 20 70 6f 69 ct and put a poi
29b40 6e 74 65 72 20 74 6f 20 69 74 0a 2a 2a 20 69 6e nter to it.** in
29b50 20 2a 70 70 50 61 67 65 72 2e 20 54 68 65 20 70 *ppPager. The p
29b60 61 67 65 72 20 73 68 6f 75 6c 64 20 65 76 65 6e ager should even
29b70 74 75 61 6c 6c 79 20 62 65 20 66 72 65 65 64 20 tually be freed
29b80 62 79 20 70 61 73 73 69 6e 67 20 69 74 0a 2a 2a by passing it.**
29b90 20 74 6f 20 73 71 6c 69 74 65 33 50 61 67 65 72 to sqlite3Pager
29ba0 43 6c 6f 73 65 28 29 2e 0a 2a 2a 0a 2a 2a 20 54 Close()..**.** T
29bb0 68 65 20 7a 46 69 6c 65 6e 61 6d 65 20 61 72 67 he zFilename arg
29bc0 75 6d 65 6e 74 20 69 73 20 74 68 65 20 70 61 74 ument is the pat
29bd0 68 20 74 6f 20 74 68 65 20 64 61 74 61 62 61 73 h to the databas
29be0 65 20 66 69 6c 65 20 74 6f 20 6f 70 65 6e 2e 0a e file to open..
29bf0 2a 2a 20 49 66 20 7a 46 69 6c 65 6e 61 6d 65 20 ** If zFilename
29c00 69 73 20 4e 55 4c 4c 20 74 68 65 6e 20 61 20 72 is NULL then a r
29c10 61 6e 64 6f 6d 6c 79 2d 6e 61 6d 65 64 20 74 65 andomly-named te
29c20 6d 70 6f 72 61 72 79 20 66 69 6c 65 20 69 73 20 mporary file is
29c30 63 72 65 61 74 65 64 0a 2a 2a 20 61 6e 64 20 75 created.** and u
29c40 73 65 64 20 61 73 20 74 68 65 20 66 69 6c 65 20 sed as the file
29c50 74 6f 20 62 65 20 63 61 63 68 65 64 2e 20 54 65 to be cached. Te
29c60 6d 70 6f 72 61 72 79 20 66 69 6c 65 73 20 61 72 mporary files ar
29c70 65 20 62 65 20 64 65 6c 65 74 65 64 0a 2a 2a 20 e be deleted.**
29c80 61 75 74 6f 6d 61 74 69 63 61 6c 6c 79 20 77 68 automatically wh
29c90 65 6e 20 74 68 65 79 20 61 72 65 20 63 6c 6f 73 en they are clos
29ca0 65 64 2e 20 49 66 20 7a 46 69 6c 65 6e 61 6d 65 ed. If zFilename
29cb0 20 69 73 20 22 3a 6d 65 6d 6f 72 79 3a 22 20 74 is ":memory:" t
29cc0 68 65 6e 20 0a 2a 2a 20 61 6c 6c 20 69 6e 66 6f hen .** all info
29cd0 72 6d 61 74 69 6f 6e 20 69 73 20 68 65 6c 64 20 rmation is held
29ce0 69 6e 20 63 61 63 68 65 2e 20 49 74 20 69 73 20 in cache. It is
29cf0 6e 65 76 65 72 20 77 72 69 74 74 65 6e 20 74 6f never written to
29d00 20 64 69 73 6b 2e 20 0a 2a 2a 20 54 68 69 73 20 disk. .** This
29d10 63 61 6e 20 62 65 20 75 73 65 64 20 74 6f 20 69 can be used to i
29d20 6d 70 6c 65 6d 65 6e 74 20 61 6e 20 69 6e 2d 6d mplement an in-m
29d30 65 6d 6f 72 79 20 64 61 74 61 62 61 73 65 2e 0a emory database..
29d40 2a 2a 0a 2a 2a 20 54 68 65 20 6e 45 78 74 72 61 **.** The nExtra
29d50 20 70 61 72 61 6d 65 74 65 72 20 73 70 65 63 69 parameter speci
29d60 66 69 65 73 20 74 68 65 20 6e 75 6d 62 65 72 20 fies the number
29d70 6f 66 20 62 79 74 65 73 20 6f 66 20 73 70 61 63 of bytes of spac
29d80 65 20 61 6c 6c 6f 63 61 74 65 64 0a 2a 2a 20 61 e allocated.** a
29d90 6c 6f 6e 67 20 77 69 74 68 20 65 61 63 68 20 70 long with each p
29da0 61 67 65 20 72 65 66 65 72 65 6e 63 65 2e 20 54 age reference. T
29db0 68 69 73 20 73 70 61 63 65 20 69 73 20 61 76 61 his space is ava
29dc0 69 6c 61 62 6c 65 20 74 6f 20 74 68 65 20 75 73 ilable to the us
29dd0 65 72 0a 2a 2a 20 76 69 61 20 74 68 65 20 73 71 er.** via the sq
29de0 6c 69 74 65 33 50 61 67 65 72 47 65 74 45 78 74 lite3PagerGetExt
29df0 72 61 28 29 20 41 50 49 2e 0a 2a 2a 0a 2a 2a 20 ra() API..**.**
29e00 54 68 65 20 66 6c 61 67 73 20 61 72 67 75 6d 65 The flags argume
29e10 6e 74 20 69 73 20 75 73 65 64 20 74 6f 20 73 70 nt is used to sp
29e20 65 63 69 66 79 20 70 72 6f 70 65 72 74 69 65 73 ecify properties
29e30 20 74 68 61 74 20 61 66 66 65 63 74 20 74 68 65 that affect the
29e40 0a 2a 2a 20 6f 70 65 72 61 74 69 6f 6e 20 6f 66 .** operation of
29e50 20 74 68 65 20 70 61 67 65 72 2e 20 49 74 20 73 the pager. It s
29e60 68 6f 75 6c 64 20 62 65 20 70 61 73 73 65 64 20 hould be passed
29e70 73 6f 6d 65 20 62 69 74 77 69 73 65 20 63 6f 6d some bitwise com
29e80 62 69 6e 61 74 69 6f 6e 0a 2a 2a 20 6f 66 20 74 bination.** of t
29e90 68 65 20 50 41 47 45 52 5f 4f 4d 49 54 5f 4a 4f he PAGER_OMIT_JO
29ea0 55 52 4e 41 4c 20 61 6e 64 20 50 41 47 45 52 5f URNAL and PAGER_
29eb0 4e 4f 5f 52 45 41 44 4c 4f 43 4b 20 66 6c 61 67 NO_READLOCK flag
29ec0 73 2e 0a 2a 2a 0a 2a 2a 20 54 68 65 20 76 66 73 s..**.** The vfs
29ed0 46 6c 61 67 73 20 70 61 72 61 6d 65 74 65 72 20 Flags parameter
29ee0 69 73 20 61 20 62 69 74 6d 61 73 6b 20 74 6f 20 is a bitmask to
29ef0 70 61 73 73 20 74 6f 20 74 68 65 20 66 6c 61 67 pass to the flag
29f00 73 20 70 61 72 61 6d 65 74 65 72 0a 2a 2a 20 6f s parameter.** o
29f10 66 20 74 68 65 20 78 4f 70 65 6e 28 29 20 6d 65 f the xOpen() me
29f20 74 68 6f 64 20 6f 66 20 74 68 65 20 73 75 70 70 thod of the supp
29f30 6c 69 65 64 20 56 46 53 20 77 68 65 6e 20 6f 70 lied VFS when op
29f40 65 6e 69 6e 67 20 66 69 6c 65 73 2e 20 0a 2a 2a ening files. .**
29f50 0a 2a 2a 20 49 66 20 74 68 65 20 70 61 67 65 72 .** If the pager
29f60 20 6f 62 6a 65 63 74 20 69 73 20 61 6c 6c 6f 63 object is alloc
29f70 61 74 65 64 20 61 6e 64 20 74 68 65 20 73 70 65 ated and the spe
29f80 63 69 66 69 65 64 20 66 69 6c 65 20 6f 70 65 6e cified file open
29f90 65 64 20 0a 2a 2a 20 73 75 63 63 65 73 73 66 75 ed .** successfu
29fa0 6c 6c 79 2c 20 53 51 4c 49 54 45 5f 4f 4b 20 69 lly, SQLITE_OK i
29fb0 73 20 72 65 74 75 72 6e 65 64 20 61 6e 64 20 2a s returned and *
29fc0 70 70 50 61 67 65 72 20 73 65 74 20 74 6f 20 70 ppPager set to p
29fd0 6f 69 6e 74 20 74 6f 0a 2a 2a 20 74 68 65 20 6e oint to.** the n
29fe0 65 77 20 70 61 67 65 72 20 6f 62 6a 65 63 74 2e ew pager object.
29ff0 20 49 66 20 61 6e 20 65 72 72 6f 72 20 6f 63 63 If an error occ
2a000 75 72 73 2c 20 2a 70 70 50 61 67 65 72 20 69 73 urs, *ppPager is
2a010 20 73 65 74 20 74 6f 20 4e 55 4c 4c 0a 2a 2a 20 set to NULL.**
2a020 61 6e 64 20 65 72 72 6f 72 20 63 6f 64 65 20 72 and error code r
2a030 65 74 75 72 6e 65 64 2e 20 54 68 69 73 20 66 75 eturned. This fu
2a040 6e 63 74 69 6f 6e 20 6d 61 79 20 72 65 74 75 72 nction may retur
2a050 6e 20 53 51 4c 49 54 45 5f 4e 4f 4d 45 4d 0a 2a n SQLITE_NOMEM.*
2a060 2a 20 28 73 71 6c 69 74 65 33 4d 61 6c 6c 6f 63 * (sqlite3Malloc
2a070 28 29 20 69 73 20 75 73 65 64 20 74 6f 20 61 6c () is used to al
2a080 6c 6f 63 61 74 65 20 6d 65 6d 6f 72 79 29 2c 20 locate memory),
2a090 53 51 4c 49 54 45 5f 43 41 4e 54 4f 50 45 4e 20 SQLITE_CANTOPEN
2a0a0 6f 72 20 0a 2a 2a 20 76 61 72 69 6f 75 73 20 53 or .** various S
2a0b0 51 4c 49 54 45 5f 49 4f 5f 58 58 58 20 65 72 72 QLITE_IO_XXX err
2a0c0 6f 72 73 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 ors..*/.int sqli
2a0d0 74 65 33 50 61 67 65 72 4f 70 65 6e 28 0a 20 20 te3PagerOpen(.
2a0e0 73 71 6c 69 74 65 33 5f 76 66 73 20 2a 70 56 66 sqlite3_vfs *pVf
2a0f0 73 2c 20 20 20 20 20 20 20 2f 2a 20 54 68 65 20 s, /* The
2a100 76 69 72 74 75 61 6c 20 66 69 6c 65 20 73 79 73 virtual file sys
2a110 74 65 6d 20 74 6f 20 75 73 65 20 2a 2f 0a 20 20 tem to use */.
2a120 50 61 67 65 72 20 2a 2a 70 70 50 61 67 65 72 2c Pager **ppPager,
2a130 20 20 20 20 20 20 20 20 20 2f 2a 20 4f 55 54 3a /* OUT:
2a140 20 52 65 74 75 72 6e 20 74 68 65 20 50 61 67 65 Return the Page
2a150 72 20 73 74 72 75 63 74 75 72 65 20 68 65 72 65 r structure here
2a160 20 2a 2f 0a 20 20 63 6f 6e 73 74 20 63 68 61 72 */. const char
2a170 20 2a 7a 46 69 6c 65 6e 61 6d 65 2c 20 20 20 2f *zFilename, /
2a180 2a 20 4e 61 6d 65 20 6f 66 20 74 68 65 20 64 61 * Name of the da
2a190 74 61 62 61 73 65 20 66 69 6c 65 20 74 6f 20 6f tabase file to o
2a1a0 70 65 6e 20 2a 2f 0a 20 20 69 6e 74 20 6e 45 78 pen */. int nEx
2a1b0 74 72 61 2c 20 20 20 20 20 20 20 20 20 20 20 20 tra,
2a1c0 20 20 2f 2a 20 45 78 74 72 61 20 62 79 74 65 73 /* Extra bytes
2a1d0 20 61 70 70 65 6e 64 20 74 6f 20 65 61 63 68 20 append to each
2a1e0 69 6e 2d 6d 65 6d 6f 72 79 20 70 61 67 65 20 2a in-memory page *
2a1f0 2f 0a 20 20 69 6e 74 20 66 6c 61 67 73 2c 20 20 /. int flags,
2a200 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 /*
2a210 66 6c 61 67 73 20 63 6f 6e 74 72 6f 6c 6c 69 6e flags controllin
2a220 67 20 74 68 69 73 20 66 69 6c 65 20 2a 2f 0a 20 g this file */.
2a230 20 69 6e 74 20 76 66 73 46 6c 61 67 73 2c 20 20 int vfsFlags,
2a240 20 20 20 20 20 20 20 20 20 20 2f 2a 20 66 6c 61 /* fla
2a250 67 73 20 70 61 73 73 65 64 20 74 68 72 6f 75 67 gs passed throug
2a260 68 20 74 6f 20 73 71 6c 69 74 65 33 5f 76 66 73 h to sqlite3_vfs
2a270 2e 78 4f 70 65 6e 28 29 20 2a 2f 0a 20 20 76 6f .xOpen() */. vo
2a280 69 64 20 28 2a 78 52 65 69 6e 69 74 29 28 44 62 id (*xReinit)(Db
2a290 50 61 67 65 2a 29 20 2f 2a 20 46 75 6e 63 74 69 Page*) /* Functi
2a2a0 6f 6e 20 74 6f 20 72 65 69 6e 69 74 69 61 6c 69 on to reinitiali
2a2b0 7a 65 20 70 61 67 65 73 20 2a 2f 0a 29 7b 0a 20 ze pages */.){.
2a2c0 20 75 38 20 2a 70 50 74 72 3b 0a 20 20 50 61 67 u8 *pPtr;. Pag
2a2d0 65 72 20 2a 70 50 61 67 65 72 20 3d 20 30 3b 20 er *pPager = 0;
2a2e0 20 20 20 20 20 20 2f 2a 20 50 61 67 65 72 20 6f /* Pager o
2a2f0 62 6a 65 63 74 20 74 6f 20 61 6c 6c 6f 63 61 74 bject to allocat
2a300 65 20 61 6e 64 20 72 65 74 75 72 6e 20 2a 2f 0a e and return */.
2a310 20 20 69 6e 74 20 72 63 20 3d 20 53 51 4c 49 54 int rc = SQLIT
2a320 45 5f 4f 4b 3b 20 20 20 20 20 20 2f 2a 20 52 65 E_OK; /* Re
2a330 74 75 72 6e 20 63 6f 64 65 20 2a 2f 0a 20 20 69 turn code */. i
2a340 6e 74 20 74 65 6d 70 46 69 6c 65 20 3d 20 30 3b nt tempFile = 0;
2a350 20 20 20 20 20 20 20 20 2f 2a 20 54 72 75 65 20 /* True
2a360 66 6f 72 20 74 65 6d 70 20 66 69 6c 65 73 20 28 for temp files (
2a370 69 6e 63 6c 2e 20 69 6e 2d 6d 65 6d 6f 72 79 20 incl. in-memory
2a380 66 69 6c 65 73 29 20 2a 2f 0a 20 20 69 6e 74 20 files) */. int
2a390 6d 65 6d 44 62 20 3d 20 30 3b 20 20 20 20 20 20 memDb = 0;
2a3a0 20 20 20 20 20 2f 2a 20 54 72 75 65 20 69 66 20 /* True if
2a3b0 74 68 69 73 20 69 73 20 61 6e 20 69 6e 2d 6d 65 this is an in-me
2a3c0 6d 6f 72 79 20 66 69 6c 65 20 2a 2f 0a 20 20 69 mory file */. i
2a3d0 6e 74 20 72 65 61 64 4f 6e 6c 79 20 3d 20 30 3b nt readOnly = 0;
2a3e0 20 20 20 20 20 20 20 20 2f 2a 20 54 72 75 65 20 /* True
2a3f0 69 66 20 74 68 69 73 20 69 73 20 61 20 72 65 61 if this is a rea
2a400 64 2d 6f 6e 6c 79 20 66 69 6c 65 20 2a 2f 0a 20 d-only file */.
2a410 20 69 6e 74 20 6a 6f 75 72 6e 61 6c 46 69 6c 65 int journalFile
2a420 53 69 7a 65 3b 20 20 20 20 20 2f 2a 20 42 79 74 Size; /* Byt
2a430 65 73 20 74 6f 20 61 6c 6c 6f 63 61 74 65 20 66 es to allocate f
2a440 6f 72 20 65 61 63 68 20 6a 6f 75 72 6e 61 6c 20 or each journal
2a450 66 64 20 2a 2f 0a 20 20 63 68 61 72 20 2a 7a 50 fd */. char *zP
2a460 61 74 68 6e 61 6d 65 20 3d 20 30 3b 20 20 20 20 athname = 0;
2a470 20 2f 2a 20 46 75 6c 6c 20 70 61 74 68 20 74 6f /* Full path to
2a480 20 64 61 74 61 62 61 73 65 20 66 69 6c 65 20 2a database file *
2a490 2f 0a 20 20 69 6e 74 20 6e 50 61 74 68 6e 61 6d /. int nPathnam
2a4a0 65 20 3d 20 30 3b 20 20 20 20 20 20 20 2f 2a 20 e = 0; /*
2a4b0 4e 75 6d 62 65 72 20 6f 66 20 62 79 74 65 73 20 Number of bytes
2a4c0 69 6e 20 7a 50 61 74 68 6e 61 6d 65 20 2a 2f 0a in zPathname */.
2a4d0 20 20 69 6e 74 20 75 73 65 4a 6f 75 72 6e 61 6c int useJournal
2a4e0 20 3d 20 28 66 6c 61 67 73 20 26 20 50 41 47 45 = (flags & PAGE
2a4f0 52 5f 4f 4d 49 54 5f 4a 4f 55 52 4e 41 4c 29 3d R_OMIT_JOURNAL)=
2a500 3d 30 3b 20 2f 2a 20 46 61 6c 73 65 20 74 6f 20 =0; /* False to
2a510 6f 6d 69 74 20 6a 6f 75 72 6e 61 6c 20 2a 2f 0a omit journal */.
2a520 20 20 69 6e 74 20 6e 6f 52 65 61 64 6c 6f 63 6b int noReadlock
2a530 20 3d 20 28 66 6c 61 67 73 20 26 20 50 41 47 45 = (flags & PAGE
2a540 52 5f 4e 4f 5f 52 45 41 44 4c 4f 43 4b 29 21 3d R_NO_READLOCK)!=
2a550 30 3b 20 20 2f 2a 20 54 72 75 65 20 74 6f 20 6f 0; /* True to o
2a560 6d 69 74 20 72 65 61 64 2d 6c 6f 63 6b 20 2a 2f mit read-lock */
2a570 0a 20 20 69 6e 74 20 70 63 61 63 68 65 53 69 7a . int pcacheSiz
2a580 65 20 3d 20 73 71 6c 69 74 65 33 50 63 61 63 68 e = sqlite3Pcach
2a590 65 53 69 7a 65 28 29 3b 20 20 20 20 20 20 20 2f eSize(); /
2a5a0 2a 20 42 79 74 65 73 20 74 6f 20 61 6c 6c 6f 63 * Bytes to alloc
2a5b0 61 74 65 20 66 6f 72 20 50 43 61 63 68 65 20 2a ate for PCache *
2a5c0 2f 0a 20 20 75 33 32 20 73 7a 50 61 67 65 44 66 /. u32 szPageDf
2a5d0 6c 74 20 3d 20 53 51 4c 49 54 45 5f 44 45 46 41 lt = SQLITE_DEFA
2a5e0 55 4c 54 5f 50 41 47 45 5f 53 49 5a 45 3b 20 20 ULT_PAGE_SIZE;
2a5f0 2f 2a 20 44 65 66 61 75 6c 74 20 70 61 67 65 20 /* Default page
2a600 73 69 7a 65 20 2a 2f 0a 20 20 63 6f 6e 73 74 20 size */. const
2a610 63 68 61 72 20 2a 7a 55 72 69 20 3d 20 30 3b 20 char *zUri = 0;
2a620 20 20 20 2f 2a 20 55 52 49 20 61 72 67 73 20 74 /* URI args t
2a630 6f 20 63 6f 70 79 20 2a 2f 0a 20 20 69 6e 74 20 o copy */. int
2a640 6e 55 72 69 20 3d 20 30 3b 20 20 20 20 20 20 20 nUri = 0;
2a650 20 20 20 20 20 2f 2a 20 4e 75 6d 62 65 72 20 6f /* Number o
2a660 66 20 62 79 74 65 73 20 6f 66 20 55 52 49 20 61 f bytes of URI a
2a670 72 67 73 20 61 74 20 2a 7a 55 72 69 20 2a 2f 0a rgs at *zUri */.
2a680 0a 20 20 2f 2a 20 46 69 67 75 72 65 20 6f 75 74 . /* Figure out
2a690 20 68 6f 77 20 6d 75 63 68 20 73 70 61 63 65 20 how much space
2a6a0 69 73 20 72 65 71 75 69 72 65 64 20 66 6f 72 20 is required for
2a6b0 65 61 63 68 20 6a 6f 75 72 6e 61 6c 20 66 69 6c each journal fil
2a6c0 65 2d 68 61 6e 64 6c 65 0a 20 20 2a 2a 20 28 74 e-handle. ** (t
2a6d0 68 65 72 65 20 61 72 65 20 74 77 6f 20 6f 66 20 here are two of
2a6e0 74 68 65 6d 2c 20 74 68 65 20 6d 61 69 6e 20 6a them, the main j
2a6f0 6f 75 72 6e 61 6c 20 61 6e 64 20 74 68 65 20 73 ournal and the s
2a700 75 62 2d 6a 6f 75 72 6e 61 6c 29 2e 20 54 68 69 ub-journal). Thi
2a710 73 0a 20 20 2a 2a 20 69 73 20 74 68 65 20 6d 61 s. ** is the ma
2a720 78 69 6d 75 6d 20 73 70 61 63 65 20 72 65 71 75 ximum space requ
2a730 69 72 65 64 20 66 6f 72 20 61 6e 20 69 6e 2d 6d ired for an in-m
2a740 65 6d 6f 72 79 20 6a 6f 75 72 6e 61 6c 20 66 69 emory journal fi
2a750 6c 65 20 68 61 6e 64 6c 65 20 0a 20 20 2a 2a 20 le handle . **
2a760 61 6e 64 20 61 20 72 65 67 75 6c 61 72 20 6a 6f and a regular jo
2a770 75 72 6e 61 6c 20 66 69 6c 65 2d 68 61 6e 64 6c urnal file-handl
2a780 65 2e 20 4e 6f 74 65 20 74 68 61 74 20 61 20 22 e. Note that a "
2a790 72 65 67 75 6c 61 72 20 6a 6f 75 72 6e 61 6c 2d regular journal-
2a7a0 68 61 6e 64 6c 65 22 0a 20 20 2a 2a 20 6d 61 79 handle". ** may
2a7b0 20 62 65 20 61 20 77 72 61 70 70 65 72 20 63 61 be a wrapper ca
2a7c0 70 61 62 6c 65 20 6f 66 20 63 61 63 68 69 6e 67 pable of caching
2a7d0 20 74 68 65 20 66 69 72 73 74 20 70 6f 72 74 69 the first porti
2a7e0 6f 6e 20 6f 66 20 74 68 65 20 6a 6f 75 72 6e 61 on of the journa
2a7f0 6c 0a 20 20 2a 2a 20 66 69 6c 65 20 69 6e 20 6d l. ** file in m
2a800 65 6d 6f 72 79 20 74 6f 20 69 6d 70 6c 65 6d 65 emory to impleme
2a810 6e 74 20 74 68 65 20 61 74 6f 6d 69 63 2d 77 72 nt the atomic-wr
2a820 69 74 65 20 6f 70 74 69 6d 69 7a 61 74 69 6f 6e ite optimization
2a830 20 28 73 65 65 20 0a 20 20 2a 2a 20 73 6f 75 72 (see . ** sour
2a840 63 65 20 66 69 6c 65 20 6a 6f 75 72 6e 61 6c 2e ce file journal.
2a850 63 29 2e 0a 20 20 2a 2f 0a 20 20 69 66 28 20 73 c).. */. if( s
2a860 71 6c 69 74 65 33 4a 6f 75 72 6e 61 6c 53 69 7a qlite3JournalSiz
2a870 65 28 70 56 66 73 29 3e 73 71 6c 69 74 65 33 4d e(pVfs)>sqlite3M
2a880 65 6d 4a 6f 75 72 6e 61 6c 53 69 7a 65 28 29 20 emJournalSize()
2a890 29 7b 0a 20 20 20 20 6a 6f 75 72 6e 61 6c 46 69 ){. journalFi
2a8a0 6c 65 53 69 7a 65 20 3d 20 52 4f 55 4e 44 38 28 leSize = ROUND8(
2a8b0 73 71 6c 69 74 65 33 4a 6f 75 72 6e 61 6c 53 69 sqlite3JournalSi
2a8c0 7a 65 28 70 56 66 73 29 29 3b 0a 20 20 7d 65 6c ze(pVfs));. }el
2a8d0 73 65 7b 0a 20 20 20 20 6a 6f 75 72 6e 61 6c 46 se{. journalF
2a8e0 69 6c 65 53 69 7a 65 20 3d 20 52 4f 55 4e 44 38 ileSize = ROUND8
2a8f0 28 73 71 6c 69 74 65 33 4d 65 6d 4a 6f 75 72 6e (sqlite3MemJourn
2a900 61 6c 53 69 7a 65 28 29 29 3b 0a 20 20 7d 0a 0a alSize());. }..
2a910 20 20 2f 2a 20 53 65 74 20 74 68 65 20 6f 75 74 /* Set the out
2a920 70 75 74 20 76 61 72 69 61 62 6c 65 20 74 6f 20 put variable to
2a930 4e 55 4c 4c 20 69 6e 20 63 61 73 65 20 61 6e 20 NULL in case an
2a940 65 72 72 6f 72 20 6f 63 63 75 72 73 2e 20 2a 2f error occurs. */
2a950 0a 20 20 2a 70 70 50 61 67 65 72 20 3d 20 30 3b . *ppPager = 0;
2a960 0a 0a 23 69 66 6e 64 65 66 20 53 51 4c 49 54 45 ..#ifndef SQLITE
2a970 5f 4f 4d 49 54 5f 4d 45 4d 4f 52 59 44 42 0a 20 _OMIT_MEMORYDB.
2a980 20 69 66 28 20 66 6c 61 67 73 20 26 20 50 41 47 if( flags & PAG
2a990 45 52 5f 4d 45 4d 4f 52 59 20 29 7b 0a 20 20 20 ER_MEMORY ){.
2a9a0 20 6d 65 6d 44 62 20 3d 20 31 3b 0a 20 20 20 20 memDb = 1;.
2a9b0 7a 46 69 6c 65 6e 61 6d 65 20 3d 20 30 3b 0a 20 zFilename = 0;.
2a9c0 20 7d 0a 23 65 6e 64 69 66 0a 0a 20 20 2f 2a 20 }.#endif.. /*
2a9d0 43 6f 6d 70 75 74 65 20 61 6e 64 20 73 74 6f 72 Compute and stor
2a9e0 65 20 74 68 65 20 66 75 6c 6c 20 70 61 74 68 6e e the full pathn
2a9f0 61 6d 65 20 69 6e 20 61 6e 20 61 6c 6c 6f 63 61 ame in an alloca
2aa00 74 65 64 20 62 75 66 66 65 72 20 70 6f 69 6e 74 ted buffer point
2aa10 65 64 0a 20 20 2a 2a 20 74 6f 20 62 79 20 7a 50 ed. ** to by zP
2aa20 61 74 68 6e 61 6d 65 2c 20 6c 65 6e 67 74 68 20 athname, length
2aa30 6e 50 61 74 68 6e 61 6d 65 2e 20 4f 72 2c 20 69 nPathname. Or, i
2aa40 66 20 74 68 69 73 20 69 73 20 61 20 74 65 6d 70 f this is a temp
2aa50 6f 72 61 72 79 20 66 69 6c 65 2c 0a 20 20 2a 2a orary file,. **
2aa60 20 6c 65 61 76 65 20 62 6f 74 68 20 6e 50 61 74 leave both nPat
2aa70 68 6e 61 6d 65 20 61 6e 64 20 7a 50 61 74 68 6e hname and zPathn
2aa80 61 6d 65 20 73 65 74 20 74 6f 20 30 2e 0a 20 20 ame set to 0..
2aa90 2a 2f 0a 20 20 69 66 28 20 7a 46 69 6c 65 6e 61 */. if( zFilena
2aaa0 6d 65 20 26 26 20 7a 46 69 6c 65 6e 61 6d 65 5b me && zFilename[
2aab0 30 5d 20 29 7b 0a 20 20 20 20 63 6f 6e 73 74 20 0] ){. const
2aac0 63 68 61 72 20 2a 7a 3b 0a 20 20 20 20 6e 50 61 char *z;. nPa
2aad0 74 68 6e 61 6d 65 20 3d 20 70 56 66 73 2d 3e 6d thname = pVfs->m
2aae0 78 50 61 74 68 6e 61 6d 65 2b 31 3b 0a 20 20 20 xPathname+1;.
2aaf0 20 7a 50 61 74 68 6e 61 6d 65 20 3d 20 73 71 6c zPathname = sql
2ab00 69 74 65 33 4d 61 6c 6c 6f 63 28 6e 50 61 74 68 ite3Malloc(nPath
2ab10 6e 61 6d 65 2a 32 29 3b 0a 20 20 20 20 69 66 28 name*2);. if(
2ab20 20 7a 50 61 74 68 6e 61 6d 65 3d 3d 30 20 29 7b zPathname==0 ){
2ab30 0a 20 20 20 20 20 20 72 65 74 75 72 6e 20 53 51 . return SQ
2ab40 4c 49 54 45 5f 4e 4f 4d 45 4d 3b 0a 20 20 20 20 LITE_NOMEM;.
2ab50 7d 0a 20 20 20 20 7a 50 61 74 68 6e 61 6d 65 5b }. zPathname[
2ab60 30 5d 20 3d 20 30 3b 20 2f 2a 20 4d 61 6b 65 20 0] = 0; /* Make
2ab70 73 75 72 65 20 69 6e 69 74 69 61 6c 69 7a 65 64 sure initialized
2ab80 20 65 76 65 6e 20 69 66 20 46 75 6c 6c 50 61 74 even if FullPat
2ab90 68 6e 61 6d 65 28 29 20 66 61 69 6c 73 20 2a 2f hname() fails */
2aba0 0a 20 20 20 20 72 63 20 3d 20 73 71 6c 69 74 65 . rc = sqlite
2abb0 33 4f 73 46 75 6c 6c 50 61 74 68 6e 61 6d 65 28 3OsFullPathname(
2abc0 70 56 66 73 2c 20 7a 46 69 6c 65 6e 61 6d 65 2c pVfs, zFilename,
2abd0 20 6e 50 61 74 68 6e 61 6d 65 2c 20 7a 50 61 74 nPathname, zPat
2abe0 68 6e 61 6d 65 29 3b 0a 20 20 20 20 6e 50 61 74 hname);. nPat
2abf0 68 6e 61 6d 65 20 3d 20 73 71 6c 69 74 65 33 53 hname = sqlite3S
2ac00 74 72 6c 65 6e 33 30 28 7a 50 61 74 68 6e 61 6d trlen30(zPathnam
2ac10 65 29 3b 0a 20 20 20 20 7a 20 3d 20 7a 55 72 69 e);. z = zUri
2ac20 20 3d 20 26 7a 46 69 6c 65 6e 61 6d 65 5b 73 71 = &zFilename[sq
2ac30 6c 69 74 65 33 53 74 72 6c 65 6e 33 30 28 7a 46 lite3Strlen30(zF
2ac40 69 6c 65 6e 61 6d 65 29 2b 31 5d 3b 0a 20 20 20 ilename)+1];.
2ac50 20 77 68 69 6c 65 28 20 2a 7a 20 29 7b 0a 20 20 while( *z ){.
2ac60 20 20 20 20 7a 20 2b 3d 20 73 71 6c 69 74 65 33 z += sqlite3
2ac70 53 74 72 6c 65 6e 33 30 28 7a 29 2b 31 3b 0a 20 Strlen30(z)+1;.
2ac80 20 20 20 20 20 7a 20 2b 3d 20 73 71 6c 69 74 65 z += sqlite
2ac90 33 53 74 72 6c 65 6e 33 30 28 7a 29 2b 31 3b 0a 3Strlen30(z)+1;.
2aca0 20 20 20 20 7d 0a 20 20 20 20 6e 55 72 69 20 3d }. nUri =
2acb0 20 26 7a 5b 31 5d 20 2d 20 7a 55 72 69 3b 0a 20 &z[1] - zUri;.
2acc0 20 20 20 69 66 28 20 72 63 3d 3d 53 51 4c 49 54 if( rc==SQLIT
2acd0 45 5f 4f 4b 20 26 26 20 6e 50 61 74 68 6e 61 6d E_OK && nPathnam
2ace0 65 2b 38 3e 70 56 66 73 2d 3e 6d 78 50 61 74 68 e+8>pVfs->mxPath
2acf0 6e 61 6d 65 20 29 7b 0a 20 20 20 20 20 20 2f 2a name ){. /*
2ad00 20 54 68 69 73 20 62 72 61 6e 63 68 20 69 73 20 This branch is
2ad10 74 61 6b 65 6e 20 77 68 65 6e 20 74 68 65 20 6a taken when the j
2ad20 6f 75 72 6e 61 6c 20 70 61 74 68 20 72 65 71 75 ournal path requ
2ad30 69 72 65 64 20 62 79 0a 20 20 20 20 20 20 2a 2a ired by. **
2ad40 20 74 68 65 20 64 61 74 61 62 61 73 65 20 62 65 the database be
2ad50 69 6e 67 20 6f 70 65 6e 65 64 20 77 69 6c 6c 20 ing opened will
2ad60 62 65 20 6d 6f 72 65 20 74 68 61 6e 20 70 56 66 be more than pVf
2ad70 73 2d 3e 6d 78 50 61 74 68 6e 61 6d 65 0a 20 20 s->mxPathname.
2ad80 20 20 20 20 2a 2a 20 62 79 74 65 73 20 69 6e 20 ** bytes in
2ad90 6c 65 6e 67 74 68 2e 20 54 68 69 73 20 6d 65 61 length. This mea
2ada0 6e 73 20 74 68 65 20 64 61 74 61 62 61 73 65 20 ns the database
2adb0 63 61 6e 6e 6f 74 20 62 65 20 6f 70 65 6e 65 64 cannot be opened
2adc0 2c 0a 20 20 20 20 20 20 2a 2a 20 61 73 20 69 74 ,. ** as it
2add0 20 77 69 6c 6c 20 6e 6f 74 20 62 65 20 70 6f 73 will not be pos
2ade0 73 69 62 6c 65 20 74 6f 20 6f 70 65 6e 20 74 68 sible to open th
2adf0 65 20 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 20 6f e journal file o
2ae00 72 20 65 76 65 6e 0a 20 20 20 20 20 20 2a 2a 20 r even. **
2ae10 63 68 65 63 6b 20 66 6f 72 20 61 20 68 6f 74 2d check for a hot-
2ae20 6a 6f 75 72 6e 61 6c 20 62 65 66 6f 72 65 20 72 journal before r
2ae30 65 61 64 69 6e 67 2e 0a 20 20 20 20 20 20 2a 2f eading.. */
2ae40 0a 20 20 20 20 20 20 72 63 20 3d 20 53 51 4c 49 . rc = SQLI
2ae50 54 45 5f 43 41 4e 54 4f 50 45 4e 5f 42 4b 50 54 TE_CANTOPEN_BKPT
2ae60 3b 0a 20 20 20 20 7d 0a 20 20 20 20 69 66 28 20 ;. }. if(
2ae70 72 63 21 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b rc!=SQLITE_OK ){
2ae80 0a 20 20 20 20 20 20 73 71 6c 69 74 65 33 5f 66 . sqlite3_f
2ae90 72 65 65 28 7a 50 61 74 68 6e 61 6d 65 29 3b 0a ree(zPathname);.
2aea0 20 20 20 20 20 20 72 65 74 75 72 6e 20 72 63 3b return rc;
2aeb0 0a 20 20 20 20 7d 0a 20 20 7d 0a 0a 20 20 2f 2a . }. }.. /*
2aec0 20 41 6c 6c 6f 63 61 74 65 20 6d 65 6d 6f 72 79 Allocate memory
2aed0 20 66 6f 72 20 74 68 65 20 50 61 67 65 72 20 73 for the Pager s
2aee0 74 72 75 63 74 75 72 65 2c 20 50 43 61 63 68 65 tructure, PCache
2aef0 20 6f 62 6a 65 63 74 2c 20 74 68 65 0a 20 20 2a object, the. *
2af00 2a 20 74 68 72 65 65 20 66 69 6c 65 20 64 65 73 * three file des
2af10 63 72 69 70 74 6f 72 73 2c 20 74 68 65 20 64 61 criptors, the da
2af20 74 61 62 61 73 65 20 66 69 6c 65 20 6e 61 6d 65 tabase file name
2af30 20 61 6e 64 20 74 68 65 20 6a 6f 75 72 6e 61 6c and the journal
2af40 20 0a 20 20 2a 2a 20 66 69 6c 65 20 6e 61 6d 65 . ** file name
2af50 2e 20 54 68 65 20 6c 61 79 6f 75 74 20 69 6e 20 . The layout in
2af60 6d 65 6d 6f 72 79 20 69 73 20 61 73 20 66 6f 6c memory is as fol
2af70 6c 6f 77 73 3a 0a 20 20 2a 2a 0a 20 20 2a 2a 20 lows:. **. **
2af80 20 20 20 20 50 61 67 65 72 20 6f 62 6a 65 63 74 Pager object
2af90 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
2afa0 20 20 20 20 28 73 69 7a 65 6f 66 28 50 61 67 65 (sizeof(Page
2afb0 72 29 20 62 79 74 65 73 29 0a 20 20 2a 2a 20 20 r) bytes). **
2afc0 20 20 20 50 43 61 63 68 65 20 6f 62 6a 65 63 74 PCache object
2afd0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
2afe0 20 20 20 28 73 71 6c 69 74 65 33 50 63 61 63 68 (sqlite3Pcach
2aff0 65 53 69 7a 65 28 29 20 62 79 74 65 73 29 0a 20 eSize() bytes).
2b000 20 2a 2a 20 20 20 20 20 44 61 74 61 62 61 73 65 ** Database
2b010 20 66 69 6c 65 20 68 61 6e 64 6c 65 20 20 20 20 file handle
2b020 20 20 20 20 20 20 20 20 28 70 56 66 73 2d 3e 73 (pVfs->s
2b030 7a 4f 73 46 69 6c 65 20 62 79 74 65 73 29 0a 20 zOsFile bytes).
2b040 20 2a 2a 20 20 20 20 20 53 75 62 2d 6a 6f 75 72 ** Sub-jour
2b050 6e 61 6c 20 66 69 6c 65 20 68 61 6e 64 6c 65 20 nal file handle
2b060 20 20 20 20 20 20 20 20 28 6a 6f 75 72 6e 61 6c (journal
2b070 46 69 6c 65 53 69 7a 65 20 62 79 74 65 73 29 0a FileSize bytes).
2b080 20 20 2a 2a 20 20 20 20 20 4d 61 69 6e 20 6a 6f ** Main jo
2b090 75 72 6e 61 6c 20 66 69 6c 65 20 68 61 6e 64 6c urnal file handl
2b0a0 65 20 20 20 20 20 20 20 20 28 6a 6f 75 72 6e 61 e (journa
2b0b0 6c 46 69 6c 65 53 69 7a 65 20 62 79 74 65 73 29 lFileSize bytes)
2b0c0 0a 20 20 2a 2a 20 20 20 20 20 44 61 74 61 62 61 . ** Databa
2b0d0 73 65 20 66 69 6c 65 20 6e 61 6d 65 20 20 20 20 se file name
2b0e0 20 20 20 20 20 20 20 20 20 20 28 6e 50 61 74 68 (nPath
2b0f0 6e 61 6d 65 2b 31 20 62 79 74 65 73 29 0a 20 20 name+1 bytes).
2b100 2a 2a 20 20 20 20 20 4a 6f 75 72 6e 61 6c 20 66 ** Journal f
2b110 69 6c 65 20 6e 61 6d 65 20 20 20 20 20 20 20 20 ile name
2b120 20 20 20 20 20 20 20 28 6e 50 61 74 68 6e 61 6d (nPathnam
2b130 65 2b 38 2b 31 20 62 79 74 65 73 29 0a 20 20 2a e+8+1 bytes). *
2b140 2f 0a 20 20 70 50 74 72 20 3d 20 28 75 38 20 2a /. pPtr = (u8 *
2b150 29 73 71 6c 69 74 65 33 4d 61 6c 6c 6f 63 5a 65 )sqlite3MallocZe
2b160 72 6f 28 0a 20 20 20 20 52 4f 55 4e 44 38 28 73 ro(. ROUND8(s
2b170 69 7a 65 6f 66 28 2a 70 50 61 67 65 72 29 29 20 izeof(*pPager))
2b180 2b 20 20 20 20 20 20 2f 2a 20 50 61 67 65 72 20 + /* Pager
2b190 73 74 72 75 63 74 75 72 65 20 2a 2f 0a 20 20 20 structure */.
2b1a0 20 52 4f 55 4e 44 38 28 70 63 61 63 68 65 53 69 ROUND8(pcacheSi
2b1b0 7a 65 29 20 2b 20 20 20 20 20 20 20 20 20 20 20 ze) +
2b1c0 2f 2a 20 50 43 61 63 68 65 20 6f 62 6a 65 63 74 /* PCache object
2b1d0 20 2a 2f 0a 20 20 20 20 52 4f 55 4e 44 38 28 70 */. ROUND8(p
2b1e0 56 66 73 2d 3e 73 7a 4f 73 46 69 6c 65 29 20 2b Vfs->szOsFile) +
2b1f0 20 20 20 20 20 20 20 2f 2a 20 54 68 65 20 6d 61 /* The ma
2b200 69 6e 20 64 62 20 66 69 6c 65 20 2a 2f 0a 20 20 in db file */.
2b210 20 20 6a 6f 75 72 6e 61 6c 46 69 6c 65 53 69 7a journalFileSiz
2b220 65 20 2a 20 32 20 2b 20 20 20 20 20 20 20 20 20 e * 2 +
2b230 20 2f 2a 20 54 68 65 20 74 77 6f 20 6a 6f 75 72 /* The two jour
2b240 6e 61 6c 20 66 69 6c 65 73 20 2a 2f 20 0a 20 20 nal files */ .
2b250 20 20 6e 50 61 74 68 6e 61 6d 65 20 2b 20 31 20 nPathname + 1
2b260 2b 20 6e 55 72 69 20 2b 20 20 20 20 20 20 20 20 + nUri +
2b270 20 2f 2a 20 7a 46 69 6c 65 6e 61 6d 65 20 2a 2f /* zFilename */
2b280 0a 20 20 20 20 6e 50 61 74 68 6e 61 6d 65 20 2b . nPathname +
2b290 20 38 20 2b 20 31 20 20 20 20 20 20 20 20 20 20 8 + 1
2b2a0 20 20 20 20 2f 2a 20 7a 4a 6f 75 72 6e 61 6c 20 /* zJournal
2b2b0 2a 2f 0a 23 69 66 6e 64 65 66 20 53 51 4c 49 54 */.#ifndef SQLIT
2b2c0 45 5f 4f 4d 49 54 5f 57 41 4c 0a 20 20 20 20 2b E_OMIT_WAL. +
2b2d0 20 6e 50 61 74 68 6e 61 6d 65 20 2b 20 34 20 2b nPathname + 4 +
2b2e0 20 31 20 20 20 20 20 20 20 20 20 20 20 20 20 20 1
2b2f0 2f 2a 20 7a 57 61 6c 20 2a 2f 0a 23 65 6e 64 69 /* zWal */.#endi
2b300 66 0a 20 20 29 3b 0a 20 20 61 73 73 65 72 74 28 f. );. assert(
2b310 20 45 49 47 48 54 5f 42 59 54 45 5f 41 4c 49 47 EIGHT_BYTE_ALIG
2b320 4e 4d 45 4e 54 28 53 51 4c 49 54 45 5f 49 4e 54 NMENT(SQLITE_INT
2b330 5f 54 4f 5f 50 54 52 28 6a 6f 75 72 6e 61 6c 46 _TO_PTR(journalF
2b340 69 6c 65 53 69 7a 65 29 29 20 29 3b 0a 20 20 69 ileSize)) );. i
2b350 66 28 20 21 70 50 74 72 20 29 7b 0a 20 20 20 20 f( !pPtr ){.
2b360 73 71 6c 69 74 65 33 5f 66 72 65 65 28 7a 50 61 sqlite3_free(zPa
2b370 74 68 6e 61 6d 65 29 3b 0a 20 20 20 20 72 65 74 thname);. ret
2b380 75 72 6e 20 53 51 4c 49 54 45 5f 4e 4f 4d 45 4d urn SQLITE_NOMEM
2b390 3b 0a 20 20 7d 0a 20 20 70 50 61 67 65 72 20 3d ;. }. pPager =
2b3a0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 50 (P
2b3b0 61 67 65 72 2a 29 28 70 50 74 72 29 3b 0a 20 20 ager*)(pPtr);.
2b3c0 70 50 61 67 65 72 2d 3e 70 50 43 61 63 68 65 20 pPager->pPCache
2b3d0 3d 20 20 20 20 28 50 43 61 63 68 65 2a 29 28 70 = (PCache*)(p
2b3e0 50 74 72 20 2b 3d 20 52 4f 55 4e 44 38 28 73 69 Ptr += ROUND8(si
2b3f0 7a 65 6f 66 28 2a 70 50 61 67 65 72 29 29 29 3b zeof(*pPager)));
2b400 0a 20 20 70 50 61 67 65 72 2d 3e 66 64 20 3d 20 . pPager->fd =
2b410 20 20 28 73 71 6c 69 74 65 33 5f 66 69 6c 65 2a (sqlite3_file*
2b420 29 28 70 50 74 72 20 2b 3d 20 52 4f 55 4e 44 38 )(pPtr += ROUND8
2b430 28 70 63 61 63 68 65 53 69 7a 65 29 29 3b 0a 20 (pcacheSize));.
2b440 20 70 50 61 67 65 72 2d 3e 73 6a 66 64 20 3d 20 pPager->sjfd =
2b450 28 73 71 6c 69 74 65 33 5f 66 69 6c 65 2a 29 28 (sqlite3_file*)(
2b460 70 50 74 72 20 2b 3d 20 52 4f 55 4e 44 38 28 70 pPtr += ROUND8(p
2b470 56 66 73 2d 3e 73 7a 4f 73 46 69 6c 65 29 29 3b Vfs->szOsFile));
2b480 0a 20 20 70 50 61 67 65 72 2d 3e 6a 66 64 20 3d . pPager->jfd =
2b490 20 20 28 73 71 6c 69 74 65 33 5f 66 69 6c 65 2a (sqlite3_file*
2b4a0 29 28 70 50 74 72 20 2b 3d 20 6a 6f 75 72 6e 61 )(pPtr += journa
2b4b0 6c 46 69 6c 65 53 69 7a 65 29 3b 0a 20 20 70 50 lFileSize);. pP
2b4c0 61 67 65 72 2d 3e 7a 46 69 6c 65 6e 61 6d 65 20 ager->zFilename
2b4d0 3d 20 20 20 20 28 63 68 61 72 2a 29 28 70 50 74 = (char*)(pPt
2b4e0 72 20 2b 3d 20 6a 6f 75 72 6e 61 6c 46 69 6c 65 r += journalFile
2b4f0 53 69 7a 65 29 3b 0a 20 20 61 73 73 65 72 74 28 Size);. assert(
2b500 20 45 49 47 48 54 5f 42 59 54 45 5f 41 4c 49 47 EIGHT_BYTE_ALIG
2b510 4e 4d 45 4e 54 28 70 50 61 67 65 72 2d 3e 6a 66 NMENT(pPager->jf
2b520 64 29 20 29 3b 0a 0a 20 20 2f 2a 20 46 69 6c 6c d) );.. /* Fill
2b530 20 69 6e 20 74 68 65 20 50 61 67 65 72 2e 7a 46 in the Pager.zF
2b540 69 6c 65 6e 61 6d 65 20 61 6e 64 20 50 61 67 65 ilename and Page
2b550 72 2e 7a 4a 6f 75 72 6e 61 6c 20 62 75 66 66 65 r.zJournal buffe
2b560 72 73 2c 20 69 66 20 72 65 71 75 69 72 65 64 2e rs, if required.
2b570 20 2a 2f 0a 20 20 69 66 28 20 7a 50 61 74 68 6e */. if( zPathn
2b580 61 6d 65 20 29 7b 0a 20 20 20 20 61 73 73 65 72 ame ){. asser
2b590 74 28 20 6e 50 61 74 68 6e 61 6d 65 3e 30 20 29 t( nPathname>0 )
2b5a0 3b 0a 20 20 20 20 70 50 61 67 65 72 2d 3e 7a 4a ;. pPager->zJ
2b5b0 6f 75 72 6e 61 6c 20 3d 20 20 20 28 63 68 61 72 ournal = (char
2b5c0 2a 29 28 70 50 74 72 20 2b 3d 20 6e 50 61 74 68 *)(pPtr += nPath
2b5d0 6e 61 6d 65 20 2b 20 31 20 2b 20 6e 55 72 69 29 name + 1 + nUri)
2b5e0 3b 0a 20 20 20 20 6d 65 6d 63 70 79 28 70 50 61 ;. memcpy(pPa
2b5f0 67 65 72 2d 3e 7a 46 69 6c 65 6e 61 6d 65 2c 20 ger->zFilename,
2b600 7a 50 61 74 68 6e 61 6d 65 2c 20 6e 50 61 74 68 zPathname, nPath
2b610 6e 61 6d 65 29 3b 0a 20 20 20 20 6d 65 6d 63 70 name);. memcp
2b620 79 28 26 70 50 61 67 65 72 2d 3e 7a 46 69 6c 65 y(&pPager->zFile
2b630 6e 61 6d 65 5b 6e 50 61 74 68 6e 61 6d 65 2b 31 name[nPathname+1
2b640 5d 2c 20 7a 55 72 69 2c 20 6e 55 72 69 29 3b 0a ], zUri, nUri);.
2b650 20 20 20 20 6d 65 6d 63 70 79 28 70 50 61 67 65 memcpy(pPage
2b660 72 2d 3e 7a 4a 6f 75 72 6e 61 6c 2c 20 7a 50 61 r->zJournal, zPa
2b670 74 68 6e 61 6d 65 2c 20 6e 50 61 74 68 6e 61 6d thname, nPathnam
2b680 65 29 3b 0a 20 20 20 20 6d 65 6d 63 70 79 28 26 e);. memcpy(&
2b690 70 50 61 67 65 72 2d 3e 7a 4a 6f 75 72 6e 61 6c pPager->zJournal
2b6a0 5b 6e 50 61 74 68 6e 61 6d 65 5d 2c 20 22 2d 6a [nPathname], "-j
2b6b0 6f 75 72 6e 61 6c 22 2c 20 38 29 3b 0a 20 20 20 ournal", 8);.
2b6c0 20 73 71 6c 69 74 65 33 46 69 6c 65 53 75 66 66 sqlite3FileSuff
2b6d0 69 78 33 28 70 50 61 67 65 72 2d 3e 7a 46 69 6c ix3(pPager->zFil
2b6e0 65 6e 61 6d 65 2c 20 70 50 61 67 65 72 2d 3e 7a ename, pPager->z
2b6f0 4a 6f 75 72 6e 61 6c 29 3b 0a 23 69 66 6e 64 65 Journal);.#ifnde
2b700 66 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 57 41 f SQLITE_OMIT_WA
2b710 4c 0a 20 20 20 20 70 50 61 67 65 72 2d 3e 7a 57 L. pPager->zW
2b720 61 6c 20 3d 20 26 70 50 61 67 65 72 2d 3e 7a 4a al = &pPager->zJ
2b730 6f 75 72 6e 61 6c 5b 6e 50 61 74 68 6e 61 6d 65 ournal[nPathname
2b740 2b 38 2b 31 5d 3b 0a 20 20 20 20 6d 65 6d 63 70 +8+1];. memcp
2b750 79 28 70 50 61 67 65 72 2d 3e 7a 57 61 6c 2c 20 y(pPager->zWal,
2b760 7a 50 61 74 68 6e 61 6d 65 2c 20 6e 50 61 74 68 zPathname, nPath
2b770 6e 61 6d 65 29 3b 0a 20 20 20 20 6d 65 6d 63 70 name);. memcp
2b780 79 28 26 70 50 61 67 65 72 2d 3e 7a 57 61 6c 5b y(&pPager->zWal[
2b790 6e 50 61 74 68 6e 61 6d 65 5d 2c 20 22 2d 77 61 nPathname], "-wa
2b7a0 6c 22 2c 20 34 29 3b 0a 20 20 20 20 73 71 6c 69 l", 4);. sqli
2b7b0 74 65 33 46 69 6c 65 53 75 66 66 69 78 33 28 70 te3FileSuffix3(p
2b7c0 50 61 67 65 72 2d 3e 7a 46 69 6c 65 6e 61 6d 65 Pager->zFilename
2b7d0 2c 20 70 50 61 67 65 72 2d 3e 7a 57 61 6c 29 3b , pPager->zWal);
2b7e0 0a 23 65 6e 64 69 66 0a 20 20 20 20 73 71 6c 69 .#endif. sqli
2b7f0 74 65 33 5f 66 72 65 65 28 7a 50 61 74 68 6e 61 te3_free(zPathna
2b800 6d 65 29 3b 0a 20 20 7d 0a 20 20 70 50 61 67 65 me);. }. pPage
2b810 72 2d 3e 70 56 66 73 20 3d 20 70 56 66 73 3b 0a r->pVfs = pVfs;.
2b820 20 20 70 50 61 67 65 72 2d 3e 76 66 73 46 6c 61 pPager->vfsFla
2b830 67 73 20 3d 20 76 66 73 46 6c 61 67 73 3b 0a 0a gs = vfsFlags;..
2b840 20 20 2f 2a 20 4f 70 65 6e 20 74 68 65 20 70 61 /* Open the pa
2b850 67 65 72 20 66 69 6c 65 2e 0a 20 20 2a 2f 0a 20 ger file.. */.
2b860 20 69 66 28 20 7a 46 69 6c 65 6e 61 6d 65 20 26 if( zFilename &
2b870 26 20 7a 46 69 6c 65 6e 61 6d 65 5b 30 5d 20 29 & zFilename[0] )
2b880 7b 0a 20 20 20 20 69 6e 74 20 66 6f 75 74 20 3d {. int fout =
2b890 20 30 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 0;
2b8a0 20 20 20 20 20 20 20 2f 2a 20 56 46 53 20 66 6c /* VFS fl
2b8b0 61 67 73 20 72 65 74 75 72 6e 65 64 20 62 79 20 ags returned by
2b8c0 78 4f 70 65 6e 28 29 20 2a 2f 0a 20 20 20 20 72 xOpen() */. r
2b8d0 63 20 3d 20 73 71 6c 69 74 65 33 4f 73 4f 70 65 c = sqlite3OsOpe
2b8e0 6e 28 70 56 66 73 2c 20 70 50 61 67 65 72 2d 3e n(pVfs, pPager->
2b8f0 7a 46 69 6c 65 6e 61 6d 65 2c 20 70 50 61 67 65 zFilename, pPage
2b900 72 2d 3e 66 64 2c 20 76 66 73 46 6c 61 67 73 2c r->fd, vfsFlags,
2b910 20 26 66 6f 75 74 29 3b 0a 20 20 20 20 61 73 73 &fout);. ass
2b920 65 72 74 28 20 21 6d 65 6d 44 62 20 29 3b 0a 20 ert( !memDb );.
2b930 20 20 20 72 65 61 64 4f 6e 6c 79 20 3d 20 28 66 readOnly = (f
2b940 6f 75 74 26 53 51 4c 49 54 45 5f 4f 50 45 4e 5f out&SQLITE_OPEN_
2b950 52 45 41 44 4f 4e 4c 59 29 3b 0a 0a 20 20 20 20 READONLY);..
2b960 2f 2a 20 49 66 20 74 68 65 20 66 69 6c 65 20 77 /* If the file w
2b970 61 73 20 73 75 63 63 65 73 73 66 75 6c 6c 79 20 as successfully
2b980 6f 70 65 6e 65 64 20 66 6f 72 20 72 65 61 64 2f opened for read/
2b990 77 72 69 74 65 20 61 63 63 65 73 73 2c 0a 20 20 write access,.
2b9a0 20 20 2a 2a 20 63 68 6f 6f 73 65 20 61 20 64 65 ** choose a de
2b9b0 66 61 75 6c 74 20 70 61 67 65 20 73 69 7a 65 20 fault page size
2b9c0 69 6e 20 63 61 73 65 20 77 65 20 68 61 76 65 20 in case we have
2b9d0 74 6f 20 63 72 65 61 74 65 20 74 68 65 0a 20 20 to create the.
2b9e0 20 20 2a 2a 20 64 61 74 61 62 61 73 65 20 66 69 ** database fi
2b9f0 6c 65 2e 20 54 68 65 20 64 65 66 61 75 6c 74 20 le. The default
2ba00 70 61 67 65 20 73 69 7a 65 20 69 73 20 74 68 65 page size is the
2ba10 20 6d 61 78 69 6d 75 6d 20 6f 66 3a 0a 20 20 20 maximum of:.
2ba20 20 2a 2a 0a 20 20 20 20 2a 2a 20 20 20 20 2b 20 **. ** +
2ba30 53 51 4c 49 54 45 5f 44 45 46 41 55 4c 54 5f 50 SQLITE_DEFAULT_P
2ba40 41 47 45 5f 53 49 5a 45 2c 0a 20 20 20 20 2a 2a AGE_SIZE,. **
2ba50 20 20 20 20 2b 20 54 68 65 20 76 61 6c 75 65 20 + The value
2ba60 72 65 74 75 72 6e 65 64 20 62 79 20 73 71 6c 69 returned by sqli
2ba70 74 65 33 4f 73 53 65 63 74 6f 72 53 69 7a 65 28 te3OsSectorSize(
2ba80 29 0a 20 20 20 20 2a 2a 20 20 20 20 2b 20 54 68 ). ** + Th
2ba90 65 20 6c 61 72 67 65 73 74 20 70 61 67 65 20 73 e largest page s
2baa0 69 7a 65 20 74 68 61 74 20 63 61 6e 20 62 65 20 ize that can be
2bab0 77 72 69 74 74 65 6e 20 61 74 6f 6d 69 63 61 6c written atomical
2bac0 6c 79 2e 0a 20 20 20 20 2a 2f 0a 20 20 20 20 69 ly.. */. i
2bad0 66 28 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b f( rc==SQLITE_OK
2bae0 20 26 26 20 21 72 65 61 64 4f 6e 6c 79 20 29 7b && !readOnly ){
2baf0 0a 20 20 20 20 20 20 73 65 74 53 65 63 74 6f 72 . setSector
2bb00 53 69 7a 65 28 70 50 61 67 65 72 29 3b 0a 20 20 Size(pPager);.
2bb10 20 20 20 20 61 73 73 65 72 74 28 53 51 4c 49 54 assert(SQLIT
2bb20 45 5f 44 45 46 41 55 4c 54 5f 50 41 47 45 5f 53 E_DEFAULT_PAGE_S
2bb30 49 5a 45 3c 3d 53 51 4c 49 54 45 5f 4d 41 58 5f IZE<=SQLITE_MAX_
2bb40 44 45 46 41 55 4c 54 5f 50 41 47 45 5f 53 49 5a DEFAULT_PAGE_SIZ
2bb50 45 29 3b 0a 20 20 20 20 20 20 69 66 28 20 73 7a E);. if( sz
2bb60 50 61 67 65 44 66 6c 74 3c 70 50 61 67 65 72 2d PageDflt<pPager-
2bb70 3e 73 65 63 74 6f 72 53 69 7a 65 20 29 7b 0a 20 >sectorSize ){.
2bb80 20 20 20 20 20 20 20 69 66 28 20 70 50 61 67 65 if( pPage
2bb90 72 2d 3e 73 65 63 74 6f 72 53 69 7a 65 3e 53 51 r->sectorSize>SQ
2bba0 4c 49 54 45 5f 4d 41 58 5f 44 45 46 41 55 4c 54 LITE_MAX_DEFAULT
2bbb0 5f 50 41 47 45 5f 53 49 5a 45 20 29 7b 0a 20 20 _PAGE_SIZE ){.
2bbc0 20 20 20 20 20 20 20 20 73 7a 50 61 67 65 44 66 szPageDf
2bbd0 6c 74 20 3d 20 53 51 4c 49 54 45 5f 4d 41 58 5f lt = SQLITE_MAX_
2bbe0 44 45 46 41 55 4c 54 5f 50 41 47 45 5f 53 49 5a DEFAULT_PAGE_SIZ
2bbf0 45 3b 0a 20 20 20 20 20 20 20 20 7d 65 6c 73 65 E;. }else
2bc00 7b 0a 20 20 20 20 20 20 20 20 20 20 73 7a 50 61 {. szPa
2bc10 67 65 44 66 6c 74 20 3d 20 28 75 33 32 29 70 50 geDflt = (u32)pP
2bc20 61 67 65 72 2d 3e 73 65 63 74 6f 72 53 69 7a 65 ager->sectorSize
2bc30 3b 0a 20 20 20 20 20 20 20 20 7d 0a 20 20 20 20 ;. }.
2bc40 20 20 7d 0a 23 69 66 64 65 66 20 53 51 4c 49 54 }.#ifdef SQLIT
2bc50 45 5f 45 4e 41 42 4c 45 5f 41 54 4f 4d 49 43 5f E_ENABLE_ATOMIC_
2bc60 57 52 49 54 45 0a 20 20 20 20 20 20 7b 0a 20 20 WRITE. {.
2bc70 20 20 20 20 20 20 69 6e 74 20 69 44 63 20 3d 20 int iDc =
2bc80 73 71 6c 69 74 65 33 4f 73 44 65 76 69 63 65 43 sqlite3OsDeviceC
2bc90 68 61 72 61 63 74 65 72 69 73 74 69 63 73 28 70 haracteristics(p
2bca0 50 61 67 65 72 2d 3e 66 64 29 3b 0a 20 20 20 20 Pager->fd);.
2bcb0 20 20 20 20 69 6e 74 20 69 69 3b 0a 20 20 20 20 int ii;.
2bcc0 20 20 20 20 61 73 73 65 72 74 28 53 51 4c 49 54 assert(SQLIT
2bcd0 45 5f 49 4f 43 41 50 5f 41 54 4f 4d 49 43 35 31 E_IOCAP_ATOMIC51
2bce0 32 3d 3d 28 35 31 32 3e 3e 38 29 29 3b 0a 20 20 2==(512>>8));.
2bcf0 20 20 20 20 20 20 61 73 73 65 72 74 28 53 51 4c assert(SQL
2bd00 49 54 45 5f 49 4f 43 41 50 5f 41 54 4f 4d 49 43 ITE_IOCAP_ATOMIC
2bd10 36 34 4b 3d 3d 28 36 35 35 33 36 3e 3e 38 29 29 64K==(65536>>8))
2bd20 3b 0a 20 20 20 20 20 20 20 20 61 73 73 65 72 74 ;. assert
2bd30 28 53 51 4c 49 54 45 5f 4d 41 58 5f 44 45 46 41 (SQLITE_MAX_DEFA
2bd40 55 4c 54 5f 50 41 47 45 5f 53 49 5a 45 3c 3d 36 ULT_PAGE_SIZE<=6
2bd50 35 35 33 36 29 3b 0a 20 20 20 20 20 20 20 20 66 5536);. f
2bd60 6f 72 28 69 69 3d 73 7a 50 61 67 65 44 66 6c 74 or(ii=szPageDflt
2bd70 3b 20 69 69 3c 3d 53 51 4c 49 54 45 5f 4d 41 58 ; ii<=SQLITE_MAX
2bd80 5f 44 45 46 41 55 4c 54 5f 50 41 47 45 5f 53 49 _DEFAULT_PAGE_SI
2bd90 5a 45 3b 20 69 69 3d 69 69 2a 32 29 7b 0a 20 20 ZE; ii=ii*2){.
2bda0 20 20 20 20 20 20 20 20 69 66 28 20 69 44 63 26 if( iDc&
2bdb0 28 53 51 4c 49 54 45 5f 49 4f 43 41 50 5f 41 54 (SQLITE_IOCAP_AT
2bdc0 4f 4d 49 43 7c 28 69 69 3e 3e 38 29 29 20 29 7b OMIC|(ii>>8)) ){
2bdd0 0a 20 20 20 20 20 20 20 20 20 20 20 20 73 7a 50 . szP
2bde0 61 67 65 44 66 6c 74 20 3d 20 69 69 3b 0a 20 20 ageDflt = ii;.
2bdf0 20 20 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 }.
2be00 20 20 7d 0a 20 20 20 20 20 20 7d 0a 23 65 6e 64 }. }.#end
2be10 69 66 0a 20 20 20 20 7d 0a 20 20 7d 65 6c 73 65 if. }. }else
2be20 7b 0a 20 20 20 20 2f 2a 20 49 66 20 61 20 74 65 {. /* If a te
2be30 6d 70 6f 72 61 72 79 20 66 69 6c 65 20 69 73 20 mporary file is
2be40 72 65 71 75 65 73 74 65 64 2c 20 69 74 20 69 73 requested, it is
2be50 20 6e 6f 74 20 6f 70 65 6e 65 64 20 69 6d 6d 65 not opened imme
2be60 64 69 61 74 65 6c 79 2e 0a 20 20 20 20 2a 2a 20 diately.. **
2be70 49 6e 20 74 68 69 73 20 63 61 73 65 20 77 65 20 In this case we
2be80 61 63 63 65 70 74 20 74 68 65 20 64 65 66 61 75 accept the defau
2be90 6c 74 20 70 61 67 65 20 73 69 7a 65 20 61 6e 64 lt page size and
2bea0 20 64 65 6c 61 79 20 61 63 74 75 61 6c 6c 79 0a delay actually.
2beb0 20 20 20 20 2a 2a 20 6f 70 65 6e 69 6e 67 20 74 ** opening t
2bec0 68 65 20 66 69 6c 65 20 75 6e 74 69 6c 20 74 68 he file until th
2bed0 65 20 66 69 72 73 74 20 63 61 6c 6c 20 74 6f 20 e first call to
2bee0 4f 73 57 72 69 74 65 28 29 2e 0a 20 20 20 20 2a OsWrite().. *
2bef0 2a 0a 20 20 20 20 2a 2a 20 54 68 69 73 20 62 72 *. ** This br
2bf00 61 6e 63 68 20 69 73 20 61 6c 73 6f 20 72 75 6e anch is also run
2bf10 20 66 6f 72 20 61 6e 20 69 6e 2d 6d 65 6d 6f 72 for an in-memor
2bf20 79 20 64 61 74 61 62 61 73 65 2e 20 41 6e 20 69 y database. An i
2bf30 6e 2d 6d 65 6d 6f 72 79 0a 20 20 20 20 2a 2a 20 n-memory. **
2bf40 64 61 74 61 62 61 73 65 20 69 73 20 74 68 65 20 database is the
2bf50 73 61 6d 65 20 61 73 20 61 20 74 65 6d 70 2d 66 same as a temp-f
2bf60 69 6c 65 20 74 68 61 74 20 69 73 20 6e 65 76 65 ile that is neve
2bf70 72 20 77 72 69 74 74 65 6e 20 6f 75 74 20 74 6f r written out to
2bf80 0a 20 20 20 20 2a 2a 20 64 69 73 6b 20 61 6e 64 . ** disk and
2bf90 20 75 73 65 73 20 61 6e 20 69 6e 2d 6d 65 6d 6f uses an in-memo
2bfa0 72 79 20 72 6f 6c 6c 62 61 63 6b 20 6a 6f 75 72 ry rollback jour
2bfb0 6e 61 6c 2e 0a 20 20 20 20 2a 2f 20 0a 20 20 20 nal.. */ .
2bfc0 20 74 65 6d 70 46 69 6c 65 20 3d 20 31 3b 0a 20 tempFile = 1;.
2bfd0 20 20 20 70 50 61 67 65 72 2d 3e 65 53 74 61 74 pPager->eStat
2bfe0 65 20 3d 20 50 41 47 45 52 5f 52 45 41 44 45 52 e = PAGER_READER
2bff0 3b 0a 20 20 20 20 70 50 61 67 65 72 2d 3e 65 4c ;. pPager->eL
2c000 6f 63 6b 20 3d 20 45 58 43 4c 55 53 49 56 45 5f ock = EXCLUSIVE_
2c010 4c 4f 43 4b 3b 0a 20 20 20 20 72 65 61 64 4f 6e LOCK;. readOn
2c020 6c 79 20 3d 20 28 76 66 73 46 6c 61 67 73 26 53 ly = (vfsFlags&S
2c030 51 4c 49 54 45 5f 4f 50 45 4e 5f 52 45 41 44 4f QLITE_OPEN_READO
2c040 4e 4c 59 29 3b 0a 20 20 7d 0a 0a 20 20 2f 2a 20 NLY);. }.. /*
2c050 54 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 63 61 The following ca
2c060 6c 6c 20 74 6f 20 50 61 67 65 72 53 65 74 50 61 ll to PagerSetPa
2c070 67 65 73 69 7a 65 28 29 20 73 65 72 76 65 73 20 gesize() serves
2c080 74 6f 20 73 65 74 20 74 68 65 20 76 61 6c 75 65 to set the value
2c090 20 6f 66 20 0a 20 20 2a 2a 20 50 61 67 65 72 2e of . ** Pager.
2c0a0 70 61 67 65 53 69 7a 65 20 61 6e 64 20 74 6f 20 pageSize and to
2c0b0 61 6c 6c 6f 63 61 74 65 20 74 68 65 20 50 61 67 allocate the Pag
2c0c0 65 72 2e 70 54 6d 70 53 70 61 63 65 20 62 75 66 er.pTmpSpace buf
2c0d0 66 65 72 2e 0a 20 20 2a 2f 0a 20 20 69 66 28 20 fer.. */. if(
2c0e0 72 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b rc==SQLITE_OK ){
2c0f0 0a 20 20 20 20 61 73 73 65 72 74 28 20 70 50 61 . assert( pPa
2c100 67 65 72 2d 3e 6d 65 6d 44 62 3d 3d 30 20 29 3b ger->memDb==0 );
2c110 0a 20 20 20 20 72 63 20 3d 20 73 71 6c 69 74 65 . rc = sqlite
2c120 33 50 61 67 65 72 53 65 74 50 61 67 65 73 69 7a 3PagerSetPagesiz
2c130 65 28 70 50 61 67 65 72 2c 20 26 73 7a 50 61 67 e(pPager, &szPag
2c140 65 44 66 6c 74 2c 20 2d 31 29 3b 0a 20 20 20 20 eDflt, -1);.
2c150 74 65 73 74 63 61 73 65 28 20 72 63 21 3d 53 51 testcase( rc!=SQ
2c160 4c 49 54 45 5f 4f 4b 20 29 3b 0a 20 20 7d 0a 0a LITE_OK );. }..
2c170 20 20 2f 2a 20 49 66 20 61 6e 20 65 72 72 6f 72 /* If an error
2c180 20 6f 63 63 75 72 72 65 64 20 69 6e 20 65 69 74 occurred in eit
2c190 68 65 72 20 6f 66 20 74 68 65 20 62 6c 6f 63 6b her of the block
2c1a0 73 20 61 62 6f 76 65 2c 20 66 72 65 65 20 74 68 s above, free th
2c1b0 65 20 0a 20 20 2a 2a 20 50 61 67 65 72 20 73 74 e . ** Pager st
2c1c0 72 75 63 74 75 72 65 20 61 6e 64 20 63 6c 6f 73 ructure and clos
2c1d0 65 20 74 68 65 20 66 69 6c 65 2e 0a 20 20 2a 2f e the file.. */
2c1e0 0a 20 20 69 66 28 20 72 63 21 3d 53 51 4c 49 54 . if( rc!=SQLIT
2c1f0 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 61 73 73 65 E_OK ){. asse
2c200 72 74 28 20 21 70 50 61 67 65 72 2d 3e 70 54 6d rt( !pPager->pTm
2c210 70 53 70 61 63 65 20 29 3b 0a 20 20 20 20 73 71 pSpace );. sq
2c220 6c 69 74 65 33 4f 73 43 6c 6f 73 65 28 70 50 61 lite3OsClose(pPa
2c230 67 65 72 2d 3e 66 64 29 3b 0a 20 20 20 20 73 71 ger->fd);. sq
2c240 6c 69 74 65 33 5f 66 72 65 65 28 70 50 61 67 65 lite3_free(pPage
2c250 72 29 3b 0a 20 20 20 20 72 65 74 75 72 6e 20 72 r);. return r
2c260 63 3b 0a 20 20 7d 0a 0a 20 20 2f 2a 20 49 6e 69 c;. }.. /* Ini
2c270 74 69 61 6c 69 7a 65 20 74 68 65 20 50 43 61 63 tialize the PCac
2c280 68 65 20 6f 62 6a 65 63 74 2e 20 2a 2f 0a 20 20 he object. */.
2c290 61 73 73 65 72 74 28 20 6e 45 78 74 72 61 3c 31 assert( nExtra<1
2c2a0 30 30 30 20 29 3b 0a 20 20 6e 45 78 74 72 61 20 000 );. nExtra
2c2b0 3d 20 52 4f 55 4e 44 38 28 6e 45 78 74 72 61 29 = ROUND8(nExtra)
2c2c0 3b 0a 20 20 73 71 6c 69 74 65 33 50 63 61 63 68 ;. sqlite3Pcach
2c2d0 65 4f 70 65 6e 28 73 7a 50 61 67 65 44 66 6c 74 eOpen(szPageDflt
2c2e0 2c 20 6e 45 78 74 72 61 2c 20 21 6d 65 6d 44 62 , nExtra, !memDb
2c2f0 2c 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 ,.
2c300 20 20 20 20 20 20 21 6d 65 6d 44 62 3f 70 61 67 !memDb?pag
2c310 65 72 53 74 72 65 73 73 3a 30 2c 20 28 76 6f 69 erStress:0, (voi
2c320 64 20 2a 29 70 50 61 67 65 72 2c 20 70 50 61 67 d *)pPager, pPag
2c330 65 72 2d 3e 70 50 43 61 63 68 65 29 3b 0a 0a 20 er->pPCache);..
2c340 20 50 41 47 45 52 54 52 41 43 45 28 28 22 4f 50 PAGERTRACE(("OP
2c350 45 4e 20 25 64 20 25 73 5c 6e 22 2c 20 46 49 4c EN %d %s\n", FIL
2c360 45 48 41 4e 44 4c 45 49 44 28 70 50 61 67 65 72 EHANDLEID(pPager
2c370 2d 3e 66 64 29 2c 20 70 50 61 67 65 72 2d 3e 7a ->fd), pPager->z
2c380 46 69 6c 65 6e 61 6d 65 29 29 3b 0a 20 20 49 4f Filename));. IO
2c390 54 52 41 43 45 28 28 22 4f 50 45 4e 20 25 70 20 TRACE(("OPEN %p
2c3a0 25 73 5c 6e 22 2c 20 70 50 61 67 65 72 2c 20 70 %s\n", pPager, p
2c3b0 50 61 67 65 72 2d 3e 7a 46 69 6c 65 6e 61 6d 65 Pager->zFilename
2c3c0 29 29 0a 0a 20 20 70 50 61 67 65 72 2d 3e 75 73 )).. pPager->us
2c3d0 65 4a 6f 75 72 6e 61 6c 20 3d 20 28 75 38 29 75 eJournal = (u8)u
2c3e0 73 65 4a 6f 75 72 6e 61 6c 3b 0a 20 20 70 50 61 seJournal;. pPa
2c3f0 67 65 72 2d 3e 6e 6f 52 65 61 64 6c 6f 63 6b 20 ger->noReadlock
2c400 3d 20 28 6e 6f 52 65 61 64 6c 6f 63 6b 20 26 26 = (noReadlock &&
2c410 20 72 65 61 64 4f 6e 6c 79 29 20 3f 31 3a 30 3b readOnly) ?1:0;
2c420 0a 20 20 2f 2a 20 70 50 61 67 65 72 2d 3e 73 74 . /* pPager->st
2c430 6d 74 4f 70 65 6e 20 3d 20 30 3b 20 2a 2f 0a 20 mtOpen = 0; */.
2c440 20 2f 2a 20 70 50 61 67 65 72 2d 3e 73 74 6d 74 /* pPager->stmt
2c450 49 6e 55 73 65 20 3d 20 30 3b 20 2a 2f 0a 20 20 InUse = 0; */.
2c460 2f 2a 20 70 50 61 67 65 72 2d 3e 6e 52 65 66 20 /* pPager->nRef
2c470 3d 20 30 3b 20 2a 2f 0a 20 20 2f 2a 20 70 50 61 = 0; */. /* pPa
2c480 67 65 72 2d 3e 73 74 6d 74 53 69 7a 65 20 3d 20 ger->stmtSize =
2c490 30 3b 20 2a 2f 0a 20 20 2f 2a 20 70 50 61 67 65 0; */. /* pPage
2c4a0 72 2d 3e 73 74 6d 74 4a 53 69 7a 65 20 3d 20 30 r->stmtJSize = 0
2c4b0 3b 20 2a 2f 0a 20 20 2f 2a 20 70 50 61 67 65 72 ; */. /* pPager
2c4c0 2d 3e 6e 50 61 67 65 20 3d 20 30 3b 20 2a 2f 0a ->nPage = 0; */.
2c4d0 20 20 70 50 61 67 65 72 2d 3e 6d 78 50 67 6e 6f pPager->mxPgno
2c4e0 20 3d 20 53 51 4c 49 54 45 5f 4d 41 58 5f 50 41 = SQLITE_MAX_PA
2c4f0 47 45 5f 43 4f 55 4e 54 3b 0a 20 20 2f 2a 20 70 GE_COUNT;. /* p
2c500 50 61 67 65 72 2d 3e 73 74 61 74 65 20 3d 20 50 Pager->state = P
2c510 41 47 45 52 5f 55 4e 4c 4f 43 4b 3b 20 2a 2f 0a AGER_UNLOCK; */.
2c520 23 69 66 20 30 0a 20 20 61 73 73 65 72 74 28 20 #if 0. assert(
2c530 70 50 61 67 65 72 2d 3e 73 74 61 74 65 20 3d 3d pPager->state ==
2c540 20 28 74 65 6d 70 46 69 6c 65 20 3f 20 50 41 47 (tempFile ? PAG
2c550 45 52 5f 45 58 43 4c 55 53 49 56 45 20 3a 20 50 ER_EXCLUSIVE : P
2c560 41 47 45 52 5f 55 4e 4c 4f 43 4b 29 20 29 3b 0a AGER_UNLOCK) );.
2c570 23 65 6e 64 69 66 0a 20 20 2f 2a 20 70 50 61 67 #endif. /* pPag
2c580 65 72 2d 3e 65 72 72 4d 61 73 6b 20 3d 20 30 3b er->errMask = 0;
2c590 20 2a 2f 0a 20 20 70 50 61 67 65 72 2d 3e 74 65 */. pPager->te
2c5a0 6d 70 46 69 6c 65 20 3d 20 28 75 38 29 74 65 6d mpFile = (u8)tem
2c5b0 70 46 69 6c 65 3b 0a 20 20 61 73 73 65 72 74 28 pFile;. assert(
2c5c0 20 74 65 6d 70 46 69 6c 65 3d 3d 50 41 47 45 52 tempFile==PAGER
2c5d0 5f 4c 4f 43 4b 49 4e 47 4d 4f 44 45 5f 4e 4f 52 _LOCKINGMODE_NOR
2c5e0 4d 41 4c 20 0a 20 20 20 20 20 20 20 20 20 20 7c MAL . |
2c5f0 7c 20 74 65 6d 70 46 69 6c 65 3d 3d 50 41 47 45 | tempFile==PAGE
2c600 52 5f 4c 4f 43 4b 49 4e 47 4d 4f 44 45 5f 45 58 R_LOCKINGMODE_EX
2c610 43 4c 55 53 49 56 45 20 29 3b 0a 20 20 61 73 73 CLUSIVE );. ass
2c620 65 72 74 28 20 50 41 47 45 52 5f 4c 4f 43 4b 49 ert( PAGER_LOCKI
2c630 4e 47 4d 4f 44 45 5f 45 58 43 4c 55 53 49 56 45 NGMODE_EXCLUSIVE
2c640 3d 3d 31 20 29 3b 0a 20 20 70 50 61 67 65 72 2d ==1 );. pPager-
2c650 3e 65 78 63 6c 75 73 69 76 65 4d 6f 64 65 20 3d >exclusiveMode =
2c660 20 28 75 38 29 74 65 6d 70 46 69 6c 65 3b 20 0a (u8)tempFile; .
2c670 20 20 70 50 61 67 65 72 2d 3e 63 68 61 6e 67 65 pPager->change
2c680 43 6f 75 6e 74 44 6f 6e 65 20 3d 20 70 50 61 67 CountDone = pPag
2c690 65 72 2d 3e 74 65 6d 70 46 69 6c 65 3b 0a 20 20 er->tempFile;.
2c6a0 70 50 61 67 65 72 2d 3e 6d 65 6d 44 62 20 3d 20 pPager->memDb =
2c6b0 28 75 38 29 6d 65 6d 44 62 3b 0a 20 20 70 50 61 (u8)memDb;. pPa
2c6c0 67 65 72 2d 3e 72 65 61 64 4f 6e 6c 79 20 3d 20 ger->readOnly =
2c6d0 28 75 38 29 72 65 61 64 4f 6e 6c 79 3b 0a 20 20 (u8)readOnly;.
2c6e0 61 73 73 65 72 74 28 20 75 73 65 4a 6f 75 72 6e assert( useJourn
2c6f0 61 6c 20 7c 7c 20 70 50 61 67 65 72 2d 3e 74 65 al || pPager->te
2c700 6d 70 46 69 6c 65 20 29 3b 0a 20 20 70 50 61 67 mpFile );. pPag
2c710 65 72 2d 3e 6e 6f 53 79 6e 63 20 3d 20 70 50 61 er->noSync = pPa
2c720 67 65 72 2d 3e 74 65 6d 70 46 69 6c 65 3b 0a 20 ger->tempFile;.
2c730 20 70 50 61 67 65 72 2d 3e 66 75 6c 6c 53 79 6e pPager->fullSyn
2c740 63 20 3d 20 70 50 61 67 65 72 2d 3e 6e 6f 53 79 c = pPager->noSy
2c750 6e 63 20 3f 30 3a 31 3b 0a 20 20 70 50 61 67 65 nc ?0:1;. pPage
2c760 72 2d 3e 73 79 6e 63 46 6c 61 67 73 20 3d 20 70 r->syncFlags = p
2c770 50 61 67 65 72 2d 3e 6e 6f 53 79 6e 63 20 3f 20 Pager->noSync ?
2c780 30 20 3a 20 53 51 4c 49 54 45 5f 53 59 4e 43 5f 0 : SQLITE_SYNC_
2c790 4e 4f 52 4d 41 4c 3b 0a 20 20 70 50 61 67 65 72 NORMAL;. pPager
2c7a0 2d 3e 63 6b 70 74 53 79 6e 63 46 6c 61 67 73 20 ->ckptSyncFlags
2c7b0 3d 20 70 50 61 67 65 72 2d 3e 73 79 6e 63 46 6c = pPager->syncFl
2c7c0 61 67 73 3b 0a 20 20 2f 2a 20 70 50 61 67 65 72 ags;. /* pPager
2c7d0 2d 3e 70 46 69 72 73 74 20 3d 20 30 3b 20 2a 2f ->pFirst = 0; */
2c7e0 0a 20 20 2f 2a 20 70 50 61 67 65 72 2d 3e 70 46 . /* pPager->pF
2c7f0 69 72 73 74 53 79 6e 63 65 64 20 3d 20 30 3b 20 irstSynced = 0;
2c800 2a 2f 0a 20 20 2f 2a 20 70 50 61 67 65 72 2d 3e */. /* pPager->
2c810 70 4c 61 73 74 20 3d 20 30 3b 20 2a 2f 0a 20 20 pLast = 0; */.
2c820 70 50 61 67 65 72 2d 3e 6e 45 78 74 72 61 20 3d pPager->nExtra =
2c830 20 28 75 31 36 29 6e 45 78 74 72 61 3b 0a 20 20 (u16)nExtra;.
2c840 70 50 61 67 65 72 2d 3e 6a 6f 75 72 6e 61 6c 53 pPager->journalS
2c850 69 7a 65 4c 69 6d 69 74 20 3d 20 53 51 4c 49 54 izeLimit = SQLIT
2c860 45 5f 44 45 46 41 55 4c 54 5f 4a 4f 55 52 4e 41 E_DEFAULT_JOURNA
2c870 4c 5f 53 49 5a 45 5f 4c 49 4d 49 54 3b 0a 20 20 L_SIZE_LIMIT;.
2c880 61 73 73 65 72 74 28 20 69 73 4f 70 65 6e 28 70 assert( isOpen(p
2c890 50 61 67 65 72 2d 3e 66 64 29 20 7c 7c 20 74 65 Pager->fd) || te
2c8a0 6d 70 46 69 6c 65 20 29 3b 0a 20 20 73 65 74 53 mpFile );. setS
2c8b0 65 63 74 6f 72 53 69 7a 65 28 70 50 61 67 65 72 ectorSize(pPager
2c8c0 29 3b 0a 20 20 69 66 28 20 21 75 73 65 4a 6f 75 );. if( !useJou
2c8d0 72 6e 61 6c 20 29 7b 0a 20 20 20 20 70 50 61 67 rnal ){. pPag
2c8e0 65 72 2d 3e 6a 6f 75 72 6e 61 6c 4d 6f 64 65 20 er->journalMode
2c8f0 3d 20 50 41 47 45 52 5f 4a 4f 55 52 4e 41 4c 4d = PAGER_JOURNALM
2c900 4f 44 45 5f 4f 46 46 3b 0a 20 20 7d 65 6c 73 65 ODE_OFF;. }else
2c910 20 69 66 28 20 6d 65 6d 44 62 20 29 7b 0a 20 20 if( memDb ){.
2c920 20 20 70 50 61 67 65 72 2d 3e 6a 6f 75 72 6e 61 pPager->journa
2c930 6c 4d 6f 64 65 20 3d 20 50 41 47 45 52 5f 4a 4f lMode = PAGER_JO
2c940 55 52 4e 41 4c 4d 4f 44 45 5f 4d 45 4d 4f 52 59 URNALMODE_MEMORY
2c950 3b 0a 20 20 7d 0a 20 20 2f 2a 20 70 50 61 67 65 ;. }. /* pPage
2c960 72 2d 3e 78 42 75 73 79 48 61 6e 64 6c 65 72 20 r->xBusyHandler
2c970 3d 20 30 3b 20 2a 2f 0a 20 20 2f 2a 20 70 50 61 = 0; */. /* pPa
2c980 67 65 72 2d 3e 70 42 75 73 79 48 61 6e 64 6c 65 ger->pBusyHandle
2c990 72 41 72 67 20 3d 20 30 3b 20 2a 2f 0a 20 20 70 rArg = 0; */. p
2c9a0 50 61 67 65 72 2d 3e 78 52 65 69 6e 69 74 65 72 Pager->xReiniter
2c9b0 20 3d 20 78 52 65 69 6e 69 74 3b 0a 20 20 2f 2a = xReinit;. /*
2c9c0 20 6d 65 6d 73 65 74 28 70 50 61 67 65 72 2d 3e memset(pPager->
2c9d0 61 48 61 73 68 2c 20 30 2c 20 73 69 7a 65 6f 66 aHash, 0, sizeof
2c9e0 28 70 50 61 67 65 72 2d 3e 61 48 61 73 68 29 29 (pPager->aHash))
2c9f0 3b 20 2a 2f 0a 0a 20 20 2a 70 70 50 61 67 65 72 ; */.. *ppPager
2ca00 20 3d 20 70 50 61 67 65 72 3b 0a 20 20 72 65 74 = pPager;. ret
2ca10 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 7d urn SQLITE_OK;.}
2ca20 0a 0a 0a 0a 2f 2a 0a 2a 2a 20 54 68 69 73 20 66 ..../*.** This f
2ca30 75 6e 63 74 69 6f 6e 20 69 73 20 63 61 6c 6c 65 unction is calle
2ca40 64 20 61 66 74 65 72 20 74 72 61 6e 73 69 74 69 d after transiti
2ca50 6f 6e 69 6e 67 20 66 72 6f 6d 20 50 41 47 45 52 oning from PAGER
2ca60 5f 55 4e 4c 4f 43 4b 20 74 6f 0a 2a 2a 20 50 41 _UNLOCK to.** PA
2ca70 47 45 52 5f 53 48 41 52 45 44 20 73 74 61 74 65 GER_SHARED state
2ca80 2e 20 49 74 20 74 65 73 74 73 20 69 66 20 74 68 . It tests if th
2ca90 65 72 65 20 69 73 20 61 20 68 6f 74 20 6a 6f 75 ere is a hot jou
2caa0 72 6e 61 6c 20 70 72 65 73 65 6e 74 20 69 6e 0a rnal present in.
2cab0 2a 2a 20 74 68 65 20 66 69 6c 65 2d 73 79 73 74 ** the file-syst
2cac0 65 6d 20 66 6f 72 20 74 68 65 20 67 69 76 65 6e em for the given
2cad0 20 70 61 67 65 72 2e 20 41 20 68 6f 74 20 6a 6f pager. A hot jo
2cae0 75 72 6e 61 6c 20 69 73 20 6f 6e 65 20 74 68 61 urnal is one tha
2caf0 74 20 0a 2a 2a 20 6e 65 65 64 73 20 74 6f 20 62 t .** needs to b
2cb00 65 20 70 6c 61 79 65 64 20 62 61 63 6b 2e 20 41 e played back. A
2cb10 63 63 6f 72 64 69 6e 67 20 74 6f 20 74 68 69 73 ccording to this
2cb20 20 66 75 6e 63 74 69 6f 6e 2c 20 61 20 68 6f 74 function, a hot
2cb30 2d 6a 6f 75 72 6e 61 6c 0a 2a 2a 20 66 69 6c 65 -journal.** file
2cb40 20 65 78 69 73 74 73 20 69 66 20 74 68 65 20 66 exists if the f
2cb50 6f 6c 6c 6f 77 69 6e 67 20 63 72 69 74 65 72 69 ollowing criteri
2cb60 61 20 61 72 65 20 6d 65 74 3a 0a 2a 2a 0a 2a 2a a are met:.**.**
2cb70 20 20 20 2a 20 54 68 65 20 6a 6f 75 72 6e 61 6c * The journal
2cb80 20 66 69 6c 65 20 65 78 69 73 74 73 20 69 6e 20 file exists in
2cb90 74 68 65 20 66 69 6c 65 20 73 79 73 74 65 6d 2c the file system,
2cba0 20 61 6e 64 0a 2a 2a 20 20 20 2a 20 4e 6f 20 70 and.** * No p
2cbb0 72 6f 63 65 73 73 20 68 6f 6c 64 73 20 61 20 52 rocess holds a R
2cbc0 45 53 45 52 56 45 44 20 6f 72 20 67 72 65 61 74 ESERVED or great
2cbd0 65 72 20 6c 6f 63 6b 20 6f 6e 20 74 68 65 20 64 er lock on the d
2cbe0 61 74 61 62 61 73 65 20 66 69 6c 65 2c 20 61 6e atabase file, an
2cbf0 64 0a 2a 2a 20 20 20 2a 20 54 68 65 20 64 61 74 d.** * The dat
2cc00 61 62 61 73 65 20 66 69 6c 65 20 69 74 73 65 6c abase file itsel
2cc10 66 20 69 73 20 67 72 65 61 74 65 72 20 74 68 61 f is greater tha
2cc20 6e 20 30 20 62 79 74 65 73 20 69 6e 20 73 69 7a n 0 bytes in siz
2cc30 65 2c 20 61 6e 64 0a 2a 2a 20 20 20 2a 20 54 68 e, and.** * Th
2cc40 65 20 66 69 72 73 74 20 62 79 74 65 20 6f 66 20 e first byte of
2cc50 74 68 65 20 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 the journal file
2cc60 20 65 78 69 73 74 73 20 61 6e 64 20 69 73 20 6e exists and is n
2cc70 6f 74 20 30 78 30 30 2e 0a 2a 2a 0a 2a 2a 20 49 ot 0x00..**.** I
2cc80 66 20 74 68 65 20 63 75 72 72 65 6e 74 20 73 69 f the current si
2cc90 7a 65 20 6f 66 20 74 68 65 20 64 61 74 61 62 61 ze of the databa
2cca0 73 65 20 66 69 6c 65 20 69 73 20 30 20 62 75 74 se file is 0 but
2ccb0 20 61 20 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 0a a journal file.
2ccc0 2a 2a 20 65 78 69 73 74 73 2c 20 74 68 61 74 20 ** exists, that
2ccd0 69 73 20 70 72 6f 62 61 62 6c 79 20 61 6e 20 6f is probably an o
2cce0 6c 64 20 6a 6f 75 72 6e 61 6c 20 6c 65 66 74 20 ld journal left
2ccf0 6f 76 65 72 20 66 72 6f 6d 20 61 20 70 72 69 6f over from a prio
2cd00 72 0a 2a 2a 20 64 61 74 61 62 61 73 65 20 77 69 r.** database wi
2cd10 74 68 20 74 68 65 20 73 61 6d 65 20 6e 61 6d 65 th the same name
2cd20 2e 20 49 6e 20 74 68 69 73 20 63 61 73 65 20 74 . In this case t
2cd30 68 65 20 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 20 he journal file
2cd40 69 73 0a 2a 2a 20 6a 75 73 74 20 64 65 6c 65 74 is.** just delet
2cd50 65 64 20 75 73 69 6e 67 20 4f 73 44 65 6c 65 74 ed using OsDelet
2cd60 65 2c 20 2a 70 45 78 69 73 74 73 20 69 73 20 73 e, *pExists is s
2cd70 65 74 20 74 6f 20 30 20 61 6e 64 20 53 51 4c 49 et to 0 and SQLI
2cd80 54 45 5f 4f 4b 0a 2a 2a 20 69 73 20 72 65 74 75 TE_OK.** is retu
2cd90 72 6e 65 64 2e 0a 2a 2a 0a 2a 2a 20 54 68 69 73 rned..**.** This
2cda0 20 72 6f 75 74 69 6e 65 20 64 6f 65 73 20 6e 6f routine does no
2cdb0 74 20 63 68 65 63 6b 20 69 66 20 74 68 65 72 65 t check if there
2cdc0 20 69 73 20 61 20 6d 61 73 74 65 72 20 6a 6f 75 is a master jou
2cdd0 72 6e 61 6c 20 66 69 6c 65 6e 61 6d 65 0a 2a 2a rnal filename.**
2cde0 20 61 74 20 74 68 65 20 65 6e 64 20 6f 66 20 74 at the end of t
2cdf0 68 65 20 66 69 6c 65 2e 20 49 66 20 74 68 65 72 he file. If ther
2ce00 65 20 69 73 2c 20 61 6e 64 20 74 68 61 74 20 6d e is, and that m
2ce10 61 73 74 65 72 20 6a 6f 75 72 6e 61 6c 20 66 69 aster journal fi
2ce20 6c 65 0a 2a 2a 20 64 6f 65 73 20 6e 6f 74 20 65 le.** does not e
2ce30 78 69 73 74 2c 20 74 68 65 6e 20 74 68 65 20 6a xist, then the j
2ce40 6f 75 72 6e 61 6c 20 66 69 6c 65 20 69 73 20 6e ournal file is n
2ce50 6f 74 20 72 65 61 6c 6c 79 20 68 6f 74 2e 20 49 ot really hot. I
2ce60 6e 20 74 68 69 73 0a 2a 2a 20 63 61 73 65 20 74 n this.** case t
2ce70 68 69 73 20 72 6f 75 74 69 6e 65 20 77 69 6c 6c his routine will
2ce80 20 72 65 74 75 72 6e 20 61 20 66 61 6c 73 65 2d return a false-
2ce90 70 6f 73 69 74 69 76 65 2e 20 54 68 65 20 70 61 positive. The pa
2cea0 67 65 72 5f 70 6c 61 79 62 61 63 6b 28 29 0a 2a ger_playback().*
2ceb0 2a 20 72 6f 75 74 69 6e 65 20 77 69 6c 6c 20 64 * routine will d
2cec0 69 73 63 6f 76 65 72 20 74 68 61 74 20 74 68 65 iscover that the
2ced0 20 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 20 69 73 journal file is
2cee0 20 6e 6f 74 20 72 65 61 6c 6c 79 20 68 6f 74 20 not really hot
2cef0 61 6e 64 20 0a 2a 2a 20 77 69 6c 6c 20 6e 6f 74 and .** will not
2cf00 20 72 6f 6c 6c 20 69 74 20 62 61 63 6b 2e 20 0a roll it back. .
2cf10 2a 2a 0a 2a 2a 20 49 66 20 61 20 68 6f 74 2d 6a **.** If a hot-j
2cf20 6f 75 72 6e 61 6c 20 66 69 6c 65 20 69 73 20 66 ournal file is f
2cf30 6f 75 6e 64 20 74 6f 20 65 78 69 73 74 2c 20 2a ound to exist, *
2cf40 70 45 78 69 73 74 73 20 69 73 20 73 65 74 20 74 pExists is set t
2cf50 6f 20 31 20 61 6e 64 20 0a 2a 2a 20 53 51 4c 49 o 1 and .** SQLI
2cf60 54 45 5f 4f 4b 20 72 65 74 75 72 6e 65 64 2e 20 TE_OK returned.
2cf70 49 66 20 6e 6f 20 68 6f 74 2d 6a 6f 75 72 6e 61 If no hot-journa
2cf80 6c 20 66 69 6c 65 20 69 73 20 70 72 65 73 65 6e l file is presen
2cf90 74 2c 20 2a 70 45 78 69 73 74 73 20 69 73 0a 2a t, *pExists is.*
2cfa0 2a 20 73 65 74 20 74 6f 20 30 20 61 6e 64 20 53 * set to 0 and S
2cfb0 51 4c 49 54 45 5f 4f 4b 20 72 65 74 75 72 6e 65 QLITE_OK returne
2cfc0 64 2e 20 49 66 20 61 6e 20 49 4f 20 65 72 72 6f d. If an IO erro
2cfd0 72 20 6f 63 63 75 72 73 20 77 68 69 6c 65 20 74 r occurs while t
2cfe0 72 79 69 6e 67 0a 2a 2a 20 74 6f 20 64 65 74 65 rying.** to dete
2cff0 72 6d 69 6e 65 20 77 68 65 74 68 65 72 20 6f 72 rmine whether or
2d000 20 6e 6f 74 20 61 20 68 6f 74 2d 6a 6f 75 72 6e not a hot-journ
2d010 61 6c 20 66 69 6c 65 20 65 78 69 73 74 73 2c 20 al file exists,
2d020 74 68 65 20 49 4f 20 65 72 72 6f 72 0a 2a 2a 20 the IO error.**
2d030 63 6f 64 65 20 69 73 20 72 65 74 75 72 6e 65 64 code is returned
2d040 20 61 6e 64 20 74 68 65 20 76 61 6c 75 65 20 6f and the value o
2d050 66 20 2a 70 45 78 69 73 74 73 20 69 73 20 75 6e f *pExists is un
2d060 64 65 66 69 6e 65 64 2e 0a 2a 2f 0a 73 74 61 74 defined..*/.stat
2d070 69 63 20 69 6e 74 20 68 61 73 48 6f 74 4a 6f 75 ic int hasHotJou
2d080 72 6e 61 6c 28 50 61 67 65 72 20 2a 70 50 61 67 rnal(Pager *pPag
2d090 65 72 2c 20 69 6e 74 20 2a 70 45 78 69 73 74 73 er, int *pExists
2d0a0 29 7b 0a 20 20 73 71 6c 69 74 65 33 5f 76 66 73 ){. sqlite3_vfs
2d0b0 20 2a 20 63 6f 6e 73 74 20 70 56 66 73 20 3d 20 * const pVfs =
2d0c0 70 50 61 67 65 72 2d 3e 70 56 66 73 3b 0a 20 20 pPager->pVfs;.
2d0d0 69 6e 74 20 72 63 20 3d 20 53 51 4c 49 54 45 5f int rc = SQLITE_
2d0e0 4f 4b 3b 20 20 20 20 20 20 20 20 20 20 20 2f 2a OK; /*
2d0f0 20 52 65 74 75 72 6e 20 63 6f 64 65 20 2a 2f 0a Return code */.
2d100 20 20 69 6e 74 20 65 78 69 73 74 73 20 3d 20 31 int exists = 1
2d110 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 ;
2d120 2f 2a 20 54 72 75 65 20 69 66 20 61 20 6a 6f 75 /* True if a jou
2d130 72 6e 61 6c 20 66 69 6c 65 20 69 73 20 70 72 65 rnal file is pre
2d140 73 65 6e 74 20 2a 2f 0a 20 20 69 6e 74 20 6a 72 sent */. int jr
2d150 6e 6c 4f 70 65 6e 20 3d 20 21 21 69 73 4f 70 65 nlOpen = !!isOpe
2d160 6e 28 70 50 61 67 65 72 2d 3e 6a 66 64 29 3b 0a n(pPager->jfd);.
2d170 0a 20 20 61 73 73 65 72 74 28 20 70 50 61 67 65 . assert( pPage
2d180 72 2d 3e 75 73 65 4a 6f 75 72 6e 61 6c 20 29 3b r->useJournal );
2d190 0a 20 20 61 73 73 65 72 74 28 20 69 73 4f 70 65 . assert( isOpe
2d1a0 6e 28 70 50 61 67 65 72 2d 3e 66 64 29 20 29 3b n(pPager->fd) );
2d1b0 0a 20 20 61 73 73 65 72 74 28 20 70 50 61 67 65 . assert( pPage
2d1c0 72 2d 3e 65 53 74 61 74 65 3d 3d 50 41 47 45 52 r->eState==PAGER
2d1d0 5f 4f 50 45 4e 20 29 3b 0a 0a 20 20 61 73 73 65 _OPEN );.. asse
2d1e0 72 74 28 20 6a 72 6e 6c 4f 70 65 6e 3d 3d 30 20 rt( jrnlOpen==0
2d1f0 7c 7c 20 28 20 73 71 6c 69 74 65 33 4f 73 44 65 || ( sqlite3OsDe
2d200 76 69 63 65 43 68 61 72 61 63 74 65 72 69 73 74 viceCharacterist
2d210 69 63 73 28 70 50 61 67 65 72 2d 3e 6a 66 64 29 ics(pPager->jfd)
2d220 20 26 0a 20 20 20 20 53 51 4c 49 54 45 5f 49 4f &. SQLITE_IO
2d230 43 41 50 5f 55 4e 44 45 4c 45 54 41 42 4c 45 5f CAP_UNDELETABLE_
2d240 57 48 45 4e 5f 4f 50 45 4e 0a 20 20 29 29 3b 0a WHEN_OPEN. ));.
2d250 0a 20 20 2a 70 45 78 69 73 74 73 20 3d 20 30 3b . *pExists = 0;
2d260 0a 20 20 69 66 28 20 21 6a 72 6e 6c 4f 70 65 6e . if( !jrnlOpen
2d270 20 29 7b 0a 20 20 20 20 72 63 20 3d 20 73 71 6c ){. rc = sql
2d280 69 74 65 33 4f 73 41 63 63 65 73 73 28 70 56 66 ite3OsAccess(pVf
2d290 73 2c 20 70 50 61 67 65 72 2d 3e 7a 4a 6f 75 72 s, pPager->zJour
2d2a0 6e 61 6c 2c 20 53 51 4c 49 54 45 5f 41 43 43 45 nal, SQLITE_ACCE
2d2b0 53 53 5f 45 58 49 53 54 53 2c 20 26 65 78 69 73 SS_EXISTS, &exis
2d2c0 74 73 29 3b 0a 20 20 7d 0a 20 20 69 66 28 20 72 ts);. }. if( r
2d2d0 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 26 26 20 c==SQLITE_OK &&
2d2e0 65 78 69 73 74 73 20 29 7b 0a 20 20 20 20 69 6e exists ){. in
2d2f0 74 20 6c 6f 63 6b 65 64 20 3d 20 30 3b 20 20 20 t locked = 0;
2d300 20 20 20 20 20 20 20 20 20 20 2f 2a 20 54 72 75 /* Tru
2d310 65 20 69 66 20 73 6f 6d 65 20 70 72 6f 63 65 73 e if some proces
2d320 73 20 68 6f 6c 64 73 20 61 20 52 45 53 45 52 56 s holds a RESERV
2d330 45 44 20 6c 6f 63 6b 20 2a 2f 0a 0a 20 20 20 20 ED lock */..
2d340 2f 2a 20 52 61 63 65 20 63 6f 6e 64 69 74 69 6f /* Race conditio
2d350 6e 20 68 65 72 65 3a 20 20 41 6e 6f 74 68 65 72 n here: Another
2d360 20 70 72 6f 63 65 73 73 20 6d 69 67 68 74 20 68 process might h
2d370 61 76 65 20 62 65 65 6e 20 68 6f 6c 64 69 6e 67 ave been holding
2d380 20 74 68 65 0a 20 20 20 20 2a 2a 20 74 68 65 20 the. ** the
2d390 52 45 53 45 52 56 45 44 20 6c 6f 63 6b 20 61 6e RESERVED lock an
2d3a0 64 20 68 61 76 65 20 61 20 6a 6f 75 72 6e 61 6c d have a journal
2d3b0 20 6f 70 65 6e 20 61 74 20 74 68 65 20 73 71 6c open at the sql
2d3c0 69 74 65 33 4f 73 41 63 63 65 73 73 28 29 20 0a ite3OsAccess() .
2d3d0 20 20 20 20 2a 2a 20 63 61 6c 6c 20 61 62 6f 76 ** call abov
2d3e0 65 2c 20 62 75 74 20 74 68 65 6e 20 64 65 6c 65 e, but then dele
2d3f0 74 65 20 74 68 65 20 6a 6f 75 72 6e 61 6c 20 61 te the journal a
2d400 6e 64 20 64 72 6f 70 20 74 68 65 20 6c 6f 63 6b nd drop the lock
2d410 20 62 65 66 6f 72 65 0a 20 20 20 20 2a 2a 20 77 before. ** w
2d420 65 20 67 65 74 20 74 6f 20 74 68 65 20 66 6f 6c e get to the fol
2d430 6c 6f 77 69 6e 67 20 73 71 6c 69 74 65 33 4f 73 lowing sqlite3Os
2d440 43 68 65 63 6b 52 65 73 65 72 76 65 64 4c 6f 63 CheckReservedLoc
2d450 6b 28 29 20 63 61 6c 6c 2e 20 20 49 66 20 74 68 k() call. If th
2d460 61 74 0a 20 20 20 20 2a 2a 20 69 73 20 74 68 65 at. ** is the
2d470 20 63 61 73 65 2c 20 74 68 69 73 20 72 6f 75 74 case, this rout
2d480 69 6e 65 20 6d 69 67 68 74 20 74 68 69 6e 6b 20 ine might think
2d490 74 68 65 72 65 20 69 73 20 61 20 68 6f 74 20 6a there is a hot j
2d4a0 6f 75 72 6e 61 6c 20 77 68 65 6e 0a 20 20 20 20 ournal when.
2d4b0 2a 2a 20 69 6e 20 66 61 63 74 20 74 68 65 72 65 ** in fact there
2d4c0 20 69 73 20 6e 6f 6e 65 2e 20 20 54 68 69 73 20 is none. This
2d4d0 72 65 73 75 6c 74 73 20 69 6e 20 61 20 66 61 6c results in a fal
2d4e0 73 65 2d 70 6f 73 69 74 69 76 65 20 77 68 69 63 se-positive whic
2d4f0 68 20 77 69 6c 6c 0a 20 20 20 20 2a 2a 20 62 65 h will. ** be
2d500 20 64 65 61 6c 74 20 77 69 74 68 20 62 79 20 74 dealt with by t
2d510 68 65 20 70 6c 61 79 62 61 63 6b 20 72 6f 75 74 he playback rout
2d520 69 6e 65 2e 20 20 54 69 63 6b 65 74 20 23 33 38 ine. Ticket #38
2d530 38 33 2e 0a 20 20 20 20 2a 2f 0a 20 20 20 20 72 83.. */. r
2d540 63 20 3d 20 73 71 6c 69 74 65 33 4f 73 43 68 65 c = sqlite3OsChe
2d550 63 6b 52 65 73 65 72 76 65 64 4c 6f 63 6b 28 70 ckReservedLock(p
2d560 50 61 67 65 72 2d 3e 66 64 2c 20 26 6c 6f 63 6b Pager->fd, &lock
2d570 65 64 29 3b 0a 20 20 20 20 69 66 28 20 72 63 3d ed);. if( rc=
2d580 3d 53 51 4c 49 54 45 5f 4f 4b 20 26 26 20 21 6c =SQLITE_OK && !l
2d590 6f 63 6b 65 64 20 29 7b 0a 20 20 20 20 20 20 50 ocked ){. P
2d5a0 67 6e 6f 20 6e 50 61 67 65 3b 20 20 20 20 20 20 gno nPage;
2d5b0 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4e 75 /* Nu
2d5c0 6d 62 65 72 20 6f 66 20 70 61 67 65 73 20 69 6e mber of pages in
2d5d0 20 64 61 74 61 62 61 73 65 20 66 69 6c 65 20 2a database file *
2d5e0 2f 0a 0a 20 20 20 20 20 20 2f 2a 20 43 68 65 63 /.. /* Chec
2d5f0 6b 20 74 68 65 20 73 69 7a 65 20 6f 66 20 74 68 k the size of th
2d600 65 20 64 61 74 61 62 61 73 65 20 66 69 6c 65 2e e database file.
2d610 20 49 66 20 69 74 20 63 6f 6e 73 69 73 74 73 20 If it consists
2d620 6f 66 20 30 20 70 61 67 65 73 2c 0a 20 20 20 20 of 0 pages,.
2d630 20 20 2a 2a 20 74 68 65 6e 20 64 65 6c 65 74 65 ** then delete
2d640 20 74 68 65 20 6a 6f 75 72 6e 61 6c 20 66 69 6c the journal fil
2d650 65 2e 20 53 65 65 20 74 68 65 20 68 65 61 64 65 e. See the heade
2d660 72 20 63 6f 6d 6d 65 6e 74 20 61 62 6f 76 65 20 r comment above
2d670 66 6f 72 20 0a 20 20 20 20 20 20 2a 2a 20 74 68 for . ** th
2d680 65 20 72 65 61 73 6f 6e 69 6e 67 20 68 65 72 65 e reasoning here
2d690 2e 20 20 44 65 6c 65 74 65 20 74 68 65 20 6f 62 . Delete the ob
2d6a0 73 6f 6c 65 74 65 20 6a 6f 75 72 6e 61 6c 20 66 solete journal f
2d6b0 69 6c 65 20 75 6e 64 65 72 0a 20 20 20 20 20 20 ile under.
2d6c0 2a 2a 20 61 20 52 45 53 45 52 56 45 44 20 6c 6f ** a RESERVED lo
2d6d0 63 6b 20 74 6f 20 61 76 6f 69 64 20 72 61 63 65 ck to avoid race
2d6e0 20 63 6f 6e 64 69 74 69 6f 6e 73 20 61 6e 64 20 conditions and
2d6f0 74 6f 20 61 76 6f 69 64 20 76 69 6f 6c 61 74 69 to avoid violati
2d700 6e 67 0a 20 20 20 20 20 20 2a 2a 20 5b 48 33 33 ng. ** [H33
2d710 30 32 30 5d 2e 0a 20 20 20 20 20 20 2a 2f 0a 20 020].. */.
2d720 20 20 20 20 20 72 63 20 3d 20 70 61 67 65 72 50 rc = pagerP
2d730 61 67 65 63 6f 75 6e 74 28 70 50 61 67 65 72 2c agecount(pPager,
2d740 20 26 6e 50 61 67 65 29 3b 0a 20 20 20 20 20 20 &nPage);.
2d750 69 66 28 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4f if( rc==SQLITE_O
2d760 4b 20 29 7b 0a 20 20 20 20 20 20 20 20 69 66 28 K ){. if(
2d770 20 6e 50 61 67 65 3d 3d 30 20 29 7b 0a 20 20 20 nPage==0 ){.
2d780 20 20 20 20 20 20 20 73 71 6c 69 74 65 33 42 65 sqlite3Be
2d790 67 69 6e 42 65 6e 69 67 6e 4d 61 6c 6c 6f 63 28 ginBenignMalloc(
2d7a0 29 3b 0a 20 20 20 20 20 20 20 20 20 20 69 66 28 );. if(
2d7b0 20 70 61 67 65 72 4c 6f 63 6b 44 62 28 70 50 61 pagerLockDb(pPa
2d7c0 67 65 72 2c 20 52 45 53 45 52 56 45 44 5f 4c 4f ger, RESERVED_LO
2d7d0 43 4b 29 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 CK)==SQLITE_OK )
2d7e0 7b 0a 20 20 20 20 20 20 20 20 20 20 20 20 73 71 {. sq
2d7f0 6c 69 74 65 33 4f 73 44 65 6c 65 74 65 28 70 56 lite3OsDelete(pV
2d800 66 73 2c 20 70 50 61 67 65 72 2d 3e 7a 4a 6f 75 fs, pPager->zJou
2d810 72 6e 61 6c 2c 20 30 29 3b 0a 20 20 20 20 20 20 rnal, 0);.
2d820 20 20 20 20 20 20 69 66 28 20 21 70 50 61 67 65 if( !pPage
2d830 72 2d 3e 65 78 63 6c 75 73 69 76 65 4d 6f 64 65 r->exclusiveMode
2d840 20 29 20 70 61 67 65 72 55 6e 6c 6f 63 6b 44 62 ) pagerUnlockDb
2d850 28 70 50 61 67 65 72 2c 20 53 48 41 52 45 44 5f (pPager, SHARED_
2d860 4c 4f 43 4b 29 3b 0a 20 20 20 20 20 20 20 20 20 LOCK);.
2d870 20 7d 0a 20 20 20 20 20 20 20 20 20 20 73 71 6c }. sql
2d880 69 74 65 33 45 6e 64 42 65 6e 69 67 6e 4d 61 6c ite3EndBenignMal
2d890 6c 6f 63 28 29 3b 0a 20 20 20 20 20 20 20 20 7d loc();. }
2d8a0 65 6c 73 65 7b 0a 20 20 20 20 20 20 20 20 20 20 else{.
2d8b0 2f 2a 20 54 68 65 20 6a 6f 75 72 6e 61 6c 20 66 /* The journal f
2d8c0 69 6c 65 20 65 78 69 73 74 73 20 61 6e 64 20 6e ile exists and n
2d8d0 6f 20 6f 74 68 65 72 20 63 6f 6e 6e 65 63 74 69 o other connecti
2d8e0 6f 6e 20 68 61 73 20 61 20 72 65 73 65 72 76 65 on has a reserve
2d8f0 64 0a 20 20 20 20 20 20 20 20 20 20 2a 2a 20 6f d. ** o
2d900 72 20 67 72 65 61 74 65 72 20 6c 6f 63 6b 20 6f r greater lock o
2d910 6e 20 74 68 65 20 64 61 74 61 62 61 73 65 20 66 n the database f
2d920 69 6c 65 2e 20 4e 6f 77 20 63 68 65 63 6b 20 74 ile. Now check t
2d930 68 61 74 20 74 68 65 72 65 20 69 73 0a 20 20 20 hat there is.
2d940 20 20 20 20 20 20 20 2a 2a 20 61 74 20 6c 65 61 ** at lea
2d950 73 74 20 6f 6e 65 20 6e 6f 6e 2d 7a 65 72 6f 20 st one non-zero
2d960 62 79 74 65 73 20 61 74 20 74 68 65 20 73 74 61 bytes at the sta
2d970 72 74 20 6f 66 20 74 68 65 20 6a 6f 75 72 6e 61 rt of the journa
2d980 6c 20 66 69 6c 65 2e 0a 20 20 20 20 20 20 20 20 l file..
2d990 20 20 2a 2a 20 49 66 20 74 68 65 72 65 20 69 73 ** If there is
2d9a0 2c 20 74 68 65 6e 20 77 65 20 63 6f 6e 73 69 64 , then we consid
2d9b0 65 72 20 74 68 69 73 20 6a 6f 75 72 6e 61 6c 20 er this journal
2d9c0 74 6f 20 62 65 20 68 6f 74 2e 20 49 66 20 6e 6f to be hot. If no
2d9d0 74 2c 20 0a 20 20 20 20 20 20 20 20 20 20 2a 2a t, . **
2d9e0 20 69 74 20 63 61 6e 20 62 65 20 69 67 6e 6f 72 it can be ignor
2d9f0 65 64 2e 0a 20 20 20 20 20 20 20 20 20 20 2a 2f ed.. */
2da00 0a 20 20 20 20 20 20 20 20 20 20 69 66 28 20 21 . if( !
2da10 6a 72 6e 6c 4f 70 65 6e 20 29 7b 0a 20 20 20 20 jrnlOpen ){.
2da20 20 20 20 20 20 20 20 20 69 6e 74 20 66 20 3d 20 int f =
2da30 53 51 4c 49 54 45 5f 4f 50 45 4e 5f 52 45 41 44 SQLITE_OPEN_READ
2da40 4f 4e 4c 59 7c 53 51 4c 49 54 45 5f 4f 50 45 4e ONLY|SQLITE_OPEN
2da50 5f 4d 41 49 4e 5f 4a 4f 55 52 4e 41 4c 3b 0a 20 _MAIN_JOURNAL;.
2da60 20 20 20 20 20 20 20 20 20 20 20 72 63 20 3d 20 rc =
2da70 73 71 6c 69 74 65 33 4f 73 4f 70 65 6e 28 70 56 sqlite3OsOpen(pV
2da80 66 73 2c 20 70 50 61 67 65 72 2d 3e 7a 4a 6f 75 fs, pPager->zJou
2da90 72 6e 61 6c 2c 20 70 50 61 67 65 72 2d 3e 6a 66 rnal, pPager->jf
2daa0 64 2c 20 66 2c 20 26 66 29 3b 0a 20 20 20 20 20 d, f, &f);.
2dab0 20 20 20 20 20 7d 0a 20 20 20 20 20 20 20 20 20 }.
2dac0 20 69 66 28 20 72 63 3d 3d 53 51 4c 49 54 45 5f if( rc==SQLITE_
2dad0 4f 4b 20 29 7b 0a 20 20 20 20 20 20 20 20 20 20 OK ){.
2dae0 20 20 75 38 20 66 69 72 73 74 20 3d 20 30 3b 0a u8 first = 0;.
2daf0 20 20 20 20 20 20 20 20 20 20 20 20 72 63 20 3d rc =
2db00 20 73 71 6c 69 74 65 33 4f 73 52 65 61 64 28 70 sqlite3OsRead(p
2db10 50 61 67 65 72 2d 3e 6a 66 64 2c 20 28 76 6f 69 Pager->jfd, (voi
2db20 64 20 2a 29 26 66 69 72 73 74 2c 20 31 2c 20 30 d *)&first, 1, 0
2db30 29 3b 0a 20 20 20 20 20 20 20 20 20 20 20 20 69 );. i
2db40 66 28 20 72 63 3d 3d 53 51 4c 49 54 45 5f 49 4f f( rc==SQLITE_IO
2db50 45 52 52 5f 53 48 4f 52 54 5f 52 45 41 44 20 29 ERR_SHORT_READ )
2db60 7b 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 {.
2db70 72 63 20 3d 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a rc = SQLITE_OK;.
2db80 20 20 20 20 20 20 20 20 20 20 20 20 7d 0a 20 20 }.
2db90 20 20 20 20 20 20 20 20 20 20 69 66 28 20 21 6a if( !j
2dba0 72 6e 6c 4f 70 65 6e 20 29 7b 0a 20 20 20 20 20 rnlOpen ){.
2dbb0 20 20 20 20 20 20 20 20 20 73 71 6c 69 74 65 33 sqlite3
2dbc0 4f 73 43 6c 6f 73 65 28 70 50 61 67 65 72 2d 3e OsClose(pPager->
2dbd0 6a 66 64 29 3b 0a 20 20 20 20 20 20 20 20 20 20 jfd);.
2dbe0 20 20 7d 0a 20 20 20 20 20 20 20 20 20 20 20 20 }.
2dbf0 2a 70 45 78 69 73 74 73 20 3d 20 28 66 69 72 73 *pExists = (firs
2dc00 74 21 3d 30 29 3b 0a 20 20 20 20 20 20 20 20 20 t!=0);.
2dc10 20 7d 65 6c 73 65 20 69 66 28 20 72 63 3d 3d 53 }else if( rc==S
2dc20 51 4c 49 54 45 5f 43 41 4e 54 4f 50 45 4e 20 29 QLITE_CANTOPEN )
2dc30 7b 0a 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a {. /*
2dc40 20 49 66 20 77 65 20 63 61 6e 6e 6f 74 20 6f 70 If we cannot op
2dc50 65 6e 20 74 68 65 20 72 6f 6c 6c 62 61 63 6b 20 en the rollback
2dc60 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 20 69 6e 20 journal file in
2dc70 6f 72 64 65 72 20 74 6f 20 73 65 65 20 69 66 0a order to see if.
2dc80 20 20 20 20 20 20 20 20 20 20 20 20 2a 2a 20 69 ** i
2dc90 74 73 20 68 61 73 20 61 20 7a 65 72 6f 20 68 65 ts has a zero he
2dca0 61 64 65 72 2c 20 74 68 61 74 20 6d 69 67 68 74 ader, that might
2dcb0 20 62 65 20 64 75 65 20 74 6f 20 61 6e 20 49 2f be due to an I/
2dcc0 4f 20 65 72 72 6f 72 2c 20 6f 72 0a 20 20 20 20 O error, or.
2dcd0 20 20 20 20 20 20 20 20 2a 2a 20 69 74 20 6d 69 ** it mi
2dce0 67 68 74 20 62 65 20 64 75 65 20 74 6f 20 74 68 ght be due to th
2dcf0 65 20 72 61 63 65 20 63 6f 6e 64 69 74 69 6f 6e e race condition
2dd00 20 64 65 73 63 72 69 62 65 64 20 61 62 6f 76 65 described above
2dd10 20 61 6e 64 20 69 6e 0a 20 20 20 20 20 20 20 20 and in.
2dd20 20 20 20 20 2a 2a 20 74 69 63 6b 65 74 20 23 33 ** ticket #3
2dd30 38 38 33 2e 20 20 45 69 74 68 65 72 20 77 61 79 883. Either way
2dd40 2c 20 61 73 73 75 6d 65 20 74 68 61 74 20 74 68 , assume that th
2dd50 65 20 6a 6f 75 72 6e 61 6c 20 69 73 20 68 6f 74 e journal is hot
2dd60 2e 0a 20 20 20 20 20 20 20 20 20 20 20 20 2a 2a .. **
2dd70 20 54 68 69 73 20 6d 69 67 68 74 20 62 65 20 61 This might be a
2dd80 20 66 61 6c 73 65 20 70 6f 73 69 74 69 76 65 2e false positive.
2dd90 20 20 42 75 74 20 69 66 20 69 74 20 69 73 2c 20 But if it is,
2dda0 74 68 65 6e 20 74 68 65 0a 20 20 20 20 20 20 20 then the.
2ddb0 20 20 20 20 20 2a 2a 20 61 75 74 6f 6d 61 74 69 ** automati
2ddc0 63 20 6a 6f 75 72 6e 61 6c 20 70 6c 61 79 62 61 c journal playba
2ddd0 63 6b 20 61 6e 64 20 72 65 63 6f 76 65 72 79 20 ck and recovery
2dde0 6d 65 63 68 61 6e 69 73 6d 20 77 69 6c 6c 20 64 mechanism will d
2ddf0 65 61 6c 0a 20 20 20 20 20 20 20 20 20 20 20 20 eal.
2de00 2a 2a 20 77 69 74 68 20 69 74 20 75 6e 64 65 72 ** with it under
2de10 20 61 6e 20 45 58 43 4c 55 53 49 56 45 20 6c 6f an EXCLUSIVE lo
2de20 63 6b 20 77 68 65 72 65 20 77 65 20 64 6f 20 6e ck where we do n
2de30 6f 74 20 6e 65 65 64 20 74 6f 0a 20 20 20 20 20 ot need to.
2de40 20 20 20 20 20 20 20 2a 2a 20 77 6f 72 72 79 20 ** worry
2de50 73 6f 20 6d 75 63 68 20 77 69 74 68 20 72 61 63 so much with rac
2de60 65 20 63 6f 6e 64 69 74 69 6f 6e 73 2e 0a 20 20 e conditions..
2de70 20 20 20 20 20 20 20 20 20 20 2a 2f 0a 20 20 20 */.
2de80 20 20 20 20 20 20 20 20 20 2a 70 45 78 69 73 74 *pExist
2de90 73 20 3d 20 31 3b 0a 20 20 20 20 20 20 20 20 20 s = 1;.
2dea0 20 20 20 72 63 20 3d 20 53 51 4c 49 54 45 5f 4f rc = SQLITE_O
2deb0 4b 3b 0a 20 20 20 20 20 20 20 20 20 20 7d 0a 20 K;. }.
2dec0 20 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 7d }. }
2ded0 0a 20 20 20 20 7d 0a 20 20 7d 0a 0a 20 20 72 65 . }. }.. re
2dee0 74 75 72 6e 20 72 63 3b 0a 7d 0a 0a 2f 2a 0a 2a turn rc;.}../*.*
2def0 2a 20 54 68 69 73 20 66 75 6e 63 74 69 6f 6e 20 * This function
2df00 69 73 20 63 61 6c 6c 65 64 20 74 6f 20 6f 62 74 is called to obt
2df10 61 69 6e 20 61 20 73 68 61 72 65 64 20 6c 6f 63 ain a shared loc
2df20 6b 20 6f 6e 20 74 68 65 20 64 61 74 61 62 61 73 k on the databas
2df30 65 20 66 69 6c 65 2e 0a 2a 2a 20 49 74 20 69 73 e file..** It is
2df40 20 69 6c 6c 65 67 61 6c 20 74 6f 20 63 61 6c 6c illegal to call
2df50 20 73 71 6c 69 74 65 33 50 61 67 65 72 41 63 71 sqlite3PagerAcq
2df60 75 69 72 65 28 29 20 75 6e 74 69 6c 20 61 66 74 uire() until aft
2df70 65 72 20 74 68 69 73 20 66 75 6e 63 74 69 6f 6e er this function
2df80 0a 2a 2a 20 68 61 73 20 62 65 65 6e 20 73 75 63 .** has been suc
2df90 63 65 73 73 66 75 6c 6c 79 20 63 61 6c 6c 65 64 cessfully called
2dfa0 2e 20 49 66 20 61 20 73 68 61 72 65 64 2d 6c 6f . If a shared-lo
2dfb0 63 6b 20 69 73 20 61 6c 72 65 61 64 79 20 68 65 ck is already he
2dfc0 6c 64 20 77 68 65 6e 0a 2a 2a 20 74 68 69 73 20 ld when.** this
2dfd0 66 75 6e 63 74 69 6f 6e 20 69 73 20 63 61 6c 6c function is call
2dfe0 65 64 2c 20 69 74 20 69 73 20 61 20 6e 6f 2d 6f ed, it is a no-o
2dff0 70 2e 0a 2a 2a 0a 2a 2a 20 54 68 65 20 66 6f 6c p..**.** The fol
2e000 6c 6f 77 69 6e 67 20 6f 70 65 72 61 74 69 6f 6e lowing operation
2e010 73 20 61 72 65 20 61 6c 73 6f 20 70 65 72 66 6f s are also perfo
2e020 72 6d 65 64 20 62 79 20 74 68 69 73 20 66 75 6e rmed by this fun
2e030 63 74 69 6f 6e 2e 0a 2a 2a 0a 2a 2a 20 20 20 31 ction..**.** 1
2e040 29 20 49 66 20 74 68 65 20 70 61 67 65 72 20 69 ) If the pager i
2e050 73 20 63 75 72 72 65 6e 74 6c 79 20 69 6e 20 50 s currently in P
2e060 41 47 45 52 5f 4f 50 45 4e 20 73 74 61 74 65 20 AGER_OPEN state
2e070 28 6e 6f 20 6c 6f 63 6b 20 68 65 6c 64 0a 2a 2a (no lock held.**
2e080 20 20 20 20 20 20 6f 6e 20 74 68 65 20 64 61 74 on the dat
2e090 61 62 61 73 65 20 66 69 6c 65 29 2c 20 74 68 65 abase file), the
2e0a0 6e 20 61 6e 20 61 74 74 65 6d 70 74 20 69 73 20 n an attempt is
2e0b0 6d 61 64 65 20 74 6f 20 6f 62 74 61 69 6e 20 61 made to obtain a
2e0c0 0a 2a 2a 20 20 20 20 20 20 53 48 41 52 45 44 20 .** SHARED
2e0d0 6c 6f 63 6b 20 6f 6e 20 74 68 65 20 64 61 74 61 lock on the data
2e0e0 62 61 73 65 20 66 69 6c 65 2e 20 49 6d 6d 65 64 base file. Immed
2e0f0 69 61 74 65 6c 79 20 61 66 74 65 72 20 6f 62 74 iately after obt
2e100 61 69 6e 69 6e 67 0a 2a 2a 20 20 20 20 20 20 74 aining.** t
2e110 68 65 20 53 48 41 52 45 44 20 6c 6f 63 6b 2c 20 he SHARED lock,
2e120 74 68 65 20 66 69 6c 65 2d 73 79 73 74 65 6d 20 the file-system
2e130 69 73 20 63 68 65 63 6b 65 64 20 66 6f 72 20 61 is checked for a
2e140 20 68 6f 74 2d 6a 6f 75 72 6e 61 6c 2c 0a 2a 2a hot-journal,.**
2e150 20 20 20 20 20 20 77 68 69 63 68 20 69 73 20 70 which is p
2e160 6c 61 79 65 64 20 62 61 63 6b 20 69 66 20 70 72 layed back if pr
2e170 65 73 65 6e 74 2e 20 46 6f 6c 6c 6f 77 69 6e 67 esent. Following
2e180 20 61 6e 79 20 68 6f 74 2d 6a 6f 75 72 6e 61 6c any hot-journal
2e190 20 0a 2a 2a 20 20 20 20 20 20 72 6f 6c 6c 62 61 .** rollba
2e1a0 63 6b 2c 20 74 68 65 20 63 6f 6e 74 65 6e 74 73 ck, the contents
2e1b0 20 6f 66 20 74 68 65 20 63 61 63 68 65 20 61 72 of the cache ar
2e1c0 65 20 76 61 6c 69 64 61 74 65 64 20 62 79 20 63 e validated by c
2e1d0 68 65 63 6b 69 6e 67 0a 2a 2a 20 20 20 20 20 20 hecking.**
2e1e0 74 68 65 20 27 63 68 61 6e 67 65 2d 63 6f 75 6e the 'change-coun
2e1f0 74 65 72 27 20 66 69 65 6c 64 20 6f 66 20 74 68 ter' field of th
2e200 65 20 64 61 74 61 62 61 73 65 20 66 69 6c 65 20 e database file
2e210 68 65 61 64 65 72 20 61 6e 64 0a 2a 2a 20 20 20 header and.**
2e220 20 20 20 64 69 73 63 61 72 64 65 64 20 69 66 20 discarded if
2e230 74 68 65 79 20 61 72 65 20 66 6f 75 6e 64 20 74 they are found t
2e240 6f 20 62 65 20 69 6e 76 61 6c 69 64 2e 0a 2a 2a o be invalid..**
2e250 0a 2a 2a 20 20 20 32 29 20 49 66 20 74 68 65 20 .** 2) If the
2e260 70 61 67 65 72 20 69 73 20 72 75 6e 6e 69 6e 67 pager is running
2e270 20 69 6e 20 65 78 63 6c 75 73 69 76 65 2d 6d 6f in exclusive-mo
2e280 64 65 2c 20 61 6e 64 20 74 68 65 72 65 20 61 72 de, and there ar
2e290 65 20 63 75 72 72 65 6e 74 6c 79 0a 2a 2a 20 20 e currently.**
2e2a0 20 20 20 20 6e 6f 20 6f 75 74 73 74 61 6e 64 69 no outstandi
2e2b0 6e 67 20 72 65 66 65 72 65 6e 63 65 73 20 74 6f ng references to
2e2c0 20 61 6e 79 20 70 61 67 65 73 2c 20 61 6e 64 20 any pages, and
2e2d0 69 73 20 69 6e 20 74 68 65 20 65 72 72 6f 72 20 is in the error
2e2e0 73 74 61 74 65 2c 0a 2a 2a 20 20 20 20 20 20 74 state,.** t
2e2f0 68 65 6e 20 61 6e 20 61 74 74 65 6d 70 74 20 69 hen an attempt i
2e300 73 20 6d 61 64 65 20 74 6f 20 63 6c 65 61 72 20 s made to clear
2e310 74 68 65 20 65 72 72 6f 72 20 73 74 61 74 65 20 the error state
2e320 62 79 20 64 69 73 63 61 72 64 69 6e 67 0a 2a 2a by discarding.**
2e330 20 20 20 20 20 20 74 68 65 20 63 6f 6e 74 65 6e the conten
2e340 74 73 20 6f 66 20 74 68 65 20 70 61 67 65 20 63 ts of the page c
2e350 61 63 68 65 20 61 6e 64 20 72 6f 6c 6c 69 6e 67 ache and rolling
2e360 20 62 61 63 6b 20 61 6e 79 20 6f 70 65 6e 20 6a back any open j
2e370 6f 75 72 6e 61 6c 0a 2a 2a 20 20 20 20 20 20 66 ournal.** f
2e380 69 6c 65 2e 0a 2a 2a 0a 2a 2a 20 49 66 20 65 76 ile..**.** If ev
2e390 65 72 79 74 68 69 6e 67 20 69 73 20 73 75 63 63 erything is succ
2e3a0 65 73 73 66 75 6c 2c 20 53 51 4c 49 54 45 5f 4f essful, SQLITE_O
2e3b0 4b 20 69 73 20 72 65 74 75 72 6e 65 64 2e 20 49 K is returned. I
2e3c0 66 20 61 6e 20 49 4f 20 65 72 72 6f 72 20 0a 2a f an IO error .*
2e3d0 2a 20 6f 63 63 75 72 73 20 77 68 69 6c 65 20 6c * occurs while l
2e3e0 6f 63 6b 69 6e 67 20 74 68 65 20 64 61 74 61 62 ocking the datab
2e3f0 61 73 65 2c 20 63 68 65 63 6b 69 6e 67 20 66 6f ase, checking fo
2e400 72 20 61 20 68 6f 74 2d 6a 6f 75 72 6e 61 6c 20 r a hot-journal
2e410 66 69 6c 65 20 6f 72 20 0a 2a 2a 20 72 6f 6c 6c file or .** roll
2e420 69 6e 67 20 62 61 63 6b 20 61 20 6a 6f 75 72 6e ing back a journ
2e430 61 6c 20 66 69 6c 65 2c 20 74 68 65 20 49 4f 20 al file, the IO
2e440 65 72 72 6f 72 20 63 6f 64 65 20 69 73 20 72 65 error code is re
2e450 74 75 72 6e 65 64 2e 0a 2a 2f 0a 69 6e 74 20 73 turned..*/.int s
2e460 71 6c 69 74 65 33 50 61 67 65 72 53 68 61 72 65 qlite3PagerShare
2e470 64 4c 6f 63 6b 28 50 61 67 65 72 20 2a 70 50 61 dLock(Pager *pPa
2e480 67 65 72 29 7b 0a 20 20 69 6e 74 20 72 63 20 3d ger){. int rc =
2e490 20 53 51 4c 49 54 45 5f 4f 4b 3b 20 20 20 20 20 SQLITE_OK;
2e4a0 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 52 65 /* Re
2e4b0 74 75 72 6e 20 63 6f 64 65 20 2a 2f 0a 0a 20 20 turn code */..
2e4c0 2f 2a 20 54 68 69 73 20 72 6f 75 74 69 6e 65 20 /* This routine
2e4d0 69 73 20 6f 6e 6c 79 20 63 61 6c 6c 65 64 20 66 is only called f
2e4e0 72 6f 6d 20 62 2d 74 72 65 65 20 61 6e 64 20 6f rom b-tree and o
2e4f0 6e 6c 79 20 77 68 65 6e 20 74 68 65 72 65 20 61 nly when there a
2e500 72 65 20 6e 6f 0a 20 20 2a 2a 20 6f 75 74 73 74 re no. ** outst
2e510 61 6e 64 69 6e 67 20 70 61 67 65 73 2e 20 54 68 anding pages. Th
2e520 69 73 20 69 6d 70 6c 69 65 73 20 74 68 61 74 20 is implies that
2e530 74 68 65 20 70 61 67 65 72 20 73 74 61 74 65 20 the pager state
2e540 73 68 6f 75 6c 64 20 65 69 74 68 65 72 0a 20 20 should either.
2e550 2a 2a 20 62 65 20 4f 50 45 4e 20 6f 72 20 52 45 ** be OPEN or RE
2e560 41 44 45 52 2e 20 52 45 41 44 45 52 20 69 73 20 ADER. READER is
2e570 6f 6e 6c 79 20 70 6f 73 73 69 62 6c 65 20 69 66 only possible if
2e580 20 74 68 65 20 70 61 67 65 72 20 69 73 20 6f 72 the pager is or
2e590 20 77 61 73 20 69 6e 20 0a 20 20 2a 2a 20 65 78 was in . ** ex
2e5a0 63 6c 75 73 69 76 65 20 61 63 63 65 73 73 20 6d clusive access m
2e5b0 6f 64 65 2e 0a 20 20 2a 2f 0a 20 20 61 73 73 65 ode.. */. asse
2e5c0 72 74 28 20 73 71 6c 69 74 65 33 50 63 61 63 68 rt( sqlite3Pcach
2e5d0 65 52 65 66 43 6f 75 6e 74 28 70 50 61 67 65 72 eRefCount(pPager
2e5e0 2d 3e 70 50 43 61 63 68 65 29 3d 3d 30 20 29 3b ->pPCache)==0 );
2e5f0 0a 20 20 61 73 73 65 72 74 28 20 61 73 73 65 72 . assert( asser
2e600 74 5f 70 61 67 65 72 5f 73 74 61 74 65 28 70 50 t_pager_state(pP
2e610 61 67 65 72 29 20 29 3b 0a 20 20 61 73 73 65 72 ager) );. asser
2e620 74 28 20 70 50 61 67 65 72 2d 3e 65 53 74 61 74 t( pPager->eStat
2e630 65 3d 3d 50 41 47 45 52 5f 4f 50 45 4e 20 7c 7c e==PAGER_OPEN ||
2e640 20 70 50 61 67 65 72 2d 3e 65 53 74 61 74 65 3d pPager->eState=
2e650 3d 50 41 47 45 52 5f 52 45 41 44 45 52 20 29 3b =PAGER_READER );
2e660 0a 20 20 69 66 28 20 4e 45 56 45 52 28 4d 45 4d . if( NEVER(MEM
2e670 44 42 20 26 26 20 70 50 61 67 65 72 2d 3e 65 72 DB && pPager->er
2e680 72 43 6f 64 65 29 20 29 7b 20 72 65 74 75 72 6e rCode) ){ return
2e690 20 70 50 61 67 65 72 2d 3e 65 72 72 43 6f 64 65 pPager->errCode
2e6a0 3b 20 7d 0a 0a 20 20 69 66 28 20 21 70 61 67 65 ; }.. if( !page
2e6b0 72 55 73 65 57 61 6c 28 70 50 61 67 65 72 29 20 rUseWal(pPager)
2e6c0 26 26 20 70 50 61 67 65 72 2d 3e 65 53 74 61 74 && pPager->eStat
2e6d0 65 3d 3d 50 41 47 45 52 5f 4f 50 45 4e 20 29 7b e==PAGER_OPEN ){
2e6e0 0a 20 20 20 20 69 6e 74 20 62 48 6f 74 4a 6f 75 . int bHotJou
2e6f0 72 6e 61 6c 20 3d 20 31 3b 20 20 20 20 20 20 20 rnal = 1;
2e700 20 20 20 2f 2a 20 54 72 75 65 20 69 66 20 74 68 /* True if th
2e710 65 72 65 20 65 78 69 73 74 73 20 61 20 68 6f 74 ere exists a hot
2e720 20 6a 6f 75 72 6e 61 6c 2d 66 69 6c 65 20 2a 2f journal-file */
2e730 0a 0a 20 20 20 20 61 73 73 65 72 74 28 20 21 4d .. assert( !M
2e740 45 4d 44 42 20 29 3b 0a 20 20 20 20 61 73 73 65 EMDB );. asse
2e750 72 74 28 20 70 50 61 67 65 72 2d 3e 6e 6f 52 65 rt( pPager->noRe
2e760 61 64 6c 6f 63 6b 3d 3d 30 20 7c 7c 20 70 50 61 adlock==0 || pPa
2e770 67 65 72 2d 3e 72 65 61 64 4f 6e 6c 79 20 29 3b ger->readOnly );
2e780 0a 0a 20 20 20 20 69 66 28 20 70 50 61 67 65 72 .. if( pPager
2e790 2d 3e 6e 6f 52 65 61 64 6c 6f 63 6b 3d 3d 30 20 ->noReadlock==0
2e7a0 29 7b 0a 20 20 20 20 20 20 72 63 20 3d 20 70 61 ){. rc = pa
2e7b0 67 65 72 5f 77 61 69 74 5f 6f 6e 5f 6c 6f 63 6b ger_wait_on_lock
2e7c0 28 70 50 61 67 65 72 2c 20 53 48 41 52 45 44 5f (pPager, SHARED_
2e7d0 4c 4f 43 4b 29 3b 0a 20 20 20 20 20 20 69 66 28 LOCK);. if(
2e7e0 20 72 63 21 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 rc!=SQLITE_OK )
2e7f0 7b 0a 20 20 20 20 20 20 20 20 61 73 73 65 72 74 {. assert
2e800 28 20 70 50 61 67 65 72 2d 3e 65 4c 6f 63 6b 3d ( pPager->eLock=
2e810 3d 4e 4f 5f 4c 4f 43 4b 20 7c 7c 20 70 50 61 67 =NO_LOCK || pPag
2e820 65 72 2d 3e 65 4c 6f 63 6b 3d 3d 55 4e 4b 4e 4f er->eLock==UNKNO
2e830 57 4e 5f 4c 4f 43 4b 20 29 3b 0a 20 20 20 20 20 WN_LOCK );.
2e840 20 20 20 67 6f 74 6f 20 66 61 69 6c 65 64 3b 0a goto failed;.
2e850 20 20 20 20 20 20 7d 0a 20 20 20 20 7d 0a 0a 20 }. }..
2e860 20 20 20 2f 2a 20 49 66 20 61 20 6a 6f 75 72 6e /* If a journ
2e870 61 6c 20 66 69 6c 65 20 65 78 69 73 74 73 2c 20 al file exists,
2e880 61 6e 64 20 74 68 65 72 65 20 69 73 20 6e 6f 20 and there is no
2e890 52 45 53 45 52 56 45 44 20 6c 6f 63 6b 20 6f 6e RESERVED lock on
2e8a0 20 74 68 65 0a 20 20 20 20 2a 2a 20 64 61 74 61 the. ** data
2e8b0 62 61 73 65 20 66 69 6c 65 2c 20 74 68 65 6e 20 base file, then
2e8c0 69 74 20 65 69 74 68 65 72 20 6e 65 65 64 73 20 it either needs
2e8d0 74 6f 20 62 65 20 70 6c 61 79 65 64 20 62 61 63 to be played bac
2e8e0 6b 20 6f 72 20 64 65 6c 65 74 65 64 2e 0a 20 20 k or deleted..
2e8f0 20 20 2a 2f 0a 20 20 20 20 69 66 28 20 70 50 61 */. if( pPa
2e900 67 65 72 2d 3e 65 4c 6f 63 6b 3c 3d 53 48 41 52 ger->eLock<=SHAR
2e910 45 44 5f 4c 4f 43 4b 20 29 7b 0a 20 20 20 20 20 ED_LOCK ){.
2e920 20 72 63 20 3d 20 68 61 73 48 6f 74 4a 6f 75 72 rc = hasHotJour
2e930 6e 61 6c 28 70 50 61 67 65 72 2c 20 26 62 48 6f nal(pPager, &bHo
2e940 74 4a 6f 75 72 6e 61 6c 29 3b 0a 20 20 20 20 7d tJournal);. }
2e950 0a 20 20 20 20 69 66 28 20 72 63 21 3d 53 51 4c . if( rc!=SQL
2e960 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 20 20 ITE_OK ){.
2e970 67 6f 74 6f 20 66 61 69 6c 65 64 3b 0a 20 20 20 goto failed;.
2e980 20 7d 0a 20 20 20 20 69 66 28 20 62 48 6f 74 4a }. if( bHotJ
2e990 6f 75 72 6e 61 6c 20 29 7b 0a 20 20 20 20 20 20 ournal ){.
2e9a0 2f 2a 20 47 65 74 20 61 6e 20 45 58 43 4c 55 53 /* Get an EXCLUS
2e9b0 49 56 45 20 6c 6f 63 6b 20 6f 6e 20 74 68 65 20 IVE lock on the
2e9c0 64 61 74 61 62 61 73 65 20 66 69 6c 65 2e 20 41 database file. A
2e9d0 74 20 74 68 69 73 20 70 6f 69 6e 74 20 69 74 20 t this point it
2e9e0 69 73 0a 20 20 20 20 20 20 2a 2a 20 69 6d 70 6f is. ** impo
2e9f0 72 74 61 6e 74 20 74 68 61 74 20 61 20 52 45 53 rtant that a RES
2ea00 45 52 56 45 44 20 6c 6f 63 6b 20 69 73 20 6e 6f ERVED lock is no
2ea10 74 20 6f 62 74 61 69 6e 65 64 20 6f 6e 20 74 68 t obtained on th
2ea20 65 20 77 61 79 20 74 6f 20 74 68 65 0a 20 20 20 e way to the.
2ea30 20 20 20 2a 2a 20 45 58 43 4c 55 53 49 56 45 20 ** EXCLUSIVE
2ea40 6c 6f 63 6b 2e 20 49 66 20 69 74 20 77 65 72 65 lock. If it were
2ea50 2c 20 61 6e 6f 74 68 65 72 20 70 72 6f 63 65 73 , another proces
2ea60 73 20 6d 69 67 68 74 20 6f 70 65 6e 20 74 68 65 s might open the
2ea70 0a 20 20 20 20 20 20 2a 2a 20 64 61 74 61 62 61 . ** databa
2ea80 73 65 20 66 69 6c 65 2c 20 64 65 74 65 63 74 20 se file, detect
2ea90 74 68 65 20 52 45 53 45 52 56 45 44 20 6c 6f 63 the RESERVED loc
2eaa0 6b 2c 20 61 6e 64 20 63 6f 6e 63 6c 75 64 65 20 k, and conclude
2eab0 74 68 61 74 20 74 68 65 0a 20 20 20 20 20 20 2a that the. *
2eac0 2a 20 64 61 74 61 62 61 73 65 20 69 73 20 73 61 * database is sa
2ead0 66 65 20 74 6f 20 72 65 61 64 20 77 68 69 6c 65 fe to read while
2eae0 20 74 68 69 73 20 70 72 6f 63 65 73 73 20 69 73 this process is
2eaf0 20 73 74 69 6c 6c 20 72 6f 6c 6c 69 6e 67 20 74 still rolling t
2eb00 68 65 20 0a 20 20 20 20 20 20 2a 2a 20 68 6f 74 he . ** hot
2eb10 2d 6a 6f 75 72 6e 61 6c 20 62 61 63 6b 2e 0a 20 -journal back..
2eb20 20 20 20 20 20 2a 2a 20 0a 20 20 20 20 20 20 2a ** . *
2eb30 2a 20 42 65 63 61 75 73 65 20 74 68 65 20 69 6e * Because the in
2eb40 74 65 72 6d 65 64 69 61 74 65 20 52 45 53 45 52 termediate RESER
2eb50 56 45 44 20 6c 6f 63 6b 20 69 73 20 6e 6f 74 20 VED lock is not
2eb60 72 65 71 75 65 73 74 65 64 2c 20 61 6e 79 0a 20 requested, any.
2eb70 20 20 20 20 20 2a 2a 20 6f 74 68 65 72 20 70 72 ** other pr
2eb80 6f 63 65 73 73 20 61 74 74 65 6d 70 74 69 6e 67 ocess attempting
2eb90 20 74 6f 20 61 63 63 65 73 73 20 74 68 65 20 64 to access the d
2eba0 61 74 61 62 61 73 65 20 66 69 6c 65 20 77 69 6c atabase file wil
2ebb0 6c 20 67 65 74 20 74 6f 20 0a 20 20 20 20 20 20 l get to .
2ebc0 2a 2a 20 74 68 69 73 20 70 6f 69 6e 74 20 69 6e ** this point in
2ebd0 20 74 68 65 20 63 6f 64 65 20 61 6e 64 20 66 61 the code and fa
2ebe0 69 6c 20 74 6f 20 6f 62 74 61 69 6e 20 69 74 73 il to obtain its
2ebf0 20 6f 77 6e 20 45 58 43 4c 55 53 49 56 45 20 6c own EXCLUSIVE l
2ec00 6f 63 6b 20 0a 20 20 20 20 20 20 2a 2a 20 6f 6e ock . ** on
2ec10 20 74 68 65 20 64 61 74 61 62 61 73 65 20 66 69 the database fi
2ec20 6c 65 2e 0a 20 20 20 20 20 20 2a 2a 0a 20 20 20 le.. **.
2ec30 20 20 20 2a 2a 20 55 6e 6c 65 73 73 20 74 68 65 ** Unless the
2ec40 20 70 61 67 65 72 20 69 73 20 69 6e 20 6c 6f 63 pager is in loc
2ec50 6b 69 6e 67 5f 6d 6f 64 65 3d 65 78 63 6c 75 73 king_mode=exclus
2ec60 69 76 65 20 6d 6f 64 65 2c 20 74 68 65 20 6c 6f ive mode, the lo
2ec70 63 6b 20 69 73 0a 20 20 20 20 20 20 2a 2a 20 64 ck is. ** d
2ec80 6f 77 6e 67 72 61 64 65 64 20 74 6f 20 53 48 41 owngraded to SHA
2ec90 52 45 44 5f 4c 4f 43 4b 20 62 65 66 6f 72 65 20 RED_LOCK before
2eca0 74 68 69 73 20 66 75 6e 63 74 69 6f 6e 20 72 65 this function re
2ecb0 74 75 72 6e 73 2e 0a 20 20 20 20 20 20 2a 2f 0a turns.. */.
2ecc0 20 20 20 20 20 20 72 63 20 3d 20 70 61 67 65 72 rc = pager
2ecd0 4c 6f 63 6b 44 62 28 70 50 61 67 65 72 2c 20 45 LockDb(pPager, E
2ece0 58 43 4c 55 53 49 56 45 5f 4c 4f 43 4b 29 3b 0a XCLUSIVE_LOCK);.
2ecf0 20 20 20 20 20 20 69 66 28 20 72 63 21 3d 53 51 if( rc!=SQ
2ed00 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 20 LITE_OK ){.
2ed10 20 20 20 67 6f 74 6f 20 66 61 69 6c 65 64 3b 0a goto failed;.
2ed20 20 20 20 20 20 20 7d 0a 20 0a 20 20 20 20 20 20 }. .
2ed30 2f 2a 20 49 66 20 69 74 20 69 73 20 6e 6f 74 20 /* If it is not
2ed40 61 6c 72 65 61 64 79 20 6f 70 65 6e 20 61 6e 64 already open and
2ed50 20 74 68 65 20 66 69 6c 65 20 65 78 69 73 74 73 the file exists
2ed60 20 6f 6e 20 64 69 73 6b 2c 20 6f 70 65 6e 20 74 on disk, open t
2ed70 68 65 20 0a 20 20 20 20 20 20 2a 2a 20 6a 6f 75 he . ** jou
2ed80 72 6e 61 6c 20 66 6f 72 20 72 65 61 64 2f 77 72 rnal for read/wr
2ed90 69 74 65 20 61 63 63 65 73 73 2e 20 57 72 69 74 ite access. Writ
2eda0 65 20 61 63 63 65 73 73 20 69 73 20 72 65 71 75 e access is requ
2edb0 69 72 65 64 20 62 65 63 61 75 73 65 20 0a 20 20 ired because .
2edc0 20 20 20 20 2a 2a 20 69 6e 20 65 78 63 6c 75 73 ** in exclus
2edd0 69 76 65 2d 61 63 63 65 73 73 20 6d 6f 64 65 20 ive-access mode
2ede0 74 68 65 20 66 69 6c 65 20 64 65 73 63 72 69 70 the file descrip
2edf0 74 6f 72 20 77 69 6c 6c 20 62 65 20 6b 65 70 74 tor will be kept
2ee00 20 6f 70 65 6e 20 0a 20 20 20 20 20 20 2a 2a 20 open . **
2ee10 61 6e 64 20 70 6f 73 73 69 62 6c 79 20 75 73 65 and possibly use
2ee20 64 20 66 6f 72 20 61 20 74 72 61 6e 73 61 63 74 d for a transact
2ee30 69 6f 6e 20 6c 61 74 65 72 20 6f 6e 2e 20 41 6c ion later on. Al
2ee40 73 6f 2c 20 77 72 69 74 65 2d 61 63 63 65 73 73 so, write-access
2ee50 20 0a 20 20 20 20 20 20 2a 2a 20 69 73 20 75 73 . ** is us
2ee60 75 61 6c 6c 79 20 72 65 71 75 69 72 65 64 20 74 ually required t
2ee70 6f 20 66 69 6e 61 6c 69 7a 65 20 74 68 65 20 6a o finalize the j
2ee80 6f 75 72 6e 61 6c 20 69 6e 20 6a 6f 75 72 6e 61 ournal in journa
2ee90 6c 5f 6d 6f 64 65 3d 70 65 72 73 69 73 74 20 0a l_mode=persist .
2eea0 20 20 20 20 20 20 2a 2a 20 6d 6f 64 65 20 28 61 ** mode (a
2eeb0 6e 64 20 61 6c 73 6f 20 66 6f 72 20 6a 6f 75 72 nd also for jour
2eec0 6e 61 6c 5f 6d 6f 64 65 3d 74 72 75 6e 63 61 74 nal_mode=truncat
2eed0 65 20 6f 6e 20 73 6f 6d 65 20 73 79 73 74 65 6d e on some system
2eee0 73 29 2e 0a 20 20 20 20 20 20 2a 2a 0a 20 20 20 s).. **.
2eef0 20 20 20 2a 2a 20 49 66 20 74 68 65 20 6a 6f 75 ** If the jou
2ef00 72 6e 61 6c 20 64 6f 65 73 20 6e 6f 74 20 65 78 rnal does not ex
2ef10 69 73 74 2c 20 69 74 20 75 73 75 61 6c 6c 79 20 ist, it usually
2ef20 6d 65 61 6e 73 20 74 68 61 74 20 73 6f 6d 65 20 means that some
2ef30 0a 20 20 20 20 20 20 2a 2a 20 6f 74 68 65 72 20 . ** other
2ef40 63 6f 6e 6e 65 63 74 69 6f 6e 20 6d 61 6e 61 67 connection manag
2ef50 65 64 20 74 6f 20 67 65 74 20 69 6e 20 61 6e 64 ed to get in and
2ef60 20 72 6f 6c 6c 20 69 74 20 62 61 63 6b 20 62 65 roll it back be
2ef70 66 6f 72 65 20 0a 20 20 20 20 20 20 2a 2a 20 74 fore . ** t
2ef80 68 69 73 20 63 6f 6e 6e 65 63 74 69 6f 6e 20 6f his connection o
2ef90 62 74 61 69 6e 65 64 20 74 68 65 20 65 78 63 6c btained the excl
2efa0 75 73 69 76 65 20 6c 6f 63 6b 20 61 62 6f 76 65 usive lock above
2efb0 2e 20 4f 72 2c 20 69 74 20 0a 20 20 20 20 20 20 . Or, it .
2efc0 2a 2a 20 6d 61 79 20 6d 65 61 6e 20 74 68 61 74 ** may mean that
2efd0 20 74 68 65 20 70 61 67 65 72 20 77 61 73 20 69 the pager was i
2efe0 6e 20 74 68 65 20 65 72 72 6f 72 2d 73 74 61 74 n the error-stat
2eff0 65 20 77 68 65 6e 20 74 68 69 73 0a 20 20 20 20 e when this.
2f000 20 20 2a 2a 20 66 75 6e 63 74 69 6f 6e 20 77 61 ** function wa
2f010 73 20 63 61 6c 6c 65 64 20 61 6e 64 20 74 68 65 s called and the
2f020 20 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 20 64 6f journal file do
2f030 65 73 20 6e 6f 74 20 65 78 69 73 74 2e 0a 20 20 es not exist..
2f040 20 20 20 20 2a 2f 0a 20 20 20 20 20 20 69 66 28 */. if(
2f050 20 21 69 73 4f 70 65 6e 28 70 50 61 67 65 72 2d !isOpen(pPager-
2f060 3e 6a 66 64 29 20 29 7b 0a 20 20 20 20 20 20 20 >jfd) ){.
2f070 20 73 71 6c 69 74 65 33 5f 76 66 73 20 2a 20 63 sqlite3_vfs * c
2f080 6f 6e 73 74 20 70 56 66 73 20 3d 20 70 50 61 67 onst pVfs = pPag
2f090 65 72 2d 3e 70 56 66 73 3b 0a 20 20 20 20 20 20 er->pVfs;.
2f0a0 20 20 69 6e 74 20 62 45 78 69 73 74 73 3b 20 20 int bExists;
2f0b0 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 54 /* T
2f0c0 72 75 65 20 69 66 20 6a 6f 75 72 6e 61 6c 20 66 rue if journal f
2f0d0 69 6c 65 20 65 78 69 73 74 73 20 2a 2f 0a 20 20 ile exists */.
2f0e0 20 20 20 20 20 20 72 63 20 3d 20 73 71 6c 69 74 rc = sqlit
2f0f0 65 33 4f 73 41 63 63 65 73 73 28 0a 20 20 20 20 e3OsAccess(.
2f100 20 20 20 20 20 20 20 20 70 56 66 73 2c 20 70 50 pVfs, pP
2f110 61 67 65 72 2d 3e 7a 4a 6f 75 72 6e 61 6c 2c 20 ager->zJournal,
2f120 53 51 4c 49 54 45 5f 41 43 43 45 53 53 5f 45 58 SQLITE_ACCESS_EX
2f130 49 53 54 53 2c 20 26 62 45 78 69 73 74 73 29 3b ISTS, &bExists);
2f140 0a 20 20 20 20 20 20 20 20 69 66 28 20 72 63 3d . if( rc=
2f150 3d 53 51 4c 49 54 45 5f 4f 4b 20 26 26 20 62 45 =SQLITE_OK && bE
2f160 78 69 73 74 73 20 29 7b 0a 20 20 20 20 20 20 20 xists ){.
2f170 20 20 20 69 6e 74 20 66 6f 75 74 20 3d 20 30 3b int fout = 0;
2f180 0a 20 20 20 20 20 20 20 20 20 20 69 6e 74 20 66 . int f
2f190 20 3d 20 53 51 4c 49 54 45 5f 4f 50 45 4e 5f 52 = SQLITE_OPEN_R
2f1a0 45 41 44 57 52 49 54 45 7c 53 51 4c 49 54 45 5f EADWRITE|SQLITE_
2f1b0 4f 50 45 4e 5f 4d 41 49 4e 5f 4a 4f 55 52 4e 41 OPEN_MAIN_JOURNA
2f1c0 4c 3b 0a 20 20 20 20 20 20 20 20 20 20 61 73 73 L;. ass
2f1d0 65 72 74 28 20 21 70 50 61 67 65 72 2d 3e 74 65 ert( !pPager->te
2f1e0 6d 70 46 69 6c 65 20 29 3b 0a 20 20 20 20 20 20 mpFile );.
2f1f0 20 20 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33 rc = sqlite3
2f200 4f 73 4f 70 65 6e 28 70 56 66 73 2c 20 70 50 61 OsOpen(pVfs, pPa
2f210 67 65 72 2d 3e 7a 4a 6f 75 72 6e 61 6c 2c 20 70 ger->zJournal, p
2f220 50 61 67 65 72 2d 3e 6a 66 64 2c 20 66 2c 20 26 Pager->jfd, f, &
2f230 66 6f 75 74 29 3b 0a 20 20 20 20 20 20 20 20 20 fout);.
2f240 20 61 73 73 65 72 74 28 20 72 63 21 3d 53 51 4c assert( rc!=SQL
2f250 49 54 45 5f 4f 4b 20 7c 7c 20 69 73 4f 70 65 6e ITE_OK || isOpen
2f260 28 70 50 61 67 65 72 2d 3e 6a 66 64 29 20 29 3b (pPager->jfd) );
2f270 0a 20 20 20 20 20 20 20 20 20 20 69 66 28 20 72 . if( r
2f280 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 26 26 20 c==SQLITE_OK &&
2f290 66 6f 75 74 26 53 51 4c 49 54 45 5f 4f 50 45 4e fout&SQLITE_OPEN
2f2a0 5f 52 45 41 44 4f 4e 4c 59 20 29 7b 0a 20 20 20 _READONLY ){.
2f2b0 20 20 20 20 20 20 20 20 20 72 63 20 3d 20 53 51 rc = SQ
2f2c0 4c 49 54 45 5f 43 41 4e 54 4f 50 45 4e 5f 42 4b LITE_CANTOPEN_BK
2f2d0 50 54 3b 0a 20 20 20 20 20 20 20 20 20 20 20 20 PT;.
2f2e0 73 71 6c 69 74 65 33 4f 73 43 6c 6f 73 65 28 70 sqlite3OsClose(p
2f2f0 50 61 67 65 72 2d 3e 6a 66 64 29 3b 0a 20 20 20 Pager->jfd);.
2f300 20 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 20 }.
2f310 20 7d 0a 20 20 20 20 20 20 7d 0a 20 0a 20 20 20 }. }. .
2f320 20 20 20 2f 2a 20 50 6c 61 79 62 61 63 6b 20 61 /* Playback a
2f330 6e 64 20 64 65 6c 65 74 65 20 74 68 65 20 6a 6f nd delete the jo
2f340 75 72 6e 61 6c 2e 20 20 44 72 6f 70 20 74 68 65 urnal. Drop the
2f350 20 64 61 74 61 62 61 73 65 20 77 72 69 74 65 0a database write.
2f360 20 20 20 20 20 20 2a 2a 20 6c 6f 63 6b 20 61 6e ** lock an
2f370 64 20 72 65 61 63 71 75 69 72 65 20 74 68 65 20 d reacquire the
2f380 72 65 61 64 20 6c 6f 63 6b 2e 20 50 75 72 67 65 read lock. Purge
2f390 20 74 68 65 20 63 61 63 68 65 20 62 65 66 6f 72 the cache befor
2f3a0 65 0a 20 20 20 20 20 20 2a 2a 20 70 6c 61 79 69 e. ** playi
2f3b0 6e 67 20 62 61 63 6b 20 74 68 65 20 68 6f 74 2d ng back the hot-
2f3c0 6a 6f 75 72 6e 61 6c 20 73 6f 20 74 68 61 74 20 journal so that
2f3d0 77 65 20 64 6f 6e 27 74 20 65 6e 64 20 75 70 20 we don't end up
2f3e0 77 69 74 68 0a 20 20 20 20 20 20 2a 2a 20 61 6e with. ** an
2f3f0 20 69 6e 63 6f 6e 73 69 73 74 65 6e 74 20 63 61 inconsistent ca
2f400 63 68 65 2e 20 20 53 79 6e 63 20 74 68 65 20 68 che. Sync the h
2f410 6f 74 20 6a 6f 75 72 6e 61 6c 20 62 65 66 6f 72 ot journal befor
2f420 65 20 70 6c 61 79 69 6e 67 0a 20 20 20 20 20 20 e playing.
2f430 2a 2a 20 69 74 20 62 61 63 6b 20 73 69 6e 63 65 ** it back since
2f440 20 74 68 65 20 70 72 6f 63 65 73 73 20 74 68 61 the process tha
2f450 74 20 63 72 61 73 68 65 64 20 61 6e 64 20 6c 65 t crashed and le
2f460 66 74 20 74 68 65 20 68 6f 74 20 6a 6f 75 72 6e ft the hot journ
2f470 61 6c 0a 20 20 20 20 20 20 2a 2a 20 70 72 6f 62 al. ** prob
2f480 61 62 6c 79 20 64 69 64 20 6e 6f 74 20 73 79 6e ably did not syn
2f490 63 20 69 74 20 61 6e 64 20 77 65 20 61 72 65 20 c it and we are
2f4a0 72 65 71 75 69 72 65 64 20 74 6f 20 61 6c 77 61 required to alwa
2f4b0 79 73 20 73 79 6e 63 0a 20 20 20 20 20 20 2a 2a ys sync. **
2f4c0 20 74 68 65 20 6a 6f 75 72 6e 61 6c 20 62 65 66 the journal bef
2f4d0 6f 72 65 20 70 6c 61 79 69 6e 67 20 69 74 20 62 ore playing it b
2f4e0 61 63 6b 2e 0a 20 20 20 20 20 20 2a 2f 0a 20 20 ack.. */.
2f4f0 20 20 20 20 69 66 28 20 69 73 4f 70 65 6e 28 70 if( isOpen(p
2f500 50 61 67 65 72 2d 3e 6a 66 64 29 20 29 7b 0a 20 Pager->jfd) ){.
2f510 20 20 20 20 20 20 20 61 73 73 65 72 74 28 20 72 assert( r
2f520 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 3b 0a c==SQLITE_OK );.
2f530 20 20 20 20 20 20 20 20 72 63 20 3d 20 70 61 67 rc = pag
2f540 65 72 53 79 6e 63 48 6f 74 4a 6f 75 72 6e 61 6c erSyncHotJournal
2f550 28 70 50 61 67 65 72 29 3b 0a 20 20 20 20 20 20 (pPager);.
2f560 20 20 69 66 28 20 72 63 3d 3d 53 51 4c 49 54 45 if( rc==SQLITE
2f570 5f 4f 4b 20 29 7b 0a 20 20 20 20 20 20 20 20 20 _OK ){.
2f580 20 72 63 20 3d 20 70 61 67 65 72 5f 70 6c 61 79 rc = pager_play
2f590 62 61 63 6b 28 70 50 61 67 65 72 2c 20 31 29 3b back(pPager, 1);
2f5a0 0a 20 20 20 20 20 20 20 20 20 20 70 50 61 67 65 . pPage
2f5b0 72 2d 3e 65 53 74 61 74 65 20 3d 20 50 41 47 45 r->eState = PAGE
2f5c0 52 5f 4f 50 45 4e 3b 0a 20 20 20 20 20 20 20 20 R_OPEN;.
2f5d0 7d 0a 20 20 20 20 20 20 7d 65 6c 73 65 20 69 66 }. }else if
2f5e0 28 20 21 70 50 61 67 65 72 2d 3e 65 78 63 6c 75 ( !pPager->exclu
2f5f0 73 69 76 65 4d 6f 64 65 20 29 7b 0a 20 20 20 20 siveMode ){.
2f600 20 20 20 20 70 61 67 65 72 55 6e 6c 6f 63 6b 44 pagerUnlockD
2f610 62 28 70 50 61 67 65 72 2c 20 53 48 41 52 45 44 b(pPager, SHARED
2f620 5f 4c 4f 43 4b 29 3b 0a 20 20 20 20 20 20 7d 0a _LOCK);. }.
2f630 0a 20 20 20 20 20 20 69 66 28 20 72 63 21 3d 53 . if( rc!=S
2f640 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 QLITE_OK ){.
2f650 20 20 20 20 2f 2a 20 54 68 69 73 20 62 72 61 6e /* This bran
2f660 63 68 20 69 73 20 74 61 6b 65 6e 20 69 66 20 61 ch is taken if a
2f670 6e 20 65 72 72 6f 72 20 6f 63 63 75 72 73 20 77 n error occurs w
2f680 68 69 6c 65 20 74 72 79 69 6e 67 20 74 6f 20 6f hile trying to o
2f690 70 65 6e 0a 20 20 20 20 20 20 20 20 2a 2a 20 6f pen. ** o
2f6a0 72 20 72 6f 6c 6c 20 62 61 63 6b 20 61 20 68 6f r roll back a ho
2f6b0 74 2d 6a 6f 75 72 6e 61 6c 20 77 68 69 6c 65 20 t-journal while
2f6c0 68 6f 6c 64 69 6e 67 20 61 6e 20 45 58 43 4c 55 holding an EXCLU
2f6d0 53 49 56 45 20 6c 6f 63 6b 2e 20 54 68 65 0a 20 SIVE lock. The.
2f6e0 20 20 20 20 20 20 20 2a 2a 20 70 61 67 65 72 5f ** pager_
2f6f0 75 6e 6c 6f 63 6b 28 29 20 72 6f 75 74 69 6e 65 unlock() routine
2f700 20 77 69 6c 6c 20 62 65 20 63 61 6c 6c 65 64 20 will be called
2f710 62 65 66 6f 72 65 20 72 65 74 75 72 6e 69 6e 67 before returning
2f720 20 74 6f 20 75 6e 6c 6f 63 6b 0a 20 20 20 20 20 to unlock.
2f730 20 20 20 2a 2a 20 74 68 65 20 66 69 6c 65 2e 20 ** the file.
2f740 49 66 20 74 68 65 20 75 6e 6c 6f 63 6b 20 61 74 If the unlock at
2f750 74 65 6d 70 74 20 66 61 69 6c 73 2c 20 74 68 65 tempt fails, the
2f760 6e 20 50 61 67 65 72 2e 65 4c 6f 63 6b 20 6d 75 n Pager.eLock mu
2f770 73 74 20 62 65 0a 20 20 20 20 20 20 20 20 2a 2a st be. **
2f780 20 73 65 74 20 74 6f 20 55 4e 4b 4e 4f 57 4e 5f set to UNKNOWN_
2f790 4c 4f 43 4b 20 28 73 65 65 20 74 68 65 20 63 6f LOCK (see the co
2f7a0 6d 6d 65 6e 74 20 61 62 6f 76 65 20 74 68 65 20 mment above the
2f7b0 23 64 65 66 69 6e 65 20 66 6f 72 20 0a 20 20 20 #define for .
2f7c0 20 20 20 20 20 2a 2a 20 55 4e 4b 4e 4f 57 4e 5f ** UNKNOWN_
2f7d0 4c 4f 43 4b 20 61 62 6f 76 65 20 66 6f 72 20 61 LOCK above for a
2f7e0 6e 20 65 78 70 6c 61 6e 61 74 69 6f 6e 29 2e 20 n explanation).
2f7f0 0a 20 20 20 20 20 20 20 20 2a 2a 0a 20 20 20 20 . **.
2f800 20 20 20 20 2a 2a 20 49 6e 20 6f 72 64 65 72 20 ** In order
2f810 74 6f 20 67 65 74 20 70 61 67 65 72 5f 75 6e 6c to get pager_unl
2f820 6f 63 6b 28 29 20 74 6f 20 64 6f 20 74 68 69 73 ock() to do this
2f830 2c 20 73 65 74 20 50 61 67 65 72 2e 65 53 74 61 , set Pager.eSta
2f840 74 65 20 74 6f 0a 20 20 20 20 20 20 20 20 2a 2a te to. **
2f850 20 50 41 47 45 52 5f 45 52 52 4f 52 20 6e 6f 77 PAGER_ERROR now
2f860 2e 20 54 68 69 73 20 69 73 20 6e 6f 74 20 61 63 . This is not ac
2f870 74 75 61 6c 6c 79 20 63 6f 75 6e 74 65 64 20 61 tually counted a
2f880 73 20 61 20 74 72 61 6e 73 69 74 69 6f 6e 0a 20 s a transition.
2f890 20 20 20 20 20 20 20 2a 2a 20 74 6f 20 45 52 52 ** to ERR
2f8a0 4f 52 20 73 74 61 74 65 20 69 6e 20 74 68 65 20 OR state in the
2f8b0 73 74 61 74 65 20 64 69 61 67 72 61 6d 20 61 74 state diagram at
2f8c0 20 74 68 65 20 74 6f 70 20 6f 66 20 74 68 69 73 the top of this
2f8d0 20 66 69 6c 65 2c 0a 20 20 20 20 20 20 20 20 2a file,. *
2f8e0 2a 20 73 69 6e 63 65 20 77 65 20 6b 6e 6f 77 20 * since we know
2f8f0 74 68 61 74 20 74 68 65 20 73 61 6d 65 20 63 61 that the same ca
2f900 6c 6c 20 74 6f 20 70 61 67 65 72 5f 75 6e 6c 6f ll to pager_unlo
2f910 63 6b 28 29 20 77 69 6c 6c 20 76 65 72 79 0a 20 ck() will very.
2f920 20 20 20 20 20 20 20 2a 2a 20 73 68 6f 72 74 6c ** shortl
2f930 79 20 74 72 61 6e 73 69 74 69 6f 6e 20 74 68 65 y transition the
2f940 20 70 61 67 65 72 20 6f 62 6a 65 63 74 20 74 6f pager object to
2f950 20 74 68 65 20 4f 50 45 4e 20 73 74 61 74 65 2e the OPEN state.
2f960 20 43 61 6c 6c 69 6e 67 0a 20 20 20 20 20 20 20 Calling.
2f970 20 2a 2a 20 61 73 73 65 72 74 5f 70 61 67 65 72 ** assert_pager
2f980 5f 73 74 61 74 65 28 29 20 77 6f 75 6c 64 20 66 _state() would f
2f990 61 69 6c 20 6e 6f 77 2c 20 61 73 20 69 74 20 73 ail now, as it s
2f9a0 68 6f 75 6c 64 20 6e 6f 74 20 62 65 20 70 6f 73 hould not be pos
2f9b0 73 69 62 6c 65 0a 20 20 20 20 20 20 20 20 2a 2a sible. **
2f9c0 20 74 6f 20 62 65 20 69 6e 20 45 52 52 4f 52 20 to be in ERROR
2f9d0 73 74 61 74 65 20 77 68 65 6e 20 74 68 65 72 65 state when there
2f9e0 20 61 72 65 20 7a 65 72 6f 20 6f 75 74 73 74 61 are zero outsta
2f9f0 6e 64 69 6e 67 20 70 61 67 65 20 0a 20 20 20 20 nding page .
2fa00 20 20 20 20 2a 2a 20 72 65 66 65 72 65 6e 63 65 ** reference
2fa10 73 2e 0a 20 20 20 20 20 20 20 20 2a 2f 0a 20 20 s.. */.
2fa20 20 20 20 20 20 20 70 61 67 65 72 5f 65 72 72 6f pager_erro
2fa30 72 28 70 50 61 67 65 72 2c 20 72 63 29 3b 0a 20 r(pPager, rc);.
2fa40 20 20 20 20 20 20 20 67 6f 74 6f 20 66 61 69 6c goto fail
2fa50 65 64 3b 0a 20 20 20 20 20 20 7d 0a 0a 20 20 20 ed;. }..
2fa60 20 20 20 61 73 73 65 72 74 28 20 70 50 61 67 65 assert( pPage
2fa70 72 2d 3e 65 53 74 61 74 65 3d 3d 50 41 47 45 52 r->eState==PAGER
2fa80 5f 4f 50 45 4e 20 29 3b 0a 20 20 20 20 20 20 61 _OPEN );. a
2fa90 73 73 65 72 74 28 20 28 70 50 61 67 65 72 2d 3e ssert( (pPager->
2faa0 65 4c 6f 63 6b 3d 3d 53 48 41 52 45 44 5f 4c 4f eLock==SHARED_LO
2fab0 43 4b 29 0a 20 20 20 20 20 20 20 20 20 20 20 7c CK). |
2fac0 7c 20 28 70 50 61 67 65 72 2d 3e 65 78 63 6c 75 | (pPager->exclu
2fad0 73 69 76 65 4d 6f 64 65 20 26 26 20 70 50 61 67 siveMode && pPag
2fae0 65 72 2d 3e 65 4c 6f 63 6b 3e 53 48 41 52 45 44 er->eLock>SHARED
2faf0 5f 4c 4f 43 4b 29 0a 20 20 20 20 20 20 29 3b 0a _LOCK). );.
2fb00 20 20 20 20 7d 0a 0a 20 20 20 20 69 66 28 20 21 }.. if( !
2fb10 70 50 61 67 65 72 2d 3e 74 65 6d 70 46 69 6c 65 pPager->tempFile
2fb20 20 0a 20 20 20 20 20 26 26 20 28 70 50 61 67 65 . && (pPage
2fb30 72 2d 3e 70 42 61 63 6b 75 70 20 7c 7c 20 73 71 r->pBackup || sq
2fb40 6c 69 74 65 33 50 63 61 63 68 65 50 61 67 65 63 lite3PcachePagec
2fb50 6f 75 6e 74 28 70 50 61 67 65 72 2d 3e 70 50 43 ount(pPager->pPC
2fb60 61 63 68 65 29 3e 30 29 20 0a 20 20 20 20 29 7b ache)>0) . ){
2fb70 0a 20 20 20 20 20 20 2f 2a 20 54 68 65 20 73 68 . /* The sh
2fb80 61 72 65 64 2d 6c 6f 63 6b 20 68 61 73 20 6a 75 ared-lock has ju
2fb90 73 74 20 62 65 65 6e 20 61 63 71 75 69 72 65 64 st been acquired
2fba0 20 6f 6e 20 74 68 65 20 64 61 74 61 62 61 73 65 on the database
2fbb0 20 66 69 6c 65 0a 20 20 20 20 20 20 2a 2a 20 61 file. ** a
2fbc0 6e 64 20 74 68 65 72 65 20 61 72 65 20 61 6c 72 nd there are alr
2fbd0 65 61 64 79 20 70 61 67 65 73 20 69 6e 20 74 68 eady pages in th
2fbe0 65 20 63 61 63 68 65 20 28 66 72 6f 6d 20 61 20 e cache (from a
2fbf0 70 72 65 76 69 6f 75 73 0a 20 20 20 20 20 20 2a previous. *
2fc00 2a 20 72 65 61 64 20 6f 72 20 77 72 69 74 65 20 * read or write
2fc10 74 72 61 6e 73 61 63 74 69 6f 6e 29 2e 20 20 43 transaction). C
2fc20 68 65 63 6b 20 74 6f 20 73 65 65 20 69 66 20 74 heck to see if t
2fc30 68 65 20 64 61 74 61 62 61 73 65 0a 20 20 20 20 he database.
2fc40 20 20 2a 2a 20 68 61 73 20 62 65 65 6e 20 6d 6f ** has been mo
2fc50 64 69 66 69 65 64 2e 20 20 49 66 20 74 68 65 20 dified. If the
2fc60 64 61 74 61 62 61 73 65 20 68 61 73 20 63 68 61 database has cha
2fc70 6e 67 65 64 2c 20 66 6c 75 73 68 20 74 68 65 0a nged, flush the.
2fc80 20 20 20 20 20 20 2a 2a 20 63 61 63 68 65 2e 0a ** cache..
2fc90 20 20 20 20 20 20 2a 2a 0a 20 20 20 20 20 20 2a **. *
2fca0 2a 20 44 61 74 61 62 61 73 65 20 63 68 61 6e 67 * Database chang
2fcb0 65 73 20 69 73 20 64 65 74 65 63 74 65 64 20 62 es is detected b
2fcc0 79 20 6c 6f 6f 6b 69 6e 67 20 61 74 20 31 35 20 y looking at 15
2fcd0 62 79 74 65 73 20 62 65 67 69 6e 6e 69 6e 67 0a bytes beginning.
2fce0 20 20 20 20 20 20 2a 2a 20 61 74 20 6f 66 66 73 ** at offs
2fcf0 65 74 20 32 34 20 69 6e 74 6f 20 74 68 65 20 66 et 24 into the f
2fd00 69 6c 65 2e 20 20 54 68 65 20 66 69 72 73 74 20 ile. The first
2fd10 34 20 6f 66 20 74 68 65 73 65 20 31 36 20 62 79 4 of these 16 by
2fd20 74 65 73 20 61 72 65 0a 20 20 20 20 20 20 2a 2a tes are. **
2fd30 20 61 20 33 32 2d 62 69 74 20 63 6f 75 6e 74 65 a 32-bit counte
2fd40 72 20 74 68 61 74 20 69 73 20 69 6e 63 72 65 6d r that is increm
2fd50 65 6e 74 65 64 20 77 69 74 68 20 65 61 63 68 20 ented with each
2fd60 63 68 61 6e 67 65 2e 20 20 54 68 65 0a 20 20 20 change. The.
2fd70 20 20 20 2a 2a 20 6f 74 68 65 72 20 62 79 74 65 ** other byte
2fd80 73 20 63 68 61 6e 67 65 20 72 61 6e 64 6f 6d 6c s change randoml
2fd90 79 20 77 69 74 68 20 65 61 63 68 20 66 69 6c 65 y with each file
2fda0 20 63 68 61 6e 67 65 20 77 68 65 6e 0a 20 20 20 change when.
2fdb0 20 20 20 2a 2a 20 61 20 63 6f 64 65 63 20 69 73 ** a codec is
2fdc0 20 69 6e 20 75 73 65 2e 0a 20 20 20 20 20 20 2a in use.. *
2fdd0 2a 20 0a 20 20 20 20 20 20 2a 2a 20 54 68 65 72 * . ** Ther
2fde0 65 20 69 73 20 61 20 76 61 6e 69 73 68 69 6e 67 e is a vanishing
2fdf0 6c 79 20 73 6d 61 6c 6c 20 63 68 61 6e 63 65 20 ly small chance
2fe00 74 68 61 74 20 61 20 63 68 61 6e 67 65 20 77 69 that a change wi
2fe10 6c 6c 20 6e 6f 74 20 62 65 20 0a 20 20 20 20 20 ll not be .
2fe20 20 2a 2a 20 64 65 74 65 63 74 65 64 2e 20 20 54 ** detected. T
2fe30 68 65 20 63 68 61 6e 63 65 20 6f 66 20 61 6e 20 he chance of an
2fe40 75 6e 64 65 74 65 63 74 65 64 20 63 68 61 6e 67 undetected chang
2fe50 65 20 69 73 20 73 6f 20 73 6d 61 6c 6c 20 74 68 e is so small th
2fe60 61 74 0a 20 20 20 20 20 20 2a 2a 20 69 74 20 63 at. ** it c
2fe70 61 6e 20 62 65 20 6e 65 67 6c 65 63 74 65 64 2e an be neglected.
2fe80 0a 20 20 20 20 20 20 2a 2f 0a 20 20 20 20 20 20 . */.
2fe90 50 67 6e 6f 20 6e 50 61 67 65 20 3d 20 30 3b 0a Pgno nPage = 0;.
2fea0 20 20 20 20 20 20 63 68 61 72 20 64 62 46 69 6c char dbFil
2feb0 65 56 65 72 73 5b 73 69 7a 65 6f 66 28 70 50 61 eVers[sizeof(pPa
2fec0 67 65 72 2d 3e 64 62 46 69 6c 65 56 65 72 73 29 ger->dbFileVers)
2fed0 5d 3b 0a 0a 20 20 20 20 20 20 72 63 20 3d 20 70 ];.. rc = p
2fee0 61 67 65 72 50 61 67 65 63 6f 75 6e 74 28 70 50 agerPagecount(pP
2fef0 61 67 65 72 2c 20 26 6e 50 61 67 65 29 3b 0a 20 ager, &nPage);.
2ff00 20 20 20 20 20 69 66 28 20 72 63 20 29 20 67 6f if( rc ) go
2ff10 74 6f 20 66 61 69 6c 65 64 3b 0a 0a 20 20 20 20 to failed;..
2ff20 20 20 69 66 28 20 6e 50 61 67 65 3e 30 20 29 7b if( nPage>0 ){
2ff30 0a 20 20 20 20 20 20 20 20 49 4f 54 52 41 43 45 . IOTRACE
2ff40 28 28 22 43 4b 56 45 52 53 20 25 70 20 25 64 5c (("CKVERS %p %d\
2ff50 6e 22 2c 20 70 50 61 67 65 72 2c 20 73 69 7a 65 n", pPager, size
2ff60 6f 66 28 64 62 46 69 6c 65 56 65 72 73 29 29 29 of(dbFileVers)))
2ff70 3b 0a 20 20 20 20 20 20 20 20 72 63 20 3d 20 73 ;. rc = s
2ff80 71 6c 69 74 65 33 4f 73 52 65 61 64 28 70 50 61 qlite3OsRead(pPa
2ff90 67 65 72 2d 3e 66 64 2c 20 26 64 62 46 69 6c 65 ger->fd, &dbFile
2ffa0 56 65 72 73 2c 20 73 69 7a 65 6f 66 28 64 62 46 Vers, sizeof(dbF
2ffb0 69 6c 65 56 65 72 73 29 2c 20 32 34 29 3b 0a 20 ileVers), 24);.
2ffc0 20 20 20 20 20 20 20 69 66 28 20 72 63 21 3d 53 if( rc!=S
2ffd0 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 QLITE_OK ){.
2ffe0 20 20 20 20 20 20 67 6f 74 6f 20 66 61 69 6c 65 goto faile
2fff0 64 3b 0a 20 20 20 20 20 20 20 20 7d 0a 20 20 20 d;. }.
30000 20 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 20 20 }else{.
30010 20 20 6d 65 6d 73 65 74 28 64 62 46 69 6c 65 56 memset(dbFileV
30020 65 72 73 2c 20 30 2c 20 73 69 7a 65 6f 66 28 64 ers, 0, sizeof(d
30030 62 46 69 6c 65 56 65 72 73 29 29 3b 0a 20 20 20 bFileVers));.
30040 20 20 20 7d 0a 0a 20 20 20 20 20 20 69 66 28 20 }.. if(
30050 6d 65 6d 63 6d 70 28 70 50 61 67 65 72 2d 3e 64 memcmp(pPager->d
30060 62 46 69 6c 65 56 65 72 73 2c 20 64 62 46 69 6c bFileVers, dbFil
30070 65 56 65 72 73 2c 20 73 69 7a 65 6f 66 28 64 62 eVers, sizeof(db
30080 46 69 6c 65 56 65 72 73 29 29 21 3d 30 20 29 7b FileVers))!=0 ){
30090 0a 20 20 20 20 20 20 20 20 70 61 67 65 72 5f 72 . pager_r
300a0 65 73 65 74 28 70 50 61 67 65 72 29 3b 0a 20 20 eset(pPager);.
300b0 20 20 20 20 7d 0a 20 20 20 20 7d 0a 0a 20 20 20 }. }..
300c0 20 2f 2a 20 49 66 20 74 68 65 72 65 20 69 73 20 /* If there is
300d0 61 20 57 41 4c 20 66 69 6c 65 20 69 6e 20 74 68 a WAL file in th
300e0 65 20 66 69 6c 65 2d 73 79 73 74 65 6d 2c 20 6f e file-system, o
300f0 70 65 6e 20 74 68 69 73 20 64 61 74 61 62 61 73 pen this databas
30100 65 20 69 6e 20 57 41 4c 0a 20 20 20 20 2a 2a 20 e in WAL. **
30110 6d 6f 64 65 2e 20 4f 74 68 65 72 77 69 73 65 2c mode. Otherwise,
30120 20 74 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 66 the following f
30130 75 6e 63 74 69 6f 6e 20 63 61 6c 6c 20 69 73 20 unction call is
30140 61 20 6e 6f 2d 6f 70 2e 0a 20 20 20 20 2a 2f 0a a no-op.. */.
30150 20 20 20 20 72 63 20 3d 20 70 61 67 65 72 4f 70 rc = pagerOp
30160 65 6e 57 61 6c 49 66 50 72 65 73 65 6e 74 28 70 enWalIfPresent(p
30170 50 61 67 65 72 29 3b 0a 23 69 66 6e 64 65 66 20 Pager);.#ifndef
30180 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 57 41 4c 0a SQLITE_OMIT_WAL.
30190 20 20 20 20 61 73 73 65 72 74 28 20 70 50 61 67 assert( pPag
301a0 65 72 2d 3e 70 57 61 6c 3d 3d 30 20 7c 7c 20 72 er->pWal==0 || r
301b0 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 3b 0a c==SQLITE_OK );.
301c0 23 65 6e 64 69 66 0a 20 20 7d 0a 0a 20 20 69 66 #endif. }.. if
301d0 28 20 70 61 67 65 72 55 73 65 57 61 6c 28 70 50 ( pagerUseWal(pP
301e0 61 67 65 72 29 20 29 7b 0a 20 20 20 20 61 73 73 ager) ){. ass
301f0 65 72 74 28 20 72 63 3d 3d 53 51 4c 49 54 45 5f ert( rc==SQLITE_
30200 4f 4b 20 29 3b 0a 20 20 20 20 72 63 20 3d 20 70 OK );. rc = p
30210 61 67 65 72 42 65 67 69 6e 52 65 61 64 54 72 61 agerBeginReadTra
30220 6e 73 61 63 74 69 6f 6e 28 70 50 61 67 65 72 29 nsaction(pPager)
30230 3b 0a 20 20 7d 0a 0a 20 20 69 66 28 20 70 50 61 ;. }.. if( pPa
30240 67 65 72 2d 3e 65 53 74 61 74 65 3d 3d 50 41 47 ger->eState==PAG
30250 45 52 5f 4f 50 45 4e 20 26 26 20 72 63 3d 3d 53 ER_OPEN && rc==S
30260 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 QLITE_OK ){.
30270 72 63 20 3d 20 70 61 67 65 72 50 61 67 65 63 6f rc = pagerPageco
30280 75 6e 74 28 70 50 61 67 65 72 2c 20 26 70 50 61 unt(pPager, &pPa
30290 67 65 72 2d 3e 64 62 53 69 7a 65 29 3b 0a 20 20 ger->dbSize);.
302a0 7d 0a 0a 20 66 61 69 6c 65 64 3a 0a 20 20 69 66 }.. failed:. if
302b0 28 20 72 63 21 3d 53 51 4c 49 54 45 5f 4f 4b 20 ( rc!=SQLITE_OK
302c0 29 7b 0a 20 20 20 20 61 73 73 65 72 74 28 20 21 ){. assert( !
302d0 4d 45 4d 44 42 20 29 3b 0a 20 20 20 20 70 61 67 MEMDB );. pag
302e0 65 72 5f 75 6e 6c 6f 63 6b 28 70 50 61 67 65 72 er_unlock(pPager
302f0 29 3b 0a 20 20 20 20 61 73 73 65 72 74 28 20 70 );. assert( p
30300 50 61 67 65 72 2d 3e 65 53 74 61 74 65 3d 3d 50 Pager->eState==P
30310 41 47 45 52 5f 4f 50 45 4e 20 29 3b 0a 20 20 7d AGER_OPEN );. }
30320 65 6c 73 65 7b 0a 20 20 20 20 70 50 61 67 65 72 else{. pPager
30330 2d 3e 65 53 74 61 74 65 20 3d 20 50 41 47 45 52 ->eState = PAGER
30340 5f 52 45 41 44 45 52 3b 0a 20 20 7d 0a 20 20 72 _READER;. }. r
30350 65 74 75 72 6e 20 72 63 3b 0a 7d 0a 0a 2f 2a 0a eturn rc;.}../*.
30360 2a 2a 20 49 66 20 74 68 65 20 72 65 66 65 72 65 ** If the refere
30370 6e 63 65 20 63 6f 75 6e 74 20 68 61 73 20 72 65 nce count has re
30380 61 63 68 65 64 20 7a 65 72 6f 2c 20 72 6f 6c 6c ached zero, roll
30390 62 61 63 6b 20 61 6e 79 20 61 63 74 69 76 65 0a back any active.
303a0 2a 2a 20 74 72 61 6e 73 61 63 74 69 6f 6e 20 61 ** transaction a
303b0 6e 64 20 75 6e 6c 6f 63 6b 20 74 68 65 20 70 61 nd unlock the pa
303c0 67 65 72 2e 0a 2a 2a 0a 2a 2a 20 45 78 63 65 70 ger..**.** Excep
303d0 74 2c 20 69 6e 20 6c 6f 63 6b 69 6e 67 5f 6d 6f t, in locking_mo
303e0 64 65 3d 45 58 43 4c 55 53 49 56 45 20 77 68 65 de=EXCLUSIVE whe
303f0 6e 20 74 68 65 72 65 20 69 73 20 6e 6f 74 68 69 n there is nothi
30400 6e 67 20 74 6f 20 69 6e 0a 2a 2a 20 74 68 65 20 ng to in.** the
30410 72 6f 6c 6c 62 61 63 6b 20 6a 6f 75 72 6e 61 6c rollback journal
30420 2c 20 74 68 65 20 75 6e 6c 6f 63 6b 20 69 73 20 , the unlock is
30430 6e 6f 74 20 70 65 72 66 6f 72 6d 65 64 20 61 6e not performed an
30440 64 20 74 68 65 72 65 20 69 73 0a 2a 2a 20 6e 6f d there is.** no
30450 74 68 69 6e 67 20 74 6f 20 72 6f 6c 6c 62 61 63 thing to rollbac
30460 6b 2c 20 73 6f 20 74 68 69 73 20 72 6f 75 74 69 k, so this routi
30470 6e 65 20 69 73 20 61 20 6e 6f 2d 6f 70 2e 0a 2a ne is a no-op..*
30480 2f 20 0a 73 74 61 74 69 63 20 76 6f 69 64 20 70 / .static void p
30490 61 67 65 72 55 6e 6c 6f 63 6b 49 66 55 6e 75 73 agerUnlockIfUnus
304a0 65 64 28 50 61 67 65 72 20 2a 70 50 61 67 65 72 ed(Pager *pPager
304b0 29 7b 0a 20 20 69 66 28 20 28 73 71 6c 69 74 65 ){. if( (sqlite
304c0 33 50 63 61 63 68 65 52 65 66 43 6f 75 6e 74 28 3PcacheRefCount(
304d0 70 50 61 67 65 72 2d 3e 70 50 43 61 63 68 65 29 pPager->pPCache)
304e0 3d 3d 30 29 20 29 7b 0a 20 20 20 20 70 61 67 65 ==0) ){. page
304f0 72 55 6e 6c 6f 63 6b 41 6e 64 52 6f 6c 6c 62 61 rUnlockAndRollba
30500 63 6b 28 70 50 61 67 65 72 29 3b 0a 20 20 7d 0a ck(pPager);. }.
30510 7d 0a 0a 2f 2a 0a 2a 2a 20 41 63 71 75 69 72 65 }../*.** Acquire
30520 20 61 20 72 65 66 65 72 65 6e 63 65 20 74 6f 20 a reference to
30530 70 61 67 65 20 6e 75 6d 62 65 72 20 70 67 6e 6f page number pgno
30540 20 69 6e 20 70 61 67 65 72 20 70 50 61 67 65 72 in pager pPager
30550 20 28 61 20 70 61 67 65 0a 2a 2a 20 72 65 66 65 (a page.** refe
30560 72 65 6e 63 65 20 68 61 73 20 74 79 70 65 20 44 rence has type D
30570 62 50 61 67 65 2a 29 2e 20 49 66 20 74 68 65 20 bPage*). If the
30580 72 65 71 75 65 73 74 65 64 20 72 65 66 65 72 65 requested refere
30590 6e 63 65 20 69 73 20 0a 2a 2a 20 73 75 63 63 65 nce is .** succe
305a0 73 73 66 75 6c 6c 79 20 6f 62 74 61 69 6e 65 64 ssfully obtained
305b0 2c 20 69 74 20 69 73 20 63 6f 70 69 65 64 20 74 , it is copied t
305c0 6f 20 2a 70 70 50 61 67 65 20 61 6e 64 20 53 51 o *ppPage and SQ
305d0 4c 49 54 45 5f 4f 4b 20 72 65 74 75 72 6e 65 64 LITE_OK returned
305e0 2e 0a 2a 2a 0a 2a 2a 20 49 66 20 74 68 65 20 72 ..**.** If the r
305f0 65 71 75 65 73 74 65 64 20 70 61 67 65 20 69 73 equested page is
30600 20 61 6c 72 65 61 64 79 20 69 6e 20 74 68 65 20 already in the
30610 63 61 63 68 65 2c 20 69 74 20 69 73 20 72 65 74 cache, it is ret
30620 75 72 6e 65 64 2e 20 0a 2a 2a 20 4f 74 68 65 72 urned. .** Other
30630 77 69 73 65 2c 20 61 20 6e 65 77 20 70 61 67 65 wise, a new page
30640 20 6f 62 6a 65 63 74 20 69 73 20 61 6c 6c 6f 63 object is alloc
30650 61 74 65 64 20 61 6e 64 20 70 6f 70 75 6c 61 74 ated and populat
30660 65 64 20 77 69 74 68 20 64 61 74 61 0a 2a 2a 20 ed with data.**
30670 72 65 61 64 20 66 72 6f 6d 20 74 68 65 20 64 61 read from the da
30680 74 61 62 61 73 65 20 66 69 6c 65 2e 20 49 6e 20 tabase file. In
30690 73 6f 6d 65 20 63 61 73 65 73 2c 20 74 68 65 20 some cases, the
306a0 70 63 61 63 68 65 20 6d 6f 64 75 6c 65 20 6d 61 pcache module ma
306b0 79 0a 2a 2a 20 63 68 6f 6f 73 65 20 6e 6f 74 20 y.** choose not
306c0 74 6f 20 61 6c 6c 6f 63 61 74 65 20 61 20 6e 65 to allocate a ne
306d0 77 20 70 61 67 65 20 6f 62 6a 65 63 74 20 61 6e w page object an
306e0 64 20 6d 61 79 20 72 65 75 73 65 20 61 6e 20 65 d may reuse an e
306f0 78 69 73 74 69 6e 67 0a 2a 2a 20 6f 62 6a 65 63 xisting.** objec
30700 74 20 77 69 74 68 20 6e 6f 20 6f 75 74 73 74 61 t with no outsta
30710 6e 64 69 6e 67 20 72 65 66 65 72 65 6e 63 65 73 nding references
30720 2e 0a 2a 2a 0a 2a 2a 20 54 68 65 20 65 78 74 72 ..**.** The extr
30730 61 20 64 61 74 61 20 61 70 70 65 6e 64 65 64 20 a data appended
30740 74 6f 20 61 20 70 61 67 65 20 69 73 20 61 6c 77 to a page is alw
30750 61 79 73 20 69 6e 69 74 69 61 6c 69 7a 65 64 20 ays initialized
30760 74 6f 20 7a 65 72 6f 73 20 74 68 65 20 0a 2a 2a to zeros the .**
30770 20 66 69 72 73 74 20 74 69 6d 65 20 61 20 70 61 first time a pa
30780 67 65 20 69 73 20 6c 6f 61 64 65 64 20 69 6e 74 ge is loaded int
30790 6f 20 6d 65 6d 6f 72 79 2e 20 49 66 20 74 68 65 o memory. If the
307a0 20 70 61 67 65 20 72 65 71 75 65 73 74 65 64 20 page requested
307b0 69 73 20 0a 2a 2a 20 61 6c 72 65 61 64 79 20 69 is .** already i
307c0 6e 20 74 68 65 20 63 61 63 68 65 20 77 68 65 6e n the cache when
307d0 20 74 68 69 73 20 66 75 6e 63 74 69 6f 6e 20 69 this function i
307e0 73 20 63 61 6c 6c 65 64 2c 20 74 68 65 6e 20 74 s called, then t
307f0 68 65 20 65 78 74 72 61 0a 2a 2a 20 64 61 74 61 he extra.** data
30800 20 69 73 20 6c 65 66 74 20 61 73 20 69 74 20 77 is left as it w
30810 61 73 20 77 68 65 6e 20 74 68 65 20 70 61 67 65 as when the page
30820 20 6f 62 6a 65 63 74 20 77 61 73 20 6c 61 73 74 object was last
30830 20 75 73 65 64 2e 0a 2a 2a 0a 2a 2a 20 49 66 20 used..**.** If
30840 74 68 65 20 64 61 74 61 62 61 73 65 20 69 6d 61 the database ima
30850 67 65 20 69 73 20 73 6d 61 6c 6c 65 72 20 74 68 ge is smaller th
30860 61 6e 20 74 68 65 20 72 65 71 75 65 73 74 65 64 an the requested
30870 20 70 61 67 65 20 6f 72 20 69 66 20 61 20 0a 2a page or if a .*
30880 2a 20 6e 6f 6e 2d 7a 65 72 6f 20 76 61 6c 75 65 * non-zero value
30890 20 69 73 20 70 61 73 73 65 64 20 61 73 20 74 68 is passed as th
308a0 65 20 6e 6f 43 6f 6e 74 65 6e 74 20 70 61 72 61 e noContent para
308b0 6d 65 74 65 72 20 61 6e 64 20 74 68 65 20 0a 2a meter and the .*
308c0 2a 20 72 65 71 75 65 73 74 65 64 20 70 61 67 65 * requested page
308d0 20 69 73 20 6e 6f 74 20 61 6c 72 65 61 64 79 20 is not already
308e0 73 74 6f 72 65 64 20 69 6e 20 74 68 65 20 63 61 stored in the ca
308f0 63 68 65 2c 20 74 68 65 6e 20 6e 6f 20 0a 2a 2a che, then no .**
30900 20 61 63 74 75 61 6c 20 64 69 73 6b 20 72 65 61 actual disk rea
30910 64 20 6f 63 63 75 72 73 2e 20 49 6e 20 74 68 69 d occurs. In thi
30920 73 20 63 61 73 65 20 74 68 65 20 6d 65 6d 6f 72 s case the memor
30930 79 20 69 6d 61 67 65 20 6f 66 20 74 68 65 20 0a y image of the .
30940 2a 2a 20 70 61 67 65 20 69 73 20 69 6e 69 74 69 ** page is initi
30950 61 6c 69 7a 65 64 20 74 6f 20 61 6c 6c 20 7a 65 alized to all ze
30960 72 6f 73 2e 20 0a 2a 2a 0a 2a 2a 20 49 66 20 6e ros. .**.** If n
30970 6f 43 6f 6e 74 65 6e 74 20 69 73 20 74 72 75 65 oContent is true
30980 2c 20 69 74 20 6d 65 61 6e 73 20 74 68 61 74 20 , it means that
30990 77 65 20 64 6f 20 6e 6f 74 20 63 61 72 65 20 61 we do not care a
309a0 62 6f 75 74 20 74 68 65 20 63 6f 6e 74 65 6e 74 bout the content
309b0 73 0a 2a 2a 20 6f 66 20 74 68 65 20 70 61 67 65 s.** of the page
309c0 2e 20 54 68 69 73 20 6f 63 63 75 72 73 20 69 6e . This occurs in
309d0 20 74 77 6f 20 73 65 70 65 72 61 74 65 20 73 63 two seperate sc
309e0 65 6e 61 72 69 6f 73 3a 0a 2a 2a 0a 2a 2a 20 20 enarios:.**.**
309f0 20 61 29 20 57 68 65 6e 20 72 65 61 64 69 6e 67 a) When reading
30a00 20 61 20 66 72 65 65 2d 6c 69 73 74 20 6c 65 61 a free-list lea
30a10 66 20 70 61 67 65 20 66 72 6f 6d 20 74 68 65 20 f page from the
30a20 64 61 74 61 62 61 73 65 2c 20 61 6e 64 0a 2a 2a database, and.**
30a30 0a 2a 2a 20 20 20 62 29 20 57 68 65 6e 20 61 20 .** b) When a
30a40 73 61 76 65 70 6f 69 6e 74 20 69 73 20 62 65 69 savepoint is bei
30a50 6e 67 20 72 6f 6c 6c 65 64 20 62 61 63 6b 20 61 ng rolled back a
30a60 6e 64 20 77 65 20 6e 65 65 64 20 74 6f 20 6c 6f nd we need to lo
30a70 61 64 0a 2a 2a 20 20 20 20 20 20 61 20 6e 65 77 ad.** a new
30a80 20 70 61 67 65 20 69 6e 74 6f 20 74 68 65 20 63 page into the c
30a90 61 63 68 65 20 74 6f 20 62 65 20 66 69 6c 6c 65 ache to be fille
30aa0 64 20 77 69 74 68 20 74 68 65 20 64 61 74 61 20 d with the data
30ab0 72 65 61 64 0a 2a 2a 20 20 20 20 20 20 66 72 6f read.** fro
30ac0 6d 20 74 68 65 20 73 61 76 65 70 6f 69 6e 74 20 m the savepoint
30ad0 6a 6f 75 72 6e 61 6c 2e 0a 2a 2a 0a 2a 2a 20 49 journal..**.** I
30ae0 66 20 6e 6f 43 6f 6e 74 65 6e 74 20 69 73 20 74 f noContent is t
30af0 72 75 65 2c 20 74 68 65 6e 20 74 68 65 20 64 61 rue, then the da
30b00 74 61 20 72 65 74 75 72 6e 65 64 20 69 73 20 7a ta returned is z
30b10 65 72 6f 65 64 20 69 6e 73 74 65 61 64 20 6f 66 eroed instead of
30b20 0a 2a 2a 20 62 65 69 6e 67 20 72 65 61 64 20 66 .** being read f
30b30 72 6f 6d 20 74 68 65 20 64 61 74 61 62 61 73 65 rom the database
30b40 2e 20 41 64 64 69 74 69 6f 6e 61 6c 6c 79 2c 20 . Additionally,
30b50 74 68 65 20 62 69 74 73 20 63 6f 72 72 65 73 70 the bits corresp
30b60 6f 6e 64 69 6e 67 0a 2a 2a 20 74 6f 20 70 67 6e onding.** to pgn
30b70 6f 20 69 6e 20 50 61 67 65 72 2e 70 49 6e 4a 6f o in Pager.pInJo
30b80 75 72 6e 61 6c 20 28 62 69 74 76 65 63 20 6f 66 urnal (bitvec of
30b90 20 70 61 67 65 73 20 61 6c 72 65 61 64 79 20 77 pages already w
30ba0 72 69 74 74 65 6e 20 74 6f 20 74 68 65 0a 2a 2a ritten to the.**
30bb0 20 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 29 20 61 journal file) a
30bc0 6e 64 20 74 68 65 20 50 61 67 65 72 53 61 76 65 nd the PagerSave
30bd0 70 6f 69 6e 74 2e 70 49 6e 53 61 76 65 70 6f 69 point.pInSavepoi
30be0 6e 74 20 62 69 74 76 65 63 73 20 6f 66 20 61 6e nt bitvecs of an
30bf0 79 20 6f 70 65 6e 0a 2a 2a 20 73 61 76 65 70 6f y open.** savepo
30c00 69 6e 74 73 20 61 72 65 20 73 65 74 2e 20 54 68 ints are set. Th
30c10 69 73 20 6d 65 61 6e 73 20 69 66 20 74 68 65 20 is means if the
30c20 70 61 67 65 20 69 73 20 6d 61 64 65 20 77 72 69 page is made wri
30c30 74 61 62 6c 65 20 61 74 20 61 6e 79 0a 2a 2a 20 table at any.**
30c40 70 6f 69 6e 74 20 69 6e 20 74 68 65 20 66 75 74 point in the fut
30c50 75 72 65 2c 20 75 73 69 6e 67 20 61 20 63 61 6c ure, using a cal
30c60 6c 20 74 6f 20 73 71 6c 69 74 65 33 50 61 67 65 l to sqlite3Page
30c70 72 57 72 69 74 65 28 29 2c 20 69 74 73 20 63 6f rWrite(), its co
30c80 6e 74 65 6e 74 73 0a 2a 2a 20 77 69 6c 6c 20 6e ntents.** will n
30c90 6f 74 20 62 65 20 6a 6f 75 72 6e 61 6c 65 64 2e ot be journaled.
30ca0 20 54 68 69 73 20 73 61 76 65 73 20 49 4f 2e 0a This saves IO..
30cb0 2a 2a 0a 2a 2a 20 54 68 65 20 61 63 71 75 69 73 **.** The acquis
30cc0 69 74 69 6f 6e 20 6d 69 67 68 74 20 66 61 69 6c ition might fail
30cd0 20 66 6f 72 20 73 65 76 65 72 61 6c 20 72 65 61 for several rea
30ce0 73 6f 6e 73 2e 20 20 49 6e 20 61 6c 6c 20 63 61 sons. In all ca
30cf0 73 65 73 2c 0a 2a 2a 20 61 6e 20 61 70 70 72 6f ses,.** an appro
30d00 70 72 69 61 74 65 20 65 72 72 6f 72 20 63 6f 64 priate error cod
30d10 65 20 69 73 20 72 65 74 75 72 6e 65 64 20 61 6e e is returned an
30d20 64 20 2a 70 70 50 61 67 65 20 69 73 20 73 65 74 d *ppPage is set
30d30 20 74 6f 20 4e 55 4c 4c 2e 0a 2a 2a 0a 2a 2a 20 to NULL..**.**
30d40 53 65 65 20 61 6c 73 6f 20 73 71 6c 69 74 65 33 See also sqlite3
30d50 50 61 67 65 72 4c 6f 6f 6b 75 70 28 29 2e 20 20 PagerLookup().
30d60 42 6f 74 68 20 74 68 69 73 20 72 6f 75 74 69 6e Both this routin
30d70 65 20 61 6e 64 20 4c 6f 6f 6b 75 70 28 29 20 61 e and Lookup() a
30d80 74 74 65 6d 70 74 0a 2a 2a 20 74 6f 20 66 69 6e ttempt.** to fin
30d90 64 20 61 20 70 61 67 65 20 69 6e 20 74 68 65 20 d a page in the
30da0 69 6e 2d 6d 65 6d 6f 72 79 20 63 61 63 68 65 20 in-memory cache
30db0 66 69 72 73 74 2e 20 20 49 66 20 74 68 65 20 70 first. If the p
30dc0 61 67 65 20 69 73 20 6e 6f 74 20 61 6c 72 65 61 age is not alrea
30dd0 64 79 0a 2a 2a 20 69 6e 20 6d 65 6d 6f 72 79 2c dy.** in memory,
30de0 20 74 68 69 73 20 72 6f 75 74 69 6e 65 20 67 6f this routine go
30df0 65 73 20 74 6f 20 64 69 73 6b 20 74 6f 20 72 65 es to disk to re
30e00 61 64 20 69 74 20 69 6e 20 77 68 65 72 65 61 73 ad it in whereas
30e10 20 4c 6f 6f 6b 75 70 28 29 0a 2a 2a 20 6a 75 73 Lookup().** jus
30e20 74 20 72 65 74 75 72 6e 73 20 30 2e 20 20 54 68 t returns 0. Th
30e30 69 73 20 72 6f 75 74 69 6e 65 20 61 63 71 75 69 is routine acqui
30e40 72 65 73 20 61 20 72 65 61 64 2d 6c 6f 63 6b 20 res a read-lock
30e50 74 68 65 20 66 69 72 73 74 20 74 69 6d 65 20 69 the first time i
30e60 74 0a 2a 2a 20 68 61 73 20 74 6f 20 67 6f 20 74 t.** has to go t
30e70 6f 20 64 69 73 6b 2c 20 61 6e 64 20 63 6f 75 6c o disk, and coul
30e80 64 20 61 6c 73 6f 20 70 6c 61 79 62 61 63 6b 20 d also playback
30e90 61 6e 20 6f 6c 64 20 6a 6f 75 72 6e 61 6c 20 69 an old journal i
30ea0 66 20 6e 65 63 65 73 73 61 72 79 2e 0a 2a 2a 20 f necessary..**
30eb0 53 69 6e 63 65 20 4c 6f 6f 6b 75 70 28 29 20 6e Since Lookup() n
30ec0 65 76 65 72 20 67 6f 65 73 20 74 6f 20 64 69 73 ever goes to dis
30ed0 6b 2c 20 69 74 20 6e 65 76 65 72 20 68 61 73 20 k, it never has
30ee0 74 6f 20 64 65 61 6c 20 77 69 74 68 20 6c 6f 63 to deal with loc
30ef0 6b 73 0a 2a 2a 20 6f 72 20 6a 6f 75 72 6e 61 6c ks.** or journal
30f00 20 66 69 6c 65 73 2e 0a 2a 2f 0a 69 6e 74 20 73 files..*/.int s
30f10 71 6c 69 74 65 33 50 61 67 65 72 41 63 71 75 69 qlite3PagerAcqui
30f20 72 65 28 0a 20 20 50 61 67 65 72 20 2a 70 50 61 re(. Pager *pPa
30f30 67 65 72 2c 20 20 20 20 20 20 2f 2a 20 54 68 65 ger, /* The
30f40 20 70 61 67 65 72 20 6f 70 65 6e 20 6f 6e 20 74 pager open on t
30f50 68 65 20 64 61 74 61 62 61 73 65 20 66 69 6c 65 he database file
30f60 20 2a 2f 0a 20 20 50 67 6e 6f 20 70 67 6e 6f 2c */. Pgno pgno,
30f70 20 20 20 20 20 20 20 20 20 20 2f 2a 20 50 61 67 /* Pag
30f80 65 20 6e 75 6d 62 65 72 20 74 6f 20 66 65 74 63 e number to fetc
30f90 68 20 2a 2f 0a 20 20 44 62 50 61 67 65 20 2a 2a h */. DbPage **
30fa0 70 70 50 61 67 65 2c 20 20 20 20 2f 2a 20 57 72 ppPage, /* Wr
30fb0 69 74 65 20 61 20 70 6f 69 6e 74 65 72 20 74 6f ite a pointer to
30fc0 20 74 68 65 20 70 61 67 65 20 68 65 72 65 20 2a the page here *
30fd0 2f 0a 20 20 69 6e 74 20 6e 6f 43 6f 6e 74 65 6e /. int noConten
30fe0 74 20 20 20 20 20 20 20 2f 2a 20 44 6f 20 6e 6f t /* Do no
30ff0 74 20 62 6f 74 68 65 72 20 72 65 61 64 69 6e 67 t bother reading
31000 20 63 6f 6e 74 65 6e 74 20 66 72 6f 6d 20 64 69 content from di
31010 73 6b 20 69 66 20 74 72 75 65 20 2a 2f 0a 29 7b sk if true */.){
31020 0a 20 20 69 6e 74 20 72 63 3b 0a 20 20 50 67 48 . int rc;. PgH
31030 64 72 20 2a 70 50 67 3b 0a 0a 20 20 61 73 73 65 dr *pPg;.. asse
31040 72 74 28 20 70 50 61 67 65 72 2d 3e 65 53 74 61 rt( pPager->eSta
31050 74 65 3e 3d 50 41 47 45 52 5f 52 45 41 44 45 52 te>=PAGER_READER
31060 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 61 73 );. assert( as
31070 73 65 72 74 5f 70 61 67 65 72 5f 73 74 61 74 65 sert_pager_state
31080 28 70 50 61 67 65 72 29 20 29 3b 0a 0a 20 20 69 (pPager) );.. i
31090 66 28 20 70 67 6e 6f 3d 3d 30 20 29 7b 0a 20 20 f( pgno==0 ){.
310a0 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f return SQLITE_
310b0 43 4f 52 52 55 50 54 5f 42 4b 50 54 3b 0a 20 20 CORRUPT_BKPT;.
310c0 7d 0a 0a 20 20 2f 2a 20 49 66 20 74 68 65 20 70 }.. /* If the p
310d0 61 67 65 72 20 69 73 20 69 6e 20 74 68 65 20 65 ager is in the e
310e0 72 72 6f 72 20 73 74 61 74 65 2c 20 72 65 74 75 rror state, retu
310f0 72 6e 20 61 6e 20 65 72 72 6f 72 20 69 6d 6d 65 rn an error imme
31100 64 69 61 74 65 6c 79 2e 20 0a 20 20 2a 2a 20 4f diately. . ** O
31110 74 68 65 72 77 69 73 65 2c 20 72 65 71 75 65 73 therwise, reques
31120 74 20 74 68 65 20 70 61 67 65 20 66 72 6f 6d 20 t the page from
31130 74 68 65 20 50 43 61 63 68 65 20 6c 61 79 65 72 the PCache layer
31140 2e 20 2a 2f 0a 20 20 69 66 28 20 70 50 61 67 65 . */. if( pPage
31150 72 2d 3e 65 72 72 43 6f 64 65 21 3d 53 51 4c 49 r->errCode!=SQLI
31160 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 72 63 20 TE_OK ){. rc
31170 3d 20 70 50 61 67 65 72 2d 3e 65 72 72 43 6f 64 = pPager->errCod
31180 65 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 e;. }else{.
31190 72 63 20 3d 20 73 71 6c 69 74 65 33 50 63 61 63 rc = sqlite3Pcac
311a0 68 65 46 65 74 63 68 28 70 50 61 67 65 72 2d 3e heFetch(pPager->
311b0 70 50 43 61 63 68 65 2c 20 70 67 6e 6f 2c 20 31 pPCache, pgno, 1
311c0 2c 20 70 70 50 61 67 65 29 3b 0a 20 20 7d 0a 0a , ppPage);. }..
311d0 20 20 69 66 28 20 72 63 21 3d 53 51 4c 49 54 45 if( rc!=SQLITE
311e0 5f 4f 4b 20 29 7b 0a 20 20 20 20 2f 2a 20 45 69 _OK ){. /* Ei
311f0 74 68 65 72 20 74 68 65 20 63 61 6c 6c 20 74 6f ther the call to
31200 20 73 71 6c 69 74 65 33 50 63 61 63 68 65 46 65 sqlite3PcacheFe
31210 74 63 68 28 29 20 72 65 74 75 72 6e 65 64 20 61 tch() returned a
31220 6e 20 65 72 72 6f 72 20 6f 72 20 74 68 65 0a 20 n error or the.
31230 20 20 20 2a 2a 20 70 61 67 65 72 20 77 61 73 20 ** pager was
31240 61 6c 72 65 61 64 79 20 69 6e 20 74 68 65 20 65 already in the e
31250 72 72 6f 72 2d 73 74 61 74 65 20 77 68 65 6e 20 rror-state when
31260 74 68 69 73 20 66 75 6e 63 74 69 6f 6e 20 77 61 this function wa
31270 73 20 63 61 6c 6c 65 64 2e 0a 20 20 20 20 2a 2a s called.. **
31280 20 53 65 74 20 70 50 67 20 74 6f 20 30 20 61 6e Set pPg to 0 an
31290 64 20 6a 75 6d 70 20 74 6f 20 74 68 65 20 65 78 d jump to the ex
312a0 63 65 70 74 69 6f 6e 20 68 61 6e 64 6c 65 72 2e ception handler.
312b0 20 20 2a 2f 0a 20 20 20 20 70 50 67 20 3d 20 30 */. pPg = 0
312c0 3b 0a 20 20 20 20 67 6f 74 6f 20 70 61 67 65 72 ;. goto pager
312d0 5f 61 63 71 75 69 72 65 5f 65 72 72 3b 0a 20 20 _acquire_err;.
312e0 7d 0a 20 20 61 73 73 65 72 74 28 20 28 2a 70 70 }. assert( (*pp
312f0 50 61 67 65 29 2d 3e 70 67 6e 6f 3d 3d 70 67 6e Page)->pgno==pgn
31300 6f 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 28 o );. assert( (
31310 2a 70 70 50 61 67 65 29 2d 3e 70 50 61 67 65 72 *ppPage)->pPager
31320 3d 3d 70 50 61 67 65 72 20 7c 7c 20 28 2a 70 70 ==pPager || (*pp
31330 50 61 67 65 29 2d 3e 70 50 61 67 65 72 3d 3d 30 Page)->pPager==0
31340 20 29 3b 0a 0a 20 20 69 66 28 20 28 2a 70 70 50 );.. if( (*ppP
31350 61 67 65 29 2d 3e 70 50 61 67 65 72 20 26 26 20 age)->pPager &&
31360 21 6e 6f 43 6f 6e 74 65 6e 74 20 29 7b 0a 20 20 !noContent ){.
31370 20 20 2f 2a 20 49 6e 20 74 68 69 73 20 63 61 73 /* In this cas
31380 65 20 74 68 65 20 70 63 61 63 68 65 20 61 6c 72 e the pcache alr
31390 65 61 64 79 20 63 6f 6e 74 61 69 6e 73 20 61 6e eady contains an
313a0 20 69 6e 69 74 69 61 6c 69 7a 65 64 20 63 6f 70 initialized cop
313b0 79 20 6f 66 0a 20 20 20 20 2a 2a 20 74 68 65 20 y of. ** the
313c0 70 61 67 65 2e 20 52 65 74 75 72 6e 20 77 69 74 page. Return wit
313d0 68 6f 75 74 20 66 75 72 74 68 65 72 20 61 64 6f hout further ado
313e0 2e 20 20 2a 2f 0a 20 20 20 20 61 73 73 65 72 74 . */. assert
313f0 28 20 70 67 6e 6f 3c 3d 50 41 47 45 52 5f 4d 41 ( pgno<=PAGER_MA
31400 58 5f 50 47 4e 4f 20 26 26 20 70 67 6e 6f 21 3d X_PGNO && pgno!=
31410 50 41 47 45 52 5f 4d 4a 5f 50 47 4e 4f 28 70 50 PAGER_MJ_PGNO(pP
31420 61 67 65 72 29 20 29 3b 0a 20 20 20 20 50 41 47 ager) );. PAG
31430 45 52 5f 49 4e 43 52 28 70 50 61 67 65 72 2d 3e ER_INCR(pPager->
31440 6e 48 69 74 29 3b 0a 20 20 20 20 72 65 74 75 72 nHit);. retur
31450 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 0a 20 20 n SQLITE_OK;..
31460 7d 65 6c 73 65 7b 0a 20 20 20 20 2f 2a 20 54 68 }else{. /* Th
31470 65 20 70 61 67 65 72 20 63 61 63 68 65 20 68 61 e pager cache ha
31480 73 20 63 72 65 61 74 65 64 20 61 20 6e 65 77 20 s created a new
31490 70 61 67 65 2e 20 49 74 73 20 63 6f 6e 74 65 6e page. Its conten
314a0 74 20 6e 65 65 64 73 20 74 6f 20 0a 20 20 20 20 t needs to .
314b0 2a 2a 20 62 65 20 69 6e 69 74 69 61 6c 69 7a 65 ** be initialize
314c0 64 2e 20 20 2a 2f 0a 0a 20 20 20 20 50 41 47 45 d. */.. PAGE
314d0 52 5f 49 4e 43 52 28 70 50 61 67 65 72 2d 3e 6e R_INCR(pPager->n
314e0 4d 69 73 73 29 3b 0a 20 20 20 20 70 50 67 20 3d Miss);. pPg =
314f0 20 2a 70 70 50 61 67 65 3b 0a 20 20 20 20 70 50 *ppPage;. pP
31500 67 2d 3e 70 50 61 67 65 72 20 3d 20 70 50 61 67 g->pPager = pPag
31510 65 72 3b 0a 0a 20 20 20 20 2f 2a 20 54 68 65 20 er;.. /* The
31520 6d 61 78 69 6d 75 6d 20 70 61 67 65 20 6e 75 6d maximum page num
31530 62 65 72 20 69 73 20 32 5e 33 31 2e 20 52 65 74 ber is 2^31. Ret
31540 75 72 6e 20 53 51 4c 49 54 45 5f 43 4f 52 52 55 urn SQLITE_CORRU
31550 50 54 20 69 66 20 61 20 70 61 67 65 0a 20 20 20 PT if a page.
31560 20 2a 2a 20 6e 75 6d 62 65 72 20 67 72 65 61 74 ** number great
31570 65 72 20 74 68 61 6e 20 74 68 69 73 2c 20 6f 72 er than this, or
31580 20 74 68 65 20 75 6e 75 73 65 64 20 6c 6f 63 6b the unused lock
31590 69 6e 67 2d 70 61 67 65 2c 20 69 73 20 72 65 71 ing-page, is req
315a0 75 65 73 74 65 64 2e 20 2a 2f 0a 20 20 20 20 69 uested. */. i
315b0 66 28 20 70 67 6e 6f 3e 50 41 47 45 52 5f 4d 41 f( pgno>PAGER_MA
315c0 58 5f 50 47 4e 4f 20 7c 7c 20 70 67 6e 6f 3d 3d X_PGNO || pgno==
315d0 50 41 47 45 52 5f 4d 4a 5f 50 47 4e 4f 28 70 50 PAGER_MJ_PGNO(pP
315e0 61 67 65 72 29 20 29 7b 0a 20 20 20 20 20 20 72 ager) ){. r
315f0 63 20 3d 20 53 51 4c 49 54 45 5f 43 4f 52 52 55 c = SQLITE_CORRU
31600 50 54 5f 42 4b 50 54 3b 0a 20 20 20 20 20 20 67 PT_BKPT;. g
31610 6f 74 6f 20 70 61 67 65 72 5f 61 63 71 75 69 72 oto pager_acquir
31620 65 5f 65 72 72 3b 0a 20 20 20 20 7d 0a 0a 20 20 e_err;. }..
31630 20 20 69 66 28 20 4d 45 4d 44 42 20 7c 7c 20 70 if( MEMDB || p
31640 50 61 67 65 72 2d 3e 64 62 53 69 7a 65 3c 70 67 Pager->dbSize<pg
31650 6e 6f 20 7c 7c 20 6e 6f 43 6f 6e 74 65 6e 74 20 no || noContent
31660 7c 7c 20 21 69 73 4f 70 65 6e 28 70 50 61 67 65 || !isOpen(pPage
31670 72 2d 3e 66 64 29 20 29 7b 0a 20 20 20 20 20 20 r->fd) ){.
31680 69 66 28 20 70 67 6e 6f 3e 70 50 61 67 65 72 2d if( pgno>pPager-
31690 3e 6d 78 50 67 6e 6f 20 29 7b 0a 20 20 20 20 20 >mxPgno ){.
316a0 20 20 20 72 63 20 3d 20 53 51 4c 49 54 45 5f 46 rc = SQLITE_F
316b0 55 4c 4c 3b 0a 20 20 20 20 20 20 20 20 67 6f 74 ULL;. got
316c0 6f 20 70 61 67 65 72 5f 61 63 71 75 69 72 65 5f o pager_acquire_
316d0 65 72 72 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20 err;. }.
316e0 20 20 20 69 66 28 20 6e 6f 43 6f 6e 74 65 6e 74 if( noContent
316f0 20 29 7b 0a 20 20 20 20 20 20 20 20 2f 2a 20 46 ){. /* F
31700 61 69 6c 75 72 65 20 74 6f 20 73 65 74 20 74 68 ailure to set th
31710 65 20 62 69 74 73 20 69 6e 20 74 68 65 20 49 6e e bits in the In
31720 4a 6f 75 72 6e 61 6c 20 62 69 74 2d 76 65 63 74 Journal bit-vect
31730 6f 72 73 20 69 73 20 62 65 6e 69 67 6e 2e 0a 20 ors is benign..
31740 20 20 20 20 20 20 20 2a 2a 20 49 74 20 6d 65 72 ** It mer
31750 65 6c 79 20 6d 65 61 6e 73 20 74 68 61 74 20 77 ely means that w
31760 65 20 6d 69 67 68 74 20 64 6f 20 73 6f 6d 65 20 e might do some
31770 65 78 74 72 61 20 77 6f 72 6b 20 74 6f 20 6a 6f extra work to jo
31780 75 72 6e 61 6c 20 61 20 0a 20 20 20 20 20 20 20 urnal a .
31790 20 2a 2a 20 70 61 67 65 20 74 68 61 74 20 64 6f ** page that do
317a0 65 73 20 6e 6f 74 20 6e 65 65 64 20 74 6f 20 62 es not need to b
317b0 65 20 6a 6f 75 72 6e 61 6c 65 64 2e 20 20 4e 65 e journaled. Ne
317c0 76 65 72 74 68 65 6c 65 73 73 2c 20 62 65 20 73 vertheless, be s
317d0 75 72 65 20 0a 20 20 20 20 20 20 20 20 2a 2a 20 ure . **
317e0 74 6f 20 74 65 73 74 20 74 68 65 20 63 61 73 65 to test the case
317f0 20 77 68 65 72 65 20 61 20 6d 61 6c 6c 6f 63 20 where a malloc
31800 65 72 72 6f 72 20 6f 63 63 75 72 73 20 77 68 69 error occurs whi
31810 6c 65 20 74 72 79 69 6e 67 20 74 6f 20 73 65 74 le trying to set
31820 20 0a 20 20 20 20 20 20 20 20 2a 2a 20 61 20 62 . ** a b
31830 69 74 20 69 6e 20 61 20 62 69 74 20 76 65 63 74 it in a bit vect
31840 6f 72 2e 0a 20 20 20 20 20 20 20 20 2a 2f 0a 20 or.. */.
31850 20 20 20 20 20 20 20 73 71 6c 69 74 65 33 42 65 sqlite3Be
31860 67 69 6e 42 65 6e 69 67 6e 4d 61 6c 6c 6f 63 28 ginBenignMalloc(
31870 29 3b 0a 20 20 20 20 20 20 20 20 69 66 28 20 70 );. if( p
31880 67 6e 6f 3c 3d 70 50 61 67 65 72 2d 3e 64 62 4f gno<=pPager->dbO
31890 72 69 67 53 69 7a 65 20 29 7b 0a 20 20 20 20 20 rigSize ){.
318a0 20 20 20 20 20 54 45 53 54 4f 4e 4c 59 28 20 72 TESTONLY( r
318b0 63 20 3d 20 29 20 73 71 6c 69 74 65 33 42 69 74 c = ) sqlite3Bit
318c0 76 65 63 53 65 74 28 70 50 61 67 65 72 2d 3e 70 vecSet(pPager->p
318d0 49 6e 4a 6f 75 72 6e 61 6c 2c 20 70 67 6e 6f 29 InJournal, pgno)
318e0 3b 0a 20 20 20 20 20 20 20 20 20 20 74 65 73 74 ;. test
318f0 63 61 73 65 28 20 72 63 3d 3d 53 51 4c 49 54 45 case( rc==SQLITE
31900 5f 4e 4f 4d 45 4d 20 29 3b 0a 20 20 20 20 20 20 _NOMEM );.
31910 20 20 7d 0a 20 20 20 20 20 20 20 20 54 45 53 54 }. TEST
31920 4f 4e 4c 59 28 20 72 63 20 3d 20 29 20 61 64 64 ONLY( rc = ) add
31930 54 6f 53 61 76 65 70 6f 69 6e 74 42 69 74 76 65 ToSavepointBitve
31940 63 73 28 70 50 61 67 65 72 2c 20 70 67 6e 6f 29 cs(pPager, pgno)
31950 3b 0a 20 20 20 20 20 20 20 20 74 65 73 74 63 61 ;. testca
31960 73 65 28 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4e se( rc==SQLITE_N
31970 4f 4d 45 4d 20 29 3b 0a 20 20 20 20 20 20 20 20 OMEM );.
31980 73 71 6c 69 74 65 33 45 6e 64 42 65 6e 69 67 6e sqlite3EndBenign
31990 4d 61 6c 6c 6f 63 28 29 3b 0a 20 20 20 20 20 20 Malloc();.
319a0 7d 0a 20 20 20 20 20 20 6d 65 6d 73 65 74 28 70 }. memset(p
319b0 50 67 2d 3e 70 44 61 74 61 2c 20 30 2c 20 70 50 Pg->pData, 0, pP
319c0 61 67 65 72 2d 3e 70 61 67 65 53 69 7a 65 29 3b ager->pageSize);
319d0 0a 20 20 20 20 20 20 49 4f 54 52 41 43 45 28 28 . IOTRACE((
319e0 22 5a 45 52 4f 20 25 70 20 25 64 5c 6e 22 2c 20 "ZERO %p %d\n",
319f0 70 50 61 67 65 72 2c 20 70 67 6e 6f 29 29 3b 0a pPager, pgno));.
31a00 20 20 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 20 }else{.
31a10 20 61 73 73 65 72 74 28 20 70 50 67 2d 3e 70 50 assert( pPg->pP
31a20 61 67 65 72 3d 3d 70 50 61 67 65 72 20 29 3b 0a ager==pPager );.
31a30 20 20 20 20 20 20 72 63 20 3d 20 72 65 61 64 44 rc = readD
31a40 62 50 61 67 65 28 70 50 67 29 3b 0a 20 20 20 20 bPage(pPg);.
31a50 20 20 69 66 28 20 72 63 21 3d 53 51 4c 49 54 45 if( rc!=SQLITE
31a60 5f 4f 4b 20 29 7b 0a 20 20 20 20 20 20 20 20 67 _OK ){. g
31a70 6f 74 6f 20 70 61 67 65 72 5f 61 63 71 75 69 72 oto pager_acquir
31a80 65 5f 65 72 72 3b 0a 20 20 20 20 20 20 7d 0a 20 e_err;. }.
31a90 20 20 20 7d 0a 20 20 20 20 70 61 67 65 72 5f 73 }. pager_s
31aa0 65 74 5f 70 61 67 65 68 61 73 68 28 70 50 67 29 et_pagehash(pPg)
31ab0 3b 0a 20 20 7d 0a 0a 20 20 72 65 74 75 72 6e 20 ;. }.. return
31ac0 53 51 4c 49 54 45 5f 4f 4b 3b 0a 0a 70 61 67 65 SQLITE_OK;..page
31ad0 72 5f 61 63 71 75 69 72 65 5f 65 72 72 3a 0a 20 r_acquire_err:.
31ae0 20 61 73 73 65 72 74 28 20 72 63 21 3d 53 51 4c assert( rc!=SQL
31af0 49 54 45 5f 4f 4b 20 29 3b 0a 20 20 69 66 28 20 ITE_OK );. if(
31b00 70 50 67 20 29 7b 0a 20 20 20 20 73 71 6c 69 74 pPg ){. sqlit
31b10 65 33 50 63 61 63 68 65 44 72 6f 70 28 70 50 67 e3PcacheDrop(pPg
31b20 29 3b 0a 20 20 7d 0a 20 20 70 61 67 65 72 55 6e );. }. pagerUn
31b30 6c 6f 63 6b 49 66 55 6e 75 73 65 64 28 70 50 61 lockIfUnused(pPa
31b40 67 65 72 29 3b 0a 0a 20 20 2a 70 70 50 61 67 65 ger);.. *ppPage
31b50 20 3d 20 30 3b 0a 20 20 72 65 74 75 72 6e 20 72 = 0;. return r
31b60 63 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 41 63 71 75 c;.}../*.** Acqu
31b70 69 72 65 20 61 20 70 61 67 65 20 69 66 20 69 74 ire a page if it
31b80 20 69 73 20 61 6c 72 65 61 64 79 20 69 6e 20 74 is already in t
31b90 68 65 20 69 6e 2d 6d 65 6d 6f 72 79 20 63 61 63 he in-memory cac
31ba0 68 65 2e 20 20 44 6f 0a 2a 2a 20 6e 6f 74 20 72 he. Do.** not r
31bb0 65 61 64 20 74 68 65 20 70 61 67 65 20 66 72 6f ead the page fro
31bc0 6d 20 64 69 73 6b 2e 20 20 52 65 74 75 72 6e 20 m disk. Return
31bd0 61 20 70 6f 69 6e 74 65 72 20 74 6f 20 74 68 65 a pointer to the
31be0 20 70 61 67 65 2c 0a 2a 2a 20 6f 72 20 30 20 69 page,.** or 0 i
31bf0 66 20 74 68 65 20 70 61 67 65 20 69 73 20 6e 6f f the page is no
31c00 74 20 69 6e 20 63 61 63 68 65 2e 20 0a 2a 2a 0a t in cache. .**.
31c10 2a 2a 20 53 65 65 20 61 6c 73 6f 20 73 71 6c 69 ** See also sqli
31c20 74 65 33 50 61 67 65 72 47 65 74 28 29 2e 20 20 te3PagerGet().
31c30 54 68 65 20 64 69 66 66 65 72 65 6e 63 65 20 62 The difference b
31c40 65 74 77 65 65 6e 20 74 68 69 73 20 72 6f 75 74 etween this rout
31c50 69 6e 65 0a 2a 2a 20 61 6e 64 20 73 71 6c 69 74 ine.** and sqlit
31c60 65 33 50 61 67 65 72 47 65 74 28 29 20 69 73 20 e3PagerGet() is
31c70 74 68 61 74 20 5f 67 65 74 28 29 20 77 69 6c 6c that _get() will
31c80 20 67 6f 20 74 6f 20 74 68 65 20 64 69 73 6b 20 go to the disk
31c90 61 6e 64 20 72 65 61 64 0a 2a 2a 20 69 6e 20 74 and read.** in t
31ca0 68 65 20 70 61 67 65 20 69 66 20 74 68 65 20 70 he page if the p
31cb0 61 67 65 20 69 73 20 6e 6f 74 20 61 6c 72 65 61 age is not alrea
31cc0 64 79 20 69 6e 20 63 61 63 68 65 2e 20 20 54 68 dy in cache. Th
31cd0 69 73 20 72 6f 75 74 69 6e 65 0a 2a 2a 20 72 65 is routine.** re
31ce0 74 75 72 6e 73 20 4e 55 4c 4c 20 69 66 20 74 68 turns NULL if th
31cf0 65 20 70 61 67 65 20 69 73 20 6e 6f 74 20 69 6e e page is not in
31d00 20 63 61 63 68 65 20 6f 72 20 69 66 20 61 20 64 cache or if a d
31d10 69 73 6b 20 49 2f 4f 20 65 72 72 6f 72 20 0a 2a isk I/O error .*
31d20 2a 20 68 61 73 20 65 76 65 72 20 68 61 70 70 65 * has ever happe
31d30 6e 65 64 2e 0a 2a 2f 0a 44 62 50 61 67 65 20 2a ned..*/.DbPage *
31d40 73 71 6c 69 74 65 33 50 61 67 65 72 4c 6f 6f 6b sqlite3PagerLook
31d50 75 70 28 50 61 67 65 72 20 2a 70 50 61 67 65 72 up(Pager *pPager
31d60 2c 20 50 67 6e 6f 20 70 67 6e 6f 29 7b 0a 20 20 , Pgno pgno){.
31d70 50 67 48 64 72 20 2a 70 50 67 20 3d 20 30 3b 0a PgHdr *pPg = 0;.
31d80 20 20 61 73 73 65 72 74 28 20 70 50 61 67 65 72 assert( pPager
31d90 21 3d 30 20 29 3b 0a 20 20 61 73 73 65 72 74 28 !=0 );. assert(
31da0 20 70 67 6e 6f 21 3d 30 20 29 3b 0a 20 20 61 73 pgno!=0 );. as
31db0 73 65 72 74 28 20 70 50 61 67 65 72 2d 3e 70 50 sert( pPager->pP
31dc0 43 61 63 68 65 21 3d 30 20 29 3b 0a 20 20 61 73 Cache!=0 );. as
31dd0 73 65 72 74 28 20 70 50 61 67 65 72 2d 3e 65 53 sert( pPager->eS
31de0 74 61 74 65 3e 3d 50 41 47 45 52 5f 52 45 41 44 tate>=PAGER_READ
31df0 45 52 20 26 26 20 70 50 61 67 65 72 2d 3e 65 53 ER && pPager->eS
31e00 74 61 74 65 21 3d 50 41 47 45 52 5f 45 52 52 4f tate!=PAGER_ERRO
31e10 52 20 29 3b 0a 20 20 73 71 6c 69 74 65 33 50 63 R );. sqlite3Pc
31e20 61 63 68 65 46 65 74 63 68 28 70 50 61 67 65 72 acheFetch(pPager
31e30 2d 3e 70 50 43 61 63 68 65 2c 20 70 67 6e 6f 2c ->pPCache, pgno,
31e40 20 30 2c 20 26 70 50 67 29 3b 0a 20 20 72 65 74 0, &pPg);. ret
31e50 75 72 6e 20 70 50 67 3b 0a 7d 0a 0a 2f 2a 0a 2a urn pPg;.}../*.*
31e60 2a 20 52 65 6c 65 61 73 65 20 61 20 70 61 67 65 * Release a page
31e70 20 72 65 66 65 72 65 6e 63 65 2e 0a 2a 2a 0a 2a reference..**.*
31e80 2a 20 49 66 20 74 68 65 20 6e 75 6d 62 65 72 20 * If the number
31e90 6f 66 20 72 65 66 65 72 65 6e 63 65 73 20 74 6f of references to
31ea0 20 74 68 65 20 70 61 67 65 20 64 72 6f 70 20 74 the page drop t
31eb0 6f 20 7a 65 72 6f 2c 20 74 68 65 6e 20 74 68 65 o zero, then the
31ec0 0a 2a 2a 20 70 61 67 65 20 69 73 20 61 64 64 65 .** page is adde
31ed0 64 20 74 6f 20 74 68 65 20 4c 52 55 20 6c 69 73 d to the LRU lis
31ee0 74 2e 20 20 57 68 65 6e 20 61 6c 6c 20 72 65 66 t. When all ref
31ef0 65 72 65 6e 63 65 73 20 74 6f 20 61 6c 6c 20 70 erences to all p
31f00 61 67 65 73 0a 2a 2a 20 61 72 65 20 72 65 6c 65 ages.** are rele
31f10 61 73 65 64 2c 20 61 20 72 6f 6c 6c 62 61 63 6b ased, a rollback
31f20 20 6f 63 63 75 72 73 20 61 6e 64 20 74 68 65 20 occurs and the
31f30 6c 6f 63 6b 20 6f 6e 20 74 68 65 20 64 61 74 61 lock on the data
31f40 62 61 73 65 20 69 73 0a 2a 2a 20 72 65 6d 6f 76 base is.** remov
31f50 65 64 2e 0a 2a 2f 0a 76 6f 69 64 20 73 71 6c 69 ed..*/.void sqli
31f60 74 65 33 50 61 67 65 72 55 6e 72 65 66 28 44 62 te3PagerUnref(Db
31f70 50 61 67 65 20 2a 70 50 67 29 7b 0a 20 20 69 66 Page *pPg){. if
31f80 28 20 70 50 67 20 29 7b 0a 20 20 20 20 50 61 67 ( pPg ){. Pag
31f90 65 72 20 2a 70 50 61 67 65 72 20 3d 20 70 50 67 er *pPager = pPg
31fa0 2d 3e 70 50 61 67 65 72 3b 0a 20 20 20 20 73 71 ->pPager;. sq
31fb0 6c 69 74 65 33 50 63 61 63 68 65 52 65 6c 65 61 lite3PcacheRelea
31fc0 73 65 28 70 50 67 29 3b 0a 20 20 20 20 70 61 67 se(pPg);. pag
31fd0 65 72 55 6e 6c 6f 63 6b 49 66 55 6e 75 73 65 64 erUnlockIfUnused
31fe0 28 70 50 61 67 65 72 29 3b 0a 20 20 7d 0a 7d 0a (pPager);. }.}.
31ff0 0a 2f 2a 0a 2a 2a 20 54 68 69 73 20 66 75 6e 63 ./*.** This func
32000 74 69 6f 6e 20 69 73 20 63 61 6c 6c 65 64 20 61 tion is called a
32010 74 20 74 68 65 20 73 74 61 72 74 20 6f 66 20 65 t the start of e
32020 76 65 72 79 20 77 72 69 74 65 20 74 72 61 6e 73 very write trans
32030 61 63 74 69 6f 6e 2e 0a 2a 2a 20 54 68 65 72 65 action..** There
32040 20 6d 75 73 74 20 61 6c 72 65 61 64 79 20 62 65 must already be
32050 20 61 20 52 45 53 45 52 56 45 44 20 6f 72 20 45 a RESERVED or E
32060 58 43 4c 55 53 49 56 45 20 6c 6f 63 6b 20 6f 6e XCLUSIVE lock on
32070 20 74 68 65 20 64 61 74 61 62 61 73 65 20 0a 2a the database .*
32080 2a 20 66 69 6c 65 20 77 68 65 6e 20 74 68 69 73 * file when this
32090 20 72 6f 75 74 69 6e 65 20 69 73 20 63 61 6c 6c routine is call
320a0 65 64 2e 0a 2a 2a 0a 2a 2a 20 4f 70 65 6e 20 74 ed..**.** Open t
320b0 68 65 20 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 20 he journal file
320c0 66 6f 72 20 70 61 67 65 72 20 70 50 61 67 65 72 for pager pPager
320d0 20 61 6e 64 20 77 72 69 74 65 20 61 20 6a 6f 75 and write a jou
320e0 72 6e 61 6c 20 68 65 61 64 65 72 0a 2a 2a 20 74 rnal header.** t
320f0 6f 20 74 68 65 20 73 74 61 72 74 20 6f 66 20 69 o the start of i
32100 74 2e 20 49 66 20 74 68 65 72 65 20 61 72 65 20 t. If there are
32110 61 63 74 69 76 65 20 73 61 76 65 70 6f 69 6e 74 active savepoint
32120 73 2c 20 6f 70 65 6e 20 74 68 65 20 73 75 62 2d s, open the sub-
32130 6a 6f 75 72 6e 61 6c 0a 2a 2a 20 61 73 20 77 65 journal.** as we
32140 6c 6c 2e 20 54 68 69 73 20 66 75 6e 63 74 69 6f ll. This functio
32150 6e 20 69 73 20 6f 6e 6c 79 20 75 73 65 64 20 77 n is only used w
32160 68 65 6e 20 74 68 65 20 6a 6f 75 72 6e 61 6c 20 hen the journal
32170 66 69 6c 65 20 69 73 20 62 65 69 6e 67 20 0a 2a file is being .*
32180 2a 20 6f 70 65 6e 65 64 20 74 6f 20 77 72 69 74 * opened to writ
32190 65 20 61 20 72 6f 6c 6c 62 61 63 6b 20 6c 6f 67 e a rollback log
321a0 20 66 6f 72 20 61 20 74 72 61 6e 73 61 63 74 69 for a transacti
321b0 6f 6e 2e 20 49 74 20 69 73 20 6e 6f 74 20 75 73 on. It is not us
321c0 65 64 20 0a 2a 2a 20 77 68 65 6e 20 6f 70 65 6e ed .** when open
321d0 69 6e 67 20 61 20 68 6f 74 20 6a 6f 75 72 6e 61 ing a hot journa
321e0 6c 20 66 69 6c 65 20 74 6f 20 72 6f 6c 6c 20 69 l file to roll i
321f0 74 20 62 61 63 6b 2e 0a 2a 2a 0a 2a 2a 20 49 66 t back..**.** If
32200 20 74 68 65 20 6a 6f 75 72 6e 61 6c 20 66 69 6c the journal fil
32210 65 20 69 73 20 61 6c 72 65 61 64 79 20 6f 70 65 e is already ope
32220 6e 20 28 61 73 20 69 74 20 6d 61 79 20 62 65 20 n (as it may be
32230 69 6e 20 65 78 63 6c 75 73 69 76 65 20 6d 6f 64 in exclusive mod
32240 65 29 2c 0a 2a 2a 20 74 68 65 6e 20 74 68 69 73 e),.** then this
32250 20 66 75 6e 63 74 69 6f 6e 20 6a 75 73 74 20 77 function just w
32260 72 69 74 65 73 20 61 20 6a 6f 75 72 6e 61 6c 20 rites a journal
32270 68 65 61 64 65 72 20 74 6f 20 74 68 65 20 73 74 header to the st
32280 61 72 74 20 6f 66 20 74 68 65 0a 2a 2a 20 61 6c art of the.** al
32290 72 65 61 64 79 20 6f 70 65 6e 20 66 69 6c 65 2e ready open file.
322a0 20 0a 2a 2a 0a 2a 2a 20 57 68 65 74 68 65 72 20 .**.** Whether
322b0 6f 72 20 6e 6f 74 20 74 68 65 20 6a 6f 75 72 6e or not the journ
322c0 61 6c 20 66 69 6c 65 20 69 73 20 6f 70 65 6e 65 al file is opene
322d0 64 20 62 79 20 74 68 69 73 20 66 75 6e 63 74 69 d by this functi
322e0 6f 6e 2c 20 74 68 65 0a 2a 2a 20 50 61 67 65 72 on, the.** Pager
322f0 2e 70 49 6e 4a 6f 75 72 6e 61 6c 20 62 69 74 76 .pInJournal bitv
32300 65 63 20 73 74 72 75 63 74 75 72 65 20 69 73 20 ec structure is
32310 61 6c 6c 6f 63 61 74 65 64 2e 0a 2a 2a 0a 2a 2a allocated..**.**
32320 20 52 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f Return SQLITE_O
32330 4b 20 69 66 20 65 76 65 72 79 74 68 69 6e 67 20 K if everything
32340 69 73 20 73 75 63 63 65 73 73 66 75 6c 2e 20 4f is successful. O
32350 74 68 65 72 77 69 73 65 2c 20 72 65 74 75 72 6e therwise, return
32360 20 0a 2a 2a 20 53 51 4c 49 54 45 5f 4e 4f 4d 45 .** SQLITE_NOME
32370 4d 20 69 66 20 74 68 65 20 61 74 74 65 6d 70 74 M if the attempt
32380 20 74 6f 20 61 6c 6c 6f 63 61 74 65 20 50 61 67 to allocate Pag
32390 65 72 2e 70 49 6e 4a 6f 75 72 6e 61 6c 20 66 61 er.pInJournal fa
323a0 69 6c 73 2c 20 6f 72 20 0a 2a 2a 20 61 6e 20 49 ils, or .** an I
323b0 4f 20 65 72 72 6f 72 20 63 6f 64 65 20 69 66 20 O error code if
323c0 6f 70 65 6e 69 6e 67 20 6f 72 20 77 72 69 74 69 opening or writi
323d0 6e 67 20 74 68 65 20 6a 6f 75 72 6e 61 6c 20 66 ng the journal f
323e0 69 6c 65 20 66 61 69 6c 73 2e 0a 2a 2f 0a 73 74 ile fails..*/.st
323f0 61 74 69 63 20 69 6e 74 20 70 61 67 65 72 5f 6f atic int pager_o
32400 70 65 6e 5f 6a 6f 75 72 6e 61 6c 28 50 61 67 65 pen_journal(Page
32410 72 20 2a 70 50 61 67 65 72 29 7b 0a 20 20 69 6e r *pPager){. in
32420 74 20 72 63 20 3d 20 53 51 4c 49 54 45 5f 4f 4b t rc = SQLITE_OK
32430 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 ;
32440 20 20 20 20 20 20 20 20 20 2f 2a 20 52 65 74 75 /* Retu
32450 72 6e 20 63 6f 64 65 20 2a 2f 0a 20 20 73 71 6c rn code */. sql
32460 69 74 65 33 5f 76 66 73 20 2a 20 63 6f 6e 73 74 ite3_vfs * const
32470 20 70 56 66 73 20 3d 20 70 50 61 67 65 72 2d 3e pVfs = pPager->
32480 70 56 66 73 3b 20 20 20 2f 2a 20 4c 6f 63 61 6c pVfs; /* Local
32490 20 63 61 63 68 65 20 6f 66 20 76 66 73 20 70 6f cache of vfs po
324a0 69 6e 74 65 72 20 2a 2f 0a 0a 20 20 61 73 73 65 inter */.. asse
324b0 72 74 28 20 70 50 61 67 65 72 2d 3e 65 53 74 61 rt( pPager->eSta
324c0 74 65 3d 3d 50 41 47 45 52 5f 57 52 49 54 45 52 te==PAGER_WRITER
324d0 5f 4c 4f 43 4b 45 44 20 29 3b 0a 20 20 61 73 73 _LOCKED );. ass
324e0 65 72 74 28 20 61 73 73 65 72 74 5f 70 61 67 65 ert( assert_page
324f0 72 5f 73 74 61 74 65 28 70 50 61 67 65 72 29 20 r_state(pPager)
32500 29 3b 0a 20 20 61 73 73 65 72 74 28 20 70 50 61 );. assert( pPa
32510 67 65 72 2d 3e 70 49 6e 4a 6f 75 72 6e 61 6c 3d ger->pInJournal=
32520 3d 30 20 29 3b 0a 20 20 0a 20 20 2f 2a 20 49 66 =0 );. . /* If
32530 20 61 6c 72 65 61 64 79 20 69 6e 20 74 68 65 20 already in the
32540 65 72 72 6f 72 20 73 74 61 74 65 2c 20 74 68 69 error state, thi
32550 73 20 66 75 6e 63 74 69 6f 6e 20 69 73 20 61 20 s function is a
32560 6e 6f 2d 6f 70 2e 20 20 42 75 74 20 6f 6e 0a 20 no-op. But on.
32570 20 2a 2a 20 74 68 65 20 6f 74 68 65 72 20 68 61 ** the other ha
32580 6e 64 2c 20 74 68 69 73 20 72 6f 75 74 69 6e 65 nd, this routine
32590 20 69 73 20 6e 65 76 65 72 20 63 61 6c 6c 65 64 is never called
325a0 20 69 66 20 77 65 20 61 72 65 20 61 6c 72 65 61 if we are alrea
325b0 64 79 20 69 6e 0a 20 20 2a 2a 20 61 6e 20 65 72 dy in. ** an er
325c0 72 6f 72 20 73 74 61 74 65 2e 20 2a 2f 0a 20 20 ror state. */.
325d0 69 66 28 20 4e 45 56 45 52 28 70 50 61 67 65 72 if( NEVER(pPager
325e0 2d 3e 65 72 72 43 6f 64 65 29 20 29 20 72 65 74 ->errCode) ) ret
325f0 75 72 6e 20 70 50 61 67 65 72 2d 3e 65 72 72 43 urn pPager->errC
32600 6f 64 65 3b 0a 0a 20 20 69 66 28 20 21 70 61 67 ode;.. if( !pag
32610 65 72 55 73 65 57 61 6c 28 70 50 61 67 65 72 29 erUseWal(pPager)
32620 20 26 26 20 70 50 61 67 65 72 2d 3e 6a 6f 75 72 && pPager->jour
32630 6e 61 6c 4d 6f 64 65 21 3d 50 41 47 45 52 5f 4a nalMode!=PAGER_J
32640 4f 55 52 4e 41 4c 4d 4f 44 45 5f 4f 46 46 20 29 OURNALMODE_OFF )
32650 7b 0a 20 20 20 20 70 50 61 67 65 72 2d 3e 70 49 {. pPager->pI
32660 6e 4a 6f 75 72 6e 61 6c 20 3d 20 73 71 6c 69 74 nJournal = sqlit
32670 65 33 42 69 74 76 65 63 43 72 65 61 74 65 28 70 e3BitvecCreate(p
32680 50 61 67 65 72 2d 3e 64 62 53 69 7a 65 29 3b 0a Pager->dbSize);.
32690 20 20 20 20 69 66 28 20 70 50 61 67 65 72 2d 3e if( pPager->
326a0 70 49 6e 4a 6f 75 72 6e 61 6c 3d 3d 30 20 29 7b pInJournal==0 ){
326b0 0a 20 20 20 20 20 20 72 65 74 75 72 6e 20 53 51 . return SQ
326c0 4c 49 54 45 5f 4e 4f 4d 45 4d 3b 0a 20 20 20 20 LITE_NOMEM;.
326d0 7d 0a 20 20 0a 20 20 20 20 2f 2a 20 4f 70 65 6e }. . /* Open
326e0 20 74 68 65 20 6a 6f 75 72 6e 61 6c 20 66 69 6c the journal fil
326f0 65 20 69 66 20 69 74 20 69 73 20 6e 6f 74 20 61 e if it is not a
32700 6c 72 65 61 64 79 20 6f 70 65 6e 2e 20 2a 2f 0a lready open. */.
32710 20 20 20 20 69 66 28 20 21 69 73 4f 70 65 6e 28 if( !isOpen(
32720 70 50 61 67 65 72 2d 3e 6a 66 64 29 20 29 7b 0a pPager->jfd) ){.
32730 20 20 20 20 20 20 69 66 28 20 70 50 61 67 65 72 if( pPager
32740 2d 3e 6a 6f 75 72 6e 61 6c 4d 6f 64 65 3d 3d 50 ->journalMode==P
32750 41 47 45 52 5f 4a 4f 55 52 4e 41 4c 4d 4f 44 45 AGER_JOURNALMODE
32760 5f 4d 45 4d 4f 52 59 20 29 7b 0a 20 20 20 20 20 _MEMORY ){.
32770 20 20 20 73 71 6c 69 74 65 33 4d 65 6d 4a 6f 75 sqlite3MemJou
32780 72 6e 61 6c 4f 70 65 6e 28 70 50 61 67 65 72 2d rnalOpen(pPager-
32790 3e 6a 66 64 29 3b 0a 20 20 20 20 20 20 7d 65 6c >jfd);. }el
327a0 73 65 7b 0a 20 20 20 20 20 20 20 20 63 6f 6e 73 se{. cons
327b0 74 20 69 6e 74 20 66 6c 61 67 73 20 3d 20 20 20 t int flags =
327c0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
327d0 2f 2a 20 56 46 53 20 66 6c 61 67 73 20 74 6f 20 /* VFS flags to
327e0 6f 70 65 6e 20 6a 6f 75 72 6e 61 6c 20 66 69 6c open journal fil
327f0 65 20 2a 2f 0a 20 20 20 20 20 20 20 20 20 20 53 e */. S
32800 51 4c 49 54 45 5f 4f 50 45 4e 5f 52 45 41 44 57 QLITE_OPEN_READW
32810 52 49 54 45 7c 53 51 4c 49 54 45 5f 4f 50 45 4e RITE|SQLITE_OPEN
32820 5f 43 52 45 41 54 45 7c 0a 20 20 20 20 20 20 20 _CREATE|.
32830 20 20 20 28 70 50 61 67 65 72 2d 3e 74 65 6d 70 (pPager->temp
32840 46 69 6c 65 20 3f 20 0a 20 20 20 20 20 20 20 20 File ? .
32850 20 20 20 20 28 53 51 4c 49 54 45 5f 4f 50 45 4e (SQLITE_OPEN
32860 5f 44 45 4c 45 54 45 4f 4e 43 4c 4f 53 45 7c 53 _DELETEONCLOSE|S
32870 51 4c 49 54 45 5f 4f 50 45 4e 5f 54 45 4d 50 5f QLITE_OPEN_TEMP_
32880 4a 4f 55 52 4e 41 4c 29 3a 0a 20 20 20 20 20 20 JOURNAL):.
32890 20 20 20 20 20 20 28 53 51 4c 49 54 45 5f 4f 50 (SQLITE_OP
328a0 45 4e 5f 4d 41 49 4e 5f 4a 4f 55 52 4e 41 4c 29 EN_MAIN_JOURNAL)
328b0 0a 20 20 20 20 20 20 20 20 20 20 29 3b 0a 20 20 . );.
328c0 23 69 66 64 65 66 20 53 51 4c 49 54 45 5f 45 4e #ifdef SQLITE_EN
328d0 41 42 4c 45 5f 41 54 4f 4d 49 43 5f 57 52 49 54 ABLE_ATOMIC_WRIT
328e0 45 0a 20 20 20 20 20 20 20 20 72 63 20 3d 20 73 E. rc = s
328f0 71 6c 69 74 65 33 4a 6f 75 72 6e 61 6c 4f 70 65 qlite3JournalOpe
32900 6e 28 0a 20 20 20 20 20 20 20 20 20 20 20 20 70 n(. p
32910 56 66 73 2c 20 70 50 61 67 65 72 2d 3e 7a 4a 6f Vfs, pPager->zJo
32920 75 72 6e 61 6c 2c 20 70 50 61 67 65 72 2d 3e 6a urnal, pPager->j
32930 66 64 2c 20 66 6c 61 67 73 2c 20 6a 72 6e 6c 42 fd, flags, jrnlB
32940 75 66 66 65 72 53 69 7a 65 28 70 50 61 67 65 72 ufferSize(pPager
32950 29 0a 20 20 20 20 20 20 20 20 29 3b 0a 20 20 23 ). );. #
32960 65 6c 73 65 0a 20 20 20 20 20 20 20 20 72 63 20 else. rc
32970 3d 20 73 71 6c 69 74 65 33 4f 73 4f 70 65 6e 28 = sqlite3OsOpen(
32980 70 56 66 73 2c 20 70 50 61 67 65 72 2d 3e 7a 4a pVfs, pPager->zJ
32990 6f 75 72 6e 61 6c 2c 20 70 50 61 67 65 72 2d 3e ournal, pPager->
329a0 6a 66 64 2c 20 66 6c 61 67 73 2c 20 30 29 3b 0a jfd, flags, 0);.
329b0 20 20 23 65 6e 64 69 66 0a 20 20 20 20 20 20 7d #endif. }
329c0 0a 20 20 20 20 20 20 61 73 73 65 72 74 28 20 72 . assert( r
329d0 63 21 3d 53 51 4c 49 54 45 5f 4f 4b 20 7c 7c 20 c!=SQLITE_OK ||
329e0 69 73 4f 70 65 6e 28 70 50 61 67 65 72 2d 3e 6a isOpen(pPager->j
329f0 66 64 29 20 29 3b 0a 20 20 20 20 7d 0a 20 20 0a fd) );. }. .
32a00 20 20 0a 20 20 20 20 2f 2a 20 57 72 69 74 65 20 . /* Write
32a10 74 68 65 20 66 69 72 73 74 20 6a 6f 75 72 6e 61 the first journa
32a20 6c 20 68 65 61 64 65 72 20 74 6f 20 74 68 65 20 l header to the
32a30 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 20 61 6e 64 journal file and
32a40 20 6f 70 65 6e 20 0a 20 20 20 20 2a 2a 20 74 68 open . ** th
32a50 65 20 73 75 62 2d 6a 6f 75 72 6e 61 6c 20 69 66 e sub-journal if
32a60 20 6e 65 63 65 73 73 61 72 79 2e 0a 20 20 20 20 necessary..
32a70 2a 2f 0a 20 20 20 20 69 66 28 20 72 63 3d 3d 53 */. if( rc==S
32a80 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 QLITE_OK ){.
32a90 20 20 2f 2a 20 54 4f 44 4f 3a 20 43 68 65 63 6b /* TODO: Check
32aa0 20 69 66 20 61 6c 6c 20 6f 66 20 74 68 65 73 65 if all of these
32ab0 20 61 72 65 20 72 65 61 6c 6c 79 20 72 65 71 75 are really requ
32ac0 69 72 65 64 2e 20 2a 2f 0a 20 20 20 20 20 20 70 ired. */. p
32ad0 50 61 67 65 72 2d 3e 6e 52 65 63 20 3d 20 30 3b Pager->nRec = 0;
32ae0 0a 20 20 20 20 20 20 70 50 61 67 65 72 2d 3e 6a . pPager->j
32af0 6f 75 72 6e 61 6c 4f 66 66 20 3d 20 30 3b 0a 20 ournalOff = 0;.
32b00 20 20 20 20 20 70 50 61 67 65 72 2d 3e 73 65 74 pPager->set
32b10 4d 61 73 74 65 72 20 3d 20 30 3b 0a 20 20 20 20 Master = 0;.
32b20 20 20 70 50 61 67 65 72 2d 3e 6a 6f 75 72 6e 61 pPager->journa
32b30 6c 48 64 72 20 3d 20 30 3b 0a 20 20 20 20 20 20 lHdr = 0;.
32b40 72 63 20 3d 20 77 72 69 74 65 4a 6f 75 72 6e 61 rc = writeJourna
32b50 6c 48 64 72 28 70 50 61 67 65 72 29 3b 0a 20 20 lHdr(pPager);.
32b60 20 20 7d 0a 20 20 7d 0a 0a 20 20 69 66 28 20 72 }. }.. if( r
32b70 63 21 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a c!=SQLITE_OK ){.
32b80 20 20 20 20 73 71 6c 69 74 65 33 42 69 74 76 65 sqlite3Bitve
32b90 63 44 65 73 74 72 6f 79 28 70 50 61 67 65 72 2d cDestroy(pPager-
32ba0 3e 70 49 6e 4a 6f 75 72 6e 61 6c 29 3b 0a 20 20 >pInJournal);.
32bb0 20 20 70 50 61 67 65 72 2d 3e 70 49 6e 4a 6f 75 pPager->pInJou
32bc0 72 6e 61 6c 20 3d 20 30 3b 0a 20 20 7d 65 6c 73 rnal = 0;. }els
32bd0 65 7b 0a 20 20 20 20 61 73 73 65 72 74 28 20 70 e{. assert( p
32be0 50 61 67 65 72 2d 3e 65 53 74 61 74 65 3d 3d 50 Pager->eState==P
32bf0 41 47 45 52 5f 57 52 49 54 45 52 5f 4c 4f 43 4b AGER_WRITER_LOCK
32c00 45 44 20 29 3b 0a 20 20 20 20 70 50 61 67 65 72 ED );. pPager
32c10 2d 3e 65 53 74 61 74 65 20 3d 20 50 41 47 45 52 ->eState = PAGER
32c20 5f 57 52 49 54 45 52 5f 43 41 43 48 45 4d 4f 44 _WRITER_CACHEMOD
32c30 3b 0a 20 20 7d 0a 0a 20 20 72 65 74 75 72 6e 20 ;. }.. return
32c40 72 63 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 42 65 67 rc;.}../*.** Beg
32c50 69 6e 20 61 20 77 72 69 74 65 2d 74 72 61 6e 73 in a write-trans
32c60 61 63 74 69 6f 6e 20 6f 6e 20 74 68 65 20 73 70 action on the sp
32c70 65 63 69 66 69 65 64 20 70 61 67 65 72 20 6f 62 ecified pager ob
32c80 6a 65 63 74 2e 20 49 66 20 61 20 0a 2a 2a 20 77 ject. If a .** w
32c90 72 69 74 65 2d 74 72 61 6e 73 61 63 74 69 6f 6e rite-transaction
32ca0 20 68 61 73 20 61 6c 72 65 61 64 79 20 62 65 65 has already bee
32cb0 6e 20 6f 70 65 6e 65 64 2c 20 74 68 69 73 20 66 n opened, this f
32cc0 75 6e 63 74 69 6f 6e 20 69 73 20 61 20 6e 6f 2d unction is a no-
32cd0 6f 70 2e 0a 2a 2a 0a 2a 2a 20 49 66 20 74 68 65 op..**.** If the
32ce0 20 65 78 46 6c 61 67 20 61 72 67 75 6d 65 6e 74 exFlag argument
32cf0 20 69 73 20 66 61 6c 73 65 2c 20 74 68 65 6e 20 is false, then
32d00 61 63 71 75 69 72 65 20 61 74 20 6c 65 61 73 74 acquire at least
32d10 20 61 20 52 45 53 45 52 56 45 44 0a 2a 2a 20 6c a RESERVED.** l
32d20 6f 63 6b 20 6f 6e 20 74 68 65 20 64 61 74 61 62 ock on the datab
32d30 61 73 65 20 66 69 6c 65 2e 20 49 66 20 65 78 46 ase file. If exF
32d40 6c 61 67 20 69 73 20 74 72 75 65 2c 20 74 68 65 lag is true, the
32d50 6e 20 61 63 71 75 69 72 65 20 61 74 20 6c 65 61 n acquire at lea
32d60 73 74 0a 2a 2a 20 61 6e 20 45 58 43 4c 55 53 49 st.** an EXCLUSI
32d70 56 45 20 6c 6f 63 6b 2e 20 49 66 20 73 75 63 68 VE lock. If such
32d80 20 61 20 6c 6f 63 6b 20 69 73 20 61 6c 72 65 61 a lock is alrea
32d90 64 79 20 68 65 6c 64 2c 20 6e 6f 20 6c 6f 63 6b dy held, no lock
32da0 69 6e 67 20 0a 2a 2a 20 66 75 6e 63 74 69 6f 6e ing .** function
32db0 73 20 6e 65 65 64 20 62 65 20 63 61 6c 6c 65 64 s need be called
32dc0 2e 0a 2a 2a 0a 2a 2a 20 49 66 20 74 68 65 20 73 ..**.** If the s
32dd0 75 62 6a 49 6e 4d 65 6d 6f 72 79 20 61 72 67 75 ubjInMemory argu
32de0 6d 65 6e 74 20 69 73 20 6e 6f 6e 2d 7a 65 72 6f ment is non-zero
32df0 2c 20 74 68 65 6e 20 61 6e 79 20 73 75 62 2d 6a , then any sub-j
32e00 6f 75 72 6e 61 6c 20 6f 70 65 6e 65 64 0a 2a 2a ournal opened.**
32e10 20 77 69 74 68 69 6e 20 74 68 69 73 20 74 72 61 within this tra
32e20 6e 73 61 63 74 69 6f 6e 20 77 69 6c 6c 20 62 65 nsaction will be
32e30 20 6f 70 65 6e 65 64 20 61 73 20 61 6e 20 69 6e opened as an in
32e40 2d 6d 65 6d 6f 72 79 20 66 69 6c 65 2e 20 54 68 -memory file. Th
32e50 69 73 0a 2a 2a 20 68 61 73 20 6e 6f 20 65 66 66 is.** has no eff
32e60 65 63 74 20 69 66 20 74 68 65 20 73 75 62 2d 6a ect if the sub-j
32e70 6f 75 72 6e 61 6c 20 69 73 20 61 6c 72 65 61 64 ournal is alread
32e80 79 20 6f 70 65 6e 65 64 20 28 61 73 20 69 74 20 y opened (as it
32e90 6d 61 79 20 62 65 20 77 68 65 6e 0a 2a 2a 20 72 may be when.** r
32ea0 75 6e 6e 69 6e 67 20 69 6e 20 65 78 63 6c 75 73 unning in exclus
32eb0 69 76 65 20 6d 6f 64 65 29 20 6f 72 20 69 66 20 ive mode) or if
32ec0 74 68 65 20 74 72 61 6e 73 61 63 74 69 6f 6e 20 the transaction
32ed0 64 6f 65 73 20 6e 6f 74 20 72 65 71 75 69 72 65 does not require
32ee0 20 61 0a 2a 2a 20 73 75 62 2d 6a 6f 75 72 6e 61 a.** sub-journa
32ef0 6c 2e 20 49 66 20 74 68 65 20 73 75 62 6a 49 6e l. If the subjIn
32f00 4d 65 6d 6f 72 79 20 61 72 67 75 6d 65 6e 74 20 Memory argument
32f10 69 73 20 7a 65 72 6f 2c 20 74 68 65 6e 20 61 6e is zero, then an
32f20 79 20 72 65 71 75 69 72 65 64 0a 2a 2a 20 73 75 y required.** su
32f30 62 2d 6a 6f 75 72 6e 61 6c 20 69 73 20 69 6d 70 b-journal is imp
32f40 6c 65 6d 65 6e 74 65 64 20 69 6e 2d 6d 65 6d 6f lemented in-memo
32f50 72 79 20 69 66 20 70 50 61 67 65 72 20 69 73 20 ry if pPager is
32f60 61 6e 20 69 6e 2d 6d 65 6d 6f 72 79 20 64 61 74 an in-memory dat
32f70 61 62 61 73 65 2c 20 0a 2a 2a 20 6f 72 20 75 73 abase, .** or us
32f80 69 6e 67 20 61 20 74 65 6d 70 6f 72 61 72 79 20 ing a temporary
32f90 66 69 6c 65 20 6f 74 68 65 72 77 69 73 65 2e 0a file otherwise..
32fa0 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 50 61 */.int sqlite3Pa
32fb0 67 65 72 42 65 67 69 6e 28 50 61 67 65 72 20 2a gerBegin(Pager *
32fc0 70 50 61 67 65 72 2c 20 69 6e 74 20 65 78 46 6c pPager, int exFl
32fd0 61 67 2c 20 69 6e 74 20 73 75 62 6a 49 6e 4d 65 ag, int subjInMe
32fe0 6d 6f 72 79 29 7b 0a 20 20 69 6e 74 20 72 63 20 mory){. int rc
32ff0 3d 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 0a 20 20 = SQLITE_OK;..
33000 69 66 28 20 70 50 61 67 65 72 2d 3e 65 72 72 43 if( pPager->errC
33010 6f 64 65 20 29 20 72 65 74 75 72 6e 20 70 50 61 ode ) return pPa
33020 67 65 72 2d 3e 65 72 72 43 6f 64 65 3b 0a 20 20 ger->errCode;.
33030 61 73 73 65 72 74 28 20 70 50 61 67 65 72 2d 3e assert( pPager->
33040 65 53 74 61 74 65 3e 3d 50 41 47 45 52 5f 52 45 eState>=PAGER_RE
33050 41 44 45 52 20 26 26 20 70 50 61 67 65 72 2d 3e ADER && pPager->
33060 65 53 74 61 74 65 3c 50 41 47 45 52 5f 45 52 52 eState<PAGER_ERR
33070 4f 52 20 29 3b 0a 20 20 70 50 61 67 65 72 2d 3e OR );. pPager->
33080 73 75 62 6a 49 6e 4d 65 6d 6f 72 79 20 3d 20 28 subjInMemory = (
33090 75 38 29 73 75 62 6a 49 6e 4d 65 6d 6f 72 79 3b u8)subjInMemory;
330a0 0a 0a 20 20 69 66 28 20 41 4c 57 41 59 53 28 70 .. if( ALWAYS(p
330b0 50 61 67 65 72 2d 3e 65 53 74 61 74 65 3d 3d 50 Pager->eState==P
330c0 41 47 45 52 5f 52 45 41 44 45 52 29 20 29 7b 0a AGER_READER) ){.
330d0 20 20 20 20 61 73 73 65 72 74 28 20 70 50 61 67 assert( pPag
330e0 65 72 2d 3e 70 49 6e 4a 6f 75 72 6e 61 6c 3d 3d er->pInJournal==
330f0 30 20 29 3b 0a 0a 20 20 20 20 69 66 28 20 70 61 0 );.. if( pa
33100 67 65 72 55 73 65 57 61 6c 28 70 50 61 67 65 72 gerUseWal(pPager
33110 29 20 29 7b 0a 20 20 20 20 20 20 2f 2a 20 49 66 ) ){. /* If
33120 20 74 68 65 20 70 61 67 65 72 20 69 73 20 63 6f the pager is co
33130 6e 66 69 67 75 72 65 64 20 74 6f 20 75 73 65 20 nfigured to use
33140 6c 6f 63 6b 69 6e 67 5f 6d 6f 64 65 3d 65 78 63 locking_mode=exc
33150 6c 75 73 69 76 65 2c 20 61 6e 64 20 61 6e 0a 20 lusive, and an.
33160 20 20 20 20 20 2a 2a 20 65 78 63 6c 75 73 69 76 ** exclusiv
33170 65 20 6c 6f 63 6b 20 6f 6e 20 74 68 65 20 64 61 e lock on the da
33180 74 61 62 61 73 65 20 69 73 20 6e 6f 74 20 61 6c tabase is not al
33190 72 65 61 64 79 20 68 65 6c 64 2c 20 6f 62 74 61 ready held, obta
331a0 69 6e 20 69 74 20 6e 6f 77 2e 0a 20 20 20 20 20 in it now..
331b0 20 2a 2f 0a 20 20 20 20 20 20 69 66 28 20 70 50 */. if( pP
331c0 61 67 65 72 2d 3e 65 78 63 6c 75 73 69 76 65 4d ager->exclusiveM
331d0 6f 64 65 20 26 26 20 73 71 6c 69 74 65 33 57 61 ode && sqlite3Wa
331e0 6c 45 78 63 6c 75 73 69 76 65 4d 6f 64 65 28 70 lExclusiveMode(p
331f0 50 61 67 65 72 2d 3e 70 57 61 6c 2c 20 2d 31 29 Pager->pWal, -1)
33200 20 29 7b 0a 20 20 20 20 20 20 20 20 72 63 20 3d ){. rc =
33210 20 70 61 67 65 72 4c 6f 63 6b 44 62 28 70 50 61 pagerLockDb(pPa
33220 67 65 72 2c 20 45 58 43 4c 55 53 49 56 45 5f 4c ger, EXCLUSIVE_L
33230 4f 43 4b 29 3b 0a 20 20 20 20 20 20 20 20 69 66 OCK);. if
33240 28 20 72 63 21 3d 53 51 4c 49 54 45 5f 4f 4b 20 ( rc!=SQLITE_OK
33250 29 7b 0a 20 20 20 20 20 20 20 20 20 20 72 65 74 ){. ret
33260 75 72 6e 20 72 63 3b 0a 20 20 20 20 20 20 20 20 urn rc;.
33270 7d 0a 20 20 20 20 20 20 20 20 73 71 6c 69 74 65 }. sqlite
33280 33 57 61 6c 45 78 63 6c 75 73 69 76 65 4d 6f 64 3WalExclusiveMod
33290 65 28 70 50 61 67 65 72 2d 3e 70 57 61 6c 2c 20 e(pPager->pWal,
332a0 31 29 3b 0a 20 20 20 20 20 20 7d 0a 0a 20 20 20 1);. }..
332b0 20 20 20 2f 2a 20 47 72 61 62 20 74 68 65 20 77 /* Grab the w
332c0 72 69 74 65 20 6c 6f 63 6b 20 6f 6e 20 74 68 65 rite lock on the
332d0 20 6c 6f 67 20 66 69 6c 65 2e 20 49 66 20 73 75 log file. If su
332e0 63 63 65 73 73 66 75 6c 2c 20 75 70 67 72 61 64 ccessful, upgrad
332f0 65 20 74 6f 0a 20 20 20 20 20 20 2a 2a 20 50 41 e to. ** PA
33300 47 45 52 5f 52 45 53 45 52 56 45 44 20 73 74 61 GER_RESERVED sta
33310 74 65 2e 20 4f 74 68 65 72 77 69 73 65 2c 20 72 te. Otherwise, r
33320 65 74 75 72 6e 20 61 6e 20 65 72 72 6f 72 20 63 eturn an error c
33330 6f 64 65 20 74 6f 20 74 68 65 20 63 61 6c 6c 65 ode to the calle
33340 72 2e 0a 20 20 20 20 20 20 2a 2a 20 54 68 65 20 r.. ** The
33350 62 75 73 79 2d 68 61 6e 64 6c 65 72 20 69 73 20 busy-handler is
33360 6e 6f 74 20 69 6e 76 6f 6b 65 64 20 69 66 20 61 not invoked if a
33370 6e 6f 74 68 65 72 20 63 6f 6e 6e 65 63 74 69 6f nother connectio
33380 6e 20 61 6c 72 65 61 64 79 0a 20 20 20 20 20 20 n already.
33390 2a 2a 20 68 6f 6c 64 73 20 74 68 65 20 77 72 69 ** holds the wri
333a0 74 65 2d 6c 6f 63 6b 2e 20 49 66 20 70 6f 73 73 te-lock. If poss
333b0 69 62 6c 65 2c 20 74 68 65 20 75 70 70 65 72 20 ible, the upper
333c0 6c 61 79 65 72 20 77 69 6c 6c 20 63 61 6c 6c 20 layer will call
333d0 69 74 2e 0a 20 20 20 20 20 20 2a 2f 0a 20 20 20 it.. */.
333e0 20 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33 57 rc = sqlite3W
333f0 61 6c 42 65 67 69 6e 57 72 69 74 65 54 72 61 6e alBeginWriteTran
33400 73 61 63 74 69 6f 6e 28 70 50 61 67 65 72 2d 3e saction(pPager->
33410 70 57 61 6c 29 3b 0a 20 20 20 20 7d 65 6c 73 65 pWal);. }else
33420 7b 0a 20 20 20 20 20 20 2f 2a 20 4f 62 74 61 69 {. /* Obtai
33430 6e 20 61 20 52 45 53 45 52 56 45 44 20 6c 6f 63 n a RESERVED loc
33440 6b 20 6f 6e 20 74 68 65 20 64 61 74 61 62 61 73 k on the databas
33450 65 20 66 69 6c 65 2e 20 49 66 20 74 68 65 20 65 e file. If the e
33460 78 46 6c 61 67 20 70 61 72 61 6d 65 74 65 72 0a xFlag parameter.
33470 20 20 20 20 20 20 2a 2a 20 69 73 20 74 72 75 65 ** is true
33480 2c 20 74 68 65 6e 20 69 6d 6d 65 64 69 61 74 65 , then immediate
33490 6c 79 20 75 70 67 72 61 64 65 20 74 68 69 73 20 ly upgrade this
334a0 74 6f 20 61 6e 20 45 58 43 4c 55 53 49 56 45 20 to an EXCLUSIVE
334b0 6c 6f 63 6b 2e 20 54 68 65 0a 20 20 20 20 20 20 lock. The.
334c0 2a 2a 20 62 75 73 79 2d 68 61 6e 64 6c 65 72 20 ** busy-handler
334d0 63 61 6c 6c 62 61 63 6b 20 63 61 6e 20 62 65 20 callback can be
334e0 75 73 65 64 20 77 68 65 6e 20 75 70 67 72 61 64 used when upgrad
334f0 69 6e 67 20 74 6f 20 74 68 65 20 45 58 43 4c 55 ing to the EXCLU
33500 53 49 56 45 0a 20 20 20 20 20 20 2a 2a 20 6c 6f SIVE. ** lo
33510 63 6b 2c 20 62 75 74 20 6e 6f 74 20 77 68 65 6e ck, but not when
33520 20 6f 62 74 61 69 6e 69 6e 67 20 74 68 65 20 52 obtaining the R
33530 45 53 45 52 56 45 44 20 6c 6f 63 6b 2e 0a 20 20 ESERVED lock..
33540 20 20 20 20 2a 2f 0a 20 20 20 20 20 20 72 63 20 */. rc
33550 3d 20 70 61 67 65 72 4c 6f 63 6b 44 62 28 70 50 = pagerLockDb(pP
33560 61 67 65 72 2c 20 52 45 53 45 52 56 45 44 5f 4c ager, RESERVED_L
33570 4f 43 4b 29 3b 0a 20 20 20 20 20 20 69 66 28 20 OCK);. if(
33580 72 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 26 26 rc==SQLITE_OK &&
33590 20 65 78 46 6c 61 67 20 29 7b 0a 20 20 20 20 20 exFlag ){.
335a0 20 20 20 72 63 20 3d 20 70 61 67 65 72 5f 77 61 rc = pager_wa
335b0 69 74 5f 6f 6e 5f 6c 6f 63 6b 28 70 50 61 67 65 it_on_lock(pPage
335c0 72 2c 20 45 58 43 4c 55 53 49 56 45 5f 4c 4f 43 r, EXCLUSIVE_LOC
335d0 4b 29 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 K);. }.
335e0 7d 0a 0a 20 20 20 20 69 66 28 20 72 63 3d 3d 53 }.. if( rc==S
335f0 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 QLITE_OK ){.
33600 20 20 2f 2a 20 43 68 61 6e 67 65 20 74 6f 20 57 /* Change to W
33610 52 49 54 45 52 5f 4c 4f 43 4b 45 44 20 73 74 61 RITER_LOCKED sta
33620 74 65 2e 0a 20 20 20 20 20 20 2a 2a 0a 20 20 20 te.. **.
33630 20 20 20 2a 2a 20 57 41 4c 20 6d 6f 64 65 20 73 ** WAL mode s
33640 65 74 73 20 50 61 67 65 72 2e 65 53 74 61 74 65 ets Pager.eState
33650 20 74 6f 20 50 41 47 45 52 5f 57 52 49 54 45 52 to PAGER_WRITER
33660 5f 4c 4f 43 4b 45 44 20 6f 72 20 43 41 43 48 45 _LOCKED or CACHE
33670 4d 4f 44 0a 20 20 20 20 20 20 2a 2a 20 77 68 65 MOD. ** whe
33680 6e 20 69 74 20 68 61 73 20 61 6e 20 6f 70 65 6e n it has an open
33690 20 74 72 61 6e 73 61 63 74 69 6f 6e 2c 20 62 75 transaction, bu
336a0 74 20 6e 65 76 65 72 20 74 6f 20 44 42 4d 4f 44 t never to DBMOD
336b0 20 6f 72 20 46 49 4e 49 53 48 45 44 2e 0a 20 20 or FINISHED..
336c0 20 20 20 20 2a 2a 20 54 68 69 73 20 69 73 20 62 ** This is b
336d0 65 63 61 75 73 65 20 69 6e 20 74 68 6f 73 65 20 ecause in those
336e0 73 74 61 74 65 73 20 74 68 65 20 63 6f 64 65 20 states the code
336f0 74 6f 20 72 6f 6c 6c 20 62 61 63 6b 20 73 61 76 to roll back sav
33700 65 70 6f 69 6e 74 20 0a 20 20 20 20 20 20 2a 2a epoint . **
33710 20 74 72 61 6e 73 61 63 74 69 6f 6e 73 20 6d 61 transactions ma
33720 79 20 63 6f 70 79 20 64 61 74 61 20 66 72 6f 6d y copy data from
33730 20 74 68 65 20 73 75 62 2d 6a 6f 75 72 6e 61 6c the sub-journal
33740 20 69 6e 74 6f 20 74 68 65 20 64 61 74 61 62 61 into the databa
33750 73 65 20 0a 20 20 20 20 20 20 2a 2a 20 66 69 6c se . ** fil
33760 65 20 61 73 20 77 65 6c 6c 20 61 73 20 69 6e 74 e as well as int
33770 6f 20 74 68 65 20 70 61 67 65 20 63 61 63 68 65 o the page cache
33780 2e 20 57 68 69 63 68 20 77 6f 75 6c 64 20 62 65 . Which would be
33790 20 69 6e 63 6f 72 72 65 63 74 20 69 6e 20 0a 20 incorrect in .
337a0 20 20 20 20 20 2a 2a 20 57 41 4c 20 6d 6f 64 65 ** WAL mode
337b0 2e 0a 20 20 20 20 20 20 2a 2f 0a 20 20 20 20 20 .. */.
337c0 20 70 50 61 67 65 72 2d 3e 65 53 74 61 74 65 20 pPager->eState
337d0 3d 20 50 41 47 45 52 5f 57 52 49 54 45 52 5f 4c = PAGER_WRITER_L
337e0 4f 43 4b 45 44 3b 0a 20 20 20 20 20 20 70 50 61 OCKED;. pPa
337f0 67 65 72 2d 3e 64 62 48 69 6e 74 53 69 7a 65 20 ger->dbHintSize
33800 3d 20 70 50 61 67 65 72 2d 3e 64 62 53 69 7a 65 = pPager->dbSize
33810 3b 0a 20 20 20 20 20 20 70 50 61 67 65 72 2d 3e ;. pPager->
33820 64 62 46 69 6c 65 53 69 7a 65 20 3d 20 70 50 61 dbFileSize = pPa
33830 67 65 72 2d 3e 64 62 53 69 7a 65 3b 0a 20 20 20 ger->dbSize;.
33840 20 20 20 70 50 61 67 65 72 2d 3e 64 62 4f 72 69 pPager->dbOri
33850 67 53 69 7a 65 20 3d 20 70 50 61 67 65 72 2d 3e gSize = pPager->
33860 64 62 53 69 7a 65 3b 0a 20 20 20 20 20 20 70 50 dbSize;. pP
33870 61 67 65 72 2d 3e 6a 6f 75 72 6e 61 6c 4f 66 66 ager->journalOff
33880 20 3d 20 30 3b 0a 20 20 20 20 7d 0a 0a 20 20 20 = 0;. }..
33890 20 61 73 73 65 72 74 28 20 72 63 3d 3d 53 51 4c assert( rc==SQL
338a0 49 54 45 5f 4f 4b 20 7c 7c 20 70 50 61 67 65 72 ITE_OK || pPager
338b0 2d 3e 65 53 74 61 74 65 3d 3d 50 41 47 45 52 5f ->eState==PAGER_
338c0 52 45 41 44 45 52 20 29 3b 0a 20 20 20 20 61 73 READER );. as
338d0 73 65 72 74 28 20 72 63 21 3d 53 51 4c 49 54 45 sert( rc!=SQLITE
338e0 5f 4f 4b 20 7c 7c 20 70 50 61 67 65 72 2d 3e 65 _OK || pPager->e
338f0 53 74 61 74 65 3d 3d 50 41 47 45 52 5f 57 52 49 State==PAGER_WRI
33900 54 45 52 5f 4c 4f 43 4b 45 44 20 29 3b 0a 20 20 TER_LOCKED );.
33910 20 20 61 73 73 65 72 74 28 20 61 73 73 65 72 74 assert( assert
33920 5f 70 61 67 65 72 5f 73 74 61 74 65 28 70 50 61 _pager_state(pPa
33930 67 65 72 29 20 29 3b 0a 20 20 7d 0a 0a 20 20 50 ger) );. }.. P
33940 41 47 45 52 54 52 41 43 45 28 28 22 54 52 41 4e AGERTRACE(("TRAN
33950 53 41 43 54 49 4f 4e 20 25 64 5c 6e 22 2c 20 50 SACTION %d\n", P
33960 41 47 45 52 49 44 28 70 50 61 67 65 72 29 29 29 AGERID(pPager)))
33970 3b 0a 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 7d ;. return rc;.}
33980 0a 0a 2f 2a 0a 2a 2a 20 4d 61 72 6b 20 61 20 73 ../*.** Mark a s
33990 69 6e 67 6c 65 20 64 61 74 61 20 70 61 67 65 20 ingle data page
339a0 61 73 20 77 72 69 74 65 61 62 6c 65 2e 20 54 68 as writeable. Th
339b0 65 20 70 61 67 65 20 69 73 20 77 72 69 74 74 65 e page is writte
339c0 6e 20 69 6e 74 6f 20 74 68 65 20 0a 2a 2a 20 6d n into the .** m
339d0 61 69 6e 20 6a 6f 75 72 6e 61 6c 20 6f 72 20 73 ain journal or s
339e0 75 62 2d 6a 6f 75 72 6e 61 6c 20 61 73 20 72 65 ub-journal as re
339f0 71 75 69 72 65 64 2e 20 49 66 20 74 68 65 20 70 quired. If the p
33a00 61 67 65 20 69 73 20 77 72 69 74 74 65 6e 20 69 age is written i
33a10 6e 74 6f 0a 2a 2a 20 6f 6e 65 20 6f 66 20 74 68 nto.** one of th
33a20 65 20 6a 6f 75 72 6e 61 6c 73 2c 20 74 68 65 20 e journals, the
33a30 63 6f 72 72 65 73 70 6f 6e 64 69 6e 67 20 62 69 corresponding bi
33a40 74 20 69 73 20 73 65 74 20 69 6e 20 74 68 65 20 t is set in the
33a50 0a 2a 2a 20 50 61 67 65 72 2e 70 49 6e 4a 6f 75 .** Pager.pInJou
33a60 72 6e 61 6c 20 62 69 74 76 65 63 20 61 6e 64 20 rnal bitvec and
33a70 74 68 65 20 50 61 67 65 72 53 61 76 65 70 6f 69 the PagerSavepoi
33a80 6e 74 2e 70 49 6e 53 61 76 65 70 6f 69 6e 74 20 nt.pInSavepoint
33a90 62 69 74 76 65 63 73 0a 2a 2a 20 6f 66 20 61 6e bitvecs.** of an
33aa0 79 20 6f 70 65 6e 20 73 61 76 65 70 6f 69 6e 74 y open savepoint
33ab0 73 20 61 73 20 61 70 70 72 6f 70 72 69 61 74 65 s as appropriate
33ac0 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74 20 ..*/.static int
33ad0 70 61 67 65 72 5f 77 72 69 74 65 28 50 67 48 64 pager_write(PgHd
33ae0 72 20 2a 70 50 67 29 7b 0a 20 20 76 6f 69 64 20 r *pPg){. void
33af0 2a 70 44 61 74 61 20 3d 20 70 50 67 2d 3e 70 44 *pData = pPg->pD
33b00 61 74 61 3b 0a 20 20 50 61 67 65 72 20 2a 70 50 ata;. Pager *pP
33b10 61 67 65 72 20 3d 20 70 50 67 2d 3e 70 50 61 67 ager = pPg->pPag
33b20 65 72 3b 0a 20 20 69 6e 74 20 72 63 20 3d 20 53 er;. int rc = S
33b30 51 4c 49 54 45 5f 4f 4b 3b 0a 0a 20 20 2f 2a 20 QLITE_OK;.. /*
33b40 54 68 69 73 20 72 6f 75 74 69 6e 65 20 69 73 20 This routine is
33b50 6e 6f 74 20 63 61 6c 6c 65 64 20 75 6e 6c 65 73 not called unles
33b60 73 20 61 20 77 72 69 74 65 2d 74 72 61 6e 73 61 s a write-transa
33b70 63 74 69 6f 6e 20 68 61 73 20 61 6c 72 65 61 64 ction has alread
33b80 79 20 0a 20 20 2a 2a 20 62 65 65 6e 20 73 74 61 y . ** been sta
33b90 72 74 65 64 2e 20 54 68 65 20 6a 6f 75 72 6e 61 rted. The journa
33ba0 6c 20 66 69 6c 65 20 6d 61 79 20 6f 72 20 6d 61 l file may or ma
33bb0 79 20 6e 6f 74 20 62 65 20 6f 70 65 6e 20 61 74 y not be open at
33bc0 20 74 68 69 73 20 70 6f 69 6e 74 2e 0a 20 20 2a this point.. *
33bd0 2a 20 49 74 20 69 73 20 6e 65 76 65 72 20 63 61 * It is never ca
33be0 6c 6c 65 64 20 69 6e 20 74 68 65 20 45 52 52 4f lled in the ERRO
33bf0 52 20 73 74 61 74 65 2e 0a 20 20 2a 2f 0a 20 20 R state.. */.
33c00 61 73 73 65 72 74 28 20 70 50 61 67 65 72 2d 3e assert( pPager->
33c10 65 53 74 61 74 65 3d 3d 50 41 47 45 52 5f 57 52 eState==PAGER_WR
33c20 49 54 45 52 5f 4c 4f 43 4b 45 44 0a 20 20 20 20 ITER_LOCKED.
33c30 20 20 20 7c 7c 20 70 50 61 67 65 72 2d 3e 65 53 || pPager->eS
33c40 74 61 74 65 3d 3d 50 41 47 45 52 5f 57 52 49 54 tate==PAGER_WRIT
33c50 45 52 5f 43 41 43 48 45 4d 4f 44 0a 20 20 20 20 ER_CACHEMOD.
33c60 20 20 20 7c 7c 20 70 50 61 67 65 72 2d 3e 65 53 || pPager->eS
33c70 74 61 74 65 3d 3d 50 41 47 45 52 5f 57 52 49 54 tate==PAGER_WRIT
33c80 45 52 5f 44 42 4d 4f 44 0a 20 20 29 3b 0a 20 20 ER_DBMOD. );.
33c90 61 73 73 65 72 74 28 20 61 73 73 65 72 74 5f 70 assert( assert_p
33ca0 61 67 65 72 5f 73 74 61 74 65 28 70 50 61 67 65 ager_state(pPage
33cb0 72 29 20 29 3b 0a 0a 20 20 2f 2a 20 49 66 20 61 r) );.. /* If a
33cc0 6e 20 65 72 72 6f 72 20 68 61 73 20 62 65 65 6e n error has been
33cd0 20 70 72 65 76 69 6f 75 73 6c 79 20 64 65 74 65 previously dete
33ce0 63 74 65 64 2c 20 72 65 70 6f 72 74 20 74 68 65 cted, report the
33cf0 20 73 61 6d 65 20 65 72 72 6f 72 0a 20 20 2a 2a same error. **
33d00 20 61 67 61 69 6e 2e 20 54 68 69 73 20 73 68 6f again. This sho
33d10 75 6c 64 20 6e 6f 74 20 68 61 70 70 65 6e 2c 20 uld not happen,
33d20 62 75 74 20 74 68 65 20 63 68 65 63 6b 20 70 72 but the check pr
33d30 6f 76 69 64 65 73 20 72 6f 62 75 73 74 6e 65 73 ovides robustnes
33d40 73 2e 20 2a 2f 0a 20 20 69 66 28 20 4e 45 56 45 s. */. if( NEVE
33d50 52 28 70 50 61 67 65 72 2d 3e 65 72 72 43 6f 64 R(pPager->errCod
33d60 65 29 20 29 20 20 72 65 74 75 72 6e 20 70 50 61 e) ) return pPa
33d70 67 65 72 2d 3e 65 72 72 43 6f 64 65 3b 0a 0a 20 ger->errCode;..
33d80 20 2f 2a 20 48 69 67 68 65 72 2d 6c 65 76 65 6c /* Higher-level
33d90 20 72 6f 75 74 69 6e 65 73 20 6e 65 76 65 72 20 routines never
33da0 63 61 6c 6c 20 74 68 69 73 20 66 75 6e 63 74 69 call this functi
33db0 6f 6e 20 69 66 20 64 61 74 61 62 61 73 65 20 69 on if database i
33dc0 73 20 6e 6f 74 0a 20 20 2a 2a 20 77 72 69 74 61 s not. ** writa
33dd0 62 6c 65 2e 20 20 42 75 74 20 63 68 65 63 6b 20 ble. But check
33de0 61 6e 79 77 61 79 2c 20 6a 75 73 74 20 66 6f 72 anyway, just for
33df0 20 72 6f 62 75 73 74 6e 65 73 73 2e 20 2a 2f 0a robustness. */.
33e00 20 20 69 66 28 20 4e 45 56 45 52 28 70 50 61 67 if( NEVER(pPag
33e10 65 72 2d 3e 72 65 61 64 4f 6e 6c 79 29 20 29 20 er->readOnly) )
33e20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 50 45 return SQLITE_PE
33e30 52 4d 3b 0a 0a 20 20 43 48 45 43 4b 5f 50 41 47 RM;.. CHECK_PAG
33e40 45 28 70 50 67 29 3b 0a 0a 20 20 2f 2a 20 54 68 E(pPg);.. /* Th
33e50 65 20 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 20 6e e journal file n
33e60 65 65 64 73 20 74 6f 20 62 65 20 6f 70 65 6e 65 eeds to be opene
33e70 64 2e 20 48 69 67 68 65 72 20 6c 65 76 65 6c 20 d. Higher level
33e80 72 6f 75 74 69 6e 65 73 20 68 61 76 65 20 61 6c routines have al
33e90 72 65 61 64 79 0a 20 20 2a 2a 20 6f 62 74 61 69 ready. ** obtai
33ea0 6e 65 64 20 74 68 65 20 6e 65 63 65 73 73 61 72 ned the necessar
33eb0 79 20 6c 6f 63 6b 73 20 74 6f 20 62 65 67 69 6e y locks to begin
33ec0 20 74 68 65 20 77 72 69 74 65 2d 74 72 61 6e 73 the write-trans
33ed0 61 63 74 69 6f 6e 2c 20 62 75 74 20 74 68 65 0a action, but the.
33ee0 20 20 2a 2a 20 72 6f 6c 6c 62 61 63 6b 20 6a 6f ** rollback jo
33ef0 75 72 6e 61 6c 20 6d 69 67 68 74 20 6e 6f 74 20 urnal might not
33f00 79 65 74 20 62 65 20 6f 70 65 6e 2e 20 4f 70 65 yet be open. Ope
33f10 6e 20 69 74 20 6e 6f 77 20 69 66 20 74 68 69 73 n it now if this
33f20 20 69 73 20 74 68 65 20 63 61 73 65 2e 0a 20 20 is the case..
33f30 2a 2a 0a 20 20 2a 2a 20 54 68 69 73 20 69 73 20 **. ** This is
33f40 64 6f 6e 65 20 62 65 66 6f 72 65 20 63 61 6c 6c done before call
33f50 69 6e 67 20 73 71 6c 69 74 65 33 50 63 61 63 68 ing sqlite3Pcach
33f60 65 4d 61 6b 65 44 69 72 74 79 28 29 20 6f 6e 20 eMakeDirty() on
33f70 74 68 65 20 70 61 67 65 2e 20 0a 20 20 2a 2a 20 the page. . **
33f80 4f 74 68 65 72 77 69 73 65 2c 20 69 66 20 69 74 Otherwise, if it
33f90 20 77 65 72 65 20 64 6f 6e 65 20 61 66 74 65 72 were done after
33fa0 20 63 61 6c 6c 69 6e 67 20 73 71 6c 69 74 65 33 calling sqlite3
33fb0 50 63 61 63 68 65 4d 61 6b 65 44 69 72 74 79 28 PcacheMakeDirty(
33fc0 29 2c 20 74 68 65 6e 0a 20 20 2a 2a 20 61 6e 20 ), then. ** an
33fd0 65 72 72 6f 72 20 6d 69 67 68 74 20 6f 63 63 75 error might occu
33fe0 72 20 61 6e 64 20 74 68 65 20 70 61 67 65 72 20 r and the pager
33ff0 77 6f 75 6c 64 20 65 6e 64 20 75 70 20 69 6e 20 would end up in
34000 57 52 49 54 45 52 5f 4c 4f 43 4b 45 44 20 73 74 WRITER_LOCKED st
34010 61 74 65 0a 20 20 2a 2a 20 77 69 74 68 20 70 61 ate. ** with pa
34020 67 65 73 20 6d 61 72 6b 65 64 20 61 73 20 64 69 ges marked as di
34030 72 74 79 20 69 6e 20 74 68 65 20 63 61 63 68 65 rty in the cache
34040 2e 0a 20 20 2a 2f 0a 20 20 69 66 28 20 70 50 61 .. */. if( pPa
34050 67 65 72 2d 3e 65 53 74 61 74 65 3d 3d 50 41 47 ger->eState==PAG
34060 45 52 5f 57 52 49 54 45 52 5f 4c 4f 43 4b 45 44 ER_WRITER_LOCKED
34070 20 29 7b 0a 20 20 20 20 72 63 20 3d 20 70 61 67 ){. rc = pag
34080 65 72 5f 6f 70 65 6e 5f 6a 6f 75 72 6e 61 6c 28 er_open_journal(
34090 70 50 61 67 65 72 29 3b 0a 20 20 20 20 69 66 28 pPager);. if(
340a0 20 72 63 21 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 rc!=SQLITE_OK )
340b0 20 72 65 74 75 72 6e 20 72 63 3b 0a 20 20 7d 0a return rc;. }.
340c0 20 20 61 73 73 65 72 74 28 20 70 50 61 67 65 72 assert( pPager
340d0 2d 3e 65 53 74 61 74 65 3e 3d 50 41 47 45 52 5f ->eState>=PAGER_
340e0 57 52 49 54 45 52 5f 43 41 43 48 45 4d 4f 44 20 WRITER_CACHEMOD
340f0 29 3b 0a 20 20 61 73 73 65 72 74 28 20 61 73 73 );. assert( ass
34100 65 72 74 5f 70 61 67 65 72 5f 73 74 61 74 65 28 ert_pager_state(
34110 70 50 61 67 65 72 29 20 29 3b 0a 0a 20 20 2f 2a pPager) );.. /*
34120 20 4d 61 72 6b 20 74 68 65 20 70 61 67 65 20 61 Mark the page a
34130 73 20 64 69 72 74 79 2e 20 20 49 66 20 74 68 65 s dirty. If the
34140 20 70 61 67 65 20 68 61 73 20 61 6c 72 65 61 64 page has alread
34150 79 20 62 65 65 6e 20 77 72 69 74 74 65 6e 0a 20 y been written.
34160 20 2a 2a 20 74 6f 20 74 68 65 20 6a 6f 75 72 6e ** to the journ
34170 61 6c 20 74 68 65 6e 20 77 65 20 63 61 6e 20 72 al then we can r
34180 65 74 75 72 6e 20 72 69 67 68 74 20 61 77 61 79 eturn right away
34190 2e 0a 20 20 2a 2f 0a 20 20 73 71 6c 69 74 65 33 .. */. sqlite3
341a0 50 63 61 63 68 65 4d 61 6b 65 44 69 72 74 79 28 PcacheMakeDirty(
341b0 70 50 67 29 3b 0a 20 20 69 66 28 20 70 61 67 65 pPg);. if( page
341c0 49 6e 4a 6f 75 72 6e 61 6c 28 70 50 67 29 20 26 InJournal(pPg) &
341d0 26 20 21 73 75 62 6a 52 65 71 75 69 72 65 73 50 & !subjRequiresP
341e0 61 67 65 28 70 50 67 29 20 29 7b 0a 20 20 20 20 age(pPg) ){.
341f0 61 73 73 65 72 74 28 20 21 70 61 67 65 72 55 73 assert( !pagerUs
34200 65 57 61 6c 28 70 50 61 67 65 72 29 20 29 3b 0a eWal(pPager) );.
34210 20 20 7d 65 6c 73 65 7b 0a 20 20 0a 20 20 20 20 }else{. .
34220 2f 2a 20 54 68 65 20 74 72 61 6e 73 61 63 74 69 /* The transacti
34230 6f 6e 20 6a 6f 75 72 6e 61 6c 20 6e 6f 77 20 65 on journal now e
34240 78 69 73 74 73 20 61 6e 64 20 77 65 20 68 61 76 xists and we hav
34250 65 20 61 20 52 45 53 45 52 56 45 44 20 6f 72 20 e a RESERVED or
34260 61 6e 0a 20 20 20 20 2a 2a 20 45 58 43 4c 55 53 an. ** EXCLUS
34270 49 56 45 20 6c 6f 63 6b 20 6f 6e 20 74 68 65 20 IVE lock on the
34280 6d 61 69 6e 20 64 61 74 61 62 61 73 65 20 66 69 main database fi
34290 6c 65 2e 20 20 57 72 69 74 65 20 74 68 65 20 63 le. Write the c
342a0 75 72 72 65 6e 74 20 70 61 67 65 20 74 6f 0a 20 urrent page to.
342b0 20 20 20 2a 2a 20 74 68 65 20 74 72 61 6e 73 61 ** the transa
342c0 63 74 69 6f 6e 20 6a 6f 75 72 6e 61 6c 20 69 66 ction journal if
342d0 20 69 74 20 69 73 20 6e 6f 74 20 74 68 65 72 65 it is not there
342e0 20 61 6c 72 65 61 64 79 2e 0a 20 20 20 20 2a 2f already.. */
342f0 0a 20 20 20 20 69 66 28 20 21 70 61 67 65 49 6e . if( !pageIn
34300 4a 6f 75 72 6e 61 6c 28 70 50 67 29 20 26 26 20 Journal(pPg) &&
34310 21 70 61 67 65 72 55 73 65 57 61 6c 28 70 50 61 !pagerUseWal(pPa
34320 67 65 72 29 20 29 7b 0a 20 20 20 20 20 20 61 73 ger) ){. as
34330 73 65 72 74 28 20 70 61 67 65 72 55 73 65 57 61 sert( pagerUseWa
34340 6c 28 70 50 61 67 65 72 29 3d 3d 30 20 29 3b 0a l(pPager)==0 );.
34350 20 20 20 20 20 20 69 66 28 20 70 50 67 2d 3e 70 if( pPg->p
34360 67 6e 6f 3c 3d 70 50 61 67 65 72 2d 3e 64 62 4f gno<=pPager->dbO
34370 72 69 67 53 69 7a 65 20 26 26 20 69 73 4f 70 65 rigSize && isOpe
34380 6e 28 70 50 61 67 65 72 2d 3e 6a 66 64 29 20 29 n(pPager->jfd) )
34390 7b 0a 20 20 20 20 20 20 20 20 75 33 32 20 63 6b {. u32 ck
343a0 73 75 6d 3b 0a 20 20 20 20 20 20 20 20 63 68 61 sum;. cha
343b0 72 20 2a 70 44 61 74 61 32 3b 0a 20 20 20 20 20 r *pData2;.
343c0 20 20 20 69 36 34 20 69 4f 66 66 20 3d 20 70 50 i64 iOff = pP
343d0 61 67 65 72 2d 3e 6a 6f 75 72 6e 61 6c 4f 66 66 ager->journalOff
343e0 3b 0a 0a 20 20 20 20 20 20 20 20 2f 2a 20 57 65 ;.. /* We
343f0 20 73 68 6f 75 6c 64 20 6e 65 76 65 72 20 77 72 should never wr
34400 69 74 65 20 74 6f 20 74 68 65 20 6a 6f 75 72 6e ite to the journ
34410 61 6c 20 66 69 6c 65 20 74 68 65 20 70 61 67 65 al file the page
34420 20 74 68 61 74 0a 20 20 20 20 20 20 20 20 2a 2a that. **
34430 20 63 6f 6e 74 61 69 6e 73 20 74 68 65 20 64 61 contains the da
34440 74 61 62 61 73 65 20 6c 6f 63 6b 73 2e 20 20 54 tabase locks. T
34450 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 61 73 73 he following ass
34460 65 72 74 20 76 65 72 69 66 69 65 73 0a 20 20 20 ert verifies.
34470 20 20 20 20 20 2a 2a 20 74 68 61 74 20 77 65 20 ** that we
34480 64 6f 20 6e 6f 74 2e 20 2a 2f 0a 20 20 20 20 20 do not. */.
34490 20 20 20 61 73 73 65 72 74 28 20 70 50 67 2d 3e assert( pPg->
344a0 70 67 6e 6f 21 3d 50 41 47 45 52 5f 4d 4a 5f 50 pgno!=PAGER_MJ_P
344b0 47 4e 4f 28 70 50 61 67 65 72 29 20 29 3b 0a 0a GNO(pPager) );..
344c0 20 20 20 20 20 20 20 20 61 73 73 65 72 74 28 20 assert(
344d0 70 50 61 67 65 72 2d 3e 6a 6f 75 72 6e 61 6c 48 pPager->journalH
344e0 64 72 3c 3d 70 50 61 67 65 72 2d 3e 6a 6f 75 72 dr<=pPager->jour
344f0 6e 61 6c 4f 66 66 20 29 3b 0a 20 20 20 20 20 20 nalOff );.
34500 20 20 43 4f 44 45 43 32 28 70 50 61 67 65 72 2c CODEC2(pPager,
34510 20 70 44 61 74 61 2c 20 70 50 67 2d 3e 70 67 6e pData, pPg->pgn
34520 6f 2c 20 37 2c 20 72 65 74 75 72 6e 20 53 51 4c o, 7, return SQL
34530 49 54 45 5f 4e 4f 4d 45 4d 2c 20 70 44 61 74 61 ITE_NOMEM, pData
34540 32 29 3b 0a 20 20 20 20 20 20 20 20 63 6b 73 75 2);. cksu
34550 6d 20 3d 20 70 61 67 65 72 5f 63 6b 73 75 6d 28 m = pager_cksum(
34560 70 50 61 67 65 72 2c 20 28 75 38 2a 29 70 44 61 pPager, (u8*)pDa
34570 74 61 32 29 3b 0a 0a 20 20 20 20 20 20 20 20 2f ta2);.. /
34580 2a 20 45 76 65 6e 20 69 66 20 61 6e 20 49 4f 20 * Even if an IO
34590 6f 72 20 64 69 73 6b 66 75 6c 6c 20 65 72 72 6f or diskfull erro
345a0 72 20 6f 63 63 75 72 73 20 77 68 69 6c 65 20 6a r occurs while j
345b0 6f 75 72 6e 61 6c 6c 69 6e 67 20 74 68 65 0a 20 ournalling the.
345c0 20 20 20 20 20 20 20 2a 2a 20 70 61 67 65 20 69 ** page i
345d0 6e 20 74 68 65 20 62 6c 6f 63 6b 20 61 62 6f 76 n the block abov
345e0 65 2c 20 73 65 74 20 74 68 65 20 6e 65 65 64 2d e, set the need-
345f0 73 79 6e 63 20 66 6c 61 67 20 66 6f 72 20 74 68 sync flag for th
34600 65 20 70 61 67 65 2e 0a 20 20 20 20 20 20 20 20 e page..
34610 2a 2a 20 4f 74 68 65 72 77 69 73 65 2c 20 77 68 ** Otherwise, wh
34620 65 6e 20 74 68 65 20 74 72 61 6e 73 61 63 74 69 en the transacti
34630 6f 6e 20 69 73 20 72 6f 6c 6c 65 64 20 62 61 63 on is rolled bac
34640 6b 2c 20 74 68 65 20 6c 6f 67 69 63 20 69 6e 0a k, the logic in.
34650 20 20 20 20 20 20 20 20 2a 2a 20 70 6c 61 79 62 ** playb
34660 61 63 6b 5f 6f 6e 65 5f 70 61 67 65 28 29 20 77 ack_one_page() w
34670 69 6c 6c 20 74 68 69 6e 6b 20 74 68 61 74 20 74 ill think that t
34680 68 65 20 70 61 67 65 20 6e 65 65 64 73 20 74 6f he page needs to
34690 20 62 65 20 72 65 73 74 6f 72 65 64 0a 20 20 20 be restored.
346a0 20 20 20 20 20 2a 2a 20 69 6e 20 74 68 65 20 64 ** in the d
346b0 61 74 61 62 61 73 65 20 66 69 6c 65 2e 20 41 6e atabase file. An
346c0 64 20 69 66 20 61 6e 20 49 4f 20 65 72 72 6f 72 d if an IO error
346d0 20 6f 63 63 75 72 73 20 77 68 69 6c 65 20 64 6f occurs while do
346e0 69 6e 67 20 73 6f 2c 0a 20 20 20 20 20 20 20 20 ing so,.
346f0 2a 2a 20 74 68 65 6e 20 63 6f 72 72 75 70 74 69 ** then corrupti
34700 6f 6e 20 6d 61 79 20 66 6f 6c 6c 6f 77 2e 0a 20 on may follow..
34710 20 20 20 20 20 20 20 2a 2f 0a 20 20 20 20 20 20 */.
34720 20 20 70 50 67 2d 3e 66 6c 61 67 73 20 7c 3d 20 pPg->flags |=
34730 50 47 48 44 52 5f 4e 45 45 44 5f 53 59 4e 43 3b PGHDR_NEED_SYNC;
34740 0a 0a 20 20 20 20 20 20 20 20 72 63 20 3d 20 77 .. rc = w
34750 72 69 74 65 33 32 62 69 74 73 28 70 50 61 67 65 rite32bits(pPage
34760 72 2d 3e 6a 66 64 2c 20 69 4f 66 66 2c 20 70 50 r->jfd, iOff, pP
34770 67 2d 3e 70 67 6e 6f 29 3b 0a 20 20 20 20 20 20 g->pgno);.
34780 20 20 69 66 28 20 72 63 21 3d 53 51 4c 49 54 45 if( rc!=SQLITE
34790 5f 4f 4b 20 29 20 72 65 74 75 72 6e 20 72 63 3b _OK ) return rc;
347a0 0a 20 20 20 20 20 20 20 20 72 63 20 3d 20 73 71 . rc = sq
347b0 6c 69 74 65 33 4f 73 57 72 69 74 65 28 70 50 61 lite3OsWrite(pPa
347c0 67 65 72 2d 3e 6a 66 64 2c 20 70 44 61 74 61 32 ger->jfd, pData2
347d0 2c 20 70 50 61 67 65 72 2d 3e 70 61 67 65 53 69 , pPager->pageSi
347e0 7a 65 2c 20 69 4f 66 66 2b 34 29 3b 0a 20 20 20 ze, iOff+4);.
347f0 20 20 20 20 20 69 66 28 20 72 63 21 3d 53 51 4c if( rc!=SQL
34800 49 54 45 5f 4f 4b 20 29 20 72 65 74 75 72 6e 20 ITE_OK ) return
34810 72 63 3b 0a 20 20 20 20 20 20 20 20 72 63 20 3d rc;. rc =
34820 20 77 72 69 74 65 33 32 62 69 74 73 28 70 50 61 write32bits(pPa
34830 67 65 72 2d 3e 6a 66 64 2c 20 69 4f 66 66 2b 70 ger->jfd, iOff+p
34840 50 61 67 65 72 2d 3e 70 61 67 65 53 69 7a 65 2b Pager->pageSize+
34850 34 2c 20 63 6b 73 75 6d 29 3b 0a 20 20 20 20 20 4, cksum);.
34860 20 20 20 69 66 28 20 72 63 21 3d 53 51 4c 49 54 if( rc!=SQLIT
34870 45 5f 4f 4b 20 29 20 72 65 74 75 72 6e 20 72 63 E_OK ) return rc
34880 3b 0a 0a 20 20 20 20 20 20 20 20 49 4f 54 52 41 ;.. IOTRA
34890 43 45 28 28 22 4a 4f 55 54 20 25 70 20 25 64 20 CE(("JOUT %p %d
348a0 25 6c 6c 64 20 25 64 5c 6e 22 2c 20 70 50 61 67 %lld %d\n", pPag
348b0 65 72 2c 20 70 50 67 2d 3e 70 67 6e 6f 2c 20 0a er, pPg->pgno, .
348c0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
348d0 20 70 50 61 67 65 72 2d 3e 6a 6f 75 72 6e 61 6c pPager->journal
348e0 4f 66 66 2c 20 70 50 61 67 65 72 2d 3e 70 61 67 Off, pPager->pag
348f0 65 53 69 7a 65 29 29 3b 0a 20 20 20 20 20 20 20 eSize));.
34900 20 50 41 47 45 52 5f 49 4e 43 52 28 73 71 6c 69 PAGER_INCR(sqli
34910 74 65 33 5f 70 61 67 65 72 5f 77 72 69 74 65 6a te3_pager_writej
34920 5f 63 6f 75 6e 74 29 3b 0a 20 20 20 20 20 20 20 _count);.
34930 20 50 41 47 45 52 54 52 41 43 45 28 28 22 4a 4f PAGERTRACE(("JO
34940 55 52 4e 41 4c 20 25 64 20 70 61 67 65 20 25 64 URNAL %d page %d
34950 20 6e 65 65 64 53 79 6e 63 3d 25 64 20 68 61 73 needSync=%d has
34960 68 28 25 30 38 78 29 5c 6e 22 2c 0a 20 20 20 20 h(%08x)\n",.
34970 20 20 20 20 20 20 20 20 20 50 41 47 45 52 49 44 PAGERID
34980 28 70 50 61 67 65 72 29 2c 20 70 50 67 2d 3e 70 (pPager), pPg->p
34990 67 6e 6f 2c 20 0a 20 20 20 20 20 20 20 20 20 20 gno, .
349a0 20 20 20 28 28 70 50 67 2d 3e 66 6c 61 67 73 26 ((pPg->flags&
349b0 50 47 48 44 52 5f 4e 45 45 44 5f 53 59 4e 43 29 PGHDR_NEED_SYNC)
349c0 3f 31 3a 30 29 2c 20 70 61 67 65 72 5f 70 61 67 ?1:0), pager_pag
349d0 65 68 61 73 68 28 70 50 67 29 29 29 3b 0a 0a 20 ehash(pPg)));..
349e0 20 20 20 20 20 20 20 70 50 61 67 65 72 2d 3e 6a pPager->j
349f0 6f 75 72 6e 61 6c 4f 66 66 20 2b 3d 20 38 20 2b ournalOff += 8 +
34a00 20 70 50 61 67 65 72 2d 3e 70 61 67 65 53 69 7a pPager->pageSiz
34a10 65 3b 0a 20 20 20 20 20 20 20 20 70 50 61 67 65 e;. pPage
34a20 72 2d 3e 6e 52 65 63 2b 2b 3b 0a 20 20 20 20 20 r->nRec++;.
34a30 20 20 20 61 73 73 65 72 74 28 20 70 50 61 67 65 assert( pPage
34a40 72 2d 3e 70 49 6e 4a 6f 75 72 6e 61 6c 21 3d 30 r->pInJournal!=0
34a50 20 29 3b 0a 20 20 20 20 20 20 20 20 72 63 20 3d );. rc =
34a60 20 73 71 6c 69 74 65 33 42 69 74 76 65 63 53 65 sqlite3BitvecSe
34a70 74 28 70 50 61 67 65 72 2d 3e 70 49 6e 4a 6f 75 t(pPager->pInJou
34a80 72 6e 61 6c 2c 20 70 50 67 2d 3e 70 67 6e 6f 29 rnal, pPg->pgno)
34a90 3b 0a 20 20 20 20 20 20 20 20 74 65 73 74 63 61 ;. testca
34aa0 73 65 28 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4e se( rc==SQLITE_N
34ab0 4f 4d 45 4d 20 29 3b 0a 20 20 20 20 20 20 20 20 OMEM );.
34ac0 61 73 73 65 72 74 28 20 72 63 3d 3d 53 51 4c 49 assert( rc==SQLI
34ad0 54 45 5f 4f 4b 20 7c 7c 20 72 63 3d 3d 53 51 4c TE_OK || rc==SQL
34ae0 49 54 45 5f 4e 4f 4d 45 4d 20 29 3b 0a 20 20 20 ITE_NOMEM );.
34af0 20 20 20 20 20 72 63 20 7c 3d 20 61 64 64 54 6f rc |= addTo
34b00 53 61 76 65 70 6f 69 6e 74 42 69 74 76 65 63 73 SavepointBitvecs
34b10 28 70 50 61 67 65 72 2c 20 70 50 67 2d 3e 70 67 (pPager, pPg->pg
34b20 6e 6f 29 3b 0a 20 20 20 20 20 20 20 20 69 66 28 no);. if(
34b30 20 72 63 21 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 rc!=SQLITE_OK )
34b40 7b 0a 20 20 20 20 20 20 20 20 20 20 61 73 73 65 {. asse
34b50 72 74 28 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4e rt( rc==SQLITE_N
34b60 4f 4d 45 4d 20 29 3b 0a 20 20 20 20 20 20 20 20 OMEM );.
34b70 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 20 20 20 return rc;.
34b80 20 20 20 20 20 7d 0a 20 20 20 20 20 20 7d 65 6c }. }el
34b90 73 65 7b 0a 20 20 20 20 20 20 20 20 69 66 28 20 se{. if(
34ba0 70 50 61 67 65 72 2d 3e 65 53 74 61 74 65 21 3d pPager->eState!=
34bb0 50 41 47 45 52 5f 57 52 49 54 45 52 5f 44 42 4d PAGER_WRITER_DBM
34bc0 4f 44 20 29 7b 0a 20 20 20 20 20 20 20 20 20 20 OD ){.
34bd0 70 50 67 2d 3e 66 6c 61 67 73 20 7c 3d 20 50 47 pPg->flags |= PG
34be0 48 44 52 5f 4e 45 45 44 5f 53 59 4e 43 3b 0a 20 HDR_NEED_SYNC;.
34bf0 20 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 20 }.
34c00 20 50 41 47 45 52 54 52 41 43 45 28 28 22 41 50 PAGERTRACE(("AP
34c10 50 45 4e 44 20 25 64 20 70 61 67 65 20 25 64 20 PEND %d page %d
34c20 6e 65 65 64 53 79 6e 63 3d 25 64 5c 6e 22 2c 0a needSync=%d\n",.
34c30 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
34c40 50 41 47 45 52 49 44 28 70 50 61 67 65 72 29 2c PAGERID(pPager),
34c50 20 70 50 67 2d 3e 70 67 6e 6f 2c 0a 20 20 20 20 pPg->pgno,.
34c60 20 20 20 20 20 20 20 20 20 20 20 28 28 70 50 67 ((pPg
34c70 2d 3e 66 6c 61 67 73 26 50 47 48 44 52 5f 4e 45 ->flags&PGHDR_NE
34c80 45 44 5f 53 59 4e 43 29 3f 31 3a 30 29 29 29 3b ED_SYNC)?1:0)));
34c90 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 7d 0a 20 . }. }.
34ca0 20 0a 20 20 20 20 2f 2a 20 49 66 20 74 68 65 20 . /* If the
34cb0 73 74 61 74 65 6d 65 6e 74 20 6a 6f 75 72 6e 61 statement journa
34cc0 6c 20 69 73 20 6f 70 65 6e 20 61 6e 64 20 74 68 l is open and th
34cd0 65 20 70 61 67 65 20 69 73 20 6e 6f 74 20 69 6e e page is not in
34ce0 20 69 74 2c 0a 20 20 20 20 2a 2a 20 74 68 65 6e it,. ** then
34cf0 20 77 72 69 74 65 20 74 68 65 20 63 75 72 72 65 write the curre
34d00 6e 74 20 70 61 67 65 20 74 6f 20 74 68 65 20 73 nt page to the s
34d10 74 61 74 65 6d 65 6e 74 20 6a 6f 75 72 6e 61 6c tatement journal
34d20 2e 20 20 4e 6f 74 65 20 74 68 61 74 0a 20 20 20 . Note that.
34d30 20 2a 2a 20 74 68 65 20 73 74 61 74 65 6d 65 6e ** the statemen
34d40 74 20 6a 6f 75 72 6e 61 6c 20 66 6f 72 6d 61 74 t journal format
34d50 20 64 69 66 66 65 72 73 20 66 72 6f 6d 20 74 68 differs from th
34d60 65 20 73 74 61 6e 64 61 72 64 20 6a 6f 75 72 6e e standard journ
34d70 61 6c 20 66 6f 72 6d 61 74 0a 20 20 20 20 2a 2a al format. **
34d80 20 69 6e 20 74 68 61 74 20 69 74 20 6f 6d 69 74 in that it omit
34d90 73 20 74 68 65 20 63 68 65 63 6b 73 75 6d 73 20 s the checksums
34da0 61 6e 64 20 74 68 65 20 68 65 61 64 65 72 2e 0a and the header..
34db0 20 20 20 20 2a 2f 0a 20 20 20 20 69 66 28 20 73 */. if( s
34dc0 75 62 6a 52 65 71 75 69 72 65 73 50 61 67 65 28 ubjRequiresPage(
34dd0 70 50 67 29 20 29 7b 0a 20 20 20 20 20 20 72 63 pPg) ){. rc
34de0 20 3d 20 73 75 62 6a 6f 75 72 6e 61 6c 50 61 67 = subjournalPag
34df0 65 28 70 50 67 29 3b 0a 20 20 20 20 7d 0a 20 20 e(pPg);. }.
34e00 7d 0a 0a 20 20 2f 2a 20 55 70 64 61 74 65 20 74 }.. /* Update t
34e10 68 65 20 64 61 74 61 62 61 73 65 20 73 69 7a 65 he database size
34e20 20 61 6e 64 20 72 65 74 75 72 6e 2e 0a 20 20 2a and return.. *
34e30 2f 0a 20 20 69 66 28 20 70 50 61 67 65 72 2d 3e /. if( pPager->
34e40 64 62 53 69 7a 65 3c 70 50 67 2d 3e 70 67 6e 6f dbSize<pPg->pgno
34e50 20 29 7b 0a 20 20 20 20 70 50 61 67 65 72 2d 3e ){. pPager->
34e60 64 62 53 69 7a 65 20 3d 20 70 50 67 2d 3e 70 67 dbSize = pPg->pg
34e70 6e 6f 3b 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e no;. }. return
34e80 20 72 63 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 4d 61 rc;.}../*.** Ma
34e90 72 6b 20 61 20 64 61 74 61 20 70 61 67 65 20 61 rk a data page a
34ea0 73 20 77 72 69 74 65 61 62 6c 65 2e 20 54 68 69 s writeable. Thi
34eb0 73 20 72 6f 75 74 69 6e 65 20 6d 75 73 74 20 62 s routine must b
34ec0 65 20 63 61 6c 6c 65 64 20 62 65 66 6f 72 65 20 e called before
34ed0 0a 2a 2a 20 6d 61 6b 69 6e 67 20 63 68 61 6e 67 .** making chang
34ee0 65 73 20 74 6f 20 61 20 70 61 67 65 2e 20 54 68 es to a page. Th
34ef0 65 20 63 61 6c 6c 65 72 20 6d 75 73 74 20 63 68 e caller must ch
34f00 65 63 6b 20 74 68 65 20 72 65 74 75 72 6e 20 76 eck the return v
34f10 61 6c 75 65 20 0a 2a 2a 20 6f 66 20 74 68 69 73 alue .** of this
34f20 20 66 75 6e 63 74 69 6f 6e 20 61 6e 64 20 62 65 function and be
34f30 20 63 61 72 65 66 75 6c 20 6e 6f 74 20 74 6f 20 careful not to
34f40 63 68 61 6e 67 65 20 61 6e 79 20 70 61 67 65 20 change any page
34f50 64 61 74 61 20 75 6e 6c 65 73 73 20 0a 2a 2a 20 data unless .**
34f60 74 68 69 73 20 72 6f 75 74 69 6e 65 20 72 65 74 this routine ret
34f70 75 72 6e 73 20 53 51 4c 49 54 45 5f 4f 4b 2e 0a urns SQLITE_OK..
34f80 2a 2a 0a 2a 2a 20 54 68 65 20 64 69 66 66 65 72 **.** The differ
34f90 65 6e 63 65 20 62 65 74 77 65 65 6e 20 74 68 69 ence between thi
34fa0 73 20 66 75 6e 63 74 69 6f 6e 20 61 6e 64 20 70 s function and p
34fb0 61 67 65 72 5f 77 72 69 74 65 28 29 20 69 73 20 ager_write() is
34fc0 74 68 61 74 20 74 68 69 73 0a 2a 2a 20 66 75 6e that this.** fun
34fd0 63 74 69 6f 6e 20 61 6c 73 6f 20 64 65 61 6c 73 ction also deals
34fe0 20 77 69 74 68 20 74 68 65 20 73 70 65 63 69 61 with the specia
34ff0 6c 20 63 61 73 65 20 77 68 65 72 65 20 32 20 6f l case where 2 o
35000 72 20 6d 6f 72 65 20 70 61 67 65 73 0a 2a 2a 20 r more pages.**
35010 66 69 74 20 6f 6e 20 61 20 73 69 6e 67 6c 65 20 fit on a single
35020 64 69 73 6b 20 73 65 63 74 6f 72 2e 20 49 6e 20 disk sector. In
35030 74 68 69 73 20 63 61 73 65 20 61 6c 6c 20 63 6f this case all co
35040 2d 72 65 73 69 64 65 6e 74 20 70 61 67 65 73 0a -resident pages.
35050 2a 2a 20 6d 75 73 74 20 68 61 76 65 20 62 65 65 ** must have bee
35060 6e 20 77 72 69 74 74 65 6e 20 74 6f 20 74 68 65 n written to the
35070 20 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 20 62 65 journal file be
35080 66 6f 72 65 20 72 65 74 75 72 6e 69 6e 67 2e 0a fore returning..
35090 2a 2a 0a 2a 2a 20 49 66 20 61 6e 20 65 72 72 6f **.** If an erro
350a0 72 20 6f 63 63 75 72 73 2c 20 53 51 4c 49 54 45 r occurs, SQLITE
350b0 5f 4e 4f 4d 45 4d 20 6f 72 20 61 6e 20 49 4f 20 _NOMEM or an IO
350c0 65 72 72 6f 72 20 63 6f 64 65 20 69 73 20 72 65 error code is re
350d0 74 75 72 6e 65 64 0a 2a 2a 20 61 73 20 61 70 70 turned.** as app
350e0 72 6f 70 72 69 61 74 65 2e 20 4f 74 68 65 72 77 ropriate. Otherw
350f0 69 73 65 2c 20 53 51 4c 49 54 45 5f 4f 4b 2e 0a ise, SQLITE_OK..
35100 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 50 61 */.int sqlite3Pa
35110 67 65 72 57 72 69 74 65 28 44 62 50 61 67 65 20 gerWrite(DbPage
35120 2a 70 44 62 50 61 67 65 29 7b 0a 20 20 69 6e 74 *pDbPage){. int
35130 20 72 63 20 3d 20 53 51 4c 49 54 45 5f 4f 4b 3b rc = SQLITE_OK;
35140 0a 0a 20 20 50 67 48 64 72 20 2a 70 50 67 20 3d .. PgHdr *pPg =
35150 20 70 44 62 50 61 67 65 3b 0a 20 20 50 61 67 65 pDbPage;. Page
35160 72 20 2a 70 50 61 67 65 72 20 3d 20 70 50 67 2d r *pPager = pPg-
35170 3e 70 50 61 67 65 72 3b 0a 20 20 50 67 6e 6f 20 >pPager;. Pgno
35180 6e 50 61 67 65 50 65 72 53 65 63 74 6f 72 20 3d nPagePerSector =
35190 20 28 70 50 61 67 65 72 2d 3e 73 65 63 74 6f 72 (pPager->sector
351a0 53 69 7a 65 2f 70 50 61 67 65 72 2d 3e 70 61 67 Size/pPager->pag
351b0 65 53 69 7a 65 29 3b 0a 0a 20 20 61 73 73 65 72 eSize);.. asser
351c0 74 28 20 70 50 61 67 65 72 2d 3e 65 53 74 61 74 t( pPager->eStat
351d0 65 3e 3d 50 41 47 45 52 5f 57 52 49 54 45 52 5f e>=PAGER_WRITER_
351e0 4c 4f 43 4b 45 44 20 29 3b 0a 20 20 61 73 73 65 LOCKED );. asse
351f0 72 74 28 20 70 50 61 67 65 72 2d 3e 65 53 74 61 rt( pPager->eSta
35200 74 65 21 3d 50 41 47 45 52 5f 45 52 52 4f 52 20 te!=PAGER_ERROR
35210 29 3b 0a 20 20 61 73 73 65 72 74 28 20 61 73 73 );. assert( ass
35220 65 72 74 5f 70 61 67 65 72 5f 73 74 61 74 65 28 ert_pager_state(
35230 70 50 61 67 65 72 29 20 29 3b 0a 0a 20 20 69 66 pPager) );.. if
35240 28 20 6e 50 61 67 65 50 65 72 53 65 63 74 6f 72 ( nPagePerSector
35250 3e 31 20 29 7b 0a 20 20 20 20 50 67 6e 6f 20 6e >1 ){. Pgno n
35260 50 61 67 65 43 6f 75 6e 74 3b 20 20 20 20 20 20 PageCount;
35270 20 20 20 20 2f 2a 20 54 6f 74 61 6c 20 6e 75 6d /* Total num
35280 62 65 72 20 6f 66 20 70 61 67 65 73 20 69 6e 20 ber of pages in
35290 64 61 74 61 62 61 73 65 20 66 69 6c 65 20 2a 2f database file */
352a0 0a 20 20 20 20 50 67 6e 6f 20 70 67 31 3b 20 20 . Pgno pg1;
352b0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f /
352c0 2a 20 46 69 72 73 74 20 70 61 67 65 20 6f 66 20 * First page of
352d0 74 68 65 20 73 65 63 74 6f 72 20 70 50 67 20 69 the sector pPg i
352e0 73 20 6c 6f 63 61 74 65 64 20 6f 6e 2e 20 2a 2f s located on. */
352f0 0a 20 20 20 20 69 6e 74 20 6e 50 61 67 65 20 3d . int nPage =
35300 20 30 3b 20 20 20 20 20 20 20 20 20 20 20 20 2f 0; /
35310 2a 20 4e 75 6d 62 65 72 20 6f 66 20 70 61 67 65 * Number of page
35320 73 20 73 74 61 72 74 69 6e 67 20 61 74 20 70 67 s starting at pg
35330 31 20 74 6f 20 6a 6f 75 72 6e 61 6c 20 2a 2f 0a 1 to journal */.
35340 20 20 20 20 69 6e 74 20 69 69 3b 20 20 20 20 20 int ii;
35350 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a /*
35360 20 4c 6f 6f 70 20 63 6f 75 6e 74 65 72 20 2a 2f Loop counter */
35370 0a 20 20 20 20 69 6e 74 20 6e 65 65 64 53 79 6e . int needSyn
35380 63 20 3d 20 30 3b 20 20 20 20 20 20 20 20 20 2f c = 0; /
35390 2a 20 54 72 75 65 20 69 66 20 61 6e 79 20 70 61 * True if any pa
353a0 67 65 20 68 61 73 20 50 47 48 44 52 5f 4e 45 45 ge has PGHDR_NEE
353b0 44 5f 53 59 4e 43 20 2a 2f 0a 0a 20 20 20 20 2f D_SYNC */.. /
353c0 2a 20 53 65 74 20 74 68 65 20 64 6f 4e 6f 74 53 * Set the doNotS
353d0 79 6e 63 53 70 69 6c 6c 20 66 6c 61 67 20 74 6f yncSpill flag to
353e0 20 31 2e 20 54 68 69 73 20 69 73 20 62 65 63 61 1. This is beca
353f0 75 73 65 20 77 65 20 63 61 6e 6e 6f 74 20 61 6c use we cannot al
35400 6c 6f 77 0a 20 20 20 20 2a 2a 20 61 20 6a 6f 75 low. ** a jou
35410 72 6e 61 6c 20 68 65 61 64 65 72 20 74 6f 20 62 rnal header to b
35420 65 20 77 72 69 74 74 65 6e 20 62 65 74 77 65 65 e written betwee
35430 6e 20 74 68 65 20 70 61 67 65 73 20 6a 6f 75 72 n the pages jour
35440 6e 61 6c 65 64 20 62 79 0a 20 20 20 20 2a 2a 20 naled by. **
35450 74 68 69 73 20 66 75 6e 63 74 69 6f 6e 2e 0a 20 this function..
35460 20 20 20 2a 2f 0a 20 20 20 20 61 73 73 65 72 74 */. assert
35470 28 20 21 4d 45 4d 44 42 20 29 3b 0a 20 20 20 20 ( !MEMDB );.
35480 61 73 73 65 72 74 28 20 70 50 61 67 65 72 2d 3e assert( pPager->
35490 64 6f 4e 6f 74 53 79 6e 63 53 70 69 6c 6c 3d 3d doNotSyncSpill==
354a0 30 20 29 3b 0a 20 20 20 20 70 50 61 67 65 72 2d 0 );. pPager-
354b0 3e 64 6f 4e 6f 74 53 79 6e 63 53 70 69 6c 6c 2b >doNotSyncSpill+
354c0 2b 3b 0a 0a 20 20 20 20 2f 2a 20 54 68 69 73 20 +;.. /* This
354d0 74 72 69 63 6b 20 61 73 73 75 6d 65 73 20 74 68 trick assumes th
354e0 61 74 20 62 6f 74 68 20 74 68 65 20 70 61 67 65 at both the page
354f0 2d 73 69 7a 65 20 61 6e 64 20 73 65 63 74 6f 72 -size and sector
35500 2d 73 69 7a 65 20 61 72 65 0a 20 20 20 20 2a 2a -size are. **
35510 20 61 6e 20 69 6e 74 65 67 65 72 20 70 6f 77 65 an integer powe
35520 72 20 6f 66 20 32 2e 20 49 74 20 73 65 74 73 20 r of 2. It sets
35530 76 61 72 69 61 62 6c 65 20 70 67 31 20 74 6f 20 variable pg1 to
35540 74 68 65 20 69 64 65 6e 74 69 66 69 65 72 0a 20 the identifier.
35550 20 20 20 2a 2a 20 6f 66 20 74 68 65 20 66 69 72 ** of the fir
35560 73 74 20 70 61 67 65 20 6f 66 20 74 68 65 20 73 st page of the s
35570 65 63 74 6f 72 20 70 50 67 20 69 73 20 6c 6f 63 ector pPg is loc
35580 61 74 65 64 20 6f 6e 2e 0a 20 20 20 20 2a 2f 0a ated on.. */.
35590 20 20 20 20 70 67 31 20 3d 20 28 28 70 50 67 2d pg1 = ((pPg-
355a0 3e 70 67 6e 6f 2d 31 29 20 26 20 7e 28 6e 50 61 >pgno-1) & ~(nPa
355b0 67 65 50 65 72 53 65 63 74 6f 72 2d 31 29 29 20 gePerSector-1))
355c0 2b 20 31 3b 0a 0a 20 20 20 20 6e 50 61 67 65 43 + 1;.. nPageC
355d0 6f 75 6e 74 20 3d 20 70 50 61 67 65 72 2d 3e 64 ount = pPager->d
355e0 62 53 69 7a 65 3b 0a 20 20 20 20 69 66 28 20 70 bSize;. if( p
355f0 50 67 2d 3e 70 67 6e 6f 3e 6e 50 61 67 65 43 6f Pg->pgno>nPageCo
35600 75 6e 74 20 29 7b 0a 20 20 20 20 20 20 6e 50 61 unt ){. nPa
35610 67 65 20 3d 20 28 70 50 67 2d 3e 70 67 6e 6f 20 ge = (pPg->pgno
35620 2d 20 70 67 31 29 2b 31 3b 0a 20 20 20 20 7d 65 - pg1)+1;. }e
35630 6c 73 65 20 69 66 28 20 28 70 67 31 2b 6e 50 61 lse if( (pg1+nPa
35640 67 65 50 65 72 53 65 63 74 6f 72 2d 31 29 3e 6e gePerSector-1)>n
35650 50 61 67 65 43 6f 75 6e 74 20 29 7b 0a 20 20 20 PageCount ){.
35660 20 20 20 6e 50 61 67 65 20 3d 20 6e 50 61 67 65 nPage = nPage
35670 43 6f 75 6e 74 2b 31 2d 70 67 31 3b 0a 20 20 20 Count+1-pg1;.
35680 20 7d 65 6c 73 65 7b 0a 20 20 20 20 20 20 6e 50 }else{. nP
35690 61 67 65 20 3d 20 6e 50 61 67 65 50 65 72 53 65 age = nPagePerSe
356a0 63 74 6f 72 3b 0a 20 20 20 20 7d 0a 20 20 20 20 ctor;. }.
356b0 61 73 73 65 72 74 28 6e 50 61 67 65 3e 30 29 3b assert(nPage>0);
356c0 0a 20 20 20 20 61 73 73 65 72 74 28 70 67 31 3c . assert(pg1<
356d0 3d 70 50 67 2d 3e 70 67 6e 6f 29 3b 0a 20 20 20 =pPg->pgno);.
356e0 20 61 73 73 65 72 74 28 28 70 67 31 2b 6e 50 61 assert((pg1+nPa
356f0 67 65 29 3e 70 50 67 2d 3e 70 67 6e 6f 29 3b 0a ge)>pPg->pgno);.
35700 0a 20 20 20 20 66 6f 72 28 69 69 3d 30 3b 20 69 . for(ii=0; i
35710 69 3c 6e 50 61 67 65 20 26 26 20 72 63 3d 3d 53 i<nPage && rc==S
35720 51 4c 49 54 45 5f 4f 4b 3b 20 69 69 2b 2b 29 7b QLITE_OK; ii++){
35730 0a 20 20 20 20 20 20 50 67 6e 6f 20 70 67 20 3d . Pgno pg =
35740 20 70 67 31 2b 69 69 3b 0a 20 20 20 20 20 20 50 pg1+ii;. P
35750 67 48 64 72 20 2a 70 50 61 67 65 3b 0a 20 20 20 gHdr *pPage;.
35760 20 20 20 69 66 28 20 70 67 3d 3d 70 50 67 2d 3e if( pg==pPg->
35770 70 67 6e 6f 20 7c 7c 20 21 73 71 6c 69 74 65 33 pgno || !sqlite3
35780 42 69 74 76 65 63 54 65 73 74 28 70 50 61 67 65 BitvecTest(pPage
35790 72 2d 3e 70 49 6e 4a 6f 75 72 6e 61 6c 2c 20 70 r->pInJournal, p
357a0 67 29 20 29 7b 0a 20 20 20 20 20 20 20 20 69 66 g) ){. if
357b0 28 20 70 67 21 3d 50 41 47 45 52 5f 4d 4a 5f 50 ( pg!=PAGER_MJ_P
357c0 47 4e 4f 28 70 50 61 67 65 72 29 20 29 7b 0a 20 GNO(pPager) ){.
357d0 20 20 20 20 20 20 20 20 20 72 63 20 3d 20 73 71 rc = sq
357e0 6c 69 74 65 33 50 61 67 65 72 47 65 74 28 70 50 lite3PagerGet(pP
357f0 61 67 65 72 2c 20 70 67 2c 20 26 70 50 61 67 65 ager, pg, &pPage
35800 29 3b 0a 20 20 20 20 20 20 20 20 20 20 69 66 28 );. if(
35810 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 rc==SQLITE_OK )
35820 7b 0a 20 20 20 20 20 20 20 20 20 20 20 20 72 63 {. rc
35830 20 3d 20 70 61 67 65 72 5f 77 72 69 74 65 28 70 = pager_write(p
35840 50 61 67 65 29 3b 0a 20 20 20 20 20 20 20 20 20 Page);.
35850 20 20 20 69 66 28 20 70 50 61 67 65 2d 3e 66 6c if( pPage->fl
35860 61 67 73 26 50 47 48 44 52 5f 4e 45 45 44 5f 53 ags&PGHDR_NEED_S
35870 59 4e 43 20 29 7b 0a 20 20 20 20 20 20 20 20 20 YNC ){.
35880 20 20 20 20 20 6e 65 65 64 53 79 6e 63 20 3d 20 needSync =
35890 31 3b 0a 20 20 20 20 20 20 20 20 20 20 20 20 7d 1;. }
358a0 0a 20 20 20 20 20 20 20 20 20 20 20 20 73 71 6c . sql
358b0 69 74 65 33 50 61 67 65 72 55 6e 72 65 66 28 70 ite3PagerUnref(p
358c0 50 61 67 65 29 3b 0a 20 20 20 20 20 20 20 20 20 Page);.
358d0 20 7d 0a 20 20 20 20 20 20 20 20 7d 0a 20 20 20 }. }.
358e0 20 20 20 7d 65 6c 73 65 20 69 66 28 20 28 70 50 }else if( (pP
358f0 61 67 65 20 3d 20 70 61 67 65 72 5f 6c 6f 6f 6b age = pager_look
35900 75 70 28 70 50 61 67 65 72 2c 20 70 67 29 29 21 up(pPager, pg))!
35910 3d 30 20 29 7b 0a 20 20 20 20 20 20 20 20 69 66 =0 ){. if
35920 28 20 70 50 61 67 65 2d 3e 66 6c 61 67 73 26 50 ( pPage->flags&P
35930 47 48 44 52 5f 4e 45 45 44 5f 53 59 4e 43 20 29 GHDR_NEED_SYNC )
35940 7b 0a 20 20 20 20 20 20 20 20 20 20 6e 65 65 64 {. need
35950 53 79 6e 63 20 3d 20 31 3b 0a 20 20 20 20 20 20 Sync = 1;.
35960 20 20 7d 0a 20 20 20 20 20 20 20 20 73 71 6c 69 }. sqli
35970 74 65 33 50 61 67 65 72 55 6e 72 65 66 28 70 50 te3PagerUnref(pP
35980 61 67 65 29 3b 0a 20 20 20 20 20 20 7d 0a 20 20 age);. }.
35990 20 20 7d 0a 0a 20 20 20 20 2f 2a 20 49 66 20 74 }.. /* If t
359a0 68 65 20 50 47 48 44 52 5f 4e 45 45 44 5f 53 59 he PGHDR_NEED_SY
359b0 4e 43 20 66 6c 61 67 20 69 73 20 73 65 74 20 66 NC flag is set f
359c0 6f 72 20 61 6e 79 20 6f 66 20 74 68 65 20 6e 50 or any of the nP
359d0 61 67 65 20 70 61 67 65 73 20 0a 20 20 20 20 2a age pages . *
359e0 2a 20 73 74 61 72 74 69 6e 67 20 61 74 20 70 67 * starting at pg
359f0 31 2c 20 74 68 65 6e 20 69 74 20 6e 65 65 64 73 1, then it needs
35a00 20 74 6f 20 62 65 20 73 65 74 20 66 6f 72 20 61 to be set for a
35a10 6c 6c 20 6f 66 20 74 68 65 6d 2e 20 42 65 63 61 ll of them. Beca
35a20 75 73 65 0a 20 20 20 20 2a 2a 20 77 72 69 74 69 use. ** writi
35a30 6e 67 20 74 6f 20 61 6e 79 20 6f 66 20 74 68 65 ng to any of the
35a40 73 65 20 6e 50 61 67 65 20 70 61 67 65 73 20 6d se nPage pages m
35a50 61 79 20 64 61 6d 61 67 65 20 74 68 65 20 6f 74 ay damage the ot
35a60 68 65 72 73 2c 20 74 68 65 0a 20 20 20 20 2a 2a hers, the. **
35a70 20 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 20 6d 75 journal file mu
35a80 73 74 20 63 6f 6e 74 61 69 6e 20 73 79 6e 63 28 st contain sync(
35a90 29 65 64 20 63 6f 70 69 65 73 20 6f 66 20 61 6c )ed copies of al
35aa0 6c 20 6f 66 20 74 68 65 6d 0a 20 20 20 20 2a 2a l of them. **
35ab0 20 62 65 66 6f 72 65 20 61 6e 79 20 6f 66 20 74 before any of t
35ac0 68 65 6d 20 63 61 6e 20 62 65 20 77 72 69 74 74 hem can be writt
35ad0 65 6e 20 6f 75 74 20 74 6f 20 74 68 65 20 64 61 en out to the da
35ae0 74 61 62 61 73 65 20 66 69 6c 65 2e 0a 20 20 20 tabase file..
35af0 20 2a 2f 0a 20 20 20 20 69 66 28 20 72 63 3d 3d */. if( rc==
35b00 53 51 4c 49 54 45 5f 4f 4b 20 26 26 20 6e 65 65 SQLITE_OK && nee
35b10 64 53 79 6e 63 20 29 7b 0a 20 20 20 20 20 20 61 dSync ){. a
35b20 73 73 65 72 74 28 20 21 4d 45 4d 44 42 20 29 3b ssert( !MEMDB );
35b30 0a 20 20 20 20 20 20 66 6f 72 28 69 69 3d 30 3b . for(ii=0;
35b40 20 69 69 3c 6e 50 61 67 65 3b 20 69 69 2b 2b 29 ii<nPage; ii++)
35b50 7b 0a 20 20 20 20 20 20 20 20 50 67 48 64 72 20 {. PgHdr
35b60 2a 70 50 61 67 65 20 3d 20 70 61 67 65 72 5f 6c *pPage = pager_l
35b70 6f 6f 6b 75 70 28 70 50 61 67 65 72 2c 20 70 67 ookup(pPager, pg
35b80 31 2b 69 69 29 3b 0a 20 20 20 20 20 20 20 20 69 1+ii);. i
35b90 66 28 20 70 50 61 67 65 20 29 7b 0a 20 20 20 20 f( pPage ){.
35ba0 20 20 20 20 20 20 70 50 61 67 65 2d 3e 66 6c 61 pPage->fla
35bb0 67 73 20 7c 3d 20 50 47 48 44 52 5f 4e 45 45 44 gs |= PGHDR_NEED
35bc0 5f 53 59 4e 43 3b 0a 20 20 20 20 20 20 20 20 20 _SYNC;.
35bd0 20 73 71 6c 69 74 65 33 50 61 67 65 72 55 6e 72 sqlite3PagerUnr
35be0 65 66 28 70 50 61 67 65 29 3b 0a 20 20 20 20 20 ef(pPage);.
35bf0 20 20 20 7d 0a 20 20 20 20 20 20 7d 0a 20 20 20 }. }.
35c00 20 7d 0a 0a 20 20 20 20 61 73 73 65 72 74 28 20 }.. assert(
35c10 70 50 61 67 65 72 2d 3e 64 6f 4e 6f 74 53 79 6e pPager->doNotSyn
35c20 63 53 70 69 6c 6c 3d 3d 31 20 29 3b 0a 20 20 20 cSpill==1 );.
35c30 20 70 50 61 67 65 72 2d 3e 64 6f 4e 6f 74 53 79 pPager->doNotSy
35c40 6e 63 53 70 69 6c 6c 2d 2d 3b 0a 20 20 7d 65 6c ncSpill--;. }el
35c50 73 65 7b 0a 20 20 20 20 72 63 20 3d 20 70 61 67 se{. rc = pag
35c60 65 72 5f 77 72 69 74 65 28 70 44 62 50 61 67 65 er_write(pDbPage
35c70 29 3b 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e 20 );. }. return
35c80 72 63 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 52 65 74 rc;.}../*.** Ret
35c90 75 72 6e 20 54 52 55 45 20 69 66 20 74 68 65 20 urn TRUE if the
35ca0 70 61 67 65 20 67 69 76 65 6e 20 69 6e 20 74 68 page given in th
35cb0 65 20 61 72 67 75 6d 65 6e 74 20 77 61 73 20 70 e argument was p
35cc0 72 65 76 69 6f 75 73 6c 79 20 70 61 73 73 65 64 reviously passed
35cd0 0a 2a 2a 20 74 6f 20 73 71 6c 69 74 65 33 50 61 .** to sqlite3Pa
35ce0 67 65 72 57 72 69 74 65 28 29 2e 20 20 49 6e 20 gerWrite(). In
35cf0 6f 74 68 65 72 20 77 6f 72 64 73 2c 20 72 65 74 other words, ret
35d00 75 72 6e 20 54 52 55 45 20 69 66 20 69 74 20 69 urn TRUE if it i
35d10 73 20 6f 6b 0a 2a 2a 20 74 6f 20 63 68 61 6e 67 s ok.** to chang
35d20 65 20 74 68 65 20 63 6f 6e 74 65 6e 74 20 6f 66 e the content of
35d30 20 74 68 65 20 70 61 67 65 2e 0a 2a 2f 0a 23 69 the page..*/.#i
35d40 66 6e 64 65 66 20 4e 44 45 42 55 47 0a 69 6e 74 fndef NDEBUG.int
35d50 20 73 71 6c 69 74 65 33 50 61 67 65 72 49 73 77 sqlite3PagerIsw
35d60 72 69 74 65 61 62 6c 65 28 44 62 50 61 67 65 20 riteable(DbPage
35d70 2a 70 50 67 29 7b 0a 20 20 72 65 74 75 72 6e 20 *pPg){. return
35d80 70 50 67 2d 3e 66 6c 61 67 73 26 50 47 48 44 52 pPg->flags&PGHDR
35d90 5f 44 49 52 54 59 3b 0a 7d 0a 23 65 6e 64 69 66 _DIRTY;.}.#endif
35da0 0a 0a 2f 2a 0a 2a 2a 20 41 20 63 61 6c 6c 20 74 ../*.** A call t
35db0 6f 20 74 68 69 73 20 72 6f 75 74 69 6e 65 20 74 o this routine t
35dc0 65 6c 6c 73 20 74 68 65 20 70 61 67 65 72 20 74 ells the pager t
35dd0 68 61 74 20 69 74 20 69 73 20 6e 6f 74 20 6e 65 hat it is not ne
35de0 63 65 73 73 61 72 79 20 74 6f 0a 2a 2a 20 77 72 cessary to.** wr
35df0 69 74 65 20 74 68 65 20 69 6e 66 6f 72 6d 61 74 ite the informat
35e00 69 6f 6e 20 6f 6e 20 70 61 67 65 20 70 50 67 20 ion on page pPg
35e10 62 61 63 6b 20 74 6f 20 74 68 65 20 64 69 73 6b back to the disk
35e20 2c 20 65 76 65 6e 20 74 68 6f 75 67 68 0a 2a 2a , even though.**
35e30 20 74 68 61 74 20 70 61 67 65 20 6d 69 67 68 74 that page might
35e40 20 62 65 20 6d 61 72 6b 65 64 20 61 73 20 64 69 be marked as di
35e50 72 74 79 2e 20 20 54 68 69 73 20 68 61 70 70 65 rty. This happe
35e60 6e 73 2c 20 66 6f 72 20 65 78 61 6d 70 6c 65 2c ns, for example,
35e70 20 77 68 65 6e 0a 2a 2a 20 74 68 65 20 70 61 67 when.** the pag
35e80 65 20 68 61 73 20 62 65 65 6e 20 61 64 64 65 64 e has been added
35e90 20 61 73 20 61 20 6c 65 61 66 20 6f 66 20 74 68 as a leaf of th
35ea0 65 20 66 72 65 65 6c 69 73 74 20 61 6e 64 20 73 e freelist and s
35eb0 6f 20 69 74 73 0a 2a 2a 20 63 6f 6e 74 65 6e 74 o its.** content
35ec0 20 6e 6f 20 6c 6f 6e 67 65 72 20 6d 61 74 74 65 no longer matte
35ed0 72 73 2e 0a 2a 2a 0a 2a 2a 20 54 68 65 20 6f 76 rs..**.** The ov
35ee0 65 72 6c 79 69 6e 67 20 73 6f 66 74 77 61 72 65 erlying software
35ef0 20 6c 61 79 65 72 20 63 61 6c 6c 73 20 74 68 69 layer calls thi
35f00 73 20 72 6f 75 74 69 6e 65 20 77 68 65 6e 20 61 s routine when a
35f10 6c 6c 20 6f 66 20 74 68 65 20 64 61 74 61 0a 2a ll of the data.*
35f20 2a 20 6f 6e 20 74 68 65 20 67 69 76 65 6e 20 70 * on the given p
35f30 61 67 65 20 69 73 20 75 6e 75 73 65 64 2e 20 54 age is unused. T
35f40 68 65 20 70 61 67 65 72 20 6d 61 72 6b 73 20 74 he pager marks t
35f50 68 65 20 70 61 67 65 20 61 73 20 63 6c 65 61 6e he page as clean
35f60 20 73 6f 0a 2a 2a 20 74 68 61 74 20 69 74 20 64 so.** that it d
35f70 6f 65 73 20 6e 6f 74 20 67 65 74 20 77 72 69 74 oes not get writ
35f80 74 65 6e 20 74 6f 20 64 69 73 6b 2e 0a 2a 2a 0a ten to disk..**.
35f90 2a 2a 20 54 65 73 74 73 20 73 68 6f 77 20 74 68 ** Tests show th
35fa0 61 74 20 74 68 69 73 20 6f 70 74 69 6d 69 7a 61 at this optimiza
35fb0 74 69 6f 6e 20 63 61 6e 20 71 75 61 64 72 75 70 tion can quadrup
35fc0 6c 65 20 74 68 65 20 73 70 65 65 64 20 6f 66 20 le the speed of
35fd0 6c 61 72 67 65 20 0a 2a 2a 20 44 45 4c 45 54 45 large .** DELETE
35fe0 20 6f 70 65 72 61 74 69 6f 6e 73 2e 0a 2a 2f 0a operations..*/.
35ff0 76 6f 69 64 20 73 71 6c 69 74 65 33 50 61 67 65 void sqlite3Page
36000 72 44 6f 6e 74 57 72 69 74 65 28 50 67 48 64 72 rDontWrite(PgHdr
36010 20 2a 70 50 67 29 7b 0a 20 20 50 61 67 65 72 20 *pPg){. Pager
36020 2a 70 50 61 67 65 72 20 3d 20 70 50 67 2d 3e 70 *pPager = pPg->p
36030 50 61 67 65 72 3b 0a 20 20 69 66 28 20 28 70 50 Pager;. if( (pP
36040 67 2d 3e 66 6c 61 67 73 26 50 47 48 44 52 5f 44 g->flags&PGHDR_D
36050 49 52 54 59 29 20 26 26 20 70 50 61 67 65 72 2d IRTY) && pPager-
36060 3e 6e 53 61 76 65 70 6f 69 6e 74 3d 3d 30 20 29 >nSavepoint==0 )
36070 7b 0a 20 20 20 20 50 41 47 45 52 54 52 41 43 45 {. PAGERTRACE
36080 28 28 22 44 4f 4e 54 5f 57 52 49 54 45 20 70 61 (("DONT_WRITE pa
36090 67 65 20 25 64 20 6f 66 20 25 64 5c 6e 22 2c 20 ge %d of %d\n",
360a0 70 50 67 2d 3e 70 67 6e 6f 2c 20 50 41 47 45 52 pPg->pgno, PAGER
360b0 49 44 28 70 50 61 67 65 72 29 29 29 3b 0a 20 20 ID(pPager)));.
360c0 20 20 49 4f 54 52 41 43 45 28 28 22 43 4c 45 41 IOTRACE(("CLEA
360d0 4e 20 25 70 20 25 64 5c 6e 22 2c 20 70 50 61 67 N %p %d\n", pPag
360e0 65 72 2c 20 70 50 67 2d 3e 70 67 6e 6f 29 29 0a er, pPg->pgno)).
360f0 20 20 20 20 70 50 67 2d 3e 66 6c 61 67 73 20 7c pPg->flags |
36100 3d 20 50 47 48 44 52 5f 44 4f 4e 54 5f 57 52 49 = PGHDR_DONT_WRI
36110 54 45 3b 0a 20 20 20 20 70 61 67 65 72 5f 73 65 TE;. pager_se
36120 74 5f 70 61 67 65 68 61 73 68 28 70 50 67 29 3b t_pagehash(pPg);
36130 0a 20 20 7d 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 54 68 . }.}../*.** Th
36140 69 73 20 72 6f 75 74 69 6e 65 20 69 73 20 63 61 is routine is ca
36150 6c 6c 65 64 20 74 6f 20 69 6e 63 72 65 6d 65 6e lled to incremen
36160 74 20 74 68 65 20 76 61 6c 75 65 20 6f 66 20 74 t the value of t
36170 68 65 20 64 61 74 61 62 61 73 65 20 66 69 6c 65 he database file
36180 20 0a 2a 2a 20 63 68 61 6e 67 65 2d 63 6f 75 6e .** change-coun
36190 74 65 72 2c 20 73 74 6f 72 65 64 20 61 73 20 61 ter, stored as a
361a0 20 34 2d 62 79 74 65 20 62 69 67 2d 65 6e 64 69 4-byte big-endi
361b0 61 6e 20 69 6e 74 65 67 65 72 20 73 74 61 72 74 an integer start
361c0 69 6e 67 20 61 74 20 0a 2a 2a 20 62 79 74 65 20 ing at .** byte
361d0 6f 66 66 73 65 74 20 32 34 20 6f 66 20 74 68 65 offset 24 of the
361e0 20 70 61 67 65 72 20 66 69 6c 65 2e 20 20 54 68 pager file. Th
361f0 65 20 73 65 63 6f 6e 64 61 72 79 20 63 68 61 6e e secondary chan
36200 67 65 20 63 6f 75 6e 74 65 72 20 61 74 0a 2a 2a ge counter at.**
36210 20 39 32 20 69 73 20 61 6c 73 6f 20 75 70 64 61 92 is also upda
36220 74 65 64 2c 20 61 73 20 69 73 20 74 68 65 20 53 ted, as is the S
36230 51 4c 69 74 65 20 76 65 72 73 69 6f 6e 20 6e 75 QLite version nu
36240 6d 62 65 72 20 61 74 20 6f 66 66 73 65 74 20 39 mber at offset 9
36250 36 2e 0a 2a 2a 0a 2a 2a 20 42 75 74 20 74 68 69 6..**.** But thi
36260 73 20 6f 6e 6c 79 20 68 61 70 70 65 6e 73 20 69 s only happens i
36270 66 20 74 68 65 20 70 50 61 67 65 72 2d 3e 63 68 f the pPager->ch
36280 61 6e 67 65 43 6f 75 6e 74 44 6f 6e 65 20 66 6c angeCountDone fl
36290 61 67 20 69 73 20 66 61 6c 73 65 2e 0a 2a 2a 20 ag is false..**
362a0 54 6f 20 61 76 6f 69 64 20 65 78 63 65 73 73 20 To avoid excess
362b0 63 68 75 72 6e 69 6e 67 20 6f 66 20 70 61 67 65 churning of page
362c0 20 31 2c 20 74 68 65 20 75 70 64 61 74 65 20 6f 1, the update o
362d0 6e 6c 79 20 68 61 70 70 65 6e 73 20 6f 6e 63 65 nly happens once
362e0 2e 0a 2a 2a 20 53 65 65 20 61 6c 73 6f 20 74 68 ..** See also th
362f0 65 20 70 61 67 65 72 5f 77 72 69 74 65 5f 63 68 e pager_write_ch
36300 61 6e 67 65 63 6f 75 6e 74 65 72 28 29 20 72 6f angecounter() ro
36310 75 74 69 6e 65 20 74 68 61 74 20 64 6f 65 73 20 utine that does
36320 61 6e 20 0a 2a 2a 20 75 6e 63 6f 6e 64 69 74 69 an .** unconditi
36330 6f 6e 61 6c 20 75 70 64 61 74 65 20 6f 66 20 74 onal update of t
36340 68 65 20 63 68 61 6e 67 65 20 63 6f 75 6e 74 65 he change counte
36350 72 73 2e 0a 2a 2a 0a 2a 2a 20 49 66 20 74 68 65 rs..**.** If the
36360 20 69 73 44 69 72 65 63 74 4d 6f 64 65 20 66 6c isDirectMode fl
36370 61 67 20 69 73 20 7a 65 72 6f 2c 20 74 68 65 6e ag is zero, then
36380 20 74 68 69 73 20 69 73 20 64 6f 6e 65 20 62 79 this is done by
36390 20 63 61 6c 6c 69 6e 67 20 0a 2a 2a 20 73 71 6c calling .** sql
363a0 69 74 65 33 50 61 67 65 72 57 72 69 74 65 28 29 ite3PagerWrite()
363b0 20 6f 6e 20 70 61 67 65 20 31 2c 20 74 68 65 6e on page 1, then
363c0 20 6d 6f 64 69 66 79 69 6e 67 20 74 68 65 20 63 modifying the c
363d0 6f 6e 74 65 6e 74 73 20 6f 66 20 74 68 65 0a 2a ontents of the.*
363e0 2a 20 70 61 67 65 20 64 61 74 61 2e 20 49 6e 20 * page data. In
363f0 74 68 69 73 20 63 61 73 65 20 74 68 65 20 66 69 this case the fi
36400 6c 65 20 77 69 6c 6c 20 62 65 20 75 70 64 61 74 le will be updat
36410 65 64 20 77 68 65 6e 20 74 68 65 20 63 75 72 72 ed when the curr
36420 65 6e 74 0a 2a 2a 20 74 72 61 6e 73 61 63 74 69 ent.** transacti
36430 6f 6e 20 69 73 20 63 6f 6d 6d 69 74 74 65 64 2e on is committed.
36440 0a 2a 2a 0a 2a 2a 20 54 68 65 20 69 73 44 69 72 .**.** The isDir
36450 65 63 74 4d 6f 64 65 20 66 6c 61 67 20 6d 61 79 ectMode flag may
36460 20 6f 6e 6c 79 20 62 65 20 6e 6f 6e 2d 7a 65 72 only be non-zer
36470 6f 20 69 66 20 74 68 65 20 6c 69 62 72 61 72 79 o if the library
36480 20 77 61 73 20 63 6f 6d 70 69 6c 65 64 0a 2a 2a was compiled.**
36490 20 77 69 74 68 20 74 68 65 20 53 51 4c 49 54 45 with the SQLITE
364a0 5f 45 4e 41 42 4c 45 5f 41 54 4f 4d 49 43 5f 57 _ENABLE_ATOMIC_W
364b0 52 49 54 45 20 6d 61 63 72 6f 20 64 65 66 69 6e RITE macro defin
364c0 65 64 2e 20 49 6e 20 74 68 69 73 20 63 61 73 65 ed. In this case
364d0 2c 0a 2a 2a 20 69 66 20 69 73 44 69 72 65 63 74 ,.** if isDirect
364e0 20 69 73 20 6e 6f 6e 2d 7a 65 72 6f 2c 20 74 68 is non-zero, th
364f0 65 6e 20 74 68 65 20 64 61 74 61 62 61 73 65 20 en the database
36500 66 69 6c 65 20 69 73 20 75 70 64 61 74 65 64 20 file is updated
36510 64 69 72 65 63 74 6c 79 0a 2a 2a 20 62 79 20 77 directly.** by w
36520 72 69 74 69 6e 67 20 61 6e 20 75 70 64 61 74 65 riting an update
36530 64 20 76 65 72 73 69 6f 6e 20 6f 66 20 70 61 67 d version of pag
36540 65 20 31 20 75 73 69 6e 67 20 61 20 63 61 6c 6c e 1 using a call
36550 20 74 6f 20 74 68 65 20 0a 2a 2a 20 73 71 6c 69 to the .** sqli
36560 74 65 33 4f 73 57 72 69 74 65 28 29 20 66 75 6e te3OsWrite() fun
36570 63 74 69 6f 6e 2e 0a 2a 2f 0a 73 74 61 74 69 63 ction..*/.static
36580 20 69 6e 74 20 70 61 67 65 72 5f 69 6e 63 72 5f int pager_incr_
36590 63 68 61 6e 67 65 63 6f 75 6e 74 65 72 28 50 61 changecounter(Pa
365a0 67 65 72 20 2a 70 50 61 67 65 72 2c 20 69 6e 74 ger *pPager, int
365b0 20 69 73 44 69 72 65 63 74 4d 6f 64 65 29 7b 0a isDirectMode){.
365c0 20 20 69 6e 74 20 72 63 20 3d 20 53 51 4c 49 54 int rc = SQLIT
365d0 45 5f 4f 4b 3b 0a 0a 20 20 61 73 73 65 72 74 28 E_OK;.. assert(
365e0 20 70 50 61 67 65 72 2d 3e 65 53 74 61 74 65 3d pPager->eState=
365f0 3d 50 41 47 45 52 5f 57 52 49 54 45 52 5f 43 41 =PAGER_WRITER_CA
36600 43 48 45 4d 4f 44 0a 20 20 20 20 20 20 20 7c 7c CHEMOD. ||
36610 20 70 50 61 67 65 72 2d 3e 65 53 74 61 74 65 3d pPager->eState=
36620 3d 50 41 47 45 52 5f 57 52 49 54 45 52 5f 44 42 =PAGER_WRITER_DB
36630 4d 4f 44 0a 20 20 29 3b 0a 20 20 61 73 73 65 72 MOD. );. asser
36640 74 28 20 61 73 73 65 72 74 5f 70 61 67 65 72 5f t( assert_pager_
36650 73 74 61 74 65 28 70 50 61 67 65 72 29 20 29 3b state(pPager) );
36660 0a 0a 20 20 2f 2a 20 44 65 63 6c 61 72 65 20 61 .. /* Declare a
36670 6e 64 20 69 6e 69 74 69 61 6c 69 7a 65 20 63 6f nd initialize co
36680 6e 73 74 61 6e 74 20 69 6e 74 65 67 65 72 20 27 nstant integer '
36690 69 73 44 69 72 65 63 74 27 2e 20 49 66 20 74 68 isDirect'. If th
366a0 65 0a 20 20 2a 2a 20 61 74 6f 6d 69 63 2d 77 72 e. ** atomic-wr
366b0 69 74 65 20 6f 70 74 69 6d 69 7a 61 74 69 6f 6e ite optimization
366c0 20 69 73 20 65 6e 61 62 6c 65 64 20 69 6e 20 74 is enabled in t
366d0 68 69 73 20 62 75 69 6c 64 2c 20 74 68 65 6e 20 his build, then
366e0 69 73 44 69 72 65 63 74 0a 20 20 2a 2a 20 69 73 isDirect. ** is
366f0 20 69 6e 69 74 69 61 6c 69 7a 65 64 20 74 6f 20 initialized to
36700 74 68 65 20 76 61 6c 75 65 20 70 61 73 73 65 64 the value passed
36710 20 61 73 20 74 68 65 20 69 73 44 69 72 65 63 74 as the isDirect
36720 4d 6f 64 65 20 70 61 72 61 6d 65 74 65 72 0a 20 Mode parameter.
36730 20 2a 2a 20 74 6f 20 74 68 69 73 20 66 75 6e 63 ** to this func
36740 74 69 6f 6e 2e 20 4f 74 68 65 72 77 69 73 65 2c tion. Otherwise,
36750 20 69 74 20 69 73 20 61 6c 77 61 79 73 20 73 65 it is always se
36760 74 20 74 6f 20 7a 65 72 6f 2e 0a 20 20 2a 2a 0a t to zero.. **.
36770 20 20 2a 2a 20 54 68 65 20 69 64 65 61 20 69 73 ** The idea is
36780 20 74 68 61 74 20 69 66 20 74 68 65 20 61 74 6f that if the ato
36790 6d 69 63 2d 77 72 69 74 65 20 6f 70 74 69 6d 69 mic-write optimi
367a0 7a 61 74 69 6f 6e 20 69 73 20 6e 6f 74 0a 20 20 zation is not.
367b0 2a 2a 20 65 6e 61 62 6c 65 64 20 61 74 20 63 6f ** enabled at co
367c0 6d 70 69 6c 65 20 74 69 6d 65 2c 20 74 68 65 20 mpile time, the
367d0 63 6f 6d 70 69 6c 65 72 20 63 61 6e 20 6f 6d 69 compiler can omi
367e0 74 20 74 68 65 20 74 65 73 74 73 20 6f 66 0a 20 t the tests of.
367f0 20 2a 2a 20 27 69 73 44 69 72 65 63 74 27 20 62 ** 'isDirect' b
36800 65 6c 6f 77 2c 20 61 73 20 77 65 6c 6c 20 61 73 elow, as well as
36810 20 74 68 65 20 62 6c 6f 63 6b 20 65 6e 63 6c 6f the block enclo
36820 73 65 64 20 69 6e 20 74 68 65 0a 20 20 2a 2a 20 sed in the. **
36830 22 69 66 28 20 69 73 44 69 72 65 63 74 20 29 22 "if( isDirect )"
36840 20 63 6f 6e 64 69 74 69 6f 6e 2e 0a 20 20 2a 2f condition.. */
36850 0a 23 69 66 6e 64 65 66 20 53 51 4c 49 54 45 5f .#ifndef SQLITE_
36860 45 4e 41 42 4c 45 5f 41 54 4f 4d 49 43 5f 57 52 ENABLE_ATOMIC_WR
36870 49 54 45 0a 23 20 64 65 66 69 6e 65 20 44 49 52 ITE.# define DIR
36880 45 43 54 5f 4d 4f 44 45 20 30 0a 20 20 61 73 73 ECT_MODE 0. ass
36890 65 72 74 28 20 69 73 44 69 72 65 63 74 4d 6f 64 ert( isDirectMod
368a0 65 3d 3d 30 20 29 3b 0a 20 20 55 4e 55 53 45 44 e==0 );. UNUSED
368b0 5f 50 41 52 41 4d 45 54 45 52 28 69 73 44 69 72 _PARAMETER(isDir
368c0 65 63 74 4d 6f 64 65 29 3b 0a 23 65 6c 73 65 0a ectMode);.#else.
368d0 23 20 64 65 66 69 6e 65 20 44 49 52 45 43 54 5f # define DIRECT_
368e0 4d 4f 44 45 20 69 73 44 69 72 65 63 74 4d 6f 64 MODE isDirectMod
368f0 65 0a 23 65 6e 64 69 66 0a 0a 20 20 69 66 28 20 e.#endif.. if(
36900 21 70 50 61 67 65 72 2d 3e 63 68 61 6e 67 65 43 !pPager->changeC
36910 6f 75 6e 74 44 6f 6e 65 20 26 26 20 70 50 61 67 ountDone && pPag
36920 65 72 2d 3e 64 62 53 69 7a 65 3e 30 20 29 7b 0a er->dbSize>0 ){.
36930 20 20 20 20 50 67 48 64 72 20 2a 70 50 67 48 64 PgHdr *pPgHd
36940 72 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 r;
36950 20 20 2f 2a 20 52 65 66 65 72 65 6e 63 65 20 74 /* Reference t
36960 6f 20 70 61 67 65 20 31 20 2a 2f 0a 0a 20 20 20 o page 1 */..
36970 20 61 73 73 65 72 74 28 20 21 70 50 61 67 65 72 assert( !pPager
36980 2d 3e 74 65 6d 70 46 69 6c 65 20 26 26 20 69 73 ->tempFile && is
36990 4f 70 65 6e 28 70 50 61 67 65 72 2d 3e 66 64 29 Open(pPager->fd)
369a0 20 29 3b 0a 0a 20 20 20 20 2f 2a 20 4f 70 65 6e );.. /* Open
369b0 20 70 61 67 65 20 31 20 6f 66 20 74 68 65 20 66 page 1 of the f
369c0 69 6c 65 20 66 6f 72 20 77 72 69 74 69 6e 67 2e ile for writing.
369d0 20 2a 2f 0a 20 20 20 20 72 63 20 3d 20 73 71 6c */. rc = sql
369e0 69 74 65 33 50 61 67 65 72 47 65 74 28 70 50 61 ite3PagerGet(pPa
369f0 67 65 72 2c 20 31 2c 20 26 70 50 67 48 64 72 29 ger, 1, &pPgHdr)
36a00 3b 0a 20 20 20 20 61 73 73 65 72 74 28 20 70 50 ;. assert( pP
36a10 67 48 64 72 3d 3d 30 20 7c 7c 20 72 63 3d 3d 53 gHdr==0 || rc==S
36a20 51 4c 49 54 45 5f 4f 4b 20 29 3b 0a 0a 20 20 20 QLITE_OK );..
36a30 20 2f 2a 20 49 66 20 70 61 67 65 20 6f 6e 65 20 /* If page one
36a40 77 61 73 20 66 65 74 63 68 65 64 20 73 75 63 63 was fetched succ
36a50 65 73 73 66 75 6c 6c 79 2c 20 61 6e 64 20 74 68 essfully, and th
36a60 69 73 20 66 75 6e 63 74 69 6f 6e 20 69 73 20 6e is function is n
36a70 6f 74 0a 20 20 20 20 2a 2a 20 6f 70 65 72 61 74 ot. ** operat
36a80 69 6e 67 20 69 6e 20 64 69 72 65 63 74 2d 6d 6f ing in direct-mo
36a90 64 65 2c 20 6d 61 6b 65 20 70 61 67 65 20 31 20 de, make page 1
36aa0 77 72 69 74 61 62 6c 65 2e 20 20 57 68 65 6e 20 writable. When
36ab0 6e 6f 74 20 69 6e 20 0a 20 20 20 20 2a 2a 20 64 not in . ** d
36ac0 69 72 65 63 74 20 6d 6f 64 65 2c 20 70 61 67 65 irect mode, page
36ad0 20 31 20 69 73 20 61 6c 77 61 79 73 20 68 65 6c 1 is always hel
36ae0 64 20 69 6e 20 63 61 63 68 65 20 61 6e 64 20 68 d in cache and h
36af0 65 6e 63 65 20 74 68 65 20 50 61 67 65 72 47 65 ence the PagerGe
36b00 74 28 29 0a 20 20 20 20 2a 2a 20 61 62 6f 76 65 t(). ** above
36b10 20 69 73 20 61 6c 77 61 79 73 20 73 75 63 63 65 is always succe
36b20 73 73 66 75 6c 20 2d 20 68 65 6e 63 65 20 74 68 ssful - hence th
36b30 65 20 41 4c 57 41 59 53 20 6f 6e 20 72 63 3d 3d e ALWAYS on rc==
36b40 53 51 4c 49 54 45 5f 4f 4b 2e 0a 20 20 20 20 2a SQLITE_OK.. *
36b50 2f 0a 20 20 20 20 69 66 28 20 21 44 49 52 45 43 /. if( !DIREC
36b60 54 5f 4d 4f 44 45 20 26 26 20 41 4c 57 41 59 53 T_MODE && ALWAYS
36b70 28 72 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b 29 20 (rc==SQLITE_OK)
36b80 29 7b 0a 20 20 20 20 20 20 72 63 20 3d 20 73 71 ){. rc = sq
36b90 6c 69 74 65 33 50 61 67 65 72 57 72 69 74 65 28 lite3PagerWrite(
36ba0 70 50 67 48 64 72 29 3b 0a 20 20 20 20 7d 0a 0a pPgHdr);. }..
36bb0 20 20 20 20 69 66 28 20 72 63 3d 3d 53 51 4c 49 if( rc==SQLI
36bc0 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 20 20 2f TE_OK ){. /
36bd0 2a 20 41 63 74 75 61 6c 6c 79 20 64 6f 20 74 68 * Actually do th
36be0 65 20 75 70 64 61 74 65 20 6f 66 20 74 68 65 20 e update of the
36bf0 63 68 61 6e 67 65 20 63 6f 75 6e 74 65 72 20 2a change counter *
36c00 2f 0a 20 20 20 20 20 20 70 61 67 65 72 5f 77 72 /. pager_wr
36c10 69 74 65 5f 63 68 61 6e 67 65 63 6f 75 6e 74 65 ite_changecounte
36c20 72 28 70 50 67 48 64 72 29 3b 0a 0a 20 20 20 20 r(pPgHdr);..
36c30 20 20 2f 2a 20 49 66 20 72 75 6e 6e 69 6e 67 20 /* If running
36c40 69 6e 20 64 69 72 65 63 74 20 6d 6f 64 65 2c 20 in direct mode,
36c50 77 72 69 74 65 20 74 68 65 20 63 6f 6e 74 65 6e write the conten
36c60 74 73 20 6f 66 20 70 61 67 65 20 31 20 74 6f 20 ts of page 1 to
36c70 74 68 65 20 66 69 6c 65 2e 20 2a 2f 0a 20 20 20 the file. */.
36c80 20 20 20 69 66 28 20 44 49 52 45 43 54 5f 4d 4f if( DIRECT_MO
36c90 44 45 20 29 7b 0a 20 20 20 20 20 20 20 20 63 6f DE ){. co
36ca0 6e 73 74 20 76 6f 69 64 20 2a 7a 42 75 66 3b 0a nst void *zBuf;.
36cb0 20 20 20 20 20 20 20 20 61 73 73 65 72 74 28 20 assert(
36cc0 70 50 61 67 65 72 2d 3e 64 62 46 69 6c 65 53 69 pPager->dbFileSi
36cd0 7a 65 3e 30 20 29 3b 0a 20 20 20 20 20 20 20 20 ze>0 );.
36ce0 43 4f 44 45 43 32 28 70 50 61 67 65 72 2c 20 70 CODEC2(pPager, p
36cf0 50 67 48 64 72 2d 3e 70 44 61 74 61 2c 20 31 2c PgHdr->pData, 1,
36d00 20 36 2c 20 72 63 3d 53 51 4c 49 54 45 5f 4e 4f 6, rc=SQLITE_NO
36d10 4d 45 4d 2c 20 7a 42 75 66 29 3b 0a 20 20 20 20 MEM, zBuf);.
36d20 20 20 20 20 69 66 28 20 72 63 3d 3d 53 51 4c 49 if( rc==SQLI
36d30 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 20 20 20 TE_OK ){.
36d40 20 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33 4f rc = sqlite3O
36d50 73 57 72 69 74 65 28 70 50 61 67 65 72 2d 3e 66 sWrite(pPager->f
36d60 64 2c 20 7a 42 75 66 2c 20 70 50 61 67 65 72 2d d, zBuf, pPager-
36d70 3e 70 61 67 65 53 69 7a 65 2c 20 30 29 3b 0a 20 >pageSize, 0);.
36d80 20 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 20 }.
36d90 20 69 66 28 20 72 63 3d 3d 53 51 4c 49 54 45 5f if( rc==SQLITE_
36da0 4f 4b 20 29 7b 0a 20 20 20 20 20 20 20 20 20 20 OK ){.
36db0 70 50 61 67 65 72 2d 3e 63 68 61 6e 67 65 43 6f pPager->changeCo
36dc0 75 6e 74 44 6f 6e 65 20 3d 20 31 3b 0a 20 20 20 untDone = 1;.
36dd0 20 20 20 20 20 7d 0a 20 20 20 20 20 20 7d 65 6c }. }el
36de0 73 65 7b 0a 20 20 20 20 20 20 20 20 70 50 61 67 se{. pPag
36df0 65 72 2d 3e 63 68 61 6e 67 65 43 6f 75 6e 74 44 er->changeCountD
36e00 6f 6e 65 20 3d 20 31 3b 0a 20 20 20 20 20 20 7d one = 1;. }
36e10 0a 20 20 20 20 7d 0a 0a 20 20 20 20 2f 2a 20 52 . }.. /* R
36e20 65 6c 65 61 73 65 20 74 68 65 20 70 61 67 65 20 elease the page
36e30 72 65 66 65 72 65 6e 63 65 2e 20 2a 2f 0a 20 20 reference. */.
36e40 20 20 73 71 6c 69 74 65 33 50 61 67 65 72 55 6e sqlite3PagerUn
36e50 72 65 66 28 70 50 67 48 64 72 29 3b 0a 20 20 7d ref(pPgHdr);. }
36e60 0a 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 7d 0a . return rc;.}.
36e70 0a 2f 2a 0a 2a 2a 20 53 79 6e 63 20 74 68 65 20 ./*.** Sync the
36e80 64 61 74 61 62 61 73 65 20 66 69 6c 65 20 74 6f database file to
36e90 20 64 69 73 6b 2e 20 54 68 69 73 20 69 73 20 61 disk. This is a
36ea0 20 6e 6f 2d 6f 70 20 66 6f 72 20 69 6e 2d 6d 65 no-op for in-me
36eb0 6d 6f 72 79 20 64 61 74 61 62 61 73 65 73 0a 2a mory databases.*
36ec0 2a 20 6f 72 20 70 61 67 65 73 20 77 69 74 68 20 * or pages with
36ed0 74 68 65 20 50 61 67 65 72 2e 6e 6f 53 79 6e 63 the Pager.noSync
36ee0 20 66 6c 61 67 20 73 65 74 2e 0a 2a 2a 0a 2a 2a flag set..**.**
36ef0 20 49 66 20 73 75 63 63 65 73 73 66 75 6c 2c 20 If successful,
36f00 6f 72 20 69 66 20 63 61 6c 6c 65 64 20 6f 6e 20 or if called on
36f10 61 20 70 61 67 65 72 20 66 6f 72 20 77 68 69 63 a pager for whic
36f20 68 20 69 74 20 69 73 20 61 20 6e 6f 2d 6f 70 2c h it is a no-op,
36f30 20 74 68 69 73 0a 2a 2a 20 66 75 6e 63 74 69 6f this.** functio
36f40 6e 20 72 65 74 75 72 6e 73 20 53 51 4c 49 54 45 n returns SQLITE
36f50 5f 4f 4b 2e 20 4f 74 68 65 72 77 69 73 65 2c 20 _OK. Otherwise,
36f60 61 6e 20 49 4f 20 65 72 72 6f 72 20 63 6f 64 65 an IO error code
36f70 20 69 73 20 72 65 74 75 72 6e 65 64 2e 0a 2a 2f is returned..*/
36f80 0a 69 6e 74 20 73 71 6c 69 74 65 33 50 61 67 65 .int sqlite3Page
36f90 72 53 79 6e 63 28 50 61 67 65 72 20 2a 70 50 61 rSync(Pager *pPa
36fa0 67 65 72 29 7b 0a 20 20 69 6e 74 20 72 63 20 3d ger){. int rc =
36fb0 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20 20 69 66 SQLITE_OK;. if
36fc0 28 20 21 70 50 61 67 65 72 2d 3e 6e 6f 53 79 6e ( !pPager->noSyn
36fd0 63 20 29 7b 0a 20 20 20 20 61 73 73 65 72 74 28 c ){. assert(
36fe0 20 21 4d 45 4d 44 42 20 29 3b 0a 20 20 20 20 72 !MEMDB );. r
36ff0 63 20 3d 20 73 71 6c 69 74 65 33 4f 73 53 79 6e c = sqlite3OsSyn
37000 63 28 70 50 61 67 65 72 2d 3e 66 64 2c 20 70 50 c(pPager->fd, pP
37010 61 67 65 72 2d 3e 73 79 6e 63 46 6c 61 67 73 29 ager->syncFlags)
37020 3b 0a 20 20 7d 65 6c 73 65 20 69 66 28 20 69 73 ;. }else if( is
37030 4f 70 65 6e 28 70 50 61 67 65 72 2d 3e 66 64 29 Open(pPager->fd)
37040 20 29 7b 0a 20 20 20 20 61 73 73 65 72 74 28 20 ){. assert(
37050 21 4d 45 4d 44 42 20 29 3b 0a 20 20 20 20 73 71 !MEMDB );. sq
37060 6c 69 74 65 33 4f 73 46 69 6c 65 43 6f 6e 74 72 lite3OsFileContr
37070 6f 6c 28 70 50 61 67 65 72 2d 3e 66 64 2c 20 53 ol(pPager->fd, S
37080 51 4c 49 54 45 5f 46 43 4e 54 4c 5f 53 59 4e 43 QLITE_FCNTL_SYNC
37090 5f 4f 4d 49 54 54 45 44 2c 20 28 76 6f 69 64 20 _OMITTED, (void
370a0 2a 29 26 72 63 29 3b 0a 20 20 7d 0a 20 20 72 65 *)&rc);. }. re
370b0 74 75 72 6e 20 72 63 3b 0a 7d 0a 0a 2f 2a 0a 2a turn rc;.}../*.*
370c0 2a 20 54 68 69 73 20 66 75 6e 63 74 69 6f 6e 20 * This function
370d0 6d 61 79 20 6f 6e 6c 79 20 62 65 20 63 61 6c 6c may only be call
370e0 65 64 20 77 68 69 6c 65 20 61 20 77 72 69 74 65 ed while a write
370f0 2d 74 72 61 6e 73 61 63 74 69 6f 6e 20 69 73 20 -transaction is
37100 61 63 74 69 76 65 20 69 6e 0a 2a 2a 20 72 6f 6c active in.** rol
37110 6c 62 61 63 6b 2e 20 49 66 20 74 68 65 20 63 6f lback. If the co
37120 6e 6e 65 63 74 69 6f 6e 20 69 73 20 69 6e 20 57 nnection is in W
37130 41 4c 20 6d 6f 64 65 2c 20 74 68 69 73 20 63 61 AL mode, this ca
37140 6c 6c 20 69 73 20 61 20 6e 6f 2d 6f 70 2e 20 0a ll is a no-op. .
37150 2a 2a 20 4f 74 68 65 72 77 69 73 65 2c 20 69 66 ** Otherwise, if
37160 20 74 68 65 20 63 6f 6e 6e 65 63 74 69 6f 6e 20 the connection
37170 64 6f 65 73 20 6e 6f 74 20 61 6c 72 65 61 64 79 does not already
37180 20 68 61 76 65 20 61 6e 20 45 58 43 4c 55 53 49 have an EXCLUSI
37190 56 45 20 6c 6f 63 6b 20 6f 6e 20 0a 2a 2a 20 74 VE lock on .** t
371a0 68 65 20 64 61 74 61 62 61 73 65 20 66 69 6c 65 he database file
371b0 2c 20 61 6e 20 61 74 74 65 6d 70 74 20 69 73 20 , an attempt is
371c0 6d 61 64 65 20 74 6f 20 6f 62 74 61 69 6e 20 6f made to obtain o
371d0 6e 65 2e 0a 2a 2a 0a 2a 2a 20 49 66 20 74 68 65 ne..**.** If the
371e0 20 45 58 43 4c 55 53 49 56 45 20 6c 6f 63 6b 20 EXCLUSIVE lock
371f0 69 73 20 61 6c 72 65 61 64 79 20 68 65 6c 64 20 is already held
37200 6f 72 20 74 68 65 20 61 74 74 65 6d 70 74 20 74 or the attempt t
37210 6f 20 6f 62 74 61 69 6e 20 69 74 20 69 73 0a 2a o obtain it is.*
37220 2a 20 73 75 63 63 65 73 73 66 75 6c 2c 20 6f 72 * successful, or
37230 20 74 68 65 20 63 6f 6e 6e 65 63 74 69 6f 6e 20 the connection
37240 69 73 20 69 6e 20 57 41 4c 20 6d 6f 64 65 2c 20 is in WAL mode,
37250 53 51 4c 49 54 45 5f 4f 4b 20 69 73 20 72 65 74 SQLITE_OK is ret
37260 75 72 6e 65 64 2e 0a 2a 2a 20 4f 74 68 65 72 77 urned..** Otherw
37270 69 73 65 2c 20 65 69 74 68 65 72 20 53 51 4c 49 ise, either SQLI
37280 54 45 5f 42 55 53 59 20 6f 72 20 61 6e 20 53 51 TE_BUSY or an SQ
37290 4c 49 54 45 5f 49 4f 45 52 52 5f 58 58 58 20 65 LITE_IOERR_XXX e
372a0 72 72 6f 72 20 63 6f 64 65 20 69 73 20 0a 2a 2a rror code is .**
372b0 20 72 65 74 75 72 6e 65 64 2e 0a 2a 2f 0a 69 6e returned..*/.in
372c0 74 20 73 71 6c 69 74 65 33 50 61 67 65 72 45 78 t sqlite3PagerEx
372d0 63 6c 75 73 69 76 65 4c 6f 63 6b 28 50 61 67 65 clusiveLock(Page
372e0 72 20 2a 70 50 61 67 65 72 29 7b 0a 20 20 69 6e r *pPager){. in
372f0 74 20 72 63 20 3d 20 53 51 4c 49 54 45 5f 4f 4b t rc = SQLITE_OK
37300 3b 0a 20 20 61 73 73 65 72 74 28 20 70 50 61 67 ;. assert( pPag
37310 65 72 2d 3e 65 53 74 61 74 65 3d 3d 50 41 47 45 er->eState==PAGE
37320 52 5f 57 52 49 54 45 52 5f 43 41 43 48 45 4d 4f R_WRITER_CACHEMO
37330 44 20 0a 20 20 20 20 20 20 20 7c 7c 20 70 50 61 D . || pPa
37340 67 65 72 2d 3e 65 53 74 61 74 65 3d 3d 50 41 47 ger->eState==PAG
37350 45 52 5f 57 52 49 54 45 52 5f 44 42 4d 4f 44 20 ER_WRITER_DBMOD
37360 0a 20 20 20 20 20 20 20 7c 7c 20 70 50 61 67 65 . || pPage
37370 72 2d 3e 65 53 74 61 74 65 3d 3d 50 41 47 45 52 r->eState==PAGER
37380 5f 57 52 49 54 45 52 5f 4c 4f 43 4b 45 44 20 0a _WRITER_LOCKED .
37390 20 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 61 );. assert( a
373a0 73 73 65 72 74 5f 70 61 67 65 72 5f 73 74 61 74 ssert_pager_stat
373b0 65 28 70 50 61 67 65 72 29 20 29 3b 0a 20 20 69 e(pPager) );. i
373c0 66 28 20 30 3d 3d 70 61 67 65 72 55 73 65 57 61 f( 0==pagerUseWa
373d0 6c 28 70 50 61 67 65 72 29 20 29 7b 0a 20 20 20 l(pPager) ){.
373e0 20 72 63 20 3d 20 70 61 67 65 72 5f 77 61 69 74 rc = pager_wait
373f0 5f 6f 6e 5f 6c 6f 63 6b 28 70 50 61 67 65 72 2c _on_lock(pPager,
37400 20 45 58 43 4c 55 53 49 56 45 5f 4c 4f 43 4b 29 EXCLUSIVE_LOCK)
37410 3b 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e 20 72 ;. }. return r
37420 63 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 53 79 6e 63 c;.}../*.** Sync
37430 20 74 68 65 20 64 61 74 61 62 61 73 65 20 66 69 the database fi
37440 6c 65 20 66 6f 72 20 74 68 65 20 70 61 67 65 72 le for the pager
37450 20 70 50 61 67 65 72 2e 20 7a 4d 61 73 74 65 72 pPager. zMaster
37460 20 70 6f 69 6e 74 73 20 74 6f 20 74 68 65 20 6e points to the n
37470 61 6d 65 0a 2a 2a 20 6f 66 20 61 20 6d 61 73 74 ame.** of a mast
37480 65 72 20 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 20 er journal file
37490 74 68 61 74 20 73 68 6f 75 6c 64 20 62 65 20 77 that should be w
374a0 72 69 74 74 65 6e 20 69 6e 74 6f 20 74 68 65 20 ritten into the
374b0 69 6e 64 69 76 69 64 75 61 6c 0a 2a 2a 20 6a 6f individual.** jo
374c0 75 72 6e 61 6c 20 66 69 6c 65 2e 20 7a 4d 61 73 urnal file. zMas
374d0 74 65 72 20 6d 61 79 20 62 65 20 4e 55 4c 4c 2c ter may be NULL,
374e0 20 77 68 69 63 68 20 69 73 20 69 6e 74 65 72 70 which is interp
374f0 72 65 74 65 64 20 61 73 20 6e 6f 20 6d 61 73 74 reted as no mast
37500 65 72 0a 2a 2a 20 6a 6f 75 72 6e 61 6c 20 28 61 er.** journal (a
37510 20 73 69 6e 67 6c 65 20 64 61 74 61 62 61 73 65 single database
37520 20 74 72 61 6e 73 61 63 74 69 6f 6e 29 2e 0a 2a transaction)..*
37530 2a 0a 2a 2a 20 54 68 69 73 20 72 6f 75 74 69 6e *.** This routin
37540 65 20 65 6e 73 75 72 65 73 20 74 68 61 74 3a 0a e ensures that:.
37550 2a 2a 0a 2a 2a 20 20 20 2a 20 54 68 65 20 64 61 **.** * The da
37560 74 61 62 61 73 65 20 66 69 6c 65 20 63 68 61 6e tabase file chan
37570 67 65 2d 63 6f 75 6e 74 65 72 20 69 73 20 75 70 ge-counter is up
37580 64 61 74 65 64 2c 0a 2a 2a 20 20 20 2a 20 74 68 dated,.** * th
37590 65 20 6a 6f 75 72 6e 61 6c 20 69 73 20 73 79 6e e journal is syn
375a0 63 65 64 20 28 75 6e 6c 65 73 73 20 74 68 65 20 ced (unless the
375b0 61 74 6f 6d 69 63 2d 77 72 69 74 65 20 6f 70 74 atomic-write opt
375c0 69 6d 69 7a 61 74 69 6f 6e 20 69 73 20 75 73 65 imization is use
375d0 64 29 2c 0a 2a 2a 20 20 20 2a 20 61 6c 6c 20 64 d),.** * all d
375e0 69 72 74 79 20 70 61 67 65 73 20 61 72 65 20 77 irty pages are w
375f0 72 69 74 74 65 6e 20 74 6f 20 74 68 65 20 64 61 ritten to the da
37600 74 61 62 61 73 65 20 66 69 6c 65 2c 20 0a 2a 2a tabase file, .**
37610 20 20 20 2a 20 74 68 65 20 64 61 74 61 62 61 73 * the databas
37620 65 20 66 69 6c 65 20 69 73 20 74 72 75 6e 63 61 e file is trunca
37630 74 65 64 20 28 69 66 20 72 65 71 75 69 72 65 64 ted (if required
37640 29 2c 20 61 6e 64 0a 2a 2a 20 20 20 2a 20 74 68 ), and.** * th
37650 65 20 64 61 74 61 62 61 73 65 20 66 69 6c 65 20 e database file
37660 73 79 6e 63 65 64 2e 20 0a 2a 2a 0a 2a 2a 20 54 synced. .**.** T
37670 68 65 20 6f 6e 6c 79 20 74 68 69 6e 67 20 74 68 he only thing th
37680 61 74 20 72 65 6d 61 69 6e 73 20 74 6f 20 63 6f at remains to co
37690 6d 6d 69 74 20 74 68 65 20 74 72 61 6e 73 61 63 mmit the transac
376a0 74 69 6f 6e 20 69 73 20 74 6f 20 66 69 6e 61 6c tion is to final
376b0 69 7a 65 20 0a 2a 2a 20 28 64 65 6c 65 74 65 2c ize .** (delete,
376c0 20 74 72 75 6e 63 61 74 65 20 6f 72 20 7a 65 72 truncate or zer
376d0 6f 20 74 68 65 20 66 69 72 73 74 20 70 61 72 74 o the first part
376e0 20 6f 66 29 20 74 68 65 20 6a 6f 75 72 6e 61 6c of) the journal
376f0 20 66 69 6c 65 20 28 6f 72 20 0a 2a 2a 20 64 65 file (or .** de
37700 6c 65 74 65 20 74 68 65 20 6d 61 73 74 65 72 20 lete the master
37710 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 20 69 66 20 journal file if
37720 73 70 65 63 69 66 69 65 64 29 2e 0a 2a 2a 0a 2a specified)..**.*
37730 2a 20 4e 6f 74 65 20 74 68 61 74 20 69 66 20 7a * Note that if z
37740 4d 61 73 74 65 72 3d 3d 4e 55 4c 4c 2c 20 74 68 Master==NULL, th
37750 69 73 20 64 6f 65 73 20 6e 6f 74 20 6f 76 65 72 is does not over
37760 77 72 69 74 65 20 61 20 70 72 65 76 69 6f 75 73 write a previous
37770 20 76 61 6c 75 65 0a 2a 2a 20 70 61 73 73 65 64 value.** passed
37780 20 74 6f 20 61 6e 20 73 71 6c 69 74 65 33 50 61 to an sqlite3Pa
37790 67 65 72 43 6f 6d 6d 69 74 50 68 61 73 65 4f 6e gerCommitPhaseOn
377a0 65 28 29 20 63 61 6c 6c 2e 0a 2a 2a 0a 2a 2a 20 e() call..**.**
377b0 49 66 20 74 68 65 20 66 69 6e 61 6c 20 70 61 72 If the final par
377c0 61 6d 65 74 65 72 20 2d 20 6e 6f 53 79 6e 63 20 ameter - noSync
377d0 2d 20 69 73 20 74 72 75 65 2c 20 74 68 65 6e 20 - is true, then
377e0 74 68 65 20 64 61 74 61 62 61 73 65 20 66 69 6c the database fil
377f0 65 20 69 74 73 65 6c 66 0a 2a 2a 20 69 73 20 6e e itself.** is n
37800 6f 74 20 73 79 6e 63 65 64 2e 20 54 68 65 20 63 ot synced. The c
37810 61 6c 6c 65 72 20 6d 75 73 74 20 63 61 6c 6c 20 aller must call
37820 73 71 6c 69 74 65 33 50 61 67 65 72 53 79 6e 63 sqlite3PagerSync
37830 28 29 20 64 69 72 65 63 74 6c 79 20 74 6f 0a 2a () directly to.*
37840 2a 20 73 79 6e 63 20 74 68 65 20 64 61 74 61 62 * sync the datab
37850 61 73 65 20 66 69 6c 65 20 62 65 66 6f 72 65 20 ase file before
37860 63 61 6c 6c 69 6e 67 20 43 6f 6d 6d 69 74 50 68 calling CommitPh
37870 61 73 65 54 77 6f 28 29 20 74 6f 20 64 65 6c 65 aseTwo() to dele
37880 74 65 20 74 68 65 0a 2a 2a 20 6a 6f 75 72 6e 61 te the.** journa
37890 6c 20 66 69 6c 65 20 69 6e 20 74 68 69 73 20 63 l file in this c
378a0 61 73 65 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 ase..*/.int sqli
378b0 74 65 33 50 61 67 65 72 43 6f 6d 6d 69 74 50 68 te3PagerCommitPh
378c0 61 73 65 4f 6e 65 28 0a 20 20 50 61 67 65 72 20 aseOne(. Pager
378d0 2a 70 50 61 67 65 72 2c 20 20 20 20 20 20 20 20 *pPager,
378e0 20 20 20 20 20 20 20 20 20 20 2f 2a 20 50 61 67 /* Pag
378f0 65 72 20 6f 62 6a 65 63 74 20 2a 2f 0a 20 20 63 er object */. c
37900 6f 6e 73 74 20 63 68 61 72 20 2a 7a 4d 61 73 74 onst char *zMast
37910 65 72 2c 20 20 20 20 20 20 20 20 20 20 20 20 2f er, /
37920 2a 20 49 66 20 6e 6f 74 20 4e 55 4c 4c 2c 20 74 * If not NULL, t
37930 68 65 20 6d 61 73 74 65 72 20 6a 6f 75 72 6e 61 he master journa
37940 6c 20 6e 61 6d 65 20 2a 2f 0a 20 20 69 6e 74 20 l name */. int
37950 6e 6f 53 79 6e 63 20 20 20 20 20 20 20 20 20 20 noSync
37960 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 54 /* T
37970 72 75 65 20 74 6f 20 6f 6d 69 74 20 74 68 65 20 rue to omit the
37980 78 53 79 6e 63 20 6f 6e 20 74 68 65 20 64 62 20 xSync on the db
37990 66 69 6c 65 20 2a 2f 0a 29 7b 0a 20 20 69 6e 74 file */.){. int
379a0 20 72 63 20 3d 20 53 51 4c 49 54 45 5f 4f 4b 3b rc = SQLITE_OK;
379b0 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 /*
379c0 52 65 74 75 72 6e 20 63 6f 64 65 20 2a 2f 0a 0a Return code */..
379d0 20 20 61 73 73 65 72 74 28 20 70 50 61 67 65 72 assert( pPager
379e0 2d 3e 65 53 74 61 74 65 3d 3d 50 41 47 45 52 5f ->eState==PAGER_
379f0 57 52 49 54 45 52 5f 4c 4f 43 4b 45 44 0a 20 20 WRITER_LOCKED.
37a00 20 20 20 20 20 7c 7c 20 70 50 61 67 65 72 2d 3e || pPager->
37a10 65 53 74 61 74 65 3d 3d 50 41 47 45 52 5f 57 52 eState==PAGER_WR
37a20 49 54 45 52 5f 43 41 43 48 45 4d 4f 44 0a 20 20 ITER_CACHEMOD.
37a30 20 20 20 20 20 7c 7c 20 70 50 61 67 65 72 2d 3e || pPager->
37a40 65 53 74 61 74 65 3d 3d 50 41 47 45 52 5f 57 52 eState==PAGER_WR
37a50 49 54 45 52 5f 44 42 4d 4f 44 0a 20 20 20 20 20 ITER_DBMOD.
37a60 20 20 7c 7c 20 70 50 61 67 65 72 2d 3e 65 53 74 || pPager->eSt
37a70 61 74 65 3d 3d 50 41 47 45 52 5f 45 52 52 4f 52 ate==PAGER_ERROR
37a80 0a 20 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 . );. assert(
37a90 61 73 73 65 72 74 5f 70 61 67 65 72 5f 73 74 61 assert_pager_sta
37aa0 74 65 28 70 50 61 67 65 72 29 20 29 3b 0a 0a 20 te(pPager) );..
37ab0 20 2f 2a 20 49 66 20 61 20 70 72 69 6f 72 20 65 /* If a prior e
37ac0 72 72 6f 72 20 6f 63 63 75 72 72 65 64 2c 20 72 rror occurred, r
37ad0 65 70 6f 72 74 20 74 68 61 74 20 65 72 72 6f 72 eport that error
37ae0 20 61 67 61 69 6e 2e 20 2a 2f 0a 20 20 69 66 28 again. */. if(
37af0 20 4e 45 56 45 52 28 70 50 61 67 65 72 2d 3e 65 NEVER(pPager->e
37b00 72 72 43 6f 64 65 29 20 29 20 72 65 74 75 72 6e rrCode) ) return
37b10 20 70 50 61 67 65 72 2d 3e 65 72 72 43 6f 64 65 pPager->errCode
37b20 3b 0a 0a 20 20 50 41 47 45 52 54 52 41 43 45 28 ;.. PAGERTRACE(
37b30 28 22 44 41 54 41 42 41 53 45 20 53 59 4e 43 3a ("DATABASE SYNC:
37b40 20 46 69 6c 65 3d 25 73 20 7a 4d 61 73 74 65 72 File=%s zMaster
37b50 3d 25 73 20 6e 53 69 7a 65 3d 25 64 5c 6e 22 2c =%s nSize=%d\n",
37b60 20 0a 20 20 20 20 20 20 70 50 61 67 65 72 2d 3e . pPager->
37b70 7a 46 69 6c 65 6e 61 6d 65 2c 20 7a 4d 61 73 74 zFilename, zMast
37b80 65 72 2c 20 70 50 61 67 65 72 2d 3e 64 62 53 69 er, pPager->dbSi
37b90 7a 65 29 29 3b 0a 0a 20 20 2f 2a 20 49 66 20 6e ze));.. /* If n
37ba0 6f 20 64 61 74 61 62 61 73 65 20 63 68 61 6e 67 o database chang
37bb0 65 73 20 68 61 76 65 20 62 65 65 6e 20 6d 61 64 es have been mad
37bc0 65 2c 20 72 65 74 75 72 6e 20 65 61 72 6c 79 2e e, return early.
37bd0 20 2a 2f 0a 20 20 69 66 28 20 70 50 61 67 65 72 */. if( pPager
37be0 2d 3e 65 53 74 61 74 65 3c 50 41 47 45 52 5f 57 ->eState<PAGER_W
37bf0 52 49 54 45 52 5f 43 41 43 48 45 4d 4f 44 20 29 RITER_CACHEMOD )
37c00 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f return SQLITE_O
37c10 4b 3b 0a 0a 20 20 69 66 28 20 4d 45 4d 44 42 20 K;.. if( MEMDB
37c20 29 7b 0a 20 20 20 20 2f 2a 20 49 66 20 74 68 69 ){. /* If thi
37c30 73 20 69 73 20 61 6e 20 69 6e 2d 6d 65 6d 6f 72 s is an in-memor
37c40 79 20 64 62 2c 20 6f 72 20 6e 6f 20 70 61 67 65 y db, or no page
37c50 73 20 68 61 76 65 20 62 65 65 6e 20 77 72 69 74 s have been writ
37c60 74 65 6e 20 74 6f 2c 20 6f 72 20 74 68 69 73 0a ten to, or this.
37c70 20 20 20 20 2a 2a 20 66 75 6e 63 74 69 6f 6e 20 ** function
37c80 68 61 73 20 61 6c 72 65 61 64 79 20 62 65 65 6e has already been
37c90 20 63 61 6c 6c 65 64 2c 20 69 74 20 69 73 20 6d called, it is m
37ca0 6f 73 74 6c 79 20 61 20 6e 6f 2d 6f 70 2e 20 20 ostly a no-op.
37cb0 48 6f 77 65 76 65 72 2c 20 61 6e 79 0a 20 20 20 However, any.
37cc0 20 2a 2a 20 62 61 63 6b 75 70 20 69 6e 20 70 72 ** backup in pr
37cd0 6f 67 72 65 73 73 20 6e 65 65 64 73 20 74 6f 20 ogress needs to
37ce0 62 65 20 72 65 73 74 61 72 74 65 64 2e 0a 20 20 be restarted..
37cf0 20 20 2a 2f 0a 20 20 20 20 73 71 6c 69 74 65 33 */. sqlite3
37d00 42 61 63 6b 75 70 52 65 73 74 61 72 74 28 70 50 BackupRestart(pP
37d10 61 67 65 72 2d 3e 70 42 61 63 6b 75 70 29 3b 0a ager->pBackup);.
37d20 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 69 66 28 }else{. if(
37d30 20 70 61 67 65 72 55 73 65 57 61 6c 28 70 50 61 pagerUseWal(pPa
37d40 67 65 72 29 20 29 7b 0a 20 20 20 20 20 20 50 67 ger) ){. Pg
37d50 48 64 72 20 2a 70 4c 69 73 74 20 3d 20 73 71 6c Hdr *pList = sql
37d60 69 74 65 33 50 63 61 63 68 65 44 69 72 74 79 4c ite3PcacheDirtyL
37d70 69 73 74 28 70 50 61 67 65 72 2d 3e 70 50 43 61 ist(pPager->pPCa
37d80 63 68 65 29 3b 0a 20 20 20 20 20 20 50 67 48 64 che);. PgHd
37d90 72 20 2a 70 50 61 67 65 4f 6e 65 20 3d 20 30 3b r *pPageOne = 0;
37da0 0a 20 20 20 20 20 20 69 66 28 20 70 4c 69 73 74 . if( pList
37db0 3d 3d 30 20 29 7b 0a 20 20 20 20 20 20 20 20 2f ==0 ){. /
37dc0 2a 20 4d 75 73 74 20 68 61 76 65 20 61 74 20 6c * Must have at l
37dd0 65 61 73 74 20 6f 6e 65 20 70 61 67 65 20 66 6f east one page fo
37de0 72 20 74 68 65 20 57 41 4c 20 63 6f 6d 6d 69 74 r the WAL commit
37df0 20 66 6c 61 67 2e 0a 20 20 20 20 20 20 20 20 2a flag.. *
37e00 2a 20 54 69 63 6b 65 74 20 5b 32 64 31 61 35 63 * Ticket [2d1a5c
37e10 36 37 64 66 63 32 33 36 33 65 34 34 66 32 39 64 67dfc2363e44f29d
37e20 39 62 62 64 35 37 66 5d 20 32 30 31 31 2d 30 35 9bbd57f] 2011-05
37e30 2d 31 38 20 2a 2f 0a 20 20 20 20 20 20 20 20 72 -18 */. r
37e40 63 20 3d 20 73 71 6c 69 74 65 33 50 61 67 65 72 c = sqlite3Pager
37e50 47 65 74 28 70 50 61 67 65 72 2c 20 31 2c 20 26 Get(pPager, 1, &
37e60 70 50 61 67 65 4f 6e 65 29 3b 0a 20 20 20 20 20 pPageOne);.
37e70 20 20 20 70 4c 69 73 74 20 3d 20 70 50 61 67 65 pList = pPage
37e80 4f 6e 65 3b 0a 20 20 20 20 20 20 20 20 70 4c 69 One;. pLi
37e90 73 74 2d 3e 70 44 69 72 74 79 20 3d 20 30 3b 0a st->pDirty = 0;.
37ea0 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 61 73 }. as
37eb0 73 65 72 74 28 20 72 63 3d 3d 53 51 4c 49 54 45 sert( rc==SQLITE
37ec0 5f 4f 4b 20 29 3b 0a 20 20 20 20 20 20 69 66 28 _OK );. if(
37ed0 20 41 4c 57 41 59 53 28 70 4c 69 73 74 29 20 29 ALWAYS(pList) )
37ee0 7b 0a 20 20 20 20 20 20 20 20 72 63 20 3d 20 70 {. rc = p
37ef0 61 67 65 72 57 61 6c 46 72 61 6d 65 73 28 70 50 agerWalFrames(pP
37f00 61 67 65 72 2c 20 70 4c 69 73 74 2c 20 70 50 61 ager, pList, pPa
37f10 67 65 72 2d 3e 64 62 53 69 7a 65 2c 20 31 2c 20 ger->dbSize, 1,
37f20 0a 20 20 20 20 20 20 20 20 20 20 20 20 28 70 50 . (pP
37f30 61 67 65 72 2d 3e 66 75 6c 6c 53 79 6e 63 20 3f ager->fullSync ?
37f40 20 70 50 61 67 65 72 2d 3e 73 79 6e 63 46 6c 61 pPager->syncFla
37f50 67 73 20 3a 20 30 29 0a 20 20 20 20 20 20 20 20 gs : 0).
37f60 29 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 20 );. }.
37f70 20 73 71 6c 69 74 65 33 50 61 67 65 72 55 6e 72 sqlite3PagerUnr
37f80 65 66 28 70 50 61 67 65 4f 6e 65 29 3b 0a 20 20 ef(pPageOne);.
37f90 20 20 20 20 69 66 28 20 72 63 3d 3d 53 51 4c 49 if( rc==SQLI
37fa0 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 20 20 20 TE_OK ){.
37fb0 20 73 71 6c 69 74 65 33 50 63 61 63 68 65 43 6c sqlite3PcacheCl
37fc0 65 61 6e 41 6c 6c 28 70 50 61 67 65 72 2d 3e 70 eanAll(pPager->p
37fd0 50 43 61 63 68 65 29 3b 0a 20 20 20 20 20 20 7d PCache);. }
37fe0 0a 20 20 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 . }else{.
37ff0 20 20 2f 2a 20 54 68 65 20 66 6f 6c 6c 6f 77 69 /* The followi
38000 6e 67 20 62 6c 6f 63 6b 20 75 70 64 61 74 65 73 ng block updates
38010 20 74 68 65 20 63 68 61 6e 67 65 2d 63 6f 75 6e the change-coun
38020 74 65 72 2e 20 45 78 61 63 74 6c 79 20 68 6f 77 ter. Exactly how
38030 20 69 74 0a 20 20 20 20 20 20 2a 2a 20 64 6f 65 it. ** doe
38040 73 20 74 68 69 73 20 64 65 70 65 6e 64 73 20 6f s this depends o
38050 6e 20 77 68 65 74 68 65 72 20 6f 72 20 6e 6f 74 n whether or not
38060 20 74 68 65 20 61 74 6f 6d 69 63 2d 75 70 64 61 the atomic-upda
38070 74 65 20 6f 70 74 69 6d 69 7a 61 74 69 6f 6e 0a te optimization.
38080 20 20 20 20 20 20 2a 2a 20 77 61 73 20 65 6e 61 ** was ena
38090 62 6c 65 64 20 61 74 20 63 6f 6d 70 69 6c 65 20 bled at compile
380a0 74 69 6d 65 2c 20 61 6e 64 20 69 66 20 74 68 69 time, and if thi
380b0 73 20 74 72 61 6e 73 61 63 74 69 6f 6e 20 6d 65 s transaction me
380c0 65 74 73 20 74 68 65 20 0a 20 20 20 20 20 20 2a ets the . *
380d0 2a 20 72 75 6e 74 69 6d 65 20 63 72 69 74 65 72 * runtime criter
380e0 69 61 20 74 6f 20 75 73 65 20 74 68 65 20 6f 70 ia to use the op
380f0 65 72 61 74 69 6f 6e 3a 20 0a 20 20 20 20 20 20 eration: .
38100 2a 2a 0a 20 20 20 20 20 20 2a 2a 20 20 20 20 2a **. ** *
38110 20 54 68 65 20 66 69 6c 65 2d 73 79 73 74 65 6d The file-system
38120 20 73 75 70 70 6f 72 74 73 20 74 68 65 20 61 74 supports the at
38130 6f 6d 69 63 2d 77 72 69 74 65 20 70 72 6f 70 65 omic-write prope
38140 72 74 79 20 66 6f 72 0a 20 20 20 20 20 20 2a 2a rty for. **
38150 20 20 20 20 20 20 62 6c 6f 63 6b 73 20 6f 66 20 blocks of
38160 73 69 7a 65 20 70 61 67 65 2d 73 69 7a 65 2c 20 size page-size,
38170 61 6e 64 20 0a 20 20 20 20 20 20 2a 2a 20 20 20 and . **
38180 20 2a 20 54 68 69 73 20 63 6f 6d 6d 69 74 20 69 * This commit i
38190 73 20 6e 6f 74 20 70 61 72 74 20 6f 66 20 61 20 s not part of a
381a0 6d 75 6c 74 69 2d 66 69 6c 65 20 74 72 61 6e 73 multi-file trans
381b0 61 63 74 69 6f 6e 2c 20 61 6e 64 0a 20 20 20 20 action, and.
381c0 20 20 2a 2a 20 20 20 20 2a 20 45 78 61 63 74 6c ** * Exactl
381d0 79 20 6f 6e 65 20 70 61 67 65 20 68 61 73 20 62 y one page has b
381e0 65 65 6e 20 6d 6f 64 69 66 69 65 64 20 61 6e 64 een modified and
381f0 20 73 74 6f 72 65 20 69 6e 20 74 68 65 20 6a 6f store in the jo
38200 75 72 6e 61 6c 20 66 69 6c 65 2e 0a 20 20 20 20 urnal file..
38210 20 20 2a 2a 0a 20 20 20 20 20 20 2a 2a 20 49 66 **. ** If
38220 20 74 68 65 20 6f 70 74 69 6d 69 7a 61 74 69 6f the optimizatio
38230 6e 20 77 61 73 20 6e 6f 74 20 65 6e 61 62 6c 65 n was not enable
38240 64 20 61 74 20 63 6f 6d 70 69 6c 65 20 74 69 6d d at compile tim
38250 65 2c 20 74 68 65 6e 20 74 68 65 0a 20 20 20 20 e, then the.
38260 20 20 2a 2a 20 70 61 67 65 72 5f 69 6e 63 72 5f ** pager_incr_
38270 63 68 61 6e 67 65 63 6f 75 6e 74 65 72 28 29 20 changecounter()
38280 66 75 6e 63 74 69 6f 6e 20 69 73 20 63 61 6c 6c function is call
38290 65 64 20 74 6f 20 75 70 64 61 74 65 20 74 68 65 ed to update the
382a0 20 63 68 61 6e 67 65 0a 20 20 20 20 20 20 2a 2a change. **
382b0 20 63 6f 75 6e 74 65 72 20 69 6e 20 27 69 6e 64 counter in 'ind
382c0 69 72 65 63 74 2d 6d 6f 64 65 27 2e 20 49 66 20 irect-mode'. If
382d0 74 68 65 20 6f 70 74 69 6d 69 7a 61 74 69 6f 6e the optimization
382e0 20 69 73 20 63 6f 6d 70 69 6c 65 64 20 69 6e 20 is compiled in
382f0 62 75 74 0a 20 20 20 20 20 20 2a 2a 20 69 73 20 but. ** is
38300 6e 6f 74 20 61 70 70 6c 69 63 61 62 6c 65 20 74 not applicable t
38310 6f 20 74 68 69 73 20 74 72 61 6e 73 61 63 74 69 o this transacti
38320 6f 6e 2c 20 63 61 6c 6c 20 73 71 6c 69 74 65 33 on, call sqlite3
38330 4a 6f 75 72 6e 61 6c 43 72 65 61 74 65 28 29 0a JournalCreate().
38340 20 20 20 20 20 20 2a 2a 20 74 6f 20 6d 61 6b 65 ** to make
38350 20 73 75 72 65 20 74 68 65 20 6a 6f 75 72 6e 61 sure the journa
38360 6c 20 66 69 6c 65 20 68 61 73 20 61 63 74 75 61 l file has actua
38370 6c 6c 79 20 62 65 65 6e 20 63 72 65 61 74 65 64 lly been created
38380 2c 20 74 68 65 6e 20 63 61 6c 6c 0a 20 20 20 20 , then call.
38390 20 20 2a 2a 20 70 61 67 65 72 5f 69 6e 63 72 5f ** pager_incr_
383a0 63 68 61 6e 67 65 63 6f 75 6e 74 65 72 28 29 20 changecounter()
383b0 74 6f 20 75 70 64 61 74 65 20 74 68 65 20 63 68 to update the ch
383c0 61 6e 67 65 2d 63 6f 75 6e 74 65 72 20 69 6e 20 ange-counter in
383d0 69 6e 64 69 72 65 63 74 0a 20 20 20 20 20 20 2a indirect. *
383e0 2a 20 6d 6f 64 65 2e 20 0a 20 20 20 20 20 20 2a * mode. . *
383f0 2a 0a 20 20 20 20 20 20 2a 2a 20 4f 74 68 65 72 *. ** Other
38400 77 69 73 65 2c 20 69 66 20 74 68 65 20 6f 70 74 wise, if the opt
38410 69 6d 69 7a 61 74 69 6f 6e 20 69 73 20 62 6f 74 imization is bot
38420 68 20 65 6e 61 62 6c 65 64 20 61 6e 64 20 61 70 h enabled and ap
38430 70 6c 69 63 61 62 6c 65 2c 0a 20 20 20 20 20 20 plicable,.
38440 2a 2a 20 74 68 65 6e 20 63 61 6c 6c 20 70 61 67 ** then call pag
38450 65 72 5f 69 6e 63 72 5f 63 68 61 6e 67 65 63 6f er_incr_changeco
38460 75 6e 74 65 72 28 29 20 74 6f 20 75 70 64 61 74 unter() to updat
38470 65 20 74 68 65 20 63 68 61 6e 67 65 2d 63 6f 75 e the change-cou
38480 6e 74 65 72 0a 20 20 20 20 20 20 2a 2a 20 69 6e nter. ** in
38490 20 27 64 69 72 65 63 74 27 20 6d 6f 64 65 2e 20 'direct' mode.
384a0 49 6e 20 74 68 69 73 20 63 61 73 65 20 74 68 65 In this case the
384b0 20 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 20 77 69 journal file wi
384c0 6c 6c 20 6e 65 76 65 72 20 62 65 0a 20 20 20 20 ll never be.
384d0 20 20 2a 2a 20 63 72 65 61 74 65 64 20 66 6f 72 ** created for
384e0 20 74 68 69 73 20 74 72 61 6e 73 61 63 74 69 6f this transactio
384f0 6e 2e 0a 20 20 20 20 20 20 2a 2f 0a 20 20 23 69 n.. */. #i
38500 66 64 65 66 20 53 51 4c 49 54 45 5f 45 4e 41 42 fdef SQLITE_ENAB
38510 4c 45 5f 41 54 4f 4d 49 43 5f 57 52 49 54 45 0a LE_ATOMIC_WRITE.
38520 20 20 20 20 20 20 50 67 48 64 72 20 2a 70 50 67 PgHdr *pPg
38530 3b 0a 20 20 20 20 20 20 61 73 73 65 72 74 28 20 ;. assert(
38540 69 73 4f 70 65 6e 28 70 50 61 67 65 72 2d 3e 6a isOpen(pPager->j
38550 66 64 29 20 0a 20 20 20 20 20 20 20 20 20 20 20 fd) .
38560 7c 7c 20 70 50 61 67 65 72 2d 3e 6a 6f 75 72 6e || pPager->journ
38570 61 6c 4d 6f 64 65 3d 3d 50 41 47 45 52 5f 4a 4f alMode==PAGER_JO
38580 55 52 4e 41 4c 4d 4f 44 45 5f 4f 46 46 20 0a 20 URNALMODE_OFF .
38590 20 20 20 20 20 20 20 20 20 20 7c 7c 20 70 50 61 || pPa
385a0 67 65 72 2d 3e 6a 6f 75 72 6e 61 6c 4d 6f 64 65 ger->journalMode
385b0 3d 3d 50 41 47 45 52 5f 4a 4f 55 52 4e 41 4c 4d ==PAGER_JOURNALM
385c0 4f 44 45 5f 57 41 4c 20 0a 20 20 20 20 20 20 29 ODE_WAL . )
385d0 3b 0a 20 20 20 20 20 20 69 66 28 20 21 7a 4d 61 ;. if( !zMa
385e0 73 74 65 72 20 26 26 20 69 73 4f 70 65 6e 28 70 ster && isOpen(p
385f0 50 61 67 65 72 2d 3e 6a 66 64 29 20 0a 20 20 20 Pager->jfd) .
38600 20 20 20 20 26 26 20 70 50 61 67 65 72 2d 3e 6a && pPager->j
38610 6f 75 72 6e 61 6c 4f 66 66 3d 3d 6a 72 6e 6c 42 ournalOff==jrnlB
38620 75 66 66 65 72 53 69 7a 65 28 70 50 61 67 65 72 ufferSize(pPager
38630 29 20 0a 20 20 20 20 20 20 20 26 26 20 70 50 61 ) . && pPa
38640 67 65 72 2d 3e 64 62 53 69 7a 65 3e 3d 70 50 61 ger->dbSize>=pPa
38650 67 65 72 2d 3e 64 62 4f 72 69 67 53 69 7a 65 0a ger->dbOrigSize.
38660 20 20 20 20 20 20 20 26 26 20 28 30 3d 3d 28 70 && (0==(p
38670 50 67 20 3d 20 73 71 6c 69 74 65 33 50 63 61 63 Pg = sqlite3Pcac
38680 68 65 44 69 72 74 79 4c 69 73 74 28 70 50 61 67 heDirtyList(pPag
38690 65 72 2d 3e 70 50 43 61 63 68 65 29 29 20 7c 7c er->pPCache)) ||
386a0 20 30 3d 3d 70 50 67 2d 3e 70 44 69 72 74 79 29 0==pPg->pDirty)
386b0 0a 20 20 20 20 20 20 29 7b 0a 20 20 20 20 20 20 . ){.
386c0 20 20 2f 2a 20 55 70 64 61 74 65 20 74 68 65 20 /* Update the
386d0 64 62 20 66 69 6c 65 20 63 68 61 6e 67 65 20 63 db file change c
386e0 6f 75 6e 74 65 72 20 76 69 61 20 74 68 65 20 64 ounter via the d
386f0 69 72 65 63 74 2d 77 72 69 74 6