0000: 2f 2a 0a 2a 2a 20 32 30 30 31 20 53 65 70 74 65 /*.** 2001 Septe
0010: 6d 62 65 72 20 31 35 0a 2a 2a 0a 2a 2a 20 54 68 mber 15.**.** Th
0020: 65 20 61 75 74 68 6f 72 20 64 69 73 63 6c 61 69 e author disclai
0030: 6d 73 20 63 6f 70 79 72 69 67 68 74 20 74 6f 20 ms copyright to
0040: 74 68 69 73 20 73 6f 75 72 63 65 20 63 6f 64 65 this source code
0050: 2e 20 20 49 6e 20 70 6c 61 63 65 20 6f 66 0a 2a . In place of.*
0060: 2a 20 61 20 6c 65 67 61 6c 20 6e 6f 74 69 63 65 * a legal notice
0070: 2c 20 68 65 72 65 20 69 73 20 61 20 62 6c 65 73 , here is a bles
0080: 73 69 6e 67 3a 0a 2a 2a 0a 2a 2a 20 20 20 20 4d sing:.**.** M
0090: 61 79 20 79 6f 75 20 64 6f 20 67 6f 6f 64 20 61 ay you do good a
00a0: 6e 64 20 6e 6f 74 20 65 76 69 6c 2e 0a 2a 2a 20 nd not evil..**
00b0: 20 20 20 4d 61 79 20 79 6f 75 20 66 69 6e 64 20 May you find
00c0: 66 6f 72 67 69 76 65 6e 65 73 73 20 66 6f 72 20 forgiveness for
00d0: 79 6f 75 72 73 65 6c 66 20 61 6e 64 20 66 6f 72 yourself and for
00e0: 67 69 76 65 20 6f 74 68 65 72 73 2e 0a 2a 2a 20 give others..**
00f0: 20 20 20 4d 61 79 20 79 6f 75 20 73 68 61 72 65 May you share
0100: 20 66 72 65 65 6c 79 2c 20 6e 65 76 65 72 20 74 freely, never t
0110: 61 6b 69 6e 67 20 6d 6f 72 65 20 74 68 61 6e 20 aking more than
0120: 79 6f 75 20 67 69 76 65 2e 0a 2a 2a 0a 2a 2a 2a you give..**.***
0130: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
0140: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
0150: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
0160: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
0170: 2a 2a 2a 2a 2a 2a 0a 2a 2a 20 54 68 69 73 20 69 ******.** This i
0180: 73 20 74 68 65 20 69 6d 70 6c 65 6d 65 6e 74 61 s the implementa
0190: 74 69 6f 6e 20 6f 66 20 74 68 65 20 70 61 67 65 tion of the page
01a0: 20 63 61 63 68 65 20 73 75 62 73 79 73 74 65 6d cache subsystem
01b0: 20 6f 72 20 22 70 61 67 65 72 22 2e 0a 2a 2a 20 or "pager"..**
01c0: 0a 2a 2a 20 54 68 65 20 70 61 67 65 72 20 69 73 .** The pager is
01d0: 20 75 73 65 64 20 74 6f 20 61 63 63 65 73 73 20 used to access
01e0: 61 20 64 61 74 61 62 61 73 65 20 64 69 73 6b 20 a database disk
01f0: 66 69 6c 65 2e 20 20 49 74 20 69 6d 70 6c 65 6d file. It implem
0200: 65 6e 74 73 0a 2a 2a 20 61 74 6f 6d 69 63 20 63 ents.** atomic c
0210: 6f 6d 6d 69 74 20 61 6e 64 20 72 6f 6c 6c 62 61 ommit and rollba
0220: 63 6b 20 74 68 72 6f 75 67 68 20 74 68 65 20 75 ck through the u
0230: 73 65 20 6f 66 20 61 20 6a 6f 75 72 6e 61 6c 20 se of a journal
0240: 66 69 6c 65 20 74 68 61 74 0a 2a 2a 20 69 73 20 file that.** is
0250: 73 65 70 61 72 61 74 65 20 66 72 6f 6d 20 74 68 separate from th
0260: 65 20 64 61 74 61 62 61 73 65 20 66 69 6c 65 2e e database file.
0270: 20 20 54 68 65 20 70 61 67 65 72 20 61 6c 73 6f The pager also
0280: 20 69 6d 70 6c 65 6d 65 6e 74 73 20 66 69 6c 65 implements file
0290: 0a 2a 2a 20 6c 6f 63 6b 69 6e 67 20 74 6f 20 70 .** locking to p
02a0: 72 65 76 65 6e 74 20 74 77 6f 20 70 72 6f 63 65 revent two proce
02b0: 73 73 65 73 20 66 72 6f 6d 20 77 72 69 74 69 6e sses from writin
02c0: 67 20 74 68 65 20 73 61 6d 65 20 64 61 74 61 62 g the same datab
02d0: 61 73 65 0a 2a 2a 20 66 69 6c 65 20 73 69 6d 75 ase.** file simu
02e0: 6c 74 61 6e 65 6f 75 73 6c 79 2c 20 6f 72 20 6f ltaneously, or o
02f0: 6e 65 20 70 72 6f 63 65 73 73 20 66 72 6f 6d 20 ne process from
0300: 72 65 61 64 69 6e 67 20 74 68 65 20 64 61 74 61 reading the data
0310: 62 61 73 65 20 77 68 69 6c 65 0a 2a 2a 20 61 6e base while.** an
0320: 6f 74 68 65 72 20 69 73 20 77 72 69 74 69 6e 67 other is writing
0330: 2e 0a 2a 2f 0a 23 69 66 6e 64 65 66 20 53 51 4c ..*/.#ifndef SQL
0340: 49 54 45 5f 4f 4d 49 54 5f 44 49 53 4b 49 4f 0a ITE_OMIT_DISKIO.
0350: 23 69 6e 63 6c 75 64 65 20 22 73 71 6c 69 74 65 #include "sqlite
0360: 49 6e 74 2e 68 22 0a 23 69 6e 63 6c 75 64 65 20 Int.h".#include
0370: 22 77 61 6c 2e 68 22 0a 0a 0a 2f 2a 2a 2a 2a 2a "wal.h".../*****
0380: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 20 4e ************** N
0390: 4f 54 45 53 20 4f 4e 20 54 48 45 20 44 45 53 49 OTES ON THE DESI
03a0: 47 4e 20 4f 46 20 54 48 45 20 50 41 47 45 52 20 GN OF THE PAGER
03b0: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
03c0: 2a 2a 2a 2a 2a 2a 2a 2a 0a 2a 2a 0a 2a 2a 20 54 ********.**.** T
03d0: 68 69 73 20 63 6f 6d 6d 65 6e 74 20 62 6c 6f 63 his comment bloc
03e0: 6b 20 64 65 73 63 72 69 62 65 73 20 69 6e 76 61 k describes inva
03f0: 72 69 61 6e 74 73 20 74 68 61 74 20 68 6f 6c 64 riants that hold
0400: 20 77 68 65 6e 20 75 73 69 6e 67 20 61 20 72 6f when using a ro
0410: 6c 6c 62 61 63 6b 0a 2a 2a 20 6a 6f 75 72 6e 61 llback.** journa
0420: 6c 2e 20 20 54 68 65 73 65 20 69 6e 76 61 72 69 l. These invari
0430: 61 6e 74 73 20 64 6f 20 6e 6f 74 20 61 70 70 6c ants do not appl
0440: 79 20 66 6f 72 20 6a 6f 75 72 6e 61 6c 5f 6d 6f y for journal_mo
0450: 64 65 3d 57 41 4c 2c 0a 2a 2a 20 6a 6f 75 72 6e de=WAL,.** journ
0460: 61 6c 5f 6d 6f 64 65 3d 4d 45 4d 4f 52 59 2c 20 al_mode=MEMORY,
0470: 6f 72 20 6a 6f 75 72 6e 61 6c 5f 6d 6f 64 65 3d or journal_mode=
0480: 4f 46 46 2e 0a 2a 2a 0a 2a 2a 20 57 69 74 68 69 OFF..**.** Withi
0490: 6e 20 74 68 69 73 20 63 6f 6d 6d 65 6e 74 20 62 n this comment b
04a0: 6c 6f 63 6b 2c 20 61 20 70 61 67 65 20 69 73 20 lock, a page is
04b0: 64 65 65 6d 65 64 20 74 6f 20 68 61 76 65 20 62 deemed to have b
04c0: 65 65 6e 20 73 79 6e 63 65 64 0a 2a 2a 20 61 75 een synced.** au
04d0: 74 6f 6d 61 74 69 63 61 6c 6c 79 20 61 73 20 73 tomatically as s
04e0: 6f 6f 6e 20 61 73 20 69 74 20 69 73 20 77 72 69 oon as it is wri
04f0: 74 74 65 6e 20 77 68 65 6e 20 50 52 41 47 4d 41 tten when PRAGMA
0500: 20 73 79 6e 63 68 72 6f 6e 6f 75 73 3d 4f 46 46 synchronous=OFF
0510: 2e 0a 2a 2a 20 4f 74 68 65 72 77 69 73 65 2c 20 ..** Otherwise,
0520: 74 68 65 20 70 61 67 65 20 69 73 20 6e 6f 74 20 the page is not
0530: 73 79 6e 63 65 64 20 75 6e 74 69 6c 20 74 68 65 synced until the
0540: 20 78 53 79 6e 63 20 6d 65 74 68 6f 64 20 6f 66 xSync method of
0550: 20 74 68 65 20 56 46 53 0a 2a 2a 20 69 73 20 63 the VFS.** is c
0560: 61 6c 6c 65 64 20 73 75 63 63 65 73 73 66 75 6c alled successful
0570: 6c 79 20 6f 6e 20 74 68 65 20 66 69 6c 65 20 63 ly on the file c
0580: 6f 6e 74 61 69 6e 69 6e 67 20 74 68 65 20 70 61 ontaining the pa
0590: 67 65 2e 0a 2a 2a 0a 2a 2a 20 44 65 66 69 6e 69 ge..**.** Defini
05a0: 74 69 6f 6e 3a 20 20 41 20 70 61 67 65 20 6f 66 tion: A page of
05b0: 20 74 68 65 20 64 61 74 61 62 61 73 65 20 66 69 the database fi
05c0: 6c 65 20 69 73 20 73 61 69 64 20 74 6f 20 62 65 le is said to be
05d0: 20 22 6f 76 65 72 77 72 69 74 65 61 62 6c 65 22 "overwriteable"
05e0: 20 69 66 0a 2a 2a 20 6f 6e 65 20 6f 72 20 6d 6f if.** one or mo
05f0: 72 65 20 6f 66 20 74 68 65 20 66 6f 6c 6c 6f 77 re of the follow
0600: 69 6e 67 20 61 72 65 20 74 72 75 65 20 61 62 6f ing are true abo
0610: 75 74 20 74 68 65 20 70 61 67 65 3a 0a 2a 2a 20 ut the page:.**
0620: 0a 2a 2a 20 20 20 20 20 28 61 29 20 20 54 68 65 .** (a) The
0630: 20 6f 72 69 67 69 6e 61 6c 20 63 6f 6e 74 65 6e original conten
0640: 74 20 6f 66 20 74 68 65 20 70 61 67 65 20 61 73 t of the page as
0650: 20 69 74 20 77 61 73 20 61 74 20 74 68 65 20 62 it was at the b
0660: 65 67 69 6e 6e 69 6e 67 20 6f 66 0a 2a 2a 20 20 eginning of.**
0670: 20 20 20 20 20 20 20 20 74 68 65 20 74 72 61 6e the tran
0680: 73 61 63 74 69 6f 6e 20 68 61 73 20 62 65 65 6e saction has been
0690: 20 77 72 69 74 74 65 6e 20 69 6e 74 6f 20 74 68 written into th
06a0: 65 20 72 6f 6c 6c 62 61 63 6b 20 6a 6f 75 72 6e e rollback journ
06b0: 61 6c 20 61 6e 64 0a 2a 2a 20 20 20 20 20 20 20 al and.**
06c0: 20 20 20 73 79 6e 63 65 64 2e 0a 2a 2a 20 0a 2a synced..** .*
06d0: 2a 20 20 20 20 20 28 62 29 20 20 54 68 65 20 70 * (b) The p
06e0: 61 67 65 20 77 61 73 20 61 20 66 72 65 65 6c 69 age was a freeli
06f0: 73 74 20 6c 65 61 66 20 70 61 67 65 20 61 74 20 st leaf page at
0700: 74 68 65 20 73 74 61 72 74 20 6f 66 20 74 68 65 the start of the
0710: 20 74 72 61 6e 73 61 63 74 69 6f 6e 2e 0a 2a 2a transaction..**
0720: 20 0a 2a 2a 20 20 20 20 20 28 63 29 20 20 54 68 .** (c) Th
0730: 65 20 70 61 67 65 20 6e 75 6d 62 65 72 20 69 73 e page number is
0740: 20 67 72 65 61 74 65 72 20 74 68 61 6e 20 74 68 greater than th
0750: 65 20 6c 61 72 67 65 73 74 20 70 61 67 65 20 74 e largest page t
0760: 68 61 74 20 65 78 69 73 74 65 64 20 69 6e 0a 2a hat existed in.*
0770: 2a 20 20 20 20 20 20 20 20 20 20 74 68 65 20 64 * the d
0780: 61 74 61 62 61 73 65 20 66 69 6c 65 20 61 74 20 atabase file at
0790: 74 68 65 20 73 74 61 72 74 20 6f 66 20 74 68 65 the start of the
07a0: 20 74 72 61 6e 73 61 63 74 69 6f 6e 2e 0a 2a 2a transaction..**
07b0: 20 0a 2a 2a 20 28 31 29 20 41 20 70 61 67 65 20 .** (1) A page
07c0: 6f 66 20 74 68 65 20 64 61 74 61 62 61 73 65 20 of the database
07d0: 66 69 6c 65 20 69 73 20 6e 65 76 65 72 20 6f 76 file is never ov
07e0: 65 72 77 72 69 74 74 65 6e 20 75 6e 6c 65 73 73 erwritten unless
07f0: 20 6f 6e 65 20 6f 66 20 74 68 65 0a 2a 2a 20 20 one of the.**
0800: 20 20 20 66 6f 6c 6c 6f 77 69 6e 67 20 61 72 65 following are
0810: 20 74 72 75 65 3a 0a 2a 2a 20 0a 2a 2a 20 20 20 true:.** .**
0820: 20 20 28 61 29 20 54 68 65 20 70 61 67 65 20 61 (a) The page a
0830: 6e 64 20 61 6c 6c 20 6f 74 68 65 72 20 70 61 67 nd all other pag
0840: 65 73 20 6f 6e 20 74 68 65 20 73 61 6d 65 20 73 es on the same s
0850: 65 63 74 6f 72 20 61 72 65 20 6f 76 65 72 77 72 ector are overwr
0860: 69 74 65 61 62 6c 65 2e 0a 2a 2a 20 0a 2a 2a 20 iteable..** .**
0870: 20 20 20 20 28 62 29 20 54 68 65 20 61 74 6f 6d (b) The atom
0880: 69 63 20 70 61 67 65 20 77 72 69 74 65 20 6f 70 ic page write op
0890: 74 69 6d 69 7a 61 74 69 6f 6e 20 69 73 20 65 6e timization is en
08a0: 61 62 6c 65 64 2c 20 61 6e 64 20 74 68 65 20 65 abled, and the e
08b0: 6e 74 69 72 65 0a 2a 2a 20 20 20 20 20 20 20 20 ntire.**
08c0: 20 74 72 61 6e 73 61 63 74 69 6f 6e 20 6f 74 68 transaction oth
08d0: 65 72 20 74 68 61 6e 20 74 68 65 20 75 70 64 61 er than the upda
08e0: 74 65 20 6f 66 20 74 68 65 20 74 72 61 6e 73 61 te of the transa
08f0: 63 74 69 6f 6e 20 73 65 71 75 65 6e 63 65 0a 2a ction sequence.*
0900: 2a 20 20 20 20 20 20 20 20 20 6e 75 6d 62 65 72 * number
0910: 20 63 6f 6e 73 69 73 74 73 20 6f 66 20 61 20 73 consists of a s
0920: 69 6e 67 6c 65 20 70 61 67 65 20 63 68 61 6e 67 ingle page chang
0930: 65 2e 0a 2a 2a 20 0a 2a 2a 20 28 32 29 20 54 68 e..** .** (2) Th
0940: 65 20 63 6f 6e 74 65 6e 74 20 6f 66 20 61 20 70 e content of a p
0950: 61 67 65 20 77 72 69 74 74 65 6e 20 69 6e 74 6f age written into
0960: 20 74 68 65 20 72 6f 6c 6c 62 61 63 6b 20 6a 6f the rollback jo
0970: 75 72 6e 61 6c 20 65 78 61 63 74 6c 79 20 6d 61 urnal exactly ma
0980: 74 63 68 65 73 0a 2a 2a 20 20 20 20 20 62 6f 74 tches.** bot
0990: 68 20 74 68 65 20 63 6f 6e 74 65 6e 74 20 69 6e h the content in
09a0: 20 74 68 65 20 64 61 74 61 62 61 73 65 20 77 68 the database wh
09b0: 65 6e 20 74 68 65 20 72 6f 6c 6c 62 61 63 6b 20 en the rollback
09c0: 6a 6f 75 72 6e 61 6c 20 77 61 73 20 77 72 69 74 journal was writ
09d0: 74 65 6e 0a 2a 2a 20 20 20 20 20 61 6e 64 20 74 ten.** and t
09e0: 68 65 20 63 6f 6e 74 65 6e 74 20 69 6e 20 74 68 he content in th
09f0: 65 20 64 61 74 61 62 61 73 65 20 61 74 20 74 68 e database at th
0a00: 65 20 62 65 67 69 6e 6e 69 6e 67 20 6f 66 20 74 e beginning of t
0a10: 68 65 20 63 75 72 72 65 6e 74 0a 2a 2a 20 20 20 he current.**
0a20: 20 20 74 72 61 6e 73 61 63 74 69 6f 6e 2e 0a 2a transaction..*
0a30: 2a 20 0a 2a 2a 20 28 33 29 20 57 72 69 74 65 73 * .** (3) Writes
0a40: 20 74 6f 20 74 68 65 20 64 61 74 61 62 61 73 65 to the database
0a50: 20 66 69 6c 65 20 61 72 65 20 61 6e 20 69 6e 74 file are an int
0a60: 65 67 65 72 20 6d 75 6c 74 69 70 6c 65 20 6f 66 eger multiple of
0a70: 20 74 68 65 20 70 61 67 65 20 73 69 7a 65 0a 2a the page size.*
0a80: 2a 20 20 20 20 20 69 6e 20 6c 65 6e 67 74 68 20 * in length
0a90: 61 6e 64 20 61 72 65 20 61 6c 69 67 6e 65 64 20 and are aligned
0aa0: 6f 6e 20 61 20 70 61 67 65 20 62 6f 75 6e 64 61 on a page bounda
0ab0: 72 79 2e 0a 2a 2a 20 0a 2a 2a 20 28 34 29 20 52 ry..** .** (4) R
0ac0: 65 61 64 73 20 66 72 6f 6d 20 74 68 65 20 64 61 eads from the da
0ad0: 74 61 62 61 73 65 20 66 69 6c 65 20 61 72 65 20 tabase file are
0ae0: 65 69 74 68 65 72 20 61 6c 69 67 6e 65 64 20 6f either aligned o
0af0: 6e 20 61 20 70 61 67 65 20 62 6f 75 6e 64 61 72 n a page boundar
0b00: 79 20 61 6e 64 0a 2a 2a 20 20 20 20 20 61 6e 20 y and.** an
0b10: 69 6e 74 65 67 65 72 20 6d 75 6c 74 69 70 6c 65 integer multiple
0b20: 20 6f 66 20 74 68 65 20 70 61 67 65 20 73 69 7a of the page siz
0b30: 65 20 69 6e 20 6c 65 6e 67 74 68 20 6f 72 20 61 e in length or a
0b40: 72 65 20 74 61 6b 65 6e 20 66 72 6f 6d 20 74 68 re taken from th
0b50: 65 0a 2a 2a 20 20 20 20 20 66 69 72 73 74 20 31 e.** first 1
0b60: 30 30 20 62 79 74 65 73 20 6f 66 20 74 68 65 20 00 bytes of the
0b70: 64 61 74 61 62 61 73 65 20 66 69 6c 65 2e 0a 2a database file..*
0b80: 2a 20 0a 2a 2a 20 28 35 29 20 41 6c 6c 20 77 72 * .** (5) All wr
0b90: 69 74 65 73 20 74 6f 20 74 68 65 20 64 61 74 61 ites to the data
0ba0: 62 61 73 65 20 66 69 6c 65 20 61 72 65 20 73 79 base file are sy
0bb0: 6e 63 65 64 20 70 72 69 6f 72 20 74 6f 20 74 68 nced prior to th
0bc0: 65 20 72 6f 6c 6c 62 61 63 6b 20 6a 6f 75 72 6e e rollback journ
0bd0: 61 6c 0a 2a 2a 20 20 20 20 20 62 65 69 6e 67 20 al.** being
0be0: 64 65 6c 65 74 65 64 2c 20 74 72 75 6e 63 61 74 deleted, truncat
0bf0: 65 64 2c 20 6f 72 20 7a 65 72 6f 65 64 2e 0a 2a ed, or zeroed..*
0c00: 2a 20 0a 2a 2a 20 28 36 29 20 49 66 20 61 20 6d * .** (6) If a m
0c10: 61 73 74 65 72 20 6a 6f 75 72 6e 61 6c 20 66 69 aster journal fi
0c20: 6c 65 20 69 73 20 75 73 65 64 2c 20 74 68 65 6e le is used, then
0c30: 20 61 6c 6c 20 77 72 69 74 65 73 20 74 6f 20 74 all writes to t
0c40: 68 65 20 64 61 74 61 62 61 73 65 20 66 69 6c 65 he database file
0c50: 0a 2a 2a 20 20 20 20 20 61 72 65 20 73 79 6e 63 .** are sync
0c60: 65 64 20 70 72 69 6f 72 20 74 6f 20 74 68 65 20 ed prior to the
0c70: 6d 61 73 74 65 72 20 6a 6f 75 72 6e 61 6c 20 62 master journal b
0c80: 65 69 6e 67 20 64 65 6c 65 74 65 64 2e 0a 2a 2a eing deleted..**
0c90: 20 0a 2a 2a 20 44 65 66 69 6e 69 74 69 6f 6e 3a .** Definition:
0ca0: 20 54 77 6f 20 64 61 74 61 62 61 73 65 73 20 28 Two databases (
0cb0: 6f 72 20 74 68 65 20 73 61 6d 65 20 64 61 74 61 or the same data
0cc0: 62 61 73 65 20 61 74 20 74 77 6f 20 70 6f 69 6e base at two poin
0cd0: 74 73 20 69 74 20 74 69 6d 65 29 0a 2a 2a 20 61 ts it time).** a
0ce0: 72 65 20 73 61 69 64 20 74 6f 20 62 65 20 22 6c re said to be "l
0cf0: 6f 67 69 63 61 6c 6c 79 20 65 71 75 69 76 61 6c ogically equival
0d00: 65 6e 74 22 20 69 66 20 74 68 65 79 20 67 69 76 ent" if they giv
0d10: 65 20 74 68 65 20 73 61 6d 65 20 61 6e 73 77 65 e the same answe
0d20: 72 20 74 6f 0a 2a 2a 20 61 6c 6c 20 71 75 65 72 r to.** all quer
0d30: 69 65 73 2e 20 20 4e 6f 74 65 20 69 6e 20 70 61 ies. Note in pa
0d40: 72 74 69 63 75 6c 61 72 20 74 68 65 20 63 6f 6e rticular the con
0d50: 74 65 6e 74 20 6f 66 20 66 72 65 65 6c 69 73 74 tent of freelist
0d60: 20 6c 65 61 66 0a 2a 2a 20 70 61 67 65 73 20 63 leaf.** pages c
0d70: 61 6e 20 62 65 20 63 68 61 6e 67 65 64 20 61 72 an be changed ar
0d80: 62 69 74 72 61 72 69 6c 79 20 77 69 74 68 6f 75 bitrarily withou
0d90: 74 20 61 66 66 65 63 74 69 6e 67 20 74 68 65 20 t affecting the
0da0: 6c 6f 67 69 63 61 6c 20 65 71 75 69 76 61 6c 65 logical equivale
0db0: 6e 63 65 0a 2a 2a 20 6f 66 20 74 68 65 20 64 61 nce.** of the da
0dc0: 74 61 62 61 73 65 2e 0a 2a 2a 20 0a 2a 2a 20 28 tabase..** .** (
0dd0: 37 29 20 41 74 20 61 6e 79 20 74 69 6d 65 2c 20 7) At any time,
0de0: 69 66 20 61 6e 79 20 73 75 62 73 65 74 2c 20 69 if any subset, i
0df0: 6e 63 6c 75 64 69 6e 67 20 74 68 65 20 65 6d 70 ncluding the emp
0e00: 74 79 20 73 65 74 20 61 6e 64 20 74 68 65 20 74 ty set and the t
0e10: 6f 74 61 6c 20 73 65 74 2c 0a 2a 2a 20 20 20 20 otal set,.**
0e20: 20 6f 66 20 74 68 65 20 75 6e 73 79 6e 63 65 64 of the unsynced
0e30: 20 63 68 61 6e 67 65 73 20 74 6f 20 61 20 72 6f changes to a ro
0e40: 6c 6c 62 61 63 6b 20 6a 6f 75 72 6e 61 6c 20 61 llback journal a
0e50: 72 65 20 72 65 6d 6f 76 65 64 20 61 6e 64 20 74 re removed and t
0e60: 68 65 20 0a 2a 2a 20 20 20 20 20 6a 6f 75 72 6e he .** journ
0e70: 61 6c 20 69 73 20 72 6f 6c 6c 65 64 20 62 61 63 al is rolled bac
0e80: 6b 2c 20 74 68 65 20 72 65 73 75 6c 74 69 6e 67 k, the resulting
0e90: 20 64 61 74 61 62 61 73 65 20 66 69 6c 65 20 77 database file w
0ea0: 69 6c 6c 20 62 65 20 6c 6f 67 69 63 61 6c 6c 79 ill be logically
0eb0: 0a 2a 2a 20 20 20 20 20 65 71 75 69 76 61 6c 65 .** equivale
0ec0: 6e 74 20 74 6f 20 74 68 65 20 64 61 74 61 62 61 nt to the databa
0ed0: 73 65 20 66 69 6c 65 20 61 74 20 74 68 65 20 62 se file at the b
0ee0: 65 67 69 6e 6e 69 6e 67 20 6f 66 20 74 68 65 20 eginning of the
0ef0: 74 72 61 6e 73 61 63 74 69 6f 6e 2e 0a 2a 2a 20 transaction..**
0f00: 0a 2a 2a 20 28 38 29 20 57 68 65 6e 20 61 20 74 .** (8) When a t
0f10: 72 61 6e 73 61 63 74 69 6f 6e 20 69 73 20 72 6f ransaction is ro
0f20: 6c 6c 65 64 20 62 61 63 6b 2c 20 74 68 65 20 78 lled back, the x
0f30: 54 72 75 6e 63 61 74 65 20 6d 65 74 68 6f 64 20 Truncate method
0f40: 6f 66 20 74 68 65 20 56 46 53 0a 2a 2a 20 20 20 of the VFS.**
0f50: 20 20 69 73 20 63 61 6c 6c 65 64 20 74 6f 20 72 is called to r
0f60: 65 73 74 6f 72 65 20 74 68 65 20 64 61 74 61 62 estore the datab
0f70: 61 73 65 20 66 69 6c 65 20 74 6f 20 74 68 65 20 ase file to the
0f80: 73 61 6d 65 20 73 69 7a 65 20 69 74 20 77 61 73 same size it was
0f90: 20 61 74 0a 2a 2a 20 20 20 20 20 74 68 65 20 62 at.** the b
0fa0: 65 67 69 6e 6e 69 6e 67 20 6f 66 20 74 68 65 20 eginning of the
0fb0: 74 72 61 6e 73 61 63 74 69 6f 6e 2e 20 20 28 49 transaction. (I
0fc0: 6e 20 73 6f 6d 65 20 56 46 53 65 73 2c 20 74 68 n some VFSes, th
0fd0: 65 20 78 54 72 75 6e 63 61 74 65 0a 2a 2a 20 20 e xTruncate.**
0fe0: 20 20 20 6d 65 74 68 6f 64 20 69 73 20 61 20 6e method is a n
0ff0: 6f 2d 6f 70 2c 20 62 75 74 20 74 68 61 74 20 64 o-op, but that d
1000: 6f 65 73 20 6e 6f 74 20 63 68 61 6e 67 65 20 74 oes not change t
1010: 68 65 20 66 61 63 74 20 74 68 65 20 53 51 4c 69 he fact the SQLi
1020: 74 65 20 77 69 6c 6c 0a 2a 2a 20 20 20 20 20 69 te will.** i
1030: 6e 76 6f 6b 65 20 69 74 2e 29 0a 2a 2a 20 0a 2a nvoke it.).** .*
1040: 2a 20 28 39 29 20 57 68 65 6e 65 76 65 72 20 74 * (9) Whenever t
1050: 68 65 20 64 61 74 61 62 61 73 65 20 66 69 6c 65 he database file
1060: 20 69 73 20 6d 6f 64 69 66 69 65 64 2c 20 61 74 is modified, at
1070: 20 6c 65 61 73 74 20 6f 6e 65 20 62 69 74 20 69 least one bit i
1080: 6e 20 74 68 65 20 72 61 6e 67 65 0a 2a 2a 20 20 n the range.**
1090: 20 20 20 6f 66 20 62 79 74 65 73 20 66 72 6f 6d of bytes from
10a0: 20 32 34 20 74 68 72 6f 75 67 68 20 33 39 20 69 24 through 39 i
10b0: 6e 63 6c 75 73 69 76 65 20 77 69 6c 6c 20 62 65 nclusive will be
10c0: 20 63 68 61 6e 67 65 64 20 70 72 69 6f 72 20 74 changed prior t
10d0: 6f 20 72 65 6c 65 61 73 69 6e 67 0a 2a 2a 20 20 o releasing.**
10e0: 20 20 20 74 68 65 20 45 58 43 4c 55 53 49 56 45 the EXCLUSIVE
10f0: 20 6c 6f 63 6b 2c 20 74 68 75 73 20 73 69 67 6e lock, thus sign
1100: 61 6c 69 6e 67 20 6f 74 68 65 72 20 63 6f 6e 6e aling other conn
1110: 65 63 74 69 6f 6e 73 20 6f 6e 20 74 68 65 20 73 ections on the s
1120: 61 6d 65 0a 2a 2a 20 20 20 20 20 64 61 74 61 62 ame.** datab
1130: 61 73 65 20 74 6f 20 66 6c 75 73 68 20 74 68 65 ase to flush the
1140: 69 72 20 63 61 63 68 65 73 2e 0a 2a 2a 0a 2a 2a ir caches..**.**
1150: 20 28 31 30 29 20 54 68 65 20 70 61 74 74 65 72 (10) The patter
1160: 6e 20 6f 66 20 62 69 74 73 20 69 6e 20 62 79 74 n of bits in byt
1170: 65 73 20 32 34 20 74 68 72 6f 75 67 68 20 33 39 es 24 through 39
1180: 20 73 68 61 6c 6c 20 6e 6f 74 20 72 65 70 65 61 shall not repea
1190: 74 20 69 6e 20 6c 65 73 73 0a 2a 2a 20 20 20 20 t in less.**
11a0: 20 20 74 68 61 6e 20 6f 6e 65 20 62 69 6c 6c 69 than one billi
11b0: 6f 6e 20 74 72 61 6e 73 61 63 74 69 6f 6e 73 2e on transactions.
11c0: 0a 2a 2a 0a 2a 2a 20 28 31 31 29 20 41 20 64 61 .**.** (11) A da
11d0: 74 61 62 61 73 65 20 66 69 6c 65 20 69 73 20 77 tabase file is w
11e0: 65 6c 6c 2d 66 6f 72 6d 65 64 20 61 74 20 74 68 ell-formed at th
11f0: 65 20 62 65 67 69 6e 6e 69 6e 67 20 61 6e 64 20 e beginning and
1200: 61 74 20 74 68 65 20 63 6f 6e 63 6c 75 73 69 6f at the conclusio
1210: 6e 0a 2a 2a 20 20 20 20 20 20 6f 66 20 65 76 65 n.** of eve
1220: 72 79 20 74 72 61 6e 73 61 63 74 69 6f 6e 2e 0a ry transaction..
1230: 2a 2a 0a 2a 2a 20 28 31 32 29 20 41 6e 20 45 58 **.** (12) An EX
1240: 43 4c 55 53 49 56 45 20 6c 6f 63 6b 20 69 73 20 CLUSIVE lock is
1250: 68 65 6c 64 20 6f 6e 20 74 68 65 20 64 61 74 61 held on the data
1260: 62 61 73 65 20 66 69 6c 65 20 77 68 65 6e 20 77 base file when w
1270: 72 69 74 69 6e 67 20 74 6f 0a 2a 2a 20 20 20 20 riting to.**
1280: 20 20 74 68 65 20 64 61 74 61 62 61 73 65 20 66 the database f
1290: 69 6c 65 2e 0a 2a 2a 0a 2a 2a 20 28 31 33 29 20 ile..**.** (13)
12a0: 41 20 53 48 41 52 45 44 20 6c 6f 63 6b 20 69 73 A SHARED lock is
12b0: 20 68 65 6c 64 20 6f 6e 20 74 68 65 20 64 61 74 held on the dat
12c0: 61 62 61 73 65 20 66 69 6c 65 20 77 68 69 6c 65 abase file while
12d0: 20 72 65 61 64 69 6e 67 20 61 6e 79 0a 2a 2a 20 reading any.**
12e0: 20 20 20 20 20 63 6f 6e 74 65 6e 74 20 6f 75 74 content out
12f0: 20 6f 66 20 74 68 65 20 64 61 74 61 62 61 73 65 of the database
1300: 20 66 69 6c 65 2e 0a 2a 2a 0a 2a 2a 2a 2a 2a 2a file..**.******
1310: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
1320: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
1330: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
1340: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
1350: 2a 2a 2a 2a 2a 2a 2a 2a 2f 0a 0a 2f 2a 0a 2a 2a ********/../*.**
1360: 20 4d 61 63 72 6f 73 20 66 6f 72 20 74 72 6f 75 Macros for trou
1370: 62 6c 65 73 68 6f 6f 74 69 6e 67 2e 20 20 4e 6f bleshooting. No
1380: 72 6d 61 6c 6c 79 20 74 75 72 6e 65 64 20 6f 66 rmally turned of
1390: 66 0a 2a 2f 0a 23 69 66 20 30 0a 69 6e 74 20 73 f.*/.#if 0.int s
13a0: 71 6c 69 74 65 33 50 61 67 65 72 54 72 61 63 65 qlite3PagerTrace
13b0: 3d 31 3b 20 20 2f 2a 20 54 72 75 65 20 74 6f 20 =1; /* True to
13c0: 65 6e 61 62 6c 65 20 74 72 61 63 69 6e 67 20 2a enable tracing *
13d0: 2f 0a 23 64 65 66 69 6e 65 20 73 71 6c 69 74 65 /.#define sqlite
13e0: 33 44 65 62 75 67 50 72 69 6e 74 66 20 70 72 69 3DebugPrintf pri
13f0: 6e 74 66 0a 23 64 65 66 69 6e 65 20 50 41 47 45 ntf.#define PAGE
1400: 52 54 52 41 43 45 28 58 29 20 20 20 20 20 69 66 RTRACE(X) if
1410: 28 20 73 71 6c 69 74 65 33 50 61 67 65 72 54 72 ( sqlite3PagerTr
1420: 61 63 65 20 29 7b 20 73 71 6c 69 74 65 33 44 65 ace ){ sqlite3De
1430: 62 75 67 50 72 69 6e 74 66 20 58 3b 20 7d 0a 23 bugPrintf X; }.#
1440: 65 6c 73 65 0a 23 64 65 66 69 6e 65 20 50 41 47 else.#define PAG
1450: 45 52 54 52 41 43 45 28 58 29 0a 23 65 6e 64 69 ERTRACE(X).#endi
1460: 66 0a 0a 2f 2a 0a 2a 2a 20 54 68 65 20 66 6f 6c f../*.** The fol
1470: 6c 6f 77 69 6e 67 20 74 77 6f 20 6d 61 63 72 6f lowing two macro
1480: 73 20 61 72 65 20 75 73 65 64 20 77 69 74 68 69 s are used withi
1490: 6e 20 74 68 65 20 50 41 47 45 52 54 52 41 43 45 n the PAGERTRACE
14a0: 28 29 20 6d 61 63 72 6f 73 20 61 62 6f 76 65 0a () macros above.
14b0: 2a 2a 20 74 6f 20 70 72 69 6e 74 20 6f 75 74 20 ** to print out
14c0: 66 69 6c 65 2d 64 65 73 63 72 69 70 74 6f 72 73 file-descriptors
14d0: 2e 20 0a 2a 2a 0a 2a 2a 20 50 41 47 45 52 49 44 . .**.** PAGERID
14e0: 28 29 20 74 61 6b 65 73 20 61 20 70 6f 69 6e 74 () takes a point
14f0: 65 72 20 74 6f 20 61 20 50 61 67 65 72 20 73 74 er to a Pager st
1500: 72 75 63 74 20 61 73 20 69 74 73 20 61 72 67 75 ruct as its argu
1510: 6d 65 6e 74 2e 20 54 68 65 0a 2a 2a 20 61 73 73 ment. The.** ass
1520: 6f 63 69 61 74 65 64 20 66 69 6c 65 2d 64 65 73 ociated file-des
1530: 63 72 69 70 74 6f 72 20 69 73 20 72 65 74 75 72 criptor is retur
1540: 6e 65 64 2e 20 46 49 4c 45 48 41 4e 44 4c 45 49 ned. FILEHANDLEI
1550: 44 28 29 20 74 61 6b 65 73 20 61 6e 20 73 71 6c D() takes an sql
1560: 69 74 65 33 5f 66 69 6c 65 0a 2a 2a 20 73 74 72 ite3_file.** str
1570: 75 63 74 20 61 73 20 69 74 73 20 61 72 67 75 6d uct as its argum
1580: 65 6e 74 2e 0a 2a 2f 0a 23 64 65 66 69 6e 65 20 ent..*/.#define
1590: 50 41 47 45 52 49 44 28 70 29 20 28 28 69 6e 74 PAGERID(p) ((int
15a0: 29 28 70 2d 3e 66 64 29 29 0a 23 64 65 66 69 6e )(p->fd)).#defin
15b0: 65 20 46 49 4c 45 48 41 4e 44 4c 45 49 44 28 66 e FILEHANDLEID(f
15c0: 64 29 20 28 28 69 6e 74 29 66 64 29 0a 0a 2f 2a d) ((int)fd)../*
15d0: 0a 2a 2a 20 54 68 65 20 50 61 67 65 72 2e 65 53 .** The Pager.eS
15e0: 74 61 74 65 20 76 61 72 69 61 62 6c 65 20 73 74 tate variable st
15f0: 6f 72 65 73 20 74 68 65 20 63 75 72 72 65 6e 74 ores the current
1600: 20 27 73 74 61 74 65 27 20 6f 66 20 61 20 70 61 'state' of a pa
1610: 67 65 72 2e 20 41 0a 2a 2a 20 70 61 67 65 72 20 ger. A.** pager
1620: 6d 61 79 20 62 65 20 69 6e 20 61 6e 79 20 6f 6e may be in any on
1630: 65 20 6f 66 20 74 68 65 20 73 65 76 65 6e 20 73 e of the seven s
1640: 74 61 74 65 73 20 73 68 6f 77 6e 20 69 6e 20 74 tates shown in t
1650: 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 0a 2a 2a 20 he following.**
1660: 73 74 61 74 65 20 64 69 61 67 72 61 6d 2e 0a 2a state diagram..*
1670: 2a 0a 2a 2a 20 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: 4f 50 45 4e 20 3c 2d 2d 2d 2d 2d 2d 2b 2d 2d 2d OPEN <------+---
16a0: 2d 2d 2d 2b 0a 2a 2a 20 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 7c 20 20 20 20 20 20 20 20 20 7c | |
16d0: 20 20 20 20 20 20 7c 0a 2a 2a 20 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 56 20 20 20 20 20 20 20 V
1700: 20 20 7c 20 20 20 20 20 20 7c 0a 2a 2a 20 20 20 | |.**
1710: 20 20 20 20 20 20 20 20 20 20 20 20 2b 2d 2d 2d +---
1720: 2d 2d 2d 2d 2d 2d 3e 20 52 45 41 44 45 52 2d 2d ------> READER--
1730: 2d 2d 2d 2d 2d 2b 20 20 20 20 20 20 7c 0a 2a 2a -----+ |.**
1740: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 7c |
1750: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 7c 20 |
1760: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 7c |
1770: 0a 2a 2a 20 20 20 20 20 20 20 20 20 20 20 20 20 .**
1780: 20 20 7c 20 20 20 20 20 20 20 20 20 20 20 20 20 |
1790: 20 56 20 20 20 20 20 20 20 20 20 20 20 20 20 20 V
17a0: 20 20 7c 0a 2a 2a 20 20 20 20 20 20 20 20 20 20 |.**
17b0: 20 20 20 20 20 7c 3c 2d 2d 2d 2d 2d 2d 2d 57 52 |<-------WR
17c0: 49 54 45 52 5f 4c 4f 43 4b 45 44 2d 2d 2d 2d 2d ITER_LOCKED-----
17d0: 2d 3e 20 45 52 52 4f 52 0a 2a 2a 20 20 20 20 20 -> ERROR.**
17e0: 20 20 20 20 20 20 20 20 20 20 7c 20 20 20 20 20 |
17f0: 20 20 20 20 20 20 20 20 20 7c 20 20 20 20 20 20 |
1800: 20 20 20 20 20 20 20 20 20 20 5e 20 20 0a 2a 2a ^ .**
1810: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 7c |
1820: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 56 20 V
1830: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 7c |
1840: 0a 2a 2a 20 20 20 20 20 20 20 20 20 20 20 20 20 .**
1850: 20 20 7c 3c 2d 2d 2d 2d 2d 2d 57 52 49 54 45 52 |<------WRITER
1860: 5f 43 41 43 48 45 4d 4f 44 2d 2d 2d 2d 2d 2d 2d _CACHEMOD-------
1870: 2d 3e 7c 0a 2a 2a 20 20 20 20 20 20 20 20 20 20 ->|.**
1880: 20 20 20 20 20 7c 20 20 20 20 20 20 20 20 20 20 |
1890: 20 20 20 20 7c 20 20 20 20 20 20 20 20 20 20 20 |
18a0: 20 20 20 20 20 7c 0a 2a 2a 20 20 20 20 20 20 20 |.**
18b0: 20 20 20 20 20 20 20 20 7c 20 20 20 20 20 20 20 |
18c0: 20 20 20 20 20 20 20 56 20 20 20 20 20 20 20 20 V
18d0: 20 20 20 20 20 20 20 20 7c 0a 2a 2a 20 20 20 20 |.**
18e0: 20 20 20 20 20 20 20 20 20 20 20 7c 3c 2d 2d 2d |<---
18f0: 2d 2d 2d 2d 57 52 49 54 45 52 5f 44 42 4d 4f 44 ----WRITER_DBMOD
1900: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 3e 7c 0a 2a 2a 20 ---------->|.**
1910: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 7c 20 |
1920: 20 20 20 20 20 20 20 20 20 20 20 20 20 7c 20 20 |
1930: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 7c 0a |.
1940: 2a 2a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 **
1950: 20 7c 20 20 20 20 20 20 20 20 20 20 20 20 20 20 |
1960: 56 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 V
1970: 20 7c 0a 2a 2a 20 20 20 20 20 20 20 20 20 20 20 |.**
1980: 20 20 20 20 2b 3c 2d 2d 2d 2d 2d 2d 57 52 49 54 +<------WRIT
1990: 45 52 5f 46 49 4e 49 53 48 45 44 2d 2d 2d 2d 2d ER_FINISHED-----
19a0: 2d 2d 2d 3e 2b 0a 2a 2a 0a 2a 2a 0a 2a 2a 20 4c --->+.**.**.** L
19b0: 69 73 74 20 6f 66 20 73 74 61 74 65 20 74 72 61 ist of state tra
19c0: 6e 73 69 74 69 6f 6e 73 20 61 6e 64 20 74 68 65 nsitions and the
19d0: 20 43 20 5b 66 75 6e 63 74 69 6f 6e 5d 20 74 68 C [function] th
19e0: 61 74 20 70 65 72 66 6f 72 6d 73 20 65 61 63 68 at performs each
19f0: 3a 0a 2a 2a 20 0a 2a 2a 20 20 20 4f 50 45 4e 20 :.** .** OPEN
1a00: 20 20 20 20 20 20 20 20 20 20 20 20 20 2d 3e 20 ->
1a10: 52 45 41 44 45 52 20 20 20 20 20 20 20 20 20 20 READER
1a20: 20 20 20 20 5b 73 71 6c 69 74 65 33 50 61 67 65 [sqlite3Page
1a30: 72 53 68 61 72 65 64 4c 6f 63 6b 5d 0a 2a 2a 20 rSharedLock].**
1a40: 20 20 52 45 41 44 45 52 20 20 20 20 20 20 20 20 READER
1a50: 20 20 20 20 2d 3e 20 4f 50 45 4e 20 20 20 20 20 -> OPEN
1a60: 20 20 20 20 20 20 20 20 20 20 20 5b 70 61 67 65 [page
1a70: 72 5f 75 6e 6c 6f 63 6b 5d 0a 2a 2a 0a 2a 2a 20 r_unlock].**.**
1a80: 20 20 52 45 41 44 45 52 20 20 20 20 20 20 20 20 READER
1a90: 20 20 20 20 2d 3e 20 57 52 49 54 45 52 5f 4c 4f -> WRITER_LO
1aa0: 43 4b 45 44 20 20 20 20 20 20 20 5b 73 71 6c 69 CKED [sqli
1ab0: 74 65 33 50 61 67 65 72 42 65 67 69 6e 5d 0a 2a te3PagerBegin].*
1ac0: 2a 20 20 20 57 52 49 54 45 52 5f 4c 4f 43 4b 45 * WRITER_LOCKE
1ad0: 44 20 20 20 20 20 2d 3e 20 57 52 49 54 45 52 5f D -> WRITER_
1ae0: 43 41 43 48 45 4d 4f 44 20 20 20 20 20 5b 70 61 CACHEMOD [pa
1af0: 67 65 72 5f 6f 70 65 6e 5f 6a 6f 75 72 6e 61 6c ger_open_journal
1b00: 5d 0a 2a 2a 20 20 20 57 52 49 54 45 52 5f 43 41 ].** WRITER_CA
1b10: 43 48 45 4d 4f 44 20 20 20 2d 3e 20 57 52 49 54 CHEMOD -> WRIT
1b20: 45 52 5f 44 42 4d 4f 44 20 20 20 20 20 20 20 20 ER_DBMOD
1b30: 5b 73 79 6e 63 4a 6f 75 72 6e 61 6c 5d 0a 2a 2a [syncJournal].**
1b40: 20 20 20 57 52 49 54 45 52 5f 44 42 4d 4f 44 20 WRITER_DBMOD
1b50: 20 20 20 20 20 2d 3e 20 57 52 49 54 45 52 5f 46 -> WRITER_F
1b60: 49 4e 49 53 48 45 44 20 20 20 20 20 5b 73 71 6c INISHED [sql
1b70: 69 74 65 33 50 61 67 65 72 43 6f 6d 6d 69 74 50 ite3PagerCommitP
1b80: 68 61 73 65 4f 6e 65 5d 0a 2a 2a 20 20 20 57 52 haseOne].** WR
1b90: 49 54 45 52 5f 2a 2a 2a 20 20 20 20 20 20 20 20 ITER_***
1ba0: 2d 3e 20 52 45 41 44 45 52 20 20 20 20 20 20 20 -> READER
1bb0: 20 20 20 20 20 20 20 5b 70 61 67 65 72 5f 65 6e [pager_en
1bc0: 64 5f 74 72 61 6e 73 61 63 74 69 6f 6e 5d 0a 2a d_transaction].*
1bd0: 2a 0a 2a 2a 20 20 20 57 52 49 54 45 52 5f 2a 2a *.** WRITER_**
1be0: 2a 20 20 20 20 20 20 20 20 2d 3e 20 45 52 52 4f * -> ERRO
1bf0: 52 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 R
1c00: 5b 70 61 67 65 72 5f 65 72 72 6f 72 5d 0a 2a 2a [pager_error].**
1c10: 20 20 20 45 52 52 4f 52 20 20 20 20 20 20 20 20 ERROR
1c20: 20 20 20 20 20 2d 3e 20 4f 50 45 4e 20 20 20 20 -> OPEN
1c30: 20 20 20 20 20 20 20 20 20 20 20 20 5b 70 61 67 [pag
1c40: 65 72 5f 75 6e 6c 6f 63 6b 5d 0a 2a 2a 20 0a 2a er_unlock].** .*
1c50: 2a 0a 2a 2a 20 20 4f 50 45 4e 3a 0a 2a 2a 0a 2a *.** OPEN:.**.*
1c60: 2a 20 20 20 20 54 68 65 20 70 61 67 65 72 20 73 * The pager s
1c70: 74 61 72 74 73 20 75 70 20 69 6e 20 74 68 69 73 tarts up in this
1c80: 20 73 74 61 74 65 2e 20 4e 6f 74 68 69 6e 67 20 state. Nothing
1c90: 69 73 20 67 75 61 72 61 6e 74 65 65 64 20 69 6e is guaranteed in
1ca0: 20 74 68 69 73 0a 2a 2a 20 20 20 20 73 74 61 74 this.** stat
1cb0: 65 20 2d 20 74 68 65 20 66 69 6c 65 20 6d 61 79 e - the file may
1cc0: 20 6f 72 20 6d 61 79 20 6e 6f 74 20 62 65 20 6c or may not be l
1cd0: 6f 63 6b 65 64 20 61 6e 64 20 74 68 65 20 64 61 ocked and the da
1ce0: 74 61 62 61 73 65 20 73 69 7a 65 20 69 73 0a 2a tabase size is.*
1cf0: 2a 20 20 20 20 75 6e 6b 6e 6f 77 6e 2e 20 54 68 * unknown. Th
1d00: 65 20 64 61 74 61 62 61 73 65 20 6d 61 79 20 6e e database may n
1d10: 6f 74 20 62 65 20 72 65 61 64 20 6f 72 20 77 72 ot be read or wr
1d20: 69 74 74 65 6e 2e 0a 2a 2a 0a 2a 2a 20 20 20 20 itten..**.**
1d30: 2a 20 4e 6f 20 72 65 61 64 20 6f 72 20 77 72 69 * No read or wri
1d40: 74 65 20 74 72 61 6e 73 61 63 74 69 6f 6e 20 69 te transaction i
1d50: 73 20 61 63 74 69 76 65 2e 0a 2a 2a 20 20 20 20 s active..**
1d60: 2a 20 41 6e 79 20 6c 6f 63 6b 2c 20 6f 72 20 6e * Any lock, or n
1d70: 6f 20 6c 6f 63 6b 20 61 74 20 61 6c 6c 2c 20 6d o lock at all, m
1d80: 61 79 20 62 65 20 68 65 6c 64 20 6f 6e 20 74 68 ay be held on th
1d90: 65 20 64 61 74 61 62 61 73 65 20 66 69 6c 65 2e e database file.
1da0: 0a 2a 2a 20 20 20 20 2a 20 54 68 65 20 64 62 53 .** * The dbS
1db0: 69 7a 65 2c 20 64 62 4f 72 69 67 53 69 7a 65 20 ize, dbOrigSize
1dc0: 61 6e 64 20 64 62 46 69 6c 65 53 69 7a 65 20 76 and dbFileSize v
1dd0: 61 72 69 61 62 6c 65 73 20 6d 61 79 20 6e 6f 74 ariables may not
1de0: 20 62 65 20 74 72 75 73 74 65 64 2e 0a 2a 2a 0a be trusted..**.
1df0: 2a 2a 20 20 52 45 41 44 45 52 3a 0a 2a 2a 0a 2a ** READER:.**.*
1e00: 2a 20 20 20 20 49 6e 20 74 68 69 73 20 73 74 61 * In this sta
1e10: 74 65 20 61 6c 6c 20 74 68 65 20 72 65 71 75 69 te all the requi
1e20: 72 65 6d 65 6e 74 73 20 66 6f 72 20 72 65 61 64 rements for read
1e30: 69 6e 67 20 74 68 65 20 64 61 74 61 62 61 73 65 ing the database
1e40: 20 69 6e 20 0a 2a 2a 20 20 20 20 72 6f 6c 6c 62 in .** rollb
1e50: 61 63 6b 20 28 6e 6f 6e 2d 57 41 4c 29 20 6d 6f ack (non-WAL) mo
1e60: 64 65 20 61 72 65 20 6d 65 74 2e 20 55 6e 6c 65 de are met. Unle
1e70: 73 73 20 74 68 65 20 70 61 67 65 72 20 69 73 20 ss the pager is
1e80: 28 6f 72 20 72 65 63 65 6e 74 6c 79 0a 2a 2a 20 (or recently.**
1e90: 20 20 20 77 61 73 29 20 69 6e 20 65 78 63 6c 75 was) in exclu
1ea0: 73 69 76 65 2d 6c 6f 63 6b 69 6e 67 20 6d 6f 64 sive-locking mod
1eb0: 65 2c 20 61 20 75 73 65 72 2d 6c 65 76 65 6c 20 e, a user-level
1ec0: 72 65 61 64 20 74 72 61 6e 73 61 63 74 69 6f 6e read transaction
1ed0: 20 69 73 20 0a 2a 2a 20 20 20 20 6f 70 65 6e 2e is .** open.
1ee0: 20 54 68 65 20 64 61 74 61 62 61 73 65 20 73 69 The database si
1ef0: 7a 65 20 69 73 20 6b 6e 6f 77 6e 20 69 6e 20 74 ze is known in t
1f00: 68 69 73 20 73 74 61 74 65 2e 0a 2a 2a 0a 2a 2a his state..**.**
1f10: 20 20 20 20 41 20 63 6f 6e 6e 65 63 74 69 6f 6e A connection
1f20: 20 72 75 6e 6e 69 6e 67 20 77 69 74 68 20 6c 6f running with lo
1f30: 63 6b 69 6e 67 5f 6d 6f 64 65 3d 6e 6f 72 6d 61 cking_mode=norma
1f40: 6c 20 65 6e 74 65 72 73 20 74 68 69 73 20 73 74 l enters this st
1f50: 61 74 65 20 77 68 65 6e 0a 2a 2a 20 20 20 20 69 ate when.** i
1f60: 74 20 6f 70 65 6e 73 20 61 20 72 65 61 64 2d 74 t opens a read-t
1f70: 72 61 6e 73 61 63 74 69 6f 6e 20 6f 6e 20 74 68 ransaction on th
1f80: 65 20 64 61 74 61 62 61 73 65 20 61 6e 64 20 72 e database and r
1f90: 65 74 75 72 6e 73 20 74 6f 20 73 74 61 74 65 0a eturns to state.
1fa0: 2a 2a 20 20 20 20 4f 50 45 4e 20 61 66 74 65 72 ** OPEN after
1fb0: 20 74 68 65 20 72 65 61 64 2d 74 72 61 6e 73 61 the read-transa
1fc0: 63 74 69 6f 6e 20 69 73 20 63 6f 6d 70 6c 65 74 ction is complet
1fd0: 65 64 2e 20 48 6f 77 65 76 65 72 20 61 20 63 6f ed. However a co
1fe0: 6e 6e 65 63 74 69 6f 6e 0a 2a 2a 20 20 20 20 72 nnection.** r
1ff0: 75 6e 6e 69 6e 67 20 69 6e 20 6c 6f 63 6b 69 6e unning in lockin
2000: 67 5f 6d 6f 64 65 3d 65 78 63 6c 75 73 69 76 65 g_mode=exclusive
2010: 20 28 69 6e 63 6c 75 64 69 6e 67 20 74 65 6d 70 (including temp
2020: 20 64 61 74 61 62 61 73 65 73 29 20 72 65 6d 61 databases) rema
2030: 69 6e 73 20 69 6e 0a 2a 2a 20 20 20 20 74 68 69 ins in.** thi
2040: 73 20 73 74 61 74 65 20 65 76 65 6e 20 61 66 74 s state even aft
2050: 65 72 20 74 68 65 20 72 65 61 64 2d 74 72 61 6e er the read-tran
2060: 73 61 63 74 69 6f 6e 20 69 73 20 63 6c 6f 73 65 saction is close
2070: 64 2e 20 54 68 65 20 6f 6e 6c 79 20 77 61 79 0a d. The only way.
2080: 2a 2a 20 20 20 20 61 20 6c 6f 63 6b 69 6e 67 5f ** a locking_
2090: 6d 6f 64 65 3d 65 78 63 6c 75 73 69 76 65 20 63 mode=exclusive c
20a0: 6f 6e 6e 65 63 74 69 6f 6e 20 63 61 6e 20 74 72 onnection can tr
20b0: 61 6e 73 69 74 69 6f 6e 20 66 72 6f 6d 20 52 45 ansition from RE
20c0: 41 44 45 52 20 74 6f 20 4f 50 45 4e 0a 2a 2a 20 ADER to OPEN.**
20d0: 20 20 20 69 73 20 76 69 61 20 74 68 65 20 45 52 is via the ER
20e0: 52 4f 52 20 73 74 61 74 65 20 28 73 65 65 20 62 ROR state (see b
20f0: 65 6c 6f 77 29 2e 0a 2a 2a 20 0a 2a 2a 20 20 20 elow)..** .**
2100: 20 2a 20 41 20 72 65 61 64 20 74 72 61 6e 73 61 * A read transa
2110: 63 74 69 6f 6e 20 6d 61 79 20 62 65 20 61 63 74 ction may be act
2120: 69 76 65 20 28 62 75 74 20 61 20 77 72 69 74 65 ive (but a write
2130: 2d 74 72 61 6e 73 61 63 74 69 6f 6e 20 63 61 6e -transaction can
2140: 6e 6f 74 29 2e 0a 2a 2a 20 20 20 20 2a 20 41 20 not)..** * A
2150: 53 48 41 52 45 44 20 6f 72 20 67 72 65 61 74 65 SHARED or greate
2160: 72 20 6c 6f 63 6b 20 69 73 20 68 65 6c 64 20 6f r lock is held o
2170: 6e 20 74 68 65 20 64 61 74 61 62 61 73 65 20 66 n the database f
2180: 69 6c 65 2e 0a 2a 2a 20 20 20 20 2a 20 54 68 65 ile..** * The
2190: 20 64 62 53 69 7a 65 20 76 61 72 69 61 62 6c 65 dbSize variable
21a0: 20 6d 61 79 20 62 65 20 74 72 75 73 74 65 64 20 may be trusted
21b0: 28 65 76 65 6e 20 69 66 20 61 20 75 73 65 72 2d (even if a user-
21c0: 6c 65 76 65 6c 20 72 65 61 64 20 0a 2a 2a 20 20 level read .**
21d0: 20 20 20 20 74 72 61 6e 73 61 63 74 69 6f 6e 20 transaction
21e0: 69 73 20 6e 6f 74 20 61 63 74 69 76 65 29 2e 20 is not active).
21f0: 54 68 65 20 64 62 4f 72 69 67 53 69 7a 65 20 61 The dbOrigSize a
2200: 6e 64 20 64 62 46 69 6c 65 53 69 7a 65 20 76 61 nd dbFileSize va
2210: 72 69 61 62 6c 65 73 0a 2a 2a 20 20 20 20 20 20 riables.**
2220: 6d 61 79 20 6e 6f 74 20 62 65 20 74 72 75 73 74 may not be trust
2230: 65 64 20 61 74 20 74 68 69 73 20 70 6f 69 6e 74 ed at this point
2240: 2e 0a 2a 2a 20 20 20 20 2a 20 49 66 20 74 68 65 ..** * If the
2250: 20 64 61 74 61 62 61 73 65 20 69 73 20 61 20 57 database is a W
2260: 41 4c 20 64 61 74 61 62 61 73 65 2c 20 74 68 65 AL database, the
2270: 6e 20 74 68 65 20 57 41 4c 20 63 6f 6e 6e 65 63 n the WAL connec
2280: 74 69 6f 6e 20 69 73 20 6f 70 65 6e 2e 0a 2a 2a tion is open..**
2290: 20 20 20 20 2a 20 45 76 65 6e 20 69 66 20 61 20 * Even if a
22a0: 72 65 61 64 2d 74 72 61 6e 73 61 63 74 69 6f 6e read-transaction
22b0: 20 69 73 20 6e 6f 74 20 6f 70 65 6e 2c 20 69 74 is not open, it
22c0: 20 69 73 20 67 75 61 72 61 6e 74 65 65 64 20 74 is guaranteed t
22d0: 68 61 74 20 0a 2a 2a 20 20 20 20 20 20 74 68 65 hat .** the
22e0: 72 65 20 69 73 20 6e 6f 20 68 6f 74 2d 6a 6f 75 re is no hot-jou
22f0: 72 6e 61 6c 20 69 6e 20 74 68 65 20 66 69 6c 65 rnal in the file
2300: 2d 73 79 73 74 65 6d 2e 0a 2a 2a 0a 2a 2a 20 20 -system..**.**
2310: 57 52 49 54 45 52 5f 4c 4f 43 4b 45 44 3a 0a 2a WRITER_LOCKED:.*
2320: 2a 0a 2a 2a 20 20 20 20 54 68 65 20 70 61 67 65 *.** The page
2330: 72 20 6d 6f 76 65 73 20 74 6f 20 74 68 69 73 20 r moves to this
2340: 73 74 61 74 65 20 66 72 6f 6d 20 52 45 41 44 45 state from READE
2350: 52 20 77 68 65 6e 20 61 20 77 72 69 74 65 2d 74 R when a write-t
2360: 72 61 6e 73 61 63 74 69 6f 6e 0a 2a 2a 20 20 20 ransaction.**
2370: 20 69 73 20 66 69 72 73 74 20 6f 70 65 6e 65 64 is first opened
2380: 20 6f 6e 20 74 68 65 20 64 61 74 61 62 61 73 65 on the database
2390: 2e 20 49 6e 20 57 52 49 54 45 52 5f 4c 4f 43 4b . In WRITER_LOCK
23a0: 45 44 20 73 74 61 74 65 2c 20 61 6c 6c 20 6c 6f ED state, all lo
23b0: 63 6b 73 20 0a 2a 2a 20 20 20 20 72 65 71 75 69 cks .** requi
23c0: 72 65 64 20 74 6f 20 73 74 61 72 74 20 61 20 77 red to start a w
23d0: 72 69 74 65 2d 74 72 61 6e 73 61 63 74 69 6f 6e rite-transaction
23e0: 20 61 72 65 20 68 65 6c 64 2c 20 62 75 74 20 6e are held, but n
23f0: 6f 20 61 63 74 75 61 6c 20 0a 2a 2a 20 20 20 20 o actual .**
2400: 6d 6f 64 69 66 69 63 61 74 69 6f 6e 73 20 74 6f modifications to
2410: 20 74 68 65 20 63 61 63 68 65 20 6f 72 20 64 61 the cache or da
2420: 74 61 62 61 73 65 20 68 61 76 65 20 74 61 6b 65 tabase have take
2430: 6e 20 70 6c 61 63 65 2e 0a 2a 2a 0a 2a 2a 20 20 n place..**.**
2440: 20 20 49 6e 20 72 6f 6c 6c 62 61 63 6b 20 6d 6f In rollback mo
2450: 64 65 2c 20 61 20 52 45 53 45 52 56 45 44 20 6f de, a RESERVED o
2460: 72 20 28 69 66 20 74 68 65 20 74 72 61 6e 73 61 r (if the transa
2470: 63 74 69 6f 6e 20 77 61 73 20 6f 70 65 6e 65 64 ction was opened
2480: 20 77 69 74 68 20 0a 2a 2a 20 20 20 20 42 45 47 with .** BEG
2490: 49 4e 20 45 58 43 4c 55 53 49 56 45 29 20 45 58 IN EXCLUSIVE) EX
24a0: 43 4c 55 53 49 56 45 20 6c 6f 63 6b 20 69 73 20 CLUSIVE lock is
24b0: 6f 62 74 61 69 6e 65 64 20 6f 6e 20 74 68 65 20 obtained on the
24c0: 64 61 74 61 62 61 73 65 20 66 69 6c 65 20 77 68 database file wh
24d0: 65 6e 0a 2a 2a 20 20 20 20 6d 6f 76 69 6e 67 20 en.** moving
24e0: 74 6f 20 74 68 69 73 20 73 74 61 74 65 2c 20 62 to this state, b
24f0: 75 74 20 74 68 65 20 6a 6f 75 72 6e 61 6c 20 66 ut the journal f
2500: 69 6c 65 20 69 73 20 6e 6f 74 20 77 72 69 74 74 ile is not writt
2510: 65 6e 20 74 6f 20 6f 72 20 6f 70 65 6e 65 64 20 en to or opened
2520: 0a 2a 2a 20 20 20 20 74 6f 20 69 6e 20 74 68 69 .** to in thi
2530: 73 20 73 74 61 74 65 2e 20 49 66 20 74 68 65 20 s state. If the
2540: 74 72 61 6e 73 61 63 74 69 6f 6e 20 69 73 20 63 transaction is c
2550: 6f 6d 6d 69 74 74 65 64 20 6f 72 20 72 6f 6c 6c ommitted or roll
2560: 65 64 20 62 61 63 6b 20 77 68 69 6c 65 20 0a 2a ed back while .*
2570: 2a 20 20 20 20 69 6e 20 57 52 49 54 45 52 5f 4c * in WRITER_L
2580: 4f 43 4b 45 44 20 73 74 61 74 65 2c 20 61 6c 6c OCKED state, all
2590: 20 74 68 61 74 20 69 73 20 72 65 71 75 69 72 65 that is require
25a0: 64 20 69 73 20 74 6f 20 75 6e 6c 6f 63 6b 20 74 d is to unlock t
25b0: 68 65 20 64 61 74 61 62 61 73 65 20 0a 2a 2a 20 he database .**
25c0: 20 20 20 66 69 6c 65 2e 0a 2a 2a 0a 2a 2a 20 20 file..**.**
25d0: 20 20 49 4e 20 57 41 4c 20 6d 6f 64 65 2c 20 57 IN WAL mode, W
25e0: 61 6c 42 65 67 69 6e 57 72 69 74 65 54 72 61 6e alBeginWriteTran
25f0: 73 61 63 74 69 6f 6e 28 29 20 69 73 20 63 61 6c saction() is cal
2600: 6c 65 64 20 74 6f 20 6c 6f 63 6b 20 74 68 65 20 led to lock the
2610: 6c 6f 67 20 66 69 6c 65 2e 0a 2a 2a 20 20 20 20 log file..**
2620: 49 66 20 74 68 65 20 63 6f 6e 6e 65 63 74 69 6f If the connectio
2630: 6e 20 69 73 20 72 75 6e 6e 69 6e 67 20 77 69 74 n is running wit
2640: 68 20 6c 6f 63 6b 69 6e 67 5f 6d 6f 64 65 3d 65 h locking_mode=e
2650: 78 63 6c 75 73 69 76 65 2c 20 61 6e 20 61 74 74 xclusive, an att
2660: 65 6d 70 74 0a 2a 2a 20 20 20 20 69 73 20 6d 61 empt.** is ma
2670: 64 65 20 74 6f 20 6f 62 74 61 69 6e 20 61 6e 20 de to obtain an
2680: 45 58 43 4c 55 53 49 56 45 20 6c 6f 63 6b 20 6f EXCLUSIVE lock o
2690: 6e 20 74 68 65 20 64 61 74 61 62 61 73 65 20 66 n the database f
26a0: 69 6c 65 2e 0a 2a 2a 0a 2a 2a 20 20 20 20 2a 20 ile..**.** *
26b0: 41 20 77 72 69 74 65 20 74 72 61 6e 73 61 63 74 A write transact
26c0: 69 6f 6e 20 69 73 20 61 63 74 69 76 65 2e 0a 2a ion is active..*
26d0: 2a 20 20 20 20 2a 20 49 66 20 74 68 65 20 63 6f * * If the co
26e0: 6e 6e 65 63 74 69 6f 6e 20 69 73 20 6f 70 65 6e nnection is open
26f0: 20 69 6e 20 72 6f 6c 6c 62 61 63 6b 2d 6d 6f 64 in rollback-mod
2700: 65 2c 20 61 20 52 45 53 45 52 56 45 44 20 6f 72 e, a RESERVED or
2710: 20 67 72 65 61 74 65 72 20 0a 2a 2a 20 20 20 20 greater .**
2720: 20 20 6c 6f 63 6b 20 69 73 20 68 65 6c 64 20 6f lock is held o
2730: 6e 20 74 68 65 20 64 61 74 61 62 61 73 65 20 66 n the database f
2740: 69 6c 65 2e 0a 2a 2a 20 20 20 20 2a 20 49 66 20 ile..** * If
2750: 74 68 65 20 63 6f 6e 6e 65 63 74 69 6f 6e 20 69 the connection i
2760: 73 20 6f 70 65 6e 20 69 6e 20 57 41 4c 2d 6d 6f s open in WAL-mo
2770: 64 65 2c 20 61 20 57 41 4c 20 77 72 69 74 65 20 de, a WAL write
2780: 74 72 61 6e 73 61 63 74 69 6f 6e 0a 2a 2a 20 20 transaction.**
2790: 20 20 20 20 69 73 20 6f 70 65 6e 20 28 69 2e 65 is open (i.e
27a0: 2e 20 73 71 6c 69 74 65 33 57 61 6c 42 65 67 69 . sqlite3WalBegi
27b0: 6e 57 72 69 74 65 54 72 61 6e 73 61 63 74 69 6f nWriteTransactio
27c0: 6e 28 29 20 68 61 73 20 62 65 65 6e 20 73 75 63 n() has been suc
27d0: 63 65 73 73 66 75 6c 6c 79 0a 2a 2a 20 20 20 20 cessfully.**
27e0: 20 20 63 61 6c 6c 65 64 29 2e 0a 2a 2a 20 20 20 called)..**
27f0: 20 2a 20 54 68 65 20 64 62 53 69 7a 65 2c 20 64 * The dbSize, d
2800: 62 4f 72 69 67 53 69 7a 65 20 61 6e 64 20 64 62 bOrigSize and db
2810: 46 69 6c 65 53 69 7a 65 20 76 61 72 69 61 62 6c FileSize variabl
2820: 65 73 20 61 72 65 20 61 6c 6c 20 76 61 6c 69 64 es are all valid
2830: 2e 0a 2a 2a 20 20 20 20 2a 20 54 68 65 20 63 6f ..** * The co
2840: 6e 74 65 6e 74 73 20 6f 66 20 74 68 65 20 70 61 ntents of the pa
2850: 67 65 72 20 63 61 63 68 65 20 68 61 76 65 20 6e ger cache have n
2860: 6f 74 20 62 65 65 6e 20 6d 6f 64 69 66 69 65 64 ot been modified
2870: 2e 0a 2a 2a 20 20 20 20 2a 20 54 68 65 20 6a 6f ..** * The jo
2880: 75 72 6e 61 6c 20 66 69 6c 65 20 6d 61 79 20 6f urnal file may o
2890: 72 20 6d 61 79 20 6e 6f 74 20 62 65 20 6f 70 65 r may not be ope
28a0: 6e 2e 0a 2a 2a 20 20 20 20 2a 20 4e 6f 74 68 69 n..** * Nothi
28b0: 6e 67 20 28 6e 6f 74 20 65 76 65 6e 20 74 68 65 ng (not even the
28c0: 20 66 69 72 73 74 20 68 65 61 64 65 72 29 20 68 first header) h
28d0: 61 73 20 62 65 65 6e 20 77 72 69 74 74 65 6e 20 as been written
28e0: 74 6f 20 74 68 65 20 6a 6f 75 72 6e 61 6c 2e 0a to the journal..
28f0: 2a 2a 0a 2a 2a 20 20 57 52 49 54 45 52 5f 43 41 **.** WRITER_CA
2900: 43 48 45 4d 4f 44 3a 0a 2a 2a 0a 2a 2a 20 20 20 CHEMOD:.**.**
2910: 20 41 20 70 61 67 65 72 20 6d 6f 76 65 73 20 66 A pager moves f
2920: 72 6f 6d 20 57 52 49 54 45 52 5f 4c 4f 43 4b 45 rom WRITER_LOCKE
2930: 44 20 73 74 61 74 65 20 74 6f 20 74 68 69 73 20 D state to this
2940: 73 74 61 74 65 20 77 68 65 6e 20 61 20 70 61 67 state when a pag
2950: 65 20 69 73 0a 2a 2a 20 20 20 20 66 69 72 73 74 e is.** first
2960: 20 6d 6f 64 69 66 69 65 64 20 62 79 20 74 68 65 modified by the
2970: 20 75 70 70 65 72 20 6c 61 79 65 72 2e 20 49 6e upper layer. In
2980: 20 72 6f 6c 6c 62 61 63 6b 20 6d 6f 64 65 20 74 rollback mode t
2990: 68 65 20 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 0a he journal file.
29a0: 2a 2a 20 20 20 20 69 73 20 6f 70 65 6e 65 64 20 ** is opened
29b0: 28 69 66 20 69 74 20 69 73 20 6e 6f 74 20 61 6c (if it is not al
29c0: 72 65 61 64 79 20 6f 70 65 6e 29 20 61 6e 64 20 ready open) and
29d0: 61 20 68 65 61 64 65 72 20 77 72 69 74 74 65 6e a header written
29e0: 20 74 6f 20 74 68 65 0a 2a 2a 20 20 20 20 73 74 to the.** st
29f0: 61 72 74 20 6f 66 20 69 74 2e 20 54 68 65 20 64 art of it. The d
2a00: 61 74 61 62 61 73 65 20 66 69 6c 65 20 6f 6e 20 atabase file on
2a10: 64 69 73 6b 20 68 61 73 20 6e 6f 74 20 62 65 65 disk has not bee
2a20: 6e 20 6d 6f 64 69 66 69 65 64 2e 0a 2a 2a 0a 2a n modified..**.*
2a30: 2a 20 20 20 20 2a 20 41 20 77 72 69 74 65 20 74 * * A write t
2a40: 72 61 6e 73 61 63 74 69 6f 6e 20 69 73 20 61 63 ransaction is ac
2a50: 74 69 76 65 2e 0a 2a 2a 20 20 20 20 2a 20 41 20 tive..** * A
2a60: 52 45 53 45 52 56 45 44 20 6f 72 20 67 72 65 61 RESERVED or grea
2a70: 74 65 72 20 6c 6f 63 6b 20 69 73 20 68 65 6c 64 ter lock is held
2a80: 20 6f 6e 20 74 68 65 20 64 61 74 61 62 61 73 65 on the database
2a90: 20 66 69 6c 65 2e 0a 2a 2a 20 20 20 20 2a 20 54 file..** * T
2aa0: 68 65 20 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 20 he journal file
2ab0: 69 73 20 6f 70 65 6e 20 61 6e 64 20 74 68 65 20 is open and the
2ac0: 66 69 72 73 74 20 68 65 61 64 65 72 20 68 61 73 first header has
2ad0: 20 62 65 65 6e 20 77 72 69 74 74 65 6e 20 0a 2a been written .*
2ae0: 2a 20 20 20 20 20 20 74 6f 20 69 74 2c 20 62 75 * to it, bu
2af0: 74 20 74 68 65 20 68 65 61 64 65 72 20 68 61 73 t the header has
2b00: 20 6e 6f 74 20 62 65 65 6e 20 73 79 6e 63 65 64 not been synced
2b10: 20 74 6f 20 64 69 73 6b 2e 0a 2a 2a 20 20 20 20 to disk..**
2b20: 2a 20 54 68 65 20 63 6f 6e 74 65 6e 74 73 20 6f * The contents o
2b30: 66 20 74 68 65 20 70 61 67 65 20 63 61 63 68 65 f the page cache
2b40: 20 68 61 76 65 20 62 65 65 6e 20 6d 6f 64 69 66 have been modif
2b50: 69 65 64 2e 0a 2a 2a 0a 2a 2a 20 20 57 52 49 54 ied..**.** WRIT
2b60: 45 52 5f 44 42 4d 4f 44 3a 0a 2a 2a 0a 2a 2a 20 ER_DBMOD:.**.**
2b70: 20 20 20 54 68 65 20 70 61 67 65 72 20 74 72 61 The pager tra
2b80: 6e 73 69 74 69 6f 6e 73 20 66 72 6f 6d 20 57 52 nsitions from WR
2b90: 49 54 45 52 5f 43 41 43 48 45 4d 4f 44 20 69 6e ITER_CACHEMOD in
2ba0: 74 6f 20 57 52 49 54 45 52 5f 44 42 4d 4f 44 20 to WRITER_DBMOD
2bb0: 73 74 61 74 65 0a 2a 2a 20 20 20 20 77 68 65 6e state.** when
2bc0: 20 69 74 20 6d 6f 64 69 66 69 65 73 20 74 68 65 it modifies the
2bd0: 20 63 6f 6e 74 65 6e 74 73 20 6f 66 20 74 68 65 contents of the
2be0: 20 64 61 74 61 62 61 73 65 20 66 69 6c 65 2e 20 database file.
2bf0: 57 41 4c 20 63 6f 6e 6e 65 63 74 69 6f 6e 73 0a WAL connections.
2c00: 2a 2a 20 20 20 20 6e 65 76 65 72 20 65 6e 74 65 ** never ente
2c10: 72 20 74 68 69 73 20 73 74 61 74 65 20 28 73 69 r this state (si
2c20: 6e 63 65 20 74 68 65 79 20 64 6f 20 6e 6f 74 20 nce they do not
2c30: 6d 6f 64 69 66 79 20 74 68 65 20 64 61 74 61 62 modify the datab
2c40: 61 73 65 20 66 69 6c 65 2c 0a 2a 2a 20 20 20 20 ase file,.**
2c50: 6a 75 73 74 20 74 68 65 20 6c 6f 67 20 66 69 6c just the log fil
2c60: 65 29 2e 0a 2a 2a 0a 2a 2a 20 20 20 20 2a 20 41 e)..**.** * A
2c70: 20 77 72 69 74 65 20 74 72 61 6e 73 61 63 74 69 write transacti
2c80: 6f 6e 20 69 73 20 61 63 74 69 76 65 2e 0a 2a 2a on is active..**
2c90: 20 20 20 20 2a 20 41 6e 20 45 58 43 4c 55 53 49 * An EXCLUSI
2ca0: 56 45 20 6f 72 20 67 72 65 61 74 65 72 20 6c 6f VE or greater lo
2cb0: 63 6b 20 69 73 20 68 65 6c 64 20 6f 6e 20 74 68 ck is held on th
2cc0: 65 20 64 61 74 61 62 61 73 65 20 66 69 6c 65 2e e database file.
2cd0: 0a 2a 2a 20 20 20 20 2a 20 54 68 65 20 6a 6f 75 .** * The jou
2ce0: 72 6e 61 6c 20 66 69 6c 65 20 69 73 20 6f 70 65 rnal file is ope
2cf0: 6e 20 61 6e 64 20 74 68 65 20 66 69 72 73 74 20 n and the first
2d00: 68 65 61 64 65 72 20 68 61 73 20 62 65 65 6e 20 header has been
2d10: 77 72 69 74 74 65 6e 20 0a 2a 2a 20 20 20 20 20 written .**
2d20: 20 61 6e 64 20 73 79 6e 63 65 64 20 74 6f 20 64 and synced to d
2d30: 69 73 6b 2e 0a 2a 2a 20 20 20 20 2a 20 54 68 65 isk..** * The
2d40: 20 63 6f 6e 74 65 6e 74 73 20 6f 66 20 74 68 65 contents of the
2d50: 20 70 61 67 65 20 63 61 63 68 65 20 68 61 76 65 page cache have
2d60: 20 62 65 65 6e 20 6d 6f 64 69 66 69 65 64 20 28 been modified (
2d70: 61 6e 64 20 70 6f 73 73 69 62 6c 79 0a 2a 2a 20 and possibly.**
2d80: 20 20 20 20 20 77 72 69 74 74 65 6e 20 74 6f 20 written to
2d90: 64 69 73 6b 29 2e 0a 2a 2a 0a 2a 2a 20 20 57 52 disk)..**.** WR
2da0: 49 54 45 52 5f 46 49 4e 49 53 48 45 44 3a 0a 2a ITER_FINISHED:.*
2db0: 2a 0a 2a 2a 20 20 20 20 49 74 20 69 73 20 6e 6f *.** It is no
2dc0: 74 20 70 6f 73 73 69 62 6c 65 20 66 6f 72 20 61 t possible for a
2dd0: 20 57 41 4c 20 63 6f 6e 6e 65 63 74 69 6f 6e 20 WAL connection
2de0: 74 6f 20 65 6e 74 65 72 20 74 68 69 73 20 73 74 to enter this st
2df0: 61 74 65 2e 0a 2a 2a 0a 2a 2a 20 20 20 20 41 20 ate..**.** A
2e00: 72 6f 6c 6c 62 61 63 6b 2d 6d 6f 64 65 20 70 61 rollback-mode pa
2e10: 67 65 72 20 63 68 61 6e 67 65 73 20 74 6f 20 57 ger changes to W
2e20: 52 49 54 45 52 5f 46 49 4e 49 53 48 45 44 20 73 RITER_FINISHED s
2e30: 74 61 74 65 20 66 72 6f 6d 20 57 52 49 54 45 52 tate from WRITER
2e40: 5f 44 42 4d 4f 44 0a 2a 2a 20 20 20 20 73 74 61 _DBMOD.** sta
2e50: 74 65 20 61 66 74 65 72 20 74 68 65 20 65 6e 74 te after the ent
2e60: 69 72 65 20 74 72 61 6e 73 61 63 74 69 6f 6e 20 ire transaction
2e70: 68 61 73 20 62 65 65 6e 20 73 75 63 63 65 73 73 has been success
2e80: 66 75 6c 6c 79 20 77 72 69 74 74 65 6e 20 69 6e fully written in
2e90: 74 6f 20 74 68 65 0a 2a 2a 20 20 20 20 64 61 74 to the.** dat
2ea0: 61 62 61 73 65 20 66 69 6c 65 2e 20 49 6e 20 74 abase file. In t
2eb0: 68 69 73 20 73 74 61 74 65 20 74 68 65 20 74 72 his state the tr
2ec0: 61 6e 73 61 63 74 69 6f 6e 20 6d 61 79 20 62 65 ansaction may be
2ed0: 20 63 6f 6d 6d 69 74 74 65 64 20 73 69 6d 70 6c committed simpl
2ee0: 79 0a 2a 2a 20 20 20 20 62 79 20 66 69 6e 61 6c y.** by final
2ef0: 69 7a 69 6e 67 20 74 68 65 20 6a 6f 75 72 6e 61 izing the journa
2f00: 6c 20 66 69 6c 65 2e 20 4f 6e 63 65 20 69 6e 20 l file. Once in
2f10: 57 52 49 54 45 52 5f 46 49 4e 49 53 48 45 44 20 WRITER_FINISHED
2f20: 73 74 61 74 65 2c 20 69 74 20 69 73 20 0a 2a 2a state, it is .**
2f30: 20 20 20 20 6e 6f 74 20 70 6f 73 73 69 62 6c 65 not possible
2f40: 20 74 6f 20 6d 6f 64 69 66 79 20 74 68 65 20 64 to modify the d
2f50: 61 74 61 62 61 73 65 20 66 75 72 74 68 65 72 2e atabase further.
2f60: 20 41 74 20 74 68 69 73 20 70 6f 69 6e 74 2c 20 At this point,
2f70: 74 68 65 20 75 70 70 65 72 20 0a 2a 2a 20 20 20 the upper .**
2f80: 20 6c 61 79 65 72 20 6d 75 73 74 20 65 69 74 68 layer must eith
2f90: 65 72 20 63 6f 6d 6d 69 74 20 6f 72 20 72 6f 6c er commit or rol
2fa0: 6c 62 61 63 6b 20 74 68 65 20 74 72 61 6e 73 61 lback the transa
2fb0: 63 74 69 6f 6e 2e 0a 2a 2a 0a 2a 2a 20 20 20 20 ction..**.**
2fc0: 2a 20 41 20 77 72 69 74 65 20 74 72 61 6e 73 61 * A write transa
2fd0: 63 74 69 6f 6e 20 69 73 20 61 63 74 69 76 65 2e ction is active.
2fe0: 0a 2a 2a 20 20 20 20 2a 20 41 6e 20 45 58 43 4c .** * An EXCL
2ff0: 55 53 49 56 45 20 6f 72 20 67 72 65 61 74 65 72 USIVE or greater
3000: 20 6c 6f 63 6b 20 69 73 20 68 65 6c 64 20 6f 6e lock is held on
3010: 20 74 68 65 20 64 61 74 61 62 61 73 65 20 66 69 the database fi
3020: 6c 65 2e 0a 2a 2a 20 20 20 20 2a 20 41 6c 6c 20 le..** * All
3030: 77 72 69 74 69 6e 67 20 61 6e 64 20 73 79 6e 63 writing and sync
3040: 69 6e 67 20 6f 66 20 6a 6f 75 72 6e 61 6c 20 61 ing of journal a
3050: 6e 64 20 64 61 74 61 62 61 73 65 20 64 61 74 61 nd database data
3060: 20 68 61 73 20 66 69 6e 69 73 68 65 64 2e 0a 2a has finished..*
3070: 2a 20 20 20 20 20 20 49 66 20 6e 6f 20 65 72 72 * If no err
3080: 6f 72 20 6f 63 63 75 72 72 65 64 2c 20 61 6c 6c or occurred, 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 6e 20 4f 50 45 4e 2d 3e 53 rt of an OPEN->S
4530: 48 41 52 45 44 0a 2a 2a 20 74 72 61 6e 73 69 74 HARED.** transit
4540: 69 6f 6e 2c 20 62 79 20 74 68 65 20 73 61 6d 65 ion, by the same
4550: 20 70 61 67 65 72 20 6f 72 20 61 6e 79 20 6f 74 pager or any ot
4560: 68 65 72 29 2e 20 49 66 20 74 68 65 20 63 61 6c her). If the cal
4570: 6c 20 74 6f 20 78 55 6e 6c 6f 63 6b 28 29 0a 2a l to xUnlock().*
4580: 2a 20 66 61 69 6c 73 20 61 74 20 74 68 69 73 20 * fails at this
4590: 70 6f 69 6e 74 20 61 6e 64 20 74 68 65 20 70 61 point and the pa
45a0: 67 65 72 20 69 73 20 6c 65 66 74 20 68 6f 6c 64 ger is left hold
45b0: 69 6e 67 20 61 6e 20 45 58 43 4c 55 53 49 56 45 ing an EXCLUSIVE
45c0: 20 6c 6f 63 6b 2c 20 74 68 69 73 0a 2a 2a 20 63 lock, this.** c
45d0: 61 6e 20 63 6f 6e 66 75 73 65 20 74 68 65 20 63 an confuse the c
45e0: 61 6c 6c 20 74 6f 20 78 43 68 65 63 6b 52 65 73 all to xCheckRes
45f0: 65 72 76 65 64 4c 6f 63 6b 28 29 20 63 61 6c 6c ervedLock() call
4600: 20 6d 61 64 65 20 6c 61 74 65 72 20 61 73 20 70 made later as p
4610: 61 72 74 0a 2a 2a 20 6f 66 20 68 6f 74 2d 6a 6f art.** of hot-jo
4620: 75 72 6e 61 6c 20 64 65 74 65 63 74 69 6f 6e 2e urnal detection.
4630: 0a 2a 2a 0a 2a 2a 20 78 43 68 65 63 6b 52 65 73 .**.** xCheckRes
4640: 65 72 76 65 64 4c 6f 63 6b 28 29 20 69 73 20 64 ervedLock() is d
4650: 65 66 69 6e 65 64 20 61 73 20 72 65 74 75 72 6e efined as return
4660: 69 6e 67 20 74 72 75 65 20 22 69 66 20 74 68 65 ing true "if the
4670: 72 65 20 69 73 20 61 20 52 45 53 45 52 56 45 44 re is a RESERVED
4680: 20 0a 2a 2a 20 6c 6f 63 6b 20 68 65 6c 64 20 62 .** lock held b
4690: 79 20 74 68 69 73 20 70 72 6f 63 65 73 73 20 6f y this process o
46a0: 72 20 61 6e 79 20 6f 74 68 65 72 73 22 2e 20 53 r any others". S
46b0: 6f 20 78 43 68 65 63 6b 52 65 73 65 72 76 65 64 o xCheckReserved
46c0: 4c 6f 63 6b 20 6d 61 79 20 0a 2a 2a 20 72 65 74 Lock may .** ret
46d0: 75 72 6e 20 74 72 75 65 20 62 65 63 61 75 73 65 urn true because
46e0: 20 74 68 65 20 63 61 6c 6c 65 72 20 69 74 73 65 the caller itse
46f0: 6c 66 20 69 73 20 68 6f 6c 64 69 6e 67 20 61 6e lf is holding an
4700: 20 45 58 43 4c 55 53 49 56 45 20 6c 6f 63 6b 20 EXCLUSIVE lock
4710: 28 62 75 74 0a 2a 2a 20 64 6f 65 73 6e 27 74 20 (but.** doesn't
4720: 6b 6e 6f 77 20 69 74 20 62 65 63 61 75 73 65 20 know it because
4730: 6f 66 20 61 20 70 72 65 76 69 6f 75 73 20 65 72 of a previous er
4740: 72 6f 72 20 69 6e 20 78 55 6e 6c 6f 63 6b 29 2e ror in xUnlock).
4750: 20 49 66 20 74 68 69 73 20 68 61 70 70 65 6e 73 If this happens
4760: 0a 2a 2a 20 61 20 68 6f 74 2d 6a 6f 75 72 6e 61 .** a hot-journa
4770: 6c 20 6d 61 79 20 62 65 20 6d 69 73 74 61 6b 65 l may be mistake
4780: 6e 20 66 6f 72 20 61 20 6a 6f 75 72 6e 61 6c 20 n for a journal
4790: 62 65 69 6e 67 20 63 72 65 61 74 65 64 20 62 79 being created by
47a0: 20 61 6e 20 61 63 74 69 76 65 0a 2a 2a 20 74 72 an active.** tr
47b0: 61 6e 73 61 63 74 69 6f 6e 20 69 6e 20 61 6e 6f ansaction in ano
47c0: 74 68 65 72 20 70 72 6f 63 65 73 73 2c 20 63 61 ther process, ca
47d0: 75 73 69 6e 67 20 53 51 4c 69 74 65 20 74 6f 20 using SQLite to
47e0: 72 65 61 64 20 66 72 6f 6d 20 74 68 65 20 64 61 read from the da
47f0: 74 61 62 61 73 65 0a 2a 2a 20 77 69 74 68 6f 75 tabase.** withou
4800: 74 20 72 6f 6c 6c 69 6e 67 20 69 74 20 62 61 63 t rolling it bac
4810: 6b 2e 0a 2a 2a 0a 2a 2a 20 54 6f 20 77 6f 72 6b k..**.** To work
4820: 20 61 72 6f 75 6e 64 20 74 68 69 73 2c 20 69 66 around this, if
4830: 20 61 20 63 61 6c 6c 20 74 6f 20 78 55 6e 6c 6f a call to xUnlo
4840: 63 6b 28 29 20 66 61 69 6c 73 20 77 68 65 6e 20 ck() fails when
4850: 75 6e 6c 6f 63 6b 69 6e 67 20 74 68 65 0a 2a 2a unlocking the.**
4860: 20 64 61 74 61 62 61 73 65 20 69 6e 20 74 68 65 database in the
4870: 20 45 52 52 4f 52 20 73 74 61 74 65 2c 20 50 61 ERROR state, Pa
4880: 67 65 72 2e 65 4c 6f 63 6b 20 69 73 20 73 65 74 ger.eLock is set
4890: 20 74 6f 20 55 4e 4b 4e 4f 57 4e 5f 4c 4f 43 4b to UNKNOWN_LOCK
48a0: 2e 20 49 74 0a 2a 2a 20 69 73 20 6f 6e 6c 79 20 . It.** is only
48b0: 63 68 61 6e 67 65 64 20 62 61 63 6b 20 74 6f 20 changed back to
48c0: 61 20 72 65 61 6c 20 6c 6f 63 6b 69 6e 67 20 73 a real locking s
48d0: 74 61 74 65 20 61 66 74 65 72 20 61 20 73 75 63 tate after a suc
48e0: 63 65 73 73 66 75 6c 20 63 61 6c 6c 0a 2a 2a 20 cessful call.**
48f0: 74 6f 20 78 4c 6f 63 6b 28 45 58 43 4c 55 53 49 to xLock(EXCLUSI
4900: 56 45 29 2e 20 41 6c 73 6f 2c 20 74 68 65 20 63 VE). Also, the c
4910: 6f 64 65 20 74 6f 20 64 6f 20 74 68 65 20 4f 50 ode to do the OP
4920: 45 4e 2d 3e 53 48 41 52 45 44 20 73 74 61 74 65 EN->SHARED state
4930: 20 74 72 61 6e 73 69 74 69 6f 6e 0a 2a 2a 20 6f transition.** o
4940: 6d 69 74 73 20 74 68 65 20 63 68 65 63 6b 20 66 mits the check f
4950: 6f 72 20 61 20 68 6f 74 2d 6a 6f 75 72 6e 61 6c or a hot-journal
4960: 20 69 66 20 50 61 67 65 72 2e 65 4c 6f 63 6b 20 if Pager.eLock
4970: 69 73 20 73 65 74 20 74 6f 20 55 4e 4b 4e 4f 57 is set to UNKNOW
4980: 4e 5f 4c 4f 43 4b 20 0a 2a 2a 20 6c 6f 63 6b 2e N_LOCK .** lock.
4990: 20 49 6e 73 74 65 61 64 2c 20 69 74 20 61 73 73 Instead, it ass
49a0: 75 6d 65 73 20 61 20 68 6f 74 2d 6a 6f 75 72 6e umes a hot-journ
49b0: 61 6c 20 65 78 69 73 74 73 20 61 6e 64 20 6f 62 al exists and ob
49c0: 74 61 69 6e 73 20 61 6e 20 45 58 43 4c 55 53 49 tains an EXCLUSI
49d0: 56 45 0a 2a 2a 20 6c 6f 63 6b 20 6f 6e 20 74 68 VE.** lock on th
49e0: 65 20 64 61 74 61 62 61 73 65 20 66 69 6c 65 20 e database file
49f0: 62 65 66 6f 72 65 20 61 74 74 65 6d 70 74 69 6e before attemptin
4a00: 67 20 74 6f 20 72 6f 6c 6c 20 69 74 20 62 61 63 g to roll it bac
4a10: 6b 2e 20 53 65 65 20 66 75 6e 63 74 69 6f 6e 0a k. See function.
4a20: 2a 2a 20 50 61 67 65 72 53 68 61 72 65 64 4c 6f ** PagerSharedLo
4a30: 63 6b 28 29 20 66 6f 72 20 6d 6f 72 65 20 64 65 ck() for more de
4a40: 74 61 69 6c 2e 0a 2a 2a 0a 2a 2a 20 50 61 67 65 tail..**.** Page
4a50: 72 2e 65 4c 6f 63 6b 20 6d 61 79 20 6f 6e 6c 79 r.eLock may only
4a60: 20 62 65 20 73 65 74 20 74 6f 20 55 4e 4b 4e 4f be set to UNKNO
4a70: 57 4e 5f 4c 4f 43 4b 20 77 68 65 6e 20 74 68 65 WN_LOCK when the
4a80: 20 70 61 67 65 72 20 69 73 20 69 6e 20 0a 2a 2a pager is in .**
4a90: 20 50 41 47 45 52 5f 4f 50 45 4e 20 73 74 61 74 PAGER_OPEN stat
4aa0: 65 2e 0a 2a 2f 0a 23 64 65 66 69 6e 65 20 55 4e e..*/.#define UN
4ab0: 4b 4e 4f 57 4e 5f 4c 4f 43 4b 20 20 20 20 20 20 KNOWN_LOCK
4ac0: 20 20 20 20 20 20 20 20 20 20 28 45 58 43 4c 55 (EXCLU
4ad0: 53 49 56 45 5f 4c 4f 43 4b 2b 31 29 0a 0a 2f 2a SIVE_LOCK+1)../*
4ae0: 0a 2a 2a 20 41 20 6d 61 63 72 6f 20 75 73 65 64 .** A macro used
4af0: 20 66 6f 72 20 69 6e 76 6f 6b 69 6e 67 20 74 68 for invoking th
4b00: 65 20 63 6f 64 65 63 20 69 66 20 74 68 65 72 65 e codec if there
4b10: 20 69 73 20 6f 6e 65 0a 2a 2f 0a 23 69 66 64 65 is one.*/.#ifde
4b20: 66 20 53 51 4c 49 54 45 5f 48 41 53 5f 43 4f 44 f SQLITE_HAS_COD
4b30: 45 43 0a 23 20 64 65 66 69 6e 65 20 43 4f 44 45 EC.# define CODE
4b40: 43 31 28 50 2c 44 2c 4e 2c 58 2c 45 29 20 5c 0a C1(P,D,N,X,E) \.
4b50: 20 20 20 20 69 66 28 20 50 2d 3e 78 43 6f 64 65 if( P->xCode
4b60: 63 20 26 26 20 50 2d 3e 78 43 6f 64 65 63 28 50 c && P->xCodec(P
4b70: 2d 3e 70 43 6f 64 65 63 2c 44 2c 4e 2c 58 29 3d ->pCodec,D,N,X)=
4b80: 3d 30 20 29 7b 20 45 3b 20 7d 0a 23 20 64 65 66 =0 ){ E; }.# def
4b90: 69 6e 65 20 43 4f 44 45 43 32 28 50 2c 44 2c 4e ine CODEC2(P,D,N
4ba0: 2c 58 2c 45 2c 4f 29 20 5c 0a 20 20 20 20 69 66 ,X,E,O) \. if
4bb0: 28 20 50 2d 3e 78 43 6f 64 65 63 3d 3d 30 20 29 ( P->xCodec==0 )
4bc0: 7b 20 4f 3d 28 63 68 61 72 2a 29 44 3b 20 7d 65 { O=(char*)D; }e
4bd0: 6c 73 65 20 5c 0a 20 20 20 20 69 66 28 20 28 4f lse \. if( (O
4be0: 3d 28 63 68 61 72 2a 29 28 50 2d 3e 78 43 6f 64 =(char*)(P->xCod
4bf0: 65 63 28 50 2d 3e 70 43 6f 64 65 63 2c 44 2c 4e ec(P->pCodec,D,N
4c00: 2c 58 29 29 29 3d 3d 30 20 29 7b 20 45 3b 20 7d ,X)))==0 ){ E; }
4c10: 0a 23 65 6c 73 65 0a 23 20 64 65 66 69 6e 65 20 .#else.# define
4c20: 43 4f 44 45 43 31 28 50 2c 44 2c 4e 2c 58 2c 45 CODEC1(P,D,N,X,E
4c30: 29 20 20 20 2f 2a 20 4e 4f 2d 4f 50 20 2a 2f 0a ) /* NO-OP */.
4c40: 23 20 64 65 66 69 6e 65 20 43 4f 44 45 43 32 28 # define CODEC2(
4c50: 50 2c 44 2c 4e 2c 58 2c 45 2c 4f 29 20 4f 3d 28 P,D,N,X,E,O) O=(
4c60: 63 68 61 72 2a 29 44 0a 23 65 6e 64 69 66 0a 0a char*)D.#endif..
4c70: 2f 2a 0a 2a 2a 20 54 68 65 20 6d 61 78 69 6d 75 /*.** The maximu
4c80: 6d 20 61 6c 6c 6f 77 65 64 20 73 65 63 74 6f 72 m allowed sector
4c90: 20 73 69 7a 65 2e 20 36 34 4b 69 42 2e 20 49 66 size. 64KiB. If
4ca0: 20 74 68 65 20 78 53 65 63 74 6f 72 73 69 7a 65 the xSectorsize
4cb0: 28 29 20 6d 65 74 68 6f 64 20 0a 2a 2a 20 72 65 () method .** re
4cc0: 74 75 72 6e 73 20 61 20 76 61 6c 75 65 20 6c 61 turns a value la
4cd0: 72 67 65 72 20 74 68 61 6e 20 74 68 69 73 2c 20 rger than this,
4ce0: 74 68 65 6e 20 4d 41 58 5f 53 45 43 54 4f 52 5f then MAX_SECTOR_
4cf0: 53 49 5a 45 20 69 73 20 75 73 65 64 20 69 6e 73 SIZE is used ins
4d00: 74 65 61 64 2e 0a 2a 2a 20 54 68 69 73 20 63 6f tead..** This co
4d10: 75 6c 64 20 63 6f 6e 63 65 69 76 61 62 6c 79 20 uld conceivably
4d20: 63 61 75 73 65 20 63 6f 72 72 75 70 74 69 6f 6e cause corruption
4d30: 20 66 6f 6c 6c 6f 77 69 6e 67 20 61 20 70 6f 77 following a pow
4d40: 65 72 20 66 61 69 6c 75 72 65 20 6f 6e 0a 2a 2a er failure on.**
4d50: 20 73 75 63 68 20 61 20 73 79 73 74 65 6d 2e 20 such a system.
4d60: 54 68 69 73 20 69 73 20 63 75 72 72 65 6e 74 6c This is currentl
4d70: 79 20 61 6e 20 75 6e 64 6f 63 75 6d 65 6e 74 65 y an undocumente
4d80: 64 20 6c 69 6d 69 74 2e 0a 2a 2f 0a 23 64 65 66 d limit..*/.#def
4d90: 69 6e 65 20 4d 41 58 5f 53 45 43 54 4f 52 5f 53 ine MAX_SECTOR_S
4da0: 49 5a 45 20 30 78 31 30 30 30 30 0a 0a 0a 2f 2a IZE 0x10000.../*
4db0: 0a 2a 2a 20 41 6e 20 69 6e 73 74 61 6e 63 65 20 .** An instance
4dc0: 6f 66 20 74 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 of the following
4dd0: 20 73 74 72 75 63 74 75 72 65 20 69 73 20 61 6c structure is al
4de0: 6c 6f 63 61 74 65 64 20 66 6f 72 20 65 61 63 68 located for each
4df0: 20 61 63 74 69 76 65 0a 2a 2a 20 73 61 76 65 70 active.** savep
4e00: 6f 69 6e 74 20 61 6e 64 20 73 74 61 74 65 6d 65 oint and stateme
4e10: 6e 74 20 74 72 61 6e 73 61 63 74 69 6f 6e 20 69 nt transaction i
4e20: 6e 20 74 68 65 20 73 79 73 74 65 6d 2e 20 41 6c n the system. Al
4e30: 6c 20 73 75 63 68 20 73 74 72 75 63 74 75 72 65 l such structure
4e40: 73 0a 2a 2a 20 61 72 65 20 73 74 6f 72 65 64 20 s.** are stored
4e50: 69 6e 20 74 68 65 20 50 61 67 65 72 2e 61 53 61 in the Pager.aSa
4e60: 76 65 70 6f 69 6e 74 5b 5d 20 61 72 72 61 79 2c vepoint[] array,
4e70: 20 77 68 69 63 68 20 69 73 20 61 6c 6c 6f 63 61 which is alloca
4e80: 74 65 64 20 61 6e 64 0a 2a 2a 20 72 65 73 69 7a ted and.** resiz
4e90: 65 64 20 75 73 69 6e 67 20 73 71 6c 69 74 65 33 ed using sqlite3
4ea0: 52 65 61 6c 6c 6f 63 28 29 2e 0a 2a 2a 0a 2a 2a Realloc()..**.**
4eb0: 20 57 68 65 6e 20 61 20 73 61 76 65 70 6f 69 6e When a savepoin
4ec0: 74 20 69 73 20 63 72 65 61 74 65 64 2c 20 74 68 t is created, th
4ed0: 65 20 50 61 67 65 72 53 61 76 65 70 6f 69 6e 74 e PagerSavepoint
4ee0: 2e 69 48 64 72 4f 66 66 73 65 74 20 66 69 65 6c .iHdrOffset fiel
4ef0: 64 20 69 73 0a 2a 2a 20 73 65 74 20 74 6f 20 30 d is.** set to 0
4f00: 2e 20 49 66 20 61 20 6a 6f 75 72 6e 61 6c 2d 68 . If a journal-h
4f10: 65 61 64 65 72 20 69 73 20 77 72 69 74 74 65 6e eader is written
4f20: 20 69 6e 74 6f 20 74 68 65 20 6d 61 69 6e 20 6a into the main j
4f30: 6f 75 72 6e 61 6c 20 77 68 69 6c 65 0a 2a 2a 20 ournal while.**
4f40: 74 68 65 20 73 61 76 65 70 6f 69 6e 74 20 69 73 the savepoint is
4f50: 20 61 63 74 69 76 65 2c 20 74 68 65 6e 20 69 48 active, then iH
4f60: 64 72 4f 66 66 73 65 74 20 69 73 20 73 65 74 20 drOffset is set
4f70: 74 6f 20 74 68 65 20 62 79 74 65 20 6f 66 66 73 to the byte offs
4f80: 65 74 20 0a 2a 2a 20 69 6d 6d 65 64 69 61 74 65 et .** immediate
4f90: 6c 79 20 66 6f 6c 6c 6f 77 69 6e 67 20 74 68 65 ly following the
4fa0: 20 6c 61 73 74 20 6a 6f 75 72 6e 61 6c 20 72 65 last journal re
4fb0: 63 6f 72 64 20 77 72 69 74 74 65 6e 20 69 6e 74 cord written int
4fc0: 6f 20 74 68 65 20 6d 61 69 6e 0a 2a 2a 20 6a 6f o the main.** jo
4fd0: 75 72 6e 61 6c 20 62 65 66 6f 72 65 20 74 68 65 urnal before the
4fe0: 20 6a 6f 75 72 6e 61 6c 2d 68 65 61 64 65 72 2e journal-header.
4ff0: 20 54 68 69 73 20 69 73 20 72 65 71 75 69 72 65 This is require
5000: 64 20 64 75 72 69 6e 67 20 73 61 76 65 70 6f 69 d during savepoi
5010: 6e 74 0a 2a 2a 20 72 6f 6c 6c 62 61 63 6b 20 28 nt.** rollback (
5020: 73 65 65 20 70 61 67 65 72 50 6c 61 79 62 61 63 see pagerPlaybac
5030: 6b 53 61 76 65 70 6f 69 6e 74 28 29 29 2e 0a 2a kSavepoint())..*
5040: 2f 0a 74 79 70 65 64 65 66 20 73 74 72 75 63 74 /.typedef struct
5050: 20 50 61 67 65 72 53 61 76 65 70 6f 69 6e 74 20 PagerSavepoint
5060: 50 61 67 65 72 53 61 76 65 70 6f 69 6e 74 3b 0a PagerSavepoint;.
5070: 73 74 72 75 63 74 20 50 61 67 65 72 53 61 76 65 struct PagerSave
5080: 70 6f 69 6e 74 20 7b 0a 20 20 69 36 34 20 69 4f point {. i64 iO
5090: 66 66 73 65 74 3b 20 20 20 20 20 20 20 20 20 20 ffset;
50a0: 20 20 20 20 20 20 20 2f 2a 20 53 74 61 72 74 69 /* Starti
50b0: 6e 67 20 6f 66 66 73 65 74 20 69 6e 20 6d 61 69 ng offset in mai
50c0: 6e 20 6a 6f 75 72 6e 61 6c 20 2a 2f 0a 20 20 69 n journal */. i
50d0: 36 34 20 69 48 64 72 4f 66 66 73 65 74 3b 20 20 64 iHdrOffset;
50e0: 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 53 /* S
50f0: 65 65 20 61 62 6f 76 65 20 2a 2f 0a 20 20 42 69 ee above */. Bi
5100: 74 76 65 63 20 2a 70 49 6e 53 61 76 65 70 6f 69 tvec *pInSavepoi
5110: 6e 74 3b 20 20 20 20 20 20 20 20 2f 2a 20 53 65 nt; /* Se
5120: 74 20 6f 66 20 70 61 67 65 73 20 69 6e 20 74 68 t of pages in th
5130: 69 73 20 73 61 76 65 70 6f 69 6e 74 20 2a 2f 0a is savepoint */.
5140: 20 20 50 67 6e 6f 20 6e 4f 72 69 67 3b 20 20 20 Pgno nOrig;
5150: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f /
5160: 2a 20 4f 72 69 67 69 6e 61 6c 20 6e 75 6d 62 65 * Original numbe
5170: 72 20 6f 66 20 70 61 67 65 73 20 69 6e 20 66 69 r of pages in fi
5180: 6c 65 20 2a 2f 0a 20 20 50 67 6e 6f 20 69 53 75 le */. Pgno iSu
5190: 62 52 65 63 3b 20 20 20 20 20 20 20 20 20 20 20 bRec;
51a0: 20 20 20 20 20 2f 2a 20 49 6e 64 65 78 20 6f 66 /* Index of
51b0: 20 66 69 72 73 74 20 72 65 63 6f 72 64 20 69 6e first record in
51c0: 20 73 75 62 2d 6a 6f 75 72 6e 61 6c 20 2a 2f 0a sub-journal */.
51d0: 23 69 66 6e 64 65 66 20 53 51 4c 49 54 45 5f 4f #ifndef SQLITE_O
51e0: 4d 49 54 5f 57 41 4c 0a 20 20 75 33 32 20 61 57 MIT_WAL. u32 aW
51f0: 61 6c 44 61 74 61 5b 57 41 4c 5f 53 41 56 45 50 alData[WAL_SAVEP
5200: 4f 49 4e 54 5f 4e 44 41 54 41 5d 3b 20 20 20 20 OINT_NDATA];
5210: 20 20 20 20 2f 2a 20 57 41 4c 20 73 61 76 65 70 /* WAL savep
5220: 6f 69 6e 74 20 63 6f 6e 74 65 78 74 20 2a 2f 0a oint context */.
5230: 23 65 6e 64 69 66 0a 7d 3b 0a 0a 2f 2a 0a 2a 2a #endif.};../*.**
5240: 20 42 69 74 73 20 6f 66 20 74 68 65 20 50 61 67 Bits of the Pag
5250: 65 72 2e 64 6f 4e 6f 74 53 70 69 6c 6c 20 66 6c er.doNotSpill fl
5260: 61 67 2e 20 20 53 65 65 20 66 75 72 74 68 65 72 ag. See further
5270: 20 64 65 73 63 72 69 70 74 69 6f 6e 20 62 65 6c description bel
5280: 6f 77 2e 0a 2a 2f 0a 23 64 65 66 69 6e 65 20 53 ow..*/.#define S
5290: 50 49 4c 4c 46 4c 41 47 5f 4f 46 46 20 20 20 20 PILLFLAG_OFF
52a0: 20 20 20 20 20 30 78 30 31 20 2f 2a 20 4e 65 76 0x01 /* Nev
52b0: 65 72 20 73 70 69 6c 6c 20 63 61 63 68 65 2e 20 er spill cache.
52c0: 20 53 65 74 20 76 69 61 20 70 72 61 67 6d 61 20 Set via pragma
52d0: 2a 2f 0a 23 64 65 66 69 6e 65 20 53 50 49 4c 4c */.#define SPILL
52e0: 46 4c 41 47 5f 52 4f 4c 4c 42 41 43 4b 20 20 20 FLAG_ROLLBACK
52f0: 20 30 78 30 32 20 2f 2a 20 43 75 72 72 65 6e 74 0x02 /* Current
5300: 20 72 6f 6c 6c 69 6e 67 20 62 61 63 6b 2c 20 73 rolling back, s
5310: 6f 20 64 6f 20 6e 6f 74 20 73 70 69 6c 6c 20 2a o do not spill *
5320: 2f 0a 23 64 65 66 69 6e 65 20 53 50 49 4c 4c 46 /.#define SPILLF
5330: 4c 41 47 5f 4e 4f 53 59 4e 43 20 20 20 20 20 20 LAG_NOSYNC
5340: 30 78 30 34 20 2f 2a 20 53 70 69 6c 6c 20 69 73 0x04 /* Spill is
5350: 20 6f 6b 2c 20 62 75 74 20 64 6f 20 6e 6f 74 20 ok, but do not
5360: 73 79 6e 63 20 2a 2f 0a 0a 2f 2a 0a 2a 2a 20 41 sync */../*.** A
5370: 6e 20 6f 70 65 6e 20 70 61 67 65 20 63 61 63 68 n open page cach
5380: 65 20 69 73 20 61 6e 20 69 6e 73 74 61 6e 63 65 e is an instance
5390: 20 6f 66 20 73 74 72 75 63 74 20 50 61 67 65 72 of struct Pager
53a0: 2e 20 41 20 64 65 73 63 72 69 70 74 69 6f 6e 20 . A description
53b0: 6f 66 0a 2a 2a 20 73 6f 6d 65 20 6f 66 20 74 68 of.** some of th
53c0: 65 20 6d 6f 72 65 20 69 6d 70 6f 72 74 61 6e 74 e more important
53d0: 20 6d 65 6d 62 65 72 20 76 61 72 69 61 62 6c 65 member variable
53e0: 73 20 66 6f 6c 6c 6f 77 73 3a 0a 2a 2a 0a 2a 2a s follows:.**.**
53f0: 20 65 53 74 61 74 65 0a 2a 2a 0a 2a 2a 20 20 20 eState.**.**
5400: 54 68 65 20 63 75 72 72 65 6e 74 20 27 73 74 61 The current 'sta
5410: 74 65 27 20 6f 66 20 74 68 65 20 70 61 67 65 72 te' of the pager
5420: 20 6f 62 6a 65 63 74 2e 20 53 65 65 20 74 68 65 object. See the
5430: 20 63 6f 6d 6d 65 6e 74 20 61 6e 64 20 73 74 61 comment and sta
5440: 74 65 0a 2a 2a 20 20 20 64 69 61 67 72 61 6d 20 te.** diagram
5450: 61 62 6f 76 65 20 66 6f 72 20 61 20 64 65 73 63 above for a desc
5460: 72 69 70 74 69 6f 6e 20 6f 66 20 74 68 65 20 70 ription of the p
5470: 61 67 65 72 20 73 74 61 74 65 2e 0a 2a 2a 0a 2a ager state..**.*
5480: 2a 20 65 4c 6f 63 6b 0a 2a 2a 0a 2a 2a 20 20 20 * eLock.**.**
5490: 46 6f 72 20 61 20 72 65 61 6c 20 6f 6e 2d 64 69 For a real on-di
54a0: 73 6b 20 64 61 74 61 62 61 73 65 2c 20 74 68 65 sk database, the
54b0: 20 63 75 72 72 65 6e 74 20 6c 6f 63 6b 20 68 65 current lock he
54c0: 6c 64 20 6f 6e 20 74 68 65 20 64 61 74 61 62 61 ld on the databa
54d0: 73 65 20 66 69 6c 65 20 2d 0a 2a 2a 20 20 20 4e se file -.** N
54e0: 4f 5f 4c 4f 43 4b 2c 20 53 48 41 52 45 44 5f 4c O_LOCK, SHARED_L
54f0: 4f 43 4b 2c 20 52 45 53 45 52 56 45 44 5f 4c 4f OCK, RESERVED_LO
5500: 43 4b 20 6f 72 20 45 58 43 4c 55 53 49 56 45 5f CK or EXCLUSIVE_
5510: 4c 4f 43 4b 2e 0a 2a 2a 0a 2a 2a 20 20 20 46 6f LOCK..**.** Fo
5520: 72 20 61 20 74 65 6d 70 6f 72 61 72 79 20 6f 72 r a temporary or
5530: 20 69 6e 2d 6d 65 6d 6f 72 79 20 64 61 74 61 62 in-memory datab
5540: 61 73 65 20 28 6e 65 69 74 68 65 72 20 6f 66 20 ase (neither of
5550: 77 68 69 63 68 20 72 65 71 75 69 72 65 20 61 6e which require an
5560: 79 0a 2a 2a 20 20 20 6c 6f 63 6b 73 29 2c 20 74 y.** locks), t
5570: 68 69 73 20 76 61 72 69 61 62 6c 65 20 69 73 20 his variable is
5580: 61 6c 77 61 79 73 20 73 65 74 20 74 6f 20 45 58 always set to EX
5590: 43 4c 55 53 49 56 45 5f 4c 4f 43 4b 2e 20 53 69 CLUSIVE_LOCK. Si
55a0: 6e 63 65 20 73 75 63 68 0a 2a 2a 20 20 20 64 61 nce such.** da
55b0: 74 61 62 61 73 65 73 20 61 6c 77 61 79 73 20 68 tabases always h
55c0: 61 76 65 20 50 61 67 65 72 2e 65 78 63 6c 75 73 ave Pager.exclus
55d0: 69 76 65 4d 6f 64 65 3d 3d 31 2c 20 74 68 69 73 iveMode==1, this
55e0: 20 74 72 69 63 6b 73 20 74 68 65 20 70 61 67 65 tricks the page
55f0: 72 0a 2a 2a 20 20 20 6c 6f 67 69 63 20 69 6e 74 r.** logic int
5600: 6f 20 74 68 69 6e 6b 69 6e 67 20 74 68 61 74 20 o thinking that
5610: 69 74 20 61 6c 72 65 61 64 79 20 68 61 73 20 61 it already has a
5620: 6c 6c 20 74 68 65 20 6c 6f 63 6b 73 20 69 74 20 ll the locks it
5630: 77 69 6c 6c 20 65 76 65 72 0a 2a 2a 20 20 20 6e will ever.** n
5640: 65 65 64 20 28 61 6e 64 20 6e 6f 20 72 65 61 73 eed (and no reas
5650: 6f 6e 20 74 6f 20 72 65 6c 65 61 73 65 20 74 68 on to release th
5660: 65 6d 29 2e 0a 2a 2a 0a 2a 2a 20 20 20 49 6e 20 em)..**.** In
5670: 73 6f 6d 65 20 28 6f 62 73 63 75 72 65 29 20 63 some (obscure) c
5680: 69 72 63 75 6d 73 74 61 6e 63 65 73 2c 20 74 68 ircumstances, th
5690: 69 73 20 76 61 72 69 61 62 6c 65 20 6d 61 79 20 is variable may
56a0: 61 6c 73 6f 20 62 65 20 73 65 74 20 74 6f 0a 2a also be set to.*
56b0: 2a 20 20 20 55 4e 4b 4e 4f 57 4e 5f 4c 4f 43 4b * UNKNOWN_LOCK
56c0: 2e 20 53 65 65 20 74 68 65 20 63 6f 6d 6d 65 6e . See the commen
56d0: 74 20 61 62 6f 76 65 20 74 68 65 20 23 64 65 66 t above the #def
56e0: 69 6e 65 20 6f 66 20 55 4e 4b 4e 4f 57 4e 5f 4c ine of UNKNOWN_L
56f0: 4f 43 4b 20 66 6f 72 0a 2a 2a 20 20 20 64 65 74 OCK for.** det
5700: 61 69 6c 73 2e 0a 2a 2a 0a 2a 2a 20 63 68 61 6e ails..**.** chan
5710: 67 65 43 6f 75 6e 74 44 6f 6e 65 0a 2a 2a 0a 2a geCountDone.**.*
5720: 2a 20 20 20 54 68 69 73 20 62 6f 6f 6c 65 61 6e * This boolean
5730: 20 76 61 72 69 61 62 6c 65 20 69 73 20 75 73 65 variable is use
5740: 64 20 74 6f 20 6d 61 6b 65 20 73 75 72 65 20 74 d to make sure t
5750: 68 61 74 20 74 68 65 20 63 68 61 6e 67 65 2d 63 hat the change-c
5760: 6f 75 6e 74 65 72 20 0a 2a 2a 20 20 20 28 74 68 ounter .** (th
5770: 65 20 34 2d 62 79 74 65 20 68 65 61 64 65 72 20 e 4-byte header
5780: 66 69 65 6c 64 20 61 74 20 62 79 74 65 20 6f 66 field at byte of
5790: 66 73 65 74 20 32 34 20 6f 66 20 74 68 65 20 64 fset 24 of the d
57a0: 61 74 61 62 61 73 65 20 66 69 6c 65 29 20 69 73 atabase file) is
57b0: 20 0a 2a 2a 20 20 20 6e 6f 74 20 75 70 64 61 74 .** not updat
57c0: 65 64 20 6d 6f 72 65 20 6f 66 74 65 6e 20 74 68 ed more often th
57d0: 61 6e 20 6e 65 63 65 73 73 61 72 79 2e 20 0a 2a an necessary. .*
57e0: 2a 0a 2a 2a 20 20 20 49 74 20 69 73 20 73 65 74 *.** It is set
57f0: 20 74 6f 20 74 72 75 65 20 77 68 65 6e 20 74 68 to true when th
5800: 65 20 63 68 61 6e 67 65 2d 63 6f 75 6e 74 65 72 e change-counter
5810: 20 66 69 65 6c 64 20 69 73 20 75 70 64 61 74 65 field is update
5820: 64 2c 20 77 68 69 63 68 20 0a 2a 2a 20 20 20 63 d, which .** c
5830: 61 6e 20 6f 6e 6c 79 20 68 61 70 70 65 6e 20 69 an only happen i
5840: 66 20 61 6e 20 65 78 63 6c 75 73 69 76 65 20 6c f an exclusive l
5850: 6f 63 6b 20 69 73 20 68 65 6c 64 20 6f 6e 20 74 ock is held on t
5860: 68 65 20 64 61 74 61 62 61 73 65 20 66 69 6c 65 he database file
5870: 2e 0a 2a 2a 20 20 20 49 74 20 69 73 20 63 6c 65 ..** It is cle
5880: 61 72 65 64 20 28 73 65 74 20 74 6f 20 66 61 6c ared (set to fal
5890: 73 65 29 20 77 68 65 6e 65 76 65 72 20 61 6e 20 se) whenever an
58a0: 65 78 63 6c 75 73 69 76 65 20 6c 6f 63 6b 20 69 exclusive lock i
58b0: 73 20 0a 2a 2a 20 20 20 72 65 6c 69 6e 71 75 69 s .** relinqui
58c0: 73 68 65 64 20 6f 6e 20 74 68 65 20 64 61 74 61 shed on the data
58d0: 62 61 73 65 20 66 69 6c 65 2e 20 45 61 63 68 20 base file. Each
58e0: 74 69 6d 65 20 61 20 74 72 61 6e 73 61 63 74 69 time a transacti
58f0: 6f 6e 20 69 73 20 63 6f 6d 6d 69 74 74 65 64 2c on is committed,
5900: 0a 2a 2a 20 20 20 54 68 65 20 63 68 61 6e 67 65 .** The change
5910: 43 6f 75 6e 74 44 6f 6e 65 20 66 6c 61 67 20 69 CountDone flag i
5920: 73 20 69 6e 73 70 65 63 74 65 64 2e 20 49 66 20 s inspected. If
5930: 69 74 20 69 73 20 74 72 75 65 2c 20 74 68 65 20 it is true, the
5940: 77 6f 72 6b 20 6f 66 0a 2a 2a 20 20 20 75 70 64 work of.** upd
5950: 61 74 69 6e 67 20 74 68 65 20 63 68 61 6e 67 65 ating the change
5960: 2d 63 6f 75 6e 74 65 72 20 69 73 20 6f 6d 69 74 -counter is omit
5970: 74 65 64 20 66 6f 72 20 74 68 65 20 63 75 72 72 ted for the curr
5980: 65 6e 74 20 74 72 61 6e 73 61 63 74 69 6f 6e 2e ent transaction.
5990: 0a 2a 2a 0a 2a 2a 20 20 20 54 68 69 73 20 6d 65 .**.** This me
59a0: 63 68 61 6e 69 73 6d 20 6d 65 61 6e 73 20 74 68 chanism means th
59b0: 61 74 20 77 68 65 6e 20 72 75 6e 6e 69 6e 67 20 at when running
59c0: 69 6e 20 65 78 63 6c 75 73 69 76 65 20 6d 6f 64 in exclusive mod
59d0: 65 2c 20 61 20 63 6f 6e 6e 65 63 74 69 6f 6e 20 e, a connection
59e0: 0a 2a 2a 20 20 20 6e 65 65 64 20 6f 6e 6c 79 20 .** need only
59f0: 75 70 64 61 74 65 20 74 68 65 20 63 68 61 6e 67 update the chang
5a00: 65 2d 63 6f 75 6e 74 65 72 20 6f 6e 63 65 2c 20 e-counter once,
5a10: 66 6f 72 20 74 68 65 20 66 69 72 73 74 20 74 72 for the first tr
5a20: 61 6e 73 61 63 74 69 6f 6e 0a 2a 2a 20 20 20 63 ansaction.** c
5a30: 6f 6d 6d 69 74 74 65 64 2e 0a 2a 2a 0a 2a 2a 20 ommitted..**.**
5a40: 73 65 74 4d 61 73 74 65 72 0a 2a 2a 0a 2a 2a 20 setMaster.**.**
5a50: 20 20 57 68 65 6e 20 50 61 67 65 72 43 6f 6d 6d When PagerComm
5a60: 69 74 50 68 61 73 65 4f 6e 65 28 29 20 69 73 20 itPhaseOne() is
5a70: 63 61 6c 6c 65 64 20 74 6f 20 63 6f 6d 6d 69 74 called to commit
5a80: 20 61 20 74 72 61 6e 73 61 63 74 69 6f 6e 2c 20 a transaction,
5a90: 69 74 20 6d 61 79 0a 2a 2a 20 20 20 28 6f 72 20 it may.** (or
5aa0: 6d 61 79 20 6e 6f 74 29 20 73 70 65 63 69 66 79 may not) specify
5ab0: 20 61 20 6d 61 73 74 65 72 2d 6a 6f 75 72 6e 61 a master-journa
5ac0: 6c 20 6e 61 6d 65 20 74 6f 20 62 65 20 77 72 69 l name to be wri
5ad0: 74 74 65 6e 20 69 6e 74 6f 20 74 68 65 20 0a 2a tten into the .*
5ae0: 2a 20 20 20 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 * journal file
5af0: 20 62 65 66 6f 72 65 20 69 74 20 69 73 20 73 79 before it is sy
5b00: 6e 63 65 64 20 74 6f 20 64 69 73 6b 2e 0a 2a 2a nced to disk..**
5b10: 0a 2a 2a 20 20 20 57 68 65 74 68 65 72 20 6f 72 .** Whether or
5b20: 20 6e 6f 74 20 61 20 6a 6f 75 72 6e 61 6c 20 66 not a journal f
5b30: 69 6c 65 20 63 6f 6e 74 61 69 6e 73 20 61 20 6d ile contains a m
5b40: 61 73 74 65 72 2d 6a 6f 75 72 6e 61 6c 20 70 6f aster-journal po
5b50: 69 6e 74 65 72 20 61 66 66 65 63 74 73 20 0a 2a inter affects .*
5b60: 2a 20 20 20 74 68 65 20 77 61 79 20 69 6e 20 77 * the way in w
5b70: 68 69 63 68 20 74 68 65 20 6a 6f 75 72 6e 61 6c hich the journal
5b80: 20 66 69 6c 65 20 69 73 20 66 69 6e 61 6c 69 7a file is finaliz
5b90: 65 64 20 61 66 74 65 72 20 74 68 65 20 74 72 61 ed after the tra
5ba0: 6e 73 61 63 74 69 6f 6e 20 69 73 20 0a 2a 2a 20 nsaction is .**
5bb0: 20 20 63 6f 6d 6d 69 74 74 65 64 20 6f 72 20 72 committed or r
5bc0: 6f 6c 6c 65 64 20 62 61 63 6b 20 77 68 65 6e 20 olled back when
5bd0: 72 75 6e 6e 69 6e 67 20 69 6e 20 22 6a 6f 75 72 running in "jour
5be0: 6e 61 6c 5f 6d 6f 64 65 3d 50 45 52 53 49 53 54 nal_mode=PERSIST
5bf0: 22 20 6d 6f 64 65 2e 0a 2a 2a 20 20 20 49 66 20 " mode..** If
5c00: 61 20 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 20 64 a journal file d
5c10: 6f 65 73 20 6e 6f 74 20 63 6f 6e 74 61 69 6e 20 oes not contain
5c20: 61 20 6d 61 73 74 65 72 2d 6a 6f 75 72 6e 61 6c a master-journal
5c30: 20 70 6f 69 6e 74 65 72 2c 20 69 74 20 69 73 0a pointer, it is.
5c40: 2a 2a 20 20 20 66 69 6e 61 6c 69 7a 65 64 20 62 ** finalized b
5c50: 79 20 6f 76 65 72 77 72 69 74 69 6e 67 20 74 68 y overwriting th
5c60: 65 20 66 69 72 73 74 20 6a 6f 75 72 6e 61 6c 20 e first journal
5c70: 68 65 61 64 65 72 20 77 69 74 68 20 7a 65 72 6f header with zero
5c80: 65 73 2e 20 49 66 0a 2a 2a 20 20 20 69 74 20 64 es. If.** it d
5c90: 6f 65 73 20 63 6f 6e 74 61 69 6e 20 61 20 6d 61 oes contain a ma
5ca0: 73 74 65 72 2d 6a 6f 75 72 6e 61 6c 20 70 6f 69 ster-journal poi
5cb0: 6e 74 65 72 20 74 68 65 20 6a 6f 75 72 6e 61 6c nter the journal
5cc0: 20 66 69 6c 65 20 69 73 20 66 69 6e 61 6c 69 7a file is finaliz
5cd0: 65 64 20 0a 2a 2a 20 20 20 62 79 20 74 72 75 6e ed .** by trun
5ce0: 63 61 74 69 6e 67 20 69 74 20 74 6f 20 7a 65 72 cating it to zer
5cf0: 6f 20 62 79 74 65 73 2c 20 6a 75 73 74 20 61 73 o bytes, just as
5d00: 20 69 66 20 74 68 65 20 63 6f 6e 6e 65 63 74 69 if the connecti
5d10: 6f 6e 20 77 65 72 65 20 0a 2a 2a 20 20 20 72 75 on were .** ru
5d20: 6e 6e 69 6e 67 20 69 6e 20 22 6a 6f 75 72 6e 61 nning in "journa
5d30: 6c 5f 6d 6f 64 65 3d 74 72 75 6e 63 61 74 65 22 l_mode=truncate"
5d40: 20 6d 6f 64 65 2e 0a 2a 2a 0a 2a 2a 20 20 20 4a mode..**.** J
5d50: 6f 75 72 6e 61 6c 20 66 69 6c 65 73 20 74 68 61 ournal files tha
5d60: 74 20 63 6f 6e 74 61 69 6e 20 6d 61 73 74 65 72 t contain master
5d70: 20 6a 6f 75 72 6e 61 6c 20 70 6f 69 6e 74 65 72 journal pointer
5d80: 73 20 63 61 6e 6e 6f 74 20 62 65 20 66 69 6e 61 s cannot be fina
5d90: 6c 69 7a 65 64 0a 2a 2a 20 20 20 73 69 6d 70 6c lized.** simpl
5da0: 79 20 62 79 20 6f 76 65 72 77 72 69 74 69 6e 67 y by overwriting
5db0: 20 74 68 65 20 66 69 72 73 74 20 6a 6f 75 72 6e the first journ
5dc0: 61 6c 2d 68 65 61 64 65 72 20 77 69 74 68 20 7a al-header with z
5dd0: 65 72 6f 65 73 2c 20 61 73 20 74 68 65 0a 2a 2a eroes, as the.**
5de0: 20 20 20 6d 61 73 74 65 72 20 6a 6f 75 72 6e 61 master journa
5df0: 6c 20 70 6f 69 6e 74 65 72 20 63 6f 75 6c 64 20 l pointer could
5e00: 69 6e 74 65 72 66 65 72 65 20 77 69 74 68 20 68 interfere with h
5e10: 6f 74 2d 6a 6f 75 72 6e 61 6c 20 72 6f 6c 6c 62 ot-journal rollb
5e20: 61 63 6b 20 6f 66 20 61 6e 79 0a 2a 2a 20 20 20 ack of any.**
5e30: 73 75 62 73 65 71 75 65 6e 74 6c 79 20 69 6e 74 subsequently int
5e40: 65 72 72 75 70 74 65 64 20 74 72 61 6e 73 61 63 errupted transac
5e50: 74 69 6f 6e 20 74 68 61 74 20 72 65 75 73 65 73 tion that reuses
5e60: 20 74 68 65 20 6a 6f 75 72 6e 61 6c 20 66 69 6c the journal fil
5e70: 65 2e 0a 2a 2a 0a 2a 2a 20 20 20 54 68 65 20 66 e..**.** The f
5e80: 6c 61 67 20 69 73 20 63 6c 65 61 72 65 64 20 61 lag is cleared a
5e90: 73 20 73 6f 6f 6e 20 61 73 20 74 68 65 20 6a 6f s soon as the jo
5ea0: 75 72 6e 61 6c 20 66 69 6c 65 20 69 73 20 66 69 urnal file is fi
5eb0: 6e 61 6c 69 7a 65 64 20 28 65 69 74 68 65 72 0a nalized (either.
5ec0: 2a 2a 20 20 20 62 79 20 50 61 67 65 72 43 6f 6d ** by PagerCom
5ed0: 6d 69 74 50 68 61 73 65 54 77 6f 20 6f 72 20 50 mitPhaseTwo or P
5ee0: 61 67 65 72 52 6f 6c 6c 62 61 63 6b 29 2e 20 49 agerRollback). I
5ef0: 66 20 61 6e 20 49 4f 20 65 72 72 6f 72 20 70 72 f an IO error pr
5f00: 65 76 65 6e 74 73 20 74 68 65 0a 2a 2a 20 20 20 events the.**
5f10: 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 20 66 72 6f journal file fro
5f20: 6d 20 62 65 69 6e 67 20 73 75 63 63 65 73 73 66 m being successf
5f30: 75 6c 6c 79 20 66 69 6e 61 6c 69 7a 65 64 2c 20 ully finalized,
5f40: 74 68 65 20 73 65 74 4d 61 73 74 65 72 20 66 6c the setMaster fl
5f50: 61 67 0a 2a 2a 20 20 20 69 73 20 63 6c 65 61 72 ag.** is clear
5f60: 65 64 20 61 6e 79 77 61 79 20 28 61 6e 64 20 74 ed anyway (and t
5f70: 68 65 20 70 61 67 65 72 20 77 69 6c 6c 20 6d 6f he pager will mo
5f80: 76 65 20 74 6f 20 45 52 52 4f 52 20 73 74 61 74 ve to ERROR stat
5f90: 65 29 2e 0a 2a 2a 0a 2a 2a 20 64 6f 4e 6f 74 53 e)..**.** doNotS
5fa0: 70 69 6c 6c 0a 2a 2a 0a 2a 2a 20 20 20 54 68 69 pill.**.** Thi
5fb0: 73 20 76 61 72 69 61 62 6c 65 73 20 63 6f 6e 74 s variables cont
5fc0: 72 6f 6c 20 74 68 65 20 62 65 68 61 76 69 6f 72 rol the behavior
5fd0: 20 6f 66 20 63 61 63 68 65 2d 73 70 69 6c 6c 73 of cache-spills
5fe0: 20 20 28 63 61 6c 6c 73 20 6d 61 64 65 20 62 79 (calls made by
5ff0: 0a 2a 2a 20 20 20 74 68 65 20 70 63 61 63 68 65 .** the pcache
6000: 20 6d 6f 64 75 6c 65 20 74 6f 20 74 68 65 20 70 module to the p
6010: 61 67 65 72 53 74 72 65 73 73 28 29 20 72 6f 75 agerStress() rou
6020: 74 69 6e 65 20 74 6f 20 77 72 69 74 65 20 63 61 tine to write ca
6030: 63 68 65 64 20 64 61 74 61 0a 2a 2a 20 20 20 74 ched data.** t
6040: 6f 20 74 68 65 20 66 69 6c 65 2d 73 79 73 74 65 o the file-syste
6050: 6d 20 69 6e 20 6f 72 64 65 72 20 74 6f 20 66 72 m in order to fr
6060: 65 65 20 75 70 20 6d 65 6d 6f 72 79 29 2e 0a 2a ee up memory)..*
6070: 2a 0a 2a 2a 20 20 20 57 68 65 6e 20 62 69 74 73 *.** When bits
6080: 20 53 50 49 4c 4c 46 4c 41 47 5f 4f 46 46 20 6f SPILLFLAG_OFF o
6090: 72 20 53 50 49 4c 4c 46 4c 41 47 5f 52 4f 4c 4c r SPILLFLAG_ROLL
60a0: 42 41 43 4b 20 6f 66 20 64 6f 4e 6f 74 53 70 69 BACK of doNotSpi
60b0: 6c 6c 20 61 72 65 20 73 65 74 2c 0a 2a 2a 20 20 ll are set,.**
60c0: 20 77 72 69 74 69 6e 67 20 74 6f 20 74 68 65 20 writing to the
60d0: 64 61 74 61 62 61 73 65 20 66 72 6f 6d 20 70 61 database from pa
60e0: 67 65 72 53 74 72 65 73 73 28 29 20 69 73 20 64 gerStress() is d
60f0: 69 73 61 62 6c 65 64 20 61 6c 74 6f 67 65 74 68 isabled altogeth
6100: 65 72 2e 0a 2a 2a 20 20 20 54 68 65 20 53 50 49 er..** The SPI
6110: 4c 4c 46 4c 41 47 5f 52 4f 4c 4c 42 41 43 4b 20 LLFLAG_ROLLBACK
6120: 63 61 73 65 20 69 73 20 64 6f 6e 65 20 69 6e 20 case is done in
6130: 61 20 76 65 72 79 20 6f 62 73 63 75 72 65 20 63 a very obscure c
6140: 61 73 65 20 74 68 61 74 0a 2a 2a 20 20 20 63 6f ase that.** co
6150: 6d 65 73 20 75 70 20 64 75 72 69 6e 67 20 73 61 mes up during sa
6160: 76 65 70 6f 69 6e 74 20 72 6f 6c 6c 62 61 63 6b vepoint rollback
6170: 20 74 68 61 74 20 72 65 71 75 69 72 65 73 20 74 that requires t
6180: 68 65 20 70 63 61 63 68 65 20 6d 6f 64 75 6c 65 he pcache module
6190: 0a 2a 2a 20 20 20 74 6f 20 61 6c 6c 6f 63 61 74 .** to allocat
61a0: 65 20 61 20 6e 65 77 20 70 61 67 65 20 74 6f 20 e a new page to
61b0: 70 72 65 76 65 6e 74 20 74 68 65 20 6a 6f 75 72 prevent the jour
61c0: 6e 61 6c 20 66 69 6c 65 20 66 72 6f 6d 20 62 65 nal file from be
61d0: 69 6e 67 20 77 72 69 74 74 65 6e 0a 2a 2a 20 20 ing written.**
61e0: 20 77 68 69 6c 65 20 69 74 20 69 73 20 62 65 69 while it is bei
61f0: 6e 67 20 74 72 61 76 65 72 73 65 64 20 62 79 20 ng traversed by
6200: 63 6f 64 65 20 69 6e 20 70 61 67 65 72 5f 70 6c code in pager_pl
6210: 61 79 62 61 63 6b 28 29 2e 20 20 54 68 65 20 53 ayback(). The S
6220: 50 49 4c 4c 46 4c 41 47 5f 4f 46 46 0a 2a 2a 20 PILLFLAG_OFF.**
6230: 20 20 63 61 73 65 20 69 73 20 61 20 75 73 65 72 case is a user
6240: 20 70 72 65 66 65 72 65 6e 63 65 2e 0a 2a 2a 20 preference..**
6250: 0a 2a 2a 20 20 20 49 66 20 74 68 65 20 53 50 49 .** If the SPI
6260: 4c 4c 46 4c 41 47 5f 4e 4f 53 59 4e 43 20 62 69 LLFLAG_NOSYNC bi
6270: 74 20 69 73 20 73 65 74 2c 20 77 72 69 74 69 6e t is set, writin
6280: 67 20 74 6f 20 74 68 65 20 64 61 74 61 62 61 73 g to the databas
6290: 65 20 66 72 6f 6d 0a 2a 2a 20 20 20 70 61 67 65 e from.** page
62a0: 72 53 74 72 65 73 73 28 29 20 69 73 20 70 65 72 rStress() is per
62b0: 6d 69 74 74 65 64 2c 20 62 75 74 20 73 79 6e 63 mitted, but sync
62c0: 69 6e 67 20 74 68 65 20 6a 6f 75 72 6e 61 6c 20 ing the journal
62d0: 66 69 6c 65 20 69 73 20 6e 6f 74 2e 0a 2a 2a 20 file is not..**
62e0: 20 20 54 68 69 73 20 66 6c 61 67 20 69 73 20 73 This flag is s
62f0: 65 74 20 62 79 20 73 71 6c 69 74 65 33 50 61 67 et by sqlite3Pag
6300: 65 72 57 72 69 74 65 28 29 20 77 68 65 6e 20 74 erWrite() when t
6310: 68 65 20 66 69 6c 65 2d 73 79 73 74 65 6d 20 73 he file-system s
6320: 65 63 74 6f 72 2d 73 69 7a 65 0a 2a 2a 20 20 20 ector-size.**
6330: 69 73 20 6c 61 72 67 65 72 20 74 68 61 6e 20 74 is larger than t
6340: 68 65 20 64 61 74 61 62 61 73 65 20 70 61 67 65 he database page
6350: 2d 73 69 7a 65 20 69 6e 20 6f 72 64 65 72 20 74 -size in order t
6360: 6f 20 70 72 65 76 65 6e 74 20 61 20 6a 6f 75 72 o prevent a jour
6370: 6e 61 6c 20 73 79 6e 63 0a 2a 2a 20 20 20 66 72 nal sync.** fr
6380: 6f 6d 20 68 61 70 70 65 6e 69 6e 67 20 69 6e 20 om happening in
6390: 62 65 74 77 65 65 6e 20 74 68 65 20 6a 6f 75 72 between the jour
63a0: 6e 61 6c 6c 69 6e 67 20 6f 66 20 74 77 6f 20 70 nalling of two p
63b0: 61 67 65 73 20 6f 6e 20 74 68 65 20 73 61 6d 65 ages on the same
63c0: 20 73 65 63 74 6f 72 2e 20 0a 2a 2a 0a 2a 2a 20 sector. .**.**
63d0: 73 75 62 6a 49 6e 4d 65 6d 6f 72 79 0a 2a 2a 0a subjInMemory.**.
63e0: 2a 2a 20 20 20 54 68 69 73 20 69 73 20 61 20 62 ** This is a b
63f0: 6f 6f 6c 65 61 6e 20 76 61 72 69 61 62 6c 65 2e oolean variable.
6400: 20 49 66 20 74 72 75 65 2c 20 74 68 65 6e 20 61 If true, then a
6410: 6e 79 20 72 65 71 75 69 72 65 64 20 73 75 62 2d ny required sub-
6420: 6a 6f 75 72 6e 61 6c 0a 2a 2a 20 20 20 69 73 20 journal.** is
6430: 6f 70 65 6e 65 64 20 61 73 20 61 6e 20 69 6e 2d opened as an in-
6440: 6d 65 6d 6f 72 79 20 6a 6f 75 72 6e 61 6c 20 66 memory journal f
6450: 69 6c 65 2e 20 49 66 20 66 61 6c 73 65 2c 20 74 ile. If false, t
6460: 68 65 6e 20 69 6e 2d 6d 65 6d 6f 72 79 0a 2a 2a hen in-memory.**
6470: 20 20 20 73 75 62 2d 6a 6f 75 72 6e 61 6c 73 20 sub-journals
6480: 61 72 65 20 6f 6e 6c 79 20 75 73 65 64 20 66 6f are only used fo
6490: 72 20 69 6e 2d 6d 65 6d 6f 72 79 20 70 61 67 65 r in-memory page
64a0: 72 20 66 69 6c 65 73 2e 0a 2a 2a 0a 2a 2a 20 20 r files..**.**
64b0: 20 54 68 69 73 20 76 61 72 69 61 62 6c 65 20 69 This variable i
64c0: 73 20 75 70 64 61 74 65 64 20 62 79 20 74 68 65 s updated by the
64d0: 20 75 70 70 65 72 20 6c 61 79 65 72 20 65 61 63 upper layer eac
64e0: 68 20 74 69 6d 65 20 61 20 6e 65 77 20 0a 2a 2a h time a new .**
64f0: 20 20 20 77 72 69 74 65 2d 74 72 61 6e 73 61 63 write-transac
6500: 74 69 6f 6e 20 69 73 20 6f 70 65 6e 65 64 2e 0a tion is opened..
6510: 2a 2a 0a 2a 2a 20 64 62 53 69 7a 65 2c 20 64 62 **.** dbSize, db
6520: 4f 72 69 67 53 69 7a 65 2c 20 64 62 46 69 6c 65 OrigSize, dbFile
6530: 53 69 7a 65 0a 2a 2a 0a 2a 2a 20 20 20 56 61 72 Size.**.** Var
6540: 69 61 62 6c 65 20 64 62 53 69 7a 65 20 69 73 20 iable dbSize is
6550: 73 65 74 20 74 6f 20 74 68 65 20 6e 75 6d 62 65 set to the numbe
6560: 72 20 6f 66 20 70 61 67 65 73 20 69 6e 20 74 68 r of pages in th
6570: 65 20 64 61 74 61 62 61 73 65 20 66 69 6c 65 2e e database file.
6580: 0a 2a 2a 20 20 20 49 74 20 69 73 20 76 61 6c 69 .** It is vali
6590: 64 20 69 6e 20 50 41 47 45 52 5f 52 45 41 44 45 d in PAGER_READE
65a0: 52 20 61 6e 64 20 68 69 67 68 65 72 20 73 74 61 R and higher sta
65b0: 74 65 73 20 28 61 6c 6c 20 73 74 61 74 65 73 20 tes (all states
65c0: 65 78 63 65 70 74 20 66 6f 72 0a 2a 2a 20 20 20 except for.**
65d0: 4f 50 45 4e 20 61 6e 64 20 45 52 52 4f 52 29 2e OPEN and ERROR).
65e0: 20 0a 2a 2a 0a 2a 2a 20 20 20 64 62 53 69 7a 65 .**.** dbSize
65f0: 20 69 73 20 73 65 74 20 62 61 73 65 64 20 6f 6e is set based on
6600: 20 74 68 65 20 73 69 7a 65 20 6f 66 20 74 68 65 the size of the
6610: 20 64 61 74 61 62 61 73 65 20 66 69 6c 65 2c 20 database file,
6620: 77 68 69 63 68 20 6d 61 79 20 62 65 20 0a 2a 2a which may be .**
6630: 20 20 20 6c 61 72 67 65 72 20 74 68 61 6e 20 74 larger than t
6640: 68 65 20 73 69 7a 65 20 6f 66 20 74 68 65 20 64 he size of the d
6650: 61 74 61 62 61 73 65 20 28 74 68 65 20 76 61 6c atabase (the val
6660: 75 65 20 73 74 6f 72 65 64 20 61 74 20 6f 66 66 ue stored at off
6670: 73 65 74 0a 2a 2a 20 20 20 32 38 20 6f 66 20 74 set.** 28 of t
6680: 68 65 20 64 61 74 61 62 61 73 65 20 68 65 61 64 he database head
6690: 65 72 20 62 79 20 74 68 65 20 62 74 72 65 65 29 er by the btree)
66a0: 2e 20 49 66 20 74 68 65 20 73 69 7a 65 20 6f 66 . If the size of
66b0: 20 74 68 65 20 66 69 6c 65 0a 2a 2a 20 20 20 69 the file.** i
66c0: 73 20 6e 6f 74 20 61 6e 20 69 6e 74 65 67 65 72 s not an integer
66d0: 20 6d 75 6c 74 69 70 6c 65 20 6f 66 20 74 68 65 multiple of the
66e0: 20 70 61 67 65 2d 73 69 7a 65 2c 20 74 68 65 20 page-size, the
66f0: 76 61 6c 75 65 20 73 74 6f 72 65 64 20 69 6e 0a value stored in.
6700: 2a 2a 20 20 20 64 62 53 69 7a 65 20 69 73 20 72 ** dbSize is r
6710: 6f 75 6e 64 65 64 20 64 6f 77 6e 20 28 69 2e 65 ounded down (i.e
6720: 2e 20 61 20 35 4b 42 20 66 69 6c 65 20 77 69 74 . a 5KB file wit
6730: 68 20 32 4b 20 70 61 67 65 2d 73 69 7a 65 20 68 h 2K page-size h
6740: 61 73 20 64 62 53 69 7a 65 3d 3d 32 29 2e 0a 2a as dbSize==2)..*
6750: 2a 20 20 20 45 78 63 65 70 74 2c 20 61 6e 79 20 * Except, any
6760: 66 69 6c 65 20 74 68 61 74 20 69 73 20 67 72 65 file that is gre
6770: 61 74 65 72 20 74 68 61 6e 20 30 20 62 79 74 65 ater than 0 byte
6780: 73 20 69 6e 20 73 69 7a 65 20 69 73 20 63 6f 6e s in size is con
6790: 73 69 64 65 72 65 64 0a 2a 2a 20 20 20 74 6f 20 sidered.** to
67a0: 68 61 76 65 20 61 74 20 6c 65 61 73 74 20 6f 6e have at least on
67b0: 65 20 70 61 67 65 2e 20 28 69 2e 65 2e 20 61 20 e page. (i.e. a
67c0: 31 4b 42 20 66 69 6c 65 20 77 69 74 68 20 32 4b 1KB file with 2K
67d0: 20 70 61 67 65 2d 73 69 7a 65 20 6c 65 61 64 73 page-size leads
67e0: 0a 2a 2a 20 20 20 74 6f 20 64 62 53 69 7a 65 3d .** to dbSize=
67f0: 3d 31 29 2e 0a 2a 2a 0a 2a 2a 20 20 20 44 75 72 =1)..**.** Dur
6800: 69 6e 67 20 61 20 77 72 69 74 65 2d 74 72 61 6e ing a write-tran
6810: 73 61 63 74 69 6f 6e 2c 20 69 66 20 70 61 67 65 saction, if page
6820: 73 20 77 69 74 68 20 70 61 67 65 2d 6e 75 6d 62 s with page-numb
6830: 65 72 73 20 67 72 65 61 74 65 72 20 74 68 61 6e ers greater than
6840: 0a 2a 2a 20 20 20 64 62 53 69 7a 65 20 61 72 65 .** dbSize are
6850: 20 6d 6f 64 69 66 69 65 64 20 69 6e 20 74 68 65 modified in the
6860: 20 63 61 63 68 65 2c 20 64 62 53 69 7a 65 20 69 cache, dbSize i
6870: 73 20 75 70 64 61 74 65 64 20 61 63 63 6f 72 64 s updated accord
6880: 69 6e 67 6c 79 2e 0a 2a 2a 20 20 20 53 69 6d 69 ingly..** Simi
6890: 6c 61 72 6c 79 2c 20 69 66 20 74 68 65 20 64 61 larly, if the da
68a0: 74 61 62 61 73 65 20 69 73 20 74 72 75 6e 63 61 tabase is trunca
68b0: 74 65 64 20 75 73 69 6e 67 20 50 61 67 65 72 54 ted using PagerT
68c0: 72 75 6e 63 61 74 65 49 6d 61 67 65 28 29 2c 20 runcateImage(),
68d0: 0a 2a 2a 20 20 20 64 62 53 69 7a 65 20 69 73 20 .** dbSize is
68e0: 75 70 64 61 74 65 64 2e 0a 2a 2a 0a 2a 2a 20 20 updated..**.**
68f0: 20 56 61 72 69 61 62 6c 65 73 20 64 62 4f 72 69 Variables dbOri
6900: 67 53 69 7a 65 20 61 6e 64 20 64 62 46 69 6c 65 gSize and dbFile
6910: 53 69 7a 65 20 61 72 65 20 76 61 6c 69 64 20 69 Size are valid i
6920: 6e 20 73 74 61 74 65 73 20 0a 2a 2a 20 20 20 50 n states .** P
6930: 41 47 45 52 5f 57 52 49 54 45 52 5f 4c 4f 43 4b AGER_WRITER_LOCK
6940: 45 44 20 61 6e 64 20 68 69 67 68 65 72 2e 20 64 ED and higher. d
6950: 62 4f 72 69 67 53 69 7a 65 20 69 73 20 61 20 63 bOrigSize is a c
6960: 6f 70 79 20 6f 66 20 74 68 65 20 64 62 53 69 7a opy of the dbSiz
6970: 65 0a 2a 2a 20 20 20 76 61 72 69 61 62 6c 65 20 e.** variable
6980: 61 74 20 74 68 65 20 73 74 61 72 74 20 6f 66 20 at the start of
6990: 74 68 65 20 74 72 61 6e 73 61 63 74 69 6f 6e 2e the transaction.
69a0: 20 49 74 20 69 73 20 75 73 65 64 20 64 75 72 69 It is used duri
69b0: 6e 67 20 72 6f 6c 6c 62 61 63 6b 2c 0a 2a 2a 20 ng rollback,.**
69c0: 20 20 61 6e 64 20 74 6f 20 64 65 74 65 72 6d 69 and to determi
69d0: 6e 65 20 77 68 65 74 68 65 72 20 6f 72 20 6e 6f ne whether or no
69e0: 74 20 70 61 67 65 73 20 6e 65 65 64 20 74 6f 20 t pages need to
69f0: 62 65 20 6a 6f 75 72 6e 61 6c 6c 65 64 20 62 65 be journalled be
6a00: 66 6f 72 65 0a 2a 2a 20 20 20 62 65 69 6e 67 20 fore.** being
6a10: 6d 6f 64 69 66 69 65 64 2e 0a 2a 2a 0a 2a 2a 20 modified..**.**
6a20: 20 20 54 68 72 6f 75 67 68 6f 75 74 20 61 20 77 Throughout a w
6a30: 72 69 74 65 2d 74 72 61 6e 73 61 63 74 69 6f 6e rite-transaction
6a40: 2c 20 64 62 46 69 6c 65 53 69 7a 65 20 63 6f 6e , dbFileSize con
6a50: 74 61 69 6e 73 20 74 68 65 20 73 69 7a 65 20 6f tains the size o
6a60: 66 0a 2a 2a 20 20 20 74 68 65 20 66 69 6c 65 20 f.** the file
6a70: 6f 6e 20 64 69 73 6b 20 69 6e 20 70 61 67 65 73 on disk in pages
6a80: 2e 20 49 74 20 69 73 20 73 65 74 20 74 6f 20 61 . It is set to a
6a90: 20 63 6f 70 79 20 6f 66 20 64 62 53 69 7a 65 20 copy of dbSize
6aa0: 77 68 65 6e 20 74 68 65 0a 2a 2a 20 20 20 77 72 when the.** wr
6ab0: 69 74 65 2d 74 72 61 6e 73 61 63 74 69 6f 6e 20 ite-transaction
6ac0: 69 73 20 66 69 72 73 74 20 6f 70 65 6e 65 64 2c is first opened,
6ad0: 20 61 6e 64 20 75 70 64 61 74 65 64 20 77 68 65 and updated whe
6ae0: 6e 20 56 46 53 20 63 61 6c 6c 73 20 61 72 65 20 n VFS calls are
6af0: 6d 61 64 65 0a 2a 2a 20 20 20 74 6f 20 77 72 69 made.** to wri
6b00: 74 65 20 6f 72 20 74 72 75 6e 63 61 74 65 20 74 te or truncate t
6b10: 68 65 20 64 61 74 61 62 61 73 65 20 66 69 6c 65 he database file
6b20: 20 6f 6e 20 64 69 73 6b 2e 20 0a 2a 2a 0a 2a 2a on disk. .**.**
6b30: 20 20 20 54 68 65 20 6f 6e 6c 79 20 72 65 61 73 The only reas
6b40: 6f 6e 20 74 68 65 20 64 62 46 69 6c 65 53 69 7a on the dbFileSiz
6b50: 65 20 76 61 72 69 61 62 6c 65 20 69 73 20 72 65 e variable is re
6b60: 71 75 69 72 65 64 20 69 73 20 74 6f 20 73 75 70 quired is to sup
6b70: 70 72 65 73 73 20 0a 2a 2a 20 20 20 75 6e 6e 65 press .** unne
6b80: 63 65 73 73 61 72 79 20 63 61 6c 6c 73 20 74 6f cessary calls to
6b90: 20 78 54 72 75 6e 63 61 74 65 28 29 20 61 66 74 xTruncate() aft
6ba0: 65 72 20 63 6f 6d 6d 69 74 74 69 6e 67 20 61 20 er committing a
6bb0: 74 72 61 6e 73 61 63 74 69 6f 6e 2e 20 49 66 2c transaction. If,
6bc0: 20 0a 2a 2a 20 20 20 77 68 65 6e 20 61 20 74 72 .** when a tr
6bd0: 61 6e 73 61 63 74 69 6f 6e 20 69 73 20 63 6f 6d ansaction is com
6be0: 6d 69 74 74 65 64 2c 20 74 68 65 20 64 62 46 69 mitted, the dbFi
6bf0: 6c 65 53 69 7a 65 20 76 61 72 69 61 62 6c 65 20 leSize variable
6c00: 69 6e 64 69 63 61 74 65 73 20 0a 2a 2a 20 20 20 indicates .**
6c10: 74 68 61 74 20 74 68 65 20 64 61 74 61 62 61 73 that the databas
6c20: 65 20 66 69 6c 65 20 69 73 20 6c 61 72 67 65 72 e file is larger
6c30: 20 74 68 61 6e 20 74 68 65 20 64 61 74 61 62 61 than the databa
6c40: 73 65 20 69 6d 61 67 65 20 28 50 61 67 65 72 2e se image (Pager.
6c50: 64 62 53 69 7a 65 29 2c 20 0a 2a 2a 20 20 20 70 dbSize), .** p
6c60: 61 67 65 72 5f 74 72 75 6e 63 61 74 65 28 29 20 ager_truncate()
6c70: 69 73 20 63 61 6c 6c 65 64 2e 20 54 68 65 20 70 is called. The p
6c80: 61 67 65 72 5f 74 72 75 6e 63 61 74 65 28 29 20 ager_truncate()
6c90: 63 61 6c 6c 20 75 73 65 73 20 78 46 69 6c 65 73 call uses xFiles
6ca0: 69 7a 65 28 29 0a 2a 2a 20 20 20 74 6f 20 6d 65 ize().** to me
6cb0: 61 73 75 72 65 20 74 68 65 20 64 61 74 61 62 61 asure the databa
6cc0: 73 65 20 66 69 6c 65 20 6f 6e 20 64 69 73 6b 2c se file on disk,
6cd0: 20 61 6e 64 20 74 68 65 6e 20 74 72 75 6e 63 61 and then trunca
6ce0: 74 65 73 20 69 74 20 69 66 20 72 65 71 75 69 72 tes it if requir
6cf0: 65 64 2e 0a 2a 2a 20 20 20 64 62 46 69 6c 65 53 ed..** dbFileS
6d00: 69 7a 65 20 69 73 20 6e 6f 74 20 75 73 65 64 20 ize is not used
6d10: 77 68 65 6e 20 72 6f 6c 6c 69 6e 67 20 62 61 63 when rolling bac
6d20: 6b 20 61 20 74 72 61 6e 73 61 63 74 69 6f 6e 2e k a transaction.
6d30: 20 49 6e 20 74 68 69 73 20 63 61 73 65 0a 2a 2a In this case.**
6d40: 20 20 20 70 61 67 65 72 5f 74 72 75 6e 63 61 74 pager_truncat
6d50: 65 28 29 20 69 73 20 63 61 6c 6c 65 64 20 75 6e e() is called un
6d60: 63 6f 6e 64 69 74 69 6f 6e 61 6c 6c 79 20 28 77 conditionally (w
6d70: 68 69 63 68 20 6d 65 61 6e 73 20 74 68 65 72 65 hich means there
6d80: 20 6d 61 79 20 62 65 0a 2a 2a 20 20 20 61 20 63 may be.** a c
6d90: 61 6c 6c 20 74 6f 20 78 46 69 6c 65 73 69 7a 65 all to xFilesize
6da0: 28 29 20 74 68 61 74 20 69 73 20 6e 6f 74 20 73 () that is not s
6db0: 74 72 69 63 74 6c 79 20 72 65 71 75 69 72 65 64 trictly required
6dc0: 29 2e 20 49 6e 20 65 69 74 68 65 72 20 63 61 73 ). In either cas
6dd0: 65 2c 0a 2a 2a 20 20 20 70 61 67 65 72 5f 74 72 e,.** pager_tr
6de0: 75 6e 63 61 74 65 28 29 20 6d 61 79 20 63 61 75 uncate() may cau
6df0: 73 65 20 74 68 65 20 66 69 6c 65 20 74 6f 20 62 se the file to b
6e00: 65 63 6f 6d 65 20 73 6d 61 6c 6c 65 72 20 6f 72 ecome smaller or
6e10: 20 6c 61 72 67 65 72 2e 0a 2a 2a 0a 2a 2a 20 64 larger..**.** d
6e20: 62 48 69 6e 74 53 69 7a 65 0a 2a 2a 0a 2a 2a 20 bHintSize.**.**
6e30: 20 20 54 68 65 20 64 62 48 69 6e 74 53 69 7a 65 The dbHintSize
6e40: 20 76 61 72 69 61 62 6c 65 20 69 73 20 75 73 65 variable is use
6e50: 64 20 74 6f 20 6c 69 6d 69 74 20 74 68 65 20 6e d to limit the n
6e60: 75 6d 62 65 72 20 6f 66 20 63 61 6c 6c 73 20 6d umber of calls m
6e70: 61 64 65 20 74 6f 0a 2a 2a 20 20 20 74 68 65 20 ade to.** the
6e80: 56 46 53 20 78 46 69 6c 65 43 6f 6e 74 72 6f 6c VFS xFileControl
6e90: 28 46 43 4e 54 4c 5f 53 49 5a 45 5f 48 49 4e 54 (FCNTL_SIZE_HINT
6ea0: 29 20 6d 65 74 68 6f 64 2e 20 0a 2a 2a 0a 2a 2a ) method. .**.**
6eb0: 20 20 20 64 62 48 69 6e 74 53 69 7a 65 20 69 73 dbHintSize is
6ec0: 20 73 65 74 20 74 6f 20 61 20 63 6f 70 79 20 6f set to a copy o
6ed0: 66 20 74 68 65 20 64 62 53 69 7a 65 20 76 61 72 f the dbSize var
6ee0: 69 61 62 6c 65 20 77 68 65 6e 20 61 0a 2a 2a 20 iable when a.**
6ef0: 20 20 77 72 69 74 65 2d 74 72 61 6e 73 61 63 74 write-transact
6f00: 69 6f 6e 20 69 73 20 6f 70 65 6e 65 64 20 28 61 ion is opened (a
6f10: 74 20 74 68 65 20 73 61 6d 65 20 74 69 6d 65 20 t the same time
6f20: 61 73 20 64 62 46 69 6c 65 53 69 7a 65 20 61 6e as dbFileSize an
6f30: 64 0a 2a 2a 20 20 20 64 62 4f 72 69 67 53 69 7a d.** dbOrigSiz
6f40: 65 29 2e 20 49 66 20 74 68 65 20 78 46 69 6c 65 e). If the xFile
6f50: 43 6f 6e 74 72 6f 6c 28 46 43 4e 54 4c 5f 53 49 Control(FCNTL_SI
6f60: 5a 45 5f 48 49 4e 54 29 20 6d 65 74 68 6f 64 20 ZE_HINT) method
6f70: 69 73 20 63 61 6c 6c 65 64 2c 0a 2a 2a 20 20 20 is called,.**
6f80: 64 62 48 69 6e 74 53 69 7a 65 20 69 73 20 69 6e dbHintSize is in
6f90: 63 72 65 61 73 65 64 20 74 6f 20 74 68 65 20 6e creased to the n
6fa0: 75 6d 62 65 72 20 6f 66 20 70 61 67 65 73 20 74 umber of pages t
6fb0: 68 61 74 20 63 6f 72 72 65 73 70 6f 6e 64 20 74 hat correspond t
6fc0: 6f 20 74 68 65 0a 2a 2a 20 20 20 73 69 7a 65 2d o the.** size-
6fd0: 68 69 6e 74 20 70 61 73 73 65 64 20 74 6f 20 74 hint passed to t
6fe0: 68 65 20 6d 65 74 68 6f 64 20 63 61 6c 6c 2e 20 he method call.
6ff0: 53 65 65 20 70 61 67 65 72 5f 77 72 69 74 65 5f See pager_write_
7000: 70 61 67 65 6c 69 73 74 28 29 20 66 6f 72 20 0a pagelist() for .
7010: 2a 2a 20 20 20 64 65 74 61 69 6c 73 2e 0a 2a 2a ** details..**
7020: 0a 2a 2a 20 65 72 72 43 6f 64 65 0a 2a 2a 0a 2a .** errCode.**.*
7030: 2a 20 20 20 54 68 65 20 50 61 67 65 72 2e 65 72 * The Pager.er
7040: 72 43 6f 64 65 20 76 61 72 69 61 62 6c 65 20 69 rCode variable i
7050: 73 20 6f 6e 6c 79 20 65 76 65 72 20 75 73 65 64 s only ever used
7060: 20 69 6e 20 50 41 47 45 52 5f 45 52 52 4f 52 20 in PAGER_ERROR
7070: 73 74 61 74 65 2e 20 49 74 0a 2a 2a 20 20 20 69 state. It.** i
7080: 73 20 73 65 74 20 74 6f 20 7a 65 72 6f 20 69 6e s set to zero in
7090: 20 61 6c 6c 20 6f 74 68 65 72 20 73 74 61 74 65 all other state
70a0: 73 2e 20 49 6e 20 50 41 47 45 52 5f 45 52 52 4f s. In PAGER_ERRO
70b0: 52 20 73 74 61 74 65 2c 20 50 61 67 65 72 2e 65 R state, Pager.e
70c0: 72 72 43 6f 64 65 20 0a 2a 2a 20 20 20 69 73 20 rrCode .** is
70d0: 61 6c 77 61 79 73 20 73 65 74 20 74 6f 20 53 51 always set to SQ
70e0: 4c 49 54 45 5f 46 55 4c 4c 2c 20 53 51 4c 49 54 LITE_FULL, SQLIT
70f0: 45 5f 49 4f 45 52 52 20 6f 72 20 6f 6e 65 20 6f E_IOERR or one o
7100: 66 20 74 68 65 20 53 51 4c 49 54 45 5f 49 4f 45 f the SQLITE_IOE
7110: 52 52 5f 58 58 58 20 0a 2a 2a 20 20 20 73 75 62 RR_XXX .** sub
7120: 2d 63 6f 64 65 73 2e 0a 2a 2f 0a 73 74 72 75 63 -codes..*/.struc
7130: 74 20 50 61 67 65 72 20 7b 0a 20 20 73 71 6c 69 t Pager {. sqli
7140: 74 65 33 5f 76 66 73 20 2a 70 56 66 73 3b 20 20 te3_vfs *pVfs;
7150: 20 20 20 20 20 20 20 20 2f 2a 20 4f 53 20 66 75 /* OS fu
7160: 6e 63 74 69 6f 6e 73 20 74 6f 20 75 73 65 20 66 nctions to use f
7170: 6f 72 20 49 4f 20 2a 2f 0a 20 20 75 38 20 65 78 or IO */. u8 ex
7180: 63 6c 75 73 69 76 65 4d 6f 64 65 3b 20 20 20 20 clusiveMode;
7190: 20 20 20 20 20 20 20 2f 2a 20 42 6f 6f 6c 65 61 /* Boolea
71a0: 6e 2e 20 54 72 75 65 20 69 66 20 6c 6f 63 6b 69 n. True if locki
71b0: 6e 67 5f 6d 6f 64 65 3d 3d 45 58 43 4c 55 53 49 ng_mode==EXCLUSI
71c0: 56 45 20 2a 2f 0a 20 20 75 38 20 6a 6f 75 72 6e VE */. u8 journ
71d0: 61 6c 4d 6f 64 65 3b 20 20 20 20 20 20 20 20 20 alMode;
71e0: 20 20 20 20 2f 2a 20 4f 6e 65 20 6f 66 20 74 68 /* One of th
71f0: 65 20 50 41 47 45 52 5f 4a 4f 55 52 4e 41 4c 4d e PAGER_JOURNALM
7200: 4f 44 45 5f 2a 20 76 61 6c 75 65 73 20 2a 2f 0a ODE_* values */.
7210: 20 20 75 38 20 75 73 65 4a 6f 75 72 6e 61 6c 3b u8 useJournal;
7220: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a /*
7230: 20 55 73 65 20 61 20 72 6f 6c 6c 62 61 63 6b 20 Use a rollback
7240: 6a 6f 75 72 6e 61 6c 20 6f 6e 20 74 68 69 73 20 journal on this
7250: 66 69 6c 65 20 2a 2f 0a 20 20 75 38 20 6e 6f 53 file */. u8 noS
7260: 79 6e 63 3b 20 20 20 20 20 20 20 20 20 20 20 20 ync;
7270: 20 20 20 20 20 20 2f 2a 20 44 6f 20 6e 6f 74 20 /* Do not
7280: 73 79 6e 63 20 74 68 65 20 6a 6f 75 72 6e 61 6c sync the journal
7290: 20 69 66 20 74 72 75 65 20 2a 2f 0a 20 20 75 38 if true */. u8
72a0: 20 66 75 6c 6c 53 79 6e 63 3b 20 20 20 20 20 20 fullSync;
72b0: 20 20 20 20 20 20 20 20 20 20 2f 2a 20 44 6f 20 /* Do
72c0: 65 78 74 72 61 20 73 79 6e 63 73 20 6f 66 20 74 extra syncs of t
72d0: 68 65 20 6a 6f 75 72 6e 61 6c 20 66 6f 72 20 72 he journal for r
72e0: 6f 62 75 73 74 6e 65 73 73 20 2a 2f 0a 20 20 75 obustness */. u
72f0: 38 20 65 78 74 72 61 53 79 6e 63 3b 20 20 20 20 8 extraSync;
7300: 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 73 79 /* sy
7310: 6e 63 20 64 69 72 65 63 74 6f 72 79 20 61 66 74 nc directory aft
7320: 65 72 20 6a 6f 75 72 6e 61 6c 20 64 65 6c 65 74 er journal delet
7330: 65 20 2a 2f 0a 20 20 75 38 20 63 6b 70 74 53 79 e */. u8 ckptSy
7340: 6e 63 46 6c 61 67 73 3b 20 20 20 20 20 20 20 20 ncFlags;
7350: 20 20 20 2f 2a 20 53 59 4e 43 5f 4e 4f 52 4d 41 /* SYNC_NORMA
7360: 4c 20 6f 72 20 53 59 4e 43 5f 46 55 4c 4c 20 66 L or SYNC_FULL f
7370: 6f 72 20 63 68 65 63 6b 70 6f 69 6e 74 20 2a 2f or checkpoint */
7380: 0a 20 20 75 38 20 77 61 6c 53 79 6e 63 46 6c 61 . u8 walSyncFla
7390: 67 73 3b 20 20 20 20 20 20 20 20 20 20 20 20 2f gs; /
73a0: 2a 20 53 59 4e 43 5f 4e 4f 52 4d 41 4c 20 6f 72 * SYNC_NORMAL or
73b0: 20 53 59 4e 43 5f 46 55 4c 4c 20 66 6f 72 20 77 SYNC_FULL for w
73c0: 61 6c 20 77 72 69 74 65 73 20 2a 2f 0a 20 20 75 al writes */. u
73d0: 38 20 73 79 6e 63 46 6c 61 67 73 3b 20 20 20 20 8 syncFlags;
73e0: 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 53 59 /* SY
73f0: 4e 43 5f 4e 4f 52 4d 41 4c 20 6f 72 20 53 59 4e NC_NORMAL or SYN
7400: 43 5f 46 55 4c 4c 20 6f 74 68 65 72 77 69 73 65 C_FULL otherwise
7410: 20 2a 2f 0a 20 20 75 38 20 74 65 6d 70 46 69 6c */. u8 tempFil
7420: 65 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 e;
7430: 20 20 2f 2a 20 7a 46 69 6c 65 6e 61 6d 65 20 69 /* zFilename i
7440: 73 20 61 20 74 65 6d 70 6f 72 61 72 79 20 6f 72 s a temporary or
7450: 20 69 6d 6d 75 74 61 62 6c 65 20 66 69 6c 65 20 immutable file
7460: 2a 2f 0a 20 20 75 38 20 6e 6f 4c 6f 63 6b 3b 20 */. u8 noLock;
7470: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
7480: 20 2f 2a 20 44 6f 20 6e 6f 74 20 6c 6f 63 6b 20 /* Do not lock
7490: 28 65 78 63 65 70 74 20 69 6e 20 57 41 4c 20 6d (except in WAL m
74a0: 6f 64 65 29 20 2a 2f 0a 20 20 75 38 20 72 65 61 ode) */. u8 rea
74b0: 64 4f 6e 6c 79 3b 20 20 20 20 20 20 20 20 20 20 dOnly;
74c0: 20 20 20 20 20 20 2f 2a 20 54 72 75 65 20 66 6f /* True fo
74d0: 72 20 61 20 72 65 61 64 2d 6f 6e 6c 79 20 64 61 r a read-only da
74e0: 74 61 62 61 73 65 20 2a 2f 0a 20 20 75 38 20 6d tabase */. u8 m
74f0: 65 6d 44 62 3b 20 20 20 20 20 20 20 20 20 20 20 emDb;
7500: 20 20 20 20 20 20 20 20 2f 2a 20 54 72 75 65 20 /* True
7510: 74 6f 20 69 6e 68 69 62 69 74 20 61 6c 6c 20 66 to inhibit all f
7520: 69 6c 65 20 49 2f 4f 20 2a 2f 0a 0a 20 20 2f 2a ile I/O */.. /*
7530: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
7540: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
7550: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
7560: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
7570: 2a 2a 2a 2a 2a 2a 2a 2a 2a 0a 20 20 2a 2a 20 54 *********. ** T
7580: 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 62 6c 6f he following blo
7590: 63 6b 20 63 6f 6e 74 61 69 6e 73 20 74 68 6f 73 ck contains thos
75a0: 65 20 63 6c 61 73 73 20 6d 65 6d 62 65 72 73 20 e class members
75b0: 74 68 61 74 20 63 68 61 6e 67 65 20 64 75 72 69 that change duri
75c0: 6e 67 0a 20 20 2a 2a 20 72 6f 75 74 69 6e 65 20 ng. ** routine
75d0: 6f 70 65 72 61 74 69 6f 6e 2e 20 20 43 6c 61 73 operation. Clas
75e0: 73 20 6d 65 6d 62 65 72 73 20 6e 6f 74 20 69 6e s members not in
75f0: 20 74 68 69 73 20 62 6c 6f 63 6b 20 61 72 65 20 this block are
7600: 65 69 74 68 65 72 20 66 69 78 65 64 0a 20 20 2a either fixed. *
7610: 2a 20 77 68 65 6e 20 74 68 65 20 70 61 67 65 72 * when the pager
7620: 20 69 73 20 66 69 72 73 74 20 63 72 65 61 74 65 is first create
7630: 64 20 6f 72 20 65 6c 73 65 20 6f 6e 6c 79 20 63 d or else only c
7640: 68 61 6e 67 65 20 77 68 65 6e 20 74 68 65 72 65 hange when there
7650: 20 69 73 20 61 0a 20 20 2a 2a 20 73 69 67 6e 69 is a. ** signi
7660: 66 69 63 61 6e 74 20 6d 6f 64 65 20 63 68 61 6e ficant mode chan
7670: 67 65 20 28 73 75 63 68 20 61 73 20 63 68 61 6e ge (such as chan
7680: 67 69 6e 67 20 74 68 65 20 70 61 67 65 5f 73 69 ging the page_si
7690: 7a 65 2c 20 6c 6f 63 6b 69 6e 67 5f 6d 6f 64 65 ze, locking_mode
76a0: 2c 0a 20 20 2a 2a 20 6f 72 20 74 68 65 20 6a 6f ,. ** or the jo
76b0: 75 72 6e 61 6c 5f 6d 6f 64 65 29 2e 20 20 46 72 urnal_mode). Fr
76c0: 6f 6d 20 61 6e 6f 74 68 65 72 20 76 69 65 77 2c om another view,
76d0: 20 74 68 65 73 65 20 63 6c 61 73 73 20 6d 65 6d these class mem
76e0: 62 65 72 73 20 64 65 73 63 72 69 62 65 0a 20 20 bers describe.
76f0: 2a 2a 20 74 68 65 20 22 73 74 61 74 65 22 20 6f ** the "state" o
7700: 66 20 74 68 65 20 70 61 67 65 72 2c 20 77 68 69 f the pager, whi
7710: 6c 65 20 6f 74 68 65 72 20 63 6c 61 73 73 20 6d le other class m
7720: 65 6d 62 65 72 73 20 64 65 73 63 72 69 62 65 20 embers describe
7730: 74 68 65 0a 20 20 2a 2a 20 22 63 6f 6e 66 69 67 the. ** "config
7740: 75 72 61 74 69 6f 6e 22 20 6f 66 20 74 68 65 20 uration" of the
7750: 70 61 67 65 72 2e 0a 20 20 2a 2f 0a 20 20 75 38 pager.. */. u8
7760: 20 65 53 74 61 74 65 3b 20 20 20 20 20 20 20 20 eState;
7770: 20 20 20 20 20 20 20 20 20 20 2f 2a 20 50 61 67 /* Pag
7780: 65 72 20 73 74 61 74 65 20 28 4f 50 45 4e 2c 20 er state (OPEN,
7790: 52 45 41 44 45 52 2c 20 57 52 49 54 45 52 5f 4c READER, WRITER_L
77a0: 4f 43 4b 45 44 2e 2e 29 20 2a 2f 0a 20 20 75 38 OCKED..) */. u8
77b0: 20 65 4c 6f 63 6b 3b 20 20 20 20 20 20 20 20 20 eLock;
77c0: 20 20 20 20 20 20 20 20 20 20 2f 2a 20 43 75 72 /* Cur
77d0: 72 65 6e 74 20 6c 6f 63 6b 20 68 65 6c 64 20 6f rent lock held o
77e0: 6e 20 64 61 74 61 62 61 73 65 20 66 69 6c 65 20 n database file
77f0: 2a 2f 0a 20 20 75 38 20 63 68 61 6e 67 65 43 6f */. u8 changeCo
7800: 75 6e 74 44 6f 6e 65 3b 20 20 20 20 20 20 20 20 untDone;
7810: 20 2f 2a 20 53 65 74 20 61 66 74 65 72 20 69 6e /* Set after in
7820: 63 72 65 6d 65 6e 74 69 6e 67 20 74 68 65 20 63 crementing the c
7830: 68 61 6e 67 65 2d 63 6f 75 6e 74 65 72 20 2a 2f hange-counter */
7840: 0a 20 20 75 38 20 73 65 74 4d 61 73 74 65 72 3b . u8 setMaster;
7850: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f /
7860: 2a 20 54 72 75 65 20 69 66 20 61 20 6d 2d 6a 20 * True if a m-j
7870: 6e 61 6d 65 20 68 61 73 20 62 65 65 6e 20 77 72 name has been wr
7880: 69 74 74 65 6e 20 74 6f 20 6a 72 6e 6c 20 2a 2f itten to jrnl */
7890: 0a 20 20 75 38 20 64 6f 4e 6f 74 53 70 69 6c 6c . u8 doNotSpill
78a0: 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f ; /
78b0: 2a 20 44 6f 20 6e 6f 74 20 73 70 69 6c 6c 20 74 * Do not spill t
78c0: 68 65 20 63 61 63 68 65 20 77 68 65 6e 20 6e 6f he cache when no
78d0: 6e 2d 7a 65 72 6f 20 2a 2f 0a 20 20 75 38 20 73 n-zero */. u8 s
78e0: 75 62 6a 49 6e 4d 65 6d 6f 72 79 3b 20 20 20 20 ubjInMemory;
78f0: 20 20 20 20 20 20 20 20 2f 2a 20 54 72 75 65 20 /* True
7900: 74 6f 20 75 73 65 20 69 6e 2d 6d 65 6d 6f 72 79 to use in-memory
7910: 20 73 75 62 2d 6a 6f 75 72 6e 61 6c 73 20 2a 2f sub-journals */
7920: 0a 20 20 75 38 20 62 55 73 65 46 65 74 63 68 3b . u8 bUseFetch;
7930: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f /
7940: 2a 20 54 72 75 65 20 74 6f 20 75 73 65 20 78 46 * True to use xF
7950: 65 74 63 68 28 29 20 2a 2f 0a 20 20 75 38 20 68 etch() */. u8 h
7960: 61 73 48 65 6c 64 53 68 61 72 65 64 4c 6f 63 6b asHeldSharedLock
7970: 3b 20 20 20 20 20 20 20 2f 2a 20 54 72 75 65 20 ; /* True
7980: 69 66 20 61 20 73 68 61 72 65 64 20 6c 6f 63 6b if a shared lock
7990: 20 68 61 73 20 65 76 65 72 20 62 65 65 6e 20 68 has ever been h
79a0: 65 6c 64 20 2a 2f 0a 20 20 50 67 6e 6f 20 64 62 eld */. Pgno db
79b0: 53 69 7a 65 3b 20 20 20 20 20 20 20 20 20 20 20 Size;
79c0: 20 20 20 20 20 2f 2a 20 4e 75 6d 62 65 72 20 6f /* Number o
79d0: 66 20 70 61 67 65 73 20 69 6e 20 74 68 65 20 64 f pages in the d
79e0: 61 74 61 62 61 73 65 20 2a 2f 0a 20 20 50 67 6e atabase */. Pgn
79f0: 6f 20 64 62 4f 72 69 67 53 69 7a 65 3b 20 20 20 o dbOrigSize;
7a00: 20 20 20 20 20 20 20 20 20 2f 2a 20 64 62 53 69 /* dbSi
7a10: 7a 65 20 62 65 66 6f 72 65 20 74 68 65 20 63 75 ze before the cu
7a20: 72 72 65 6e 74 20 74 72 61 6e 73 61 63 74 69 6f rrent transactio
7a30: 6e 20 2a 2f 0a 20 20 50 67 6e 6f 20 64 62 46 69 n */. Pgno dbFi
7a40: 6c 65 53 69 7a 65 3b 20 20 20 20 20 20 20 20 20 leSize;
7a50: 20 20 20 2f 2a 20 4e 75 6d 62 65 72 20 6f 66 20 /* Number of
7a60: 70 61 67 65 73 20 69 6e 20 74 68 65 20 64 61 74 pages in the dat
7a70: 61 62 61 73 65 20 66 69 6c 65 20 2a 2f 0a 20 20 abase file */.
7a80: 50 67 6e 6f 20 64 62 48 69 6e 74 53 69 7a 65 3b Pgno dbHintSize;
7a90: 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 56 /* V
7aa0: 61 6c 75 65 20 70 61 73 73 65 64 20 74 6f 20 46 alue passed to F
7ab0: 43 4e 54 4c 5f 53 49 5a 45 5f 48 49 4e 54 20 63 CNTL_SIZE_HINT c
7ac0: 61 6c 6c 20 2a 2f 0a 20 20 69 6e 74 20 65 72 72 all */. int err
7ad0: 43 6f 64 65 3b 20 20 20 20 20 20 20 20 20 20 20 Code;
7ae0: 20 20 20 20 20 2f 2a 20 4f 6e 65 20 6f 66 20 73 /* One of s
7af0: 65 76 65 72 61 6c 20 6b 69 6e 64 73 20 6f 66 20 everal kinds of
7b00: 65 72 72 6f 72 73 20 2a 2f 0a 20 20 69 6e 74 20 errors */. int
7b10: 6e 52 65 63 3b 20 20 20 20 20 20 20 20 20 20 20 nRec;
7b20: 20 20 20 20 20 20 20 20 2f 2a 20 50 61 67 65 73 /* Pages
7b30: 20 6a 6f 75 72 6e 61 6c 6c 65 64 20 73 69 6e 63 journalled sinc
7b40: 65 20 6c 61 73 74 20 6a 2d 68 65 61 64 65 72 20 e last j-header
7b50: 77 72 69 74 74 65 6e 20 2a 2f 0a 20 20 75 33 32 written */. u32
7b60: 20 63 6b 73 75 6d 49 6e 69 74 3b 20 20 20 20 20 cksumInit;
7b70: 20 20 20 20 20 20 20 20 20 2f 2a 20 51 75 61 73 /* Quas
7b80: 69 2d 72 61 6e 64 6f 6d 20 76 61 6c 75 65 20 61 i-random value a
7b90: 64 64 65 64 20 74 6f 20 65 76 65 72 79 20 63 68 dded to every ch
7ba0: 65 63 6b 73 75 6d 20 2a 2f 0a 20 20 75 33 32 20 ecksum */. u32
7bb0: 6e 53 75 62 52 65 63 3b 20 20 20 20 20 20 20 20 nSubRec;
7bc0: 20 20 20 20 20 20 20 20 2f 2a 20 4e 75 6d 62 65 /* Numbe
7bd0: 72 20 6f 66 20 72 65 63 6f 72 64 73 20 77 72 69 r of records wri
7be0: 74 74 65 6e 20 74 6f 20 73 75 62 2d 6a 6f 75 72 tten to sub-jour
7bf0: 6e 61 6c 20 2a 2f 0a 20 20 42 69 74 76 65 63 20 nal */. Bitvec
7c00: 2a 70 49 6e 4a 6f 75 72 6e 61 6c 3b 20 20 20 20 *pInJournal;
7c10: 20 20 20 20 20 2f 2a 20 4f 6e 65 20 62 69 74 20 /* One bit
7c20: 66 6f 72 20 65 61 63 68 20 70 61 67 65 20 69 6e for each page in
7c30: 20 74 68 65 20 64 61 74 61 62 61 73 65 20 66 69 the database fi
7c40: 6c 65 20 2a 2f 0a 20 20 73 71 6c 69 74 65 33 5f le */. sqlite3_
7c50: 66 69 6c 65 20 2a 66 64 3b 20 20 20 20 20 20 20 file *fd;
7c60: 20 20 20 20 2f 2a 20 46 69 6c 65 20 64 65 73 63 /* File desc
7c70: 72 69 70 74 6f 72 20 66 6f 72 20 64 61 74 61 62 riptor for datab
7c80: 61 73 65 20 2a 2f 0a 20 20 73 71 6c 69 74 65 33 ase */. sqlite3
7c90: 5f 66 69 6c 65 20 2a 6a 66 64 3b 20 20 20 20 20 _file *jfd;
7ca0: 20 20 20 20 20 2f 2a 20 46 69 6c 65 20 64 65 73 /* File des
7cb0: 63 72 69 70 74 6f 72 20 66 6f 72 20 6d 61 69 6e criptor for main
7cc0: 20 6a 6f 75 72 6e 61 6c 20 2a 2f 0a 20 20 73 71 journal */. sq
7cd0: 6c 69 74 65 33 5f 66 69 6c 65 20 2a 73 6a 66 64 lite3_file *sjfd
7ce0: 3b 20 20 20 20 20 20 20 20 20 2f 2a 20 46 69 6c ; /* Fil
7cf0: 65 20 64 65 73 63 72 69 70 74 6f 72 20 66 6f 72 e descriptor for
7d00: 20 73 75 62 2d 6a 6f 75 72 6e 61 6c 20 2a 2f 0a sub-journal */.
7d10: 20 20 69 36 34 20 6a 6f 75 72 6e 61 6c 4f 66 66 i64 journalOff
7d20: 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a ; /*
7d30: 20 43 75 72 72 65 6e 74 20 77 72 69 74 65 20 6f Current write o
7d40: 66 66 73 65 74 20 69 6e 20 74 68 65 20 6a 6f 75 ffset in the jou
7d50: 72 6e 61 6c 20 66 69 6c 65 20 2a 2f 0a 20 20 69 rnal file */. i
7d60: 36 34 20 6a 6f 75 72 6e 61 6c 48 64 72 3b 20 20 64 journalHdr;
7d70: 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 42 79 /* By
7d80: 74 65 20 6f 66 66 73 65 74 20 74 6f 20 70 72 65 te offset to pre
7d90: 76 69 6f 75 73 20 6a 6f 75 72 6e 61 6c 20 68 65 vious journal he
7da0: 61 64 65 72 20 2a 2f 0a 20 20 73 71 6c 69 74 65 ader */. sqlite
7db0: 33 5f 62 61 63 6b 75 70 20 2a 70 42 61 63 6b 75 3_backup *pBacku
7dc0: 70 3b 20 20 20 20 2f 2a 20 50 6f 69 6e 74 65 72 p; /* Pointer
7dd0: 20 74 6f 20 6c 69 73 74 20 6f 66 20 6f 6e 67 6f to list of ongo
7de0: 69 6e 67 20 62 61 63 6b 75 70 20 70 72 6f 63 65 ing backup proce
7df0: 73 73 65 73 20 2a 2f 0a 20 20 50 61 67 65 72 53 sses */. PagerS
7e00: 61 76 65 70 6f 69 6e 74 20 2a 61 53 61 76 65 70 avepoint *aSavep
7e10: 6f 69 6e 74 3b 20 2f 2a 20 41 72 72 61 79 20 6f oint; /* Array o
7e20: 66 20 61 63 74 69 76 65 20 73 61 76 65 70 6f 69 f active savepoi
7e30: 6e 74 73 20 2a 2f 0a 20 20 69 6e 74 20 6e 53 61 nts */. int nSa
7e40: 76 65 70 6f 69 6e 74 3b 20 20 20 20 20 20 20 20 vepoint;
7e50: 20 20 20 20 20 2f 2a 20 4e 75 6d 62 65 72 20 6f /* Number o
7e60: 66 20 65 6c 65 6d 65 6e 74 73 20 69 6e 20 61 53 f elements in aS
7e70: 61 76 65 70 6f 69 6e 74 5b 5d 20 2a 2f 0a 20 20 avepoint[] */.
7e80: 75 33 32 20 69 44 61 74 61 56 65 72 73 69 6f 6e u32 iDataVersion
7e90: 3b 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 43 ; /* C
7ea0: 68 61 6e 67 65 73 20 77 68 65 6e 65 76 65 72 20 hanges whenever
7eb0: 64 61 74 61 62 61 73 65 20 63 6f 6e 74 65 6e 74 database content
7ec0: 20 63 68 61 6e 67 65 73 20 2a 2f 0a 20 20 63 68 changes */. ch
7ed0: 61 72 20 64 62 46 69 6c 65 56 65 72 73 5b 31 36 ar dbFileVers[16
7ee0: 5d 3b 20 20 20 20 20 20 20 20 2f 2a 20 43 68 61 ]; /* Cha
7ef0: 6e 67 65 73 20 77 68 65 6e 65 76 65 72 20 64 61 nges whenever da
7f00: 74 61 62 61 73 65 20 66 69 6c 65 20 63 68 61 6e tabase file chan
7f10: 67 65 73 20 2a 2f 0a 0a 20 20 69 6e 74 20 6e 4d ges */.. int nM
7f20: 6d 61 70 4f 75 74 3b 20 20 20 20 20 20 20 20 20 mapOut;
7f30: 20 20 20 20 20 20 2f 2a 20 4e 75 6d 62 65 72 20 /* Number
7f40: 6f 66 20 6d 6d 61 70 20 70 61 67 65 73 20 63 75 of mmap pages cu
7f50: 72 72 65 6e 74 6c 79 20 6f 75 74 73 74 61 6e 64 rrently outstand
7f60: 69 6e 67 20 2a 2f 0a 20 20 73 71 6c 69 74 65 33 ing */. sqlite3
7f70: 5f 69 6e 74 36 34 20 73 7a 4d 6d 61 70 3b 20 20 _int64 szMmap;
7f80: 20 20 20 20 20 2f 2a 20 44 65 73 69 72 65 64 20 /* Desired
7f90: 6d 61 78 69 6d 75 6d 20 6d 6d 61 70 20 73 69 7a maximum mmap siz
7fa0: 65 20 2a 2f 0a 20 20 50 67 48 64 72 20 2a 70 4d e */. PgHdr *pM
7fb0: 6d 61 70 46 72 65 65 6c 69 73 74 3b 20 20 20 20 mapFreelist;
7fc0: 20 20 20 2f 2a 20 4c 69 73 74 20 6f 66 20 66 72 /* List of fr
7fd0: 65 65 20 6d 6d 61 70 20 70 61 67 65 20 68 65 61 ee mmap page hea
7fe0: 64 65 72 73 20 28 70 44 69 72 74 79 29 20 2a 2f ders (pDirty) */
7ff0: 0a 20 20 2f 2a 0a 20 20 2a 2a 20 45 6e 64 20 6f . /*. ** End o
8000: 66 20 74 68 65 20 72 6f 75 74 69 6e 65 6c 79 2d f the routinely-
8010: 63 68 61 6e 67 69 6e 67 20 63 6c 61 73 73 20 6d changing class m
8020: 65 6d 62 65 72 73 0a 20 20 2a 2a 2a 2a 2a 2a 2a embers. *******
8030: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
8040: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
8050: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
8060: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
8070: 2a 2a 2a 2a 2f 0a 0a 20 20 75 31 36 20 6e 45 78 ****/.. u16 nEx
8080: 74 72 61 3b 20 20 20 20 20 20 20 20 20 20 20 20 tra;
8090: 20 20 20 20 20 2f 2a 20 41 64 64 20 74 68 69 73 /* Add this
80a0: 20 6d 61 6e 79 20 62 79 74 65 73 20 74 6f 20 65 many bytes to e
80b0: 61 63 68 20 69 6e 2d 6d 65 6d 6f 72 79 20 70 61 ach in-memory pa
80c0: 67 65 20 2a 2f 0a 20 20 69 31 36 20 6e 52 65 73 ge */. i16 nRes
80d0: 65 72 76 65 3b 20 20 20 20 20 20 20 20 20 20 20 erve;
80e0: 20 20 20 20 2f 2a 20 4e 75 6d 62 65 72 20 6f 66 /* Number of
80f0: 20 75 6e 75 73 65 64 20 62 79 74 65 73 20 61 74 unused bytes at
8100: 20 65 6e 64 20 6f 66 20 65 61 63 68 20 70 61 67 end of each pag
8110: 65 20 2a 2f 0a 20 20 75 33 32 20 76 66 73 46 6c e */. u32 vfsFl
8120: 61 67 73 3b 20 20 20 20 20 20 20 20 20 20 20 20 ags;
8130: 20 20 20 2f 2a 20 46 6c 61 67 73 20 66 6f 72 20 /* Flags for
8140: 73 71 6c 69 74 65 33 5f 76 66 73 2e 78 4f 70 65 sqlite3_vfs.xOpe
8150: 6e 28 29 20 2a 2f 0a 20 20 75 33 32 20 73 65 63 n() */. u32 sec
8160: 74 6f 72 53 69 7a 65 3b 20 20 20 20 20 20 20 20 torSize;
8170: 20 20 20 20 20 2f 2a 20 41 73 73 75 6d 65 64 20 /* Assumed
8180: 73 65 63 74 6f 72 20 73 69 7a 65 20 64 75 72 69 sector size duri
8190: 6e 67 20 72 6f 6c 6c 62 61 63 6b 20 2a 2f 0a 20 ng rollback */.
81a0: 20 69 6e 74 20 70 61 67 65 53 69 7a 65 3b 20 20 int pageSize;
81b0: 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 /*
81c0: 4e 75 6d 62 65 72 20 6f 66 20 62 79 74 65 73 20 Number of bytes
81d0: 69 6e 20 61 20 70 61 67 65 20 2a 2f 0a 20 20 50 in a page */. P
81e0: 67 6e 6f 20 6d 78 50 67 6e 6f 3b 20 20 20 20 20 gno mxPgno;
81f0: 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4d 61 /* Ma
8200: 78 69 6d 75 6d 20 61 6c 6c 6f 77 65 64 20 73 69 ximum allowed si
8210: 7a 65 20 6f 66 20 74 68 65 20 64 61 74 61 62 61 ze of the databa
8220: 73 65 20 2a 2f 0a 20 20 69 36 34 20 6a 6f 75 72 se */. i64 jour
8230: 6e 61 6c 53 69 7a 65 4c 69 6d 69 74 3b 20 20 20 nalSizeLimit;
8240: 20 20 20 20 2f 2a 20 53 69 7a 65 20 6c 69 6d 69 /* Size limi
8250: 74 20 66 6f 72 20 70 65 72 73 69 73 74 65 6e 74 t for persistent
8260: 20 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 73 20 2a journal files *
8270: 2f 0a 20 20 63 68 61 72 20 2a 7a 46 69 6c 65 6e /. char *zFilen
8280: 61 6d 65 3b 20 20 20 20 20 20 20 20 20 20 20 20 ame;
8290: 2f 2a 20 4e 61 6d 65 20 6f 66 20 74 68 65 20 64 /* Name of the d
82a0: 61 74 61 62 61 73 65 20 66 69 6c 65 20 2a 2f 0a atabase file */.
82b0: 20 20 63 68 61 72 20 2a 7a 4a 6f 75 72 6e 61 6c char *zJournal
82c0: 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a ; /*
82d0: 20 4e 61 6d 65 20 6f 66 20 74 68 65 20 6a 6f 75 Name of the jou
82e0: 72 6e 61 6c 20 66 69 6c 65 20 2a 2f 0a 20 20 69 rnal file */. i
82f0: 6e 74 20 28 2a 78 42 75 73 79 48 61 6e 64 6c 65 nt (*xBusyHandle
8300: 72 29 28 76 6f 69 64 2a 29 3b 20 2f 2a 20 46 75 r)(void*); /* Fu
8310: 6e 63 74 69 6f 6e 20 74 6f 20 63 61 6c 6c 20 77 nction to call w
8320: 68 65 6e 20 62 75 73 79 20 2a 2f 0a 20 20 76 6f hen busy */. vo
8330: 69 64 20 2a 70 42 75 73 79 48 61 6e 64 6c 65 72 id *pBusyHandler
8340: 41 72 67 3b 20 20 20 20 20 20 2f 2a 20 43 6f 6e Arg; /* Con
8350: 74 65 78 74 20 61 72 67 75 6d 65 6e 74 20 66 6f text argument fo
8360: 72 20 78 42 75 73 79 48 61 6e 64 6c 65 72 20 2a r xBusyHandler *
8370: 2f 0a 20 20 69 6e 74 20 61 53 74 61 74 5b 33 5d /. int aStat[3]
8380: 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 ;
8390: 2f 2a 20 54 6f 74 61 6c 20 63 61 63 68 65 20 68 /* Total cache h
83a0: 69 74 73 2c 20 6d 69 73 73 65 73 20 61 6e 64 20 its, misses and
83b0: 77 72 69 74 65 73 20 2a 2f 0a 23 69 66 64 65 66 writes */.#ifdef
83c0: 20 53 51 4c 49 54 45 5f 54 45 53 54 0a 20 20 69 SQLITE_TEST. i
83d0: 6e 74 20 6e 52 65 61 64 3b 20 20 20 20 20 20 20 nt nRead;
83e0: 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 44 61 /* Da
83f0: 74 61 62 61 73 65 20 70 61 67 65 73 20 72 65 61 tabase pages rea
8400: 64 20 2a 2f 0a 23 65 6e 64 69 66 0a 20 20 76 6f d */.#endif. vo
8410: 69 64 20 28 2a 78 52 65 69 6e 69 74 65 72 29 28 id (*xReiniter)(
8420: 44 62 50 61 67 65 2a 29 3b 20 2f 2a 20 43 61 6c DbPage*); /* Cal
8430: 6c 20 74 68 69 73 20 72 6f 75 74 69 6e 65 20 77 l this routine w
8440: 68 65 6e 20 72 65 6c 6f 61 64 69 6e 67 20 70 61 hen reloading pa
8450: 67 65 73 20 2a 2f 0a 23 69 66 64 65 66 20 53 51 ges */.#ifdef SQ
8460: 4c 49 54 45 5f 48 41 53 5f 43 4f 44 45 43 0a 20 LITE_HAS_CODEC.
8470: 20 76 6f 69 64 20 2a 28 2a 78 43 6f 64 65 63 29 void *(*xCodec)
8480: 28 76 6f 69 64 2a 2c 76 6f 69 64 2a 2c 50 67 6e (void*,void*,Pgn
8490: 6f 2c 69 6e 74 29 3b 20 2f 2a 20 52 6f 75 74 69 o,int); /* Routi
84a0: 6e 65 20 66 6f 72 20 65 6e 2f 64 65 63 6f 64 69 ne for en/decodi
84b0: 6e 67 20 64 61 74 61 20 2a 2f 0a 20 20 76 6f 69 ng data */. voi
84c0: 64 20 28 2a 78 43 6f 64 65 63 53 69 7a 65 43 68 d (*xCodecSizeCh
84d0: 6e 67 29 28 76 6f 69 64 2a 2c 69 6e 74 2c 69 6e ng)(void*,int,in
84e0: 74 29 3b 20 2f 2a 20 4e 6f 74 69 66 79 20 6f 66 t); /* Notify of
84f0: 20 70 61 67 65 20 73 69 7a 65 20 63 68 61 6e 67 page size chang
8500: 65 73 20 2a 2f 0a 20 20 76 6f 69 64 20 28 2a 78 es */. void (*x
8510: 43 6f 64 65 63 46 72 65 65 29 28 76 6f 69 64 2a CodecFree)(void*
8520: 29 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 2f ); /
8530: 2a 20 44 65 73 74 72 75 63 74 6f 72 20 66 6f 72 * Destructor for
8540: 20 74 68 65 20 63 6f 64 65 63 20 2a 2f 0a 20 20 the codec */.
8550: 76 6f 69 64 20 2a 70 43 6f 64 65 63 3b 20 20 20 void *pCodec;
8560: 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 46 /* F
8570: 69 72 73 74 20 61 72 67 75 6d 65 6e 74 20 74 6f irst argument to
8580: 20 78 43 6f 64 65 63 2e 2e 2e 20 6d 65 74 68 6f xCodec... metho
8590: 64 73 20 2a 2f 0a 23 65 6e 64 69 66 0a 20 20 63 ds */.#endif. c
85a0: 68 61 72 20 2a 70 54 6d 70 53 70 61 63 65 3b 20 har *pTmpSpace;
85b0: 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 50 61 /* Pa
85c0: 67 65 72 2e 70 61 67 65 53 69 7a 65 20 62 79 74 ger.pageSize byt
85d0: 65 73 20 6f 66 20 73 70 61 63 65 20 66 6f 72 20 es of space for
85e0: 74 6d 70 20 75 73 65 20 2a 2f 0a 20 20 50 43 61 tmp use */. PCa
85f0: 63 68 65 20 2a 70 50 43 61 63 68 65 3b 20 20 20 che *pPCache;
8600: 20 20 20 20 20 20 20 20 20 2f 2a 20 50 6f 69 6e /* Poin
8610: 74 65 72 20 74 6f 20 70 61 67 65 20 63 61 63 68 ter to page cach
8620: 65 20 6f 62 6a 65 63 74 20 2a 2f 0a 23 69 66 6e e object */.#ifn
8630: 64 65 66 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f def SQLITE_OMIT_
8640: 57 41 4c 0a 20 20 57 61 6c 20 2a 70 57 61 6c 3b WAL. Wal *pWal;
8650: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
8660: 20 20 2f 2a 20 57 72 69 74 65 2d 61 68 65 61 64 /* Write-ahead
8670: 20 6c 6f 67 20 75 73 65 64 20 62 79 20 22 6a 6f log used by "jo
8680: 75 72 6e 61 6c 5f 6d 6f 64 65 3d 77 61 6c 22 20 urnal_mode=wal"
8690: 2a 2f 0a 20 20 63 68 61 72 20 2a 7a 57 61 6c 3b */. char *zWal;
86a0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
86b0: 20 2f 2a 20 46 69 6c 65 20 6e 61 6d 65 20 66 6f /* File name fo
86c0: 72 20 77 72 69 74 65 2d 61 68 65 61 64 20 6c 6f r write-ahead lo
86d0: 67 20 2a 2f 0a 23 65 6e 64 69 66 0a 7d 3b 0a 0a g */.#endif.};..
86e0: 2f 2a 0a 2a 2a 20 49 6e 64 65 78 65 73 20 66 6f /*.** Indexes fo
86f0: 72 20 75 73 65 20 77 69 74 68 20 50 61 67 65 72 r use with Pager
8700: 2e 61 53 74 61 74 5b 5d 2e 20 54 68 65 20 50 61 .aStat[]. The Pa
8710: 67 65 72 2e 61 53 74 61 74 5b 5d 20 61 72 72 61 ger.aStat[] arra
8720: 79 20 63 6f 6e 74 61 69 6e 73 0a 2a 2a 20 74 68 y contains.** th
8730: 65 20 76 61 6c 75 65 73 20 61 63 63 65 73 73 65 e values accesse
8740: 64 20 62 79 20 70 61 73 73 69 6e 67 20 53 51 4c d by passing SQL
8750: 49 54 45 5f 44 42 53 54 41 54 55 53 5f 43 41 43 ITE_DBSTATUS_CAC
8760: 48 45 5f 48 49 54 2c 20 43 41 43 48 45 5f 4d 49 HE_HIT, CACHE_MI
8770: 53 53 20 0a 2a 2a 20 6f 72 20 43 41 43 48 45 5f SS .** or CACHE_
8780: 57 52 49 54 45 20 74 6f 20 73 71 6c 69 74 65 33 WRITE to sqlite3
8790: 5f 64 62 5f 73 74 61 74 75 73 28 29 2e 0a 2a 2f _db_status()..*/
87a0: 0a 23 64 65 66 69 6e 65 20 50 41 47 45 52 5f 53 .#define PAGER_S
87b0: 54 41 54 5f 48 49 54 20 20 20 30 0a 23 64 65 66 TAT_HIT 0.#def
87c0: 69 6e 65 20 50 41 47 45 52 5f 53 54 41 54 5f 4d ine PAGER_STAT_M
87d0: 49 53 53 20 20 31 0a 23 64 65 66 69 6e 65 20 50 ISS 1.#define P
87e0: 41 47 45 52 5f 53 54 41 54 5f 57 52 49 54 45 20 AGER_STAT_WRITE
87f0: 32 0a 0a 2f 2a 0a 2a 2a 20 54 68 65 20 66 6f 6c 2../*.** The fol
8800: 6c 6f 77 69 6e 67 20 67 6c 6f 62 61 6c 20 76 61 lowing global va
8810: 72 69 61 62 6c 65 73 20 68 6f 6c 64 20 63 6f 75 riables hold cou
8820: 6e 74 65 72 73 20 75 73 65 64 20 66 6f 72 0a 2a nters used for.*
8830: 2a 20 74 65 73 74 69 6e 67 20 70 75 72 70 6f 73 * testing purpos
8840: 65 73 20 6f 6e 6c 79 2e 20 20 54 68 65 73 65 20 es only. These
8850: 76 61 72 69 61 62 6c 65 73 20 64 6f 20 6e 6f 74 variables do not
8860: 20 65 78 69 73 74 20 69 6e 0a 2a 2a 20 61 20 6e exist in.** a n
8870: 6f 6e 2d 74 65 73 74 69 6e 67 20 62 75 69 6c 64 on-testing build
8880: 2e 20 20 54 68 65 73 65 20 76 61 72 69 61 62 6c . These variabl
8890: 65 73 20 61 72 65 20 6e 6f 74 20 74 68 72 65 61 es are not threa
88a0: 64 2d 73 61 66 65 2e 0a 2a 2f 0a 23 69 66 64 65 d-safe..*/.#ifde
88b0: 66 20 53 51 4c 49 54 45 5f 54 45 53 54 0a 69 6e f SQLITE_TEST.in
88c0: 74 20 73 71 6c 69 74 65 33 5f 70 61 67 65 72 5f t sqlite3_pager_
88d0: 72 65 61 64 64 62 5f 63 6f 75 6e 74 20 3d 20 30 readdb_count = 0
88e0: 3b 20 20 20 20 2f 2a 20 4e 75 6d 62 65 72 20 6f ; /* Number o
88f0: 66 20 66 75 6c 6c 20 70 61 67 65 73 20 72 65 61 f full pages rea
8900: 64 20 66 72 6f 6d 20 44 42 20 2a 2f 0a 69 6e 74 d from DB */.int
8910: 20 73 71 6c 69 74 65 33 5f 70 61 67 65 72 5f 77 sqlite3_pager_w
8920: 72 69 74 65 64 62 5f 63 6f 75 6e 74 20 3d 20 30 ritedb_count = 0
8930: 3b 20 20 20 2f 2a 20 4e 75 6d 62 65 72 20 6f 66 ; /* Number of
8940: 20 66 75 6c 6c 20 70 61 67 65 73 20 77 72 69 74 full pages writ
8950: 74 65 6e 20 74 6f 20 44 42 20 2a 2f 0a 69 6e 74 ten to DB */.int
8960: 20 73 71 6c 69 74 65 33 5f 70 61 67 65 72 5f 77 sqlite3_pager_w
8970: 72 69 74 65 6a 5f 63 6f 75 6e 74 20 3d 20 30 3b ritej_count = 0;
8980: 20 20 20 20 2f 2a 20 4e 75 6d 62 65 72 20 6f 66 /* Number of
8990: 20 70 61 67 65 73 20 77 72 69 74 74 65 6e 20 74 pages written t
89a0: 6f 20 6a 6f 75 72 6e 61 6c 20 2a 2f 0a 23 20 64 o journal */.# d
89b0: 65 66 69 6e 65 20 50 41 47 45 52 5f 49 4e 43 52 efine PAGER_INCR
89c0: 28 76 29 20 20 76 2b 2b 0a 23 65 6c 73 65 0a 23 (v) v++.#else.#
89d0: 20 64 65 66 69 6e 65 20 50 41 47 45 52 5f 49 4e define PAGER_IN
89e0: 43 52 28 76 29 0a 23 65 6e 64 69 66 0a 0a 0a 0a CR(v).#endif....
89f0: 2f 2a 0a 2a 2a 20 4a 6f 75 72 6e 61 6c 20 66 69 /*.** Journal fi
8a00: 6c 65 73 20 62 65 67 69 6e 20 77 69 74 68 20 74 les begin with t
8a10: 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 6d 61 67 he following mag
8a20: 69 63 20 73 74 72 69 6e 67 2e 20 20 54 68 65 20 ic string. The
8a30: 64 61 74 61 0a 2a 2a 20 77 61 73 20 6f 62 74 61 data.** was obta
8a40: 69 6e 65 64 20 66 72 6f 6d 20 2f 64 65 76 2f 72 ined from /dev/r
8a50: 61 6e 64 6f 6d 2e 20 20 49 74 20 69 73 20 75 73 andom. It is us
8a60: 65 64 20 6f 6e 6c 79 20 61 73 20 61 20 73 61 6e ed only as a san
8a70: 69 74 79 20 63 68 65 63 6b 2e 0a 2a 2a 0a 2a 2a ity check..**.**
8a80: 20 53 69 6e 63 65 20 76 65 72 73 69 6f 6e 20 32 Since version 2
8a90: 2e 38 2e 30 2c 20 74 68 65 20 6a 6f 75 72 6e 61 .8.0, the journa
8aa0: 6c 20 66 6f 72 6d 61 74 20 63 6f 6e 74 61 69 6e l format contain
8ab0: 73 20 61 64 64 69 74 69 6f 6e 61 6c 20 73 61 6e s additional san
8ac0: 69 74 79 0a 2a 2a 20 63 68 65 63 6b 69 6e 67 20 ity.** checking
8ad0: 69 6e 66 6f 72 6d 61 74 69 6f 6e 2e 20 20 49 66 information. If
8ae0: 20 74 68 65 20 70 6f 77 65 72 20 66 61 69 6c 73 the power fails
8af0: 20 77 68 69 6c 65 20 74 68 65 20 6a 6f 75 72 6e while the journ
8b00: 61 6c 20 69 73 20 62 65 69 6e 67 0a 2a 2a 20 77 al is being.** w
8b10: 72 69 74 74 65 6e 2c 20 73 65 6d 69 2d 72 61 6e ritten, semi-ran
8b20: 64 6f 6d 20 67 61 72 62 61 67 65 20 64 61 74 61 dom garbage data
8b30: 20 6d 69 67 68 74 20 61 70 70 65 61 72 20 69 6e might appear in
8b40: 20 74 68 65 20 6a 6f 75 72 6e 61 6c 0a 2a 2a 20 the journal.**
8b50: 66 69 6c 65 20 61 66 74 65 72 20 70 6f 77 65 72 file after power
8b60: 20 69 73 20 72 65 73 74 6f 72 65 64 2e 20 20 49 is restored. I
8b70: 66 20 61 6e 20 61 74 74 65 6d 70 74 20 69 73 20 f an attempt is
8b80: 74 68 65 6e 20 6d 61 64 65 0a 2a 2a 20 74 6f 20 then made.** to
8b90: 72 6f 6c 6c 20 74 68 65 20 6a 6f 75 72 6e 61 6c roll the journal
8ba0: 20 62 61 63 6b 2c 20 74 68 65 20 64 61 74 61 62 back, the datab
8bb0: 61 73 65 20 63 6f 75 6c 64 20 62 65 20 63 6f 72 ase could be cor
8bc0: 72 75 70 74 65 64 2e 20 20 54 68 65 20 61 64 64 rupted. The add
8bd0: 69 74 69 6f 6e 61 6c 0a 2a 2a 20 73 61 6e 69 74 itional.** sanit
8be0: 79 20 63 68 65 63 6b 69 6e 67 20 64 61 74 61 20 y checking data
8bf0: 69 73 20 61 6e 20 61 74 74 65 6d 70 74 20 74 6f is an attempt to
8c00: 20 64 69 73 63 6f 76 65 72 20 74 68 65 20 67 61 discover the ga
8c10: 72 62 61 67 65 20 69 6e 20 74 68 65 0a 2a 2a 20 rbage in the.**
8c20: 6a 6f 75 72 6e 61 6c 20 61 6e 64 20 69 67 6e 6f journal and igno
8c30: 72 65 20 69 74 2e 0a 2a 2a 0a 2a 2a 20 54 68 65 re it..**.** The
8c40: 20 73 61 6e 69 74 79 20 63 68 65 63 6b 69 6e 67 sanity checking
8c50: 20 69 6e 66 6f 72 6d 61 74 69 6f 6e 20 66 6f 72 information for
8c60: 20 74 68 65 20 6e 65 77 20 6a 6f 75 72 6e 61 6c the new journal
8c70: 20 66 6f 72 6d 61 74 20 63 6f 6e 73 69 73 74 73 format consists
8c80: 0a 2a 2a 20 6f 66 20 61 20 33 32 2d 62 69 74 20 .** of a 32-bit
8c90: 63 68 65 63 6b 73 75 6d 20 6f 6e 20 65 61 63 68 checksum on each
8ca0: 20 70 61 67 65 20 6f 66 20 64 61 74 61 2e 20 20 page of data.
8cb0: 54 68 65 20 63 68 65 63 6b 73 75 6d 20 63 6f 76 The checksum cov
8cc0: 65 72 73 20 62 6f 74 68 0a 2a 2a 20 74 68 65 20 ers both.** the
8cd0: 70 61 67 65 20 6e 75 6d 62 65 72 20 61 6e 64 20 page number and
8ce0: 74 68 65 20 70 50 61 67 65 72 2d 3e 70 61 67 65 the pPager->page
8cf0: 53 69 7a 65 20 62 79 74 65 73 20 6f 66 20 64 61 Size bytes of da
8d00: 74 61 20 66 6f 72 20 74 68 65 20 70 61 67 65 2e ta for the page.
8d10: 0a 2a 2a 20 54 68 69 73 20 63 6b 73 75 6d 20 69 .** This cksum i
8d20: 73 20 69 6e 69 74 69 61 6c 69 7a 65 64 20 74 6f s initialized to
8d30: 20 61 20 33 32 2d 62 69 74 20 72 61 6e 64 6f 6d a 32-bit random
8d40: 20 76 61 6c 75 65 20 74 68 61 74 20 61 70 70 65 value that appe
8d50: 61 72 73 20 69 6e 20 74 68 65 0a 2a 2a 20 6a 6f ars in the.** jo
8d60: 75 72 6e 61 6c 20 66 69 6c 65 20 72 69 67 68 74 urnal file right
8d70: 20 61 66 74 65 72 20 74 68 65 20 68 65 61 64 65 after the heade
8d80: 72 2e 20 20 54 68 65 20 72 61 6e 64 6f 6d 20 69 r. The random i
8d90: 6e 69 74 69 61 6c 69 7a 65 72 20 69 73 20 69 6d nitializer is im
8da0: 70 6f 72 74 61 6e 74 2c 0a 2a 2a 20 62 65 63 61 portant,.** beca
8db0: 75 73 65 20 67 61 72 62 61 67 65 20 64 61 74 61 use garbage data
8dc0: 20 74 68 61 74 20 61 70 70 65 61 72 73 20 61 74 that appears at
8dd0: 20 74 68 65 20 65 6e 64 20 6f 66 20 61 20 6a 6f the end of a jo
8de0: 75 72 6e 61 6c 20 69 73 20 6c 69 6b 65 6c 79 0a urnal is likely.
8df0: 2a 2a 20 64 61 74 61 20 74 68 61 74 20 77 61 73 ** data that was
8e00: 20 6f 6e 63 65 20 69 6e 20 6f 74 68 65 72 20 66 once in other f
8e10: 69 6c 65 73 20 74 68 61 74 20 68 61 76 65 20 6e iles that have n
8e20: 6f 77 20 62 65 65 6e 20 64 65 6c 65 74 65 64 2e ow been deleted.
8e30: 20 20 49 66 20 74 68 65 0a 2a 2a 20 67 61 72 62 If the.** garb
8e40: 61 67 65 20 64 61 74 61 20 63 61 6d 65 20 66 72 age data came fr
8e50: 6f 6d 20 61 6e 20 6f 62 73 6f 6c 65 74 65 20 6a om an obsolete j
8e60: 6f 75 72 6e 61 6c 20 66 69 6c 65 2c 20 74 68 65 ournal file, the
8e70: 20 63 68 65 63 6b 73 75 6d 73 20 6d 69 67 68 74 checksums might
8e80: 0a 2a 2a 20 62 65 20 63 6f 72 72 65 63 74 2e 20 .** be correct.
8e90: 20 42 75 74 20 62 79 20 69 6e 69 74 69 61 6c 69 But by initiali
8ea0: 7a 69 6e 67 20 74 68 65 20 63 68 65 63 6b 73 75 zing the checksu
8eb0: 6d 20 74 6f 20 72 61 6e 64 6f 6d 20 76 61 6c 75 m to random valu
8ec0: 65 20 77 68 69 63 68 0a 2a 2a 20 69 73 20 64 69 e which.** is di
8ed0: 66 66 65 72 65 6e 74 20 66 6f 72 20 65 76 65 72 fferent for ever
8ee0: 79 20 6a 6f 75 72 6e 61 6c 2c 20 77 65 20 6d 69 y journal, we mi
8ef0: 6e 69 6d 69 7a 65 20 74 68 61 74 20 72 69 73 6b nimize that risk
8f00: 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 63 6f 6e 73 ..*/.static cons
8f10: 74 20 75 6e 73 69 67 6e 65 64 20 63 68 61 72 20 t unsigned char
8f20: 61 4a 6f 75 72 6e 61 6c 4d 61 67 69 63 5b 5d 20 aJournalMagic[]
8f30: 3d 20 7b 0a 20 20 30 78 64 39 2c 20 30 78 64 35 = {. 0xd9, 0xd5
8f40: 2c 20 30 78 30 35 2c 20 30 78 66 39 2c 20 30 78 , 0x05, 0xf9, 0x
8f50: 32 30 2c 20 30 78 61 31 2c 20 30 78 36 33 2c 20 20, 0xa1, 0x63,
8f60: 30 78 64 37 2c 0a 7d 3b 0a 0a 2f 2a 0a 2a 2a 20 0xd7,.};../*.**
8f70: 54 68 65 20 73 69 7a 65 20 6f 66 20 74 68 65 20 The size of the
8f80: 6f 66 20 65 61 63 68 20 70 61 67 65 20 72 65 63 of each page rec
8f90: 6f 72 64 20 69 6e 20 74 68 65 20 6a 6f 75 72 6e ord in the journ
8fa0: 61 6c 20 69 73 20 67 69 76 65 6e 20 62 79 0a 2a al is given by.*
8fb0: 2a 20 74 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 * the following
8fc0: 6d 61 63 72 6f 2e 0a 2a 2f 0a 23 64 65 66 69 6e macro..*/.#defin
8fd0: 65 20 4a 4f 55 52 4e 41 4c 5f 50 47 5f 53 5a 28 e JOURNAL_PG_SZ(
8fe0: 70 50 61 67 65 72 29 20 20 28 28 70 50 61 67 65 pPager) ((pPage
8ff0: 72 2d 3e 70 61 67 65 53 69 7a 65 29 20 2b 20 38 r->pageSize) + 8
9000: 29 0a 0a 2f 2a 0a 2a 2a 20 54 68 65 20 6a 6f 75 )../*.** The jou
9010: 72 6e 61 6c 20 68 65 61 64 65 72 20 73 69 7a 65 rnal header size
9020: 20 66 6f 72 20 74 68 69 73 20 70 61 67 65 72 2e for this pager.
9030: 20 54 68 69 73 20 69 73 20 75 73 75 61 6c 6c 79 This is usually
9040: 20 74 68 65 20 73 61 6d 65 20 0a 2a 2a 20 73 69 the same .** si
9050: 7a 65 20 61 73 20 61 20 73 69 6e 67 6c 65 20 64 ze as a single d
9060: 69 73 6b 20 73 65 63 74 6f 72 2e 20 53 65 65 20 isk sector. See
9070: 61 6c 73 6f 20 73 65 74 53 65 63 74 6f 72 53 69 also setSectorSi
9080: 7a 65 28 29 2e 0a 2a 2f 0a 23 64 65 66 69 6e 65 ze()..*/.#define
9090: 20 4a 4f 55 52 4e 41 4c 5f 48 44 52 5f 53 5a 28 JOURNAL_HDR_SZ(
90a0: 70 50 61 67 65 72 29 20 28 70 50 61 67 65 72 2d pPager) (pPager-
90b0: 3e 73 65 63 74 6f 72 53 69 7a 65 29 0a 0a 2f 2a >sectorSize)../*
90c0: 0a 2a 2a 20 54 68 65 20 6d 61 63 72 6f 20 4d 45 .** The macro ME
90d0: 4d 44 42 20 69 73 20 74 72 75 65 20 69 66 20 77 MDB is true if w
90e0: 65 20 61 72 65 20 64 65 61 6c 69 6e 67 20 77 69 e are dealing wi
90f0: 74 68 20 61 6e 20 69 6e 2d 6d 65 6d 6f 72 79 20 th an in-memory
9100: 64 61 74 61 62 61 73 65 2e 0a 2a 2a 20 57 65 20 database..** We
9110: 64 6f 20 74 68 69 73 20 61 73 20 61 20 6d 61 63 do this as a mac
9120: 72 6f 20 73 6f 20 74 68 61 74 20 69 66 20 74 68 ro so that if th
9130: 65 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 4d 45 e SQLITE_OMIT_ME
9140: 4d 4f 52 59 44 42 20 6d 61 63 72 6f 20 69 73 20 MORYDB macro is
9150: 73 65 74 2c 0a 2a 2a 20 74 68 65 20 76 61 6c 75 set,.** the valu
9160: 65 20 6f 66 20 4d 45 4d 44 42 20 77 69 6c 6c 20 e of MEMDB will
9170: 62 65 20 61 20 63 6f 6e 73 74 61 6e 74 20 61 6e be a constant an
9180: 64 20 74 68 65 20 63 6f 6d 70 69 6c 65 72 20 77 d the compiler w
9190: 69 6c 6c 20 6f 70 74 69 6d 69 7a 65 0a 2a 2a 20 ill optimize.**
91a0: 6f 75 74 20 63 6f 64 65 20 74 68 61 74 20 77 6f out code that wo
91b0: 75 6c 64 20 6e 65 76 65 72 20 65 78 65 63 75 74 uld never execut
91c0: 65 2e 0a 2a 2f 0a 23 69 66 64 65 66 20 53 51 4c e..*/.#ifdef SQL
91d0: 49 54 45 5f 4f 4d 49 54 5f 4d 45 4d 4f 52 59 44 ITE_OMIT_MEMORYD
91e0: 42 0a 23 20 64 65 66 69 6e 65 20 4d 45 4d 44 42 B.# define MEMDB
91f0: 20 30 0a 23 65 6c 73 65 0a 23 20 64 65 66 69 6e 0.#else.# defin
9200: 65 20 4d 45 4d 44 42 20 70 50 61 67 65 72 2d 3e e MEMDB pPager->
9210: 6d 65 6d 44 62 0a 23 65 6e 64 69 66 0a 0a 2f 2a memDb.#endif../*
9220: 0a 2a 2a 20 54 68 65 20 6d 61 63 72 6f 20 55 53 .** The macro US
9230: 45 46 45 54 43 48 20 69 73 20 74 72 75 65 20 69 EFETCH is true i
9240: 66 20 77 65 20 61 72 65 20 61 6c 6c 6f 77 65 64 f we are allowed
9250: 20 74 6f 20 75 73 65 20 74 68 65 20 78 46 65 74 to use the xFet
9260: 63 68 20 61 6e 64 20 78 55 6e 66 65 74 63 68 0a ch and xUnfetch.
9270: 2a 2a 20 69 6e 74 65 72 66 61 63 65 73 20 74 6f ** interfaces to
9280: 20 61 63 63 65 73 73 20 74 68 65 20 64 61 74 61 access the data
9290: 62 61 73 65 20 75 73 69 6e 67 20 6d 65 6d 6f 72 base using memor
92a0: 79 2d 6d 61 70 70 65 64 20 49 2f 4f 2e 0a 2a 2f y-mapped I/O..*/
92b0: 0a 23 69 66 20 53 51 4c 49 54 45 5f 4d 41 58 5f .#if SQLITE_MAX_
92c0: 4d 4d 41 50 5f 53 49 5a 45 3e 30 0a 23 20 64 65 MMAP_SIZE>0.# de
92d0: 66 69 6e 65 20 55 53 45 46 45 54 43 48 28 78 29 fine USEFETCH(x)
92e0: 20 28 28 78 29 2d 3e 62 55 73 65 46 65 74 63 68 ((x)->bUseFetch
92f0: 29 0a 23 65 6c 73 65 0a 23 20 64 65 66 69 6e 65 ).#else.# define
9300: 20 55 53 45 46 45 54 43 48 28 78 29 20 30 0a 23 USEFETCH(x) 0.#
9310: 65 6e 64 69 66 0a 0a 2f 2a 0a 2a 2a 20 54 68 65 endif../*.** The
9320: 20 6d 61 78 69 6d 75 6d 20 6c 65 67 61 6c 20 70 maximum legal p
9330: 61 67 65 20 6e 75 6d 62 65 72 20 69 73 20 28 32 age number is (2
9340: 5e 33 31 20 2d 20 31 29 2e 0a 2a 2f 0a 23 64 65 ^31 - 1)..*/.#de
9350: 66 69 6e 65 20 50 41 47 45 52 5f 4d 41 58 5f 50 fine PAGER_MAX_P
9360: 47 4e 4f 20 32 31 34 37 34 38 33 36 34 37 0a 0a GNO 2147483647..
9370: 2f 2a 0a 2a 2a 20 54 68 65 20 61 72 67 75 6d 65 /*.** The argume
9380: 6e 74 20 74 6f 20 74 68 69 73 20 6d 61 63 72 6f nt to this macro
9390: 20 69 73 20 61 20 66 69 6c 65 20 64 65 73 63 72 is a file descr
93a0: 69 70 74 6f 72 20 28 74 79 70 65 20 73 71 6c 69 iptor (type sqli
93b0: 74 65 33 5f 66 69 6c 65 2a 29 2e 0a 2a 2a 20 52 te3_file*)..** R
93c0: 65 74 75 72 6e 20 30 20 69 66 20 69 74 20 69 73 eturn 0 if it is
93d0: 20 6e 6f 74 20 6f 70 65 6e 2c 20 6f 72 20 6e 6f not open, or no
93e0: 6e 2d 7a 65 72 6f 20 28 62 75 74 20 6e 6f 74 20 n-zero (but not
93f0: 31 29 20 69 66 20 69 74 20 69 73 2e 0a 2a 2a 0a 1) if it is..**.
9400: 2a 2a 20 54 68 69 73 20 69 73 20 73 6f 20 74 68 ** This is so th
9410: 61 74 20 65 78 70 72 65 73 73 69 6f 6e 73 20 63 at expressions c
9420: 61 6e 20 62 65 20 77 72 69 74 74 65 6e 20 61 73 an be written as
9430: 3a 0a 2a 2a 0a 2a 2a 20 20 20 69 66 28 20 69 73 :.**.** if( is
9440: 4f 70 65 6e 28 70 50 61 67 65 72 2d 3e 6a 66 64 Open(pPager->jfd
9450: 29 20 29 7b 20 2e 2e 2e 0a 2a 2a 0a 2a 2a 20 69 ) ){ ....**.** i
9460: 6e 73 74 65 61 64 20 6f 66 0a 2a 2a 0a 2a 2a 20 nstead of.**.**
9470: 20 20 69 66 28 20 70 50 61 67 65 72 2d 3e 6a 66 if( pPager->jf
9480: 64 2d 3e 70 4d 65 74 68 6f 64 73 20 29 7b 20 2e d->pMethods ){ .
9490: 2e 2e 0a 2a 2f 0a 23 64 65 66 69 6e 65 20 69 73 ...*/.#define is
94a0: 4f 70 65 6e 28 70 46 64 29 20 28 28 70 46 64 29 Open(pFd) ((pFd)
94b0: 2d 3e 70 4d 65 74 68 6f 64 73 21 3d 30 29 0a 0a ->pMethods!=0)..
94c0: 2f 2a 0a 2a 2a 20 52 65 74 75 72 6e 20 74 72 75 /*.** Return tru
94d0: 65 20 69 66 20 74 68 69 73 20 70 61 67 65 72 20 e if this pager
94e0: 75 73 65 73 20 61 20 77 72 69 74 65 2d 61 68 65 uses a write-ahe
94f0: 61 64 20 6c 6f 67 20 69 6e 73 74 65 61 64 20 6f ad log instead o
9500: 66 20 74 68 65 20 75 73 75 61 6c 0a 2a 2a 20 72 f the usual.** r
9510: 6f 6c 6c 62 61 63 6b 20 6a 6f 75 72 6e 61 6c 2e ollback journal.
9520: 20 4f 74 68 65 72 77 69 73 65 20 66 61 6c 73 65 Otherwise false
9530: 2e 0a 2a 2f 0a 23 69 66 6e 64 65 66 20 53 51 4c ..*/.#ifndef SQL
9540: 49 54 45 5f 4f 4d 49 54 5f 57 41 4c 0a 73 74 61 ITE_OMIT_WAL.sta
9550: 74 69 63 20 69 6e 74 20 70 61 67 65 72 55 73 65 tic int pagerUse
9560: 57 61 6c 28 50 61 67 65 72 20 2a 70 50 61 67 65 Wal(Pager *pPage
9570: 72 29 7b 0a 20 20 72 65 74 75 72 6e 20 28 70 50 r){. return (pP
9580: 61 67 65 72 2d 3e 70 57 61 6c 21 3d 30 29 3b 0a ager->pWal!=0);.
9590: 7d 0a 23 65 6c 73 65 0a 23 20 64 65 66 69 6e 65 }.#else.# define
95a0: 20 70 61 67 65 72 55 73 65 57 61 6c 28 78 29 20 pagerUseWal(x)
95b0: 30 0a 23 20 64 65 66 69 6e 65 20 70 61 67 65 72 0.# define pager
95c0: 52 6f 6c 6c 62 61 63 6b 57 61 6c 28 78 29 20 30 RollbackWal(x) 0
95d0: 0a 23 20 64 65 66 69 6e 65 20 70 61 67 65 72 57 .# define pagerW
95e0: 61 6c 46 72 61 6d 65 73 28 76 2c 77 2c 78 2c 79 alFrames(v,w,x,y
95f0: 29 20 30 0a 23 20 64 65 66 69 6e 65 20 70 61 67 ) 0.# define pag
9600: 65 72 4f 70 65 6e 57 61 6c 49 66 50 72 65 73 65 erOpenWalIfPrese
9610: 6e 74 28 7a 29 20 53 51 4c 49 54 45 5f 4f 4b 0a nt(z) SQLITE_OK.
9620: 23 20 64 65 66 69 6e 65 20 70 61 67 65 72 42 65 # define pagerBe
9630: 67 69 6e 52 65 61 64 54 72 61 6e 73 61 63 74 69 ginReadTransacti
9640: 6f 6e 28 7a 29 20 53 51 4c 49 54 45 5f 4f 4b 0a on(z) SQLITE_OK.
9650: 23 65 6e 64 69 66 0a 0a 23 69 66 6e 64 65 66 20 #endif..#ifndef
9660: 4e 44 45 42 55 47 20 0a 2f 2a 0a 2a 2a 20 55 73 NDEBUG ./*.** Us
9670: 61 67 65 3a 0a 2a 2a 0a 2a 2a 20 20 20 61 73 73 age:.**.** ass
9680: 65 72 74 28 20 61 73 73 65 72 74 5f 70 61 67 65 ert( assert_page
9690: 72 5f 73 74 61 74 65 28 70 50 61 67 65 72 29 20 r_state(pPager)
96a0: 29 3b 0a 2a 2a 0a 2a 2a 20 54 68 69 73 20 66 75 );.**.** This fu
96b0: 6e 63 74 69 6f 6e 20 72 75 6e 73 20 6d 61 6e 79 nction runs many
96c0: 20 61 73 73 65 72 74 73 20 74 6f 20 74 72 79 20 asserts to try
96d0: 74 6f 20 66 69 6e 64 20 69 6e 63 6f 6e 73 69 73 to find inconsis
96e0: 74 65 6e 63 69 65 73 20 69 6e 0a 2a 2a 20 74 68 tencies in.** th
96f0: 65 20 69 6e 74 65 72 6e 61 6c 20 73 74 61 74 65 e internal state
9700: 20 6f 66 20 74 68 65 20 50 61 67 65 72 20 6f 62 of the Pager ob
9710: 6a 65 63 74 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 ject..*/.static
9720: 69 6e 74 20 61 73 73 65 72 74 5f 70 61 67 65 72 int assert_pager
9730: 5f 73 74 61 74 65 28 50 61 67 65 72 20 2a 70 29 _state(Pager *p)
9740: 7b 0a 20 20 50 61 67 65 72 20 2a 70 50 61 67 65 {. Pager *pPage
9750: 72 20 3d 20 70 3b 0a 0a 20 20 2f 2a 20 53 74 61 r = p;.. /* Sta
9760: 74 65 20 6d 75 73 74 20 62 65 20 76 61 6c 69 64 te must be valid
9770: 2e 20 2a 2f 0a 20 20 61 73 73 65 72 74 28 20 70 . */. assert( p
9780: 2d 3e 65 53 74 61 74 65 3d 3d 50 41 47 45 52 5f ->eState==PAGER_
9790: 4f 50 45 4e 0a 20 20 20 20 20 20 20 7c 7c 20 70 OPEN. || p
97a0: 2d 3e 65 53 74 61 74 65 3d 3d 50 41 47 45 52 5f ->eState==PAGER_
97b0: 52 45 41 44 45 52 0a 20 20 20 20 20 20 20 7c 7c READER. ||
97c0: 20 70 2d 3e 65 53 74 61 74 65 3d 3d 50 41 47 45 p->eState==PAGE
97d0: 52 5f 57 52 49 54 45 52 5f 4c 4f 43 4b 45 44 0a R_WRITER_LOCKED.
97e0: 20 20 20 20 20 20 20 7c 7c 20 70 2d 3e 65 53 74 || p->eSt
97f0: 61 74 65 3d 3d 50 41 47 45 52 5f 57 52 49 54 45 ate==PAGER_WRITE
9800: 52 5f 43 41 43 48 45 4d 4f 44 0a 20 20 20 20 20 R_CACHEMOD.
9810: 20 20 7c 7c 20 70 2d 3e 65 53 74 61 74 65 3d 3d || p->eState==
9820: 50 41 47 45 52 5f 57 52 49 54 45 52 5f 44 42 4d PAGER_WRITER_DBM
9830: 4f 44 0a 20 20 20 20 20 20 20 7c 7c 20 70 2d 3e OD. || p->
9840: 65 53 74 61 74 65 3d 3d 50 41 47 45 52 5f 57 52 eState==PAGER_WR
9850: 49 54 45 52 5f 46 49 4e 49 53 48 45 44 0a 20 20 ITER_FINISHED.
9860: 20 20 20 20 20 7c 7c 20 70 2d 3e 65 53 74 61 74 || p->eStat
9870: 65 3d 3d 50 41 47 45 52 5f 45 52 52 4f 52 0a 20 e==PAGER_ERROR.
9880: 20 29 3b 0a 0a 20 20 2f 2a 20 52 65 67 61 72 64 );.. /* Regard
9890: 6c 65 73 73 20 6f 66 20 74 68 65 20 63 75 72 72 less of the curr
98a0: 65 6e 74 20 73 74 61 74 65 2c 20 61 20 74 65 6d ent state, a tem
98b0: 70 2d 66 69 6c 65 20 63 6f 6e 6e 65 63 74 69 6f p-file connectio
98c0: 6e 20 61 6c 77 61 79 73 20 62 65 68 61 76 65 73 n always behaves
98d0: 0a 20 20 2a 2a 20 61 73 20 69 66 20 69 74 20 68 . ** as if it h
98e0: 61 73 20 61 6e 20 65 78 63 6c 75 73 69 76 65 20 as an exclusive
98f0: 6c 6f 63 6b 20 6f 6e 20 74 68 65 20 64 61 74 61 lock on the data
9900: 62 61 73 65 20 66 69 6c 65 2e 20 49 74 20 6e 65 base file. It ne
9910: 76 65 72 20 75 70 64 61 74 65 73 0a 20 20 2a 2a ver updates. **
9920: 20 74 68 65 20 63 68 61 6e 67 65 2d 63 6f 75 6e the change-coun
9930: 74 65 72 20 66 69 65 6c 64 2c 20 73 6f 20 74 68 ter field, so th
9940: 65 20 63 68 61 6e 67 65 43 6f 75 6e 74 44 6f 6e e changeCountDon
9950: 65 20 66 6c 61 67 20 69 73 20 61 6c 77 61 79 73 e flag is always
9960: 20 73 65 74 2e 0a 20 20 2a 2f 0a 20 20 61 73 73 set.. */. ass
9970: 65 72 74 28 20 70 2d 3e 74 65 6d 70 46 69 6c 65 ert( p->tempFile
9980: 3d 3d 30 20 7c 7c 20 70 2d 3e 65 4c 6f 63 6b 3d ==0 || p->eLock=
9990: 3d 45 58 43 4c 55 53 49 56 45 5f 4c 4f 43 4b 20 =EXCLUSIVE_LOCK
99a0: 29 3b 0a 20 20 61 73 73 65 72 74 28 20 70 2d 3e );. assert( p->
99b0: 74 65 6d 70 46 69 6c 65 3d 3d 30 20 7c 7c 20 70 tempFile==0 || p
99c0: 50 61 67 65 72 2d 3e 63 68 61 6e 67 65 43 6f 75 Pager->changeCou
99d0: 6e 74 44 6f 6e 65 20 29 3b 0a 0a 20 20 2f 2a 20 ntDone );.. /*
99e0: 49 66 20 74 68 65 20 75 73 65 4a 6f 75 72 6e 61 If the useJourna
99f0: 6c 20 66 6c 61 67 20 69 73 20 63 6c 65 61 72 2c l flag is clear,
9a00: 20 74 68 65 20 6a 6f 75 72 6e 61 6c 2d 6d 6f 64 the journal-mod
9a10: 65 20 6d 75 73 74 20 62 65 20 22 4f 46 46 22 2e e must be "OFF".
9a20: 20 0a 20 20 2a 2a 20 41 6e 64 20 69 66 20 74 68 . ** And if th
9a30: 65 20 6a 6f 75 72 6e 61 6c 2d 6d 6f 64 65 20 69 e journal-mode i
9a40: 73 20 22 4f 46 46 22 2c 20 74 68 65 20 6a 6f 75 s "OFF", the jou
9a50: 72 6e 61 6c 20 66 69 6c 65 20 6d 75 73 74 20 6e rnal file must n
9a60: 6f 74 20 62 65 20 6f 70 65 6e 2e 0a 20 20 2a 2f ot be open.. */
9a70: 0a 20 20 61 73 73 65 72 74 28 20 70 2d 3e 6a 6f . assert( p->jo
9a80: 75 72 6e 61 6c 4d 6f 64 65 3d 3d 50 41 47 45 52 urnalMode==PAGER
9a90: 5f 4a 4f 55 52 4e 41 4c 4d 4f 44 45 5f 4f 46 46 _JOURNALMODE_OFF
9aa0: 20 7c 7c 20 70 2d 3e 75 73 65 4a 6f 75 72 6e 61 || p->useJourna
9ab0: 6c 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 70 l );. assert( p
9ac0: 2d 3e 6a 6f 75 72 6e 61 6c 4d 6f 64 65 21 3d 50 ->journalMode!=P
9ad0: 41 47 45 52 5f 4a 4f 55 52 4e 41 4c 4d 4f 44 45 AGER_JOURNALMODE
9ae0: 5f 4f 46 46 20 7c 7c 20 21 69 73 4f 70 65 6e 28 _OFF || !isOpen(
9af0: 70 2d 3e 6a 66 64 29 20 29 3b 0a 0a 20 20 2f 2a p->jfd) );.. /*
9b00: 20 43 68 65 63 6b 20 74 68 61 74 20 4d 45 4d 44 Check that MEMD
9b10: 42 20 69 6d 70 6c 69 65 73 20 6e 6f 53 79 6e 63 B implies noSync
9b20: 2e 20 41 6e 64 20 61 6e 20 69 6e 2d 6d 65 6d 6f . And an in-memo
9b30: 72 79 20 6a 6f 75 72 6e 61 6c 2e 20 53 69 6e 63 ry journal. Sinc
9b40: 65 20 0a 20 20 2a 2a 20 74 68 69 73 20 6d 65 61 e . ** this mea
9b50: 6e 73 20 61 6e 20 69 6e 2d 6d 65 6d 6f 72 79 20 ns an in-memory
9b60: 70 61 67 65 72 20 70 65 72 66 6f 72 6d 73 20 6e pager performs n
9b70: 6f 20 49 4f 20 61 74 20 61 6c 6c 2c 20 69 74 20 o IO at all, it
9b80: 63 61 6e 6e 6f 74 20 65 6e 63 6f 75 6e 74 65 72 cannot encounter
9b90: 20 0a 20 20 2a 2a 20 65 69 74 68 65 72 20 53 51 . ** either SQ
9ba0: 4c 49 54 45 5f 49 4f 45 52 52 20 6f 72 20 53 51 LITE_IOERR or SQ
9bb0: 4c 49 54 45 5f 46 55 4c 4c 20 64 75 72 69 6e 67 LITE_FULL during
9bc0: 20 72 6f 6c 6c 62 61 63 6b 20 6f 72 20 77 68 69 rollback or whi
9bd0: 6c 65 20 66 69 6e 61 6c 69 7a 69 6e 67 20 0a 20 le finalizing .
9be0: 20 2a 2a 20 61 20 6a 6f 75 72 6e 61 6c 20 66 69 ** a journal fi
9bf0: 6c 65 2e 20 28 61 6c 74 68 6f 75 67 68 20 74 68 le. (although th
9c00: 65 20 69 6e 2d 6d 65 6d 6f 72 79 20 6a 6f 75 72 e in-memory jour
9c10: 6e 61 6c 20 69 6d 70 6c 65 6d 65 6e 74 61 74 69 nal implementati
9c20: 6f 6e 20 6d 61 79 20 0a 20 20 2a 2a 20 72 65 74 on may . ** ret
9c30: 75 72 6e 20 53 51 4c 49 54 45 5f 49 4f 45 52 52 urn SQLITE_IOERR
9c40: 5f 4e 4f 4d 45 4d 20 77 68 69 6c 65 20 74 68 65 _NOMEM while the
9c50: 20 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 20 69 73 journal file is
9c60: 20 62 65 69 6e 67 20 77 72 69 74 74 65 6e 29 2e being written).
9c70: 20 49 74 20 0a 20 20 2a 2a 20 69 73 20 74 68 65 It . ** is the
9c80: 72 65 66 6f 72 65 20 6e 6f 74 20 70 6f 73 73 69 refore not possi
9c90: 62 6c 65 20 66 6f 72 20 61 6e 20 69 6e 2d 6d 65 ble for an in-me
9ca0: 6d 6f 72 79 20 70 61 67 65 72 20 74 6f 20 65 6e mory pager to en
9cb0: 74 65 72 20 74 68 65 20 45 52 52 4f 52 20 0a 20 ter the ERROR .
9cc0: 20 2a 2a 20 73 74 61 74 65 2e 0a 20 20 2a 2f 0a ** state.. */.
9cd0: 20 20 69 66 28 20 4d 45 4d 44 42 20 29 7b 0a 20 if( MEMDB ){.
9ce0: 20 20 20 61 73 73 65 72 74 28 20 70 2d 3e 6e 6f assert( p->no
9cf0: 53 79 6e 63 20 29 3b 0a 20 20 20 20 61 73 73 65 Sync );. asse
9d00: 72 74 28 20 70 2d 3e 6a 6f 75 72 6e 61 6c 4d 6f rt( p->journalMo
9d10: 64 65 3d 3d 50 41 47 45 52 5f 4a 4f 55 52 4e 41 de==PAGER_JOURNA
9d20: 4c 4d 4f 44 45 5f 4f 46 46 20 0a 20 20 20 20 20 LMODE_OFF .
9d30: 20 20 20 20 7c 7c 20 70 2d 3e 6a 6f 75 72 6e 61 || p->journa
9d40: 6c 4d 6f 64 65 3d 3d 50 41 47 45 52 5f 4a 4f 55 lMode==PAGER_JOU
9d50: 52 4e 41 4c 4d 4f 44 45 5f 4d 45 4d 4f 52 59 20 RNALMODE_MEMORY
9d60: 0a 20 20 20 20 29 3b 0a 20 20 20 20 61 73 73 65 . );. asse
9d70: 72 74 28 20 70 2d 3e 65 53 74 61 74 65 21 3d 50 rt( p->eState!=P
9d80: 41 47 45 52 5f 45 52 52 4f 52 20 26 26 20 70 2d AGER_ERROR && p-
9d90: 3e 65 53 74 61 74 65 21 3d 50 41 47 45 52 5f 4f >eState!=PAGER_O
9da0: 50 45 4e 20 29 3b 0a 20 20 20 20 61 73 73 65 72 PEN );. asser
9db0: 74 28 20 70 61 67 65 72 55 73 65 57 61 6c 28 70 t( pagerUseWal(p
9dc0: 29 3d 3d 30 20 29 3b 0a 20 20 7d 0a 0a 20 20 2f )==0 );. }.. /
9dd0: 2a 20 49 66 20 63 68 61 6e 67 65 43 6f 75 6e 74 * If changeCount
9de0: 44 6f 6e 65 20 69 73 20 73 65 74 2c 20 61 20 52 Done is set, a R
9df0: 45 53 45 52 56 45 44 20 6c 6f 63 6b 20 6f 72 20 ESERVED lock or
9e00: 67 72 65 61 74 65 72 20 6d 75 73 74 20 62 65 20 greater must be
9e10: 68 65 6c 64 0a 20 20 2a 2a 20 6f 6e 20 74 68 65 held. ** on the
9e20: 20 66 69 6c 65 2e 0a 20 20 2a 2f 0a 20 20 61 73 file.. */. as
9e30: 73 65 72 74 28 20 70 50 61 67 65 72 2d 3e 63 68 sert( pPager->ch
9e40: 61 6e 67 65 43 6f 75 6e 74 44 6f 6e 65 3d 3d 30 angeCountDone==0
9e50: 20 7c 7c 20 70 50 61 67 65 72 2d 3e 65 4c 6f 63 || pPager->eLoc
9e60: 6b 3e 3d 52 45 53 45 52 56 45 44 5f 4c 4f 43 4b k>=RESERVED_LOCK
9e70: 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 70 2d );. assert( p-
9e80: 3e 65 4c 6f 63 6b 21 3d 50 45 4e 44 49 4e 47 5f >eLock!=PENDING_
9e90: 4c 4f 43 4b 20 29 3b 0a 0a 20 20 73 77 69 74 63 LOCK );.. switc
9ea0: 68 28 20 70 2d 3e 65 53 74 61 74 65 20 29 7b 0a h( p->eState ){.
9eb0: 20 20 20 20 63 61 73 65 20 50 41 47 45 52 5f 4f case PAGER_O
9ec0: 50 45 4e 3a 0a 20 20 20 20 20 20 61 73 73 65 72 PEN:. asser
9ed0: 74 28 20 21 4d 45 4d 44 42 20 29 3b 0a 20 20 20 t( !MEMDB );.
9ee0: 20 20 20 61 73 73 65 72 74 28 20 70 50 61 67 65 assert( pPage
9ef0: 72 2d 3e 65 72 72 43 6f 64 65 3d 3d 53 51 4c 49 r->errCode==SQLI
9f00: 54 45 5f 4f 4b 20 29 3b 0a 20 20 20 20 20 20 61 TE_OK );. a
9f10: 73 73 65 72 74 28 20 73 71 6c 69 74 65 33 50 63 ssert( sqlite3Pc
9f20: 61 63 68 65 52 65 66 43 6f 75 6e 74 28 70 50 61 acheRefCount(pPa
9f30: 67 65 72 2d 3e 70 50 43 61 63 68 65 29 3d 3d 30 ger->pPCache)==0
9f40: 20 7c 7c 20 70 50 61 67 65 72 2d 3e 74 65 6d 70 || pPager->temp
9f50: 46 69 6c 65 20 29 3b 0a 20 20 20 20 20 20 62 72 File );. br
9f60: 65 61 6b 3b 0a 0a 20 20 20 20 63 61 73 65 20 50 eak;.. case P
9f70: 41 47 45 52 5f 52 45 41 44 45 52 3a 0a 20 20 20 AGER_READER:.
9f80: 20 20 20 61 73 73 65 72 74 28 20 70 50 61 67 65 assert( pPage
9f90: 72 2d 3e 65 72 72 43 6f 64 65 3d 3d 53 51 4c 49 r->errCode==SQLI
9fa0: 54 45 5f 4f 4b 20 29 3b 0a 20 20 20 20 20 20 61 TE_OK );. a
9fb0: 73 73 65 72 74 28 20 70 2d 3e 65 4c 6f 63 6b 21 ssert( p->eLock!
9fc0: 3d 55 4e 4b 4e 4f 57 4e 5f 4c 4f 43 4b 20 29 3b =UNKNOWN_LOCK );
9fd0: 0a 20 20 20 20 20 20 61 73 73 65 72 74 28 20 70 . assert( p
9fe0: 2d 3e 65 4c 6f 63 6b 3e 3d 53 48 41 52 45 44 5f ->eLock>=SHARED_
9ff0: 4c 4f 43 4b 20 29 3b 0a 20 20 20 20 20 20 62 72 LOCK );. br
a000: 65 61 6b 3b 0a 0a 20 20 20 20 63 61 73 65 20 50 eak;.. case P
a010: 41 47 45 52 5f 57 52 49 54 45 52 5f 4c 4f 43 4b AGER_WRITER_LOCK
a020: 45 44 3a 0a 20 20 20 20 20 20 61 73 73 65 72 74 ED:. assert
a030: 28 20 70 2d 3e 65 4c 6f 63 6b 21 3d 55 4e 4b 4e ( p->eLock!=UNKN
a040: 4f 57 4e 5f 4c 4f 43 4b 20 29 3b 0a 20 20 20 20 OWN_LOCK );.
a050: 20 20 61 73 73 65 72 74 28 20 70 50 61 67 65 72 assert( pPager
a060: 2d 3e 65 72 72 43 6f 64 65 3d 3d 53 51 4c 49 54 ->errCode==SQLIT
a070: 45 5f 4f 4b 20 29 3b 0a 20 20 20 20 20 20 69 66 E_OK );. if
a080: 28 20 21 70 61 67 65 72 55 73 65 57 61 6c 28 70 ( !pagerUseWal(p
a090: 50 61 67 65 72 29 20 29 7b 0a 20 20 20 20 20 20 Pager) ){.
a0a0: 20 20 61 73 73 65 72 74 28 20 70 2d 3e 65 4c 6f assert( p->eLo
a0b0: 63 6b 3e 3d 52 45 53 45 52 56 45 44 5f 4c 4f 43 ck>=RESERVED_LOC
a0c0: 4b 20 29 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20 K );. }.
a0d0: 20 20 20 61 73 73 65 72 74 28 20 70 50 61 67 65 assert( pPage
a0e0: 72 2d 3e 64 62 53 69 7a 65 3d 3d 70 50 61 67 65 r->dbSize==pPage
a0f0: 72 2d 3e 64 62 4f 72 69 67 53 69 7a 65 20 29 3b r->dbOrigSize );
a100: 0a 20 20 20 20 20 20 61 73 73 65 72 74 28 20 70 . assert( p
a110: 50 61 67 65 72 2d 3e 64 62 4f 72 69 67 53 69 7a Pager->dbOrigSiz
a120: 65 3d 3d 70 50 61 67 65 72 2d 3e 64 62 46 69 6c e==pPager->dbFil
a130: 65 53 69 7a 65 20 29 3b 0a 20 20 20 20 20 20 61 eSize );. a
a140: 73 73 65 72 74 28 20 70 50 61 67 65 72 2d 3e 64 ssert( pPager->d
a150: 62 4f 72 69 67 53 69 7a 65 3d 3d 70 50 61 67 65 bOrigSize==pPage
a160: 72 2d 3e 64 62 48 69 6e 74 53 69 7a 65 20 29 3b r->dbHintSize );
a170: 0a 20 20 20 20 20 20 61 73 73 65 72 74 28 20 70 . assert( p
a180: 50 61 67 65 72 2d 3e 73 65 74 4d 61 73 74 65 72 Pager->setMaster
a190: 3d 3d 30 20 29 3b 0a 20 20 20 20 20 20 62 72 65 ==0 );. bre
a1a0: 61 6b 3b 0a 0a 20 20 20 20 63 61 73 65 20 50 41 ak;.. case PA
a1b0: 47 45 52 5f 57 52 49 54 45 52 5f 43 41 43 48 45 GER_WRITER_CACHE
a1c0: 4d 4f 44 3a 0a 20 20 20 20 20 20 61 73 73 65 72 MOD:. asser
a1d0: 74 28 20 70 2d 3e 65 4c 6f 63 6b 21 3d 55 4e 4b t( p->eLock!=UNK
a1e0: 4e 4f 57 4e 5f 4c 4f 43 4b 20 29 3b 0a 20 20 20 NOWN_LOCK );.
a1f0: 20 20 20 61 73 73 65 72 74 28 20 70 50 61 67 65 assert( pPage
a200: 72 2d 3e 65 72 72 43 6f 64 65 3d 3d 53 51 4c 49 r->errCode==SQLI
a210: 54 45 5f 4f 4b 20 29 3b 0a 20 20 20 20 20 20 69 TE_OK );. i
a220: 66 28 20 21 70 61 67 65 72 55 73 65 57 61 6c 28 f( !pagerUseWal(
a230: 70 50 61 67 65 72 29 20 29 7b 0a 20 20 20 20 20 pPager) ){.
a240: 20 20 20 2f 2a 20 49 74 20 69 73 20 70 6f 73 73 /* It is poss
a250: 69 62 6c 65 20 74 68 61 74 20 69 66 20 6a 6f 75 ible that if jou
a260: 72 6e 61 6c 5f 6d 6f 64 65 3d 77 61 6c 20 68 65 rnal_mode=wal he
a270: 72 65 20 74 68 61 74 20 6e 65 69 74 68 65 72 20 re that neither
a280: 74 68 65 0a 20 20 20 20 20 20 20 20 2a 2a 20 6a the. ** j
a290: 6f 75 72 6e 61 6c 20 66 69 6c 65 20 6e 6f 72 20 ournal file nor
a2a0: 74 68 65 20 57 41 4c 20 66 69 6c 65 20 61 72 65 the WAL file are
a2b0: 20 6f 70 65 6e 2e 20 54 68 69 73 20 68 61 70 70 open. This happ
a2c0: 65 6e 73 20 64 75 72 69 6e 67 0a 20 20 20 20 20 ens during.
a2d0: 20 20 20 2a 2a 20 61 20 72 6f 6c 6c 62 61 63 6b ** a rollback
a2e0: 20 74 72 61 6e 73 61 63 74 69 6f 6e 20 74 68 61 transaction tha
a2f0: 74 20 73 77 69 74 63 68 65 73 20 66 72 6f 6d 20 t switches from
a300: 6a 6f 75 72 6e 61 6c 5f 6d 6f 64 65 3d 6f 66 66 journal_mode=off
a310: 0a 20 20 20 20 20 20 20 20 2a 2a 20 74 6f 20 6a . ** to j
a320: 6f 75 72 6e 61 6c 5f 6d 6f 64 65 3d 77 61 6c 2e ournal_mode=wal.
a330: 0a 20 20 20 20 20 20 20 20 2a 2f 0a 20 20 20 20 . */.
a340: 20 20 20 20 61 73 73 65 72 74 28 20 70 2d 3e 65 assert( p->e
a350: 4c 6f 63 6b 3e 3d 52 45 53 45 52 56 45 44 5f 4c Lock>=RESERVED_L
a360: 4f 43 4b 20 29 3b 0a 20 20 20 20 20 20 20 20 61 OCK );. a
a370: 73 73 65 72 74 28 20 69 73 4f 70 65 6e 28 70 2d ssert( isOpen(p-
a380: 3e 6a 66 64 29 20 0a 20 20 20 20 20 20 20 20 20 >jfd) .
a390: 20 20 20 20 7c 7c 20 70 2d 3e 6a 6f 75 72 6e 61 || p->journa
a3a0: 6c 4d 6f 64 65 3d 3d 50 41 47 45 52 5f 4a 4f 55 lMode==PAGER_JOU
a3b0: 52 4e 41 4c 4d 4f 44 45 5f 4f 46 46 20 0a 20 20 RNALMODE_OFF .
a3c0: 20 20 20 20 20 20 20 20 20 20 20 7c 7c 20 70 2d || p-
a3d0: 3e 6a 6f 75 72 6e 61 6c 4d 6f 64 65 3d 3d 50 41 >journalMode==PA
a3e0: 47 45 52 5f 4a 4f 55 52 4e 41 4c 4d 4f 44 45 5f GER_JOURNALMODE_
a3f0: 57 41 4c 20 0a 20 20 20 20 20 20 20 20 29 3b 0a WAL . );.
a400: 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 61 73 }. as
a410: 73 65 72 74 28 20 70 50 61 67 65 72 2d 3e 64 62 sert( pPager->db
a420: 4f 72 69 67 53 69 7a 65 3d 3d 70 50 61 67 65 72 OrigSize==pPager
a430: 2d 3e 64 62 46 69 6c 65 53 69 7a 65 20 29 3b 0a ->dbFileSize );.
a440: 20 20 20 20 20 20 61 73 73 65 72 74 28 20 70 50 assert( pP
a450: 61 67 65 72 2d 3e 64 62 4f 72 69 67 53 69 7a 65 ager->dbOrigSize
a460: 3d 3d 70 50 61 67 65 72 2d 3e 64 62 48 69 6e 74 ==pPager->dbHint
a470: 53 69 7a 65 20 29 3b 0a 20 20 20 20 20 20 62 72 Size );. br
a480: 65 61 6b 3b 0a 0a 20 20 20 20 63 61 73 65 20 50 eak;.. case P
a490: 41 47 45 52 5f 57 52 49 54 45 52 5f 44 42 4d 4f AGER_WRITER_DBMO
a4a0: 44 3a 0a 20 20 20 20 20 20 61 73 73 65 72 74 28 D:. assert(
a4b0: 20 70 2d 3e 65 4c 6f 63 6b 3d 3d 45 58 43 4c 55 p->eLock==EXCLU
a4c0: 53 49 56 45 5f 4c 4f 43 4b 20 29 3b 0a 20 20 20 SIVE_LOCK );.
a4d0: 20 20 20 61 73 73 65 72 74 28 20 70 50 61 67 65 assert( pPage
a4e0: 72 2d 3e 65 72 72 43 6f 64 65 3d 3d 53 51 4c 49 r->errCode==SQLI
a4f0: 54 45 5f 4f 4b 20 29 3b 0a 20 20 20 20 20 20 61 TE_OK );. a
a500: 73 73 65 72 74 28 20 21 70 61 67 65 72 55 73 65 ssert( !pagerUse
a510: 57 61 6c 28 70 50 61 67 65 72 29 20 29 3b 0a 20 Wal(pPager) );.
a520: 20 20 20 20 20 61 73 73 65 72 74 28 20 70 2d 3e assert( p->
a530: 65 4c 6f 63 6b 3e 3d 45 58 43 4c 55 53 49 56 45 eLock>=EXCLUSIVE
a540: 5f 4c 4f 43 4b 20 29 3b 0a 20 20 20 20 20 20 61 _LOCK );. a
a550: 73 73 65 72 74 28 20 69 73 4f 70 65 6e 28 70 2d ssert( isOpen(p-
a560: 3e 6a 66 64 29 20 0a 20 20 20 20 20 20 20 20 20 >jfd) .
a570: 20 20 7c 7c 20 70 2d 3e 6a 6f 75 72 6e 61 6c 4d || p->journalM
a580: 6f 64 65 3d 3d 50 41 47 45 52 5f 4a 4f 55 52 4e ode==PAGER_JOURN
a590: 41 4c 4d 4f 44 45 5f 4f 46 46 20 0a 20 20 20 20 ALMODE_OFF .
a5a0: 20 20 20 20 20 20 20 7c 7c 20 70 2d 3e 6a 6f 75 || p->jou
a5b0: 72 6e 61 6c 4d 6f 64 65 3d 3d 50 41 47 45 52 5f rnalMode==PAGER_
a5c0: 4a 4f 55 52 4e 41 4c 4d 4f 44 45 5f 57 41 4c 20 JOURNALMODE_WAL
a5d0: 0a 20 20 20 20 20 20 29 3b 0a 20 20 20 20 20 20 . );.
a5e0: 61 73 73 65 72 74 28 20 70 50 61 67 65 72 2d 3e assert( pPager->
a5f0: 64 62 4f 72 69 67 53 69 7a 65 3c 3d 70 50 61 67 dbOrigSize<=pPag
a600: 65 72 2d 3e 64 62 48 69 6e 74 53 69 7a 65 20 29 er->dbHintSize )
a610: 3b 0a 20 20 20 20 20 20 62 72 65 61 6b 3b 0a 0a ;. break;..
a620: 20 20 20 20 63 61 73 65 20 50 41 47 45 52 5f 57 case PAGER_W
a630: 52 49 54 45 52 5f 46 49 4e 49 53 48 45 44 3a 0a RITER_FINISHED:.
a640: 20 20 20 20 20 20 61 73 73 65 72 74 28 20 70 2d assert( p-
a650: 3e 65 4c 6f 63 6b 3d 3d 45 58 43 4c 55 53 49 56 >eLock==EXCLUSIV
a660: 45 5f 4c 4f 43 4b 20 29 3b 0a 20 20 20 20 20 20 E_LOCK );.
a670: 61 73 73 65 72 74 28 20 70 50 61 67 65 72 2d 3e assert( pPager->
a680: 65 72 72 43 6f 64 65 3d 3d 53 51 4c 49 54 45 5f errCode==SQLITE_
a690: 4f 4b 20 29 3b 0a 20 20 20 20 20 20 61 73 73 65 OK );. asse
a6a0: 72 74 28 20 21 70 61 67 65 72 55 73 65 57 61 6c rt( !pagerUseWal
a6b0: 28 70 50 61 67 65 72 29 20 29 3b 0a 20 20 20 20 (pPager) );.
a6c0: 20 20 61 73 73 65 72 74 28 20 69 73 4f 70 65 6e assert( isOpen
a6d0: 28 70 2d 3e 6a 66 64 29 20 0a 20 20 20 20 20 20 (p->jfd) .
a6e0: 20 20 20 20 20 7c 7c 20 70 2d 3e 6a 6f 75 72 6e || p->journ
a6f0: 61 6c 4d 6f 64 65 3d 3d 50 41 47 45 52 5f 4a 4f alMode==PAGER_JO
a700: 55 52 4e 41 4c 4d 4f 44 45 5f 4f 46 46 20 0a 20 URNALMODE_OFF .
a710: 20 20 20 20 20 20 20 20 20 20 7c 7c 20 70 2d 3e || p->
a720: 6a 6f 75 72 6e 61 6c 4d 6f 64 65 3d 3d 50 41 47 journalMode==PAG
a730: 45 52 5f 4a 4f 55 52 4e 41 4c 4d 4f 44 45 5f 57 ER_JOURNALMODE_W
a740: 41 4c 20 0a 20 20 20 20 20 20 29 3b 0a 20 20 20 AL . );.
a750: 20 20 20 62 72 65 61 6b 3b 0a 0a 20 20 20 20 63 break;.. c
a760: 61 73 65 20 50 41 47 45 52 5f 45 52 52 4f 52 3a ase PAGER_ERROR:
a770: 0a 20 20 20 20 20 20 2f 2a 20 54 68 65 72 65 20 . /* There
a780: 6d 75 73 74 20 62 65 20 61 74 20 6c 65 61 73 74 must be at least
a790: 20 6f 6e 65 20 6f 75 74 73 74 61 6e 64 69 6e 67 one outstanding
a7a0: 20 72 65 66 65 72 65 6e 63 65 20 74 6f 20 74 68 reference to th
a7b0: 65 20 70 61 67 65 72 20 69 66 0a 20 20 20 20 20 e pager if.
a7c0: 20 2a 2a 20 69 6e 20 45 52 52 4f 52 20 73 74 61 ** in ERROR sta
a7d0: 74 65 2e 20 4f 74 68 65 72 77 69 73 65 20 74 68 te. Otherwise th
a7e0: 65 20 70 61 67 65 72 20 73 68 6f 75 6c 64 20 68 e pager should h
a7f0: 61 76 65 20 61 6c 72 65 61 64 79 20 64 72 6f 70 ave already drop
a800: 70 65 64 0a 20 20 20 20 20 20 2a 2a 20 62 61 63 ped. ** bac
a810: 6b 20 74 6f 20 4f 50 45 4e 20 73 74 61 74 65 2e k to OPEN state.
a820: 0a 20 20 20 20 20 20 2a 2f 0a 20 20 20 20 20 20 . */.
a830: 61 73 73 65 72 74 28 20 70 50 61 67 65 72 2d 3e assert( pPager->
a840: 65 72 72 43 6f 64 65 21 3d 53 51 4c 49 54 45 5f errCode!=SQLITE_
a850: 4f 4b 20 29 3b 0a 20 20 20 20 20 20 61 73 73 65 OK );. asse
a860: 72 74 28 20 73 71 6c 69 74 65 33 50 63 61 63 68 rt( sqlite3Pcach
a870: 65 52 65 66 43 6f 75 6e 74 28 70 50 61 67 65 72 eRefCount(pPager
a880: 2d 3e 70 50 43 61 63 68 65 29 3e 30 20 7c 7c 20 ->pPCache)>0 ||
a890: 70 50 61 67 65 72 2d 3e 74 65 6d 70 46 69 6c 65 pPager->tempFile
a8a0: 20 29 3b 0a 20 20 20 20 20 20 62 72 65 61 6b 3b );. break;
a8b0: 0a 20 20 7d 0a 0a 20 20 72 65 74 75 72 6e 20 31 . }.. return 1
a8c0: 3b 0a 7d 0a 23 65 6e 64 69 66 20 2f 2a 20 69 66 ;.}.#endif /* if
a8d0: 6e 64 65 66 20 4e 44 45 42 55 47 20 2a 2f 0a 0a ndef NDEBUG */..
a8e0: 23 69 66 64 65 66 20 53 51 4c 49 54 45 5f 44 45 #ifdef SQLITE_DE
a8f0: 42 55 47 20 0a 2f 2a 0a 2a 2a 20 52 65 74 75 72 BUG ./*.** Retur
a900: 6e 20 61 20 70 6f 69 6e 74 65 72 20 74 6f 20 61 n a pointer to a
a910: 20 68 75 6d 61 6e 20 72 65 61 64 61 62 6c 65 20 human readable
a920: 73 74 72 69 6e 67 20 69 6e 20 61 20 73 74 61 74 string in a stat
a930: 69 63 20 62 75 66 66 65 72 0a 2a 2a 20 63 6f 6e ic buffer.** con
a940: 74 61 69 6e 69 6e 67 20 74 68 65 20 73 74 61 74 taining the stat
a950: 65 20 6f 66 20 74 68 65 20 50 61 67 65 72 20 6f e of the Pager o
a960: 62 6a 65 63 74 20 70 61 73 73 65 64 20 61 73 20 bject passed as
a970: 61 6e 20 61 72 67 75 6d 65 6e 74 2e 20 54 68 69 an argument. Thi
a980: 73 0a 2a 2a 20 69 73 20 69 6e 74 65 6e 64 65 64 s.** is intended
a990: 20 74 6f 20 62 65 20 75 73 65 64 20 77 69 74 68 to be used with
a9a0: 69 6e 20 64 65 62 75 67 67 65 72 73 2e 20 46 6f in debuggers. Fo
a9b0: 72 20 65 78 61 6d 70 6c 65 2c 20 61 73 20 61 6e r example, as an
a9c0: 20 61 6c 74 65 72 6e 61 74 69 76 65 0a 2a 2a 20 alternative.**
a9d0: 74 6f 20 22 70 72 69 6e 74 20 2a 70 50 61 67 65 to "print *pPage
a9e0: 72 22 20 69 6e 20 67 64 62 3a 0a 2a 2a 0a 2a 2a r" in gdb:.**.**
a9f0: 20 28 67 64 62 29 20 70 72 69 6e 74 66 20 22 25 (gdb) printf "%
aa00: 73 22 2c 20 70 72 69 6e 74 5f 70 61 67 65 72 5f s", print_pager_
aa10: 73 74 61 74 65 28 70 50 61 67 65 72 29 0a 2a 2f state(pPager).*/
aa20: 0a 73 74 61 74 69 63 20 63 68 61 72 20 2a 70 72 .static char *pr
aa30: 69 6e 74 5f 70 61 67 65 72 5f 73 74 61 74 65 28 int_pager_state(
aa40: 50 61 67 65 72 20 2a 70 29 7b 0a 20 20 73 74 61 Pager *p){. sta
aa50: 74 69 63 20 63 68 61 72 20 7a 52 65 74 5b 31 30 tic char zRet[10
aa60: 32 34 5d 3b 0a 0a 20 20 73 71 6c 69 74 65 33 5f 24];.. sqlite3_
aa70: 73 6e 70 72 69 6e 74 66 28 31 30 32 34 2c 20 7a snprintf(1024, z
aa80: 52 65 74 2c 0a 20 20 20 20 20 20 22 46 69 6c 65 Ret,. "File
aa90: 6e 61 6d 65 3a 20 20 20 20 20 20 25 73 5c 6e 22 name: %s\n"
aaa0: 0a 20 20 20 20 20 20 22 53 74 61 74 65 3a 20 20 . "State:
aab0: 20 20 20 20 20 20 20 25 73 20 65 72 72 43 6f 64 %s errCod
aac0: 65 3d 25 64 5c 6e 22 0a 20 20 20 20 20 20 22 4c e=%d\n". "L
aad0: 6f 63 6b 3a 20 20 20 20 20 20 20 20 20 20 25 73 ock: %s
aae0: 5c 6e 22 0a 20 20 20 20 20 20 22 4c 6f 63 6b 69 \n". "Locki
aaf0: 6e 67 20 6d 6f 64 65 3a 20 20 6c 6f 63 6b 69 6e ng mode: lockin
ab00: 67 5f 6d 6f 64 65 3d 25 73 5c 6e 22 0a 20 20 20 g_mode=%s\n".
ab10: 20 20 20 22 4a 6f 75 72 6e 61 6c 20 6d 6f 64 65 "Journal mode
ab20: 3a 20 20 6a 6f 75 72 6e 61 6c 5f 6d 6f 64 65 3d : journal_mode=
ab30: 25 73 5c 6e 22 0a 20 20 20 20 20 20 22 42 61 63 %s\n". "Bac
ab40: 6b 69 6e 67 20 73 74 6f 72 65 3a 20 74 65 6d 70 king store: temp
ab50: 46 69 6c 65 3d 25 64 20 6d 65 6d 44 62 3d 25 64 File=%d memDb=%d
ab60: 20 75 73 65 4a 6f 75 72 6e 61 6c 3d 25 64 5c 6e useJournal=%d\n
ab70: 22 0a 20 20 20 20 20 20 22 4a 6f 75 72 6e 61 6c ". "Journal
ab80: 3a 20 20 20 20 20 20 20 6a 6f 75 72 6e 61 6c 4f : journalO
ab90: 66 66 3d 25 6c 6c 64 20 6a 6f 75 72 6e 61 6c 48 ff=%lld journalH
aba0: 64 72 3d 25 6c 6c 64 5c 6e 22 0a 20 20 20 20 20 dr=%lld\n".
abb0: 20 22 53 69 7a 65 3a 20 20 20 20 20 20 20 20 20 "Size:
abc0: 20 64 62 73 69 7a 65 3d 25 64 20 64 62 4f 72 69 dbsize=%d dbOri
abd0: 67 53 69 7a 65 3d 25 64 20 64 62 46 69 6c 65 53 gSize=%d dbFileS
abe0: 69 7a 65 3d 25 64 5c 6e 22 0a 20 20 20 20 20 20 ize=%d\n".
abf0: 2c 20 70 2d 3e 7a 46 69 6c 65 6e 61 6d 65 0a 20 , p->zFilename.
ac00: 20 20 20 20 20 2c 20 70 2d 3e 65 53 74 61 74 65 , p->eState
ac10: 3d 3d 50 41 47 45 52 5f 4f 50 45 4e 20 20 20 20 ==PAGER_OPEN
ac20: 20 20 20 20 20 20 20 20 3f 20 22 4f 50 45 4e 22 ? "OPEN"
ac30: 20 3a 0a 20 20 20 20 20 20 20 20 70 2d 3e 65 53 :. p->eS
ac40: 74 61 74 65 3d 3d 50 41 47 45 52 5f 52 45 41 44 tate==PAGER_READ
ac50: 45 52 20 20 20 20 20 20 20 20 20 20 3f 20 22 52 ER ? "R
ac60: 45 41 44 45 52 22 20 3a 0a 20 20 20 20 20 20 20 EADER" :.
ac70: 20 70 2d 3e 65 53 74 61 74 65 3d 3d 50 41 47 45 p->eState==PAGE
ac80: 52 5f 57 52 49 54 45 52 5f 4c 4f 43 4b 45 44 20 R_WRITER_LOCKED
ac90: 20 20 3f 20 22 57 52 49 54 45 52 5f 4c 4f 43 4b ? "WRITER_LOCK
aca0: 45 44 22 20 3a 0a 20 20 20 20 20 20 20 20 70 2d ED" :. p-
acb0: 3e 65 53 74 61 74 65 3d 3d 50 41 47 45 52 5f 57 >eState==PAGER_W
acc0: 52 49 54 45 52 5f 43 41 43 48 45 4d 4f 44 20 3f RITER_CACHEMOD ?
acd0: 20 22 57 52 49 54 45 52 5f 43 41 43 48 45 4d 4f "WRITER_CACHEMO
ace0: 44 22 20 3a 0a 20 20 20 20 20 20 20 20 70 2d 3e D" :. p->
acf0: 65 53 74 61 74 65 3d 3d 50 41 47 45 52 5f 57 52 eState==PAGER_WR
ad00: 49 54 45 52 5f 44 42 4d 4f 44 20 20 20 20 3f 20 ITER_DBMOD ?
ad10: 22 57 52 49 54 45 52 5f 44 42 4d 4f 44 22 20 3a "WRITER_DBMOD" :
ad20: 0a 20 20 20 20 20 20 20 20 70 2d 3e 65 53 74 61 . p->eSta
ad30: 74 65 3d 3d 50 41 47 45 52 5f 57 52 49 54 45 52 te==PAGER_WRITER
ad40: 5f 46 49 4e 49 53 48 45 44 20 3f 20 22 57 52 49 _FINISHED ? "WRI
ad50: 54 45 52 5f 46 49 4e 49 53 48 45 44 22 20 3a 0a TER_FINISHED" :.
ad60: 20 20 20 20 20 20 20 20 70 2d 3e 65 53 74 61 74 p->eStat
ad70: 65 3d 3d 50 41 47 45 52 5f 45 52 52 4f 52 20 20 e==PAGER_ERROR
ad80: 20 20 20 20 20 20 20 20 20 3f 20 22 45 52 52 4f ? "ERRO
ad90: 52 22 20 3a 20 22 3f 65 72 72 6f 72 3f 22 0a 20 R" : "?error?".
ada0: 20 20 20 20 20 2c 20 28 69 6e 74 29 70 2d 3e 65 , (int)p->e
adb0: 72 72 43 6f 64 65 0a 20 20 20 20 20 20 2c 20 70 rrCode. , p
adc0: 2d 3e 65 4c 6f 63 6b 3d 3d 4e 4f 5f 4c 4f 43 4b ->eLock==NO_LOCK
add0: 20 20 20 20 20 20 20 20 20 3f 20 22 4e 4f 5f 4c ? "NO_L
ade0: 4f 43 4b 22 20 3a 0a 20 20 20 20 20 20 20 20 70 OCK" :. p
adf0: 2d 3e 65 4c 6f 63 6b 3d 3d 52 45 53 45 52 56 45 ->eLock==RESERVE
ae00: 44 5f 4c 4f 43 4b 20 20 20 3f 20 22 52 45 53 45 D_LOCK ? "RESE
ae10: 52 56 45 44 22 20 3a 0a 20 20 20 20 20 20 20 20 RVED" :.
ae20: 70 2d 3e 65 4c 6f 63 6b 3d 3d 45 58 43 4c 55 53 p->eLock==EXCLUS
ae30: 49 56 45 5f 4c 4f 43 4b 20 20 3f 20 22 45 58 43 IVE_LOCK ? "EXC
ae40: 4c 55 53 49 56 45 22 20 3a 0a 20 20 20 20 20 20 LUSIVE" :.
ae50: 20 20 70 2d 3e 65 4c 6f 63 6b 3d 3d 53 48 41 52 p->eLock==SHAR
ae60: 45 44 5f 4c 4f 43 4b 20 20 20 20 20 3f 20 22 53 ED_LOCK ? "S
ae70: 48 41 52 45 44 22 20 3a 0a 20 20 20 20 20 20 20 HARED" :.
ae80: 20 70 2d 3e 65 4c 6f 63 6b 3d 3d 55 4e 4b 4e 4f p->eLock==UNKNO
ae90: 57 4e 5f 4c 4f 43 4b 20 20 20 20 3f 20 22 55 4e WN_LOCK ? "UN
aea0: 4b 4e 4f 57 4e 22 20 3a 20 22 3f 65 72 72 6f 72 KNOWN" : "?error
aeb0: 3f 22 0a 20 20 20 20 20 20 2c 20 70 2d 3e 65 78 ?". , p->ex
aec0: 63 6c 75 73 69 76 65 4d 6f 64 65 20 3f 20 22 65 clusiveMode ? "e
aed0: 78 63 6c 75 73 69 76 65 22 20 3a 20 22 6e 6f 72 xclusive" : "nor
aee0: 6d 61 6c 22 0a 20 20 20 20 20 20 2c 20 70 2d 3e mal". , p->
aef0: 6a 6f 75 72 6e 61 6c 4d 6f 64 65 3d 3d 50 41 47 journalMode==PAG
af00: 45 52 5f 4a 4f 55 52 4e 41 4c 4d 4f 44 45 5f 4d ER_JOURNALMODE_M
af10: 45 4d 4f 52 59 20 20 20 3f 20 22 6d 65 6d 6f 72 EMORY ? "memor
af20: 79 22 20 3a 0a 20 20 20 20 20 20 20 20 70 2d 3e y" :. p->
af30: 6a 6f 75 72 6e 61 6c 4d 6f 64 65 3d 3d 50 41 47 journalMode==PAG
af40: 45 52 5f 4a 4f 55 52 4e 41 4c 4d 4f 44 45 5f 4f ER_JOURNALMODE_O
af50: 46 46 20 20 20 20 20 20 3f 20 22 6f 66 66 22 20 FF ? "off"
af60: 3a 0a 20 20 20 20 20 20 20 20 70 2d 3e 6a 6f 75 :. p->jou
af70: 72 6e 61 6c 4d 6f 64 65 3d 3d 50 41 47 45 52 5f rnalMode==PAGER_
af80: 4a 4f 55 52 4e 41 4c 4d 4f 44 45 5f 44 45 4c 45 JOURNALMODE_DELE
af90: 54 45 20 20 20 3f 20 22 64 65 6c 65 74 65 22 20 TE ? "delete"
afa0: 3a 0a 20 20 20 20 20 20 20 20 70 2d 3e 6a 6f 75 :. p->jou
afb0: 72 6e 61 6c 4d 6f 64 65 3d 3d 50 41 47 45 52 5f rnalMode==PAGER_
afc0: 4a 4f 55 52 4e 41 4c 4d 4f 44 45 5f 50 45 52 53 JOURNALMODE_PERS
afd0: 49 53 54 20 20 3f 20 22 70 65 72 73 69 73 74 22 IST ? "persist"
afe0: 20 3a 0a 20 20 20 20 20 20 20 20 70 2d 3e 6a 6f :. p->jo
aff0: 75 72 6e 61 6c 4d 6f 64 65 3d 3d 50 41 47 45 52 urnalMode==PAGER
b000: 5f 4a 4f 55 52 4e 41 4c 4d 4f 44 45 5f 54 52 55 _JOURNALMODE_TRU
b010: 4e 43 41 54 45 20 3f 20 22 74 72 75 6e 63 61 74 NCATE ? "truncat
b020: 65 22 20 3a 0a 20 20 20 20 20 20 20 20 70 2d 3e e" :. p->
b030: 6a 6f 75 72 6e 61 6c 4d 6f 64 65 3d 3d 50 41 47 journalMode==PAG
b040: 45 52 5f 4a 4f 55 52 4e 41 4c 4d 4f 44 45 5f 57 ER_JOURNALMODE_W
b050: 41 4c 20 20 20 20 20 20 3f 20 22 77 61 6c 22 20 AL ? "wal"
b060: 3a 20 22 3f 65 72 72 6f 72 3f 22 0a 20 20 20 20 : "?error?".
b070: 20 20 2c 20 28 69 6e 74 29 70 2d 3e 74 65 6d 70 , (int)p->temp
b080: 46 69 6c 65 2c 20 28 69 6e 74 29 70 2d 3e 6d 65 File, (int)p->me
b090: 6d 44 62 2c 20 28 69 6e 74 29 70 2d 3e 75 73 65 mDb, (int)p->use
b0a0: 4a 6f 75 72 6e 61 6c 0a 20 20 20 20 20 20 2c 20 Journal. ,
b0b0: 70 2d 3e 6a 6f 75 72 6e 61 6c 4f 66 66 2c 20 70 p->journalOff, p
b0c0: 2d 3e 6a 6f 75 72 6e 61 6c 48 64 72 0a 20 20 20 ->journalHdr.
b0d0: 20 20 20 2c 20 28 69 6e 74 29 70 2d 3e 64 62 53 , (int)p->dbS
b0e0: 69 7a 65 2c 20 28 69 6e 74 29 70 2d 3e 64 62 4f ize, (int)p->dbO
b0f0: 72 69 67 53 69 7a 65 2c 20 28 69 6e 74 29 70 2d rigSize, (int)p-
b100: 3e 64 62 46 69 6c 65 53 69 7a 65 0a 20 20 29 3b >dbFileSize. );
b110: 0a 0a 20 20 72 65 74 75 72 6e 20 7a 52 65 74 3b .. return zRet;
b120: 0a 7d 0a 23 65 6e 64 69 66 0a 0a 2f 2a 0a 2a 2a .}.#endif../*.**
b130: 20 52 65 74 75 72 6e 20 74 72 75 65 20 69 66 20 Return true if
b140: 69 74 20 69 73 20 6e 65 63 65 73 73 61 72 79 20 it is necessary
b150: 74 6f 20 77 72 69 74 65 20 70 61 67 65 20 2a 70 to write page *p
b160: 50 67 20 69 6e 74 6f 20 74 68 65 20 73 75 62 2d Pg into the sub-
b170: 6a 6f 75 72 6e 61 6c 2e 0a 2a 2a 20 41 20 70 61 journal..** A pa
b180: 67 65 20 6e 65 65 64 73 20 74 6f 20 62 65 20 77 ge needs to be w
b190: 72 69 74 74 65 6e 20 69 6e 74 6f 20 74 68 65 20 ritten into the
b1a0: 73 75 62 2d 6a 6f 75 72 6e 61 6c 20 69 66 20 74 sub-journal if t
b1b0: 68 65 72 65 20 65 78 69 73 74 73 20 6f 6e 65 0a here exists one.
b1c0: 2a 2a 20 6f 72 20 6d 6f 72 65 20 6f 70 65 6e 20 ** or more open
b1d0: 73 61 76 65 70 6f 69 6e 74 73 20 66 6f 72 20 77 savepoints for w
b1e0: 68 69 63 68 3a 0a 2a 2a 0a 2a 2a 20 20 20 2a 20 hich:.**.** *
b1f0: 54 68 65 20 70 61 67 65 2d 6e 75 6d 62 65 72 20 The page-number
b200: 69 73 20 6c 65 73 73 20 74 68 61 6e 20 6f 72 20 is less than or
b210: 65 71 75 61 6c 20 74 6f 20 50 61 67 65 72 53 61 equal to PagerSa
b220: 76 65 70 6f 69 6e 74 2e 6e 4f 72 69 67 2c 20 61 vepoint.nOrig, a
b230: 6e 64 0a 2a 2a 20 20 20 2a 20 54 68 65 20 62 69 nd.** * The bi
b240: 74 20 63 6f 72 72 65 73 70 6f 6e 64 69 6e 67 20 t corresponding
b250: 74 6f 20 74 68 65 20 70 61 67 65 2d 6e 75 6d 62 to the page-numb
b260: 65 72 20 69 73 20 6e 6f 74 20 73 65 74 20 69 6e er is not set in
b270: 0a 2a 2a 20 20 20 20 20 50 61 67 65 72 53 61 76 .** PagerSav
b280: 65 70 6f 69 6e 74 2e 70 49 6e 53 61 76 65 70 6f epoint.pInSavepo
b290: 69 6e 74 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 69 int..*/.static i
b2a0: 6e 74 20 73 75 62 6a 52 65 71 75 69 72 65 73 50 nt subjRequiresP
b2b0: 61 67 65 28 50 67 48 64 72 20 2a 70 50 67 29 7b age(PgHdr *pPg){
b2c0: 0a 20 20 50 61 67 65 72 20 2a 70 50 61 67 65 72 . Pager *pPager
b2d0: 20 3d 20 70 50 67 2d 3e 70 50 61 67 65 72 3b 0a = pPg->pPager;.
b2e0: 20 20 50 61 67 65 72 53 61 76 65 70 6f 69 6e 74 PagerSavepoint
b2f0: 20 2a 70 3b 0a 20 20 50 67 6e 6f 20 70 67 6e 6f *p;. Pgno pgno
b300: 20 3d 20 70 50 67 2d 3e 70 67 6e 6f 3b 0a 20 20 = pPg->pgno;.
b310: 69 6e 74 20 69 3b 0a 20 20 66 6f 72 28 69 3d 30 int i;. for(i=0
b320: 3b 20 69 3c 70 50 61 67 65 72 2d 3e 6e 53 61 76 ; i<pPager->nSav
b330: 65 70 6f 69 6e 74 3b 20 69 2b 2b 29 7b 0a 20 20 epoint; i++){.
b340: 20 20 70 20 3d 20 26 70 50 61 67 65 72 2d 3e 61 p = &pPager->a
b350: 53 61 76 65 70 6f 69 6e 74 5b 69 5d 3b 0a 20 20 Savepoint[i];.
b360: 20 20 69 66 28 20 70 2d 3e 6e 4f 72 69 67 3e 3d if( p->nOrig>=
b370: 70 67 6e 6f 20 26 26 20 30 3d 3d 73 71 6c 69 74 pgno && 0==sqlit
b380: 65 33 42 69 74 76 65 63 54 65 73 74 4e 6f 74 4e e3BitvecTestNotN
b390: 75 6c 6c 28 70 2d 3e 70 49 6e 53 61 76 65 70 6f ull(p->pInSavepo
b3a0: 69 6e 74 2c 20 70 67 6e 6f 29 20 29 7b 0a 20 20 int, pgno) ){.
b3b0: 20 20 20 20 72 65 74 75 72 6e 20 31 3b 0a 20 20 return 1;.
b3c0: 20 20 7d 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e }. }. return
b3d0: 20 30 3b 0a 7d 0a 0a 23 69 66 64 65 66 20 53 51 0;.}..#ifdef SQ
b3e0: 4c 49 54 45 5f 44 45 42 55 47 0a 2f 2a 0a 2a 2a LITE_DEBUG./*.**
b3f0: 20 52 65 74 75 72 6e 20 74 72 75 65 20 69 66 20 Return true if
b400: 74 68 65 20 70 61 67 65 20 69 73 20 61 6c 72 65 the page is alre
b410: 61 64 79 20 69 6e 20 74 68 65 20 6a 6f 75 72 6e ady in the journ
b420: 61 6c 20 66 69 6c 65 2e 0a 2a 2f 0a 73 74 61 74 al file..*/.stat
b430: 69 63 20 69 6e 74 20 70 61 67 65 49 6e 4a 6f 75 ic int pageInJou
b440: 72 6e 61 6c 28 50 61 67 65 72 20 2a 70 50 61 67 rnal(Pager *pPag
b450: 65 72 2c 20 50 67 48 64 72 20 2a 70 50 67 29 7b er, PgHdr *pPg){
b460: 0a 20 20 72 65 74 75 72 6e 20 73 71 6c 69 74 65 . return sqlite
b470: 33 42 69 74 76 65 63 54 65 73 74 28 70 50 61 67 3BitvecTest(pPag
b480: 65 72 2d 3e 70 49 6e 4a 6f 75 72 6e 61 6c 2c 20 er->pInJournal,
b490: 70 50 67 2d 3e 70 67 6e 6f 29 3b 0a 7d 0a 23 65 pPg->pgno);.}.#e
b4a0: 6e 64 69 66 0a 0a 2f 2a 0a 2a 2a 20 52 65 61 64 ndif../*.** Read
b4b0: 20 61 20 33 32 2d 62 69 74 20 69 6e 74 65 67 65 a 32-bit intege
b4c0: 72 20 66 72 6f 6d 20 74 68 65 20 67 69 76 65 6e r from the given
b4d0: 20 66 69 6c 65 20 64 65 73 63 72 69 70 74 6f 72 file descriptor
b4e0: 2e 20 20 53 74 6f 72 65 20 74 68 65 20 69 6e 74 . Store the int
b4f0: 65 67 65 72 0a 2a 2a 20 74 68 61 74 20 69 73 20 eger.** that is
b500: 72 65 61 64 20 69 6e 20 2a 70 52 65 73 2e 20 20 read in *pRes.
b510: 52 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b Return SQLITE_OK
b520: 20 69 66 20 65 76 65 72 79 74 68 69 6e 67 20 77 if everything w
b530: 6f 72 6b 65 64 2c 20 6f 72 20 61 6e 0a 2a 2a 20 orked, or an.**
b540: 65 72 72 6f 72 20 63 6f 64 65 20 69 73 20 73 6f error code is so
b550: 6d 65 74 68 69 6e 67 20 67 6f 65 73 20 77 72 6f mething goes wro
b560: 6e 67 2e 0a 2a 2a 0a 2a 2a 20 41 6c 6c 20 76 61 ng..**.** All va
b570: 6c 75 65 73 20 61 72 65 20 73 74 6f 72 65 64 20 lues are stored
b580: 6f 6e 20 64 69 73 6b 20 61 73 20 62 69 67 2d 65 on disk as big-e
b590: 6e 64 69 61 6e 2e 0a 2a 2f 0a 73 74 61 74 69 63 ndian..*/.static
b5a0: 20 69 6e 74 20 72 65 61 64 33 32 62 69 74 73 28 int read32bits(
b5b0: 73 71 6c 69 74 65 33 5f 66 69 6c 65 20 2a 66 64 sqlite3_file *fd
b5c0: 2c 20 69 36 34 20 6f 66 66 73 65 74 2c 20 75 33 , i64 offset, u3
b5d0: 32 20 2a 70 52 65 73 29 7b 0a 20 20 75 6e 73 69 2 *pRes){. unsi
b5e0: 67 6e 65 64 20 63 68 61 72 20 61 63 5b 34 5d 3b gned char ac[4];
b5f0: 0a 20 20 69 6e 74 20 72 63 20 3d 20 73 71 6c 69 . int rc = sqli
b600: 74 65 33 4f 73 52 65 61 64 28 66 64 2c 20 61 63 te3OsRead(fd, ac
b610: 2c 20 73 69 7a 65 6f 66 28 61 63 29 2c 20 6f 66 , sizeof(ac), of
b620: 66 73 65 74 29 3b 0a 20 20 69 66 28 20 72 63 3d fset);. if( rc=
b630: 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 =SQLITE_OK ){.
b640: 20 20 2a 70 52 65 73 20 3d 20 73 71 6c 69 74 65 *pRes = sqlite
b650: 33 47 65 74 34 62 79 74 65 28 61 63 29 3b 0a 20 3Get4byte(ac);.
b660: 20 7d 0a 20 20 72 65 74 75 72 6e 20 72 63 3b 0a }. return rc;.
b670: 7d 0a 0a 2f 2a 0a 2a 2a 20 57 72 69 74 65 20 61 }../*.** Write a
b680: 20 33 32 2d 62 69 74 20 69 6e 74 65 67 65 72 20 32-bit integer
b690: 69 6e 74 6f 20 61 20 73 74 72 69 6e 67 20 62 75 into a string bu
b6a0: 66 66 65 72 20 69 6e 20 62 69 67 2d 65 6e 64 69 ffer in big-endi
b6b0: 61 6e 20 62 79 74 65 20 6f 72 64 65 72 2e 0a 2a an byte order..*
b6c0: 2f 0a 23 64 65 66 69 6e 65 20 70 75 74 33 32 62 /.#define put32b
b6d0: 69 74 73 28 41 2c 42 29 20 20 73 71 6c 69 74 65 its(A,B) sqlite
b6e0: 33 50 75 74 34 62 79 74 65 28 28 75 38 2a 29 41 3Put4byte((u8*)A
b6f0: 2c 42 29 0a 0a 0a 2f 2a 0a 2a 2a 20 57 72 69 74 ,B).../*.** Writ
b700: 65 20 61 20 33 32 2d 62 69 74 20 69 6e 74 65 67 e a 32-bit integ
b710: 65 72 20 69 6e 74 6f 20 74 68 65 20 67 69 76 65 er into the give
b720: 6e 20 66 69 6c 65 20 64 65 73 63 72 69 70 74 6f n file descripto
b730: 72 2e 20 20 52 65 74 75 72 6e 20 53 51 4c 49 54 r. Return SQLIT
b740: 45 5f 4f 4b 0a 2a 2a 20 6f 6e 20 73 75 63 63 65 E_OK.** on succe
b750: 73 73 20 6f 72 20 61 6e 20 65 72 72 6f 72 20 63 ss or an error c
b760: 6f 64 65 20 69 73 20 73 6f 6d 65 74 68 69 6e 67 ode is something
b770: 20 67 6f 65 73 20 77 72 6f 6e 67 2e 0a 2a 2f 0a goes wrong..*/.
b780: 73 74 61 74 69 63 20 69 6e 74 20 77 72 69 74 65 static int write
b790: 33 32 62 69 74 73 28 73 71 6c 69 74 65 33 5f 66 32bits(sqlite3_f
b7a0: 69 6c 65 20 2a 66 64 2c 20 69 36 34 20 6f 66 66 ile *fd, i64 off
b7b0: 73 65 74 2c 20 75 33 32 20 76 61 6c 29 7b 0a 20 set, u32 val){.
b7c0: 20 63 68 61 72 20 61 63 5b 34 5d 3b 0a 20 20 70 char ac[4];. p
b7d0: 75 74 33 32 62 69 74 73 28 61 63 2c 20 76 61 6c ut32bits(ac, val
b7e0: 29 3b 0a 20 20 72 65 74 75 72 6e 20 73 71 6c 69 );. return sqli
b7f0: 74 65 33 4f 73 57 72 69 74 65 28 66 64 2c 20 61 te3OsWrite(fd, a
b800: 63 2c 20 34 2c 20 6f 66 66 73 65 74 29 3b 0a 7d c, 4, offset);.}
b810: 0a 0a 2f 2a 0a 2a 2a 20 55 6e 6c 6f 63 6b 20 74 ../*.** Unlock t
b820: 68 65 20 64 61 74 61 62 61 73 65 20 66 69 6c 65 he database file
b830: 20 74 6f 20 6c 65 76 65 6c 20 65 4c 6f 63 6b 2c to level eLock,
b840: 20 77 68 69 63 68 20 6d 75 73 74 20 62 65 20 65 which must be e
b850: 69 74 68 65 72 20 4e 4f 5f 4c 4f 43 4b 0a 2a 2a ither NO_LOCK.**
b860: 20 6f 72 20 53 48 41 52 45 44 5f 4c 4f 43 4b 2e or SHARED_LOCK.
b870: 20 52 65 67 61 72 64 6c 65 73 73 20 6f 66 20 77 Regardless of w
b880: 68 65 74 68 65 72 20 6f 72 20 6e 6f 74 20 74 68 hether or not th
b890: 65 20 63 61 6c 6c 20 74 6f 20 78 55 6e 6c 6f 63 e call to xUnloc
b8a0: 6b 28 29 0a 2a 2a 20 73 75 63 63 65 65 64 73 2c k().** succeeds,
b8b0: 20 73 65 74 20 74 68 65 20 50 61 67 65 72 2e 65 set the Pager.e
b8c0: 4c 6f 63 6b 20 76 61 72 69 61 62 6c 65 20 74 6f Lock variable to
b8d0: 20 6d 61 74 63 68 20 74 68 65 20 28 61 74 74 65 match the (atte
b8e0: 6d 70 74 65 64 29 20 6e 65 77 20 6c 6f 63 6b 2e mpted) new lock.
b8f0: 0a 2a 2a 0a 2a 2a 20 45 78 63 65 70 74 2c 20 69 .**.** Except, i
b900: 66 20 50 61 67 65 72 2e 65 4c 6f 63 6b 20 69 73 f Pager.eLock is
b910: 20 73 65 74 20 74 6f 20 55 4e 4b 4e 4f 57 4e 5f set to UNKNOWN_
b920: 4c 4f 43 4b 20 77 68 65 6e 20 74 68 69 73 20 66 LOCK when this f
b930: 75 6e 63 74 69 6f 6e 20 69 73 0a 2a 2a 20 63 61 unction is.** ca
b940: 6c 6c 65 64 2c 20 64 6f 20 6e 6f 74 20 6d 6f 64 lled, do not mod
b950: 69 66 79 20 69 74 2e 20 53 65 65 20 74 68 65 20 ify it. See the
b960: 63 6f 6d 6d 65 6e 74 20 61 62 6f 76 65 20 74 68 comment above th
b970: 65 20 23 64 65 66 69 6e 65 20 6f 66 20 0a 2a 2a e #define of .**
b980: 20 55 4e 4b 4e 4f 57 4e 5f 4c 4f 43 4b 20 66 6f UNKNOWN_LOCK fo
b990: 72 20 61 6e 20 65 78 70 6c 61 6e 61 74 69 6f 6e r an explanation
b9a0: 20 6f 66 20 74 68 69 73 2e 0a 2a 2f 0a 73 74 61 of this..*/.sta
b9b0: 74 69 63 20 69 6e 74 20 70 61 67 65 72 55 6e 6c tic int pagerUnl
b9c0: 6f 63 6b 44 62 28 50 61 67 65 72 20 2a 70 50 61 ockDb(Pager *pPa
b9d0: 67 65 72 2c 20 69 6e 74 20 65 4c 6f 63 6b 29 7b ger, int eLock){
b9e0: 0a 20 20 69 6e 74 20 72 63 20 3d 20 53 51 4c 49 . int rc = SQLI
b9f0: 54 45 5f 4f 4b 3b 0a 0a 20 20 61 73 73 65 72 74 TE_OK;.. assert
ba00: 28 20 21 70 50 61 67 65 72 2d 3e 65 78 63 6c 75 ( !pPager->exclu
ba10: 73 69 76 65 4d 6f 64 65 20 7c 7c 20 70 50 61 67 siveMode || pPag
ba20: 65 72 2d 3e 65 4c 6f 63 6b 3d 3d 65 4c 6f 63 6b er->eLock==eLock
ba30: 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 65 4c );. assert( eL
ba40: 6f 63 6b 3d 3d 4e 4f 5f 4c 4f 43 4b 20 7c 7c 20 ock==NO_LOCK ||
ba50: 65 4c 6f 63 6b 3d 3d 53 48 41 52 45 44 5f 4c 4f eLock==SHARED_LO
ba60: 43 4b 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 CK );. assert(
ba70: 65 4c 6f 63 6b 21 3d 4e 4f 5f 4c 4f 43 4b 20 7c eLock!=NO_LOCK |
ba80: 7c 20 70 61 67 65 72 55 73 65 57 61 6c 28 70 50 | pagerUseWal(pP
ba90: 61 67 65 72 29 3d 3d 30 20 29 3b 0a 20 20 69 66 ager)==0 );. if
baa0: 28 20 69 73 4f 70 65 6e 28 70 50 61 67 65 72 2d ( isOpen(pPager-
bab0: 3e 66 64 29 20 29 7b 0a 20 20 20 20 61 73 73 65 >fd) ){. asse
bac0: 72 74 28 20 70 50 61 67 65 72 2d 3e 65 4c 6f 63 rt( pPager->eLoc
bad0: 6b 3e 3d 65 4c 6f 63 6b 20 29 3b 0a 20 20 20 20 k>=eLock );.
bae0: 72 63 20 3d 20 70 50 61 67 65 72 2d 3e 6e 6f 4c rc = pPager->noL
baf0: 6f 63 6b 20 3f 20 53 51 4c 49 54 45 5f 4f 4b 20 ock ? SQLITE_OK
bb00: 3a 20 73 71 6c 69 74 65 33 4f 73 55 6e 6c 6f 63 : sqlite3OsUnloc
bb10: 6b 28 70 50 61 67 65 72 2d 3e 66 64 2c 20 65 4c k(pPager->fd, eL
bb20: 6f 63 6b 29 3b 0a 20 20 20 20 69 66 28 20 70 50 ock);. if( pP
bb30: 61 67 65 72 2d 3e 65 4c 6f 63 6b 21 3d 55 4e 4b ager->eLock!=UNK
bb40: 4e 4f 57 4e 5f 4c 4f 43 4b 20 29 7b 0a 20 20 20 NOWN_LOCK ){.
bb50: 20 20 20 70 50 61 67 65 72 2d 3e 65 4c 6f 63 6b pPager->eLock
bb60: 20 3d 20 28 75 38 29 65 4c 6f 63 6b 3b 0a 20 20 = (u8)eLock;.
bb70: 20 20 7d 0a 20 20 20 20 49 4f 54 52 41 43 45 28 }. IOTRACE(
bb80: 28 22 55 4e 4c 4f 43 4b 20 25 70 20 25 64 5c 6e ("UNLOCK %p %d\n
bb90: 22 2c 20 70 50 61 67 65 72 2c 20 65 4c 6f 63 6b ", pPager, eLock
bba0: 29 29 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e 20 )). }. return
bbb0: 72 63 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 4c 6f 63 rc;.}../*.** Loc
bbc0: 6b 20 74 68 65 20 64 61 74 61 62 61 73 65 20 66 k the database f
bbd0: 69 6c 65 20 74 6f 20 6c 65 76 65 6c 20 65 4c 6f ile to level eLo
bbe0: 63 6b 2c 20 77 68 69 63 68 20 6d 75 73 74 20 62 ck, which must b
bbf0: 65 20 65 69 74 68 65 72 20 53 48 41 52 45 44 5f e either SHARED_
bc00: 4c 4f 43 4b 2c 0a 2a 2a 20 52 45 53 45 52 56 45 LOCK,.** RESERVE
bc10: 44 5f 4c 4f 43 4b 20 6f 72 20 45 58 43 4c 55 53 D_LOCK or EXCLUS
bc20: 49 56 45 5f 4c 4f 43 4b 2e 20 49 66 20 74 68 65 IVE_LOCK. If the
bc30: 20 63 61 6c 6c 65 72 20 69 73 20 73 75 63 63 65 caller is succe
bc40: 73 73 66 75 6c 2c 20 73 65 74 20 74 68 65 0a 2a ssful, set the.*
bc50: 2a 20 50 61 67 65 72 2e 65 4c 6f 63 6b 20 76 61 * Pager.eLock va
bc60: 72 69 61 62 6c 65 20 74 6f 20 74 68 65 20 6e 65 riable to the ne
bc70: 77 20 6c 6f 63 6b 69 6e 67 20 73 74 61 74 65 2e w locking state.
bc80: 20 0a 2a 2a 0a 2a 2a 20 45 78 63 65 70 74 2c 20 .**.** Except,
bc90: 69 66 20 50 61 67 65 72 2e 65 4c 6f 63 6b 20 69 if Pager.eLock i
bca0: 73 20 73 65 74 20 74 6f 20 55 4e 4b 4e 4f 57 4e s set to UNKNOWN
bcb0: 5f 4c 4f 43 4b 20 77 68 65 6e 20 74 68 69 73 20 _LOCK when this
bcc0: 66 75 6e 63 74 69 6f 6e 20 69 73 20 0a 2a 2a 20 function is .**
bcd0: 63 61 6c 6c 65 64 2c 20 64 6f 20 6e 6f 74 20 6d called, do not m
bce0: 6f 64 69 66 79 20 69 74 20 75 6e 6c 65 73 73 20 odify it unless
bcf0: 74 68 65 20 6e 65 77 20 6c 6f 63 6b 69 6e 67 20 the new locking
bd00: 73 74 61 74 65 20 69 73 20 45 58 43 4c 55 53 49 state is EXCLUSI
bd10: 56 45 5f 4c 4f 43 4b 2e 20 0a 2a 2a 20 53 65 65 VE_LOCK. .** See
bd20: 20 74 68 65 20 63 6f 6d 6d 65 6e 74 20 61 62 6f the comment abo
bd30: 76 65 20 74 68 65 20 23 64 65 66 69 6e 65 20 6f ve the #define o
bd40: 66 20 55 4e 4b 4e 4f 57 4e 5f 4c 4f 43 4b 20 66 f UNKNOWN_LOCK f
bd50: 6f 72 20 61 6e 20 65 78 70 6c 61 6e 61 74 69 6f or an explanatio
bd60: 6e 20 0a 2a 2a 20 6f 66 20 74 68 69 73 2e 0a 2a n .** of this..*
bd70: 2f 0a 73 74 61 74 69 63 20 69 6e 74 20 70 61 67 /.static int pag
bd80: 65 72 4c 6f 63 6b 44 62 28 50 61 67 65 72 20 2a erLockDb(Pager *
bd90: 70 50 61 67 65 72 2c 20 69 6e 74 20 65 4c 6f 63 pPager, int eLoc
bda0: 6b 29 7b 0a 20 20 69 6e 74 20 72 63 20 3d 20 53 k){. int rc = S
bdb0: 51 4c 49 54 45 5f 4f 4b 3b 0a 0a 20 20 61 73 73 QLITE_OK;.. ass
bdc0: 65 72 74 28 20 65 4c 6f 63 6b 3d 3d 53 48 41 52 ert( eLock==SHAR
bdd0: 45 44 5f 4c 4f 43 4b 20 7c 7c 20 65 4c 6f 63 6b ED_LOCK || eLock
bde0: 3d 3d 52 45 53 45 52 56 45 44 5f 4c 4f 43 4b 20 ==RESERVED_LOCK
bdf0: 7c 7c 20 65 4c 6f 63 6b 3d 3d 45 58 43 4c 55 53 || eLock==EXCLUS
be00: 49 56 45 5f 4c 4f 43 4b 20 29 3b 0a 20 20 69 66 IVE_LOCK );. if
be10: 28 20 70 50 61 67 65 72 2d 3e 65 4c 6f 63 6b 3c ( pPager->eLock<
be20: 65 4c 6f 63 6b 20 7c 7c 20 70 50 61 67 65 72 2d eLock || pPager-
be30: 3e 65 4c 6f 63 6b 3d 3d 55 4e 4b 4e 4f 57 4e 5f >eLock==UNKNOWN_
be40: 4c 4f 43 4b 20 29 7b 0a 20 20 20 20 72 63 20 3d LOCK ){. rc =
be50: 20 70 50 61 67 65 72 2d 3e 6e 6f 4c 6f 63 6b 20 pPager->noLock
be60: 3f 20 53 51 4c 49 54 45 5f 4f 4b 20 3a 20 73 71 ? SQLITE_OK : sq
be70: 6c 69 74 65 33 4f 73 4c 6f 63 6b 28 70 50 61 67 lite3OsLock(pPag
be80: 65 72 2d 3e 66 64 2c 20 65 4c 6f 63 6b 29 3b 0a er->fd, eLock);.
be90: 20 20 20 20 69 66 28 20 72 63 3d 3d 53 51 4c 49 if( rc==SQLI
bea0: 54 45 5f 4f 4b 20 26 26 20 28 70 50 61 67 65 72 TE_OK && (pPager
beb0: 2d 3e 65 4c 6f 63 6b 21 3d 55 4e 4b 4e 4f 57 4e ->eLock!=UNKNOWN
bec0: 5f 4c 4f 43 4b 7c 7c 65 4c 6f 63 6b 3d 3d 45 58 _LOCK||eLock==EX
bed0: 43 4c 55 53 49 56 45 5f 4c 4f 43 4b 29 20 29 7b CLUSIVE_LOCK) ){
bee0: 0a 20 20 20 20 20 20 70 50 61 67 65 72 2d 3e 65 . pPager->e
bef0: 4c 6f 63 6b 20 3d 20 28 75 38 29 65 4c 6f 63 6b Lock = (u8)eLock
bf00: 3b 0a 20 20 20 20 20 20 49 4f 54 52 41 43 45 28 ;. IOTRACE(
bf10: 28 22 4c 4f 43 4b 20 25 70 20 25 64 5c 6e 22 2c ("LOCK %p %d\n",
bf20: 20 70 50 61 67 65 72 2c 20 65 4c 6f 63 6b 29 29 pPager, eLock))
bf30: 0a 20 20 20 20 7d 0a 20 20 7d 0a 20 20 72 65 74 . }. }. ret
bf40: 75 72 6e 20 72 63 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a urn rc;.}../*.**
bf50: 20 54 68 69 73 20 66 75 6e 63 74 69 6f 6e 20 64 This function d
bf60: 65 74 65 72 6d 69 6e 65 73 20 77 68 65 74 68 65 etermines whethe
bf70: 72 20 6f 72 20 6e 6f 74 20 74 68 65 20 61 74 6f r or not the ato
bf80: 6d 69 63 2d 77 72 69 74 65 20 6f 70 74 69 6d 69 mic-write optimi
bf90: 7a 61 74 69 6f 6e 0a 2a 2a 20 63 61 6e 20 62 65 zation.** can be
bfa0: 20 75 73 65 64 20 77 69 74 68 20 74 68 69 73 20 used with this
bfb0: 70 61 67 65 72 2e 20 54 68 65 20 6f 70 74 69 6d pager. The optim
bfc0: 69 7a 61 74 69 6f 6e 20 63 61 6e 20 62 65 20 75 ization can be u
bfd0: 73 65 64 20 69 66 3a 0a 2a 2a 0a 2a 2a 20 20 28 sed if:.**.** (
bfe0: 61 29 20 74 68 65 20 76 61 6c 75 65 20 72 65 74 a) the value ret
bff0: 75 72 6e 65 64 20 62 79 20 4f 73 44 65 76 69 63 urned by OsDevic
c000: 65 43 68 61 72 61 63 74 65 72 69 73 74 69 63 73 eCharacteristics
c010: 28 29 20 69 6e 64 69 63 61 74 65 73 20 74 68 61 () indicates tha
c020: 74 0a 2a 2a 20 20 20 20 20 20 61 20 64 61 74 61 t.** a data
c030: 62 61 73 65 20 70 61 67 65 20 6d 61 79 20 62 65 base page may be
c040: 20 77 72 69 74 74 65 6e 20 61 74 6f 6d 69 63 61 written atomica
c050: 6c 6c 79 2c 20 61 6e 64 0a 2a 2a 20 20 28 62 29 lly, and.** (b)
c060: 20 74 68 65 20 76 61 6c 75 65 20 72 65 74 75 72 the value retur
c070: 6e 65 64 20 62 79 20 4f 73 53 65 63 74 6f 72 53 ned by OsSectorS
c080: 69 7a 65 28 29 20 69 73 20 6c 65 73 73 20 74 68 ize() is less th
c090: 61 6e 20 6f 72 20 65 71 75 61 6c 0a 2a 2a 20 20 an or equal.**
c0a0: 20 20 20 20 74 6f 20 74 68 65 20 70 61 67 65 20 to the page
c0b0: 73 69 7a 65 2e 0a 2a 2a 0a 2a 2a 20 54 68 65 20 size..**.** The
c0c0: 6f 70 74 69 6d 69 7a 61 74 69 6f 6e 20 69 73 20 optimization is
c0d0: 61 6c 73 6f 20 61 6c 77 61 79 73 20 65 6e 61 62 also always enab
c0e0: 6c 65 64 20 66 6f 72 20 74 65 6d 70 6f 72 61 72 led for temporar
c0f0: 79 20 66 69 6c 65 73 2e 20 49 74 20 69 73 0a 2a y files. It is.*
c100: 2a 20 61 6e 20 65 72 72 6f 72 20 74 6f 20 63 61 * an error to ca
c110: 6c 6c 20 74 68 69 73 20 66 75 6e 63 74 69 6f 6e ll this function
c120: 20 69 66 20 70 50 61 67 65 72 20 69 73 20 6f 70 if pPager is op
c130: 65 6e 65 64 20 6f 6e 20 61 6e 20 69 6e 2d 6d 65 ened on an in-me
c140: 6d 6f 72 79 0a 2a 2a 20 64 61 74 61 62 61 73 65 mory.** database
c150: 2e 0a 2a 2a 0a 2a 2a 20 49 66 20 74 68 65 20 6f ..**.** If the o
c160: 70 74 69 6d 69 7a 61 74 69 6f 6e 20 63 61 6e 6e ptimization cann
c170: 6f 74 20 62 65 20 75 73 65 64 2c 20 30 20 69 73 ot be used, 0 is
c180: 20 72 65 74 75 72 6e 65 64 2e 20 49 66 20 69 74 returned. If it
c190: 20 63 61 6e 20 62 65 20 75 73 65 64 2c 0a 2a 2a can be used,.**
c1a0: 20 74 68 65 6e 20 74 68 65 20 76 61 6c 75 65 20 then the value
c1b0: 72 65 74 75 72 6e 65 64 20 69 73 20 74 68 65 20 returned is the
c1c0: 73 69 7a 65 20 6f 66 20 74 68 65 20 6a 6f 75 72 size of the jour
c1d0: 6e 61 6c 20 66 69 6c 65 20 77 68 65 6e 20 69 74 nal file when it
c1e0: 0a 2a 2a 20 63 6f 6e 74 61 69 6e 73 20 72 6f 6c .** contains rol
c1f0: 6c 62 61 63 6b 20 64 61 74 61 20 66 6f 72 20 65 lback data for e
c200: 78 61 63 74 6c 79 20 6f 6e 65 20 70 61 67 65 2e xactly one page.
c210: 0a 2a 2f 0a 23 69 66 64 65 66 20 53 51 4c 49 54 .*/.#ifdef SQLIT
c220: 45 5f 45 4e 41 42 4c 45 5f 41 54 4f 4d 49 43 5f E_ENABLE_ATOMIC_
c230: 57 52 49 54 45 0a 73 74 61 74 69 63 20 69 6e 74 WRITE.static int
c240: 20 6a 72 6e 6c 42 75 66 66 65 72 53 69 7a 65 28 jrnlBufferSize(
c250: 50 61 67 65 72 20 2a 70 50 61 67 65 72 29 7b 0a Pager *pPager){.
c260: 20 20 61 73 73 65 72 74 28 20 21 4d 45 4d 44 42 assert( !MEMDB
c270: 20 29 3b 0a 20 20 69 66 28 20 21 70 50 61 67 65 );. if( !pPage
c280: 72 2d 3e 74 65 6d 70 46 69 6c 65 20 29 7b 0a 20 r->tempFile ){.
c290: 20 20 20 69 6e 74 20 64 63 3b 20 20 20 20 20 20 int dc;
c2a0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
c2b0: 20 20 20 20 20 2f 2a 20 44 65 76 69 63 65 20 63 /* Device c
c2c0: 68 61 72 61 63 74 65 72 69 73 74 69 63 73 20 2a haracteristics *
c2d0: 2f 0a 20 20 20 20 69 6e 74 20 6e 53 65 63 74 6f /. int nSecto
c2e0: 72 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 r;
c2f0: 20 20 20 20 20 20 20 20 2f 2a 20 53 65 63 74 6f /* Secto
c300: 72 20 73 69 7a 65 20 2a 2f 0a 20 20 20 20 69 6e r size */. in
c310: 74 20 73 7a 50 61 67 65 3b 20 20 20 20 20 20 20 t szPage;
c320: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
c330: 2f 2a 20 50 61 67 65 20 73 69 7a 65 20 2a 2f 0a /* Page size */.
c340: 0a 20 20 20 20 61 73 73 65 72 74 28 20 69 73 4f . assert( isO
c350: 70 65 6e 28 70 50 61 67 65 72 2d 3e 66 64 29 20 pen(pPager->fd)
c360: 29 3b 0a 20 20 20 20 64 63 20 3d 20 73 71 6c 69 );. dc = sqli
c370: 74 65 33 4f 73 44 65 76 69 63 65 43 68 61 72 61 te3OsDeviceChara
c380: 63 74 65 72 69 73 74 69 63 73 28 70 50 61 67 65 cteristics(pPage
c390: 72 2d 3e 66 64 29 3b 0a 20 20 20 20 6e 53 65 63 r->fd);. nSec
c3a0: 74 6f 72 20 3d 20 70 50 61 67 65 72 2d 3e 73 65 tor = pPager->se
c3b0: 63 74 6f 72 53 69 7a 65 3b 0a 20 20 20 20 73 7a ctorSize;. sz
c3c0: 50 61 67 65 20 3d 20 70 50 61 67 65 72 2d 3e 70 Page = pPager->p
c3d0: 61 67 65 53 69 7a 65 3b 0a 0a 20 20 20 20 61 73 ageSize;.. as
c3e0: 73 65 72 74 28 53 51 4c 49 54 45 5f 49 4f 43 41 sert(SQLITE_IOCA
c3f0: 50 5f 41 54 4f 4d 49 43 35 31 32 3d 3d 28 35 31 P_ATOMIC512==(51
c400: 32 3e 3e 38 29 29 3b 0a 20 20 20 20 61 73 73 65 2>>8));. asse
c410: 72 74 28 53 51 4c 49 54 45 5f 49 4f 43 41 50 5f rt(SQLITE_IOCAP_
c420: 41 54 4f 4d 49 43 36 34 4b 3d 3d 28 36 35 35 33 ATOMIC64K==(6553
c430: 36 3e 3e 38 29 29 3b 0a 20 20 20 20 69 66 28 20 6>>8));. if(
c440: 30 3d 3d 28 64 63 26 28 53 51 4c 49 54 45 5f 49 0==(dc&(SQLITE_I
c450: 4f 43 41 50 5f 41 54 4f 4d 49 43 7c 28 73 7a 50 OCAP_ATOMIC|(szP
c460: 61 67 65 3e 3e 38 29 29 20 7c 7c 20 6e 53 65 63 age>>8)) || nSec
c470: 74 6f 72 3e 73 7a 50 61 67 65 29 20 29 7b 0a 20 tor>szPage) ){.
c480: 20 20 20 20 20 72 65 74 75 72 6e 20 30 3b 0a 20 return 0;.
c490: 20 20 20 7d 0a 20 20 7d 0a 0a 20 20 72 65 74 75 }. }.. retu
c4a0: 72 6e 20 4a 4f 55 52 4e 41 4c 5f 48 44 52 5f 53 rn JOURNAL_HDR_S
c4b0: 5a 28 70 50 61 67 65 72 29 20 2b 20 4a 4f 55 52 Z(pPager) + JOUR
c4c0: 4e 41 4c 5f 50 47 5f 53 5a 28 70 50 61 67 65 72 NAL_PG_SZ(pPager
c4d0: 29 3b 0a 7d 0a 23 65 6c 73 65 0a 23 20 64 65 66 );.}.#else.# def
c4e0: 69 6e 65 20 6a 72 6e 6c 42 75 66 66 65 72 53 69 ine jrnlBufferSi
c4f0: 7a 65 28 78 29 20 30 0a 23 65 6e 64 69 66 0a 0a ze(x) 0.#endif..
c500: 2f 2a 0a 2a 2a 20 49 66 20 53 51 4c 49 54 45 5f /*.** If SQLITE_
c510: 43 48 45 43 4b 5f 50 41 47 45 53 20 69 73 20 64 CHECK_PAGES is d
c520: 65 66 69 6e 65 64 20 74 68 65 6e 20 77 65 20 64 efined then we d
c530: 6f 20 73 6f 6d 65 20 73 61 6e 69 74 79 20 63 68 o some sanity ch
c540: 65 63 6b 69 6e 67 0a 2a 2a 20 6f 6e 20 74 68 65 ecking.** on the
c550: 20 63 61 63 68 65 20 75 73 69 6e 67 20 61 20 68 cache using a h
c560: 61 73 68 20 66 75 6e 63 74 69 6f 6e 2e 20 20 54 ash function. T
c570: 68 69 73 20 69 73 20 75 73 65 64 20 66 6f 72 20 his is used for
c580: 74 65 73 74 69 6e 67 0a 2a 2a 20 61 6e 64 20 64 testing.** and d
c590: 65 62 75 67 67 69 6e 67 20 6f 6e 6c 79 2e 0a 2a ebugging only..*
c5a0: 2f 0a 23 69 66 64 65 66 20 53 51 4c 49 54 45 5f /.#ifdef SQLITE_
c5b0: 43 48 45 43 4b 5f 50 41 47 45 53 0a 2f 2a 0a 2a CHECK_PAGES./*.*
c5c0: 2a 20 52 65 74 75 72 6e 20 61 20 33 32 2d 62 69 * Return a 32-bi
c5d0: 74 20 68 61 73 68 20 6f 66 20 74 68 65 20 70 61 t hash of the pa
c5e0: 67 65 20 64 61 74 61 20 66 6f 72 20 70 50 61 67 ge data for pPag
c5f0: 65 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 75 33 32 e..*/.static u32
c600: 20 70 61 67 65 72 5f 64 61 74 61 68 61 73 68 28 pager_datahash(
c610: 69 6e 74 20 6e 42 79 74 65 2c 20 75 6e 73 69 67 int nByte, unsig
c620: 6e 65 64 20 63 68 61 72 20 2a 70 44 61 74 61 29 ned char *pData)
c630: 7b 0a 20 20 75 33 32 20 68 61 73 68 20 3d 20 30 {. u32 hash = 0
c640: 3b 0a 20 20 69 6e 74 20 69 3b 0a 20 20 66 6f 72 ;. int i;. for
c650: 28 69 3d 30 3b 20 69 3c 6e 42 79 74 65 3b 20 69 (i=0; i<nByte; i
c660: 2b 2b 29 7b 0a 20 20 20 20 68 61 73 68 20 3d 20 ++){. hash =
c670: 28 68 61 73 68 2a 31 30 33 39 29 20 2b 20 70 44 (hash*1039) + pD
c680: 61 74 61 5b 69 5d 3b 0a 20 20 7d 0a 20 20 72 65 ata[i];. }. re
c690: 74 75 72 6e 20 68 61 73 68 3b 0a 7d 0a 73 74 61 turn hash;.}.sta
c6a0: 74 69 63 20 75 33 32 20 70 61 67 65 72 5f 70 61 tic u32 pager_pa
c6b0: 67 65 68 61 73 68 28 50 67 48 64 72 20 2a 70 50 gehash(PgHdr *pP
c6c0: 61 67 65 29 7b 0a 20 20 72 65 74 75 72 6e 20 70 age){. return p
c6d0: 61 67 65 72 5f 64 61 74 61 68 61 73 68 28 70 50 ager_datahash(pP
c6e0: 61 67 65 2d 3e 70 50 61 67 65 72 2d 3e 70 61 67 age->pPager->pag
c6f0: 65 53 69 7a 65 2c 20 28 75 6e 73 69 67 6e 65 64 eSize, (unsigned
c700: 20 63 68 61 72 20 2a 29 70 50 61 67 65 2d 3e 70 char *)pPage->p
c710: 44 61 74 61 29 3b 0a 7d 0a 73 74 61 74 69 63 20 Data);.}.static
c720: 76 6f 69 64 20 70 61 67 65 72 5f 73 65 74 5f 70 void pager_set_p
c730: 61 67 65 68 61 73 68 28 50 67 48 64 72 20 2a 70 agehash(PgHdr *p
c740: 50 61 67 65 29 7b 0a 20 20 70 50 61 67 65 2d 3e Page){. pPage->
c750: 70 61 67 65 48 61 73 68 20 3d 20 70 61 67 65 72 pageHash = pager
c760: 5f 70 61 67 65 68 61 73 68 28 70 50 61 67 65 29 _pagehash(pPage)
c770: 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 54 68 65 20 43 ;.}../*.** The C
c780: 48 45 43 4b 5f 50 41 47 45 20 6d 61 63 72 6f 20 HECK_PAGE macro
c790: 74 61 6b 65 73 20 61 20 50 67 48 64 72 2a 20 61 takes a PgHdr* a
c7a0: 73 20 61 6e 20 61 72 67 75 6d 65 6e 74 2e 20 49 s an argument. I
c7b0: 66 20 53 51 4c 49 54 45 5f 43 48 45 43 4b 5f 50 f SQLITE_CHECK_P
c7c0: 41 47 45 53 0a 2a 2a 20 69 73 20 64 65 66 69 6e AGES.** is defin
c7d0: 65 64 2c 20 61 6e 64 20 4e 44 45 42 55 47 20 69 ed, and NDEBUG i
c7e0: 73 20 6e 6f 74 20 64 65 66 69 6e 65 64 2c 20 61 s not defined, a
c7f0: 6e 20 61 73 73 65 72 74 28 29 20 73 74 61 74 65 n assert() state
c800: 6d 65 6e 74 20 63 68 65 63 6b 73 0a 2a 2a 20 74 ment checks.** t
c810: 68 61 74 20 74 68 65 20 70 61 67 65 20 69 73 20 hat the page is
c820: 65 69 74 68 65 72 20 64 69 72 74 79 20 6f 72 20 either dirty or
c830: 73 74 69 6c 6c 20 6d 61 74 63 68 65 73 20 74 68 still matches th
c840: 65 20 63 61 6c 63 75 6c 61 74 65 64 20 70 61 67 e calculated pag
c850: 65 2d 68 61 73 68 2e 0a 2a 2f 0a 23 64 65 66 69 e-hash..*/.#defi
c860: 6e 65 20 43 48 45 43 4b 5f 50 41 47 45 28 78 29 ne CHECK_PAGE(x)
c870: 20 63 68 65 63 6b 50 61 67 65 28 78 29 0a 73 74 checkPage(x).st
c880: 61 74 69 63 20 76 6f 69 64 20 63 68 65 63 6b 50 atic void checkP
c890: 61 67 65 28 50 67 48 64 72 20 2a 70 50 67 29 7b age(PgHdr *pPg){
c8a0: 0a 20 20 50 61 67 65 72 20 2a 70 50 61 67 65 72 . Pager *pPager
c8b0: 20 3d 20 70 50 67 2d 3e 70 50 61 67 65 72 3b 0a = pPg->pPager;.
c8c0: 20 20 61 73 73 65 72 74 28 20 70 50 61 67 65 72 assert( pPager
c8d0: 2d 3e 65 53 74 61 74 65 21 3d 50 41 47 45 52 5f ->eState!=PAGER_
c8e0: 45 52 52 4f 52 20 29 3b 0a 20 20 61 73 73 65 72 ERROR );. asser
c8f0: 74 28 20 28 70 50 67 2d 3e 66 6c 61 67 73 26 50 t( (pPg->flags&P
c900: 47 48 44 52 5f 44 49 52 54 59 29 20 7c 7c 20 70 GHDR_DIRTY) || p
c910: 50 67 2d 3e 70 61 67 65 48 61 73 68 3d 3d 70 61 Pg->pageHash==pa
c920: 67 65 72 5f 70 61 67 65 68 61 73 68 28 70 50 67 ger_pagehash(pPg
c930: 29 20 29 3b 0a 7d 0a 0a 23 65 6c 73 65 0a 23 64 ) );.}..#else.#d
c940: 65 66 69 6e 65 20 70 61 67 65 72 5f 64 61 74 61 efine pager_data
c950: 68 61 73 68 28 58 2c 59 29 20 20 30 0a 23 64 65 hash(X,Y) 0.#de
c960: 66 69 6e 65 20 70 61 67 65 72 5f 70 61 67 65 68 fine pager_pageh
c970: 61 73 68 28 58 29 20 20 30 0a 23 64 65 66 69 6e ash(X) 0.#defin
c980: 65 20 70 61 67 65 72 5f 73 65 74 5f 70 61 67 65 e pager_set_page
c990: 68 61 73 68 28 58 29 0a 23 64 65 66 69 6e 65 20 hash(X).#define
c9a0: 43 48 45 43 4b 5f 50 41 47 45 28 78 29 0a 23 65 CHECK_PAGE(x).#e
c9b0: 6e 64 69 66 20 20 2f 2a 20 53 51 4c 49 54 45 5f ndif /* SQLITE_
c9c0: 43 48 45 43 4b 5f 50 41 47 45 53 20 2a 2f 0a 0a CHECK_PAGES */..
c9d0: 2f 2a 0a 2a 2a 20 57 68 65 6e 20 74 68 69 73 20 /*.** When this
c9e0: 69 73 20 63 61 6c 6c 65 64 20 74 68 65 20 6a 6f is called the jo
c9f0: 75 72 6e 61 6c 20 66 69 6c 65 20 66 6f 72 20 70 urnal file for p
ca00: 61 67 65 72 20 70 50 61 67 65 72 20 6d 75 73 74 ager pPager must
ca10: 20 62 65 20 6f 70 65 6e 2e 0a 2a 2a 20 54 68 69 be open..** Thi
ca20: 73 20 66 75 6e 63 74 69 6f 6e 20 61 74 74 65 6d s function attem
ca30: 70 74 73 20 74 6f 20 72 65 61 64 20 61 20 6d 61 pts to read a ma
ca40: 73 74 65 72 20 6a 6f 75 72 6e 61 6c 20 66 69 6c ster journal fil
ca50: 65 20 6e 61 6d 65 20 66 72 6f 6d 20 74 68 65 20 e name from the
ca60: 0a 2a 2a 20 65 6e 64 20 6f 66 20 74 68 65 20 66 .** end of the f
ca70: 69 6c 65 20 61 6e 64 2c 20 69 66 20 73 75 63 63 ile and, if succ
ca80: 65 73 73 66 75 6c 2c 20 63 6f 70 69 65 73 20 69 essful, copies i
ca90: 74 20 69 6e 74 6f 20 6d 65 6d 6f 72 79 20 73 75 t into memory su
caa0: 70 70 6c 69 65 64 20 0a 2a 2a 20 62 79 20 74 68 pplied .** by th
cab0: 65 20 63 61 6c 6c 65 72 2e 20 53 65 65 20 63 6f e caller. See co
cac0: 6d 6d 65 6e 74 73 20 61 62 6f 76 65 20 77 72 69 mments above wri
cad0: 74 65 4d 61 73 74 65 72 4a 6f 75 72 6e 61 6c 28 teMasterJournal(
cae0: 29 20 66 6f 72 20 74 68 65 20 66 6f 72 6d 61 74 ) for the format
caf0: 0a 2a 2a 20 75 73 65 64 20 74 6f 20 73 74 6f 72 .** used to stor
cb00: 65 20 61 20 6d 61 73 74 65 72 20 6a 6f 75 72 6e e a master journ
cb10: 61 6c 20 66 69 6c 65 20 6e 61 6d 65 20 61 74 20 al file name at
cb20: 74 68 65 20 65 6e 64 20 6f 66 20 61 20 6a 6f 75 the end of a jou
cb30: 72 6e 61 6c 20 66 69 6c 65 2e 0a 2a 2a 0a 2a 2a rnal file..**.**
cb40: 20 7a 4d 61 73 74 65 72 20 6d 75 73 74 20 70 6f zMaster must po
cb50: 69 6e 74 20 74 6f 20 61 20 62 75 66 66 65 72 20 int to a buffer
cb60: 6f 66 20 61 74 20 6c 65 61 73 74 20 6e 4d 61 73 of at least nMas
cb70: 74 65 72 20 62 79 74 65 73 20 61 6c 6c 6f 63 61 ter bytes alloca
cb80: 74 65 64 20 62 79 0a 2a 2a 20 74 68 65 20 63 61 ted by.** the ca
cb90: 6c 6c 65 72 2e 20 54 68 69 73 20 73 68 6f 75 6c ller. This shoul
cba0: 64 20 62 65 20 73 71 6c 69 74 65 33 5f 76 66 73 d be sqlite3_vfs
cbb0: 2e 6d 78 50 61 74 68 6e 61 6d 65 2b 31 20 28 74 .mxPathname+1 (t
cbc0: 6f 20 65 6e 73 75 72 65 20 74 68 65 72 65 20 69 o ensure there i
cbd0: 73 0a 2a 2a 20 65 6e 6f 75 67 68 20 73 70 61 63 s.** enough spac
cbe0: 65 20 74 6f 20 77 72 69 74 65 20 74 68 65 20 6d e to write the m
cbf0: 61 73 74 65 72 20 6a 6f 75 72 6e 61 6c 20 6e 61 aster journal na
cc00: 6d 65 29 2e 20 49 66 20 74 68 65 20 6d 61 73 74 me). If the mast
cc10: 65 72 20 6a 6f 75 72 6e 61 6c 0a 2a 2a 20 6e 61 er journal.** na
cc20: 6d 65 20 69 6e 20 74 68 65 20 6a 6f 75 72 6e 61 me in the journa
cc30: 6c 20 69 73 20 6c 6f 6e 67 65 72 20 74 68 61 6e l is longer than
cc40: 20 6e 4d 61 73 74 65 72 20 62 79 74 65 73 20 28 nMaster bytes (
cc50: 69 6e 63 6c 75 64 69 6e 67 20 61 0a 2a 2a 20 6e including a.** n
cc60: 75 6c 2d 74 65 72 6d 69 6e 61 74 6f 72 29 2c 20 ul-terminator),
cc70: 74 68 65 6e 20 74 68 69 73 20 69 73 20 68 61 6e then this is han
cc80: 64 6c 65 64 20 61 73 20 69 66 20 6e 6f 20 6d 61 dled as if no ma
cc90: 73 74 65 72 20 6a 6f 75 72 6e 61 6c 20 6e 61 6d ster journal nam
cca0: 65 0a 2a 2a 20 77 65 72 65 20 70 72 65 73 65 6e e.** were presen
ccb0: 74 20 69 6e 20 74 68 65 20 6a 6f 75 72 6e 61 6c t in the journal
ccc0: 2e 0a 2a 2a 0a 2a 2a 20 49 66 20 61 20 6d 61 73 ..**.** If a mas
ccd0: 74 65 72 20 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 ter journal file
cce0: 20 6e 61 6d 65 20 69 73 20 70 72 65 73 65 6e 74 name is present
ccf0: 20 61 74 20 74 68 65 20 65 6e 64 20 6f 66 20 74 at the end of t
cd00: 68 65 20 6a 6f 75 72 6e 61 6c 0a 2a 2a 20 66 69 he journal.** fi
cd10: 6c 65 2c 20 74 68 65 6e 20 69 74 20 69 73 20 63 le, then it is c
cd20: 6f 70 69 65 64 20 69 6e 74 6f 20 74 68 65 20 62 opied into the b
cd30: 75 66 66 65 72 20 70 6f 69 6e 74 65 64 20 74 6f uffer pointed to
cd40: 20 62 79 20 7a 4d 61 73 74 65 72 2e 20 41 0a 2a by zMaster. A.*
cd50: 2a 20 6e 75 6c 2d 74 65 72 6d 69 6e 61 74 6f 72 * nul-terminator
cd60: 20 62 79 74 65 20 69 73 20 61 70 70 65 6e 64 65 byte is appende
cd70: 64 20 74 6f 20 74 68 65 20 62 75 66 66 65 72 20 d to the buffer
cd80: 66 6f 6c 6c 6f 77 69 6e 67 20 74 68 65 20 6d 61 following the ma
cd90: 73 74 65 72 0a 2a 2a 20 6a 6f 75 72 6e 61 6c 20 ster.** journal
cda0: 66 69 6c 65 20 6e 61 6d 65 2e 0a 2a 2a 0a 2a 2a file name..**.**
cdb0: 20 49 66 20 69 74 20 69 73 20 64 65 74 65 72 6d If it is determ
cdc0: 69 6e 65 64 20 74 68 61 74 20 6e 6f 20 6d 61 73 ined that no mas
cdd0: 74 65 72 20 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 ter journal file
cde0: 20 6e 61 6d 65 20 69 73 20 70 72 65 73 65 6e 74 name is present
cdf0: 20 0a 2a 2a 20 7a 4d 61 73 74 65 72 5b 30 5d 20 .** zMaster[0]
ce00: 69 73 20 73 65 74 20 74 6f 20 30 20 61 6e 64 20 is set to 0 and
ce10: 53 51 4c 49 54 45 5f 4f 4b 20 72 65 74 75 72 6e SQLITE_OK return
ce20: 65 64 2e 0a 2a 2a 0a 2a 2a 20 49 66 20 61 6e 20 ed..**.** If an
ce30: 65 72 72 6f 72 20 6f 63 63 75 72 73 20 77 68 69 error occurs whi
ce40: 6c 65 20 72 65 61 64 69 6e 67 20 66 72 6f 6d 20 le reading from
ce50: 74 68 65 20 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 the journal file
ce60: 2c 20 61 6e 20 53 51 4c 69 74 65 0a 2a 2a 20 65 , an SQLite.** e
ce70: 72 72 6f 72 20 63 6f 64 65 20 69 73 20 72 65 74 rror code is ret
ce80: 75 72 6e 65 64 2e 0a 2a 2f 0a 73 74 61 74 69 63 urned..*/.static
ce90: 20 69 6e 74 20 72 65 61 64 4d 61 73 74 65 72 4a int readMasterJ
cea0: 6f 75 72 6e 61 6c 28 73 71 6c 69 74 65 33 5f 66 ournal(sqlite3_f
ceb0: 69 6c 65 20 2a 70 4a 72 6e 6c 2c 20 63 68 61 72 ile *pJrnl, char
cec0: 20 2a 7a 4d 61 73 74 65 72 2c 20 75 33 32 20 6e *zMaster, u32 n
ced0: 4d 61 73 74 65 72 29 7b 0a 20 20 69 6e 74 20 72 Master){. int r
cee0: 63 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 c;
cef0: 20 20 20 20 20 20 2f 2a 20 52 65 74 75 72 6e 20 /* Return
cf00: 63 6f 64 65 20 2a 2f 0a 20 20 75 33 32 20 6c 65 code */. u32 le
cf10: 6e 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 n;
cf20: 20 20 20 20 20 2f 2a 20 4c 65 6e 67 74 68 20 69 /* Length i
cf30: 6e 20 62 79 74 65 73 20 6f 66 20 6d 61 73 74 65 n bytes of maste
cf40: 72 20 6a 6f 75 72 6e 61 6c 20 6e 61 6d 65 20 2a r journal name *
cf50: 2f 0a 20 20 69 36 34 20 73 7a 4a 3b 20 20 20 20 /. i64 szJ;
cf60: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f /
cf70: 2a 20 54 6f 74 61 6c 20 73 69 7a 65 20 69 6e 20 * Total size in
cf80: 62 79 74 65 73 20 6f 66 20 6a 6f 75 72 6e 61 6c bytes of journal
cf90: 20 66 69 6c 65 20 70 4a 72 6e 6c 20 2a 2f 0a 20 file pJrnl */.
cfa0: 20 75 33 32 20 63 6b 73 75 6d 3b 20 20 20 20 20 u32 cksum;
cfb0: 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4d /* M
cfc0: 4a 20 63 68 65 63 6b 73 75 6d 20 76 61 6c 75 65 J checksum value
cfd0: 20 72 65 61 64 20 66 72 6f 6d 20 6a 6f 75 72 6e read from journ
cfe0: 61 6c 20 2a 2f 0a 20 20 75 33 32 20 75 3b 20 20 al */. u32 u;
cff0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
d000: 20 20 20 2f 2a 20 55 6e 73 69 67 6e 65 64 20 6c /* Unsigned l
d010: 6f 6f 70 20 63 6f 75 6e 74 65 72 20 2a 2f 0a 20 oop counter */.
d020: 20 75 6e 73 69 67 6e 65 64 20 63 68 61 72 20 61 unsigned char a
d030: 4d 61 67 69 63 5b 38 5d 3b 20 20 20 2f 2a 20 41 Magic[8]; /* A
d040: 20 62 75 66 66 65 72 20 74 6f 20 68 6f 6c 64 20 buffer to hold
d050: 74 68 65 20 6d 61 67 69 63 20 68 65 61 64 65 72 the magic header
d060: 20 2a 2f 0a 20 20 7a 4d 61 73 74 65 72 5b 30 5d */. zMaster[0]
d070: 20 3d 20 27 5c 30 27 3b 0a 0a 20 20 69 66 28 20 = '\0';.. if(
d080: 53 51 4c 49 54 45 5f 4f 4b 21 3d 28 72 63 20 3d SQLITE_OK!=(rc =
d090: 20 73 71 6c 69 74 65 33 4f 73 46 69 6c 65 53 69 sqlite3OsFileSi
d0a0: 7a 65 28 70 4a 72 6e 6c 2c 20 26 73 7a 4a 29 29 ze(pJrnl, &szJ))
d0b0: 0a 20 20 20 7c 7c 20 73 7a 4a 3c 31 36 0a 20 20 . || szJ<16.
d0c0: 20 7c 7c 20 53 51 4c 49 54 45 5f 4f 4b 21 3d 28 || SQLITE_OK!=(
d0d0: 72 63 20 3d 20 72 65 61 64 33 32 62 69 74 73 28 rc = read32bits(
d0e0: 70 4a 72 6e 6c 2c 20 73 7a 4a 2d 31 36 2c 20 26 pJrnl, szJ-16, &
d0f0: 6c 65 6e 29 29 0a 20 20 20 7c 7c 20 6c 65 6e 3e len)). || len>
d100: 3d 6e 4d 61 73 74 65 72 20 0a 20 20 20 7c 7c 20 =nMaster . ||
d110: 6c 65 6e 3d 3d 30 20 0a 20 20 20 7c 7c 20 53 51 len==0 . || SQ
d120: 4c 49 54 45 5f 4f 4b 21 3d 28 72 63 20 3d 20 72 LITE_OK!=(rc = r
d130: 65 61 64 33 32 62 69 74 73 28 70 4a 72 6e 6c 2c ead32bits(pJrnl,
d140: 20 73 7a 4a 2d 31 32 2c 20 26 63 6b 73 75 6d 29 szJ-12, &cksum)
d150: 29 0a 20 20 20 7c 7c 20 53 51 4c 49 54 45 5f 4f ). || SQLITE_O
d160: 4b 21 3d 28 72 63 20 3d 20 73 71 6c 69 74 65 33 K!=(rc = sqlite3
d170: 4f 73 52 65 61 64 28 70 4a 72 6e 6c 2c 20 61 4d OsRead(pJrnl, aM
d180: 61 67 69 63 2c 20 38 2c 20 73 7a 4a 2d 38 29 29 agic, 8, szJ-8))
d190: 0a 20 20 20 7c 7c 20 6d 65 6d 63 6d 70 28 61 4d . || memcmp(aM
d1a0: 61 67 69 63 2c 20 61 4a 6f 75 72 6e 61 6c 4d 61 agic, aJournalMa
d1b0: 67 69 63 2c 20 38 29 0a 20 20 20 7c 7c 20 53 51 gic, 8). || SQ
d1c0: 4c 49 54 45 5f 4f 4b 21 3d 28 72 63 20 3d 20 73 LITE_OK!=(rc = s
d1d0: 71 6c 69 74 65 33 4f 73 52 65 61 64 28 70 4a 72 qlite3OsRead(pJr
d1e0: 6e 6c 2c 20 7a 4d 61 73 74 65 72 2c 20 6c 65 6e nl, zMaster, len
d1f0: 2c 20 73 7a 4a 2d 31 36 2d 6c 65 6e 29 29 0a 20 , szJ-16-len)).
d200: 20 29 7b 0a 20 20 20 20 72 65 74 75 72 6e 20 72 ){. return r
d210: 63 3b 0a 20 20 7d 0a 0a 20 20 2f 2a 20 53 65 65 c;. }.. /* See
d220: 20 69 66 20 74 68 65 20 63 68 65 63 6b 73 75 6d if the checksum
d230: 20 6d 61 74 63 68 65 73 20 74 68 65 20 6d 61 73 matches the mas
d240: 74 65 72 20 6a 6f 75 72 6e 61 6c 20 6e 61 6d 65 ter journal name
d250: 20 2a 2f 0a 20 20 66 6f 72 28 75 3d 30 3b 20 75 */. for(u=0; u
d260: 3c 6c 65 6e 3b 20 75 2b 2b 29 7b 0a 20 20 20 20 <len; u++){.
d270: 63 6b 73 75 6d 20 2d 3d 20 7a 4d 61 73 74 65 72 cksum -= zMaster
d280: 5b 75 5d 3b 0a 20 20 7d 0a 20 20 69 66 28 20 63 [u];. }. if( c
d290: 6b 73 75 6d 20 29 7b 0a 20 20 20 20 2f 2a 20 49 ksum ){. /* I
d2a0: 66 20 74 68 65 20 63 68 65 63 6b 73 75 6d 20 64 f the checksum d
d2b0: 6f 65 73 6e 27 74 20 61 64 64 20 75 70 2c 20 74 oesn't add up, t
d2c0: 68 65 6e 20 6f 6e 65 20 6f 72 20 6d 6f 72 65 20 hen one or more
d2d0: 6f 66 20 74 68 65 20 64 69 73 6b 20 73 65 63 74 of the disk sect
d2e0: 6f 72 73 0a 20 20 20 20 2a 2a 20 63 6f 6e 74 61 ors. ** conta
d2f0: 69 6e 69 6e 67 20 74 68 65 20 6d 61 73 74 65 72 ining the master
d300: 20 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 6e 61 6d journal filenam
d310: 65 20 69 73 20 63 6f 72 72 75 70 74 65 64 2e 20 e is corrupted.
d320: 54 68 69 73 20 6d 65 61 6e 73 0a 20 20 20 20 2a This means. *
d330: 2a 20 64 65 66 69 6e 69 74 65 6c 79 20 72 6f 6c * definitely rol
d340: 6c 20 62 61 63 6b 2c 20 73 6f 20 6a 75 73 74 20 l back, so just
d350: 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b return SQLITE_OK
d360: 20 61 6e 64 20 72 65 70 6f 72 74 20 61 20 28 6e and report a (n
d370: 75 6c 29 0a 20 20 20 20 2a 2a 20 6d 61 73 74 65 ul). ** maste
d380: 72 2d 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 6e 61 r-journal filena
d390: 6d 65 2e 0a 20 20 20 20 2a 2f 0a 20 20 20 20 6c me.. */. l
d3a0: 65 6e 20 3d 20 30 3b 0a 20 20 7d 0a 20 20 7a 4d en = 0;. }. zM
d3b0: 61 73 74 65 72 5b 6c 65 6e 5d 20 3d 20 27 5c 30 aster[len] = '\0
d3c0: 27 3b 0a 20 20 20 0a 20 20 72 65 74 75 72 6e 20 ';. . return
d3d0: 53 51 4c 49 54 45 5f 4f 4b 3b 0a 7d 0a 0a 2f 2a SQLITE_OK;.}../*
d3e0: 0a 2a 2a 20 52 65 74 75 72 6e 20 74 68 65 20 6f .** Return the o
d3f0: 66 66 73 65 74 20 6f 66 20 74 68 65 20 73 65 63 ffset of the sec
d400: 74 6f 72 20 62 6f 75 6e 64 61 72 79 20 61 74 20 tor boundary at
d410: 6f 72 20 69 6d 6d 65 64 69 61 74 65 6c 79 20 0a or immediately .
d420: 2a 2a 20 66 6f 6c 6c 6f 77 69 6e 67 20 74 68 65 ** following the
d430: 20 76 61 6c 75 65 20 69 6e 20 70 50 61 67 65 72 value in pPager
d440: 2d 3e 6a 6f 75 72 6e 61 6c 4f 66 66 2c 20 61 73 ->journalOff, as
d450: 73 75 6d 69 6e 67 20 61 20 73 65 63 74 6f 72 20 suming a sector
d460: 0a 2a 2a 20 73 69 7a 65 20 6f 66 20 70 50 61 67 .** size of pPag
d470: 65 72 2d 3e 73 65 63 74 6f 72 53 69 7a 65 20 62 er->sectorSize b
d480: 79 74 65 73 2e 0a 2a 2a 0a 2a 2a 20 69 2e 65 20 ytes..**.** i.e
d490: 66 6f 72 20 61 20 73 65 63 74 6f 72 20 73 69 7a for a sector siz
d4a0: 65 20 6f 66 20 35 31 32 3a 0a 2a 2a 0a 2a 2a 20 e of 512:.**.**
d4b0: 20 20 50 61 67 65 72 2e 6a 6f 75 72 6e 61 6c 4f Pager.journalO
d4c0: 66 66 20 20 20 20 20 20 20 20 20 20 52 65 74 75 ff Retu
d4d0: 72 6e 20 76 61 6c 75 65 0a 2a 2a 20 20 20 2d 2d rn value.** --
d4e0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
d4f0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
d500: 2d 2d 2d 2d 2d 0a 2a 2a 20 20 20 30 20 20 20 20 -----.** 0
d510: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
d520: 20 20 20 20 20 30 0a 2a 2a 20 20 20 35 31 32 20 0.** 512
d530: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
d540: 20 20 20 20 20 20 35 31 32 0a 2a 2a 20 20 20 31 512.** 1
d550: 30 30 20 20 20 20 20 20 20 20 20 20 20 20 20 20 00
d560: 20 20 20 20 20 20 20 20 20 35 31 32 0a 2a 2a 20 512.**
d570: 20 20 32 30 30 30 20 20 20 20 20 20 20 20 20 20 2000
d580: 20 20 20 20 20 20 20 20 20 20 20 20 32 30 34 38 2048
d590: 0a 2a 2a 20 0a 2a 2f 0a 73 74 61 74 69 63 20 69 .** .*/.static i
d5a0: 36 34 20 6a 6f 75 72 6e 61 6c 48 64 72 4f 66 66 64 journalHdrOff
d5b0: 73 65 74 28 50 61 67 65 72 20 2a 70 50 61 67 65 set(Pager *pPage
d5c0: 72 29 7b 0a 20 20 69 36 34 20 6f 66 66 73 65 74 r){. i64 offset
d5d0: 20 3d 20 30 3b 0a 20 20 69 36 34 20 63 20 3d 20 = 0;. i64 c =
d5e0: 70 50 61 67 65 72 2d 3e 6a 6f 75 72 6e 61 6c 4f pPager->journalO
d5f0: 66 66 3b 0a 20 20 69 66 28 20 63 20 29 7b 0a 20 ff;. if( c ){.
d600: 20 20 20 6f 66 66 73 65 74 20 3d 20 28 28 63 2d offset = ((c-
d610: 31 29 2f 4a 4f 55 52 4e 41 4c 5f 48 44 52 5f 53 1)/JOURNAL_HDR_S
d620: 5a 28 70 50 61 67 65 72 29 20 2b 20 31 29 20 2a Z(pPager) + 1) *
d630: 20 4a 4f 55 52 4e 41 4c 5f 48 44 52 5f 53 5a 28 JOURNAL_HDR_SZ(
d640: 70 50 61 67 65 72 29 3b 0a 20 20 7d 0a 20 20 61 pPager);. }. a
d650: 73 73 65 72 74 28 20 6f 66 66 73 65 74 25 4a 4f ssert( offset%JO
d660: 55 52 4e 41 4c 5f 48 44 52 5f 53 5a 28 70 50 61 URNAL_HDR_SZ(pPa
d670: 67 65 72 29 3d 3d 30 20 29 3b 0a 20 20 61 73 73 ger)==0 );. ass
d680: 65 72 74 28 20 6f 66 66 73 65 74 3e 3d 63 20 29 ert( offset>=c )
d690: 3b 0a 20 20 61 73 73 65 72 74 28 20 28 6f 66 66 ;. assert( (off
d6a0: 73 65 74 2d 63 29 3c 4a 4f 55 52 4e 41 4c 5f 48 set-c)<JOURNAL_H
d6b0: 44 52 5f 53 5a 28 70 50 61 67 65 72 29 20 29 3b DR_SZ(pPager) );
d6c0: 0a 20 20 72 65 74 75 72 6e 20 6f 66 66 73 65 74 . return offset
d6d0: 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 54 68 65 20 6a ;.}../*.** The j
d6e0: 6f 75 72 6e 61 6c 20 66 69 6c 65 20 6d 75 73 74 ournal file must
d6f0: 20 62 65 20 6f 70 65 6e 20 77 68 65 6e 20 74 68 be open when th
d700: 69 73 20 66 75 6e 63 74 69 6f 6e 20 69 73 20 63 is function is c
d710: 61 6c 6c 65 64 2e 0a 2a 2a 0a 2a 2a 20 54 68 69 alled..**.** Thi
d720: 73 20 66 75 6e 63 74 69 6f 6e 20 69 73 20 61 20 s function is a
d730: 6e 6f 2d 6f 70 20 69 66 20 74 68 65 20 6a 6f 75 no-op if the jou
d740: 72 6e 61 6c 20 66 69 6c 65 20 68 61 73 20 6e 6f rnal file has no
d750: 74 20 62 65 65 6e 20 77 72 69 74 74 65 6e 20 74 t been written t
d760: 6f 0a 2a 2a 20 77 69 74 68 69 6e 20 74 68 65 20 o.** within the
d770: 63 75 72 72 65 6e 74 20 74 72 61 6e 73 61 63 74 current transact
d780: 69 6f 6e 20 28 69 2e 65 2e 20 69 66 20 50 61 67 ion (i.e. if Pag
d790: 65 72 2e 6a 6f 75 72 6e 61 6c 4f 66 66 3d 3d 30 er.journalOff==0
d7a0: 29 2e 0a 2a 2a 0a 2a 2a 20 49 66 20 64 6f 54 72 )..**.** If doTr
d7b0: 75 6e 63 61 74 65 20 69 73 20 6e 6f 6e 2d 7a 65 uncate is non-ze
d7c0: 72 6f 20 6f 72 20 74 68 65 20 50 61 67 65 72 2e ro or the Pager.
d7d0: 6a 6f 75 72 6e 61 6c 53 69 7a 65 4c 69 6d 69 74 journalSizeLimit
d7e0: 20 76 61 72 69 61 62 6c 65 20 69 73 0a 2a 2a 20 variable is.**
d7f0: 73 65 74 20 74 6f 20 30 2c 20 74 68 65 6e 20 74 set to 0, then t
d800: 72 75 6e 63 61 74 65 20 74 68 65 20 6a 6f 75 72 runcate the jour
d810: 6e 61 6c 20 66 69 6c 65 20 74 6f 20 7a 65 72 6f nal file to zero
d820: 20 62 79 74 65 73 20 69 6e 20 73 69 7a 65 2e 20 bytes in size.
d830: 4f 74 68 65 72 77 69 73 65 2c 0a 2a 2a 20 7a 65 Otherwise,.** ze
d840: 72 6f 20 74 68 65 20 32 38 2d 62 79 74 65 20 68 ro the 28-byte h
d850: 65 61 64 65 72 20 61 74 20 74 68 65 20 73 74 61 eader at the sta
d860: 72 74 20 6f 66 20 74 68 65 20 6a 6f 75 72 6e 61 rt of the journa
d870: 6c 20 66 69 6c 65 2e 20 49 6e 20 65 69 74 68 65 l file. In eithe
d880: 72 20 63 61 73 65 2c 20 0a 2a 2a 20 69 66 20 74 r case, .** if t
d890: 68 65 20 70 61 67 65 72 20 69 73 20 6e 6f 74 20 he pager is not
d8a0: 69 6e 20 6e 6f 2d 73 79 6e 63 20 6d 6f 64 65 2c in no-sync mode,
d8b0: 20 73 79 6e 63 20 74 68 65 20 6a 6f 75 72 6e 61 sync the journa
d8c0: 6c 20 66 69 6c 65 20 69 6d 6d 65 64 69 61 74 65 l file immediate
d8d0: 6c 79 20 0a 2a 2a 20 61 66 74 65 72 20 77 72 69 ly .** after wri
d8e0: 74 69 6e 67 20 6f 72 20 74 72 75 6e 63 61 74 69 ting or truncati
d8f0: 6e 67 20 69 74 2e 0a 2a 2a 0a 2a 2a 20 49 66 20 ng it..**.** If
d900: 50 61 67 65 72 2e 6a 6f 75 72 6e 61 6c 53 69 7a Pager.journalSiz
d910: 65 4c 69 6d 69 74 20 69 73 20 73 65 74 20 74 6f eLimit is set to
d920: 20 61 20 70 6f 73 69 74 69 76 65 2c 20 6e 6f 6e a positive, non
d930: 2d 7a 65 72 6f 20 76 61 6c 75 65 2c 20 61 6e 64 -zero value, and
d940: 0a 2a 2a 20 66 6f 6c 6c 6f 77 69 6e 67 20 74 68 .** following th
d950: 65 20 74 72 75 6e 63 61 74 69 6f 6e 20 6f 72 20 e truncation or
d960: 7a 65 72 6f 69 6e 67 20 64 65 73 63 72 69 62 65 zeroing describe
d970: 64 20 61 62 6f 76 65 20 74 68 65 20 73 69 7a 65 d above the size
d980: 20 6f 66 20 74 68 65 20 0a 2a 2a 20 6a 6f 75 72 of the .** jour
d990: 6e 61 6c 20 66 69 6c 65 20 69 6e 20 62 79 74 65 nal file in byte
d9a0: 73 20 69 73 20 6c 61 72 67 65 72 20 74 68 61 6e s is larger than
d9b0: 20 74 68 69 73 20 76 61 6c 75 65 2c 20 74 68 65 this value, the
d9c0: 6e 20 74 72 75 6e 63 61 74 65 20 74 68 65 0a 2a n truncate the.*
d9d0: 2a 20 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 20 74 * journal file t
d9e0: 6f 20 50 61 67 65 72 2e 6a 6f 75 72 6e 61 6c 53 o Pager.journalS
d9f0: 69 7a 65 4c 69 6d 69 74 20 62 79 74 65 73 2e 20 izeLimit bytes.
da00: 54 68 65 20 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 The journal file
da10: 20 64 6f 65 73 0a 2a 2a 20 6e 6f 74 20 6e 65 65 does.** not nee
da20: 64 20 74 6f 20 62 65 20 73 79 6e 63 65 64 20 66 d to be synced f
da30: 6f 6c 6c 6f 77 69 6e 67 20 74 68 69 73 20 6f 70 ollowing this op
da40: 65 72 61 74 69 6f 6e 2e 0a 2a 2a 0a 2a 2a 20 49 eration..**.** I
da50: 66 20 61 6e 20 49 4f 20 65 72 72 6f 72 20 6f 63 f an IO error oc
da60: 63 75 72 73 2c 20 61 62 61 6e 64 6f 6e 20 70 72 curs, abandon pr
da70: 6f 63 65 73 73 69 6e 67 20 61 6e 64 20 72 65 74 ocessing and ret
da80: 75 72 6e 20 74 68 65 20 49 4f 20 65 72 72 6f 72 urn the IO error
da90: 20 63 6f 64 65 2e 0a 2a 2a 20 4f 74 68 65 72 77 code..** Otherw
daa0: 69 73 65 2c 20 72 65 74 75 72 6e 20 53 51 4c 49 ise, return SQLI
dab0: 54 45 5f 4f 4b 2e 0a 2a 2f 0a 73 74 61 74 69 63 TE_OK..*/.static
dac0: 20 69 6e 74 20 7a 65 72 6f 4a 6f 75 72 6e 61 6c int zeroJournal
dad0: 48 64 72 28 50 61 67 65 72 20 2a 70 50 61 67 65 Hdr(Pager *pPage
dae0: 72 2c 20 69 6e 74 20 64 6f 54 72 75 6e 63 61 74 r, int doTruncat
daf0: 65 29 7b 0a 20 20 69 6e 74 20 72 63 20 3d 20 53 e){. int rc = S
db00: 51 4c 49 54 45 5f 4f 4b 3b 20 20 20 20 20 20 20 QLITE_OK;
db10: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
db20: 20 20 20 20 20 20 20 20 2f 2a 20 52 65 74 75 72 /* Retur
db30: 6e 20 63 6f 64 65 20 2a 2f 0a 20 20 61 73 73 65 n code */. asse
db40: 72 74 28 20 69 73 4f 70 65 6e 28 70 50 61 67 65 rt( isOpen(pPage
db50: 72 2d 3e 6a 66 64 29 20 29 3b 0a 20 20 61 73 73 r->jfd) );. ass
db60: 65 72 74 28 20 21 73 71 6c 69 74 65 33 4a 6f 75 ert( !sqlite3Jou
db70: 72 6e 61 6c 49 73 49 6e 4d 65 6d 6f 72 79 28 70 rnalIsInMemory(p
db80: 50 61 67 65 72 2d 3e 6a 66 64 29 20 29 3b 0a 20 Pager->jfd) );.
db90: 20 69 66 28 20 70 50 61 67 65 72 2d 3e 6a 6f 75 if( pPager->jou
dba0: 72 6e 61 6c 4f 66 66 20 29 7b 0a 20 20 20 20 63 rnalOff ){. c
dbb0: 6f 6e 73 74 20 69 36 34 20 69 4c 69 6d 69 74 20 onst i64 iLimit
dbc0: 3d 20 70 50 61 67 65 72 2d 3e 6a 6f 75 72 6e 61 = pPager->journa
dbd0: 6c 53 69 7a 65 4c 69 6d 69 74 3b 20 20 20 20 2f lSizeLimit; /
dbe0: 2a 20 4c 6f 63 61 6c 20 63 61 63 68 65 20 6f 66 * Local cache of
dbf0: 20 6a 73 6c 20 2a 2f 0a 0a 20 20 20 20 49 4f 54 jsl */.. IOT
dc00: 52 41 43 45 28 28 22 4a 5a 45 52 4f 48 44 52 20 RACE(("JZEROHDR
dc10: 25 70 5c 6e 22 2c 20 70 50 61 67 65 72 29 29 0a %p\n", pPager)).
dc20: 20 20 20 20 69 66 28 20 64 6f 54 72 75 6e 63 61 if( doTrunca
dc30: 74 65 20 7c 7c 20 69 4c 69 6d 69 74 3d 3d 30 20 te || iLimit==0
dc40: 29 7b 0a 20 20 20 20 20 20 72 63 20 3d 20 73 71 ){. rc = sq
dc50: 6c 69 74 65 33 4f 73 54 72 75 6e 63 61 74 65 28 lite3OsTruncate(
dc60: 70 50 61 67 65 72 2d 3e 6a 66 64 2c 20 30 29 3b pPager->jfd, 0);
dc70: 0a 20 20 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 . }else{.
dc80: 20 20 73 74 61 74 69 63 20 63 6f 6e 73 74 20 63 static const c
dc90: 68 61 72 20 7a 65 72 6f 48 64 72 5b 32 38 5d 20 har zeroHdr[28]
dca0: 3d 20 7b 30 7d 3b 0a 20 20 20 20 20 20 72 63 20 = {0};. rc
dcb0: 3d 20 73 71 6c 69 74 65 33 4f 73 57 72 69 74 65 = sqlite3OsWrite
dcc0: 28 70 50 61 67 65 72 2d 3e 6a 66 64 2c 20 7a 65 (pPager->jfd, ze
dcd0: 72 6f 48 64 72 2c 20 73 69 7a 65 6f 66 28 7a 65 roHdr, sizeof(ze
dce0: 72 6f 48 64 72 29 2c 20 30 29 3b 0a 20 20 20 20 roHdr), 0);.
dcf0: 7d 0a 20 20 20 20 69 66 28 20 72 63 3d 3d 53 51 }. if( rc==SQ
dd00: 4c 49 54 45 5f 4f 4b 20 26 26 20 21 70 50 61 67 LITE_OK && !pPag
dd10: 65 72 2d 3e 6e 6f 53 79 6e 63 20 29 7b 0a 20 20 er->noSync ){.
dd20: 20 20 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33 rc = sqlite3
dd30: 4f 73 53 79 6e 63 28 70 50 61 67 65 72 2d 3e 6a OsSync(pPager->j
dd40: 66 64 2c 20 53 51 4c 49 54 45 5f 53 59 4e 43 5f fd, SQLITE_SYNC_
dd50: 44 41 54 41 4f 4e 4c 59 7c 70 50 61 67 65 72 2d DATAONLY|pPager-
dd60: 3e 73 79 6e 63 46 6c 61 67 73 29 3b 0a 20 20 20 >syncFlags);.
dd70: 20 7d 0a 0a 20 20 20 20 2f 2a 20 41 74 20 74 68 }.. /* At th
dd80: 69 73 20 70 6f 69 6e 74 20 74 68 65 20 74 72 61 is point the tra
dd90: 6e 73 61 63 74 69 6f 6e 20 69 73 20 63 6f 6d 6d nsaction is comm
dda0: 69 74 74 65 64 20 62 75 74 20 74 68 65 20 77 72 itted but the wr
ddb0: 69 74 65 20 6c 6f 63 6b 20 0a 20 20 20 20 2a 2a ite lock . **
ddc0: 20 69 73 20 73 74 69 6c 6c 20 68 65 6c 64 20 6f is still held o
ddd0: 6e 20 74 68 65 20 66 69 6c 65 2e 20 49 66 20 74 n the file. If t
dde0: 68 65 72 65 20 69 73 20 61 20 73 69 7a 65 20 6c here is a size l
ddf0: 69 6d 69 74 20 63 6f 6e 66 69 67 75 72 65 64 20 imit configured
de00: 66 6f 72 20 0a 20 20 20 20 2a 2a 20 74 68 65 20 for . ** the
de10: 70 65 72 73 69 73 74 65 6e 74 20 6a 6f 75 72 6e persistent journ
de20: 61 6c 20 61 6e 64 20 74 68 65 20 6a 6f 75 72 6e al and the journ
de30: 61 6c 20 66 69 6c 65 20 63 75 72 72 65 6e 74 6c al file currentl
de40: 79 20 63 6f 6e 73 75 6d 65 73 20 6d 6f 72 65 0a y consumes more.
de50: 20 20 20 20 2a 2a 20 73 70 61 63 65 20 74 68 61 ** space tha
de60: 6e 20 74 68 61 74 20 6c 69 6d 69 74 20 61 6c 6c n that limit all
de70: 6f 77 73 20 66 6f 72 2c 20 74 72 75 6e 63 61 74 ows for, truncat
de80: 65 20 69 74 20 6e 6f 77 2e 20 54 68 65 72 65 20 e it now. There
de90: 69 73 20 6e 6f 20 6e 65 65 64 0a 20 20 20 20 2a is no need. *
dea0: 2a 20 74 6f 20 73 79 6e 63 20 74 68 65 20 66 69 * to sync the fi
deb0: 6c 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 74 68 69 le following thi
dec0: 73 20 6f 70 65 72 61 74 69 6f 6e 2e 0a 20 20 20 s operation..
ded0: 20 2a 2f 0a 20 20 20 20 69 66 28 20 72 63 3d 3d */. if( rc==
dee0: 53 51 4c 49 54 45 5f 4f 4b 20 26 26 20 69 4c 69 SQLITE_OK && iLi
def0: 6d 69 74 3e 30 20 29 7b 0a 20 20 20 20 20 20 69 mit>0 ){. i
df00: 36 34 20 73 7a 3b 0a 20 20 20 20 20 20 72 63 20 64 sz;. rc
df10: 3d 20 73 71 6c 69 74 65 33 4f 73 46 69 6c 65 53 = sqlite3OsFileS
df20: 69 7a 65 28 70 50 61 67 65 72 2d 3e 6a 66 64 2c ize(pPager->jfd,
df30: 20 26 73 7a 29 3b 0a 20 20 20 20 20 20 69 66 28 &sz);. if(
df40: 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 26 rc==SQLITE_OK &
df50: 26 20 73 7a 3e 69 4c 69 6d 69 74 20 29 7b 0a 20 & sz>iLimit ){.
df60: 20 20 20 20 20 20 20 72 63 20 3d 20 73 71 6c 69 rc = sqli
df70: 74 65 33 4f 73 54 72 75 6e 63 61 74 65 28 70 50 te3OsTruncate(pP
df80: 61 67 65 72 2d 3e 6a 66 64 2c 20 69 4c 69 6d 69 ager->jfd, iLimi
df90: 74 29 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 t);. }.
dfa0: 7d 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e 20 72 }. }. return r
dfb0: 63 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 54 68 65 20 c;.}../*.** The
dfc0: 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 20 6d 75 73 journal file mus
dfd0: 74 20 62 65 20 6f 70 65 6e 20 77 68 65 6e 20 74 t be open when t
dfe0: 68 69 73 20 72 6f 75 74 69 6e 65 20 69 73 20 63 his routine is c
dff0: 61 6c 6c 65 64 2e 20 41 20 6a 6f 75 72 6e 61 6c alled. A journal
e000: 0a 2a 2a 20 68 65 61 64 65 72 20 28 4a 4f 55 52 .** header (JOUR
e010: 4e 41 4c 5f 48 44 52 5f 53 5a 20 62 79 74 65 73 NAL_HDR_SZ bytes
e020: 29 20 69 73 20 77 72 69 74 74 65 6e 20 69 6e 74 ) is written int
e030: 6f 20 74 68 65 20 6a 6f 75 72 6e 61 6c 20 66 69 o the journal fi
e040: 6c 65 20 61 74 20 74 68 65 0a 2a 2a 20 63 75 72 le at the.** cur
e050: 72 65 6e 74 20 6c 6f 63 61 74 69 6f 6e 2e 0a 2a rent location..*
e060: 2a 0a 2a 2a 20 54 68 65 20 66 6f 72 6d 61 74 20 *.** The format
e070: 66 6f 72 20 74 68 65 20 6a 6f 75 72 6e 61 6c 20 for the journal
e080: 68 65 61 64 65 72 20 69 73 20 61 73 20 66 6f 6c header is as fol
e090: 6c 6f 77 73 3a 0a 2a 2a 20 2d 20 38 20 62 79 74 lows:.** - 8 byt
e0a0: 65 73 3a 20 4d 61 67 69 63 20 69 64 65 6e 74 69 es: Magic identi
e0b0: 66 79 69 6e 67 20 6a 6f 75 72 6e 61 6c 20 66 6f fying journal fo
e0c0: 72 6d 61 74 2e 0a 2a 2a 20 2d 20 34 20 62 79 74 rmat..** - 4 byt
e0d0: 65 73 3a 20 4e 75 6d 62 65 72 20 6f 66 20 72 65 es: Number of re
e0e0: 63 6f 72 64 73 20 69 6e 20 6a 6f 75 72 6e 61 6c cords in journal
e0f0: 2c 20 6f 72 20 2d 31 20 6e 6f 2d 73 79 6e 63 20 , or -1 no-sync
e100: 6d 6f 64 65 20 69 73 20 6f 6e 2e 0a 2a 2a 20 2d mode is on..** -
e110: 20 34 20 62 79 74 65 73 3a 20 52 61 6e 64 6f 6d 4 bytes: Random
e120: 20 6e 75 6d 62 65 72 20 75 73 65 64 20 66 6f 72 number used for
e130: 20 70 61 67 65 20 68 61 73 68 2e 0a 2a 2a 20 2d page hash..** -
e140: 20 34 20 62 79 74 65 73 3a 20 49 6e 69 74 69 61 4 bytes: Initia
e150: 6c 20 64 61 74 61 62 61 73 65 20 70 61 67 65 20 l database page
e160: 63 6f 75 6e 74 2e 0a 2a 2a 20 2d 20 34 20 62 79 count..** - 4 by
e170: 74 65 73 3a 20 53 65 63 74 6f 72 20 73 69 7a 65 tes: Sector size
e180: 20 75 73 65 64 20 62 79 20 74 68 65 20 70 72 6f used by the pro
e190: 63 65 73 73 20 74 68 61 74 20 77 72 6f 74 65 20 cess that wrote
e1a0: 74 68 69 73 20 6a 6f 75 72 6e 61 6c 2e 0a 2a 2a this journal..**
e1b0: 20 2d 20 34 20 62 79 74 65 73 3a 20 44 61 74 61 - 4 bytes: Data
e1c0: 62 61 73 65 20 70 61 67 65 20 73 69 7a 65 2e 0a base page size..
e1d0: 2a 2a 20 0a 2a 2a 20 46 6f 6c 6c 6f 77 65 64 20 ** .** Followed
e1e0: 62 79 20 28 4a 4f 55 52 4e 41 4c 5f 48 44 52 5f by (JOURNAL_HDR_
e1f0: 53 5a 20 2d 20 32 38 29 20 62 79 74 65 73 20 6f SZ - 28) bytes o
e200: 66 20 75 6e 75 73 65 64 20 73 70 61 63 65 2e 0a f unused space..
e210: 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74 20 77 72 */.static int wr
e220: 69 74 65 4a 6f 75 72 6e 61 6c 48 64 72 28 50 61 iteJournalHdr(Pa
e230: 67 65 72 20 2a 70 50 61 67 65 72 29 7b 0a 20 20 ger *pPager){.
e240: 69 6e 74 20 72 63 20 3d 20 53 51 4c 49 54 45 5f int rc = SQLITE_
e250: 4f 4b 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 OK;
e260: 20 20 20 20 2f 2a 20 52 65 74 75 72 6e 20 63 6f /* Return co
e270: 64 65 20 2a 2f 0a 20 20 63 68 61 72 20 2a 7a 48 de */. char *zH
e280: 65 61 64 65 72 20 3d 20 70 50 61 67 65 72 2d 3e eader = pPager->
e290: 70 54 6d 70 53 70 61 63 65 3b 20 20 2f 2a 20 54 pTmpSpace; /* T
e2a0: 65 6d 70 6f 72 61 72 79 20 73 70 61 63 65 20 75 emporary space u
e2b0: 73 65 64 20 74 6f 20 62 75 69 6c 64 20 68 65 61 sed to build hea
e2c0: 64 65 72 20 2a 2f 0a 20 20 75 33 32 20 6e 48 65 der */. u32 nHe
e2d0: 61 64 65 72 20 3d 20 28 75 33 32 29 70 50 61 67 ader = (u32)pPag
e2e0: 65 72 2d 3e 70 61 67 65 53 69 7a 65 3b 2f 2a 20 er->pageSize;/*
e2f0: 53 69 7a 65 20 6f 66 20 62 75 66 66 65 72 20 70 Size of buffer p
e300: 6f 69 6e 74 65 64 20 74 6f 20 62 79 20 7a 48 65 ointed to by zHe
e310: 61 64 65 72 20 2a 2f 0a 20 20 75 33 32 20 6e 57 ader */. u32 nW
e320: 72 69 74 65 3b 20 20 20 20 20 20 20 20 20 20 20 rite;
e330: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a /*
e340: 20 42 79 74 65 73 20 6f 66 20 68 65 61 64 65 72 Bytes of header
e350: 20 73 65 63 74 6f 72 20 77 72 69 74 74 65 6e 20 sector written
e360: 2a 2f 0a 20 20 69 6e 74 20 69 69 3b 20 20 20 20 */. int ii;
e370: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
e380: 20 20 20 20 20 20 20 20 20 2f 2a 20 4c 6f 6f 70 /* Loop
e390: 20 63 6f 75 6e 74 65 72 20 2a 2f 0a 0a 20 20 61 counter */.. a
e3a0: 73 73 65 72 74 28 20 69 73 4f 70 65 6e 28 70 50 ssert( isOpen(pP
e3b0: 61 67 65 72 2d 3e 6a 66 64 29 20 29 3b 20 20 20 ager->jfd) );
e3c0: 20 20 20 2f 2a 20 4a 6f 75 72 6e 61 6c 20 66 69 /* Journal fi
e3d0: 6c 65 20 6d 75 73 74 20 62 65 20 6f 70 65 6e 2e le must be open.
e3e0: 20 2a 2f 0a 0a 20 20 69 66 28 20 6e 48 65 61 64 */.. if( nHead
e3f0: 65 72 3e 4a 4f 55 52 4e 41 4c 5f 48 44 52 5f 53 er>JOURNAL_HDR_S
e400: 5a 28 70 50 61 67 65 72 29 20 29 7b 0a 20 20 20 Z(pPager) ){.
e410: 20 6e 48 65 61 64 65 72 20 3d 20 4a 4f 55 52 4e nHeader = JOURN
e420: 41 4c 5f 48 44 52 5f 53 5a 28 70 50 61 67 65 72 AL_HDR_SZ(pPager
e430: 29 3b 0a 20 20 7d 0a 0a 20 20 2f 2a 20 49 66 20 );. }.. /* If
e440: 74 68 65 72 65 20 61 72 65 20 61 63 74 69 76 65 there are active
e450: 20 73 61 76 65 70 6f 69 6e 74 73 20 61 6e 64 20 savepoints and
e460: 61 6e 79 20 6f 66 20 74 68 65 6d 20 77 65 72 65 any of them were
e470: 20 63 72 65 61 74 65 64 20 0a 20 20 2a 2a 20 73 created . ** s
e480: 69 6e 63 65 20 74 68 65 20 6d 6f 73 74 20 72 65 ince the most re
e490: 63 65 6e 74 20 6a 6f 75 72 6e 61 6c 20 68 65 61 cent journal hea
e4a0: 64 65 72 20 77 61 73 20 77 72 69 74 74 65 6e 2c der was written,
e4b0: 20 75 70 64 61 74 65 20 74 68 65 20 0a 20 20 2a update the . *
e4c0: 2a 20 50 61 67 65 72 53 61 76 65 70 6f 69 6e 74 * PagerSavepoint
e4d0: 2e 69 48 64 72 4f 66 66 73 65 74 20 66 69 65 6c .iHdrOffset fiel
e4e0: 64 73 20 6e 6f 77 2e 0a 20 20 2a 2f 0a 20 20 66 ds now.. */. f
e4f0: 6f 72 28 69 69 3d 30 3b 20 69 69 3c 70 50 61 67 or(ii=0; ii<pPag
e500: 65 72 2d 3e 6e 53 61 76 65 70 6f 69 6e 74 3b 20 er->nSavepoint;
e510: 69 69 2b 2b 29 7b 0a 20 20 20 20 69 66 28 20 70 ii++){. if( p
e520: 50 61 67 65 72 2d 3e 61 53 61 76 65 70 6f 69 6e Pager->aSavepoin
e530: 74 5b 69 69 5d 2e 69 48 64 72 4f 66 66 73 65 74 t[ii].iHdrOffset
e540: 3d 3d 30 20 29 7b 0a 20 20 20 20 20 20 70 50 61 ==0 ){. pPa
e550: 67 65 72 2d 3e 61 53 61 76 65 70 6f 69 6e 74 5b ger->aSavepoint[
e560: 69 69 5d 2e 69 48 64 72 4f 66 66 73 65 74 20 3d ii].iHdrOffset =
e570: 20 70 50 61 67 65 72 2d 3e 6a 6f 75 72 6e 61 6c pPager->journal
e580: 4f 66 66 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a 0a Off;. }. }..
e590: 20 20 70 50 61 67 65 72 2d 3e 6a 6f 75 72 6e 61 pPager->journa
e5a0: 6c 48 64 72 20 3d 20 70 50 61 67 65 72 2d 3e 6a lHdr = pPager->j
e5b0: 6f 75 72 6e 61 6c 4f 66 66 20 3d 20 6a 6f 75 72 ournalOff = jour
e5c0: 6e 61 6c 48 64 72 4f 66 66 73 65 74 28 70 50 61 nalHdrOffset(pPa
e5d0: 67 65 72 29 3b 0a 0a 20 20 2f 2a 20 0a 20 20 2a ger);.. /* . *
e5e0: 2a 20 57 72 69 74 65 20 74 68 65 20 6e 52 65 63 * Write the nRec
e5f0: 20 46 69 65 6c 64 20 2d 20 74 68 65 20 6e 75 6d Field - the num
e600: 62 65 72 20 6f 66 20 70 61 67 65 20 72 65 63 6f ber of page reco
e610: 72 64 73 20 74 68 61 74 20 66 6f 6c 6c 6f 77 20 rds that follow
e620: 74 68 69 73 0a 20 20 2a 2a 20 6a 6f 75 72 6e 61 this. ** journa
e630: 6c 20 68 65 61 64 65 72 2e 20 4e 6f 72 6d 61 6c l header. Normal
e640: 6c 79 2c 20 7a 65 72 6f 20 69 73 20 77 72 69 74 ly, zero is writ
e650: 74 65 6e 20 74 6f 20 74 68 69 73 20 76 61 6c 75 ten to this valu
e660: 65 20 61 74 20 74 68 69 73 20 74 69 6d 65 2e 0a e at this time..
e670: 20 20 2a 2a 20 41 66 74 65 72 20 74 68 65 20 72 ** After the r
e680: 65 63 6f 72 64 73 20 61 72 65 20 61 64 64 65 64 ecords are added
e690: 20 74 6f 20 74 68 65 20 6a 6f 75 72 6e 61 6c 20 to the journal
e6a0: 28 61 6e 64 20 74 68 65 20 6a 6f 75 72 6e 61 6c (and the journal
e6b0: 20 73 79 6e 63 65 64 2c 20 0a 20 20 2a 2a 20 69 synced, . ** i
e6c0: 66 20 69 6e 20 66 75 6c 6c 2d 73 79 6e 63 20 6d f in full-sync m
e6d0: 6f 64 65 29 2c 20 74 68 65 20 7a 65 72 6f 20 69 ode), the zero i
e6e0: 73 20 6f 76 65 72 77 72 69 74 74 65 6e 20 77 69 s overwritten wi
e6f0: 74 68 20 74 68 65 20 74 72 75 65 20 6e 75 6d 62 th the true numb
e700: 65 72 0a 20 20 2a 2a 20 6f 66 20 72 65 63 6f 72 er. ** of recor
e710: 64 73 20 28 73 65 65 20 73 79 6e 63 4a 6f 75 72 ds (see syncJour
e720: 6e 61 6c 28 29 29 2e 0a 20 20 2a 2a 0a 20 20 2a nal()).. **. *
e730: 2a 20 41 20 66 61 73 74 65 72 20 61 6c 74 65 72 * A faster alter
e740: 6e 61 74 69 76 65 20 69 73 20 74 6f 20 77 72 69 native is to wri
e750: 74 65 20 30 78 46 46 46 46 46 46 46 46 20 74 6f te 0xFFFFFFFF to
e760: 20 74 68 65 20 6e 52 65 63 20 66 69 65 6c 64 2e the nRec field.
e770: 20 57 68 65 6e 0a 20 20 2a 2a 20 72 65 61 64 69 When. ** readi
e780: 6e 67 20 74 68 65 20 6a 6f 75 72 6e 61 6c 20 74 ng the journal t
e790: 68 69 73 20 76 61 6c 75 65 20 74 65 6c 6c 73 20 his value tells
e7a0: 53 51 4c 69 74 65 20 74 6f 20 61 73 73 75 6d 65 SQLite to assume
e7b0: 20 74 68 61 74 20 74 68 65 0a 20 20 2a 2a 20 72 that the. ** r
e7c0: 65 73 74 20 6f 66 20 74 68 65 20 6a 6f 75 72 6e est of the journ
e7d0: 61 6c 20 66 69 6c 65 20 63 6f 6e 74 61 69 6e 73 al file contains
e7e0: 20 76 61 6c 69 64 20 70 61 67 65 20 72 65 63 6f valid page reco
e7f0: 72 64 73 2e 20 54 68 69 73 20 61 73 73 75 6d 70 rds. This assump
e800: 74 69 6f 6e 0a 20 20 2a 2a 20 69 73 20 64 61 6e tion. ** is dan
e810: 67 65 72 6f 75 73 2c 20 61 73 20 69 66 20 61 20 gerous, as if a
e820: 66 61 69 6c 75 72 65 20 6f 63 63 75 72 72 65 64 failure occurred
e830: 20 77 68 69 6c 73 74 20 77 72 69 74 69 6e 67 20 whilst writing
e840: 74 6f 20 74 68 65 20 6a 6f 75 72 6e 61 6c 0a 20 to the journal.
e850: 20 2a 2a 20 66 69 6c 65 20 69 74 20 6d 61 79 20 ** file it may
e860: 63 6f 6e 74 61 69 6e 20 73 6f 6d 65 20 67 61 72 contain some gar
e870: 62 61 67 65 20 64 61 74 61 2e 20 54 68 65 72 65 bage data. There
e880: 20 61 72 65 20 74 77 6f 20 73 63 65 6e 61 72 69 are two scenari
e890: 6f 73 0a 20 20 2a 2a 20 77 68 65 72 65 20 74 68 os. ** where th
e8a0: 69 73 20 72 69 73 6b 20 63 61 6e 20 62 65 20 69 is risk can be i
e8b0: 67 6e 6f 72 65 64 3a 0a 20 20 2a 2a 0a 20 20 2a gnored:. **. *
e8c0: 2a 20 20 20 2a 20 57 68 65 6e 20 74 68 65 20 70 * * When the p
e8d0: 61 67 65 72 20 69 73 20 69 6e 20 6e 6f 2d 73 79 ager is in no-sy
e8e0: 6e 63 20 6d 6f 64 65 2e 20 43 6f 72 72 75 70 74 nc mode. Corrupt
e8f0: 69 6f 6e 20 63 61 6e 20 66 6f 6c 6c 6f 77 20 61 ion can follow a
e900: 0a 20 20 2a 2a 20 20 20 20 20 70 6f 77 65 72 20 . ** power
e910: 66 61 69 6c 75 72 65 20 69 6e 20 74 68 69 73 20 failure in this
e920: 63 61 73 65 20 61 6e 79 77 61 79 2e 0a 20 20 2a case anyway.. *
e930: 2a 0a 20 20 2a 2a 20 20 20 2a 20 57 68 65 6e 20 *. ** * When
e940: 74 68 65 20 53 51 4c 49 54 45 5f 49 4f 43 41 50 the SQLITE_IOCAP
e950: 5f 53 41 46 45 5f 41 50 50 45 4e 44 20 66 6c 61 _SAFE_APPEND fla
e960: 67 20 69 73 20 73 65 74 2e 20 54 68 69 73 20 67 g is set. This g
e970: 75 61 72 61 6e 74 65 65 73 0a 20 20 2a 2a 20 20 uarantees. **
e980: 20 20 20 74 68 61 74 20 67 61 72 62 61 67 65 20 that garbage
e990: 64 61 74 61 20 69 73 20 6e 65 76 65 72 20 61 70 data is never ap
e9a0: 70 65 6e 64 65 64 20 74 6f 20 74 68 65 20 6a 6f pended to the jo
e9b0: 75 72 6e 61 6c 20 66 69 6c 65 2e 0a 20 20 2a 2f urnal file.. */
e9c0: 0a 20 20 61 73 73 65 72 74 28 20 69 73 4f 70 65 . assert( isOpe
e9d0: 6e 28 70 50 61 67 65 72 2d 3e 66 64 29 20 7c 7c n(pPager->fd) ||
e9e0: 20 70 50 61 67 65 72 2d 3e 6e 6f 53 79 6e 63 20 pPager->noSync
e9f0: 29 3b 0a 20 20 69 66 28 20 70 50 61 67 65 72 2d );. if( pPager-
ea00: 3e 6e 6f 53 79 6e 63 20 7c 7c 20 28 70 50 61 67 >noSync || (pPag
ea10: 65 72 2d 3e 6a 6f 75 72 6e 61 6c 4d 6f 64 65 3d er->journalMode=
ea20: 3d 50 41 47 45 52 5f 4a 4f 55 52 4e 41 4c 4d 4f =PAGER_JOURNALMO
ea30: 44 45 5f 4d 45 4d 4f 52 59 29 0a 20 20 20 7c 7c DE_MEMORY). ||
ea40: 20 28 73 71 6c 69 74 65 33 4f 73 44 65 76 69 63 (sqlite3OsDevic
ea50: 65 43 68 61 72 61 63 74 65 72 69 73 74 69 63 73 eCharacteristics
ea60: 28 70 50 61 67 65 72 2d 3e 66 64 29 26 53 51 4c (pPager->fd)&SQL
ea70: 49 54 45 5f 49 4f 43 41 50 5f 53 41 46 45 5f 41 ITE_IOCAP_SAFE_A
ea80: 50 50 45 4e 44 29 20 0a 20 20 29 7b 0a 20 20 20 PPEND) . ){.
ea90: 20 6d 65 6d 63 70 79 28 7a 48 65 61 64 65 72 2c memcpy(zHeader,
eaa0: 20 61 4a 6f 75 72 6e 61 6c 4d 61 67 69 63 2c 20 aJournalMagic,
eab0: 73 69 7a 65 6f 66 28 61 4a 6f 75 72 6e 61 6c 4d sizeof(aJournalM
eac0: 61 67 69 63 29 29 3b 0a 20 20 20 20 70 75 74 33 agic));. put3
ead0: 32 62 69 74 73 28 26 7a 48 65 61 64 65 72 5b 73 2bits(&zHeader[s
eae0: 69 7a 65 6f 66 28 61 4a 6f 75 72 6e 61 6c 4d 61 izeof(aJournalMa
eaf0: 67 69 63 29 5d 2c 20 30 78 66 66 66 66 66 66 66 gic)], 0xfffffff
eb00: 66 29 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 20 f);. }else{.
eb10: 20 6d 65 6d 73 65 74 28 7a 48 65 61 64 65 72 2c memset(zHeader,
eb20: 20 30 2c 20 73 69 7a 65 6f 66 28 61 4a 6f 75 72 0, sizeof(aJour
eb30: 6e 61 6c 4d 61 67 69 63 29 2b 34 29 3b 0a 20 20 nalMagic)+4);.
eb40: 7d 0a 0a 20 20 2f 2a 20 54 68 65 20 72 61 6e 64 }.. /* The rand
eb50: 6f 6d 20 63 68 65 63 6b 2d 68 61 73 68 20 69 6e om check-hash in
eb60: 69 74 69 61 6c 69 7a 65 72 20 2a 2f 20 0a 20 20 itializer */ .
eb70: 73 71 6c 69 74 65 33 5f 72 61 6e 64 6f 6d 6e 65 sqlite3_randomne
eb80: 73 73 28 73 69 7a 65 6f 66 28 70 50 61 67 65 72 ss(sizeof(pPager
eb90: 2d 3e 63 6b 73 75 6d 49 6e 69 74 29 2c 20 26 70 ->cksumInit), &p
eba0: 50 61 67 65 72 2d 3e 63 6b 73 75 6d 49 6e 69 74 Pager->cksumInit
ebb0: 29 3b 0a 20 20 70 75 74 33 32 62 69 74 73 28 26 );. put32bits(&
ebc0: 7a 48 65 61 64 65 72 5b 73 69 7a 65 6f 66 28 61 zHeader[sizeof(a
ebd0: 4a 6f 75 72 6e 61 6c 4d 61 67 69 63 29 2b 34 5d JournalMagic)+4]
ebe0: 2c 20 70 50 61 67 65 72 2d 3e 63 6b 73 75 6d 49 , pPager->cksumI
ebf0: 6e 69 74 29 3b 0a 20 20 2f 2a 20 54 68 65 20 69 nit);. /* The i
ec00: 6e 69 74 69 61 6c 20 64 61 74 61 62 61 73 65 20 nitial database
ec10: 73 69 7a 65 20 2a 2f 0a 20 20 70 75 74 33 32 62 size */. put32b
ec20: 69 74 73 28 26 7a 48 65 61 64 65 72 5b 73 69 7a its(&zHeader[siz
ec30: 65 6f 66 28 61 4a 6f 75 72 6e 61 6c 4d 61 67 69 eof(aJournalMagi
ec40: 63 29 2b 38 5d 2c 20 70 50 61 67 65 72 2d 3e 64 c)+8], pPager->d
ec50: 62 4f 72 69 67 53 69 7a 65 29 3b 0a 20 20 2f 2a bOrigSize);. /*
ec60: 20 54 68 65 20 61 73 73 75 6d 65 64 20 73 65 63 The assumed sec
ec70: 74 6f 72 20 73 69 7a 65 20 66 6f 72 20 74 68 69 tor size for thi
ec80: 73 20 70 72 6f 63 65 73 73 20 2a 2f 0a 20 20 70 s process */. p
ec90: 75 74 33 32 62 69 74 73 28 26 7a 48 65 61 64 65 ut32bits(&zHeade
eca0: 72 5b 73 69 7a 65 6f 66 28 61 4a 6f 75 72 6e 61 r[sizeof(aJourna
ecb0: 6c 4d 61 67 69 63 29 2b 31 32 5d 2c 20 70 50 61 lMagic)+12], pPa
ecc0: 67 65 72 2d 3e 73 65 63 74 6f 72 53 69 7a 65 29 ger->sectorSize)
ecd0: 3b 0a 0a 20 20 2f 2a 20 54 68 65 20 70 61 67 65 ;.. /* The page
ece0: 20 73 69 7a 65 20 2a 2f 0a 20 20 70 75 74 33 32 size */. put32
ecf0: 62 69 74 73 28 26 7a 48 65 61 64 65 72 5b 73 69 bits(&zHeader[si
ed00: 7a 65 6f 66 28 61 4a 6f 75 72 6e 61 6c 4d 61 67 zeof(aJournalMag
ed10: 69 63 29 2b 31 36 5d 2c 20 70 50 61 67 65 72 2d ic)+16], pPager-
ed20: 3e 70 61 67 65 53 69 7a 65 29 3b 0a 0a 20 20 2f >pageSize);.. /
ed30: 2a 20 49 6e 69 74 69 61 6c 69 7a 69 6e 67 20 74 * Initializing t
ed40: 68 65 20 74 61 69 6c 20 6f 66 20 74 68 65 20 62 he tail of the b
ed50: 75 66 66 65 72 20 69 73 20 6e 6f 74 20 6e 65 63 uffer is not nec
ed60: 65 73 73 61 72 79 2e 20 20 45 76 65 72 79 74 68 essary. Everyth
ed70: 69 6e 67 0a 20 20 2a 2a 20 77 6f 72 6b 73 20 66 ing. ** works f
ed80: 69 6e 64 20 69 66 20 74 68 65 20 66 6f 6c 6c 6f ind if the follo
ed90: 77 69 6e 67 20 6d 65 6d 73 65 74 28 29 20 69 73 wing memset() is
eda0: 20 6f 6d 69 74 74 65 64 2e 20 20 42 75 74 20 69 omitted. But i
edb0: 6e 69 74 69 61 6c 69 7a 69 6e 67 0a 20 20 2a 2a nitializing. **
edc0: 20 74 68 65 20 6d 65 6d 6f 72 79 20 70 72 65 76 the memory prev
edd0: 65 6e 74 73 20 76 61 6c 67 72 69 6e 64 20 66 72 ents valgrind fr
ede0: 6f 6d 20 63 6f 6d 70 6c 61 69 6e 69 6e 67 2c 20 om complaining,
edf0: 73 6f 20 77 65 20 61 72 65 20 77 69 6c 6c 69 6e so we are willin
ee00: 67 20 74 6f 0a 20 20 2a 2a 20 74 61 6b 65 20 74 g to. ** take t
ee10: 68 65 20 70 65 72 66 6f 72 6d 61 6e 63 65 20 68 he performance h
ee20: 69 74 2e 0a 20 20 2a 2f 0a 20 20 6d 65 6d 73 65 it.. */. memse
ee30: 74 28 26 7a 48 65 61 64 65 72 5b 73 69 7a 65 6f t(&zHeader[sizeo
ee40: 66 28 61 4a 6f 75 72 6e 61 6c 4d 61 67 69 63 29 f(aJournalMagic)
ee50: 2b 32 30 5d 2c 20 30 2c 0a 20 20 20 20 20 20 20 +20], 0,.
ee60: 20 20 6e 48 65 61 64 65 72 2d 28 73 69 7a 65 6f nHeader-(sizeo
ee70: 66 28 61 4a 6f 75 72 6e 61 6c 4d 61 67 69 63 29 f(aJournalMagic)
ee80: 2b 32 30 29 29 3b 0a 0a 20 20 2f 2a 20 49 6e 20 +20));.. /* In
ee90: 74 68 65 6f 72 79 2c 20 69 74 20 69 73 20 6f 6e theory, it is on
eea0: 6c 79 20 6e 65 63 65 73 73 61 72 79 20 74 6f 20 ly necessary to
eeb0: 77 72 69 74 65 20 74 68 65 20 32 38 20 62 79 74 write the 28 byt
eec0: 65 73 20 74 68 61 74 20 74 68 65 20 0a 20 20 2a es that the . *
eed0: 2a 20 6a 6f 75 72 6e 61 6c 20 68 65 61 64 65 72 * journal header
eee0: 20 63 6f 6e 73 75 6d 65 73 20 74 6f 20 74 68 65 consumes to the
eef0: 20 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 20 68 65 journal file he
ef00: 72 65 2e 20 54 68 65 6e 20 69 6e 63 72 65 6d 65 re. Then increme
ef10: 6e 74 20 74 68 65 20 0a 20 20 2a 2a 20 50 61 67 nt the . ** Pag
ef20: 65 72 2e 6a 6f 75 72 6e 61 6c 4f 66 66 20 76 61 er.journalOff va
ef30: 72 69 61 62 6c 65 20 62 79 20 4a 4f 55 52 4e 41 riable by JOURNA
ef40: 4c 5f 48 44 52 5f 53 5a 20 73 6f 20 74 68 61 74 L_HDR_SZ so that
ef50: 20 74 68 65 20 6e 65 78 74 20 0a 20 20 2a 2a 20 the next . **
ef60: 72 65 63 6f 72 64 20 69 73 20 77 72 69 74 74 65 record is writte
ef70: 6e 20 74 6f 20 74 68 65 20 66 6f 6c 6c 6f 77 69 n to the followi
ef80: 6e 67 20 73 65 63 74 6f 72 20 28 6c 65 61 76 69 ng sector (leavi
ef90: 6e 67 20 61 20 67 61 70 20 69 6e 20 74 68 65 20 ng a gap in the
efa0: 66 69 6c 65 0a 20 20 2a 2a 20 74 68 61 74 20 77 file. ** that w
efb0: 69 6c 6c 20 62 65 20 69 6d 70 6c 69 63 69 74 6c ill be implicitl
efc0: 79 20 66 69 6c 6c 65 64 20 69 6e 20 62 79 20 74 y filled in by t
efd0: 68 65 20 4f 53 29 2e 0a 20 20 2a 2a 0a 20 20 2a he OS).. **. *
efe0: 2a 20 48 6f 77 65 76 65 72 20 69 74 20 68 61 73 * However it has
eff0: 20 62 65 65 6e 20 64 69 73 63 6f 76 65 72 65 64 been discovered
f000: 20 74 68 61 74 20 6f 6e 20 73 6f 6d 65 20 73 79 that on some sy
f010: 73 74 65 6d 73 20 74 68 69 73 20 70 61 74 74 65 stems this patte
f020: 72 6e 20 63 61 6e 20 0a 20 20 2a 2a 20 62 65 20 rn can . ** be
f030: 73 69 67 6e 69 66 69 63 61 6e 74 6c 79 20 73 6c significantly sl
f040: 6f 77 65 72 20 74 68 61 6e 20 63 6f 6e 74 69 67 ower than contig
f050: 75 6f 75 73 6c 79 20 77 72 69 74 69 6e 67 20 64 uously writing d
f060: 61 74 61 20 74 6f 20 74 68 65 20 66 69 6c 65 2c ata to the file,
f070: 0a 20 20 2a 2a 20 65 76 65 6e 20 69 66 20 74 68 . ** even if th
f080: 61 74 20 6d 65 61 6e 73 20 65 78 70 6c 69 63 69 at means explici
f090: 74 6c 79 20 77 72 69 74 69 6e 67 20 64 61 74 61 tly writing data
f0a0: 20 74 6f 20 74 68 65 20 62 6c 6f 63 6b 20 6f 66 to the block of
f0b0: 20 0a 20 20 2a 2a 20 28 4a 4f 55 52 4e 41 4c 5f . ** (JOURNAL_
f0c0: 48 44 52 5f 53 5a 20 2d 20 32 38 29 20 62 79 74 HDR_SZ - 28) byt
f0d0: 65 73 20 74 68 61 74 20 77 69 6c 6c 20 6e 6f 74 es that will not
f0e0: 20 62 65 20 75 73 65 64 2e 20 53 6f 20 74 68 61 be used. So tha
f0f0: 74 20 69 73 20 77 68 61 74 0a 20 20 2a 2a 20 69 t is what. ** i
f100: 73 20 64 6f 6e 65 2e 20 0a 20 20 2a 2a 0a 20 20 s done. . **.
f110: 2a 2a 20 54 68 65 20 6c 6f 6f 70 20 69 73 20 72 ** The loop is r
f120: 65 71 75 69 72 65 64 20 68 65 72 65 20 69 6e 20 equired here in
f130: 63 61 73 65 20 74 68 65 20 73 65 63 74 6f 72 2d case the sector-
f140: 73 69 7a 65 20 69 73 20 6c 61 72 67 65 72 20 74 size is larger t
f150: 68 61 6e 20 74 68 65 20 0a 20 20 2a 2a 20 64 61 han the . ** da
f160: 74 61 62 61 73 65 20 70 61 67 65 20 73 69 7a 65 tabase page size
f170: 2e 20 53 69 6e 63 65 20 74 68 65 20 7a 48 65 61 . Since the zHea
f180: 64 65 72 20 62 75 66 66 65 72 20 69 73 20 6f 6e der buffer is on
f190: 6c 79 20 50 61 67 65 72 2e 70 61 67 65 53 69 7a ly Pager.pageSiz
f1a0: 65 0a 20 20 2a 2a 20 62 79 74 65 73 20 69 6e 20 e. ** bytes in
f1b0: 73 69 7a 65 2c 20 6d 6f 72 65 20 74 68 61 6e 20 size, more than
f1c0: 6f 6e 65 20 63 61 6c 6c 20 74 6f 20 73 71 6c 69 one call to sqli
f1d0: 74 65 33 4f 73 57 72 69 74 65 28 29 20 6d 61 79 te3OsWrite() may
f1e0: 20 62 65 20 72 65 71 75 69 72 65 64 0a 20 20 2a be required. *
f1f0: 2a 20 74 6f 20 70 6f 70 75 6c 61 74 65 20 74 68 * to populate th
f200: 65 20 65 6e 74 69 72 65 20 6a 6f 75 72 6e 61 6c e entire journal
f210: 20 68 65 61 64 65 72 20 73 65 63 74 6f 72 2e 0a header sector..
f220: 20 20 2a 2f 20 0a 20 20 66 6f 72 28 6e 57 72 69 */ . for(nWri
f230: 74 65 3d 30 3b 20 72 63 3d 3d 53 51 4c 49 54 45 te=0; rc==SQLITE
f240: 5f 4f 4b 26 26 6e 57 72 69 74 65 3c 4a 4f 55 52 _OK&&nWrite<JOUR
f250: 4e 41 4c 5f 48 44 52 5f 53 5a 28 70 50 61 67 65 NAL_HDR_SZ(pPage
f260: 72 29 3b 20 6e 57 72 69 74 65 2b 3d 6e 48 65 61 r); nWrite+=nHea
f270: 64 65 72 29 7b 0a 20 20 20 20 49 4f 54 52 41 43 der){. IOTRAC
f280: 45 28 28 22 4a 48 44 52 20 25 70 20 25 6c 6c 64 E(("JHDR %p %lld
f290: 20 25 64 5c 6e 22 2c 20 70 50 61 67 65 72 2c 20 %d\n", pPager,
f2a0: 70 50 61 67 65 72 2d 3e 6a 6f 75 72 6e 61 6c 48 pPager->journalH
f2b0: 64 72 2c 20 6e 48 65 61 64 65 72 29 29 0a 20 20 dr, nHeader)).
f2c0: 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33 4f 73 rc = sqlite3Os
f2d0: 57 72 69 74 65 28 70 50 61 67 65 72 2d 3e 6a 66 Write(pPager->jf
f2e0: 64 2c 20 7a 48 65 61 64 65 72 2c 20 6e 48 65 61 d, zHeader, nHea
f2f0: 64 65 72 2c 20 70 50 61 67 65 72 2d 3e 6a 6f 75 der, pPager->jou
f300: 72 6e 61 6c 4f 66 66 29 3b 0a 20 20 20 20 61 73 rnalOff);. as
f310: 73 65 72 74 28 20 70 50 61 67 65 72 2d 3e 6a 6f sert( pPager->jo
f320: 75 72 6e 61 6c 48 64 72 20 3c 3d 20 70 50 61 67 urnalHdr <= pPag
f330: 65 72 2d 3e 6a 6f 75 72 6e 61 6c 4f 66 66 20 29 er->journalOff )
f340: 3b 0a 20 20 20 20 70 50 61 67 65 72 2d 3e 6a 6f ;. pPager->jo
f350: 75 72 6e 61 6c 4f 66 66 20 2b 3d 20 6e 48 65 61 urnalOff += nHea
f360: 64 65 72 3b 0a 20 20 7d 0a 0a 20 20 72 65 74 75 der;. }.. retu
f370: 72 6e 20 72 63 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 rn rc;.}../*.**
f380: 54 68 65 20 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 The journal file
f390: 20 6d 75 73 74 20 62 65 20 6f 70 65 6e 20 77 68 must be open wh
f3a0: 65 6e 20 74 68 69 73 20 69 73 20 63 61 6c 6c 65 en this is calle
f3b0: 64 2e 20 41 20 6a 6f 75 72 6e 61 6c 20 68 65 61 d. A journal hea
f3c0: 64 65 72 20 66 69 6c 65 0a 2a 2a 20 28 4a 4f 55 der file.** (JOU
f3d0: 52 4e 41 4c 5f 48 44 52 5f 53 5a 20 62 79 74 65 RNAL_HDR_SZ byte
f3e0: 73 29 20 69 73 20 72 65 61 64 20 66 72 6f 6d 20 s) is read from
f3f0: 74 68 65 20 63 75 72 72 65 6e 74 20 6c 6f 63 61 the current loca
f400: 74 69 6f 6e 20 69 6e 20 74 68 65 20 6a 6f 75 72 tion in the jour
f410: 6e 61 6c 0a 2a 2a 20 66 69 6c 65 2e 20 54 68 65 nal.** file. The
f420: 20 63 75 72 72 65 6e 74 20 6c 6f 63 61 74 69 6f current locatio
f430: 6e 20 69 6e 20 74 68 65 20 6a 6f 75 72 6e 61 6c n in the journal
f440: 20 66 69 6c 65 20 69 73 20 67 69 76 65 6e 20 62 file is given b
f450: 79 0a 2a 2a 20 70 50 61 67 65 72 2d 3e 6a 6f 75 y.** pPager->jou
f460: 72 6e 61 6c 4f 66 66 2e 20 53 65 65 20 63 6f 6d rnalOff. See com
f470: 6d 65 6e 74 73 20 61 62 6f 76 65 20 66 75 6e 63 ments above func
f480: 74 69 6f 6e 20 77 72 69 74 65 4a 6f 75 72 6e 61 tion writeJourna
f490: 6c 48 64 72 28 29 20 66 6f 72 0a 2a 2a 20 61 20 lHdr() for.** a
f4a0: 64 65 73 63 72 69 70 74 69 6f 6e 20 6f 66 20 74 description of t
f4b0: 68 65 20 6a 6f 75 72 6e 61 6c 20 68 65 61 64 65 he journal heade
f4c0: 72 20 66 6f 72 6d 61 74 2e 0a 2a 2a 0a 2a 2a 20 r format..**.**
f4d0: 49 66 20 74 68 65 20 68 65 61 64 65 72 20 69 73 If the header is
f4e0: 20 72 65 61 64 20 73 75 63 63 65 73 73 66 75 6c read successful
f4f0: 6c 79 2c 20 2a 70 4e 52 65 63 20 69 73 20 73 65 ly, *pNRec is se
f500: 74 20 74 6f 20 74 68 65 20 6e 75 6d 62 65 72 20 t to the number
f510: 6f 66 0a 2a 2a 20 70 61 67 65 20 72 65 63 6f 72 of.** page recor
f520: 64 73 20 66 6f 6c 6c 6f 77 69 6e 67 20 74 68 69 ds following thi
f530: 73 20 68 65 61 64 65 72 20 61 6e 64 20 2a 70 44 s header and *pD
f540: 62 53 69 7a 65 20 69 73 20 73 65 74 20 74 6f 20 bSize is set to
f550: 74 68 65 20 73 69 7a 65 20 6f 66 20 74 68 65 0a the size of the.
f560: 2a 2a 20 64 61 74 61 62 61 73 65 20 62 65 66 6f ** database befo
f570: 72 65 20 74 68 65 20 74 72 61 6e 73 61 63 74 69 re the transacti
f580: 6f 6e 20 62 65 67 61 6e 2c 20 69 6e 20 70 61 67 on began, in pag
f590: 65 73 2e 20 41 6c 73 6f 2c 20 70 50 61 67 65 72 es. Also, pPager
f5a0: 2d 3e 63 6b 73 75 6d 49 6e 69 74 0a 2a 2a 20 69 ->cksumInit.** i
f5b0: 73 20 73 65 74 20 74 6f 20 74 68 65 20 76 61 6c s set to the val
f5c0: 75 65 20 72 65 61 64 20 66 72 6f 6d 20 74 68 65 ue read from the
f5d0: 20 6a 6f 75 72 6e 61 6c 20 68 65 61 64 65 72 2e journal header.
f5e0: 20 53 51 4c 49 54 45 5f 4f 4b 20 69 73 20 72 65 SQLITE_OK is re
f5f0: 74 75 72 6e 65 64 0a 2a 2a 20 69 6e 20 74 68 69 turned.** in thi
f600: 73 20 63 61 73 65 2e 0a 2a 2a 0a 2a 2a 20 49 66 s case..**.** If
f610: 20 74 68 65 20 6a 6f 75 72 6e 61 6c 20 68 65 61 the journal hea
f620: 64 65 72 20 66 69 6c 65 20 61 70 70 65 61 72 73 der file appears
f630: 20 74 6f 20 62 65 20 63 6f 72 72 75 70 74 65 64 to be corrupted
f640: 2c 20 53 51 4c 49 54 45 5f 44 4f 4e 45 20 69 73 , SQLITE_DONE is
f650: 0a 2a 2a 20 72 65 74 75 72 6e 65 64 20 61 6e 64 .** returned and
f660: 20 2a 70 4e 52 65 63 20 61 6e 64 20 2a 50 44 62 *pNRec and *PDb
f670: 53 69 7a 65 20 61 72 65 20 75 6e 64 65 66 69 6e Size are undefin
f680: 65 64 2e 20 20 49 66 20 4a 4f 55 52 4e 41 4c 5f ed. If JOURNAL_
f690: 48 44 52 5f 53 5a 20 62 79 74 65 73 0a 2a 2a 20 HDR_SZ bytes.**
f6a0: 63 61 6e 6e 6f 74 20 62 65 20 72 65 61 64 20 66 cannot be read f
f6b0: 72 6f 6d 20 74 68 65 20 6a 6f 75 72 6e 61 6c 20 rom the journal
f6c0: 66 69 6c 65 20 61 6e 20 65 72 72 6f 72 20 63 6f file an error co
f6d0: 64 65 20 69 73 20 72 65 74 75 72 6e 65 64 2e 0a de is returned..
f6e0: 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74 20 72 65 */.static int re
f6f0: 61 64 4a 6f 75 72 6e 61 6c 48 64 72 28 0a 20 20 adJournalHdr(.
f700: 50 61 67 65 72 20 2a 70 50 61 67 65 72 2c 20 20 Pager *pPager,
f710: 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 /*
f720: 50 61 67 65 72 20 6f 62 6a 65 63 74 20 2a 2f 0a Pager object */.
f730: 20 20 69 6e 74 20 69 73 48 6f 74 2c 0a 20 20 69 int isHot,. i
f740: 36 34 20 6a 6f 75 72 6e 61 6c 53 69 7a 65 2c 20 64 journalSize,
f750: 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 53 /* S
f760: 69 7a 65 20 6f 66 20 74 68 65 20 6f 70 65 6e 20 ize of the open
f770: 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 20 69 6e 20 journal file in
f780: 62 79 74 65 73 20 2a 2f 0a 20 20 75 33 32 20 2a bytes */. u32 *
f790: 70 4e 52 65 63 2c 20 20 20 20 20 20 20 20 20 20 pNRec,
f7a0: 20 20 20 20 20 20 20 20 2f 2a 20 4f 55 54 3a 20 /* OUT:
f7b0: 56 61 6c 75 65 20 72 65 61 64 20 66 72 6f 6d 20 Value read from
f7c0: 74 68 65 20 6e 52 65 63 20 66 69 65 6c 64 20 2a the nRec field *
f7d0: 2f 0a 20 20 75 33 32 20 2a 70 44 62 53 69 7a 65 /. u32 *pDbSize
f7e0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
f7f0: 20 2f 2a 20 4f 55 54 3a 20 56 61 6c 75 65 20 6f /* OUT: Value o
f800: 66 20 6f 72 69 67 69 6e 61 6c 20 64 61 74 61 62 f original datab
f810: 61 73 65 20 73 69 7a 65 20 66 69 65 6c 64 20 2a ase size field *
f820: 2f 0a 29 7b 0a 20 20 69 6e 74 20 72 63 3b 20 20 /.){. int rc;
f830: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
f840: 20 20 20 20 2f 2a 20 52 65 74 75 72 6e 20 63 6f /* Return co
f850: 64 65 20 2a 2f 0a 20 20 75 6e 73 69 67 6e 65 64 de */. unsigned
f860: 20 63 68 61 72 20 61 4d 61 67 69 63 5b 38 5d 3b char aMagic[8];
f870: 20 20 20 20 20 2f 2a 20 41 20 62 75 66 66 65 72 /* A buffer
f880: 20 74 6f 20 68 6f 6c 64 20 74 68 65 20 6d 61 67 to hold the mag
f890: 69 63 20 68 65 61 64 65 72 20 2a 2f 0a 20 20 69 ic header */. i
f8a0: 36 34 20 69 48 64 72 4f 66 66 3b 20 20 20 20 20 64 iHdrOff;
f8b0: 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4f /* O
f8c0: 66 66 73 65 74 20 6f 66 20 6a 6f 75 72 6e 61 6c ffset of journal
f8d0: 20 68 65 61 64 65 72 20 62 65 69 6e 67 20 72 65 header being re
f8e0: 61 64 20 2a 2f 0a 0a 20 20 61 73 73 65 72 74 28 ad */.. assert(
f8f0: 20 69 73 4f 70 65 6e 28 70 50 61 67 65 72 2d 3e isOpen(pPager->
f900: 6a 66 64 29 20 29 3b 20 20 20 20 20 20 2f 2a 20 jfd) ); /*
f910: 4a 6f 75 72 6e 61 6c 20 66 69 6c 65 20 6d 75 73 Journal file mus
f920: 74 20 62 65 20 6f 70 65 6e 2e 20 2a 2f 0a 0a 20 t be open. */..
f930: 20 2f 2a 20 41 64 76 61 6e 63 65 20 50 61 67 65 /* Advance Page
f940: 72 2e 6a 6f 75 72 6e 61 6c 4f 66 66 20 74 6f 20 r.journalOff to
f950: 74 68 65 20 73 74 61 72 74 20 6f 66 20 74 68 65 the start of the
f960: 20 6e 65 78 74 20 73 65 63 74 6f 72 2e 20 49 66 next sector. If
f970: 20 74 68 65 0a 20 20 2a 2a 20 6a 6f 75 72 6e 61 the. ** journa
f980: 6c 20 66 69 6c 65 20 69 73 20 74 6f 6f 20 73 6d l file is too sm
f990: 61 6c 6c 20 66 6f 72 20 74 68 65 72 65 20 74 6f all for there to
f9a0: 20 62 65 20 61 20 68 65 61 64 65 72 20 73 74 6f be a header sto
f9b0: 72 65 64 20 61 74 20 74 68 69 73 0a 20 20 2a 2a red at this. **
f9c0: 20 70 6f 69 6e 74 2c 20 72 65 74 75 72 6e 20 53 point, return S
f9d0: 51 4c 49 54 45 5f 44 4f 4e 45 2e 0a 20 20 2a 2f QLITE_DONE.. */
f9e0: 0a 20 20 70 50 61 67 65 72 2d 3e 6a 6f 75 72 6e . pPager->journ
f9f0: 61 6c 4f 66 66 20 3d 20 6a 6f 75 72 6e 61 6c 48 alOff = journalH
fa00: 64 72 4f 66 66 73 65 74 28 70 50 61 67 65 72 29 drOffset(pPager)
fa10: 3b 0a 20 20 69 66 28 20 70 50 61 67 65 72 2d 3e ;. if( pPager->
fa20: 6a 6f 75 72 6e 61 6c 4f 66 66 2b 4a 4f 55 52 4e journalOff+JOURN
fa30: 41 4c 5f 48 44 52 5f 53 5a 28 70 50 61 67 65 72 AL_HDR_SZ(pPager
fa40: 29 20 3e 20 6a 6f 75 72 6e 61 6c 53 69 7a 65 20 ) > journalSize
fa50: 29 7b 0a 20 20 20 20 72 65 74 75 72 6e 20 53 51 ){. return SQ
fa60: 4c 49 54 45 5f 44 4f 4e 45 3b 0a 20 20 7d 0a 20 LITE_DONE;. }.
fa70: 20 69 48 64 72 4f 66 66 20 3d 20 70 50 61 67 65 iHdrOff = pPage
fa80: 72 2d 3e 6a 6f 75 72 6e 61 6c 4f 66 66 3b 0a 0a r->journalOff;..
fa90: 20 20 2f 2a 20 52 65 61 64 20 69 6e 20 74 68 65 /* Read in the
faa0: 20 66 69 72 73 74 20 38 20 62 79 74 65 73 20 6f first 8 bytes o
fab0: 66 20 74 68 65 20 6a 6f 75 72 6e 61 6c 20 68 65 f the journal he
fac0: 61 64 65 72 2e 20 49 66 20 74 68 65 79 20 64 6f ader. If they do
fad0: 20 6e 6f 74 20 6d 61 74 63 68 0a 20 20 2a 2a 20 not match. **
fae0: 74 68 65 20 20 6d 61 67 69 63 20 73 74 72 69 6e the magic strin
faf0: 67 20 66 6f 75 6e 64 20 61 74 20 74 68 65 20 73 g found at the s
fb00: 74 61 72 74 20 6f 66 20 65 61 63 68 20 6a 6f 75 tart of each jou
fb10: 72 6e 61 6c 20 68 65 61 64 65 72 2c 20 72 65 74 rnal header, ret
fb20: 75 72 6e 0a 20 20 2a 2a 20 53 51 4c 49 54 45 5f urn. ** SQLITE_
fb30: 44 4f 4e 45 2e 20 49 66 20 61 6e 20 49 4f 20 65 DONE. If an IO e
fb40: 72 72 6f 72 20 6f 63 63 75 72 73 2c 20 72 65 74 rror occurs, ret
fb50: 75 72 6e 20 61 6e 20 65 72 72 6f 72 20 63 6f 64 urn an error cod
fb60: 65 2e 20 4f 74 68 65 72 77 69 73 65 2c 0a 20 20 e. Otherwise,.
fb70: 2a 2a 20 70 72 6f 63 65 65 64 2e 0a 20 20 2a 2f ** proceed.. */
fb80: 0a 20 20 69 66 28 20 69 73 48 6f 74 20 7c 7c 20 . if( isHot ||
fb90: 69 48 64 72 4f 66 66 21 3d 70 50 61 67 65 72 2d iHdrOff!=pPager-
fba0: 3e 6a 6f 75 72 6e 61 6c 48 64 72 20 29 7b 0a 20 >journalHdr ){.
fbb0: 20 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33 4f rc = sqlite3O
fbc0: 73 52 65 61 64 28 70 50 61 67 65 72 2d 3e 6a 66 sRead(pPager->jf
fbd0: 64 2c 20 61 4d 61 67 69 63 2c 20 73 69 7a 65 6f d, aMagic, sizeo
fbe0: 66 28 61 4d 61 67 69 63 29 2c 20 69 48 64 72 4f f(aMagic), iHdrO
fbf0: 66 66 29 3b 0a 20 20 20 20 69 66 28 20 72 63 20 ff);. if( rc
fc00: 29 7b 0a 20 20 20 20 20 20 72 65 74 75 72 6e 20 ){. return
fc10: 72 63 3b 0a 20 20 20 20 7d 0a 20 20 20 20 69 66 rc;. }. if
fc20: 28 20 6d 65 6d 63 6d 70 28 61 4d 61 67 69 63 2c ( memcmp(aMagic,
fc30: 20 61 4a 6f 75 72 6e 61 6c 4d 61 67 69 63 2c 20 aJournalMagic,
fc40: 73 69 7a 65 6f 66 28 61 4d 61 67 69 63 29 29 21 sizeof(aMagic))!
fc50: 3d 30 20 29 7b 0a 20 20 20 20 20 20 72 65 74 75 =0 ){. retu
fc60: 72 6e 20 53 51 4c 49 54 45 5f 44 4f 4e 45 3b 0a rn SQLITE_DONE;.
fc70: 20 20 20 20 7d 0a 20 20 7d 0a 0a 20 20 2f 2a 20 }. }.. /*
fc80: 52 65 61 64 20 74 68 65 20 66 69 72 73 74 20 74 Read the first t
fc90: 68 72 65 65 20 33 32 2d 62 69 74 20 66 69 65 6c hree 32-bit fiel
fca0: 64 73 20 6f 66 20 74 68 65 20 6a 6f 75 72 6e 61 ds of the journa
fcb0: 6c 20 68 65 61 64 65 72 3a 20 54 68 65 20 6e 52 l header: The nR
fcc0: 65 63 0a 20 20 2a 2a 20 66 69 65 6c 64 2c 20 74 ec. ** field, t
fcd0: 68 65 20 63 68 65 63 6b 73 75 6d 2d 69 6e 69 74 he checksum-init
fce0: 69 61 6c 69 7a 65 72 20 61 6e 64 20 74 68 65 20 ializer and the
fcf0: 64 61 74 61 62 61 73 65 20 73 69 7a 65 20 61 74 database size at
fd00: 20 74 68 65 20 73 74 61 72 74 0a 20 20 2a 2a 20 the start. **
fd10: 6f 66 20 74 68 65 20 74 72 61 6e 73 61 63 74 69 of the transacti
fd20: 6f 6e 2e 20 52 65 74 75 72 6e 20 61 6e 20 65 72 on. Return an er
fd30: 72 6f 72 20 63 6f 64 65 20 69 66 20 61 6e 79 74 ror code if anyt
fd40: 68 69 6e 67 20 67 6f 65 73 20 77 72 6f 6e 67 2e hing goes wrong.
fd50: 0a 20 20 2a 2f 0a 20 20 69 66 28 20 53 51 4c 49 . */. if( SQLI
fd60: 54 45 5f 4f 4b 21 3d 28 72 63 20 3d 20 72 65 61 TE_OK!=(rc = rea
fd70: 64 33 32 62 69 74 73 28 70 50 61 67 65 72 2d 3e d32bits(pPager->
fd80: 6a 66 64 2c 20 69 48 64 72 4f 66 66 2b 38 2c 20 jfd, iHdrOff+8,
fd90: 70 4e 52 65 63 29 29 0a 20 20 20 7c 7c 20 53 51 pNRec)). || SQ
fda0: 4c 49 54 45 5f 4f 4b 21 3d 28 72 63 20 3d 20 72 LITE_OK!=(rc = r
fdb0: 65 61 64 33 32 62 69 74 73 28 70 50 61 67 65 72 ead32bits(pPager
fdc0: 2d 3e 6a 66 64 2c 20 69 48 64 72 4f 66 66 2b 31 ->jfd, iHdrOff+1
fdd0: 32 2c 20 26 70 50 61 67 65 72 2d 3e 63 6b 73 75 2, &pPager->cksu
fde0: 6d 49 6e 69 74 29 29 0a 20 20 20 7c 7c 20 53 51 mInit)). || SQ
fdf0: 4c 49 54 45 5f 4f 4b 21 3d 28 72 63 20 3d 20 72 LITE_OK!=(rc = r
fe00: 65 61 64 33 32 62 69 74 73 28 70 50 61 67 65 72 ead32bits(pPager
fe10: 2d 3e 6a 66 64 2c 20 69 48 64 72 4f 66 66 2b 31 ->jfd, iHdrOff+1
fe20: 36 2c 20 70 44 62 53 69 7a 65 29 29 0a 20 20 29 6, pDbSize)). )
fe30: 7b 0a 20 20 20 20 72 65 74 75 72 6e 20 72 63 3b {. return rc;
fe40: 0a 20 20 7d 0a 0a 20 20 69 66 28 20 70 50 61 67 . }.. if( pPag
fe50: 65 72 2d 3e 6a 6f 75 72 6e 61 6c 4f 66 66 3d 3d er->journalOff==
fe60: 30 20 29 7b 0a 20 20 20 20 75 33 32 20 69 50 61 0 ){. u32 iPa
fe70: 67 65 53 69 7a 65 3b 20 20 20 20 20 20 20 20 20 geSize;
fe80: 20 20 20 20 20 20 2f 2a 20 50 61 67 65 2d 73 69 /* Page-si
fe90: 7a 65 20 66 69 65 6c 64 20 6f 66 20 6a 6f 75 72 ze field of jour
fea0: 6e 61 6c 20 68 65 61 64 65 72 20 2a 2f 0a 20 20 nal header */.
feb0: 20 20 75 33 32 20 69 53 65 63 74 6f 72 53 69 7a u32 iSectorSiz
fec0: 65 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 2f e; /
fed0: 2a 20 53 65 63 74 6f 72 2d 73 69 7a 65 20 66 69 * Sector-size fi
fee0: 65 6c 64 20 6f 66 20 6a 6f 75 72 6e 61 6c 20 68 eld of journal h
fef0: 65 61 64 65 72 20 2a 2f 0a 0a 20 20 20 20 2f 2a eader */.. /*
ff00: 20 52 65 61 64 20 74 68 65 20 70 61 67 65 2d 73 Read the page-s
ff10: 69 7a 65 20 61 6e 64 20 73 65 63 74 6f 72 2d 73 ize and sector-s
ff20: 69 7a 65 20 6a 6f 75 72 6e 61 6c 20 68 65 61 64 ize journal head
ff30: 65 72 20 66 69 65 6c 64 73 2e 20 2a 2f 0a 20 20 er fields. */.
ff40: 20 20 69 66 28 20 53 51 4c 49 54 45 5f 4f 4b 21 if( SQLITE_OK!
ff50: 3d 28 72 63 20 3d 20 72 65 61 64 33 32 62 69 74 =(rc = read32bit
ff60: 73 28 70 50 61 67 65 72 2d 3e 6a 66 64 2c 20 69 s(pPager->jfd, i
ff70: 48 64 72 4f 66 66 2b 32 30 2c 20 26 69 53 65 63 HdrOff+20, &iSec
ff80: 74 6f 72 53 69 7a 65 29 29 0a 20 20 20 20 20 7c torSize)). |
ff90: 7c 20 53 51 4c 49 54 45 5f 4f 4b 21 3d 28 72 63 | SQLITE_OK!=(rc
ffa0: 20 3d 20 72 65 61 64 33 32 62 69 74 73 28 70 50 = read32bits(pP
ffb0: 61 67 65 72 2d 3e 6a 66 64 2c 20 69 48 64 72 4f ager->jfd, iHdrO
ffc0: 66 66 2b 32 34 2c 20 26 69 50 61 67 65 53 69 7a ff+24, &iPageSiz
ffd0: 65 29 29 0a 20 20 20 20 29 7b 0a 20 20 20 20 20 e)). ){.
ffe0: 20 72 65 74 75 72 6e 20 72 63 3b 0a 20 20 20 20 return rc;.
fff0: 7d 0a 0a 20 20 20 20 2f 2a 20 56 65 72 73 69 6f }.. /* Versio
10000 6e 73 20 6f 66 20 53 51 4c 69 74 65 20 70 72 69 ns of SQLite pri
10010 6f 72 20 74 6f 20 33 2e 35 2e 38 20 73 65 74 20 or to 3.5.8 set
10020 74 68 65 20 70 61 67 65 2d 73 69 7a 65 20 66 69 the page-size fi
10030 65 6c 64 20 6f 66 20 74 68 65 0a 20 20 20 20 2a eld of the. *
10040 2a 20 6a 6f 75 72 6e 61 6c 20 68 65 61 64 65 72 * journal header
10050 20 74 6f 20 7a 65 72 6f 2e 20 49 6e 20 74 68 69 to zero. In thi
10060 73 20 63 61 73 65 2c 20 61 73 73 75 6d 65 20 74 s case, assume t
10070 68 61 74 20 74 68 65 20 50 61 67 65 72 2e 70 61 hat the Pager.pa
10080 67 65 53 69 7a 65 0a 20 20 20 20 2a 2a 20 76 61 geSize. ** va
10090 72 69 61 62 6c 65 20 69 73 20 61 6c 72 65 61 64 riable is alread
100a0 79 20 73 65 74 20 74 6f 20 74 68 65 20 63 6f 72 y set to the cor
100b0 72 65 63 74 20 70 61 67 65 20 73 69 7a 65 2e 0a rect page size..
100c0 20 20 20 20 2a 2f 0a 20 20 20 20 69 66 28 20 69 */. if( i
100d0 50 61 67 65 53 69 7a 65 3d 3d 30 20 29 7b 0a 20 PageSize==0 ){.
100e0 20 20 20 20 20 69 50 61 67 65 53 69 7a 65 20 3d iPageSize =
100f0 20 70 50 61 67 65 72 2d 3e 70 61 67 65 53 69 7a pPager->pageSiz
10100 65 3b 0a 20 20 20 20 7d 0a 0a 20 20 20 20 2f 2a e;. }.. /*
10110 20 43 68 65 63 6b 20 74 68 61 74 20 74 68 65 20 Check that the
10120 76 61 6c 75 65 73 20 72 65 61 64 20 66 72 6f 6d values read from
10130 20 74 68 65 20 70 61 67 65 2d 73 69 7a 65 20 61 the page-size a
10140 6e 64 20 73 65 63 74 6f 72 2d 73 69 7a 65 20 66 nd sector-size f
10150 69 65 6c 64 73 0a 20 20 20 20 2a 2a 20 61 72 65 ields. ** are
10160 20 77 69 74 68 69 6e 20 72 61 6e 67 65 2e 20 54 within range. T
10170 6f 20 62 65 20 27 69 6e 20 72 61 6e 67 65 27 2c o be 'in range',
10180 20 62 6f 74 68 20 76 61 6c 75 65 73 20 6e 65 65 both values nee
10190 64 20 74 6f 20 62 65 20 61 20 70 6f 77 65 72 0a d to be a power.
101a0 20 20 20 20 2a 2a 20 6f 66 20 74 77 6f 20 67 72 ** of two gr
101b0 65 61 74 65 72 20 74 68 61 6e 20 6f 72 20 65 71 eater than or eq
101c0 75 61 6c 20 74 6f 20 35 31 32 20 6f 72 20 33 32 ual to 512 or 32
101d0 2c 20 61 6e 64 20 6e 6f 74 20 67 72 65 61 74 65 , and not greate
101e0 72 20 74 68 61 6e 20 74 68 65 69 72 20 0a 20 20 r than their .
101f0 20 20 2a 2a 20 72 65 73 70 65 63 74 69 76 65 20 ** respective
10200 63 6f 6d 70 69 6c 65 20 74 69 6d 65 20 6d 61 78 compile time max
10210 69 6d 75 6d 20 6c 69 6d 69 74 73 2e 0a 20 20 20 imum limits..
10220 20 2a 2f 0a 20 20 20 20 69 66 28 20 69 50 61 67 */. if( iPag
10230 65 53 69 7a 65 3c 35 31 32 20 20 20 20 20 20 20 eSize<512
10240 20 20 20 20 20 20 20 20 20 20 20 7c 7c 20 69 53 || iS
10250 65 63 74 6f 72 53 69 7a 65 3c 33 32 0a 20 20 20 ectorSize<32.
10260 20 20 7c 7c 20 69 50 61 67 65 53 69 7a 65 3e 53 || iPageSize>S
10270 51 4c 49 54 45 5f 4d 41 58 5f 50 41 47 45 5f 53 QLITE_MAX_PAGE_S
10280 49 5a 45 20 7c 7c 20 69 53 65 63 74 6f 72 53 69 IZE || iSectorSi
10290 7a 65 3e 4d 41 58 5f 53 45 43 54 4f 52 5f 53 49 ze>MAX_SECTOR_SI
102a0 5a 45 0a 20 20 20 20 20 7c 7c 20 28 28 69 50 61 ZE. || ((iPa
102b0 67 65 53 69 7a 65 2d 31 29 26 69 50 61 67 65 53 geSize-1)&iPageS
102c0 69 7a 65 29 21 3d 30 20 20 20 7c 7c 20 28 28 69 ize)!=0 || ((i
102d0 53 65 63 74 6f 72 53 69 7a 65 2d 31 29 26 69 53 SectorSize-1)&iS
102e0 65 63 74 6f 72 53 69 7a 65 29 21 3d 30 20 0a 20 ectorSize)!=0 .
102f0 20 20 20 29 7b 0a 20 20 20 20 20 20 2f 2a 20 49 ){. /* I
10300 66 20 74 68 65 20 65 69 74 68 65 72 20 74 68 65 f the either the
10310 20 70 61 67 65 2d 73 69 7a 65 20 6f 72 20 73 65 page-size or se
10320 63 74 6f 72 2d 73 69 7a 65 20 69 6e 20 74 68 65 ctor-size in the
10330 20 6a 6f 75 72 6e 61 6c 2d 68 65 61 64 65 72 20 journal-header
10340 69 73 20 0a 20 20 20 20 20 20 2a 2a 20 69 6e 76 is . ** inv
10350 61 6c 69 64 2c 20 74 68 65 6e 20 74 68 65 20 70 alid, then the p
10360 72 6f 63 65 73 73 20 74 68 61 74 20 77 72 6f 74 rocess that wrot
10370 65 20 74 68 65 20 6a 6f 75 72 6e 61 6c 2d 68 65 e the journal-he
10380 61 64 65 72 20 6d 75 73 74 20 68 61 76 65 20 0a ader must have .
10390 20 20 20 20 20 20 2a 2a 20 63 72 61 73 68 65 64 ** crashed
103a0 20 62 65 66 6f 72 65 20 74 68 65 20 68 65 61 64 before the head
103b0 65 72 20 77 61 73 20 73 79 6e 63 65 64 2e 20 49 er was synced. I
103c0 6e 20 74 68 69 73 20 63 61 73 65 20 73 74 6f 70 n this case stop
103d0 20 72 65 61 64 69 6e 67 20 0a 20 20 20 20 20 20 reading .
103e0 2a 2a 20 74 68 65 20 6a 6f 75 72 6e 61 6c 20 66 ** the journal f
103f0 69 6c 65 20 68 65 72 65 2e 0a 20 20 20 20 20 20 ile here..
10400 2a 2f 0a 20 20 20 20 20 20 72 65 74 75 72 6e 20 */. return
10410 53 51 4c 49 54 45 5f 44 4f 4e 45 3b 0a 20 20 20 SQLITE_DONE;.
10420 20 7d 0a 0a 20 20 20 20 2f 2a 20 55 70 64 61 74 }.. /* Updat
10430 65 20 74 68 65 20 70 61 67 65 2d 73 69 7a 65 20 e the page-size
10440 74 6f 20 6d 61 74 63 68 20 74 68 65 20 76 61 6c to match the val
10450 75 65 20 72 65 61 64 20 66 72 6f 6d 20 74 68 65 ue read from the
10460 20 6a 6f 75 72 6e 61 6c 2e 20 0a 20 20 20 20 2a journal. . *
10470 2a 20 55 73 65 20 61 20 74 65 73 74 63 61 73 65 * Use a testcase
10480 28 29 20 6d 61 63 72 6f 20 74 6f 20 6d 61 6b 65 () macro to make
10490 20 73 75 72 65 20 74 68 61 74 20 6d 61 6c 6c 6f sure that mallo
104a0 63 20 66 61 69 6c 75 72 65 20 77 69 74 68 69 6e c failure within
104b0 20 0a 20 20 20 20 2a 2a 20 50 61 67 65 72 53 65 . ** PagerSe
104c0 74 50 61 67 65 73 69 7a 65 28 29 20 69 73 20 74 tPagesize() is t
104d0 65 73 74 65 64 2e 0a 20 20 20 20 2a 2f 0a 20 20 ested.. */.
104e0 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33 50 61 rc = sqlite3Pa
104f0 67 65 72 53 65 74 50 61 67 65 73 69 7a 65 28 70 gerSetPagesize(p
10500 50 61 67 65 72 2c 20 26 69 50 61 67 65 53 69 7a Pager, &iPageSiz
10510 65 2c 20 2d 31 29 3b 0a 20 20 20 20 74 65 73 74 e, -1);. test
10520 63 61 73 65 28 20 72 63 21 3d 53 51 4c 49 54 45 case( rc!=SQLITE
10530 5f 4f 4b 20 29 3b 0a 0a 20 20 20 20 2f 2a 20 55 _OK );.. /* U
10540 70 64 61 74 65 20 74 68 65 20 61 73 73 75 6d 65 pdate the assume
10550 64 20 73 65 63 74 6f 72 2d 73 69 7a 65 20 74 6f d sector-size to
10560 20 6d 61 74 63 68 20 74 68 65 20 76 61 6c 75 65 match the value
10570 20 75 73 65 64 20 62 79 20 0a 20 20 20 20 2a 2a used by . **
10580 20 74 68 65 20 70 72 6f 63 65 73 73 20 74 68 61 the process tha
10590 74 20 63 72 65 61 74 65 64 20 74 68 69 73 20 6a t created this j
105a0 6f 75 72 6e 61 6c 2e 20 49 66 20 74 68 69 73 20 ournal. If this
105b0 6a 6f 75 72 6e 61 6c 20 77 61 73 0a 20 20 20 20 journal was.
105c0 2a 2a 20 63 72 65 61 74 65 64 20 62 79 20 61 20 ** created by a
105d0 70 72 6f 63 65 73 73 20 6f 74 68 65 72 20 74 68 process other th
105e0 61 6e 20 74 68 69 73 20 6f 6e 65 2c 20 74 68 65 an this one, the
105f0 6e 20 74 68 69 73 20 72 6f 75 74 69 6e 65 0a 20 n this routine.
10600 20 20 20 2a 2a 20 69 73 20 62 65 69 6e 67 20 63 ** is being c
10610 61 6c 6c 65 64 20 66 72 6f 6d 20 77 69 74 68 69 alled from withi
10620 6e 20 70 61 67 65 72 5f 70 6c 61 79 62 61 63 6b n pager_playback
10630 28 29 2e 20 54 68 65 20 6c 6f 63 61 6c 20 76 61 (). The local va
10640 6c 75 65 0a 20 20 20 20 2a 2a 20 6f 66 20 50 61 lue. ** of Pa
10650 67 65 72 2e 73 65 63 74 6f 72 53 69 7a 65 20 69 ger.sectorSize i
10660 73 20 72 65 73 74 6f 72 65 64 20 61 74 20 74 68 s restored at th
10670 65 20 65 6e 64 20 6f 66 20 74 68 61 74 20 72 6f e end of that ro
10680 75 74 69 6e 65 2e 0a 20 20 20 20 2a 2f 0a 20 20 utine.. */.
10690 20 20 70 50 61 67 65 72 2d 3e 73 65 63 74 6f 72 pPager->sector
106a0 53 69 7a 65 20 3d 20 69 53 65 63 74 6f 72 53 69 Size = iSectorSi
106b0 7a 65 3b 0a 20 20 7d 0a 0a 20 20 70 50 61 67 65 ze;. }.. pPage
106c0 72 2d 3e 6a 6f 75 72 6e 61 6c 4f 66 66 20 2b 3d r->journalOff +=
106d0 20 4a 4f 55 52 4e 41 4c 5f 48 44 52 5f 53 5a 28 JOURNAL_HDR_SZ(
106e0 70 50 61 67 65 72 29 3b 0a 20 20 72 65 74 75 72 pPager);. retur
106f0 6e 20 72 63 3b 0a 7d 0a 0a 0a 2f 2a 0a 2a 2a 20 n rc;.}.../*.**
10700 57 72 69 74 65 20 74 68 65 20 73 75 70 70 6c 69 Write the suppli
10710 65 64 20 6d 61 73 74 65 72 20 6a 6f 75 72 6e 61 ed master journa
10720 6c 20 6e 61 6d 65 20 69 6e 74 6f 20 74 68 65 20 l name into the
10730 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 20 66 6f 72 journal file for
10740 20 70 61 67 65 72 0a 2a 2a 20 70 50 61 67 65 72 pager.** pPager
10750 20 61 74 20 74 68 65 20 63 75 72 72 65 6e 74 20 at the current
10760 6c 6f 63 61 74 69 6f 6e 2e 20 54 68 65 20 6d 61 location. The ma
10770 73 74 65 72 20 6a 6f 75 72 6e 61 6c 20 6e 61 6d ster journal nam
10780 65 20 6d 75 73 74 20 62 65 20 74 68 65 20 6c 61 e must be the la
10790 73 74 0a 2a 2a 20 74 68 69 6e 67 20 77 72 69 74 st.** thing writ
107a0 74 65 6e 20 74 6f 20 61 20 6a 6f 75 72 6e 61 6c ten to a journal
107b0 20 66 69 6c 65 2e 20 49 66 20 74 68 65 20 70 61 file. If the pa
107c0 67 65 72 20 69 73 20 69 6e 20 66 75 6c 6c 2d 73 ger is in full-s
107d0 79 6e 63 20 6d 6f 64 65 2c 20 74 68 65 0a 2a 2a ync mode, the.**
107e0 20 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 20 64 65 journal file de
107f0 73 63 72 69 70 74 6f 72 20 69 73 20 61 64 76 61 scriptor is adva
10800 6e 63 65 64 20 74 6f 20 74 68 65 20 6e 65 78 74 nced to the next
10810 20 73 65 63 74 6f 72 20 62 6f 75 6e 64 61 72 79 sector boundary
10820 20 62 65 66 6f 72 65 0a 2a 2a 20 61 6e 79 74 68 before.** anyth
10830 69 6e 67 20 69 73 20 77 72 69 74 74 65 6e 2e 20 ing is written.
10840 54 68 65 20 66 6f 72 6d 61 74 20 69 73 3a 0a 2a The format is:.*
10850 2a 0a 2a 2a 20 20 20 2b 20 34 20 62 79 74 65 73 *.** + 4 bytes
10860 3a 20 50 41 47 45 52 5f 4d 4a 5f 50 47 4e 4f 2e : PAGER_MJ_PGNO.
10870 0a 2a 2a 20 20 20 2b 20 4e 20 62 79 74 65 73 3a .** + N bytes:
10880 20 4d 61 73 74 65 72 20 6a 6f 75 72 6e 61 6c 20 Master journal
10890 66 69 6c 65 6e 61 6d 65 20 69 6e 20 75 74 66 2d filename in utf-
108a0 38 2e 0a 2a 2a 20 20 20 2b 20 34 20 62 79 74 65 8..** + 4 byte
108b0 73 3a 20 4e 20 28 6c 65 6e 67 74 68 20 6f 66 20 s: N (length of
108c0 6d 61 73 74 65 72 20 6a 6f 75 72 6e 61 6c 20 6e master journal n
108d0 61 6d 65 20 69 6e 20 62 79 74 65 73 2c 20 6e 6f ame in bytes, no
108e0 20 6e 75 6c 2d 74 65 72 6d 69 6e 61 74 6f 72 29 nul-terminator)
108f0 2e 0a 2a 2a 20 20 20 2b 20 34 20 62 79 74 65 73 ..** + 4 bytes
10900 3a 20 4d 61 73 74 65 72 20 6a 6f 75 72 6e 61 6c : Master journal
10910 20 6e 61 6d 65 20 63 68 65 63 6b 73 75 6d 2e 0a name checksum..
10920 2a 2a 20 20 20 2b 20 38 20 62 79 74 65 73 3a 20 ** + 8 bytes:
10930 61 4a 6f 75 72 6e 61 6c 4d 61 67 69 63 5b 5d 2e aJournalMagic[].
10940 0a 2a 2a 0a 2a 2a 20 54 68 65 20 6d 61 73 74 65 .**.** The maste
10950 72 20 6a 6f 75 72 6e 61 6c 20 70 61 67 65 20 63 r journal page c
10960 68 65 63 6b 73 75 6d 20 69 73 20 74 68 65 20 73 hecksum is the s
10970 75 6d 20 6f 66 20 74 68 65 20 62 79 74 65 73 20 um of the bytes
10980 69 6e 20 74 68 65 20 6d 61 73 74 65 72 0a 2a 2a in the master.**
10990 20 6a 6f 75 72 6e 61 6c 20 6e 61 6d 65 2c 20 77 journal name, w
109a0 68 65 72 65 20 65 61 63 68 20 62 79 74 65 20 69 here each byte i
109b0 73 20 69 6e 74 65 72 70 72 65 74 65 64 20 61 73 s interpreted as
109c0 20 61 20 73 69 67 6e 65 64 20 38 2d 62 69 74 20 a signed 8-bit
109d0 69 6e 74 65 67 65 72 2e 0a 2a 2a 0a 2a 2a 20 49 integer..**.** I
109e0 66 20 7a 4d 61 73 74 65 72 20 69 73 20 61 20 4e f zMaster is a N
109f0 55 4c 4c 20 70 6f 69 6e 74 65 72 20 28 6f 63 63 ULL pointer (occ
10a00 75 72 73 20 66 6f 72 20 61 20 73 69 6e 67 6c 65 urs for a single
10a10 20 64 61 74 61 62 61 73 65 20 74 72 61 6e 73 61 database transa
10a20 63 74 69 6f 6e 29 2c 20 0a 2a 2a 20 74 68 69 73 ction), .** this
10a30 20 63 61 6c 6c 20 69 73 20 61 20 6e 6f 2d 6f 70 call is a no-op
10a40 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74 20 ..*/.static int
10a50 77 72 69 74 65 4d 61 73 74 65 72 4a 6f 75 72 6e writeMasterJourn
10a60 61 6c 28 50 61 67 65 72 20 2a 70 50 61 67 65 72 al(Pager *pPager
10a70 2c 20 63 6f 6e 73 74 20 63 68 61 72 20 2a 7a 4d , const char *zM
10a80 61 73 74 65 72 29 7b 0a 20 20 69 6e 74 20 72 63 aster){. int rc
10a90 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 ;
10aa0 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 52 65 /* Re
10ab0 74 75 72 6e 20 63 6f 64 65 20 2a 2f 0a 20 20 69 turn code */. i
10ac0 6e 74 20 6e 4d 61 73 74 65 72 3b 20 20 20 20 20 nt nMaster;
10ad0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
10ae0 2f 2a 20 4c 65 6e 67 74 68 20 6f 66 20 73 74 72 /* Length of str
10af0 69 6e 67 20 7a 4d 61 73 74 65 72 20 2a 2f 0a 20 ing zMaster */.
10b00 20 69 36 34 20 69 48 64 72 4f 66 66 3b 20 20 20 i64 iHdrOff;
10b10 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
10b20 20 20 2f 2a 20 4f 66 66 73 65 74 20 6f 66 20 68 /* Offset of h
10b30 65 61 64 65 72 20 69 6e 20 6a 6f 75 72 6e 61 6c eader in journal
10b40 20 66 69 6c 65 20 2a 2f 0a 20 20 69 36 34 20 6a file */. i64 j
10b50 72 6e 6c 53 69 7a 65 3b 20 20 20 20 20 20 20 20 rnlSize;
10b60 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 53 /* S
10b70 69 7a 65 20 6f 66 20 6a 6f 75 72 6e 61 6c 20 66 ize of journal f
10b80 69 6c 65 20 6f 6e 20 64 69 73 6b 20 2a 2f 0a 20 ile on disk */.
10b90 20 75 33 32 20 63 6b 73 75 6d 20 3d 20 30 3b 20 u32 cksum = 0;
10ba0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
10bb0 20 20 2f 2a 20 43 68 65 63 6b 73 75 6d 20 6f 66 /* Checksum of
10bc0 20 73 74 72 69 6e 67 20 7a 4d 61 73 74 65 72 20 string zMaster
10bd0 2a 2f 0a 0a 20 20 61 73 73 65 72 74 28 20 70 50 */.. assert( pP
10be0 61 67 65 72 2d 3e 73 65 74 4d 61 73 74 65 72 3d ager->setMaster=
10bf0 3d 30 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 =0 );. assert(
10c00 21 70 61 67 65 72 55 73 65 57 61 6c 28 70 50 61 !pagerUseWal(pPa
10c10 67 65 72 29 20 29 3b 0a 0a 20 20 69 66 28 20 21 ger) );.. if( !
10c20 7a 4d 61 73 74 65 72 20 0a 20 20 20 7c 7c 20 70 zMaster . || p
10c30 50 61 67 65 72 2d 3e 6a 6f 75 72 6e 61 6c 4d 6f Pager->journalMo
10c40 64 65 3d 3d 50 41 47 45 52 5f 4a 4f 55 52 4e 41 de==PAGER_JOURNA
10c50 4c 4d 4f 44 45 5f 4d 45 4d 4f 52 59 20 0a 20 20 LMODE_MEMORY .
10c60 20 7c 7c 20 21 69 73 4f 70 65 6e 28 70 50 61 67 || !isOpen(pPag
10c70 65 72 2d 3e 6a 66 64 29 0a 20 20 29 7b 0a 20 20 er->jfd). ){.
10c80 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f return SQLITE_
10c90 4f 4b 3b 0a 20 20 7d 0a 20 20 70 50 61 67 65 72 OK;. }. pPager
10ca0 2d 3e 73 65 74 4d 61 73 74 65 72 20 3d 20 31 3b ->setMaster = 1;
10cb0 0a 20 20 61 73 73 65 72 74 28 20 70 50 61 67 65 . assert( pPage
10cc0 72 2d 3e 6a 6f 75 72 6e 61 6c 48 64 72 20 3c 3d r->journalHdr <=
10cd0 20 70 50 61 67 65 72 2d 3e 6a 6f 75 72 6e 61 6c pPager->journal
10ce0 4f 66 66 20 29 3b 0a 0a 20 20 2f 2a 20 43 61 6c Off );.. /* Cal
10cf0 63 75 6c 61 74 65 20 74 68 65 20 6c 65 6e 67 74 culate the lengt
10d00 68 20 69 6e 20 62 79 74 65 73 20 61 6e 64 20 74 h in bytes and t
10d10 68 65 20 63 68 65 63 6b 73 75 6d 20 6f 66 20 7a he checksum of z
10d20 4d 61 73 74 65 72 20 2a 2f 0a 20 20 66 6f 72 28 Master */. for(
10d30 6e 4d 61 73 74 65 72 3d 30 3b 20 7a 4d 61 73 74 nMaster=0; zMast
10d40 65 72 5b 6e 4d 61 73 74 65 72 5d 3b 20 6e 4d 61 er[nMaster]; nMa
10d50 73 74 65 72 2b 2b 29 7b 0a 20 20 20 20 63 6b 73 ster++){. cks
10d60 75 6d 20 2b 3d 20 7a 4d 61 73 74 65 72 5b 6e 4d um += zMaster[nM
10d70 61 73 74 65 72 5d 3b 0a 20 20 7d 0a 0a 20 20 2f aster];. }.. /
10d80 2a 20 49 66 20 69 6e 20 66 75 6c 6c 2d 73 79 6e * If in full-syn
10d90 63 20 6d 6f 64 65 2c 20 61 64 76 61 6e 63 65 20 c mode, advance
10da0 74 6f 20 74 68 65 20 6e 65 78 74 20 64 69 73 6b to the next disk
10db0 20 73 65 63 74 6f 72 20 62 65 66 6f 72 65 20 77 sector before w
10dc0 72 69 74 69 6e 67 0a 20 20 2a 2a 20 74 68 65 20 riting. ** the
10dd0 6d 61 73 74 65 72 20 6a 6f 75 72 6e 61 6c 20 6e master journal n
10de0 61 6d 65 2e 20 54 68 69 73 20 69 73 20 69 6e 20 ame. This is in
10df0 63 61 73 65 20 74 68 65 20 70 72 65 76 69 6f 75 case the previou
10e00 73 20 70 61 67 65 20 77 72 69 74 74 65 6e 20 74 s page written t
10e10 6f 0a 20 20 2a 2a 20 74 68 65 20 6a 6f 75 72 6e o. ** the journ
10e20 61 6c 20 68 61 73 20 61 6c 72 65 61 64 79 20 62 al has already b
10e30 65 65 6e 20 73 79 6e 63 65 64 2e 0a 20 20 2a 2f een synced.. */
10e40 0a 20 20 69 66 28 20 70 50 61 67 65 72 2d 3e 66 . if( pPager->f
10e50 75 6c 6c 53 79 6e 63 20 29 7b 0a 20 20 20 20 70 ullSync ){. p
10e60 50 61 67 65 72 2d 3e 6a 6f 75 72 6e 61 6c 4f 66 Pager->journalOf
10e70 66 20 3d 20 6a 6f 75 72 6e 61 6c 48 64 72 4f 66 f = journalHdrOf
10e80 66 73 65 74 28 70 50 61 67 65 72 29 3b 0a 20 20 fset(pPager);.
10e90 7d 0a 20 20 69 48 64 72 4f 66 66 20 3d 20 70 50 }. iHdrOff = pP
10ea0 61 67 65 72 2d 3e 6a 6f 75 72 6e 61 6c 4f 66 66 ager->journalOff
10eb0 3b 0a 0a 20 20 2f 2a 20 57 72 69 74 65 20 74 68 ;.. /* Write th
10ec0 65 20 6d 61 73 74 65 72 20 6a 6f 75 72 6e 61 6c e master journal
10ed0 20 64 61 74 61 20 74 6f 20 74 68 65 20 65 6e 64 data to the end
10ee0 20 6f 66 20 74 68 65 20 6a 6f 75 72 6e 61 6c 20 of the journal
10ef0 66 69 6c 65 2e 20 49 66 0a 20 20 2a 2a 20 61 6e file. If. ** an
10f00 20 65 72 72 6f 72 20 6f 63 63 75 72 73 2c 20 72 error occurs, r
10f10 65 74 75 72 6e 20 74 68 65 20 65 72 72 6f 72 20 eturn the error
10f20 63 6f 64 65 20 74 6f 20 74 68 65 20 63 61 6c 6c code to the call
10f30 65 72 2e 0a 20 20 2a 2f 0a 20 20 69 66 28 20 28 er.. */. if( (
10f40 30 20 21 3d 20 28 72 63 20 3d 20 77 72 69 74 65 0 != (rc = write
10f50 33 32 62 69 74 73 28 70 50 61 67 65 72 2d 3e 6a 32bits(pPager->j
10f60 66 64 2c 20 69 48 64 72 4f 66 66 2c 20 50 41 47 fd, iHdrOff, PAG
10f70 45 52 5f 4d 4a 5f 50 47 4e 4f 28 70 50 61 67 65 ER_MJ_PGNO(pPage
10f80 72 29 29 29 29 0a 20 20 20 7c 7c 20 28 30 20 21 r)))). || (0 !
10f90 3d 20 28 72 63 20 3d 20 73 71 6c 69 74 65 33 4f = (rc = sqlite3O
10fa0 73 57 72 69 74 65 28 70 50 61 67 65 72 2d 3e 6a sWrite(pPager->j
10fb0 66 64 2c 20 7a 4d 61 73 74 65 72 2c 20 6e 4d 61 fd, zMaster, nMa
10fc0 73 74 65 72 2c 20 69 48 64 72 4f 66 66 2b 34 29 ster, iHdrOff+4)
10fd0 29 29 0a 20 20 20 7c 7c 20 28 30 20 21 3d 20 28 )). || (0 != (
10fe0 72 63 20 3d 20 77 72 69 74 65 33 32 62 69 74 73 rc = write32bits
10ff0 28 70 50 61 67 65 72 2d 3e 6a 66 64 2c 20 69 48 (pPager->jfd, iH
11000 64 72 4f 66 66 2b 34 2b 6e 4d 61 73 74 65 72 2c drOff+4+nMaster,
11010 20 6e 4d 61 73 74 65 72 29 29 29 0a 20 20 20 7c nMaster))). |
11020 7c 20 28 30 20 21 3d 20 28 72 63 20 3d 20 77 72 | (0 != (rc = wr
11030 69 74 65 33 32 62 69 74 73 28 70 50 61 67 65 72 ite32bits(pPager
11040 2d 3e 6a 66 64 2c 20 69 48 64 72 4f 66 66 2b 34 ->jfd, iHdrOff+4
11050 2b 6e 4d 61 73 74 65 72 2b 34 2c 20 63 6b 73 75 +nMaster+4, cksu
11060 6d 29 29 29 0a 20 20 20 7c 7c 20 28 30 20 21 3d m))). || (0 !=
11070 20 28 72 63 20 3d 20 73 71 6c 69 74 65 33 4f 73 (rc = sqlite3Os
11080 57 72 69 74 65 28 70 50 61 67 65 72 2d 3e 6a 66 Write(pPager->jf
11090 64 2c 20 61 4a 6f 75 72 6e 61 6c 4d 61 67 69 63 d, aJournalMagic
110a0 2c 20 38 2c 0a 20 20 20 20 20 20 20 20 20 20 20 , 8,.
110b0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
110c0 20 20 20 20 20 20 69 48 64 72 4f 66 66 2b 34 2b iHdrOff+4+
110d0 6e 4d 61 73 74 65 72 2b 38 29 29 29 0a 20 20 29 nMaster+8))). )
110e0 7b 0a 20 20 20 20 72 65 74 75 72 6e 20 72 63 3b {. return rc;
110f0 0a 20 20 7d 0a 20 20 70 50 61 67 65 72 2d 3e 6a . }. pPager->j
11100 6f 75 72 6e 61 6c 4f 66 66 20 2b 3d 20 28 6e 4d ournalOff += (nM
11110 61 73 74 65 72 2b 32 30 29 3b 0a 0a 20 20 2f 2a aster+20);.. /*
11120 20 49 66 20 74 68 65 20 70 61 67 65 72 20 69 73 If the pager is
11130 20 69 6e 20 70 65 72 69 73 74 65 6e 74 2d 6a 6f in peristent-jo
11140 75 72 6e 61 6c 20 6d 6f 64 65 2c 20 74 68 65 6e urnal mode, then
11150 20 74 68 65 20 70 68 79 73 69 63 61 6c 20 0a 20 the physical .
11160 20 2a 2a 20 6a 6f 75 72 6e 61 6c 2d 66 69 6c 65 ** journal-file
11170 20 6d 61 79 20 65 78 74 65 6e 64 20 70 61 73 74 may extend past
11180 20 74 68 65 20 65 6e 64 20 6f 66 20 74 68 65 20 the end of the
11190 6d 61 73 74 65 72 2d 6a 6f 75 72 6e 61 6c 20 6e master-journal n
111a0 61 6d 65 0a 20 20 2a 2a 20 61 6e 64 20 38 20 62 ame. ** and 8 b
111b0 79 74 65 73 20 6f 66 20 6d 61 67 69 63 20 64 61 ytes of magic da
111c0 74 61 20 6a 75 73 74 20 77 72 69 74 74 65 6e 20 ta just written
111d0 74 6f 20 74 68 65 20 66 69 6c 65 2e 20 54 68 69 to the file. Thi
111e0 73 20 69 73 20 0a 20 20 2a 2a 20 64 61 6e 67 65 s is . ** dange
111f0 72 6f 75 73 20 62 65 63 61 75 73 65 20 74 68 65 rous because the
11200 20 63 6f 64 65 20 74 6f 20 72 6f 6c 6c 62 61 63 code to rollbac
11210 6b 20 61 20 68 6f 74 2d 6a 6f 75 72 6e 61 6c 20 k a hot-journal
11220 66 69 6c 65 0a 20 20 2a 2a 20 77 69 6c 6c 20 6e file. ** will n
11230 6f 74 20 62 65 20 61 62 6c 65 20 74 6f 20 66 69 ot be able to fi
11240 6e 64 20 74 68 65 20 6d 61 73 74 65 72 2d 6a 6f nd the master-jo
11250 75 72 6e 61 6c 20 6e 61 6d 65 20 74 6f 20 64 65 urnal name to de
11260 74 65 72 6d 69 6e 65 20 0a 20 20 2a 2a 20 77 68 termine . ** wh
11270 65 74 68 65 72 20 6f 72 20 6e 6f 74 20 74 68 65 ether or not the
11280 20 6a 6f 75 72 6e 61 6c 20 69 73 20 68 6f 74 2e journal is hot.
11290 20 0a 20 20 2a 2a 0a 20 20 2a 2a 20 45 61 73 69 . **. ** Easi
112a0 65 73 74 20 74 68 69 6e 67 20 74 6f 20 64 6f 20 est thing to do
112b0 69 6e 20 74 68 69 73 20 73 63 65 6e 61 72 69 6f in this scenario
112c0 20 69 73 20 74 6f 20 74 72 75 6e 63 61 74 65 20 is to truncate
112d0 74 68 65 20 6a 6f 75 72 6e 61 6c 20 0a 20 20 2a the journal . *
112e0 2a 20 66 69 6c 65 20 74 6f 20 74 68 65 20 72 65 * file to the re
112f0 71 75 69 72 65 64 20 73 69 7a 65 2e 0a 20 20 2a quired size.. *
11300 2f 20 0a 20 20 69 66 28 20 53 51 4c 49 54 45 5f / . if( SQLITE_
11310 4f 4b 3d 3d 28 72 63 20 3d 20 73 71 6c 69 74 65 OK==(rc = sqlite
11320 33 4f 73 46 69 6c 65 53 69 7a 65 28 70 50 61 67 3OsFileSize(pPag
11330 65 72 2d 3e 6a 66 64 2c 20 26 6a 72 6e 6c 53 69 er->jfd, &jrnlSi
11340 7a 65 29 29 0a 20 20 20 26 26 20 6a 72 6e 6c 53 ze)). && jrnlS
11350 69 7a 65 3e 70 50 61 67 65 72 2d 3e 6a 6f 75 72 ize>pPager->jour
11360 6e 61 6c 4f 66 66 0a 20 20 29 7b 0a 20 20 20 20 nalOff. ){.
11370 72 63 20 3d 20 73 71 6c 69 74 65 33 4f 73 54 72 rc = sqlite3OsTr
11380 75 6e 63 61 74 65 28 70 50 61 67 65 72 2d 3e 6a uncate(pPager->j
11390 66 64 2c 20 70 50 61 67 65 72 2d 3e 6a 6f 75 72 fd, pPager->jour
113a0 6e 61 6c 4f 66 66 29 3b 0a 20 20 7d 0a 20 20 72 nalOff);. }. r
113b0 65 74 75 72 6e 20 72 63 3b 0a 7d 0a 0a 2f 2a 0a eturn rc;.}../*.
113c0 2a 2a 20 44 69 73 63 61 72 64 20 74 68 65 20 65 ** Discard the e
113d0 6e 74 69 72 65 20 63 6f 6e 74 65 6e 74 73 20 6f ntire contents o
113e0 66 20 74 68 65 20 69 6e 2d 6d 65 6d 6f 72 79 20 f the in-memory
113f0 70 61 67 65 2d 63 61 63 68 65 2e 0a 2a 2f 0a 73 page-cache..*/.s
11400 74 61 74 69 63 20 76 6f 69 64 20 70 61 67 65 72 tatic void pager
11410 5f 72 65 73 65 74 28 50 61 67 65 72 20 2a 70 50 _reset(Pager *pP
11420 61 67 65 72 29 7b 0a 20 20 70 50 61 67 65 72 2d ager){. pPager-
11430 3e 69 44 61 74 61 56 65 72 73 69 6f 6e 2b 2b 3b >iDataVersion++;
11440 0a 20 20 73 71 6c 69 74 65 33 42 61 63 6b 75 70 . sqlite3Backup
11450 52 65 73 74 61 72 74 28 70 50 61 67 65 72 2d 3e Restart(pPager->
11460 70 42 61 63 6b 75 70 29 3b 0a 20 20 73 71 6c 69 pBackup);. sqli
11470 74 65 33 50 63 61 63 68 65 43 6c 65 61 72 28 70 te3PcacheClear(p
11480 50 61 67 65 72 2d 3e 70 50 43 61 63 68 65 29 3b Pager->pPCache);
11490 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 52 65 74 75 72 6e .}../*.** Return
114a0 20 74 68 65 20 70 50 61 67 65 72 2d 3e 69 44 61 the pPager->iDa
114b0 74 61 56 65 72 73 69 6f 6e 20 76 61 6c 75 65 0a taVersion value.
114c0 2a 2f 0a 75 33 32 20 73 71 6c 69 74 65 33 50 61 */.u32 sqlite3Pa
114d0 67 65 72 44 61 74 61 56 65 72 73 69 6f 6e 28 50 gerDataVersion(P
114e0 61 67 65 72 20 2a 70 50 61 67 65 72 29 7b 0a 20 ager *pPager){.
114f0 20 61 73 73 65 72 74 28 20 70 50 61 67 65 72 2d assert( pPager-
11500 3e 65 53 74 61 74 65 3e 50 41 47 45 52 5f 4f 50 >eState>PAGER_OP
11510 45 4e 20 29 3b 0a 20 20 72 65 74 75 72 6e 20 70 EN );. return p
11520 50 61 67 65 72 2d 3e 69 44 61 74 61 56 65 72 73 Pager->iDataVers
11530 69 6f 6e 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 46 72 ion;.}../*.** Fr
11540 65 65 20 61 6c 6c 20 73 74 72 75 63 74 75 72 65 ee all structure
11550 73 20 69 6e 20 74 68 65 20 50 61 67 65 72 2e 61 s in the Pager.a
11560 53 61 76 65 70 6f 69 6e 74 5b 5d 20 61 72 72 61 Savepoint[] arra
11570 79 20 61 6e 64 20 73 65 74 20 62 6f 74 68 0a 2a y and set both.*
11580 2a 20 50 61 67 65 72 2e 61 53 61 76 65 70 6f 69 * Pager.aSavepoi
11590 6e 74 20 61 6e 64 20 50 61 67 65 72 2e 6e 53 61 nt and Pager.nSa
115a0 76 65 70 6f 69 6e 74 20 74 6f 20 7a 65 72 6f 2e vepoint to zero.
115b0 20 43 6c 6f 73 65 20 74 68 65 20 73 75 62 2d 6a Close the sub-j
115c0 6f 75 72 6e 61 6c 0a 2a 2a 20 69 66 20 69 74 20 ournal.** if it
115d0 69 73 20 6f 70 65 6e 20 61 6e 64 20 74 68 65 20 is open and the
115e0 70 61 67 65 72 20 69 73 20 6e 6f 74 20 69 6e 20 pager is not in
115f0 65 78 63 6c 75 73 69 76 65 20 6d 6f 64 65 2e 0a exclusive mode..
11600 2a 2f 0a 73 74 61 74 69 63 20 76 6f 69 64 20 72 */.static void r
11610 65 6c 65 61 73 65 41 6c 6c 53 61 76 65 70 6f 69 eleaseAllSavepoi
11620 6e 74 73 28 50 61 67 65 72 20 2a 70 50 61 67 65 nts(Pager *pPage
11630 72 29 7b 0a 20 20 69 6e 74 20 69 69 3b 20 20 20 r){. int ii;
11640 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 49 /* I
11650 74 65 72 61 74 6f 72 20 66 6f 72 20 6c 6f 6f 70 terator for loop
11660 69 6e 67 20 74 68 72 6f 75 67 68 20 50 61 67 65 ing through Page
11670 72 2e 61 53 61 76 65 70 6f 69 6e 74 20 2a 2f 0a r.aSavepoint */.
11680 20 20 66 6f 72 28 69 69 3d 30 3b 20 69 69 3c 70 for(ii=0; ii<p
11690 50 61 67 65 72 2d 3e 6e 53 61 76 65 70 6f 69 6e Pager->nSavepoin
116a0 74 3b 20 69 69 2b 2b 29 7b 0a 20 20 20 20 73 71 t; ii++){. sq
116b0 6c 69 74 65 33 42 69 74 76 65 63 44 65 73 74 72 lite3BitvecDestr
116c0 6f 79 28 70 50 61 67 65 72 2d 3e 61 53 61 76 65 oy(pPager->aSave
116d0 70 6f 69 6e 74 5b 69 69 5d 2e 70 49 6e 53 61 76 point[ii].pInSav
116e0 65 70 6f 69 6e 74 29 3b 0a 20 20 7d 0a 20 20 69 epoint);. }. i
116f0 66 28 20 21 70 50 61 67 65 72 2d 3e 65 78 63 6c f( !pPager->excl
11700 75 73 69 76 65 4d 6f 64 65 20 7c 7c 20 73 71 6c usiveMode || sql
11710 69 74 65 33 4a 6f 75 72 6e 61 6c 49 73 49 6e 4d ite3JournalIsInM
11720 65 6d 6f 72 79 28 70 50 61 67 65 72 2d 3e 73 6a emory(pPager->sj
11730 66 64 29 20 29 7b 0a 20 20 20 20 73 71 6c 69 74 fd) ){. sqlit
11740 65 33 4f 73 43 6c 6f 73 65 28 70 50 61 67 65 72 e3OsClose(pPager
11750 2d 3e 73 6a 66 64 29 3b 0a 20 20 7d 0a 20 20 73 ->sjfd);. }. s
11760 71 6c 69 74 65 33 5f 66 72 65 65 28 70 50 61 67 qlite3_free(pPag
11770 65 72 2d 3e 61 53 61 76 65 70 6f 69 6e 74 29 3b er->aSavepoint);
11780 0a 20 20 70 50 61 67 65 72 2d 3e 61 53 61 76 65 . pPager->aSave
11790 70 6f 69 6e 74 20 3d 20 30 3b 0a 20 20 70 50 61 point = 0;. pPa
117a0 67 65 72 2d 3e 6e 53 61 76 65 70 6f 69 6e 74 20 ger->nSavepoint
117b0 3d 20 30 3b 0a 20 20 70 50 61 67 65 72 2d 3e 6e = 0;. pPager->n
117c0 53 75 62 52 65 63 20 3d 20 30 3b 0a 7d 0a 0a 2f SubRec = 0;.}../
117d0 2a 0a 2a 2a 20 53 65 74 20 74 68 65 20 62 69 74 *.** Set the bit
117e0 20 6e 75 6d 62 65 72 20 70 67 6e 6f 20 69 6e 20 number pgno in
117f0 74 68 65 20 50 61 67 65 72 53 61 76 65 70 6f 69 the PagerSavepoi
11800 6e 74 2e 70 49 6e 53 61 76 65 70 6f 69 6e 74 20 nt.pInSavepoint
11810 0a 2a 2a 20 62 69 74 76 65 63 73 20 6f 66 20 61 .** bitvecs of a
11820 6c 6c 20 6f 70 65 6e 20 73 61 76 65 70 6f 69 6e ll open savepoin
11830 74 73 2e 20 52 65 74 75 72 6e 20 53 51 4c 49 54 ts. Return SQLIT
11840 45 5f 4f 4b 20 69 66 20 73 75 63 63 65 73 73 66 E_OK if successf
11850 75 6c 0a 2a 2a 20 6f 72 20 53 51 4c 49 54 45 5f ul.** or SQLITE_
11860 4e 4f 4d 45 4d 20 69 66 20 61 20 6d 61 6c 6c 6f NOMEM if a mallo
11870 63 20 66 61 69 6c 75 72 65 20 6f 63 63 75 72 73 c failure occurs
11880 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74 20 ..*/.static int
11890 61 64 64 54 6f 53 61 76 65 70 6f 69 6e 74 42 69 addToSavepointBi
118a0 74 76 65 63 73 28 50 61 67 65 72 20 2a 70 50 61 tvecs(Pager *pPa
118b0 67 65 72 2c 20 50 67 6e 6f 20 70 67 6e 6f 29 7b ger, Pgno pgno){
118c0 0a 20 20 69 6e 74 20 69 69 3b 20 20 20 20 20 20 . int ii;
118d0 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 /*
118e0 4c 6f 6f 70 20 63 6f 75 6e 74 65 72 20 2a 2f 0a Loop counter */.
118f0 20 20 69 6e 74 20 72 63 20 3d 20 53 51 4c 49 54 int rc = SQLIT
11900 45 5f 4f 4b 3b 20 20 20 20 20 20 20 2f 2a 20 52 E_OK; /* R
11910 65 73 75 6c 74 20 63 6f 64 65 20 2a 2f 0a 0a 20 esult code */..
11920 20 66 6f 72 28 69 69 3d 30 3b 20 69 69 3c 70 50 for(ii=0; ii<pP
11930 61 67 65 72 2d 3e 6e 53 61 76 65 70 6f 69 6e 74 ager->nSavepoint
11940 3b 20 69 69 2b 2b 29 7b 0a 20 20 20 20 50 61 67 ; ii++){. Pag
11950 65 72 53 61 76 65 70 6f 69 6e 74 20 2a 70 20 3d erSavepoint *p =
11960 20 26 70 50 61 67 65 72 2d 3e 61 53 61 76 65 70 &pPager->aSavep
11970 6f 69 6e 74 5b 69 69 5d 3b 0a 20 20 20 20 69 66 oint[ii];. if
11980 28 20 70 67 6e 6f 3c 3d 70 2d 3e 6e 4f 72 69 67 ( pgno<=p->nOrig
11990 20 29 7b 0a 20 20 20 20 20 20 72 63 20 7c 3d 20 ){. rc |=
119a0 73 71 6c 69 74 65 33 42 69 74 76 65 63 53 65 74 sqlite3BitvecSet
119b0 28 70 2d 3e 70 49 6e 53 61 76 65 70 6f 69 6e 74 (p->pInSavepoint
119c0 2c 20 70 67 6e 6f 29 3b 0a 20 20 20 20 20 20 74 , pgno);. t
119d0 65 73 74 63 61 73 65 28 20 72 63 3d 3d 53 51 4c estcase( rc==SQL
119e0 49 54 45 5f 4e 4f 4d 45 4d 20 29 3b 0a 20 20 20 ITE_NOMEM );.
119f0 20 20 20 61 73 73 65 72 74 28 20 72 63 3d 3d 53 assert( rc==S
11a00 51 4c 49 54 45 5f 4f 4b 20 7c 7c 20 72 63 3d 3d QLITE_OK || rc==
11a10 53 51 4c 49 54 45 5f 4e 4f 4d 45 4d 20 29 3b 0a SQLITE_NOMEM );.
11a20 20 20 20 20 7d 0a 20 20 7d 0a 20 20 72 65 74 75 }. }. retu
11a30 72 6e 20 72 63 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 rn rc;.}../*.**
11a40 54 68 69 73 20 66 75 6e 63 74 69 6f 6e 20 69 73 This function is
11a50 20 61 20 6e 6f 2d 6f 70 20 69 66 20 74 68 65 20 a no-op if the
11a60 70 61 67 65 72 20 69 73 20 69 6e 20 65 78 63 6c pager is in excl
11a70 75 73 69 76 65 20 6d 6f 64 65 20 61 6e 64 20 6e usive mode and n
11a80 6f 74 0a 2a 2a 20 69 6e 20 74 68 65 20 45 52 52 ot.** in the ERR
11a90 4f 52 20 73 74 61 74 65 2e 20 4f 74 68 65 72 77 OR state. Otherw
11aa0 69 73 65 2c 20 69 74 20 73 77 69 74 63 68 65 73 ise, it switches
11ab0 20 74 68 65 20 70 61 67 65 72 20 74 6f 20 50 41 the pager to PA
11ac0 47 45 52 5f 4f 50 45 4e 0a 2a 2a 20 73 74 61 74 GER_OPEN.** stat
11ad0 65 2e 0a 2a 2a 0a 2a 2a 20 49 66 20 74 68 65 20 e..**.** If the
11ae0 70 61 67 65 72 20 69 73 20 6e 6f 74 20 69 6e 20 pager is not in
11af0 65 78 63 6c 75 73 69 76 65 2d 61 63 63 65 73 73 exclusive-access
11b00 20 6d 6f 64 65 2c 20 74 68 65 20 64 61 74 61 62 mode, the datab
11b10 61 73 65 20 66 69 6c 65 20 69 73 0a 2a 2a 20 63 ase file is.** c
11b20 6f 6d 70 6c 65 74 65 6c 79 20 75 6e 6c 6f 63 6b ompletely unlock
11b30 65 64 2e 20 49 66 20 74 68 65 20 66 69 6c 65 20 ed. If the file
11b40 69 73 20 75 6e 6c 6f 63 6b 65 64 20 61 6e 64 20 is unlocked and
11b50 74 68 65 20 66 69 6c 65 2d 73 79 73 74 65 6d 20 the file-system
11b60 64 6f 65 73 0a 2a 2a 20 6e 6f 74 20 65 78 68 69 does.** not exhi
11b70 62 69 74 20 74 68 65 20 55 4e 44 45 4c 45 54 41 bit the UNDELETA
11b80 42 4c 45 5f 57 48 45 4e 5f 4f 50 45 4e 20 70 72 BLE_WHEN_OPEN pr
11b90 6f 70 65 72 74 79 2c 20 74 68 65 20 6a 6f 75 72 operty, the jour
11ba0 6e 61 6c 20 66 69 6c 65 20 69 73 0a 2a 2a 20 63 nal file is.** c
11bb0 6c 6f 73 65 64 20 28 69 66 20 69 74 20 69 73 20 losed (if it is
11bc0 6f 70 65 6e 29 2e 0a 2a 2a 0a 2a 2a 20 49 66 20 open)..**.** If
11bd0 74 68 65 20 70 61 67 65 72 20 69 73 20 69 6e 20 the pager is in
11be0 45 52 52 4f 52 20 73 74 61 74 65 20 77 68 65 6e ERROR state when
11bf0 20 74 68 69 73 20 66 75 6e 63 74 69 6f 6e 20 69 this function i
11c00 73 20 63 61 6c 6c 65 64 2c 20 74 68 65 20 0a 2a s called, the .*
11c10 2a 20 63 6f 6e 74 65 6e 74 73 20 6f 66 20 74 68 * contents of th
11c20 65 20 70 61 67 65 72 20 63 61 63 68 65 20 61 72 e pager cache ar
11c30 65 20 64 69 73 63 61 72 64 65 64 20 62 65 66 6f e discarded befo
11c40 72 65 20 73 77 69 74 63 68 69 6e 67 20 62 61 63 re switching bac
11c50 6b 20 74 6f 20 0a 2a 2a 20 74 68 65 20 4f 50 45 k to .** the OPE
11c60 4e 20 73 74 61 74 65 2e 20 52 65 67 61 72 64 6c N state. Regardl
11c70 65 73 73 20 6f 66 20 77 68 65 74 68 65 72 20 74 ess of whether t
11c80 68 65 20 70 61 67 65 72 20 69 73 20 69 6e 20 65 he pager is in e
11c90 78 63 6c 75 73 69 76 65 2d 6d 6f 64 65 0a 2a 2a xclusive-mode.**
11ca0 20 6f 72 20 6e 6f 74 2c 20 61 6e 79 20 6a 6f 75 or not, any jou
11cb0 72 6e 61 6c 20 66 69 6c 65 20 6c 65 66 74 20 69 rnal file left i
11cc0 6e 20 74 68 65 20 66 69 6c 65 2d 73 79 73 74 65 n the file-syste
11cd0 6d 20 77 69 6c 6c 20 62 65 20 74 72 65 61 74 65 m will be treate
11ce0 64 0a 2a 2a 20 61 73 20 61 20 68 6f 74 2d 6a 6f d.** as a hot-jo
11cf0 75 72 6e 61 6c 20 61 6e 64 20 72 6f 6c 6c 65 64 urnal and rolled
11d00 20 62 61 63 6b 20 74 68 65 20 6e 65 78 74 20 74 back the next t
11d10 69 6d 65 20 61 20 72 65 61 64 2d 74 72 61 6e 73 ime a read-trans
11d20 61 63 74 69 6f 6e 0a 2a 2a 20 69 73 20 6f 70 65 action.** is ope
11d30 6e 65 64 20 28 62 79 20 74 68 69 73 20 6f 72 20 ned (by this or
11d40 62 79 20 61 6e 79 20 6f 74 68 65 72 20 63 6f 6e by any other con
11d50 6e 65 63 74 69 6f 6e 29 2e 0a 2a 2f 0a 73 74 61 nection)..*/.sta
11d60 74 69 63 20 76 6f 69 64 20 70 61 67 65 72 5f 75 tic void pager_u
11d70 6e 6c 6f 63 6b 28 50 61 67 65 72 20 2a 70 50 61 nlock(Pager *pPa
11d80 67 65 72 29 7b 0a 0a 20 20 61 73 73 65 72 74 28 ger){.. assert(
11d90 20 70 50 61 67 65 72 2d 3e 65 53 74 61 74 65 3d pPager->eState=
11da0 3d 50 41 47 45 52 5f 52 45 41 44 45 52 20 0a 20 =PAGER_READER .
11db0 20 20 20 20 20 20 7c 7c 20 70 50 61 67 65 72 2d || pPager-
11dc0 3e 65 53 74 61 74 65 3d 3d 50 41 47 45 52 5f 4f >eState==PAGER_O
11dd0 50 45 4e 20 0a 20 20 20 20 20 20 20 7c 7c 20 70 PEN . || p
11de0 50 61 67 65 72 2d 3e 65 53 74 61 74 65 3d 3d 50 Pager->eState==P
11df0 41 47 45 52 5f 45 52 52 4f 52 20 0a 20 20 29 3b AGER_ERROR . );
11e00 0a 0a 20 20 73 71 6c 69 74 65 33 42 69 74 76 65 .. sqlite3Bitve
11e10 63 44 65 73 74 72 6f 79 28 70 50 61 67 65 72 2d cDestroy(pPager-
11e20 3e 70 49 6e 4a 6f 75 72 6e 61 6c 29 3b 0a 20 20 >pInJournal);.
11e30 70 50 61 67 65 72 2d 3e 70 49 6e 4a 6f 75 72 6e pPager->pInJourn
11e40 61 6c 20 3d 20 30 3b 0a 20 20 72 65 6c 65 61 73 al = 0;. releas
11e50 65 41 6c 6c 53 61 76 65 70 6f 69 6e 74 73 28 70 eAllSavepoints(p
11e60 50 61 67 65 72 29 3b 0a 0a 20 20 69 66 28 20 70 Pager);.. if( p
11e70 61 67 65 72 55 73 65 57 61 6c 28 70 50 61 67 65 agerUseWal(pPage
11e80 72 29 20 29 7b 0a 20 20 20 20 61 73 73 65 72 74 r) ){. assert
11e90 28 20 21 69 73 4f 70 65 6e 28 70 50 61 67 65 72 ( !isOpen(pPager
11ea0 2d 3e 6a 66 64 29 20 29 3b 0a 20 20 20 20 73 71 ->jfd) );. sq
11eb0 6c 69 74 65 33 57 61 6c 45 6e 64 52 65 61 64 54 lite3WalEndReadT
11ec0 72 61 6e 73 61 63 74 69 6f 6e 28 70 50 61 67 65 ransaction(pPage
11ed0 72 2d 3e 70 57 61 6c 29 3b 0a 20 20 20 20 70 50 r->pWal);. pP
11ee0 61 67 65 72 2d 3e 65 53 74 61 74 65 20 3d 20 50 ager->eState = P
11ef0 41 47 45 52 5f 4f 50 45 4e 3b 0a 20 20 7d 65 6c AGER_OPEN;. }el
11f00 73 65 20 69 66 28 20 21 70 50 61 67 65 72 2d 3e se if( !pPager->
11f10 65 78 63 6c 75 73 69 76 65 4d 6f 64 65 20 29 7b exclusiveMode ){
11f20 0a 20 20 20 20 69 6e 74 20 72 63 3b 20 20 20 20 . int rc;
11f30 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
11f40 20 20 20 2f 2a 20 45 72 72 6f 72 20 63 6f 64 65 /* Error code
11f50 20 72 65 74 75 72 6e 65 64 20 62 79 20 70 61 67 returned by pag
11f60 65 72 55 6e 6c 6f 63 6b 44 62 28 29 20 2a 2f 0a erUnlockDb() */.
11f70 20 20 20 20 69 6e 74 20 69 44 63 20 3d 20 69 73 int iDc = is
11f80 4f 70 65 6e 28 70 50 61 67 65 72 2d 3e 66 64 29 Open(pPager->fd)
11f90 3f 73 71 6c 69 74 65 33 4f 73 44 65 76 69 63 65 ?sqlite3OsDevice
11fa0 43 68 61 72 61 63 74 65 72 69 73 74 69 63 73 28 Characteristics(
11fb0 70 50 61 67 65 72 2d 3e 66 64 29 3a 30 3b 0a 0a pPager->fd):0;..
11fc0 20 20 20 20 2f 2a 20 49 66 20 74 68 65 20 6f 70 /* If the op
11fd0 65 72 61 74 69 6e 67 20 73 79 73 74 65 6d 20 73 erating system s
11fe0 75 70 70 6f 72 74 20 64 65 6c 65 74 69 6f 6e 20 upport deletion
11ff0 6f 66 20 6f 70 65 6e 20 66 69 6c 65 73 2c 20 74 of open files, t
12000 68 65 6e 0a 20 20 20 20 2a 2a 20 63 6c 6f 73 65 hen. ** close
12010 20 74 68 65 20 6a 6f 75 72 6e 61 6c 20 66 69 6c the journal fil
12020 65 20 77 68 65 6e 20 64 72 6f 70 70 69 6e 67 20 e when dropping
12030 74 68 65 20 64 61 74 61 62 61 73 65 20 6c 6f 63 the database loc
12040 6b 2e 20 20 4f 74 68 65 72 77 69 73 65 0a 20 20 k. Otherwise.
12050 20 20 2a 2a 20 61 6e 6f 74 68 65 72 20 63 6f 6e ** another con
12060 6e 65 63 74 69 6f 6e 20 77 69 74 68 20 6a 6f 75 nection with jou
12070 72 6e 61 6c 5f 6d 6f 64 65 3d 64 65 6c 65 74 65 rnal_mode=delete
12080 20 6d 69 67 68 74 20 64 65 6c 65 74 65 20 74 68 might delete th
12090 65 20 66 69 6c 65 0a 20 20 20 20 2a 2a 20 6f 75 e file. ** ou
120a0 74 20 66 72 6f 6d 20 75 6e 64 65 72 20 75 73 2e t from under us.
120b0 0a 20 20 20 20 2a 2f 0a 20 20 20 20 61 73 73 65 . */. asse
120c0 72 74 28 20 28 50 41 47 45 52 5f 4a 4f 55 52 4e rt( (PAGER_JOURN
120d0 41 4c 4d 4f 44 45 5f 4d 45 4d 4f 52 59 20 20 20 ALMODE_MEMORY
120e0 26 20 35 29 21 3d 31 20 29 3b 0a 20 20 20 20 61 & 5)!=1 );. a
120f0 73 73 65 72 74 28 20 28 50 41 47 45 52 5f 4a 4f ssert( (PAGER_JO
12100 55 52 4e 41 4c 4d 4f 44 45 5f 4f 46 46 20 20 20 URNALMODE_OFF
12110 20 20 20 26 20 35 29 21 3d 31 20 29 3b 0a 20 20 & 5)!=1 );.
12120 20 20 61 73 73 65 72 74 28 20 28 50 41 47 45 52 assert( (PAGER
12130 5f 4a 4f 55 52 4e 41 4c 4d 4f 44 45 5f 57 41 4c _JOURNALMODE_WAL
12140 20 20 20 20 20 20 26 20 35 29 21 3d 31 20 29 3b & 5)!=1 );
12150 0a 20 20 20 20 61 73 73 65 72 74 28 20 28 50 41 . assert( (PA
12160 47 45 52 5f 4a 4f 55 52 4e 41 4c 4d 4f 44 45 5f GER_JOURNALMODE_
12170 44 45 4c 45 54 45 20 20 20 26 20 35 29 21 3d 31 DELETE & 5)!=1
12180 20 29 3b 0a 20 20 20 20 61 73 73 65 72 74 28 20 );. assert(
12190 28 50 41 47 45 52 5f 4a 4f 55 52 4e 41 4c 4d 4f (PAGER_JOURNALMO
121a0 44 45 5f 54 52 55 4e 43 41 54 45 20 26 20 35 29 DE_TRUNCATE & 5)
121b0 3d 3d 31 20 29 3b 0a 20 20 20 20 61 73 73 65 72 ==1 );. asser
121c0 74 28 20 28 50 41 47 45 52 5f 4a 4f 55 52 4e 41 t( (PAGER_JOURNA
121d0 4c 4d 4f 44 45 5f 50 45 52 53 49 53 54 20 20 26 LMODE_PERSIST &
121e0 20 35 29 3d 3d 31 20 29 3b 0a 20 20 20 20 69 66 5)==1 );. if
121f0 28 20 30 3d 3d 28 69 44 63 20 26 20 53 51 4c 49 ( 0==(iDc & SQLI
12200 54 45 5f 49 4f 43 41 50 5f 55 4e 44 45 4c 45 54 TE_IOCAP_UNDELET
12210 41 42 4c 45 5f 57 48 45 4e 5f 4f 50 45 4e 29 0a ABLE_WHEN_OPEN).
12220 20 20 20 20 20 7c 7c 20 31 21 3d 28 70 50 61 67 || 1!=(pPag
12230 65 72 2d 3e 6a 6f 75 72 6e 61 6c 4d 6f 64 65 20 er->journalMode
12240 26 20 35 29 0a 20 20 20 20 29 7b 0a 20 20 20 20 & 5). ){.
12250 20 20 73 71 6c 69 74 65 33 4f 73 43 6c 6f 73 65 sqlite3OsClose
12260 28 70 50 61 67 65 72 2d 3e 6a 66 64 29 3b 0a 20 (pPager->jfd);.
12270 20 20 20 7d 0a 0a 20 20 20 20 2f 2a 20 49 66 20 }.. /* If
12280 74 68 65 20 70 61 67 65 72 20 69 73 20 69 6e 20 the pager is in
12290 74 68 65 20 45 52 52 4f 52 20 73 74 61 74 65 20 the ERROR state
122a0 61 6e 64 20 74 68 65 20 63 61 6c 6c 20 74 6f 20 and the call to
122b0 75 6e 6c 6f 63 6b 20 74 68 65 20 64 61 74 61 62 unlock the datab
122c0 61 73 65 0a 20 20 20 20 2a 2a 20 66 69 6c 65 20 ase. ** file
122d0 66 61 69 6c 73 2c 20 73 65 74 20 74 68 65 20 63 fails, set the c
122e0 75 72 72 65 6e 74 20 6c 6f 63 6b 20 74 6f 20 55 urrent lock to U
122f0 4e 4b 4e 4f 57 4e 5f 4c 4f 43 4b 2e 20 53 65 65 NKNOWN_LOCK. See
12300 20 74 68 65 20 63 6f 6d 6d 65 6e 74 0a 20 20 20 the comment.
12310 20 2a 2a 20 61 62 6f 76 65 20 74 68 65 20 23 64 ** above the #d
12320 65 66 69 6e 65 20 66 6f 72 20 55 4e 4b 4e 4f 57 efine for UNKNOW
12330 4e 5f 4c 4f 43 4b 20 66 6f 72 20 61 6e 20 65 78 N_LOCK for an ex
12340 70 6c 61 6e 61 74 69 6f 6e 20 6f 66 20 77 68 79 planation of why
12350 20 74 68 69 73 0a 20 20 20 20 2a 2a 20 69 73 20 this. ** is
12360 6e 65 63 65 73 73 61 72 79 2e 0a 20 20 20 20 2a necessary.. *
12370 2f 0a 20 20 20 20 72 63 20 3d 20 70 61 67 65 72 /. rc = pager
12380 55 6e 6c 6f 63 6b 44 62 28 70 50 61 67 65 72 2c UnlockDb(pPager,
12390 20 4e 4f 5f 4c 4f 43 4b 29 3b 0a 20 20 20 20 69 NO_LOCK);. i
123a0 66 28 20 72 63 21 3d 53 51 4c 49 54 45 5f 4f 4b f( rc!=SQLITE_OK
123b0 20 26 26 20 70 50 61 67 65 72 2d 3e 65 53 74 61 && pPager->eSta
123c0 74 65 3d 3d 50 41 47 45 52 5f 45 52 52 4f 52 20 te==PAGER_ERROR
123d0 29 7b 0a 20 20 20 20 20 20 70 50 61 67 65 72 2d ){. pPager-
123e0 3e 65 4c 6f 63 6b 20 3d 20 55 4e 4b 4e 4f 57 4e >eLock = UNKNOWN
123f0 5f 4c 4f 43 4b 3b 0a 20 20 20 20 7d 0a 0a 20 20 _LOCK;. }..
12400 20 20 2f 2a 20 54 68 65 20 70 61 67 65 72 20 73 /* The pager s
12410 74 61 74 65 20 6d 61 79 20 62 65 20 63 68 61 6e tate may be chan
12420 67 65 64 20 66 72 6f 6d 20 50 41 47 45 52 5f 45 ged from PAGER_E
12430 52 52 4f 52 20 74 6f 20 50 41 47 45 52 5f 4f 50 RROR to PAGER_OP
12440 45 4e 20 68 65 72 65 0a 20 20 20 20 2a 2a 20 77 EN here. ** w
12450 69 74 68 6f 75 74 20 63 6c 65 61 72 69 6e 67 20 ithout clearing
12460 74 68 65 20 65 72 72 6f 72 20 63 6f 64 65 2e 20 the error code.
12470 54 68 69 73 20 69 73 20 69 6e 74 65 6e 74 69 6f This is intentio
12480 6e 61 6c 20 2d 20 74 68 65 20 65 72 72 6f 72 0a nal - the error.
12490 20 20 20 20 2a 2a 20 63 6f 64 65 20 69 73 20 63 ** code is c
124a0 6c 65 61 72 65 64 20 61 6e 64 20 74 68 65 20 63 leared and the c
124b0 61 63 68 65 20 72 65 73 65 74 20 69 6e 20 74 68 ache reset in th
124c0 65 20 62 6c 6f 63 6b 20 62 65 6c 6f 77 2e 0a 20 e block below..
124d0 20 20 20 2a 2f 0a 20 20 20 20 61 73 73 65 72 74 */. assert
124e0 28 20 70 50 61 67 65 72 2d 3e 65 72 72 43 6f 64 ( pPager->errCod
124f0 65 20 7c 7c 20 70 50 61 67 65 72 2d 3e 65 53 74 e || pPager->eSt
12500 61 74 65 21 3d 50 41 47 45 52 5f 45 52 52 4f 52 ate!=PAGER_ERROR
12510 20 29 3b 0a 20 20 20 20 70 50 61 67 65 72 2d 3e );. pPager->
12520 63 68 61 6e 67 65 43 6f 75 6e 74 44 6f 6e 65 20 changeCountDone
12530 3d 20 30 3b 0a 20 20 20 20 70 50 61 67 65 72 2d = 0;. pPager-
12540 3e 65 53 74 61 74 65 20 3d 20 50 41 47 45 52 5f >eState = PAGER_
12550 4f 50 45 4e 3b 0a 20 20 7d 0a 0a 20 20 2f 2a 20 OPEN;. }.. /*
12560 49 66 20 50 61 67 65 72 2e 65 72 72 43 6f 64 65 If Pager.errCode
12570 20 69 73 20 73 65 74 2c 20 74 68 65 20 63 6f 6e is set, the con
12580 74 65 6e 74 73 20 6f 66 20 74 68 65 20 70 61 67 tents of the pag
12590 65 72 20 63 61 63 68 65 20 63 61 6e 6e 6f 74 20 er cache cannot
125a0 62 65 0a 20 20 2a 2a 20 74 72 75 73 74 65 64 2e be. ** trusted.
125b0 20 4e 6f 77 20 74 68 61 74 20 74 68 65 72 65 20 Now that there
125c0 61 72 65 20 6e 6f 20 6f 75 74 73 74 61 6e 64 69 are no outstandi
125d0 6e 67 20 72 65 66 65 72 65 6e 63 65 73 20 74 6f ng references to
125e0 20 74 68 65 20 70 61 67 65 72 2c 0a 20 20 2a 2a the pager,. **
125f0 20 69 74 20 63 61 6e 20 73 61 66 65 6c 79 20 6d it can safely m
12600 6f 76 65 20 62 61 63 6b 20 74 6f 20 50 41 47 45 ove back to PAGE
12610 52 5f 4f 50 45 4e 20 73 74 61 74 65 2e 20 54 68 R_OPEN state. Th
12620 69 73 20 68 61 70 70 65 6e 73 20 69 6e 20 62 6f is happens in bo
12630 74 68 0a 20 20 2a 2a 20 6e 6f 72 6d 61 6c 20 61 th. ** normal a
12640 6e 64 20 65 78 63 6c 75 73 69 76 65 2d 6c 6f 63 nd exclusive-loc
12650 6b 69 6e 67 20 6d 6f 64 65 2e 0a 20 20 2a 2a 0a king mode.. **.
12660 20 20 2a 2a 20 45 78 63 65 70 74 69 6f 6e 3a 20 ** Exception:
12670 54 68 65 72 65 20 69 73 20 6e 6f 20 77 61 79 20 There is no way
12680 6f 75 74 20 6f 66 20 74 68 65 20 65 72 72 6f 72 out of the error
12690 20 73 74 61 74 65 20 66 6f 72 20 74 65 6d 70 20 state for temp
126a0 66 69 6c 65 73 2e 0a 20 20 2a 2a 20 54 68 69 73 files.. ** This
126b0 20 69 73 20 62 65 63 61 75 73 65 20 69 74 20 69 is because it i
126c0 73 20 6e 6f 74 20 70 6f 73 73 69 62 6c 65 20 74 s not possible t
126d0 6f 20 63 61 6c 6c 20 70 61 67 65 72 5f 72 65 73 o call pager_res
126e0 65 74 28 29 20 6f 6e 20 61 20 74 65 6d 70 0a 20 et() on a temp.
126f0 20 2a 2a 20 66 69 6c 65 20 70 61 67 65 72 20 28 ** file pager (
12700 61 73 20 74 68 69 73 20 6d 61 79 20 64 69 73 63 as this may disc
12710 61 72 64 20 74 68 65 20 6f 6e 6c 79 20 63 6f 70 ard the only cop
12720 79 20 6f 66 20 73 6f 6d 65 20 64 61 74 61 29 2e y of some data).
12730 20 20 2a 2f 0a 20 20 61 73 73 65 72 74 28 20 70 */. assert( p
12740 50 61 67 65 72 2d 3e 65 72 72 43 6f 64 65 3d 3d Pager->errCode==
12750 53 51 4c 49 54 45 5f 4f 4b 20 7c 7c 20 21 4d 45 SQLITE_OK || !ME
12760 4d 44 42 20 29 3b 0a 20 20 69 66 28 20 70 50 61 MDB );. if( pPa
12770 67 65 72 2d 3e 74 65 6d 70 46 69 6c 65 3d 3d 30 ger->tempFile==0
12780 20 26 26 20 70 50 61 67 65 72 2d 3e 65 72 72 43 && pPager->errC
12790 6f 64 65 20 29 7b 0a 20 20 20 20 70 61 67 65 72 ode ){. pager
127a0 5f 72 65 73 65 74 28 70 50 61 67 65 72 29 3b 0a _reset(pPager);.
127b0 20 20 20 20 70 50 61 67 65 72 2d 3e 63 68 61 6e pPager->chan
127c0 67 65 43 6f 75 6e 74 44 6f 6e 65 20 3d 20 30 3b geCountDone = 0;
127d0 0a 20 20 20 20 70 50 61 67 65 72 2d 3e 65 53 74 . pPager->eSt
127e0 61 74 65 20 3d 20 50 41 47 45 52 5f 4f 50 45 4e ate = PAGER_OPEN
127f0 3b 0a 20 20 20 20 70 50 61 67 65 72 2d 3e 65 72 ;. pPager->er
12800 72 43 6f 64 65 20 3d 20 53 51 4c 49 54 45 5f 4f rCode = SQLITE_O
12810 4b 3b 0a 20 20 20 20 69 66 28 20 55 53 45 46 45 K;. if( USEFE
12820 54 43 48 28 70 50 61 67 65 72 29 20 29 20 73 71 TCH(pPager) ) sq
12830 6c 69 74 65 33 4f 73 55 6e 66 65 74 63 68 28 70 lite3OsUnfetch(p
12840 50 61 67 65 72 2d 3e 66 64 2c 20 30 2c 20 30 29 Pager->fd, 0, 0)
12850 3b 0a 20 20 7d 0a 0a 20 20 70 50 61 67 65 72 2d ;. }.. pPager-
12860 3e 6a 6f 75 72 6e 61 6c 4f 66 66 20 3d 20 30 3b >journalOff = 0;
12870 0a 20 20 70 50 61 67 65 72 2d 3e 6a 6f 75 72 6e . pPager->journ
12880 61 6c 48 64 72 20 3d 20 30 3b 0a 20 20 70 50 61 alHdr = 0;. pPa
12890 67 65 72 2d 3e 73 65 74 4d 61 73 74 65 72 20 3d ger->setMaster =
128a0 20 30 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 54 68 69 0;.}../*.** Thi
128b0 73 20 66 75 6e 63 74 69 6f 6e 20 69 73 20 63 61 s function is ca
128c0 6c 6c 65 64 20 77 68 65 6e 65 76 65 72 20 61 6e lled whenever an
128d0 20 49 4f 45 52 52 20 6f 72 20 46 55 4c 4c 20 65 IOERR or FULL e
128e0 72 72 6f 72 20 74 68 61 74 20 72 65 71 75 69 72 rror that requir
128f0 65 73 0a 2a 2a 20 74 68 65 20 70 61 67 65 72 20 es.** the pager
12900 74 6f 20 74 72 61 6e 73 69 74 69 6f 6e 20 69 6e to transition in
12910 74 6f 20 74 68 65 20 45 52 52 4f 52 20 73 74 61 to the ERROR sta
12920 74 65 20 6d 61 79 20 61 68 76 65 20 6f 63 63 75 te may ahve occu
12930 72 72 65 64 2e 0a 2a 2a 20 54 68 65 20 66 69 72 rred..** The fir
12940 73 74 20 61 72 67 75 6d 65 6e 74 20 69 73 20 61 st argument is a
12950 20 70 6f 69 6e 74 65 72 20 74 6f 20 74 68 65 20 pointer to the
12960 70 61 67 65 72 20 73 74 72 75 63 74 75 72 65 2c pager structure,
12970 20 74 68 65 20 73 65 63 6f 6e 64 20 0a 2a 2a 20 the second .**
12980 74 68 65 20 65 72 72 6f 72 2d 63 6f 64 65 20 61 the error-code a
12990 62 6f 75 74 20 74 6f 20 62 65 20 72 65 74 75 72 bout to be retur
129a0 6e 65 64 20 62 79 20 61 20 70 61 67 65 72 20 41 ned by a pager A
129b0 50 49 20 66 75 6e 63 74 69 6f 6e 2e 20 54 68 65 PI function. The
129c0 20 0a 2a 2a 20 76 61 6c 75 65 20 72 65 74 75 72 .** value retur
129d0 6e 65 64 20 69 73 20 61 20 63 6f 70 79 20 6f 66 ned is a copy of
129e0 20 74 68 65 20 73 65 63 6f 6e 64 20 61 72 67 75 the second argu
129f0 6d 65 6e 74 20 74 6f 20 74 68 69 73 20 66 75 6e ment to this fun
12a00 63 74 69 6f 6e 2e 20 0a 2a 2a 0a 2a 2a 20 49 66 ction. .**.** If
12a10 20 74 68 65 20 73 65 63 6f 6e 64 20 61 72 67 75 the second argu
12a20 6d 65 6e 74 20 69 73 20 53 51 4c 49 54 45 5f 46 ment is SQLITE_F
12a30 55 4c 4c 2c 20 53 51 4c 49 54 45 5f 49 4f 45 52 ULL, SQLITE_IOER
12a40 52 20 6f 72 20 6f 6e 65 20 6f 66 20 74 68 65 0a R or one of the.
12a50 2a 2a 20 49 4f 45 52 52 20 73 75 62 2d 63 6f 64 ** IOERR sub-cod
12a60 65 73 2c 20 74 68 65 20 70 61 67 65 72 20 65 6e es, the pager en
12a70 74 65 72 73 20 74 68 65 20 45 52 52 4f 52 20 73 ters the ERROR s
12a80 74 61 74 65 20 61 6e 64 20 74 68 65 20 65 72 72 tate and the err
12a90 6f 72 20 63 6f 64 65 0a 2a 2a 20 69 73 20 73 74 or code.** is st
12aa0 6f 72 65 64 20 69 6e 20 50 61 67 65 72 2e 65 72 ored in Pager.er
12ab0 72 43 6f 64 65 2e 20 57 68 69 6c 65 20 74 68 65 rCode. While the
12ac0 20 70 61 67 65 72 20 72 65 6d 61 69 6e 73 20 69 pager remains i
12ad0 6e 20 74 68 65 20 45 52 52 4f 52 20 73 74 61 74 n the ERROR stat
12ae0 65 2c 0a 2a 2a 20 61 6c 6c 20 6d 61 6a 6f 72 20 e,.** all major
12af0 41 50 49 20 63 61 6c 6c 73 20 6f 6e 20 74 68 65 API calls on the
12b00 20 50 61 67 65 72 20 77 69 6c 6c 20 69 6d 6d 65 Pager will imme
12b10 64 69 61 74 65 6c 79 20 72 65 74 75 72 6e 20 50 diately return P
12b20 61 67 65 72 2e 65 72 72 43 6f 64 65 2e 0a 2a 2a ager.errCode..**
12b30 0a 2a 2a 20 54 68 65 20 45 52 52 4f 52 20 73 74 .** The ERROR st
12b40 61 74 65 20 69 6e 64 69 63 61 74 65 73 20 74 68 ate indicates th
12b50 61 74 20 74 68 65 20 63 6f 6e 74 65 6e 74 73 20 at the contents
12b60 6f 66 20 74 68 65 20 70 61 67 65 72 2d 63 61 63 of the pager-cac
12b70 68 65 20 0a 2a 2a 20 63 61 6e 6e 6f 74 20 62 65 he .** cannot be
12b80 20 74 72 75 73 74 65 64 2e 20 54 68 69 73 20 73 trusted. This s
12b90 74 61 74 65 20 63 61 6e 20 62 65 20 63 6c 65 61 tate can be clea
12ba0 72 65 64 20 62 79 20 63 6f 6d 70 6c 65 74 65 6c red by completel
12bb0 79 20 64 69 73 63 61 72 64 69 6e 67 20 0a 2a 2a y discarding .**
12bc0 20 74 68 65 20 63 6f 6e 74 65 6e 74 73 20 6f 66 the contents of
12bd0 20 74 68 65 20 70 61 67 65 72 2d 63 61 63 68 65 the pager-cache
12be0 2e 20 49 66 20 61 20 74 72 61 6e 73 61 63 74 69 . If a transacti
12bf0 6f 6e 20 77 61 73 20 61 63 74 69 76 65 20 77 68 on was active wh
12c00 65 6e 0a 2a 2a 20 74 68 65 20 70 65 72 73 69 73 en.** the persis
12c10 74 65 6e 74 20 65 72 72 6f 72 20 6f 63 63 75 72 tent error occur
12c20 72 65 64 2c 20 74 68 65 6e 20 74 68 65 20 72 6f red, then the ro
12c30 6c 6c 62 61 63 6b 20 6a 6f 75 72 6e 61 6c 20 6d llback journal m
12c40 61 79 20 6e 65 65 64 0a 2a 2a 20 74 6f 20 62 65 ay need.** to be
12c50 20 72 65 70 6c 61 79 65 64 20 74 6f 20 72 65 73 replayed to res
12c60 74 6f 72 65 20 74 68 65 20 63 6f 6e 74 65 6e 74 tore the content
12c70 73 20 6f 66 20 74 68 65 20 64 61 74 61 62 61 73 s of the databas
12c80 65 20 66 69 6c 65 20 28 61 73 20 69 66 0a 2a 2a e file (as if.**
12c90 20 69 74 20 77 65 72 65 20 61 20 68 6f 74 2d 6a it were a hot-j
12ca0 6f 75 72 6e 61 6c 29 2e 0a 2a 2f 0a 73 74 61 74 ournal)..*/.stat
12cb0 69 63 20 69 6e 74 20 70 61 67 65 72 5f 65 72 72 ic int pager_err
12cc0 6f 72 28 50 61 67 65 72 20 2a 70 50 61 67 65 72 or(Pager *pPager
12cd0 2c 20 69 6e 74 20 72 63 29 7b 0a 20 20 69 6e 74 , int rc){. int
12ce0 20 72 63 32 20 3d 20 72 63 20 26 20 30 78 66 66 rc2 = rc & 0xff
12cf0 3b 0a 20 20 61 73 73 65 72 74 28 20 72 63 3d 3d ;. assert( rc==
12d00 53 51 4c 49 54 45 5f 4f 4b 20 7c 7c 20 21 4d 45 SQLITE_OK || !ME
12d10 4d 44 42 20 29 3b 0a 20 20 61 73 73 65 72 74 28 MDB );. assert(
12d20 0a 20 20 20 20 20 20 20 70 50 61 67 65 72 2d 3e . pPager->
12d30 65 72 72 43 6f 64 65 3d 3d 53 51 4c 49 54 45 5f errCode==SQLITE_
12d40 46 55 4c 4c 20 7c 7c 0a 20 20 20 20 20 20 20 70 FULL ||. p
12d50 50 61 67 65 72 2d 3e 65 72 72 43 6f 64 65 3d 3d Pager->errCode==
12d60 53 51 4c 49 54 45 5f 4f 4b 20 7c 7c 0a 20 20 20 SQLITE_OK ||.
12d70 20 20 20 20 28 70 50 61 67 65 72 2d 3e 65 72 72 (pPager->err
12d80 43 6f 64 65 20 26 20 30 78 66 66 29 3d 3d 53 51 Code & 0xff)==SQ
12d90 4c 49 54 45 5f 49 4f 45 52 52 0a 20 20 29 3b 0a LITE_IOERR. );.
12da0 20 20 69 66 28 20 72 63 32 3d 3d 53 51 4c 49 54 if( rc2==SQLIT
12db0 45 5f 46 55 4c 4c 20 7c 7c 20 72 63 32 3d 3d 53 E_FULL || rc2==S
12dc0 51 4c 49 54 45 5f 49 4f 45 52 52 20 29 7b 0a 20 QLITE_IOERR ){.
12dd0 20 20 20 70 50 61 67 65 72 2d 3e 65 72 72 43 6f pPager->errCo
12de0 64 65 20 3d 20 72 63 3b 0a 20 20 20 20 70 50 61 de = rc;. pPa
12df0 67 65 72 2d 3e 65 53 74 61 74 65 20 3d 20 50 41 ger->eState = PA
12e00 47 45 52 5f 45 52 52 4f 52 3b 0a 20 20 7d 0a 20 GER_ERROR;. }.
12e10 20 72 65 74 75 72 6e 20 72 63 3b 0a 7d 0a 0a 73 return rc;.}..s
12e20 74 61 74 69 63 20 69 6e 74 20 70 61 67 65 72 5f tatic int pager_
12e30 74 72 75 6e 63 61 74 65 28 50 61 67 65 72 20 2a truncate(Pager *
12e40 70 50 61 67 65 72 2c 20 50 67 6e 6f 20 6e 50 61 pPager, Pgno nPa
12e50 67 65 29 3b 0a 0a 2f 2a 0a 2a 2a 20 54 68 65 20 ge);../*.** The
12e60 77 72 69 74 65 20 74 72 61 6e 73 61 63 74 69 6f write transactio
12e70 6e 20 6f 70 65 6e 20 6f 6e 20 74 68 65 20 70 61 n open on the pa
12e80 67 65 72 20 70 61 73 73 65 64 20 61 73 20 74 68 ger passed as th
12e90 65 20 6f 6e 6c 79 20 61 72 67 75 6d 65 6e 74 20 e only argument
12ea0 69 73 0a 2a 2a 20 62 65 69 6e 67 20 63 6f 6d 6d is.** being comm
12eb0 69 74 74 65 64 2e 20 54 68 69 73 20 66 75 6e 63 itted. This func
12ec0 74 69 6f 6e 20 72 65 74 75 72 6e 73 20 74 72 75 tion returns tru
12ed0 65 20 69 66 20 61 6c 6c 20 64 69 72 74 79 20 70 e if all dirty p
12ee0 61 67 65 73 20 73 68 6f 75 6c 64 0a 2a 2a 20 62 ages should.** b
12ef0 65 20 66 6c 75 73 68 65 64 20 74 6f 20 64 69 73 e flushed to dis
12f00 6b 2c 20 6f 72 20 66 61 6c 73 65 20 6f 74 68 65 k, or false othe
12f10 72 77 69 73 65 2e 20 50 61 67 65 73 20 73 68 6f rwise. Pages sho
12f20 75 6c 64 20 62 65 20 66 6c 75 73 68 65 64 20 74 uld be flushed t
12f30 6f 20 64 69 73 6b 0a 2a 2a 20 75 6e 6c 65 73 73 o disk.** unless
12f40 20 6f 6e 65 20 6f 66 20 74 68 65 20 66 6f 6c 6c one of the foll
12f50 6f 77 69 6e 67 20 69 73 20 74 72 75 65 3a 0a 2a owing is true:.*
12f60 2a 0a 2a 2a 20 20 20 2a 20 54 68 65 20 64 62 20 *.** * The db
12f70 69 73 20 61 6e 20 69 6e 2d 6d 65 6d 6f 72 79 20 is an in-memory
12f80 64 61 74 61 62 61 73 65 2e 0a 2a 2a 0a 2a 2a 20 database..**.**
12f90 20 20 2a 20 54 68 65 20 64 62 20 69 73 20 61 20 * The db is a
12fa0 74 65 6d 70 6f 72 61 72 79 20 64 61 74 61 62 61 temporary databa
12fb0 73 65 20 61 6e 64 20 74 68 65 20 64 62 20 66 69 se and the db fi
12fc0 6c 65 20 68 61 73 20 6e 6f 74 20 62 65 65 6e 20 le has not been
12fd0 6f 70 65 6e 65 64 2e 0a 2a 2a 0a 2a 2a 20 20 20 opened..**.**
12fe0 2a 20 54 68 65 20 64 62 20 69 73 20 61 20 74 65 * The db is a te
12ff0 6d 70 6f 72 61 72 79 20 64 61 74 61 62 61 73 65 mporary database
13000 20 61 6e 64 20 74 68 65 20 63 61 63 68 65 20 63 and the cache c
13010 6f 6e 74 61 69 6e 73 20 6c 65 73 73 20 74 68 61 ontains less tha
13020 6e 0a 2a 2a 20 20 20 20 20 43 2f 34 20 64 69 72 n.** C/4 dir
13030 74 79 20 70 61 67 65 73 2c 20 77 68 65 72 65 20 ty pages, where
13040 43 20 69 73 20 74 68 65 20 63 6f 6e 66 69 67 75 C is the configu
13050 72 65 64 20 63 61 63 68 65 2d 73 69 7a 65 2e 0a red cache-size..
13060 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74 20 70 61 */.static int pa
13070 67 65 72 46 6c 75 73 68 4f 6e 43 6f 6d 6d 69 74 gerFlushOnCommit
13080 28 50 61 67 65 72 20 2a 70 50 61 67 65 72 29 7b (Pager *pPager){
13090 0a 20 20 69 66 28 20 70 50 61 67 65 72 2d 3e 74 . if( pPager->t
130a0 65 6d 70 46 69 6c 65 3d 3d 30 20 29 20 72 65 74 empFile==0 ) ret
130b0 75 72 6e 20 31 3b 0a 20 20 69 66 28 20 21 69 73 urn 1;. if( !is
130c0 4f 70 65 6e 28 70 50 61 67 65 72 2d 3e 66 64 29 Open(pPager->fd)
130d0 20 29 20 72 65 74 75 72 6e 20 30 3b 0a 20 20 72 ) return 0;. r
130e0 65 74 75 72 6e 20 28 73 71 6c 69 74 65 33 50 43 eturn (sqlite3PC
130f0 61 63 68 65 50 65 72 63 65 6e 74 44 69 72 74 79 achePercentDirty
13100 28 70 50 61 67 65 72 2d 3e 70 50 43 61 63 68 65 (pPager->pPCache
13110 29 3e 3d 32 35 29 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a )>=25);.}../*.**
13120 20 54 68 69 73 20 72 6f 75 74 69 6e 65 20 65 6e This routine en
13130 64 73 20 61 20 74 72 61 6e 73 61 63 74 69 6f 6e ds a transaction
13140 2e 20 41 20 74 72 61 6e 73 61 63 74 69 6f 6e 20 . A transaction
13150 69 73 20 75 73 75 61 6c 6c 79 20 65 6e 64 65 64 is usually ended
13160 20 62 79 20 0a 2a 2a 20 65 69 74 68 65 72 20 61 by .** either a
13170 20 43 4f 4d 4d 49 54 20 6f 72 20 61 20 52 4f 4c COMMIT or a ROL
13180 4c 42 41 43 4b 20 6f 70 65 72 61 74 69 6f 6e 2e LBACK operation.
13190 20 54 68 69 73 20 72 6f 75 74 69 6e 65 20 6d 61 This routine ma
131a0 79 20 62 65 20 63 61 6c 6c 65 64 20 0a 2a 2a 20 y be called .**
131b0 61 66 74 65 72 20 72 6f 6c 6c 62 61 63 6b 20 6f after rollback o
131c0 66 20 61 20 68 6f 74 2d 6a 6f 75 72 6e 61 6c 2c f a hot-journal,
131d0 20 6f 72 20 69 66 20 61 6e 20 65 72 72 6f 72 20 or if an error
131e0 6f 63 63 75 72 73 20 77 68 69 6c 65 20 6f 70 65 occurs while ope
131f0 6e 69 6e 67 0a 2a 2a 20 74 68 65 20 6a 6f 75 72 ning.** the jour
13200 6e 61 6c 20 66 69 6c 65 20 6f 72 20 77 72 69 74 nal file or writ
13210 69 6e 67 20 74 68 65 20 76 65 72 79 20 66 69 72 ing the very fir
13220 73 74 20 6a 6f 75 72 6e 61 6c 2d 68 65 61 64 65 st journal-heade
13230 72 20 6f 66 20 61 0a 2a 2a 20 64 61 74 61 62 61 r of a.** databa
13240 73 65 20 74 72 61 6e 73 61 63 74 69 6f 6e 2e 0a se transaction..
13250 2a 2a 20 0a 2a 2a 20 54 68 69 73 20 72 6f 75 74 ** .** This rout
13260 69 6e 65 20 69 73 20 6e 65 76 65 72 20 63 61 6c ine is never cal
13270 6c 65 64 20 69 6e 20 50 41 47 45 52 5f 45 52 52 led in PAGER_ERR
13280 4f 52 20 73 74 61 74 65 2e 20 49 66 20 69 74 20 OR state. If it
13290 69 73 20 63 61 6c 6c 65 64 0a 2a 2a 20 69 6e 20 is called.** in
132a0 50 41 47 45 52 5f 4e 4f 4e 45 20 6f 72 20 50 41 PAGER_NONE or PA
132b0 47 45 52 5f 53 48 41 52 45 44 20 73 74 61 74 65 GER_SHARED state
132c0 20 61 6e 64 20 74 68 65 20 6c 6f 63 6b 20 68 65 and the lock he
132d0 6c 64 20 69 73 20 6c 65 73 73 0a 2a 2a 20 65 78 ld is less.** ex
132e0 63 6c 75 73 69 76 65 20 74 68 61 6e 20 61 20 52 clusive than a R
132f0 45 53 45 52 56 45 44 20 6c 6f 63 6b 2c 20 69 74 ESERVED lock, it
13300 20 69 73 20 61 20 6e 6f 2d 6f 70 2e 0a 2a 2a 0a is a no-op..**.
13310 2a 2a 20 4f 74 68 65 72 77 69 73 65 2c 20 61 6e ** Otherwise, an
13320 79 20 61 63 74 69 76 65 20 73 61 76 65 70 6f 69 y active savepoi
13330 6e 74 73 20 61 72 65 20 72 65 6c 65 61 73 65 64 nts are released
13340 2e 0a 2a 2a 0a 2a 2a 20 49 66 20 74 68 65 20 6a ..**.** If the j
13350 6f 75 72 6e 61 6c 20 66 69 6c 65 20 69 73 20 6f ournal file is o
13360 70 65 6e 2c 20 74 68 65 6e 20 69 74 20 69 73 20 pen, then it is
13370 22 66 69 6e 61 6c 69 7a 65 64 22 2e 20 4f 6e 63 "finalized". Onc
13380 65 20 61 20 6a 6f 75 72 6e 61 6c 20 0a 2a 2a 20 e a journal .**
13390 66 69 6c 65 20 68 61 73 20 62 65 65 6e 20 66 69 file has been fi
133a0 6e 61 6c 69 7a 65 64 20 69 74 20 69 73 20 6e 6f nalized it is no
133b0 74 20 70 6f 73 73 69 62 6c 65 20 74 6f 20 75 73 t possible to us
133c0 65 20 69 74 20 74 6f 20 72 6f 6c 6c 20 62 61 63 e it to roll bac
133d0 6b 20 61 20 0a 2a 2a 20 74 72 61 6e 73 61 63 74 k a .** transact
133e0 69 6f 6e 2e 20 4e 6f 72 20 77 69 6c 6c 20 69 74 ion. Nor will it
133f0 20 62 65 20 63 6f 6e 73 69 64 65 72 65 64 20 74 be considered t
13400 6f 20 62 65 20 61 20 68 6f 74 2d 6a 6f 75 72 6e o be a hot-journ
13410 61 6c 20 62 79 20 74 68 69 73 0a 2a 2a 20 6f 72 al by this.** or
13420 20 61 6e 79 20 6f 74 68 65 72 20 64 61 74 61 62 any other datab
13430 61 73 65 20 63 6f 6e 6e 65 63 74 69 6f 6e 2e 20 ase connection.
13440 45 78 61 63 74 6c 79 20 68 6f 77 20 61 20 6a 6f Exactly how a jo
13450 75 72 6e 61 6c 20 69 73 20 66 69 6e 61 6c 69 7a urnal is finaliz
13460 65 64 0a 2a 2a 20 64 65 70 65 6e 64 73 20 6f 6e ed.** depends on
13470 20 77 68 65 74 68 65 72 20 6f 72 20 6e 6f 74 20 whether or not
13480 74 68 65 20 70 61 67 65 72 20 69 73 20 72 75 6e the pager is run
13490 6e 69 6e 67 20 69 6e 20 65 78 63 6c 75 73 69 76 ning in exclusiv
134a0 65 20 6d 6f 64 65 20 61 6e 64 0a 2a 2a 20 74 68 e mode and.** th
134b0 65 20 63 75 72 72 65 6e 74 20 6a 6f 75 72 6e 61 e current journa
134c0 6c 2d 6d 6f 64 65 20 28 50 61 67 65 72 2e 6a 6f l-mode (Pager.jo
134d0 75 72 6e 61 6c 4d 6f 64 65 20 76 61 6c 75 65 29 urnalMode value)
134e0 2c 20 61 73 20 66 6f 6c 6c 6f 77 73 3a 0a 2a 2a , as follows:.**
134f0 0a 2a 2a 20 20 20 6a 6f 75 72 6e 61 6c 4d 6f 64 .** journalMod
13500 65 3d 3d 4d 45 4d 4f 52 59 0a 2a 2a 20 20 20 20 e==MEMORY.**
13510 20 4a 6f 75 72 6e 61 6c 20 66 69 6c 65 20 64 65 Journal file de
13520 73 63 72 69 70 74 6f 72 20 69 73 20 73 69 6d 70 scriptor is simp
13530 6c 79 20 63 6c 6f 73 65 64 2e 20 54 68 69 73 20 ly closed. This
13540 64 65 73 74 72 6f 79 73 20 61 6e 20 0a 2a 2a 20 destroys an .**
13550 20 20 20 20 69 6e 2d 6d 65 6d 6f 72 79 20 6a 6f in-memory jo
13560 75 72 6e 61 6c 2e 0a 2a 2a 0a 2a 2a 20 20 20 6a urnal..**.** j
13570 6f 75 72 6e 61 6c 4d 6f 64 65 3d 3d 54 52 55 4e ournalMode==TRUN
13580 43 41 54 45 0a 2a 2a 20 20 20 20 20 4a 6f 75 72 CATE.** Jour
13590 6e 61 6c 20 66 69 6c 65 20 69 73 20 74 72 75 6e nal file is trun
135a0 63 61 74 65 64 20 74 6f 20 7a 65 72 6f 20 62 79 cated to zero by
135b0 74 65 73 20 69 6e 20 73 69 7a 65 2e 0a 2a 2a 0a tes in size..**.
135c0 2a 2a 20 20 20 6a 6f 75 72 6e 61 6c 4d 6f 64 65 ** journalMode
135d0 3d 3d 50 45 52 53 49 53 54 0a 2a 2a 20 20 20 20 ==PERSIST.**
135e0 20 54 68 65 20 66 69 72 73 74 20 32 38 20 62 79 The first 28 by
135f0 74 65 73 20 6f 66 20 74 68 65 20 6a 6f 75 72 6e tes of the journ
13600 61 6c 20 66 69 6c 65 20 61 72 65 20 7a 65 72 6f al file are zero
13610 65 64 2e 20 54 68 69 73 20 69 6e 76 61 6c 69 64 ed. This invalid
13620 61 74 65 73 0a 2a 2a 20 20 20 20 20 74 68 65 20 ates.** the
13630 66 69 72 73 74 20 6a 6f 75 72 6e 61 6c 20 68 65 first journal he
13640 61 64 65 72 20 69 6e 20 74 68 65 20 66 69 6c 65 ader in the file
13650 2c 20 61 6e 64 20 68 65 6e 63 65 20 74 68 65 20 , and hence the
13660 65 6e 74 69 72 65 20 6a 6f 75 72 6e 61 6c 0a 2a entire journal.*
13670 2a 20 20 20 20 20 66 69 6c 65 2e 20 41 6e 20 69 * file. An i
13680 6e 76 61 6c 69 64 20 6a 6f 75 72 6e 61 6c 20 66 nvalid journal f
13690 69 6c 65 20 63 61 6e 6e 6f 74 20 62 65 20 72 6f ile cannot be ro
136a0 6c 6c 65 64 20 62 61 63 6b 2e 0a 2a 2a 0a 2a 2a lled back..**.**
136b0 20 20 20 6a 6f 75 72 6e 61 6c 4d 6f 64 65 3d 3d journalMode==
136c0 44 45 4c 45 54 45 0a 2a 2a 20 20 20 20 20 54 68 DELETE.** Th
136d0 65 20 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 20 69 e journal file i
136e0 73 20 63 6c 6f 73 65 64 20 61 6e 64 20 64 65 6c s closed and del
136f0 65 74 65 64 20 75 73 69 6e 67 20 73 71 6c 69 74 eted using sqlit
13700 65 33 4f 73 44 65 6c 65 74 65 28 29 2e 0a 2a 2a e3OsDelete()..**
13710 0a 2a 2a 20 20 20 20 20 49 66 20 74 68 65 20 70 .** If the p
13720 61 67 65 72 20 69 73 20 72 75 6e 6e 69 6e 67 20 ager is running
13730 69 6e 20 65 78 63 6c 75 73 69 76 65 20 6d 6f 64 in exclusive mod
13740 65 2c 20 74 68 69 73 20 6d 65 74 68 6f 64 20 6f e, this method o
13750 66 20 66 69 6e 61 6c 69 7a 69 6e 67 0a 2a 2a 20 f finalizing.**
13760 20 20 20 20 74 68 65 20 6a 6f 75 72 6e 61 6c 20 the journal
13770 66 69 6c 65 20 69 73 20 6e 65 76 65 72 20 75 73 file is never us
13780 65 64 2e 20 49 6e 73 74 65 61 64 2c 20 69 66 20 ed. Instead, if
13790 74 68 65 20 6a 6f 75 72 6e 61 6c 4d 6f 64 65 20 the journalMode
137a0 69 73 0a 2a 2a 20 20 20 20 20 44 45 4c 45 54 45 is.** DELETE
137b0 20 61 6e 64 20 74 68 65 20 70 61 67 65 72 20 69 and the pager i
137c0 73 20 69 6e 20 65 78 63 6c 75 73 69 76 65 20 6d s in exclusive m
137d0 6f 64 65 2c 20 74 68 65 20 6d 65 74 68 6f 64 20 ode, the method
137e0 64 65 73 63 72 69 62 65 64 20 75 6e 64 65 72 0a described under.
137f0 2a 2a 20 20 20 20 20 6a 6f 75 72 6e 61 6c 4d 6f ** journalMo
13800 64 65 3d 3d 50 45 52 53 49 53 54 20 69 73 20 75 de==PERSIST is u
13810 73 65 64 20 69 6e 73 74 65 61 64 2e 0a 2a 2a 0a sed instead..**.
13820 2a 2a 20 41 66 74 65 72 20 74 68 65 20 6a 6f 75 ** After the jou
13830 72 6e 61 6c 20 69 73 20 66 69 6e 61 6c 69 7a 65 rnal is finalize
13840 64 2c 20 74 68 65 20 70 61 67 65 72 20 6d 6f 76 d, the pager mov
13850 65 73 20 74 6f 20 50 41 47 45 52 5f 52 45 41 44 es to PAGER_READ
13860 45 52 20 73 74 61 74 65 2e 0a 2a 2a 20 49 66 20 ER state..** If
13870 72 75 6e 6e 69 6e 67 20 69 6e 20 6e 6f 6e 2d 65 running in non-e
13880 78 63 6c 75 73 69 76 65 20 72 6f 6c 6c 62 61 63 xclusive rollbac
13890 6b 20 6d 6f 64 65 2c 20 74 68 65 20 6c 6f 63 6b k mode, the lock
138a0 20 6f 6e 20 74 68 65 20 66 69 6c 65 20 69 73 20 on the file is
138b0 0a 2a 2a 20 64 6f 77 6e 67 72 61 64 65 64 20 74 .** downgraded t
138c0 6f 20 61 20 53 48 41 52 45 44 5f 4c 4f 43 4b 2e o a SHARED_LOCK.
138d0 0a 2a 2a 0a 2a 2a 20 53 51 4c 49 54 45 5f 4f 4b .**.** SQLITE_OK
138e0 20 69 73 20 72 65 74 75 72 6e 65 64 20 69 66 20 is returned if
138f0 6e 6f 20 65 72 72 6f 72 20 6f 63 63 75 72 73 2e no error occurs.
13900 20 49 66 20 61 6e 20 65 72 72 6f 72 20 6f 63 63 If an error occ
13910 75 72 73 20 64 75 72 69 6e 67 0a 2a 2a 20 61 6e urs during.** an
13920 79 20 6f 66 20 74 68 65 20 49 4f 20 6f 70 65 72 y of the IO oper
13930 61 74 69 6f 6e 73 20 74 6f 20 66 69 6e 61 6c 69 ations to finali
13940 7a 65 20 74 68 65 20 6a 6f 75 72 6e 61 6c 20 66 ze the journal f
13950 69 6c 65 20 6f 72 20 75 6e 6c 6f 63 6b 20 74 68 ile or unlock th
13960 65 0a 2a 2a 20 64 61 74 61 62 61 73 65 20 74 68 e.** database th
13970 65 6e 20 74 68 65 20 49 4f 20 65 72 72 6f 72 20 en the IO error
13980 63 6f 64 65 20 69 73 20 72 65 74 75 72 6e 65 64 code is returned
13990 20 74 6f 20 74 68 65 20 75 73 65 72 2e 20 49 66 to the user. If
139a0 20 74 68 65 20 0a 2a 2a 20 6f 70 65 72 61 74 69 the .** operati
139b0 6f 6e 20 74 6f 20 66 69 6e 61 6c 69 7a 65 20 74 on to finalize t
139c0 68 65 20 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 20 he journal file
139d0 66 61 69 6c 73 2c 20 74 68 65 6e 20 74 68 65 20 fails, then the
139e0 63 6f 64 65 20 73 74 69 6c 6c 0a 2a 2a 20 74 72 code still.** tr
139f0 69 65 73 20 74 6f 20 75 6e 6c 6f 63 6b 20 74 68 ies to unlock th
13a00 65 20 64 61 74 61 62 61 73 65 20 66 69 6c 65 20 e database file
13a10 69 66 20 6e 6f 74 20 69 6e 20 65 78 63 6c 75 73 if not in exclus
13a20 69 76 65 20 6d 6f 64 65 2e 20 49 66 20 74 68 65 ive mode. If the
13a30 0a 2a 2a 20 75 6e 6c 6f 63 6b 20 6f 70 65 72 61 .** unlock opera
13a40 74 69 6f 6e 20 66 61 69 6c 73 20 61 73 20 77 65 tion fails as we
13a50 6c 6c 2c 20 74 68 65 6e 20 74 68 65 20 66 69 72 ll, then the fir
13a60 73 74 20 65 72 72 6f 72 20 63 6f 64 65 20 72 65 st error code re
13a70 6c 61 74 65 64 0a 2a 2a 20 74 6f 20 74 68 65 20 lated.** to the
13a80 66 69 72 73 74 20 65 72 72 6f 72 20 65 6e 63 6f first error enco
13a90 75 6e 74 65 72 65 64 20 28 74 68 65 20 6a 6f 75 untered (the jou
13aa0 72 6e 61 6c 20 66 69 6e 61 6c 69 7a 61 74 69 6f rnal finalizatio
13ab0 6e 20 6f 6e 65 29 20 69 73 0a 2a 2a 20 72 65 74 n one) is.** ret
13ac0 75 72 6e 65 64 2e 0a 2a 2f 0a 73 74 61 74 69 63 urned..*/.static
13ad0 20 69 6e 74 20 70 61 67 65 72 5f 65 6e 64 5f 74 int pager_end_t
13ae0 72 61 6e 73 61 63 74 69 6f 6e 28 50 61 67 65 72 ransaction(Pager
13af0 20 2a 70 50 61 67 65 72 2c 20 69 6e 74 20 68 61 *pPager, int ha
13b00 73 4d 61 73 74 65 72 2c 20 69 6e 74 20 62 43 6f sMaster, int bCo
13b10 6d 6d 69 74 29 7b 0a 20 20 69 6e 74 20 72 63 20 mmit){. int rc
13b20 3d 20 53 51 4c 49 54 45 5f 4f 4b 3b 20 20 20 20 = SQLITE_OK;
13b30 20 20 2f 2a 20 45 72 72 6f 72 20 63 6f 64 65 20 /* Error code
13b40 66 72 6f 6d 20 6a 6f 75 72 6e 61 6c 20 66 69 6e from journal fin
13b50 61 6c 69 7a 61 74 69 6f 6e 20 6f 70 65 72 61 74 alization operat
13b60 69 6f 6e 20 2a 2f 0a 20 20 69 6e 74 20 72 63 32 ion */. int rc2
13b70 20 3d 20 53 51 4c 49 54 45 5f 4f 4b 3b 20 20 20 = SQLITE_OK;
13b80 20 20 2f 2a 20 45 72 72 6f 72 20 63 6f 64 65 20 /* Error code
13b90 66 72 6f 6d 20 64 62 20 66 69 6c 65 20 75 6e 6c from db file unl
13ba0 6f 63 6b 20 6f 70 65 72 61 74 69 6f 6e 20 2a 2f ock operation */
13bb0 0a 0a 20 20 2f 2a 20 44 6f 20 6e 6f 74 68 69 6e .. /* Do nothin
13bc0 67 20 69 66 20 74 68 65 20 70 61 67 65 72 20 64 g if the pager d
13bd0 6f 65 73 20 6e 6f 74 20 68 61 76 65 20 61 6e 20 oes not have an
13be0 6f 70 65 6e 20 77 72 69 74 65 20 74 72 61 6e 73 open write trans
13bf0 61 63 74 69 6f 6e 0a 20 20 2a 2a 20 6f 72 20 61 action. ** or a
13c00 74 20 6c 65 61 73 74 20 61 20 52 45 53 45 52 56 t least a RESERV
13c10 45 44 20 6c 6f 63 6b 2e 20 54 68 69 73 20 66 75 ED lock. This fu
13c20 6e 63 74 69 6f 6e 20 6d 61 79 20 62 65 20 63 61 nction may be ca
13c30 6c 6c 65 64 20 77 68 65 6e 20 74 68 65 72 65 0a lled when there.
13c40 20 20 2a 2a 20 69 73 20 6e 6f 20 77 72 69 74 65 ** is no write
13c50 2d 74 72 61 6e 73 61 63 74 69 6f 6e 20 61 63 74 -transaction act
13c60 69 76 65 20 62 75 74 20 61 20 52 45 53 45 52 56 ive but a RESERV
13c70 45 44 20 6f 72 20 67 72 65 61 74 65 72 20 6c 6f ED or greater lo
13c80 63 6b 20 69 73 0a 20 20 2a 2a 20 68 65 6c 64 20 ck is. ** held
13c90 75 6e 64 65 72 20 74 77 6f 20 63 69 72 63 75 6d under two circum
13ca0 73 74 61 6e 63 65 73 3a 0a 20 20 2a 2a 0a 20 20 stances:. **.
13cb0 2a 2a 20 20 20 31 2e 20 41 66 74 65 72 20 61 20 ** 1. After a
13cc0 73 75 63 63 65 73 73 66 75 6c 20 68 6f 74 2d 6a successful hot-j
13cd0 6f 75 72 6e 61 6c 20 72 6f 6c 6c 62 61 63 6b 2c ournal rollback,
13ce0 20 69 74 20 69 73 20 63 61 6c 6c 65 64 20 77 69 it is called wi
13cf0 74 68 0a 20 20 2a 2a 20 20 20 20 20 20 65 53 74 th. ** eSt
13d00 61 74 65 3d 3d 50 41 47 45 52 5f 4e 4f 4e 45 20 ate==PAGER_NONE
13d10 61 6e 64 20 65 4c 6f 63 6b 3d 3d 45 58 43 4c 55 and eLock==EXCLU
13d20 53 49 56 45 5f 4c 4f 43 4b 2e 0a 20 20 2a 2a 0a SIVE_LOCK.. **.
13d30 20 20 2a 2a 20 20 20 32 2e 20 49 66 20 61 20 63 ** 2. If a c
13d40 6f 6e 6e 65 63 74 69 6f 6e 20 77 69 74 68 20 6c onnection with l
13d50 6f 63 6b 69 6e 67 5f 6d 6f 64 65 3d 65 78 63 6c ocking_mode=excl
13d60 75 73 69 76 65 20 68 6f 6c 64 69 6e 67 20 61 6e usive holding an
13d70 20 45 58 43 4c 55 53 49 56 45 20 0a 20 20 2a 2a EXCLUSIVE . **
13d80 20 20 20 20 20 20 6c 6f 63 6b 20 73 77 69 74 63 lock switc
13d90 68 65 73 20 62 61 63 6b 20 74 6f 20 6c 6f 63 6b hes back to lock
13da0 69 6e 67 5f 6d 6f 64 65 3d 6e 6f 72 6d 61 6c 20 ing_mode=normal
13db0 61 6e 64 20 74 68 65 6e 20 65 78 65 63 75 74 65 and then execute
13dc0 73 20 61 0a 20 20 2a 2a 20 20 20 20 20 20 72 65 s a. ** re
13dd0 61 64 2d 74 72 61 6e 73 61 63 74 69 6f 6e 2c 20 ad-transaction,
13de0 74 68 69 73 20 66 75 6e 63 74 69 6f 6e 20 69 73 this function is
13df0 20 63 61 6c 6c 65 64 20 77 69 74 68 20 65 53 74 called with eSt
13e00 61 74 65 3d 3d 50 41 47 45 52 5f 52 45 41 44 45 ate==PAGER_READE
13e10 52 20 0a 20 20 2a 2a 20 20 20 20 20 20 61 6e 64 R . ** and
13e20 20 65 4c 6f 63 6b 3d 3d 45 58 43 4c 55 53 49 56 eLock==EXCLUSIV
13e30 45 5f 4c 4f 43 4b 20 77 68 65 6e 20 74 68 65 20 E_LOCK when the
13e40 72 65 61 64 2d 74 72 61 6e 73 61 63 74 69 6f 6e read-transaction
13e50 20 69 73 20 63 6c 6f 73 65 64 2e 0a 20 20 2a 2f is closed.. */
13e60 0a 20 20 61 73 73 65 72 74 28 20 61 73 73 65 72 . assert( asser
13e70 74 5f 70 61 67 65 72 5f 73 74 61 74 65 28 70 50 t_pager_state(pP
13e80 61 67 65 72 29 20 29 3b 0a 20 20 61 73 73 65 72 ager) );. asser
13e90 74 28 20 70 50 61 67 65 72 2d 3e 65 53 74 61 74 t( pPager->eStat
13ea0 65 21 3d 50 41 47 45 52 5f 45 52 52 4f 52 20 29 e!=PAGER_ERROR )
13eb0 3b 0a 20 20 69 66 28 20 70 50 61 67 65 72 2d 3e ;. if( pPager->
13ec0 65 53 74 61 74 65 3c 50 41 47 45 52 5f 57 52 49 eState<PAGER_WRI
13ed0 54 45 52 5f 4c 4f 43 4b 45 44 20 26 26 20 70 50 TER_LOCKED && pP
13ee0 61 67 65 72 2d 3e 65 4c 6f 63 6b 3c 52 45 53 45 ager->eLock<RESE
13ef0 52 56 45 44 5f 4c 4f 43 4b 20 29 7b 0a 20 20 20 RVED_LOCK ){.
13f00 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f return SQLITE_O
13f10 4b 3b 0a 20 20 7d 0a 0a 20 20 72 65 6c 65 61 73 K;. }.. releas
13f20 65 41 6c 6c 53 61 76 65 70 6f 69 6e 74 73 28 70 eAllSavepoints(p
13f30 50 61 67 65 72 29 3b 0a 20 20 61 73 73 65 72 74 Pager);. assert
13f40 28 20 69 73 4f 70 65 6e 28 70 50 61 67 65 72 2d ( isOpen(pPager-
13f50 3e 6a 66 64 29 20 7c 7c 20 70 50 61 67 65 72 2d >jfd) || pPager-
13f60 3e 70 49 6e 4a 6f 75 72 6e 61 6c 3d 3d 30 20 29 >pInJournal==0 )
13f70 3b 0a 20 20 69 66 28 20 69 73 4f 70 65 6e 28 70 ;. if( isOpen(p
13f80 50 61 67 65 72 2d 3e 6a 66 64 29 20 29 7b 0a 20 Pager->jfd) ){.
13f90 20 20 20 61 73 73 65 72 74 28 20 21 70 61 67 65 assert( !page
13fa0 72 55 73 65 57 61 6c 28 70 50 61 67 65 72 29 20 rUseWal(pPager)
13fb0 29 3b 0a 0a 20 20 20 20 2f 2a 20 46 69 6e 61 6c );.. /* Final
13fc0 69 7a 65 20 74 68 65 20 6a 6f 75 72 6e 61 6c 20 ize the journal
13fd0 66 69 6c 65 2e 20 2a 2f 0a 20 20 20 20 69 66 28 file. */. if(
13fe0 20 73 71 6c 69 74 65 33 4a 6f 75 72 6e 61 6c 49 sqlite3JournalI
13ff0 73 49 6e 4d 65 6d 6f 72 79 28 70 50 61 67 65 72 sInMemory(pPager
14000 2d 3e 6a 66 64 29 20 29 7b 0a 20 20 20 20 20 20 ->jfd) ){.
14010 2f 2a 20 61 73 73 65 72 74 28 20 70 50 61 67 65 /* assert( pPage
14020 72 2d 3e 6a 6f 75 72 6e 61 6c 4d 6f 64 65 3d 3d r->journalMode==
14030 50 41 47 45 52 5f 4a 4f 55 52 4e 41 4c 4d 4f 44 PAGER_JOURNALMOD
14040 45 5f 4d 45 4d 4f 52 59 20 29 3b 20 2a 2f 0a 20 E_MEMORY ); */.
14050 20 20 20 20 20 73 71 6c 69 74 65 33 4f 73 43 6c sqlite3OsCl
14060 6f 73 65 28 70 50 61 67 65 72 2d 3e 6a 66 64 29 ose(pPager->jfd)
14070 3b 0a 20 20 20 20 7d 65 6c 73 65 20 69 66 28 20 ;. }else if(
14080 70 50 61 67 65 72 2d 3e 6a 6f 75 72 6e 61 6c 4d pPager->journalM
14090 6f 64 65 3d 3d 50 41 47 45 52 5f 4a 4f 55 52 4e ode==PAGER_JOURN
140a0 41 4c 4d 4f 44 45 5f 54 52 55 4e 43 41 54 45 20 ALMODE_TRUNCATE
140b0 29 7b 0a 20 20 20 20 20 20 69 66 28 20 70 50 61 ){. if( pPa
140c0 67 65 72 2d 3e 6a 6f 75 72 6e 61 6c 4f 66 66 3d ger->journalOff=
140d0 3d 30 20 29 7b 0a 20 20 20 20 20 20 20 20 72 63 =0 ){. rc
140e0 20 3d 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20 20 = SQLITE_OK;.
140f0 20 20 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 20 }else{.
14100 20 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33 4f rc = sqlite3O
14110 73 54 72 75 6e 63 61 74 65 28 70 50 61 67 65 72 sTruncate(pPager
14120 2d 3e 6a 66 64 2c 20 30 29 3b 0a 20 20 20 20 20 ->jfd, 0);.
14130 20 20 20 69 66 28 20 72 63 3d 3d 53 51 4c 49 54 if( rc==SQLIT
14140 45 5f 4f 4b 20 26 26 20 70 50 61 67 65 72 2d 3e E_OK && pPager->
14150 66 75 6c 6c 53 79 6e 63 20 29 7b 0a 20 20 20 20 fullSync ){.
14160 20 20 20 20 20 20 2f 2a 20 4d 61 6b 65 20 73 75 /* Make su
14170 72 65 20 74 68 65 20 6e 65 77 20 66 69 6c 65 20 re the new file
14180 73 69 7a 65 20 69 73 20 77 72 69 74 74 65 6e 20 size is written
14190 69 6e 74 6f 20 74 68 65 20 69 6e 6f 64 65 20 72 into the inode r
141a0 69 67 68 74 20 61 77 61 79 2e 0a 20 20 20 20 20 ight away..
141b0 20 20 20 20 20 2a 2a 20 4f 74 68 65 72 77 69 73 ** Otherwis
141c0 65 20 74 68 65 20 6a 6f 75 72 6e 61 6c 20 6d 69 e the journal mi
141d0 67 68 74 20 72 65 73 75 72 72 65 63 74 20 66 6f ght resurrect fo
141e0 6c 6c 6f 77 69 6e 67 20 61 20 70 6f 77 65 72 20 llowing a power
141f0 6c 6f 73 73 20 61 6e 64 0a 20 20 20 20 20 20 20 loss and.
14200 20 20 20 2a 2a 20 63 61 75 73 65 20 74 68 65 20 ** cause the
14210 6c 61 73 74 20 74 72 61 6e 73 61 63 74 69 6f 6e last transaction
14220 20 74 6f 20 72 6f 6c 6c 20 62 61 63 6b 2e 20 20 to roll back.
14230 53 65 65 0a 20 20 20 20 20 20 20 20 20 20 2a 2a See. **
14240 20 68 74 74 70 73 3a 2f 2f 62 75 67 7a 69 6c 6c https://bugzill
14250 61 2e 6d 6f 7a 69 6c 6c 61 2e 6f 72 67 2f 73 68 a.mozilla.org/sh
14260 6f 77 5f 62 75 67 2e 63 67 69 3f 69 64 3d 31 30 ow_bug.cgi?id=10
14270 37 32 37 37 33 0a 20 20 20 20 20 20 20 20 20 20 72773.
14280 2a 2f 0a 20 20 20 20 20 20 20 20 20 20 72 63 20 */. rc
14290 3d 20 73 71 6c 69 74 65 33 4f 73 53 79 6e 63 28 = sqlite3OsSync(
142a0 70 50 61 67 65 72 2d 3e 6a 66 64 2c 20 70 50 61 pPager->jfd, pPa
142b0 67 65 72 2d 3e 73 79 6e 63 46 6c 61 67 73 29 3b ger->syncFlags);
142c0 0a 20 20 20 20 20 20 20 20 7d 0a 20 20 20 20 20 . }.
142d0 20 7d 0a 20 20 20 20 20 20 70 50 61 67 65 72 2d }. pPager-
142e0 3e 6a 6f 75 72 6e 61 6c 4f 66 66 20 3d 20 30 3b >journalOff = 0;
142f0 0a 20 20 20 20 7d 65 6c 73 65 20 69 66 28 20 70 . }else if( p
14300 50 61 67 65 72 2d 3e 6a 6f 75 72 6e 61 6c 4d 6f Pager->journalMo
14310 64 65 3d 3d 50 41 47 45 52 5f 4a 4f 55 52 4e 41 de==PAGER_JOURNA
14320 4c 4d 4f 44 45 5f 50 45 52 53 49 53 54 0a 20 20 LMODE_PERSIST.
14330 20 20 20 20 7c 7c 20 28 70 50 61 67 65 72 2d 3e || (pPager->
14340 65 78 63 6c 75 73 69 76 65 4d 6f 64 65 20 26 26 exclusiveMode &&
14350 20 70 50 61 67 65 72 2d 3e 6a 6f 75 72 6e 61 6c pPager->journal
14360 4d 6f 64 65 21 3d 50 41 47 45 52 5f 4a 4f 55 52 Mode!=PAGER_JOUR
14370 4e 41 4c 4d 4f 44 45 5f 57 41 4c 29 0a 20 20 20 NALMODE_WAL).
14380 20 29 7b 0a 20 20 20 20 20 20 72 63 20 3d 20 7a ){. rc = z
14390 65 72 6f 4a 6f 75 72 6e 61 6c 48 64 72 28 70 50 eroJournalHdr(pP
143a0 61 67 65 72 2c 20 68 61 73 4d 61 73 74 65 72 29 ager, hasMaster)
143b0 3b 0a 20 20 20 20 20 20 70 50 61 67 65 72 2d 3e ;. pPager->
143c0 6a 6f 75 72 6e 61 6c 4f 66 66 20 3d 20 30 3b 0a journalOff = 0;.
143d0 20 20 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 20 }else{.
143e0 20 2f 2a 20 54 68 69 73 20 62 72 61 6e 63 68 20 /* This branch
143f0 6d 61 79 20 62 65 20 65 78 65 63 75 74 65 64 20 may be executed
14400 77 69 74 68 20 50 61 67 65 72 2e 6a 6f 75 72 6e with Pager.journ
14410 61 6c 4d 6f 64 65 3d 3d 4d 45 4d 4f 52 59 20 69 alMode==MEMORY i
14420 66 0a 20 20 20 20 20 20 2a 2a 20 61 20 68 6f 74 f. ** a hot
14430 2d 6a 6f 75 72 6e 61 6c 20 77 61 73 20 6a 75 73 -journal was jus
14440 74 20 72 6f 6c 6c 65 64 20 62 61 63 6b 2e 20 49 t rolled back. I
14450 6e 20 74 68 69 73 20 63 61 73 65 20 74 68 65 20 n this case the
14460 6a 6f 75 72 6e 61 6c 0a 20 20 20 20 20 20 2a 2a journal. **
14470 20 66 69 6c 65 20 73 68 6f 75 6c 64 20 62 65 20 file should be
14480 63 6c 6f 73 65 64 20 61 6e 64 20 64 65 6c 65 74 closed and delet
14490 65 64 2e 20 49 66 20 74 68 69 73 20 63 6f 6e 6e ed. If this conn
144a0 65 63 74 69 6f 6e 20 77 72 69 74 65 73 20 74 6f ection writes to
144b0 0a 20 20 20 20 20 20 2a 2a 20 74 68 65 20 64 61 . ** the da
144c0 74 61 62 61 73 65 20 66 69 6c 65 2c 20 69 74 20 tabase file, it
144d0 77 69 6c 6c 20 64 6f 20 73 6f 20 75 73 69 6e 67 will do so using
144e0 20 61 6e 20 69 6e 2d 6d 65 6d 6f 72 79 20 6a 6f an in-memory jo
144f0 75 72 6e 61 6c 2e 0a 20 20 20 20 20 20 2a 2f 0a urnal.. */.
14500 20 20 20 20 20 20 69 6e 74 20 62 44 65 6c 65 74 int bDelet
14510 65 20 3d 20 21 70 50 61 67 65 72 2d 3e 74 65 6d e = !pPager->tem
14520 70 46 69 6c 65 3b 0a 20 20 20 20 20 20 61 73 73 pFile;. ass
14530 65 72 74 28 20 73 71 6c 69 74 65 33 4a 6f 75 72 ert( sqlite3Jour
14540 6e 61 6c 49 73 49 6e 4d 65 6d 6f 72 79 28 70 50 nalIsInMemory(pP
14550 61 67 65 72 2d 3e 6a 66 64 29 3d 3d 30 20 29 3b ager->jfd)==0 );
14560 0a 20 20 20 20 20 20 61 73 73 65 72 74 28 20 70 . assert( p
14570 50 61 67 65 72 2d 3e 6a 6f 75 72 6e 61 6c 4d 6f Pager->journalMo
14580 64 65 3d 3d 50 41 47 45 52 5f 4a 4f 55 52 4e 41 de==PAGER_JOURNA
14590 4c 4d 4f 44 45 5f 44 45 4c 45 54 45 20 0a 20 20 LMODE_DELETE .
145a0 20 20 20 20 20 20 20 20 20 7c 7c 20 70 50 61 67 || pPag
145b0 65 72 2d 3e 6a 6f 75 72 6e 61 6c 4d 6f 64 65 3d er->journalMode=
145c0 3d 50 41 47 45 52 5f 4a 4f 55 52 4e 41 4c 4d 4f =PAGER_JOURNALMO
145d0 44 45 5f 4d 45 4d 4f 52 59 20 0a 20 20 20 20 20 DE_MEMORY .
145e0 20 20 20 20 20 20 7c 7c 20 70 50 61 67 65 72 2d || pPager-
145f0 3e 6a 6f 75 72 6e 61 6c 4d 6f 64 65 3d 3d 50 41 >journalMode==PA
14600 47 45 52 5f 4a 4f 55 52 4e 41 4c 4d 4f 44 45 5f GER_JOURNALMODE_
14610 57 41 4c 20 0a 20 20 20 20 20 20 29 3b 0a 20 20 WAL . );.
14620 20 20 20 20 73 71 6c 69 74 65 33 4f 73 43 6c 6f sqlite3OsClo
14630 73 65 28 70 50 61 67 65 72 2d 3e 6a 66 64 29 3b se(pPager->jfd);
14640 0a 20 20 20 20 20 20 69 66 28 20 62 44 65 6c 65 . if( bDele
14650 74 65 20 29 7b 0a 20 20 20 20 20 20 20 20 72 63 te ){. rc
14660 20 3d 20 73 71 6c 69 74 65 33 4f 73 44 65 6c 65 = sqlite3OsDele
14670 74 65 28 70 50 61 67 65 72 2d 3e 70 56 66 73 2c te(pPager->pVfs,
14680 20 70 50 61 67 65 72 2d 3e 7a 4a 6f 75 72 6e 61 pPager->zJourna
14690 6c 2c 20 70 50 61 67 65 72 2d 3e 65 78 74 72 61 l, pPager->extra
146a0 53 79 6e 63 29 3b 0a 20 20 20 20 20 20 7d 0a 20 Sync);. }.
146b0 20 20 20 7d 0a 20 20 7d 0a 0a 23 69 66 64 65 66 }. }..#ifdef
146c0 20 53 51 4c 49 54 45 5f 43 48 45 43 4b 5f 50 41 SQLITE_CHECK_PA
146d0 47 45 53 0a 20 20 73 71 6c 69 74 65 33 50 63 61 GES. sqlite3Pca
146e0 63 68 65 49 74 65 72 61 74 65 44 69 72 74 79 28 cheIterateDirty(
146f0 70 50 61 67 65 72 2d 3e 70 50 43 61 63 68 65 2c pPager->pPCache,
14700 20 70 61 67 65 72 5f 73 65 74 5f 70 61 67 65 68 pager_set_pageh
14710 61 73 68 29 3b 0a 20 20 69 66 28 20 70 50 61 67 ash);. if( pPag
14720 65 72 2d 3e 64 62 53 69 7a 65 3d 3d 30 20 26 26 er->dbSize==0 &&
14730 20 73 71 6c 69 74 65 33 50 63 61 63 68 65 52 65 sqlite3PcacheRe
14740 66 43 6f 75 6e 74 28 70 50 61 67 65 72 2d 3e 70 fCount(pPager->p
14750 50 43 61 63 68 65 29 3e 30 20 29 7b 0a 20 20 20 PCache)>0 ){.
14760 20 50 67 48 64 72 20 2a 70 20 3d 20 73 71 6c 69 PgHdr *p = sqli
14770 74 65 33 50 61 67 65 72 4c 6f 6f 6b 75 70 28 70 te3PagerLookup(p
14780 50 61 67 65 72 2c 20 31 29 3b 0a 20 20 20 20 69 Pager, 1);. i
14790 66 28 20 70 20 29 7b 0a 20 20 20 20 20 20 70 2d f( p ){. p-
147a0 3e 70 61 67 65 48 61 73 68 20 3d 20 30 3b 0a 20 >pageHash = 0;.
147b0 20 20 20 20 20 73 71 6c 69 74 65 33 50 61 67 65 sqlite3Page
147c0 72 55 6e 72 65 66 4e 6f 74 4e 75 6c 6c 28 70 29 rUnrefNotNull(p)
147d0 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a 23 65 6e 64 ;. }. }.#end
147e0 69 66 0a 0a 20 20 73 71 6c 69 74 65 33 42 69 74 if.. sqlite3Bit
147f0 76 65 63 44 65 73 74 72 6f 79 28 70 50 61 67 65 vecDestroy(pPage
14800 72 2d 3e 70 49 6e 4a 6f 75 72 6e 61 6c 29 3b 0a r->pInJournal);.
14810 20 20 70 50 61 67 65 72 2d 3e 70 49 6e 4a 6f 75 pPager->pInJou
14820 72 6e 61 6c 20 3d 20 30 3b 0a 20 20 70 50 61 67 rnal = 0;. pPag
14830 65 72 2d 3e 6e 52 65 63 20 3d 20 30 3b 0a 20 20 er->nRec = 0;.
14840 69 66 28 20 70 61 67 65 72 46 6c 75 73 68 4f 6e if( pagerFlushOn
14850 43 6f 6d 6d 69 74 28 70 50 61 67 65 72 29 20 29 Commit(pPager) )
14860 7b 0a 20 20 20 20 73 71 6c 69 74 65 33 50 63 61 {. sqlite3Pca
14870 63 68 65 43 6c 65 61 6e 41 6c 6c 28 70 50 61 67 cheCleanAll(pPag
14880 65 72 2d 3e 70 50 43 61 63 68 65 29 3b 0a 20 20 er->pPCache);.
14890 7d 65 6c 73 65 7b 0a 20 20 20 20 73 71 6c 69 74 }else{. sqlit
148a0 65 33 50 63 61 63 68 65 43 6c 65 61 72 57 72 69 e3PcacheClearWri
148b0 74 61 62 6c 65 28 70 50 61 67 65 72 2d 3e 70 50 table(pPager->pP
148c0 43 61 63 68 65 29 3b 0a 20 20 7d 0a 20 20 73 71 Cache);. }. sq
148d0 6c 69 74 65 33 50 63 61 63 68 65 54 72 75 6e 63 lite3PcacheTrunc
148e0 61 74 65 28 70 50 61 67 65 72 2d 3e 70 50 43 61 ate(pPager->pPCa
148f0 63 68 65 2c 20 70 50 61 67 65 72 2d 3e 64 62 53 che, pPager->dbS
14900 69 7a 65 29 3b 0a 0a 20 20 69 66 28 20 70 61 67 ize);.. if( pag
14910 65 72 55 73 65 57 61 6c 28 70 50 61 67 65 72 29 erUseWal(pPager)
14920 20 29 7b 0a 20 20 20 20 2f 2a 20 44 72 6f 70 20 ){. /* Drop
14930 74 68 65 20 57 41 4c 20 77 72 69 74 65 2d 6c 6f the WAL write-lo
14940 63 6b 2c 20 69 66 20 61 6e 79 2e 20 41 6c 73 6f ck, if any. Also
14950 2c 20 69 66 20 74 68 65 20 63 6f 6e 6e 65 63 74 , if the connect
14960 69 6f 6e 20 77 61 73 20 69 6e 20 0a 20 20 20 20 ion was in .
14970 2a 2a 20 6c 6f 63 6b 69 6e 67 5f 6d 6f 64 65 3d ** locking_mode=
14980 65 78 63 6c 75 73 69 76 65 20 6d 6f 64 65 20 62 exclusive mode b
14990 75 74 20 69 73 20 6e 6f 20 6c 6f 6e 67 65 72 2c ut is no longer,
149a0 20 64 72 6f 70 20 74 68 65 20 45 58 43 4c 55 53 drop the EXCLUS
149b0 49 56 45 20 0a 20 20 20 20 2a 2a 20 6c 6f 63 6b IVE . ** lock
149c0 20 68 65 6c 64 20 6f 6e 20 74 68 65 20 64 61 74 held on the dat
149d0 61 62 61 73 65 20 66 69 6c 65 2e 0a 20 20 20 20 abase file..
149e0 2a 2f 0a 20 20 20 20 72 63 32 20 3d 20 73 71 6c */. rc2 = sql
149f0 69 74 65 33 57 61 6c 45 6e 64 57 72 69 74 65 54 ite3WalEndWriteT
14a00 72 61 6e 73 61 63 74 69 6f 6e 28 70 50 61 67 65 ransaction(pPage
14a10 72 2d 3e 70 57 61 6c 29 3b 0a 20 20 20 20 61 73 r->pWal);. as
14a20 73 65 72 74 28 20 72 63 32 3d 3d 53 51 4c 49 54 sert( rc2==SQLIT
14a30 45 5f 4f 4b 20 29 3b 0a 20 20 7d 65 6c 73 65 20 E_OK );. }else
14a40 69 66 28 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4f if( rc==SQLITE_O
14a50 4b 20 26 26 20 62 43 6f 6d 6d 69 74 20 26 26 20 K && bCommit &&
14a60 70 50 61 67 65 72 2d 3e 64 62 46 69 6c 65 53 69 pPager->dbFileSi
14a70 7a 65 3e 70 50 61 67 65 72 2d 3e 64 62 53 69 7a ze>pPager->dbSiz
14a80 65 20 29 7b 0a 20 20 20 20 2f 2a 20 54 68 69 73 e ){. /* This
14a90 20 62 72 61 6e 63 68 20 69 73 20 74 61 6b 65 6e branch is taken
14aa0 20 77 68 65 6e 20 63 6f 6d 6d 69 74 74 69 6e 67 when committing
14ab0 20 61 20 74 72 61 6e 73 61 63 74 69 6f 6e 20 69 a transaction i
14ac0 6e 20 72 6f 6c 6c 62 61 63 6b 2d 6a 6f 75 72 6e n rollback-journ
14ad0 61 6c 0a 20 20 20 20 2a 2a 20 6d 6f 64 65 20 69 al. ** mode i
14ae0 66 20 74 68 65 20 64 61 74 61 62 61 73 65 20 66 f the database f
14af0 69 6c 65 20 6f 6e 20 64 69 73 6b 20 69 73 20 6c ile on disk is l
14b00 61 72 67 65 72 20 74 68 61 6e 20 74 68 65 20 64 arger than the d
14b10 61 74 61 62 61 73 65 20 69 6d 61 67 65 2e 0a 20 atabase image..
14b20 20 20 20 2a 2a 20 41 74 20 74 68 69 73 20 70 6f ** At this po
14b30 69 6e 74 20 74 68 65 20 6a 6f 75 72 6e 61 6c 20 int the journal
14b40 68 61 73 20 62 65 65 6e 20 66 69 6e 61 6c 69 7a has been finaliz
14b50 65 64 20 61 6e 64 20 74 68 65 20 74 72 61 6e 73 ed and the trans
14b60 61 63 74 69 6f 6e 20 0a 20 20 20 20 2a 2a 20 73 action . ** s
14b70 75 63 63 65 73 73 66 75 6c 6c 79 20 63 6f 6d 6d uccessfully comm
14b80 69 74 74 65 64 2c 20 62 75 74 20 74 68 65 20 45 itted, but the E
14b90 58 43 4c 55 53 49 56 45 20 6c 6f 63 6b 20 69 73 XCLUSIVE lock is
14ba0 20 73 74 69 6c 6c 20 68 65 6c 64 20 6f 6e 20 74 still held on t
14bb0 68 65 0a 20 20 20 20 2a 2a 20 66 69 6c 65 2e 20 he. ** file.
14bc0 53 6f 20 69 74 20 69 73 20 73 61 66 65 20 74 6f So it is safe to
14bd0 20 74 72 75 6e 63 61 74 65 20 74 68 65 20 64 61 truncate the da
14be0 74 61 62 61 73 65 20 66 69 6c 65 20 74 6f 20 69 tabase file to i
14bf0 74 73 20 6d 69 6e 69 6d 75 6d 0a 20 20 20 20 2a ts minimum. *
14c00 2a 20 72 65 71 75 69 72 65 64 20 73 69 7a 65 2e * required size.
14c10 20 20 2a 2f 0a 20 20 20 20 61 73 73 65 72 74 28 */. assert(
14c20 20 70 50 61 67 65 72 2d 3e 65 4c 6f 63 6b 3d 3d pPager->eLock==
14c30 45 58 43 4c 55 53 49 56 45 5f 4c 4f 43 4b 20 29 EXCLUSIVE_LOCK )
14c40 3b 0a 20 20 20 20 72 63 20 3d 20 70 61 67 65 72 ;. rc = pager
14c50 5f 74 72 75 6e 63 61 74 65 28 70 50 61 67 65 72 _truncate(pPager
14c60 2c 20 70 50 61 67 65 72 2d 3e 64 62 53 69 7a 65 , pPager->dbSize
14c70 29 3b 0a 20 20 7d 0a 0a 20 20 69 66 28 20 72 63 );. }.. if( rc
14c80 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 26 26 20 62 ==SQLITE_OK && b
14c90 43 6f 6d 6d 69 74 20 26 26 20 69 73 4f 70 65 6e Commit && isOpen
14ca0 28 70 50 61 67 65 72 2d 3e 66 64 29 20 29 7b 0a (pPager->fd) ){.
14cb0 20 20 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33 rc = sqlite3
14cc0 4f 73 46 69 6c 65 43 6f 6e 74 72 6f 6c 28 70 50 OsFileControl(pP
14cd0 61 67 65 72 2d 3e 66 64 2c 20 53 51 4c 49 54 45 ager->fd, SQLITE
14ce0 5f 46 43 4e 54 4c 5f 43 4f 4d 4d 49 54 5f 50 48 _FCNTL_COMMIT_PH
14cf0 41 53 45 54 57 4f 2c 20 30 29 3b 0a 20 20 20 20 ASETWO, 0);.
14d00 69 66 28 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4e if( rc==SQLITE_N
14d10 4f 54 46 4f 55 4e 44 20 29 20 72 63 20 3d 20 53 OTFOUND ) rc = S
14d20 51 4c 49 54 45 5f 4f 4b 3b 0a 20 20 7d 0a 0a 20 QLITE_OK;. }..
14d30 20 69 66 28 20 21 70 50 61 67 65 72 2d 3e 65 78 if( !pPager->ex
14d40 63 6c 75 73 69 76 65 4d 6f 64 65 20 0a 20 20 20 clusiveMode .
14d50 26 26 20 28 21 70 61 67 65 72 55 73 65 57 61 6c && (!pagerUseWal
14d60 28 70 50 61 67 65 72 29 20 7c 7c 20 73 71 6c 69 (pPager) || sqli
14d70 74 65 33 57 61 6c 45 78 63 6c 75 73 69 76 65 4d te3WalExclusiveM
14d80 6f 64 65 28 70 50 61 67 65 72 2d 3e 70 57 61 6c ode(pPager->pWal
14d90 2c 20 30 29 29 0a 20 20 29 7b 0a 20 20 20 20 72 , 0)). ){. r
14da0 63 32 20 3d 20 70 61 67 65 72 55 6e 6c 6f 63 6b c2 = pagerUnlock
14db0 44 62 28 70 50 61 67 65 72 2c 20 53 48 41 52 45 Db(pPager, SHARE
14dc0 44 5f 4c 4f 43 4b 29 3b 0a 20 20 20 20 70 50 61 D_LOCK);. pPa
14dd0 67 65 72 2d 3e 63 68 61 6e 67 65 43 6f 75 6e 74 ger->changeCount
14de0 44 6f 6e 65 20 3d 20 30 3b 0a 20 20 7d 0a 20 20 Done = 0;. }.
14df0 70 50 61 67 65 72 2d 3e 65 53 74 61 74 65 20 3d pPager->eState =
14e00 20 50 41 47 45 52 5f 52 45 41 44 45 52 3b 0a 20 PAGER_READER;.
14e10 20 70 50 61 67 65 72 2d 3e 73 65 74 4d 61 73 74 pPager->setMast
14e20 65 72 20 3d 20 30 3b 0a 0a 20 20 72 65 74 75 72 er = 0;.. retur
14e30 6e 20 28 72 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b n (rc==SQLITE_OK
14e40 3f 72 63 32 3a 72 63 29 3b 0a 7d 0a 0a 2f 2a 0a ?rc2:rc);.}../*.
14e50 2a 2a 20 45 78 65 63 75 74 65 20 61 20 72 6f 6c ** Execute a rol
14e60 6c 62 61 63 6b 20 69 66 20 61 20 74 72 61 6e 73 lback if a trans
14e70 61 63 74 69 6f 6e 20 69 73 20 61 63 74 69 76 65 action is active
14e80 20 61 6e 64 20 75 6e 6c 6f 63 6b 20 74 68 65 20 and unlock the
14e90 0a 2a 2a 20 64 61 74 61 62 61 73 65 20 66 69 6c .** database fil
14ea0 65 2e 20 0a 2a 2a 0a 2a 2a 20 49 66 20 74 68 65 e. .**.** If the
14eb0 20 70 61 67 65 72 20 68 61 73 20 61 6c 72 65 61 pager has alrea
14ec0 64 79 20 65 6e 74 65 72 65 64 20 74 68 65 20 45 dy entered the E
14ed0 52 52 4f 52 20 73 74 61 74 65 2c 20 64 6f 20 6e RROR state, do n
14ee0 6f 74 20 61 74 74 65 6d 70 74 20 0a 2a 2a 20 74 ot attempt .** t
14ef0 68 65 20 72 6f 6c 6c 62 61 63 6b 20 61 74 20 74 he rollback at t
14f00 68 69 73 20 74 69 6d 65 2e 20 49 6e 73 74 65 61 his time. Instea
14f10 64 2c 20 70 61 67 65 72 5f 75 6e 6c 6f 63 6b 28 d, pager_unlock(
14f20 29 20 69 73 20 63 61 6c 6c 65 64 2e 20 54 68 65 ) is called. The
14f30 0a 2a 2a 20 63 61 6c 6c 20 74 6f 20 70 61 67 65 .** call to page
14f40 72 5f 75 6e 6c 6f 63 6b 28 29 20 77 69 6c 6c 20 r_unlock() will
14f50 64 69 73 63 61 72 64 20 61 6c 6c 20 69 6e 2d 6d discard all in-m
14f60 65 6d 6f 72 79 20 70 61 67 65 73 2c 20 75 6e 6c emory pages, unl
14f70 6f 63 6b 0a 2a 2a 20 74 68 65 20 64 61 74 61 62 ock.** the datab
14f80 61 73 65 20 66 69 6c 65 20 61 6e 64 20 6d 6f 76 ase file and mov
14f90 65 20 74 68 65 20 70 61 67 65 72 20 62 61 63 6b e the pager back
14fa0 20 74 6f 20 4f 50 45 4e 20 73 74 61 74 65 2e 20 to OPEN state.
14fb0 49 66 20 74 68 69 73 20 0a 2a 2a 20 6d 65 61 6e If this .** mean
14fc0 73 20 74 68 61 74 20 74 68 65 72 65 20 69 73 20 s that there is
14fd0 61 20 68 6f 74 2d 6a 6f 75 72 6e 61 6c 20 6c 65 a hot-journal le
14fe0 66 74 20 69 6e 20 74 68 65 20 66 69 6c 65 2d 73 ft in the file-s
14ff0 79 73 74 65 6d 2c 20 74 68 65 20 6e 65 78 74 20 ystem, the next
15000 0a 2a 2a 20 63 6f 6e 6e 65 63 74 69 6f 6e 20 74 .** connection t
15010 6f 20 6f 62 74 61 69 6e 20 61 20 73 68 61 72 65 o obtain a share
15020 64 20 6c 6f 63 6b 20 6f 6e 20 74 68 65 20 70 61 d lock on the pa
15030 67 65 72 20 28 77 68 69 63 68 20 6d 61 79 20 62 ger (which may b
15040 65 20 74 68 69 73 20 6f 6e 65 29 20 0a 2a 2a 20 e this one) .**
15050 77 69 6c 6c 20 72 6f 6c 6c 20 69 74 20 62 61 63 will roll it bac
15060 6b 2e 0a 2a 2a 0a 2a 2a 20 49 66 20 74 68 65 20 k..**.** If the
15070 70 61 67 65 72 20 68 61 73 20 6e 6f 74 20 61 6c pager has not al
15080 72 65 61 64 79 20 65 6e 74 65 72 65 64 20 74 68 ready entered th
15090 65 20 45 52 52 4f 52 20 73 74 61 74 65 2c 20 62 e ERROR state, b
150a0 75 74 20 61 6e 20 49 4f 20 6f 72 0a 2a 2a 20 6d ut an IO or.** m
150b0 61 6c 6c 6f 63 20 65 72 72 6f 72 20 6f 63 63 75 alloc error occu
150c0 72 73 20 64 75 72 69 6e 67 20 61 20 72 6f 6c 6c rs during a roll
150d0 62 61 63 6b 2c 20 74 68 65 6e 20 74 68 69 73 20 back, then this
150e0 77 69 6c 6c 20 69 74 73 65 6c 66 20 63 61 75 73 will itself caus
150f0 65 20 0a 2a 2a 20 74 68 65 20 70 61 67 65 72 20 e .** the pager
15100 74 6f 20 65 6e 74 65 72 20 74 68 65 20 45 52 52 to enter the ERR
15110 4f 52 20 73 74 61 74 65 2e 20 57 68 69 63 68 20 OR state. Which
15120 77 69 6c 6c 20 62 65 20 63 6c 65 61 72 65 64 20 will be cleared
15130 62 79 20 74 68 65 0a 2a 2a 20 63 61 6c 6c 20 74 by the.** call t
15140 6f 20 70 61 67 65 72 5f 75 6e 6c 6f 63 6b 28 29 o pager_unlock()
15150 2c 20 61 73 20 64 65 73 63 72 69 62 65 64 20 61 , as described a
15160 62 6f 76 65 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 bove..*/.static
15170 76 6f 69 64 20 70 61 67 65 72 55 6e 6c 6f 63 6b void pagerUnlock
15180 41 6e 64 52 6f 6c 6c 62 61 63 6b 28 50 61 67 65 AndRollback(Page
15190 72 20 2a 70 50 61 67 65 72 29 7b 0a 20 20 69 66 r *pPager){. if
151a0 28 20 70 50 61 67 65 72 2d 3e 65 53 74 61 74 65 ( pPager->eState
151b0 21 3d 50 41 47 45 52 5f 45 52 52 4f 52 20 26 26 !=PAGER_ERROR &&
151c0 20 70 50 61 67 65 72 2d 3e 65 53 74 61 74 65 21 pPager->eState!
151d0 3d 50 41 47 45 52 5f 4f 50 45 4e 20 29 7b 0a 20 =PAGER_OPEN ){.
151e0 20 20 20 61 73 73 65 72 74 28 20 61 73 73 65 72 assert( asser
151f0 74 5f 70 61 67 65 72 5f 73 74 61 74 65 28 70 50 t_pager_state(pP
15200 61 67 65 72 29 20 29 3b 0a 20 20 20 20 69 66 28 ager) );. if(
15210 20 70 50 61 67 65 72 2d 3e 65 53 74 61 74 65 3e pPager->eState>
15220 3d 50 41 47 45 52 5f 57 52 49 54 45 52 5f 4c 4f =PAGER_WRITER_LO
15230 43 4b 45 44 20 29 7b 0a 20 20 20 20 20 20 73 71 CKED ){. sq
15240 6c 69 74 65 33 42 65 67 69 6e 42 65 6e 69 67 6e lite3BeginBenign
15250 4d 61 6c 6c 6f 63 28 29 3b 0a 20 20 20 20 20 20 Malloc();.
15260 73 71 6c 69 74 65 33 50 61 67 65 72 52 6f 6c 6c sqlite3PagerRoll
15270 62 61 63 6b 28 70 50 61 67 65 72 29 3b 0a 20 20 back(pPager);.
15280 20 20 20 20 73 71 6c 69 74 65 33 45 6e 64 42 65 sqlite3EndBe
15290 6e 69 67 6e 4d 61 6c 6c 6f 63 28 29 3b 0a 20 20 nignMalloc();.
152a0 20 20 7d 65 6c 73 65 20 69 66 28 20 21 70 50 61 }else if( !pPa
152b0 67 65 72 2d 3e 65 78 63 6c 75 73 69 76 65 4d 6f ger->exclusiveMo
152c0 64 65 20 29 7b 0a 20 20 20 20 20 20 61 73 73 65 de ){. asse
152d0 72 74 28 20 70 50 61 67 65 72 2d 3e 65 53 74 61 rt( pPager->eSta
152e0 74 65 3d 3d 50 41 47 45 52 5f 52 45 41 44 45 52 te==PAGER_READER
152f0 20 29 3b 0a 20 20 20 20 20 20 70 61 67 65 72 5f );. pager_
15300 65 6e 64 5f 74 72 61 6e 73 61 63 74 69 6f 6e 28 end_transaction(
15310 70 50 61 67 65 72 2c 20 30 2c 20 30 29 3b 0a 20 pPager, 0, 0);.
15320 20 20 20 7d 0a 20 20 7d 0a 20 20 70 61 67 65 72 }. }. pager
15330 5f 75 6e 6c 6f 63 6b 28 70 50 61 67 65 72 29 3b _unlock(pPager);
15340 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 50 61 72 61 6d 65 .}../*.** Parame
15350 74 65 72 20 61 44 61 74 61 20 6d 75 73 74 20 70 ter aData must p
15360 6f 69 6e 74 20 74 6f 20 61 20 62 75 66 66 65 72 oint to a buffer
15370 20 6f 66 20 70 50 61 67 65 72 2d 3e 70 61 67 65 of pPager->page
15380 53 69 7a 65 20 62 79 74 65 73 0a 2a 2a 20 6f 66 Size bytes.** of
15390 20 64 61 74 61 2e 20 43 6f 6d 70 75 74 65 20 61 data. Compute a
153a0 6e 64 20 72 65 74 75 72 6e 20 61 20 63 68 65 63 nd return a chec
153b0 6b 73 75 6d 20 62 61 73 65 64 20 6f 6e 74 20 74 ksum based ont t
153c0 68 65 20 63 6f 6e 74 65 6e 74 73 20 6f 66 20 74 he contents of t
153d0 68 65 20 0a 2a 2a 20 70 61 67 65 20 6f 66 20 64 he .** page of d
153e0 61 74 61 20 61 6e 64 20 74 68 65 20 63 75 72 72 ata and the curr
153f0 65 6e 74 20 76 61 6c 75 65 20 6f 66 20 70 50 61 ent value of pPa
15400 67 65 72 2d 3e 63 6b 73 75 6d 49 6e 69 74 2e 0a ger->cksumInit..
15410 2a 2a 0a 2a 2a 20 54 68 69 73 20 69 73 20 6e 6f **.** This is no
15420 74 20 61 20 72 65 61 6c 20 63 68 65 63 6b 73 75 t a real checksu
15430 6d 2e 20 49 74 20 69 73 20 72 65 61 6c 6c 79 20 m. It is really
15440 6a 75 73 74 20 74 68 65 20 73 75 6d 20 6f 66 20 just the sum of
15450 74 68 65 20 0a 2a 2a 20 72 61 6e 64 6f 6d 20 69 the .** random i
15460 6e 69 74 69 61 6c 20 76 61 6c 75 65 20 28 70 50 nitial value (pP
15470 61 67 65 72 2d 3e 63 6b 73 75 6d 49 6e 69 74 29 ager->cksumInit)
15480 20 61 6e 64 20 65 76 65 72 79 20 32 30 30 74 68 and every 200th
15490 20 62 79 74 65 0a 2a 2a 20 6f 66 20 74 68 65 20 byte.** of the
154a0 70 61 67 65 20 64 61 74 61 2c 20 73 74 61 72 74 page data, start
154b0 69 6e 67 20 77 69 74 68 20 62 79 74 65 20 6f 66 ing with byte of
154c0 66 73 65 74 20 28 70 50 61 67 65 72 2d 3e 70 61 fset (pPager->pa
154d0 67 65 53 69 7a 65 25 32 30 30 29 2e 0a 2a 2a 20 geSize%200)..**
154e0 45 61 63 68 20 62 79 74 65 20 69 73 20 69 6e 74 Each byte is int
154f0 65 72 70 72 65 74 65 64 20 61 73 20 61 6e 20 38 erpreted as an 8
15500 2d 62 69 74 20 75 6e 73 69 67 6e 65 64 20 69 6e -bit unsigned in
15510 74 65 67 65 72 2e 0a 2a 2a 0a 2a 2a 20 43 68 61 teger..**.** Cha
15520 6e 67 69 6e 67 20 74 68 65 20 66 6f 72 6d 75 6c nging the formul
15530 61 20 75 73 65 64 20 74 6f 20 63 6f 6d 70 75 74 a used to comput
15540 65 20 74 68 69 73 20 63 68 65 63 6b 73 75 6d 20 e this checksum
15550 72 65 73 75 6c 74 73 20 69 6e 20 61 6e 0a 2a 2a results in an.**
15560 20 69 6e 63 6f 6d 70 61 74 69 62 6c 65 20 6a 6f incompatible jo
15570 75 72 6e 61 6c 20 66 69 6c 65 20 66 6f 72 6d 61 urnal file forma
15580 74 2e 0a 2a 2a 0a 2a 2a 20 49 66 20 6a 6f 75 72 t..**.** If jour
15590 6e 61 6c 20 63 6f 72 72 75 70 74 69 6f 6e 20 6f nal corruption o
155a0 63 63 75 72 73 20 64 75 65 20 74 6f 20 61 20 70 ccurs due to a p
155b0 6f 77 65 72 20 66 61 69 6c 75 72 65 2c 20 74 68 ower failure, th
155c0 65 20 6d 6f 73 74 20 6c 69 6b 65 6c 79 20 0a 2a e most likely .*
155d0 2a 20 73 63 65 6e 61 72 69 6f 20 69 73 20 74 68 * scenario is th
155e0 61 74 20 6f 6e 65 20 65 6e 64 20 6f 72 20 74 68 at one end or th
155f0 65 20 6f 74 68 65 72 20 6f 66 20 74 68 65 20 72 e other of the r
15600 65 63 6f 72 64 20 77 69 6c 6c 20 62 65 20 63 68 ecord will be ch
15610 61 6e 67 65 64 2e 20 0a 2a 2a 20 49 74 20 69 73 anged. .** It is
15620 20 6d 75 63 68 20 6c 65 73 73 20 6c 69 6b 65 6c much less likel
15630 79 20 74 68 61 74 20 74 68 65 20 74 77 6f 20 65 y that the two e
15640 6e 64 73 20 6f 66 20 74 68 65 20 6a 6f 75 72 6e nds of the journ
15650 61 6c 20 72 65 63 6f 72 64 20 77 69 6c 6c 20 62 al record will b
15660 65 0a 2a 2a 20 63 6f 72 72 65 63 74 20 61 6e 64 e.** correct and
15670 20 74 68 65 20 6d 69 64 64 6c 65 20 62 65 20 63 the middle be c
15680 6f 72 72 75 70 74 2e 20 20 54 68 75 73 2c 20 74 orrupt. Thus, t
15690 68 69 73 20 22 63 68 65 63 6b 73 75 6d 22 20 73 his "checksum" s
156a0 63 68 65 6d 65 2c 0a 2a 2a 20 74 68 6f 75 67 68 cheme,.** though
156b0 20 66 61 73 74 20 61 6e 64 20 73 69 6d 70 6c 65 fast and simple
156c0 2c 20 63 61 74 63 68 65 73 20 74 68 65 20 6d 6f , catches the mo
156d0 73 74 6c 79 20 6c 69 6b 65 6c 79 20 6b 69 6e 64 stly likely kind
156e0 20 6f 66 20 63 6f 72 72 75 70 74 69 6f 6e 2e 0a of corruption..
156f0 2a 2f 0a 73 74 61 74 69 63 20 75 33 32 20 70 61 */.static u32 pa
15700 67 65 72 5f 63 6b 73 75 6d 28 50 61 67 65 72 20 ger_cksum(Pager
15710 2a 70 50 61 67 65 72 2c 20 63 6f 6e 73 74 20 75 *pPager, const u
15720 38 20 2a 61 44 61 74 61 29 7b 0a 20 20 75 33 32 8 *aData){. u32
15730 20 63 6b 73 75 6d 20 3d 20 70 50 61 67 65 72 2d cksum = pPager-
15740 3e 63 6b 73 75 6d 49 6e 69 74 3b 20 20 20 20 20 >cksumInit;
15750 20 20 20 20 2f 2a 20 43 68 65 63 6b 73 75 6d 20 /* Checksum
15760 76 61 6c 75 65 20 74 6f 20 72 65 74 75 72 6e 20 value to return
15770 2a 2f 0a 20 20 69 6e 74 20 69 20 3d 20 70 50 61 */. int i = pPa
15780 67 65 72 2d 3e 70 61 67 65 53 69 7a 65 2d 32 30 ger->pageSize-20
15790 30 3b 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4c 0; /* L
157a0 6f 6f 70 20 63 6f 75 6e 74 65 72 20 2a 2f 0a 20 oop counter */.
157b0 20 77 68 69 6c 65 28 20 69 3e 30 20 29 7b 0a 20 while( i>0 ){.
157c0 20 20 20 63 6b 73 75 6d 20 2b 3d 20 61 44 61 74 cksum += aDat
157d0 61 5b 69 5d 3b 0a 20 20 20 20 69 20 2d 3d 20 32 a[i];. i -= 2
157e0 30 30 3b 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e 00;. }. return
157f0 20 63 6b 73 75 6d 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a cksum;.}../*.**
15800 20 52 65 70 6f 72 74 20 74 68 65 20 63 75 72 72 Report the curr
15810 65 6e 74 20 70 61 67 65 20 73 69 7a 65 20 61 6e ent page size an
15820 64 20 6e 75 6d 62 65 72 20 6f 66 20 72 65 73 65 d number of rese
15830 72 76 65 64 20 62 79 74 65 73 20 62 61 63 6b 0a rved bytes back.
15840 2a 2a 20 74 6f 20 74 68 65 20 63 6f 64 65 63 2e ** to the codec.
15850 0a 2a 2f 0a 23 69 66 64 65 66 20 53 51 4c 49 54 .*/.#ifdef SQLIT
15860 45 5f 48 41 53 5f 43 4f 44 45 43 0a 73 74 61 74 E_HAS_CODEC.stat
15870 69 63 20 76 6f 69 64 20 70 61 67 65 72 52 65 70 ic void pagerRep
15880 6f 72 74 53 69 7a 65 28 50 61 67 65 72 20 2a 70 ortSize(Pager *p
15890 50 61 67 65 72 29 7b 0a 20 20 69 66 28 20 70 50 Pager){. if( pP
158a0 61 67 65 72 2d 3e 78 43 6f 64 65 63 53 69 7a 65 ager->xCodecSize
158b0 43 68 6e 67 20 29 7b 0a 20 20 20 20 70 50 61 67 Chng ){. pPag
158c0 65 72 2d 3e 78 43 6f 64 65 63 53 69 7a 65 43 68 er->xCodecSizeCh
158d0 6e 67 28 70 50 61 67 65 72 2d 3e 70 43 6f 64 65 ng(pPager->pCode
158e0 63 2c 20 70 50 61 67 65 72 2d 3e 70 61 67 65 53 c, pPager->pageS
158f0 69 7a 65 2c 0a 20 20 20 20 20 20 20 20 20 20 20 ize,.
15900 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
15910 28 69 6e 74 29 70 50 61 67 65 72 2d 3e 6e 52 65 (int)pPager->nRe
15920 73 65 72 76 65 29 3b 0a 20 20 7d 0a 7d 0a 23 65 serve);. }.}.#e
15930 6c 73 65 0a 23 20 64 65 66 69 6e 65 20 70 61 67 lse.# define pag
15940 65 72 52 65 70 6f 72 74 53 69 7a 65 28 58 29 20 erReportSize(X)
15950 20 20 20 20 2f 2a 20 4e 6f 2d 6f 70 20 69 66 20 /* No-op if
15960 77 65 20 64 6f 20 6e 6f 74 20 73 75 70 70 6f 72 we do not suppor
15970 74 20 61 20 63 6f 64 65 63 20 2a 2f 0a 23 65 6e t a codec */.#en
15980 64 69 66 0a 0a 23 69 66 64 65 66 20 53 51 4c 49 dif..#ifdef SQLI
15990 54 45 5f 48 41 53 5f 43 4f 44 45 43 0a 2f 2a 0a TE_HAS_CODEC./*.
159a0 2a 2a 20 4d 61 6b 65 20 73 75 72 65 20 74 68 65 ** Make sure the
159b0 20 6e 75 6d 62 65 72 20 6f 66 20 72 65 73 65 72 number of reser
159c0 76 65 64 20 62 69 74 73 20 69 73 20 74 68 65 20 ved bits is the
159d0 73 61 6d 65 20 69 6e 20 74 68 65 20 64 65 73 74 same in the dest
159e0 69 6e 61 74 69 6f 6e 0a 2a 2a 20 70 61 67 65 72 ination.** pager
159f0 20 61 73 20 69 74 20 69 73 20 69 6e 20 74 68 65 as it is in the
15a00 20 73 6f 75 72 63 65 2e 20 20 54 68 69 73 20 63 source. This c
15a10 6f 6d 65 73 20 75 70 20 77 68 65 6e 20 61 20 56 omes up when a V
15a20 41 43 55 55 4d 20 63 68 61 6e 67 65 73 20 74 68 ACUUM changes th
15a30 65 0a 2a 2a 20 6e 75 6d 62 65 72 20 6f 66 20 72 e.** number of r
15a40 65 73 65 72 76 65 64 20 62 69 74 73 20 74 6f 20 eserved bits to
15a50 74 68 65 20 22 6f 70 74 69 6d 61 6c 22 20 61 6d the "optimal" am
15a60 6f 75 6e 74 2e 0a 2a 2f 0a 76 6f 69 64 20 73 71 ount..*/.void sq
15a70 6c 69 74 65 33 50 61 67 65 72 41 6c 69 67 6e 52 lite3PagerAlignR
15a80 65 73 65 72 76 65 28 50 61 67 65 72 20 2a 70 44 eserve(Pager *pD
15a90 65 73 74 2c 20 50 61 67 65 72 20 2a 70 53 72 63 est, Pager *pSrc
15aa0 29 7b 0a 20 20 69 66 28 20 70 44 65 73 74 2d 3e ){. if( pDest->
15ab0 6e 52 65 73 65 72 76 65 21 3d 70 53 72 63 2d 3e nReserve!=pSrc->
15ac0 6e 52 65 73 65 72 76 65 20 29 7b 0a 20 20 20 20 nReserve ){.
15ad0 70 44 65 73 74 2d 3e 6e 52 65 73 65 72 76 65 20 pDest->nReserve
15ae0 3d 20 70 53 72 63 2d 3e 6e 52 65 73 65 72 76 65 = pSrc->nReserve
15af0 3b 0a 20 20 20 20 70 61 67 65 72 52 65 70 6f 72 ;. pagerRepor
15b00 74 53 69 7a 65 28 70 44 65 73 74 29 3b 0a 20 20 tSize(pDest);.
15b10 7d 0a 7d 0a 23 65 6e 64 69 66 0a 0a 2f 2a 0a 2a }.}.#endif../*.*
15b20 2a 20 52 65 61 64 20 61 20 73 69 6e 67 6c 65 20 * Read a single
15b30 70 61 67 65 20 66 72 6f 6d 20 65 69 74 68 65 72 page from either
15b40 20 74 68 65 20 6a 6f 75 72 6e 61 6c 20 66 69 6c the journal fil
15b50 65 20 28 69 66 20 69 73 4d 61 69 6e 4a 72 6e 6c e (if isMainJrnl
15b60 3d 3d 31 29 20 6f 72 0a 2a 2a 20 66 72 6f 6d 20 ==1) or.** from
15b70 74 68 65 20 73 75 62 2d 6a 6f 75 72 6e 61 6c 20 the sub-journal
15b80 28 69 66 20 69 73 4d 61 69 6e 4a 72 6e 6c 3d 3d (if isMainJrnl==
15b90 30 29 20 61 6e 64 20 70 6c 61 79 62 61 63 6b 20 0) and playback
15ba0 74 68 61 74 20 70 61 67 65 2e 0a 2a 2a 20 54 68 that page..** Th
15bb0 65 20 70 61 67 65 20 62 65 67 69 6e 73 20 61 74 e page begins at
15bc0 20 6f 66 66 73 65 74 20 2a 70 4f 66 66 73 65 74 offset *pOffset
15bd0 20 69 6e 74 6f 20 74 68 65 20 66 69 6c 65 2e 20 into the file.
15be0 54 68 65 20 2a 70 4f 66 66 73 65 74 0a 2a 2a 20 The *pOffset.**
15bf0 76 61 6c 75 65 20 69 73 20 69 6e 63 72 65 61 73 value is increas
15c00 65 64 20 74 6f 20 74 68 65 20 73 74 61 72 74 20 ed to the start
15c10 6f 66 20 74 68 65 20 6e 65 78 74 20 70 61 67 65 of the next page
15c20 20 69 6e 20 74 68 65 20 6a 6f 75 72 6e 61 6c 2e in the journal.
15c30 0a 2a 2a 0a 2a 2a 20 54 68 65 20 6d 61 69 6e 20 .**.** The main
15c40 72 6f 6c 6c 62 61 63 6b 20 6a 6f 75 72 6e 61 6c rollback journal
15c50 20 75 73 65 73 20 63 68 65 63 6b 73 75 6d 73 20 uses checksums
15c60 2d 20 74 68 65 20 73 74 61 74 65 6d 65 6e 74 20 - the statement
15c70 6a 6f 75 72 6e 61 6c 20 64 6f 65 73 20 0a 2a 2a journal does .**
15c80 20 6e 6f 74 2e 0a 2a 2a 0a 2a 2a 20 49 66 20 74 not..**.** If t
15c90 68 65 20 70 61 67 65 20 6e 75 6d 62 65 72 20 6f he page number o
15ca0 66 20 74 68 65 20 70 61 67 65 20 72 65 63 6f 72 f the page recor
15cb0 64 20 72 65 61 64 20 66 72 6f 6d 20 74 68 65 20 d read from the
15cc0 28 73 75 62 2d 29 6a 6f 75 72 6e 61 6c 20 66 69 (sub-)journal fi
15cd0 6c 65 0a 2a 2a 20 69 73 20 67 72 65 61 74 65 72 le.** is greater
15ce0 20 74 68 61 6e 20 74 68 65 20 63 75 72 72 65 6e than the curren
15cf0 74 20 76 61 6c 75 65 20 6f 66 20 50 61 67 65 72 t value of Pager
15d00 2e 64 62 53 69 7a 65 2c 20 74 68 65 6e 20 70 6c .dbSize, then pl
15d10 61 79 62 61 63 6b 20 69 73 0a 2a 2a 20 73 6b 69 ayback is.** ski
15d20 70 70 65 64 20 61 6e 64 20 53 51 4c 49 54 45 5f pped and SQLITE_
15d30 4f 4b 20 69 73 20 72 65 74 75 72 6e 65 64 2e 0a OK is returned..
15d40 2a 2a 0a 2a 2a 20 49 66 20 70 44 6f 6e 65 20 69 **.** If pDone i
15d50 73 20 6e 6f 74 20 4e 55 4c 4c 2c 20 74 68 65 6e s not NULL, then
15d60 20 69 74 20 69 73 20 61 20 72 65 63 6f 72 64 20 it is a record
15d70 6f 66 20 70 61 67 65 73 20 74 68 61 74 20 68 61 of pages that ha
15d80 76 65 20 61 6c 72 65 61 64 79 0a 2a 2a 20 62 65 ve already.** be
15d90 65 6e 20 70 6c 61 79 65 64 20 62 61 63 6b 2e 20 en played back.
15da0 20 49 66 20 74 68 65 20 70 61 67 65 20 61 74 20 If the page at
15db0 2a 70 4f 66 66 73 65 74 20 68 61 73 20 61 6c 72 *pOffset has alr
15dc0 65 61 64 79 20 62 65 65 6e 20 70 6c 61 79 65 64 eady been played
15dd0 20 62 61 63 6b 0a 2a 2a 20 28 69 66 20 74 68 65 back.** (if the
15de0 20 63 6f 72 72 65 73 70 6f 6e 64 69 6e 67 20 70 corresponding p
15df0 44 6f 6e 65 20 62 69 74 20 69 73 20 73 65 74 29 Done bit is set)
15e00 20 74 68 65 6e 20 73 6b 69 70 20 74 68 65 20 70 then skip the p
15e10 6c 61 79 62 61 63 6b 2e 0a 2a 2a 20 4d 61 6b 65 layback..** Make
15e20 20 73 75 72 65 20 74 68 65 20 70 44 6f 6e 65 20 sure the pDone
15e30 62 69 74 20 63 6f 72 72 65 73 70 6f 6e 64 69 6e bit correspondin
15e40 67 20 74 6f 20 74 68 65 20 2a 70 4f 66 66 73 65 g to the *pOffse
15e50 74 20 70 61 67 65 20 69 73 20 73 65 74 0a 2a 2a t page is set.**
15e60 20 70 72 69 6f 72 20 74 6f 20 72 65 74 75 72 6e prior to return
15e70 69 6e 67 2e 0a 2a 2a 0a 2a 2a 20 49 66 20 74 68 ing..**.** If th
15e80 65 20 70 61 67 65 20 72 65 63 6f 72 64 20 69 73 e page record is
15e90 20 73 75 63 63 65 73 73 66 75 6c 6c 79 20 72 65 successfully re
15ea0 61 64 20 66 72 6f 6d 20 74 68 65 20 28 73 75 62 ad from the (sub
15eb0 2d 29 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 0a 2a -)journal file.*
15ec0 2a 20 61 6e 64 20 70 6c 61 79 65 64 20 62 61 63 * and played bac
15ed0 6b 2c 20 74 68 65 6e 20 53 51 4c 49 54 45 5f 4f k, then SQLITE_O
15ee0 4b 20 69 73 20 72 65 74 75 72 6e 65 64 2e 20 49 K is returned. I
15ef0 66 20 61 6e 20 49 4f 20 65 72 72 6f 72 20 6f 63 f an IO error oc
15f00 63 75 72 73 0a 2a 2a 20 77 68 69 6c 65 20 72 65 curs.** while re
15f10 61 64 69 6e 67 20 74 68 65 20 72 65 63 6f 72 64 ading the record
15f20 20 66 72 6f 6d 20 74 68 65 20 28 73 75 62 2d 29 from the (sub-)
15f30 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 20 6f 72 20 journal file or
15f40 77 68 69 6c 65 20 77 72 69 74 69 6e 67 0a 2a 2a while writing.**
15f50 20 74 6f 20 74 68 65 20 64 61 74 61 62 61 73 65 to the database
15f60 20 66 69 6c 65 2c 20 74 68 65 6e 20 74 68 65 20 file, then the
15f70 49 4f 20 65 72 72 6f 72 20 63 6f 64 65 20 69 73 IO error code is
15f80 20 72 65 74 75 72 6e 65 64 2e 20 49 66 20 64 61 returned. If da
15f90 74 61 0a 2a 2a 20 69 73 20 73 75 63 63 65 73 73 ta.** is success
15fa0 66 75 6c 6c 79 20 72 65 61 64 20 66 72 6f 6d 20 fully read from
15fb0 74 68 65 20 28 73 75 62 2d 29 6a 6f 75 72 6e 61 the (sub-)journa
15fc0 6c 20 66 69 6c 65 20 62 75 74 20 61 70 70 65 61 l file but appea
15fd0 72 73 20 74 6f 20 62 65 0a 2a 2a 20 63 6f 72 72 rs to be.** corr
15fe0 75 70 74 65 64 2c 20 53 51 4c 49 54 45 5f 44 4f upted, SQLITE_DO
15ff0 4e 45 20 69 73 20 72 65 74 75 72 6e 65 64 2e 20 NE is returned.
16000 44 61 74 61 20 69 73 20 63 6f 6e 73 69 64 65 72 Data is consider
16010 65 64 20 63 6f 72 72 75 70 74 65 64 20 69 6e 0a ed corrupted in.
16020 2a 2a 20 74 77 6f 20 63 69 72 63 75 6d 73 74 61 ** two circumsta
16030 6e 63 65 73 3a 0a 2a 2a 20 0a 2a 2a 20 20 20 2a nces:.** .** *
16040 20 49 66 20 74 68 65 20 72 65 63 6f 72 64 20 70 If the record p
16050 61 67 65 2d 6e 75 6d 62 65 72 20 69 73 20 69 6c age-number is il
16060 6c 65 67 61 6c 20 28 30 20 6f 72 20 50 41 47 45 legal (0 or PAGE
16070 52 5f 4d 4a 5f 50 47 4e 4f 29 2c 20 6f 72 0a 2a R_MJ_PGNO), or.*
16080 2a 20 20 20 2a 20 49 66 20 74 68 65 20 72 65 63 * * If the rec
16090 6f 72 64 20 69 73 20 62 65 69 6e 67 20 72 6f 6c ord is being rol
160a0 6c 65 64 20 62 61 63 6b 20 66 72 6f 6d 20 74 68 led back from th
160b0 65 20 6d 61 69 6e 20 6a 6f 75 72 6e 61 6c 20 66 e main journal f
160c0 69 6c 65 0a 2a 2a 20 20 20 20 20 61 6e 64 20 74 ile.** and t
160d0 68 65 20 63 68 65 63 6b 73 75 6d 20 66 69 65 6c he checksum fiel
160e0 64 20 64 6f 65 73 20 6e 6f 74 20 6d 61 74 63 68 d does not match
160f0 20 74 68 65 20 72 65 63 6f 72 64 20 63 6f 6e 74 the record cont
16100 65 6e 74 2e 0a 2a 2a 0a 2a 2a 20 4e 65 69 74 68 ent..**.** Neith
16110 65 72 20 6f 66 20 74 68 65 73 65 20 74 77 6f 20 er of these two
16120 73 63 65 6e 61 72 69 6f 73 20 61 72 65 20 70 6f scenarios are po
16130 73 73 69 62 6c 65 20 64 75 72 69 6e 67 20 61 20 ssible during a
16140 73 61 76 65 70 6f 69 6e 74 20 72 6f 6c 6c 62 61 savepoint rollba
16150 63 6b 2e 0a 2a 2a 0a 2a 2a 20 49 66 20 74 68 69 ck..**.** If thi
16160 73 20 69 73 20 61 20 73 61 76 65 70 6f 69 6e 74 s is a savepoint
16170 20 72 6f 6c 6c 62 61 63 6b 2c 20 74 68 65 6e 20 rollback, then
16180 6d 65 6d 6f 72 79 20 6d 61 79 20 68 61 76 65 20 memory may have
16190 74 6f 20 62 65 20 64 79 6e 61 6d 69 63 61 6c 6c to be dynamicall
161a0 79 0a 2a 2a 20 61 6c 6c 6f 63 61 74 65 64 20 62 y.** allocated b
161b0 79 20 74 68 69 73 20 66 75 6e 63 74 69 6f 6e 2e y this function.
161c0 20 49 66 20 74 68 69 73 20 69 73 20 74 68 65 20 If this is the
161d0 63 61 73 65 20 61 6e 64 20 61 6e 20 61 6c 6c 6f case and an allo
161e0 63 61 74 69 6f 6e 20 66 61 69 6c 73 2c 0a 2a 2a cation fails,.**
161f0 20 53 51 4c 49 54 45 5f 4e 4f 4d 45 4d 20 69 73 SQLITE_NOMEM is
16200 20 72 65 74 75 72 6e 65 64 2e 0a 2a 2f 0a 73 74 returned..*/.st
16210 61 74 69 63 20 69 6e 74 20 70 61 67 65 72 5f 70 atic int pager_p
16220 6c 61 79 62 61 63 6b 5f 6f 6e 65 5f 70 61 67 65 layback_one_page
16230 28 0a 20 20 50 61 67 65 72 20 2a 70 50 61 67 65 (. Pager *pPage
16240 72 2c 20 20 20 20 20 20 20 20 20 20 20 20 20 20 r,
16250 20 20 2f 2a 20 54 68 65 20 70 61 67 65 72 20 62 /* The pager b
16260 65 69 6e 67 20 70 6c 61 79 65 64 20 62 61 63 6b eing played back
16270 20 2a 2f 0a 20 20 69 36 34 20 2a 70 4f 66 66 73 */. i64 *pOffs
16280 65 74 2c 20 20 20 20 20 20 20 20 20 20 20 20 20 et,
16290 20 20 20 20 2f 2a 20 4f 66 66 73 65 74 20 6f 66 /* Offset of
162a0 20 72 65 63 6f 72 64 20 74 6f 20 70 6c 61 79 62 record to playb
162b0 61 63 6b 20 2a 2f 0a 20 20 42 69 74 76 65 63 20 ack */. Bitvec
162c0 2a 70 44 6f 6e 65 2c 20 20 20 20 20 20 20 20 20 *pDone,
162d0 20 20 20 20 20 20 20 2f 2a 20 42 69 74 76 65 63 /* Bitvec
162e0 20 6f 66 20 70 61 67 65 73 20 61 6c 72 65 61 64 of pages alread
162f0 79 20 70 6c 61 79 65 64 20 62 61 63 6b 20 2a 2f y played back */
16300 0a 20 20 69 6e 74 20 69 73 4d 61 69 6e 4a 72 6e . int isMainJrn
16310 6c 2c 20 20 20 20 20 20 20 20 20 20 20 20 20 20 l,
16320 20 2f 2a 20 31 20 2d 3e 20 6d 61 69 6e 20 6a 6f /* 1 -> main jo
16330 75 72 6e 61 6c 2e 20 30 20 2d 3e 20 73 75 62 2d urnal. 0 -> sub-
16340 6a 6f 75 72 6e 61 6c 2e 20 2a 2f 0a 20 20 69 6e journal. */. in
16350 74 20 69 73 53 61 76 65 70 6e 74 20 20 20 20 20 t isSavepnt
16360 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 54 /* T
16370 72 75 65 20 66 6f 72 20 61 20 73 61 76 65 70 6f rue for a savepo
16380 69 6e 74 20 72 6f 6c 6c 62 61 63 6b 20 2a 2f 0a int rollback */.
16390 29 7b 0a 20 20 69 6e 74 20 72 63 3b 0a 20 20 50 ){. int rc;. P
163a0 67 48 64 72 20 2a 70 50 67 3b 20 20 20 20 20 20 gHdr *pPg;
163b0 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 /*
163c0 41 6e 20 65 78 69 73 74 69 6e 67 20 70 61 67 65 An existing page
163d0 20 69 6e 20 74 68 65 20 63 61 63 68 65 20 2a 2f in the cache */
163e0 0a 20 20 50 67 6e 6f 20 70 67 6e 6f 3b 20 20 20 . Pgno pgno;
163f0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
16400 20 2f 2a 20 54 68 65 20 70 61 67 65 20 6e 75 6d /* The page num
16410 62 65 72 20 6f 66 20 61 20 70 61 67 65 20 69 6e ber of a page in
16420 20 6a 6f 75 72 6e 61 6c 20 2a 2f 0a 20 20 75 33 journal */. u3
16430 32 20 63 6b 73 75 6d 3b 20 20 20 20 20 20 20 20 2 cksum;
16440 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 43 /* C
16450 68 65 63 6b 73 75 6d 20 75 73 65 64 20 66 6f 72 hecksum used for
16460 20 73 61 6e 69 74 79 20 63 68 65 63 6b 69 6e 67 sanity checking
16470 20 2a 2f 0a 20 20 63 68 61 72 20 2a 61 44 61 74 */. char *aDat
16480 61 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 a;
16490 20 20 20 20 2f 2a 20 54 65 6d 70 6f 72 61 72 79 /* Temporary
164a0 20 73 74 6f 72 61 67 65 20 66 6f 72 20 74 68 65 storage for the
164b0 20 70 61 67 65 20 2a 2f 0a 20 20 73 71 6c 69 74 page */. sqlit
164c0 65 33 5f 66 69 6c 65 20 2a 6a 66 64 3b 20 20 20 e3_file *jfd;
164d0 20 20 20 20 20 20 20 20 20 2f 2a 20 54 68 65 20 /* The
164e0 66 69 6c 65 20 64 65 73 63 72 69 70 74 6f 72 20 file descriptor
164f0 66 6f 72 20 74 68 65 20 6a 6f 75 72 6e 61 6c 20 for the journal
16500 66 69 6c 65 20 2a 2f 0a 20 20 69 6e 74 20 69 73 file */. int is
16510 53 79 6e 63 65 64 3b 20 20 20 20 20 20 20 20 20 Synced;
16520 20 20 20 20 20 20 20 20 2f 2a 20 54 72 75 65 20 /* True
16530 69 66 20 6a 6f 75 72 6e 61 6c 20 70 61 67 65 20 if journal page
16540 69 73 20 73 79 6e 63 65 64 20 2a 2f 0a 0a 20 20 is synced */..
16550 61 73 73 65 72 74 28 20 28 69 73 4d 61 69 6e 4a assert( (isMainJ
16560 72 6e 6c 26 7e 31 29 3d 3d 30 20 29 3b 20 20 20 rnl&~1)==0 );
16570 20 20 20 2f 2a 20 69 73 4d 61 69 6e 4a 72 6e 6c /* isMainJrnl
16580 20 69 73 20 30 20 6f 72 20 31 20 2a 2f 0a 20 20 is 0 or 1 */.
16590 61 73 73 65 72 74 28 20 28 69 73 53 61 76 65 70 assert( (isSavep
165a0 6e 74 26 7e 31 29 3d 3d 30 20 29 3b 20 20 20 20 nt&~1)==0 );
165b0 20 20 20 2f 2a 20 69 73 53 61 76 65 70 6e 74 20 /* isSavepnt
165c0 69 73 20 30 20 6f 72 20 31 20 2a 2f 0a 20 20 61 is 0 or 1 */. a
165d0 73 73 65 72 74 28 20 69 73 4d 61 69 6e 4a 72 6e ssert( isMainJrn
165e0 6c 20 7c 7c 20 70 44 6f 6e 65 20 29 3b 20 20 20 l || pDone );
165f0 20 20 2f 2a 20 70 44 6f 6e 65 20 61 6c 77 61 79 /* pDone alway
16600 73 20 75 73 65 64 20 6f 6e 20 73 75 62 2d 6a 6f s used on sub-jo
16610 75 72 6e 61 6c 73 20 2a 2f 0a 20 20 61 73 73 65 urnals */. asse
16620 72 74 28 20 69 73 53 61 76 65 70 6e 74 20 7c 7c rt( isSavepnt ||
16630 20 70 44 6f 6e 65 3d 3d 30 20 29 3b 20 20 20 2f pDone==0 ); /
16640 2a 20 70 44 6f 6e 65 20 6e 65 76 65 72 20 75 73 * pDone never us
16650 65 64 20 6f 6e 20 6e 6f 6e 2d 73 61 76 65 70 6f ed on non-savepo
16660 69 6e 74 20 2a 2f 0a 0a 20 20 61 44 61 74 61 20 int */.. aData
16670 3d 20 70 50 61 67 65 72 2d 3e 70 54 6d 70 53 70 = pPager->pTmpSp
16680 61 63 65 3b 0a 20 20 61 73 73 65 72 74 28 20 61 ace;. assert( a
16690 44 61 74 61 20 29 3b 20 20 20 20 20 20 20 20 20 Data );
166a0 2f 2a 20 54 65 6d 70 20 73 74 6f 72 61 67 65 20 /* Temp storage
166b0 6d 75 73 74 20 68 61 76 65 20 61 6c 72 65 61 64 must have alread
166c0 79 20 62 65 65 6e 20 61 6c 6c 6f 63 61 74 65 64 y been allocated
166d0 20 2a 2f 0a 20 20 61 73 73 65 72 74 28 20 70 61 */. assert( pa
166e0 67 65 72 55 73 65 57 61 6c 28 70 50 61 67 65 72 gerUseWal(pPager
166f0 29 3d 3d 30 20 7c 7c 20 28 21 69 73 4d 61 69 6e )==0 || (!isMain
16700 4a 72 6e 6c 20 26 26 20 69 73 53 61 76 65 70 6e Jrnl && isSavepn
16710 74 29 20 29 3b 0a 0a 20 20 2f 2a 20 45 69 74 68 t) );.. /* Eith
16720 65 72 20 74 68 65 20 73 74 61 74 65 20 69 73 20 er the state is
16730 67 72 65 61 74 65 72 20 74 68 61 6e 20 50 41 47 greater than PAG
16740 45 52 5f 57 52 49 54 45 52 5f 43 41 43 48 45 4d ER_WRITER_CACHEM
16750 4f 44 20 28 61 20 74 72 61 6e 73 61 63 74 69 6f OD (a transactio
16760 6e 20 0a 20 20 2a 2a 20 6f 72 20 73 61 76 65 70 n . ** or savep
16770 6f 69 6e 74 20 72 6f 6c 6c 62 61 63 6b 20 64 6f oint rollback do
16780 6e 65 20 61 74 20 74 68 65 20 72 65 71 75 65 73 ne at the reques
16790 74 20 6f 66 20 74 68 65 20 63 61 6c 6c 65 72 29 t of the caller)
167a0 20 6f 72 20 74 68 69 73 20 69 73 0a 20 20 2a 2a or this is. **
167b0 20 61 20 68 6f 74 2d 6a 6f 75 72 6e 61 6c 20 72 a hot-journal r
167c0 6f 6c 6c 62 61 63 6b 2e 20 49 66 20 69 74 20 69 ollback. If it i
167d0 73 20 61 20 68 6f 74 2d 6a 6f 75 72 6e 61 6c 20 s a hot-journal
167e0 72 6f 6c 6c 62 61 63 6b 2c 20 74 68 65 20 70 61 rollback, the pa
167f0 67 65 72 0a 20 20 2a 2a 20 69 73 20 69 6e 20 73 ger. ** is in s
16800 74 61 74 65 20 4f 50 45 4e 20 61 6e 64 20 68 6f tate OPEN and ho
16810 6c 64 73 20 61 6e 20 45 58 43 4c 55 53 49 56 45 lds an EXCLUSIVE
16820 20 6c 6f 63 6b 2e 20 48 6f 74 2d 6a 6f 75 72 6e lock. Hot-journ
16830 61 6c 20 72 6f 6c 6c 62 61 63 6b 0a 20 20 2a 2a al rollback. **
16840 20 6f 6e 6c 79 20 72 65 61 64 73 20 66 72 6f 6d only reads from
16850 20 74 68 65 20 6d 61 69 6e 20 6a 6f 75 72 6e 61 the main journa
16860 6c 2c 20 6e 6f 74 20 74 68 65 20 73 75 62 2d 6a l, not the sub-j
16870 6f 75 72 6e 61 6c 2e 0a 20 20 2a 2f 0a 20 20 61 ournal.. */. a
16880 73 73 65 72 74 28 20 70 50 61 67 65 72 2d 3e 65 ssert( pPager->e
16890 53 74 61 74 65 3e 3d 50 41 47 45 52 5f 57 52 49 State>=PAGER_WRI
168a0 54 45 52 5f 43 41 43 48 45 4d 4f 44 0a 20 20 20 TER_CACHEMOD.
168b0 20 20 20 20 7c 7c 20 28 70 50 61 67 65 72 2d 3e || (pPager->
168c0 65 53 74 61 74 65 3d 3d 50 41 47 45 52 5f 4f 50 eState==PAGER_OP
168d0 45 4e 20 26 26 20 70 50 61 67 65 72 2d 3e 65 4c EN && pPager->eL
168e0 6f 63 6b 3d 3d 45 58 43 4c 55 53 49 56 45 5f 4c ock==EXCLUSIVE_L
168f0 4f 43 4b 29 0a 20 20 29 3b 0a 20 20 61 73 73 65 OCK). );. asse
16900 72 74 28 20 70 50 61 67 65 72 2d 3e 65 53 74 61 rt( pPager->eSta
16910 74 65 3e 3d 50 41 47 45 52 5f 57 52 49 54 45 52 te>=PAGER_WRITER
16920 5f 43 41 43 48 45 4d 4f 44 20 7c 7c 20 69 73 4d _CACHEMOD || isM
16930 61 69 6e 4a 72 6e 6c 20 29 3b 0a 0a 20 20 2f 2a ainJrnl );.. /*
16940 20 52 65 61 64 20 74 68 65 20 70 61 67 65 20 6e Read the page n
16950 75 6d 62 65 72 20 61 6e 64 20 70 61 67 65 20 64 umber and page d
16960 61 74 61 20 66 72 6f 6d 20 74 68 65 20 6a 6f 75 ata from the jou
16970 72 6e 61 6c 20 6f 72 20 73 75 62 2d 6a 6f 75 72 rnal or sub-jour
16980 6e 61 6c 0a 20 20 2a 2a 20 66 69 6c 65 2e 20 52 nal. ** file. R
16990 65 74 75 72 6e 20 61 6e 20 65 72 72 6f 72 20 63 eturn an error c
169a0 6f 64 65 20 74 6f 20 74 68 65 20 63 61 6c 6c 65 ode to the calle
169b0 72 20 69 66 20 61 6e 20 49 4f 20 65 72 72 6f 72 r if an IO error
169c0 20 6f 63 63 75 72 73 2e 0a 20 20 2a 2f 0a 20 20 occurs.. */.
169d0 6a 66 64 20 3d 20 69 73 4d 61 69 6e 4a 72 6e 6c jfd = isMainJrnl
169e0 20 3f 20 70 50 61 67 65 72 2d 3e 6a 66 64 20 3a ? pPager->jfd :
169f0 20 70 50 61 67 65 72 2d 3e 73 6a 66 64 3b 0a 20 pPager->sjfd;.
16a00 20 72 63 20 3d 20 72 65 61 64 33 32 62 69 74 73 rc = read32bits
16a10 28 6a 66 64 2c 20 2a 70 4f 66 66 73 65 74 2c 20 (jfd, *pOffset,
16a20 26 70 67 6e 6f 29 3b 0a 20 20 69 66 28 20 72 63 &pgno);. if( rc
16a30 21 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 20 72 65 !=SQLITE_OK ) re
16a40 74 75 72 6e 20 72 63 3b 0a 20 20 72 63 20 3d 20 turn rc;. rc =
16a50 73 71 6c 69 74 65 33 4f 73 52 65 61 64 28 6a 66 sqlite3OsRead(jf
16a60 64 2c 20 28 75 38 2a 29 61 44 61 74 61 2c 20 70 d, (u8*)aData, p
16a70 50 61 67 65 72 2d 3e 70 61 67 65 53 69 7a 65 2c Pager->pageSize,
16a80 20 28 2a 70 4f 66 66 73 65 74 29 2b 34 29 3b 0a (*pOffset)+4);.
16a90 20 20 69 66 28 20 72 63 21 3d 53 51 4c 49 54 45 if( rc!=SQLITE
16aa0 5f 4f 4b 20 29 20 72 65 74 75 72 6e 20 72 63 3b _OK ) return rc;
16ab0 0a 20 20 2a 70 4f 66 66 73 65 74 20 2b 3d 20 70 . *pOffset += p
16ac0 50 61 67 65 72 2d 3e 70 61 67 65 53 69 7a 65 20 Pager->pageSize
16ad0 2b 20 34 20 2b 20 69 73 4d 61 69 6e 4a 72 6e 6c + 4 + isMainJrnl
16ae0 2a 34 3b 0a 0a 20 20 2f 2a 20 53 61 6e 69 74 79 *4;.. /* Sanity
16af0 20 63 68 65 63 6b 69 6e 67 20 6f 6e 20 74 68 65 checking on the
16b00 20 70 61 67 65 2e 20 20 54 68 69 73 20 69 73 20 page. This is
16b10 6d 6f 72 65 20 69 6d 70 6f 72 74 61 6e 74 20 74 more important t
16b20 68 61 74 20 49 20 6f 72 69 67 69 6e 61 6c 6c 79 hat I originally
16b30 0a 20 20 2a 2a 20 74 68 6f 75 67 68 74 2e 20 20 . ** thought.
16b40 49 66 20 61 20 70 6f 77 65 72 20 66 61 69 6c 75 If a power failu
16b50 72 65 20 6f 63 63 75 72 73 20 77 68 69 6c 65 20 re occurs while
16b60 74 68 65 20 6a 6f 75 72 6e 61 6c 20 69 73 20 62 the journal is b
16b70 65 69 6e 67 20 77 72 69 74 74 65 6e 2c 0a 20 20 eing written,.
16b80 2a 2a 20 69 74 20 63 6f 75 6c 64 20 63 61 75 73 ** it could caus
16b90 65 20 69 6e 76 61 6c 69 64 20 64 61 74 61 20 74 e invalid data t
16ba0 6f 20 62 65 20 77 72 69 74 74 65 6e 20 69 6e 74 o be written int
16bb0 6f 20 74 68 65 20 6a 6f 75 72 6e 61 6c 2e 20 20 o the journal.
16bc0 57 65 20 6e 65 65 64 20 74 6f 0a 20 20 2a 2a 20 We need to. **
16bd0 64 65 74 65 63 74 20 74 68 69 73 20 69 6e 76 61 detect this inva
16be0 6c 69 64 20 64 61 74 61 20 28 77 69 74 68 20 68 lid data (with h
16bf0 69 67 68 20 70 72 6f 62 61 62 69 6c 69 74 79 29 igh probability)
16c00 20 61 6e 64 20 69 67 6e 6f 72 65 20 69 74 2e 0a and ignore it..
16c10 20 20 2a 2f 0a 20 20 69 66 28 20 70 67 6e 6f 3d */. if( pgno=
16c20 3d 30 20 7c 7c 20 70 67 6e 6f 3d 3d 50 41 47 45 =0 || pgno==PAGE
16c30 52 5f 4d 4a 5f 50 47 4e 4f 28 70 50 61 67 65 72 R_MJ_PGNO(pPager
16c40 29 20 29 7b 0a 20 20 20 20 61 73 73 65 72 74 28 ) ){. assert(
16c50 20 21 69 73 53 61 76 65 70 6e 74 20 29 3b 0a 20 !isSavepnt );.
16c60 20 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 return SQLITE
16c70 5f 44 4f 4e 45 3b 0a 20 20 7d 0a 20 20 69 66 28 _DONE;. }. if(
16c80 20 70 67 6e 6f 3e 28 50 67 6e 6f 29 70 50 61 67 pgno>(Pgno)pPag
16c90 65 72 2d 3e 64 62 53 69 7a 65 20 7c 7c 20 73 71 er->dbSize || sq
16ca0 6c 69 74 65 33 42 69 74 76 65 63 54 65 73 74 28 lite3BitvecTest(
16cb0 70 44 6f 6e 65 2c 20 70 67 6e 6f 29 20 29 7b 0a pDone, pgno) ){.
16cc0 20 20 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 return SQLIT
16cd0 45 5f 4f 4b 3b 0a 20 20 7d 0a 20 20 69 66 28 20 E_OK;. }. if(
16ce0 69 73 4d 61 69 6e 4a 72 6e 6c 20 29 7b 0a 20 20 isMainJrnl ){.
16cf0 20 20 72 63 20 3d 20 72 65 61 64 33 32 62 69 74 rc = read32bit
16d00 73 28 6a 66 64 2c 20 28 2a 70 4f 66 66 73 65 74 s(jfd, (*pOffset
16d10 29 2d 34 2c 20 26 63 6b 73 75 6d 29 3b 0a 20 20 )-4, &cksum);.
16d20 20 20 69 66 28 20 72 63 20 29 20 72 65 74 75 72 if( rc ) retur
16d30 6e 20 72 63 3b 0a 20 20 20 20 69 66 28 20 21 69 n rc;. if( !i
16d40 73 53 61 76 65 70 6e 74 20 26 26 20 70 61 67 65 sSavepnt && page
16d50 72 5f 63 6b 73 75 6d 28 70 50 61 67 65 72 2c 20 r_cksum(pPager,
16d60 28 75 38 2a 29 61 44 61 74 61 29 21 3d 63 6b 73 (u8*)aData)!=cks
16d70 75 6d 20 29 7b 0a 20 20 20 20 20 20 72 65 74 75 um ){. retu
16d80 72 6e 20 53 51 4c 49 54 45 5f 44 4f 4e 45 3b 0a rn SQLITE_DONE;.
16d90 20 20 20 20 7d 0a 20 20 7d 0a 0a 20 20 2f 2a 20 }. }.. /*
16da0 49 66 20 74 68 69 73 20 70 61 67 65 20 68 61 73 If this page has
16db0 20 61 6c 72 65 61 64 79 20 62 65 65 6e 20 70 6c already been pl
16dc0 61 79 65 64 20 62 61 63 6b 20 62 65 66 6f 72 65 ayed back before
16dd0 20 64 75 72 69 6e 67 20 74 68 65 20 63 75 72 72 during the curr
16de0 65 6e 74 0a 20 20 2a 2a 20 72 6f 6c 6c 62 61 63 ent. ** rollbac
16df0 6b 2c 20 74 68 65 6e 20 64 6f 6e 27 74 20 62 6f k, then don't bo
16e00 74 68 65 72 20 74 6f 20 70 6c 61 79 20 69 74 20 ther to play it
16e10 62 61 63 6b 20 61 67 61 69 6e 2e 0a 20 20 2a 2f back again.. */
16e20 0a 20 20 69 66 28 20 70 44 6f 6e 65 20 26 26 20 . if( pDone &&
16e30 28 72 63 20 3d 20 73 71 6c 69 74 65 33 42 69 74 (rc = sqlite3Bit
16e40 76 65 63 53 65 74 28 70 44 6f 6e 65 2c 20 70 67 vecSet(pDone, pg
16e50 6e 6f 29 29 21 3d 53 51 4c 49 54 45 5f 4f 4b 20 no))!=SQLITE_OK
16e60 29 7b 0a 20 20 20 20 72 65 74 75 72 6e 20 72 63 ){. return rc
16e70 3b 0a 20 20 7d 0a 0a 20 20 2f 2a 20 57 68 65 6e ;. }.. /* When
16e80 20 70 6c 61 79 69 6e 67 20 62 61 63 6b 20 70 61 playing back pa
16e90 67 65 20 31 2c 20 72 65 73 74 6f 72 65 20 74 68 ge 1, restore th
16ea0 65 20 6e 52 65 73 65 72 76 65 20 73 65 74 74 69 e nReserve setti
16eb0 6e 67 0a 20 20 2a 2f 0a 20 20 69 66 28 20 70 67 ng. */. if( pg
16ec0 6e 6f 3d 3d 31 20 26 26 20 70 50 61 67 65 72 2d no==1 && pPager-
16ed0 3e 6e 52 65 73 65 72 76 65 21 3d 28 28 75 38 2a >nReserve!=((u8*
16ee0 29 61 44 61 74 61 29 5b 32 30 5d 20 29 7b 0a 20 )aData)[20] ){.
16ef0 20 20 20 70 50 61 67 65 72 2d 3e 6e 52 65 73 65 pPager->nRese
16f00 72 76 65 20 3d 20 28 28 75 38 2a 29 61 44 61 74 rve = ((u8*)aDat
16f10 61 29 5b 32 30 5d 3b 0a 20 20 20 20 70 61 67 65 a)[20];. page
16f20 72 52 65 70 6f 72 74 53 69 7a 65 28 70 50 61 67 rReportSize(pPag
16f30 65 72 29 3b 0a 20 20 7d 0a 0a 20 20 2f 2a 20 49 er);. }.. /* I
16f40 66 20 74 68 65 20 70 61 67 65 72 20 69 73 20 69 f the pager is i
16f50 6e 20 43 41 43 48 45 4d 4f 44 20 73 74 61 74 65 n CACHEMOD state
16f60 2c 20 74 68 65 6e 20 74 68 65 72 65 20 6d 75 73 , then there mus
16f70 74 20 62 65 20 61 20 63 6f 70 79 20 6f 66 20 74 t be a copy of t
16f80 68 69 73 0a 20 20 2a 2a 20 70 61 67 65 20 69 6e his. ** page in
16f90 20 74 68 65 20 70 61 67 65 72 20 63 61 63 68 65 the pager cache
16fa0 2e 20 49 6e 20 74 68 69 73 20 63 61 73 65 20 6a . In this case j
16fb0 75 73 74 20 75 70 64 61 74 65 20 74 68 65 20 70 ust update the p
16fc0 61 67 65 72 20 63 61 63 68 65 2c 0a 20 20 2a 2a ager cache,. **
16fd0 20 6e 6f 74 20 74 68 65 20 64 61 74 61 62 61 73 not the databas
16fe0 65 20 66 69 6c 65 2e 20 54 68 65 20 70 61 67 65 e file. The page
16ff0 20 69 73 20 6c 65 66 74 20 6d 61 72 6b 65 64 20 is left marked
17000 64 69 72 74 79 20 69 6e 20 74 68 69 73 20 63 61 dirty in this ca
17010 73 65 2e 0a 20 20 2a 2a 0a 20 20 2a 2a 20 41 6e se.. **. ** An
17020 20 65 78 63 65 70 74 69 6f 6e 20 74 6f 20 74 68 exception to th
17030 65 20 61 62 6f 76 65 20 72 75 6c 65 3a 20 49 66 e above rule: If
17040 20 74 68 65 20 64 61 74 61 62 61 73 65 20 69 73 the database is
17050 20 69 6e 20 6e 6f 2d 73 79 6e 63 20 6d 6f 64 65 in no-sync mode
17060 0a 20 20 2a 2a 20 61 6e 64 20 61 20 70 61 67 65 . ** and a page
17070 20 69 73 20 6d 6f 76 65 64 20 64 75 72 69 6e 67 is moved during
17080 20 61 6e 20 69 6e 63 72 65 6d 65 6e 74 61 6c 20 an incremental
17090 76 61 63 75 75 6d 20 74 68 65 6e 20 74 68 65 20 vacuum then the
170a0 70 61 67 65 20 6d 61 79 0a 20 20 2a 2a 20 6e 6f page may. ** no
170b0 74 20 62 65 20 69 6e 20 74 68 65 20 70 61 67 65 t be in the page
170c0 72 20 63 61 63 68 65 2e 20 4c 61 74 65 72 3a 20 r cache. Later:
170d0 69 66 20 61 20 6d 61 6c 6c 6f 63 28 29 20 6f 72 if a malloc() or
170e0 20 49 4f 20 65 72 72 6f 72 20 6f 63 63 75 72 73 IO error occurs
170f0 0a 20 20 2a 2a 20 64 75 72 69 6e 67 20 61 20 4d . ** during a M
17100 6f 76 65 70 61 67 65 28 29 20 63 61 6c 6c 2c 20 ovepage() call,
17110 74 68 65 6e 20 74 68 65 20 70 61 67 65 20 6d 61 then the page ma
17120 79 20 6e 6f 74 20 62 65 20 69 6e 20 74 68 65 20 y not be in the
17130 63 61 63 68 65 0a 20 20 2a 2a 20 65 69 74 68 65 cache. ** eithe
17140 72 2e 20 53 6f 20 74 68 65 20 63 6f 6e 64 69 74 r. So the condit
17150 69 6f 6e 20 64 65 73 63 72 69 62 65 64 20 69 6e ion described in
17160 20 74 68 65 20 61 62 6f 76 65 20 70 61 72 61 67 the above parag
17170 72 61 70 68 20 69 73 20 6e 6f 74 0a 20 20 2a 2a raph is not. **
17180 20 61 73 73 65 72 74 28 29 61 62 6c 65 2e 0a 20 assert()able..
17190 20 2a 2a 0a 20 20 2a 2a 20 49 66 20 69 6e 20 57 **. ** If in W
171a0 52 49 54 45 52 5f 44 42 4d 4f 44 2c 20 57 52 49 RITER_DBMOD, WRI
171b0 54 45 52 5f 46 49 4e 49 53 48 45 44 20 6f 72 20 TER_FINISHED or
171c0 4f 50 45 4e 20 73 74 61 74 65 2c 20 74 68 65 6e OPEN state, then
171d0 20 77 65 20 75 70 64 61 74 65 20 74 68 65 0a 20 we update the.
171e0 20 2a 2a 20 70 61 67 65 72 20 63 61 63 68 65 20 ** pager cache
171f0 69 66 20 69 74 20 65 78 69 73 74 73 20 61 6e 64 if it exists and
17200 20 74 68 65 20 6d 61 69 6e 20 66 69 6c 65 2e 20 the main file.
17210 54 68 65 20 70 61 67 65 20 69 73 20 74 68 65 6e The page is then
17220 20 6d 61 72 6b 65 64 20 0a 20 20 2a 2a 20 6e 6f marked . ** no
17230 74 20 64 69 72 74 79 2e 20 53 69 6e 63 65 20 74 t dirty. Since t
17240 68 69 73 20 63 6f 64 65 20 69 73 20 6f 6e 6c 79 his code is only
17250 20 65 78 65 63 75 74 65 64 20 69 6e 20 50 41 47 executed in PAG
17260 45 52 5f 4f 50 45 4e 20 73 74 61 74 65 20 66 6f ER_OPEN state fo
17270 72 0a 20 20 2a 2a 20 61 20 68 6f 74 2d 6a 6f 75 r. ** a hot-jou
17280 72 6e 61 6c 20 72 6f 6c 6c 62 61 63 6b 2c 20 69 rnal rollback, i
17290 74 20 69 73 20 67 75 61 72 61 6e 74 65 65 64 20 t is guaranteed
172a0 74 68 61 74 20 74 68 65 20 70 61 67 65 2d 63 61 that the page-ca
172b0 63 68 65 20 69 73 20 65 6d 70 74 79 0a 20 20 2a che is empty. *
172c0 2a 20 69 66 20 74 68 65 20 70 61 67 65 72 20 69 * if the pager i
172d0 73 20 69 6e 20 4f 50 45 4e 20 73 74 61 74 65 2e s in OPEN state.
172e0 0a 20 20 2a 2a 0a 20 20 2a 2a 20 54 69 63 6b 65 . **. ** Ticke
172f0 74 20 23 31 31 37 31 3a 20 20 54 68 65 20 73 74 t #1171: The st
17300 61 74 65 6d 65 6e 74 20 6a 6f 75 72 6e 61 6c 20 atement journal
17310 6d 69 67 68 74 20 63 6f 6e 74 61 69 6e 20 70 61 might contain pa
17320 67 65 20 63 6f 6e 74 65 6e 74 20 74 68 61 74 20 ge content that
17330 69 73 0a 20 20 2a 2a 20 64 69 66 66 65 72 65 6e is. ** differen
17340 74 20 66 72 6f 6d 20 74 68 65 20 70 61 67 65 20 t from the page
17350 63 6f 6e 74 65 6e 74 20 61 74 20 74 68 65 20 73 content at the s
17360 74 61 72 74 20 6f 66 20 74 68 65 20 74 72 61 6e tart of the tran
17370 73 61 63 74 69 6f 6e 2e 0a 20 20 2a 2a 20 54 68 saction.. ** Th
17380 69 73 20 6f 63 63 75 72 73 20 77 68 65 6e 20 61 is occurs when a
17390 20 70 61 67 65 20 69 73 20 63 68 61 6e 67 65 64 page is changed
173a0 20 70 72 69 6f 72 20 74 6f 20 74 68 65 20 73 74 prior to the st
173b0 61 72 74 20 6f 66 20 61 20 73 74 61 74 65 6d 65 art of a stateme
173c0 6e 74 0a 20 20 2a 2a 20 74 68 65 6e 20 63 68 61 nt. ** then cha
173d0 6e 67 65 64 20 61 67 61 69 6e 20 77 69 74 68 69 nged again withi
173e0 6e 20 74 68 65 20 73 74 61 74 65 6d 65 6e 74 2e n the statement.
173f0 20 20 57 68 65 6e 20 72 6f 6c 6c 69 6e 67 20 62 When rolling b
17400 61 63 6b 20 73 75 63 68 20 61 0a 20 20 2a 2a 20 ack such a. **
17410 73 74 61 74 65 6d 65 6e 74 20 77 65 20 6d 75 73 statement we mus
17420 74 20 6e 6f 74 20 77 72 69 74 65 20 74 6f 20 74 t not write to t
17430 68 65 20 6f 72 69 67 69 6e 61 6c 20 64 61 74 61 he original data
17440 62 61 73 65 20 75 6e 6c 65 73 73 20 77 65 20 6b base unless we k
17450 6e 6f 77 0a 20 20 2a 2a 20 66 6f 72 20 63 65 72 now. ** for cer
17460 74 61 69 6e 20 74 68 61 74 20 6f 72 69 67 69 6e tain that origin
17470 61 6c 20 70 61 67 65 20 63 6f 6e 74 65 6e 74 73 al page contents
17480 20 61 72 65 20 73 79 6e 63 65 64 20 69 6e 74 6f are synced into
17490 20 74 68 65 20 6d 61 69 6e 20 72 6f 6c 6c 62 61 the main rollba
174a0 63 6b 0a 20 20 2a 2a 20 6a 6f 75 72 6e 61 6c 2e ck. ** journal.
174b0 20 20 4f 74 68 65 72 77 69 73 65 2c 20 61 20 70 Otherwise, a p
174c0 6f 77 65 72 20 6c 6f 73 73 20 6d 69 67 68 74 20 ower loss might
174d0 6c 65 61 76 65 20 6d 6f 64 69 66 69 65 64 20 64 leave modified d
174e0 61 74 61 20 69 6e 20 74 68 65 0a 20 20 2a 2a 20 ata in the. **
174f0 64 61 74 61 62 61 73 65 20 66 69 6c 65 20 77 69 database file wi
17500 74 68 6f 75 74 20 61 6e 20 65 6e 74 72 79 20 69 thout an entry i
17510 6e 20 74 68 65 20 72 6f 6c 6c 62 61 63 6b 20 6a n the rollback j
17520 6f 75 72 6e 61 6c 20 74 68 61 74 20 63 61 6e 0a ournal that can.
17530 20 20 2a 2a 20 72 65 73 74 6f 72 65 20 74 68 65 ** restore the
17540 20 64 61 74 61 62 61 73 65 20 74 6f 20 69 74 73 database to its
17550 20 6f 72 69 67 69 6e 61 6c 20 66 6f 72 6d 2e 20 original form.
17560 20 54 77 6f 20 63 6f 6e 64 69 74 69 6f 6e 73 20 Two conditions
17570 6d 75 73 74 20 62 65 0a 20 20 2a 2a 20 6d 65 74 must be. ** met
17580 20 62 65 66 6f 72 65 20 77 72 69 74 69 6e 67 20 before writing
17590 74 6f 20 74 68 65 20 64 61 74 61 62 61 73 65 20 to the database
175a0 66 69 6c 65 73 2e 20 28 31 29 20 74 68 65 20 64 files. (1) the d
175b0 61 74 61 62 61 73 65 20 6d 75 73 74 20 62 65 0a atabase must be.
175c0 20 20 2a 2a 20 6c 6f 63 6b 65 64 2e 20 20 28 32 ** locked. (2
175d0 29 20 77 65 20 6b 6e 6f 77 20 74 68 61 74 20 74 ) we know that t
175e0 68 65 20 6f 72 69 67 69 6e 61 6c 20 70 61 67 65 he original page
175f0 20 63 6f 6e 74 65 6e 74 20 69 73 20 66 75 6c 6c content is full
17600 79 20 73 79 6e 63 65 64 0a 20 20 2a 2a 20 69 6e y synced. ** in
17610 20 74 68 65 20 6d 61 69 6e 20 6a 6f 75 72 6e 61 the main journa
17620 6c 20 65 69 74 68 65 72 20 62 65 63 61 75 73 65 l either because
17630 20 74 68 65 20 70 61 67 65 20 69 73 20 6e 6f 74 the page is not
17640 20 69 6e 20 63 61 63 68 65 20 6f 72 20 65 6c 73 in cache or els
17650 65 0a 20 20 2a 2a 20 74 68 65 20 70 61 67 65 20 e. ** the page
17660 69 73 20 6d 61 72 6b 65 64 20 61 73 20 6e 65 65 is marked as nee
17670 64 53 79 6e 63 3d 3d 30 2e 0a 20 20 2a 2a 0a 20 dSync==0.. **.
17680 20 2a 2a 20 32 30 30 38 2d 30 34 2d 31 34 3a 20 ** 2008-04-14:
17690 20 57 68 65 6e 20 61 74 74 65 6d 70 74 69 6e 67 When attempting
176a0 20 74 6f 20 76 61 63 75 75 6d 20 61 20 63 6f 72 to vacuum a cor
176b0 72 75 70 74 20 64 61 74 61 62 61 73 65 20 66 69 rupt database fi
176c0 6c 65 2c 20 69 74 0a 20 20 2a 2a 20 69 73 20 70 le, it. ** is p
176d0 6f 73 73 69 62 6c 65 20 74 6f 20 66 61 69 6c 20 ossible to fail
176e0 61 20 73 74 61 74 65 6d 65 6e 74 20 6f 6e 20 61 a statement on a
176f0 20 64 61 74 61 62 61 73 65 20 74 68 61 74 20 64 database that d
17700 6f 65 73 20 6e 6f 74 20 79 65 74 20 65 78 69 73 oes not yet exis
17710 74 2e 0a 20 20 2a 2a 20 44 6f 20 6e 6f 74 20 61 t.. ** Do not a
17720 74 74 65 6d 70 74 20 74 6f 20 77 72 69 74 65 20 ttempt to write
17730 69 66 20 64 61 74 61 62 61 73 65 20 66 69 6c 65 if database file
17740 20 68 61 73 20 6e 65 76 65 72 20 62 65 65 6e 20 has never been
17750 6f 70 65 6e 65 64 2e 0a 20 20 2a 2f 0a 20 20 69 opened.. */. i
17760 66 28 20 70 61 67 65 72 55 73 65 57 61 6c 28 70 f( pagerUseWal(p
17770 50 61 67 65 72 29 20 29 7b 0a 20 20 20 20 70 50 Pager) ){. pP
17780 67 20 3d 20 30 3b 0a 20 20 7d 65 6c 73 65 7b 0a g = 0;. }else{.
17790 20 20 20 20 70 50 67 20 3d 20 73 71 6c 69 74 65 pPg = sqlite
177a0 33 50 61 67 65 72 4c 6f 6f 6b 75 70 28 70 50 61 3PagerLookup(pPa
177b0 67 65 72 2c 20 70 67 6e 6f 29 3b 0a 20 20 7d 0a ger, pgno);. }.
177c0 20 20 61 73 73 65 72 74 28 20 70 50 67 20 7c 7c assert( pPg ||
177d0 20 21 4d 45 4d 44 42 20 29 3b 0a 20 20 61 73 73 !MEMDB );. ass
177e0 65 72 74 28 20 70 50 61 67 65 72 2d 3e 65 53 74 ert( pPager->eSt
177f0 61 74 65 21 3d 50 41 47 45 52 5f 4f 50 45 4e 20 ate!=PAGER_OPEN
17800 7c 7c 20 70 50 67 3d 3d 30 20 29 3b 0a 20 20 50 || pPg==0 );. P
17810 41 47 45 52 54 52 41 43 45 28 28 22 50 4c 41 59 AGERTRACE(("PLAY
17820 42 41 43 4b 20 25 64 20 70 61 67 65 20 25 64 20 BACK %d page %d
17830 68 61 73 68 28 25 30 38 78 29 20 25 73 5c 6e 22 hash(%08x) %s\n"
17840 2c 0a 20 20 20 20 20 20 20 20 20 20 20 50 41 47 ,. PAG
17850 45 52 49 44 28 70 50 61 67 65 72 29 2c 20 70 67 ERID(pPager), pg
17860 6e 6f 2c 20 70 61 67 65 72 5f 64 61 74 61 68 61 no, pager_dataha
17870 73 68 28 70 50 61 67 65 72 2d 3e 70 61 67 65 53 sh(pPager->pageS
17880 69 7a 65 2c 20 28 75 38 2a 29 61 44 61 74 61 29 ize, (u8*)aData)
17890 2c 0a 20 20 20 20 20 20 20 20 20 20 20 28 69 73 ,. (is
178a0 4d 61 69 6e 4a 72 6e 6c 3f 22 6d 61 69 6e 2d 6a MainJrnl?"main-j
178b0 6f 75 72 6e 61 6c 22 3a 22 73 75 62 2d 6a 6f 75 ournal":"sub-jou
178c0 72 6e 61 6c 22 29 0a 20 20 29 29 3b 0a 20 20 69 rnal"). ));. i
178d0 66 28 20 69 73 4d 61 69 6e 4a 72 6e 6c 20 29 7b f( isMainJrnl ){
178e0 0a 20 20 20 20 69 73 53 79 6e 63 65 64 20 3d 20 . isSynced =
178f0 70 50 61 67 65 72 2d 3e 6e 6f 53 79 6e 63 20 7c pPager->noSync |
17900 7c 20 28 2a 70 4f 66 66 73 65 74 20 3c 3d 20 70 | (*pOffset <= p
17910 50 61 67 65 72 2d 3e 6a 6f 75 72 6e 61 6c 48 64 Pager->journalHd
17920 72 29 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 20 r);. }else{.
17930 20 69 73 53 79 6e 63 65 64 20 3d 20 28 70 50 67 isSynced = (pPg
17940 3d 3d 30 20 7c 7c 20 30 3d 3d 28 70 50 67 2d 3e ==0 || 0==(pPg->
17950 66 6c 61 67 73 20 26 20 50 47 48 44 52 5f 4e 45 flags & PGHDR_NE
17960 45 44 5f 53 59 4e 43 29 29 3b 0a 20 20 7d 0a 20 ED_SYNC));. }.
17970 20 69 66 28 20 69 73 4f 70 65 6e 28 70 50 61 67 if( isOpen(pPag
17980 65 72 2d 3e 66 64 29 0a 20 20 20 26 26 20 28 70 er->fd). && (p
17990 50 61 67 65 72 2d 3e 65 53 74 61 74 65 3e 3d 50 Pager->eState>=P
179a0 41 47 45 52 5f 57 52 49 54 45 52 5f 44 42 4d 4f AGER_WRITER_DBMO
179b0 44 20 7c 7c 20 70 50 61 67 65 72 2d 3e 65 53 74 D || pPager->eSt
179c0 61 74 65 3d 3d 50 41 47 45 52 5f 4f 50 45 4e 29 ate==PAGER_OPEN)
179d0 0a 20 20 20 26 26 20 69 73 53 79 6e 63 65 64 0a . && isSynced.
179e0 20 20 29 7b 0a 20 20 20 20 69 36 34 20 6f 66 73 ){. i64 ofs
179f0 74 20 3d 20 28 70 67 6e 6f 2d 31 29 2a 28 69 36 t = (pgno-1)*(i6
17a00 34 29 70 50 61 67 65 72 2d 3e 70 61 67 65 53 69 4)pPager->pageSi
17a10 7a 65 3b 0a 20 20 20 20 74 65 73 74 63 61 73 65 ze;. testcase
17a20 28 20 21 69 73 53 61 76 65 70 6e 74 20 26 26 20 ( !isSavepnt &&
17a30 70 50 67 21 3d 30 20 26 26 20 28 70 50 67 2d 3e pPg!=0 && (pPg->
17a40 66 6c 61 67 73 26 50 47 48 44 52 5f 4e 45 45 44 flags&PGHDR_NEED
17a50 5f 53 59 4e 43 29 21 3d 30 20 29 3b 0a 20 20 20 _SYNC)!=0 );.
17a60 20 61 73 73 65 72 74 28 20 21 70 61 67 65 72 55 assert( !pagerU
17a70 73 65 57 61 6c 28 70 50 61 67 65 72 29 20 29 3b seWal(pPager) );
17a80 0a 20 20 20 20 72 63 20 3d 20 73 71 6c 69 74 65 . rc = sqlite
17a90 33 4f 73 57 72 69 74 65 28 70 50 61 67 65 72 2d 3OsWrite(pPager-
17aa0 3e 66 64 2c 20 28 75 38 20 2a 29 61 44 61 74 61 >fd, (u8 *)aData
17ab0 2c 20 70 50 61 67 65 72 2d 3e 70 61 67 65 53 69 , pPager->pageSi
17ac0 7a 65 2c 20 6f 66 73 74 29 3b 0a 20 20 20 20 69 ze, ofst);. i
17ad0 66 28 20 70 67 6e 6f 3e 70 50 61 67 65 72 2d 3e f( pgno>pPager->
17ae0 64 62 46 69 6c 65 53 69 7a 65 20 29 7b 0a 20 20 dbFileSize ){.
17af0 20 20 20 20 70 50 61 67 65 72 2d 3e 64 62 46 69 pPager->dbFi
17b00 6c 65 53 69 7a 65 20 3d 20 70 67 6e 6f 3b 0a 20 leSize = pgno;.
17b10 20 20 20 7d 0a 20 20 20 20 69 66 28 20 70 50 61 }. if( pPa
17b20 67 65 72 2d 3e 70 42 61 63 6b 75 70 20 29 7b 0a ger->pBackup ){.
17b30 20 20 20 20 20 20 43 4f 44 45 43 31 28 70 50 61 CODEC1(pPa
17b40 67 65 72 2c 20 61 44 61 74 61 2c 20 70 67 6e 6f ger, aData, pgno
17b50 2c 20 33 2c 20 72 63 3d 53 51 4c 49 54 45 5f 4e , 3, rc=SQLITE_N
17b60 4f 4d 45 4d 5f 42 4b 50 54 29 3b 0a 20 20 20 20 OMEM_BKPT);.
17b70 20 20 73 71 6c 69 74 65 33 42 61 63 6b 75 70 55 sqlite3BackupU
17b80 70 64 61 74 65 28 70 50 61 67 65 72 2d 3e 70 42 pdate(pPager->pB
17b90 61 63 6b 75 70 2c 20 70 67 6e 6f 2c 20 28 75 38 ackup, pgno, (u8
17ba0 2a 29 61 44 61 74 61 29 3b 0a 20 20 20 20 20 20 *)aData);.
17bb0 43 4f 44 45 43 32 28 70 50 61 67 65 72 2c 20 61 CODEC2(pPager, a
17bc0 44 61 74 61 2c 20 70 67 6e 6f 2c 20 37 2c 20 72 Data, pgno, 7, r
17bd0 63 3d 53 51 4c 49 54 45 5f 4e 4f 4d 45 4d 5f 42 c=SQLITE_NOMEM_B
17be0 4b 50 54 2c 20 61 44 61 74 61 29 3b 0a 20 20 20 KPT, aData);.
17bf0 20 7d 0a 20 20 7d 65 6c 73 65 20 69 66 28 20 21 }. }else if( !
17c00 69 73 4d 61 69 6e 4a 72 6e 6c 20 26 26 20 70 50 isMainJrnl && pP
17c10 67 3d 3d 30 20 29 7b 0a 20 20 20 20 2f 2a 20 49 g==0 ){. /* I
17c20 66 20 74 68 69 73 20 69 73 20 61 20 72 6f 6c 6c f this is a roll
17c30 62 61 63 6b 20 6f 66 20 61 20 73 61 76 65 70 6f back of a savepo
17c40 69 6e 74 20 61 6e 64 20 64 61 74 61 20 77 61 73 int and data was
17c50 20 6e 6f 74 20 77 72 69 74 74 65 6e 20 74 6f 0a not written to.
17c60 20 20 20 20 2a 2a 20 74 68 65 20 64 61 74 61 62 ** the datab
17c70 61 73 65 20 61 6e 64 20 74 68 65 20 70 61 67 65 ase and the page
17c80 20 69 73 20 6e 6f 74 20 69 6e 2d 6d 65 6d 6f 72 is not in-memor
17c90 79 2c 20 74 68 65 72 65 20 69 73 20 61 20 70 6f y, there is a po
17ca0 74 65 6e 74 69 61 6c 0a 20 20 20 20 2a 2a 20 70 tential. ** p
17cb0 72 6f 62 6c 65 6d 2e 20 57 68 65 6e 20 74 68 65 roblem. When the
17cc0 20 70 61 67 65 20 69 73 20 6e 65 78 74 20 66 65 page is next fe
17cd0 74 63 68 65 64 20 62 79 20 74 68 65 20 62 2d 74 tched by the b-t
17ce0 72 65 65 20 6c 61 79 65 72 2c 20 69 74 20 0a 20 ree layer, it .
17cf0 20 20 20 2a 2a 20 77 69 6c 6c 20 62 65 20 72 65 ** will be re
17d00 61 64 20 66 72 6f 6d 20 74 68 65 20 64 61 74 61 ad from the data
17d10 62 61 73 65 20 66 69 6c 65 2c 20 77 68 69 63 68 base file, which
17d20 20 6d 61 79 20 6f 72 20 6d 61 79 20 6e 6f 74 20 may or may not
17d30 62 65 20 0a 20 20 20 20 2a 2a 20 63 75 72 72 65 be . ** curre
17d40 6e 74 2e 20 0a 20 20 20 20 2a 2a 0a 20 20 20 20 nt. . **.
17d50 2a 2a 20 54 68 65 72 65 20 61 72 65 20 61 20 63 ** There are a c
17d60 6f 75 70 6c 65 20 6f 66 20 64 69 66 66 65 72 65 ouple of differe
17d70 6e 74 20 77 61 79 73 20 74 68 69 73 20 63 61 6e nt ways this can
17d80 20 68 61 70 70 65 6e 2e 20 41 6c 6c 20 61 72 65 happen. All are
17d90 20 71 75 69 74 65 0a 20 20 20 20 2a 2a 20 6f 62 quite. ** ob
17da0 73 63 75 72 65 2e 20 57 68 65 6e 20 72 75 6e 6e scure. When runn
17db0 69 6e 67 20 69 6e 20 73 79 6e 63 68 72 6f 6e 6f ing in synchrono
17dc0 75 73 20 6d 6f 64 65 2c 20 74 68 69 73 20 63 61 us mode, this ca
17dd0 6e 20 6f 6e 6c 79 20 68 61 70 70 65 6e 20 0a 20 n only happen .
17de0 20 20 20 2a 2a 20 69 66 20 74 68 65 20 70 61 67 ** if the pag
17df0 65 20 69 73 20 6f 6e 20 74 68 65 20 66 72 65 65 e is on the free
17e00 2d 6c 69 73 74 20 61 74 20 74 68 65 20 73 74 61 -list at the sta
17e10 72 74 20 6f 66 20 74 68 65 20 74 72 61 6e 73 61 rt of the transa
17e20 63 74 69 6f 6e 2c 20 74 68 65 6e 0a 20 20 20 20 ction, then.
17e30 2a 2a 20 70 6f 70 75 6c 61 74 65 64 2c 20 74 68 ** populated, th
17e40 65 6e 20 6d 6f 76 65 64 20 75 73 69 6e 67 20 73 en moved using s
17e50 71 6c 69 74 65 33 50 61 67 65 72 4d 6f 76 65 70 qlite3PagerMovep
17e60 61 67 65 28 29 2e 0a 20 20 20 20 2a 2a 0a 20 20 age().. **.
17e70 20 20 2a 2a 20 54 68 65 20 73 6f 6c 75 74 69 6f ** The solutio
17e80 6e 20 69 73 20 74 6f 20 61 64 64 20 61 6e 20 69 n is to add an i
17e90 6e 2d 6d 65 6d 6f 72 79 20 70 61 67 65 20 74 6f n-memory page to
17ea0 20 74 68 65 20 63 61 63 68 65 20 63 6f 6e 74 61 the cache conta
17eb0 69 6e 69 6e 67 0a 20 20 20 20 2a 2a 20 74 68 65 ining. ** the
17ec0 20 64 61 74 61 20 6a 75 73 74 20 72 65 61 64 20 data just read
17ed0 66 72 6f 6d 20 74 68 65 20 73 75 62 2d 6a 6f 75 from the sub-jou
17ee0 72 6e 61 6c 2e 20 4d 61 72 6b 20 74 68 65 20 70 rnal. Mark the p
17ef0 61 67 65 20 61 73 20 64 69 72 74 79 20 0a 20 20 age as dirty .
17f00 20 20 2a 2a 20 61 6e 64 20 69 66 20 74 68 65 20 ** and if the
17f10 70 61 67 65 72 20 72 65 71 75 69 72 65 73 20 61 pager requires a
17f20 20 6a 6f 75 72 6e 61 6c 2d 73 79 6e 63 2c 20 74 journal-sync, t
17f30 68 65 6e 20 6d 61 72 6b 20 74 68 65 20 70 61 67 hen mark the pag
17f40 65 20 61 73 20 0a 20 20 20 20 2a 2a 20 72 65 71 e as . ** req
17f50 75 69 72 69 6e 67 20 61 20 6a 6f 75 72 6e 61 6c uiring a journal
17f60 2d 73 79 6e 63 20 62 65 66 6f 72 65 20 69 74 20 -sync before it
17f70 69 73 20 77 72 69 74 74 65 6e 2e 0a 20 20 20 20 is written..
17f80 2a 2f 0a 20 20 20 20 61 73 73 65 72 74 28 20 69 */. assert( i
17f90 73 53 61 76 65 70 6e 74 20 29 3b 0a 20 20 20 20 sSavepnt );.
17fa0 61 73 73 65 72 74 28 20 28 70 50 61 67 65 72 2d assert( (pPager-
17fb0 3e 64 6f 4e 6f 74 53 70 69 6c 6c 20 26 20 53 50 >doNotSpill & SP
17fc0 49 4c 4c 46 4c 41 47 5f 52 4f 4c 4c 42 41 43 4b ILLFLAG_ROLLBACK
17fd0 29 3d 3d 30 20 29 3b 0a 20 20 20 20 70 50 61 67 )==0 );. pPag
17fe0 65 72 2d 3e 64 6f 4e 6f 74 53 70 69 6c 6c 20 7c er->doNotSpill |
17ff0 3d 20 53 50 49 4c 4c 46 4c 41 47 5f 52 4f 4c 4c = SPILLFLAG_ROLL
18000 42 41 43 4b 3b 0a 20 20 20 20 72 63 20 3d 20 73 BACK;. rc = s
18010 71 6c 69 74 65 33 50 61 67 65 72 47 65 74 28 70 qlite3PagerGet(p
18020 50 61 67 65 72 2c 20 70 67 6e 6f 2c 20 26 70 50 Pager, pgno, &pP
18030 67 2c 20 31 29 3b 0a 20 20 20 20 61 73 73 65 72 g, 1);. asser
18040 74 28 20 28 70 50 61 67 65 72 2d 3e 64 6f 4e 6f t( (pPager->doNo
18050 74 53 70 69 6c 6c 20 26 20 53 50 49 4c 4c 46 4c tSpill & SPILLFL
18060 41 47 5f 52 4f 4c 4c 42 41 43 4b 29 21 3d 30 20 AG_ROLLBACK)!=0
18070 29 3b 0a 20 20 20 20 70 50 61 67 65 72 2d 3e 64 );. pPager->d
18080 6f 4e 6f 74 53 70 69 6c 6c 20 26 3d 20 7e 53 50 oNotSpill &= ~SP
18090 49 4c 4c 46 4c 41 47 5f 52 4f 4c 4c 42 41 43 4b ILLFLAG_ROLLBACK
180a0 3b 0a 20 20 20 20 69 66 28 20 72 63 21 3d 53 51 ;. if( rc!=SQ
180b0 4c 49 54 45 5f 4f 4b 20 29 20 72 65 74 75 72 6e LITE_OK ) return
180c0 20 72 63 3b 0a 20 20 20 20 70 50 67 2d 3e 66 6c rc;. pPg->fl
180d0 61 67 73 20 26 3d 20 7e 50 47 48 44 52 5f 4e 45 ags &= ~PGHDR_NE
180e0 45 44 5f 52 45 41 44 3b 0a 20 20 20 20 73 71 6c ED_READ;. sql
180f0 69 74 65 33 50 63 61 63 68 65 4d 61 6b 65 44 69 ite3PcacheMakeDi
18100 72 74 79 28 70 50 67 29 3b 0a 20 20 7d 0a 20 20 rty(pPg);. }.
18110 69 66 28 20 70 50 67 20 29 7b 0a 20 20 20 20 2f if( pPg ){. /
18120 2a 20 4e 6f 20 70 61 67 65 20 73 68 6f 75 6c 64 * No page should
18130 20 65 76 65 72 20 62 65 20 65 78 70 6c 69 63 69 ever be explici
18140 74 6c 79 20 72 6f 6c 6c 65 64 20 62 61 63 6b 20 tly rolled back
18150 74 68 61 74 20 69 73 20 69 6e 20 75 73 65 2c 20 that is in use,
18160 65 78 63 65 70 74 0a 20 20 20 20 2a 2a 20 66 6f except. ** fo
18170 72 20 70 61 67 65 20 31 20 77 68 69 63 68 20 69 r page 1 which i
18180 73 20 68 65 6c 64 20 69 6e 20 75 73 65 20 69 6e s held in use in
18190 20 6f 72 64 65 72 20 74 6f 20 6b 65 65 70 20 74 order to keep t
181a0 68 65 20 6c 6f 63 6b 20 6f 6e 20 74 68 65 0a 20 he lock on the.
181b0 20 20 20 2a 2a 20 64 61 74 61 62 61 73 65 20 61 ** database a
181c0 63 74 69 76 65 2e 20 48 6f 77 65 76 65 72 20 73 ctive. However s
181d0 75 63 68 20 61 20 70 61 67 65 20 6d 61 79 20 62 uch a page may b
181e0 65 20 72 6f 6c 6c 65 64 20 62 61 63 6b 20 61 73 e rolled back as
181f0 20 61 20 72 65 73 75 6c 74 0a 20 20 20 20 2a 2a a result. **
18200 20 6f 66 20 61 6e 20 69 6e 74 65 72 6e 61 6c 20 of an internal
18210 65 72 72 6f 72 20 72 65 73 75 6c 74 69 6e 67 20 error resulting
18220 69 6e 20 61 6e 20 61 75 74 6f 6d 61 74 69 63 20 in an automatic
18230 63 61 6c 6c 20 74 6f 0a 20 20 20 20 2a 2a 20 73 call to. ** s
18240 71 6c 69 74 65 33 50 61 67 65 72 52 6f 6c 6c 62 qlite3PagerRollb
18250 61 63 6b 28 29 2e 0a 20 20 20 20 2a 2f 0a 20 20 ack().. */.
18260 20 20 76 6f 69 64 20 2a 70 44 61 74 61 3b 0a 20 void *pData;.
18270 20 20 20 70 44 61 74 61 20 3d 20 70 50 67 2d 3e pData = pPg->
18280 70 44 61 74 61 3b 0a 20 20 20 20 6d 65 6d 63 70 pData;. memcp
18290 79 28 70 44 61 74 61 2c 20 28 75 38 2a 29 61 44 y(pData, (u8*)aD
182a0 61 74 61 2c 20 70 50 61 67 65 72 2d 3e 70 61 67 ata, pPager->pag
182b0 65 53 69 7a 65 29 3b 0a 20 20 20 20 70 50 61 67 eSize);. pPag
182c0 65 72 2d 3e 78 52 65 69 6e 69 74 65 72 28 70 50 er->xReiniter(pP
182d0 67 29 3b 0a 20 20 20 20 69 66 28 20 69 73 4d 61 g);. if( isMa
182e0 69 6e 4a 72 6e 6c 20 26 26 20 28 21 69 73 53 61 inJrnl && (!isSa
182f0 76 65 70 6e 74 20 7c 7c 20 2a 70 4f 66 66 73 65 vepnt || *pOffse
18300 74 3c 3d 70 50 61 67 65 72 2d 3e 6a 6f 75 72 6e t<=pPager->journ
18310 61 6c 48 64 72 29 20 29 7b 0a 20 20 20 20 20 20 alHdr) ){.
18320 2f 2a 20 49 66 20 74 68 65 20 63 6f 6e 74 65 6e /* If the conten
18330 74 73 20 6f 66 20 74 68 69 73 20 70 61 67 65 20 ts of this page
18340 77 65 72 65 20 6a 75 73 74 20 72 65 73 74 6f 72 were just restor
18350 65 64 20 66 72 6f 6d 20 74 68 65 20 6d 61 69 6e ed from the main
18360 20 0a 20 20 20 20 20 20 2a 2a 20 6a 6f 75 72 6e . ** journ
18370 61 6c 20 66 69 6c 65 2c 20 74 68 65 6e 20 69 74 al file, then it
18380 73 20 63 6f 6e 74 65 6e 74 20 6d 75 73 74 20 62 s content must b
18390 65 20 61 73 20 74 68 65 79 20 77 65 72 65 20 77 e as they were w
183a0 68 65 6e 20 74 68 65 20 0a 20 20 20 20 20 20 2a hen the . *
183b0 2a 20 74 72 61 6e 73 61 63 74 69 6f 6e 20 77 61 * transaction wa
183c0 73 20 66 69 72 73 74 20 6f 70 65 6e 65 64 2e 20 s first opened.
183d0 49 6e 20 74 68 69 73 20 63 61 73 65 20 77 65 20 In this case we
183e0 63 61 6e 20 6d 61 72 6b 20 74 68 65 20 70 61 67 can mark the pag
183f0 65 0a 20 20 20 20 20 20 2a 2a 20 61 73 20 63 6c e. ** as cl
18400 65 61 6e 2c 20 73 69 6e 63 65 20 74 68 65 72 65 ean, since there
18410 20 77 69 6c 6c 20 62 65 20 6e 6f 20 6e 65 65 64 will be no need
18420 20 74 6f 20 77 72 69 74 65 20 69 74 20 6f 75 74 to write it out
18430 20 74 6f 20 74 68 65 0a 20 20 20 20 20 20 2a 2a to the. **
18440 20 64 61 74 61 62 61 73 65 2e 0a 20 20 20 20 20 database..
18450 20 2a 2a 0a 20 20 20 20 20 20 2a 2a 20 54 68 65 **. ** The
18460 72 65 20 69 73 20 6f 6e 65 20 65 78 63 65 70 74 re is one except
18470 69 6f 6e 20 74 6f 20 74 68 69 73 20 72 75 6c 65 ion to this rule
18480 2e 20 49 66 20 74 68 65 20 70 61 67 65 20 69 73 . If the page is
18490 20 62 65 69 6e 67 20 72 6f 6c 6c 65 64 0a 20 20 being rolled.
184a0 20 20 20 20 2a 2a 20 62 61 63 6b 20 61 73 20 70 ** back as p
184b0 61 72 74 20 6f 66 20 61 20 73 61 76 65 70 6f 69 art of a savepoi
184c0 6e 74 20 28 6f 72 20 73 74 61 74 65 6d 65 6e 74 nt (or statement
184d0 29 20 72 6f 6c 6c 62 61 63 6b 20 66 72 6f 6d 20 ) rollback from
184e0 61 6e 20 0a 20 20 20 20 20 20 2a 2a 20 75 6e 73 an . ** uns
184f0 79 6e 63 65 64 20 70 6f 72 74 69 6f 6e 20 6f 66 ynced portion of
18500 20 74 68 65 20 6d 61 69 6e 20 6a 6f 75 72 6e 61 the main journa
18510 6c 20 66 69 6c 65 2c 20 74 68 65 6e 20 69 74 20 l file, then it
18520 69 73 20 6e 6f 74 20 73 61 66 65 0a 20 20 20 20 is not safe.
18530 20 20 2a 2a 20 74 6f 20 6d 61 72 6b 20 74 68 65 ** to mark the
18540 20 70 61 67 65 20 61 73 20 63 6c 65 61 6e 2e 20 page as clean.
18550 54 68 69 73 20 69 73 20 62 65 63 61 75 73 65 20 This is because
18560 6d 61 72 6b 69 6e 67 20 74 68 65 20 70 61 67 65 marking the page
18570 20 61 73 0a 20 20 20 20 20 20 2a 2a 20 63 6c 65 as. ** cle
18580 61 6e 20 77 69 6c 6c 20 63 6c 65 61 72 20 74 68 an will clear th
18590 65 20 50 47 48 44 52 5f 4e 45 45 44 5f 53 59 4e e PGHDR_NEED_SYN
185a0 43 20 66 6c 61 67 2e 20 53 69 6e 63 65 20 74 68 C flag. Since th
185b0 65 20 70 61 67 65 20 69 73 0a 20 20 20 20 20 20 e page is.
185c0 2a 2a 20 61 6c 72 65 61 64 79 20 69 6e 20 74 68 ** already in th
185d0 65 20 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 20 28 e journal file (
185e0 72 65 63 6f 72 64 65 64 20 69 6e 20 50 61 67 65 recorded in Page
185f0 72 2e 70 49 6e 4a 6f 75 72 6e 61 6c 29 20 61 6e r.pInJournal) an
18600 64 0a 20 20 20 20 20 20 2a 2a 20 74 68 65 20 50 d. ** the P
18610 47 48 44 52 5f 4e 45 45 44 5f 53 59 4e 43 20 66 GHDR_NEED_SYNC f
18620 6c 61 67 20 69 73 20 63 6c 65 61 72 65 64 2c 20 lag is cleared,
18630 69 66 20 74 68 65 20 70 61 67 65 20 69 73 20 77 if the page is w
18640 72 69 74 74 65 6e 20 74 6f 0a 20 20 20 20 20 20 ritten to.
18650 2a 2a 20 61 67 61 69 6e 20 77 69 74 68 69 6e 20 ** again within
18660 74 68 69 73 20 74 72 61 6e 73 61 63 74 69 6f 6e this transaction
18670 2c 20 69 74 20 77 69 6c 6c 20 62 65 20 6d 61 72 , it will be mar
18680 6b 65 64 20 61 73 20 64 69 72 74 79 20 62 75 74 ked as dirty but
18690 0a 20 20 20 20 20 20 2a 2a 20 74 68 65 20 50 47 . ** the PG
186a0 48 44 52 5f 4e 45 45 44 5f 53 59 4e 43 20 66 6c HDR_NEED_SYNC fl
186b0 61 67 20 77 69 6c 6c 20 6e 6f 74 20 62 65 20 73 ag will not be s
186c0 65 74 2e 20 49 74 20 63 6f 75 6c 64 20 74 68 65 et. It could the
186d0 6e 20 70 6f 74 65 6e 74 69 61 6c 6c 79 0a 20 20 n potentially.
186e0 20 20 20 20 2a 2a 20 62 65 20 77 72 69 74 74 65 ** be writte
186f0 6e 20 6f 75 74 20 69 6e 74 6f 20 74 68 65 20 64 n out into the d
18700 61 74 61 62 61 73 65 20 66 69 6c 65 20 62 65 66 atabase file bef
18710 6f 72 65 20 69 74 73 20 6a 6f 75 72 6e 61 6c 20 ore its journal
18720 66 69 6c 65 0a 20 20 20 20 20 20 2a 2a 20 73 65 file. ** se
18730 67 6d 65 6e 74 20 69 73 20 73 79 6e 63 65 64 2e gment is synced.
18740 20 49 66 20 61 20 63 72 61 73 68 20 6f 63 63 75 If a crash occu
18750 72 73 20 64 75 72 69 6e 67 20 6f 72 20 66 6f 6c rs during or fol
18760 6c 6f 77 69 6e 67 20 74 68 69 73 2c 0a 20 20 20 lowing this,.
18770 20 20 20 2a 2a 20 64 61 74 61 62 61 73 65 20 63 ** database c
18780 6f 72 72 75 70 74 69 6f 6e 20 6d 61 79 20 65 6e orruption may en
18790 73 75 65 2e 0a 20 20 20 20 20 20 2a 2a 0a 20 20 sue.. **.
187a0 20 20 20 20 2a 2a 20 55 70 64 61 74 65 3a 20 41 ** Update: A
187b0 6e 6f 74 68 65 72 20 65 78 63 65 70 74 69 6f 6e nother exception
187c0 20 69 73 20 66 6f 72 20 74 65 6d 70 20 66 69 6c is for temp fil
187d0 65 73 20 74 68 61 74 20 61 72 65 20 6e 6f 74 20 es that are not
187e0 0a 20 20 20 20 20 20 2a 2a 20 69 6e 2d 6d 65 6d . ** in-mem
187f0 6f 72 79 20 64 61 74 61 62 61 73 65 73 2e 20 49 ory databases. I
18800 6e 20 74 68 69 73 20 63 61 73 65 20 74 68 65 20 n this case the
18810 70 61 67 65 20 6d 61 79 20 68 61 76 65 20 62 65 page may have be
18820 65 6e 20 64 69 72 74 79 0a 20 20 20 20 20 20 2a en dirty. *
18830 2a 20 61 74 20 74 68 65 20 73 74 61 72 74 20 6f * at the start o
18840 66 20 74 68 65 20 74 72 61 6e 73 61 63 74 69 6f f the transactio
18850 6e 2e 0a 20 20 20 20 20 20 2a 2f 0a 20 20 20 20 n.. */.
18860 20 20 61 73 73 65 72 74 28 20 21 70 61 67 65 72 assert( !pager
18870 55 73 65 57 61 6c 28 70 50 61 67 65 72 29 20 29 UseWal(pPager) )
18880 3b 0a 20 20 20 20 20 20 69 66 28 20 70 50 61 67 ;. if( pPag
18890 65 72 2d 3e 74 65 6d 70 46 69 6c 65 3d 3d 30 20 er->tempFile==0
188a0 29 20 73 71 6c 69 74 65 33 50 63 61 63 68 65 4d ) sqlite3PcacheM
188b0 61 6b 65 43 6c 65 61 6e 28 70 50 67 29 3b 0a 20 akeClean(pPg);.
188c0 20 20 20 7d 0a 20 20 20 20 70 61 67 65 72 5f 73 }. pager_s
188d0 65 74 5f 70 61 67 65 68 61 73 68 28 70 50 67 29 et_pagehash(pPg)
188e0 3b 0a 0a 20 20 20 20 2f 2a 20 49 66 20 74 68 69 ;.. /* If thi
188f0 73 20 77 61 73 20 70 61 67 65 20 31 2c 20 74 68 s was page 1, th
18900 65 6e 20 72 65 73 74 6f 72 65 20 74 68 65 20 76 en restore the v
18910 61 6c 75 65 20 6f 66 20 50 61 67 65 72 2e 64 62 alue of Pager.db
18920 46 69 6c 65 56 65 72 73 2e 0a 20 20 20 20 2a 2a FileVers.. **
18930 20 44 6f 20 74 68 69 73 20 62 65 66 6f 72 65 20 Do this before
18940 61 6e 79 20 64 65 63 6f 64 69 6e 67 2e 20 2a 2f any decoding. */
18950 0a 20 20 20 20 69 66 28 20 70 67 6e 6f 3d 3d 31 . if( pgno==1
18960 20 29 7b 0a 20 20 20 20 20 20 6d 65 6d 63 70 79 ){. memcpy
18970 28 26 70 50 61 67 65 72 2d 3e 64 62 46 69 6c 65 (&pPager->dbFile
18980 56 65 72 73 2c 20 26 28 28 75 38 2a 29 70 44 61 Vers, &((u8*)pDa
18990 74 61 29 5b 32 34 5d 2c 73 69 7a 65 6f 66 28 70 ta)[24],sizeof(p
189a0 50 61 67 65 72 2d 3e 64 62 46 69 6c 65 56 65 72 Pager->dbFileVer
189b0 73 29 29 3b 0a 20 20 20 20 7d 0a 0a 20 20 20 20 s));. }..
189c0 2f 2a 20 44 65 63 6f 64 65 20 74 68 65 20 70 61 /* Decode the pa
189d0 67 65 20 6a 75 73 74 20 72 65 61 64 20 66 72 6f ge just read fro
189e0 6d 20 64 69 73 6b 20 2a 2f 0a 20 20 20 20 43 4f m disk */. CO
189f0 44 45 43 31 28 70 50 61 67 65 72 2c 20 70 44 61 DEC1(pPager, pDa
18a00 74 61 2c 20 70 50 67 2d 3e 70 67 6e 6f 2c 20 33 ta, pPg->pgno, 3
18a10 2c 20 72 63 3d 53 51 4c 49 54 45 5f 4e 4f 4d 45 , rc=SQLITE_NOME
18a20 4d 5f 42 4b 50 54 29 3b 0a 20 20 20 20 73 71 6c M_BKPT);. sql
18a30 69 74 65 33 50 63 61 63 68 65 52 65 6c 65 61 73 ite3PcacheReleas
18a40 65 28 70 50 67 29 3b 0a 20 20 7d 0a 20 20 72 65 e(pPg);. }. re
18a50 74 75 72 6e 20 72 63 3b 0a 7d 0a 0a 2f 2a 0a 2a turn rc;.}../*.*
18a60 2a 20 50 61 72 61 6d 65 74 65 72 20 7a 4d 61 73 * Parameter zMas
18a70 74 65 72 20 69 73 20 74 68 65 20 6e 61 6d 65 20 ter is the name
18a80 6f 66 20 61 20 6d 61 73 74 65 72 20 6a 6f 75 72 of a master jour
18a90 6e 61 6c 20 66 69 6c 65 2e 20 41 20 73 69 6e 67 nal file. A sing
18aa0 6c 65 20 6a 6f 75 72 6e 61 6c 0a 2a 2a 20 66 69 le journal.** fi
18ab0 6c 65 20 74 68 61 74 20 72 65 66 65 72 72 65 64 le that referred
18ac0 20 74 6f 20 74 68 65 20 6d 61 73 74 65 72 20 6a to the master j
18ad0 6f 75 72 6e 61 6c 20 66 69 6c 65 20 68 61 73 20 ournal file has
18ae0 6a 75 73 74 20 62 65 65 6e 20 72 6f 6c 6c 65 64 just been rolled
18af0 20 62 61 63 6b 2e 0a 2a 2a 20 54 68 69 73 20 72 back..** This r
18b00 6f 75 74 69 6e 65 20 63 68 65 63 6b 73 20 69 66 outine checks if
18b10 20 69 74 20 69 73 20 70 6f 73 73 69 62 6c 65 20 it is possible
18b20 74 6f 20 64 65 6c 65 74 65 20 74 68 65 20 6d 61 to delete the ma
18b30 73 74 65 72 20 6a 6f 75 72 6e 61 6c 20 66 69 6c ster journal fil
18b40 65 2c 0a 2a 2a 20 61 6e 64 20 64 6f 65 73 20 73 e,.** and does s
18b50 6f 20 69 66 20 69 74 20 69 73 2e 0a 2a 2a 0a 2a o if it is..**.*
18b60 2a 20 41 72 67 75 6d 65 6e 74 20 7a 4d 61 73 74 * Argument zMast
18b70 65 72 20 6d 61 79 20 70 6f 69 6e 74 20 74 6f 20 er may point to
18b80 50 61 67 65 72 2e 70 54 6d 70 53 70 61 63 65 2e Pager.pTmpSpace.
18b90 20 53 6f 20 74 68 61 74 20 62 75 66 66 65 72 20 So that buffer
18ba0 69 73 20 6e 6f 74 20 0a 2a 2a 20 61 76 61 69 6c is not .** avail
18bb0 61 62 6c 65 20 66 6f 72 20 75 73 65 20 77 69 74 able for use wit
18bc0 68 69 6e 20 74 68 69 73 20 66 75 6e 63 74 69 6f hin this functio
18bd0 6e 2e 0a 2a 2a 0a 2a 2a 20 57 68 65 6e 20 61 20 n..**.** When a
18be0 6d 61 73 74 65 72 20 6a 6f 75 72 6e 61 6c 20 66 master journal f
18bf0 69 6c 65 20 69 73 20 63 72 65 61 74 65 64 2c 20 ile is created,
18c00 69 74 20 69 73 20 70 6f 70 75 6c 61 74 65 64 20 it is populated
18c10 77 69 74 68 20 74 68 65 20 6e 61 6d 65 73 20 0a with the names .
18c20 2a 2a 20 6f 66 20 61 6c 6c 20 6f 66 20 69 74 73 ** of all of its
18c30 20 63 68 69 6c 64 20 6a 6f 75 72 6e 61 6c 73 2c child journals,
18c40 20 6f 6e 65 20 61 66 74 65 72 20 61 6e 6f 74 68 one after anoth
18c50 65 72 2c 20 66 6f 72 6d 61 74 74 65 64 20 61 73 er, formatted as
18c60 20 75 74 66 2d 38 20 0a 2a 2a 20 65 6e 63 6f 64 utf-8 .** encod
18c70 65 64 20 74 65 78 74 2e 20 54 68 65 20 65 6e 64 ed text. The end
18c80 20 6f 66 20 65 61 63 68 20 63 68 69 6c 64 20 6a of each child j
18c90 6f 75 72 6e 61 6c 20 66 69 6c 65 20 69 73 20 6d ournal file is m
18ca0 61 72 6b 65 64 20 77 69 74 68 20 61 20 0a 2a 2a arked with a .**
18cb0 20 6e 75 6c 2d 74 65 72 6d 69 6e 61 74 6f 72 20 nul-terminator
18cc0 62 79 74 65 20 28 30 78 30 30 29 2e 20 69 2e 65 byte (0x00). i.e
18cd0 2e 20 74 68 65 20 65 6e 74 69 72 65 20 63 6f 6e . the entire con
18ce0 74 65 6e 74 73 20 6f 66 20 61 20 6d 61 73 74 65 tents of a maste
18cf0 72 20 6a 6f 75 72 6e 61 6c 0a 2a 2a 20 66 69 6c r journal.** fil
18d00 65 20 66 6f 72 20 61 20 74 72 61 6e 73 61 63 74 e for a transact
18d10 69 6f 6e 20 69 6e 76 6f 6c 76 69 6e 67 20 74 77 ion involving tw
18d20 6f 20 64 61 74 61 62 61 73 65 73 20 6d 69 67 68 o databases migh
18d30 74 20 62 65 3a 0a 2a 2a 0a 2a 2a 20 20 20 22 2f t be:.**.** "/
18d40 68 6f 6d 65 2f 62 69 6c 6c 2f 61 2e 64 62 2d 6a home/bill/a.db-j
18d50 6f 75 72 6e 61 6c 5c 78 30 30 2f 68 6f 6d 65 2f ournal\x00/home/
18d60 62 69 6c 6c 2f 62 2e 64 62 2d 6a 6f 75 72 6e 61 bill/b.db-journa
18d70 6c 5c 78 30 30 22 0a 2a 2a 0a 2a 2a 20 41 20 6d l\x00".**.** A m
18d80 61 73 74 65 72 20 6a 6f 75 72 6e 61 6c 20 66 69 aster journal fi
18d90 6c 65 20 6d 61 79 20 6f 6e 6c 79 20 62 65 20 64 le may only be d
18da0 65 6c 65 74 65 64 20 6f 6e 63 65 20 61 6c 6c 20 eleted once all
18db0 6f 66 20 69 74 73 20 63 68 69 6c 64 20 0a 2a 2a of its child .**
18dc0 20 6a 6f 75 72 6e 61 6c 73 20 68 61 76 65 20 62 journals have b
18dd0 65 65 6e 20 72 6f 6c 6c 65 64 20 62 61 63 6b 2e een rolled back.
18de0 0a 2a 2a 0a 2a 2a 20 54 68 69 73 20 66 75 6e 63 .**.** This func
18df0 74 69 6f 6e 20 72 65 61 64 73 20 74 68 65 20 63 tion reads the c
18e00 6f 6e 74 65 6e 74 73 20 6f 66 20 74 68 65 20 6d ontents of the m
18e10 61 73 74 65 72 2d 6a 6f 75 72 6e 61 6c 20 66 69 aster-journal fi
18e20 6c 65 20 69 6e 74 6f 20 0a 2a 2a 20 6d 65 6d 6f le into .** memo
18e30 72 79 20 61 6e 64 20 6c 6f 6f 70 73 20 74 68 72 ry and loops thr
18e40 6f 75 67 68 20 65 61 63 68 20 6f 66 20 74 68 65 ough each of the
18e50 20 63 68 69 6c 64 20 6a 6f 75 72 6e 61 6c 20 6e child journal n
18e60 61 6d 65 73 2e 20 46 6f 72 0a 2a 2a 20 65 61 63 ames. For.** eac
18e70 68 20 63 68 69 6c 64 20 6a 6f 75 72 6e 61 6c 2c h child journal,
18e80 20 69 74 20 63 68 65 63 6b 73 20 69 66 3a 0a 2a it checks if:.*
18e90 2a 0a 2a 2a 20 20 20 2a 20 69 66 20 74 68 65 20 *.** * if the
18ea0 63 68 69 6c 64 20 6a 6f 75 72 6e 61 6c 20 65 78 child journal ex
18eb0 69 73 74 73 2c 20 61 6e 64 20 69 66 20 73 6f 0a ists, and if so.
18ec0 2a 2a 20 20 20 2a 20 69 66 20 74 68 65 20 63 68 ** * if the ch
18ed0 69 6c 64 20 6a 6f 75 72 6e 61 6c 20 63 6f 6e 74 ild journal cont
18ee0 61 69 6e 73 20 61 20 72 65 66 65 72 65 6e 63 65 ains a reference
18ef0 20 74 6f 20 6d 61 73 74 65 72 20 6a 6f 75 72 6e to master journ
18f00 61 6c 20 0a 2a 2a 20 20 20 20 20 66 69 6c 65 20 al .** file
18f10 7a 4d 61 73 74 65 72 0a 2a 2a 0a 2a 2a 20 49 66 zMaster.**.** If
18f20 20 61 20 63 68 69 6c 64 20 6a 6f 75 72 6e 61 6c a child journal
18f30 20 63 61 6e 20 62 65 20 66 6f 75 6e 64 20 74 68 can be found th
18f40 61 74 20 6d 61 74 63 68 65 73 20 62 6f 74 68 20 at matches both
18f50 6f 66 20 74 68 65 20 63 72 69 74 65 72 69 61 0a of the criteria.
18f60 2a 2a 20 61 62 6f 76 65 2c 20 74 68 69 73 20 66 ** above, this f
18f70 75 6e 63 74 69 6f 6e 20 72 65 74 75 72 6e 73 20 unction returns
18f80 77 69 74 68 6f 75 74 20 64 6f 69 6e 67 20 61 6e without doing an
18f90 79 74 68 69 6e 67 2e 20 4f 74 68 65 72 77 69 73 ything. Otherwis
18fa0 65 2c 20 69 66 0a 2a 2a 20 6e 6f 20 73 75 63 68 e, if.** no such
18fb0 20 63 68 69 6c 64 20 6a 6f 75 72 6e 61 6c 20 63 child journal c
18fc0 61 6e 20 62 65 20 66 6f 75 6e 64 2c 20 66 69 6c an be found, fil
18fd0 65 20 7a 4d 61 73 74 65 72 20 69 73 20 64 65 6c e zMaster is del
18fe0 65 74 65 64 20 66 72 6f 6d 0a 2a 2a 20 74 68 65 eted from.** the
18ff0 20 66 69 6c 65 2d 73 79 73 74 65 6d 20 75 73 69 file-system usi
19000 6e 67 20 73 71 6c 69 74 65 33 4f 73 44 65 6c 65 ng sqlite3OsDele
19010 74 65 28 29 2e 0a 2a 2a 0a 2a 2a 20 49 66 20 61 te()..**.** If a
19020 6e 20 49 4f 20 65 72 72 6f 72 20 77 69 74 68 69 n IO error withi
19030 6e 20 74 68 69 73 20 66 75 6e 63 74 69 6f 6e 2c n this function,
19040 20 61 6e 20 65 72 72 6f 72 20 63 6f 64 65 20 69 an error code i
19050 73 20 72 65 74 75 72 6e 65 64 2e 20 54 68 69 73 s returned. This
19060 0a 2a 2a 20 66 75 6e 63 74 69 6f 6e 20 61 6c 6c .** function all
19070 6f 63 61 74 65 73 20 6d 65 6d 6f 72 79 20 62 79 ocates memory by
19080 20 63 61 6c 6c 69 6e 67 20 73 71 6c 69 74 65 33 calling sqlite3
19090 4d 61 6c 6c 6f 63 28 29 2e 20 49 66 20 61 6e 20 Malloc(). If an
190a0 61 6c 6c 6f 63 61 74 69 6f 6e 0a 2a 2a 20 66 61 allocation.** fa
190b0 69 6c 73 2c 20 53 51 4c 49 54 45 5f 4e 4f 4d 45 ils, SQLITE_NOME
190c0 4d 20 69 73 20 72 65 74 75 72 6e 65 64 2e 20 4f M is returned. O
190d0 74 68 65 72 77 69 73 65 2c 20 69 66 20 6e 6f 20 therwise, if no
190e0 49 4f 20 6f 72 20 6d 61 6c 6c 6f 63 20 65 72 72 IO or malloc err
190f0 6f 72 73 20 0a 2a 2a 20 6f 63 63 75 72 2c 20 53 ors .** occur, S
19100 51 4c 49 54 45 5f 4f 4b 20 69 73 20 72 65 74 75 QLITE_OK is retu
19110 72 6e 65 64 2e 0a 2a 2a 0a 2a 2a 20 54 4f 44 4f rned..**.** TODO
19120 3a 20 54 68 69 73 20 66 75 6e 63 74 69 6f 6e 20 : This function
19130 61 6c 6c 6f 63 61 74 65 73 20 61 20 73 69 6e 67 allocates a sing
19140 6c 65 20 62 6c 6f 63 6b 20 6f 66 20 6d 65 6d 6f le block of memo
19150 72 79 20 74 6f 20 6c 6f 61 64 0a 2a 2a 20 74 68 ry to load.** th
19160 65 20 65 6e 74 69 72 65 20 63 6f 6e 74 65 6e 74 e entire content
19170 73 20 6f 66 20 74 68 65 20 6d 61 73 74 65 72 20 s of the master
19180 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 2e 20 54 68 journal file. Th
19190 69 73 20 63 6f 75 6c 64 20 62 65 0a 2a 2a 20 61 is could be.** a
191a0 20 63 6f 75 70 6c 65 20 6f 66 20 6b 69 6c 6f 62 couple of kilob
191b0 79 74 65 73 20 6f 72 20 73 6f 20 2d 20 70 6f 74 ytes or so - pot
191c0 65 6e 74 69 61 6c 6c 79 20 6c 61 72 67 65 72 20 entially larger
191d0 74 68 61 6e 20 74 68 65 20 70 61 67 65 20 0a 2a than the page .*
191e0 2a 20 73 69 7a 65 2e 0a 2a 2f 0a 73 74 61 74 69 * size..*/.stati
191f0 63 20 69 6e 74 20 70 61 67 65 72 5f 64 65 6c 6d c int pager_delm
19200 61 73 74 65 72 28 50 61 67 65 72 20 2a 70 50 61 aster(Pager *pPa
19210 67 65 72 2c 20 63 6f 6e 73 74 20 63 68 61 72 20 ger, const char
19220 2a 7a 4d 61 73 74 65 72 29 7b 0a 20 20 73 71 6c *zMaster){. sql
19230 69 74 65 33 5f 76 66 73 20 2a 70 56 66 73 20 3d ite3_vfs *pVfs =
19240 20 70 50 61 67 65 72 2d 3e 70 56 66 73 3b 0a 20 pPager->pVfs;.
19250 20 69 6e 74 20 72 63 3b 20 20 20 20 20 20 20 20 int rc;
19260 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 52 65 /* Re
19270 74 75 72 6e 20 63 6f 64 65 20 2a 2f 0a 20 20 73 turn code */. s
19280 71 6c 69 74 65 33 5f 66 69 6c 65 20 2a 70 4d 61 qlite3_file *pMa
19290 73 74 65 72 3b 20 20 20 20 2f 2a 20 4d 61 6c 6c ster; /* Mall
192a0 6f 63 27 64 20 6d 61 73 74 65 72 2d 6a 6f 75 72 oc'd master-jour
192b0 6e 61 6c 20 66 69 6c 65 20 64 65 73 63 72 69 70 nal file descrip
192c0 74 6f 72 20 2a 2f 0a 20 20 73 71 6c 69 74 65 33 tor */. sqlite3
192d0 5f 66 69 6c 65 20 2a 70 4a 6f 75 72 6e 61 6c 3b _file *pJournal;
192e0 20 20 20 2f 2a 20 4d 61 6c 6c 6f 63 27 64 20 63 /* Malloc'd c
192f0 68 69 6c 64 2d 6a 6f 75 72 6e 61 6c 20 66 69 6c hild-journal fil
19300 65 20 64 65 73 63 72 69 70 74 6f 72 20 2a 2f 0a e descriptor */.
19310 20 20 63 68 61 72 20 2a 7a 4d 61 73 74 65 72 4a char *zMasterJ
19320 6f 75 72 6e 61 6c 20 3d 20 30 3b 20 2f 2a 20 43 ournal = 0; /* C
19330 6f 6e 74 65 6e 74 73 20 6f 66 20 6d 61 73 74 65 ontents of maste
19340 72 20 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 20 2a r journal file *
19350 2f 0a 20 20 69 36 34 20 6e 4d 61 73 74 65 72 4a /. i64 nMasterJ
19360 6f 75 72 6e 61 6c 3b 20 20 20 20 20 20 20 2f 2a ournal; /*
19370 20 53 69 7a 65 20 6f 66 20 6d 61 73 74 65 72 20 Size of master
19380 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 20 2a 2f 0a journal file */.
19390 20 20 63 68 61 72 20 2a 7a 4a 6f 75 72 6e 61 6c char *zJournal
193a0 3b 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 50 ; /* P
193b0 6f 69 6e 74 65 72 20 74 6f 20 6f 6e 65 20 6a 6f ointer to one jo
193c0 75 72 6e 61 6c 20 77 69 74 68 69 6e 20 4d 4a 20 urnal within MJ
193d0 66 69 6c 65 20 2a 2f 0a 20 20 63 68 61 72 20 2a file */. char *
193e0 7a 4d 61 73 74 65 72 50 74 72 3b 20 20 20 20 20 zMasterPtr;
193f0 20 20 20 20 2f 2a 20 53 70 61 63 65 20 74 6f 20 /* Space to
19400 68 6f 6c 64 20 4d 4a 20 66 69 6c 65 6e 61 6d 65 hold MJ filename
19410 20 66 72 6f 6d 20 61 20 6a 6f 75 72 6e 61 6c 20 from a journal
19420 66 69 6c 65 20 2a 2f 0a 20 20 69 6e 74 20 6e 4d file */. int nM
19430 61 73 74 65 72 50 74 72 3b 20 20 20 20 20 20 20 asterPtr;
19440 20 20 20 20 2f 2a 20 41 6d 6f 75 6e 74 20 6f 66 /* Amount of
19450 20 73 70 61 63 65 20 61 6c 6c 6f 63 61 74 65 64 space allocated
19460 20 74 6f 20 7a 4d 61 73 74 65 72 50 74 72 5b 5d to zMasterPtr[]
19470 20 2a 2f 0a 0a 20 20 2f 2a 20 41 6c 6c 6f 63 61 */.. /* Alloca
19480 74 65 20 73 70 61 63 65 20 66 6f 72 20 62 6f 74 te space for bot
19490 68 20 74 68 65 20 70 4a 6f 75 72 6e 61 6c 20 61 h the pJournal a
194a0 6e 64 20 70 4d 61 73 74 65 72 20 66 69 6c 65 20 nd pMaster file
194b0 64 65 73 63 72 69 70 74 6f 72 73 2e 0a 20 20 2a descriptors.. *
194c0 2a 20 49 66 20 73 75 63 63 65 73 73 66 75 6c 2c * If successful,
194d0 20 6f 70 65 6e 20 74 68 65 20 6d 61 73 74 65 72 open the master
194e0 20 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 20 66 6f journal file fo
194f0 72 20 72 65 61 64 69 6e 67 2e 0a 20 20 2a 2f 0a r reading.. */.
19500 20 20 70 4d 61 73 74 65 72 20 3d 20 28 73 71 6c pMaster = (sql
19510 69 74 65 33 5f 66 69 6c 65 20 2a 29 73 71 6c 69 ite3_file *)sqli
19520 74 65 33 4d 61 6c 6c 6f 63 5a 65 72 6f 28 70 56 te3MallocZero(pV
19530 66 73 2d 3e 73 7a 4f 73 46 69 6c 65 20 2a 20 32 fs->szOsFile * 2
19540 29 3b 0a 20 20 70 4a 6f 75 72 6e 61 6c 20 3d 20 );. pJournal =
19550 28 73 71 6c 69 74 65 33 5f 66 69 6c 65 20 2a 29 (sqlite3_file *)
19560 28 28 28 75 38 20 2a 29 70 4d 61 73 74 65 72 29 (((u8 *)pMaster)
19570 20 2b 20 70 56 66 73 2d 3e 73 7a 4f 73 46 69 6c + pVfs->szOsFil
19580 65 29 3b 0a 20 20 69 66 28 20 21 70 4d 61 73 74 e);. if( !pMast
19590 65 72 20 29 7b 0a 20 20 20 20 72 63 20 3d 20 53 er ){. rc = S
195a0 51 4c 49 54 45 5f 4e 4f 4d 45 4d 5f 42 4b 50 54 QLITE_NOMEM_BKPT
195b0 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 63 ;. }else{. c
195c0 6f 6e 73 74 20 69 6e 74 20 66 6c 61 67 73 20 3d onst int flags =
195d0 20 28 53 51 4c 49 54 45 5f 4f 50 45 4e 5f 52 45 (SQLITE_OPEN_RE
195e0 41 44 4f 4e 4c 59 7c 53 51 4c 49 54 45 5f 4f 50 ADONLY|SQLITE_OP
195f0 45 4e 5f 4d 41 53 54 45 52 5f 4a 4f 55 52 4e 41 EN_MASTER_JOURNA
19600 4c 29 3b 0a 20 20 20 20 72 63 20 3d 20 73 71 6c L);. rc = sql
19610 69 74 65 33 4f 73 4f 70 65 6e 28 70 56 66 73 2c ite3OsOpen(pVfs,
19620 20 7a 4d 61 73 74 65 72 2c 20 70 4d 61 73 74 65 zMaster, pMaste
19630 72 2c 20 66 6c 61 67 73 2c 20 30 29 3b 0a 20 20 r, flags, 0);.
19640 7d 0a 20 20 69 66 28 20 72 63 21 3d 53 51 4c 49 }. if( rc!=SQLI
19650 54 45 5f 4f 4b 20 29 20 67 6f 74 6f 20 64 65 6c TE_OK ) goto del
19660 6d 61 73 74 65 72 5f 6f 75 74 3b 0a 0a 20 20 2f master_out;.. /
19670 2a 20 4c 6f 61 64 20 74 68 65 20 65 6e 74 69 72 * Load the entir
19680 65 20 6d 61 73 74 65 72 20 6a 6f 75 72 6e 61 6c e master journal
19690 20 66 69 6c 65 20 69 6e 74 6f 20 73 70 61 63 65 file into space
196a0 20 6f 62 74 61 69 6e 65 64 20 66 72 6f 6d 0a 20 obtained from.
196b0 20 2a 2a 20 73 71 6c 69 74 65 33 5f 6d 61 6c 6c ** sqlite3_mall
196c0 6f 63 28 29 20 61 6e 64 20 70 6f 69 6e 74 65 64 oc() and pointed
196d0 20 74 6f 20 62 79 20 7a 4d 61 73 74 65 72 4a 6f to by zMasterJo
196e0 75 72 6e 61 6c 2e 20 20 20 41 6c 73 6f 20 6f 62 urnal. Also ob
196f0 74 61 69 6e 0a 20 20 2a 2a 20 73 75 66 66 69 63 tain. ** suffic
19700 69 65 6e 74 20 73 70 61 63 65 20 28 69 6e 20 7a ient space (in z
19710 4d 61 73 74 65 72 50 74 72 29 20 74 6f 20 68 6f MasterPtr) to ho
19720 6c 64 20 74 68 65 20 6e 61 6d 65 73 20 6f 66 20 ld the names of
19730 6d 61 73 74 65 72 0a 20 20 2a 2a 20 6a 6f 75 72 master. ** jour
19740 6e 61 6c 20 66 69 6c 65 73 20 65 78 74 72 61 63 nal files extrac
19750 74 65 64 20 66 72 6f 6d 20 72 65 67 75 6c 61 72 ted from regular
19760 20 72 6f 6c 6c 62 61 63 6b 2d 6a 6f 75 72 6e 61 rollback-journa
19770 6c 73 2e 0a 20 20 2a 2f 0a 20 20 72 63 20 3d 20 ls.. */. rc =
19780 73 71 6c 69 74 65 33 4f 73 46 69 6c 65 53 69 7a sqlite3OsFileSiz
19790 65 28 70 4d 61 73 74 65 72 2c 20 26 6e 4d 61 73 e(pMaster, &nMas
197a0 74 65 72 4a 6f 75 72 6e 61 6c 29 3b 0a 20 20 69 terJournal);. i
197b0 66 28 20 72 63 21 3d 53 51 4c 49 54 45 5f 4f 4b f( rc!=SQLITE_OK
197c0 20 29 20 67 6f 74 6f 20 64 65 6c 6d 61 73 74 65 ) goto delmaste
197d0 72 5f 6f 75 74 3b 0a 20 20 6e 4d 61 73 74 65 72 r_out;. nMaster
197e0 50 74 72 20 3d 20 70 56 66 73 2d 3e 6d 78 50 61 Ptr = pVfs->mxPa
197f0 74 68 6e 61 6d 65 2b 31 3b 0a 20 20 7a 4d 61 73 thname+1;. zMas
19800 74 65 72 4a 6f 75 72 6e 61 6c 20 3d 20 73 71 6c terJournal = sql
19810 69 74 65 33 4d 61 6c 6c 6f 63 28 6e 4d 61 73 74 ite3Malloc(nMast
19820 65 72 4a 6f 75 72 6e 61 6c 20 2b 20 6e 4d 61 73 erJournal + nMas
19830 74 65 72 50 74 72 20 2b 20 31 29 3b 0a 20 20 69 terPtr + 1);. i
19840 66 28 20 21 7a 4d 61 73 74 65 72 4a 6f 75 72 6e f( !zMasterJourn
19850 61 6c 20 29 7b 0a 20 20 20 20 72 63 20 3d 20 53 al ){. rc = S
19860 51 4c 49 54 45 5f 4e 4f 4d 45 4d 5f 42 4b 50 54 QLITE_NOMEM_BKPT
19870 3b 0a 20 20 20 20 67 6f 74 6f 20 64 65 6c 6d 61 ;. goto delma
19880 73 74 65 72 5f 6f 75 74 3b 0a 20 20 7d 0a 20 20 ster_out;. }.
19890 7a 4d 61 73 74 65 72 50 74 72 20 3d 20 26 7a 4d zMasterPtr = &zM
198a0 61 73 74 65 72 4a 6f 75 72 6e 61 6c 5b 6e 4d 61 asterJournal[nMa
198b0 73 74 65 72 4a 6f 75 72 6e 61 6c 2b 31 5d 3b 0a sterJournal+1];.
198c0 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33 4f 73 rc = sqlite3Os
198d0 52 65 61 64 28 70 4d 61 73 74 65 72 2c 20 7a 4d Read(pMaster, zM
198e0 61 73 74 65 72 4a 6f 75 72 6e 61 6c 2c 20 28 69 asterJournal, (i
198f0 6e 74 29 6e 4d 61 73 74 65 72 4a 6f 75 72 6e 61 nt)nMasterJourna
19900 6c 2c 20 30 29 3b 0a 20 20 69 66 28 20 72 63 21 l, 0);. if( rc!
19910 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 20 67 6f 74 =SQLITE_OK ) got
19920 6f 20 64 65 6c 6d 61 73 74 65 72 5f 6f 75 74 3b o delmaster_out;
19930 0a 20 20 7a 4d 61 73 74 65 72 4a 6f 75 72 6e 61 . zMasterJourna
19940 6c 5b 6e 4d 61 73 74 65 72 4a 6f 75 72 6e 61 6c l[nMasterJournal
19950 5d 20 3d 20 30 3b 0a 0a 20 20 7a 4a 6f 75 72 6e ] = 0;.. zJourn
19960 61 6c 20 3d 20 7a 4d 61 73 74 65 72 4a 6f 75 72 al = zMasterJour
19970 6e 61 6c 3b 0a 20 20 77 68 69 6c 65 28 20 28 7a nal;. while( (z
19980 4a 6f 75 72 6e 61 6c 2d 7a 4d 61 73 74 65 72 4a Journal-zMasterJ
19990 6f 75 72 6e 61 6c 29 3c 6e 4d 61 73 74 65 72 4a ournal)<nMasterJ
199a0 6f 75 72 6e 61 6c 20 29 7b 0a 20 20 20 20 69 6e ournal ){. in
199b0 74 20 65 78 69 73 74 73 3b 0a 20 20 20 20 72 63 t exists;. rc
199c0 20 3d 20 73 71 6c 69 74 65 33 4f 73 41 63 63 65 = sqlite3OsAcce
199d0 73 73 28 70 56 66 73 2c 20 7a 4a 6f 75 72 6e 61 ss(pVfs, zJourna
199e0 6c 2c 20 53 51 4c 49 54 45 5f 41 43 43 45 53 53 l, SQLITE_ACCESS
199f0 5f 45 58 49 53 54 53 2c 20 26 65 78 69 73 74 73 _EXISTS, &exists
19a00 29 3b 0a 20 20 20 20 69 66 28 20 72 63 21 3d 53 );. if( rc!=S
19a10 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 QLITE_OK ){.
19a20 20 20 67 6f 74 6f 20 64 65 6c 6d 61 73 74 65 72 goto delmaster
19a30 5f 6f 75 74 3b 0a 20 20 20 20 7d 0a 20 20 20 20 _out;. }.
19a40 69 66 28 20 65 78 69 73 74 73 20 29 7b 0a 20 20 if( exists ){.
19a50 20 20 20 20 2f 2a 20 4f 6e 65 20 6f 66 20 74 68 /* One of th
19a60 65 20 6a 6f 75 72 6e 61 6c 73 20 70 6f 69 6e 74 e journals point
19a70 65 64 20 74 6f 20 62 79 20 74 68 65 20 6d 61 73 ed to by the mas
19a80 74 65 72 20 6a 6f 75 72 6e 61 6c 20 65 78 69 73 ter journal exis
19a90 74 73 2e 0a 20 20 20 20 20 20 2a 2a 20 4f 70 65 ts.. ** Ope
19aa0 6e 20 69 74 20 61 6e 64 20 63 68 65 63 6b 20 69 n it and check i
19ab0 66 20 69 74 20 70 6f 69 6e 74 73 20 61 74 20 74 f it points at t
19ac0 68 65 20 6d 61 73 74 65 72 20 6a 6f 75 72 6e 61 he master journa
19ad0 6c 2e 20 49 66 0a 20 20 20 20 20 20 2a 2a 20 73 l. If. ** s
19ae0 6f 2c 20 72 65 74 75 72 6e 20 77 69 74 68 6f 75 o, return withou
19af0 74 20 64 65 6c 65 74 69 6e 67 20 74 68 65 20 6d t deleting the m
19b00 61 73 74 65 72 20 6a 6f 75 72 6e 61 6c 20 66 69 aster journal fi
19b10 6c 65 2e 0a 20 20 20 20 20 20 2a 2f 0a 20 20 20 le.. */.
19b20 20 20 20 69 6e 74 20 63 3b 0a 20 20 20 20 20 20 int c;.
19b30 69 6e 74 20 66 6c 61 67 73 20 3d 20 28 53 51 4c int flags = (SQL
19b40 49 54 45 5f 4f 50 45 4e 5f 52 45 41 44 4f 4e 4c ITE_OPEN_READONL
19b50 59 7c 53 51 4c 49 54 45 5f 4f 50 45 4e 5f 4d 41 Y|SQLITE_OPEN_MA
19b60 49 4e 5f 4a 4f 55 52 4e 41 4c 29 3b 0a 20 20 20 IN_JOURNAL);.
19b70 20 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33 4f rc = sqlite3O
19b80 73 4f 70 65 6e 28 70 56 66 73 2c 20 7a 4a 6f 75 sOpen(pVfs, zJou
19b90 72 6e 61 6c 2c 20 70 4a 6f 75 72 6e 61 6c 2c 20 rnal, pJournal,
19ba0 66 6c 61 67 73 2c 20 30 29 3b 0a 20 20 20 20 20 flags, 0);.
19bb0 20 69 66 28 20 72 63 21 3d 53 51 4c 49 54 45 5f if( rc!=SQLITE_
19bc0 4f 4b 20 29 7b 0a 20 20 20 20 20 20 20 20 67 6f OK ){. go
19bd0 74 6f 20 64 65 6c 6d 61 73 74 65 72 5f 6f 75 74 to delmaster_out
19be0 3b 0a 20 20 20 20 20 20 7d 0a 0a 20 20 20 20 20 ;. }..
19bf0 20 72 63 20 3d 20 72 65 61 64 4d 61 73 74 65 72 rc = readMaster
19c00 4a 6f 75 72 6e 61 6c 28 70 4a 6f 75 72 6e 61 6c Journal(pJournal
19c10 2c 20 7a 4d 61 73 74 65 72 50 74 72 2c 20 6e 4d , zMasterPtr, nM
19c20 61 73 74 65 72 50 74 72 29 3b 0a 20 20 20 20 20 asterPtr);.
19c30 20 73 71 6c 69 74 65 33 4f 73 43 6c 6f 73 65 28 sqlite3OsClose(
19c40 70 4a 6f 75 72 6e 61 6c 29 3b 0a 20 20 20 20 20 pJournal);.
19c50 20 69 66 28 20 72 63 21 3d 53 51 4c 49 54 45 5f if( rc!=SQLITE_
19c60 4f 4b 20 29 7b 0a 20 20 20 20 20 20 20 20 67 6f OK ){. go
19c70 74 6f 20 64 65 6c 6d 61 73 74 65 72 5f 6f 75 74 to delmaster_out
19c80 3b 0a 20 20 20 20 20 20 7d 0a 0a 20 20 20 20 20 ;. }..
19c90 20 63 20 3d 20 7a 4d 61 73 74 65 72 50 74 72 5b c = zMasterPtr[
19ca0 30 5d 21 3d 30 20 26 26 20 73 74 72 63 6d 70 28 0]!=0 && strcmp(
19cb0 7a 4d 61 73 74 65 72 50 74 72 2c 20 7a 4d 61 73 zMasterPtr, zMas
19cc0 74 65 72 29 3d 3d 30 3b 0a 20 20 20 20 20 20 69 ter)==0;. i
19cd0 66 28 20 63 20 29 7b 0a 20 20 20 20 20 20 20 20 f( c ){.
19ce0 2f 2a 20 57 65 20 68 61 76 65 20 61 20 6d 61 74 /* We have a mat
19cf0 63 68 2e 20 44 6f 20 6e 6f 74 20 64 65 6c 65 74 ch. Do not delet
19d00 65 20 74 68 65 20 6d 61 73 74 65 72 20 6a 6f 75 e the master jou
19d10 72 6e 61 6c 20 66 69 6c 65 2e 20 2a 2f 0a 20 20 rnal file. */.
19d20 20 20 20 20 20 20 67 6f 74 6f 20 64 65 6c 6d 61 goto delma
19d30 73 74 65 72 5f 6f 75 74 3b 0a 20 20 20 20 20 20 ster_out;.
19d40 7d 0a 20 20 20 20 7d 0a 20 20 20 20 7a 4a 6f 75 }. }. zJou
19d50 72 6e 61 6c 20 2b 3d 20 28 73 71 6c 69 74 65 33 rnal += (sqlite3
19d60 53 74 72 6c 65 6e 33 30 28 7a 4a 6f 75 72 6e 61 Strlen30(zJourna
19d70 6c 29 2b 31 29 3b 0a 20 20 7d 0a 20 0a 20 20 73 l)+1);. }. . s
19d80 71 6c 69 74 65 33 4f 73 43 6c 6f 73 65 28 70 4d qlite3OsClose(pM
19d90 61 73 74 65 72 29 3b 0a 20 20 72 63 20 3d 20 73 aster);. rc = s
19da0 71 6c 69 74 65 33 4f 73 44 65 6c 65 74 65 28 70 qlite3OsDelete(p
19db0 56 66 73 2c 20 7a 4d 61 73 74 65 72 2c 20 30 29 Vfs, zMaster, 0)
19dc0 3b 0a 0a 64 65 6c 6d 61 73 74 65 72 5f 6f 75 74 ;..delmaster_out
19dd0 3a 0a 20 20 73 71 6c 69 74 65 33 5f 66 72 65 65 :. sqlite3_free
19de0 28 7a 4d 61 73 74 65 72 4a 6f 75 72 6e 61 6c 29 (zMasterJournal)
19df0 3b 0a 20 20 69 66 28 20 70 4d 61 73 74 65 72 20 ;. if( pMaster
19e00 29 7b 0a 20 20 20 20 73 71 6c 69 74 65 33 4f 73 ){. sqlite3Os
19e10 43 6c 6f 73 65 28 70 4d 61 73 74 65 72 29 3b 0a Close(pMaster);.
19e20 20 20 20 20 61 73 73 65 72 74 28 20 21 69 73 4f assert( !isO
19e30 70 65 6e 28 70 4a 6f 75 72 6e 61 6c 29 20 29 3b pen(pJournal) );
19e40 0a 20 20 20 20 73 71 6c 69 74 65 33 5f 66 72 65 . sqlite3_fre
19e50 65 28 70 4d 61 73 74 65 72 29 3b 0a 20 20 7d 0a e(pMaster);. }.
19e60 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 7d 0a 0a return rc;.}..
19e70 0a 2f 2a 0a 2a 2a 20 54 68 69 73 20 66 75 6e 63 ./*.** This func
19e80 74 69 6f 6e 20 69 73 20 75 73 65 64 20 74 6f 20 tion is used to
19e90 63 68 61 6e 67 65 20 74 68 65 20 61 63 74 75 61 change the actua
19ea0 6c 20 73 69 7a 65 20 6f 66 20 74 68 65 20 64 61 l size of the da
19eb0 74 61 62 61 73 65 20 0a 2a 2a 20 66 69 6c 65 20 tabase .** file
19ec0 69 6e 20 74 68 65 20 66 69 6c 65 2d 73 79 73 74 in the file-syst
19ed0 65 6d 2e 20 54 68 69 73 20 6f 6e 6c 79 20 68 61 em. This only ha
19ee0 70 70 65 6e 73 20 77 68 65 6e 20 63 6f 6d 6d 69 ppens when commi
19ef0 74 74 69 6e 67 20 61 20 74 72 61 6e 73 61 63 74 tting a transact
19f00 69 6f 6e 2c 0a 2a 2a 20 6f 72 20 72 6f 6c 6c 69 ion,.** or rolli
19f10 6e 67 20 62 61 63 6b 20 61 20 74 72 61 6e 73 61 ng back a transa
19f20 63 74 69 6f 6e 20 28 69 6e 63 6c 75 64 69 6e 67 ction (including
19f30 20 72 6f 6c 6c 69 6e 67 20 62 61 63 6b 20 61 20 rolling back a
19f40 68 6f 74 2d 6a 6f 75 72 6e 61 6c 29 2e 0a 2a 2a hot-journal)..**
19f50 0a 2a 2a 20 49 66 20 74 68 65 20 6d 61 69 6e 20 .** If the main
19f60 64 61 74 61 62 61 73 65 20 66 69 6c 65 20 69 73 database file is
19f70 20 6e 6f 74 20 6f 70 65 6e 2c 20 6f 72 20 74 68 not open, or th
19f80 65 20 70 61 67 65 72 20 69 73 20 6e 6f 74 20 69 e pager is not i
19f90 6e 20 65 69 74 68 65 72 0a 2a 2a 20 44 42 4d 4f n either.** DBMO
19fa0 44 20 6f 72 20 4f 50 45 4e 20 73 74 61 74 65 2c D or OPEN state,
19fb0 20 74 68 69 73 20 66 75 6e 63 74 69 6f 6e 20 69 this function i
19fc0 73 20 61 20 6e 6f 2d 6f 70 2e 20 4f 74 68 65 72 s a no-op. Other
19fd0 77 69 73 65 2c 20 74 68 65 20 73 69 7a 65 20 0a wise, the size .
19fe0 2a 2a 20 6f 66 20 74 68 65 20 66 69 6c 65 20 69 ** of the file i
19ff0 73 20 63 68 61 6e 67 65 64 20 74 6f 20 6e 50 61 s changed to nPa
1a000 67 65 20 70 61 67 65 73 20 28 6e 50 61 67 65 2a ge pages (nPage*
1a010 70 50 61 67 65 72 2d 3e 70 61 67 65 53 69 7a 65 pPager->pageSize
1a020 20 62 79 74 65 73 29 2e 20 0a 2a 2a 20 49 66 20 bytes). .** If
1a030 74 68 65 20 66 69 6c 65 20 6f 6e 20 64 69 73 6b the file on disk
1a040 20 69 73 20 63 75 72 72 65 6e 74 6c 79 20 6c 61 is currently la
1a050 72 67 65 72 20 74 68 61 6e 20 6e 50 61 67 65 20 rger than nPage
1a060 70 61 67 65 73 2c 20 74 68 65 6e 20 75 73 65 20 pages, then use
1a070 74 68 65 20 56 46 53 0a 2a 2a 20 78 54 72 75 6e the VFS.** xTrun
1a080 63 61 74 65 28 29 20 6d 65 74 68 6f 64 20 74 6f cate() method to
1a090 20 74 72 75 6e 63 61 74 65 20 69 74 2e 0a 2a 2a truncate it..**
1a0a0 0a 2a 2a 20 4f 72 2c 20 69 74 20 6d 69 67 68 74 .** Or, it might
1a0b0 20 62 65 20 74 68 65 20 63 61 73 65 20 74 68 61 be the case tha
1a0c0 74 20 74 68 65 20 66 69 6c 65 20 6f 6e 20 64 69 t the file on di
1a0d0 73 6b 20 69 73 20 73 6d 61 6c 6c 65 72 20 74 68 sk is smaller th
1a0e0 61 6e 20 0a 2a 2a 20 6e 50 61 67 65 20 70 61 67 an .** nPage pag
1a0f0 65 73 2e 20 53 6f 6d 65 20 6f 70 65 72 61 74 69 es. Some operati
1a100 6e 67 20 73 79 73 74 65 6d 20 69 6d 70 6c 65 6d ng system implem
1a110 65 6e 74 61 74 69 6f 6e 73 20 63 61 6e 20 67 65 entations can ge
1a120 74 20 63 6f 6e 66 75 73 65 64 20 69 66 20 0a 2a t confused if .*
1a130 2a 20 79 6f 75 20 74 72 79 20 74 6f 20 74 72 75 * you try to tru
1a140 6e 63 61 74 65 20 61 20 66 69 6c 65 20 74 6f 20 ncate a file to
1a150 73 6f 6d 65 20 73 69 7a 65 20 74 68 61 74 20 69 some size that i
1a160 73 20 6c 61 72 67 65 72 20 74 68 61 6e 20 69 74 s larger than it
1a170 20 0a 2a 2a 20 63 75 72 72 65 6e 74 6c 79 20 69 .** currently i
1a180 73 2c 20 73 6f 20 64 65 74 65 63 74 20 74 68 69 s, so detect thi
1a190 73 20 63 61 73 65 20 61 6e 64 20 77 72 69 74 65 s case and write
1a1a0 20 61 20 73 69 6e 67 6c 65 20 7a 65 72 6f 20 62 a single zero b
1a1b0 79 74 65 20 74 6f 20 0a 2a 2a 20 74 68 65 20 65 yte to .** the e
1a1c0 6e 64 20 6f 66 20 74 68 65 20 6e 65 77 20 66 69 nd of the new fi
1a1d0 6c 65 20 69 6e 73 74 65 61 64 2e 0a 2a 2a 0a 2a le instead..**.*
1a1e0 2a 20 49 66 20 73 75 63 63 65 73 73 66 75 6c 2c * If successful,
1a1f0 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f return SQLITE_O
1a200 4b 2e 20 49 66 20 61 6e 20 49 4f 20 65 72 72 6f K. If an IO erro
1a210 72 20 6f 63 63 75 72 73 20 77 68 69 6c 65 20 6d r occurs while m
1a220 6f 64 69 66 79 69 6e 67 0a 2a 2a 20 74 68 65 20 odifying.** the
1a230 64 61 74 61 62 61 73 65 20 66 69 6c 65 2c 20 72 database file, r
1a240 65 74 75 72 6e 20 74 68 65 20 65 72 72 6f 72 20 eturn the error
1a250 63 6f 64 65 20 74 6f 20 74 68 65 20 63 61 6c 6c code to the call
1a260 65 72 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e er..*/.static in
1a270 74 20 70 61 67 65 72 5f 74 72 75 6e 63 61 74 65 t pager_truncate
1a280 28 50 61 67 65 72 20 2a 70 50 61 67 65 72 2c 20 (Pager *pPager,
1a290 50 67 6e 6f 20 6e 50 61 67 65 29 7b 0a 20 20 69 Pgno nPage){. i
1a2a0 6e 74 20 72 63 20 3d 20 53 51 4c 49 54 45 5f 4f nt rc = SQLITE_O
1a2b0 4b 3b 0a 20 20 61 73 73 65 72 74 28 20 70 50 61 K;. assert( pPa
1a2c0 67 65 72 2d 3e 65 53 74 61 74 65 21 3d 50 41 47 ger->eState!=PAG
1a2d0 45 52 5f 45 52 52 4f 52 20 29 3b 0a 20 20 61 73 ER_ERROR );. as
1a2e0 73 65 72 74 28 20 70 50 61 67 65 72 2d 3e 65 53 sert( pPager->eS
1a2f0 74 61 74 65 21 3d 50 41 47 45 52 5f 52 45 41 44 tate!=PAGER_READ
1a300 45 52 20 29 3b 0a 20 20 0a 20 20 69 66 28 20 69 ER );. . if( i
1a310 73 4f 70 65 6e 28 70 50 61 67 65 72 2d 3e 66 64 sOpen(pPager->fd
1a320 29 20 0a 20 20 20 26 26 20 28 70 50 61 67 65 72 ) . && (pPager
1a330 2d 3e 65 53 74 61 74 65 3e 3d 50 41 47 45 52 5f ->eState>=PAGER_
1a340 57 52 49 54 45 52 5f 44 42 4d 4f 44 20 7c 7c 20 WRITER_DBMOD ||
1a350 70 50 61 67 65 72 2d 3e 65 53 74 61 74 65 3d 3d pPager->eState==
1a360 50 41 47 45 52 5f 4f 50 45 4e 29 20 0a 20 20 29 PAGER_OPEN) . )
1a370 7b 0a 20 20 20 20 69 36 34 20 63 75 72 72 65 6e {. i64 curren
1a380 74 53 69 7a 65 2c 20 6e 65 77 53 69 7a 65 3b 0a tSize, newSize;.
1a390 20 20 20 20 69 6e 74 20 73 7a 50 61 67 65 20 3d int szPage =
1a3a0 20 70 50 61 67 65 72 2d 3e 70 61 67 65 53 69 7a pPager->pageSiz
1a3b0 65 3b 0a 20 20 20 20 61 73 73 65 72 74 28 20 70 e;. assert( p
1a3c0 50 61 67 65 72 2d 3e 65 4c 6f 63 6b 3d 3d 45 58 Pager->eLock==EX
1a3d0 43 4c 55 53 49 56 45 5f 4c 4f 43 4b 20 29 3b 0a CLUSIVE_LOCK );.
1a3e0 20 20 20 20 2f 2a 20 54 4f 44 4f 3a 20 49 73 20 /* TODO: Is
1a3f0 69 74 20 73 61 66 65 20 74 6f 20 75 73 65 20 50 it safe to use P
1a400 61 67 65 72 2e 64 62 46 69 6c 65 53 69 7a 65 20 ager.dbFileSize
1a410 68 65 72 65 3f 20 2a 2f 0a 20 20 20 20 72 63 20 here? */. rc
1a420 3d 20 73 71 6c 69 74 65 33 4f 73 46 69 6c 65 53 = sqlite3OsFileS
1a430 69 7a 65 28 70 50 61 67 65 72 2d 3e 66 64 2c 20 ize(pPager->fd,
1a440 26 63 75 72 72 65 6e 74 53 69 7a 65 29 3b 0a 20 ¤tSize);.
1a450 20 20 20 6e 65 77 53 69 7a 65 20 3d 20 73 7a 50 newSize = szP
1a460 61 67 65 2a 28 69 36 34 29 6e 50 61 67 65 3b 0a age*(i64)nPage;.
1a470 20 20 20 20 69 66 28 20 72 63 3d 3d 53 51 4c 49 if( rc==SQLI
1a480 54 45 5f 4f 4b 20 26 26 20 63 75 72 72 65 6e 74 TE_OK && current
1a490 53 69 7a 65 21 3d 6e 65 77 53 69 7a 65 20 29 7b Size!=newSize ){
1a4a0 0a 20 20 20 20 20 20 69 66 28 20 63 75 72 72 65 . if( curre
1a4b0 6e 74 53 69 7a 65 3e 6e 65 77 53 69 7a 65 20 29 ntSize>newSize )
1a4c0 7b 0a 20 20 20 20 20 20 20 20 72 63 20 3d 20 73 {. rc = s
1a4d0 71 6c 69 74 65 33 4f 73 54 72 75 6e 63 61 74 65 qlite3OsTruncate
1a4e0 28 70 50 61 67 65 72 2d 3e 66 64 2c 20 6e 65 77 (pPager->fd, new
1a4f0 53 69 7a 65 29 3b 0a 20 20 20 20 20 20 7d 65 6c Size);. }el
1a500 73 65 20 69 66 28 20 28 63 75 72 72 65 6e 74 53 se if( (currentS
1a510 69 7a 65 2b 73 7a 50 61 67 65 29 3c 3d 6e 65 77 ize+szPage)<=new
1a520 53 69 7a 65 20 29 7b 0a 20 20 20 20 20 20 20 20 Size ){.
1a530 63 68 61 72 20 2a 70 54 6d 70 20 3d 20 70 50 61 char *pTmp = pPa
1a540 67 65 72 2d 3e 70 54 6d 70 53 70 61 63 65 3b 0a ger->pTmpSpace;.
1a550 20 20 20 20 20 20 20 20 6d 65 6d 73 65 74 28 70 memset(p
1a560 54 6d 70 2c 20 30 2c 20 73 7a 50 61 67 65 29 3b Tmp, 0, szPage);
1a570 0a 20 20 20 20 20 20 20 20 74 65 73 74 63 61 73 . testcas
1a580 65 28 20 28 6e 65 77 53 69 7a 65 2d 73 7a 50 61 e( (newSize-szPa
1a590 67 65 29 20 3d 3d 20 63 75 72 72 65 6e 74 53 69 ge) == currentSi
1a5a0 7a 65 20 29 3b 0a 20 20 20 20 20 20 20 20 74 65 ze );. te
1a5b0 73 74 63 61 73 65 28 20 28 6e 65 77 53 69 7a 65 stcase( (newSize
1a5c0 2d 73 7a 50 61 67 65 29 20 3e 20 20 63 75 72 72 -szPage) > curr
1a5d0 65 6e 74 53 69 7a 65 20 29 3b 0a 20 20 20 20 20 entSize );.
1a5e0 20 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33 4f rc = sqlite3O
1a5f0 73 57 72 69 74 65 28 70 50 61 67 65 72 2d 3e 66 sWrite(pPager->f
1a600 64 2c 20 70 54 6d 70 2c 20 73 7a 50 61 67 65 2c d, pTmp, szPage,
1a610 20 6e 65 77 53 69 7a 65 2d 73 7a 50 61 67 65 29 newSize-szPage)
1a620 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 ;. }.
1a630 69 66 28 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4f if( rc==SQLITE_O
1a640 4b 20 29 7b 0a 20 20 20 20 20 20 20 20 70 50 61 K ){. pPa
1a650 67 65 72 2d 3e 64 62 46 69 6c 65 53 69 7a 65 20 ger->dbFileSize
1a660 3d 20 6e 50 61 67 65 3b 0a 20 20 20 20 20 20 7d = nPage;. }
1a670 0a 20 20 20 20 7d 0a 20 20 7d 0a 20 20 72 65 74 . }. }. ret
1a680 75 72 6e 20 72 63 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a urn rc;.}../*.**
1a690 20 52 65 74 75 72 6e 20 61 20 73 61 6e 69 74 69 Return a saniti
1a6a0 7a 65 64 20 76 65 72 73 69 6f 6e 20 6f 66 20 74 zed version of t
1a6b0 68 65 20 73 65 63 74 6f 72 2d 73 69 7a 65 20 6f he sector-size o
1a6c0 66 20 4f 53 20 66 69 6c 65 20 70 46 69 6c 65 2e f OS file pFile.
1a6d0 20 54 68 65 0a 2a 2a 20 72 65 74 75 72 6e 20 76 The.** return v
1a6e0 61 6c 75 65 20 69 73 20 67 75 61 72 61 6e 74 65 alue is guarante
1a6f0 65 64 20 74 6f 20 6c 69 65 20 62 65 74 77 65 65 ed to lie betwee
1a700 6e 20 33 32 20 61 6e 64 20 4d 41 58 5f 53 45 43 n 32 and MAX_SEC
1a710 54 4f 52 5f 53 49 5a 45 2e 0a 2a 2f 0a 69 6e 74 TOR_SIZE..*/.int
1a720 20 73 71 6c 69 74 65 33 53 65 63 74 6f 72 53 69 sqlite3SectorSi
1a730 7a 65 28 73 71 6c 69 74 65 33 5f 66 69 6c 65 20 ze(sqlite3_file
1a740 2a 70 46 69 6c 65 29 7b 0a 20 20 69 6e 74 20 69 *pFile){. int i
1a750 52 65 74 20 3d 20 73 71 6c 69 74 65 33 4f 73 53 Ret = sqlite3OsS
1a760 65 63 74 6f 72 53 69 7a 65 28 70 46 69 6c 65 29 ectorSize(pFile)
1a770 3b 0a 20 20 69 66 28 20 69 52 65 74 3c 33 32 20 ;. if( iRet<32
1a780 29 7b 0a 20 20 20 20 69 52 65 74 20 3d 20 35 31 ){. iRet = 51
1a790 32 3b 0a 20 20 7d 65 6c 73 65 20 69 66 28 20 69 2;. }else if( i
1a7a0 52 65 74 3e 4d 41 58 5f 53 45 43 54 4f 52 5f 53 Ret>MAX_SECTOR_S
1a7b0 49 5a 45 20 29 7b 0a 20 20 20 20 61 73 73 65 72 IZE ){. asser
1a7c0 74 28 20 4d 41 58 5f 53 45 43 54 4f 52 5f 53 49 t( MAX_SECTOR_SI
1a7d0 5a 45 3e 3d 35 31 32 20 29 3b 0a 20 20 20 20 69 ZE>=512 );. i
1a7e0 52 65 74 20 3d 20 4d 41 58 5f 53 45 43 54 4f 52 Ret = MAX_SECTOR
1a7f0 5f 53 49 5a 45 3b 0a 20 20 7d 0a 20 20 72 65 74 _SIZE;. }. ret
1a800 75 72 6e 20 69 52 65 74 3b 0a 7d 0a 0a 2f 2a 0a urn iRet;.}../*.
1a810 2a 2a 20 53 65 74 20 74 68 65 20 76 61 6c 75 65 ** Set the value
1a820 20 6f 66 20 74 68 65 20 50 61 67 65 72 2e 73 65 of the Pager.se
1a830 63 74 6f 72 53 69 7a 65 20 76 61 72 69 61 62 6c ctorSize variabl
1a840 65 20 66 6f 72 20 74 68 65 20 67 69 76 65 6e 0a e for the given.
1a850 2a 2a 20 70 61 67 65 72 20 62 61 73 65 64 20 6f ** pager based o
1a860 6e 20 74 68 65 20 76 61 6c 75 65 20 72 65 74 75 n the value retu
1a870 72 6e 65 64 20 62 79 20 74 68 65 20 78 53 65 63 rned by the xSec
1a880 74 6f 72 53 69 7a 65 20 6d 65 74 68 6f 64 0a 2a torSize method.*
1a890 2a 20 6f 66 20 74 68 65 20 6f 70 65 6e 20 64 61 * of the open da
1a8a0 74 61 62 61 73 65 20 66 69 6c 65 2e 20 54 68 65 tabase file. The
1a8b0 20 73 65 63 74 6f 72 20 73 69 7a 65 20 77 69 6c sector size wil
1a8c0 6c 20 62 65 20 75 73 65 64 20 0a 2a 2a 20 74 6f l be used .** to
1a8d0 20 64 65 74 65 72 6d 69 6e 65 20 74 68 65 20 73 determine the s
1a8e0 69 7a 65 20 61 6e 64 20 61 6c 69 67 6e 6d 65 6e ize and alignmen
1a8f0 74 20 6f 66 20 6a 6f 75 72 6e 61 6c 20 68 65 61 t of journal hea
1a900 64 65 72 20 61 6e 64 20 0a 2a 2a 20 6d 61 73 74 der and .** mast
1a910 65 72 20 6a 6f 75 72 6e 61 6c 20 70 6f 69 6e 74 er journal point
1a920 65 72 73 20 77 69 74 68 69 6e 20 63 72 65 61 74 ers within creat
1a930 65 64 20 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 73 ed journal files
1a940 2e 0a 2a 2a 0a 2a 2a 20 46 6f 72 20 74 65 6d 70 ..**.** For temp
1a950 6f 72 61 72 79 20 66 69 6c 65 73 20 74 68 65 20 orary files the
1a960 65 66 66 65 63 74 69 76 65 20 73 65 63 74 6f 72 effective sector
1a970 20 73 69 7a 65 20 69 73 20 61 6c 77 61 79 73 20 size is always
1a980 35 31 32 20 62 79 74 65 73 2e 0a 2a 2a 0a 2a 2a 512 bytes..**.**
1a990 20 4f 74 68 65 72 77 69 73 65 2c 20 66 6f 72 20 Otherwise, for
1a9a0 6e 6f 6e 2d 74 65 6d 70 6f 72 61 72 79 20 66 69 non-temporary fi
1a9b0 6c 65 73 2c 20 74 68 65 20 65 66 66 65 63 74 69 les, the effecti
1a9c0 76 65 20 73 65 63 74 6f 72 20 73 69 7a 65 20 69 ve sector size i
1a9d0 73 0a 2a 2a 20 74 68 65 20 76 61 6c 75 65 20 72 s.** the value r
1a9e0 65 74 75 72 6e 65 64 20 62 79 20 74 68 65 20 78 eturned by the x
1a9f0 53 65 63 74 6f 72 53 69 7a 65 28 29 20 6d 65 74 SectorSize() met
1aa00 68 6f 64 20 72 6f 75 6e 64 65 64 20 75 70 20 74 hod rounded up t
1aa10 6f 20 33 32 20 69 66 0a 2a 2a 20 69 74 20 69 73 o 32 if.** it is
1aa20 20 6c 65 73 73 20 74 68 61 6e 20 33 32 2c 20 6f less than 32, o
1aa30 72 20 72 6f 75 6e 64 65 64 20 64 6f 77 6e 20 74 r rounded down t
1aa40 6f 20 4d 41 58 5f 53 45 43 54 4f 52 5f 53 49 5a o MAX_SECTOR_SIZ
1aa50 45 20 69 66 20 69 74 0a 2a 2a 20 69 73 20 67 72 E if it.** is gr
1aa60 65 61 74 65 72 20 74 68 61 6e 20 4d 41 58 5f 53 eater than MAX_S
1aa70 45 43 54 4f 52 5f 53 49 5a 45 2e 0a 2a 2a 0a 2a ECTOR_SIZE..**.*
1aa80 2a 20 49 66 20 74 68 65 20 66 69 6c 65 20 68 61 * If the file ha
1aa90 73 20 74 68 65 20 53 51 4c 49 54 45 5f 49 4f 43 s the SQLITE_IOC
1aaa0 41 50 5f 50 4f 57 45 52 53 41 46 45 5f 4f 56 45 AP_POWERSAFE_OVE
1aab0 52 57 52 49 54 45 20 70 72 6f 70 65 72 74 79 2c RWRITE property,
1aac0 20 74 68 65 6e 20 73 65 74 0a 2a 2a 20 74 68 65 then set.** the
1aad0 20 65 66 66 65 63 74 69 76 65 20 73 65 63 74 6f effective secto
1aae0 72 20 73 69 7a 65 20 74 6f 20 69 74 73 20 6d 69 r size to its mi
1aaf0 6e 69 6d 75 6d 20 76 61 6c 75 65 20 28 35 31 32 nimum value (512
1ab00 29 2e 20 20 54 68 65 20 70 75 72 70 6f 73 65 20 ). The purpose
1ab10 6f 66 0a 2a 2a 20 70 50 61 67 65 72 2d 3e 73 65 of.** pPager->se
1ab20 63 74 6f 72 53 69 7a 65 20 69 73 20 74 6f 20 64 ctorSize is to d
1ab30 65 66 69 6e 65 20 74 68 65 20 22 62 6c 61 73 74 efine the "blast
1ab40 20 72 61 64 69 75 73 22 20 6f 66 20 62 79 74 65 radius" of byte
1ab50 73 20 74 68 61 74 0a 2a 2a 20 6d 69 67 68 74 20 s that.** might
1ab60 63 68 61 6e 67 65 20 69 66 20 61 20 63 72 61 73 change if a cras
1ab70 68 20 6f 63 63 75 72 73 20 77 68 69 6c 65 20 77 h occurs while w
1ab80 72 69 74 69 6e 67 20 74 6f 20 61 20 73 69 6e 67 riting to a sing
1ab90 6c 65 20 62 79 74 65 20 69 6e 0a 2a 2a 20 74 68 le byte in.** th
1aba0 61 74 20 72 61 6e 67 65 2e 20 20 42 75 74 20 77 at range. But w
1abb0 69 74 68 20 50 4f 57 45 52 53 41 46 45 5f 4f 56 ith POWERSAFE_OV
1abc0 45 52 57 52 49 54 45 2c 20 74 68 65 20 62 6c 61 ERWRITE, the bla
1abd0 73 74 20 72 61 64 69 75 73 20 69 73 20 7a 65 72 st radius is zer
1abe0 6f 0a 2a 2a 20 28 74 68 61 74 20 69 73 20 77 68 o.** (that is wh
1abf0 61 74 20 50 4f 57 45 52 53 41 46 45 5f 4f 56 45 at POWERSAFE_OVE
1ac00 52 57 52 49 54 45 20 6d 65 61 6e 73 29 2c 20 73 RWRITE means), s
1ac10 6f 20 77 65 20 6d 69 6e 69 6d 69 7a 65 20 74 68 o we minimize th
1ac20 65 20 73 65 63 74 6f 72 0a 2a 2a 20 73 69 7a 65 e sector.** size
1ac30 2e 20 20 46 6f 72 20 62 61 63 6b 77 61 72 64 73 . For backwards
1ac40 20 63 6f 6d 70 61 74 69 62 69 6c 69 74 79 20 6f compatibility o
1ac50 66 20 74 68 65 20 72 6f 6c 6c 62 61 63 6b 20 6a f the rollback j
1ac60 6f 75 72 6e 61 6c 20 66 69 6c 65 20 66 6f 72 6d ournal file form
1ac70 61 74 2c 0a 2a 2a 20 77 65 20 63 61 6e 6e 6f 74 at,.** we cannot
1ac80 20 72 65 64 75 63 65 20 74 68 65 20 65 66 66 65 reduce the effe
1ac90 63 74 69 76 65 20 73 65 63 74 6f 72 20 73 69 7a ctive sector siz
1aca0 65 20 62 65 6c 6f 77 20 35 31 32 2e 0a 2a 2f 0a e below 512..*/.
1acb0 73 74 61 74 69 63 20 76 6f 69 64 20 73 65 74 53 static void setS
1acc0 65 63 74 6f 72 53 69 7a 65 28 50 61 67 65 72 20 ectorSize(Pager
1acd0 2a 70 50 61 67 65 72 29 7b 0a 20 20 61 73 73 65 *pPager){. asse
1ace0 72 74 28 20 69 73 4f 70 65 6e 28 70 50 61 67 65 rt( isOpen(pPage
1acf0 72 2d 3e 66 64 29 20 7c 7c 20 70 50 61 67 65 72 r->fd) || pPager
1ad00 2d 3e 74 65 6d 70 46 69 6c 65 20 29 3b 0a 0a 20 ->tempFile );..
1ad10 20 69 66 28 20 70 50 61 67 65 72 2d 3e 74 65 6d if( pPager->tem
1ad20 70 46 69 6c 65 0a 20 20 20 7c 7c 20 28 73 71 6c pFile. || (sql
1ad30 69 74 65 33 4f 73 44 65 76 69 63 65 43 68 61 72 ite3OsDeviceChar
1ad40 61 63 74 65 72 69 73 74 69 63 73 28 70 50 61 67 acteristics(pPag
1ad50 65 72 2d 3e 66 64 29 20 26 20 0a 20 20 20 20 20 er->fd) & .
1ad60 20 20 20 20 20 20 20 20 20 53 51 4c 49 54 45 5f SQLITE_
1ad70 49 4f 43 41 50 5f 50 4f 57 45 52 53 41 46 45 5f IOCAP_POWERSAFE_
1ad80 4f 56 45 52 57 52 49 54 45 29 21 3d 30 0a 20 20 OVERWRITE)!=0.
1ad90 29 7b 0a 20 20 20 20 2f 2a 20 53 65 63 74 6f 72 ){. /* Sector
1ada0 20 73 69 7a 65 20 64 6f 65 73 6e 27 74 20 6d 61 size doesn't ma
1adb0 74 74 65 72 20 66 6f 72 20 74 65 6d 70 6f 72 61 tter for tempora
1adc0 72 79 20 66 69 6c 65 73 2e 20 41 6c 73 6f 2c 20 ry files. Also,
1add0 74 68 65 20 66 69 6c 65 0a 20 20 20 20 2a 2a 20 the file. **
1ade0 6d 61 79 20 6e 6f 74 20 68 61 76 65 20 62 65 65 may not have bee
1adf0 6e 20 6f 70 65 6e 65 64 20 79 65 74 2c 20 69 6e n opened yet, in
1ae00 20 77 68 69 63 68 20 63 61 73 65 20 74 68 65 20 which case the
1ae10 4f 73 53 65 63 74 6f 72 53 69 7a 65 28 29 0a 20 OsSectorSize().
1ae20 20 20 20 2a 2a 20 63 61 6c 6c 20 77 69 6c 6c 20 ** call will
1ae30 73 65 67 66 61 75 6c 74 2e 20 2a 2f 0a 20 20 20 segfault. */.
1ae40 20 70 50 61 67 65 72 2d 3e 73 65 63 74 6f 72 53 pPager->sectorS
1ae50 69 7a 65 20 3d 20 35 31 32 3b 0a 20 20 7d 65 6c ize = 512;. }el
1ae60 73 65 7b 0a 20 20 20 20 70 50 61 67 65 72 2d 3e se{. pPager->
1ae70 73 65 63 74 6f 72 53 69 7a 65 20 3d 20 73 71 6c sectorSize = sql
1ae80 69 74 65 33 53 65 63 74 6f 72 53 69 7a 65 28 70 ite3SectorSize(p
1ae90 50 61 67 65 72 2d 3e 66 64 29 3b 0a 20 20 7d 0a Pager->fd);. }.
1aea0 7d 0a 0a 2f 2a 0a 2a 2a 20 50 6c 61 79 62 61 63 }../*.** Playbac
1aeb0 6b 20 74 68 65 20 6a 6f 75 72 6e 61 6c 20 61 6e k the journal an
1aec0 64 20 74 68 75 73 20 72 65 73 74 6f 72 65 20 74 d thus restore t
1aed0 68 65 20 64 61 74 61 62 61 73 65 20 66 69 6c 65 he database file
1aee0 20 74 6f 0a 2a 2a 20 74 68 65 20 73 74 61 74 65 to.** the state
1aef0 20 69 74 20 77 61 73 20 69 6e 20 62 65 66 6f 72 it was in befor
1af00 65 20 77 65 20 73 74 61 72 74 65 64 20 6d 61 6b e we started mak
1af10 69 6e 67 20 63 68 61 6e 67 65 73 2e 20 20 0a 2a ing changes. .*
1af20 2a 0a 2a 2a 20 54 68 65 20 6a 6f 75 72 6e 61 6c *.** The journal
1af30 20 66 69 6c 65 20 66 6f 72 6d 61 74 20 69 73 20 file format is
1af40 61 73 20 66 6f 6c 6c 6f 77 73 3a 20 0a 2a 2a 0a as follows: .**.
1af50 2a 2a 20 20 28 31 29 20 20 38 20 62 79 74 65 20 ** (1) 8 byte
1af60 70 72 65 66 69 78 2e 20 20 41 20 63 6f 70 79 20 prefix. A copy
1af70 6f 66 20 61 4a 6f 75 72 6e 61 6c 4d 61 67 69 63 of aJournalMagic
1af80 5b 5d 2e 0a 2a 2a 20 20 28 32 29 20 20 34 20 62 []..** (2) 4 b
1af90 79 74 65 20 62 69 67 2d 65 6e 64 69 61 6e 20 69 yte big-endian i
1afa0 6e 74 65 67 65 72 20 77 68 69 63 68 20 69 73 20 nteger which is
1afb0 74 68 65 20 6e 75 6d 62 65 72 20 6f 66 20 76 61 the number of va
1afc0 6c 69 64 20 70 61 67 65 20 72 65 63 6f 72 64 73 lid page records
1afd0 0a 2a 2a 20 20 20 20 20 20 20 69 6e 20 74 68 65 .** in the
1afe0 20 6a 6f 75 72 6e 61 6c 2e 20 20 49 66 20 74 68 journal. If th
1aff0 69 73 20 76 61 6c 75 65 20 69 73 20 30 78 66 66 is value is 0xff
1b000 66 66 66 66 66 66 2c 20 74 68 65 6e 20 63 6f 6d ffffff, then com
1b010 70 75 74 65 20 74 68 65 0a 2a 2a 20 20 20 20 20 pute the.**
1b020 20 20 6e 75 6d 62 65 72 20 6f 66 20 70 61 67 65 number of page
1b030 20 72 65 63 6f 72 64 73 20 66 72 6f 6d 20 74 68 records from th
1b040 65 20 6a 6f 75 72 6e 61 6c 20 73 69 7a 65 2e 0a e journal size..
1b050 2a 2a 20 20 28 33 29 20 20 34 20 62 79 74 65 20 ** (3) 4 byte
1b060 62 69 67 2d 65 6e 64 69 61 6e 20 69 6e 74 65 67 big-endian integ
1b070 65 72 20 77 68 69 63 68 20 69 73 20 74 68 65 20 er which is the
1b080 69 6e 69 74 69 61 6c 20 76 61 6c 75 65 20 66 6f initial value fo
1b090 72 20 74 68 65 20 0a 2a 2a 20 20 20 20 20 20 20 r the .**
1b0a0 73 61 6e 69 74 79 20 63 68 65 63 6b 73 75 6d 2e sanity checksum.
1b0b0 0a 2a 2a 20 20 28 34 29 20 20 34 20 62 79 74 65 .** (4) 4 byte
1b0c0 20 69 6e 74 65 67 65 72 20 77 68 69 63 68 20 69 integer which i
1b0d0 73 20 74 68 65 20 6e 75 6d 62 65 72 20 6f 66 20 s the number of
1b0e0 70 61 67 65 73 20 74 6f 20 74 72 75 6e 63 61 74 pages to truncat
1b0f0 65 20 74 68 65 0a 2a 2a 20 20 20 20 20 20 20 64 e the.** d
1b100 61 74 61 62 61 73 65 20 74 6f 20 64 75 72 69 6e atabase to durin
1b110 67 20 61 20 72 6f 6c 6c 62 61 63 6b 2e 0a 2a 2a g a rollback..**
1b120 20 20 28 35 29 20 20 34 20 62 79 74 65 20 62 69 (5) 4 byte bi
1b130 67 2d 65 6e 64 69 61 6e 20 69 6e 74 65 67 65 72 g-endian integer
1b140 20 77 68 69 63 68 20 69 73 20 74 68 65 20 73 65 which is the se
1b150 63 74 6f 72 20 73 69 7a 65 2e 20 20 54 68 65 20 ctor size. The
1b160 68 65 61 64 65 72 0a 2a 2a 20 20 20 20 20 20 20 header.**
1b170 69 73 20 74 68 69 73 20 6d 61 6e 79 20 62 79 74 is this many byt
1b180 65 73 20 69 6e 20 73 69 7a 65 2e 0a 2a 2a 20 20 es in size..**
1b190 28 36 29 20 20 34 20 62 79 74 65 20 62 69 67 2d (6) 4 byte big-
1b1a0 65 6e 64 69 61 6e 20 69 6e 74 65 67 65 72 20 77 endian integer w
1b1b0 68 69 63 68 20 69 73 20 74 68 65 20 70 61 67 65 hich is the page
1b1c0 20 73 69 7a 65 2e 0a 2a 2a 20 20 28 37 29 20 20 size..** (7)
1b1d0 7a 65 72 6f 20 70 61 64 64 69 6e 67 20 6f 75 74 zero padding out
1b1e0 20 74 6f 20 74 68 65 20 6e 65 78 74 20 73 65 63 to the next sec
1b1f0 74 6f 72 20 73 69 7a 65 2e 0a 2a 2a 20 20 28 38 tor size..** (8
1b200 29 20 20 5a 65 72 6f 20 6f 72 20 6d 6f 72 65 20 ) Zero or more
1b210 70 61 67 65 73 20 69 6e 73 74 61 6e 63 65 73 2c pages instances,
1b220 20 65 61 63 68 20 61 73 20 66 6f 6c 6c 6f 77 73 each as follows
1b230 3a 0a 2a 2a 20 20 20 20 20 20 20 20 2b 20 20 34 :.** + 4
1b240 20 62 79 74 65 20 70 61 67 65 20 6e 75 6d 62 65 byte page numbe
1b250 72 2e 0a 2a 2a 20 20 20 20 20 20 20 20 2b 20 20 r..** +
1b260 70 50 61 67 65 72 2d 3e 70 61 67 65 53 69 7a 65 pPager->pageSize
1b270 20 62 79 74 65 73 20 6f 66 20 64 61 74 61 2e 0a bytes of data..
1b280 2a 2a 20 20 20 20 20 20 20 20 2b 20 20 34 20 62 ** + 4 b
1b290 79 74 65 20 63 68 65 63 6b 73 75 6d 0a 2a 2a 0a yte checksum.**.
1b2a0 2a 2a 20 57 68 65 6e 20 77 65 20 73 70 65 61 6b ** When we speak
1b2b0 20 6f 66 20 74 68 65 20 6a 6f 75 72 6e 61 6c 20 of the journal
1b2c0 68 65 61 64 65 72 2c 20 77 65 20 6d 65 61 6e 20 header, we mean
1b2d0 74 68 65 20 66 69 72 73 74 20 37 20 69 74 65 6d the first 7 item
1b2e0 73 20 61 62 6f 76 65 2e 0a 2a 2a 20 45 61 63 68 s above..** Each
1b2f0 20 65 6e 74 72 79 20 69 6e 20 74 68 65 20 6a 6f entry in the jo
1b300 75 72 6e 61 6c 20 69 73 20 61 6e 20 69 6e 73 74 urnal is an inst
1b310 61 6e 63 65 20 6f 66 20 74 68 65 20 38 74 68 20 ance of the 8th
1b320 69 74 65 6d 2e 0a 2a 2a 0a 2a 2a 20 43 61 6c 6c item..**.** Call
1b330 20 74 68 65 20 76 61 6c 75 65 20 66 72 6f 6d 20 the value from
1b340 74 68 65 20 73 65 63 6f 6e 64 20 62 75 6c 6c 65 the second bulle
1b350 74 20 22 6e 52 65 63 22 2e 20 20 6e 52 65 63 20 t "nRec". nRec
1b360 69 73 20 74 68 65 20 6e 75 6d 62 65 72 20 6f 66 is the number of
1b370 0a 2a 2a 20 76 61 6c 69 64 20 70 61 67 65 20 65 .** valid page e
1b380 6e 74 72 69 65 73 20 69 6e 20 74 68 65 20 6a 6f ntries in the jo
1b390 75 72 6e 61 6c 2e 20 20 49 6e 20 6d 6f 73 74 20 urnal. In most
1b3a0 63 61 73 65 73 2c 20 79 6f 75 20 63 61 6e 20 63 cases, you can c
1b3b0 6f 6d 70 75 74 65 20 74 68 65 0a 2a 2a 20 76 61 ompute the.** va
1b3c0 6c 75 65 20 6f 66 20 6e 52 65 63 20 66 72 6f 6d lue of nRec from
1b3d0 20 74 68 65 20 73 69 7a 65 20 6f 66 20 74 68 65 the size of the
1b3e0 20 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 2e 20 20 journal file.
1b3f0 42 75 74 20 69 66 20 61 20 70 6f 77 65 72 0a 2a But if a power.*
1b400 2a 20 66 61 69 6c 75 72 65 20 6f 63 63 75 72 72 * failure occurr
1b410 65 64 20 77 68 69 6c 65 20 74 68 65 20 6a 6f 75 ed while the jou
1b420 72 6e 61 6c 20 77 61 73 20 62 65 69 6e 67 20 77 rnal was being w
1b430 72 69 74 74 65 6e 2c 20 69 74 20 63 6f 75 6c 64 ritten, it could
1b440 20 62 65 20 74 68 65 0a 2a 2a 20 63 61 73 65 20 be the.** case
1b450 74 68 61 74 20 74 68 65 20 73 69 7a 65 20 6f 66 that the size of
1b460 20 74 68 65 20 6a 6f 75 72 6e 61 6c 20 66 69 6c the journal fil
1b470 65 20 68 61 64 20 61 6c 72 65 61 64 79 20 62 65 e had already be
1b480 65 6e 20 69 6e 63 72 65 61 73 65 64 20 62 75 74 en increased but
1b490 0a 2a 2a 20 74 68 65 20 65 78 74 72 61 20 65 6e .** the extra en
1b4a0 74 72 69 65 73 20 68 61 64 20 6e 6f 74 20 79 65 tries had not ye
1b4b0 74 20 6d 61 64 65 20 69 74 20 73 61 66 65 6c 79 t made it safely
1b4c0 20 74 6f 20 64 69 73 6b 2e 20 20 49 6e 20 73 75 to disk. In su
1b4d0 63 68 20 61 20 63 61 73 65 2c 0a 2a 2a 20 74 68 ch a case,.** th
1b4e0 65 20 76 61 6c 75 65 20 6f 66 20 6e 52 65 63 20 e value of nRec
1b4f0 63 6f 6d 70 75 74 65 64 20 66 72 6f 6d 20 74 68 computed from th
1b500 65 20 66 69 6c 65 20 73 69 7a 65 20 77 6f 75 6c e file size woul
1b510 64 20 62 65 20 74 6f 6f 20 6c 61 72 67 65 2e 20 d be too large.
1b520 20 46 6f 72 0a 2a 2a 20 74 68 61 74 20 72 65 61 For.** that rea
1b530 73 6f 6e 2c 20 77 65 20 61 6c 77 61 79 73 20 75 son, we always u
1b540 73 65 20 74 68 65 20 6e 52 65 63 20 76 61 6c 75 se the nRec valu
1b550 65 20 69 6e 20 74 68 65 20 68 65 61 64 65 72 2e e in the header.
1b560 0a 2a 2a 0a 2a 2a 20 49 66 20 74 68 65 20 6e 52 .**.** If the nR
1b570 65 63 20 76 61 6c 75 65 20 69 73 20 30 78 66 66 ec value is 0xff
1b580 66 66 66 66 66 66 20 69 74 20 6d 65 61 6e 73 20 ffffff it means
1b590 74 68 61 74 20 6e 52 65 63 20 73 68 6f 75 6c 64 that nRec should
1b5a0 20 62 65 20 63 6f 6d 70 75 74 65 64 0a 2a 2a 20 be computed.**
1b5b0 66 72 6f 6d 20 74 68 65 20 66 69 6c 65 20 73 69 from the file si
1b5c0 7a 65 2e 20 20 54 68 69 73 20 76 61 6c 75 65 20 ze. This value
1b5d0 69 73 20 75 73 65 64 20 77 68 65 6e 20 74 68 65 is used when the
1b5e0 20 75 73 65 72 20 73 65 6c 65 63 74 73 20 74 68 user selects th
1b5f0 65 0a 2a 2a 20 6e 6f 2d 73 79 6e 63 20 6f 70 74 e.** no-sync opt
1b600 69 6f 6e 20 66 6f 72 20 74 68 65 20 6a 6f 75 72 ion for the jour
1b610 6e 61 6c 2e 20 20 41 20 70 6f 77 65 72 20 66 61 nal. A power fa
1b620 69 6c 75 72 65 20 63 6f 75 6c 64 20 6c 65 61 64 ilure could lead
1b630 20 74 6f 20 63 6f 72 72 75 70 74 69 6f 6e 0a 2a to corruption.*
1b640 2a 20 69 6e 20 74 68 69 73 20 63 61 73 65 2e 20 * in this case.
1b650 20 42 75 74 20 66 6f 72 20 74 68 69 6e 67 73 20 But for things
1b660 6c 69 6b 65 20 74 65 6d 70 6f 72 61 72 79 20 74 like temporary t
1b670 61 62 6c 65 20 28 77 68 69 63 68 20 77 69 6c 6c able (which will
1b680 20 62 65 0a 2a 2a 20 64 65 6c 65 74 65 64 20 77 be.** deleted w
1b690 68 65 6e 20 74 68 65 20 70 6f 77 65 72 20 69 73 hen the power is
1b6a0 20 72 65 73 74 6f 72 65 64 29 20 77 65 20 64 6f restored) we do
1b6b0 6e 27 74 20 63 61 72 65 2e 20 20 0a 2a 2a 0a 2a n't care. .**.*
1b6c0 2a 20 49 66 20 74 68 65 20 66 69 6c 65 20 6f 70 * If the file op
1b6d0 65 6e 65 64 20 61 73 20 74 68 65 20 6a 6f 75 72 ened as the jour
1b6e0 6e 61 6c 20 66 69 6c 65 20 69 73 20 6e 6f 74 20 nal file is not
1b6f0 61 20 77 65 6c 6c 2d 66 6f 72 6d 65 64 0a 2a 2a a well-formed.**
1b700 20 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 20 74 68 journal file th
1b710 65 6e 20 61 6c 6c 20 70 61 67 65 73 20 75 70 20 en all pages up
1b720 74 6f 20 74 68 65 20 66 69 72 73 74 20 63 6f 72 to the first cor
1b730 72 75 70 74 65 64 20 70 61 67 65 20 61 72 65 20 rupted page are
1b740 72 6f 6c 6c 65 64 0a 2a 2a 20 62 61 63 6b 20 28 rolled.** back (
1b750 6f 72 20 6e 6f 20 70 61 67 65 73 20 69 66 20 74 or no pages if t
1b760 68 65 20 6a 6f 75 72 6e 61 6c 20 68 65 61 64 65 he journal heade
1b770 72 20 69 73 20 63 6f 72 72 75 70 74 65 64 29 2e r is corrupted).
1b780 20 54 68 65 20 6a 6f 75 72 6e 61 6c 20 66 69 6c The journal fil
1b790 65 0a 2a 2a 20 69 73 20 74 68 65 6e 20 64 65 6c e.** is then del
1b7a0 65 74 65 64 20 61 6e 64 20 53 51 4c 49 54 45 5f eted and SQLITE_
1b7b0 4f 4b 20 72 65 74 75 72 6e 65 64 2c 20 6a 75 73 OK returned, jus
1b7c0 74 20 61 73 20 69 66 20 6e 6f 20 63 6f 72 72 75 t as if no corru
1b7d0 70 74 69 6f 6e 20 68 61 64 0a 2a 2a 20 62 65 65 ption had.** bee
1b7e0 6e 20 65 6e 63 6f 75 6e 74 65 72 65 64 2e 0a 2a n encountered..*
1b7f0 2a 0a 2a 2a 20 49 66 20 61 6e 20 49 2f 4f 20 6f *.** If an I/O o
1b800 72 20 6d 61 6c 6c 6f 63 28 29 20 65 72 72 6f 72 r malloc() error
1b810 20 6f 63 63 75 72 73 2c 20 74 68 65 20 6a 6f 75 occurs, the jou
1b820 72 6e 61 6c 2d 66 69 6c 65 20 69 73 20 6e 6f 74 rnal-file is not
1b830 20 64 65 6c 65 74 65 64 0a 2a 2a 20 61 6e 64 20 deleted.** and
1b840 61 6e 20 65 72 72 6f 72 20 63 6f 64 65 20 69 73 an error code is
1b850 20 72 65 74 75 72 6e 65 64 2e 0a 2a 2a 0a 2a 2a returned..**.**
1b860 20 54 68 65 20 69 73 48 6f 74 20 70 61 72 61 6d The isHot param
1b870 65 74 65 72 20 69 6e 64 69 63 61 74 65 73 20 74 eter indicates t
1b880 68 61 74 20 77 65 20 61 72 65 20 74 72 79 69 6e hat we are tryin
1b890 67 20 74 6f 20 72 6f 6c 6c 62 61 63 6b 20 61 20 g to rollback a
1b8a0 6a 6f 75 72 6e 61 6c 0a 2a 2a 20 74 68 61 74 20 journal.** that
1b8b0 6d 69 67 68 74 20 62 65 20 61 20 68 6f 74 20 6a might be a hot j
1b8c0 6f 75 72 6e 61 6c 2e 20 20 4f 72 2c 20 69 74 20 ournal. Or, it
1b8d0 63 6f 75 6c 64 20 62 65 20 74 68 61 74 20 74 68 could be that th
1b8e0 65 20 6a 6f 75 72 6e 61 6c 20 69 73 20 0a 2a 2a e journal is .**
1b8f0 20 70 72 65 73 65 72 76 65 64 20 62 65 63 61 75 preserved becau
1b900 73 65 20 6f 66 20 4a 4f 55 52 4e 41 4c 4d 4f 44 se of JOURNALMOD
1b910 45 5f 50 45 52 53 49 53 54 20 6f 72 20 4a 4f 55 E_PERSIST or JOU
1b920 52 4e 41 4c 4d 4f 44 45 5f 54 52 55 4e 43 41 54 RNALMODE_TRUNCAT
1b930 45 2e 0a 2a 2a 20 49 66 20 74 68 65 20 6a 6f 75 E..** If the jou
1b940 72 6e 61 6c 20 72 65 61 6c 6c 79 20 69 73 20 68 rnal really is h
1b950 6f 74 2c 20 72 65 73 65 74 20 74 68 65 20 70 61 ot, reset the pa
1b960 67 65 72 20 63 61 63 68 65 20 70 72 69 6f 72 20 ger cache prior
1b970 72 6f 6c 6c 69 6e 67 0a 2a 2a 20 62 61 63 6b 20 rolling.** back
1b980 61 6e 79 20 63 6f 6e 74 65 6e 74 2e 20 20 49 66 any content. If
1b990 20 74 68 65 20 6a 6f 75 72 6e 61 6c 20 69 73 20 the journal is
1b9a0 6d 65 72 65 6c 79 20 70 65 72 73 69 73 74 65 6e merely persisten
1b9b0 74 2c 20 6e 6f 20 72 65 73 65 74 20 69 73 0a 2a t, no reset is.*
1b9c0 2a 20 6e 65 65 64 65 64 2e 0a 2a 2f 0a 73 74 61 * needed..*/.sta
1b9d0 74 69 63 20 69 6e 74 20 70 61 67 65 72 5f 70 6c tic int pager_pl
1b9e0 61 79 62 61 63 6b 28 50 61 67 65 72 20 2a 70 50 ayback(Pager *pP
1b9f0 61 67 65 72 2c 20 69 6e 74 20 69 73 48 6f 74 29 ager, int isHot)
1ba00 7b 0a 20 20 73 71 6c 69 74 65 33 5f 76 66 73 20 {. sqlite3_vfs
1ba10 2a 70 56 66 73 20 3d 20 70 50 61 67 65 72 2d 3e *pVfs = pPager->
1ba20 70 56 66 73 3b 0a 20 20 69 36 34 20 73 7a 4a 3b pVfs;. i64 szJ;
1ba30 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
1ba40 20 2f 2a 20 53 69 7a 65 20 6f 66 20 74 68 65 20 /* Size of the
1ba50 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 20 69 6e 20 journal file in
1ba60 62 79 74 65 73 20 2a 2f 0a 20 20 75 33 32 20 6e bytes */. u32 n
1ba70 52 65 63 3b 20 20 20 20 20 20 20 20 20 20 20 20 Rec;
1ba80 20 20 20 20 2f 2a 20 4e 75 6d 62 65 72 20 6f 66 /* Number of
1ba90 20 52 65 63 6f 72 64 73 20 69 6e 20 74 68 65 20 Records in the
1baa0 6a 6f 75 72 6e 61 6c 20 2a 2f 0a 20 20 75 33 32 journal */. u32
1bab0 20 75 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 u;
1bac0 20 20 20 20 20 20 2f 2a 20 55 6e 73 69 67 6e 65 /* Unsigne
1bad0 64 20 6c 6f 6f 70 20 63 6f 75 6e 74 65 72 20 2a d loop counter *
1bae0 2f 0a 20 20 50 67 6e 6f 20 6d 78 50 67 20 3d 20 /. Pgno mxPg =
1baf0 30 3b 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 0; /*
1bb00 53 69 7a 65 20 6f 66 20 74 68 65 20 6f 72 69 67 Size of the orig
1bb10 69 6e 61 6c 20 66 69 6c 65 20 69 6e 20 70 61 67 inal file in pag
1bb20 65 73 20 2a 2f 0a 20 20 69 6e 74 20 72 63 3b 20 es */. int rc;
1bb30 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
1bb40 20 2f 2a 20 52 65 73 75 6c 74 20 63 6f 64 65 20 /* Result code
1bb50 6f 66 20 61 20 73 75 62 72 6f 75 74 69 6e 65 20 of a subroutine
1bb60 2a 2f 0a 20 20 69 6e 74 20 72 65 73 20 3d 20 31 */. int res = 1
1bb70 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a ; /*
1bb80 20 56 61 6c 75 65 20 72 65 74 75 72 6e 65 64 20 Value returned
1bb90 62 79 20 73 71 6c 69 74 65 33 4f 73 41 63 63 65 by sqlite3OsAcce
1bba0 73 73 28 29 20 2a 2f 0a 20 20 63 68 61 72 20 2a ss() */. char *
1bbb0 7a 4d 61 73 74 65 72 20 3d 20 30 3b 20 20 20 20 zMaster = 0;
1bbc0 20 20 20 2f 2a 20 4e 61 6d 65 20 6f 66 20 6d 61 /* Name of ma
1bbd0 73 74 65 72 20 6a 6f 75 72 6e 61 6c 20 66 69 6c ster journal fil
1bbe0 65 20 69 66 20 61 6e 79 20 2a 2f 0a 20 20 69 6e e if any */. in
1bbf0 74 20 6e 65 65 64 50 61 67 65 72 52 65 73 65 74 t needPagerReset
1bc00 3b 20 20 20 20 20 20 2f 2a 20 54 72 75 65 20 74 ; /* True t
1bc10 6f 20 72 65 73 65 74 20 70 61 67 65 20 70 72 69 o reset page pri
1bc20 6f 72 20 74 6f 20 66 69 72 73 74 20 70 61 67 65 or to first page
1bc30 20 72 6f 6c 6c 62 61 63 6b 20 2a 2f 0a 20 20 69 rollback */. i
1bc40 6e 74 20 6e 50 6c 61 79 62 61 63 6b 20 3d 20 30 nt nPlayback = 0
1bc50 3b 20 20 20 20 20 20 20 2f 2a 20 54 6f 74 61 6c ; /* Total
1bc60 20 6e 75 6d 62 65 72 20 6f 66 20 70 61 67 65 73 number of pages
1bc70 20 72 65 73 74 6f 72 65 64 20 66 72 6f 6d 20 6a restored from j
1bc80 6f 75 72 6e 61 6c 20 2a 2f 0a 0a 20 20 2f 2a 20 ournal */.. /*
1bc90 46 69 67 75 72 65 20 6f 75 74 20 68 6f 77 20 6d Figure out how m
1bca0 61 6e 79 20 72 65 63 6f 72 64 73 20 61 72 65 20 any records are
1bcb0 69 6e 20 74 68 65 20 6a 6f 75 72 6e 61 6c 2e 20 in the journal.
1bcc0 20 41 62 6f 72 74 20 65 61 72 6c 79 20 69 66 0a Abort early if.
1bcd0 20 20 2a 2a 20 74 68 65 20 6a 6f 75 72 6e 61 6c ** the journal
1bce0 20 69 73 20 65 6d 70 74 79 2e 0a 20 20 2a 2f 0a is empty.. */.
1bcf0 20 20 61 73 73 65 72 74 28 20 69 73 4f 70 65 6e assert( isOpen
1bd00 28 70 50 61 67 65 72 2d 3e 6a 66 64 29 20 29 3b (pPager->jfd) );
1bd10 0a 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33 4f . rc = sqlite3O
1bd20 73 46 69 6c 65 53 69 7a 65 28 70 50 61 67 65 72 sFileSize(pPager
1bd30 2d 3e 6a 66 64 2c 20 26 73 7a 4a 29 3b 0a 20 20 ->jfd, &szJ);.
1bd40 69 66 28 20 72 63 21 3d 53 51 4c 49 54 45 5f 4f if( rc!=SQLITE_O
1bd50 4b 20 29 7b 0a 20 20 20 20 67 6f 74 6f 20 65 6e K ){. goto en
1bd60 64 5f 70 6c 61 79 62 61 63 6b 3b 0a 20 20 7d 0a d_playback;. }.
1bd70 0a 20 20 2f 2a 20 52 65 61 64 20 74 68 65 20 6d . /* Read the m
1bd80 61 73 74 65 72 20 6a 6f 75 72 6e 61 6c 20 6e 61 aster journal na
1bd90 6d 65 20 66 72 6f 6d 20 74 68 65 20 6a 6f 75 72 me from the jour
1bda0 6e 61 6c 2c 20 69 66 20 69 74 20 69 73 20 70 72 nal, if it is pr
1bdb0 65 73 65 6e 74 2e 0a 20 20 2a 2a 20 49 66 20 61 esent.. ** If a
1bdc0 20 6d 61 73 74 65 72 20 6a 6f 75 72 6e 61 6c 20 master journal
1bdd0 66 69 6c 65 20 6e 61 6d 65 20 69 73 20 73 70 65 file name is spe
1bde0 63 69 66 69 65 64 2c 20 62 75 74 20 74 68 65 20 cified, but the
1bdf0 66 69 6c 65 20 69 73 20 6e 6f 74 0a 20 20 2a 2a file is not. **
1be00 20 70 72 65 73 65 6e 74 20 6f 6e 20 64 69 73 6b present on disk
1be10 2c 20 74 68 65 6e 20 74 68 65 20 6a 6f 75 72 6e , then the journ
1be20 61 6c 20 69 73 20 6e 6f 74 20 68 6f 74 20 61 6e al is not hot an
1be30 64 20 64 6f 65 73 20 6e 6f 74 20 6e 65 65 64 20 d does not need
1be40 74 6f 20 62 65 0a 20 20 2a 2a 20 70 6c 61 79 65 to be. ** playe
1be50 64 20 62 61 63 6b 2e 0a 20 20 2a 2a 0a 20 20 2a d back.. **. *
1be60 2a 20 54 4f 44 4f 3a 20 54 65 63 68 6e 69 63 61 * TODO: Technica
1be70 6c 6c 79 20 74 68 65 20 66 6f 6c 6c 6f 77 69 6e lly the followin
1be80 67 20 69 73 20 61 6e 20 65 72 72 6f 72 20 62 65 g is an error be
1be90 63 61 75 73 65 20 69 74 20 61 73 73 75 6d 65 73 cause it assumes
1bea0 20 74 68 61 74 0a 20 20 2a 2a 20 62 75 66 66 65 that. ** buffe
1beb0 72 20 50 61 67 65 72 2e 70 54 6d 70 53 70 61 63 r Pager.pTmpSpac
1bec0 65 20 69 73 20 28 6d 78 50 61 74 68 6e 61 6d 65 e is (mxPathname
1bed0 2b 31 29 20 62 79 74 65 73 20 6f 72 20 6c 61 72 +1) bytes or lar
1bee0 67 65 72 2e 20 69 2e 65 2e 20 74 68 61 74 0a 20 ger. i.e. that.
1bef0 20 2a 2a 20 28 70 50 61 67 65 72 2d 3e 70 61 67 ** (pPager->pag
1bf00 65 53 69 7a 65 20 3e 3d 20 70 50 61 67 65 72 2d eSize >= pPager-
1bf10 3e 70 56 66 73 2d 3e 6d 78 50 61 74 68 6e 61 6d >pVfs->mxPathnam
1bf20 65 2b 31 29 2e 20 55 73 69 6e 67 20 6f 73 5f 75 e+1). Using os_u
1bf30 6e 69 78 2e 63 2c 0a 20 20 2a 2a 20 6d 78 50 61 nix.c,. ** mxPa
1bf40 74 68 6e 61 6d 65 20 69 73 20 35 31 32 2c 20 77 thname is 512, w
1bf50 68 69 63 68 20 69 73 20 74 68 65 20 73 61 6d 65 hich is the same
1bf60 20 61 73 20 74 68 65 20 6d 69 6e 69 6d 75 6d 20 as the minimum
1bf70 61 6c 6c 6f 77 61 62 6c 65 20 76 61 6c 75 65 0a allowable value.
1bf80 20 20 2a 2a 20 66 6f 72 20 70 61 67 65 53 69 7a ** for pageSiz
1bf90 65 2e 0a 20 20 2a 2f 0a 20 20 7a 4d 61 73 74 65 e.. */. zMaste
1bfa0 72 20 3d 20 70 50 61 67 65 72 2d 3e 70 54 6d 70 r = pPager->pTmp
1bfb0 53 70 61 63 65 3b 0a 20 20 72 63 20 3d 20 72 65 Space;. rc = re
1bfc0 61 64 4d 61 73 74 65 72 4a 6f 75 72 6e 61 6c 28 adMasterJournal(
1bfd0 70 50 61 67 65 72 2d 3e 6a 66 64 2c 20 7a 4d 61 pPager->jfd, zMa
1bfe0 73 74 65 72 2c 20 70 50 61 67 65 72 2d 3e 70 56 ster, pPager->pV
1bff0 66 73 2d 3e 6d 78 50 61 74 68 6e 61 6d 65 2b 31 fs->mxPathname+1
1c000 29 3b 0a 20 20 69 66 28 20 72 63 3d 3d 53 51 4c );. if( rc==SQL
1c010 49 54 45 5f 4f 4b 20 26 26 20 7a 4d 61 73 74 65 ITE_OK && zMaste
1c020 72 5b 30 5d 20 29 7b 0a 20 20 20 20 72 63 20 3d r[0] ){. rc =
1c030 20 73 71 6c 69 74 65 33 4f 73 41 63 63 65 73 73 sqlite3OsAccess
1c040 28 70 56 66 73 2c 20 7a 4d 61 73 74 65 72 2c 20 (pVfs, zMaster,
1c050 53 51 4c 49 54 45 5f 41 43 43 45 53 53 5f 45 58 SQLITE_ACCESS_EX
1c060 49 53 54 53 2c 20 26 72 65 73 29 3b 0a 20 20 7d ISTS, &res);. }
1c070 0a 20 20 7a 4d 61 73 74 65 72 20 3d 20 30 3b 0a . zMaster = 0;.
1c080 20 20 69 66 28 20 72 63 21 3d 53 51 4c 49 54 45 if( rc!=SQLITE
1c090 5f 4f 4b 20 7c 7c 20 21 72 65 73 20 29 7b 0a 20 _OK || !res ){.
1c0a0 20 20 20 67 6f 74 6f 20 65 6e 64 5f 70 6c 61 79 goto end_play
1c0b0 62 61 63 6b 3b 0a 20 20 7d 0a 20 20 70 50 61 67 back;. }. pPag
1c0c0 65 72 2d 3e 6a 6f 75 72 6e 61 6c 4f 66 66 20 3d er->journalOff =
1c0d0 20 30 3b 0a 20 20 6e 65 65 64 50 61 67 65 72 52 0;. needPagerR
1c0e0 65 73 65 74 20 3d 20 69 73 48 6f 74 3b 0a 0a 20 eset = isHot;..
1c0f0 20 2f 2a 20 54 68 69 73 20 6c 6f 6f 70 20 74 65 /* This loop te
1c100 72 6d 69 6e 61 74 65 73 20 65 69 74 68 65 72 20 rminates either
1c110 77 68 65 6e 20 61 20 72 65 61 64 4a 6f 75 72 6e when a readJourn
1c120 61 6c 48 64 72 28 29 20 6f 72 20 0a 20 20 2a 2a alHdr() or . **
1c130 20 70 61 67 65 72 5f 70 6c 61 79 62 61 63 6b 5f pager_playback_
1c140 6f 6e 65 5f 70 61 67 65 28 29 20 63 61 6c 6c 20 one_page() call
1c150 72 65 74 75 72 6e 73 20 53 51 4c 49 54 45 5f 44 returns SQLITE_D
1c160 4f 4e 45 20 6f 72 20 61 6e 20 49 4f 20 65 72 72 ONE or an IO err
1c170 6f 72 20 0a 20 20 2a 2a 20 6f 63 63 75 72 73 2e or . ** occurs.
1c180 20 0a 20 20 2a 2f 0a 20 20 77 68 69 6c 65 28 20 . */. while(
1c190 31 20 29 7b 0a 20 20 20 20 2f 2a 20 52 65 61 64 1 ){. /* Read
1c1a0 20 74 68 65 20 6e 65 78 74 20 6a 6f 75 72 6e 61 the next journa
1c1b0 6c 20 68 65 61 64 65 72 20 66 72 6f 6d 20 74 68 l header from th
1c1c0 65 20 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 2e 20 e journal file.
1c1d0 20 49 66 20 74 68 65 72 65 20 61 72 65 0a 20 20 If there are.
1c1e0 20 20 2a 2a 20 6e 6f 74 20 65 6e 6f 75 67 68 20 ** not enough
1c1f0 62 79 74 65 73 20 6c 65 66 74 20 69 6e 20 74 68 bytes left in th
1c200 65 20 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 20 66 e journal file f
1c210 6f 72 20 61 20 63 6f 6d 70 6c 65 74 65 20 68 65 or a complete he
1c220 61 64 65 72 2c 20 6f 72 0a 20 20 20 20 2a 2a 20 ader, or. **
1c230 69 74 20 69 73 20 63 6f 72 72 75 70 74 65 64 2c it is corrupted,
1c240 20 74 68 65 6e 20 61 20 70 72 6f 63 65 73 73 20 then a process
1c250 6d 75 73 74 20 68 61 76 65 20 66 61 69 6c 65 64 must have failed
1c260 20 77 68 69 6c 65 20 77 72 69 74 69 6e 67 20 69 while writing i
1c270 74 2e 0a 20 20 20 20 2a 2a 20 54 68 69 73 20 69 t.. ** This i
1c280 6e 64 69 63 61 74 65 73 20 6e 6f 74 68 69 6e 67 ndicates nothing
1c290 20 6d 6f 72 65 20 6e 65 65 64 73 20 74 6f 20 62 more needs to b
1c2a0 65 20 72 6f 6c 6c 65 64 20 62 61 63 6b 2e 0a 20 e rolled back..
1c2b0 20 20 20 2a 2f 0a 20 20 20 20 72 63 20 3d 20 72 */. rc = r
1c2c0 65 61 64 4a 6f 75 72 6e 61 6c 48 64 72 28 70 50 eadJournalHdr(pP
1c2d0 61 67 65 72 2c 20 69 73 48 6f 74 2c 20 73 7a 4a ager, isHot, szJ
1c2e0 2c 20 26 6e 52 65 63 2c 20 26 6d 78 50 67 29 3b , &nRec, &mxPg);
1c2f0 0a 20 20 20 20 69 66 28 20 72 63 21 3d 53 51 4c . if( rc!=SQL
1c300 49 54 45 5f 4f 4b 20 29 7b 20 0a 20 20 20 20 20 ITE_OK ){ .
1c310 20 69 66 28 20 72 63 3d 3d 53 51 4c 49 54 45 5f if( rc==SQLITE_
1c320 44 4f 4e 45 20 29 7b 0a 20 20 20 20 20 20 20 20 DONE ){.
1c330 72 63 20 3d 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a rc = SQLITE_OK;.
1c340 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 67 6f }. go
1c350 74 6f 20 65 6e 64 5f 70 6c 61 79 62 61 63 6b 3b to end_playback;
1c360 0a 20 20 20 20 7d 0a 0a 20 20 20 20 2f 2a 20 49 . }.. /* I
1c370 66 20 6e 52 65 63 20 69 73 20 30 78 66 66 66 66 f nRec is 0xffff
1c380 66 66 66 66 2c 20 74 68 65 6e 20 74 68 69 73 20 ffff, then this
1c390 6a 6f 75 72 6e 61 6c 20 77 61 73 20 63 72 65 61 journal was crea
1c3a0 74 65 64 20 62 79 20 61 20 70 72 6f 63 65 73 73 ted by a process
1c3b0 0a 20 20 20 20 2a 2a 20 77 6f 72 6b 69 6e 67 20 . ** working
1c3c0 69 6e 20 6e 6f 2d 73 79 6e 63 20 6d 6f 64 65 2e in no-sync mode.
1c3d0 20 54 68 69 73 20 6d 65 61 6e 73 20 74 68 61 74 This means that
1c3e0 20 74 68 65 20 72 65 73 74 20 6f 66 20 74 68 65 the rest of the
1c3f0 20 6a 6f 75 72 6e 61 6c 0a 20 20 20 20 2a 2a 20 journal. **
1c400 66 69 6c 65 20 63 6f 6e 73 69 73 74 73 20 6f 66 file consists of
1c410 20 70 61 67 65 73 2c 20 74 68 65 72 65 20 61 72 pages, there ar
1c420 65 20 6e 6f 20 6d 6f 72 65 20 6a 6f 75 72 6e 61 e no more journa
1c430 6c 20 68 65 61 64 65 72 73 2e 20 43 6f 6d 70 75 l headers. Compu
1c440 74 65 0a 20 20 20 20 2a 2a 20 74 68 65 20 76 61 te. ** the va
1c450 6c 75 65 20 6f 66 20 6e 52 65 63 20 62 61 73 65 lue of nRec base
1c460 64 20 6f 6e 20 74 68 69 73 20 61 73 73 75 6d 70 d on this assump
1c470 74 69 6f 6e 2e 0a 20 20 20 20 2a 2f 0a 20 20 20 tion.. */.
1c480 20 69 66 28 20 6e 52 65 63 3d 3d 30 78 66 66 66 if( nRec==0xfff
1c490 66 66 66 66 66 20 29 7b 0a 20 20 20 20 20 20 61 fffff ){. a
1c4a0 73 73 65 72 74 28 20 70 50 61 67 65 72 2d 3e 6a ssert( pPager->j
1c4b0 6f 75 72 6e 61 6c 4f 66 66 3d 3d 4a 4f 55 52 4e ournalOff==JOURN
1c4c0 41 4c 5f 48 44 52 5f 53 5a 28 70 50 61 67 65 72 AL_HDR_SZ(pPager
1c4d0 29 20 29 3b 0a 20 20 20 20 20 20 6e 52 65 63 20 ) );. nRec
1c4e0 3d 20 28 69 6e 74 29 28 28 73 7a 4a 20 2d 20 4a = (int)((szJ - J
1c4f0 4f 55 52 4e 41 4c 5f 48 44 52 5f 53 5a 28 70 50 OURNAL_HDR_SZ(pP
1c500 61 67 65 72 29 29 2f 4a 4f 55 52 4e 41 4c 5f 50 ager))/JOURNAL_P
1c510 47 5f 53 5a 28 70 50 61 67 65 72 29 29 3b 0a 20 G_SZ(pPager));.
1c520 20 20 20 7d 0a 0a 20 20 20 20 2f 2a 20 49 66 20 }.. /* If
1c530 6e 52 65 63 20 69 73 20 30 20 61 6e 64 20 74 68 nRec is 0 and th
1c540 69 73 20 72 6f 6c 6c 62 61 63 6b 20 69 73 20 6f is rollback is o
1c550 66 20 61 20 74 72 61 6e 73 61 63 74 69 6f 6e 20 f a transaction
1c560 63 72 65 61 74 65 64 20 62 79 20 74 68 69 73 0a created by this.
1c570 20 20 20 20 2a 2a 20 70 72 6f 63 65 73 73 20 61 ** process a
1c580 6e 64 20 69 66 20 74 68 69 73 20 69 73 20 74 68 nd if this is th
1c590 65 20 66 69 6e 61 6c 20 68 65 61 64 65 72 20 69 e final header i
1c5a0 6e 20 74 68 65 20 6a 6f 75 72 6e 61 6c 2c 20 74 n the journal, t
1c5b0 68 65 6e 20 69 74 20 6d 65 61 6e 73 0a 20 20 20 hen it means.
1c5c0 20 2a 2a 20 74 68 61 74 20 74 68 69 73 20 70 61 ** that this pa
1c5d0 72 74 20 6f 66 20 74 68 65 20 6a 6f 75 72 6e 61 rt of the journa
1c5e0 6c 20 77 61 73 20 62 65 69 6e 67 20 66 69 6c 6c l was being fill
1c5f0 65 64 20 62 75 74 20 68 61 73 20 6e 6f 74 20 79 ed but has not y
1c600 65 74 20 62 65 65 6e 0a 20 20 20 20 2a 2a 20 73 et been. ** s
1c610 79 6e 63 65 64 20 74 6f 20 64 69 73 6b 2e 20 20 ynced to disk.
1c620 43 6f 6d 70 75 74 65 20 74 68 65 20 6e 75 6d 62 Compute the numb
1c630 65 72 20 6f 66 20 70 61 67 65 73 20 62 61 73 65 er of pages base
1c640 64 20 6f 6e 20 74 68 65 20 72 65 6d 61 69 6e 69 d on the remaini
1c650 6e 67 0a 20 20 20 20 2a 2a 20 73 69 7a 65 20 6f ng. ** size o
1c660 66 20 74 68 65 20 66 69 6c 65 2e 0a 20 20 20 20 f the file..
1c670 2a 2a 0a 20 20 20 20 2a 2a 20 54 68 65 20 74 68 **. ** The th
1c680 69 72 64 20 74 65 72 6d 20 6f 66 20 74 68 65 20 ird term of the
1c690 74 65 73 74 20 77 61 73 20 61 64 64 65 64 20 74 test was added t
1c6a0 6f 20 66 69 78 20 74 69 63 6b 65 74 20 23 32 35 o fix ticket #25
1c6b0 36 35 2e 0a 20 20 20 20 2a 2a 20 57 68 65 6e 20 65.. ** When
1c6c0 72 6f 6c 6c 69 6e 67 20 62 61 63 6b 20 61 20 68 rolling back a h
1c6d0 6f 74 20 6a 6f 75 72 6e 61 6c 2c 20 6e 52 65 63 ot journal, nRec
1c6e0 3d 3d 30 20 61 6c 77 61 79 73 20 6d 65 61 6e 73 ==0 always means
1c6f0 20 74 68 61 74 20 74 68 65 20 6e 65 78 74 0a 20 that the next.
1c700 20 20 20 2a 2a 20 63 68 75 6e 6b 20 6f 66 20 74 ** chunk of t
1c710 68 65 20 6a 6f 75 72 6e 61 6c 20 63 6f 6e 74 61 he journal conta
1c720 69 6e 73 20 7a 65 72 6f 20 70 61 67 65 73 20 74 ins zero pages t
1c730 6f 20 62 65 20 72 6f 6c 6c 65 64 20 62 61 63 6b o be rolled back
1c740 2e 20 20 42 75 74 0a 20 20 20 20 2a 2a 20 77 68 . But. ** wh
1c750 65 6e 20 64 6f 69 6e 67 20 61 20 52 4f 4c 4c 42 en doing a ROLLB
1c760 41 43 4b 20 61 6e 64 20 74 68 65 20 6e 52 65 63 ACK and the nRec
1c770 3d 3d 30 20 63 68 75 6e 6b 20 69 73 20 74 68 65 ==0 chunk is the
1c780 20 6c 61 73 74 20 63 68 75 6e 6b 20 69 6e 0a 20 last chunk in.
1c790 20 20 20 2a 2a 20 74 68 65 20 6a 6f 75 72 6e 61 ** the journa
1c7a0 6c 2c 20 69 74 20 6d 65 61 6e 73 20 74 68 61 74 l, it means that
1c7b0 20 74 68 65 20 6a 6f 75 72 6e 61 6c 20 6d 69 67 the journal mig
1c7c0 68 74 20 63 6f 6e 74 61 69 6e 20 61 64 64 69 74 ht contain addit
1c7d0 69 6f 6e 61 6c 0a 20 20 20 20 2a 2a 20 70 61 67 ional. ** pag
1c7e0 65 73 20 74 68 61 74 20 6e 65 65 64 20 74 6f 20 es that need to
1c7f0 62 65 20 72 6f 6c 6c 65 64 20 62 61 63 6b 20 61 be rolled back a
1c800 6e 64 20 74 68 61 74 20 74 68 65 20 6e 75 6d 62 nd that the numb
1c810 65 72 20 6f 66 20 70 61 67 65 73 20 0a 20 20 20 er of pages .
1c820 20 2a 2a 20 73 68 6f 75 6c 64 20 62 65 20 63 6f ** should be co
1c830 6d 70 75 74 65 64 20 62 61 73 65 64 20 6f 6e 20 mputed based on
1c840 74 68 65 20 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 the journal file
1c850 20 73 69 7a 65 2e 0a 20 20 20 20 2a 2f 0a 20 20 size.. */.
1c860 20 20 69 66 28 20 6e 52 65 63 3d 3d 30 20 26 26 if( nRec==0 &&
1c870 20 21 69 73 48 6f 74 20 26 26 0a 20 20 20 20 20 !isHot &&.
1c880 20 20 20 70 50 61 67 65 72 2d 3e 6a 6f 75 72 6e pPager->journ
1c890 61 6c 48 64 72 2b 4a 4f 55 52 4e 41 4c 5f 48 44 alHdr+JOURNAL_HD
1c8a0 52 5f 53 5a 28 70 50 61 67 65 72 29 3d 3d 70 50 R_SZ(pPager)==pP
1c8b0 61 67 65 72 2d 3e 6a 6f 75 72 6e 61 6c 4f 66 66 ager->journalOff
1c8c0 20 29 7b 0a 20 20 20 20 20 20 6e 52 65 63 20 3d ){. nRec =
1c8d0 20 28 69 6e 74 29 28 28 73 7a 4a 20 2d 20 70 50 (int)((szJ - pP
1c8e0 61 67 65 72 2d 3e 6a 6f 75 72 6e 61 6c 4f 66 66 ager->journalOff
1c8f0 29 20 2f 20 4a 4f 55 52 4e 41 4c 5f 50 47 5f 53 ) / JOURNAL_PG_S
1c900 5a 28 70 50 61 67 65 72 29 29 3b 0a 20 20 20 20 Z(pPager));.
1c910 7d 0a 0a 20 20 20 20 2f 2a 20 49 66 20 74 68 69 }.. /* If thi
1c920 73 20 69 73 20 74 68 65 20 66 69 72 73 74 20 68 s is the first h
1c930 65 61 64 65 72 20 72 65 61 64 20 66 72 6f 6d 20 eader read from
1c940 74 68 65 20 6a 6f 75 72 6e 61 6c 2c 20 74 72 75 the journal, tru
1c950 6e 63 61 74 65 20 74 68 65 0a 20 20 20 20 2a 2a ncate the. **
1c960 20 64 61 74 61 62 61 73 65 20 66 69 6c 65 20 62 database file b
1c970 61 63 6b 20 74 6f 20 69 74 73 20 6f 72 69 67 69 ack to its origi
1c980 6e 61 6c 20 73 69 7a 65 2e 0a 20 20 20 20 2a 2f nal size.. */
1c990 0a 20 20 20 20 69 66 28 20 70 50 61 67 65 72 2d . if( pPager-
1c9a0 3e 6a 6f 75 72 6e 61 6c 4f 66 66 3d 3d 4a 4f 55 >journalOff==JOU
1c9b0 52 4e 41 4c 5f 48 44 52 5f 53 5a 28 70 50 61 67 RNAL_HDR_SZ(pPag
1c9c0 65 72 29 20 29 7b 0a 20 20 20 20 20 20 72 63 20 er) ){. rc
1c9d0 3d 20 70 61 67 65 72 5f 74 72 75 6e 63 61 74 65 = pager_truncate
1c9e0 28 70 50 61 67 65 72 2c 20 6d 78 50 67 29 3b 0a (pPager, mxPg);.
1c9f0 20 20 20 20 20 20 69 66 28 20 72 63 21 3d 53 51 if( rc!=SQ
1ca00 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 20 LITE_OK ){.
1ca10 20 20 20 67 6f 74 6f 20 65 6e 64 5f 70 6c 61 79 goto end_play
1ca20 62 61 63 6b 3b 0a 20 20 20 20 20 20 7d 0a 20 20 back;. }.
1ca30 20 20 20 20 70 50 61 67 65 72 2d 3e 64 62 53 69 pPager->dbSi
1ca40 7a 65 20 3d 20 6d 78 50 67 3b 0a 20 20 20 20 7d ze = mxPg;. }
1ca50 0a 0a 20 20 20 20 2f 2a 20 43 6f 70 79 20 6f 72 .. /* Copy or
1ca60 69 67 69 6e 61 6c 20 70 61 67 65 73 20 6f 75 74 iginal pages out
1ca70 20 6f 66 20 74 68 65 20 6a 6f 75 72 6e 61 6c 20 of the journal
1ca80 61 6e 64 20 62 61 63 6b 20 69 6e 74 6f 20 74 68 and back into th
1ca90 65 20 0a 20 20 20 20 2a 2a 20 64 61 74 61 62 61 e . ** databa
1caa0 73 65 20 66 69 6c 65 20 61 6e 64 2f 6f 72 20 70 se file and/or p
1cab0 61 67 65 20 63 61 63 68 65 2e 0a 20 20 20 20 2a age cache.. *
1cac0 2f 0a 20 20 20 20 66 6f 72 28 75 3d 30 3b 20 75 /. for(u=0; u
1cad0 3c 6e 52 65 63 3b 20 75 2b 2b 29 7b 0a 20 20 20 <nRec; u++){.
1cae0 20 20 20 69 66 28 20 6e 65 65 64 50 61 67 65 72 if( needPager
1caf0 52 65 73 65 74 20 29 7b 0a 20 20 20 20 20 20 20 Reset ){.
1cb00 20 70 61 67 65 72 5f 72 65 73 65 74 28 70 50 61 pager_reset(pPa
1cb10 67 65 72 29 3b 0a 20 20 20 20 20 20 20 20 6e 65 ger);. ne
1cb20 65 64 50 61 67 65 72 52 65 73 65 74 20 3d 20 30 edPagerReset = 0
1cb30 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 ;. }.
1cb40 72 63 20 3d 20 70 61 67 65 72 5f 70 6c 61 79 62 rc = pager_playb
1cb50 61 63 6b 5f 6f 6e 65 5f 70 61 67 65 28 70 50 61 ack_one_page(pPa
1cb60 67 65 72 2c 26 70 50 61 67 65 72 2d 3e 6a 6f 75 ger,&pPager->jou
1cb70 72 6e 61 6c 4f 66 66 2c 30 2c 31 2c 30 29 3b 0a rnalOff,0,1,0);.
1cb80 20 20 20 20 20 20 69 66 28 20 72 63 3d 3d 53 51 if( rc==SQ
1cb90 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 20 LITE_OK ){.
1cba0 20 20 20 6e 50 6c 61 79 62 61 63 6b 2b 2b 3b 0a nPlayback++;.
1cbb0 20 20 20 20 20 20 7d 65 6c 73 65 7b 0a 20 20 20 }else{.
1cbc0 20 20 20 20 20 69 66 28 20 72 63 3d 3d 53 51 4c if( rc==SQL
1cbd0 49 54 45 5f 44 4f 4e 45 20 29 7b 0a 20 20 20 20 ITE_DONE ){.
1cbe0 20 20 20 20 20 20 70 50 61 67 65 72 2d 3e 6a 6f pPager->jo
1cbf0 75 72 6e 61 6c 4f 66 66 20 3d 20 73 7a 4a 3b 0a urnalOff = szJ;.
1cc00 20 20 20 20 20 20 20 20 20 20 62 72 65 61 6b 3b break;
1cc10 0a 20 20 20 20 20 20 20 20 7d 65 6c 73 65 20 69 . }else i
1cc20 66 28 20 72 63 3d 3d 53 51 4c 49 54 45 5f 49 4f f( rc==SQLITE_IO
1cc30 45 52 52 5f 53 48 4f 52 54 5f 52 45 41 44 20 29 ERR_SHORT_READ )
1cc40 7b 0a 20 20 20 20 20 20 20 20 20 20 2f 2a 20 49 {. /* I
1cc50 66 20 74 68 65 20 6a 6f 75 72 6e 61 6c 20 68 61 f the journal ha
1cc60 73 20 62 65 65 6e 20 74 72 75 6e 63 61 74 65 64 s been truncated
1cc70 2c 20 73 69 6d 70 6c 79 20 73 74 6f 70 20 72 65 , simply stop re
1cc80 61 64 69 6e 67 20 61 6e 64 0a 20 20 20 20 20 20 ading and.
1cc90 20 20 20 20 2a 2a 20 70 72 6f 63 65 73 73 69 6e ** processin
1cca0 67 20 74 68 65 20 6a 6f 75 72 6e 61 6c 2e 20 54 g the journal. T
1ccb0 68 69 73 20 6d 69 67 68 74 20 68 61 70 70 65 6e his might happen
1ccc0 20 69 66 20 74 68 65 20 6a 6f 75 72 6e 61 6c 20 if the journal
1ccd0 77 61 73 0a 20 20 20 20 20 20 20 20 20 20 2a 2a was. **
1cce0 20 6e 6f 74 20 63 6f 6d 70 6c 65 74 65 6c 79 20 not completely
1ccf0 77 72 69 74 74 65 6e 20 61 6e 64 20 73 79 6e 63 written and sync
1cd00 65 64 20 70 72 69 6f 72 20 74 6f 20 61 20 63 72 ed prior to a cr
1cd10 61 73 68 2e 20 20 49 6e 20 74 68 61 74 0a 20 20 ash. In that.
1cd20 20 20 20 20 20 20 20 20 2a 2a 20 63 61 73 65 2c ** case,
1cd30 20 74 68 65 20 64 61 74 61 62 61 73 65 20 73 68 the database sh
1cd40 6f 75 6c 64 20 68 61 76 65 20 6e 65 76 65 72 20 ould have never
1cd50 62 65 65 6e 20 77 72 69 74 74 65 6e 20 69 6e 20 been written in
1cd60 74 68 65 0a 20 20 20 20 20 20 20 20 20 20 2a 2a the. **
1cd70 20 66 69 72 73 74 20 70 6c 61 63 65 20 73 6f 20 first place so
1cd80 69 74 20 69 73 20 4f 4b 20 74 6f 20 73 69 6d 70 it is OK to simp
1cd90 6c 79 20 61 62 61 6e 64 6f 6e 20 74 68 65 20 72 ly abandon the r
1cda0 6f 6c 6c 62 61 63 6b 2e 20 2a 2f 0a 20 20 20 20 ollback. */.
1cdb0 20 20 20 20 20 20 72 63 20 3d 20 53 51 4c 49 54 rc = SQLIT
1cdc0 45 5f 4f 4b 3b 0a 20 20 20 20 20 20 20 20 20 20 E_OK;.
1cdd0 67 6f 74 6f 20 65 6e 64 5f 70 6c 61 79 62 61 63 goto end_playbac
1cde0 6b 3b 0a 20 20 20 20 20 20 20 20 7d 65 6c 73 65 k;. }else
1cdf0 7b 0a 20 20 20 20 20 20 20 20 20 20 2f 2a 20 49 {. /* I
1ce00 66 20 77 65 20 61 72 65 20 75 6e 61 62 6c 65 20 f we are unable
1ce10 74 6f 20 72 6f 6c 6c 62 61 63 6b 2c 20 71 75 69 to rollback, qui
1ce20 74 20 61 6e 64 20 72 65 74 75 72 6e 20 74 68 65 t and return the
1ce30 20 65 72 72 6f 72 0a 20 20 20 20 20 20 20 20 20 error.
1ce40 20 2a 2a 20 63 6f 64 65 2e 20 20 54 68 69 73 20 ** code. This
1ce50 77 69 6c 6c 20 63 61 75 73 65 20 74 68 65 20 70 will cause the p
1ce60 61 67 65 72 20 74 6f 20 65 6e 74 65 72 20 74 68 ager to enter th
1ce70 65 20 65 72 72 6f 72 20 73 74 61 74 65 0a 20 20 e error state.
1ce80 20 20 20 20 20 20 20 20 2a 2a 20 73 6f 20 74 68 ** so th
1ce90 61 74 20 6e 6f 20 66 75 72 74 68 65 72 20 68 61 at no further ha
1cea0 72 6d 20 77 69 6c 6c 20 62 65 20 64 6f 6e 65 2e rm will be done.
1ceb0 20 20 50 65 72 68 61 70 73 20 74 68 65 20 6e 65 Perhaps the ne
1cec0 78 74 0a 20 20 20 20 20 20 20 20 20 20 2a 2a 20 xt. **
1ced0 70 72 6f 63 65 73 73 20 74 6f 20 63 6f 6d 65 20 process to come
1cee0 61 6c 6f 6e 67 20 77 69 6c 6c 20 62 65 20 61 62 along will be ab
1cef0 6c 65 20 74 6f 20 72 6f 6c 6c 62 61 63 6b 20 74 le to rollback t
1cf00 68 65 20 64 61 74 61 62 61 73 65 2e 0a 20 20 20 he database..
1cf10 20 20 20 20 20 20 20 2a 2f 0a 20 20 20 20 20 20 */.
1cf20 20 20 20 20 67 6f 74 6f 20 65 6e 64 5f 70 6c 61 goto end_pla
1cf30 79 62 61 63 6b 3b 0a 20 20 20 20 20 20 20 20 7d yback;. }
1cf40 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 7d 0a 20 . }. }.
1cf50 20 7d 0a 20 20 2f 2a 4e 4f 54 52 45 41 43 48 45 }. /*NOTREACHE
1cf60 44 2a 2f 0a 20 20 61 73 73 65 72 74 28 20 30 20 D*/. assert( 0
1cf70 29 3b 0a 0a 65 6e 64 5f 70 6c 61 79 62 61 63 6b );..end_playback
1cf80 3a 0a 20 20 2f 2a 20 46 6f 6c 6c 6f 77 69 6e 67 :. /* Following
1cf90 20 61 20 72 6f 6c 6c 62 61 63 6b 2c 20 74 68 65 a rollback, the
1cfa0 20 64 61 74 61 62 61 73 65 20 66 69 6c 65 20 73 database file s
1cfb0 68 6f 75 6c 64 20 62 65 20 62 61 63 6b 20 69 6e hould be back in
1cfc0 20 69 74 73 20 6f 72 69 67 69 6e 61 6c 0a 20 20 its original.
1cfd0 2a 2a 20 73 74 61 74 65 20 70 72 69 6f 72 20 74 ** state prior t
1cfe0 6f 20 74 68 65 20 73 74 61 72 74 20 6f 66 20 74 o the start of t
1cff0 68 65 20 74 72 61 6e 73 61 63 74 69 6f 6e 2c 20 he transaction,
1d000 73 6f 20 69 6e 76 6f 6b 65 20 74 68 65 0a 20 20 so invoke the.
1d010 2a 2a 20 53 51 4c 49 54 45 5f 46 43 4e 54 4c 5f ** SQLITE_FCNTL_
1d020 44 42 5f 55 4e 43 48 41 4e 47 45 44 20 66 69 6c DB_UNCHANGED fil
1d030 65 2d 63 6f 6e 74 72 6f 6c 20 6d 65 74 68 6f 64 e-control method
1d040 20 74 6f 20 64 69 73 61 62 6c 65 20 74 68 65 0a to disable the.
1d050 20 20 2a 2a 20 61 73 73 65 72 74 69 6f 6e 20 74 ** assertion t
1d060 68 61 74 20 74 68 65 20 74 72 61 6e 73 61 63 74 hat the transact
1d070 69 6f 6e 20 63 6f 75 6e 74 65 72 20 77 61 73 20 ion counter was
1d080 6d 6f 64 69 66 69 65 64 2e 0a 20 20 2a 2f 0a 23 modified.. */.#
1d090 69 66 64 65 66 20 53 51 4c 49 54 45 5f 44 45 42 ifdef SQLITE_DEB
1d0a0 55 47 0a 20 20 69 66 28 20 70 50 61 67 65 72 2d UG. if( pPager-
1d0b0 3e 66 64 2d 3e 70 4d 65 74 68 6f 64 73 20 29 7b >fd->pMethods ){
1d0c0 0a 20 20 20 20 73 71 6c 69 74 65 33 4f 73 46 69 . sqlite3OsFi
1d0d0 6c 65 43 6f 6e 74 72 6f 6c 48 69 6e 74 28 70 50 leControlHint(pP
1d0e0 61 67 65 72 2d 3e 66 64 2c 53 51 4c 49 54 45 5f ager->fd,SQLITE_
1d0f0 46 43 4e 54 4c 5f 44 42 5f 55 4e 43 48 41 4e 47 FCNTL_DB_UNCHANG
1d100 45 44 2c 30 29 3b 0a 20 20 7d 0a 23 65 6e 64 69 ED,0);. }.#endi
1d110 66 0a 0a 20 20 2f 2a 20 49 66 20 74 68 69 73 20 f.. /* If this
1d120 70 6c 61 79 62 61 63 6b 20 69 73 20 68 61 70 70 playback is happ
1d130 65 6e 69 6e 67 20 61 75 74 6f 6d 61 74 69 63 61 ening automatica
1d140 6c 6c 79 20 61 73 20 61 20 72 65 73 75 6c 74 20 lly as a result
1d150 6f 66 20 61 6e 20 49 4f 20 6f 72 20 0a 20 20 2a of an IO or . *
1d160 2a 20 6d 61 6c 6c 6f 63 20 65 72 72 6f 72 20 74 * malloc error t
1d170 68 61 74 20 6f 63 63 75 72 72 65 64 20 61 66 74 hat occurred aft
1d180 65 72 20 74 68 65 20 63 68 61 6e 67 65 2d 63 6f er the change-co
1d190 75 6e 74 65 72 20 77 61 73 20 75 70 64 61 74 65 unter was update
1d1a0 64 20 62 75 74 20 0a 20 20 2a 2a 20 62 65 66 6f d but . ** befo
1d1b0 72 65 20 74 68 65 20 74 72 61 6e 73 61 63 74 69 re the transacti
1d1c0 6f 6e 20 77 61 73 20 63 6f 6d 6d 69 74 74 65 64 on was committed
1d1d0 2c 20 74 68 65 6e 20 74 68 65 20 63 68 61 6e 67 , then the chang
1d1e0 65 2d 63 6f 75 6e 74 65 72 20 0a 20 20 2a 2a 20 e-counter . **
1d1f0 6d 6f 64 69 66 69 63 61 74 69 6f 6e 20 6d 61 79 modification may
1d200 20 6a 75 73 74 20 68 61 76 65 20 62 65 65 6e 20 just have been
1d210 72 65 76 65 72 74 65 64 2e 20 49 66 20 74 68 69 reverted. If thi
1d220 73 20 68 61 70 70 65 6e 73 20 69 6e 20 65 78 63 s happens in exc
1d230 6c 75 73 69 76 65 20 0a 20 20 2a 2a 20 6d 6f 64 lusive . ** mod
1d240 65 2c 20 74 68 65 6e 20 73 75 62 73 65 71 75 65 e, then subseque
1d250 6e 74 20 74 72 61 6e 73 61 63 74 69 6f 6e 73 20 nt transactions
1d260 70 65 72 66 6f 72 6d 65 64 20 62 79 20 74 68 65 performed by the
1d270 20 63 6f 6e 6e 65 63 74 69 6f 6e 20 77 69 6c 6c connection will
1d280 20 6e 6f 74 0a 20 20 2a 2a 20 75 70 64 61 74 65 not. ** update
1d290 20 74 68 65 20 63 68 61 6e 67 65 2d 63 6f 75 6e the change-coun
1d2a0 74 65 72 20 61 74 20 61 6c 6c 2e 20 54 68 69 73 ter at all. This
1d2b0 20 6d 61 79 20 6c 65 61 64 20 74 6f 20 63 61 63 may lead to cac
1d2c0 68 65 20 69 6e 63 6f 6e 73 69 73 74 65 6e 63 79 he inconsistency
1d2d0 0a 20 20 2a 2a 20 70 72 6f 62 6c 65 6d 73 20 66 . ** problems f
1d2e0 6f 72 20 6f 74 68 65 72 20 70 72 6f 63 65 73 73 or other process
1d2f0 65 73 20 61 74 20 73 6f 6d 65 20 70 6f 69 6e 74 es at some point
1d300 20 69 6e 20 74 68 65 20 66 75 74 75 72 65 2e 20 in the future.
1d310 53 6f 2c 20 6a 75 73 74 0a 20 20 2a 2a 20 69 6e So, just. ** in
1d320 20 63 61 73 65 20 74 68 69 73 20 68 61 73 20 68 case this has h
1d330 61 70 70 65 6e 65 64 2c 20 63 6c 65 61 72 20 74 appened, clear t
1d340 68 65 20 63 68 61 6e 67 65 43 6f 75 6e 74 44 6f he changeCountDo
1d350 6e 65 20 66 6c 61 67 20 6e 6f 77 2e 0a 20 20 2a ne flag now.. *
1d360 2f 0a 20 20 70 50 61 67 65 72 2d 3e 63 68 61 6e /. pPager->chan
1d370 67 65 43 6f 75 6e 74 44 6f 6e 65 20 3d 20 70 50 geCountDone = pP
1d380 61 67 65 72 2d 3e 74 65 6d 70 46 69 6c 65 3b 0a ager->tempFile;.
1d390 0a 20 20 69 66 28 20 72 63 3d 3d 53 51 4c 49 54 . if( rc==SQLIT
1d3a0 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 7a 4d 61 73 E_OK ){. zMas
1d3b0 74 65 72 20 3d 20 70 50 61 67 65 72 2d 3e 70 54 ter = pPager->pT
1d3c0 6d 70 53 70 61 63 65 3b 0a 20 20 20 20 72 63 20 mpSpace;. rc
1d3d0 3d 20 72 65 61 64 4d 61 73 74 65 72 4a 6f 75 72 = readMasterJour
1d3e0 6e 61 6c 28 70 50 61 67 65 72 2d 3e 6a 66 64 2c nal(pPager->jfd,
1d3f0 20 7a 4d 61 73 74 65 72 2c 20 70 50 61 67 65 72 zMaster, pPager
1d400 2d 3e 70 56 66 73 2d 3e 6d 78 50 61 74 68 6e 61 ->pVfs->mxPathna
1d410 6d 65 2b 31 29 3b 0a 20 20 20 20 74 65 73 74 63 me+1);. testc
1d420 61 73 65 28 20 72 63 21 3d 53 51 4c 49 54 45 5f ase( rc!=SQLITE_
1d430 4f 4b 20 29 3b 0a 20 20 7d 0a 20 20 69 66 28 20 OK );. }. if(
1d440 72 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b 0a 20 20 rc==SQLITE_OK.
1d450 20 26 26 20 28 70 50 61 67 65 72 2d 3e 65 53 74 && (pPager->eSt
1d460 61 74 65 3e 3d 50 41 47 45 52 5f 57 52 49 54 45 ate>=PAGER_WRITE
1d470 52 5f 44 42 4d 4f 44 20 7c 7c 20 70 50 61 67 65 R_DBMOD || pPage
1d480 72 2d 3e 65 53 74 61 74 65 3d 3d 50 41 47 45 52 r->eState==PAGER
1d490 5f 4f 50 45 4e 29 0a 20 20 29 7b 0a 20 20 20 20 _OPEN). ){.
1d4a0 72 63 20 3d 20 73 71 6c 69 74 65 33 50 61 67 65 rc = sqlite3Page
1d4b0 72 53 79 6e 63 28 70 50 61 67 65 72 2c 20 30 29 rSync(pPager, 0)
1d4c0 3b 0a 20 20 7d 0a 20 20 69 66 28 20 72 63 3d 3d ;. }. if( rc==
1d4d0 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 SQLITE_OK ){.
1d4e0 20 72 63 20 3d 20 70 61 67 65 72 5f 65 6e 64 5f rc = pager_end_
1d4f0 74 72 61 6e 73 61 63 74 69 6f 6e 28 70 50 61 67 transaction(pPag
1d500 65 72 2c 20 7a 4d 61 73 74 65 72 5b 30 5d 21 3d er, zMaster[0]!=
1d510 27 5c 30 27 2c 20 30 29 3b 0a 20 20 20 20 74 65 '\0', 0);. te
1d520 73 74 63 61 73 65 28 20 72 63 21 3d 53 51 4c 49 stcase( rc!=SQLI
1d530 54 45 5f 4f 4b 20 29 3b 0a 20 20 7d 0a 20 20 69 TE_OK );. }. i
1d540 66 28 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b f( rc==SQLITE_OK
1d550 20 26 26 20 7a 4d 61 73 74 65 72 5b 30 5d 20 26 && zMaster[0] &
1d560 26 20 72 65 73 20 29 7b 0a 20 20 20 20 2f 2a 20 & res ){. /*
1d570 49 66 20 74 68 65 72 65 20 77 61 73 20 61 20 6d If there was a m
1d580 61 73 74 65 72 20 6a 6f 75 72 6e 61 6c 20 61 6e aster journal an
1d590 64 20 74 68 69 73 20 72 6f 75 74 69 6e 65 20 77 d this routine w
1d5a0 69 6c 6c 20 72 65 74 75 72 6e 20 73 75 63 63 65 ill return succe
1d5b0 73 73 2c 0a 20 20 20 20 2a 2a 20 73 65 65 20 69 ss,. ** see i
1d5c0 66 20 69 74 20 69 73 20 70 6f 73 73 69 62 6c 65 f it is possible
1d5d0 20 74 6f 20 64 65 6c 65 74 65 20 74 68 65 20 6d to delete the m
1d5e0 61 73 74 65 72 20 6a 6f 75 72 6e 61 6c 2e 0a 20 aster journal..
1d5f0 20 20 20 2a 2f 0a 20 20 20 20 72 63 20 3d 20 70 */. rc = p
1d600 61 67 65 72 5f 64 65 6c 6d 61 73 74 65 72 28 70 ager_delmaster(p
1d610 50 61 67 65 72 2c 20 7a 4d 61 73 74 65 72 29 3b Pager, zMaster);
1d620 0a 20 20 20 20 74 65 73 74 63 61 73 65 28 20 72 . testcase( r
1d630 63 21 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 3b 0a c!=SQLITE_OK );.
1d640 20 20 7d 0a 20 20 69 66 28 20 69 73 48 6f 74 20 }. if( isHot
1d650 26 26 20 6e 50 6c 61 79 62 61 63 6b 20 29 7b 0a && nPlayback ){.
1d660 20 20 20 20 73 71 6c 69 74 65 33 5f 6c 6f 67 28 sqlite3_log(
1d670 53 51 4c 49 54 45 5f 4e 4f 54 49 43 45 5f 52 45 SQLITE_NOTICE_RE
1d680 43 4f 56 45 52 5f 52 4f 4c 4c 42 41 43 4b 2c 20 COVER_ROLLBACK,
1d690 22 72 65 63 6f 76 65 72 65 64 20 25 64 20 70 61 "recovered %d pa
1d6a0 67 65 73 20 66 72 6f 6d 20 25 73 22 2c 0a 20 20 ges from %s",.
1d6b0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 6e 50 nP
1d6c0 6c 61 79 62 61 63 6b 2c 20 70 50 61 67 65 72 2d layback, pPager-
1d6d0 3e 7a 4a 6f 75 72 6e 61 6c 29 3b 0a 20 20 7d 0a >zJournal);. }.
1d6e0 0a 20 20 2f 2a 20 54 68 65 20 50 61 67 65 72 2e . /* The Pager.
1d6f0 73 65 63 74 6f 72 53 69 7a 65 20 76 61 72 69 61 sectorSize varia
1d700 62 6c 65 20 6d 61 79 20 68 61 76 65 20 62 65 65 ble may have bee
1d710 6e 20 75 70 64 61 74 65 64 20 77 68 69 6c 65 20 n updated while
1d720 72 6f 6c 6c 69 6e 67 0a 20 20 2a 2a 20 62 61 63 rolling. ** bac
1d730 6b 20 61 20 6a 6f 75 72 6e 61 6c 20 63 72 65 61 k a journal crea
1d740 74 65 64 20 62 79 20 61 20 70 72 6f 63 65 73 73 ted by a process
1d750 20 77 69 74 68 20 61 20 64 69 66 66 65 72 65 6e with a differen
1d760 74 20 73 65 63 74 6f 72 20 73 69 7a 65 0a 20 20 t sector size.
1d770 2a 2a 20 76 61 6c 75 65 2e 20 52 65 73 65 74 20 ** value. Reset
1d780 69 74 20 74 6f 20 74 68 65 20 63 6f 72 72 65 63 it to the correc
1d790 74 20 76 61 6c 75 65 20 66 6f 72 20 74 68 69 73 t value for this
1d7a0 20 70 72 6f 63 65 73 73 2e 0a 20 20 2a 2f 0a 20 process.. */.
1d7b0 20 73 65 74 53 65 63 74 6f 72 53 69 7a 65 28 70 setSectorSize(p
1d7c0 50 61 67 65 72 29 3b 0a 20 20 72 65 74 75 72 6e Pager);. return
1d7d0 20 72 63 3b 0a 7d 0a 0a 0a 2f 2a 0a 2a 2a 20 52 rc;.}.../*.** R
1d7e0 65 61 64 20 74 68 65 20 63 6f 6e 74 65 6e 74 20 ead the content
1d7f0 66 6f 72 20 70 61 67 65 20 70 50 67 20 6f 75 74 for page pPg out
1d800 20 6f 66 20 74 68 65 20 64 61 74 61 62 61 73 65 of the database
1d810 20 66 69 6c 65 20 61 6e 64 20 69 6e 74 6f 20 0a file and into .
1d820 2a 2a 20 70 50 67 2d 3e 70 44 61 74 61 2e 20 41 ** pPg->pData. A
1d830 20 73 68 61 72 65 64 20 6c 6f 63 6b 20 6f 72 20 shared lock or
1d840 67 72 65 61 74 65 72 20 6d 75 73 74 20 62 65 20 greater must be
1d850 68 65 6c 64 20 6f 6e 20 74 68 65 20 64 61 74 61 held on the data
1d860 62 61 73 65 0a 2a 2a 20 66 69 6c 65 20 62 65 66 base.** file bef
1d870 6f 72 65 20 74 68 69 73 20 66 75 6e 63 74 69 6f ore this functio
1d880 6e 20 69 73 20 63 61 6c 6c 65 64 2e 0a 2a 2a 0a n is called..**.
1d890 2a 2a 20 49 66 20 70 61 67 65 20 31 20 69 73 20 ** If page 1 is
1d8a0 72 65 61 64 2c 20 74 68 65 6e 20 74 68 65 20 76 read, then the v
1d8b0 61 6c 75 65 20 6f 66 20 50 61 67 65 72 2e 64 62 alue of Pager.db
1d8c0 46 69 6c 65 56 65 72 73 5b 5d 20 69 73 20 73 65 FileVers[] is se
1d8d0 74 20 74 6f 0a 2a 2a 20 74 68 65 20 76 61 6c 75 t to.** the valu
1d8e0 65 20 72 65 61 64 20 66 72 6f 6d 20 74 68 65 20 e read from the
1d8f0 64 61 74 61 62 61 73 65 20 66 69 6c 65 2e 0a 2a database file..*
1d900 2a 0a 2a 2a 20 49 66 20 61 6e 20 49 4f 20 65 72 *.** If an IO er
1d910 72 6f 72 20 6f 63 63 75 72 73 2c 20 74 68 65 6e ror occurs, then
1d920 20 74 68 65 20 49 4f 20 65 72 72 6f 72 20 69 73 the IO error is
1d930 20 72 65 74 75 72 6e 65 64 20 74 6f 20 74 68 65 returned to the
1d940 20 63 61 6c 6c 65 72 2e 0a 2a 2a 20 4f 74 68 65 caller..** Othe
1d950 72 77 69 73 65 2c 20 53 51 4c 49 54 45 5f 4f 4b rwise, SQLITE_OK
1d960 20 69 73 20 72 65 74 75 72 6e 65 64 2e 0a 2a 2f is returned..*/
1d970 0a 73 74 61 74 69 63 20 69 6e 74 20 72 65 61 64 .static int read
1d980 44 62 50 61 67 65 28 50 67 48 64 72 20 2a 70 50 DbPage(PgHdr *pP
1d990 67 2c 20 75 33 32 20 69 46 72 61 6d 65 29 7b 0a g, u32 iFrame){.
1d9a0 20 20 50 61 67 65 72 20 2a 70 50 61 67 65 72 20 Pager *pPager
1d9b0 3d 20 70 50 67 2d 3e 70 50 61 67 65 72 3b 20 2f = pPg->pPager; /
1d9c0 2a 20 50 61 67 65 72 20 6f 62 6a 65 63 74 20 61 * Pager object a
1d9d0 73 73 6f 63 69 61 74 65 64 20 77 69 74 68 20 70 ssociated with p
1d9e0 61 67 65 20 70 50 67 20 2a 2f 0a 20 20 50 67 6e age pPg */. Pgn
1d9f0 6f 20 70 67 6e 6f 20 3d 20 70 50 67 2d 3e 70 67 o pgno = pPg->pg
1da00 6e 6f 3b 20 20 20 20 20 20 20 2f 2a 20 50 61 67 no; /* Pag
1da10 65 20 6e 75 6d 62 65 72 20 74 6f 20 72 65 61 64 e number to read
1da20 20 2a 2f 0a 20 20 69 6e 74 20 72 63 20 3d 20 53 */. int rc = S
1da30 51 4c 49 54 45 5f 4f 4b 3b 20 20 20 20 20 20 20 QLITE_OK;
1da40 20 20 20 2f 2a 20 52 65 74 75 72 6e 20 63 6f 64 /* Return cod
1da50 65 20 2a 2f 0a 20 20 69 6e 74 20 70 67 73 7a 20 e */. int pgsz
1da60 3d 20 70 50 61 67 65 72 2d 3e 70 61 67 65 53 69 = pPager->pageSi
1da70 7a 65 3b 20 2f 2a 20 4e 75 6d 62 65 72 20 6f 66 ze; /* Number of
1da80 20 62 79 74 65 73 20 74 6f 20 72 65 61 64 20 2a bytes to read *
1da90 2f 0a 0a 20 20 61 73 73 65 72 74 28 20 70 50 61 /.. assert( pPa
1daa0 67 65 72 2d 3e 65 53 74 61 74 65 3e 3d 50 41 47 ger->eState>=PAG
1dab0 45 52 5f 52 45 41 44 45 52 20 26 26 20 21 4d 45 ER_READER && !ME
1dac0 4d 44 42 20 29 3b 0a 20 20 61 73 73 65 72 74 28 MDB );. assert(
1dad0 20 69 73 4f 70 65 6e 28 70 50 61 67 65 72 2d 3e isOpen(pPager->
1dae0 66 64 29 20 29 3b 0a 0a 23 69 66 6e 64 65 66 20 fd) );..#ifndef
1daf0 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 57 41 4c 0a SQLITE_OMIT_WAL.
1db00 20 20 69 66 28 20 69 46 72 61 6d 65 20 29 7b 0a if( iFrame ){.
1db10 20 20 20 20 2f 2a 20 54 72 79 20 74 6f 20 70 75 /* Try to pu
1db20 6c 6c 20 74 68 65 20 70 61 67 65 20 66 72 6f 6d ll the page from
1db30 20 74 68 65 20 77 72 69 74 65 2d 61 68 65 61 64 the write-ahead
1db40 20 6c 6f 67 2e 20 2a 2f 0a 20 20 20 20 72 63 20 log. */. rc
1db50 3d 20 73 71 6c 69 74 65 33 57 61 6c 52 65 61 64 = sqlite3WalRead
1db60 46 72 61 6d 65 28 70 50 61 67 65 72 2d 3e 70 57 Frame(pPager->pW
1db70 61 6c 2c 20 69 46 72 61 6d 65 2c 20 70 67 73 7a al, iFrame, pgsz
1db80 2c 20 70 50 67 2d 3e 70 44 61 74 61 29 3b 0a 20 , pPg->pData);.
1db90 20 7d 65 6c 73 65 0a 23 65 6e 64 69 66 0a 20 20 }else.#endif.
1dba0 7b 0a 20 20 20 20 69 36 34 20 69 4f 66 66 73 65 {. i64 iOffse
1dbb0 74 20 3d 20 28 70 67 6e 6f 2d 31 29 2a 28 69 36 t = (pgno-1)*(i6
1dbc0 34 29 70 50 61 67 65 72 2d 3e 70 61 67 65 53 69 4)pPager->pageSi
1dbd0 7a 65 3b 0a 20 20 20 20 72 63 20 3d 20 73 71 6c ze;. rc = sql
1dbe0 69 74 65 33 4f 73 52 65 61 64 28 70 50 61 67 65 ite3OsRead(pPage
1dbf0 72 2d 3e 66 64 2c 20 70 50 67 2d 3e 70 44 61 74 r->fd, pPg->pDat
1dc00 61 2c 20 70 67 73 7a 2c 20 69 4f 66 66 73 65 74 a, pgsz, iOffset
1dc10 29 3b 0a 20 20 20 20 69 66 28 20 72 63 3d 3d 53 );. if( rc==S
1dc20 51 4c 49 54 45 5f 49 4f 45 52 52 5f 53 48 4f 52 QLITE_IOERR_SHOR
1dc30 54 5f 52 45 41 44 20 29 7b 0a 20 20 20 20 20 20 T_READ ){.
1dc40 72 63 20 3d 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a rc = SQLITE_OK;.
1dc50 20 20 20 20 7d 0a 20 20 7d 0a 0a 20 20 69 66 28 }. }.. if(
1dc60 20 70 67 6e 6f 3d 3d 31 20 29 7b 0a 20 20 20 20 pgno==1 ){.
1dc70 69 66 28 20 72 63 20 29 7b 0a 20 20 20 20 20 20 if( rc ){.
1dc80 2f 2a 20 49 66 20 74 68 65 20 72 65 61 64 20 69 /* If the read i
1dc90 73 20 75 6e 73 75 63 63 65 73 73 66 75 6c 2c 20 s unsuccessful,
1dca0 73 65 74 20 74 68 65 20 64 62 46 69 6c 65 56 65 set the dbFileVe
1dcb0 72 73 5b 5d 20 74 6f 20 73 6f 6d 65 74 68 69 6e rs[] to somethin
1dcc0 67 0a 20 20 20 20 20 20 2a 2a 20 74 68 61 74 20 g. ** that
1dcd0 77 69 6c 6c 20 6e 65 76 65 72 20 62 65 20 61 20 will never be a
1dce0 76 61 6c 69 64 20 66 69 6c 65 20 76 65 72 73 69 valid file versi
1dcf0 6f 6e 2e 20 20 64 62 46 69 6c 65 56 65 72 73 5b on. dbFileVers[
1dd00 5d 20 69 73 20 61 20 63 6f 70 79 0a 20 20 20 20 ] is a copy.
1dd10 20 20 2a 2a 20 6f 66 20 62 79 74 65 73 20 32 34 ** of bytes 24
1dd20 2e 2e 33 39 20 6f 66 20 74 68 65 20 64 61 74 61 ..39 of the data
1dd30 62 61 73 65 2e 20 20 42 79 74 65 73 20 32 38 2e base. Bytes 28.
1dd40 2e 33 31 20 73 68 6f 75 6c 64 20 61 6c 77 61 79 .31 should alway
1dd50 73 20 62 65 0a 20 20 20 20 20 20 2a 2a 20 7a 65 s be. ** ze
1dd60 72 6f 20 6f 72 20 74 68 65 20 73 69 7a 65 20 6f ro or the size o
1dd70 66 20 74 68 65 20 64 61 74 61 62 61 73 65 20 69 f the database i
1dd80 6e 20 70 61 67 65 2e 20 42 79 74 65 73 20 33 32 n page. Bytes 32
1dd90 2e 2e 33 35 20 61 6e 64 20 33 35 2e 2e 33 39 0a ..35 and 35..39.
1dda0 20 20 20 20 20 20 2a 2a 20 73 68 6f 75 6c 64 20 ** should
1ddb0 62 65 20 70 61 67 65 20 6e 75 6d 62 65 72 73 20 be page numbers
1ddc0 77 68 69 63 68 20 61 72 65 20 6e 65 76 65 72 20 which are never
1ddd0 30 78 66 66 66 66 66 66 66 66 2e 20 20 53 6f 20 0xffffffff. So
1dde0 66 69 6c 6c 69 6e 67 0a 20 20 20 20 20 20 2a 2a filling. **
1ddf0 20 70 50 61 67 65 72 2d 3e 64 62 46 69 6c 65 56 pPager->dbFileV
1de00 65 72 73 5b 5d 20 77 69 74 68 20 61 6c 6c 20 30 ers[] with all 0
1de10 78 66 66 20 62 79 74 65 73 20 73 68 6f 75 6c 64 xff bytes should
1de20 20 73 75 66 66 69 63 65 2e 0a 20 20 20 20 20 20 suffice..
1de30 2a 2a 0a 20 20 20 20 20 20 2a 2a 20 46 6f 72 20 **. ** For
1de40 61 6e 20 65 6e 63 72 79 70 74 65 64 20 64 61 74 an encrypted dat
1de50 61 62 61 73 65 2c 20 74 68 65 20 73 69 74 75 61 abase, the situa
1de60 74 69 6f 6e 20 69 73 20 6d 6f 72 65 20 63 6f 6d tion is more com
1de70 70 6c 65 78 3a 20 20 62 79 74 65 73 0a 20 20 20 plex: bytes.
1de80 20 20 20 2a 2a 20 32 34 2e 2e 33 39 20 6f 66 20 ** 24..39 of
1de90 74 68 65 20 64 61 74 61 62 61 73 65 20 61 72 65 the database are
1dea0 20 77 68 69 74 65 20 6e 6f 69 73 65 2e 20 20 42 white noise. B
1deb0 75 74 20 74 68 65 20 70 72 6f 62 61 62 69 6c 69 ut the probabili
1dec0 74 79 20 6f 66 0a 20 20 20 20 20 20 2a 2a 20 77 ty of. ** w
1ded0 68 69 74 65 20 6e 6f 69 73 65 20 65 71 75 61 6c hite noise equal
1dee0 69 6e 67 20 31 36 20 62 79 74 65 73 20 6f 66 20 ing 16 bytes of
1def0 30 78 66 66 20 69 73 20 76 61 6e 69 73 68 69 6e 0xff is vanishin
1df00 67 6c 79 20 73 6d 61 6c 6c 20 73 6f 0a 20 20 20 gly small so.
1df10 20 20 20 2a 2a 20 77 65 20 73 68 6f 75 6c 64 20 ** we should
1df20 73 74 69 6c 6c 20 62 65 20 6f 6b 2e 0a 20 20 20 still be ok..
1df30 20 20 20 2a 2f 0a 20 20 20 20 20 20 6d 65 6d 73 */. mems
1df40 65 74 28 70 50 61 67 65 72 2d 3e 64 62 46 69 6c et(pPager->dbFil
1df50 65 56 65 72 73 2c 20 30 78 66 66 2c 20 73 69 7a eVers, 0xff, siz
1df60 65 6f 66 28 70 50 61 67 65 72 2d 3e 64 62 46 69 eof(pPager->dbFi
1df70 6c 65 56 65 72 73 29 29 3b 0a 20 20 20 20 7d 65 leVers));. }e
1df80 6c 73 65 7b 0a 20 20 20 20 20 20 75 38 20 2a 64 lse{. u8 *d
1df90 62 46 69 6c 65 56 65 72 73 20 3d 20 26 28 28 75 bFileVers = &((u
1dfa0 38 2a 29 70 50 67 2d 3e 70 44 61 74 61 29 5b 32 8*)pPg->pData)[2
1dfb0 34 5d 3b 0a 20 20 20 20 20 20 6d 65 6d 63 70 79 4];. memcpy
1dfc0 28 26 70 50 61 67 65 72 2d 3e 64 62 46 69 6c 65 (&pPager->dbFile
1dfd0 56 65 72 73 2c 20 64 62 46 69 6c 65 56 65 72 73 Vers, dbFileVers
1dfe0 2c 20 73 69 7a 65 6f 66 28 70 50 61 67 65 72 2d , sizeof(pPager-
1dff0 3e 64 62 46 69 6c 65 56 65 72 73 29 29 3b 0a 20 >dbFileVers));.
1e000 20 20 20 7d 0a 20 20 7d 0a 20 20 43 4f 44 45 43 }. }. CODEC
1e010 31 28 70 50 61 67 65 72 2c 20 70 50 67 2d 3e 70 1(pPager, pPg->p
1e020 44 61 74 61 2c 20 70 67 6e 6f 2c 20 33 2c 20 72 Data, pgno, 3, r
1e030 63 20 3d 20 53 51 4c 49 54 45 5f 4e 4f 4d 45 4d c = SQLITE_NOMEM
1e040 5f 42 4b 50 54 29 3b 0a 0a 20 20 50 41 47 45 52 _BKPT);.. PAGER
1e050 5f 49 4e 43 52 28 73 71 6c 69 74 65 33 5f 70 61 _INCR(sqlite3_pa
1e060 67 65 72 5f 72 65 61 64 64 62 5f 63 6f 75 6e 74 ger_readdb_count
1e070 29 3b 0a 20 20 50 41 47 45 52 5f 49 4e 43 52 28 );. PAGER_INCR(
1e080 70 50 61 67 65 72 2d 3e 6e 52 65 61 64 29 3b 0a pPager->nRead);.
1e090 20 20 49 4f 54 52 41 43 45 28 28 22 50 47 49 4e IOTRACE(("PGIN
1e0a0 20 25 70 20 25 64 5c 6e 22 2c 20 70 50 61 67 65 %p %d\n", pPage
1e0b0 72 2c 20 70 67 6e 6f 29 29 3b 0a 20 20 50 41 47 r, pgno));. PAG
1e0c0 45 52 54 52 41 43 45 28 28 22 46 45 54 43 48 20 ERTRACE(("FETCH
1e0d0 25 64 20 70 61 67 65 20 25 64 20 68 61 73 68 28 %d page %d hash(
1e0e0 25 30 38 78 29 5c 6e 22 2c 0a 20 20 20 20 20 20 %08x)\n",.
1e0f0 20 20 20 20 20 20 20 20 20 50 41 47 45 52 49 44 PAGERID
1e100 28 70 50 61 67 65 72 29 2c 20 70 67 6e 6f 2c 20 (pPager), pgno,
1e110 70 61 67 65 72 5f 70 61 67 65 68 61 73 68 28 70 pager_pagehash(p
1e120 50 67 29 29 29 3b 0a 0a 20 20 72 65 74 75 72 6e Pg)));.. return
1e130 20 72 63 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 55 70 rc;.}../*.** Up
1e140 64 61 74 65 20 74 68 65 20 76 61 6c 75 65 20 6f date the value o
1e150 66 20 74 68 65 20 63 68 61 6e 67 65 2d 63 6f 75 f the change-cou
1e160 6e 74 65 72 20 61 74 20 6f 66 66 73 65 74 73 20 nter at offsets
1e170 32 34 20 61 6e 64 20 39 32 20 69 6e 0a 2a 2a 20 24 and 92 in.**
1e180 74 68 65 20 68 65 61 64 65 72 20 61 6e 64 20 74 the header and t
1e190 68 65 20 73 71 6c 69 74 65 20 76 65 72 73 69 6f he sqlite versio
1e1a0 6e 20 6e 75 6d 62 65 72 20 61 74 20 6f 66 66 73 n number at offs
1e1b0 65 74 20 39 36 2e 0a 2a 2a 0a 2a 2a 20 54 68 69 et 96..**.** Thi
1e1c0 73 20 69 73 20 61 6e 20 75 6e 63 6f 6e 64 69 74 s is an uncondit
1e1d0 69 6f 6e 61 6c 20 75 70 64 61 74 65 2e 20 20 53 ional update. S
1e1e0 65 65 20 61 6c 73 6f 20 74 68 65 20 70 61 67 65 ee also the page
1e1f0 72 5f 69 6e 63 72 5f 63 68 61 6e 67 65 63 6f 75 r_incr_changecou
1e200 6e 74 65 72 28 29 0a 2a 2a 20 72 6f 75 74 69 6e nter().** routin
1e210 65 20 77 68 69 63 68 20 6f 6e 6c 79 20 75 70 64 e which only upd
1e220 61 74 65 73 20 74 68 65 20 63 68 61 6e 67 65 2d ates the change-
1e230 63 6f 75 6e 74 65 72 20 69 66 20 74 68 65 20 75 counter if the u
1e240 70 64 61 74 65 20 69 73 20 61 63 74 75 61 6c 6c pdate is actuall
1e250 79 0a 2a 2a 20 6e 65 65 64 65 64 2c 20 61 73 20 y.** needed, as
1e260 64 65 74 65 72 6d 69 6e 65 64 20 62 79 20 74 68 determined by th
1e270 65 20 70 50 61 67 65 72 2d 3e 63 68 61 6e 67 65 e pPager->change
1e280 43 6f 75 6e 74 44 6f 6e 65 20 73 74 61 74 65 20 CountDone state
1e290 76 61 72 69 61 62 6c 65 2e 0a 2a 2f 0a 73 74 61 variable..*/.sta
1e2a0 74 69 63 20 76 6f 69 64 20 70 61 67 65 72 5f 77 tic void pager_w
1e2b0 72 69 74 65 5f 63 68 61 6e 67 65 63 6f 75 6e 74 rite_changecount
1e2c0 65 72 28 50 67 48 64 72 20 2a 70 50 67 29 7b 0a er(PgHdr *pPg){.
1e2d0 20 20 75 33 32 20 63 68 61 6e 67 65 5f 63 6f 75 u32 change_cou
1e2e0 6e 74 65 72 3b 0a 0a 20 20 2f 2a 20 49 6e 63 72 nter;.. /* Incr
1e2f0 65 6d 65 6e 74 20 74 68 65 20 76 61 6c 75 65 20 ement the value
1e300 6a 75 73 74 20 72 65 61 64 20 61 6e 64 20 77 72 just read and wr
1e310 69 74 65 20 69 74 20 62 61 63 6b 20 74 6f 20 62 ite it back to b
1e320 79 74 65 20 32 34 2e 20 2a 2f 0a 20 20 63 68 61 yte 24. */. cha
1e330 6e 67 65 5f 63 6f 75 6e 74 65 72 20 3d 20 73 71 nge_counter = sq
1e340 6c 69 74 65 33 47 65 74 34 62 79 74 65 28 28 75 lite3Get4byte((u
1e350 38 2a 29 70 50 67 2d 3e 70 50 61 67 65 72 2d 3e 8*)pPg->pPager->
1e360 64 62 46 69 6c 65 56 65 72 73 29 2b 31 3b 0a 20 dbFileVers)+1;.
1e370 20 70 75 74 33 32 62 69 74 73 28 28 28 63 68 61 put32bits(((cha
1e380 72 2a 29 70 50 67 2d 3e 70 44 61 74 61 29 2b 32 r*)pPg->pData)+2
1e390 34 2c 20 63 68 61 6e 67 65 5f 63 6f 75 6e 74 65 4, change_counte
1e3a0 72 29 3b 0a 0a 20 20 2f 2a 20 41 6c 73 6f 20 73 r);.. /* Also s
1e3b0 74 6f 72 65 20 74 68 65 20 53 51 4c 69 74 65 20 tore the SQLite
1e3c0 76 65 72 73 69 6f 6e 20 6e 75 6d 62 65 72 20 69 version number i
1e3d0 6e 20 62 79 74 65 73 20 39 36 2e 2e 39 39 20 61 n bytes 96..99 a
1e3e0 6e 64 20 69 6e 0a 20 20 2a 2a 20 62 79 74 65 73 nd in. ** bytes
1e3f0 20 39 32 2e 2e 39 35 20 73 74 6f 72 65 20 74 68 92..95 store th
1e400 65 20 63 68 61 6e 67 65 20 63 6f 75 6e 74 65 72 e change counter
1e410 20 66 6f 72 20 77 68 69 63 68 20 74 68 65 20 76 for which the v
1e420 65 72 73 69 6f 6e 20 6e 75 6d 62 65 72 0a 20 20 ersion number.
1e430 2a 2a 20 69 73 20 76 61 6c 69 64 2e 20 2a 2f 0a ** is valid. */.
1e440 20 20 70 75 74 33 32 62 69 74 73 28 28 28 63 68 put32bits(((ch
1e450 61 72 2a 29 70 50 67 2d 3e 70 44 61 74 61 29 2b ar*)pPg->pData)+
1e460 39 32 2c 20 63 68 61 6e 67 65 5f 63 6f 75 6e 74 92, change_count
1e470 65 72 29 3b 0a 20 20 70 75 74 33 32 62 69 74 73 er);. put32bits
1e480 28 28 28 63 68 61 72 2a 29 70 50 67 2d 3e 70 44 (((char*)pPg->pD
1e490 61 74 61 29 2b 39 36 2c 20 53 51 4c 49 54 45 5f ata)+96, SQLITE_
1e4a0 56 45 52 53 49 4f 4e 5f 4e 55 4d 42 45 52 29 3b VERSION_NUMBER);
1e4b0 0a 7d 0a 0a 23 69 66 6e 64 65 66 20 53 51 4c 49 .}..#ifndef SQLI
1e4c0 54 45 5f 4f 4d 49 54 5f 57 41 4c 0a 2f 2a 0a 2a TE_OMIT_WAL./*.*
1e4d0 2a 20 54 68 69 73 20 66 75 6e 63 74 69 6f 6e 20 * This function
1e4e0 69 73 20 69 6e 76 6f 6b 65 64 20 6f 6e 63 65 20 is invoked once
1e4f0 66 6f 72 20 65 61 63 68 20 70 61 67 65 20 74 68 for each page th
1e500 61 74 20 68 61 73 20 61 6c 72 65 61 64 79 20 62 at has already b
1e510 65 65 6e 20 0a 2a 2a 20 77 72 69 74 74 65 6e 20 een .** written
1e520 69 6e 74 6f 20 74 68 65 20 6c 6f 67 20 66 69 6c into the log fil
1e530 65 20 77 68 65 6e 20 61 20 57 41 4c 20 74 72 61 e when a WAL tra
1e540 6e 73 61 63 74 69 6f 6e 20 69 73 20 72 6f 6c 6c nsaction is roll
1e550 65 64 20 62 61 63 6b 2e 0a 2a 2a 20 50 61 72 61 ed back..** Para
1e560 6d 65 74 65 72 20 69 50 67 20 69 73 20 74 68 65 meter iPg is the
1e570 20 70 61 67 65 20 6e 75 6d 62 65 72 20 6f 66 20 page number of
1e580 73 61 69 64 20 70 61 67 65 2e 20 54 68 65 20 70 said page. The p
1e590 43 74 78 20 61 72 67 75 6d 65 6e 74 20 0a 2a 2a Ctx argument .**
1e5a0 20 69 73 20 61 63 74 75 61 6c 6c 79 20 61 20 70 is actually a p
1e5b0 6f 69 6e 74 65 72 20 74 6f 20 74 68 65 20 50 61 ointer to the Pa
1e5c0 67 65 72 20 73 74 72 75 63 74 75 72 65 2e 0a 2a ger structure..*
1e5d0 2a 0a 2a 2a 20 49 66 20 70 61 67 65 20 69 50 67 *.** If page iPg
1e5e0 20 69 73 20 70 72 65 73 65 6e 74 20 69 6e 20 74 is present in t
1e5f0 68 65 20 63 61 63 68 65 2c 20 61 6e 64 20 68 61 he cache, and ha
1e600 73 20 6e 6f 20 6f 75 74 73 74 61 6e 64 69 6e 67 s no outstanding
1e610 20 72 65 66 65 72 65 6e 63 65 73 2c 0a 2a 2a 20 references,.**
1e620 69 74 20 69 73 20 64 69 73 63 61 72 64 65 64 2e it is discarded.
1e630 20 4f 74 68 65 72 77 69 73 65 2c 20 69 66 20 74 Otherwise, if t
1e640 68 65 72 65 20 61 72 65 20 6f 6e 65 20 6f 72 20 here are one or
1e650 6d 6f 72 65 20 6f 75 74 73 74 61 6e 64 69 6e 67 more outstanding
1e660 0a 2a 2a 20 72 65 66 65 72 65 6e 63 65 73 2c 20 .** references,
1e670 74 68 65 20 70 61 67 65 20 63 6f 6e 74 65 6e 74 the page content
1e680 20 69 73 20 72 65 6c 6f 61 64 65 64 20 66 72 6f is reloaded fro
1e690 6d 20 74 68 65 20 64 61 74 61 62 61 73 65 2e 20 m the database.
1e6a0 49 66 20 74 68 65 0a 2a 2a 20 61 74 74 65 6d 70 If the.** attemp
1e6b0 74 20 74 6f 20 72 65 6c 6f 61 64 20 63 6f 6e 74 t to reload cont
1e6c0 65 6e 74 20 66 72 6f 6d 20 74 68 65 20 64 61 74 ent from the dat
1e6d0 61 62 61 73 65 20 69 73 20 72 65 71 75 69 72 65 abase is require
1e6e0 64 20 61 6e 64 20 66 61 69 6c 73 2c 20 0a 2a 2a d and fails, .**
1e6f0 20 72 65 74 75 72 6e 20 61 6e 20 53 51 4c 69 74 return an SQLit
1e700 65 20 65 72 72 6f 72 20 63 6f 64 65 2e 20 4f 74 e error code. Ot
1e710 68 65 72 77 69 73 65 2c 20 53 51 4c 49 54 45 5f herwise, SQLITE_
1e720 4f 4b 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e OK..*/.static in
1e730 74 20 70 61 67 65 72 55 6e 64 6f 43 61 6c 6c 62 t pagerUndoCallb
1e740 61 63 6b 28 76 6f 69 64 20 2a 70 43 74 78 2c 20 ack(void *pCtx,
1e750 50 67 6e 6f 20 69 50 67 29 7b 0a 20 20 69 6e 74 Pgno iPg){. int
1e760 20 72 63 20 3d 20 53 51 4c 49 54 45 5f 4f 4b 3b rc = SQLITE_OK;
1e770 0a 20 20 50 61 67 65 72 20 2a 70 50 61 67 65 72 . Pager *pPager
1e780 20 3d 20 28 50 61 67 65 72 20 2a 29 70 43 74 78 = (Pager *)pCtx
1e790 3b 0a 20 20 50 67 48 64 72 20 2a 70 50 67 3b 0a ;. PgHdr *pPg;.
1e7a0 0a 20 20 61 73 73 65 72 74 28 20 70 61 67 65 72 . assert( pager
1e7b0 55 73 65 57 61 6c 28 70 50 61 67 65 72 29 20 29 UseWal(pPager) )
1e7c0 3b 0a 20 20 70 50 67 20 3d 20 73 71 6c 69 74 65 ;. pPg = sqlite
1e7d0 33 50 61 67 65 72 4c 6f 6f 6b 75 70 28 70 50 61 3PagerLookup(pPa
1e7e0 67 65 72 2c 20 69 50 67 29 3b 0a 20 20 69 66 28 ger, iPg);. if(
1e7f0 20 70 50 67 20 29 7b 0a 20 20 20 20 69 66 28 20 pPg ){. if(
1e800 73 71 6c 69 74 65 33 50 63 61 63 68 65 50 61 67 sqlite3PcachePag
1e810 65 52 65 66 63 6f 75 6e 74 28 70 50 67 29 3d 3d eRefcount(pPg)==
1e820 31 20 29 7b 0a 20 20 20 20 20 20 73 71 6c 69 74 1 ){. sqlit
1e830 65 33 50 63 61 63 68 65 44 72 6f 70 28 70 50 67 e3PcacheDrop(pPg
1e840 29 3b 0a 20 20 20 20 7d 65 6c 73 65 7b 0a 20 20 );. }else{.
1e850 20 20 20 20 75 33 32 20 69 46 72 61 6d 65 20 3d u32 iFrame =
1e860 20 30 3b 0a 20 20 20 20 20 20 72 63 20 3d 20 73 0;. rc = s
1e870 71 6c 69 74 65 33 57 61 6c 46 69 6e 64 46 72 61 qlite3WalFindFra
1e880 6d 65 28 70 50 61 67 65 72 2d 3e 70 57 61 6c 2c me(pPager->pWal,
1e890 20 70 50 67 2d 3e 70 67 6e 6f 2c 20 26 69 46 72 pPg->pgno, &iFr
1e8a0 61 6d 65 29 3b 0a 20 20 20 20 20 20 69 66 28 20 ame);. if(
1e8b0 72 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b rc==SQLITE_OK ){
1e8c0 0a 20 20 20 20 20 20 20 20 72 63 20 3d 20 72 65 . rc = re
1e8d0 61 64 44 62 50 61 67 65 28 70 50 67 2c 20 69 46 adDbPage(pPg, iF
1e8e0 72 61 6d 65 29 3b 0a 20 20 20 20 20 20 7d 0a 20 rame);. }.
1e8f0 20 20 20 20 20 69 66 28 20 72 63 3d 3d 53 51 4c if( rc==SQL
1e900 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 20 20 ITE_OK ){.
1e910 20 20 70 50 61 67 65 72 2d 3e 78 52 65 69 6e 69 pPager->xReini
1e920 74 65 72 28 70 50 67 29 3b 0a 20 20 20 20 20 20 ter(pPg);.
1e930 7d 0a 20 20 20 20 20 20 73 71 6c 69 74 65 33 50 }. sqlite3P
1e940 61 67 65 72 55 6e 72 65 66 4e 6f 74 4e 75 6c 6c agerUnrefNotNull
1e950 28 70 50 67 29 3b 0a 20 20 20 20 7d 0a 20 20 7d (pPg);. }. }
1e960 0a 0a 20 20 2f 2a 20 4e 6f 72 6d 61 6c 6c 79 2c .. /* Normally,
1e970 20 69 66 20 61 20 74 72 61 6e 73 61 63 74 69 6f if a transactio
1e980 6e 20 69 73 20 72 6f 6c 6c 65 64 20 62 61 63 6b n is rolled back
1e990 2c 20 61 6e 79 20 62 61 63 6b 75 70 20 70 72 6f , any backup pro
1e9a0 63 65 73 73 65 73 20 61 72 65 0a 20 20 2a 2a 20 cesses are. **
1e9b0 75 70 64 61 74 65 64 20 61 73 20 64 61 74 61 20 updated as data
1e9c0 69 73 20 63 6f 70 69 65 64 20 6f 75 74 20 6f 66 is copied out of
1e9d0 20 74 68 65 20 72 6f 6c 6c 62 61 63 6b 20 6a 6f the rollback jo
1e9e0 75 72 6e 61 6c 20 61 6e 64 20 69 6e 74 6f 20 74 urnal and into t
1e9f0 68 65 0a 20 20 2a 2a 20 64 61 74 61 62 61 73 65 he. ** database
1ea00 2e 20 54 68 69 73 20 69 73 20 6e 6f 74 20 67 65 . This is not ge
1ea10 6e 65 72 61 6c 6c 79 20 70 6f 73 73 69 62 6c 65 nerally possible
1ea20 20 77 69 74 68 20 61 20 57 41 4c 20 64 61 74 61 with a WAL data
1ea30 62 61 73 65 2c 20 61 73 0a 20 20 2a 2a 20 72 6f base, as. ** ro
1ea40 6c 6c 62 61 63 6b 20 69 6e 76 6f 6c 76 65 73 20 llback involves
1ea50 73 69 6d 70 6c 79 20 74 72 75 6e 63 61 74 69 6e simply truncatin
1ea60 67 20 74 68 65 20 6c 6f 67 20 66 69 6c 65 2e 20 g the log file.
1ea70 54 68 65 72 65 66 6f 72 65 2c 20 69 66 20 6f 6e Therefore, if on
1ea80 65 0a 20 20 2a 2a 20 6f 72 20 6d 6f 72 65 20 66 e. ** or more f
1ea90 72 61 6d 65 73 20 68 61 76 65 20 61 6c 72 65 61 rames have alrea
1eaa0 64 79 20 62 65 65 6e 20 77 72 69 74 74 65 6e 20 dy been written
1eab0 74 6f 20 74 68 65 20 6c 6f 67 20 28 61 6e 64 20 to the log (and
1eac0 74 68 65 72 65 66 6f 72 65 20 0a 20 20 2a 2a 20 therefore . **
1ead0 61 6c 73 6f 20 63 6f 70 69 65 64 20 69 6e 74 6f also copied into
1eae0 20 74 68 65 20 62 61 63 6b 75 70 20 64 61 74 61 the backup data
1eaf0 62 61 73 65 73 29 20 61 73 20 70 61 72 74 20 6f bases) as part o
1eb00 66 20 74 68 69 73 20 74 72 61 6e 73 61 63 74 69 f this transacti
1eb10 6f 6e 2c 0a 20 20 2a 2a 20 74 68 65 20 62 61 63 on,. ** the bac
1eb20 6b 75 70 73 20 6d 75 73 74 20 62 65 20 72 65 73 kups must be res
1eb30 74 61 72 74 65 64 2e 0a 20 20 2a 2f 0a 20 20 73 tarted.. */. s
1eb40 71 6c 69 74 65 33 42 61 63 6b 75 70 52 65 73 74 qlite3BackupRest
1eb50 61 72 74 28 70 50 61 67 65 72 2d 3e 70 42 61 63 art(pPager->pBac
1eb60 6b 75 70 29 3b 0a 0a 20 20 72 65 74 75 72 6e 20 kup);.. return
1eb70 72 63 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 54 68 69 rc;.}../*.** Thi
1eb80 73 20 66 75 6e 63 74 69 6f 6e 20 69 73 20 63 61 s function is ca
1eb90 6c 6c 65 64 20 74 6f 20 72 6f 6c 6c 62 61 63 6b lled to rollback
1eba0 20 61 20 74 72 61 6e 73 61 63 74 69 6f 6e 20 6f a transaction o
1ebb0 6e 20 61 20 57 41 4c 20 64 61 74 61 62 61 73 65 n a WAL database
1ebc0 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74 20 ..*/.static int
1ebd0 70 61 67 65 72 52 6f 6c 6c 62 61 63 6b 57 61 6c pagerRollbackWal
1ebe0 28 50 61 67 65 72 20 2a 70 50 61 67 65 72 29 7b (Pager *pPager){
1ebf0 0a 20 20 69 6e 74 20 72 63 3b 20 20 20 20 20 20 . int rc;
1ec00 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
1ec10 20 20 20 2f 2a 20 52 65 74 75 72 6e 20 43 6f 64 /* Return Cod
1ec20 65 20 2a 2f 0a 20 20 50 67 48 64 72 20 2a 70 4c e */. PgHdr *pL
1ec30 69 73 74 3b 20 20 20 20 20 20 20 20 20 20 20 20 ist;
1ec40 20 20 20 20 20 20 20 2f 2a 20 4c 69 73 74 20 6f /* List o
1ec50 66 20 64 69 72 74 79 20 70 61 67 65 73 20 74 6f f dirty pages to
1ec60 20 72 65 76 65 72 74 20 2a 2f 0a 0a 20 20 2f 2a revert */.. /*
1ec70 20 46 6f 72 20 61 6c 6c 20 70 61 67 65 73 20 69 For all pages i
1ec80 6e 20 74 68 65 20 63 61 63 68 65 20 74 68 61 74 n the cache that
1ec90 20 61 72 65 20 63 75 72 72 65 6e 74 6c 79 20 64 are currently d
1eca0 69 72 74 79 20 6f 72 20 68 61 76 65 20 61 6c 72 irty or have alr
1ecb0 65 61 64 79 0a 20 20 2a 2a 20 62 65 65 6e 20 77 eady. ** been w
1ecc0 72 69 74 74 65 6e 20 28 62 75 74 20 6e 6f 74 20 ritten (but not
1ecd0 63 6f 6d 6d 69 74 74 65 64 29 20 74 6f 20 74 68 committed) to th
1ece0 65 20 6c 6f 67 20 66 69 6c 65 2c 20 64 6f 20 6f e log file, do o
1ecf0 6e 65 20 6f 66 20 74 68 65 20 0a 20 20 2a 2a 20 ne of the . **
1ed00 66 6f 6c 6c 6f 77 69 6e 67 3a 0a 20 20 2a 2a 0a following:. **.
1ed10 20 20 2a 2a 20 20 20 2b 20 44 69 73 63 61 72 64 ** + Discard
1ed20 20 74 68 65 20 63 61 63 68 65 64 20 70 61 67 65 the cached page
1ed30 20 28 69 66 20 72 65 66 63 6f 75 6e 74 3d 3d 30 (if refcount==0
1ed40 29 2c 20 6f 72 0a 20 20 2a 2a 20 20 20 2b 20 52 ), or. ** + R
1ed50 65 6c 6f 61 64 20 70 61 67 65 20 63 6f 6e 74 65 eload page conte
1ed60 6e 74 20 66 72 6f 6d 20 74 68 65 20 64 61 74 61 nt from the data
1ed70 62 61 73 65 20 28 69 66 20 72 65 66 63 6f 75 6e base (if refcoun
1ed80 74 3e 30 29 2e 0a 20 20 2a 2f 0a 20 20 70 50 61 t>0).. */. pPa
1ed90 67 65 72 2d 3e 64 62 53 69 7a 65 20 3d 20 70 50 ger->dbSize = pP
1eda0 61 67 65 72 2d 3e 64 62 4f 72 69 67 53 69 7a 65 ager->dbOrigSize
1edb0 3b 0a 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33 ;. rc = sqlite3
1edc0 57 61 6c 55 6e 64 6f 28 70 50 61 67 65 72 2d 3e WalUndo(pPager->
1edd0 70 57 61 6c 2c 20 70 61 67 65 72 55 6e 64 6f 43 pWal, pagerUndoC
1ede0 61 6c 6c 62 61 63 6b 2c 20 28 76 6f 69 64 20 2a allback, (void *
1edf0 29 70 50 61 67 65 72 29 3b 0a 20 20 70 4c 69 73 )pPager);. pLis
1ee00 74 20 3d 20 73 71 6c 69 74 65 33 50 63 61 63 68 t = sqlite3Pcach
1ee10 65 44 69 72 74 79 4c 69 73 74 28 70 50 61 67 65 eDirtyList(pPage
1ee20 72 2d 3e 70 50 43 61 63 68 65 29 3b 0a 20 20 77 r->pPCache);. w
1ee30 68 69 6c 65 28 20 70 4c 69 73 74 20 26 26 20 72 hile( pList && r
1ee40 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a c==SQLITE_OK ){.
1ee50 20 20 20 20 50 67 48 64 72 20 2a 70 4e 65 78 74 PgHdr *pNext
1ee60 20 3d 20 70 4c 69 73 74 2d 3e 70 44 69 72 74 79 = pList->pDirty
1ee70 3b 0a 20 20 20 20 72 63 20 3d 20 70 61 67 65 72 ;. rc = pager
1ee80 55 6e 64 6f 43 61 6c 6c 62 61 63 6b 28 28 76 6f UndoCallback((vo
1ee90 69 64 20 2a 29 70 50 61 67 65 72 2c 20 70 4c 69 id *)pPager, pLi
1eea0 73 74 2d 3e 70 67 6e 6f 29 3b 0a 20 20 20 20 70 st->pgno);. p
1eeb0 4c 69 73 74 20 3d 20 70 4e 65 78 74 3b 0a 20 20 List = pNext;.
1eec0 7d 0a 0a 20 20 72 65 74 75 72 6e 20 72 63 3b 0a }.. return rc;.
1eed0 7d 0a 0a 2f 2a 0a 2a 2a 20 54 68 69 73 20 66 75 }../*.** This fu
1eee0 6e 63 74 69 6f 6e 20 69 73 20 61 20 77 72 61 70 nction is a wrap
1eef0 70 65 72 20 61 72 6f 75 6e 64 20 73 71 6c 69 74 per around sqlit
1ef00 65 33 57 61 6c 46 72 61 6d 65 73 28 29 2e 20 41 e3WalFrames(). A
1ef10 73 20 77 65 6c 6c 20 61 73 20 6c 6f 67 67 69 6e s well as loggin
1ef20 67 0a 2a 2a 20 74 68 65 20 63 6f 6e 74 65 6e 74 g.** the content
1ef30 73 20 6f 66 20 74 68 65 20 6c 69 73 74 20 6f 66 s of the list of
1ef40 20 70 61 67 65 73 20 68 65 61 64 65 64 20 62 79 pages headed by
1ef50 20 70 4c 69 73 74 20 28 63 6f 6e 6e 65 63 74 65 pList (connecte
1ef60 64 20 62 79 20 70 44 69 72 74 79 29 2c 0a 2a 2a d by pDirty),.**
1ef70 20 74 68 69 73 20 66 75 6e 63 74 69 6f 6e 20 6e this function n
1ef80 6f 74 69 66 69 65 73 20 61 6e 79 20 61 63 74 69 otifies any acti
1ef90 76 65 20 62 61 63 6b 75 70 20 70 72 6f 63 65 73 ve backup proces
1efa0 73 65 73 20 74 68 61 74 20 74 68 65 20 70 61 67 ses that the pag
1efb0 65 73 20 68 61 76 65 0a 2a 2a 20 63 68 61 6e 67 es have.** chang
1efc0 65 64 2e 20 0a 2a 2a 0a 2a 2a 20 54 68 65 20 6c ed. .**.** The l
1efd0 69 73 74 20 6f 66 20 70 61 67 65 73 20 70 61 73 ist of pages pas
1efe0 73 65 64 20 69 6e 74 6f 20 74 68 69 73 20 72 6f sed into this ro
1eff0 75 74 69 6e 65 20 69 73 20 61 6c 77 61 79 73 20 utine is always
1f000 73 6f 72 74 65 64 20 62 79 20 70 61 67 65 20 6e sorted by page n
1f010 75 6d 62 65 72 2e 0a 2a 2a 20 48 65 6e 63 65 2c umber..** Hence,
1f020 20 69 66 20 70 61 67 65 20 31 20 61 70 70 65 61 if page 1 appea
1f030 72 73 20 61 6e 79 77 68 65 72 65 20 6f 6e 20 74 rs anywhere on t
1f040 68 65 20 6c 69 73 74 2c 20 69 74 20 77 69 6c 6c he list, it will
1f050 20 62 65 20 74 68 65 20 66 69 72 73 74 20 70 61 be the first pa
1f060 67 65 2e 0a 2a 2f 20 0a 73 74 61 74 69 63 20 69 ge..*/ .static i
1f070 6e 74 20 70 61 67 65 72 57 61 6c 46 72 61 6d 65 nt pagerWalFrame
1f080 73 28 0a 20 20 50 61 67 65 72 20 2a 70 50 61 67 s(. Pager *pPag
1f090 65 72 2c 20 20 20 20 20 20 20 20 20 20 20 20 20 er,
1f0a0 20 20 20 20 20 2f 2a 20 50 61 67 65 72 20 6f 62 /* Pager ob
1f0b0 6a 65 63 74 20 2a 2f 0a 20 20 50 67 48 64 72 20 ject */. PgHdr
1f0c0 2a 70 4c 69 73 74 2c 20 20 20 20 20 20 20 20 20 *pList,
1f0d0 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4c 69 73 /* Lis
1f0e0 74 20 6f 66 20 66 72 61 6d 65 73 20 74 6f 20 6c t of frames to l
1f0f0 6f 67 20 2a 2f 0a 20 20 50 67 6e 6f 20 6e 54 72 og */. Pgno nTr
1f100 75 6e 63 61 74 65 2c 20 20 20 20 20 20 20 20 20 uncate,
1f110 20 20 20 20 20 20 20 20 2f 2a 20 44 61 74 61 62 /* Datab
1f120 61 73 65 20 73 69 7a 65 20 61 66 74 65 72 20 74 ase size after t
1f130 68 69 73 20 63 6f 6d 6d 69 74 20 2a 2f 0a 20 20 his commit */.
1f140 69 6e 74 20 69 73 43 6f 6d 6d 69 74 20 20 20 20 int isCommit
1f150 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
1f160 2f 2a 20 54 72 75 65 20 69 66 20 74 68 69 73 20 /* True if this
1f170 69 73 20 61 20 63 6f 6d 6d 69 74 20 2a 2f 0a 29 is a commit */.)
1f180 7b 0a 20 20 69 6e 74 20 72 63 3b 20 20 20 20 20 {. int rc;
1f190 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
1f1a0 20 20 20 20 2f 2a 20 52 65 74 75 72 6e 20 63 6f /* Return co
1f1b0 64 65 20 2a 2f 0a 20 20 69 6e 74 20 6e 4c 69 73 de */. int nLis
1f1c0 74 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 t;
1f1d0 20 20 20 20 20 20 20 20 2f 2a 20 4e 75 6d 62 65 /* Numbe
1f1e0 72 20 6f 66 20 70 61 67 65 73 20 69 6e 20 70 4c r of pages in pL
1f1f0 69 73 74 20 2a 2f 0a 20 20 50 67 48 64 72 20 2a ist */. PgHdr *
1f200 70 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 p;
1f210 20 20 20 20 20 20 20 20 20 2f 2a 20 46 6f 72 20 /* For
1f220 6c 6f 6f 70 69 6e 67 20 6f 76 65 72 20 70 61 67 looping over pag
1f230 65 73 20 2a 2f 0a 0a 20 20 61 73 73 65 72 74 28 es */.. assert(
1f240 20 70 50 61 67 65 72 2d 3e 70 57 61 6c 20 29 3b pPager->pWal );
1f250 0a 20 20 61 73 73 65 72 74 28 20 70 4c 69 73 74 . assert( pList
1f260 20 29 3b 0a 23 69 66 64 65 66 20 53 51 4c 49 54 );.#ifdef SQLIT
1f270 45 5f 44 45 42 55 47 0a 20 20 2f 2a 20 56 65 72 E_DEBUG. /* Ver
1f280 69 66 79 20 74 68 61 74 20 74 68 65 20 70 61 67 ify that the pag
1f290 65 20 6c 69 73 74 20 69 73 20 69 6e 20 61 63 63 e list is in acc
1f2a0 65 6e 64 69 6e 67 20 6f 72 64 65 72 20 2a 2f 0a ending order */.
1f2b0 20 20 66 6f 72 28 70 3d 70 4c 69 73 74 3b 20 70 for(p=pList; p
1f2c0 20 26 26 20 70 2d 3e 70 44 69 72 74 79 3b 20 70 && p->pDirty; p
1f2d0 3d 70 2d 3e 70 44 69 72 74 79 29 7b 0a 20 20 20 =p->pDirty){.
1f2e0 20 61 73 73 65 72 74 28 20 70 2d 3e 70 67 6e 6f assert( p->pgno
1f2f0 20 3c 20 70 2d 3e 70 44 69 72 74 79 2d 3e 70 67 < p->pDirty->pg
1f300 6e 6f 20 29 3b 0a 20 20 7d 0a 23 65 6e 64 69 66 no );. }.#endif
1f310 0a 0a 20 20 61 73 73 65 72 74 28 20 70 4c 69 73 .. assert( pLis
1f320 74 2d 3e 70 44 69 72 74 79 3d 3d 30 20 7c 7c 20 t->pDirty==0 ||
1f330 69 73 43 6f 6d 6d 69 74 20 29 3b 0a 20 20 69 66 isCommit );. if
1f340 28 20 69 73 43 6f 6d 6d 69 74 20 29 7b 0a 20 20 ( isCommit ){.
1f350 20 20 2f 2a 20 49 66 20 61 20 57 41 4c 20 74 72 /* If a WAL tr
1f360 61 6e 73 61 63 74 69 6f 6e 20 69 73 20 62 65 69 ansaction is bei
1f370 6e 67 20 63 6f 6d 6d 69 74 74 65 64 2c 20 74 68 ng committed, th
1f380 65 72 65 20 69 73 20 6e 6f 20 70 6f 69 6e 74 20 ere is no point
1f390 69 6e 20 77 72 69 74 69 6e 67 0a 20 20 20 20 2a in writing. *
1f3a0 2a 20 61 6e 79 20 70 61 67 65 73 20 77 69 74 68 * any pages with
1f3b0 20 70 61 67 65 20 6e 75 6d 62 65 72 73 20 67 72 page numbers gr
1f3c0 65 61 74 65 72 20 74 68 61 6e 20 6e 54 72 75 6e eater than nTrun
1f3d0 63 61 74 65 20 69 6e 74 6f 20 74 68 65 20 57 41 cate into the WA
1f3e0 4c 20 66 69 6c 65 2e 0a 20 20 20 20 2a 2a 20 54 L file.. ** T
1f3f0 68 65 79 20 77 69 6c 6c 20 6e 65 76 65 72 20 62 hey will never b
1f400 65 20 72 65 61 64 20 62 79 20 61 6e 79 20 63 6c e read by any cl
1f410 69 65 6e 74 2e 20 53 6f 20 72 65 6d 6f 76 65 20 ient. So remove
1f420 74 68 65 6d 20 66 72 6f 6d 20 74 68 65 20 70 44 them from the pD
1f430 69 72 74 79 0a 20 20 20 20 2a 2a 20 6c 69 73 74 irty. ** list
1f440 20 68 65 72 65 2e 20 2a 2f 0a 20 20 20 20 50 67 here. */. Pg
1f450 48 64 72 20 2a 2a 70 70 4e 65 78 74 20 3d 20 26 Hdr **ppNext = &
1f460 70 4c 69 73 74 3b 0a 20 20 20 20 6e 4c 69 73 74 pList;. nList
1f470 20 3d 20 30 3b 0a 20 20 20 20 66 6f 72 28 70 3d = 0;. for(p=
1f480 70 4c 69 73 74 3b 20 28 2a 70 70 4e 65 78 74 20 pList; (*ppNext
1f490 3d 20 70 29 21 3d 30 3b 20 70 3d 70 2d 3e 70 44 = p)!=0; p=p->pD
1f4a0 69 72 74 79 29 7b 0a 20 20 20 20 20 20 69 66 28 irty){. if(
1f4b0 20 70 2d 3e 70 67 6e 6f 3c 3d 6e 54 72 75 6e 63 p->pgno<=nTrunc
1f4c0 61 74 65 20 29 7b 0a 20 20 20 20 20 20 20 20 70 ate ){. p
1f4d0 70 4e 65 78 74 20 3d 20 26 70 2d 3e 70 44 69 72 pNext = &p->pDir
1f4e0 74 79 3b 0a 20 20 20 20 20 20 20 20 6e 4c 69 73 ty;. nLis
1f4f0 74 2b 2b 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20 t++;. }.
1f500 20 7d 0a 20 20 20 20 61 73 73 65 72 74 28 20 70 }. assert( p
1f510 4c 69 73 74 20 29 3b 0a 20 20 7d 65 6c 73 65 7b List );. }else{
1f520 0a 20 20 20 20 6e 4c 69 73 74 20 3d 20 31 3b 0a . nList = 1;.
1f530 20 20 7d 0a 20 20 70 50 61 67 65 72 2d 3e 61 53 }. pPager->aS
1f540 74 61 74 5b 50 41 47 45 52 5f 53 54 41 54 5f 57 tat[PAGER_STAT_W
1f550 52 49 54 45 5d 20 2b 3d 20 6e 4c 69 73 74 3b 0a RITE] += nList;.
1f560 0a 20 20 69 66 28 20 70 4c 69 73 74 2d 3e 70 67 . if( pList->pg
1f570 6e 6f 3d 3d 31 20 29 20 70 61 67 65 72 5f 77 72 no==1 ) pager_wr
1f580 69 74 65 5f 63 68 61 6e 67 65 63 6f 75 6e 74 65 ite_changecounte
1f590 72 28 70 4c 69 73 74 29 3b 0a 20 20 72 63 20 3d r(pList);. rc =
1f5a0 20 73 71 6c 69 74 65 33 57 61 6c 46 72 61 6d 65 sqlite3WalFrame
1f5b0 73 28 70 50 61 67 65 72 2d 3e 70 57 61 6c 2c 20 s(pPager->pWal,
1f5c0 0a 20 20 20 20 20 20 70 50 61 67 65 72 2d 3e 70 . pPager->p
1f5d0 61 67 65 53 69 7a 65 2c 20 70 4c 69 73 74 2c 20 ageSize, pList,
1f5e0 6e 54 72 75 6e 63 61 74 65 2c 20 69 73 43 6f 6d nTruncate, isCom
1f5f0 6d 69 74 2c 20 70 50 61 67 65 72 2d 3e 77 61 6c mit, pPager->wal
1f600 53 79 6e 63 46 6c 61 67 73 0a 20 20 29 3b 0a 20 SyncFlags. );.
1f610 20 69 66 28 20 72 63 3d 3d 53 51 4c 49 54 45 5f if( rc==SQLITE_
1f620 4f 4b 20 26 26 20 70 50 61 67 65 72 2d 3e 70 42 OK && pPager->pB
1f630 61 63 6b 75 70 20 29 7b 0a 20 20 20 20 66 6f 72 ackup ){. for
1f640 28 70 3d 70 4c 69 73 74 3b 20 70 3b 20 70 3d 70 (p=pList; p; p=p
1f650 2d 3e 70 44 69 72 74 79 29 7b 0a 20 20 20 20 20 ->pDirty){.
1f660 20 73 71 6c 69 74 65 33 42 61 63 6b 75 70 55 70 sqlite3BackupUp
1f670 64 61 74 65 28 70 50 61 67 65 72 2d 3e 70 42 61 date(pPager->pBa
1f680 63 6b 75 70 2c 20 70 2d 3e 70 67 6e 6f 2c 20 28 ckup, p->pgno, (
1f690 75 38 20 2a 29 70 2d 3e 70 44 61 74 61 29 3b 0a u8 *)p->pData);.
1f6a0 20 20 20 20 7d 0a 20 20 7d 0a 0a 23 69 66 64 65 }. }..#ifde
1f6b0 66 20 53 51 4c 49 54 45 5f 43 48 45 43 4b 5f 50 f SQLITE_CHECK_P
1f6c0 41 47 45 53 0a 20 20 70 4c 69 73 74 20 3d 20 73 AGES. pList = s
1f6d0 71 6c 69 74 65 33 50 63 61 63 68 65 44 69 72 74 qlite3PcacheDirt
1f6e0 79 4c 69 73 74 28 70 50 61 67 65 72 2d 3e 70 50 yList(pPager->pP
1f6f0 43 61 63 68 65 29 3b 0a 20 20 66 6f 72 28 70 3d Cache);. for(p=
1f700 70 4c 69 73 74 3b 20 70 3b 20 70 3d 70 2d 3e 70 pList; p; p=p->p
1f710 44 69 72 74 79 29 7b 0a 20 20 20 20 70 61 67 65 Dirty){. page
1f720 72 5f 73 65 74 5f 70 61 67 65 68 61 73 68 28 70 r_set_pagehash(p
1f730 29 3b 0a 20 20 7d 0a 23 65 6e 64 69 66 0a 0a 20 );. }.#endif..
1f740 20 72 65 74 75 72 6e 20 72 63 3b 0a 7d 0a 0a 2f return rc;.}../
1f750 2a 0a 2a 2a 20 42 65 67 69 6e 20 61 20 72 65 61 *.** Begin a rea
1f760 64 20 74 72 61 6e 73 61 63 74 69 6f 6e 20 6f 6e d transaction on
1f770 20 74 68 65 20 57 41 4c 2e 0a 2a 2a 0a 2a 2a 20 the WAL..**.**
1f780 54 68 69 73 20 72 6f 75 74 69 6e 65 20 75 73 65 This routine use
1f790 64 20 74 6f 20 62 65 20 63 61 6c 6c 65 64 20 22 d to be called "
1f7a0 70 61 67 65 72 4f 70 65 6e 53 6e 61 70 73 68 6f pagerOpenSnapsho
1f7b0 74 28 29 22 20 62 65 63 61 75 73 65 20 69 74 20 t()" because it
1f7c0 65 73 73 65 6e 74 69 61 6c 6c 79 0a 2a 2a 20 6d essentially.** m
1f7d0 61 6b 65 73 20 61 20 73 6e 61 70 73 68 6f 74 20 akes a snapshot
1f7e0 6f 66 20 74 68 65 20 64 61 74 61 62 61 73 65 20 of the database
1f7f0 61 74 20 74 68 65 20 63 75 72 72 65 6e 74 20 70 at the current p
1f800 6f 69 6e 74 20 69 6e 20 74 69 6d 65 20 61 6e 64 oint in time and
1f810 20 70 72 65 73 65 72 76 65 73 0a 2a 2a 20 74 68 preserves.** th
1f820 61 74 20 73 6e 61 70 73 68 6f 74 20 66 6f 72 20 at snapshot for
1f830 75 73 65 20 62 79 20 74 68 65 20 72 65 61 64 65 use by the reade
1f840 72 20 69 6e 20 73 70 69 74 65 20 6f 66 20 63 6f r in spite of co
1f850 6e 63 75 72 72 65 6e 74 6c 79 20 63 68 61 6e 67 ncurrently chang
1f860 65 73 20 62 79 0a 2a 2a 20 6f 74 68 65 72 20 77 es by.** other w
1f870 72 69 74 65 72 73 20 6f 72 20 63 68 65 63 6b 70 riters or checkp
1f880 6f 69 6e 74 65 72 73 2e 0a 2a 2f 0a 73 74 61 74 ointers..*/.stat
1f890 69 63 20 69 6e 74 20 70 61 67 65 72 42 65 67 69 ic int pagerBegi
1f8a0 6e 52 65 61 64 54 72 61 6e 73 61 63 74 69 6f 6e nReadTransaction
1f8b0 28 50 61 67 65 72 20 2a 70 50 61 67 65 72 29 7b (Pager *pPager){
1f8c0 0a 20 20 69 6e 74 20 72 63 3b 20 20 20 20 20 20 . int rc;
1f8d0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
1f8e0 20 20 20 2f 2a 20 52 65 74 75 72 6e 20 63 6f 64 /* Return cod
1f8f0 65 20 2a 2f 0a 20 20 69 6e 74 20 63 68 61 6e 67 e */. int chang
1f900 65 64 20 3d 20 30 3b 20 20 20 20 20 20 20 20 20 ed = 0;
1f910 20 20 20 20 20 20 20 2f 2a 20 54 72 75 65 20 69 /* True i
1f920 66 20 63 61 63 68 65 20 6d 75 73 74 20 62 65 20 f cache must be
1f930 72 65 73 65 74 20 2a 2f 0a 0a 20 20 61 73 73 65 reset */.. asse
1f940 72 74 28 20 70 61 67 65 72 55 73 65 57 61 6c 28 rt( pagerUseWal(
1f950 70 50 61 67 65 72 29 20 29 3b 0a 20 20 61 73 73 pPager) );. ass
1f960 65 72 74 28 20 70 50 61 67 65 72 2d 3e 65 53 74 ert( pPager->eSt
1f970 61 74 65 3d 3d 50 41 47 45 52 5f 4f 50 45 4e 20 ate==PAGER_OPEN
1f980 7c 7c 20 70 50 61 67 65 72 2d 3e 65 53 74 61 74 || pPager->eStat
1f990 65 3d 3d 50 41 47 45 52 5f 52 45 41 44 45 52 20 e==PAGER_READER
1f9a0 29 3b 0a 0a 20 20 2f 2a 20 73 71 6c 69 74 65 33 );.. /* sqlite3
1f9b0 57 61 6c 45 6e 64 52 65 61 64 54 72 61 6e 73 61 WalEndReadTransa
1f9c0 63 74 69 6f 6e 28 29 20 77 61 73 20 6e 6f 74 20 ction() was not
1f9d0 63 61 6c 6c 65 64 20 66 6f 72 20 74 68 65 20 70 called for the p
1f9e0 72 65 76 69 6f 75 73 0a 20 20 2a 2a 20 74 72 61 revious. ** tra
1f9f0 6e 73 61 63 74 69 6f 6e 20 69 6e 20 6c 6f 63 6b nsaction in lock
1fa00 69 6e 67 5f 6d 6f 64 65 3d 45 58 43 4c 55 53 49 ing_mode=EXCLUSI
1fa10 56 45 2e 20 20 53 6f 20 63 61 6c 6c 20 69 74 20 VE. So call it
1fa20 6e 6f 77 2e 20 20 49 66 20 77 65 0a 20 20 2a 2a now. If we. **
1fa30 20 61 72 65 20 69 6e 20 6c 6f 63 6b 69 6e 67 5f are in locking_
1fa40 6d 6f 64 65 3d 4e 4f 52 4d 41 4c 20 61 6e 64 20 mode=NORMAL and
1fa50 45 6e 64 52 65 61 64 28 29 20 77 61 73 20 70 72 EndRead() was pr
1fa60 65 76 69 6f 75 73 6c 79 20 63 61 6c 6c 65 64 2c eviously called,
1fa70 0a 20 20 2a 2a 20 74 68 65 20 64 75 70 6c 69 63 . ** the duplic
1fa80 61 74 65 20 63 61 6c 6c 20 69 73 20 68 61 72 6d ate call is harm
1fa90 6c 65 73 73 2e 0a 20 20 2a 2f 0a 20 20 73 71 6c less.. */. sql
1faa0 69 74 65 33 57 61 6c 45 6e 64 52 65 61 64 54 72 ite3WalEndReadTr
1fab0 61 6e 73 61 63 74 69 6f 6e 28 70 50 61 67 65 72 ansaction(pPager
1fac0 2d 3e 70 57 61 6c 29 3b 0a 0a 20 20 72 63 20 3d ->pWal);.. rc =
1fad0 20 73 71 6c 69 74 65 33 57 61 6c 42 65 67 69 6e sqlite3WalBegin
1fae0 52 65 61 64 54 72 61 6e 73 61 63 74 69 6f 6e 28 ReadTransaction(
1faf0 70 50 61 67 65 72 2d 3e 70 57 61 6c 2c 20 26 63 pPager->pWal, &c
1fb00 68 61 6e 67 65 64 29 3b 0a 20 20 69 66 28 20 72 hanged);. if( r
1fb10 63 21 3d 53 51 4c 49 54 45 5f 4f 4b 20 7c 7c 20 c!=SQLITE_OK ||
1fb20 63 68 61 6e 67 65 64 20 29 7b 0a 20 20 20 20 70 changed ){. p
1fb30 61 67 65 72 5f 72 65 73 65 74 28 70 50 61 67 65 ager_reset(pPage
1fb40 72 29 3b 0a 20 20 20 20 69 66 28 20 55 53 45 46 r);. if( USEF
1fb50 45 54 43 48 28 70 50 61 67 65 72 29 20 29 20 73 ETCH(pPager) ) s
1fb60 71 6c 69 74 65 33 4f 73 55 6e 66 65 74 63 68 28 qlite3OsUnfetch(
1fb70 70 50 61 67 65 72 2d 3e 66 64 2c 20 30 2c 20 30 pPager->fd, 0, 0
1fb80 29 3b 0a 20 20 7d 0a 0a 20 20 72 65 74 75 72 6e );. }.. return
1fb90 20 72 63 3b 0a 7d 0a 23 65 6e 64 69 66 0a 0a 2f rc;.}.#endif../
1fba0 2a 0a 2a 2a 20 54 68 69 73 20 66 75 6e 63 74 69 *.** This functi
1fbb0 6f 6e 20 69 73 20 63 61 6c 6c 65 64 20 61 73 20 on is called as
1fbc0 70 61 72 74 20 6f 66 20 74 68 65 20 74 72 61 6e part of the tran
1fbd0 73 69 74 69 6f 6e 20 66 72 6f 6d 20 50 41 47 45 sition from PAGE
1fbe0 52 5f 4f 50 45 4e 0a 2a 2a 20 74 6f 20 50 41 47 R_OPEN.** to PAG
1fbf0 45 52 5f 52 45 41 44 45 52 20 73 74 61 74 65 20 ER_READER state
1fc00 74 6f 20 64 65 74 65 72 6d 69 6e 65 20 74 68 65 to determine the
1fc10 20 73 69 7a 65 20 6f 66 20 74 68 65 20 64 61 74 size of the dat
1fc20 61 62 61 73 65 20 66 69 6c 65 0a 2a 2a 20 69 6e abase file.** in
1fc30 20 70 61 67 65 73 20 28 61 73 73 75 6d 69 6e 67 pages (assuming
1fc40 20 74 68 65 20 70 61 67 65 20 73 69 7a 65 20 63 the page size c
1fc50 75 72 72 65 6e 74 6c 79 20 73 74 6f 72 65 64 20 urrently stored
1fc60 69 6e 20 50 61 67 65 72 2e 70 61 67 65 53 69 7a in Pager.pageSiz
1fc70 65 29 2e 0a 2a 2a 0a 2a 2a 20 49 66 20 6e 6f 20 e)..**.** If no
1fc80 65 72 72 6f 72 20 6f 63 63 75 72 73 2c 20 53 51 error occurs, SQ
1fc90 4c 49 54 45 5f 4f 4b 20 69 73 20 72 65 74 75 72 LITE_OK is retur
1fca0 6e 65 64 20 61 6e 64 20 74 68 65 20 73 69 7a 65 ned and the size
1fcb0 20 6f 66 20 74 68 65 20 64 61 74 61 62 61 73 65 of the database
1fcc0 0a 2a 2a 20 69 6e 20 70 61 67 65 73 20 69 73 20 .** in pages is
1fcd0 73 74 6f 72 65 64 20 69 6e 20 2a 70 6e 50 61 67 stored in *pnPag
1fce0 65 2e 20 4f 74 68 65 72 77 69 73 65 2c 20 61 6e e. Otherwise, an
1fcf0 20 65 72 72 6f 72 20 63 6f 64 65 20 28 70 65 72 error code (per
1fd00 68 61 70 73 0a 2a 2a 20 53 51 4c 49 54 45 5f 49 haps.** SQLITE_I
1fd10 4f 45 52 52 5f 46 53 54 41 54 29 20 69 73 20 72 OERR_FSTAT) is r
1fd20 65 74 75 72 6e 65 64 20 61 6e 64 20 2a 70 6e 50 eturned and *pnP
1fd30 61 67 65 20 69 73 20 6c 65 66 74 20 75 6e 6d 6f age is left unmo
1fd40 64 69 66 69 65 64 2e 0a 2a 2f 0a 73 74 61 74 69 dified..*/.stati
1fd50 63 20 69 6e 74 20 70 61 67 65 72 50 61 67 65 63 c int pagerPagec
1fd60 6f 75 6e 74 28 50 61 67 65 72 20 2a 70 50 61 67 ount(Pager *pPag
1fd70 65 72 2c 20 50 67 6e 6f 20 2a 70 6e 50 61 67 65 er, Pgno *pnPage
1fd80 29 7b 0a 20 20 50 67 6e 6f 20 6e 50 61 67 65 3b ){. Pgno nPage;
1fd90 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
1fda0 20 20 20 20 20 2f 2a 20 56 61 6c 75 65 20 74 6f /* Value to
1fdb0 20 72 65 74 75 72 6e 20 76 69 61 20 2a 70 6e 50 return via *pnP
1fdc0 61 67 65 20 2a 2f 0a 0a 20 20 2f 2a 20 51 75 65 age */.. /* Que
1fdd0 72 79 20 74 68 65 20 57 41 4c 20 73 75 62 2d 73 ry the WAL sub-s
1fde0 79 73 74 65 6d 20 66 6f 72 20 74 68 65 20 64 61 ystem for the da
1fdf0 74 61 62 61 73 65 20 73 69 7a 65 2e 20 54 68 65 tabase size. The
1fe00 20 57 61 6c 44 62 73 69 7a 65 28 29 0a 20 20 2a WalDbsize(). *
1fe10 2a 20 66 75 6e 63 74 69 6f 6e 20 72 65 74 75 72 * function retur
1fe20 6e 73 20 7a 65 72 6f 20 69 66 20 74 68 65 20 57 ns zero if the W
1fe30 41 4c 20 69 73 20 6e 6f 74 20 6f 70 65 6e 20 28 AL is not open (
1fe40 69 2e 65 2e 20 50 61 67 65 72 2e 70 57 61 6c 3d i.e. Pager.pWal=
1fe50 3d 30 29 2c 20 6f 72 0a 20 20 2a 2a 20 69 66 20 =0), or. ** if
1fe60 74 68 65 20 64 61 74 61 62 61 73 65 20 73 69 7a the database siz
1fe70 65 20 69 73 20 6e 6f 74 20 61 76 61 69 6c 61 62 e is not availab
1fe80 6c 65 2e 20 54 68 65 20 64 61 74 61 62 61 73 65 le. The database
1fe90 20 73 69 7a 65 20 69 73 20 6e 6f 74 0a 20 20 2a size is not. *
1fea0 2a 20 61 76 61 69 6c 61 62 6c 65 20 66 72 6f 6d * available from
1feb0 20 74 68 65 20 57 41 4c 20 73 75 62 2d 73 79 73 the WAL sub-sys
1fec0 74 65 6d 20 69 66 20 74 68 65 20 6c 6f 67 20 66 tem if the log f
1fed0 69 6c 65 20 69 73 20 65 6d 70 74 79 20 6f 72 0a ile is empty or.
1fee0 20 20 2a 2a 20 63 6f 6e 74 61 69 6e 73 20 6e 6f ** contains no
1fef0 20 76 61 6c 69 64 20 63 6f 6d 6d 69 74 74 65 64 valid committed
1ff00 20 74 72 61 6e 73 61 63 74 69 6f 6e 73 2e 0a 20 transactions..
1ff10 20 2a 2f 0a 20 20 61 73 73 65 72 74 28 20 70 50 */. assert( pP
1ff20 61 67 65 72 2d 3e 65 53 74 61 74 65 3d 3d 50 41 ager->eState==PA
1ff30 47 45 52 5f 4f 50 45 4e 20 29 3b 0a 20 20 61 73 GER_OPEN );. as
1ff40 73 65 72 74 28 20 70 50 61 67 65 72 2d 3e 65 4c sert( pPager->eL
1ff50 6f 63 6b 3e 3d 53 48 41 52 45 44 5f 4c 4f 43 4b ock>=SHARED_LOCK
1ff60 20 29 3b 0a 20 20 6e 50 61 67 65 20 3d 20 73 71 );. nPage = sq
1ff70 6c 69 74 65 33 57 61 6c 44 62 73 69 7a 65 28 70 lite3WalDbsize(p
1ff80 50 61 67 65 72 2d 3e 70 57 61 6c 29 3b 0a 0a 20 Pager->pWal);..
1ff90 20 2f 2a 20 49 66 20 74 68 65 20 6e 75 6d 62 65 /* If the numbe
1ffa0 72 20 6f 66 20 70 61 67 65 73 20 69 6e 20 74 68 r of pages in th
1ffb0 65 20 64 61 74 61 62 61 73 65 20 69 73 20 6e 6f e database is no
1ffc0 74 20 61 76 61 69 6c 61 62 6c 65 20 66 72 6f 6d t available from
1ffd0 20 74 68 65 0a 20 20 2a 2a 20 57 41 4c 20 73 75 the. ** WAL su
1ffe0 62 2d 73 79 73 74 65 6d 2c 20 64 65 74 65 72 6d b-system, determ
1fff0 69 6e 65 20 74 68 65 20 70 61 67 65 20 63 6f 75 ine the page cou
20000 6e 74 65 20 62 61 73 65 64 20 6f 6e 20 74 68 65 nte based on the
20010 20 73 69 7a 65 20 6f 66 0a 20 20 2a 2a 20 74 68 size of. ** th
20020 65 20 64 61 74 61 62 61 73 65 20 66 69 6c 65 2e e database file.
20030 20 20 49 66 20 74 68 65 20 73 69 7a 65 20 6f 66 If the size of
20040 20 74 68 65 20 64 61 74 61 62 61 73 65 20 66 69 the database fi
20050 6c 65 20 69 73 20 6e 6f 74 20 61 6e 0a 20 20 2a le is not an. *
20060 2a 20 69 6e 74 65 67 65 72 20 6d 75 6c 74 69 70 * integer multip
20070 6c 65 20 6f 66 20 74 68 65 20 70 61 67 65 2d 73 le of the page-s
20080 69 7a 65 2c 20 72 6f 75 6e 64 20 75 70 20 74 68 ize, round up th
20090 65 20 72 65 73 75 6c 74 2e 0a 20 20 2a 2f 0a 20 e result.. */.
200a0 20 69 66 28 20 6e 50 61 67 65 3d 3d 30 20 29 7b if( nPage==0 ){
200b0 0a 20 20 20 20 69 36 34 20 6e 20 3d 20 30 3b 20 . i64 n = 0;
200c0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
200d0 20 20 20 2f 2a 20 53 69 7a 65 20 6f 66 20 64 62 /* Size of db
200e0 20 66 69 6c 65 20 69 6e 20 62 79 74 65 73 20 2a file in bytes *
200f0 2f 0a 20 20 20 20 61 73 73 65 72 74 28 20 69 73 /. assert( is
20100 4f 70 65 6e 28 70 50 61 67 65 72 2d 3e 66 64 29 Open(pPager->fd)
20110 20 7c 7c 20 70 50 61 67 65 72 2d 3e 74 65 6d 70 || pPager->temp
20120 46 69 6c 65 20 29 3b 0a 20 20 20 20 69 66 28 20 File );. if(
20130 69 73 4f 70 65 6e 28 70 50 61 67 65 72 2d 3e 66 isOpen(pPager->f
20140 64 29 20 29 7b 0a 20 20 20 20 20 20 69 6e 74 20 d) ){. int
20150 72 63 20 3d 20 73 71 6c 69 74 65 33 4f 73 46 69 rc = sqlite3OsFi
20160 6c 65 53 69 7a 65 28 70 50 61 67 65 72 2d 3e 66 leSize(pPager->f
20170 64 2c 20 26 6e 29 3b 0a 20 20 20 20 20 20 69 66 d, &n);. if
20180 28 20 72 63 21 3d 53 51 4c 49 54 45 5f 4f 4b 20 ( rc!=SQLITE_OK
20190 29 7b 0a 20 20 20 20 20 20 20 20 72 65 74 75 72 ){. retur
201a0 6e 20 72 63 3b 0a 20 20 20 20 20 20 7d 0a 20 20 n rc;. }.
201b0 20 20 7d 0a 20 20 20 20 6e 50 61 67 65 20 3d 20 }. nPage =
201c0 28 50 67 6e 6f 29 28 28 6e 2b 70 50 61 67 65 72 (Pgno)((n+pPager
201d0 2d 3e 70 61 67 65 53 69 7a 65 2d 31 29 20 2f 20 ->pageSize-1) /
201e0 70 50 61 67 65 72 2d 3e 70 61 67 65 53 69 7a 65 pPager->pageSize
201f0 29 3b 0a 20 20 7d 0a 0a 20 20 2f 2a 20 49 66 20 );. }.. /* If
20200 74 68 65 20 63 75 72 72 65 6e 74 20 6e 75 6d 62 the current numb
20210 65 72 20 6f 66 20 70 61 67 65 73 20 69 6e 20 74 er of pages in t
20220 68 65 20 66 69 6c 65 20 69 73 20 67 72 65 61 74 he file is great
20230 65 72 20 74 68 61 6e 20 74 68 65 0a 20 20 2a 2a er than the. **
20240 20 63 6f 6e 66 69 67 75 72 65 64 20 6d 61 78 69 configured maxi
20250 6d 75 6d 20 70 61 67 65 72 20 6e 75 6d 62 65 72 mum pager number
20260 2c 20 69 6e 63 72 65 61 73 65 20 74 68 65 20 61 , increase the a
20270 6c 6c 6f 77 65 64 20 6c 69 6d 69 74 20 73 6f 0a llowed limit so.
20280 20 20 2a 2a 20 74 68 61 74 20 74 68 65 20 66 69 ** that the fi
20290 6c 65 20 63 61 6e 20 62 65 20 72 65 61 64 2e 0a le can be read..
202a0 20 20 2a 2f 0a 20 20 69 66 28 20 6e 50 61 67 65 */. if( nPage
202b0 3e 70 50 61 67 65 72 2d 3e 6d 78 50 67 6e 6f 20 >pPager->mxPgno
202c0 29 7b 0a 20 20 20 20 70 50 61 67 65 72 2d 3e 6d ){. pPager->m
202d0 78 50 67 6e 6f 20 3d 20 28 50 67 6e 6f 29 6e 50 xPgno = (Pgno)nP
202e0 61 67 65 3b 0a 20 20 7d 0a 0a 20 20 2a 70 6e 50 age;. }.. *pnP
202f0 61 67 65 20 3d 20 6e 50 61 67 65 3b 0a 20 20 72 age = nPage;. r
20300 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b eturn SQLITE_OK;
20310 0a 7d 0a 0a 23 69 66 6e 64 65 66 20 53 51 4c 49 .}..#ifndef SQLI
20320 54 45 5f 4f 4d 49 54 5f 57 41 4c 0a 2f 2a 0a 2a TE_OMIT_WAL./*.*
20330 2a 20 43 68 65 63 6b 20 69 66 20 74 68 65 20 2a * Check if the *
20340 2d 77 61 6c 20 66 69 6c 65 20 74 68 61 74 20 63 -wal file that c
20350 6f 72 72 65 73 70 6f 6e 64 73 20 74 6f 20 74 68 orresponds to th
20360 65 20 64 61 74 61 62 61 73 65 20 6f 70 65 6e 65 e database opene
20370 64 20 62 79 20 70 50 61 67 65 72 0a 2a 2a 20 65 d by pPager.** e
20380 78 69 73 74 73 20 69 66 20 74 68 65 20 64 61 74 xists if the dat
20390 61 62 61 73 65 20 69 73 20 6e 6f 74 20 65 6d 70 abase is not emp
203a0 79 2c 20 6f 72 20 76 65 72 69 66 79 20 74 68 61 y, or verify tha
203b0 74 20 74 68 65 20 2a 2d 77 61 6c 20 66 69 6c 65 t the *-wal file
203c0 20 64 6f 65 73 0a 2a 2a 20 6e 6f 74 20 65 78 69 does.** not exi
203d0 73 74 20 28 62 79 20 64 65 6c 65 74 69 6e 67 20 st (by deleting
203e0 69 74 29 20 69 66 20 74 68 65 20 64 61 74 61 62 it) if the datab
203f0 61 73 65 20 66 69 6c 65 20 69 73 20 65 6d 70 74 ase file is empt
20400 79 2e 0a 2a 2a 0a 2a 2a 20 49 66 20 74 68 65 20 y..**.** If the
20410 64 61 74 61 62 61 73 65 20 69 73 20 6e 6f 74 20 database is not
20420 65 6d 70 74 79 20 61 6e 64 20 74 68 65 20 2a 2d empty and the *-
20430 77 61 6c 20 66 69 6c 65 20 65 78 69 73 74 73 2c wal file exists,
20440 20 6f 70 65 6e 20 74 68 65 20 70 61 67 65 72 0a open the pager.
20450 2a 2a 20 69 6e 20 57 41 4c 20 6d 6f 64 65 2e 20 ** in WAL mode.
20460 20 49 66 20 74 68 65 20 64 61 74 61 62 61 73 65 If the database
20470 20 69 73 20 65 6d 70 74 79 20 6f 72 20 69 66 20 is empty or if
20480 6e 6f 20 2a 2d 77 61 6c 20 66 69 6c 65 20 65 78 no *-wal file ex
20490 69 73 74 73 20 61 6e 64 0a 2a 2a 20 69 66 20 6e ists and.** if n
204a0 6f 20 65 72 72 6f 72 20 6f 63 63 75 72 73 2c 20 o error occurs,
204b0 6d 61 6b 65 20 73 75 72 65 20 50 61 67 65 72 2e make sure Pager.
204c0 6a 6f 75 72 6e 61 6c 4d 6f 64 65 20 69 73 20 6e journalMode is n
204d0 6f 74 20 73 65 74 20 74 6f 0a 2a 2a 20 50 41 47 ot set to.** PAG
204e0 45 52 5f 4a 4f 55 52 4e 41 4c 4d 4f 44 45 5f 57 ER_JOURNALMODE_W
204f0 41 4c 2e 0a 2a 2a 0a 2a 2a 20 52 65 74 75 72 6e AL..**.** Return
20500 20 53 51 4c 49 54 45 5f 4f 4b 20 6f 72 20 61 6e SQLITE_OK or an
20510 20 65 72 72 6f 72 20 63 6f 64 65 2e 0a 2a 2a 0a error code..**.
20520 2a 2a 20 54 68 65 20 63 61 6c 6c 65 72 20 6d 75 ** The caller mu
20530 73 74 20 68 6f 6c 64 20 61 20 53 48 41 52 45 44 st hold a SHARED
20540 20 6c 6f 63 6b 20 6f 6e 20 74 68 65 20 64 61 74 lock on the dat
20550 61 62 61 73 65 20 66 69 6c 65 20 74 6f 20 63 61 abase file to ca
20560 6c 6c 20 74 68 69 73 0a 2a 2a 20 66 75 6e 63 74 ll this.** funct
20570 69 6f 6e 2e 20 42 65 63 61 75 73 65 20 61 6e 20 ion. Because an
20580 45 58 43 4c 55 53 49 56 45 20 6c 6f 63 6b 20 6f EXCLUSIVE lock o
20590 6e 20 74 68 65 20 64 62 20 66 69 6c 65 20 69 73 n the db file is
205a0 20 72 65 71 75 69 72 65 64 20 74 6f 20 64 65 6c required to del
205b0 65 74 65 20 0a 2a 2a 20 61 20 57 41 4c 20 6f 6e ete .** a WAL on
205c0 20 61 20 6e 6f 6e 65 2d 65 6d 70 74 79 20 64 61 a none-empty da
205d0 74 61 62 61 73 65 2c 20 74 68 69 73 20 65 6e 73 tabase, this ens
205e0 75 72 65 73 20 74 68 65 72 65 20 69 73 20 6e 6f ures there is no
205f0 20 72 61 63 65 20 63 6f 6e 64 69 74 69 6f 6e 20 race condition
20600 0a 2a 2a 20 62 65 74 77 65 65 6e 20 74 68 65 20 .** between the
20610 78 41 63 63 65 73 73 28 29 20 62 65 6c 6f 77 20 xAccess() below
20620 61 6e 64 20 61 6e 20 78 44 65 6c 65 74 65 28 29 and an xDelete()
20630 20 62 65 69 6e 67 20 65 78 65 63 75 74 65 64 20 being executed
20640 62 79 20 73 6f 6d 65 20 0a 2a 2a 20 6f 74 68 65 by some .** othe
20650 72 20 63 6f 6e 6e 65 63 74 69 6f 6e 2e 0a 2a 2f r connection..*/
20660 0a 73 74 61 74 69 63 20 69 6e 74 20 70 61 67 65 .static int page
20670 72 4f 70 65 6e 57 61 6c 49 66 50 72 65 73 65 6e rOpenWalIfPresen
20680 74 28 50 61 67 65 72 20 2a 70 50 61 67 65 72 29 t(Pager *pPager)
20690 7b 0a 20 20 69 6e 74 20 72 63 20 3d 20 53 51 4c {. int rc = SQL
206a0 49 54 45 5f 4f 4b 3b 0a 20 20 61 73 73 65 72 74 ITE_OK;. assert
206b0 28 20 70 50 61 67 65 72 2d 3e 65 53 74 61 74 65 ( pPager->eState
206c0 3d 3d 50 41 47 45 52 5f 4f 50 45 4e 20 29 3b 0a ==PAGER_OPEN );.
206d0 20 20 61 73 73 65 72 74 28 20 70 50 61 67 65 72 assert( pPager
206e0 2d 3e 65 4c 6f 63 6b 3e 3d 53 48 41 52 45 44 5f ->eLock>=SHARED_
206f0 4c 4f 43 4b 20 29 3b 0a 0a 20 20 69 66 28 20 21 LOCK );.. if( !
20700 70 50 61 67 65 72 2d 3e 74 65 6d 70 46 69 6c 65 pPager->tempFile
20710 20 29 7b 0a 20 20 20 20 69 6e 74 20 69 73 57 61 ){. int isWa
20720 6c 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 l;
20730 20 20 20 20 20 20 2f 2a 20 54 72 75 65 20 69 66 /* True if
20740 20 57 41 4c 20 66 69 6c 65 20 65 78 69 73 74 73 WAL file exists
20750 20 2a 2f 0a 20 20 20 20 50 67 6e 6f 20 6e 50 61 */. Pgno nPa
20760 67 65 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 ge;
20770 20 20 20 20 20 20 2f 2a 20 53 69 7a 65 20 6f 66 /* Size of
20780 20 74 68 65 20 64 61 74 61 62 61 73 65 20 66 69 the database fi
20790 6c 65 20 2a 2f 0a 0a 20 20 20 20 72 63 20 3d 20 le */.. rc =
207a0 70 61 67 65 72 50 61 67 65 63 6f 75 6e 74 28 70 pagerPagecount(p
207b0 50 61 67 65 72 2c 20 26 6e 50 61 67 65 29 3b 0a Pager, &nPage);.
207c0 20 20 20 20 69 66 28 20 72 63 20 29 20 72 65 74 if( rc ) ret
207d0 75 72 6e 20 72 63 3b 0a 20 20 20 20 69 66 28 20 urn rc;. if(
207e0 6e 50 61 67 65 3d 3d 30 20 29 7b 0a 20 20 20 20 nPage==0 ){.
207f0 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33 4f 73 rc = sqlite3Os
20800 44 65 6c 65 74 65 28 70 50 61 67 65 72 2d 3e 70 Delete(pPager->p
20810 56 66 73 2c 20 70 50 61 67 65 72 2d 3e 7a 57 61 Vfs, pPager->zWa
20820 6c 2c 20 30 29 3b 0a 20 20 20 20 20 20 69 66 28 l, 0);. if(
20830 20 72 63 3d 3d 53 51 4c 49 54 45 5f 49 4f 45 52 rc==SQLITE_IOER
20840 52 5f 44 45 4c 45 54 45 5f 4e 4f 45 4e 54 20 29 R_DELETE_NOENT )
20850 20 72 63 20 3d 20 53 51 4c 49 54 45 5f 4f 4b 3b rc = SQLITE_OK;
20860 0a 20 20 20 20 20 20 69 73 57 61 6c 20 3d 20 30 . isWal = 0
20870 3b 0a 20 20 20 20 7d 65 6c 73 65 7b 0a 20 20 20 ;. }else{.
20880 20 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33 4f rc = sqlite3O
20890 73 41 63 63 65 73 73 28 0a 20 20 20 20 20 20 20 sAccess(.
208a0 20 20 20 70 50 61 67 65 72 2d 3e 70 56 66 73 2c pPager->pVfs,
208b0 20 70 50 61 67 65 72 2d 3e 7a 57 61 6c 2c 20 53 pPager->zWal, S
208c0 51 4c 49 54 45 5f 41 43 43 45 53 53 5f 45 58 49 QLITE_ACCESS_EXI
208d0 53 54 53 2c 20 26 69 73 57 61 6c 0a 20 20 20 20 STS, &isWal.
208e0 20 20 29 3b 0a 20 20 20 20 7d 0a 20 20 20 20 69 );. }. i
208f0 66 28 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b f( rc==SQLITE_OK
20900 20 29 7b 0a 20 20 20 20 20 20 69 66 28 20 69 73 ){. if( is
20910 57 61 6c 20 29 7b 0a 20 20 20 20 20 20 20 20 74 Wal ){. t
20920 65 73 74 63 61 73 65 28 20 73 71 6c 69 74 65 33 estcase( sqlite3
20930 50 63 61 63 68 65 50 61 67 65 63 6f 75 6e 74 28 PcachePagecount(
20940 70 50 61 67 65 72 2d 3e 70 50 43 61 63 68 65 29 pPager->pPCache)
20950 3d 3d 30 20 29 3b 0a 20 20 20 20 20 20 20 20 72 ==0 );. r
20960 63 20 3d 20 73 71 6c 69 74 65 33 50 61 67 65 72 c = sqlite3Pager
20970 4f 70 65 6e 57 61 6c 28 70 50 61 67 65 72 2c 20 OpenWal(pPager,
20980 30 29 3b 0a 20 20 20 20 20 20 7d 65 6c 73 65 20 0);. }else
20990 69 66 28 20 70 50 61 67 65 72 2d 3e 6a 6f 75 72 if( pPager->jour
209a0 6e 61 6c 4d 6f 64 65 3d 3d 50 41 47 45 52 5f 4a nalMode==PAGER_J
209b0 4f 55 52 4e 41 4c 4d 4f 44 45 5f 57 41 4c 20 29 OURNALMODE_WAL )
209c0 7b 0a 20 20 20 20 20 20 20 20 70 50 61 67 65 72 {. pPager
209d0 2d 3e 6a 6f 75 72 6e 61 6c 4d 6f 64 65 20 3d 20 ->journalMode =
209e0 50 41 47 45 52 5f 4a 4f 55 52 4e 41 4c 4d 4f 44 PAGER_JOURNALMOD
209f0 45 5f 44 45 4c 45 54 45 3b 0a 20 20 20 20 20 20 E_DELETE;.
20a00 7d 0a 20 20 20 20 7d 0a 20 20 7d 0a 20 20 72 65 }. }. }. re
20a10 74 75 72 6e 20 72 63 3b 0a 7d 0a 23 65 6e 64 69 turn rc;.}.#endi
20a20 66 0a 0a 2f 2a 0a 2a 2a 20 50 6c 61 79 62 61 63 f../*.** Playbac
20a30 6b 20 73 61 76 65 70 6f 69 6e 74 20 70 53 61 76 k savepoint pSav
20a40 65 70 6f 69 6e 74 2e 20 4f 72 2c 20 69 66 20 70 epoint. Or, if p
20a50 53 61 76 65 70 6f 69 6e 74 3d 3d 4e 55 4c 4c 2c Savepoint==NULL,
20a60 20 74 68 65 6e 20 70 6c 61 79 62 61 63 6b 0a 2a then playback.*
20a70 2a 20 74 68 65 20 65 6e 74 69 72 65 20 6d 61 73 * the entire mas
20a80 74 65 72 20 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 ter journal file
20a90 2e 20 54 68 65 20 63 61 73 65 20 70 53 61 76 65 . The case pSave
20aa0 70 6f 69 6e 74 3d 3d 4e 55 4c 4c 20 6f 63 63 75 point==NULL occu
20ab0 72 73 20 77 68 65 6e 20 0a 2a 2a 20 61 20 52 4f rs when .** a RO
20ac0 4c 4c 42 41 43 4b 20 54 4f 20 63 6f 6d 6d 61 6e LLBACK TO comman
20ad0 64 20 69 73 20 69 6e 76 6f 6b 65 64 20 6f 6e 20 d is invoked on
20ae0 61 20 53 41 56 45 50 4f 49 4e 54 20 74 68 61 74 a SAVEPOINT that
20af0 20 69 73 20 61 20 74 72 61 6e 73 61 63 74 69 6f is a transactio
20b00 6e 20 0a 2a 2a 20 73 61 76 65 70 6f 69 6e 74 2e n .** savepoint.
20b10 0a 2a 2a 0a 2a 2a 20 57 68 65 6e 20 70 53 61 76 .**.** When pSav
20b20 65 70 6f 69 6e 74 20 69 73 20 6e 6f 74 20 4e 55 epoint is not NU
20b30 4c 4c 20 28 6d 65 61 6e 69 6e 67 20 61 20 6e 6f LL (meaning a no
20b40 6e 2d 74 72 61 6e 73 61 63 74 69 6f 6e 20 73 61 n-transaction sa
20b50 76 65 70 6f 69 6e 74 20 69 73 20 0a 2a 2a 20 62 vepoint is .** b
20b60 65 69 6e 67 20 72 6f 6c 6c 65 64 20 62 61 63 6b eing rolled back
20b70 29 2c 20 74 68 65 6e 20 74 68 65 20 72 6f 6c 6c ), then the roll
20b80 62 61 63 6b 20 63 6f 6e 73 69 73 74 73 20 6f 66 back consists of
20b90 20 75 70 20 74 6f 20 74 68 72 65 65 20 73 74 61 up to three sta
20ba0 67 65 73 2c 0a 2a 2a 20 70 65 72 66 6f 72 6d 65 ges,.** performe
20bb0 64 20 69 6e 20 74 68 65 20 6f 72 64 65 72 20 73 d in the order s
20bc0 70 65 63 69 66 69 65 64 3a 0a 2a 2a 0a 2a 2a 20 pecified:.**.**
20bd0 20 20 2a 20 50 61 67 65 73 20 61 72 65 20 70 6c * Pages are pl
20be0 61 79 65 64 20 62 61 63 6b 20 66 72 6f 6d 20 74 ayed back from t
20bf0 68 65 20 6d 61 69 6e 20 6a 6f 75 72 6e 61 6c 20 he main journal
20c00 73 74 61 72 74 69 6e 67 20 61 74 20 62 79 74 65 starting at byte
20c10 0a 2a 2a 20 20 20 20 20 6f 66 66 73 65 74 20 50 .** offset P
20c20 61 67 65 72 53 61 76 65 70 6f 69 6e 74 2e 69 4f agerSavepoint.iO
20c30 66 66 73 65 74 20 61 6e 64 20 63 6f 6e 74 69 6e ffset and contin
20c40 75 69 6e 67 20 74 6f 20 0a 2a 2a 20 20 20 20 20 uing to .**
20c50 50 61 67 65 72 53 61 76 65 70 6f 69 6e 74 2e 69 PagerSavepoint.i
20c60 48 64 72 4f 66 66 73 65 74 2c 20 6f 72 20 74 6f HdrOffset, or to
20c70 20 74 68 65 20 65 6e 64 20 6f 66 20 74 68 65 20 the end of the
20c80 6d 61 69 6e 20 6a 6f 75 72 6e 61 6c 0a 2a 2a 20 main journal.**
20c90 20 20 20 20 66 69 6c 65 20 69 66 20 50 61 67 65 file if Page
20ca0 72 53 61 76 65 70 6f 69 6e 74 2e 69 48 64 72 4f rSavepoint.iHdrO
20cb0 66 66 73 65 74 20 69 73 20 7a 65 72 6f 2e 0a 2a ffset is zero..*
20cc0 2a 0a 2a 2a 20 20 20 2a 20 49 66 20 50 61 67 65 *.** * If Page
20cd0 72 53 61 76 65 70 6f 69 6e 74 2e 69 48 64 72 4f rSavepoint.iHdrO
20ce0 66 66 73 65 74 20 69 73 20 6e 6f 74 20 7a 65 72 ffset is not zer
20cf0 6f 2c 20 74 68 65 6e 20 70 61 67 65 73 20 61 72 o, then pages ar
20d00 65 20 70 6c 61 79 65 64 0a 2a 2a 20 20 20 20 20 e played.**
20d10 62 61 63 6b 20 73 74 61 72 74 69 6e 67 20 66 72 back starting fr
20d20 6f 6d 20 74 68 65 20 6a 6f 75 72 6e 61 6c 20 68 om the journal h
20d30 65 61 64 65 72 20 69 6d 6d 65 64 69 61 74 65 6c eader immediatel
20d40 79 20 66 6f 6c 6c 6f 77 69 6e 67 20 0a 2a 2a 20 y following .**
20d50 20 20 20 20 50 61 67 65 72 53 61 76 65 70 6f 69 PagerSavepoi
20d60 6e 74 2e 69 48 64 72 4f 66 66 73 65 74 20 74 6f nt.iHdrOffset to
20d70 20 74 68 65 20 65 6e 64 20 6f 66 20 74 68 65 20 the end of the
20d80 6d 61 69 6e 20 6a 6f 75 72 6e 61 6c 20 66 69 6c main journal fil
20d90 65 2e 0a 2a 2a 0a 2a 2a 20 20 20 2a 20 50 61 67 e..**.** * Pag
20da0 65 73 20 61 72 65 20 74 68 65 6e 20 70 6c 61 79 es are then play
20db0 65 64 20 62 61 63 6b 20 66 72 6f 6d 20 74 68 65 ed back from the
20dc0 20 73 75 62 2d 6a 6f 75 72 6e 61 6c 20 66 69 6c sub-journal fil
20dd0 65 2c 20 73 74 61 72 74 69 6e 67 0a 2a 2a 20 20 e, starting.**
20de0 20 20 20 77 69 74 68 20 74 68 65 20 50 61 67 65 with the Page
20df0 72 53 61 76 65 70 6f 69 6e 74 2e 69 53 75 62 52 rSavepoint.iSubR
20e00 65 63 20 61 6e 64 20 63 6f 6e 74 69 6e 75 69 6e ec and continuin
20e10 67 20 74 6f 20 74 68 65 20 65 6e 64 20 6f 66 0a g to the end of.
20e20 2a 2a 20 20 20 20 20 74 68 65 20 6a 6f 75 72 6e ** the journ
20e30 61 6c 20 66 69 6c 65 2e 0a 2a 2a 0a 2a 2a 20 54 al file..**.** T
20e40 68 72 6f 75 67 68 6f 75 74 20 74 68 65 20 72 6f hroughout the ro
20e50 6c 6c 62 61 63 6b 20 70 72 6f 63 65 73 73 2c 20 llback process,
20e60 65 61 63 68 20 74 69 6d 65 20 61 20 70 61 67 65 each time a page
20e70 20 69 73 20 72 6f 6c 6c 65 64 20 62 61 63 6b 2c is rolled back,
20e80 20 74 68 65 0a 2a 2a 20 63 6f 72 72 65 73 70 6f the.** correspo
20e90 6e 64 69 6e 67 20 62 69 74 20 69 73 20 73 65 74 nding bit is set
20ea0 20 69 6e 20 61 20 62 69 74 76 65 63 20 73 74 72 in a bitvec str
20eb0 75 63 74 75 72 65 20 28 76 61 72 69 61 62 6c 65 ucture (variable
20ec0 20 70 44 6f 6e 65 20 69 6e 20 74 68 65 0a 2a 2a pDone in the.**
20ed0 20 69 6d 70 6c 65 6d 65 6e 74 61 74 69 6f 6e 20 implementation
20ee0 62 65 6c 6f 77 29 2e 20 54 68 69 73 20 69 73 20 below). This is
20ef0 75 73 65 64 20 74 6f 20 65 6e 73 75 72 65 20 74 used to ensure t
20f00 68 61 74 20 61 20 70 61 67 65 20 69 73 20 6f 6e hat a page is on
20f10 6c 79 0a 2a 2a 20 72 6f 6c 6c 65 64 20 62 61 63 ly.** rolled bac
20f20 6b 20 74 68 65 20 66 69 72 73 74 20 74 69 6d 65 k the first time
20f30 20 69 74 20 69 73 20 65 6e 63 6f 75 6e 74 65 72 it is encounter
20f40 65 64 20 69 6e 20 65 69 74 68 65 72 20 6a 6f 75 ed in either jou
20f50 72 6e 61 6c 2e 0a 2a 2a 0a 2a 2a 20 49 66 20 70 rnal..**.** If p
20f60 53 61 76 65 70 6f 69 6e 74 20 69 73 20 4e 55 4c Savepoint is NUL
20f70 4c 2c 20 74 68 65 6e 20 70 61 67 65 73 20 61 72 L, then pages ar
20f80 65 20 6f 6e 6c 79 20 70 6c 61 79 65 64 20 62 61 e only played ba
20f90 63 6b 20 66 72 6f 6d 20 74 68 65 20 6d 61 69 6e ck from the main
20fa0 0a 2a 2a 20 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 .** journal file
20fb0 2e 20 54 68 65 72 65 20 69 73 20 6e 6f 20 6e 65 . There is no ne
20fc0 65 64 20 66 6f 72 20 61 20 62 69 74 76 65 63 20 ed for a bitvec
20fd0 69 6e 20 74 68 69 73 20 63 61 73 65 2e 0a 2a 2a in this case..**
20fe0 0a 2a 2a 20 49 6e 20 65 69 74 68 65 72 20 63 61 .** In either ca
20ff0 73 65 2c 20 62 65 66 6f 72 65 20 70 6c 61 79 62 se, before playb
21000 61 63 6b 20 63 6f 6d 6d 65 6e 63 65 73 20 74 68 ack commences th
21010 65 20 50 61 67 65 72 2e 64 62 53 69 7a 65 20 76 e Pager.dbSize v
21020 61 72 69 61 62 6c 65 0a 2a 2a 20 69 73 20 72 65 ariable.** is re
21030 73 65 74 20 74 6f 20 74 68 65 20 76 61 6c 75 65 set to the value
21040 20 74 68 61 74 20 69 74 20 68 65 6c 64 20 61 74 that it held at
21050 20 74 68 65 20 73 74 61 72 74 20 6f 66 20 74 68 the start of th
21060 65 20 73 61 76 65 70 6f 69 6e 74 20 0a 2a 2a 20 e savepoint .**
21070 28 6f 72 20 74 72 61 6e 73 61 63 74 69 6f 6e 29 (or transaction)
21080 2e 20 4e 6f 20 70 61 67 65 20 77 69 74 68 20 61 . No page with a
21090 20 70 61 67 65 2d 6e 75 6d 62 65 72 20 67 72 65 page-number gre
210a0 61 74 65 72 20 74 68 61 6e 20 74 68 69 73 20 76 ater than this v
210b0 61 6c 75 65 0a 2a 2a 20 69 73 20 70 6c 61 79 65 alue.** is playe
210c0 64 20 62 61 63 6b 2e 20 49 66 20 6f 6e 65 20 69 d back. If one i
210d0 73 20 65 6e 63 6f 75 6e 74 65 72 65 64 20 69 74 s encountered it
210e0 20 69 73 20 73 69 6d 70 6c 79 20 73 6b 69 70 70 is simply skipp
210f0 65 64 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e ed..*/.static in
21100 74 20 70 61 67 65 72 50 6c 61 79 62 61 63 6b 53 t pagerPlaybackS
21110 61 76 65 70 6f 69 6e 74 28 50 61 67 65 72 20 2a avepoint(Pager *
21120 70 50 61 67 65 72 2c 20 50 61 67 65 72 53 61 76 pPager, PagerSav
21130 65 70 6f 69 6e 74 20 2a 70 53 61 76 65 70 6f 69 epoint *pSavepoi
21140 6e 74 29 7b 0a 20 20 69 36 34 20 73 7a 4a 3b 20 nt){. i64 szJ;
21150 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
21160 2f 2a 20 45 66 66 65 63 74 69 76 65 20 73 69 7a /* Effective siz
21170 65 20 6f 66 20 74 68 65 20 6d 61 69 6e 20 6a 6f e of the main jo
21180 75 72 6e 61 6c 20 2a 2f 0a 20 20 69 36 34 20 69 urnal */. i64 i
21190 48 64 72 4f 66 66 3b 20 20 20 20 20 20 20 20 20 HdrOff;
211a0 20 20 20 20 2f 2a 20 45 6e 64 20 6f 66 20 66 69 /* End of fi
211b0 72 73 74 20 73 65 67 6d 65 6e 74 20 6f 66 20 6d rst segment of m
211c0 61 69 6e 2d 6a 6f 75 72 6e 61 6c 20 72 65 63 6f ain-journal reco
211d0 72 64 73 20 2a 2f 0a 20 20 69 6e 74 20 72 63 20 rds */. int rc
211e0 3d 20 53 51 4c 49 54 45 5f 4f 4b 3b 20 20 20 20 = SQLITE_OK;
211f0 20 20 2f 2a 20 52 65 74 75 72 6e 20 63 6f 64 65 /* Return code
21200 20 2a 2f 0a 20 20 42 69 74 76 65 63 20 2a 70 44 */. Bitvec *pD
21210 6f 6e 65 20 3d 20 30 3b 20 20 20 20 20 20 20 2f one = 0; /
21220 2a 20 42 69 74 76 65 63 20 74 6f 20 65 6e 73 75 * Bitvec to ensu
21230 72 65 20 70 61 67 65 73 20 70 6c 61 79 65 64 20 re pages played
21240 62 61 63 6b 20 6f 6e 6c 79 20 6f 6e 63 65 20 2a back only once *
21250 2f 0a 0a 20 20 61 73 73 65 72 74 28 20 70 50 61 /.. assert( pPa
21260 67 65 72 2d 3e 65 53 74 61 74 65 21 3d 50 41 47 ger->eState!=PAG
21270 45 52 5f 45 52 52 4f 52 20 29 3b 0a 20 20 61 73 ER_ERROR );. as
21280 73 65 72 74 28 20 70 50 61 67 65 72 2d 3e 65 53 sert( pPager->eS
21290 74 61 74 65 3e 3d 50 41 47 45 52 5f 57 52 49 54 tate>=PAGER_WRIT
212a0 45 52 5f 4c 4f 43 4b 45 44 20 29 3b 0a 0a 20 20 ER_LOCKED );..
212b0 2f 2a 20 41 6c 6c 6f 63 61 74 65 20 61 20 62 69 /* Allocate a bi
212c0 74 76 65 63 20 74 6f 20 75 73 65 20 74 6f 20 73 tvec to use to s
212d0 74 6f 72 65 20 74 68 65 20 73 65 74 20 6f 66 20 tore the set of
212e0 70 61 67 65 73 20 72 6f 6c 6c 65 64 20 62 61 63 pages rolled bac
212f0 6b 20 2a 2f 0a 20 20 69 66 28 20 70 53 61 76 65 k */. if( pSave
21300 70 6f 69 6e 74 20 29 7b 0a 20 20 20 20 70 44 6f point ){. pDo
21310 6e 65 20 3d 20 73 71 6c 69 74 65 33 42 69 74 76 ne = sqlite3Bitv
21320 65 63 43 72 65 61 74 65 28 70 53 61 76 65 70 6f ecCreate(pSavepo
21330 69 6e 74 2d 3e 6e 4f 72 69 67 29 3b 0a 20 20 20 int->nOrig);.
21340 20 69 66 28 20 21 70 44 6f 6e 65 20 29 7b 0a 20 if( !pDone ){.
21350 20 20 20 20 20 72 65 74 75 72 6e 20 53 51 4c 49 return SQLI
21360 54 45 5f 4e 4f 4d 45 4d 5f 42 4b 50 54 3b 0a 20 TE_NOMEM_BKPT;.
21370 20 20 20 7d 0a 20 20 7d 0a 0a 20 20 2f 2a 20 53 }. }.. /* S
21380 65 74 20 74 68 65 20 64 61 74 61 62 61 73 65 20 et the database
21390 73 69 7a 65 20 62 61 63 6b 20 74 6f 20 74 68 65 size back to the
213a0 20 76 61 6c 75 65 20 69 74 20 77 61 73 20 62 65 value it was be
213b0 66 6f 72 65 20 74 68 65 20 73 61 76 65 70 6f 69 fore the savepoi
213c0 6e 74 20 0a 20 20 2a 2a 20 62 65 69 6e 67 20 72 nt . ** being r
213d0 65 76 65 72 74 65 64 20 77 61 73 20 6f 70 65 6e everted was open
213e0 65 64 2e 0a 20 20 2a 2f 0a 20 20 70 50 61 67 65 ed.. */. pPage
213f0 72 2d 3e 64 62 53 69 7a 65 20 3d 20 70 53 61 76 r->dbSize = pSav
21400 65 70 6f 69 6e 74 20 3f 20 70 53 61 76 65 70 6f epoint ? pSavepo
21410 69 6e 74 2d 3e 6e 4f 72 69 67 20 3a 20 70 50 61 int->nOrig : pPa
21420 67 65 72 2d 3e 64 62 4f 72 69 67 53 69 7a 65 3b ger->dbOrigSize;
21430 0a 20 20 70 50 61 67 65 72 2d 3e 63 68 61 6e 67 . pPager->chang
21440 65 43 6f 75 6e 74 44 6f 6e 65 20 3d 20 70 50 61 eCountDone = pPa
21450 67 65 72 2d 3e 74 65 6d 70 46 69 6c 65 3b 0a 0a ger->tempFile;..
21460 20 20 69 66 28 20 21 70 53 61 76 65 70 6f 69 6e if( !pSavepoin
21470 74 20 26 26 20 70 61 67 65 72 55 73 65 57 61 6c t && pagerUseWal
21480 28 70 50 61 67 65 72 29 20 29 7b 0a 20 20 20 20 (pPager) ){.
21490 72 65 74 75 72 6e 20 70 61 67 65 72 52 6f 6c 6c return pagerRoll
214a0 62 61 63 6b 57 61 6c 28 70 50 61 67 65 72 29 3b backWal(pPager);
214b0 0a 20 20 7d 0a 0a 20 20 2f 2a 20 55 73 65 20 70 . }.. /* Use p
214c0 50 61 67 65 72 2d 3e 6a 6f 75 72 6e 61 6c 4f 66 Pager->journalOf
214d0 66 20 61 73 20 74 68 65 20 65 66 66 65 63 74 69 f as the effecti
214e0 76 65 20 73 69 7a 65 20 6f 66 20 74 68 65 20 6d ve size of the m
214f0 61 69 6e 20 72 6f 6c 6c 62 61 63 6b 0a 20 20 2a ain rollback. *
21500 2a 20 6a 6f 75 72 6e 61 6c 2e 20 20 54 68 65 20 * journal. The
21510 61 63 74 75 61 6c 20 66 69 6c 65 20 6d 69 67 68 actual file migh
21520 74 20 62 65 20 6c 61 72 67 65 72 20 74 68 61 6e t be larger than
21530 20 74 68 69 73 20 69 6e 0a 20 20 2a 2a 20 50 41 this in. ** PA
21540 47 45 52 5f 4a 4f 55 52 4e 41 4c 4d 4f 44 45 5f GER_JOURNALMODE_
21550 54 52 55 4e 43 41 54 45 20 6f 72 20 50 41 47 45 TRUNCATE or PAGE
21560 52 5f 4a 4f 55 52 4e 41 4c 4d 4f 44 45 5f 50 45 R_JOURNALMODE_PE
21570 52 53 49 53 54 2e 20 20 42 75 74 20 61 6e 79 74 RSIST. But anyt
21580 68 69 6e 67 0a 20 20 2a 2a 20 70 61 73 74 20 70 hing. ** past p
21590 50 61 67 65 72 2d 3e 6a 6f 75 72 6e 61 6c 4f 66 Pager->journalOf
215a0 66 20 69 73 20 6f 66 66 2d 6c 69 6d 69 74 73 20 f is off-limits
215b0 74 6f 20 75 73 2e 0a 20 20 2a 2f 0a 20 20 73 7a to us.. */. sz
215c0 4a 20 3d 20 70 50 61 67 65 72 2d 3e 6a 6f 75 72 J = pPager->jour
215d0 6e 61 6c 4f 66 66 3b 0a 20 20 61 73 73 65 72 74 nalOff;. assert
215e0 28 20 70 61 67 65 72 55 73 65 57 61 6c 28 70 50 ( pagerUseWal(pP
215f0 61 67 65 72 29 3d 3d 30 20 7c 7c 20 73 7a 4a 3d ager)==0 || szJ=
21600 3d 30 20 29 3b 0a 0a 20 20 2f 2a 20 42 65 67 69 =0 );.. /* Begi
21610 6e 20 62 79 20 72 6f 6c 6c 69 6e 67 20 62 61 63 n by rolling bac
21620 6b 20 72 65 63 6f 72 64 73 20 66 72 6f 6d 20 74 k records from t
21630 68 65 20 6d 61 69 6e 20 6a 6f 75 72 6e 61 6c 20 he main journal
21640 73 74 61 72 74 69 6e 67 20 61 74 0a 20 20 2a 2a starting at. **
21650 20 50 61 67 65 72 53 61 76 65 70 6f 69 6e 74 2e PagerSavepoint.
21660 69 4f 66 66 73 65 74 20 61 6e 64 20 63 6f 6e 74 iOffset and cont
21670 69 6e 75 69 6e 67 20 74 6f 20 74 68 65 20 6e 65 inuing to the ne
21680 78 74 20 6a 6f 75 72 6e 61 6c 20 68 65 61 64 65 xt journal heade
21690 72 2e 0a 20 20 2a 2a 20 54 68 65 72 65 20 6d 69 r.. ** There mi
216a0 67 68 74 20 62 65 20 72 65 63 6f 72 64 73 20 69 ght be records i
216b0 6e 20 74 68 65 20 6d 61 69 6e 20 6a 6f 75 72 6e n the main journ
216c0 61 6c 20 74 68 61 74 20 68 61 76 65 20 61 20 70 al that have a p
216d0 61 67 65 20 6e 75 6d 62 65 72 0a 20 20 2a 2a 20 age number. **
216e0 67 72 65 61 74 65 72 20 74 68 61 6e 20 74 68 65 greater than the
216f0 20 63 75 72 72 65 6e 74 20 64 61 74 61 62 61 73 current databas
21700 65 20 73 69 7a 65 20 28 70 50 61 67 65 72 2d 3e e size (pPager->
21710 64 62 53 69 7a 65 29 20 62 75 74 20 74 68 6f 73 dbSize) but thos
21720 65 0a 20 20 2a 2a 20 77 69 6c 6c 20 62 65 20 73 e. ** will be s
21730 6b 69 70 70 65 64 20 61 75 74 6f 6d 61 74 69 63 kipped automatic
21740 61 6c 6c 79 2e 20 20 50 61 67 65 73 20 61 72 65 ally. Pages are
21750 20 61 64 64 65 64 20 74 6f 20 70 44 6f 6e 65 20 added to pDone
21760 61 73 20 74 68 65 79 0a 20 20 2a 2a 20 61 72 65 as they. ** are
21770 20 70 6c 61 79 65 64 20 62 61 63 6b 2e 0a 20 20 played back..
21780 2a 2f 0a 20 20 69 66 28 20 70 53 61 76 65 70 6f */. if( pSavepo
21790 69 6e 74 20 26 26 20 21 70 61 67 65 72 55 73 65 int && !pagerUse
217a0 57 61 6c 28 70 50 61 67 65 72 29 20 29 7b 0a 20 Wal(pPager) ){.
217b0 20 20 20 69 48 64 72 4f 66 66 20 3d 20 70 53 61 iHdrOff = pSa
217c0 76 65 70 6f 69 6e 74 2d 3e 69 48 64 72 4f 66 66 vepoint->iHdrOff
217d0 73 65 74 20 3f 20 70 53 61 76 65 70 6f 69 6e 74 set ? pSavepoint
217e0 2d 3e 69 48 64 72 4f 66 66 73 65 74 20 3a 20 73 ->iHdrOffset : s
217f0 7a 4a 3b 0a 20 20 20 20 70 50 61 67 65 72 2d 3e zJ;. pPager->
21800 6a 6f 75 72 6e 61 6c 4f 66 66 20 3d 20 70 53 61 journalOff = pSa
21810 76 65 70 6f 69 6e 74 2d 3e 69 4f 66 66 73 65 74 vepoint->iOffset
21820 3b 0a 20 20 20 20 77 68 69 6c 65 28 20 72 63 3d ;. while( rc=
21830 3d 53 51 4c 49 54 45 5f 4f 4b 20 26 26 20 70 50 =SQLITE_OK && pP
21840 61 67 65 72 2d 3e 6a 6f 75 72 6e 61 6c 4f 66 66 ager->journalOff
21850 3c 69 48 64 72 4f 66 66 20 29 7b 0a 20 20 20 20 <iHdrOff ){.
21860 20 20 72 63 20 3d 20 70 61 67 65 72 5f 70 6c 61 rc = pager_pla
21870 79 62 61 63 6b 5f 6f 6e 65 5f 70 61 67 65 28 70 yback_one_page(p
21880 50 61 67 65 72 2c 20 26 70 50 61 67 65 72 2d 3e Pager, &pPager->
21890 6a 6f 75 72 6e 61 6c 4f 66 66 2c 20 70 44 6f 6e journalOff, pDon
218a0 65 2c 20 31 2c 20 31 29 3b 0a 20 20 20 20 7d 0a e, 1, 1);. }.
218b0 20 20 20 20 61 73 73 65 72 74 28 20 72 63 21 3d assert( rc!=
218c0 53 51 4c 49 54 45 5f 44 4f 4e 45 20 29 3b 0a 20 SQLITE_DONE );.
218d0 20 7d 65 6c 73 65 7b 0a 20 20 20 20 70 50 61 67 }else{. pPag
218e0 65 72 2d 3e 6a 6f 75 72 6e 61 6c 4f 66 66 20 3d er->journalOff =
218f0 20 30 3b 0a 20 20 7d 0a 0a 20 20 2f 2a 20 43 6f 0;. }.. /* Co
21900 6e 74 69 6e 75 65 20 72 6f 6c 6c 69 6e 67 20 62 ntinue rolling b
21910 61 63 6b 20 72 65 63 6f 72 64 73 20 6f 75 74 20 ack records out
21920 6f 66 20 74 68 65 20 6d 61 69 6e 20 6a 6f 75 72 of the main jour
21930 6e 61 6c 20 73 74 61 72 74 69 6e 67 20 61 74 0a nal starting at.
21940 20 20 2a 2a 20 74 68 65 20 66 69 72 73 74 20 6a ** the first j
21950 6f 75 72 6e 61 6c 20 68 65 61 64 65 72 20 73 65 ournal header se
21960 65 6e 20 61 6e 64 20 63 6f 6e 74 69 6e 75 69 6e en and continuin
21970 67 20 75 6e 74 69 6c 20 74 68 65 20 65 66 66 65 g until the effe
21980 63 74 69 76 65 20 65 6e 64 0a 20 20 2a 2a 20 6f ctive end. ** o
21990 66 20 74 68 65 20 6d 61 69 6e 20 6a 6f 75 72 6e f the main journ
219a0 61 6c 20 66 69 6c 65 2e 20 20 43 6f 6e 74 69 6e al file. Contin
219b0 75 65 20 74 6f 20 73 6b 69 70 20 6f 75 74 2d 6f ue to skip out-o
219c0 66 2d 72 61 6e 67 65 20 70 61 67 65 73 20 61 6e f-range pages an
219d0 64 0a 20 20 2a 2a 20 63 6f 6e 74 69 6e 75 65 20 d. ** continue
219e0 61 64 64 69 6e 67 20 70 61 67 65 73 20 72 6f 6c adding pages rol
219f0 6c 65 64 20 62 61 63 6b 20 74 6f 20 70 44 6f 6e led back to pDon
21a00 65 2e 0a 20 20 2a 2f 0a 20 20 77 68 69 6c 65 28 e.. */. while(
21a10 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 26 rc==SQLITE_OK &
21a20 26 20 70 50 61 67 65 72 2d 3e 6a 6f 75 72 6e 61 & pPager->journa
21a30 6c 4f 66 66 3c 73 7a 4a 20 29 7b 0a 20 20 20 20 lOff<szJ ){.
21a40 75 33 32 20 69 69 3b 20 20 20 20 20 20 20 20 20 u32 ii;
21a50 20 20 20 2f 2a 20 4c 6f 6f 70 20 63 6f 75 6e 74 /* Loop count
21a60 65 72 20 2a 2f 0a 20 20 20 20 75 33 32 20 6e 4a er */. u32 nJ
21a70 52 65 63 20 3d 20 30 3b 20 20 20 20 20 2f 2a 20 Rec = 0; /*
21a80 4e 75 6d 62 65 72 20 6f 66 20 4a 6f 75 72 6e 61 Number of Journa
21a90 6c 20 52 65 63 6f 72 64 73 20 2a 2f 0a 20 20 20 l Records */.
21aa0 20 75 33 32 20 64 75 6d 6d 79 3b 0a 20 20 20 20 u32 dummy;.
21ab0 72 63 20 3d 20 72 65 61 64 4a 6f 75 72 6e 61 6c rc = readJournal
21ac0 48 64 72 28 70 50 61 67 65 72 2c 20 30 2c 20 73 Hdr(pPager, 0, s
21ad0 7a 4a 2c 20 26 6e 4a 52 65 63 2c 20 26 64 75 6d zJ, &nJRec, &dum
21ae0 6d 79 29 3b 0a 20 20 20 20 61 73 73 65 72 74 28 my);. assert(
21af0 20 72 63 21 3d 53 51 4c 49 54 45 5f 44 4f 4e 45 rc!=SQLITE_DONE
21b00 20 29 3b 0a 0a 20 20 20 20 2f 2a 0a 20 20 20 20 );.. /*.
21b10 2a 2a 20 54 68 65 20 22 70 50 61 67 65 72 2d 3e ** The "pPager->
21b20 6a 6f 75 72 6e 61 6c 48 64 72 2b 4a 4f 55 52 4e journalHdr+JOURN
21b30 41 4c 5f 48 44 52 5f 53 5a 28 70 50 61 67 65 72 AL_HDR_SZ(pPager
21b40 29 3d 3d 70 50 61 67 65 72 2d 3e 6a 6f 75 72 6e )==pPager->journ
21b50 61 6c 4f 66 66 22 0a 20 20 20 20 2a 2a 20 74 65 alOff". ** te
21b60 73 74 20 69 73 20 72 65 6c 61 74 65 64 20 74 6f st is related to
21b70 20 74 69 63 6b 65 74 20 23 32 35 36 35 2e 20 20 ticket #2565.
21b80 53 65 65 20 74 68 65 20 64 69 73 63 75 73 73 69 See the discussi
21b90 6f 6e 20 69 6e 20 74 68 65 0a 20 20 20 20 2a 2a on in the. **
21ba0 20 70 61 67 65 72 5f 70 6c 61 79 62 61 63 6b 28 pager_playback(
21bb0 29 20 66 75 6e 63 74 69 6f 6e 20 66 6f 72 20 61 ) function for a
21bc0 64 64 69 74 69 6f 6e 61 6c 20 69 6e 66 6f 72 6d dditional inform
21bd0 61 74 69 6f 6e 2e 0a 20 20 20 20 2a 2f 0a 20 20 ation.. */.
21be0 20 20 69 66 28 20 6e 4a 52 65 63 3d 3d 30 20 0a if( nJRec==0 .
21bf0 20 20 20 20 20 26 26 20 70 50 61 67 65 72 2d 3e && pPager->
21c00 6a 6f 75 72 6e 61 6c 48 64 72 2b 4a 4f 55 52 4e journalHdr+JOURN
21c10 41 4c 5f 48 44 52 5f 53 5a 28 70 50 61 67 65 72 AL_HDR_SZ(pPager
21c20 29 3d 3d 70 50 61 67 65 72 2d 3e 6a 6f 75 72 6e )==pPager->journ
21c30 61 6c 4f 66 66 0a 20 20 20 20 29 7b 0a 20 20 20 alOff. ){.
21c40 20 20 20 6e 4a 52 65 63 20 3d 20 28 75 33 32 29 nJRec = (u32)
21c50 28 28 73 7a 4a 20 2d 20 70 50 61 67 65 72 2d 3e ((szJ - pPager->
21c60 6a 6f 75 72 6e 61 6c 4f 66 66 29 2f 4a 4f 55 52 journalOff)/JOUR
21c70 4e 41 4c 5f 50 47 5f 53 5a 28 70 50 61 67 65 72 NAL_PG_SZ(pPager
21c80 29 29 3b 0a 20 20 20 20 7d 0a 20 20 20 20 66 6f ));. }. fo
21c90 72 28 69 69 3d 30 3b 20 72 63 3d 3d 53 51 4c 49 r(ii=0; rc==SQLI
21ca0 54 45 5f 4f 4b 20 26 26 20 69 69 3c 6e 4a 52 65 TE_OK && ii<nJRe
21cb0 63 20 26 26 20 70 50 61 67 65 72 2d 3e 6a 6f 75 c && pPager->jou
21cc0 72 6e 61 6c 4f 66 66 3c 73 7a 4a 3b 20 69 69 2b rnalOff<szJ; ii+
21cd0 2b 29 7b 0a 20 20 20 20 20 20 72 63 20 3d 20 70 +){. rc = p
21ce0 61 67 65 72 5f 70 6c 61 79 62 61 63 6b 5f 6f 6e ager_playback_on
21cf0 65 5f 70 61 67 65 28 70 50 61 67 65 72 2c 20 26 e_page(pPager, &
21d00 70 50 61 67 65 72 2d 3e 6a 6f 75 72 6e 61 6c 4f pPager->journalO
21d10 66 66 2c 20 70 44 6f 6e 65 2c 20 31 2c 20 31 29 ff, pDone, 1, 1)
21d20 3b 0a 20 20 20 20 7d 0a 20 20 20 20 61 73 73 65 ;. }. asse
21d30 72 74 28 20 72 63 21 3d 53 51 4c 49 54 45 5f 44 rt( rc!=SQLITE_D
21d40 4f 4e 45 20 29 3b 0a 20 20 7d 0a 20 20 61 73 73 ONE );. }. ass
21d50 65 72 74 28 20 72 63 21 3d 53 51 4c 49 54 45 5f ert( rc!=SQLITE_
21d60 4f 4b 20 7c 7c 20 70 50 61 67 65 72 2d 3e 6a 6f OK || pPager->jo
21d70 75 72 6e 61 6c 4f 66 66 3e 3d 73 7a 4a 20 29 3b urnalOff>=szJ );
21d80 0a 0a 20 20 2f 2a 20 46 69 6e 61 6c 6c 79 2c 20 .. /* Finally,
21d90 20 72 6f 6c 6c 62 61 63 6b 20 70 61 67 65 73 20 rollback pages
21da0 66 72 6f 6d 20 74 68 65 20 73 75 62 2d 6a 6f 75 from the sub-jou
21db0 72 6e 61 6c 2e 20 20 50 61 67 65 20 74 68 61 74 rnal. Page that
21dc0 20 77 65 72 65 0a 20 20 2a 2a 20 70 72 65 76 69 were. ** previ
21dd0 6f 75 73 6c 79 20 72 6f 6c 6c 65 64 20 62 61 63 ously rolled bac
21de0 6b 20 6f 75 74 20 6f 66 20 74 68 65 20 6d 61 69 k out of the mai
21df0 6e 20 6a 6f 75 72 6e 61 6c 20 28 61 6e 64 20 61 n journal (and a
21e00 72 65 20 68 65 6e 63 65 20 69 6e 20 70 44 6f 6e re hence in pDon
21e10 65 29 0a 20 20 2a 2a 20 77 69 6c 6c 20 62 65 20 e). ** will be
21e20 73 6b 69 70 70 65 64 2e 20 20 4f 75 74 2d 6f 66 skipped. Out-of
21e30 2d 72 61 6e 67 65 20 70 61 67 65 73 20 61 72 65 -range pages are
21e40 20 61 6c 73 6f 20 73 6b 69 70 70 65 64 2e 0a 20 also skipped..
21e50 20 2a 2f 0a 20 20 69 66 28 20 70 53 61 76 65 70 */. if( pSavep
21e60 6f 69 6e 74 20 29 7b 0a 20 20 20 20 75 33 32 20 oint ){. u32
21e70 69 69 3b 20 20 20 20 20 20 20 20 20 20 20 20 2f ii; /
21e80 2a 20 4c 6f 6f 70 20 63 6f 75 6e 74 65 72 20 2a * Loop counter *
21e90 2f 0a 20 20 20 20 69 36 34 20 6f 66 66 73 65 74 /. i64 offset
21ea0 20 3d 20 28 69 36 34 29 70 53 61 76 65 70 6f 69 = (i64)pSavepoi
21eb0 6e 74 2d 3e 69 53 75 62 52 65 63 2a 28 34 2b 70 nt->iSubRec*(4+p
21ec0 50 61 67 65 72 2d 3e 70 61 67 65 53 69 7a 65 29 Pager->pageSize)
21ed0 3b 0a 0a 20 20 20 20 69 66 28 20 70 61 67 65 72 ;.. if( pager
21ee0 55 73 65 57 61 6c 28 70 50 61 67 65 72 29 20 29 UseWal(pPager) )
21ef0 7b 0a 20 20 20 20 20 20 72 63 20 3d 20 73 71 6c {. rc = sql
21f00 69 74 65 33 57 61 6c 53 61 76 65 70 6f 69 6e 74 ite3WalSavepoint
21f10 55 6e 64 6f 28 70 50 61 67 65 72 2d 3e 70 57 61 Undo(pPager->pWa
21f20 6c 2c 20 70 53 61 76 65 70 6f 69 6e 74 2d 3e 61 l, pSavepoint->a
21f30 57 61 6c 44 61 74 61 29 3b 0a 20 20 20 20 7d 0a WalData);. }.
21f40 20 20 20 20 66 6f 72 28 69 69 3d 70 53 61 76 65 for(ii=pSave
21f50 70 6f 69 6e 74 2d 3e 69 53 75 62 52 65 63 3b 20 point->iSubRec;
21f60 72 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 26 26 rc==SQLITE_OK &&
21f70 20 69 69 3c 70 50 61 67 65 72 2d 3e 6e 53 75 62 ii<pPager->nSub
21f80 52 65 63 3b 20 69 69 2b 2b 29 7b 0a 20 20 20 20 Rec; ii++){.
21f90 20 20 61 73 73 65 72 74 28 20 6f 66 66 73 65 74 assert( offset
21fa0 3d 3d 28 69 36 34 29 69 69 2a 28 34 2b 70 50 61 ==(i64)ii*(4+pPa
21fb0 67 65 72 2d 3e 70 61 67 65 53 69 7a 65 29 20 29 ger->pageSize) )
21fc0 3b 0a 20 20 20 20 20 20 72 63 20 3d 20 70 61 67 ;. rc = pag
21fd0 65 72 5f 70 6c 61 79 62 61 63 6b 5f 6f 6e 65 5f er_playback_one_
21fe0 70 61 67 65 28 70 50 61 67 65 72 2c 20 26 6f 66 page(pPager, &of
21ff0 66 73 65 74 2c 20 70 44 6f 6e 65 2c 20 30 2c 20 fset, pDone, 0,
22000 31 29 3b 0a 20 20 20 20 7d 0a 20 20 20 20 61 73 1);. }. as
22010 73 65 72 74 28 20 72 63 21 3d 53 51 4c 49 54 45 sert( rc!=SQLITE
22020 5f 44 4f 4e 45 20 29 3b 0a 20 20 7d 0a 0a 20 20 _DONE );. }..
22030 73 71 6c 69 74 65 33 42 69 74 76 65 63 44 65 73 sqlite3BitvecDes
22040 74 72 6f 79 28 70 44 6f 6e 65 29 3b 0a 20 20 69 troy(pDone);. i
22050 66 28 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b f( rc==SQLITE_OK
22060 20 29 7b 0a 20 20 20 20 70 50 61 67 65 72 2d 3e ){. pPager->
22070 6a 6f 75 72 6e 61 6c 4f 66 66 20 3d 20 73 7a 4a journalOff = szJ
22080 3b 0a 20 20 7d 0a 0a 20 20 72 65 74 75 72 6e 20 ;. }.. return
22090 72 63 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 43 68 61 rc;.}../*.** Cha
220a0 6e 67 65 20 74 68 65 20 6d 61 78 69 6d 75 6d 20 nge the maximum
220b0 6e 75 6d 62 65 72 20 6f 66 20 69 6e 2d 6d 65 6d number of in-mem
220c0 6f 72 79 20 70 61 67 65 73 20 74 68 61 74 20 61 ory pages that a
220d0 72 65 20 61 6c 6c 6f 77 65 64 0a 2a 2a 20 62 65 re allowed.** be
220e0 66 6f 72 65 20 61 74 74 65 6d 70 74 69 6e 67 20 fore attempting
220f0 74 6f 20 72 65 63 79 63 6c 65 20 63 6c 65 61 6e to recycle clean
22100 20 61 6e 64 20 75 6e 75 73 65 64 20 70 61 67 65 and unused page
22110 73 2e 0a 2a 2f 0a 76 6f 69 64 20 73 71 6c 69 74 s..*/.void sqlit
22120 65 33 50 61 67 65 72 53 65 74 43 61 63 68 65 73 e3PagerSetCaches
22130 69 7a 65 28 50 61 67 65 72 20 2a 70 50 61 67 65 ize(Pager *pPage
22140 72 2c 20 69 6e 74 20 6d 78 50 61 67 65 29 7b 0a r, int mxPage){.
22150 20 20 73 71 6c 69 74 65 33 50 63 61 63 68 65 53 sqlite3PcacheS
22160 65 74 43 61 63 68 65 73 69 7a 65 28 70 50 61 67 etCachesize(pPag
22170 65 72 2d 3e 70 50 43 61 63 68 65 2c 20 6d 78 50 er->pPCache, mxP
22180 61 67 65 29 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 43 age);.}../*.** C
22190 68 61 6e 67 65 20 74 68 65 20 6d 61 78 69 6d 75 hange the maximu
221a0 6d 20 6e 75 6d 62 65 72 20 6f 66 20 69 6e 2d 6d m number of in-m
221b0 65 6d 6f 72 79 20 70 61 67 65 73 20 74 68 61 74 emory pages that
221c0 20 61 72 65 20 61 6c 6c 6f 77 65 64 0a 2a 2a 20 are allowed.**
221d0 62 65 66 6f 72 65 20 61 74 74 65 6d 70 74 69 6e before attemptin
221e0 67 20 74 6f 20 73 70 69 6c 6c 20 70 61 67 65 73 g to spill pages
221f0 20 74 6f 20 6a 6f 75 72 6e 61 6c 2e 0a 2a 2f 0a to journal..*/.
22200 69 6e 74 20 73 71 6c 69 74 65 33 50 61 67 65 72 int sqlite3Pager
22210 53 65 74 53 70 69 6c 6c 73 69 7a 65 28 50 61 67 SetSpillsize(Pag
22220 65 72 20 2a 70 50 61 67 65 72 2c 20 69 6e 74 20 er *pPager, int
22230 6d 78 50 61 67 65 29 7b 0a 20 20 72 65 74 75 72 mxPage){. retur
22240 6e 20 73 71 6c 69 74 65 33 50 63 61 63 68 65 53 n sqlite3PcacheS
22250 65 74 53 70 69 6c 6c 73 69 7a 65 28 70 50 61 67 etSpillsize(pPag
22260 65 72 2d 3e 70 50 43 61 63 68 65 2c 20 6d 78 50 er->pPCache, mxP
22270 61 67 65 29 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 49 age);.}../*.** I
22280 6e 76 6f 6b 65 20 53 51 4c 49 54 45 5f 46 43 4e nvoke SQLITE_FCN
22290 54 4c 5f 4d 4d 41 50 5f 53 49 5a 45 20 62 61 73 TL_MMAP_SIZE bas
222a0 65 64 20 6f 6e 20 74 68 65 20 63 75 72 72 65 6e ed on the curren
222b0 74 20 76 61 6c 75 65 20 6f 66 20 73 7a 4d 6d 61 t value of szMma
222c0 70 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 76 6f 69 p..*/.static voi
222d0 64 20 70 61 67 65 72 46 69 78 4d 61 70 6c 69 6d d pagerFixMaplim
222e0 69 74 28 50 61 67 65 72 20 2a 70 50 61 67 65 72 it(Pager *pPager
222f0 29 7b 0a 23 69 66 20 53 51 4c 49 54 45 5f 4d 41 ){.#if SQLITE_MA
22300 58 5f 4d 4d 41 50 5f 53 49 5a 45 3e 30 0a 20 20 X_MMAP_SIZE>0.
22310 73 71 6c 69 74 65 33 5f 66 69 6c 65 20 2a 66 64 sqlite3_file *fd
22320 20 3d 20 70 50 61 67 65 72 2d 3e 66 64 3b 0a 20 = pPager->fd;.
22330 20 69 66 28 20 69 73 4f 70 65 6e 28 66 64 29 20 if( isOpen(fd)
22340 26 26 20 66 64 2d 3e 70 4d 65 74 68 6f 64 73 2d && fd->pMethods-
22350 3e 69 56 65 72 73 69 6f 6e 3e 3d 33 20 29 7b 0a >iVersion>=3 ){.
22360 20 20 20 20 73 71 6c 69 74 65 33 5f 69 6e 74 36 sqlite3_int6
22370 34 20 73 7a 3b 0a 20 20 20 20 73 7a 20 3d 20 70 4 sz;. sz = p
22380 50 61 67 65 72 2d 3e 73 7a 4d 6d 61 70 3b 0a 20 Pager->szMmap;.
22390 20 20 20 70 50 61 67 65 72 2d 3e 62 55 73 65 46 pPager->bUseF
223a0 65 74 63 68 20 3d 20 28 73 7a 3e 30 29 3b 0a 20 etch = (sz>0);.
223b0 20 20 20 73 71 6c 69 74 65 33 4f 73 46 69 6c 65 sqlite3OsFile
223c0 43 6f 6e 74 72 6f 6c 48 69 6e 74 28 70 50 61 67 ControlHint(pPag
223d0 65 72 2d 3e 66 64 2c 20 53 51 4c 49 54 45 5f 46 er->fd, SQLITE_F
223e0 43 4e 54 4c 5f 4d 4d 41 50 5f 53 49 5a 45 2c 20 CNTL_MMAP_SIZE,
223f0 26 73 7a 29 3b 0a 20 20 7d 0a 23 65 6e 64 69 66 &sz);. }.#endif
22400 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 43 68 61 6e 67 65 .}../*.** Change
22410 20 74 68 65 20 6d 61 78 69 6d 75 6d 20 73 69 7a the maximum siz
22420 65 20 6f 66 20 61 6e 79 20 6d 65 6d 6f 72 79 20 e of any memory
22430 6d 61 70 70 69 6e 67 20 6d 61 64 65 20 6f 66 20 mapping made of
22440 74 68 65 20 64 61 74 61 62 61 73 65 20 66 69 6c the database fil
22450 65 2e 0a 2a 2f 0a 76 6f 69 64 20 73 71 6c 69 74 e..*/.void sqlit
22460 65 33 50 61 67 65 72 53 65 74 4d 6d 61 70 4c 69 e3PagerSetMmapLi
22470 6d 69 74 28 50 61 67 65 72 20 2a 70 50 61 67 65 mit(Pager *pPage
22480 72 2c 20 73 71 6c 69 74 65 33 5f 69 6e 74 36 34 r, sqlite3_int64
22490 20 73 7a 4d 6d 61 70 29 7b 0a 20 20 70 50 61 67 szMmap){. pPag
224a0 65 72 2d 3e 73 7a 4d 6d 61 70 20 3d 20 73 7a 4d er->szMmap = szM
224b0 6d 61 70 3b 0a 20 20 70 61 67 65 72 46 69 78 4d map;. pagerFixM
224c0 61 70 6c 69 6d 69 74 28 70 50 61 67 65 72 29 3b aplimit(pPager);
224d0 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 46 72 65 65 20 61 .}../*.** Free a
224e0 73 20 6d 75 63 68 20 6d 65 6d 6f 72 79 20 61 73 s much memory as
224f0 20 70 6f 73 73 69 62 6c 65 20 66 72 6f 6d 20 74 possible from t
22500 68 65 20 70 61 67 65 72 2e 0a 2a 2f 0a 76 6f 69 he pager..*/.voi
22510 64 20 73 71 6c 69 74 65 33 50 61 67 65 72 53 68 d sqlite3PagerSh
22520 72 69 6e 6b 28 50 61 67 65 72 20 2a 70 50 61 67 rink(Pager *pPag
22530 65 72 29 7b 0a 20 20 73 71 6c 69 74 65 33 50 63 er){. sqlite3Pc
22540 61 63 68 65 53 68 72 69 6e 6b 28 70 50 61 67 65 acheShrink(pPage
22550 72 2d 3e 70 50 43 61 63 68 65 29 3b 0a 7d 0a 0a r->pPCache);.}..
22560 2f 2a 0a 2a 2a 20 41 64 6a 75 73 74 20 73 65 74 /*.** Adjust set
22570 74 69 6e 67 73 20 6f 66 20 74 68 65 20 70 61 67 tings of the pag
22580 65 72 20 74 6f 20 74 68 6f 73 65 20 73 70 65 63 er to those spec
22590 69 66 69 65 64 20 69 6e 20 74 68 65 20 70 67 46 ified in the pgF
225a0 6c 61 67 73 20 70 61 72 61 6d 65 74 65 72 2e 0a lags parameter..
225b0 2a 2a 0a 2a 2a 20 54 68 65 20 22 6c 65 76 65 6c **.** The "level
225c0 22 20 69 6e 20 70 67 46 6c 61 67 73 20 26 20 50 " in pgFlags & P
225d0 41 47 45 52 5f 53 59 4e 43 48 52 4f 4e 4f 55 53 AGER_SYNCHRONOUS
225e0 5f 4d 41 53 4b 20 73 65 74 73 20 74 68 65 20 72 _MASK sets the r
225f0 6f 62 75 73 74 6e 65 73 73 0a 2a 2a 20 6f 66 20 obustness.** of
22600 74 68 65 20 64 61 74 61 62 61 73 65 20 74 6f 20 the database to
22610 64 61 6d 61 67 65 20 64 75 65 20 74 6f 20 4f 53 damage due to OS
22620 20 63 72 61 73 68 65 73 20 6f 72 20 70 6f 77 65 crashes or powe
22630 72 20 66 61 69 6c 75 72 65 73 20 62 79 0a 2a 2a r failures by.**
22640 20 63 68 61 6e 67 69 6e 67 20 74 68 65 20 6e 75 changing the nu
22650 6d 62 65 72 20 6f 66 20 73 79 6e 63 73 28 29 73 mber of syncs()s
22660 20 77 68 65 6e 20 77 72 69 74 69 6e 67 20 74 68 when writing th
22670 65 20 6a 6f 75 72 6e 61 6c 73 2e 0a 2a 2a 20 54 e journals..** T
22680 68 65 72 65 20 61 72 65 20 66 6f 75 72 20 6c 65 here are four le
22690 76 65 6c 73 3a 0a 2a 2a 0a 2a 2a 20 20 20 20 4f vels:.**.** O
226a0 46 46 20 20 20 20 20 20 20 73 71 6c 69 74 65 33 FF sqlite3
226b0 4f 73 53 79 6e 63 28 29 20 69 73 20 6e 65 76 65 OsSync() is neve
226c0 72 20 63 61 6c 6c 65 64 2e 20 20 54 68 69 73 20 r called. This
226d0 69 73 20 74 68 65 20 64 65 66 61 75 6c 74 0a 2a is the default.*
226e0 2a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 66 * f
226f0 6f 72 20 74 65 6d 70 6f 72 61 72 79 20 61 6e 64 or temporary and
22700 20 74 72 61 6e 73 69 65 6e 74 20 66 69 6c 65 73 transient files
22710 2e 0a 2a 2a 0a 2a 2a 20 20 20 20 4e 4f 52 4d 41 ..**.** NORMA
22720 4c 20 20 20 20 54 68 65 20 6a 6f 75 72 6e 61 6c L The journal
22730 20 69 73 20 73 79 6e 63 65 64 20 6f 6e 63 65 20 is synced once
22740 62 65 66 6f 72 65 20 77 72 69 74 65 73 20 62 65 before writes be
22750 67 69 6e 20 6f 6e 20 74 68 65 0a 2a 2a 20 20 20 gin on the.**
22760 20 20 20 20 20 20 20 20 20 20 20 64 61 74 61 62 datab
22770 61 73 65 2e 20 20 54 68 69 73 20 69 73 20 6e 6f ase. This is no
22780 72 6d 61 6c 6c 79 20 61 64 65 71 75 61 74 65 20 rmally adequate
22790 70 72 6f 74 65 63 74 69 6f 6e 2c 20 62 75 74 0a protection, but.
227a0 2a 2a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 **
227b0 69 74 20 69 73 20 74 68 65 6f 72 65 74 69 63 61 it is theoretica
227c0 6c 6c 79 20 70 6f 73 73 69 62 6c 65 2c 20 74 68 lly possible, th
227d0 6f 75 67 68 20 76 65 72 79 20 75 6e 6c 69 6b 65 ough very unlike
227e0 6c 79 2c 0a 2a 2a 20 20 20 20 20 20 20 20 20 20 ly,.**
227f0 20 20 20 20 74 68 61 74 20 61 6e 20 69 6e 6f 70 that an inop
22800 65 72 74 75 6e 65 20 70 6f 77 65 72 20 66 61 69 ertune power fai
22810 6c 75 72 65 20 63 6f 75 6c 64 20 6c 65 61 76 65 lure could leave
22820 20 74 68 65 20 6a 6f 75 72 6e 61 6c 0a 2a 2a 20 the journal.**
22830 20 20 20 20 20 20 20 20 20 20 20 20 20 69 6e 20 in
22840 61 20 73 74 61 74 65 20 77 68 69 63 68 20 77 6f a state which wo
22850 75 6c 64 20 63 61 75 73 65 20 64 61 6d 61 67 65 uld cause damage
22860 20 74 6f 20 74 68 65 20 64 61 74 61 62 61 73 65 to the database
22870 0a 2a 2a 20 20 20 20 20 20 20 20 20 20 20 20 20 .**
22880 20 77 68 65 6e 20 69 74 20 69 73 20 72 6f 6c 6c when it is roll
22890 65 64 20 62 61 63 6b 2e 0a 2a 2a 0a 2a 2a 20 20 ed back..**.**
228a0 20 20 46 55 4c 4c 20 20 20 20 20 20 54 68 65 20 FULL The
228b0 6a 6f 75 72 6e 61 6c 20 69 73 20 73 79 6e 63 65 journal is synce
228c0 64 20 74 77 69 63 65 20 62 65 66 6f 72 65 20 77 d twice before w
228d0 72 69 74 65 73 20 62 65 67 69 6e 20 6f 6e 20 74 rites begin on t
228e0 68 65 0a 2a 2a 20 20 20 20 20 20 20 20 20 20 20 he.**
228f0 20 20 20 64 61 74 61 62 61 73 65 20 28 77 69 74 database (wit
22900 68 20 73 6f 6d 65 20 61 64 64 69 74 69 6f 6e 61 h some additiona
22910 6c 20 69 6e 66 6f 72 6d 61 74 69 6f 6e 20 2d 20 l information -
22920 74 68 65 20 6e 52 65 63 20 66 69 65 6c 64 0a 2a the nRec field.*
22930 2a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 6f * o
22940 66 20 74 68 65 20 6a 6f 75 72 6e 61 6c 20 68 65 f the journal he
22950 61 64 65 72 20 2d 20 62 65 69 6e 67 20 77 72 69 ader - being wri
22960 74 74 65 6e 20 69 6e 20 62 65 74 77 65 65 6e 20 tten in between
22970 74 68 65 20 74 77 6f 0a 2a 2a 20 20 20 20 20 20 the two.**
22980 20 20 20 20 20 20 20 20 73 79 6e 63 73 29 2e 20 syncs).
22990 20 49 66 20 77 65 20 61 73 73 75 6d 65 20 74 68 If we assume th
229a0 61 74 20 77 72 69 74 69 6e 67 20 61 0a 2a 2a 20 at writing a.**
229b0 20 20 20 20 20 20 20 20 20 20 20 20 20 73 69 6e sin
229c0 67 6c 65 20 64 69 73 6b 20 73 65 63 74 6f 72 20 gle disk sector
229d0 69 73 20 61 74 6f 6d 69 63 2c 20 74 68 65 6e 20 is atomic, then
229e0 74 68 69 73 20 6d 6f 64 65 20 70 72 6f 76 69 64 this mode provid
229f0 65 73 0a 2a 2a 20 20 20 20 20 20 20 20 20 20 20 es.**
22a00 20 20 20 61 73 73 75 72 61 6e 63 65 20 74 68 61 assurance tha
22a10 74 20 74 68 65 20 6a 6f 75 72 6e 61 6c 20 77 69 t the journal wi
22a20 6c 6c 20 6e 6f 74 20 62 65 20 63 6f 72 72 75 70 ll not be corrup
22a30 74 65 64 20 74 6f 20 74 68 65 0a 2a 2a 20 20 20 ted to the.**
22a40 20 20 20 20 20 20 20 20 20 20 20 70 6f 69 6e 74 point
22a50 20 6f 66 20 63 61 75 73 69 6e 67 20 64 61 6d 61 of causing dama
22a60 67 65 20 74 6f 20 74 68 65 20 64 61 74 61 62 61 ge to the databa
22a70 73 65 20 64 75 72 69 6e 67 20 72 6f 6c 6c 62 61 se during rollba
22a80 63 6b 2e 0a 2a 2a 0a 2a 2a 20 20 20 20 45 58 54 ck..**.** EXT
22a90 52 41 20 20 20 20 20 54 68 69 73 20 69 73 20 6c RA This is l
22aa0 69 6b 65 20 46 55 4c 4c 20 65 78 63 65 70 74 20 ike FULL except
22ab0 74 68 61 74 20 69 73 20 61 6c 73 6f 20 73 79 6e that is also syn
22ac0 63 73 20 74 68 65 20 64 69 72 65 63 74 6f 72 79 cs the directory
22ad0 0a 2a 2a 20 20 20 20 20 20 20 20 20 20 20 20 20 .**
22ae0 20 74 68 61 74 20 63 6f 6e 74 61 69 6e 73 20 74 that contains t
22af0 68 65 20 72 6f 6c 6c 62 61 63 6b 20 6a 6f 75 72 he rollback jour
22b00 6e 61 6c 20 61 66 74 65 72 20 74 68 65 20 72 6f nal after the ro
22b10 6c 6c 62 61 63 6b 0a 2a 2a 20 20 20 20 20 20 20 llback.**
22b20 20 20 20 20 20 20 20 6a 6f 75 72 6e 61 6c 20 69 journal i
22b30 73 20 75 6e 6c 69 6e 6b 65 64 2e 0a 2a 2a 0a 2a s unlinked..**.*
22b40 2a 20 54 68 65 20 61 62 6f 76 65 20 69 73 20 66 * The above is f
22b50 6f 72 20 61 20 72 6f 6c 6c 62 61 63 6b 2d 6a 6f or a rollback-jo
22b60 75 72 6e 61 6c 20 6d 6f 64 65 2e 20 20 46 6f 72 urnal mode. For
22b70 20 57 41 4c 20 6d 6f 64 65 2c 20 4f 46 46 20 63 WAL mode, OFF c
22b80 6f 6e 74 69 6e 75 65 73 0a 2a 2a 20 74 6f 20 6d ontinues.** to m
22b90 65 61 6e 20 74 68 61 74 20 6e 6f 20 73 79 6e 63 ean that no sync
22ba0 73 20 65 76 65 72 20 6f 63 63 75 72 2e 20 20 4e s ever occur. N
22bb0 4f 52 4d 41 4c 20 6d 65 61 6e 73 20 74 68 61 74 ORMAL means that
22bc0 20 74 68 65 20 57 41 4c 20 69 73 20 73 79 6e 63 the WAL is sync
22bd0 65 64 0a 2a 2a 20 70 72 69 6f 72 20 74 6f 20 74 ed.** prior to t
22be0 68 65 20 73 74 61 72 74 20 6f 66 20 63 68 65 63 he start of chec
22bf0 6b 70 6f 69 6e 74 20 61 6e 64 20 74 68 61 74 20 kpoint and that
22c00 74 68 65 20 64 61 74 61 62 61 73 65 20 66 69 6c the database fil
22c10 65 20 69 73 20 73 79 6e 63 65 64 0a 2a 2a 20 61 e is synced.** a
22c20 74 20 74 68 65 20 63 6f 6e 63 6c 75 73 69 6f 6e t the conclusion
22c30 20 6f 66 20 74 68 65 20 63 68 65 63 6b 70 6f 69 of the checkpoi
22c40 6e 74 20 69 66 20 74 68 65 20 65 6e 74 69 72 65 nt if the entire
22c50 20 63 6f 6e 74 65 6e 74 20 6f 66 20 74 68 65 20 content of the
22c60 57 41 4c 0a 2a 2a 20 77 61 73 20 77 72 69 74 74 WAL.** was writt
22c70 65 6e 20 62 61 63 6b 20 69 6e 74 6f 20 74 68 65 en back into the
22c80 20 64 61 74 61 62 61 73 65 2e 20 20 42 75 74 20 database. But
22c90 6e 6f 20 73 79 6e 63 20 6f 70 65 72 61 74 69 6f no sync operatio
22ca0 6e 73 20 6f 63 63 75 72 20 66 6f 72 0a 2a 2a 20 ns occur for.**
22cb0 61 6e 20 6f 72 64 69 6e 61 72 79 20 63 6f 6d 6d an ordinary comm
22cc0 69 74 20 69 6e 20 4e 4f 52 4d 41 4c 20 6d 6f 64 it in NORMAL mod
22cd0 65 20 77 69 74 68 20 57 41 4c 2e 20 20 46 55 4c e with WAL. FUL
22ce0 4c 20 6d 65 61 6e 73 20 74 68 61 74 20 74 68 65 L means that the
22cf0 20 57 41 4c 0a 2a 2a 20 66 69 6c 65 20 69 73 20 WAL.** file is
22d00 73 79 6e 63 65 64 20 66 6f 6c 6c 6f 77 69 6e 67 synced following
22d10 20 65 61 63 68 20 63 6f 6d 6d 69 74 20 6f 70 65 each commit ope
22d20 72 61 74 69 6f 6e 2c 20 69 6e 20 61 64 64 69 74 ration, in addit
22d30 69 6f 6e 20 74 6f 20 74 68 65 0a 2a 2a 20 73 79 ion to the.** sy
22d40 6e 63 73 20 61 73 73 6f 63 69 61 74 65 64 20 77 ncs associated w
22d50 69 74 68 20 4e 4f 52 4d 41 4c 2e 20 20 54 68 65 ith NORMAL. The
22d60 72 65 20 69 73 20 6e 6f 20 64 69 66 66 65 72 65 re is no differe
22d70 6e 63 65 20 62 65 74 77 65 65 6e 20 46 55 4c 4c nce between FULL
22d80 0a 2a 2a 20 61 6e 64 20 45 58 54 52 41 20 66 6f .** and EXTRA fo
22d90 72 20 57 41 4c 20 6d 6f 64 65 2e 0a 2a 2a 0a 2a r WAL mode..**.*
22da0 2a 20 44 6f 20 6e 6f 74 20 63 6f 6e 66 75 73 65 * Do not confuse
22db0 20 73 79 6e 63 68 72 6f 6e 6f 75 73 3d 46 55 4c synchronous=FUL
22dc0 4c 20 77 69 74 68 20 53 51 4c 49 54 45 5f 53 59 L with SQLITE_SY
22dd0 4e 43 5f 46 55 4c 4c 2e 20 20 54 68 65 0a 2a 2a NC_FULL. The.**
22de0 20 53 51 4c 49 54 45 5f 53 59 4e 43 5f 46 55 4c SQLITE_SYNC_FUL
22df0 4c 20 6d 61 63 72 6f 20 6d 65 61 6e 73 20 74 6f L macro means to
22e00 20 75 73 65 20 74 68 65 20 4d 61 63 4f 53 58 2d use the MacOSX-
22e10 73 74 79 6c 65 20 66 75 6c 6c 2d 66 73 79 6e 63 style full-fsync
22e20 0a 2a 2a 20 75 73 69 6e 67 20 66 63 6e 74 6c 28 .** using fcntl(
22e30 46 5f 46 55 4c 4c 46 53 59 4e 43 29 2e 20 20 53 F_FULLFSYNC). S
22e40 51 4c 49 54 45 5f 53 59 4e 43 5f 4e 4f 52 4d 41 QLITE_SYNC_NORMA
22e50 4c 20 6d 65 61 6e 73 20 74 6f 20 64 6f 20 61 6e L means to do an
22e60 0a 2a 2a 20 6f 72 64 69 6e 61 72 79 20 66 73 79 .** ordinary fsy
22e70 6e 63 28 29 20 63 61 6c 6c 2e 20 20 54 68 65 72 nc() call. Ther
22e80 65 20 69 73 20 6e 6f 20 64 69 66 66 65 72 65 6e e is no differen
22e90 63 65 20 62 65 74 77 65 65 6e 20 53 51 4c 49 54 ce between SQLIT
22ea0 45 5f 53 59 4e 43 5f 46 55 4c 4c 0a 2a 2a 20 61 E_SYNC_FULL.** a
22eb0 6e 64 20 53 51 4c 49 54 45 5f 53 59 4e 43 5f 4e nd SQLITE_SYNC_N
22ec0 4f 52 4d 41 4c 20 6f 6e 20 70 6c 61 74 66 6f 72 ORMAL on platfor
22ed0 6d 73 20 6f 74 68 65 72 20 74 68 61 6e 20 4d 61 ms other than Ma
22ee0 63 4f 53 58 2e 20 20 42 75 74 20 74 68 65 0a 2a cOSX. But the.*
22ef0 2a 20 73 79 6e 63 68 72 6f 6e 6f 75 73 3d 46 55 * synchronous=FU
22f00 4c 4c 20 76 65 72 73 75 73 20 73 79 6e 63 68 72 LL versus synchr
22f10 6f 6e 6f 75 73 3d 4e 4f 52 4d 41 4c 20 73 65 74 onous=NORMAL set
22f20 74 69 6e 67 20 64 65 74 65 72 6d 69 6e 65 73 20 ting determines
22f30 77 68 65 6e 0a 2a 2a 20 74 68 65 20 78 53 79 6e when.** the xSyn
22f40 63 20 70 72 69 6d 69 74 69 76 65 20 69 73 20 63 c primitive is c
22f50 61 6c 6c 65 64 20 61 6e 64 20 69 73 20 72 65 6c alled and is rel
22f60 65 76 61 6e 74 20 74 6f 20 61 6c 6c 20 70 6c 61 evant to all pla
22f70 74 66 6f 72 6d 73 2e 0a 2a 2a 0a 2a 2a 20 4e 75 tforms..**.** Nu
22f80 6d 65 72 69 63 20 76 61 6c 75 65 73 20 61 73 73 meric values ass
22f90 6f 63 69 61 74 65 64 20 77 69 74 68 20 74 68 65 ociated with the
22fa0 73 65 20 73 74 61 74 65 73 20 61 72 65 20 4f 46 se states are OF
22fb0 46 3d 3d 31 2c 20 4e 4f 52 4d 41 4c 3d 32 2c 0a F==1, NORMAL=2,.
22fc0 2a 2a 20 61 6e 64 20 46 55 4c 4c 3d 33 2e 0a 2a ** and FULL=3..*
22fd0 2f 0a 23 69 66 6e 64 65 66 20 53 51 4c 49 54 45 /.#ifndef SQLITE
22fe0 5f 4f 4d 49 54 5f 50 41 47 45 52 5f 50 52 41 47 _OMIT_PAGER_PRAG
22ff0 4d 41 53 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 MAS.void sqlite3
23000 50 61 67 65 72 53 65 74 46 6c 61 67 73 28 0a 20 PagerSetFlags(.
23010 20 50 61 67 65 72 20 2a 70 50 61 67 65 72 2c 20 Pager *pPager,
23020 20 20 20 20 20 20 20 2f 2a 20 54 68 65 20 70 61 /* The pa
23030 67 65 72 20 74 6f 20 73 65 74 20 73 61 66 65 74 ger to set safet
23040 79 20 6c 65 76 65 6c 20 66 6f 72 20 2a 2f 0a 20 y level for */.
23050 20 75 6e 73 69 67 6e 65 64 20 70 67 46 6c 61 67 unsigned pgFlag
23060 73 20 20 20 20 20 20 2f 2a 20 56 61 72 69 6f 75 s /* Variou
23070 73 20 66 6c 61 67 73 20 2a 2f 0a 29 7b 0a 20 20 s flags */.){.
23080 75 6e 73 69 67 6e 65 64 20 6c 65 76 65 6c 20 3d unsigned level =
23090 20 70 67 46 6c 61 67 73 20 26 20 50 41 47 45 52 pgFlags & PAGER
230a0 5f 53 59 4e 43 48 52 4f 4e 4f 55 53 5f 4d 41 53 _SYNCHRONOUS_MAS
230b0 4b 3b 0a 20 20 69 66 28 20 70 50 61 67 65 72 2d K;. if( pPager-
230c0 3e 74 65 6d 70 46 69 6c 65 20 29 7b 0a 20 20 20 >tempFile ){.
230d0 20 70 50 61 67 65 72 2d 3e 6e 6f 53 79 6e 63 20 pPager->noSync
230e0 3d 20 31 3b 0a 20 20 20 20 70 50 61 67 65 72 2d = 1;. pPager-
230f0 3e 66 75 6c 6c 53 79 6e 63 20 3d 20 30 3b 0a 20 >fullSync = 0;.
23100 20 20 20 70 50 61 67 65 72 2d 3e 65 78 74 72 61 pPager->extra
23110 53 79 6e 63 20 3d 20 30 3b 0a 20 20 7d 65 6c 73 Sync = 0;. }els
23120 65 7b 0a 20 20 20 20 70 50 61 67 65 72 2d 3e 6e e{. pPager->n
23130 6f 53 79 6e 63 20 3d 20 20 6c 65 76 65 6c 3d 3d oSync = level==
23140 50 41 47 45 52 5f 53 59 4e 43 48 52 4f 4e 4f 55 PAGER_SYNCHRONOU
23150 53 5f 4f 46 46 20 3f 31 3a 30 3b 0a 20 20 20 20 S_OFF ?1:0;.
23160 70 50 61 67 65 72 2d 3e 66 75 6c 6c 53 79 6e 63 pPager->fullSync
23170 20 3d 20 6c 65 76 65 6c 3e 3d 50 41 47 45 52 5f = level>=PAGER_
23180 53 59 4e 43 48 52 4f 4e 4f 55 53 5f 46 55 4c 4c SYNCHRONOUS_FULL
23190 20 3f 31 3a 30 3b 0a 20 20 20 20 70 50 61 67 65 ?1:0;. pPage
231a0 72 2d 3e 65 78 74 72 61 53 79 6e 63 20 3d 20 6c r->extraSync = l
231b0 65 76 65 6c 3d 3d 50 41 47 45 52 5f 53 59 4e 43 evel==PAGER_SYNC
231c0 48 52 4f 4e 4f 55 53 5f 45 58 54 52 41 20 3f 31 HRONOUS_EXTRA ?1
231d0 3a 30 3b 0a 20 20 7d 0a 20 20 69 66 28 20 70 50 :0;. }. if( pP
231e0 61 67 65 72 2d 3e 6e 6f 53 79 6e 63 20 29 7b 0a ager->noSync ){.
231f0 20 20 20 20 70 50 61 67 65 72 2d 3e 73 79 6e 63 pPager->sync
23200 46 6c 61 67 73 20 3d 20 30 3b 0a 20 20 20 20 70 Flags = 0;. p
23210 50 61 67 65 72 2d 3e 63 6b 70 74 53 79 6e 63 46 Pager->ckptSyncF
23220 6c 61 67 73 20 3d 20 30 3b 0a 20 20 7d 65 6c 73 lags = 0;. }els
23230 65 20 69 66 28 20 70 67 46 6c 61 67 73 20 26 20 e if( pgFlags &
23240 50 41 47 45 52 5f 46 55 4c 4c 46 53 59 4e 43 20 PAGER_FULLFSYNC
23250 29 7b 0a 20 20 20 20 70 50 61 67 65 72 2d 3e 73 ){. pPager->s
23260 79 6e 63 46 6c 61 67 73 20 3d 20 53 51 4c 49 54 yncFlags = SQLIT
23270 45 5f 53 59 4e 43 5f 46 55 4c 4c 3b 0a 20 20 20 E_SYNC_FULL;.
23280 20 70 50 61 67 65 72 2d 3e 63 6b 70 74 53 79 6e pPager->ckptSyn
23290 63 46 6c 61 67 73 20 3d 20 53 51 4c 49 54 45 5f cFlags = SQLITE_
232a0 53 59 4e 43 5f 46 55 4c 4c 3b 0a 20 20 7d 65 6c SYNC_FULL;. }el
232b0 73 65 20 69 66 28 20 70 67 46 6c 61 67 73 20 26 se if( pgFlags &
232c0 20 50 41 47 45 52 5f 43 4b 50 54 5f 46 55 4c 4c PAGER_CKPT_FULL
232d0 46 53 59 4e 43 20 29 7b 0a 20 20 20 20 70 50 61 FSYNC ){. pPa
232e0 67 65 72 2d 3e 73 79 6e 63 46 6c 61 67 73 20 3d ger->syncFlags =
232f0 20 53 51 4c 49 54 45 5f 53 59 4e 43 5f 4e 4f 52 SQLITE_SYNC_NOR
23300 4d 41 4c 3b 0a 20 20 20 20 70 50 61 67 65 72 2d MAL;. pPager-
23310 3e 63 6b 70 74 53 79 6e 63 46 6c 61 67 73 20 3d >ckptSyncFlags =
23320 20 53 51 4c 49 54 45 5f 53 59 4e 43 5f 46 55 4c SQLITE_SYNC_FUL
23330 4c 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 L;. }else{.
23340 70 50 61 67 65 72 2d 3e 73 79 6e 63 46 6c 61 67 pPager->syncFlag
23350 73 20 3d 20 53 51 4c 49 54 45 5f 53 59 4e 43 5f s = SQLITE_SYNC_
23360 4e 4f 52 4d 41 4c 3b 0a 20 20 20 20 70 50 61 67 NORMAL;. pPag
23370 65 72 2d 3e 63 6b 70 74 53 79 6e 63 46 6c 61 67 er->ckptSyncFlag
23380 73 20 3d 20 53 51 4c 49 54 45 5f 53 59 4e 43 5f s = SQLITE_SYNC_
23390 4e 4f 52 4d 41 4c 3b 0a 20 20 7d 0a 20 20 70 50 NORMAL;. }. pP
233a0 61 67 65 72 2d 3e 77 61 6c 53 79 6e 63 46 6c 61 ager->walSyncFla
233b0 67 73 20 3d 20 70 50 61 67 65 72 2d 3e 73 79 6e gs = pPager->syn
233c0 63 46 6c 61 67 73 3b 0a 20 20 69 66 28 20 70 50 cFlags;. if( pP
233d0 61 67 65 72 2d 3e 66 75 6c 6c 53 79 6e 63 20 29 ager->fullSync )
233e0 7b 0a 20 20 20 20 70 50 61 67 65 72 2d 3e 77 61 {. pPager->wa
233f0 6c 53 79 6e 63 46 6c 61 67 73 20 7c 3d 20 57 41 lSyncFlags |= WA
23400 4c 5f 53 59 4e 43 5f 54 52 41 4e 53 41 43 54 49 L_SYNC_TRANSACTI
23410 4f 4e 53 3b 0a 20 20 7d 0a 20 20 69 66 28 20 70 ONS;. }. if( p
23420 67 46 6c 61 67 73 20 26 20 50 41 47 45 52 5f 43 gFlags & PAGER_C
23430 41 43 48 45 53 50 49 4c 4c 20 29 7b 0a 20 20 20 ACHESPILL ){.
23440 20 70 50 61 67 65 72 2d 3e 64 6f 4e 6f 74 53 70 pPager->doNotSp
23450 69 6c 6c 20 26 3d 20 7e 53 50 49 4c 4c 46 4c 41 ill &= ~SPILLFLA
23460 47 5f 4f 46 46 3b 0a 20 20 7d 65 6c 73 65 7b 0a G_OFF;. }else{.
23470 20 20 20 20 70 50 61 67 65 72 2d 3e 64 6f 4e 6f pPager->doNo
23480 74 53 70 69 6c 6c 20 7c 3d 20 53 50 49 4c 4c 46 tSpill |= SPILLF
23490 4c 41 47 5f 4f 46 46 3b 0a 20 20 7d 0a 7d 0a 23 LAG_OFF;. }.}.#
234a0 65 6e 64 69 66 0a 0a 2f 2a 0a 2a 2a 20 54 68 65 endif../*.** The
234b0 20 66 6f 6c 6c 6f 77 69 6e 67 20 67 6c 6f 62 61 following globa
234c0 6c 20 76 61 72 69 61 62 6c 65 20 69 73 20 69 6e l variable is in
234d0 63 72 65 6d 65 6e 74 65 64 20 77 68 65 6e 65 76 cremented whenev
234e0 65 72 20 74 68 65 20 6c 69 62 72 61 72 79 0a 2a er the library.*
234f0 2a 20 61 74 74 65 6d 70 74 73 20 74 6f 20 6f 70 * attempts to op
23500 65 6e 20 61 20 74 65 6d 70 6f 72 61 72 79 20 66 en a temporary f
23510 69 6c 65 2e 20 20 54 68 69 73 20 69 6e 66 6f 72 ile. This infor
23520 6d 61 74 69 6f 6e 20 69 73 20 75 73 65 64 20 66 mation is used f
23530 6f 72 0a 2a 2a 20 74 65 73 74 69 6e 67 20 61 6e or.** testing an
23540 64 20 61 6e 61 6c 79 73 69 73 20 6f 6e 6c 79 2e d analysis only.
23550 20 20 0a 2a 2f 0a 23 69 66 64 65 66 20 53 51 4c .*/.#ifdef SQL
23560 49 54 45 5f 54 45 53 54 0a 69 6e 74 20 73 71 6c ITE_TEST.int sql
23570 69 74 65 33 5f 6f 70 65 6e 74 65 6d 70 5f 63 6f ite3_opentemp_co
23580 75 6e 74 20 3d 20 30 3b 0a 23 65 6e 64 69 66 0a unt = 0;.#endif.
23590 0a 2f 2a 0a 2a 2a 20 4f 70 65 6e 20 61 20 74 65 ./*.** Open a te
235a0 6d 70 6f 72 61 72 79 20 66 69 6c 65 2e 0a 2a 2a mporary file..**
235b0 0a 2a 2a 20 57 72 69 74 65 20 74 68 65 20 66 69 .** Write the fi
235c0 6c 65 20 64 65 73 63 72 69 70 74 6f 72 20 69 6e le descriptor in
235d0 74 6f 20 2a 70 46 69 6c 65 2e 20 52 65 74 75 72 to *pFile. Retur
235e0 6e 20 53 51 4c 49 54 45 5f 4f 4b 20 6f 6e 20 73 n SQLITE_OK on s
235f0 75 63 63 65 73 73 20 0a 2a 2a 20 6f 72 20 73 6f uccess .** or so
23600 6d 65 20 6f 74 68 65 72 20 65 72 72 6f 72 20 63 me other error c
23610 6f 64 65 20 69 66 20 77 65 20 66 61 69 6c 2e 20 ode if we fail.
23620 54 68 65 20 4f 53 20 77 69 6c 6c 20 61 75 74 6f The OS will auto
23630 6d 61 74 69 63 61 6c 6c 79 20 0a 2a 2a 20 64 65 matically .** de
23640 6c 65 74 65 20 74 68 65 20 74 65 6d 70 6f 72 61 lete the tempora
23650 72 79 20 66 69 6c 65 20 77 68 65 6e 20 69 74 20 ry file when it
23660 69 73 20 63 6c 6f 73 65 64 2e 0a 2a 2a 0a 2a 2a is closed..**.**
23670 20 54 68 65 20 66 6c 61 67 73 20 70 61 73 73 65 The flags passe
23680 64 20 74 6f 20 74 68 65 20 56 46 53 20 6c 61 79 d to the VFS lay
23690 65 72 20 78 4f 70 65 6e 28 29 20 63 61 6c 6c 20 er xOpen() call
236a0 61 72 65 20 74 68 6f 73 65 20 73 70 65 63 69 66 are those specif
236b0 69 65 64 0a 2a 2a 20 62 79 20 70 61 72 61 6d 65 ied.** by parame
236c0 74 65 72 20 76 66 73 46 6c 61 67 73 20 4f 52 65 ter vfsFlags ORe
236d0 64 20 77 69 74 68 20 74 68 65 20 66 6f 6c 6c 6f d with the follo
236e0 77 69 6e 67 3a 0a 2a 2a 0a 2a 2a 20 20 20 20 20 wing:.**.**
236f0 53 51 4c 49 54 45 5f 4f 50 45 4e 5f 52 45 41 44 SQLITE_OPEN_READ
23700 57 52 49 54 45 0a 2a 2a 20 20 20 20 20 53 51 4c WRITE.** SQL
23710 49 54 45 5f 4f 50 45 4e 5f 43 52 45 41 54 45 0a ITE_OPEN_CREATE.
23720 2a 2a 20 20 20 20 20 53 51 4c 49 54 45 5f 4f 50 ** SQLITE_OP
23730 45 4e 5f 45 58 43 4c 55 53 49 56 45 0a 2a 2a 20 EN_EXCLUSIVE.**
23740 20 20 20 20 53 51 4c 49 54 45 5f 4f 50 45 4e 5f SQLITE_OPEN_
23750 44 45 4c 45 54 45 4f 4e 43 4c 4f 53 45 0a 2a 2f DELETEONCLOSE.*/
23760 0a 73 74 61 74 69 63 20 69 6e 74 20 70 61 67 65 .static int page
23770 72 4f 70 65 6e 74 65 6d 70 28 0a 20 20 50 61 67 rOpentemp(. Pag
23780 65 72 20 2a 70 50 61 67 65 72 2c 20 20 20 20 20 er *pPager,
23790 20 20 20 2f 2a 20 54 68 65 20 70 61 67 65 72 20 /* The pager
237a0 6f 62 6a 65 63 74 20 2a 2f 0a 20 20 73 71 6c 69 object */. sqli
237b0 74 65 33 5f 66 69 6c 65 20 2a 70 46 69 6c 65 2c te3_file *pFile,
237c0 20 20 2f 2a 20 57 72 69 74 65 20 74 68 65 20 66 /* Write the f
237d0 69 6c 65 20 64 65 73 63 72 69 70 74 6f 72 20 68 ile descriptor h
237e0 65 72 65 20 2a 2f 0a 20 20 69 6e 74 20 76 66 73 ere */. int vfs
237f0 46 6c 61 67 73 20 20 20 20 20 20 20 20 20 20 2f Flags /
23800 2a 20 46 6c 61 67 73 20 70 61 73 73 65 64 20 74 * Flags passed t
23810 68 72 6f 75 67 68 20 74 6f 20 74 68 65 20 56 46 hrough to the VF
23820 53 20 2a 2f 0a 29 7b 0a 20 20 69 6e 74 20 72 63 S */.){. int rc
23830 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 ;
23840 2f 2a 20 52 65 74 75 72 6e 20 63 6f 64 65 20 2a /* Return code *
23850 2f 0a 0a 23 69 66 64 65 66 20 53 51 4c 49 54 45 /..#ifdef SQLITE
23860 5f 54 45 53 54 0a 20 20 73 71 6c 69 74 65 33 5f _TEST. sqlite3_
23870 6f 70 65 6e 74 65 6d 70 5f 63 6f 75 6e 74 2b 2b opentemp_count++
23880 3b 20 20 2f 2a 20 55 73 65 64 20 66 6f 72 20 74 ; /* Used for t
23890 65 73 74 69 6e 67 20 61 6e 64 20 61 6e 61 6c 79 esting and analy
238a0 73 69 73 20 6f 6e 6c 79 20 2a 2f 0a 23 65 6e 64 sis only */.#end
238b0 69 66 0a 0a 20 20 76 66 73 46 6c 61 67 73 20 7c if.. vfsFlags |
238c0 3d 20 20 53 51 4c 49 54 45 5f 4f 50 45 4e 5f 52 = SQLITE_OPEN_R
238d0 45 41 44 57 52 49 54 45 20 7c 20 53 51 4c 49 54 EADWRITE | SQLIT
238e0 45 5f 4f 50 45 4e 5f 43 52 45 41 54 45 20 7c 0a E_OPEN_CREATE |.
238f0 20 20 20 20 20 20 20 20 20 20 20 20 53 51 4c 49 SQLI
23900 54 45 5f 4f 50 45 4e 5f 45 58 43 4c 55 53 49 56 TE_OPEN_EXCLUSIV
23910 45 20 7c 20 53 51 4c 49 54 45 5f 4f 50 45 4e 5f E | SQLITE_OPEN_
23920 44 45 4c 45 54 45 4f 4e 43 4c 4f 53 45 3b 0a 20 DELETEONCLOSE;.
23930 20 72 63 20 3d 20 73 71 6c 69 74 65 33 4f 73 4f rc = sqlite3OsO
23940 70 65 6e 28 70 50 61 67 65 72 2d 3e 70 56 66 73 pen(pPager->pVfs
23950 2c 20 30 2c 20 70 46 69 6c 65 2c 20 76 66 73 46 , 0, pFile, vfsF
23960 6c 61 67 73 2c 20 30 29 3b 0a 20 20 61 73 73 65 lags, 0);. asse
23970 72 74 28 20 72 63 21 3d 53 51 4c 49 54 45 5f 4f rt( rc!=SQLITE_O
23980 4b 20 7c 7c 20 69 73 4f 70 65 6e 28 70 46 69 6c K || isOpen(pFil
23990 65 29 20 29 3b 0a 20 20 72 65 74 75 72 6e 20 72 e) );. return r
239a0 63 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 53 65 74 20 c;.}../*.** Set
239b0 74 68 65 20 62 75 73 79 20 68 61 6e 64 6c 65 72 the busy handler
239c0 20 66 75 6e 63 74 69 6f 6e 2e 0a 2a 2a 0a 2a 2a function..**.**
239d0 20 54 68 65 20 70 61 67 65 72 20 69 6e 76 6f 6b The pager invok
239e0 65 73 20 74 68 65 20 62 75 73 79 2d 68 61 6e 64 es the busy-hand
239f0 6c 65 72 20 69 66 20 73 71 6c 69 74 65 33 4f 73 ler if sqlite3Os
23a00 4c 6f 63 6b 28 29 20 72 65 74 75 72 6e 73 20 0a Lock() returns .
23a10 2a 2a 20 53 51 4c 49 54 45 5f 42 55 53 59 20 77 ** SQLITE_BUSY w
23a20 68 65 6e 20 74 72 79 69 6e 67 20 74 6f 20 75 70 hen trying to up
23a30 67 72 61 64 65 20 66 72 6f 6d 20 6e 6f 2d 6c 6f grade from no-lo
23a40 63 6b 20 74 6f 20 61 20 53 48 41 52 45 44 20 6c ck to a SHARED l
23a50 6f 63 6b 2c 0a 2a 2a 20 6f 72 20 77 68 65 6e 20 ock,.** or when
23a60 74 72 79 69 6e 67 20 74 6f 20 75 70 67 72 61 64 trying to upgrad
23a70 65 20 66 72 6f 6d 20 61 20 52 45 53 45 52 56 45 e from a RESERVE
23a80 44 20 6c 6f 63 6b 20 74 6f 20 61 6e 20 45 58 43 D lock to an EXC
23a90 4c 55 53 49 56 45 20 0a 2a 2a 20 6c 6f 63 6b 2e LUSIVE .** lock.
23aa0 20 49 74 20 64 6f 65 73 20 2a 6e 6f 74 2a 20 69 It does *not* i
23ab0 6e 76 6f 6b 65 20 74 68 65 20 62 75 73 79 20 68 nvoke the busy h
23ac0 61 6e 64 6c 65 72 20 77 68 65 6e 20 75 70 67 72 andler when upgr
23ad0 61 64 69 6e 67 20 66 72 6f 6d 0a 2a 2a 20 53 48 ading from.** SH
23ae0 41 52 45 44 20 74 6f 20 52 45 53 45 52 56 45 44 ARED to RESERVED
23af0 2c 20 6f 72 20 77 68 65 6e 20 75 70 67 72 61 64 , or when upgrad
23b00 69 6e 67 20 66 72 6f 6d 20 53 48 41 52 45 44 20 ing from SHARED
23b10 74 6f 20 45 58 43 4c 55 53 49 56 45 0a 2a 2a 20 to EXCLUSIVE.**
23b20 28 77 68 69 63 68 20 6f 63 63 75 72 73 20 64 75 (which occurs du
23b30 72 69 6e 67 20 68 6f 74 2d 6a 6f 75 72 6e 61 6c ring hot-journal
23b40 20 72 6f 6c 6c 62 61 63 6b 29 2e 20 53 75 6d 6d rollback). Summ
23b50 61 72 79 3a 0a 2a 2a 0a 2a 2a 20 20 20 54 72 61 ary:.**.** Tra
23b60 6e 73 69 74 69 6f 6e 20 20 20 20 20 20 20 20 20 nsition
23b70 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 7c |
23b80 20 49 6e 76 6f 6b 65 73 20 78 42 75 73 79 48 61 Invokes xBusyHa
23b90 6e 64 6c 65 72 0a 2a 2a 20 20 20 2d 2d 2d 2d 2d ndler.** -----
23ba0 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
23bb0 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
23bc0 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
23bd0 2d 2d 2d 0a 2a 2a 20 20 20 4e 4f 5f 4c 4f 43 4b ---.** NO_LOCK
23be0 20 20 20 20 20 20 20 2d 3e 20 53 48 41 52 45 44 -> SHARED
23bf0 5f 4c 4f 43 4b 20 20 20 20 20 20 7c 20 59 65 73 _LOCK | Yes
23c00 0a 2a 2a 20 20 20 53 48 41 52 45 44 5f 4c 4f 43 .** SHARED_LOC
23c10 4b 20 20 20 2d 3e 20 52 45 53 45 52 56 45 44 5f K -> RESERVED_
23c20 4c 4f 43 4b 20 20 20 20 7c 20 4e 6f 0a 2a 2a 20 LOCK | No.**
23c30 20 20 53 48 41 52 45 44 5f 4c 4f 43 4b 20 20 20 SHARED_LOCK
23c40 2d 3e 20 45 58 43 4c 55 53 49 56 45 5f 4c 4f 43 -> EXCLUSIVE_LOC
23c50 4b 20 20 20 7c 20 4e 6f 0a 2a 2a 20 20 20 52 45 K | No.** RE
23c60 53 45 52 56 45 44 5f 4c 4f 43 4b 20 2d 3e 20 45 SERVED_LOCK -> E
23c70 58 43 4c 55 53 49 56 45 5f 4c 4f 43 4b 20 20 20 XCLUSIVE_LOCK
23c80 7c 20 59 65 73 0a 2a 2a 0a 2a 2a 20 49 66 20 74 | Yes.**.** If t
23c90 68 65 20 62 75 73 79 2d 68 61 6e 64 6c 65 72 20 he busy-handler
23ca0 63 61 6c 6c 62 61 63 6b 20 72 65 74 75 72 6e 73 callback returns
23cb0 20 6e 6f 6e 2d 7a 65 72 6f 2c 20 74 68 65 20 6c non-zero, the l
23cc0 6f 63 6b 20 69 73 20 0a 2a 2a 20 72 65 74 72 69 ock is .** retri
23cd0 65 64 2e 20 49 66 20 69 74 20 72 65 74 75 72 6e ed. If it return
23ce0 73 20 7a 65 72 6f 2c 20 74 68 65 6e 20 74 68 65 s zero, then the
23cf0 20 53 51 4c 49 54 45 5f 42 55 53 59 20 65 72 72 SQLITE_BUSY err
23d00 6f 72 20 69 73 0a 2a 2a 20 72 65 74 75 72 6e 65 or is.** returne
23d10 64 20 74 6f 20 74 68 65 20 63 61 6c 6c 65 72 20 d to the caller
23d20 6f 66 20 74 68 65 20 70 61 67 65 72 20 41 50 49 of the pager API
23d30 20 66 75 6e 63 74 69 6f 6e 2e 0a 2a 2f 0a 76 6f function..*/.vo
23d40 69 64 20 73 71 6c 69 74 65 33 50 61 67 65 72 53 id sqlite3PagerS
23d50 65 74 42 75 73 79 68 61 6e 64 6c 65 72 28 0a 20 etBusyhandler(.
23d60 20 50 61 67 65 72 20 2a 70 50 61 67 65 72 2c 20 Pager *pPager,
23d70 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
23d80 20 20 20 20 20 20 2f 2a 20 50 61 67 65 72 20 6f /* Pager o
23d90 62 6a 65 63 74 20 2a 2f 0a 20 20 69 6e 74 20 28 bject */. int (
23da0 2a 78 42 75 73 79 48 61 6e 64 6c 65 72 29 28 76 *xBusyHandler)(v
23db0 6f 69 64 20 2a 29 2c 20 20 20 20 20 20 20 20 20 oid *),
23dc0 2f 2a 20 50 6f 69 6e 74 65 72 20 74 6f 20 62 75 /* Pointer to bu
23dd0 73 79 2d 68 61 6e 64 6c 65 72 20 66 75 6e 63 74 sy-handler funct
23de0 69 6f 6e 20 2a 2f 0a 20 20 76 6f 69 64 20 2a 70 ion */. void *p
23df0 42 75 73 79 48 61 6e 64 6c 65 72 41 72 67 20 20 BusyHandlerArg
23e00 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a /*
23e10 20 41 72 67 75 6d 65 6e 74 20 74 6f 20 70 61 73 Argument to pas
23e20 73 20 74 6f 20 78 42 75 73 79 48 61 6e 64 6c 65 s to xBusyHandle
23e30 72 20 2a 2f 0a 29 7b 0a 20 20 70 50 61 67 65 72 r */.){. pPager
23e40 2d 3e 78 42 75 73 79 48 61 6e 64 6c 65 72 20 3d ->xBusyHandler =
23e50 20 78 42 75 73 79 48 61 6e 64 6c 65 72 3b 0a 20 xBusyHandler;.
23e60 20 70 50 61 67 65 72 2d 3e 70 42 75 73 79 48 61 pPager->pBusyHa
23e70 6e 64 6c 65 72 41 72 67 20 3d 20 70 42 75 73 79 ndlerArg = pBusy
23e80 48 61 6e 64 6c 65 72 41 72 67 3b 0a 0a 20 20 69 HandlerArg;.. i
23e90 66 28 20 69 73 4f 70 65 6e 28 70 50 61 67 65 72 f( isOpen(pPager
23ea0 2d 3e 66 64 29 20 29 7b 0a 20 20 20 20 76 6f 69 ->fd) ){. voi
23eb0 64 20 2a 2a 61 70 20 3d 20 28 76 6f 69 64 20 2a d **ap = (void *
23ec0 2a 29 26 70 50 61 67 65 72 2d 3e 78 42 75 73 79 *)&pPager->xBusy
23ed0 48 61 6e 64 6c 65 72 3b 0a 20 20 20 20 61 73 73 Handler;. ass
23ee0 65 72 74 28 20 28 28 69 6e 74 28 2a 29 28 76 6f ert( ((int(*)(vo
23ef0 69 64 20 2a 29 29 28 61 70 5b 30 5d 29 29 3d 3d id *))(ap[0]))==
23f00 78 42 75 73 79 48 61 6e 64 6c 65 72 20 29 3b 0a xBusyHandler );.
23f10 20 20 20 20 61 73 73 65 72 74 28 20 61 70 5b 31 assert( ap[1
23f20 5d 3d 3d 70 42 75 73 79 48 61 6e 64 6c 65 72 41 ]==pBusyHandlerA
23f30 72 67 20 29 3b 0a 20 20 20 20 73 71 6c 69 74 65 rg );. sqlite
23f40 33 4f 73 46 69 6c 65 43 6f 6e 74 72 6f 6c 48 69 3OsFileControlHi
23f50 6e 74 28 70 50 61 67 65 72 2d 3e 66 64 2c 20 53 nt(pPager->fd, S
23f60 51 4c 49 54 45 5f 46 43 4e 54 4c 5f 42 55 53 59 QLITE_FCNTL_BUSY
23f70 48 41 4e 44 4c 45 52 2c 20 28 76 6f 69 64 20 2a HANDLER, (void *
23f80 29 61 70 29 3b 0a 20 20 7d 0a 7d 0a 0a 2f 2a 0a )ap);. }.}../*.
23f90 2a 2a 20 43 68 61 6e 67 65 20 74 68 65 20 70 61 ** Change the pa
23fa0 67 65 20 73 69 7a 65 20 75 73 65 64 20 62 79 20 ge size used by
23fb0 74 68 65 20 50 61 67 65 72 20 6f 62 6a 65 63 74 the Pager object
23fc0 2e 20 54 68 65 20 6e 65 77 20 70 61 67 65 20 73 . The new page s
23fd0 69 7a 65 20 0a 2a 2a 20 69 73 20 70 61 73 73 65 ize .** is passe
23fe0 64 20 69 6e 20 2a 70 50 61 67 65 53 69 7a 65 2e d in *pPageSize.
23ff0 0a 2a 2a 0a 2a 2a 20 49 66 20 74 68 65 20 70 61 .**.** If the pa
24000 67 65 72 20 69 73 20 69 6e 20 74 68 65 20 65 72 ger is in the er
24010 72 6f 72 20 73 74 61 74 65 20 77 68 65 6e 20 74 ror state when t
24020 68 69 73 20 66 75 6e 63 74 69 6f 6e 20 69 73 20 his function is
24030 63 61 6c 6c 65 64 2c 20 69 74 0a 2a 2a 20 69 73 called, it.** is
24040 20 61 20 6e 6f 2d 6f 70 2e 20 54 68 65 20 76 61 a no-op. The va
24050 6c 75 65 20 72 65 74 75 72 6e 65 64 20 69 73 20 lue returned is
24060 74 68 65 20 65 72 72 6f 72 20 73 74 61 74 65 20 the error state
24070 65 72 72 6f 72 20 63 6f 64 65 20 28 69 2e 65 2e error code (i.e.
24080 20 0a 2a 2a 20 6f 6e 65 20 6f 66 20 53 51 4c 49 .** one of SQLI
24090 54 45 5f 49 4f 45 52 52 2c 20 61 6e 20 53 51 4c TE_IOERR, an SQL
240a0 49 54 45 5f 49 4f 45 52 52 5f 78 78 78 20 73 75 ITE_IOERR_xxx su
240b0 62 2d 63 6f 64 65 20 6f 72 20 53 51 4c 49 54 45 b-code or SQLITE
240c0 5f 46 55 4c 4c 29 2e 0a 2a 2a 0a 2a 2a 20 4f 74 _FULL)..**.** Ot
240d0 68 65 72 77 69 73 65 2c 20 69 66 20 61 6c 6c 20 herwise, if all
240e0 6f 66 20 74 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 of the following
240f0 20 61 72 65 20 74 72 75 65 3a 0a 2a 2a 0a 2a 2a are true:.**.**
24100 20 20 20 2a 20 74 68 65 20 6e 65 77 20 70 61 67 * the new pag
24110 65 20 73 69 7a 65 20 28 76 61 6c 75 65 20 6f 66 e size (value of
24120 20 2a 70 50 61 67 65 53 69 7a 65 29 20 69 73 20 *pPageSize) is
24130 76 61 6c 69 64 20 28 61 20 70 6f 77 65 72 20 0a valid (a power .
24140 2a 2a 20 20 20 20 20 6f 66 20 74 77 6f 20 62 65 ** of two be
24150 74 77 65 65 6e 20 35 31 32 20 61 6e 64 20 53 51 tween 512 and SQ
24160 4c 49 54 45 5f 4d 41 58 5f 50 41 47 45 5f 53 49 LITE_MAX_PAGE_SI
24170 5a 45 2c 20 69 6e 63 6c 75 73 69 76 65 29 2c 20 ZE, inclusive),
24180 61 6e 64 0a 2a 2a 0a 2a 2a 20 20 20 2a 20 74 68 and.**.** * th
24190 65 72 65 20 61 72 65 20 6e 6f 20 6f 75 74 73 74 ere are no outst
241a0 61 6e 64 69 6e 67 20 70 61 67 65 20 72 65 66 65 anding page refe
241b0 72 65 6e 63 65 73 2c 20 61 6e 64 0a 2a 2a 0a 2a rences, and.**.*
241c0 2a 20 20 20 2a 20 74 68 65 20 64 61 74 61 62 61 * * the databa
241d0 73 65 20 69 73 20 65 69 74 68 65 72 20 6e 6f 74 se is either not
241e0 20 61 6e 20 69 6e 2d 6d 65 6d 6f 72 79 20 64 61 an in-memory da
241f0 74 61 62 61 73 65 20 6f 72 20 69 74 20 69 73 0a tabase or it is.
24200 2a 2a 20 20 20 20 20 61 6e 20 69 6e 2d 6d 65 6d ** an in-mem
24210 6f 72 79 20 64 61 74 61 62 61 73 65 20 74 68 61 ory database tha
24220 74 20 63 75 72 72 65 6e 74 6c 79 20 63 6f 6e 73 t currently cons
24230 69 73 74 73 20 6f 66 20 7a 65 72 6f 20 70 61 67 ists of zero pag
24240 65 73 2e 0a 2a 2a 0a 2a 2a 20 74 68 65 6e 20 74 es..**.** then t
24250 68 65 20 70 61 67 65 72 20 6f 62 6a 65 63 74 20 he pager object
24260 70 61 67 65 20 73 69 7a 65 20 69 73 20 73 65 74 page size is set
24270 20 74 6f 20 2a 70 50 61 67 65 53 69 7a 65 2e 0a to *pPageSize..
24280 2a 2a 0a 2a 2a 20 49 66 20 74 68 65 20 70 61 67 **.** If the pag
24290 65 20 73 69 7a 65 20 69 73 20 63 68 61 6e 67 65 e size is change
242a0 64 2c 20 74 68 65 6e 20 74 68 69 73 20 66 75 6e d, then this fun
242b0 63 74 69 6f 6e 20 75 73 65 73 20 73 71 6c 69 74 ction uses sqlit
242c0 65 33 50 61 67 65 72 4d 61 6c 6c 6f 63 28 29 20 e3PagerMalloc()
242d0 0a 2a 2a 20 74 6f 20 6f 62 74 61 69 6e 20 61 20 .** to obtain a
242e0 6e 65 77 20 50 61 67 65 72 2e 70 54 6d 70 53 70 new Pager.pTmpSp
242f0 61 63 65 20 62 75 66 66 65 72 2e 20 49 66 20 74 ace buffer. If t
24300 68 69 73 20 61 6c 6c 6f 63 61 74 69 6f 6e 20 61 his allocation a
24310 74 74 65 6d 70 74 20 0a 2a 2a 20 66 61 69 6c 73 ttempt .** fails
24320 2c 20 53 51 4c 49 54 45 5f 4e 4f 4d 45 4d 20 69 , SQLITE_NOMEM i
24330 73 20 72 65 74 75 72 6e 65 64 20 61 6e 64 20 74 s returned and t
24340 68 65 20 70 61 67 65 20 73 69 7a 65 20 72 65 6d he page size rem
24350 61 69 6e 73 20 75 6e 63 68 61 6e 67 65 64 2e 20 ains unchanged.
24360 0a 2a 2a 20 49 6e 20 61 6c 6c 20 6f 74 68 65 72 .** In all other
24370 20 63 61 73 65 73 2c 20 53 51 4c 49 54 45 5f 4f cases, SQLITE_O
24380 4b 20 69 73 20 72 65 74 75 72 6e 65 64 2e 0a 2a K is returned..*
24390 2a 0a 2a 2a 20 49 66 20 74 68 65 20 70 61 67 65 *.** If the page
243a0 20 73 69 7a 65 20 69 73 20 6e 6f 74 20 63 68 61 size is not cha
243b0 6e 67 65 64 2c 20 65 69 74 68 65 72 20 62 65 63 nged, either bec
243c0 61 75 73 65 20 6f 6e 65 20 6f 66 20 74 68 65 20 ause one of the
243d0 65 6e 75 6d 65 72 61 74 65 64 0a 2a 2a 20 63 6f enumerated.** co
243e0 6e 64 69 74 69 6f 6e 73 20 61 62 6f 76 65 20 69 nditions above i
243f0 73 20 6e 6f 74 20 74 72 75 65 2c 20 74 68 65 20 s not true, the
24400 70 61 67 65 72 20 77 61 73 20 69 6e 20 65 72 72 pager was in err
24410 6f 72 20 73 74 61 74 65 20 77 68 65 6e 20 74 68 or state when th
24420 69 73 0a 2a 2a 20 66 75 6e 63 74 69 6f 6e 20 77 is.** function w
24430 61 73 20 63 61 6c 6c 65 64 2c 20 6f 72 20 62 65 as called, or be
24440 63 61 75 73 65 20 74 68 65 20 6d 65 6d 6f 72 79 cause the memory
24450 20 61 6c 6c 6f 63 61 74 69 6f 6e 20 61 74 74 65 allocation atte
24460 6d 70 74 20 66 61 69 6c 65 64 2c 20 0a 2a 2a 20 mpt failed, .**
24470 74 68 65 6e 20 2a 70 50 61 67 65 53 69 7a 65 20 then *pPageSize
24480 69 73 20 73 65 74 20 74 6f 20 74 68 65 20 6f 6c is set to the ol
24490 64 2c 20 72 65 74 61 69 6e 65 64 20 70 61 67 65 d, retained page
244a0 20 73 69 7a 65 20 62 65 66 6f 72 65 20 72 65 74 size before ret
244b0 75 72 6e 69 6e 67 2e 0a 2a 2f 0a 69 6e 74 20 73 urning..*/.int s
244c0 71 6c 69 74 65 33 50 61 67 65 72 53 65 74 50 61 qlite3PagerSetPa
244d0 67 65 73 69 7a 65 28 50 61 67 65 72 20 2a 70 50 gesize(Pager *pP
244e0 61 67 65 72 2c 20 75 33 32 20 2a 70 50 61 67 65 ager, u32 *pPage
244f0 53 69 7a 65 2c 20 69 6e 74 20 6e 52 65 73 65 72 Size, int nReser
24500 76 65 29 7b 0a 20 20 69 6e 74 20 72 63 20 3d 20 ve){. int rc =
24510 53 51 4c 49 54 45 5f 4f 4b 3b 0a 0a 20 20 2f 2a SQLITE_OK;.. /*
24520 20 49 74 20 69 73 20 6e 6f 74 20 70 6f 73 73 69 It is not possi
24530 62 6c 65 20 74 6f 20 64 6f 20 61 20 66 75 6c 6c ble to do a full
24540 20 61 73 73 65 72 74 5f 70 61 67 65 72 5f 73 74 assert_pager_st
24550 61 74 65 28 29 20 68 65 72 65 2c 20 61 73 20 74 ate() here, as t
24560 68 69 73 0a 20 20 2a 2a 20 66 75 6e 63 74 69 6f his. ** functio
24570 6e 20 6d 61 79 20 62 65 20 63 61 6c 6c 65 64 20 n may be called
24580 66 72 6f 6d 20 77 69 74 68 69 6e 20 50 61 67 65 from within Page
24590 72 4f 70 65 6e 28 29 2c 20 62 65 66 6f 72 65 20 rOpen(), before
245a0 74 68 65 20 73 74 61 74 65 0a 20 20 2a 2a 20 6f the state. ** o
245b0 66 20 74 68 65 20 50 61 67 65 72 20 6f 62 6a 65 f the Pager obje
245c0 63 74 20 69 73 20 69 6e 74 65 72 6e 61 6c 6c 79 ct is internally
245d0 20 63 6f 6e 73 69 73 74 65 6e 74 2e 0a 20 20 2a consistent.. *
245e0 2a 0a 20 20 2a 2a 20 41 74 20 6f 6e 65 20 70 6f *. ** At one po
245f0 69 6e 74 20 74 68 69 73 20 66 75 6e 63 74 69 6f int this functio
24600 6e 20 72 65 74 75 72 6e 65 64 20 61 6e 20 65 72 n returned an er
24610 72 6f 72 20 69 66 20 74 68 65 20 70 61 67 65 72 ror if the pager
24620 20 77 61 73 20 69 6e 20 0a 20 20 2a 2a 20 50 41 was in . ** PA
24630 47 45 52 5f 45 52 52 4f 52 20 73 74 61 74 65 2e GER_ERROR state.
24640 20 42 75 74 20 73 69 6e 63 65 20 50 41 47 45 52 But since PAGER
24650 5f 45 52 52 4f 52 20 73 74 61 74 65 20 67 75 61 _ERROR state gua
24660 72 61 6e 74 65 65 73 20 74 68 61 74 0a 20 20 2a rantees that. *
24670 2a 20 74 68 65 72 65 20 69 73 20 61 74 20 6c 65 * there is at le
24680 61 73 74 20 6f 6e 65 20 6f 75 74 73 74 61 6e 64 ast one outstand
24690 69 6e 67 20 70 61 67 65 20 72 65 66 65 72 65 6e ing page referen
246a0 63 65 2c 20 74 68 69 73 20 66 75 6e 63 74 69 6f ce, this functio
246b0 6e 0a 20 20 2a 2a 20 69 73 20 61 20 6e 6f 2d 6f n. ** is a no-o
246c0 70 20 66 6f 72 20 74 68 61 74 20 63 61 73 65 20 p for that case
246d0 61 6e 79 68 6f 77 2e 0a 20 20 2a 2f 0a 0a 20 20 anyhow.. */..
246e0 75 33 32 20 70 61 67 65 53 69 7a 65 20 3d 20 2a u32 pageSize = *
246f0 70 50 61 67 65 53 69 7a 65 3b 0a 20 20 61 73 73 pPageSize;. ass
24700 65 72 74 28 20 70 61 67 65 53 69 7a 65 3d 3d 30 ert( pageSize==0
24710 20 7c 7c 20 28 70 61 67 65 53 69 7a 65 3e 3d 35 || (pageSize>=5
24720 31 32 20 26 26 20 70 61 67 65 53 69 7a 65 3c 3d 12 && pageSize<=
24730 53 51 4c 49 54 45 5f 4d 41 58 5f 50 41 47 45 5f SQLITE_MAX_PAGE_
24740 53 49 5a 45 29 20 29 3b 0a 20 20 69 66 28 20 28 SIZE) );. if( (
24750 70 50 61 67 65 72 2d 3e 6d 65 6d 44 62 3d 3d 30 pPager->memDb==0
24760 20 7c 7c 20 70 50 61 67 65 72 2d 3e 64 62 53 69 || pPager->dbSi
24770 7a 65 3d 3d 30 29 0a 20 20 20 26 26 20 73 71 6c ze==0). && sql
24780 69 74 65 33 50 63 61 63 68 65 52 65 66 43 6f 75 ite3PcacheRefCou
24790 6e 74 28 70 50 61 67 65 72 2d 3e 70 50 43 61 63 nt(pPager->pPCac
247a0 68 65 29 3d 3d 30 20 0a 20 20 20 26 26 20 70 61 he)==0 . && pa
247b0 67 65 53 69 7a 65 20 26 26 20 70 61 67 65 53 69 geSize && pageSi
247c0 7a 65 21 3d 28 75 33 32 29 70 50 61 67 65 72 2d ze!=(u32)pPager-
247d0 3e 70 61 67 65 53 69 7a 65 20 0a 20 20 29 7b 0a >pageSize . ){.
247e0 20 20 20 20 63 68 61 72 20 2a 70 4e 65 77 20 3d char *pNew =
247f0 20 4e 55 4c 4c 3b 20 20 20 20 20 20 20 20 20 20 NULL;
24800 20 20 20 2f 2a 20 4e 65 77 20 74 65 6d 70 20 73 /* New temp s
24810 70 61 63 65 20 2a 2f 0a 20 20 20 20 69 36 34 20 pace */. i64
24820 6e 42 79 74 65 20 3d 20 30 3b 0a 0a 20 20 20 20 nByte = 0;..
24830 69 66 28 20 70 50 61 67 65 72 2d 3e 65 53 74 61 if( pPager->eSta
24840 74 65 3e 50 41 47 45 52 5f 4f 50 45 4e 20 26 26 te>PAGER_OPEN &&
24850 20 69 73 4f 70 65 6e 28 70 50 61 67 65 72 2d 3e isOpen(pPager->
24860 66 64 29 20 29 7b 0a 20 20 20 20 20 20 72 63 20 fd) ){. rc
24870 3d 20 73 71 6c 69 74 65 33 4f 73 46 69 6c 65 53 = sqlite3OsFileS
24880 69 7a 65 28 70 50 61 67 65 72 2d 3e 66 64 2c 20 ize(pPager->fd,
24890 26 6e 42 79 74 65 29 3b 0a 20 20 20 20 7d 0a 20 &nByte);. }.
248a0 20 20 20 69 66 28 20 72 63 3d 3d 53 51 4c 49 54 if( rc==SQLIT
248b0 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 20 20 70 4e E_OK ){. pN
248c0 65 77 20 3d 20 28 63 68 61 72 20 2a 29 73 71 6c ew = (char *)sql
248d0 69 74 65 33 50 61 67 65 4d 61 6c 6c 6f 63 28 70 ite3PageMalloc(p
248e0 61 67 65 53 69 7a 65 29 3b 0a 20 20 20 20 20 20 ageSize);.
248f0 69 66 28 20 21 70 4e 65 77 20 29 20 72 63 20 3d if( !pNew ) rc =
24900 20 53 51 4c 49 54 45 5f 4e 4f 4d 45 4d 5f 42 4b SQLITE_NOMEM_BK
24910 50 54 3b 0a 20 20 20 20 7d 0a 0a 20 20 20 20 69 PT;. }.. i
24920 66 28 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b f( rc==SQLITE_OK
24930 20 29 7b 0a 20 20 20 20 20 20 70 61 67 65 72 5f ){. pager_
24940 72 65 73 65 74 28 70 50 61 67 65 72 29 3b 0a 20 reset(pPager);.
24950 20 20 20 20 20 72 63 20 3d 20 73 71 6c 69 74 65 rc = sqlite
24960 33 50 63 61 63 68 65 53 65 74 50 61 67 65 53 69 3PcacheSetPageSi
24970 7a 65 28 70 50 61 67 65 72 2d 3e 70 50 43 61 63 ze(pPager->pPCac
24980 68 65 2c 20 70 61 67 65 53 69 7a 65 29 3b 0a 20 he, pageSize);.
24990 20 20 20 7d 0a 20 20 20 20 69 66 28 20 72 63 3d }. if( rc=
249a0 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 =SQLITE_OK ){.
249b0 20 20 20 20 73 71 6c 69 74 65 33 50 61 67 65 46 sqlite3PageF
249c0 72 65 65 28 70 50 61 67 65 72 2d 3e 70 54 6d 70 ree(pPager->pTmp
249d0 53 70 61 63 65 29 3b 0a 20 20 20 20 20 20 70 50 Space);. pP
249e0 61 67 65 72 2d 3e 70 54 6d 70 53 70 61 63 65 20 ager->pTmpSpace
249f0 3d 20 70 4e 65 77 3b 0a 20 20 20 20 20 20 70 50 = pNew;. pP
24a00 61 67 65 72 2d 3e 64 62 53 69 7a 65 20 3d 20 28 ager->dbSize = (
24a10 50 67 6e 6f 29 28 28 6e 42 79 74 65 2b 70 61 67 Pgno)((nByte+pag
24a20 65 53 69 7a 65 2d 31 29 2f 70 61 67 65 53 69 7a eSize-1)/pageSiz
24a30 65 29 3b 0a 20 20 20 20 20 20 70 50 61 67 65 72 e);. pPager
24a40 2d 3e 70 61 67 65 53 69 7a 65 20 3d 20 70 61 67 ->pageSize = pag
24a50 65 53 69 7a 65 3b 0a 20 20 20 20 7d 65 6c 73 65 eSize;. }else
24a60 7b 0a 20 20 20 20 20 20 73 71 6c 69 74 65 33 50 {. sqlite3P
24a70 61 67 65 46 72 65 65 28 70 4e 65 77 29 3b 0a 20 ageFree(pNew);.
24a80 20 20 20 7d 0a 20 20 7d 0a 0a 20 20 2a 70 50 61 }. }.. *pPa
24a90 67 65 53 69 7a 65 20 3d 20 70 50 61 67 65 72 2d geSize = pPager-
24aa0 3e 70 61 67 65 53 69 7a 65 3b 0a 20 20 69 66 28 >pageSize;. if(
24ab0 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 rc==SQLITE_OK )
24ac0 7b 0a 20 20 20 20 69 66 28 20 6e 52 65 73 65 72 {. if( nReser
24ad0 76 65 3c 30 20 29 20 6e 52 65 73 65 72 76 65 20 ve<0 ) nReserve
24ae0 3d 20 70 50 61 67 65 72 2d 3e 6e 52 65 73 65 72 = pPager->nReser
24af0 76 65 3b 0a 20 20 20 20 61 73 73 65 72 74 28 20 ve;. assert(
24b00 6e 52 65 73 65 72 76 65 3e 3d 30 20 26 26 20 6e nReserve>=0 && n
24b10 52 65 73 65 72 76 65 3c 31 30 30 30 20 29 3b 0a Reserve<1000 );.
24b20 20 20 20 20 70 50 61 67 65 72 2d 3e 6e 52 65 73 pPager->nRes
24b30 65 72 76 65 20 3d 20 28 69 31 36 29 6e 52 65 73 erve = (i16)nRes
24b40 65 72 76 65 3b 0a 20 20 20 20 70 61 67 65 72 52 erve;. pagerR
24b50 65 70 6f 72 74 53 69 7a 65 28 70 50 61 67 65 72 eportSize(pPager
24b60 29 3b 0a 20 20 20 20 70 61 67 65 72 46 69 78 4d );. pagerFixM
24b70 61 70 6c 69 6d 69 74 28 70 50 61 67 65 72 29 3b aplimit(pPager);
24b80 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e 20 72 63 . }. return rc
24b90 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 52 65 74 75 72 ;.}../*.** Retur
24ba0 6e 20 61 20 70 6f 69 6e 74 65 72 20 74 6f 20 74 n a pointer to t
24bb0 68 65 20 22 74 65 6d 70 6f 72 61 72 79 20 70 61 he "temporary pa
24bc0 67 65 22 20 62 75 66 66 65 72 20 68 65 6c 64 20 ge" buffer held
24bd0 69 6e 74 65 72 6e 61 6c 6c 79 0a 2a 2a 20 62 79 internally.** by
24be0 20 74 68 65 20 70 61 67 65 72 2e 20 20 54 68 69 the pager. Thi
24bf0 73 20 69 73 20 61 20 62 75 66 66 65 72 20 74 68 s is a buffer th
24c00 61 74 20 69 73 20 62 69 67 20 65 6e 6f 75 67 68 at is big enough
24c10 20 74 6f 20 68 6f 6c 64 20 74 68 65 0a 2a 2a 20 to hold the.**
24c20 65 6e 74 69 72 65 20 63 6f 6e 74 65 6e 74 20 6f entire content o
24c30 66 20 61 20 64 61 74 61 62 61 73 65 20 70 61 67 f a database pag
24c40 65 2e 20 20 54 68 69 73 20 62 75 66 66 65 72 20 e. This buffer
24c50 69 73 20 75 73 65 64 20 69 6e 74 65 72 6e 61 6c is used internal
24c60 6c 79 0a 2a 2a 20 64 75 72 69 6e 67 20 72 6f 6c ly.** during rol
24c70 6c 62 61 63 6b 20 61 6e 64 20 77 69 6c 6c 20 62 lback and will b
24c80 65 20 6f 76 65 72 77 72 69 74 74 65 6e 20 77 68 e overwritten wh
24c90 65 6e 65 76 65 72 20 61 20 72 6f 6c 6c 62 61 63 enever a rollbac
24ca0 6b 0a 2a 2a 20 6f 63 63 75 72 73 2e 20 20 42 75 k.** occurs. Bu
24cb0 74 20 6f 74 68 65 72 20 6d 6f 64 75 6c 65 73 20 t other modules
24cc0 61 72 65 20 66 72 65 65 20 74 6f 20 75 73 65 20 are free to use
24cd0 69 74 20 74 6f 6f 2c 20 61 73 20 6c 6f 6e 67 20 it too, as long
24ce0 61 73 0a 2a 2a 20 6e 6f 20 72 6f 6c 6c 62 61 63 as.** no rollbac
24cf0 6b 73 20 61 72 65 20 68 61 70 70 65 6e 69 6e 67 ks are happening
24d00 2e 0a 2a 2f 0a 76 6f 69 64 20 2a 73 71 6c 69 74 ..*/.void *sqlit
24d10 65 33 50 61 67 65 72 54 65 6d 70 53 70 61 63 65 e3PagerTempSpace
24d20 28 50 61 67 65 72 20 2a 70 50 61 67 65 72 29 7b (Pager *pPager){
24d30 0a 20 20 72 65 74 75 72 6e 20 70 50 61 67 65 72 . return pPager
24d40 2d 3e 70 54 6d 70 53 70 61 63 65 3b 0a 7d 0a 0a ->pTmpSpace;.}..
24d50 2f 2a 0a 2a 2a 20 41 74 74 65 6d 70 74 20 74 6f /*.** Attempt to
24d60 20 73 65 74 20 74 68 65 20 6d 61 78 69 6d 75 6d set the maximum
24d70 20 64 61 74 61 62 61 73 65 20 70 61 67 65 20 63 database page c
24d80 6f 75 6e 74 20 69 66 20 6d 78 50 61 67 65 20 69 ount if mxPage i
24d90 73 20 70 6f 73 69 74 69 76 65 2e 20 0a 2a 2a 20 s positive. .**
24da0 4d 61 6b 65 20 6e 6f 20 63 68 61 6e 67 65 73 20 Make no changes
24db0 69 66 20 6d 78 50 61 67 65 20 69 73 20 7a 65 72 if mxPage is zer
24dc0 6f 20 6f 72 20 6e 65 67 61 74 69 76 65 2e 20 20 o or negative.
24dd0 41 6e 64 20 6e 65 76 65 72 20 72 65 64 75 63 65 And never reduce
24de0 20 74 68 65 0a 2a 2a 20 6d 61 78 69 6d 75 6d 20 the.** maximum
24df0 70 61 67 65 20 63 6f 75 6e 74 20 62 65 6c 6f 77 page count below
24e00 20 74 68 65 20 63 75 72 72 65 6e 74 20 73 69 7a the current siz
24e10 65 20 6f 66 20 74 68 65 20 64 61 74 61 62 61 73 e of the databas
24e20 65 2e 0a 2a 2a 0a 2a 2a 20 52 65 67 61 72 64 6c e..**.** Regardl
24e30 65 73 73 20 6f 66 20 6d 78 50 61 67 65 2c 20 72 ess of mxPage, r
24e40 65 74 75 72 6e 20 74 68 65 20 63 75 72 72 65 6e eturn the curren
24e50 74 20 6d 61 78 69 6d 75 6d 20 70 61 67 65 20 63 t maximum page c
24e60 6f 75 6e 74 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c ount..*/.int sql
24e70 69 74 65 33 50 61 67 65 72 4d 61 78 50 61 67 65 ite3PagerMaxPage
24e80 43 6f 75 6e 74 28 50 61 67 65 72 20 2a 70 50 61 Count(Pager *pPa
24e90 67 65 72 2c 20 69 6e 74 20 6d 78 50 61 67 65 29 ger, int mxPage)
24ea0 7b 0a 20 20 69 66 28 20 6d 78 50 61 67 65 3e 30 {. if( mxPage>0
24eb0 20 29 7b 0a 20 20 20 20 70 50 61 67 65 72 2d 3e ){. pPager->
24ec0 6d 78 50 67 6e 6f 20 3d 20 6d 78 50 61 67 65 3b mxPgno = mxPage;
24ed0 0a 20 20 7d 0a 20 20 61 73 73 65 72 74 28 20 70 . }. assert( p
24ee0 50 61 67 65 72 2d 3e 65 53 74 61 74 65 21 3d 50 Pager->eState!=P
24ef0 41 47 45 52 5f 4f 50 45 4e 20 29 3b 20 20 20 20 AGER_OPEN );
24f00 20 20 2f 2a 20 43 61 6c 6c 65 64 20 6f 6e 6c 79 /* Called only
24f10 20 62 79 20 4f 50 5f 4d 61 78 50 67 63 6e 74 20 by OP_MaxPgcnt
24f20 2a 2f 0a 20 20 61 73 73 65 72 74 28 20 70 50 61 */. assert( pPa
24f30 67 65 72 2d 3e 6d 78 50 67 6e 6f 3e 3d 70 50 61 ger->mxPgno>=pPa
24f40 67 65 72 2d 3e 64 62 53 69 7a 65 20 29 3b 20 20 ger->dbSize );
24f50 2f 2a 20 4f 50 5f 4d 61 78 50 67 63 6e 74 20 65 /* OP_MaxPgcnt e
24f60 6e 66 6f 72 63 65 73 20 74 68 69 73 20 2a 2f 0a nforces this */.
24f70 20 20 72 65 74 75 72 6e 20 70 50 61 67 65 72 2d return pPager-
24f80 3e 6d 78 50 67 6e 6f 3b 0a 7d 0a 0a 2f 2a 0a 2a >mxPgno;.}../*.*
24f90 2a 20 54 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 * The following
24fa0 73 65 74 20 6f 66 20 72 6f 75 74 69 6e 65 73 20 set of routines
24fb0 61 72 65 20 75 73 65 64 20 74 6f 20 64 69 73 61 are used to disa
24fc0 62 6c 65 20 74 68 65 20 73 69 6d 75 6c 61 74 65 ble the simulate
24fd0 64 0a 2a 2a 20 49 2f 4f 20 65 72 72 6f 72 20 6d d.** I/O error m
24fe0 65 63 68 61 6e 69 73 6d 2e 20 20 54 68 65 73 65 echanism. These
24ff0 20 72 6f 75 74 69 6e 65 73 20 61 72 65 20 75 73 routines are us
25000 65 64 20 74 6f 20 61 76 6f 69 64 20 73 69 6d 75 ed to avoid simu
25010 6c 61 74 65 64 0a 2a 2a 20 65 72 72 6f 72 73 20 lated.** errors
25020 69 6e 20 70 6c 61 63 65 73 20 77 68 65 72 65 20 in places where
25030 77 65 20 64 6f 20 6e 6f 74 20 63 61 72 65 20 61 we do not care a
25040 62 6f 75 74 20 65 72 72 6f 72 73 2e 0a 2a 2a 0a bout errors..**.
25050 2a 2a 20 55 6e 6c 65 73 73 20 2d 44 53 51 4c 49 ** Unless -DSQLI
25060 54 45 5f 54 45 53 54 3d 31 20 69 73 20 75 73 65 TE_TEST=1 is use
25070 64 2c 20 74 68 65 73 65 20 72 6f 75 74 69 6e 65 d, these routine
25080 73 20 61 72 65 20 61 6c 6c 20 6e 6f 2d 6f 70 73 s are all no-ops
25090 0a 2a 2a 20 61 6e 64 20 67 65 6e 65 72 61 74 65 .** and generate
250a0 20 6e 6f 20 63 6f 64 65 2e 0a 2a 2f 0a 23 69 66 no code..*/.#if
250b0 64 65 66 20 53 51 4c 49 54 45 5f 54 45 53 54 0a def SQLITE_TEST.
250c0 65 78 74 65 72 6e 20 69 6e 74 20 73 71 6c 69 74 extern int sqlit
250d0 65 33 5f 69 6f 5f 65 72 72 6f 72 5f 70 65 6e 64 e3_io_error_pend
250e0 69 6e 67 3b 0a 65 78 74 65 72 6e 20 69 6e 74 20 ing;.extern int
250f0 73 71 6c 69 74 65 33 5f 69 6f 5f 65 72 72 6f 72 sqlite3_io_error
25100 5f 68 69 74 3b 0a 73 74 61 74 69 63 20 69 6e 74 _hit;.static int
25110 20 73 61 76 65 64 5f 63 6e 74 3b 0a 76 6f 69 64 saved_cnt;.void
25120 20 64 69 73 61 62 6c 65 5f 73 69 6d 75 6c 61 74 disable_simulat
25130 65 64 5f 69 6f 5f 65 72 72 6f 72 73 28 76 6f 69 ed_io_errors(voi
25140 64 29 7b 0a 20 20 73 61 76 65 64 5f 63 6e 74 20 d){. saved_cnt
25150 3d 20 73 71 6c 69 74 65 33 5f 69 6f 5f 65 72 72 = sqlite3_io_err
25160 6f 72 5f 70 65 6e 64 69 6e 67 3b 0a 20 20 73 71 or_pending;. sq
25170 6c 69 74 65 33 5f 69 6f 5f 65 72 72 6f 72 5f 70 lite3_io_error_p
25180 65 6e 64 69 6e 67 20 3d 20 2d 31 3b 0a 7d 0a 76 ending = -1;.}.v
25190 6f 69 64 20 65 6e 61 62 6c 65 5f 73 69 6d 75 6c oid enable_simul
251a0 61 74 65 64 5f 69 6f 5f 65 72 72 6f 72 73 28 76 ated_io_errors(v
251b0 6f 69 64 29 7b 0a 20 20 73 71 6c 69 74 65 33 5f oid){. sqlite3_
251c0 69 6f 5f 65 72 72 6f 72 5f 70 65 6e 64 69 6e 67 io_error_pending
251d0 20 3d 20 73 61 76 65 64 5f 63 6e 74 3b 0a 7d 0a = saved_cnt;.}.
251e0 23 65 6c 73 65 0a 23 20 64 65 66 69 6e 65 20 64 #else.# define d
251f0 69 73 61 62 6c 65 5f 73 69 6d 75 6c 61 74 65 64 isable_simulated
25200 5f 69 6f 5f 65 72 72 6f 72 73 28 29 0a 23 20 64 _io_errors().# d
25210 65 66 69 6e 65 20 65 6e 61 62 6c 65 5f 73 69 6d efine enable_sim
25220 75 6c 61 74 65 64 5f 69 6f 5f 65 72 72 6f 72 73 ulated_io_errors
25230 28 29 0a 23 65 6e 64 69 66 0a 0a 2f 2a 0a 2a 2a ().#endif../*.**
25240 20 52 65 61 64 20 74 68 65 20 66 69 72 73 74 20 Read the first
25250 4e 20 62 79 74 65 73 20 66 72 6f 6d 20 74 68 65 N bytes from the
25260 20 62 65 67 69 6e 6e 69 6e 67 20 6f 66 20 74 68 beginning of th
25270 65 20 66 69 6c 65 20 69 6e 74 6f 20 6d 65 6d 6f e file into memo
25280 72 79 0a 2a 2a 20 74 68 61 74 20 70 44 65 73 74 ry.** that pDest
25290 20 70 6f 69 6e 74 73 20 74 6f 2e 20 0a 2a 2a 0a points to. .**.
252a0 2a 2a 20 49 66 20 74 68 65 20 70 61 67 65 72 20 ** If the pager
252b0 77 61 73 20 6f 70 65 6e 65 64 20 6f 6e 20 61 20 was opened on a
252c0 74 72 61 6e 73 69 65 6e 74 20 66 69 6c 65 20 28 transient file (
252d0 7a 46 69 6c 65 6e 61 6d 65 3d 3d 22 22 29 2c 20 zFilename==""),
252e0 6f 72 0a 2a 2a 20 6f 70 65 6e 65 64 20 6f 6e 20 or.** opened on
252f0 61 20 66 69 6c 65 20 6c 65 73 73 20 74 68 61 6e a file less than
25300 20 4e 20 62 79 74 65 73 20 69 6e 20 73 69 7a 65 N bytes in size
25310 2c 20 74 68 65 20 6f 75 74 70 75 74 20 62 75 66 , the output buf
25320 66 65 72 20 69 73 0a 2a 2a 20 7a 65 72 6f 65 64 fer is.** zeroed
25330 20 61 6e 64 20 53 51 4c 49 54 45 5f 4f 4b 20 72 and SQLITE_OK r
25340 65 74 75 72 6e 65 64 2e 20 54 68 65 20 72 61 74 eturned. The rat
25350 69 6f 6e 61 6c 65 20 66 6f 72 20 74 68 69 73 20 ionale for this
25360 69 73 20 74 68 61 74 20 74 68 69 73 20 0a 2a 2a is that this .**
25370 20 66 75 6e 63 74 69 6f 6e 20 69 73 20 75 73 65 function is use
25380 64 20 74 6f 20 72 65 61 64 20 64 61 74 61 62 61 d to read databa
25390 73 65 20 68 65 61 64 65 72 73 2c 20 61 6e 64 20 se headers, and
253a0 61 20 6e 65 77 20 74 72 61 6e 73 69 65 6e 74 20 a new transient
253b0 6f 72 0a 2a 2a 20 7a 65 72 6f 20 73 69 7a 65 64 or.** zero sized
253c0 20 64 61 74 61 62 61 73 65 20 68 61 73 20 61 20 database has a
253d0 68 65 61 64 65 72 20 74 68 61 6e 20 63 6f 6e 73 header than cons
253e0 69 73 74 73 20 65 6e 74 69 72 65 6c 79 20 6f 66 ists entirely of
253f0 20 7a 65 72 6f 65 73 2e 0a 2a 2a 0a 2a 2a 20 49 zeroes..**.** I
25400 66 20 61 6e 79 20 49 4f 20 65 72 72 6f 72 20 61 f any IO error a
25410 70 61 72 74 20 66 72 6f 6d 20 53 51 4c 49 54 45 part from SQLITE
25420 5f 49 4f 45 52 52 5f 53 48 4f 52 54 5f 52 45 41 _IOERR_SHORT_REA
25430 44 20 69 73 20 65 6e 63 6f 75 6e 74 65 72 65 64 D is encountered
25440 2c 0a 2a 2a 20 74 68 65 20 65 72 72 6f 72 20 63 ,.** the error c
25450 6f 64 65 20 69 73 20 72 65 74 75 72 6e 65 64 20 ode is returned
25460 74 6f 20 74 68 65 20 63 61 6c 6c 65 72 20 61 6e to the caller an
25470 64 20 74 68 65 20 63 6f 6e 74 65 6e 74 73 20 6f d the contents o
25480 66 20 74 68 65 0a 2a 2a 20 6f 75 74 70 75 74 20 f the.** output
25490 62 75 66 66 65 72 20 75 6e 64 65 66 69 6e 65 64 buffer undefined
254a0 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 ..*/.int sqlite3
254b0 50 61 67 65 72 52 65 61 64 46 69 6c 65 68 65 61 PagerReadFilehea
254c0 64 65 72 28 50 61 67 65 72 20 2a 70 50 61 67 65 der(Pager *pPage
254d0 72 2c 20 69 6e 74 20 4e 2c 20 75 6e 73 69 67 6e r, int N, unsign
254e0 65 64 20 63 68 61 72 20 2a 70 44 65 73 74 29 7b ed char *pDest){
254f0 0a 20 20 69 6e 74 20 72 63 20 3d 20 53 51 4c 49 . int rc = SQLI
25500 54 45 5f 4f 4b 3b 0a 20 20 6d 65 6d 73 65 74 28 TE_OK;. memset(
25510 70 44 65 73 74 2c 20 30 2c 20 4e 29 3b 0a 20 20 pDest, 0, N);.
25520 61 73 73 65 72 74 28 20 69 73 4f 70 65 6e 28 70 assert( isOpen(p
25530 50 61 67 65 72 2d 3e 66 64 29 20 7c 7c 20 70 50 Pager->fd) || pP
25540 61 67 65 72 2d 3e 74 65 6d 70 46 69 6c 65 20 29 ager->tempFile )
25550 3b 0a 0a 20 20 2f 2a 20 54 68 69 73 20 72 6f 75 ;.. /* This rou
25560 74 69 6e 65 20 69 73 20 6f 6e 6c 79 20 63 61 6c tine is only cal
25570 6c 65 64 20 62 79 20 62 74 72 65 65 20 69 6d 6d led by btree imm
25580 65 64 69 61 74 65 6c 79 20 61 66 74 65 72 20 63 ediately after c
25590 72 65 61 74 69 6e 67 0a 20 20 2a 2a 20 74 68 65 reating. ** the
255a0 20 50 61 67 65 72 20 6f 62 6a 65 63 74 2e 20 20 Pager object.
255b0 54 68 65 72 65 20 68 61 73 20 6e 6f 74 20 62 65 There has not be
255c0 65 6e 20 61 6e 20 6f 70 70 6f 72 74 75 6e 69 74 en an opportunit
255d0 79 20 74 6f 20 74 72 61 6e 73 69 74 69 6f 6e 0a y to transition.
255e0 20 20 2a 2a 20 74 6f 20 57 41 4c 20 6d 6f 64 65 ** to WAL mode
255f0 20 79 65 74 2e 0a 20 20 2a 2f 0a 20 20 61 73 73 yet.. */. ass
25600 65 72 74 28 20 21 70 61 67 65 72 55 73 65 57 61 ert( !pagerUseWa
25610 6c 28 70 50 61 67 65 72 29 20 29 3b 0a 0a 20 20 l(pPager) );..
25620 69 66 28 20 69 73 4f 70 65 6e 28 70 50 61 67 65 if( isOpen(pPage
25630 72 2d 3e 66 64 29 20 29 7b 0a 20 20 20 20 49 4f r->fd) ){. IO
25640 54 52 41 43 45 28 28 22 44 42 48 44 52 20 25 70 TRACE(("DBHDR %p
25650 20 30 20 25 64 5c 6e 22 2c 20 70 50 61 67 65 72 0 %d\n", pPager
25660 2c 20 4e 29 29 0a 20 20 20 20 72 63 20 3d 20 73 , N)). rc = s
25670 71 6c 69 74 65 33 4f 73 52 65 61 64 28 70 50 61 qlite3OsRead(pPa
25680 67 65 72 2d 3e 66 64 2c 20 70 44 65 73 74 2c 20 ger->fd, pDest,
25690 4e 2c 20 30 29 3b 0a 20 20 20 20 69 66 28 20 72 N, 0);. if( r
256a0 63 3d 3d 53 51 4c 49 54 45 5f 49 4f 45 52 52 5f c==SQLITE_IOERR_
256b0 53 48 4f 52 54 5f 52 45 41 44 20 29 7b 0a 20 20 SHORT_READ ){.
256c0 20 20 20 20 72 63 20 3d 20 53 51 4c 49 54 45 5f rc = SQLITE_
256d0 4f 4b 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a 20 20 OK;. }. }.
256e0 72 65 74 75 72 6e 20 72 63 3b 0a 7d 0a 0a 2f 2a return rc;.}../*
256f0 0a 2a 2a 20 54 68 69 73 20 66 75 6e 63 74 69 6f .** This functio
25700 6e 20 6d 61 79 20 6f 6e 6c 79 20 62 65 20 63 61 n may only be ca
25710 6c 6c 65 64 20 77 68 65 6e 20 61 20 72 65 61 64 lled when a read
25720 2d 74 72 61 6e 73 61 63 74 69 6f 6e 20 69 73 20 -transaction is
25730 6f 70 65 6e 20 6f 6e 0a 2a 2a 20 74 68 65 20 70 open on.** the p
25740 61 67 65 72 2e 20 49 74 20 72 65 74 75 72 6e 73 ager. It returns
25750 20 74 68 65 20 74 6f 74 61 6c 20 6e 75 6d 62 65 the total numbe
25760 72 20 6f 66 20 70 61 67 65 73 20 69 6e 20 74 68 r of pages in th
25770 65 20 64 61 74 61 62 61 73 65 2e 0a 2a 2a 0a 2a e database..**.*
25780 2a 20 48 6f 77 65 76 65 72 2c 20 69 66 20 74 68 * However, if th
25790 65 20 66 69 6c 65 20 69 73 20 62 65 74 77 65 65 e file is betwee
257a0 6e 20 31 20 61 6e 64 20 3c 70 61 67 65 2d 73 69 n 1 and <page-si
257b0 7a 65 3e 20 62 79 74 65 73 20 69 6e 20 73 69 7a ze> bytes in siz
257c0 65 2c 20 74 68 65 6e 20 0a 2a 2a 20 74 68 69 73 e, then .** this
257d0 20 69 73 20 63 6f 6e 73 69 64 65 72 65 64 20 61 is considered a
257e0 20 31 20 70 61 67 65 20 66 69 6c 65 2e 0a 2a 2f 1 page file..*/
257f0 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 50 61 67 .void sqlite3Pag
25800 65 72 50 61 67 65 63 6f 75 6e 74 28 50 61 67 65 erPagecount(Page
25810 72 20 2a 70 50 61 67 65 72 2c 20 69 6e 74 20 2a r *pPager, int *
25820 70 6e 50 61 67 65 29 7b 0a 20 20 61 73 73 65 72 pnPage){. asser
25830 74 28 20 70 50 61 67 65 72 2d 3e 65 53 74 61 74 t( pPager->eStat
25840 65 3e 3d 50 41 47 45 52 5f 52 45 41 44 45 52 20 e>=PAGER_READER
25850 29 3b 0a 20 20 61 73 73 65 72 74 28 20 70 50 61 );. assert( pPa
25860 67 65 72 2d 3e 65 53 74 61 74 65 21 3d 50 41 47 ger->eState!=PAG
25870 45 52 5f 57 52 49 54 45 52 5f 46 49 4e 49 53 48 ER_WRITER_FINISH
25880 45 44 20 29 3b 0a 20 20 2a 70 6e 50 61 67 65 20 ED );. *pnPage
25890 3d 20 28 69 6e 74 29 70 50 61 67 65 72 2d 3e 64 = (int)pPager->d
258a0 62 53 69 7a 65 3b 0a 7d 0a 0a 0a 2f 2a 0a 2a 2a bSize;.}.../*.**
258b0 20 54 72 79 20 74 6f 20 6f 62 74 61 69 6e 20 61 Try to obtain a
258c0 20 6c 6f 63 6b 20 6f 66 20 74 79 70 65 20 6c 6f lock of type lo
258d0 63 6b 74 79 70 65 20 6f 6e 20 74 68 65 20 64 61 cktype on the da
258e0 74 61 62 61 73 65 20 66 69 6c 65 2e 20 49 66 0a tabase file. If.
258f0 2a 2a 20 61 20 73 69 6d 69 6c 61 72 20 6f 72 20 ** a similar or
25900 67 72 65 61 74 65 72 20 6c 6f 63 6b 20 69 73 20 greater lock is
25910 61 6c 72 65 61 64 79 20 68 65 6c 64 2c 20 74 68 already held, th
25920 69 73 20 66 75 6e 63 74 69 6f 6e 20 69 73 20 61 is function is a
25930 20 6e 6f 2d 6f 70 0a 2a 2a 20 28 72 65 74 75 72 no-op.** (retur
25940 6e 69 6e 67 20 53 51 4c 49 54 45 5f 4f 4b 20 69 ning SQLITE_OK i
25950 6d 6d 65 64 69 61 74 65 6c 79 29 2e 0a 2a 2a 0a mmediately)..**.
25960 2a 2a 20 4f 74 68 65 72 77 69 73 65 2c 20 61 74 ** Otherwise, at
25970 74 65 6d 70 74 20 74 6f 20 6f 62 74 61 69 6e 20 tempt to obtain
25980 74 68 65 20 6c 6f 63 6b 20 75 73 69 6e 67 20 73 the lock using s
25990 71 6c 69 74 65 33 4f 73 4c 6f 63 6b 28 29 2e 20 qlite3OsLock().
259a0 49 6e 76 6f 6b 65 20 0a 2a 2a 20 74 68 65 20 62 Invoke .** the b
259b0 75 73 79 20 63 61 6c 6c 62 61 63 6b 20 69 66 20 usy callback if
259c0 74 68 65 20 6c 6f 63 6b 20 69 73 20 63 75 72 72 the lock is curr
259d0 65 6e 74 6c 79 20 6e 6f 74 20 61 76 61 69 6c 61 ently not availa
259e0 62 6c 65 2e 20 52 65 70 65 61 74 20 0a 2a 2a 20 ble. Repeat .**
259f0 75 6e 74 69 6c 20 74 68 65 20 62 75 73 79 20 63 until the busy c
25a00 61 6c 6c 62 61 63 6b 20 72 65 74 75 72 6e 73 20 allback returns
25a10 66 61 6c 73 65 20 6f 72 20 75 6e 74 69 6c 20 74 false or until t
25a20 68 65 20 61 74 74 65 6d 70 74 20 74 6f 20 0a 2a he attempt to .*
25a30 2a 20 6f 62 74 61 69 6e 20 74 68 65 20 6c 6f 63 * obtain the loc
25a40 6b 20 73 75 63 63 65 65 64 73 2e 0a 2a 2a 0a 2a k succeeds..**.*
25a50 2a 20 52 65 74 75 72 6e 20 53 51 4c 49 54 45 5f * Return SQLITE_
25a60 4f 4b 20 6f 6e 20 73 75 63 63 65 73 73 20 61 6e OK on success an
25a70 64 20 61 6e 20 65 72 72 6f 72 20 63 6f 64 65 20 d an error code
25a80 69 66 20 77 65 20 63 61 6e 6e 6f 74 20 6f 62 74 if we cannot obt
25a90 61 69 6e 0a 2a 2a 20 74 68 65 20 6c 6f 63 6b 2e ain.** the lock.
25aa0 20 49 66 20 74 68 65 20 6c 6f 63 6b 20 69 73 20 If the lock is
25ab0 6f 62 74 61 69 6e 65 64 20 73 75 63 63 65 73 73 obtained success
25ac0 66 75 6c 6c 79 2c 20 73 65 74 20 74 68 65 20 50 fully, set the P
25ad0 61 67 65 72 2e 73 74 61 74 65 20 0a 2a 2a 20 76 ager.state .** v
25ae0 61 72 69 61 62 6c 65 20 74 6f 20 6c 6f 63 6b 74 ariable to lockt
25af0 79 70 65 20 62 65 66 6f 72 65 20 72 65 74 75 72 ype before retur
25b00 6e 69 6e 67 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 ning..*/.static
25b10 69 6e 74 20 70 61 67 65 72 5f 77 61 69 74 5f 6f int pager_wait_o
25b20 6e 5f 6c 6f 63 6b 28 50 61 67 65 72 20 2a 70 50 n_lock(Pager *pP
25b30 61 67 65 72 2c 20 69 6e 74 20 6c 6f 63 6b 74 79 ager, int lockty
25b40 70 65 29 7b 0a 20 20 69 6e 74 20 72 63 3b 20 20 pe){. int rc;
25b50 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
25b60 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 52 /* R
25b70 65 74 75 72 6e 20 63 6f 64 65 20 2a 2f 0a 0a 20 eturn code */..
25b80 20 2f 2a 20 43 68 65 63 6b 20 74 68 61 74 20 74 /* Check that t
25b90 68 69 73 20 69 73 20 65 69 74 68 65 72 20 61 20 his is either a
25ba0 6e 6f 2d 6f 70 20 28 62 65 63 61 75 73 65 20 74 no-op (because t
25bb0 68 65 20 72 65 71 75 65 73 74 65 64 20 6c 6f 63 he requested loc
25bc0 6b 20 69 73 20 0a 20 20 2a 2a 20 61 6c 72 65 61 k is . ** alrea
25bd0 64 79 20 68 65 6c 64 29 2c 20 6f 72 20 6f 6e 65 dy held), or one
25be0 20 6f 66 20 74 68 65 20 74 72 61 6e 73 69 74 69 of the transiti
25bf0 6f 6e 73 20 74 68 61 74 20 74 68 65 20 62 75 73 ons that the bus
25c00 79 2d 68 61 6e 64 6c 65 72 0a 20 20 2a 2a 20 6d y-handler. ** m
25c10 61 79 20 62 65 20 69 6e 76 6f 6b 65 64 20 64 75 ay be invoked du
25c20 72 69 6e 67 2c 20 61 63 63 6f 72 64 69 6e 67 20 ring, according
25c30 74 6f 20 74 68 65 20 63 6f 6d 6d 65 6e 74 20 61 to the comment a
25c40 62 6f 76 65 0a 20 20 2a 2a 20 73 71 6c 69 74 65 bove. ** sqlite
25c50 33 50 61 67 65 72 53 65 74 42 75 73 79 68 61 6e 3PagerSetBusyhan
25c60 64 6c 65 72 28 29 2e 0a 20 20 2a 2f 0a 20 20 61 dler().. */. a
25c70 73 73 65 72 74 28 20 28 70 50 61 67 65 72 2d 3e ssert( (pPager->
25c80 65 4c 6f 63 6b 3e 3d 6c 6f 63 6b 74 79 70 65 29 eLock>=locktype)
25c90 0a 20 20 20 20 20 20 20 7c 7c 20 28 70 50 61 67 . || (pPag
25ca0 65 72 2d 3e 65 4c 6f 63 6b 3d 3d 4e 4f 5f 4c 4f er->eLock==NO_LO
25cb0 43 4b 20 26 26 20 6c 6f 63 6b 74 79 70 65 3d 3d CK && locktype==
25cc0 53 48 41 52 45 44 5f 4c 4f 43 4b 29 0a 20 20 20 SHARED_LOCK).
25cd0 20 20 20 20 7c 7c 20 28 70 50 61 67 65 72 2d 3e || (pPager->
25ce0 65 4c 6f 63 6b 3d 3d 52 45 53 45 52 56 45 44 5f eLock==RESERVED_
25cf0 4c 4f 43 4b 20 26 26 20 6c 6f 63 6b 74 79 70 65 LOCK && locktype
25d00 3d 3d 45 58 43 4c 55 53 49 56 45 5f 4c 4f 43 4b ==EXCLUSIVE_LOCK
25d10 29 0a 20 20 29 3b 0a 0a 20 20 64 6f 20 7b 0a 20 ). );.. do {.
25d20 20 20 20 72 63 20 3d 20 70 61 67 65 72 4c 6f 63 rc = pagerLoc
25d30 6b 44 62 28 70 50 61 67 65 72 2c 20 6c 6f 63 6b kDb(pPager, lock
25d40 74 79 70 65 29 3b 0a 20 20 7d 77 68 69 6c 65 28 type);. }while(
25d50 20 72 63 3d 3d 53 51 4c 49 54 45 5f 42 55 53 59 rc==SQLITE_BUSY
25d60 20 26 26 20 70 50 61 67 65 72 2d 3e 78 42 75 73 && pPager->xBus
25d70 79 48 61 6e 64 6c 65 72 28 70 50 61 67 65 72 2d yHandler(pPager-
25d80 3e 70 42 75 73 79 48 61 6e 64 6c 65 72 41 72 67 >pBusyHandlerArg
25d90 29 20 29 3b 0a 20 20 72 65 74 75 72 6e 20 72 63 ) );. return rc
25da0 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 46 75 6e 63 74 ;.}../*.** Funct
25db0 69 6f 6e 20 61 73 73 65 72 74 54 72 75 6e 63 61 ion assertTrunca
25dc0 74 65 43 6f 6e 73 74 72 61 69 6e 74 28 70 50 61 teConstraint(pPa
25dd0 67 65 72 29 20 63 68 65 63 6b 73 20 74 68 61 74 ger) checks that
25de0 20 6f 6e 65 20 6f 66 20 74 68 65 20 0a 2a 2a 20 one of the .**
25df0 66 6f 6c 6c 6f 77 69 6e 67 20 69 73 20 74 72 75 following is tru
25e00 65 20 66 6f 72 20 61 6c 6c 20 64 69 72 74 79 20 e for all dirty
25e10 70 61 67 65 73 20 63 75 72 72 65 6e 74 6c 79 20 pages currently
25e20 69 6e 20 74 68 65 20 70 61 67 65 2d 63 61 63 68 in the page-cach
25e30 65 3a 0a 2a 2a 0a 2a 2a 20 20 20 61 29 20 54 68 e:.**.** a) Th
25e40 65 20 70 61 67 65 20 6e 75 6d 62 65 72 20 69 73 e page number is
25e50 20 6c 65 73 73 20 74 68 61 6e 20 6f 72 20 65 71 less than or eq
25e60 75 61 6c 20 74 6f 20 74 68 65 20 73 69 7a 65 20 ual to the size
25e70 6f 66 20 74 68 65 20 0a 2a 2a 20 20 20 20 20 20 of the .**
25e80 63 75 72 72 65 6e 74 20 64 61 74 61 62 61 73 65 current database
25e90 20 69 6d 61 67 65 2c 20 69 6e 20 70 61 67 65 73 image, in pages
25ea0 2c 20 4f 52 0a 2a 2a 0a 2a 2a 20 20 20 62 29 20 , OR.**.** b)
25eb0 69 66 20 74 68 65 20 70 61 67 65 20 63 6f 6e 74 if the page cont
25ec0 65 6e 74 20 77 65 72 65 20 77 72 69 74 74 65 6e ent were written
25ed0 20 61 74 20 74 68 69 73 20 74 69 6d 65 2c 20 69 at this time, i
25ee0 74 20 77 6f 75 6c 64 20 6e 6f 74 0a 2a 2a 20 20 t would not.**
25ef0 20 20 20 20 62 65 20 6e 65 63 65 73 73 61 72 79 be necessary
25f00 20 74 6f 20 77 72 69 74 65 20 74 68 65 20 63 75 to write the cu
25f10 72 72 65 6e 74 20 63 6f 6e 74 65 6e 74 20 6f 75 rrent content ou
25f20 74 20 74 6f 20 74 68 65 20 73 75 62 2d 6a 6f 75 t to the sub-jou
25f30 72 6e 61 6c 0a 2a 2a 20 20 20 20 20 20 28 61 73 rnal.** (as
25f40 20 64 65 74 65 72 6d 69 6e 65 64 20 62 79 20 66 determined by f
25f50 75 6e 63 74 69 6f 6e 20 73 75 62 6a 52 65 71 75 unction subjRequ
25f60 69 72 65 73 50 61 67 65 28 29 29 2e 0a 2a 2a 0a iresPage())..**.
25f70 2a 2a 20 49 66 20 74 68 65 20 63 6f 6e 64 69 74 ** If the condit
25f80 69 6f 6e 20 61 73 73 65 72 74 65 64 20 62 79 20 ion asserted by
25f90 74 68 69 73 20 66 75 6e 63 74 69 6f 6e 20 77 65 this function we
25fa0 72 65 20 6e 6f 74 20 74 72 75 65 2c 20 61 6e 64 re not true, and
25fb0 20 74 68 65 0a 2a 2a 20 64 69 72 74 79 20 70 61 the.** dirty pa
25fc0 67 65 20 77 65 72 65 20 74 6f 20 62 65 20 64 69 ge were to be di
25fd0 73 63 61 72 64 65 64 20 66 72 6f 6d 20 74 68 65 scarded from the
25fe0 20 63 61 63 68 65 20 76 69 61 20 74 68 65 20 70 cache via the p
25ff0 61 67 65 72 53 74 72 65 73 73 28 29 0a 2a 2a 20 agerStress().**
26000 72 6f 75 74 69 6e 65 2c 20 70 61 67 65 72 53 74 routine, pagerSt
26010 72 65 73 73 28 29 20 77 6f 75 6c 64 20 6e 6f 74 ress() would not
26020 20 77 72 69 74 65 20 74 68 65 20 63 75 72 72 65 write the curre
26030 6e 74 20 70 61 67 65 20 63 6f 6e 74 65 6e 74 20 nt page content
26040 74 6f 0a 2a 2a 20 74 68 65 20 64 61 74 61 62 61 to.** the databa
26050 73 65 20 66 69 6c 65 2e 20 49 66 20 61 20 73 61 se file. If a sa
26060 76 65 70 6f 69 6e 74 20 74 72 61 6e 73 61 63 74 vepoint transact
26070 69 6f 6e 20 77 65 72 65 20 72 6f 6c 6c 65 64 20 ion were rolled
26080 62 61 63 6b 20 61 66 74 65 72 0a 2a 2a 20 74 68 back after.** th
26090 69 73 20 68 61 70 70 65 6e 65 64 2c 20 74 68 65 is happened, the
260a0 20 63 6f 72 72 65 63 74 20 62 65 68 61 76 69 6f correct behavio
260b0 72 20 77 6f 75 6c 64 20 62 65 20 74 6f 20 72 65 r would be to re
260c0 73 74 6f 72 65 20 74 68 65 20 63 75 72 72 65 6e store the curren
260d0 74 0a 2a 2a 20 63 6f 6e 74 65 6e 74 20 6f 66 20 t.** content of
260e0 74 68 65 20 70 61 67 65 2e 20 48 6f 77 65 76 65 the page. Howeve
260f0 72 2c 20 73 69 6e 63 65 20 74 68 69 73 20 63 6f r, since this co
26100 6e 74 65 6e 74 20 69 73 20 6e 6f 74 20 70 72 65 ntent is not pre
26110 73 65 6e 74 20 69 6e 20 65 69 74 68 65 72 0a 2a sent in either.*
26120 2a 20 74 68 65 20 64 61 74 61 62 61 73 65 20 66 * the database f
26130 69 6c 65 20 6f 72 20 74 68 65 20 70 6f 72 74 69 ile or the porti
26140 6f 6e 20 6f 66 20 74 68 65 20 72 6f 6c 6c 62 61 on of the rollba
26150 63 6b 20 6a 6f 75 72 6e 61 6c 20 61 6e 64 20 0a ck journal and .
26160 2a 2a 20 73 75 62 2d 6a 6f 75 72 6e 61 6c 20 72 ** sub-journal r
26170 6f 6c 6c 65 64 20 62 61 63 6b 20 74 68 65 20 63 olled back the c
26180 6f 6e 74 65 6e 74 20 63 6f 75 6c 64 20 6e 6f 74 ontent could not
26190 20 62 65 20 72 65 73 74 6f 72 65 64 20 61 6e 64 be restored and
261a0 20 74 68 65 0a 2a 2a 20 64 61 74 61 62 61 73 65 the.** database
261b0 20 69 6d 61 67 65 20 77 6f 75 6c 64 20 62 65 63 image would bec
261c0 6f 6d 65 20 63 6f 72 72 75 70 74 2e 20 49 74 20 ome corrupt. It
261d0 69 73 20 74 68 65 72 65 66 6f 72 65 20 66 6f 72 is therefore for
261e0 74 75 6e 61 74 65 20 74 68 61 74 20 0a 2a 2a 20 tunate that .**
261f0 74 68 69 73 20 63 69 72 63 75 6d 73 74 61 6e 63 this circumstanc
26200 65 20 63 61 6e 6e 6f 74 20 61 72 69 73 65 2e 0a e cannot arise..
26210 2a 2f 0a 23 69 66 20 64 65 66 69 6e 65 64 28 53 */.#if defined(S
26220 51 4c 49 54 45 5f 44 45 42 55 47 29 0a 73 74 61 QLITE_DEBUG).sta
26230 74 69 63 20 76 6f 69 64 20 61 73 73 65 72 74 54 tic void assertT
26240 72 75 6e 63 61 74 65 43 6f 6e 73 74 72 61 69 6e runcateConstrain
26250 74 43 62 28 50 67 48 64 72 20 2a 70 50 67 29 7b tCb(PgHdr *pPg){
26260 0a 20 20 61 73 73 65 72 74 28 20 70 50 67 2d 3e . assert( pPg->
26270 66 6c 61 67 73 26 50 47 48 44 52 5f 44 49 52 54 flags&PGHDR_DIRT
26280 59 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 21 Y );. assert( !
26290 73 75 62 6a 52 65 71 75 69 72 65 73 50 61 67 65 subjRequiresPage
262a0 28 70 50 67 29 20 7c 7c 20 70 50 67 2d 3e 70 67 (pPg) || pPg->pg
262b0 6e 6f 3c 3d 70 50 67 2d 3e 70 50 61 67 65 72 2d no<=pPg->pPager-
262c0 3e 64 62 53 69 7a 65 20 29 3b 0a 7d 0a 73 74 61 >dbSize );.}.sta
262d0 74 69 63 20 76 6f 69 64 20 61 73 73 65 72 74 54 tic void assertT
262e0 72 75 6e 63 61 74 65 43 6f 6e 73 74 72 61 69 6e runcateConstrain
262f0 74 28 50 61 67 65 72 20 2a 70 50 61 67 65 72 29 t(Pager *pPager)
26300 7b 0a 20 20 73 71 6c 69 74 65 33 50 63 61 63 68 {. sqlite3Pcach
26310 65 49 74 65 72 61 74 65 44 69 72 74 79 28 70 50 eIterateDirty(pP
26320 61 67 65 72 2d 3e 70 50 43 61 63 68 65 2c 20 61 ager->pPCache, a
26330 73 73 65 72 74 54 72 75 6e 63 61 74 65 43 6f 6e ssertTruncateCon
26340 73 74 72 61 69 6e 74 43 62 29 3b 0a 7d 0a 23 65 straintCb);.}.#e
26350 6c 73 65 0a 23 20 64 65 66 69 6e 65 20 61 73 73 lse.# define ass
26360 65 72 74 54 72 75 6e 63 61 74 65 43 6f 6e 73 74 ertTruncateConst
26370 72 61 69 6e 74 28 70 50 61 67 65 72 29 0a 23 65 raint(pPager).#e
26380 6e 64 69 66 0a 0a 2f 2a 0a 2a 2a 20 54 72 75 6e ndif../*.** Trun
26390 63 61 74 65 20 74 68 65 20 69 6e 2d 6d 65 6d 6f cate the in-memo
263a0 72 79 20 64 61 74 61 62 61 73 65 20 66 69 6c 65 ry database file
263b0 20 69 6d 61 67 65 20 74 6f 20 6e 50 61 67 65 20 image to nPage
263c0 70 61 67 65 73 2e 20 54 68 69 73 20 0a 2a 2a 20 pages. This .**
263d0 66 75 6e 63 74 69 6f 6e 20 64 6f 65 73 20 6e 6f function does no
263e0 74 20 61 63 74 75 61 6c 6c 79 20 6d 6f 64 69 66 t actually modif
263f0 79 20 74 68 65 20 64 61 74 61 62 61 73 65 20 66 y the database f
26400 69 6c 65 20 6f 6e 20 64 69 73 6b 2e 20 49 74 20 ile on disk. It
26410 0a 2a 2a 20 6a 75 73 74 20 73 65 74 73 20 74 68 .** just sets th
26420 65 20 69 6e 74 65 72 6e 61 6c 20 73 74 61 74 65 e internal state
26430 20 6f 66 20 74 68 65 20 70 61 67 65 72 20 6f 62 of the pager ob
26440 6a 65 63 74 20 73 6f 20 74 68 61 74 20 74 68 65 ject so that the
26450 20 0a 2a 2a 20 74 72 75 6e 63 61 74 69 6f 6e 20 .** truncation
26460 77 69 6c 6c 20 62 65 20 64 6f 6e 65 20 77 68 65 will be done whe
26470 6e 20 74 68 65 20 63 75 72 72 65 6e 74 20 74 72 n the current tr
26480 61 6e 73 61 63 74 69 6f 6e 20 69 73 20 63 6f 6d ansaction is com
26490 6d 69 74 74 65 64 2e 0a 2a 2a 0a 2a 2a 20 54 68 mitted..**.** Th
264a0 69 73 20 66 75 6e 63 74 69 6f 6e 20 69 73 20 6f is function is o
264b0 6e 6c 79 20 63 61 6c 6c 65 64 20 72 69 67 68 74 nly called right
264c0 20 62 65 66 6f 72 65 20 63 6f 6d 6d 69 74 74 69 before committi
264d0 6e 67 20 61 20 74 72 61 6e 73 61 63 74 69 6f 6e ng a transaction
264e0 2e 0a 2a 2a 20 4f 6e 63 65 20 74 68 69 73 20 66 ..** Once this f
264f0 75 6e 63 74 69 6f 6e 20 68 61 73 20 62 65 65 6e unction has been
26500 20 63 61 6c 6c 65 64 2c 20 74 68 65 20 74 72 61 called, the tra
26510 6e 73 61 63 74 69 6f 6e 20 6d 75 73 74 20 65 69 nsaction must ei
26520 74 68 65 72 20 62 65 0a 2a 2a 20 72 6f 6c 6c 65 ther be.** rolle
26530 64 20 62 61 63 6b 20 6f 72 20 63 6f 6d 6d 69 74 d back or commit
26540 74 65 64 2e 20 49 74 20 69 73 20 6e 6f 74 20 73 ted. It is not s
26550 61 66 65 20 74 6f 20 63 61 6c 6c 20 74 68 69 73 afe to call this
26560 20 66 75 6e 63 74 69 6f 6e 20 61 6e 64 0a 2a 2a function and.**
26570 20 74 68 65 6e 20 63 6f 6e 74 69 6e 75 65 20 77 then continue w
26580 72 69 74 69 6e 67 20 74 6f 20 74 68 65 20 64 61 riting to the da
26590 74 61 62 61 73 65 2e 0a 2a 2f 0a 76 6f 69 64 20 tabase..*/.void
265a0 73 71 6c 69 74 65 33 50 61 67 65 72 54 72 75 6e sqlite3PagerTrun
265b0 63 61 74 65 49 6d 61 67 65 28 50 61 67 65 72 20 cateImage(Pager
265c0 2a 70 50 61 67 65 72 2c 20 50 67 6e 6f 20 6e 50 *pPager, Pgno nP
265d0 61 67 65 29 7b 0a 20 20 61 73 73 65 72 74 28 20 age){. assert(
265e0 70 50 61 67 65 72 2d 3e 64 62 53 69 7a 65 3e 3d pPager->dbSize>=
265f0 6e 50 61 67 65 20 29 3b 0a 20 20 61 73 73 65 72 nPage );. asser
26600 74 28 20 70 50 61 67 65 72 2d 3e 65 53 74 61 74 t( pPager->eStat
26610 65 3e 3d 50 41 47 45 52 5f 57 52 49 54 45 52 5f e>=PAGER_WRITER_
26620 43 41 43 48 45 4d 4f 44 20 29 3b 0a 20 20 70 50 CACHEMOD );. pP
26630 61 67 65 72 2d 3e 64 62 53 69 7a 65 20 3d 20 6e ager->dbSize = n
26640 50 61 67 65 3b 0a 0a 20 20 2f 2a 20 41 74 20 6f Page;.. /* At o
26650 6e 65 20 70 6f 69 6e 74 20 74 68 65 20 63 6f 64 ne point the cod
26660 65 20 68 65 72 65 20 63 61 6c 6c 65 64 20 61 73 e here called as
26670 73 65 72 74 54 72 75 6e 63 61 74 65 43 6f 6e 73 sertTruncateCons
26680 74 72 61 69 6e 74 28 29 20 74 6f 0a 20 20 2a 2a traint() to. **
26690 20 65 6e 73 75 72 65 20 74 68 61 74 20 61 6c 6c ensure that all
266a0 20 70 61 67 65 73 20 62 65 69 6e 67 20 74 72 75 pages being tru
266b0 6e 63 61 74 65 64 20 61 77 61 79 20 62 79 20 74 ncated away by t
266c0 68 69 73 20 6f 70 65 72 61 74 69 6f 6e 20 61 72 his operation ar
266d0 65 2c 0a 20 20 2a 2a 20 69 66 20 6f 6e 65 20 6f e,. ** if one o
266e0 72 20 6d 6f 72 65 20 73 61 76 65 70 6f 69 6e 74 r more savepoint
266f0 73 20 61 72 65 20 6f 70 65 6e 2c 20 70 72 65 73 s are open, pres
26700 65 6e 74 20 69 6e 20 74 68 65 20 73 61 76 65 70 ent in the savep
26710 6f 69 6e 74 20 0a 20 20 2a 2a 20 6a 6f 75 72 6e oint . ** journ
26720 61 6c 20 73 6f 20 74 68 61 74 20 74 68 65 79 20 al so that they
26730 63 61 6e 20 62 65 20 72 65 73 74 6f 72 65 64 20 can be restored
26740 69 66 20 74 68 65 20 73 61 76 65 70 6f 69 6e 74 if the savepoint
26750 20 69 73 20 72 6f 6c 6c 65 64 0a 20 20 2a 2a 20 is rolled. **
26760 62 61 63 6b 2e 20 54 68 69 73 20 69 73 20 6e 6f back. This is no
26770 20 6c 6f 6e 67 65 72 20 6e 65 63 65 73 73 61 72 longer necessar
26780 79 20 61 73 20 74 68 69 73 20 66 75 6e 63 74 69 y as this functi
26790 6f 6e 20 69 73 20 6e 6f 77 20 6f 6e 6c 79 0a 20 on is now only.
267a0 20 2a 2a 20 63 61 6c 6c 65 64 20 72 69 67 68 74 ** called right
267b0 20 62 65 66 6f 72 65 20 63 6f 6d 6d 69 74 74 69 before committi
267c0 6e 67 20 61 20 74 72 61 6e 73 61 63 74 69 6f 6e ng a transaction
267d0 2e 20 53 6f 20 61 6c 74 68 6f 75 67 68 20 74 68 . So although th
267e0 65 20 0a 20 20 2a 2a 20 50 61 67 65 72 20 6f 62 e . ** Pager ob
267f0 6a 65 63 74 20 6d 61 79 20 73 74 69 6c 6c 20 68 ject may still h
26800 61 76 65 20 6f 70 65 6e 20 73 61 76 65 70 6f 69 ave open savepoi
26810 6e 74 73 20 28 50 61 67 65 72 2e 6e 53 61 76 65 nts (Pager.nSave
26820 70 6f 69 6e 74 21 3d 30 29 2c 20 0a 20 20 2a 2a point!=0), . **
26830 20 74 68 65 79 20 63 61 6e 6e 6f 74 20 62 65 20 they cannot be
26840 72 6f 6c 6c 65 64 20 62 61 63 6b 2e 20 53 6f 20 rolled back. So
26850 74 68 65 20 61 73 73 65 72 74 54 72 75 6e 63 61 the assertTrunca
26860 74 65 43 6f 6e 73 74 72 61 69 6e 74 28 29 20 63 teConstraint() c
26870 61 6c 6c 0a 20 20 2a 2a 20 69 73 20 6e 6f 20 6c all. ** is no l
26880 6f 6e 67 65 72 20 63 6f 72 72 65 63 74 2e 20 2a onger correct. *
26890 2f 0a 7d 0a 0a 0a 2f 2a 0a 2a 2a 20 54 68 69 73 /.}.../*.** This
268a0 20 66 75 6e 63 74 69 6f 6e 20 69 73 20 63 61 6c function is cal
268b0 6c 65 64 20 62 65 66 6f 72 65 20 61 74 74 65 6d led before attem
268c0 70 74 69 6e 67 20 61 20 68 6f 74 2d 6a 6f 75 72 pting a hot-jour
268d0 6e 61 6c 20 72 6f 6c 6c 62 61 63 6b 2e 20 49 74 nal rollback. It
268e0 0a 2a 2a 20 73 79 6e 63 73 20 74 68 65 20 6a 6f .** syncs the jo
268f0 75 72 6e 61 6c 20 66 69 6c 65 20 74 6f 20 64 69 urnal file to di
26900 73 6b 2c 20 74 68 65 6e 20 73 65 74 73 20 70 50 sk, then sets pP
26910 61 67 65 72 2d 3e 6a 6f 75 72 6e 61 6c 48 64 72 ager->journalHdr
26920 20 74 6f 20 74 68 65 0a 2a 2a 20 73 69 7a 65 20 to the.** size
26930 6f 66 20 74 68 65 20 6a 6f 75 72 6e 61 6c 20 66 of the journal f
26940 69 6c 65 20 73 6f 20 74 68 61 74 20 74 68 65 20 ile so that the
26950 70 61 67 65 72 5f 70 6c 61 79 62 61 63 6b 28 29 pager_playback()
26960 20 72 6f 75 74 69 6e 65 20 6b 6e 6f 77 73 0a 2a routine knows.*
26970 2a 20 74 68 61 74 20 74 68 65 20 65 6e 74 69 72 * that the entir
26980 65 20 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 20 68 e journal file h
26990 61 73 20 62 65 65 6e 20 73 79 6e 63 65 64 2e 0a as been synced..
269a0 2a 2a 0a 2a 2a 20 53 79 6e 63 69 6e 67 20 61 20 **.** Syncing a
269b0 68 6f 74 2d 6a 6f 75 72 6e 61 6c 20 74 6f 20 64 hot-journal to d
269c0 69 73 6b 20 62 65 66 6f 72 65 20 61 74 74 65 6d isk before attem
269d0 70 74 69 6e 67 20 74 6f 20 72 6f 6c 6c 20 69 74 pting to roll it
269e0 20 62 61 63 6b 20 65 6e 73 75 72 65 73 20 0a 2a back ensures .*
269f0 2a 20 74 68 61 74 20 69 66 20 61 20 70 6f 77 65 * that if a powe
26a00 72 2d 66 61 69 6c 75 72 65 20 6f 63 63 75 72 73 r-failure occurs
26a10 20 64 75 72 69 6e 67 20 74 68 65 20 72 6f 6c 6c during the roll
26a20 62 61 63 6b 2c 20 74 68 65 20 70 72 6f 63 65 73 back, the proces
26a30 73 20 74 68 61 74 0a 2a 2a 20 61 74 74 65 6d 70 s that.** attemp
26a40 74 73 20 72 6f 6c 6c 62 61 63 6b 20 66 6f 6c 6c ts rollback foll
26a50 6f 77 69 6e 67 20 73 79 73 74 65 6d 20 72 65 63 owing system rec
26a60 6f 76 65 72 79 20 73 65 65 73 20 74 68 65 20 73 overy sees the s
26a70 61 6d 65 20 6a 6f 75 72 6e 61 6c 0a 2a 2a 20 63 ame journal.** c
26a80 6f 6e 74 65 6e 74 20 61 73 20 74 68 69 73 20 70 ontent as this p
26a90 72 6f 63 65 73 73 2e 0a 2a 2a 0a 2a 2a 20 49 66 rocess..**.** If
26aa0 20 65 76 65 72 79 74 68 69 6e 67 20 67 6f 65 73 everything goes
26ab0 20 61 73 20 70 6c 61 6e 6e 65 64 2c 20 53 51 4c as planned, SQL
26ac0 49 54 45 5f 4f 4b 20 69 73 20 72 65 74 75 72 6e ITE_OK is return
26ad0 65 64 2e 20 4f 74 68 65 72 77 69 73 65 2c 20 0a ed. Otherwise, .
26ae0 2a 2a 20 61 6e 20 53 51 4c 69 74 65 20 65 72 72 ** an SQLite err
26af0 6f 72 20 63 6f 64 65 2e 0a 2a 2f 0a 73 74 61 74 or code..*/.stat
26b00 69 63 20 69 6e 74 20 70 61 67 65 72 53 79 6e 63 ic int pagerSync
26b10 48 6f 74 4a 6f 75 72 6e 61 6c 28 50 61 67 65 72 HotJournal(Pager
26b20 20 2a 70 50 61 67 65 72 29 7b 0a 20 20 69 6e 74 *pPager){. int
26b30 20 72 63 20 3d 20 53 51 4c 49 54 45 5f 4f 4b 3b rc = SQLITE_OK;
26b40 0a 20 20 69 66 28 20 21 70 50 61 67 65 72 2d 3e . if( !pPager->
26b50 6e 6f 53 79 6e 63 20 29 7b 0a 20 20 20 20 72 63 noSync ){. rc
26b60 20 3d 20 73 71 6c 69 74 65 33 4f 73 53 79 6e 63 = sqlite3OsSync
26b70 28 70 50 61 67 65 72 2d 3e 6a 66 64 2c 20 53 51 (pPager->jfd, SQ
26b80 4c 49 54 45 5f 53 59 4e 43 5f 4e 4f 52 4d 41 4c LITE_SYNC_NORMAL
26b90 29 3b 0a 20 20 7d 0a 20 20 69 66 28 20 72 63 3d );. }. if( rc=
26ba0 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 =SQLITE_OK ){.
26bb0 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33 4f 73 rc = sqlite3Os
26bc0 46 69 6c 65 53 69 7a 65 28 70 50 61 67 65 72 2d FileSize(pPager-
26bd0 3e 6a 66 64 2c 20 26 70 50 61 67 65 72 2d 3e 6a >jfd, &pPager->j
26be0 6f 75 72 6e 61 6c 48 64 72 29 3b 0a 20 20 7d 0a ournalHdr);. }.
26bf0 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 7d 0a 0a return rc;.}..
26c00 2f 2a 0a 2a 2a 20 4f 62 74 61 69 6e 20 61 20 72 /*.** Obtain a r
26c10 65 66 65 72 65 6e 63 65 20 74 6f 20 61 20 6d 65 eference to a me
26c20 6d 6f 72 79 20 6d 61 70 70 65 64 20 70 61 67 65 mory mapped page
26c30 20 6f 62 6a 65 63 74 20 66 6f 72 20 70 61 67 65 object for page
26c40 20 6e 75 6d 62 65 72 20 70 67 6e 6f 2e 20 0a 2a number pgno. .*
26c50 2a 20 54 68 65 20 6e 65 77 20 6f 62 6a 65 63 74 * The new object
26c60 20 77 69 6c 6c 20 75 73 65 20 74 68 65 20 70 6f will use the po
26c70 69 6e 74 65 72 20 70 44 61 74 61 2c 20 6f 62 74 inter pData, obt
26c80 61 69 6e 65 64 20 66 72 6f 6d 20 78 46 65 74 63 ained from xFetc
26c90 68 28 29 2e 0a 2a 2a 20 49 66 20 73 75 63 63 65 h()..** If succe
26ca0 73 73 66 75 6c 2c 20 73 65 74 20 2a 70 70 50 61 ssful, set *ppPa
26cb0 67 65 20 74 6f 20 70 6f 69 6e 74 20 74 6f 20 74 ge to point to t
26cc0 68 65 20 6e 65 77 20 70 61 67 65 20 72 65 66 65 he new page refe
26cd0 72 65 6e 63 65 0a 2a 2a 20 61 6e 64 20 72 65 74 rence.** and ret
26ce0 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 2e 20 4f urn SQLITE_OK. O
26cf0 74 68 65 72 77 69 73 65 2c 20 72 65 74 75 72 6e therwise, return
26d00 20 61 6e 20 53 51 4c 69 74 65 20 65 72 72 6f 72 an SQLite error
26d10 20 63 6f 64 65 20 61 6e 64 20 73 65 74 0a 2a 2a code and set.**
26d20 20 2a 70 70 50 61 67 65 20 74 6f 20 7a 65 72 6f *ppPage to zero
26d30 2e 0a 2a 2a 0a 2a 2a 20 50 61 67 65 20 72 65 66 ..**.** Page ref
26d40 65 72 65 6e 63 65 73 20 6f 62 74 61 69 6e 65 64 erences obtained
26d50 20 62 79 20 63 61 6c 6c 69 6e 67 20 74 68 69 73 by calling this
26d60 20 66 75 6e 63 74 69 6f 6e 20 73 68 6f 75 6c 64 function should
26d70 20 62 65 20 72 65 6c 65 61 73 65 64 0a 2a 2a 20 be released.**
26d80 62 79 20 63 61 6c 6c 69 6e 67 20 70 61 67 65 72 by calling pager
26d90 52 65 6c 65 61 73 65 4d 61 70 50 61 67 65 28 29 ReleaseMapPage()
26da0 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74 20 ..*/.static int
26db0 70 61 67 65 72 41 63 71 75 69 72 65 4d 61 70 50 pagerAcquireMapP
26dc0 61 67 65 28 0a 20 20 50 61 67 65 72 20 2a 70 50 age(. Pager *pP
26dd0 61 67 65 72 2c 20 20 20 20 20 20 20 20 20 20 20 ager,
26de0 20 20 20 20 20 20 20 2f 2a 20 50 61 67 65 72 20 /* Pager
26df0 6f 62 6a 65 63 74 20 2a 2f 0a 20 20 50 67 6e 6f object */. Pgno
26e00 20 70 67 6e 6f 2c 20 20 20 20 20 20 20 20 20 20 pgno,
26e10 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 50 /* P
26e20 61 67 65 20 6e 75 6d 62 65 72 20 2a 2f 0a 20 20 age number */.
26e30 76 6f 69 64 20 2a 70 44 61 74 61 2c 20 20 20 20 void *pData,
26e40 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
26e50 2f 2a 20 78 46 65 74 63 68 28 29 27 64 20 64 61 /* xFetch()'d da
26e60 74 61 20 66 6f 72 20 74 68 69 73 20 70 61 67 65 ta for this page
26e70 20 2a 2f 0a 20 20 50 67 48 64 72 20 2a 2a 70 70 */. PgHdr **pp
26e80 50 61 67 65 20 20 20 20 20 20 20 20 20 20 20 20 Page
26e90 20 20 20 20 20 20 2f 2a 20 4f 55 54 3a 20 41 63 /* OUT: Ac
26ea0 71 75 69 72 65 64 20 70 61 67 65 20 6f 62 6a 65 quired page obje
26eb0 63 74 20 2a 2f 0a 29 7b 0a 20 20 50 67 48 64 72 ct */.){. PgHdr
26ec0 20 2a 70 3b 20 20 20 20 20 20 20 20 20 20 20 20 *p;
26ed0 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4d 65 /* Me
26ee0 6d 6f 72 79 20 6d 61 70 70 65 64 20 70 61 67 65 mory mapped page
26ef0 20 74 6f 20 72 65 74 75 72 6e 20 2a 2f 0a 20 20 to return */.
26f00 0a 20 20 69 66 28 20 70 50 61 67 65 72 2d 3e 70 . if( pPager->p
26f10 4d 6d 61 70 46 72 65 65 6c 69 73 74 20 29 7b 0a MmapFreelist ){.
26f20 20 20 20 20 2a 70 70 50 61 67 65 20 3d 20 70 20 *ppPage = p
26f30 3d 20 70 50 61 67 65 72 2d 3e 70 4d 6d 61 70 46 = pPager->pMmapF
26f40 72 65 65 6c 69 73 74 3b 0a 20 20 20 20 70 50 61 reelist;. pPa
26f50 67 65 72 2d 3e 70 4d 6d 61 70 46 72 65 65 6c 69 ger->pMmapFreeli
26f60 73 74 20 3d 20 70 2d 3e 70 44 69 72 74 79 3b 0a st = p->pDirty;.
26f70 20 20 20 20 70 2d 3e 70 44 69 72 74 79 20 3d 20 p->pDirty =
26f80 30 3b 0a 20 20 20 20 6d 65 6d 73 65 74 28 70 2d 0;. memset(p-
26f90 3e 70 45 78 74 72 61 2c 20 30 2c 20 70 50 61 67 >pExtra, 0, pPag
26fa0 65 72 2d 3e 6e 45 78 74 72 61 29 3b 0a 20 20 7d er->nExtra);. }
26fb0 65 6c 73 65 7b 0a 20 20 20 20 2a 70 70 50 61 67 else{. *ppPag
26fc0 65 20 3d 20 70 20 3d 20 28 50 67 48 64 72 20 2a e = p = (PgHdr *
26fd0 29 73 71 6c 69 74 65 33 4d 61 6c 6c 6f 63 5a 65 )sqlite3MallocZe
26fe0 72 6f 28 73 69 7a 65 6f 66 28 50 67 48 64 72 29 ro(sizeof(PgHdr)
26ff0 20 2b 20 70 50 61 67 65 72 2d 3e 6e 45 78 74 72 + pPager->nExtr
27000 61 29 3b 0a 20 20 20 20 69 66 28 20 70 3d 3d 30 a);. if( p==0
27010 20 29 7b 0a 20 20 20 20 20 20 73 71 6c 69 74 65 ){. sqlite
27020 33 4f 73 55 6e 66 65 74 63 68 28 70 50 61 67 65 3OsUnfetch(pPage
27030 72 2d 3e 66 64 2c 20 28 69 36 34 29 28 70 67 6e r->fd, (i64)(pgn
27040 6f 2d 31 29 20 2a 20 70 50 61 67 65 72 2d 3e 70 o-1) * pPager->p
27050 61 67 65 53 69 7a 65 2c 20 70 44 61 74 61 29 3b ageSize, pData);
27060 0a 20 20 20 20 20 20 72 65 74 75 72 6e 20 53 51 . return SQ
27070 4c 49 54 45 5f 4e 4f 4d 45 4d 5f 42 4b 50 54 3b LITE_NOMEM_BKPT;
27080 0a 20 20 20 20 7d 0a 20 20 20 20 70 2d 3e 70 45 . }. p->pE
27090 78 74 72 61 20 3d 20 28 76 6f 69 64 20 2a 29 26 xtra = (void *)&
270a0 70 5b 31 5d 3b 0a 20 20 20 20 70 2d 3e 66 6c 61 p[1];. p->fla
270b0 67 73 20 3d 20 50 47 48 44 52 5f 4d 4d 41 50 3b gs = PGHDR_MMAP;
270c0 0a 20 20 20 20 70 2d 3e 6e 52 65 66 20 3d 20 31 . p->nRef = 1
270d0 3b 0a 20 20 20 20 70 2d 3e 70 50 61 67 65 72 20 ;. p->pPager
270e0 3d 20 70 50 61 67 65 72 3b 0a 20 20 7d 0a 0a 20 = pPager;. }..
270f0 20 61 73 73 65 72 74 28 20 70 2d 3e 70 45 78 74 assert( p->pExt
27100 72 61 3d 3d 28 76 6f 69 64 20 2a 29 26 70 5b 31 ra==(void *)&p[1
27110 5d 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 70 ] );. assert( p
27120 2d 3e 70 50 61 67 65 3d 3d 30 20 29 3b 0a 20 20 ->pPage==0 );.
27130 61 73 73 65 72 74 28 20 70 2d 3e 66 6c 61 67 73 assert( p->flags
27140 3d 3d 50 47 48 44 52 5f 4d 4d 41 50 20 29 3b 0a ==PGHDR_MMAP );.
27150 20 20 61 73 73 65 72 74 28 20 70 2d 3e 70 50 61 assert( p->pPa
27160 67 65 72 3d 3d 70 50 61 67 65 72 20 29 3b 0a 20 ger==pPager );.
27170 20 61 73 73 65 72 74 28 20 70 2d 3e 6e 52 65 66 assert( p->nRef
27180 3d 3d 31 20 29 3b 0a 0a 20 20 70 2d 3e 70 67 6e ==1 );.. p->pgn
27190 6f 20 3d 20 70 67 6e 6f 3b 0a 20 20 70 2d 3e 70 o = pgno;. p->p
271a0 44 61 74 61 20 3d 20 70 44 61 74 61 3b 0a 20 20 Data = pData;.
271b0 70 50 61 67 65 72 2d 3e 6e 4d 6d 61 70 4f 75 74 pPager->nMmapOut
271c0 2b 2b 3b 0a 0a 20 20 72 65 74 75 72 6e 20 53 51 ++;.. return SQ
271d0 4c 49 54 45 5f 4f 4b 3b 0a 7d 0a 0a 2f 2a 0a 2a LITE_OK;.}../*.*
271e0 2a 20 52 65 6c 65 61 73 65 20 61 20 72 65 66 65 * Release a refe
271f0 72 65 6e 63 65 20 74 6f 20 70 61 67 65 20 70 50 rence to page pP
27200 67 2e 20 70 50 67 20 6d 75 73 74 20 68 61 76 65 g. pPg must have
27210 20 62 65 65 6e 20 72 65 74 75 72 6e 65 64 20 62 been returned b
27220 79 20 61 6e 20 0a 2a 2a 20 65 61 72 6c 69 65 72 y an .** earlier
27230 20 63 61 6c 6c 20 74 6f 20 70 61 67 65 72 41 63 call to pagerAc
27240 71 75 69 72 65 4d 61 70 50 61 67 65 28 29 2e 0a quireMapPage()..
27250 2a 2f 0a 73 74 61 74 69 63 20 76 6f 69 64 20 70 */.static void p
27260 61 67 65 72 52 65 6c 65 61 73 65 4d 61 70 50 61 agerReleaseMapPa
27270 67 65 28 50 67 48 64 72 20 2a 70 50 67 29 7b 0a ge(PgHdr *pPg){.
27280 20 20 50 61 67 65 72 20 2a 70 50 61 67 65 72 20 Pager *pPager
27290 3d 20 70 50 67 2d 3e 70 50 61 67 65 72 3b 0a 20 = pPg->pPager;.
272a0 20 70 50 61 67 65 72 2d 3e 6e 4d 6d 61 70 4f 75 pPager->nMmapOu
272b0 74 2d 2d 3b 0a 20 20 70 50 67 2d 3e 70 44 69 72 t--;. pPg->pDir
272c0 74 79 20 3d 20 70 50 61 67 65 72 2d 3e 70 4d 6d ty = pPager->pMm
272d0 61 70 46 72 65 65 6c 69 73 74 3b 0a 20 20 70 50 apFreelist;. pP
272e0 61 67 65 72 2d 3e 70 4d 6d 61 70 46 72 65 65 6c ager->pMmapFreel
272f0 69 73 74 20 3d 20 70 50 67 3b 0a 0a 20 20 61 73 ist = pPg;.. as
27300 73 65 72 74 28 20 70 50 61 67 65 72 2d 3e 66 64 sert( pPager->fd
27310 2d 3e 70 4d 65 74 68 6f 64 73 2d 3e 69 56 65 72 ->pMethods->iVer
27320 73 69 6f 6e 3e 3d 33 20 29 3b 0a 20 20 73 71 6c sion>=3 );. sql
27330 69 74 65 33 4f 73 55 6e 66 65 74 63 68 28 70 50 ite3OsUnfetch(pP
27340 61 67 65 72 2d 3e 66 64 2c 20 28 69 36 34 29 28 ager->fd, (i64)(
27350 70 50 67 2d 3e 70 67 6e 6f 2d 31 29 2a 70 50 61 pPg->pgno-1)*pPa
27360 67 65 72 2d 3e 70 61 67 65 53 69 7a 65 2c 20 70 ger->pageSize, p
27370 50 67 2d 3e 70 44 61 74 61 29 3b 0a 7d 0a 0a 2f Pg->pData);.}../
27380 2a 0a 2a 2a 20 46 72 65 65 20 61 6c 6c 20 50 67 *.** Free all Pg
27390 48 64 72 20 6f 62 6a 65 63 74 73 20 73 74 6f 72 Hdr objects stor
273a0 65 64 20 69 6e 20 74 68 65 20 50 61 67 65 72 2e ed in the Pager.
273b0 70 4d 6d 61 70 46 72 65 65 6c 69 73 74 20 6c 69 pMmapFreelist li
273c0 73 74 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 76 6f st..*/.static vo
273d0 69 64 20 70 61 67 65 72 46 72 65 65 4d 61 70 48 id pagerFreeMapH
273e0 64 72 73 28 50 61 67 65 72 20 2a 70 50 61 67 65 drs(Pager *pPage
273f0 72 29 7b 0a 20 20 50 67 48 64 72 20 2a 70 3b 0a r){. PgHdr *p;.
27400 20 20 50 67 48 64 72 20 2a 70 4e 65 78 74 3b 0a PgHdr *pNext;.
27410 20 20 66 6f 72 28 70 3d 70 50 61 67 65 72 2d 3e for(p=pPager->
27420 70 4d 6d 61 70 46 72 65 65 6c 69 73 74 3b 20 70 pMmapFreelist; p
27430 3b 20 70 3d 70 4e 65 78 74 29 7b 0a 20 20 20 20 ; p=pNext){.
27440 70 4e 65 78 74 20 3d 20 70 2d 3e 70 44 69 72 74 pNext = p->pDirt
27450 79 3b 0a 20 20 20 20 73 71 6c 69 74 65 33 5f 66 y;. sqlite3_f
27460 72 65 65 28 70 29 3b 0a 20 20 7d 0a 7d 0a 0a 0a ree(p);. }.}...
27470 2f 2a 0a 2a 2a 20 53 68 75 74 64 6f 77 6e 20 74 /*.** Shutdown t
27480 68 65 20 70 61 67 65 20 63 61 63 68 65 2e 20 20 he page cache.
27490 46 72 65 65 20 61 6c 6c 20 6d 65 6d 6f 72 79 20 Free all memory
274a0 61 6e 64 20 63 6c 6f 73 65 20 61 6c 6c 20 66 69 and close all fi
274b0 6c 65 73 2e 0a 2a 2a 0a 2a 2a 20 49 66 20 61 20 les..**.** If a
274c0 74 72 61 6e 73 61 63 74 69 6f 6e 20 77 61 73 20 transaction was
274d0 69 6e 20 70 72 6f 67 72 65 73 73 20 77 68 65 6e in progress when
274e0 20 74 68 69 73 20 72 6f 75 74 69 6e 65 20 69 73 this routine is
274f0 20 63 61 6c 6c 65 64 2c 20 74 68 61 74 0a 2a 2a called, that.**
27500 20 74 72 61 6e 73 61 63 74 69 6f 6e 20 69 73 20 transaction is
27510 72 6f 6c 6c 65 64 20 62 61 63 6b 2e 20 20 41 6c rolled back. Al
27520 6c 20 6f 75 74 73 74 61 6e 64 69 6e 67 20 70 61 l outstanding pa
27530 67 65 73 20 61 72 65 20 69 6e 76 61 6c 69 64 61 ges are invalida
27540 74 65 64 0a 2a 2a 20 61 6e 64 20 74 68 65 69 72 ted.** and their
27550 20 6d 65 6d 6f 72 79 20 69 73 20 66 72 65 65 64 memory is freed
27560 2e 20 20 41 6e 79 20 61 74 74 65 6d 70 74 20 74 . Any attempt t
27570 6f 20 75 73 65 20 61 20 70 61 67 65 20 61 73 73 o use a page ass
27580 6f 63 69 61 74 65 64 0a 2a 2a 20 77 69 74 68 20 ociated.** with
27590 74 68 69 73 20 70 61 67 65 20 63 61 63 68 65 20 this page cache
275a0 61 66 74 65 72 20 74 68 69 73 20 66 75 6e 63 74 after this funct
275b0 69 6f 6e 20 72 65 74 75 72 6e 73 20 77 69 6c 6c ion returns will
275c0 20 6c 69 6b 65 6c 79 0a 2a 2a 20 72 65 73 75 6c likely.** resul
275d0 74 20 69 6e 20 61 20 63 6f 72 65 64 75 6d 70 2e t in a coredump.
275e0 0a 2a 2a 0a 2a 2a 20 54 68 69 73 20 66 75 6e 63 .**.** This func
275f0 74 69 6f 6e 20 61 6c 77 61 79 73 20 73 75 63 63 tion always succ
27600 65 65 64 73 2e 20 49 66 20 61 20 74 72 61 6e 73 eeds. If a trans
27610 61 63 74 69 6f 6e 20 69 73 20 61 63 74 69 76 65 action is active
27620 20 61 6e 20 61 74 74 65 6d 70 74 0a 2a 2a 20 69 an attempt.** i
27630 73 20 6d 61 64 65 20 74 6f 20 72 6f 6c 6c 20 69 s made to roll i
27640 74 20 62 61 63 6b 2e 20 49 66 20 61 6e 20 65 72 t back. If an er
27650 72 6f 72 20 6f 63 63 75 72 73 20 64 75 72 69 6e ror occurs durin
27660 67 20 74 68 65 20 72 6f 6c 6c 62 61 63 6b 20 0a g the rollback .
27670 2a 2a 20 61 20 68 6f 74 20 6a 6f 75 72 6e 61 6c ** a hot journal
27680 20 6d 61 79 20 62 65 20 6c 65 66 74 20 69 6e 20 may be left in
27690 74 68 65 20 66 69 6c 65 73 79 73 74 65 6d 20 62 the filesystem b
276a0 75 74 20 6e 6f 20 65 72 72 6f 72 20 69 73 20 72 ut no error is r
276b0 65 74 75 72 6e 65 64 0a 2a 2a 20 74 6f 20 74 68 eturned.** to th
276c0 65 20 63 61 6c 6c 65 72 2e 0a 2a 2f 0a 69 6e 74 e caller..*/.int
276d0 20 73 71 6c 69 74 65 33 50 61 67 65 72 43 6c 6f sqlite3PagerClo
276e0 73 65 28 50 61 67 65 72 20 2a 70 50 61 67 65 72 se(Pager *pPager
276f0 29 7b 0a 20 20 75 38 20 2a 70 54 6d 70 20 3d 20 ){. u8 *pTmp =
27700 28 75 38 20 2a 29 70 50 61 67 65 72 2d 3e 70 54 (u8 *)pPager->pT
27710 6d 70 53 70 61 63 65 3b 0a 0a 20 20 61 73 73 65 mpSpace;.. asse
27720 72 74 28 20 61 73 73 65 72 74 5f 70 61 67 65 72 rt( assert_pager
27730 5f 73 74 61 74 65 28 70 50 61 67 65 72 29 20 29 _state(pPager) )
27740 3b 0a 20 20 64 69 73 61 62 6c 65 5f 73 69 6d 75 ;. disable_simu
27750 6c 61 74 65 64 5f 69 6f 5f 65 72 72 6f 72 73 28 lated_io_errors(
27760 29 3b 0a 20 20 73 71 6c 69 74 65 33 42 65 67 69 );. sqlite3Begi
27770 6e 42 65 6e 69 67 6e 4d 61 6c 6c 6f 63 28 29 3b nBenignMalloc();
27780 0a 20 20 70 61 67 65 72 46 72 65 65 4d 61 70 48 . pagerFreeMapH
27790 64 72 73 28 70 50 61 67 65 72 29 3b 0a 20 20 2f drs(pPager);. /
277a0 2a 20 70 50 61 67 65 72 2d 3e 65 72 72 43 6f 64 * pPager->errCod
277b0 65 20 3d 20 30 3b 20 2a 2f 0a 20 20 70 50 61 67 e = 0; */. pPag
277c0 65 72 2d 3e 65 78 63 6c 75 73 69 76 65 4d 6f 64 er->exclusiveMod
277d0 65 20 3d 20 30 3b 0a 23 69 66 6e 64 65 66 20 53 e = 0;.#ifndef S
277e0 51 4c 49 54 45 5f 4f 4d 49 54 5f 57 41 4c 0a 20 QLITE_OMIT_WAL.
277f0 20 73 71 6c 69 74 65 33 57 61 6c 43 6c 6f 73 65 sqlite3WalClose
27800 28 70 50 61 67 65 72 2d 3e 70 57 61 6c 2c 20 70 (pPager->pWal, p
27810 50 61 67 65 72 2d 3e 63 6b 70 74 53 79 6e 63 46 Pager->ckptSyncF
27820 6c 61 67 73 2c 20 70 50 61 67 65 72 2d 3e 70 61 lags, pPager->pa
27830 67 65 53 69 7a 65 2c 20 70 54 6d 70 29 3b 0a 20 geSize, pTmp);.
27840 20 70 50 61 67 65 72 2d 3e 70 57 61 6c 20 3d 20 pPager->pWal =
27850 30 3b 0a 23 65 6e 64 69 66 0a 20 20 70 61 67 65 0;.#endif. page
27860 72 5f 72 65 73 65 74 28 70 50 61 67 65 72 29 3b r_reset(pPager);
27870 0a 20 20 69 66 28 20 4d 45 4d 44 42 20 29 7b 0a . if( MEMDB ){.
27880 20 20 20 20 70 61 67 65 72 5f 75 6e 6c 6f 63 6b pager_unlock
27890 28 70 50 61 67 65 72 29 3b 0a 20 20 7d 65 6c 73 (pPager);. }els
278a0 65 7b 0a 20 20 20 20 2f 2a 20 49 66 20 69 74 20 e{. /* If it
278b0 69 73 20 6f 70 65 6e 2c 20 73 79 6e 63 20 74 68 is open, sync th
278c0 65 20 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 20 62 e journal file b
278d0 65 66 6f 72 65 20 63 61 6c 6c 69 6e 67 20 55 6e efore calling Un
278e0 6c 6f 63 6b 41 6e 64 52 6f 6c 6c 62 61 63 6b 2e lockAndRollback.
278f0 0a 20 20 20 20 2a 2a 20 49 66 20 74 68 69 73 20 . ** If this
27900 69 73 20 6e 6f 74 20 64 6f 6e 65 2c 20 74 68 65 is not done, the
27910 6e 20 61 6e 20 75 6e 73 79 6e 63 65 64 20 70 6f n an unsynced po
27920 72 74 69 6f 6e 20 6f 66 20 74 68 65 20 6f 70 65 rtion of the ope
27930 6e 20 6a 6f 75 72 6e 61 6c 20 0a 20 20 20 20 2a n journal . *
27940 2a 20 66 69 6c 65 20 6d 61 79 20 62 65 20 70 6c * file may be pl
27950 61 79 65 64 20 62 61 63 6b 20 69 6e 74 6f 20 74 ayed back into t
27960 68 65 20 64 61 74 61 62 61 73 65 2e 20 49 66 20 he database. If
27970 61 20 70 6f 77 65 72 20 66 61 69 6c 75 72 65 20 a power failure
27980 6f 63 63 75 72 73 20 0a 20 20 20 20 2a 2a 20 77 occurs . ** w
27990 68 69 6c 65 20 74 68 69 73 20 69 73 20 68 61 70 hile this is hap
279a0 70 65 6e 69 6e 67 2c 20 74 68 65 20 64 61 74 61 pening, the data
279b0 62 61 73 65 20 63 6f 75 6c 64 20 62 65 63 6f 6d base could becom
279c0 65 20 63 6f 72 72 75 70 74 2e 0a 20 20 20 20 2a e corrupt.. *
279d0 2a 0a 20 20 20 20 2a 2a 20 49 66 20 61 6e 20 65 *. ** If an e
279e0 72 72 6f 72 20 6f 63 63 75 72 73 20 77 68 69 6c rror occurs whil
279f0 65 20 74 72 79 69 6e 67 20 74 6f 20 73 79 6e 63 e trying to sync
27a00 20 74 68 65 20 6a 6f 75 72 6e 61 6c 2c 20 73 68 the journal, sh
27a10 69 66 74 20 74 68 65 20 70 61 67 65 72 0a 20 20 ift the pager.
27a20 20 20 2a 2a 20 69 6e 74 6f 20 74 68 65 20 45 52 ** into the ER
27a30 52 4f 52 20 73 74 61 74 65 2e 20 54 68 69 73 20 ROR state. This
27a40 63 61 75 73 65 73 20 55 6e 6c 6f 63 6b 41 6e 64 causes UnlockAnd
27a50 52 6f 6c 6c 62 61 63 6b 20 74 6f 20 75 6e 6c 6f Rollback to unlo
27a60 63 6b 20 74 68 65 0a 20 20 20 20 2a 2a 20 64 61 ck the. ** da
27a70 74 61 62 61 73 65 20 61 6e 64 20 63 6c 6f 73 65 tabase and close
27a80 20 74 68 65 20 6a 6f 75 72 6e 61 6c 20 66 69 6c the journal fil
27a90 65 20 77 69 74 68 6f 75 74 20 61 74 74 65 6d 70 e without attemp
27aa0 74 69 6e 67 20 74 6f 20 72 6f 6c 6c 20 69 74 0a ting to roll it.
27ab0 20 20 20 20 2a 2a 20 62 61 63 6b 20 6f 72 20 66 ** back or f
27ac0 69 6e 61 6c 69 7a 65 20 69 74 2e 20 54 68 65 20 inalize it. The
27ad0 6e 65 78 74 20 64 61 74 61 62 61 73 65 20 75 73 next database us
27ae0 65 72 20 77 69 6c 6c 20 68 61 76 65 20 74 6f 20 er will have to
27af0 64 6f 20 68 6f 74 2d 6a 6f 75 72 6e 61 6c 0a 20 do hot-journal.
27b00 20 20 20 2a 2a 20 72 6f 6c 6c 62 61 63 6b 20 62 ** rollback b
27b10 65 66 6f 72 65 20 61 63 63 65 73 73 69 6e 67 20 efore accessing
27b20 74 68 65 20 64 61 74 61 62 61 73 65 20 66 69 6c the database fil
27b30 65 2e 0a 20 20 20 20 2a 2f 0a 20 20 20 20 69 66 e.. */. if
27b40 28 20 69 73 4f 70 65 6e 28 70 50 61 67 65 72 2d ( isOpen(pPager-
27b50 3e 6a 66 64 29 20 29 7b 0a 20 20 20 20 20 20 70 >jfd) ){. p
27b60 61 67 65 72 5f 65 72 72 6f 72 28 70 50 61 67 65 ager_error(pPage
27b70 72 2c 20 70 61 67 65 72 53 79 6e 63 48 6f 74 4a r, pagerSyncHotJ
27b80 6f 75 72 6e 61 6c 28 70 50 61 67 65 72 29 29 3b ournal(pPager));
27b90 0a 20 20 20 20 7d 0a 20 20 20 20 70 61 67 65 72 . }. pager
27ba0 55 6e 6c 6f 63 6b 41 6e 64 52 6f 6c 6c 62 61 63 UnlockAndRollbac
27bb0 6b 28 70 50 61 67 65 72 29 3b 0a 20 20 7d 0a 20 k(pPager);. }.
27bc0 20 73 71 6c 69 74 65 33 45 6e 64 42 65 6e 69 67 sqlite3EndBenig
27bd0 6e 4d 61 6c 6c 6f 63 28 29 3b 0a 20 20 65 6e 61 nMalloc();. ena
27be0 62 6c 65 5f 73 69 6d 75 6c 61 74 65 64 5f 69 6f ble_simulated_io
27bf0 5f 65 72 72 6f 72 73 28 29 3b 0a 20 20 50 41 47 _errors();. PAG
27c00 45 52 54 52 41 43 45 28 28 22 43 4c 4f 53 45 20 ERTRACE(("CLOSE
27c10 25 64 5c 6e 22 2c 20 50 41 47 45 52 49 44 28 70 %d\n", PAGERID(p
27c20 50 61 67 65 72 29 29 29 3b 0a 20 20 49 4f 54 52 Pager)));. IOTR
27c30 41 43 45 28 28 22 43 4c 4f 53 45 20 25 70 5c 6e ACE(("CLOSE %p\n
27c40 22 2c 20 70 50 61 67 65 72 29 29 0a 20 20 73 71 ", pPager)). sq
27c50 6c 69 74 65 33 4f 73 43 6c 6f 73 65 28 70 50 61 lite3OsClose(pPa
27c60 67 65 72 2d 3e 6a 66 64 29 3b 0a 20 20 73 71 6c ger->jfd);. sql
27c70 69 74 65 33 4f 73 43 6c 6f 73 65 28 70 50 61 67 ite3OsClose(pPag
27c80 65 72 2d 3e 66 64 29 3b 0a 20 20 73 71 6c 69 74 er->fd);. sqlit
27c90 65 33 50 61 67 65 46 72 65 65 28 70 54 6d 70 29 e3PageFree(pTmp)
27ca0 3b 0a 20 20 73 71 6c 69 74 65 33 50 63 61 63 68 ;. sqlite3Pcach
27cb0 65 43 6c 6f 73 65 28 70 50 61 67 65 72 2d 3e 70 eClose(pPager->p
27cc0 50 43 61 63 68 65 29 3b 0a 0a 23 69 66 64 65 66 PCache);..#ifdef
27cd0 20 53 51 4c 49 54 45 5f 48 41 53 5f 43 4f 44 45 SQLITE_HAS_CODE
27ce0 43 0a 20 20 69 66 28 20 70 50 61 67 65 72 2d 3e C. if( pPager->
27cf0 78 43 6f 64 65 63 46 72 65 65 20 29 20 70 50 61 xCodecFree ) pPa
27d00 67 65 72 2d 3e 78 43 6f 64 65 63 46 72 65 65 28 ger->xCodecFree(
27d10 70 50 61 67 65 72 2d 3e 70 43 6f 64 65 63 29 3b pPager->pCodec);
27d20 0a 23 65 6e 64 69 66 0a 0a 20 20 61 73 73 65 72 .#endif.. asser
27d30 74 28 20 21 70 50 61 67 65 72 2d 3e 61 53 61 76 t( !pPager->aSav
27d40 65 70 6f 69 6e 74 20 26 26 20 21 70 50 61 67 65 epoint && !pPage
27d50 72 2d 3e 70 49 6e 4a 6f 75 72 6e 61 6c 20 29 3b r->pInJournal );
27d60 0a 20 20 61 73 73 65 72 74 28 20 21 69 73 4f 70 . assert( !isOp
27d70 65 6e 28 70 50 61 67 65 72 2d 3e 6a 66 64 29 20 en(pPager->jfd)
27d80 26 26 20 21 69 73 4f 70 65 6e 28 70 50 61 67 65 && !isOpen(pPage
27d90 72 2d 3e 73 6a 66 64 29 20 29 3b 0a 0a 20 20 73 r->sjfd) );.. s
27da0 71 6c 69 74 65 33 5f 66 72 65 65 28 70 50 61 67 qlite3_free(pPag
27db0 65 72 29 3b 0a 20 20 72 65 74 75 72 6e 20 53 51 er);. return SQ
27dc0 4c 49 54 45 5f 4f 4b 3b 0a 7d 0a 0a 23 69 66 20 LITE_OK;.}..#if
27dd0 21 64 65 66 69 6e 65 64 28 4e 44 45 42 55 47 29 !defined(NDEBUG)
27de0 20 7c 7c 20 64 65 66 69 6e 65 64 28 53 51 4c 49 || defined(SQLI
27df0 54 45 5f 54 45 53 54 29 0a 2f 2a 0a 2a 2a 20 52 TE_TEST)./*.** R
27e00 65 74 75 72 6e 20 74 68 65 20 70 61 67 65 20 6e eturn the page n
27e10 75 6d 62 65 72 20 66 6f 72 20 70 61 67 65 20 70 umber for page p
27e20 50 67 2e 0a 2a 2f 0a 50 67 6e 6f 20 73 71 6c 69 Pg..*/.Pgno sqli
27e30 74 65 33 50 61 67 65 72 50 61 67 65 6e 75 6d 62 te3PagerPagenumb
27e40 65 72 28 44 62 50 61 67 65 20 2a 70 50 67 29 7b er(DbPage *pPg){
27e50 0a 20 20 72 65 74 75 72 6e 20 70 50 67 2d 3e 70 . return pPg->p
27e60 67 6e 6f 3b 0a 7d 0a 23 65 6e 64 69 66 0a 0a 2f gno;.}.#endif../
27e70 2a 0a 2a 2a 20 49 6e 63 72 65 6d 65 6e 74 20 74 *.** Increment t
27e80 68 65 20 72 65 66 65 72 65 6e 63 65 20 63 6f 75 he reference cou
27e90 6e 74 20 66 6f 72 20 70 61 67 65 20 70 50 67 2e nt for page pPg.
27ea0 0a 2a 2f 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 .*/.void sqlite3
27eb0 50 61 67 65 72 52 65 66 28 44 62 50 61 67 65 20 PagerRef(DbPage
27ec0 2a 70 50 67 29 7b 0a 20 20 73 71 6c 69 74 65 33 *pPg){. sqlite3
27ed0 50 63 61 63 68 65 52 65 66 28 70 50 67 29 3b 0a PcacheRef(pPg);.
27ee0 7d 0a 0a 2f 2a 0a 2a 2a 20 53 79 6e 63 20 74 68 }../*.** Sync th
27ef0 65 20 6a 6f 75 72 6e 61 6c 2e 20 49 6e 20 6f 74 e journal. In ot
27f00 68 65 72 20 77 6f 72 64 73 2c 20 6d 61 6b 65 20 her words, make
27f10 73 75 72 65 20 61 6c 6c 20 74 68 65 20 70 61 67 sure all the pag
27f20 65 73 20 74 68 61 74 20 68 61 76 65 0a 2a 2a 20 es that have.**
27f30 62 65 65 6e 20 77 72 69 74 74 65 6e 20 74 6f 20 been written to
27f40 74 68 65 20 6a 6f 75 72 6e 61 6c 20 68 61 76 65 the journal have
27f50 20 61 63 74 75 61 6c 6c 79 20 72 65 61 63 68 65 actually reache
27f60 64 20 74 68 65 20 73 75 72 66 61 63 65 20 6f 66 d the surface of
27f70 20 74 68 65 0a 2a 2a 20 64 69 73 6b 20 61 6e 64 the.** disk and
27f80 20 63 61 6e 20 62 65 20 72 65 73 74 6f 72 65 64 can be restored
27f90 20 69 6e 20 74 68 65 20 65 76 65 6e 74 20 6f 66 in the event of
27fa0 20 61 20 68 6f 74 2d 6a 6f 75 72 6e 61 6c 20 72 a hot-journal r
27fb0 6f 6c 6c 62 61 63 6b 2e 0a 2a 2a 0a 2a 2a 20 49 ollback..**.** I
27fc0 66 20 74 68 65 20 50 61 67 65 72 2e 6e 6f 53 79 f the Pager.noSy
27fd0 6e 63 20 66 6c 61 67 20 69 73 20 73 65 74 2c 20 nc flag is set,
27fe0 74 68 65 6e 20 74 68 69 73 20 66 75 6e 63 74 69 then this functi
27ff0 6f 6e 20 69 73 20 61 20 6e 6f 2d 6f 70 2e 0a 2a on is a no-op..*
28000 2a 20 4f 74 68 65 72 77 69 73 65 2c 20 74 68 65 * Otherwise, the
28010 20 61 63 74 69 6f 6e 73 20 72 65 71 75 69 72 65 actions require
28020 64 20 64 65 70 65 6e 64 20 6f 6e 20 74 68 65 20 d depend on the
28030 6a 6f 75 72 6e 61 6c 2d 6d 6f 64 65 20 61 6e 64 journal-mode and
28040 20 74 68 65 20 0a 2a 2a 20 64 65 76 69 63 65 20 the .** device
28050 63 68 61 72 61 63 74 65 72 69 73 74 69 63 73 20 characteristics
28060 6f 66 20 74 68 65 20 66 69 6c 65 2d 73 79 73 74 of the file-syst
28070 65 6d 2c 20 61 73 20 66 6f 6c 6c 6f 77 73 3a 0a em, as follows:.
28080 2a 2a 0a 2a 2a 20 20 20 2a 20 49 66 20 74 68 65 **.** * If the
28090 20 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 20 69 73 journal file is
280a0 20 61 6e 20 69 6e 2d 6d 65 6d 6f 72 79 20 6a 6f an in-memory jo
280b0 75 72 6e 61 6c 20 66 69 6c 65 2c 20 6e 6f 20 61 urnal file, no a
280c0 63 74 69 6f 6e 20 6e 65 65 64 0a 2a 2a 20 20 20 ction need.**
280d0 20 20 62 65 20 74 61 6b 65 6e 2e 0a 2a 2a 0a 2a be taken..**.*
280e0 2a 20 20 20 2a 20 4f 74 68 65 72 77 69 73 65 2c * * Otherwise,
280f0 20 69 66 20 74 68 65 20 64 65 76 69 63 65 20 64 if the device d
28100 6f 65 73 20 6e 6f 74 20 73 75 70 70 6f 72 74 20 oes not support
28110 74 68 65 20 53 41 46 45 5f 41 50 50 45 4e 44 20 the SAFE_APPEND
28120 70 72 6f 70 65 72 74 79 2c 0a 2a 2a 20 20 20 20 property,.**
28130 20 74 68 65 6e 20 74 68 65 20 6e 52 65 63 20 66 then the nRec f
28140 69 65 6c 64 20 6f 66 20 74 68 65 20 6d 6f 73 74 ield of the most
28150 20 72 65 63 65 6e 74 6c 79 20 77 72 69 74 74 65 recently writte
28160 6e 20 6a 6f 75 72 6e 61 6c 20 68 65 61 64 65 72 n journal header
28170 0a 2a 2a 20 20 20 20 20 69 73 20 75 70 64 61 74 .** is updat
28180 65 64 20 74 6f 20 63 6f 6e 74 61 69 6e 20 74 68 ed to contain th
28190 65 20 6e 75 6d 62 65 72 20 6f 66 20 6a 6f 75 72 e number of jour
281a0 6e 61 6c 20 72 65 63 6f 72 64 73 20 74 68 61 74 nal records that
281b0 20 68 61 76 65 0a 2a 2a 20 20 20 20 20 62 65 65 have.** bee
281c0 6e 20 77 72 69 74 74 65 6e 20 66 6f 6c 6c 6f 77 n written follow
281d0 69 6e 67 20 69 74 2e 20 49 66 20 74 68 65 20 70 ing it. If the p
281e0 61 67 65 72 20 69 73 20 6f 70 65 72 61 74 69 6e ager is operatin
281f0 67 20 69 6e 20 66 75 6c 6c 2d 73 79 6e 63 0a 2a g in full-sync.*
28200 2a 20 20 20 20 20 6d 6f 64 65 2c 20 74 68 65 6e * mode, then
28210 20 74 68 65 20 6a 6f 75 72 6e 61 6c 20 66 69 6c the journal fil
28220 65 20 69 73 20 73 79 6e 63 65 64 20 62 65 66 6f e is synced befo
28230 72 65 20 74 68 69 73 20 66 69 65 6c 64 20 69 73 re this field is
28240 20 75 70 64 61 74 65 64 2e 0a 2a 2a 0a 2a 2a 20 updated..**.**
28250 20 20 2a 20 49 66 20 74 68 65 20 64 65 76 69 63 * If the devic
28260 65 20 64 6f 65 73 20 6e 6f 74 20 73 75 70 70 6f e does not suppo
28270 72 74 20 74 68 65 20 53 45 51 55 45 4e 54 49 41 rt the SEQUENTIA
28280 4c 20 70 72 6f 70 65 72 74 79 2c 20 74 68 65 6e L property, then
28290 20 0a 2a 2a 20 20 20 20 20 6a 6f 75 72 6e 61 6c .** journal
282a0 20 66 69 6c 65 20 69 73 20 73 79 6e 63 65 64 2e file is synced.
282b0 0a 2a 2a 0a 2a 2a 20 4f 72 2c 20 69 6e 20 70 73 .**.** Or, in ps
282c0 65 75 64 6f 2d 63 6f 64 65 3a 0a 2a 2a 0a 2a 2a eudo-code:.**.**
282d0 20 20 20 69 66 28 20 4e 4f 54 20 3c 69 6e 2d 6d if( NOT <in-m
282e0 65 6d 6f 72 79 20 6a 6f 75 72 6e 61 6c 3e 20 29 emory journal> )
282f0 7b 0a 2a 2a 20 20 20 20 20 69 66 28 20 4e 4f 54 {.** if( NOT
28300 20 53 41 46 45 5f 41 50 50 45 4e 44 20 29 7b 0a SAFE_APPEND ){.
28310 2a 2a 20 20 20 20 20 20 20 69 66 28 20 3c 66 75 ** if( <fu
28320 6c 6c 2d 73 79 6e 63 20 6d 6f 64 65 3e 20 29 20 ll-sync mode> )
28330 78 53 79 6e 63 28 3c 6a 6f 75 72 6e 61 6c 20 66 xSync(<journal f
28340 69 6c 65 3e 29 3b 0a 2a 2a 20 20 20 20 20 20 20 ile>);.**
28350 3c 75 70 64 61 74 65 20 6e 52 65 63 20 66 69 65 <update nRec fie
28360 6c 64 3e 0a 2a 2a 20 20 20 20 20 7d 20 0a 2a 2a ld>.** } .**
28370 20 20 20 20 20 69 66 28 20 4e 4f 54 20 53 45 51 if( NOT SEQ
28380 55 45 4e 54 49 41 4c 20 29 20 78 53 79 6e 63 28 UENTIAL ) xSync(
28390 3c 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 3e 29 3b <journal file>);
283a0 0a 2a 2a 20 20 20 7d 0a 2a 2a 0a 2a 2a 20 49 66 .** }.**.** If
283b0 20 73 75 63 63 65 73 73 66 75 6c 2c 20 74 68 69 successful, thi
283c0 73 20 72 6f 75 74 69 6e 65 20 63 6c 65 61 72 73 s routine clears
283d0 20 74 68 65 20 50 47 48 44 52 5f 4e 45 45 44 5f the PGHDR_NEED_
283e0 53 59 4e 43 20 66 6c 61 67 20 6f 66 20 65 76 65 SYNC flag of eve
283f0 72 79 20 0a 2a 2a 20 70 61 67 65 20 63 75 72 72 ry .** page curr
28400 65 6e 74 6c 79 20 68 65 6c 64 20 69 6e 20 6d 65 ently held in me
28410 6d 6f 72 79 20 62 65 66 6f 72 65 20 72 65 74 75 mory before retu
28420 72 6e 69 6e 67 20 53 51 4c 49 54 45 5f 4f 4b 2e rning SQLITE_OK.
28430 20 49 66 20 61 6e 20 49 4f 0a 2a 2a 20 65 72 72 If an IO.** err
28440 6f 72 20 69 73 20 65 6e 63 6f 75 6e 74 65 72 65 or is encountere
28450 64 2c 20 74 68 65 6e 20 74 68 65 20 49 4f 20 65 d, then the IO e
28460 72 72 6f 72 20 63 6f 64 65 20 69 73 20 72 65 74 rror code is ret
28470 75 72 6e 65 64 20 74 6f 20 74 68 65 20 63 61 6c urned to the cal
28480 6c 65 72 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 69 ler..*/.static i
28490 6e 74 20 73 79 6e 63 4a 6f 75 72 6e 61 6c 28 50 nt syncJournal(P
284a0 61 67 65 72 20 2a 70 50 61 67 65 72 2c 20 69 6e ager *pPager, in
284b0 74 20 6e 65 77 48 64 72 29 7b 0a 20 20 69 6e 74 t newHdr){. int
284c0 20 72 63 3b 20 20 20 20 20 20 20 20 20 20 20 20 rc;
284d0 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 /*
284e0 52 65 74 75 72 6e 20 63 6f 64 65 20 2a 2f 0a 0a Return code */..
284f0 20 20 61 73 73 65 72 74 28 20 70 50 61 67 65 72 assert( pPager
28500 2d 3e 65 53 74 61 74 65 3d 3d 50 41 47 45 52 5f ->eState==PAGER_
28510 57 52 49 54 45 52 5f 43 41 43 48 45 4d 4f 44 0a WRITER_CACHEMOD.
28520 20 20 20 20 20 20 20 7c 7c 20 70 50 61 67 65 72 || pPager
28530 2d 3e 65 53 74 61 74 65 3d 3d 50 41 47 45 52 5f ->eState==PAGER_
28540 57 52 49 54 45 52 5f 44 42 4d 4f 44 0a 20 20 29 WRITER_DBMOD. )
28550 3b 0a 20 20 61 73 73 65 72 74 28 20 61 73 73 65 ;. assert( asse
28560 72 74 5f 70 61 67 65 72 5f 73 74 61 74 65 28 70 rt_pager_state(p
28570 50 61 67 65 72 29 20 29 3b 0a 20 20 61 73 73 65 Pager) );. asse
28580 72 74 28 20 21 70 61 67 65 72 55 73 65 57 61 6c rt( !pagerUseWal
28590 28 70 50 61 67 65 72 29 20 29 3b 0a 0a 20 20 72 (pPager) );.. r
285a0 63 20 3d 20 73 71 6c 69 74 65 33 50 61 67 65 72 c = sqlite3Pager
285b0 45 78 63 6c 75 73 69 76 65 4c 6f 63 6b 28 70 50 ExclusiveLock(pP
285c0 61 67 65 72 29 3b 0a 20 20 69 66 28 20 72 63 21 ager);. if( rc!
285d0 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 20 72 65 74 =SQLITE_OK ) ret
285e0 75 72 6e 20 72 63 3b 0a 0a 20 20 69 66 28 20 21 urn rc;.. if( !
285f0 70 50 61 67 65 72 2d 3e 6e 6f 53 79 6e 63 20 29 pPager->noSync )
28600 7b 0a 20 20 20 20 61 73 73 65 72 74 28 20 21 70 {. assert( !p
28610 50 61 67 65 72 2d 3e 74 65 6d 70 46 69 6c 65 20 Pager->tempFile
28620 29 3b 0a 20 20 20 20 69 66 28 20 69 73 4f 70 65 );. if( isOpe
28630 6e 28 70 50 61 67 65 72 2d 3e 6a 66 64 29 20 26 n(pPager->jfd) &
28640 26 20 70 50 61 67 65 72 2d 3e 6a 6f 75 72 6e 61 & pPager->journa
28650 6c 4d 6f 64 65 21 3d 50 41 47 45 52 5f 4a 4f 55 lMode!=PAGER_JOU
28660 52 4e 41 4c 4d 4f 44 45 5f 4d 45 4d 4f 52 59 20 RNALMODE_MEMORY
28670 29 7b 0a 20 20 20 20 20 20 63 6f 6e 73 74 20 69 ){. const i
28680 6e 74 20 69 44 63 20 3d 20 73 71 6c 69 74 65 33 nt iDc = sqlite3
28690 4f 73 44 65 76 69 63 65 43 68 61 72 61 63 74 65 OsDeviceCharacte
286a0 72 69 73 74 69 63 73 28 70 50 61 67 65 72 2d 3e ristics(pPager->
286b0 66 64 29 3b 0a 20 20 20 20 20 20 61 73 73 65 72 fd);. asser
286c0 74 28 20 69 73 4f 70 65 6e 28 70 50 61 67 65 72 t( isOpen(pPager
286d0 2d 3e 6a 66 64 29 20 29 3b 0a 0a 20 20 20 20 20 ->jfd) );..
286e0 20 69 66 28 20 30 3d 3d 28 69 44 63 26 53 51 4c if( 0==(iDc&SQL
286f0 49 54 45 5f 49 4f 43 41 50 5f 53 41 46 45 5f 41 ITE_IOCAP_SAFE_A
28700 50 50 45 4e 44 29 20 29 7b 0a 20 20 20 20 20 20 PPEND) ){.
28710 20 20 2f 2a 20 54 68 69 73 20 62 6c 6f 63 6b 20 /* This block
28720 64 65 61 6c 73 20 77 69 74 68 20 61 6e 20 6f 62 deals with an ob
28730 73 63 75 72 65 20 70 72 6f 62 6c 65 6d 2e 20 49 scure problem. I
28740 66 20 74 68 65 20 6c 61 73 74 20 63 6f 6e 6e 65 f the last conne
28750 63 74 69 6f 6e 0a 20 20 20 20 20 20 20 20 2a 2a ction. **
28760 20 74 68 61 74 20 77 72 6f 74 65 20 74 6f 20 74 that wrote to t
28770 68 69 73 20 64 61 74 61 62 61 73 65 20 77 61 73 his database was
28780 20 6f 70 65 72 61 74 69 6e 67 20 69 6e 20 70 65 operating in pe
28790 72 73 69 73 74 65 6e 74 2d 6a 6f 75 72 6e 61 6c rsistent-journal
287a0 0a 20 20 20 20 20 20 20 20 2a 2a 20 6d 6f 64 65 . ** mode
287b0 2c 20 74 68 65 6e 20 74 68 65 20 6a 6f 75 72 6e , then the journ
287c0 61 6c 20 66 69 6c 65 20 6d 61 79 20 61 74 20 74 al file may at t
287d0 68 69 73 20 70 6f 69 6e 74 20 61 63 74 75 61 6c his point actual
287e0 6c 79 20 62 65 20 6c 61 72 67 65 72 0a 20 20 20 ly be larger.
287f0 20 20 20 20 20 2a 2a 20 74 68 61 6e 20 50 61 67 ** than Pag
28800 65 72 2e 6a 6f 75 72 6e 61 6c 4f 66 66 20 62 79 er.journalOff by
28810 74 65 73 2e 20 49 66 20 74 68 65 20 6e 65 78 74 tes. If the next
28820 20 74 68 69 6e 67 20 69 6e 20 74 68 65 20 6a 6f thing in the jo
28830 75 72 6e 61 6c 0a 20 20 20 20 20 20 20 20 2a 2a urnal. **
28840 20 66 69 6c 65 20 68 61 70 70 65 6e 73 20 74 6f file happens to
28850 20 62 65 20 61 20 6a 6f 75 72 6e 61 6c 2d 68 65 be a journal-he
28860 61 64 65 72 20 28 77 72 69 74 74 65 6e 20 61 73 ader (written as
28870 20 70 61 72 74 20 6f 66 20 74 68 65 0a 20 20 20 part of the.
28880 20 20 20 20 20 2a 2a 20 70 72 65 76 69 6f 75 73 ** previous
28890 20 63 6f 6e 6e 65 63 74 69 6f 6e 27 73 20 74 72 connection's tr
288a0 61 6e 73 61 63 74 69 6f 6e 29 2c 20 61 6e 64 20 ansaction), and
288b0 61 20 63 72 61 73 68 20 6f 72 20 70 6f 77 65 72 a crash or power
288c0 2d 66 61 69 6c 75 72 65 20 0a 20 20 20 20 20 20 -failure .
288d0 20 20 2a 2a 20 6f 63 63 75 72 73 20 61 66 74 65 ** occurs afte
288e0 72 20 6e 52 65 63 20 69 73 20 75 70 64 61 74 65 r nRec is update
288f0 64 20 62 75 74 20 62 65 66 6f 72 65 20 74 68 69 d but before thi
28900 73 20 63 6f 6e 6e 65 63 74 69 6f 6e 20 77 72 69 s connection wri
28910 74 65 73 20 0a 20 20 20 20 20 20 20 20 2a 2a 20 tes . **
28920 61 6e 79 74 68 69 6e 67 20 65 6c 73 65 20 74 6f anything else to
28930 20 74 68 65 20 6a 6f 75 72 6e 61 6c 20 66 69 6c the journal fil
28940 65 20 28 6f 72 20 63 6f 6d 6d 69 74 73 2f 72 6f e (or commits/ro
28950 6c 6c 73 20 62 61 63 6b 20 69 74 73 20 0a 20 20 lls back its .
28960 20 20 20 20 20 20 2a 2a 20 74 72 61 6e 73 61 63 ** transac
28970 74 69 6f 6e 29 2c 20 74 68 65 6e 20 53 51 4c 69 tion), then SQLi
28980 74 65 20 6d 61 79 20 62 65 63 6f 6d 65 20 63 6f te may become co
28990 6e 66 75 73 65 64 20 77 68 65 6e 20 64 6f 69 6e nfused when doin
289a0 67 20 74 68 65 20 0a 20 20 20 20 20 20 20 20 2a g the . *
289b0 2a 20 68 6f 74 2d 6a 6f 75 72 6e 61 6c 20 72 6f * hot-journal ro
289c0 6c 6c 62 61 63 6b 20 66 6f 6c 6c 6f 77 69 6e 67 llback following
289d0 20 72 65 63 6f 76 65 72 79 2e 20 49 74 20 6d 61 recovery. It ma
289e0 79 20 72 6f 6c 6c 20 62 61 63 6b 20 61 6c 6c 0a y roll back all.
289f0 20 20 20 20 20 20 20 20 2a 2a 20 6f 66 20 74 68 ** of th
28a00 69 73 20 63 6f 6e 6e 65 63 74 69 6f 6e 73 20 64 is connections d
28a10 61 74 61 2c 20 74 68 65 6e 20 70 72 6f 63 65 65 ata, then procee
28a20 64 20 74 6f 20 72 6f 6c 6c 69 6e 67 20 62 61 63 d to rolling bac
28a30 6b 20 74 68 65 20 6f 6c 64 2c 0a 20 20 20 20 20 k the old,.
28a40 20 20 20 2a 2a 20 6f 75 74 2d 6f 66 2d 64 61 74 ** out-of-dat
28a50 65 20 64 61 74 61 20 74 68 61 74 20 66 6f 6c 6c e data that foll
28a60 6f 77 73 20 69 74 2e 20 44 61 74 61 62 61 73 65 ows it. Database
28a70 20 63 6f 72 72 75 70 74 69 6f 6e 2e 0a 20 20 20 corruption..
28a80 20 20 20 20 20 2a 2a 0a 20 20 20 20 20 20 20 20 **.
28a90 2a 2a 20 54 6f 20 77 6f 72 6b 20 61 72 6f 75 6e ** To work aroun
28aa0 64 20 74 68 69 73 2c 20 69 66 20 74 68 65 20 6a d this, if the j
28ab0 6f 75 72 6e 61 6c 20 66 69 6c 65 20 64 6f 65 73 ournal file does
28ac0 20 61 70 70 65 61 72 20 74 6f 20 63 6f 6e 74 61 appear to conta
28ad0 69 6e 0a 20 20 20 20 20 20 20 20 2a 2a 20 61 20 in. ** a
28ae0 76 61 6c 69 64 20 68 65 61 64 65 72 20 66 6f 6c valid header fol
28af0 6c 6f 77 69 6e 67 20 50 61 67 65 72 2e 6a 6f 75 lowing Pager.jou
28b00 72 6e 61 6c 4f 66 66 2c 20 74 68 65 6e 20 77 72 rnalOff, then wr
28b10 69 74 65 20 61 20 30 78 30 30 0a 20 20 20 20 20 ite a 0x00.
28b20 20 20 20 2a 2a 20 62 79 74 65 20 74 6f 20 74 68 ** byte to th
28b30 65 20 73 74 61 72 74 20 6f 66 20 69 74 20 74 6f e start of it to
28b40 20 70 72 65 76 65 6e 74 20 69 74 20 66 72 6f 6d prevent it from
28b50 20 62 65 69 6e 67 20 72 65 63 6f 67 6e 69 7a 65 being recognize
28b60 64 2e 0a 20 20 20 20 20 20 20 20 2a 2a 0a 20 20 d.. **.
28b70 20 20 20 20 20 20 2a 2a 20 56 61 72 69 61 62 6c ** Variabl
28b80 65 20 69 4e 65 78 74 48 64 72 4f 66 66 73 65 74 e iNextHdrOffset
28b90 20 69 73 20 73 65 74 20 74 6f 20 74 68 65 20 6f is set to the o
28ba0 66 66 73 65 74 20 61 74 20 77 68 69 63 68 20 74 ffset at which t
28bb0 68 69 73 0a 20 20 20 20 20 20 20 20 2a 2a 20 70 his. ** p
28bc0 72 6f 62 6c 65 6d 61 74 69 63 20 68 65 61 64 65 roblematic heade
28bd0 72 20 77 69 6c 6c 20 6f 63 63 75 72 2c 20 69 66 r will occur, if
28be0 20 69 74 20 65 78 69 73 74 73 2e 20 61 4d 61 67 it exists. aMag
28bf0 69 63 20 69 73 20 75 73 65 64 20 0a 20 20 20 20 ic is used .
28c00 20 20 20 20 2a 2a 20 61 73 20 61 20 74 65 6d 70 ** as a temp
28c10 6f 72 61 72 79 20 62 75 66 66 65 72 20 74 6f 20 orary buffer to
28c20 69 6e 73 70 65 63 74 20 74 68 65 20 66 69 72 73 inspect the firs
28c30 74 20 63 6f 75 70 6c 65 20 6f 66 20 62 79 74 65 t couple of byte
28c40 73 20 6f 66 0a 20 20 20 20 20 20 20 20 2a 2a 20 s of. **
28c50 74 68 65 20 70 6f 74 65 6e 74 69 61 6c 20 6a 6f the potential jo
28c60 75 72 6e 61 6c 20 68 65 61 64 65 72 2e 0a 20 20 urnal header..
28c70 20 20 20 20 20 20 2a 2f 0a 20 20 20 20 20 20 20 */.
28c80 20 69 36 34 20 69 4e 65 78 74 48 64 72 4f 66 66 i64 iNextHdrOff
28c90 73 65 74 3b 0a 20 20 20 20 20 20 20 20 75 38 20 set;. u8
28ca0 61 4d 61 67 69 63 5b 38 5d 3b 0a 20 20 20 20 20 aMagic[8];.
28cb0 20 20 20 75 38 20 7a 48 65 61 64 65 72 5b 73 69 u8 zHeader[si
28cc0 7a 65 6f 66 28 61 4a 6f 75 72 6e 61 6c 4d 61 67 zeof(aJournalMag
28cd0 69 63 29 2b 34 5d 3b 0a 0a 20 20 20 20 20 20 20 ic)+4];..
28ce0 20 6d 65 6d 63 70 79 28 7a 48 65 61 64 65 72 2c memcpy(zHeader,
28cf0 20 61 4a 6f 75 72 6e 61 6c 4d 61 67 69 63 2c 20 aJournalMagic,
28d00 73 69 7a 65 6f 66 28 61 4a 6f 75 72 6e 61 6c 4d sizeof(aJournalM
28d10 61 67 69 63 29 29 3b 0a 20 20 20 20 20 20 20 20 agic));.
28d20 70 75 74 33 32 62 69 74 73 28 26 7a 48 65 61 64 put32bits(&zHead
28d30 65 72 5b 73 69 7a 65 6f 66 28 61 4a 6f 75 72 6e er[sizeof(aJourn
28d40 61 6c 4d 61 67 69 63 29 5d 2c 20 70 50 61 67 65 alMagic)], pPage
28d50 72 2d 3e 6e 52 65 63 29 3b 0a 0a 20 20 20 20 20 r->nRec);..
28d60 20 20 20 69 4e 65 78 74 48 64 72 4f 66 66 73 65 iNextHdrOffse
28d70 74 20 3d 20 6a 6f 75 72 6e 61 6c 48 64 72 4f 66 t = journalHdrOf
28d80 66 73 65 74 28 70 50 61 67 65 72 29 3b 0a 20 20 fset(pPager);.
28d90 20 20 20 20 20 20 72 63 20 3d 20 73 71 6c 69 74 rc = sqlit
28da0 65 33 4f 73 52 65 61 64 28 70 50 61 67 65 72 2d e3OsRead(pPager-
28db0 3e 6a 66 64 2c 20 61 4d 61 67 69 63 2c 20 38 2c >jfd, aMagic, 8,
28dc0 20 69 4e 65 78 74 48 64 72 4f 66 66 73 65 74 29 iNextHdrOffset)
28dd0 3b 0a 20 20 20 20 20 20 20 20 69 66 28 20 72 63 ;. if( rc
28de0 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 26 26 20 30 ==SQLITE_OK && 0
28df0 3d 3d 6d 65 6d 63 6d 70 28 61 4d 61 67 69 63 2c ==memcmp(aMagic,
28e00 20 61 4a 6f 75 72 6e 61 6c 4d 61 67 69 63 2c 20 aJournalMagic,
28e10 38 29 20 29 7b 0a 20 20 20 20 20 20 20 20 20 20 8) ){.
28e20 73 74 61 74 69 63 20 63 6f 6e 73 74 20 75 38 20 static const u8
28e30 7a 65 72 6f 62 79 74 65 20 3d 20 30 3b 0a 20 20 zerobyte = 0;.
28e40 20 20 20 20 20 20 20 20 72 63 20 3d 20 73 71 6c rc = sql
28e50 69 74 65 33 4f 73 57 72 69 74 65 28 70 50 61 67 ite3OsWrite(pPag
28e60 65 72 2d 3e 6a 66 64 2c 20 26 7a 65 72 6f 62 79 er->jfd, &zeroby
28e70 74 65 2c 20 31 2c 20 69 4e 65 78 74 48 64 72 4f te, 1, iNextHdrO
28e80 66 66 73 65 74 29 3b 0a 20 20 20 20 20 20 20 20 ffset);.
28e90 7d 0a 20 20 20 20 20 20 20 20 69 66 28 20 72 63 }. if( rc
28ea0 21 3d 53 51 4c 49 54 45 5f 4f 4b 20 26 26 20 72 !=SQLITE_OK && r
28eb0 63 21 3d 53 51 4c 49 54 45 5f 49 4f 45 52 52 5f c!=SQLITE_IOERR_
28ec0 53 48 4f 52 54 5f 52 45 41 44 20 29 7b 0a 20 20 SHORT_READ ){.
28ed0 20 20 20 20 20 20 20 20 72 65 74 75 72 6e 20 72 return r
28ee0 63 3b 0a 20 20 20 20 20 20 20 20 7d 0a 0a 20 20 c;. }..
28ef0 20 20 20 20 20 20 2f 2a 20 57 72 69 74 65 20 74 /* Write t
28f00 68 65 20 6e 52 65 63 20 76 61 6c 75 65 20 69 6e he nRec value in
28f10 74 6f 20 74 68 65 20 6a 6f 75 72 6e 61 6c 20 66 to the journal f
28f20 69 6c 65 20 68 65 61 64 65 72 2e 20 49 66 20 69 ile header. If i
28f30 6e 0a 20 20 20 20 20 20 20 20 2a 2a 20 66 75 6c n. ** ful
28f40 6c 2d 73 79 6e 63 68 72 6f 6e 6f 75 73 20 6d 6f l-synchronous mo
28f50 64 65 2c 20 73 79 6e 63 20 74 68 65 20 6a 6f 75 de, sync the jou
28f60 72 6e 61 6c 20 66 69 72 73 74 2e 20 54 68 69 73 rnal first. This
28f70 20 65 6e 73 75 72 65 73 20 74 68 61 74 0a 20 20 ensures that.
28f80 20 20 20 20 20 20 2a 2a 20 61 6c 6c 20 64 61 74 ** all dat
28f90 61 20 68 61 73 20 72 65 61 6c 6c 79 20 68 69 74 a has really hit
28fa0 20 74 68 65 20 64 69 73 6b 20 62 65 66 6f 72 65 the disk before
28fb0 20 6e 52 65 63 20 69 73 20 75 70 64 61 74 65 64 nRec is updated
28fc0 20 74 6f 20 6d 61 72 6b 0a 20 20 20 20 20 20 20 to mark.
28fd0 20 2a 2a 20 69 74 20 61 73 20 61 20 63 61 6e 64 ** it as a cand
28fe0 69 64 61 74 65 20 66 6f 72 20 72 6f 6c 6c 62 61 idate for rollba
28ff0 63 6b 2e 0a 20 20 20 20 20 20 20 20 2a 2a 0a 20 ck.. **.
29000 20 20 20 20 20 20 20 2a 2a 20 54 68 69 73 20 69 ** This i
29010 73 20 6e 6f 74 20 72 65 71 75 69 72 65 64 20 69 s not required i
29020 66 20 74 68 65 20 70 65 72 73 69 73 74 65 6e 74 f the persistent
29030 20 6d 65 64 69 61 20 73 75 70 70 6f 72 74 73 20 media supports
29040 74 68 65 0a 20 20 20 20 20 20 20 20 2a 2a 20 53 the. ** S
29050 41 46 45 5f 41 50 50 45 4e 44 20 70 72 6f 70 65 AFE_APPEND prope
29060 72 74 79 2e 20 42 65 63 61 75 73 65 20 69 6e 20 rty. Because in
29070 74 68 69 73 20 63 61 73 65 20 69 74 20 69 73 20 this case it is
29080 6e 6f 74 20 70 6f 73 73 69 62 6c 65 20 0a 20 20 not possible .
29090 20 20 20 20 20 20 2a 2a 20 66 6f 72 20 67 61 72 ** for gar
290a0 62 61 67 65 20 64 61 74 61 20 74 6f 20 62 65 20 bage data to be
290b0 61 70 70 65 6e 64 65 64 20 74 6f 20 74 68 65 20 appended to the
290c0 66 69 6c 65 2c 20 74 68 65 20 6e 52 65 63 20 66 file, the nRec f
290d0 69 65 6c 64 0a 20 20 20 20 20 20 20 20 2a 2a 20 ield. **
290e0 69 73 20 70 6f 70 75 6c 61 74 65 64 20 77 69 74 is populated wit
290f0 68 20 30 78 46 46 46 46 46 46 46 46 20 77 68 65 h 0xFFFFFFFF whe
29100 6e 20 74 68 65 20 6a 6f 75 72 6e 61 6c 20 68 65 n the journal he
29110 61 64 65 72 20 69 73 20 77 72 69 74 74 65 6e 0a ader is written.
29120 20 20 20 20 20 20 20 20 2a 2a 20 61 6e 64 20 6e ** and n
29130 65 76 65 72 20 6e 65 65 64 73 20 74 6f 20 62 65 ever needs to be
29140 20 75 70 64 61 74 65 64 2e 0a 20 20 20 20 20 20 updated..
29150 20 20 2a 2f 0a 20 20 20 20 20 20 20 20 69 66 28 */. if(
29160 20 70 50 61 67 65 72 2d 3e 66 75 6c 6c 53 79 6e pPager->fullSyn
29170 63 20 26 26 20 30 3d 3d 28 69 44 63 26 53 51 4c c && 0==(iDc&SQL
29180 49 54 45 5f 49 4f 43 41 50 5f 53 45 51 55 45 4e ITE_IOCAP_SEQUEN
29190 54 49 41 4c 29 20 29 7b 0a 20 20 20 20 20 20 20 TIAL) ){.
291a0 20 20 20 50 41 47 45 52 54 52 41 43 45 28 28 22 PAGERTRACE(("
291b0 53 59 4e 43 20 6a 6f 75 72 6e 61 6c 20 6f 66 20 SYNC journal of
291c0 25 64 5c 6e 22 2c 20 50 41 47 45 52 49 44 28 70 %d\n", PAGERID(p
291d0 50 61 67 65 72 29 29 29 3b 0a 20 20 20 20 20 20 Pager)));.
291e0 20 20 20 20 49 4f 54 52 41 43 45 28 28 22 4a 53 IOTRACE(("JS
291f0 59 4e 43 20 25 70 5c 6e 22 2c 20 70 50 61 67 65 YNC %p\n", pPage
29200 72 29 29 0a 20 20 20 20 20 20 20 20 20 20 72 63 r)). rc
29210 20 3d 20 73 71 6c 69 74 65 33 4f 73 53 79 6e 63 = sqlite3OsSync
29220 28 70 50 61 67 65 72 2d 3e 6a 66 64 2c 20 70 50 (pPager->jfd, pP
29230 61 67 65 72 2d 3e 73 79 6e 63 46 6c 61 67 73 29 ager->syncFlags)
29240 3b 0a 20 20 20 20 20 20 20 20 20 20 69 66 28 20 ;. if(
29250 72 63 21 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 20 rc!=SQLITE_OK )
29260 72 65 74 75 72 6e 20 72 63 3b 0a 20 20 20 20 20 return rc;.
29270 20 20 20 7d 0a 20 20 20 20 20 20 20 20 49 4f 54 }. IOT
29280 52 41 43 45 28 28 22 4a 48 44 52 20 25 70 20 25 RACE(("JHDR %p %
29290 6c 6c 64 5c 6e 22 2c 20 70 50 61 67 65 72 2c 20 lld\n", pPager,
292a0 70 50 61 67 65 72 2d 3e 6a 6f 75 72 6e 61 6c 48 pPager->journalH
292b0 64 72 29 29 3b 0a 20 20 20 20 20 20 20 20 72 63 dr));. rc
292c0 20 3d 20 73 71 6c 69 74 65 33 4f 73 57 72 69 74 = sqlite3OsWrit
292d0 65 28 0a 20 20 20 20 20 20 20 20 20 20 20 20 70 e(. p
292e0 50 61 67 65 72 2d 3e 6a 66 64 2c 20 7a 48 65 61 Pager->jfd, zHea
292f0 64 65 72 2c 20 73 69 7a 65 6f 66 28 7a 48 65 61 der, sizeof(zHea
29300 64 65 72 29 2c 20 70 50 61 67 65 72 2d 3e 6a 6f der), pPager->jo
29310 75 72 6e 61 6c 48 64 72 0a 20 20 20 20 20 20 20 urnalHdr.
29320 20 29 3b 0a 20 20 20 20 20 20 20 20 69 66 28 20 );. if(
29330 72 63 21 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 20 rc!=SQLITE_OK )
29340 72 65 74 75 72 6e 20 72 63 3b 0a 20 20 20 20 20 return rc;.
29350 20 7d 0a 20 20 20 20 20 20 69 66 28 20 30 3d 3d }. if( 0==
29360 28 69 44 63 26 53 51 4c 49 54 45 5f 49 4f 43 41 (iDc&SQLITE_IOCA
29370 50 5f 53 45 51 55 45 4e 54 49 41 4c 29 20 29 7b P_SEQUENTIAL) ){
29380 0a 20 20 20 20 20 20 20 20 50 41 47 45 52 54 52 . PAGERTR
29390 41 43 45 28 28 22 53 59 4e 43 20 6a 6f 75 72 6e ACE(("SYNC journ
293a0 61 6c 20 6f 66 20 25 64 5c 6e 22 2c 20 50 41 47 al of %d\n", PAG
293b0 45 52 49 44 28 70 50 61 67 65 72 29 29 29 3b 0a ERID(pPager)));.
293c0 20 20 20 20 20 20 20 20 49 4f 54 52 41 43 45 28 IOTRACE(
293d0 28 22 4a 53 59 4e 43 20 25 70 5c 6e 22 2c 20 70 ("JSYNC %p\n", p
293e0 50 61 67 65 72 29 29 0a 20 20 20 20 20 20 20 20 Pager)).
293f0 72 63 20 3d 20 73 71 6c 69 74 65 33 4f 73 53 79 rc = sqlite3OsSy
29400 6e 63 28 70 50 61 67 65 72 2d 3e 6a 66 64 2c 20 nc(pPager->jfd,
29410 70 50 61 67 65 72 2d 3e 73 79 6e 63 46 6c 61 67 pPager->syncFlag
29420 73 7c 20 0a 20 20 20 20 20 20 20 20 20 20 28 70 s| . (p
29430 50 61 67 65 72 2d 3e 73 79 6e 63 46 6c 61 67 73 Pager->syncFlags
29440 3d 3d 53 51 4c 49 54 45 5f 53 59 4e 43 5f 46 55 ==SQLITE_SYNC_FU
29450 4c 4c 3f 53 51 4c 49 54 45 5f 53 59 4e 43 5f 44 LL?SQLITE_SYNC_D
29460 41 54 41 4f 4e 4c 59 3a 30 29 0a 20 20 20 20 20 ATAONLY:0).
29470 20 20 20 29 3b 0a 20 20 20 20 20 20 20 20 69 66 );. if
29480 28 20 72 63 21 3d 53 51 4c 49 54 45 5f 4f 4b 20 ( rc!=SQLITE_OK
29490 29 20 72 65 74 75 72 6e 20 72 63 3b 0a 20 20 20 ) return rc;.
294a0 20 20 20 7d 0a 0a 20 20 20 20 20 20 70 50 61 67 }.. pPag
294b0 65 72 2d 3e 6a 6f 75 72 6e 61 6c 48 64 72 20 3d er->journalHdr =
294c0 20 70 50 61 67 65 72 2d 3e 6a 6f 75 72 6e 61 6c pPager->journal
294d0 4f 66 66 3b 0a 20 20 20 20 20 20 69 66 28 20 6e Off;. if( n
294e0 65 77 48 64 72 20 26 26 20 30 3d 3d 28 69 44 63 ewHdr && 0==(iDc
294f0 26 53 51 4c 49 54 45 5f 49 4f 43 41 50 5f 53 41 &SQLITE_IOCAP_SA
29500 46 45 5f 41 50 50 45 4e 44 29 20 29 7b 0a 20 20 FE_APPEND) ){.
29510 20 20 20 20 20 20 70 50 61 67 65 72 2d 3e 6e 52 pPager->nR
29520 65 63 20 3d 20 30 3b 0a 20 20 20 20 20 20 20 20 ec = 0;.
29530 72 63 20 3d 20 77 72 69 74 65 4a 6f 75 72 6e 61 rc = writeJourna
29540 6c 48 64 72 28 70 50 61 67 65 72 29 3b 0a 20 20 lHdr(pPager);.
29550 20 20 20 20 20 20 69 66 28 20 72 63 21 3d 53 51 if( rc!=SQ
29560 4c 49 54 45 5f 4f 4b 20 29 20 72 65 74 75 72 6e LITE_OK ) return
29570 20 72 63 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20 rc;. }.
29580 20 7d 65 6c 73 65 7b 0a 20 20 20 20 20 20 70 50 }else{. pP
29590 61 67 65 72 2d 3e 6a 6f 75 72 6e 61 6c 48 64 72 ager->journalHdr
295a0 20 3d 20 70 50 61 67 65 72 2d 3e 6a 6f 75 72 6e = pPager->journ
295b0 61 6c 4f 66 66 3b 0a 20 20 20 20 7d 0a 20 20 7d alOff;. }. }
295c0 0a 0a 20 20 2f 2a 20 55 6e 6c 65 73 73 20 74 68 .. /* Unless th
295d0 65 20 70 61 67 65 72 20 69 73 20 69 6e 20 6e 6f e pager is in no
295e0 53 79 6e 63 20 6d 6f 64 65 2c 20 74 68 65 20 6a Sync mode, the j
295f0 6f 75 72 6e 61 6c 20 66 69 6c 65 20 77 61 73 20 ournal file was
29600 6a 75 73 74 20 0a 20 20 2a 2a 20 73 75 63 63 65 just . ** succe
29610 73 73 66 75 6c 6c 79 20 73 79 6e 63 65 64 2e 20 ssfully synced.
29620 45 69 74 68 65 72 20 77 61 79 2c 20 63 6c 65 61 Either way, clea
29630 72 20 74 68 65 20 50 47 48 44 52 5f 4e 45 45 44 r the PGHDR_NEED
29640 5f 53 59 4e 43 20 66 6c 61 67 20 6f 6e 20 0a 20 _SYNC flag on .
29650 20 2a 2a 20 61 6c 6c 20 70 61 67 65 73 2e 0a 20 ** all pages..
29660 20 2a 2f 0a 20 20 73 71 6c 69 74 65 33 50 63 61 */. sqlite3Pca
29670 63 68 65 43 6c 65 61 72 53 79 6e 63 46 6c 61 67 cheClearSyncFlag
29680 73 28 70 50 61 67 65 72 2d 3e 70 50 43 61 63 68 s(pPager->pPCach
29690 65 29 3b 0a 20 20 70 50 61 67 65 72 2d 3e 65 53 e);. pPager->eS
296a0 74 61 74 65 20 3d 20 50 41 47 45 52 5f 57 52 49 tate = PAGER_WRI
296b0 54 45 52 5f 44 42 4d 4f 44 3b 0a 20 20 61 73 73 TER_DBMOD;. ass
296c0 65 72 74 28 20 61 73 73 65 72 74 5f 70 61 67 65 ert( assert_page
296d0 72 5f 73 74 61 74 65 28 70 50 61 67 65 72 29 20 r_state(pPager)
296e0 29 3b 0a 20 20 72 65 74 75 72 6e 20 53 51 4c 49 );. return SQLI
296f0 54 45 5f 4f 4b 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 TE_OK;.}../*.**
29700 54 68 65 20 61 72 67 75 6d 65 6e 74 20 69 73 20 The argument is
29710 74 68 65 20 66 69 72 73 74 20 69 6e 20 61 20 6c the first in a l
29720 69 6e 6b 65 64 20 6c 69 73 74 20 6f 66 20 64 69 inked list of di
29730 72 74 79 20 70 61 67 65 73 20 63 6f 6e 6e 65 63 rty pages connec
29740 74 65 64 0a 2a 2a 20 62 79 20 74 68 65 20 50 67 ted.** by the Pg
29750 48 64 72 2e 70 44 69 72 74 79 20 70 6f 69 6e 74 Hdr.pDirty point
29760 65 72 2e 20 54 68 69 73 20 66 75 6e 63 74 69 6f er. This functio
29770 6e 20 77 72 69 74 65 73 20 65 61 63 68 20 6f 6e n writes each on
29780 65 20 6f 66 20 74 68 65 0a 2a 2a 20 69 6e 2d 6d e of the.** in-m
29790 65 6d 6f 72 79 20 70 61 67 65 73 20 69 6e 20 74 emory pages in t
297a0 68 65 20 6c 69 73 74 20 74 6f 20 74 68 65 20 64 he list to the d
297b0 61 74 61 62 61 73 65 20 66 69 6c 65 2e 20 54 68 atabase file. Th
297c0 65 20 61 72 67 75 6d 65 6e 74 20 6d 61 79 0a 2a e argument may.*
297d0 2a 20 62 65 20 4e 55 4c 4c 2c 20 72 65 70 72 65 * be NULL, repre
297e0 73 65 6e 74 69 6e 67 20 61 6e 20 65 6d 70 74 79 senting an empty
297f0 20 6c 69 73 74 2e 20 49 6e 20 74 68 69 73 20 63 list. In this c
29800 61 73 65 20 74 68 69 73 20 66 75 6e 63 74 69 6f ase this functio
29810 6e 20 69 73 0a 2a 2a 20 61 20 6e 6f 2d 6f 70 2e n is.** a no-op.
29820 0a 2a 2a 0a 2a 2a 20 54 68 65 20 70 61 67 65 72 .**.** The pager
29830 20 6d 75 73 74 20 68 6f 6c 64 20 61 74 20 6c 65 must hold at le
29840 61 73 74 20 61 20 52 45 53 45 52 56 45 44 20 6c ast a RESERVED l
29850 6f 63 6b 20 77 68 65 6e 20 74 68 69 73 20 66 75 ock when this fu
29860 6e 63 74 69 6f 6e 0a 2a 2a 20 69 73 20 63 61 6c nction.** is cal
29870 6c 65 64 2e 20 42 65 66 6f 72 65 20 77 72 69 74 led. Before writ
29880 69 6e 67 20 61 6e 79 74 68 69 6e 67 20 74 6f 20 ing anything to
29890 74 68 65 20 64 61 74 61 62 61 73 65 20 66 69 6c the database fil
298a0 65 2c 20 74 68 69 73 20 6c 6f 63 6b 0a 2a 2a 20 e, this lock.**
298b0 69 73 20 75 70 67 72 61 64 65 64 20 74 6f 20 61 is upgraded to a
298c0 6e 20 45 58 43 4c 55 53 49 56 45 20 6c 6f 63 6b n EXCLUSIVE lock
298d0 2e 20 49 66 20 74 68 65 20 6c 6f 63 6b 20 63 61 . If the lock ca
298e0 6e 6e 6f 74 20 62 65 20 6f 62 74 61 69 6e 65 64 nnot be obtained
298f0 2c 0a 2a 2a 20 53 51 4c 49 54 45 5f 42 55 53 59 ,.** SQLITE_BUSY
29900 20 69 73 20 72 65 74 75 72 6e 65 64 20 61 6e 64 is returned and
29910 20 6e 6f 20 64 61 74 61 20 69 73 20 77 72 69 74 no data is writ
29920 74 65 6e 20 74 6f 20 74 68 65 20 64 61 74 61 62 ten to the datab
29930 61 73 65 20 66 69 6c 65 2e 0a 2a 2a 20 0a 2a 2a ase file..** .**
29940 20 49 66 20 74 68 65 20 70 61 67 65 72 20 69 73 If the pager is
29950 20 61 20 74 65 6d 70 2d 66 69 6c 65 20 70 61 67 a temp-file pag
29960 65 72 20 61 6e 64 20 74 68 65 20 61 63 74 75 61 er and the actua
29970 6c 20 66 69 6c 65 2d 73 79 73 74 65 6d 20 66 69 l file-system fi
29980 6c 65 0a 2a 2a 20 69 73 20 6e 6f 74 20 79 65 74 le.** is not yet
29990 20 6f 70 65 6e 2c 20 69 74 20 69 73 20 63 72 65 open, it is cre
299a0 61 74 65 64 20 61 6e 64 20 6f 70 65 6e 65 64 20 ated and opened
299b0 62 65 66 6f 72 65 20 61 6e 79 20 64 61 74 61 20 before any data
299c0 69 73 20 0a 2a 2a 20 77 72 69 74 74 65 6e 20 6f is .** written o
299d0 75 74 2e 0a 2a 2a 0a 2a 2a 20 4f 6e 63 65 20 74 ut..**.** Once t
299e0 68 65 20 6c 6f 63 6b 20 68 61 73 20 62 65 65 6e he lock has been
299f0 20 75 70 67 72 61 64 65 64 20 61 6e 64 2c 20 69 upgraded and, i
29a00 66 20 6e 65 63 65 73 73 61 72 79 2c 20 74 68 65 f necessary, the
29a10 20 66 69 6c 65 20 6f 70 65 6e 65 64 2c 0a 2a 2a file opened,.**
29a20 20 74 68 65 20 70 61 67 65 73 20 61 72 65 20 77 the pages are w
29a30 72 69 74 74 65 6e 20 6f 75 74 20 74 6f 20 74 68 ritten out to th
29a40 65 20 64 61 74 61 62 61 73 65 20 66 69 6c 65 20 e database file
29a50 69 6e 20 6c 69 73 74 20 6f 72 64 65 72 2e 20 57 in list order. W
29a60 72 69 74 69 6e 67 0a 2a 2a 20 61 20 70 61 67 65 riting.** a page
29a70 20 69 73 20 73 6b 69 70 70 65 64 20 69 66 20 69 is skipped if i
29a80 74 20 6d 65 65 74 73 20 65 69 74 68 65 72 20 6f t meets either o
29a90 66 20 74 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 f the following
29aa0 63 72 69 74 65 72 69 61 3a 0a 2a 2a 0a 2a 2a 20 criteria:.**.**
29ab0 20 20 2a 20 54 68 65 20 70 61 67 65 20 6e 75 6d * The page num
29ac0 62 65 72 20 69 73 20 67 72 65 61 74 65 72 20 74 ber is greater t
29ad0 68 61 6e 20 50 61 67 65 72 2e 64 62 53 69 7a 65 han Pager.dbSize
29ae0 2c 20 6f 72 0a 2a 2a 20 20 20 2a 20 54 68 65 20 , or.** * The
29af0 50 47 48 44 52 5f 44 4f 4e 54 5f 57 52 49 54 45 PGHDR_DONT_WRITE
29b00 20 66 6c 61 67 20 69 73 20 73 65 74 20 6f 6e 20 flag is set on
29b10 74 68 65 20 70 61 67 65 2e 0a 2a 2a 0a 2a 2a 20 the page..**.**
29b20 49 66 20 77 72 69 74 69 6e 67 20 6f 75 74 20 61 If writing out a
29b30 20 70 61 67 65 20 63 61 75 73 65 73 20 74 68 65 page causes the
29b40 20 64 61 74 61 62 61 73 65 20 66 69 6c 65 20 74 database file t
29b50 6f 20 67 72 6f 77 2c 20 50 61 67 65 72 2e 64 62 o grow, Pager.db
29b60 46 69 6c 65 53 69 7a 65 0a 2a 2a 20 69 73 20 75 FileSize.** is u
29b70 70 64 61 74 65 64 20 61 63 63 6f 72 64 69 6e 67 pdated according
29b80 6c 79 2e 20 49 66 20 70 61 67 65 20 31 20 69 73 ly. If page 1 is
29b90 20 77 72 69 74 74 65 6e 20 6f 75 74 2c 20 74 68 written out, th
29ba0 65 6e 20 74 68 65 20 76 61 6c 75 65 20 63 61 63 en the value cac
29bb0 68 65 64 0a 2a 2a 20 69 6e 20 50 61 67 65 72 2e hed.** in Pager.
29bc0 64 62 46 69 6c 65 56 65 72 73 5b 5d 20 69 73 20 dbFileVers[] is
29bd0 75 70 64 61 74 65 64 20 74 6f 20 6d 61 74 63 68 updated to match
29be0 20 74 68 65 20 6e 65 77 20 76 61 6c 75 65 20 73 the new value s
29bf0 74 6f 72 65 64 20 69 6e 0a 2a 2a 20 74 68 65 20 tored in.** the
29c00 64 61 74 61 62 61 73 65 20 66 69 6c 65 2e 0a 2a database file..*
29c10 2a 0a 2a 2a 20 49 66 20 65 76 65 72 79 74 68 69 *.** If everythi
29c20 6e 67 20 69 73 20 73 75 63 63 65 73 73 66 75 6c ng is successful
29c30 2c 20 53 51 4c 49 54 45 5f 4f 4b 20 69 73 20 72 , SQLITE_OK is r
29c40 65 74 75 72 6e 65 64 2e 20 49 66 20 61 6e 20 49 eturned. If an I
29c50 4f 20 65 72 72 6f 72 20 0a 2a 2a 20 6f 63 63 75 O error .** occu
29c60 72 73 2c 20 61 6e 20 49 4f 20 65 72 72 6f 72 20 rs, an IO error
29c70 63 6f 64 65 20 69 73 20 72 65 74 75 72 6e 65 64 code is returned
29c80 2e 20 4f 72 2c 20 69 66 20 74 68 65 20 45 58 43 . Or, if the EXC
29c90 4c 55 53 49 56 45 20 6c 6f 63 6b 20 63 61 6e 6e LUSIVE lock cann
29ca0 6f 74 0a 2a 2a 20 62 65 20 6f 62 74 61 69 6e 65 ot.** be obtaine
29cb0 64 2c 20 53 51 4c 49 54 45 5f 42 55 53 59 20 69 d, SQLITE_BUSY i
29cc0 73 20 72 65 74 75 72 6e 65 64 2e 0a 2a 2f 0a 73 s returned..*/.s
29cd0 74 61 74 69 63 20 69 6e 74 20 70 61 67 65 72 5f tatic int pager_
29ce0 77 72 69 74 65 5f 70 61 67 65 6c 69 73 74 28 50 write_pagelist(P
29cf0 61 67 65 72 20 2a 70 50 61 67 65 72 2c 20 50 67 ager *pPager, Pg
29d00 48 64 72 20 2a 70 4c 69 73 74 29 7b 0a 20 20 69 Hdr *pList){. i
29d10 6e 74 20 72 63 20 3d 20 53 51 4c 49 54 45 5f 4f nt rc = SQLITE_O
29d20 4b 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 K;
29d30 20 20 20 20 2f 2a 20 52 65 74 75 72 6e 20 63 6f /* Return co
29d40 64 65 20 2a 2f 0a 0a 20 20 2f 2a 20 54 68 69 73 de */.. /* This
29d50 20 66 75 6e 63 74 69 6f 6e 20 69 73 20 6f 6e 6c function is onl
29d60 79 20 63 61 6c 6c 65 64 20 66 6f 72 20 72 6f 6c y called for rol
29d70 6c 62 61 63 6b 20 70 61 67 65 72 73 20 69 6e 20 lback pagers in
29d80 57 52 49 54 45 52 5f 44 42 4d 4f 44 20 73 74 61 WRITER_DBMOD sta
29d90 74 65 2e 20 2a 2f 0a 20 20 61 73 73 65 72 74 28 te. */. assert(
29da0 20 21 70 61 67 65 72 55 73 65 57 61 6c 28 70 50 !pagerUseWal(pP
29db0 61 67 65 72 29 20 29 3b 0a 20 20 61 73 73 65 72 ager) );. asser
29dc0 74 28 20 70 50 61 67 65 72 2d 3e 74 65 6d 70 46 t( pPager->tempF
29dd0 69 6c 65 20 7c 7c 20 70 50 61 67 65 72 2d 3e 65 ile || pPager->e
29de0 53 74 61 74 65 3d 3d 50 41 47 45 52 5f 57 52 49 State==PAGER_WRI
29df0 54 45 52 5f 44 42 4d 4f 44 20 29 3b 0a 20 20 61 TER_DBMOD );. a
29e00 73 73 65 72 74 28 20 70 50 61 67 65 72 2d 3e 65 ssert( pPager->e
29e10 4c 6f 63 6b 3d 3d 45 58 43 4c 55 53 49 56 45 5f Lock==EXCLUSIVE_
29e20 4c 4f 43 4b 20 29 3b 0a 20 20 61 73 73 65 72 74 LOCK );. assert
29e30 28 20 69 73 4f 70 65 6e 28 70 50 61 67 65 72 2d ( isOpen(pPager-
29e40 3e 66 64 29 20 7c 7c 20 70 4c 69 73 74 2d 3e 70 >fd) || pList->p
29e50 44 69 72 74 79 3d 3d 30 20 29 3b 0a 0a 20 20 2f Dirty==0 );.. /
29e60 2a 20 49 66 20 74 68 65 20 66 69 6c 65 20 69 73 * If the file is
29e70 20 61 20 74 65 6d 70 2d 66 69 6c 65 20 68 61 73 a temp-file has
29e80 20 6e 6f 74 20 79 65 74 20 62 65 65 6e 20 6f 70 not yet been op
29e90 65 6e 65 64 2c 20 6f 70 65 6e 20 69 74 20 6e 6f ened, open it no
29ea0 77 2e 20 49 74 0a 20 20 2a 2a 20 69 73 20 6e 6f w. It. ** is no
29eb0 74 20 70 6f 73 73 69 62 6c 65 20 66 6f 72 20 72 t possible for r
29ec0 63 20 74 6f 20 62 65 20 6f 74 68 65 72 20 74 68 c to be other th
29ed0 61 6e 20 53 51 4c 49 54 45 5f 4f 4b 20 69 66 20 an SQLITE_OK if
29ee0 74 68 69 73 20 62 72 61 6e 63 68 0a 20 20 2a 2a this branch. **
29ef0 20 69 73 20 74 61 6b 65 6e 2c 20 61 73 20 70 61 is taken, as pa
29f00 67 65 72 5f 77 61 69 74 5f 6f 6e 5f 6c 6f 63 6b ger_wait_on_lock
29f10 28 29 20 69 73 20 61 20 6e 6f 2d 6f 70 20 66 6f () is a no-op fo
29f20 72 20 74 65 6d 70 2d 66 69 6c 65 73 2e 0a 20 20 r temp-files..
29f30 2a 2f 0a 20 20 69 66 28 20 21 69 73 4f 70 65 6e */. if( !isOpen
29f40 28 70 50 61 67 65 72 2d 3e 66 64 29 20 29 7b 0a (pPager->fd) ){.
29f50 20 20 20 20 61 73 73 65 72 74 28 20 70 50 61 67 assert( pPag
29f60 65 72 2d 3e 74 65 6d 70 46 69 6c 65 20 26 26 20 er->tempFile &&
29f70 72 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 3b rc==SQLITE_OK );
29f80 0a 20 20 20 20 72 63 20 3d 20 70 61 67 65 72 4f . rc = pagerO
29f90 70 65 6e 74 65 6d 70 28 70 50 61 67 65 72 2c 20 pentemp(pPager,
29fa0 70 50 61 67 65 72 2d 3e 66 64 2c 20 70 50 61 67 pPager->fd, pPag
29fb0 65 72 2d 3e 76 66 73 46 6c 61 67 73 29 3b 0a 20 er->vfsFlags);.
29fc0 20 7d 0a 0a 20 20 2f 2a 20 42 65 66 6f 72 65 20 }.. /* Before
29fd0 74 68 65 20 66 69 72 73 74 20 77 72 69 74 65 2c the first write,
29fe0 20 67 69 76 65 20 74 68 65 20 56 46 53 20 61 20 give the VFS a
29ff0 68 69 6e 74 20 6f 66 20 77 68 61 74 20 74 68 65 hint of what the
2a000 20 66 69 6e 61 6c 0a 20 20 2a 2a 20 66 69 6c 65 final. ** file
2a010 20 73 69 7a 65 20 77 69 6c 6c 20 62 65 2e 0a 20 size will be..
2a020 20 2a 2f 0a 20 20 61 73 73 65 72 74 28 20 72 63 */. assert( rc
2a030 21 3d 53 51 4c 49 54 45 5f 4f 4b 20 7c 7c 20 69 !=SQLITE_OK || i
2a040 73 4f 70 65 6e 28 70 50 61 67 65 72 2d 3e 66 64 sOpen(pPager->fd
2a050 29 20 29 3b 0a 20 20 69 66 28 20 72 63 3d 3d 53 ) );. if( rc==S
2a060 51 4c 49 54 45 5f 4f 4b 20 0a 20 20 20 26 26 20 QLITE_OK . &&
2a070 70 50 61 67 65 72 2d 3e 64 62 48 69 6e 74 53 69 pPager->dbHintSi
2a080 7a 65 3c 70 50 61 67 65 72 2d 3e 64 62 53 69 7a ze<pPager->dbSiz
2a090 65 0a 20 20 20 26 26 20 28 70 4c 69 73 74 2d 3e e. && (pList->
2a0a0 70 44 69 72 74 79 20 7c 7c 20 70 4c 69 73 74 2d pDirty || pList-
2a0b0 3e 70 67 6e 6f 3e 70 50 61 67 65 72 2d 3e 64 62 >pgno>pPager->db
2a0c0 48 69 6e 74 53 69 7a 65 29 0a 20 20 29 7b 0a 20 HintSize). ){.
2a0d0 20 20 20 73 71 6c 69 74 65 33 5f 69 6e 74 36 34 sqlite3_int64
2a0e0 20 73 7a 46 69 6c 65 20 3d 20 70 50 61 67 65 72 szFile = pPager
2a0f0 2d 3e 70 61 67 65 53 69 7a 65 20 2a 20 28 73 71 ->pageSize * (sq
2a100 6c 69 74 65 33 5f 69 6e 74 36 34 29 70 50 61 67 lite3_int64)pPag
2a110 65 72 2d 3e 64 62 53 69 7a 65 3b 0a 20 20 20 20 er->dbSize;.
2a120 73 71 6c 69 74 65 33 4f 73 46 69 6c 65 43 6f 6e sqlite3OsFileCon
2a130 74 72 6f 6c 48 69 6e 74 28 70 50 61 67 65 72 2d trolHint(pPager-
2a140 3e 66 64 2c 20 53 51 4c 49 54 45 5f 46 43 4e 54 >fd, SQLITE_FCNT
2a150 4c 5f 53 49 5a 45 5f 48 49 4e 54 2c 20 26 73 7a L_SIZE_HINT, &sz
2a160 46 69 6c 65 29 3b 0a 20 20 20 20 70 50 61 67 65 File);. pPage
2a170 72 2d 3e 64 62 48 69 6e 74 53 69 7a 65 20 3d 20 r->dbHintSize =
2a180 70 50 61 67 65 72 2d 3e 64 62 53 69 7a 65 3b 0a pPager->dbSize;.
2a190 20 20 7d 0a 0a 20 20 77 68 69 6c 65 28 20 72 63 }.. while( rc
2a1a0 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 26 26 20 70 ==SQLITE_OK && p
2a1b0 4c 69 73 74 20 29 7b 0a 20 20 20 20 50 67 6e 6f List ){. Pgno
2a1c0 20 70 67 6e 6f 20 3d 20 70 4c 69 73 74 2d 3e 70 pgno = pList->p
2a1d0 67 6e 6f 3b 0a 0a 20 20 20 20 2f 2a 20 49 66 20 gno;.. /* If
2a1e0 74 68 65 72 65 20 61 72 65 20 64 69 72 74 79 20 there are dirty
2a1f0 70 61 67 65 73 20 69 6e 20 74 68 65 20 70 61 67 pages in the pag
2a200 65 20 63 61 63 68 65 20 77 69 74 68 20 70 61 67 e cache with pag
2a210 65 20 6e 75 6d 62 65 72 73 20 67 72 65 61 74 65 e numbers greate
2a220 72 0a 20 20 20 20 2a 2a 20 74 68 61 6e 20 50 61 r. ** than Pa
2a230 67 65 72 2e 64 62 53 69 7a 65 2c 20 74 68 69 73 ger.dbSize, this
2a240 20 6d 65 61 6e 73 20 73 71 6c 69 74 65 33 50 61 means sqlite3Pa
2a250 67 65 72 54 72 75 6e 63 61 74 65 49 6d 61 67 65 gerTruncateImage
2a260 28 29 20 77 61 73 20 63 61 6c 6c 65 64 20 74 6f () was called to
2a270 0a 20 20 20 20 2a 2a 20 6d 61 6b 65 20 74 68 65 . ** make the
2a280 20 66 69 6c 65 20 73 6d 61 6c 6c 65 72 20 28 70 file smaller (p
2a290 72 65 73 75 6d 61 62 6c 79 20 62 79 20 61 75 74 resumably by aut
2a2a0 6f 2d 76 61 63 75 75 6d 20 63 6f 64 65 29 2e 20 o-vacuum code).
2a2b0 44 6f 20 6e 6f 74 20 77 72 69 74 65 0a 20 20 20 Do not write.
2a2c0 20 2a 2a 20 61 6e 79 20 73 75 63 68 20 70 61 67 ** any such pag
2a2d0 65 73 20 74 6f 20 74 68 65 20 66 69 6c 65 2e 0a es to the file..
2a2e0 20 20 20 20 2a 2a 0a 20 20 20 20 2a 2a 20 41 6c **. ** Al
2a2f0 73 6f 2c 20 64 6f 20 6e 6f 74 20 77 72 69 74 65 so, do not write
2a300 20 6f 75 74 20 61 6e 79 20 70 61 67 65 20 74 68 out any page th
2a310 61 74 20 68 61 73 20 74 68 65 20 50 47 48 44 52 at has the PGHDR
2a320 5f 44 4f 4e 54 5f 57 52 49 54 45 20 66 6c 61 67 _DONT_WRITE flag
2a330 0a 20 20 20 20 2a 2a 20 73 65 74 20 28 73 65 74 . ** set (set
2a340 20 62 79 20 73 71 6c 69 74 65 33 50 61 67 65 72 by sqlite3Pager
2a350 44 6f 6e 74 57 72 69 74 65 28 29 29 2e 0a 20 20 DontWrite())..
2a360 20 20 2a 2f 0a 20 20 20 20 69 66 28 20 70 67 6e */. if( pgn
2a370 6f 3c 3d 70 50 61 67 65 72 2d 3e 64 62 53 69 7a o<=pPager->dbSiz
2a380 65 20 26 26 20 30 3d 3d 28 70 4c 69 73 74 2d 3e e && 0==(pList->
2a390 66 6c 61 67 73 26 50 47 48 44 52 5f 44 4f 4e 54 flags&PGHDR_DONT
2a3a0 5f 57 52 49 54 45 29 20 29 7b 0a 20 20 20 20 20 _WRITE) ){.
2a3b0 20 69 36 34 20 6f 66 66 73 65 74 20 3d 20 28 70 i64 offset = (p
2a3c0 67 6e 6f 2d 31 29 2a 28 69 36 34 29 70 50 61 67 gno-1)*(i64)pPag
2a3d0 65 72 2d 3e 70 61 67 65 53 69 7a 65 3b 20 20 20 er->pageSize;
2a3e0 2f 2a 20 4f 66 66 73 65 74 20 74 6f 20 77 72 69 /* Offset to wri
2a3f0 74 65 20 2a 2f 0a 20 20 20 20 20 20 63 68 61 72 te */. char
2a400 20 2a 70 44 61 74 61 3b 20 20 20 20 20 20 20 20 *pData;
2a410 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
2a420 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 44 61 /* Da
2a430 74 61 20 74 6f 20 77 72 69 74 65 20 2a 2f 20 20 ta to write */
2a440 20 20 0a 0a 20 20 20 20 20 20 61 73 73 65 72 74 .. assert
2a450 28 20 28 70 4c 69 73 74 2d 3e 66 6c 61 67 73 26 ( (pList->flags&
2a460 50 47 48 44 52 5f 4e 45 45 44 5f 53 59 4e 43 29 PGHDR_NEED_SYNC)
2a470 3d 3d 30 20 29 3b 0a 20 20 20 20 20 20 69 66 28 ==0 );. if(
2a480 20 70 4c 69 73 74 2d 3e 70 67 6e 6f 3d 3d 31 20 pList->pgno==1
2a490 29 20 70 61 67 65 72 5f 77 72 69 74 65 5f 63 68 ) pager_write_ch
2a4a0 61 6e 67 65 63 6f 75 6e 74 65 72 28 70 4c 69 73 angecounter(pLis
2a4b0 74 29 3b 0a 0a 20 20 20 20 20 20 2f 2a 20 45 6e t);.. /* En
2a4c0 63 6f 64 65 20 74 68 65 20 64 61 74 61 62 61 73 code the databas
2a4d0 65 20 2a 2f 0a 20 20 20 20 20 20 43 4f 44 45 43 e */. CODEC
2a4e0 32 28 70 50 61 67 65 72 2c 20 70 4c 69 73 74 2d 2(pPager, pList-
2a4f0 3e 70 44 61 74 61 2c 20 70 67 6e 6f 2c 20 36 2c >pData, pgno, 6,
2a500 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4e return SQLITE_N
2a510 4f 4d 45 4d 5f 42 4b 50 54 2c 20 70 44 61 74 61 OMEM_BKPT, pData
2a520 29 3b 0a 0a 20 20 20 20 20 20 2f 2a 20 57 72 69 );.. /* Wri
2a530 74 65 20 6f 75 74 20 74 68 65 20 70 61 67 65 20 te out the page
2a540 64 61 74 61 2e 20 2a 2f 0a 20 20 20 20 20 20 72 data. */. r
2a550 63 20 3d 20 73 71 6c 69 74 65 33 4f 73 57 72 69 c = sqlite3OsWri
2a560 74 65 28 70 50 61 67 65 72 2d 3e 66 64 2c 20 70 te(pPager->fd, p
2a570 44 61 74 61 2c 20 70 50 61 67 65 72 2d 3e 70 61 Data, pPager->pa
2a580 67 65 53 69 7a 65 2c 20 6f 66 66 73 65 74 29 3b geSize, offset);
2a590 0a 0a 20 20 20 20 20 20 2f 2a 20 49 66 20 70 61 .. /* If pa
2a5a0 67 65 20 31 20 77 61 73 20 6a 75 73 74 20 77 72 ge 1 was just wr
2a5b0 69 74 74 65 6e 2c 20 75 70 64 61 74 65 20 50 61 itten, update Pa
2a5c0 67 65 72 2e 64 62 46 69 6c 65 56 65 72 73 20 74 ger.dbFileVers t
2a5d0 6f 20 6d 61 74 63 68 0a 20 20 20 20 20 20 2a 2a o match. **
2a5e0 20 74 68 65 20 76 61 6c 75 65 20 6e 6f 77 20 73 the value now s
2a5f0 74 6f 72 65 64 20 69 6e 20 74 68 65 20 64 61 74 tored in the dat
2a600 61 62 61 73 65 20 66 69 6c 65 2e 20 49 66 20 77 abase file. If w
2a610 72 69 74 69 6e 67 20 74 68 69 73 20 0a 20 20 20 riting this .
2a620 20 20 20 2a 2a 20 70 61 67 65 20 63 61 75 73 65 ** page cause
2a630 64 20 74 68 65 20 64 61 74 61 62 61 73 65 20 66 d the database f
2a640 69 6c 65 20 74 6f 20 67 72 6f 77 2c 20 75 70 64 ile to grow, upd
2a650 61 74 65 20 64 62 46 69 6c 65 53 69 7a 65 2e 20 ate dbFileSize.
2a660 0a 20 20 20 20 20 20 2a 2f 0a 20 20 20 20 20 20 . */.
2a670 69 66 28 20 70 67 6e 6f 3d 3d 31 20 29 7b 0a 20 if( pgno==1 ){.
2a680 20 20 20 20 20 20 20 6d 65 6d 63 70 79 28 26 70 memcpy(&p
2a690 50 61 67 65 72 2d 3e 64 62 46 69 6c 65 56 65 72 Pager->dbFileVer
2a6a0 73 2c 20 26 70 44 61 74 61 5b 32 34 5d 2c 20 73 s, &pData[24], s
2a6b0 69 7a 65 6f 66 28 70 50 61 67 65 72 2d 3e 64 62 izeof(pPager->db
2a6c0 46 69 6c 65 56 65 72 73 29 29 3b 0a 20 20 20 20 FileVers));.
2a6d0 20 20 7d 0a 20 20 20 20 20 20 69 66 28 20 70 67 }. if( pg
2a6e0 6e 6f 3e 70 50 61 67 65 72 2d 3e 64 62 46 69 6c no>pPager->dbFil
2a6f0 65 53 69 7a 65 20 29 7b 0a 20 20 20 20 20 20 20 eSize ){.
2a700 20 70 50 61 67 65 72 2d 3e 64 62 46 69 6c 65 53 pPager->dbFileS
2a710 69 7a 65 20 3d 20 70 67 6e 6f 3b 0a 20 20 20 20 ize = pgno;.
2a720 20 20 7d 0a 20 20 20 20 20 20 70 50 61 67 65 72 }. pPager
2a730 2d 3e 61 53 74 61 74 5b 50 41 47 45 52 5f 53 54 ->aStat[PAGER_ST
2a740 41 54 5f 57 52 49 54 45 5d 2b 2b 3b 0a 0a 20 20 AT_WRITE]++;..
2a750 20 20 20 20 2f 2a 20 55 70 64 61 74 65 20 61 6e /* Update an
2a760 79 20 62 61 63 6b 75 70 20 6f 62 6a 65 63 74 73 y backup objects
2a770 20 63 6f 70 79 69 6e 67 20 74 68 65 20 63 6f 6e copying the con
2a780 74 65 6e 74 73 20 6f 66 20 74 68 69 73 20 70 61 tents of this pa
2a790 67 65 72 2e 20 2a 2f 0a 20 20 20 20 20 20 73 71 ger. */. sq
2a7a0 6c 69 74 65 33 42 61 63 6b 75 70 55 70 64 61 74 lite3BackupUpdat
2a7b0 65 28 70 50 61 67 65 72 2d 3e 70 42 61 63 6b 75 e(pPager->pBacku
2a7c0 70 2c 20 70 67 6e 6f 2c 20 28 75 38 2a 29 70 4c p, pgno, (u8*)pL
2a7d0 69 73 74 2d 3e 70 44 61 74 61 29 3b 0a 0a 20 20 ist->pData);..
2a7e0 20 20 20 20 50 41 47 45 52 54 52 41 43 45 28 28 PAGERTRACE((
2a7f0 22 53 54 4f 52 45 20 25 64 20 70 61 67 65 20 25 "STORE %d page %
2a800 64 20 68 61 73 68 28 25 30 38 78 29 5c 6e 22 2c d hash(%08x)\n",
2a810 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 .
2a820 20 20 20 20 50 41 47 45 52 49 44 28 70 50 61 67 PAGERID(pPag
2a830 65 72 29 2c 20 70 67 6e 6f 2c 20 70 61 67 65 72 er), pgno, pager
2a840 5f 70 61 67 65 68 61 73 68 28 70 4c 69 73 74 29 _pagehash(pList)
2a850 29 29 3b 0a 20 20 20 20 20 20 49 4f 54 52 41 43 ));. IOTRAC
2a860 45 28 28 22 50 47 4f 55 54 20 25 70 20 25 64 5c E(("PGOUT %p %d\
2a870 6e 22 2c 20 70 50 61 67 65 72 2c 20 70 67 6e 6f n", pPager, pgno
2a880 29 29 3b 0a 20 20 20 20 20 20 50 41 47 45 52 5f ));. PAGER_
2a890 49 4e 43 52 28 73 71 6c 69 74 65 33 5f 70 61 67 INCR(sqlite3_pag
2a8a0 65 72 5f 77 72 69 74 65 64 62 5f 63 6f 75 6e 74 er_writedb_count
2a8b0 29 3b 0a 20 20 20 20 7d 65 6c 73 65 7b 0a 20 20 );. }else{.
2a8c0 20 20 20 20 50 41 47 45 52 54 52 41 43 45 28 28 PAGERTRACE((
2a8d0 22 4e 4f 53 54 4f 52 45 20 25 64 20 70 61 67 65 "NOSTORE %d page
2a8e0 20 25 64 5c 6e 22 2c 20 50 41 47 45 52 49 44 28 %d\n", PAGERID(
2a8f0 70 50 61 67 65 72 29 2c 20 70 67 6e 6f 29 29 3b pPager), pgno));
2a900 0a 20 20 20 20 7d 0a 20 20 20 20 70 61 67 65 72 . }. pager
2a910 5f 73 65 74 5f 70 61 67 65 68 61 73 68 28 70 4c _set_pagehash(pL
2a920 69 73 74 29 3b 0a 20 20 20 20 70 4c 69 73 74 20 ist);. pList
2a930 3d 20 70 4c 69 73 74 2d 3e 70 44 69 72 74 79 3b = pList->pDirty;
2a940 0a 20 20 7d 0a 0a 20 20 72 65 74 75 72 6e 20 72 . }.. return r
2a950 63 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 45 6e 73 75 c;.}../*.** Ensu
2a960 72 65 20 74 68 61 74 20 74 68 65 20 73 75 62 2d re that the sub-
2a970 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 20 69 73 20 journal file is
2a980 6f 70 65 6e 2e 20 49 66 20 69 74 20 69 73 20 61 open. If it is a
2a990 6c 72 65 61 64 79 20 6f 70 65 6e 2c 20 74 68 69 lready open, thi
2a9a0 73 20 0a 2a 2a 20 66 75 6e 63 74 69 6f 6e 20 69 s .** function i
2a9b0 73 20 61 20 6e 6f 2d 6f 70 2e 0a 2a 2a 0a 2a 2a s a no-op..**.**
2a9c0 20 53 51 4c 49 54 45 5f 4f 4b 20 69 73 20 72 65 SQLITE_OK is re
2a9d0 74 75 72 6e 65 64 20 69 66 20 65 76 65 72 79 74 turned if everyt
2a9e0 68 69 6e 67 20 67 6f 65 73 20 61 63 63 6f 72 64 hing goes accord
2a9f0 69 6e 67 20 74 6f 20 70 6c 61 6e 2e 20 41 6e 20 ing to plan. An
2aa00 0a 2a 2a 20 53 51 4c 49 54 45 5f 49 4f 45 52 52 .** SQLITE_IOERR
2aa10 5f 58 58 58 20 65 72 72 6f 72 20 63 6f 64 65 20 _XXX error code
2aa20 69 73 20 72 65 74 75 72 6e 65 64 20 69 66 20 61 is returned if a
2aa30 20 63 61 6c 6c 20 74 6f 20 73 71 6c 69 74 65 33 call to sqlite3
2aa40 4f 73 4f 70 65 6e 28 29 20 0a 2a 2a 20 66 61 69 OsOpen() .** fai
2aa50 6c 73 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e ls..*/.static in
2aa60 74 20 6f 70 65 6e 53 75 62 4a 6f 75 72 6e 61 6c t openSubJournal
2aa70 28 50 61 67 65 72 20 2a 70 50 61 67 65 72 29 7b (Pager *pPager){
2aa80 0a 20 20 69 6e 74 20 72 63 20 3d 20 53 51 4c 49 . int rc = SQLI
2aa90 54 45 5f 4f 4b 3b 0a 20 20 69 66 28 20 21 69 73 TE_OK;. if( !is
2aaa0 4f 70 65 6e 28 70 50 61 67 65 72 2d 3e 73 6a 66 Open(pPager->sjf
2aab0 64 29 20 29 7b 0a 20 20 20 20 63 6f 6e 73 74 20 d) ){. const
2aac0 69 6e 74 20 66 6c 61 67 73 20 3d 20 20 53 51 4c int flags = SQL
2aad0 49 54 45 5f 4f 50 45 4e 5f 53 55 42 4a 4f 55 52 ITE_OPEN_SUBJOUR
2aae0 4e 41 4c 20 7c 20 53 51 4c 49 54 45 5f 4f 50 45 NAL | SQLITE_OPE
2aaf0 4e 5f 52 45 41 44 57 52 49 54 45 20 0a 20 20 20 N_READWRITE .
2ab00 20 20 20 7c 20 53 51 4c 49 54 45 5f 4f 50 45 4e | SQLITE_OPEN
2ab10 5f 43 52 45 41 54 45 20 7c 20 53 51 4c 49 54 45 _CREATE | SQLITE
2ab20 5f 4f 50 45 4e 5f 45 58 43 4c 55 53 49 56 45 20 _OPEN_EXCLUSIVE
2ab30 0a 20 20 20 20 20 20 7c 20 53 51 4c 49 54 45 5f . | SQLITE_
2ab40 4f 50 45 4e 5f 44 45 4c 45 54 45 4f 4e 43 4c 4f OPEN_DELETEONCLO
2ab50 53 45 3b 0a 20 20 20 20 69 6e 74 20 6e 53 74 6d SE;. int nStm
2ab60 74 53 70 69 6c 6c 20 3d 20 73 71 6c 69 74 65 33 tSpill = sqlite3
2ab70 43 6f 6e 66 69 67 2e 6e 53 74 6d 74 53 70 69 6c Config.nStmtSpil
2ab80 6c 3b 0a 20 20 20 20 69 66 28 20 70 50 61 67 65 l;. if( pPage
2ab90 72 2d 3e 6a 6f 75 72 6e 61 6c 4d 6f 64 65 3d 3d r->journalMode==
2aba0 50 41 47 45 52 5f 4a 4f 55 52 4e 41 4c 4d 4f 44 PAGER_JOURNALMOD
2abb0 45 5f 4d 45 4d 4f 52 59 20 7c 7c 20 70 50 61 67 E_MEMORY || pPag
2abc0 65 72 2d 3e 73 75 62 6a 49 6e 4d 65 6d 6f 72 79 er->subjInMemory
2abd0 20 29 7b 0a 20 20 20 20 20 20 6e 53 74 6d 74 53 ){. nStmtS
2abe0 70 69 6c 6c 20 3d 20 2d 31 3b 0a 20 20 20 20 7d pill = -1;. }
2abf0 0a 20 20 20 20 72 63 20 3d 20 73 71 6c 69 74 65 . rc = sqlite
2ac00 33 4a 6f 75 72 6e 61 6c 4f 70 65 6e 28 70 50 61 3JournalOpen(pPa
2ac10 67 65 72 2d 3e 70 56 66 73 2c 20 30 2c 20 70 50 ger->pVfs, 0, pP
2ac20 61 67 65 72 2d 3e 73 6a 66 64 2c 20 66 6c 61 67 ager->sjfd, flag
2ac30 73 2c 20 6e 53 74 6d 74 53 70 69 6c 6c 29 3b 0a s, nStmtSpill);.
2ac40 20 20 7d 0a 20 20 72 65 74 75 72 6e 20 72 63 3b }. return rc;
2ac50 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 41 70 70 65 6e 64 .}../*.** Append
2ac60 20 61 20 72 65 63 6f 72 64 20 6f 66 20 74 68 65 a record of the
2ac70 20 63 75 72 72 65 6e 74 20 73 74 61 74 65 20 6f current state o
2ac80 66 20 70 61 67 65 20 70 50 67 20 74 6f 20 74 68 f page pPg to th
2ac90 65 20 73 75 62 2d 6a 6f 75 72 6e 61 6c 2e 20 0a e sub-journal. .
2aca0 2a 2a 0a 2a 2a 20 49 66 20 73 75 63 63 65 73 73 **.** If success
2acb0 66 75 6c 2c 20 73 65 74 20 74 68 65 20 62 69 74 ful, set the bit
2acc0 20 63 6f 72 72 65 73 70 6f 6e 64 69 6e 67 20 74 corresponding t
2acd0 6f 20 70 50 67 2d 3e 70 67 6e 6f 20 69 6e 20 74 o pPg->pgno in t
2ace0 68 65 20 62 69 74 76 65 63 73 0a 2a 2a 20 66 6f he bitvecs.** fo
2acf0 72 20 61 6c 6c 20 6f 70 65 6e 20 73 61 76 65 70 r all open savep
2ad00 6f 69 6e 74 73 20 62 65 66 6f 72 65 20 72 65 74 oints before ret
2ad10 75 72 6e 69 6e 67 2e 0a 2a 2a 0a 2a 2a 20 54 68 urning..**.** Th
2ad20 69 73 20 66 75 6e 63 74 69 6f 6e 20 72 65 74 75 is function retu
2ad30 72 6e 73 20 53 51 4c 49 54 45 5f 4f 4b 20 69 66 rns SQLITE_OK if
2ad40 20 65 76 65 72 79 74 68 69 6e 67 20 69 73 20 73 everything is s
2ad50 75 63 63 65 73 73 66 75 6c 2c 20 61 6e 20 49 4f uccessful, an IO
2ad60 0a 2a 2a 20 65 72 72 6f 72 20 63 6f 64 65 20 69 .** error code i
2ad70 66 20 74 68 65 20 61 74 74 65 6d 70 74 20 74 6f f the attempt to
2ad80 20 77 72 69 74 65 20 74 6f 20 74 68 65 20 73 75 write to the su
2ad90 62 2d 6a 6f 75 72 6e 61 6c 20 66 61 69 6c 73 2c b-journal fails,
2ada0 20 6f 72 20 0a 2a 2a 20 53 51 4c 49 54 45 5f 4e or .** SQLITE_N
2adb0 4f 4d 45 4d 20 69 66 20 61 20 6d 61 6c 6c 6f 63 OMEM if a malloc
2adc0 20 66 61 69 6c 73 20 77 68 69 6c 65 20 73 65 74 fails while set
2add0 74 69 6e 67 20 61 20 62 69 74 20 69 6e 20 61 20 ting a bit in a
2ade0 73 61 76 65 70 6f 69 6e 74 0a 2a 2a 20 62 69 74 savepoint.** bit
2adf0 76 65 63 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 69 vec..*/.static i
2ae00 6e 74 20 73 75 62 6a 6f 75 72 6e 61 6c 50 61 67 nt subjournalPag
2ae10 65 28 50 67 48 64 72 20 2a 70 50 67 29 7b 0a 20 e(PgHdr *pPg){.
2ae20 20 69 6e 74 20 72 63 20 3d 20 53 51 4c 49 54 45 int rc = SQLITE
2ae30 5f 4f 4b 3b 0a 20 20 50 61 67 65 72 20 2a 70 50 _OK;. Pager *pP
2ae40 61 67 65 72 20 3d 20 70 50 67 2d 3e 70 50 61 67 ager = pPg->pPag
2ae50 65 72 3b 0a 20 20 69 66 28 20 70 50 61 67 65 72 er;. if( pPager
2ae60 2d 3e 6a 6f 75 72 6e 61 6c 4d 6f 64 65 21 3d 50 ->journalMode!=P
2ae70 41 47 45 52 5f 4a 4f 55 52 4e 41 4c 4d 4f 44 45 AGER_JOURNALMODE
2ae80 5f 4f 46 46 20 29 7b 0a 0a 20 20 20 20 2f 2a 20 _OFF ){.. /*
2ae90 4f 70 65 6e 20 74 68 65 20 73 75 62 2d 6a 6f 75 Open the sub-jou
2aea0 72 6e 61 6c 2c 20 69 66 20 69 74 20 68 61 73 20 rnal, if it has
2aeb0 6e 6f 74 20 61 6c 72 65 61 64 79 20 62 65 65 6e not already been
2aec0 20 6f 70 65 6e 65 64 20 2a 2f 0a 20 20 20 20 61 opened */. a
2aed0 73 73 65 72 74 28 20 70 50 61 67 65 72 2d 3e 75 ssert( pPager->u
2aee0 73 65 4a 6f 75 72 6e 61 6c 20 29 3b 0a 20 20 20 seJournal );.
2aef0 20 61 73 73 65 72 74 28 20 69 73 4f 70 65 6e 28 assert( isOpen(
2af00 70 50 61 67 65 72 2d 3e 6a 66 64 29 20 7c 7c 20 pPager->jfd) ||
2af10 70 61 67 65 72 55 73 65 57 61 6c 28 70 50 61 67 pagerUseWal(pPag
2af20 65 72 29 20 29 3b 0a 20 20 20 20 61 73 73 65 72 er) );. asser
2af30 74 28 20 69 73 4f 70 65 6e 28 70 50 61 67 65 72 t( isOpen(pPager
2af40 2d 3e 73 6a 66 64 29 20 7c 7c 20 70 50 61 67 65 ->sjfd) || pPage
2af50 72 2d 3e 6e 53 75 62 52 65 63 3d 3d 30 20 29 3b r->nSubRec==0 );
2af60 0a 20 20 20 20 61 73 73 65 72 74 28 20 70 61 67 . assert( pag
2af70 65 72 55 73 65 57 61 6c 28 70 50 61 67 65 72 29 erUseWal(pPager)
2af80 20 0a 20 20 20 20 20 20 20 20 20 7c 7c 20 70 61 . || pa
2af90 67 65 49 6e 4a 6f 75 72 6e 61 6c 28 70 50 61 67 geInJournal(pPag
2afa0 65 72 2c 20 70 50 67 29 20 0a 20 20 20 20 20 20 er, pPg) .
2afb0 20 20 20 7c 7c 20 70 50 67 2d 3e 70 67 6e 6f 3e || pPg->pgno>
2afc0 70 50 61 67 65 72 2d 3e 64 62 4f 72 69 67 53 69 pPager->dbOrigSi
2afd0 7a 65 20 0a 20 20 20 20 29 3b 0a 20 20 20 20 72 ze . );. r
2afe0 63 20 3d 20 6f 70 65 6e 53 75 62 4a 6f 75 72 6e c = openSubJourn
2aff0 61 6c 28 70 50 61 67 65 72 29 3b 0a 0a 20 20 20 al(pPager);..
2b000 20 2f 2a 20 49 66 20 74 68 65 20 73 75 62 2d 6a /* If the sub-j
2b010 6f 75 72 6e 61 6c 20 77 61 73 20 6f 70 65 6e 65 ournal was opene
2b020 64 20 73 75 63 63 65 73 73 66 75 6c 6c 79 20 28 d successfully (
2b030 6f 72 20 77 61 73 20 61 6c 72 65 61 64 79 20 6f or was already o
2b040 70 65 6e 29 2c 0a 20 20 20 20 2a 2a 20 77 72 69 pen),. ** wri
2b050 74 65 20 74 68 65 20 6a 6f 75 72 6e 61 6c 20 72 te the journal r
2b060 65 63 6f 72 64 20 69 6e 74 6f 20 74 68 65 20 66 ecord into the f
2b070 69 6c 65 2e 20 20 2a 2f 0a 20 20 20 20 69 66 28 ile. */. if(
2b080 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 rc==SQLITE_OK )
2b090 7b 0a 20 20 20 20 20 20 76 6f 69 64 20 2a 70 44 {. void *pD
2b0a0 61 74 61 20 3d 20 70 50 67 2d 3e 70 44 61 74 61 ata = pPg->pData
2b0b0 3b 0a 20 20 20 20 20 20 69 36 34 20 6f 66 66 73 ;. i64 offs
2b0c0 65 74 20 3d 20 28 69 36 34 29 70 50 61 67 65 72 et = (i64)pPager
2b0d0 2d 3e 6e 53 75 62 52 65 63 2a 28 34 2b 70 50 61 ->nSubRec*(4+pPa
2b0e0 67 65 72 2d 3e 70 61 67 65 53 69 7a 65 29 3b 0a ger->pageSize);.
2b0f0 20 20 20 20 20 20 63 68 61 72 20 2a 70 44 61 74 char *pDat
2b100 61 32 3b 0a 20 20 0a 20 20 20 20 20 20 43 4f 44 a2;. . COD
2b110 45 43 32 28 70 50 61 67 65 72 2c 20 70 44 61 74 EC2(pPager, pDat
2b120 61 2c 20 70 50 67 2d 3e 70 67 6e 6f 2c 20 37 2c a, pPg->pgno, 7,
2b130 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4e return SQLITE_N
2b140 4f 4d 45 4d 5f 42 4b 50 54 2c 20 70 44 61 74 61 OMEM_BKPT, pData
2b150 32 29 3b 0a 20 20 20 20 20 20 50 41 47 45 52 54 2);. PAGERT
2b160 52 41 43 45 28 28 22 53 54 4d 54 2d 4a 4f 55 52 RACE(("STMT-JOUR
2b170 4e 41 4c 20 25 64 20 70 61 67 65 20 25 64 5c 6e NAL %d page %d\n
2b180 22 2c 20 50 41 47 45 52 49 44 28 70 50 61 67 65 ", PAGERID(pPage
2b190 72 29 2c 20 70 50 67 2d 3e 70 67 6e 6f 29 29 3b r), pPg->pgno));
2b1a0 0a 20 20 20 20 20 20 72 63 20 3d 20 77 72 69 74 . rc = writ
2b1b0 65 33 32 62 69 74 73 28 70 50 61 67 65 72 2d 3e e32bits(pPager->
2b1c0 73 6a 66 64 2c 20 6f 66 66 73 65 74 2c 20 70 50 sjfd, offset, pP
2b1d0 67 2d 3e 70 67 6e 6f 29 3b 0a 20 20 20 20 20 20 g->pgno);.
2b1e0 69 66 28 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4f if( rc==SQLITE_O
2b1f0 4b 20 29 7b 0a 20 20 20 20 20 20 20 20 72 63 20 K ){. rc
2b200 3d 20 73 71 6c 69 74 65 33 4f 73 57 72 69 74 65 = sqlite3OsWrite
2b210 28 70 50 61 67 65 72 2d 3e 73 6a 66 64 2c 20 70 (pPager->sjfd, p
2b220 44 61 74 61 32 2c 20 70 50 61 67 65 72 2d 3e 70 Data2, pPager->p
2b230 61 67 65 53 69 7a 65 2c 20 6f 66 66 73 65 74 2b ageSize, offset+
2b240 34 29 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 4);. }.
2b250 7d 0a 20 20 7d 0a 20 20 69 66 28 20 72 63 3d 3d }. }. if( rc==
2b260 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 SQLITE_OK ){.
2b270 20 70 50 61 67 65 72 2d 3e 6e 53 75 62 52 65 63 pPager->nSubRec
2b280 2b 2b 3b 0a 20 20 20 20 61 73 73 65 72 74 28 20 ++;. assert(
2b290 70 50 61 67 65 72 2d 3e 6e 53 61 76 65 70 6f 69 pPager->nSavepoi
2b2a0 6e 74 3e 30 20 29 3b 0a 20 20 20 20 72 63 20 3d nt>0 );. rc =
2b2b0 20 61 64 64 54 6f 53 61 76 65 70 6f 69 6e 74 42 addToSavepointB
2b2c0 69 74 76 65 63 73 28 70 50 61 67 65 72 2c 20 70 itvecs(pPager, p
2b2d0 50 67 2d 3e 70 67 6e 6f 29 3b 0a 20 20 7d 0a 20 Pg->pgno);. }.
2b2e0 20 72 65 74 75 72 6e 20 72 63 3b 0a 7d 0a 73 74 return rc;.}.st
2b2f0 61 74 69 63 20 69 6e 74 20 73 75 62 6a 6f 75 72 atic int subjour
2b300 6e 61 6c 50 61 67 65 49 66 52 65 71 75 69 72 65 nalPageIfRequire
2b310 64 28 50 67 48 64 72 20 2a 70 50 67 29 7b 0a 20 d(PgHdr *pPg){.
2b320 20 69 66 28 20 73 75 62 6a 52 65 71 75 69 72 65 if( subjRequire
2b330 73 50 61 67 65 28 70 50 67 29 20 29 7b 0a 20 20 sPage(pPg) ){.
2b340 20 20 72 65 74 75 72 6e 20 73 75 62 6a 6f 75 72 return subjour
2b350 6e 61 6c 50 61 67 65 28 70 50 67 29 3b 0a 20 20 nalPage(pPg);.
2b360 7d 65 6c 73 65 7b 0a 20 20 20 20 72 65 74 75 72 }else{. retur
2b370 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20 20 7d n SQLITE_OK;. }
2b380 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 54 68 69 73 20 66 .}../*.** This f
2b390 75 6e 63 74 69 6f 6e 20 69 73 20 63 61 6c 6c 65 unction is calle
2b3a0 64 20 62 79 20 74 68 65 20 70 63 61 63 68 65 20 d by the pcache
2b3b0 6c 61 79 65 72 20 77 68 65 6e 20 69 74 20 68 61 layer when it ha
2b3c0 73 20 72 65 61 63 68 65 64 20 73 6f 6d 65 0a 2a s reached some.*
2b3d0 2a 20 73 6f 66 74 20 6d 65 6d 6f 72 79 20 6c 69 * soft memory li
2b3e0 6d 69 74 2e 20 54 68 65 20 66 69 72 73 74 20 61 mit. The first a
2b3f0 72 67 75 6d 65 6e 74 20 69 73 20 61 20 70 6f 69 rgument is a poi
2b400 6e 74 65 72 20 74 6f 20 61 20 50 61 67 65 72 20 nter to a Pager
2b410 6f 62 6a 65 63 74 0a 2a 2a 20 28 63 61 73 74 20 object.** (cast
2b420 61 73 20 61 20 76 6f 69 64 2a 29 2e 20 54 68 65 as a void*). The
2b430 20 70 61 67 65 72 20 69 73 20 61 6c 77 61 79 73 pager is always
2b440 20 27 70 75 72 67 65 61 62 6c 65 27 20 28 6e 6f 'purgeable' (no
2b450 74 20 61 6e 20 69 6e 2d 6d 65 6d 6f 72 79 0a 2a t an in-memory.*
2b460 2a 20 64 61 74 61 62 61 73 65 29 2e 20 54 68 65 * database). The
2b470 20 73 65 63 6f 6e 64 20 61 72 67 75 6d 65 6e 74 second argument
2b480 20 69 73 20 61 20 72 65 66 65 72 65 6e 63 65 20 is a reference
2b490 74 6f 20 61 20 70 61 67 65 20 74 68 61 74 20 69 to a page that i
2b4a0 73 20 0a 2a 2a 20 63 75 72 72 65 6e 74 6c 79 20 s .** currently
2b4b0 64 69 72 74 79 20 62 75 74 20 68 61 73 20 6e 6f dirty but has no
2b4c0 20 6f 75 74 73 74 61 6e 64 69 6e 67 20 72 65 66 outstanding ref
2b4d0 65 72 65 6e 63 65 73 2e 20 54 68 65 20 70 61 67 erences. The pag
2b4e0 65 0a 2a 2a 20 69 73 20 61 6c 77 61 79 73 20 61 e.** is always a
2b4f0 73 73 6f 63 69 61 74 65 64 20 77 69 74 68 20 74 ssociated with t
2b500 68 65 20 50 61 67 65 72 20 6f 62 6a 65 63 74 20 he Pager object
2b510 70 61 73 73 65 64 20 61 73 20 74 68 65 20 66 69 passed as the fi
2b520 72 73 74 20 0a 2a 2a 20 61 72 67 75 6d 65 6e 74 rst .** argument
2b530 2e 0a 2a 2a 0a 2a 2a 20 54 68 65 20 6a 6f 62 20 ..**.** The job
2b540 6f 66 20 74 68 69 73 20 66 75 6e 63 74 69 6f 6e of this function
2b550 20 69 73 20 74 6f 20 6d 61 6b 65 20 70 50 67 20 is to make pPg
2b560 63 6c 65 61 6e 20 62 79 20 77 72 69 74 69 6e 67 clean by writing
2b570 20 69 74 73 20 63 6f 6e 74 65 6e 74 73 0a 2a 2a its contents.**
2b580 20 6f 75 74 20 74 6f 20 74 68 65 20 64 61 74 61 out to the data
2b590 62 61 73 65 20 66 69 6c 65 2c 20 69 66 20 70 6f base file, if po
2b5a0 73 73 69 62 6c 65 2e 20 54 68 69 73 20 6d 61 79 ssible. This may
2b5b0 20 69 6e 76 6f 6c 76 65 20 73 79 6e 63 69 6e 67 involve syncing
2b5c0 20 74 68 65 0a 2a 2a 20 6a 6f 75 72 6e 61 6c 20 the.** journal
2b5d0 66 69 6c 65 2e 20 0a 2a 2a 0a 2a 2a 20 49 66 20 file. .**.** If
2b5e0 73 75 63 63 65 73 73 66 75 6c 2c 20 73 71 6c 69 successful, sqli
2b5f0 74 65 33 50 63 61 63 68 65 4d 61 6b 65 43 6c 65 te3PcacheMakeCle
2b600 61 6e 28 29 20 69 73 20 63 61 6c 6c 65 64 20 6f an() is called o
2b610 6e 20 74 68 65 20 70 61 67 65 20 61 6e 64 0a 2a n the page and.*
2b620 2a 20 53 51 4c 49 54 45 5f 4f 4b 20 72 65 74 75 * SQLITE_OK retu
2b630 72 6e 65 64 2e 20 49 66 20 61 6e 20 49 4f 20 65 rned. If an IO e
2b640 72 72 6f 72 20 6f 63 63 75 72 73 20 77 68 69 6c rror occurs whil
2b650 65 20 74 72 79 69 6e 67 20 74 6f 20 6d 61 6b 65 e trying to make
2b660 20 74 68 65 0a 2a 2a 20 70 61 67 65 20 63 6c 65 the.** page cle
2b670 61 6e 2c 20 74 68 65 20 49 4f 20 65 72 72 6f 72 an, the IO error
2b680 20 63 6f 64 65 20 69 73 20 72 65 74 75 72 6e 65 code is returne
2b690 64 2e 20 49 66 20 74 68 65 20 70 61 67 65 20 63 d. If the page c
2b6a0 61 6e 6e 6f 74 20 62 65 0a 2a 2a 20 6d 61 64 65 annot be.** made
2b6b0 20 63 6c 65 61 6e 20 66 6f 72 20 73 6f 6d 65 20 clean for some
2b6c0 6f 74 68 65 72 20 72 65 61 73 6f 6e 2c 20 62 75 other reason, bu
2b6d0 74 20 6e 6f 20 65 72 72 6f 72 20 6f 63 63 75 72 t no error occur
2b6e0 73 2c 20 74 68 65 6e 20 53 51 4c 49 54 45 5f 4f s, then SQLITE_O
2b6f0 4b 0a 2a 2a 20 69 73 20 72 65 74 75 72 6e 65 64 K.** is returned
2b700 20 62 79 20 73 71 6c 69 74 65 33 50 63 61 63 68 by sqlite3Pcach
2b710 65 4d 61 6b 65 43 6c 65 61 6e 28 29 20 69 73 20 eMakeClean() is
2b720 6e 6f 74 20 63 61 6c 6c 65 64 2e 0a 2a 2f 0a 73 not called..*/.s
2b730 74 61 74 69 63 20 69 6e 74 20 70 61 67 65 72 53 tatic int pagerS
2b740 74 72 65 73 73 28 76 6f 69 64 20 2a 70 2c 20 50 tress(void *p, P
2b750 67 48 64 72 20 2a 70 50 67 29 7b 0a 20 20 50 61 gHdr *pPg){. Pa
2b760 67 65 72 20 2a 70 50 61 67 65 72 20 3d 20 28 50 ger *pPager = (P
2b770 61 67 65 72 20 2a 29 70 3b 0a 20 20 69 6e 74 20 ager *)p;. int
2b780 72 63 20 3d 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a rc = SQLITE_OK;.
2b790 0a 20 20 61 73 73 65 72 74 28 20 70 50 67 2d 3e . assert( pPg->
2b7a0 70 50 61 67 65 72 3d 3d 70 50 61 67 65 72 20 29 pPager==pPager )
2b7b0 3b 0a 20 20 61 73 73 65 72 74 28 20 70 50 67 2d ;. assert( pPg-
2b7c0 3e 66 6c 61 67 73 26 50 47 48 44 52 5f 44 49 52 >flags&PGHDR_DIR
2b7d0 54 59 20 29 3b 0a 0a 20 20 2f 2a 20 54 68 65 20 TY );.. /* The
2b7e0 64 6f 4e 6f 74 53 70 69 6c 6c 20 4e 4f 53 59 4e doNotSpill NOSYN
2b7f0 43 20 62 69 74 20 69 73 20 73 65 74 20 64 75 72 C bit is set dur
2b800 69 6e 67 20 74 69 6d 65 73 20 77 68 65 6e 20 64 ing times when d
2b810 6f 69 6e 67 20 61 20 73 79 6e 63 20 6f 66 0a 20 oing a sync of.
2b820 20 2a 2a 20 6a 6f 75 72 6e 61 6c 20 28 61 6e 64 ** journal (and
2b830 20 61 64 64 69 6e 67 20 61 20 6e 65 77 20 68 65 adding a new he
2b840 61 64 65 72 29 20 69 73 20 6e 6f 74 20 61 6c 6c ader) is not all
2b850 6f 77 65 64 2e 20 20 54 68 69 73 20 6f 63 63 75 owed. This occu
2b860 72 73 0a 20 20 2a 2a 20 64 75 72 69 6e 67 20 63 rs. ** during c
2b870 61 6c 6c 73 20 74 6f 20 73 71 6c 69 74 65 33 50 alls to sqlite3P
2b880 61 67 65 72 57 72 69 74 65 28 29 20 77 68 69 6c agerWrite() whil
2b890 65 20 74 72 79 69 6e 67 20 74 6f 20 6a 6f 75 72 e trying to jour
2b8a0 6e 61 6c 20 6d 75 6c 74 69 70 6c 65 0a 20 20 2a nal multiple. *
2b8b0 2a 20 70 61 67 65 73 20 62 65 6c 6f 6e 67 69 6e * pages belongin
2b8c0 67 20 74 6f 20 74 68 65 20 73 61 6d 65 20 73 65 g to the same se
2b8d0 63 74 6f 72 2e 0a 20 20 2a 2a 0a 20 20 2a 2a 20 ctor.. **. **
2b8e0 54 68 65 20 64 6f 4e 6f 74 53 70 69 6c 6c 20 52 The doNotSpill R
2b8f0 4f 4c 4c 42 41 43 4b 20 61 6e 64 20 4f 46 46 20 OLLBACK and OFF
2b900 62 69 74 73 20 69 6e 68 69 62 69 74 73 20 61 6c bits inhibits al
2b910 6c 20 63 61 63 68 65 20 73 70 69 6c 6c 69 6e 67 l cache spilling
2b920 0a 20 20 2a 2a 20 72 65 67 61 72 64 6c 65 73 73 . ** regardless
2b930 20 6f 66 20 77 68 65 74 68 65 72 20 6f 72 20 6e of whether or n
2b940 6f 74 20 61 20 73 79 6e 63 20 69 73 20 72 65 71 ot a sync is req
2b950 75 69 72 65 64 2e 20 20 54 68 69 73 20 69 73 20 uired. This is
2b960 73 65 74 20 64 75 72 69 6e 67 0a 20 20 2a 2a 20 set during. **
2b970 61 20 72 6f 6c 6c 62 61 63 6b 20 6f 72 20 62 79 a rollback or by
2b980 20 75 73 65 72 20 72 65 71 75 65 73 74 2c 20 72 user request, r
2b990 65 73 70 65 63 74 69 76 65 6c 79 2e 0a 20 20 2a espectively.. *
2b9a0 2a 0a 20 20 2a 2a 20 53 70 69 6c 6c 69 6e 67 20 *. ** Spilling
2b9b0 69 73 20 61 6c 73 6f 20 70 72 6f 68 69 62 69 74 is also prohibit
2b9c0 65 64 20 77 68 65 6e 20 69 6e 20 61 6e 20 65 72 ed when in an er
2b9d0 72 6f 72 20 73 74 61 74 65 20 73 69 6e 63 65 20 ror state since
2b9e0 74 68 61 74 20 63 6f 75 6c 64 0a 20 20 2a 2a 20 that could. **
2b9f0 6c 65 61 64 20 74 6f 20 64 61 74 61 62 61 73 65 lead to database
2ba00 20 63 6f 72 72 75 70 74 69 6f 6e 2e 20 20 20 49 corruption. I
2ba10 6e 20 74 68 65 20 63 75 72 72 65 6e 74 20 69 6d n the current im
2ba20 70 6c 65 6d 65 6e 74 61 74 69 6f 6e 20 69 74 20 plementation it
2ba30 0a 20 20 2a 2a 20 69 73 20 69 6d 70 6f 73 73 69 . ** is impossi
2ba40 62 6c 65 20 66 6f 72 20 73 71 6c 69 74 65 33 50 ble for sqlite3P
2ba50 63 61 63 68 65 46 65 74 63 68 28 29 20 74 6f 20 cacheFetch() to
2ba60 62 65 20 63 61 6c 6c 65 64 20 77 69 74 68 20 63 be called with c
2ba70 72 65 61 74 65 46 6c 61 67 3d 3d 33 0a 20 20 2a reateFlag==3. *
2ba80 2a 20 77 68 69 6c 65 20 69 6e 20 74 68 65 20 65 * while in the e
2ba90 72 72 6f 72 20 73 74 61 74 65 2c 20 68 65 6e 63 rror state, henc
2baa0 65 20 69 74 20 69 73 20 69 6d 70 6f 73 73 69 62 e it is impossib
2bab0 6c 65 20 66 6f 72 20 74 68 69 73 20 72 6f 75 74 le for this rout
2bac0 69 6e 65 20 74 6f 0a 20 20 2a 2a 20 62 65 20 63 ine to. ** be c
2bad0 61 6c 6c 65 64 20 69 6e 20 74 68 65 20 65 72 72 alled in the err
2bae0 6f 72 20 73 74 61 74 65 2e 20 20 4e 65 76 65 72 or state. Never
2baf0 74 68 65 6c 65 73 73 2c 20 77 65 20 69 6e 63 6c theless, we incl
2bb00 75 64 65 20 61 20 4e 45 56 45 52 28 29 0a 20 20 ude a NEVER().
2bb10 2a 2a 20 74 65 73 74 20 66 6f 72 20 74 68 65 20 ** test for the
2bb20 65 72 72 6f 72 20 73 74 61 74 65 20 61 73 20 61 error state as a
2bb30 20 73 61 66 65 67 75 61 72 64 20 61 67 61 69 6e safeguard again
2bb40 73 74 20 66 75 74 75 72 65 20 63 68 61 6e 67 65 st future change
2bb50 73 2e 0a 20 20 2a 2f 0a 20 20 69 66 28 20 4e 45 s.. */. if( NE
2bb60 56 45 52 28 70 50 61 67 65 72 2d 3e 65 72 72 43 VER(pPager->errC
2bb70 6f 64 65 29 20 29 20 72 65 74 75 72 6e 20 53 51 ode) ) return SQ
2bb80 4c 49 54 45 5f 4f 4b 3b 0a 20 20 74 65 73 74 63 LITE_OK;. testc
2bb90 61 73 65 28 20 70 50 61 67 65 72 2d 3e 64 6f 4e ase( pPager->doN
2bba0 6f 74 53 70 69 6c 6c 20 26 20 53 50 49 4c 4c 46 otSpill & SPILLF
2bbb0 4c 41 47 5f 52 4f 4c 4c 42 41 43 4b 20 29 3b 0a LAG_ROLLBACK );.
2bbc0 20 20 74 65 73 74 63 61 73 65 28 20 70 50 61 67 testcase( pPag
2bbd0 65 72 2d 3e 64 6f 4e 6f 74 53 70 69 6c 6c 20 26 er->doNotSpill &
2bbe0 20 53 50 49 4c 4c 46 4c 41 47 5f 4f 46 46 20 29 SPILLFLAG_OFF )
2bbf0 3b 0a 20 20 74 65 73 74 63 61 73 65 28 20 70 50 ;. testcase( pP
2bc00 61 67 65 72 2d 3e 64 6f 4e 6f 74 53 70 69 6c 6c ager->doNotSpill
2bc10 20 26 20 53 50 49 4c 4c 46 4c 41 47 5f 4e 4f 53 & SPILLFLAG_NOS
2bc20 59 4e 43 20 29 3b 0a 20 20 69 66 28 20 70 50 61 YNC );. if( pPa
2bc30 67 65 72 2d 3e 64 6f 4e 6f 74 53 70 69 6c 6c 0a ger->doNotSpill.
2bc40 20 20 20 26 26 20 28 28 70 50 61 67 65 72 2d 3e && ((pPager->
2bc50 64 6f 4e 6f 74 53 70 69 6c 6c 20 26 20 28 53 50 doNotSpill & (SP
2bc60 49 4c 4c 46 4c 41 47 5f 52 4f 4c 4c 42 41 43 4b ILLFLAG_ROLLBACK
2bc70 7c 53 50 49 4c 4c 46 4c 41 47 5f 4f 46 46 29 29 |SPILLFLAG_OFF))
2bc80 21 3d 30 0a 20 20 20 20 20 20 7c 7c 20 28 70 50 !=0. || (pP
2bc90 67 2d 3e 66 6c 61 67 73 20 26 20 50 47 48 44 52 g->flags & PGHDR
2bca0 5f 4e 45 45 44 5f 53 59 4e 43 29 21 3d 30 29 0a _NEED_SYNC)!=0).
2bcb0 20 20 29 7b 0a 20 20 20 20 72 65 74 75 72 6e 20 ){. return
2bcc0 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20 20 7d 0a 0a SQLITE_OK;. }..
2bcd0 20 20 70 50 67 2d 3e 70 44 69 72 74 79 20 3d 20 pPg->pDirty =
2bce0 30 3b 0a 20 20 69 66 28 20 70 61 67 65 72 55 73 0;. if( pagerUs
2bcf0 65 57 61 6c 28 70 50 61 67 65 72 29 20 29 7b 0a eWal(pPager) ){.
2bd00 20 20 20 20 2f 2a 20 57 72 69 74 65 20 61 20 73 /* Write a s
2bd10 69 6e 67 6c 65 20 66 72 61 6d 65 20 66 6f 72 20 ingle frame for
2bd20 74 68 69 73 20 70 61 67 65 20 74 6f 20 74 68 65 this page to the
2bd30 20 6c 6f 67 2e 20 2a 2f 0a 20 20 20 20 72 63 20 log. */. rc
2bd40 3d 20 73 75 62 6a 6f 75 72 6e 61 6c 50 61 67 65 = subjournalPage
2bd50 49 66 52 65 71 75 69 72 65 64 28 70 50 67 29 3b IfRequired(pPg);
2bd60 20 0a 20 20 20 20 69 66 28 20 72 63 3d 3d 53 51 . if( rc==SQ
2bd70 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 20 LITE_OK ){.
2bd80 20 72 63 20 3d 20 70 61 67 65 72 57 61 6c 46 72 rc = pagerWalFr
2bd90 61 6d 65 73 28 70 50 61 67 65 72 2c 20 70 50 67 ames(pPager, pPg
2bda0 2c 20 30 2c 20 30 29 3b 0a 20 20 20 20 7d 0a 20 , 0, 0);. }.
2bdb0 20 7d 65 6c 73 65 7b 0a 20 20 0a 20 20 20 20 2f }else{. . /
2bdc0 2a 20 53 79 6e 63 20 74 68 65 20 6a 6f 75 72 6e * Sync the journ
2bdd0 61 6c 20 66 69 6c 65 20 69 66 20 72 65 71 75 69 al file if requi
2bde0 72 65 64 2e 20 2a 2f 0a 20 20 20 20 69 66 28 20 red. */. if(
2bdf0 70 50 67 2d 3e 66 6c 61 67 73 26 50 47 48 44 52 pPg->flags&PGHDR
2be00 5f 4e 45 45 44 5f 53 59 4e 43 20 0a 20 20 20 20 _NEED_SYNC .
2be10 20 7c 7c 20 70 50 61 67 65 72 2d 3e 65 53 74 61 || pPager->eSta
2be20 74 65 3d 3d 50 41 47 45 52 5f 57 52 49 54 45 52 te==PAGER_WRITER
2be30 5f 43 41 43 48 45 4d 4f 44 0a 20 20 20 20 29 7b _CACHEMOD. ){
2be40 0a 20 20 20 20 20 20 72 63 20 3d 20 73 79 6e 63 . rc = sync
2be50 4a 6f 75 72 6e 61 6c 28 70 50 61 67 65 72 2c 20 Journal(pPager,
2be60 31 29 3b 0a 20 20 20 20 7d 0a 20 20 0a 20 20 20 1);. }. .
2be70 20 2f 2a 20 57 72 69 74 65 20 74 68 65 20 63 6f /* Write the co
2be80 6e 74 65 6e 74 73 20 6f 66 20 74 68 65 20 70 61 ntents of the pa
2be90 67 65 20 6f 75 74 20 74 6f 20 74 68 65 20 64 61 ge out to the da
2bea0 74 61 62 61 73 65 20 66 69 6c 65 2e 20 2a 2f 0a tabase file. */.
2beb0 20 20 20 20 69 66 28 20 72 63 3d 3d 53 51 4c 49 if( rc==SQLI
2bec0 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 20 20 61 TE_OK ){. a
2bed0 73 73 65 72 74 28 20 28 70 50 67 2d 3e 66 6c 61 ssert( (pPg->fla
2bee0 67 73 26 50 47 48 44 52 5f 4e 45 45 44 5f 53 59 gs&PGHDR_NEED_SY
2bef0 4e 43 29 3d 3d 30 20 29 3b 0a 20 20 20 20 20 20 NC)==0 );.
2bf00 72 63 20 3d 20 70 61 67 65 72 5f 77 72 69 74 65 rc = pager_write
2bf10 5f 70 61 67 65 6c 69 73 74 28 70 50 61 67 65 72 _pagelist(pPager
2bf20 2c 20 70 50 67 29 3b 0a 20 20 20 20 7d 0a 20 20 , pPg);. }.
2bf30 7d 0a 0a 20 20 2f 2a 20 4d 61 72 6b 20 74 68 65 }.. /* Mark the
2bf40 20 70 61 67 65 20 61 73 20 63 6c 65 61 6e 2e 20 page as clean.
2bf50 2a 2f 0a 20 20 69 66 28 20 72 63 3d 3d 53 51 4c */. if( rc==SQL
2bf60 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 50 41 ITE_OK ){. PA
2bf70 47 45 52 54 52 41 43 45 28 28 22 53 54 52 45 53 GERTRACE(("STRES
2bf80 53 20 25 64 20 70 61 67 65 20 25 64 5c 6e 22 2c S %d page %d\n",
2bf90 20 50 41 47 45 52 49 44 28 70 50 61 67 65 72 29 PAGERID(pPager)
2bfa0 2c 20 70 50 67 2d 3e 70 67 6e 6f 29 29 3b 0a 20 , pPg->pgno));.
2bfb0 20 20 20 73 71 6c 69 74 65 33 50 63 61 63 68 65 sqlite3Pcache
2bfc0 4d 61 6b 65 43 6c 65 61 6e 28 70 50 67 29 3b 0a MakeClean(pPg);.
2bfd0 20 20 7d 0a 0a 20 20 72 65 74 75 72 6e 20 70 61 }.. return pa
2bfe0 67 65 72 5f 65 72 72 6f 72 28 70 50 61 67 65 72 ger_error(pPager
2bff0 2c 20 72 63 29 3b 20 0a 7d 0a 0a 2f 2a 0a 2a 2a , rc); .}../*.**
2c000 20 46 6c 75 73 68 20 61 6c 6c 20 75 6e 72 65 66 Flush all unref
2c010 65 72 65 6e 63 65 64 20 64 69 72 74 79 20 70 61 erenced dirty pa
2c020 67 65 73 20 74 6f 20 64 69 73 6b 2e 0a 2a 2f 0a ges to disk..*/.
2c030 69 6e 74 20 73 71 6c 69 74 65 33 50 61 67 65 72 int sqlite3Pager
2c040 46 6c 75 73 68 28 50 61 67 65 72 20 2a 70 50 61 Flush(Pager *pPa
2c050 67 65 72 29 7b 0a 20 20 69 6e 74 20 72 63 20 3d ger){. int rc =
2c060 20 70 50 61 67 65 72 2d 3e 65 72 72 43 6f 64 65 pPager->errCode
2c070 3b 0a 20 20 69 66 28 20 21 4d 45 4d 44 42 20 29 ;. if( !MEMDB )
2c080 7b 0a 20 20 20 20 50 67 48 64 72 20 2a 70 4c 69 {. PgHdr *pLi
2c090 73 74 20 3d 20 73 71 6c 69 74 65 33 50 63 61 63 st = sqlite3Pcac
2c0a0 68 65 44 69 72 74 79 4c 69 73 74 28 70 50 61 67 heDirtyList(pPag
2c0b0 65 72 2d 3e 70 50 43 61 63 68 65 29 3b 0a 20 20 er->pPCache);.
2c0c0 20 20 61 73 73 65 72 74 28 20 61 73 73 65 72 74 assert( assert
2c0d0 5f 70 61 67 65 72 5f 73 74 61 74 65 28 70 50 61 _pager_state(pPa
2c0e0 67 65 72 29 20 29 3b 0a 20 20 20 20 77 68 69 6c ger) );. whil
2c0f0 65 28 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b e( rc==SQLITE_OK
2c100 20 26 26 20 70 4c 69 73 74 20 29 7b 0a 20 20 20 && pList ){.
2c110 20 20 20 50 67 48 64 72 20 2a 70 4e 65 78 74 20 PgHdr *pNext
2c120 3d 20 70 4c 69 73 74 2d 3e 70 44 69 72 74 79 3b = pList->pDirty;
2c130 0a 20 20 20 20 20 20 69 66 28 20 70 4c 69 73 74 . if( pList
2c140 2d 3e 6e 52 65 66 3d 3d 30 20 29 7b 0a 20 20 20 ->nRef==0 ){.
2c150 20 20 20 20 20 72 63 20 3d 20 70 61 67 65 72 53 rc = pagerS
2c160 74 72 65 73 73 28 28 76 6f 69 64 2a 29 70 50 61 tress((void*)pPa
2c170 67 65 72 2c 20 70 4c 69 73 74 29 3b 0a 20 20 20 ger, pList);.
2c180 20 20 20 7d 0a 20 20 20 20 20 20 70 4c 69 73 74 }. pList
2c190 20 3d 20 70 4e 65 78 74 3b 0a 20 20 20 20 7d 0a = pNext;. }.
2c1a0 20 20 7d 0a 0a 20 20 72 65 74 75 72 6e 20 72 63 }.. return rc
2c1b0 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 41 6c 6c 6f 63 ;.}../*.** Alloc
2c1c0 61 74 65 20 61 6e 64 20 69 6e 69 74 69 61 6c 69 ate and initiali
2c1d0 7a 65 20 61 20 6e 65 77 20 50 61 67 65 72 20 6f ze a new Pager o
2c1e0 62 6a 65 63 74 20 61 6e 64 20 70 75 74 20 61 20 bject and put a
2c1f0 70 6f 69 6e 74 65 72 20 74 6f 20 69 74 0a 2a 2a pointer to it.**
2c200 20 69 6e 20 2a 70 70 50 61 67 65 72 2e 20 54 68 in *ppPager. Th
2c210 65 20 70 61 67 65 72 20 73 68 6f 75 6c 64 20 65 e pager should e
2c220 76 65 6e 74 75 61 6c 6c 79 20 62 65 20 66 72 65 ventually be fre
2c230 65 64 20 62 79 20 70 61 73 73 69 6e 67 20 69 74 ed by passing it
2c240 0a 2a 2a 20 74 6f 20 73 71 6c 69 74 65 33 50 61 .** to sqlite3Pa
2c250 67 65 72 43 6c 6f 73 65 28 29 2e 0a 2a 2a 0a 2a gerClose()..**.*
2c260 2a 20 54 68 65 20 7a 46 69 6c 65 6e 61 6d 65 20 * The zFilename
2c270 61 72 67 75 6d 65 6e 74 20 69 73 20 74 68 65 20 argument is the
2c280 70 61 74 68 20 74 6f 20 74 68 65 20 64 61 74 61 path to the data
2c290 62 61 73 65 20 66 69 6c 65 20 74 6f 20 6f 70 65 base file to ope
2c2a0 6e 2e 0a 2a 2a 20 49 66 20 7a 46 69 6c 65 6e 61 n..** If zFilena
2c2b0 6d 65 20 69 73 20 4e 55 4c 4c 20 74 68 65 6e 20 me is NULL then
2c2c0 61 20 72 61 6e 64 6f 6d 6c 79 2d 6e 61 6d 65 64 a randomly-named
2c2d0 20 74 65 6d 70 6f 72 61 72 79 20 66 69 6c 65 20 temporary file
2c2e0 69 73 20 63 72 65 61 74 65 64 0a 2a 2a 20 61 6e is created.** an
2c2f0 64 20 75 73 65 64 20 61 73 20 74 68 65 20 66 69 d used as the fi
2c300 6c 65 20 74 6f 20 62 65 20 63 61 63 68 65 64 2e le to be cached.
2c310 20 54 65 6d 70 6f 72 61 72 79 20 66 69 6c 65 73 Temporary files
2c320 20 61 72 65 20 62 65 20 64 65 6c 65 74 65 64 0a are be deleted.
2c330 2a 2a 20 61 75 74 6f 6d 61 74 69 63 61 6c 6c 79 ** automatically
2c340 20 77 68 65 6e 20 74 68 65 79 20 61 72 65 20 63 when they are c
2c350 6c 6f 73 65 64 2e 20 49 66 20 7a 46 69 6c 65 6e losed. If zFilen
2c360 61 6d 65 20 69 73 20 22 3a 6d 65 6d 6f 72 79 3a ame is ":memory:
2c370 22 20 74 68 65 6e 20 0a 2a 2a 20 61 6c 6c 20 69 " then .** all i
2c380 6e 66 6f 72 6d 61 74 69 6f 6e 20 69 73 20 68 65 nformation is he
2c390 6c 64 20 69 6e 20 63 61 63 68 65 2e 20 49 74 20 ld in cache. It
2c3a0 69 73 20 6e 65 76 65 72 20 77 72 69 74 74 65 6e is never written
2c3b0 20 74 6f 20 64 69 73 6b 2e 20 0a 2a 2a 20 54 68 to disk. .** Th
2c3c0 69 73 20 63 61 6e 20 62 65 20 75 73 65 64 20 74 is can be used t
2c3d0 6f 20 69 6d 70 6c 65 6d 65 6e 74 20 61 6e 20 69 o implement an i
2c3e0 6e 2d 6d 65 6d 6f 72 79 20 64 61 74 61 62 61 73 n-memory databas
2c3f0 65 2e 0a 2a 2a 0a 2a 2a 20 54 68 65 20 6e 45 78 e..**.** The nEx
2c400 74 72 61 20 70 61 72 61 6d 65 74 65 72 20 73 70 tra parameter sp
2c410 65 63 69 66 69 65 73 20 74 68 65 20 6e 75 6d 62 ecifies the numb
2c420 65 72 20 6f 66 20 62 79 74 65 73 20 6f 66 20 73 er of bytes of s
2c430 70 61 63 65 20 61 6c 6c 6f 63 61 74 65 64 0a 2a pace allocated.*
2c440 2a 20 61 6c 6f 6e 67 20 77 69 74 68 20 65 61 63 * along with eac
2c450 68 20 70 61 67 65 20 72 65 66 65 72 65 6e 63 65 h page reference
2c460 2e 20 54 68 69 73 20 73 70 61 63 65 20 69 73 20 . This space is
2c470 61 76 61 69 6c 61 62 6c 65 20 74 6f 20 74 68 65 available to the
2c480 20 75 73 65 72 0a 2a 2a 20 76 69 61 20 74 68 65 user.** via the
2c490 20 73 71 6c 69 74 65 33 50 61 67 65 72 47 65 74 sqlite3PagerGet
2c4a0 45 78 74 72 61 28 29 20 41 50 49 2e 0a 2a 2a 0a Extra() API..**.
2c4b0 2a 2a 20 54 68 65 20 66 6c 61 67 73 20 61 72 67 ** The flags arg
2c4c0 75 6d 65 6e 74 20 69 73 20 75 73 65 64 20 74 6f ument is used to
2c4d0 20 73 70 65 63 69 66 79 20 70 72 6f 70 65 72 74 specify propert
2c4e0 69 65 73 20 74 68 61 74 20 61 66 66 65 63 74 20 ies that affect
2c4f0 74 68 65 0a 2a 2a 20 6f 70 65 72 61 74 69 6f 6e the.** operation
2c500 20 6f 66 20 74 68 65 20 70 61 67 65 72 2e 20 49 of the pager. I
2c510 74 20 73 68 6f 75 6c 64 20 62 65 20 70 61 73 73 t should be pass
2c520 65 64 20 73 6f 6d 65 20 62 69 74 77 69 73 65 20 ed some bitwise
2c530 63 6f 6d 62 69 6e 61 74 69 6f 6e 0a 2a 2a 20 6f combination.** o
2c540 66 20 74 68 65 20 50 41 47 45 52 5f 2a 20 66 6c f the PAGER_* fl
2c550 61 67 73 2e 0a 2a 2a 0a 2a 2a 20 54 68 65 20 76 ags..**.** The v
2c560 66 73 46 6c 61 67 73 20 70 61 72 61 6d 65 74 65 fsFlags paramete
2c570 72 20 69 73 20 61 20 62 69 74 6d 61 73 6b 20 74 r is a bitmask t
2c580 6f 20 70 61 73 73 20 74 6f 20 74 68 65 20 66 6c o pass to the fl
2c590 61 67 73 20 70 61 72 61 6d 65 74 65 72 0a 2a 2a ags parameter.**
2c5a0 20 6f 66 20 74 68 65 20 78 4f 70 65 6e 28 29 20 of the xOpen()
2c5b0 6d 65 74 68 6f 64 20 6f 66 20 74 68 65 20 73 75 method of the su
2c5c0 70 70 6c 69 65 64 20 56 46 53 20 77 68 65 6e 20 pplied VFS when
2c5d0 6f 70 65 6e 69 6e 67 20 66 69 6c 65 73 2e 20 0a opening files. .
2c5e0 2a 2a 0a 2a 2a 20 49 66 20 74 68 65 20 70 61 67 **.** If the pag
2c5f0 65 72 20 6f 62 6a 65 63 74 20 69 73 20 61 6c 6c er object is all
2c600 6f 63 61 74 65 64 20 61 6e 64 20 74 68 65 20 73 ocated and the s
2c610 70 65 63 69 66 69 65 64 20 66 69 6c 65 20 6f 70 pecified file op
2c620 65 6e 65 64 20 0a 2a 2a 20 73 75 63 63 65 73 73 ened .** success
2c630 66 75 6c 6c 79 2c 20 53 51 4c 49 54 45 5f 4f 4b fully, SQLITE_OK
2c640 20 69 73 20 72 65 74 75 72 6e 65 64 20 61 6e 64 is returned and
2c650 20 2a 70 70 50 61 67 65 72 20 73 65 74 20 74 6f *ppPager set to
2c660 20 70 6f 69 6e 74 20 74 6f 0a 2a 2a 20 74 68 65 point to.** the
2c670 20 6e 65 77 20 70 61 67 65 72 20 6f 62 6a 65 63 new pager objec
2c680 74 2e 20 49 66 20 61 6e 20 65 72 72 6f 72 20 6f t. If an error o
2c690 63 63 75 72 73 2c 20 2a 70 70 50 61 67 65 72 20 ccurs, *ppPager
2c6a0 69 73 20 73 65 74 20 74 6f 20 4e 55 4c 4c 0a 2a is set to NULL.*
2c6b0 2a 20 61 6e 64 20 65 72 72 6f 72 20 63 6f 64 65 * and error code
2c6c0 20 72 65 74 75 72 6e 65 64 2e 20 54 68 69 73 20 returned. This
2c6d0 66 75 6e 63 74 69 6f 6e 20 6d 61 79 20 72 65 74 function may ret
2c6e0 75 72 6e 20 53 51 4c 49 54 45 5f 4e 4f 4d 45 4d urn SQLITE_NOMEM
2c6f0 0a 2a 2a 20 28 73 71 6c 69 74 65 33 4d 61 6c 6c .** (sqlite3Mall
2c700 6f 63 28 29 20 69 73 20 75 73 65 64 20 74 6f 20 oc() is used to
2c710 61 6c 6c 6f 63 61 74 65 20 6d 65 6d 6f 72 79 29 allocate memory)
2c720 2c 20 53 51 4c 49 54 45 5f 43 41 4e 54 4f 50 45 , SQLITE_CANTOPE
2c730 4e 20 6f 72 20 0a 2a 2a 20 76 61 72 69 6f 75 73 N or .** various
2c740 20 53 51 4c 49 54 45 5f 49 4f 5f 58 58 58 20 65 SQLITE_IO_XXX e
2c750 72 72 6f 72 73 2e 0a 2a 2f 0a 69 6e 74 20 73 71 rrors..*/.int sq
2c760 6c 69 74 65 33 50 61 67 65 72 4f 70 65 6e 28 0a lite3PagerOpen(.
2c770 20 20 73 71 6c 69 74 65 33 5f 76 66 73 20 2a 70 sqlite3_vfs *p
2c780 56 66 73 2c 20 20 20 20 20 20 20 2f 2a 20 54 68 Vfs, /* Th
2c790 65 20 76 69 72 74 75 61 6c 20 66 69 6c 65 20 73 e virtual file s
2c7a0 79 73 74 65 6d 20 74 6f 20 75 73 65 20 2a 2f 0a ystem to use */.
2c7b0 20 20 50 61 67 65 72 20 2a 2a 70 70 50 61 67 65 Pager **ppPage
2c7c0 72 2c 20 20 20 20 20 20 20 20 20 2f 2a 20 4f 55 r, /* OU
2c7d0 54 3a 20 52 65 74 75 72 6e 20 74 68 65 20 50 61 T: Return the Pa
2c7e0 67 65 72 20 73 74 72 75 63 74 75 72 65 20 68 65 ger structure he
2c7f0 72 65 20 2a 2f 0a 20 20 63 6f 6e 73 74 20 63 68 re */. const ch
2c800 61 72 20 2a 7a 46 69 6c 65 6e 61 6d 65 2c 20 20 ar *zFilename,
2c810 20 2f 2a 20 4e 61 6d 65 20 6f 66 20 74 68 65 20 /* Name of the
2c820 64 61 74 61 62 61 73 65 20 66 69 6c 65 20 74 6f database file to
2c830 20 6f 70 65 6e 20 2a 2f 0a 20 20 69 6e 74 20 6e open */. int n
2c840 45 78 74 72 61 2c 20 20 20 20 20 20 20 20 20 20 Extra,
2c850 20 20 20 20 2f 2a 20 45 78 74 72 61 20 62 79 74 /* Extra byt
2c860 65 73 20 61 70 70 65 6e 64 20 74 6f 20 65 61 63 es append to eac
2c870 68 20 69 6e 2d 6d 65 6d 6f 72 79 20 70 61 67 65 h in-memory page
2c880 20 2a 2f 0a 20 20 69 6e 74 20 66 6c 61 67 73 2c */. int flags,
2c890 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f /
2c8a0 2a 20 66 6c 61 67 73 20 63 6f 6e 74 72 6f 6c 6c * flags controll
2c8b0 69 6e 67 20 74 68 69 73 20 66 69 6c 65 20 2a 2f ing this file */
2c8c0 0a 20 20 69 6e 74 20 76 66 73 46 6c 61 67 73 2c . int vfsFlags,
2c8d0 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 66 /* f
2c8e0 6c 61 67 73 20 70 61 73 73 65 64 20 74 68 72 6f lags passed thro
2c8f0 75 67 68 20 74 6f 20 73 71 6c 69 74 65 33 5f 76 ugh to sqlite3_v
2c900 66 73 2e 78 4f 70 65 6e 28 29 20 2a 2f 0a 20 20 fs.xOpen() */.
2c910 76 6f 69 64 20 28 2a 78 52 65 69 6e 69 74 29 28 void (*xReinit)(
2c920 44 62 50 61 67 65 2a 29 20 2f 2a 20 46 75 6e 63 DbPage*) /* Func
2c930 74 69 6f 6e 20 74 6f 20 72 65 69 6e 69 74 69 61 tion to reinitia
2c940 6c 69 7a 65 20 70 61 67 65 73 20 2a 2f 0a 29 7b lize pages */.){
2c950 0a 20 20 75 38 20 2a 70 50 74 72 3b 0a 20 20 50 . u8 *pPtr;. P
2c960 61 67 65 72 20 2a 70 50 61 67 65 72 20 3d 20 30 ager *pPager = 0
2c970 3b 20 20 20 20 20 20 20 2f 2a 20 50 61 67 65 72 ; /* Pager
2c980 20 6f 62 6a 65 63 74 20 74 6f 20 61 6c 6c 6f 63 object to alloc
2c990 61 74 65 20 61 6e 64 20 72 65 74 75 72 6e 20 2a ate and return *
2c9a0 2f 0a 20 20 69 6e 74 20 72 63 20 3d 20 53 51 4c /. int rc = SQL
2c9b0 49 54 45 5f 4f 4b 3b 20 20 20 20 20 20 2f 2a 20 ITE_OK; /*
2c9c0 52 65 74 75 72 6e 20 63 6f 64 65 20 2a 2f 0a 20 Return code */.
2c9d0 20 69 6e 74 20 74 65 6d 70 46 69 6c 65 20 3d 20 int tempFile =
2c9e0 30 3b 20 20 20 20 20 20 20 20 2f 2a 20 54 72 75 0; /* Tru
2c9f0 65 20 66 6f 72 20 74 65 6d 70 20 66 69 6c 65 73 e for temp files
2ca00 20 28 69 6e 63 6c 2e 20 69 6e 2d 6d 65 6d 6f 72 (incl. in-memor
2ca10 79 20 66 69 6c 65 73 29 20 2a 2f 0a 20 20 69 6e y files) */. in
2ca20 74 20 6d 65 6d 44 62 20 3d 20 30 3b 20 20 20 20 t memDb = 0;
2ca30 20 20 20 20 20 20 20 2f 2a 20 54 72 75 65 20 69 /* True i
2ca40 66 20 74 68 69 73 20 69 73 20 61 6e 20 69 6e 2d f this is an in-
2ca50 6d 65 6d 6f 72 79 20 66 69 6c 65 20 2a 2f 0a 20 memory file */.
2ca60 20 69 6e 74 20 72 65 61 64 4f 6e 6c 79 20 3d 20 int readOnly =
2ca70 30 3b 20 20 20 20 20 20 20 20 2f 2a 20 54 72 75 0; /* Tru
2ca80 65 20 69 66 20 74 68 69 73 20 69 73 20 61 20 72 e if this is a r
2ca90 65 61 64 2d 6f 6e 6c 79 20 66 69 6c 65 20 2a 2f ead-only file */
2caa0 0a 20 20 69 6e 74 20 6a 6f 75 72 6e 61 6c 46 69 . int journalFi
2cab0 6c 65 53 69 7a 65 3b 20 20 20 20 20 2f 2a 20 42 leSize; /* B
2cac0 79 74 65 73 20 74 6f 20 61 6c 6c 6f 63 61 74 65 ytes to allocate
2cad0 20 66 6f 72 20 65 61 63 68 20 6a 6f 75 72 6e 61 for each journa
2cae0 6c 20 66 64 20 2a 2f 0a 20 20 63 68 61 72 20 2a l fd */. char *
2caf0 7a 50 61 74 68 6e 61 6d 65 20 3d 20 30 3b 20 20 zPathname = 0;
2cb00 20 20 20 2f 2a 20 46 75 6c 6c 20 70 61 74 68 20 /* Full path
2cb10 74 6f 20 64 61 74 61 62 61 73 65 20 66 69 6c 65 to database file
2cb20 20 2a 2f 0a 20 20 69 6e 74 20 6e 50 61 74 68 6e */. int nPathn
2cb30 61 6d 65 20 3d 20 30 3b 20 20 20 20 20 20 20 2f ame = 0; /
2cb40 2a 20 4e 75 6d 62 65 72 20 6f 66 20 62 79 74 65 * Number of byte
2cb50 73 20 69 6e 20 7a 50 61 74 68 6e 61 6d 65 20 2a s in zPathname *
2cb60 2f 0a 20 20 69 6e 74 20 75 73 65 4a 6f 75 72 6e /. int useJourn
2cb70 61 6c 20 3d 20 28 66 6c 61 67 73 20 26 20 50 41 al = (flags & PA
2cb80 47 45 52 5f 4f 4d 49 54 5f 4a 4f 55 52 4e 41 4c GER_OMIT_JOURNAL
2cb90 29 3d 3d 30 3b 20 2f 2a 20 46 61 6c 73 65 20 74 )==0; /* False t
2cba0 6f 20 6f 6d 69 74 20 6a 6f 75 72 6e 61 6c 20 2a o omit journal *
2cbb0 2f 0a 20 20 69 6e 74 20 70 63 61 63 68 65 53 69 /. int pcacheSi
2cbc0 7a 65 20 3d 20 73 71 6c 69 74 65 33 50 63 61 63 ze = sqlite3Pcac
2cbd0 68 65 53 69 7a 65 28 29 3b 20 20 20 20 20 20 20 heSize();
2cbe0 2f 2a 20 42 79 74 65 73 20 74 6f 20 61 6c 6c 6f /* Bytes to allo
2cbf0 63 61 74 65 20 66 6f 72 20 50 43 61 63 68 65 20 cate for PCache
2cc00 2a 2f 0a 20 20 75 33 32 20 73 7a 50 61 67 65 44 */. u32 szPageD
2cc10 66 6c 74 20 3d 20 53 51 4c 49 54 45 5f 44 45 46 flt = SQLITE_DEF
2cc20 41 55 4c 54 5f 50 41 47 45 5f 53 49 5a 45 3b 20 AULT_PAGE_SIZE;
2cc30 20 2f 2a 20 44 65 66 61 75 6c 74 20 70 61 67 65 /* Default page
2cc40 20 73 69 7a 65 20 2a 2f 0a 20 20 63 6f 6e 73 74 size */. const
2cc50 20 63 68 61 72 20 2a 7a 55 72 69 20 3d 20 30 3b char *zUri = 0;
2cc60 20 20 20 20 2f 2a 20 55 52 49 20 61 72 67 73 20 /* URI args
2cc70 74 6f 20 63 6f 70 79 20 2a 2f 0a 20 20 69 6e 74 to copy */. int
2cc80 20 6e 55 72 69 20 3d 20 30 3b 20 20 20 20 20 20 nUri = 0;
2cc90 20 20 20 20 20 20 2f 2a 20 4e 75 6d 62 65 72 20 /* Number
2cca0 6f 66 20 62 79 74 65 73 20 6f 66 20 55 52 49 20 of bytes of URI
2ccb0 61 72 67 73 20 61 74 20 2a 7a 55 72 69 20 2a 2f args at *zUri */
2ccc0 0a 0a 20 20 2f 2a 20 46 69 67 75 72 65 20 6f 75 .. /* Figure ou
2ccd0 74 20 68 6f 77 20 6d 75 63 68 20 73 70 61 63 65 t how much space
2cce0 20 69 73 20 72 65 71 75 69 72 65 64 20 66 6f 72 is required for
2ccf0 20 65 61 63 68 20 6a 6f 75 72 6e 61 6c 20 66 69 each journal fi
2cd00 6c 65 2d 68 61 6e 64 6c 65 0a 20 20 2a 2a 20 28 le-handle. ** (
2cd10 74 68 65 72 65 20 61 72 65 20 74 77 6f 20 6f 66 there are two of
2cd20 20 74 68 65 6d 2c 20 74 68 65 20 6d 61 69 6e 20 them, the main
2cd30 6a 6f 75 72 6e 61 6c 20 61 6e 64 20 74 68 65 20 journal and the
2cd40 73 75 62 2d 6a 6f 75 72 6e 61 6c 29 2e 20 20 2a sub-journal). *
2cd50 2f 0a 20 20 6a 6f 75 72 6e 61 6c 46 69 6c 65 53 /. journalFileS
2cd60 69 7a 65 20 3d 20 52 4f 55 4e 44 38 28 73 71 6c ize = ROUND8(sql
2cd70 69 74 65 33 4a 6f 75 72 6e 61 6c 53 69 7a 65 28 ite3JournalSize(
2cd80 70 56 66 73 29 29 3b 0a 0a 20 20 2f 2a 20 53 65 pVfs));.. /* Se
2cd90 74 20 74 68 65 20 6f 75 74 70 75 74 20 76 61 72 t the output var
2cda0 69 61 62 6c 65 20 74 6f 20 4e 55 4c 4c 20 69 6e iable to NULL in
2cdb0 20 63 61 73 65 20 61 6e 20 65 72 72 6f 72 20 6f case an error o
2cdc0 63 63 75 72 73 2e 20 2a 2f 0a 20 20 2a 70 70 50 ccurs. */. *ppP
2cdd0 61 67 65 72 20 3d 20 30 3b 0a 0a 23 69 66 6e 64 ager = 0;..#ifnd
2cde0 65 66 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 4d ef SQLITE_OMIT_M
2cdf0 45 4d 4f 52 59 44 42 0a 20 20 69 66 28 20 66 6c EMORYDB. if( fl
2ce00 61 67 73 20 26 20 50 41 47 45 52 5f 4d 45 4d 4f ags & PAGER_MEMO
2ce10 52 59 20 29 7b 0a 20 20 20 20 6d 65 6d 44 62 20 RY ){. memDb
2ce20 3d 20 31 3b 0a 20 20 20 20 69 66 28 20 7a 46 69 = 1;. if( zFi
2ce30 6c 65 6e 61 6d 65 20 26 26 20 7a 46 69 6c 65 6e lename && zFilen
2ce40 61 6d 65 5b 30 5d 20 29 7b 0a 20 20 20 20 20 20 ame[0] ){.
2ce50 7a 50 61 74 68 6e 61 6d 65 20 3d 20 73 71 6c 69 zPathname = sqli
2ce60 74 65 33 44 62 53 74 72 44 75 70 28 30 2c 20 7a te3DbStrDup(0, z
2ce70 46 69 6c 65 6e 61 6d 65 29 3b 0a 20 20 20 20 20 Filename);.
2ce80 20 69 66 28 20 7a 50 61 74 68 6e 61 6d 65 3d 3d if( zPathname==
2ce90 30 20 20 29 20 72 65 74 75 72 6e 20 53 51 4c 49 0 ) return SQLI
2cea0 54 45 5f 4e 4f 4d 45 4d 5f 42 4b 50 54 3b 0a 20 TE_NOMEM_BKPT;.
2ceb0 20 20 20 20 20 6e 50 61 74 68 6e 61 6d 65 20 3d nPathname =
2cec0 20 73 71 6c 69 74 65 33 53 74 72 6c 65 6e 33 30 sqlite3Strlen30
2ced0 28 7a 50 61 74 68 6e 61 6d 65 29 3b 0a 20 20 20 (zPathname);.
2cee0 20 20 20 7a 46 69 6c 65 6e 61 6d 65 20 3d 20 30 zFilename = 0
2cef0 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a 23 65 6e 64 ;. }. }.#end
2cf00 69 66 0a 0a 20 20 2f 2a 20 43 6f 6d 70 75 74 65 if.. /* Compute
2cf10 20 61 6e 64 20 73 74 6f 72 65 20 74 68 65 20 66 and store the f
2cf20 75 6c 6c 20 70 61 74 68 6e 61 6d 65 20 69 6e 20 ull pathname in
2cf30 61 6e 20 61 6c 6c 6f 63 61 74 65 64 20 62 75 66 an allocated buf
2cf40 66 65 72 20 70 6f 69 6e 74 65 64 0a 20 20 2a 2a fer pointed. **
2cf50 20 74 6f 20 62 79 20 7a 50 61 74 68 6e 61 6d 65 to by zPathname
2cf60 2c 20 6c 65 6e 67 74 68 20 6e 50 61 74 68 6e 61 , length nPathna
2cf70 6d 65 2e 20 4f 72 2c 20 69 66 20 74 68 69 73 20 me. Or, if this
2cf80 69 73 20 61 20 74 65 6d 70 6f 72 61 72 79 20 66 is a temporary f
2cf90 69 6c 65 2c 0a 20 20 2a 2a 20 6c 65 61 76 65 20 ile,. ** leave
2cfa0 62 6f 74 68 20 6e 50 61 74 68 6e 61 6d 65 20 61 both nPathname a
2cfb0 6e 64 20 7a 50 61 74 68 6e 61 6d 65 20 73 65 74 nd zPathname set
2cfc0 20 74 6f 20 30 2e 0a 20 20 2a 2f 0a 20 20 69 66 to 0.. */. if
2cfd0 28 20 7a 46 69 6c 65 6e 61 6d 65 20 26 26 20 7a ( zFilename && z
2cfe0 46 69 6c 65 6e 61 6d 65 5b 30 5d 20 29 7b 0a 20 Filename[0] ){.
2cff0 20 20 20 63 6f 6e 73 74 20 63 68 61 72 20 2a 7a const char *z
2d000 3b 0a 20 20 20 20 6e 50 61 74 68 6e 61 6d 65 20 ;. nPathname
2d010 3d 20 70 56 66 73 2d 3e 6d 78 50 61 74 68 6e 61 = pVfs->mxPathna
2d020 6d 65 2b 31 3b 0a 20 20 20 20 7a 50 61 74 68 6e me+1;. zPathn
2d030 61 6d 65 20 3d 20 73 71 6c 69 74 65 33 44 62 4d ame = sqlite3DbM
2d040 61 6c 6c 6f 63 52 61 77 28 30 2c 20 6e 50 61 74 allocRaw(0, nPat
2d050 68 6e 61 6d 65 2a 32 29 3b 0a 20 20 20 20 69 66 hname*2);. if
2d060 28 20 7a 50 61 74 68 6e 61 6d 65 3d 3d 30 20 29 ( zPathname==0 )
2d070 7b 0a 20 20 20 20 20 20 72 65 74 75 72 6e 20 53 {. return S
2d080 51 4c 49 54 45 5f 4e 4f 4d 45 4d 5f 42 4b 50 54 QLITE_NOMEM_BKPT
2d090 3b 0a 20 20 20 20 7d 0a 20 20 20 20 7a 50 61 74 ;. }. zPat
2d0a0 68 6e 61 6d 65 5b 30 5d 20 3d 20 30 3b 20 2f 2a hname[0] = 0; /*
2d0b0 20 4d 61 6b 65 20 73 75 72 65 20 69 6e 69 74 69 Make sure initi
2d0c0 61 6c 69 7a 65 64 20 65 76 65 6e 20 69 66 20 46 alized even if F
2d0d0 75 6c 6c 50 61 74 68 6e 61 6d 65 28 29 20 66 61 ullPathname() fa
2d0e0 69 6c 73 20 2a 2f 0a 20 20 20 20 72 63 20 3d 20 ils */. rc =
2d0f0 73 71 6c 69 74 65 33 4f 73 46 75 6c 6c 50 61 74 sqlite3OsFullPat
2d100 68 6e 61 6d 65 28 70 56 66 73 2c 20 7a 46 69 6c hname(pVfs, zFil
2d110 65 6e 61 6d 65 2c 20 6e 50 61 74 68 6e 61 6d 65 ename, nPathname
2d120 2c 20 7a 50 61 74 68 6e 61 6d 65 29 3b 0a 20 20 , zPathname);.
2d130 20 20 6e 50 61 74 68 6e 61 6d 65 20 3d 20 73 71 nPathname = sq
2d140 6c 69 74 65 33 53 74 72 6c 65 6e 33 30 28 7a 50 lite3Strlen30(zP
2d150 61 74 68 6e 61 6d 65 29 3b 0a 20 20 20 20 7a 20 athname);. z
2d160 3d 20 7a 55 72 69 20 3d 20 26 7a 46 69 6c 65 6e = zUri = &zFilen
2d170 61 6d 65 5b 73 71 6c 69 74 65 33 53 74 72 6c 65 ame[sqlite3Strle
2d180 6e 33 30 28 7a 46 69 6c 65 6e 61 6d 65 29 2b 31 n30(zFilename)+1
2d190 5d 3b 0a 20 20 20 20 77 68 69 6c 65 28 20 2a 7a ];. while( *z
2d1a0 20 29 7b 0a 20 20 20 20 20 20 7a 20 2b 3d 20 73 ){. z += s
2d1b0 71 6c 69 74 65 33 53 74 72 6c 65 6e 33 30 28 7a qlite3Strlen30(z
2d1c0 29 2b 31 3b 0a 20 20 20 20 20 20 7a 20 2b 3d 20 )+1;. z +=
2d1d0 73 71 6c 69 74 65 33 53 74 72 6c 65 6e 33 30 28 sqlite3Strlen30(
2d1e0 7a 29 2b 31 3b 0a 20 20 20 20 7d 0a 20 20 20 20 z)+1;. }.
2d1f0 6e 55 72 69 20 3d 20 28 69 6e 74 29 28 26 7a 5b nUri = (int)(&z[
2d200 31 5d 20 2d 20 7a 55 72 69 29 3b 0a 20 20 20 20 1] - zUri);.
2d210 61 73 73 65 72 74 28 20 6e 55 72 69 3e 3d 30 20 assert( nUri>=0
2d220 29 3b 0a 20 20 20 20 69 66 28 20 72 63 3d 3d 53 );. if( rc==S
2d230 51 4c 49 54 45 5f 4f 4b 20 26 26 20 6e 50 61 74 QLITE_OK && nPat
2d240 68 6e 61 6d 65 2b 38 3e 70 56 66 73 2d 3e 6d 78 hname+8>pVfs->mx
2d250 50 61 74 68 6e 61 6d 65 20 29 7b 0a 20 20 20 20 Pathname ){.
2d260 20 20 2f 2a 20 54 68 69 73 20 62 72 61 6e 63 68 /* This branch
2d270 20 69 73 20 74 61 6b 65 6e 20 77 68 65 6e 20 74 is taken when t
2d280 68 65 20 6a 6f 75 72 6e 61 6c 20 70 61 74 68 20 he journal path
2d290 72 65 71 75 69 72 65 64 20 62 79 0a 20 20 20 20 required by.
2d2a0 20 20 2a 2a 20 74 68 65 20 64 61 74 61 62 61 73 ** the databas
2d2b0 65 20 62 65 69 6e 67 20 6f 70 65 6e 65 64 20 77 e being opened w
2d2c0 69 6c 6c 20 62 65 20 6d 6f 72 65 20 74 68 61 6e ill be more than
2d2d0 20 70 56 66 73 2d 3e 6d 78 50 61 74 68 6e 61 6d pVfs->mxPathnam
2d2e0 65 0a 20 20 20 20 20 20 2a 2a 20 62 79 74 65 73 e. ** bytes
2d2f0 20 69 6e 20 6c 65 6e 67 74 68 2e 20 54 68 69 73 in length. This
2d300 20 6d 65 61 6e 73 20 74 68 65 20 64 61 74 61 62 means the datab
2d310 61 73 65 20 63 61 6e 6e 6f 74 20 62 65 20 6f 70 ase cannot be op
2d320 65 6e 65 64 2c 0a 20 20 20 20 20 20 2a 2a 20 61 ened,. ** a
2d330 73 20 69 74 20 77 69 6c 6c 20 6e 6f 74 20 62 65 s it will not be
2d340 20 70 6f 73 73 69 62 6c 65 20 74 6f 20 6f 70 65 possible to ope
2d350 6e 20 74 68 65 20 6a 6f 75 72 6e 61 6c 20 66 69 n the journal fi
2d360 6c 65 20 6f 72 20 65 76 65 6e 0a 20 20 20 20 20 le or even.
2d370 20 2a 2a 20 63 68 65 63 6b 20 66 6f 72 20 61 20 ** check for a
2d380 68 6f 74 2d 6a 6f 75 72 6e 61 6c 20 62 65 66 6f hot-journal befo
2d390 72 65 20 72 65 61 64 69 6e 67 2e 0a 20 20 20 20 re reading..
2d3a0 20 20 2a 2f 0a 20 20 20 20 20 20 72 63 20 3d 20 */. rc =
2d3b0 53 51 4c 49 54 45 5f 43 41 4e 54 4f 50 45 4e 5f SQLITE_CANTOPEN_
2d3c0 42 4b 50 54 3b 0a 20 20 20 20 7d 0a 20 20 20 20 BKPT;. }.
2d3d0 69 66 28 20 72 63 21 3d 53 51 4c 49 54 45 5f 4f if( rc!=SQLITE_O
2d3e0 4b 20 29 7b 0a 20 20 20 20 20 20 73 71 6c 69 74 K ){. sqlit
2d3f0 65 33 44 62 46 72 65 65 28 30 2c 20 7a 50 61 74 e3DbFree(0, zPat
2d400 68 6e 61 6d 65 29 3b 0a 20 20 20 20 20 20 72 65 hname);. re
2d410 74 75 72 6e 20 72 63 3b 0a 20 20 20 20 7d 0a 20 turn rc;. }.
2d420 20 7d 0a 0a 20 20 2f 2a 20 41 6c 6c 6f 63 61 74 }.. /* Allocat
2d430 65 20 6d 65 6d 6f 72 79 20 66 6f 72 20 74 68 65 e memory for the
2d440 20 50 61 67 65 72 20 73 74 72 75 63 74 75 72 65 Pager structure
2d450 2c 20 50 43 61 63 68 65 20 6f 62 6a 65 63 74 2c , PCache object,
2d460 20 74 68 65 0a 20 20 2a 2a 20 74 68 72 65 65 20 the. ** three
2d470 66 69 6c 65 20 64 65 73 63 72 69 70 74 6f 72 73 file descriptors
2d480 2c 20 74 68 65 20 64 61 74 61 62 61 73 65 20 66 , the database f
2d490 69 6c 65 20 6e 61 6d 65 20 61 6e 64 20 74 68 65 ile name and the
2d4a0 20 6a 6f 75 72 6e 61 6c 20 0a 20 20 2a 2a 20 66 journal . ** f
2d4b0 69 6c 65 20 6e 61 6d 65 2e 20 54 68 65 20 6c 61 ile name. The la
2d4c0 79 6f 75 74 20 69 6e 20 6d 65 6d 6f 72 79 20 69 yout in memory i
2d4d0 73 20 61 73 20 66 6f 6c 6c 6f 77 73 3a 0a 20 20 s as follows:.
2d4e0 2a 2a 0a 20 20 2a 2a 20 20 20 20 20 50 61 67 65 **. ** Page
2d4f0 72 20 6f 62 6a 65 63 74 20 20 20 20 20 20 20 20 r object
2d500 20 20 20 20 20 20 20 20 20 20 20 20 28 73 69 7a (siz
2d510 65 6f 66 28 50 61 67 65 72 29 20 62 79 74 65 73 eof(Pager) bytes
2d520 29 0a 20 20 2a 2a 20 20 20 20 20 50 43 61 63 68 ). ** PCach
2d530 65 20 6f 62 6a 65 63 74 20 20 20 20 20 20 20 20 e object
2d540 20 20 20 20 20 20 20 20 20 20 20 28 73 71 6c 69 (sqli
2d550 74 65 33 50 63 61 63 68 65 53 69 7a 65 28 29 20 te3PcacheSize()
2d560 62 79 74 65 73 29 0a 20 20 2a 2a 20 20 20 20 20 bytes). **
2d570 44 61 74 61 62 61 73 65 20 66 69 6c 65 20 68 61 Database file ha
2d580 6e 64 6c 65 20 20 20 20 20 20 20 20 20 20 20 20 ndle
2d590 28 70 56 66 73 2d 3e 73 7a 4f 73 46 69 6c 65 20 (pVfs->szOsFile
2d5a0 62 79 74 65 73 29 0a 20 20 2a 2a 20 20 20 20 20 bytes). **
2d5b0 53 75 62 2d 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 Sub-journal file
2d5c0 20 68 61 6e 64 6c 65 20 20 20 20 20 20 20 20 20 handle
2d5d0 28 6a 6f 75 72 6e 61 6c 46 69 6c 65 53 69 7a 65 (journalFileSize
2d5e0 20 62 79 74 65 73 29 0a 20 20 2a 2a 20 20 20 20 bytes). **
2d5f0 20 4d 61 69 6e 20 6a 6f 75 72 6e 61 6c 20 66 69 Main journal fi
2d600 6c 65 20 68 61 6e 64 6c 65 20 20 20 20 20 20 20 le handle
2d610 20 28 6a 6f 75 72 6e 61 6c 46 69 6c 65 53 69 7a (journalFileSiz
2d620 65 20 62 79 74 65 73 29 0a 20 20 2a 2a 20 20 20 e bytes). **
2d630 20 20 44 61 74 61 62 61 73 65 20 66 69 6c 65 20 Database file
2d640 6e 61 6d 65 20 20 20 20 20 20 20 20 20 20 20 20 name
2d650 20 20 28 6e 50 61 74 68 6e 61 6d 65 2b 31 20 62 (nPathname+1 b
2d660 79 74 65 73 29 0a 20 20 2a 2a 20 20 20 20 20 4a ytes). ** J
2d670 6f 75 72 6e 61 6c 20 66 69 6c 65 20 6e 61 6d 65 ournal file name
2d680 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 (
2d690 6e 50 61 74 68 6e 61 6d 65 2b 38 2b 31 20 62 79 nPathname+8+1 by
2d6a0 74 65 73 29 0a 20 20 2a 2f 0a 20 20 70 50 74 72 tes). */. pPtr
2d6b0 20 3d 20 28 75 38 20 2a 29 73 71 6c 69 74 65 33 = (u8 *)sqlite3
2d6c0 4d 61 6c 6c 6f 63 5a 65 72 6f 28 0a 20 20 20 20 MallocZero(.
2d6d0 52 4f 55 4e 44 38 28 73 69 7a 65 6f 66 28 2a 70 ROUND8(sizeof(*p
2d6e0 50 61 67 65 72 29 29 20 2b 20 20 20 20 20 20 2f Pager)) + /
2d6f0 2a 20 50 61 67 65 72 20 73 74 72 75 63 74 75 72 * Pager structur
2d700 65 20 2a 2f 0a 20 20 20 20 52 4f 55 4e 44 38 28 e */. ROUND8(
2d710 70 63 61 63 68 65 53 69 7a 65 29 20 2b 20 20 20 pcacheSize) +
2d720 20 20 20 20 20 20 20 20 2f 2a 20 50 43 61 63 68 /* PCach
2d730 65 20 6f 62 6a 65 63 74 20 2a 2f 0a 20 20 20 20 e object */.
2d740 52 4f 55 4e 44 38 28 70 56 66 73 2d 3e 73 7a 4f ROUND8(pVfs->szO
2d750 73 46 69 6c 65 29 20 2b 20 20 20 20 20 20 20 2f sFile) + /
2d760 2a 20 54 68 65 20 6d 61 69 6e 20 64 62 20 66 69 * The main db fi
2d770 6c 65 20 2a 2f 0a 20 20 20 20 6a 6f 75 72 6e 61 le */. journa
2d780 6c 46 69 6c 65 53 69 7a 65 20 2a 20 32 20 2b 20 lFileSize * 2 +
2d790 20 20 20 20 20 20 20 20 20 2f 2a 20 54 68 65 20 /* The
2d7a0 74 77 6f 20 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 two journal file
2d7b0 73 20 2a 2f 20 0a 20 20 20 20 6e 50 61 74 68 6e s */ . nPathn
2d7c0 61 6d 65 20 2b 20 31 20 2b 20 6e 55 72 69 20 2b ame + 1 + nUri +
2d7d0 20 20 20 20 20 20 20 20 20 2f 2a 20 7a 46 69 6c /* zFil
2d7e0 65 6e 61 6d 65 20 2a 2f 0a 20 20 20 20 6e 50 61 ename */. nPa
2d7f0 74 68 6e 61 6d 65 20 2b 20 38 20 2b 20 32 20 20 thname + 8 + 2
2d800 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 7a /* z
2d810 4a 6f 75 72 6e 61 6c 20 2a 2f 0a 23 69 66 6e 64 Journal */.#ifnd
2d820 65 66 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 57 ef SQLITE_OMIT_W
2d830 41 4c 0a 20 20 20 20 2b 20 6e 50 61 74 68 6e 61 AL. + nPathna
2d840 6d 65 20 2b 20 34 20 2b 20 32 20 20 20 20 20 20 me + 4 + 2
2d850 20 20 20 20 20 20 2f 2a 20 7a 57 61 6c 20 2a 2f /* zWal */
2d860 0a 23 65 6e 64 69 66 0a 20 20 29 3b 0a 20 20 61 .#endif. );. a
2d870 73 73 65 72 74 28 20 45 49 47 48 54 5f 42 59 54 ssert( EIGHT_BYT
2d880 45 5f 41 4c 49 47 4e 4d 45 4e 54 28 53 51 4c 49 E_ALIGNMENT(SQLI
2d890 54 45 5f 49 4e 54 5f 54 4f 5f 50 54 52 28 6a 6f TE_INT_TO_PTR(jo
2d8a0 75 72 6e 61 6c 46 69 6c 65 53 69 7a 65 29 29 20 urnalFileSize))
2d8b0 29 3b 0a 20 20 69 66 28 20 21 70 50 74 72 20 29 );. if( !pPtr )
2d8c0 7b 0a 20 20 20 20 73 71 6c 69 74 65 33 44 62 46 {. sqlite3DbF
2d8d0 72 65 65 28 30 2c 20 7a 50 61 74 68 6e 61 6d 65 ree(0, zPathname
2d8e0 29 3b 0a 20 20 20 20 72 65 74 75 72 6e 20 53 51 );. return SQ
2d8f0 4c 49 54 45 5f 4e 4f 4d 45 4d 5f 42 4b 50 54 3b LITE_NOMEM_BKPT;
2d900 0a 20 20 7d 0a 20 20 70 50 61 67 65 72 20 3d 20 . }. pPager =
2d910 20 20 20 20 20 20 20 20 20 20 20 20 20 28 50 61 (Pa
2d920 67 65 72 2a 29 28 70 50 74 72 29 3b 0a 20 20 70 ger*)(pPtr);. p
2d930 50 61 67 65 72 2d 3e 70 50 43 61 63 68 65 20 3d Pager->pPCache =
2d940 20 20 20 20 28 50 43 61 63 68 65 2a 29 28 70 50 (PCache*)(pP
2d950 74 72 20 2b 3d 20 52 4f 55 4e 44 38 28 73 69 7a tr += ROUND8(siz
2d960 65 6f 66 28 2a 70 50 61 67 65 72 29 29 29 3b 0a eof(*pPager)));.
2d970 20 20 70 50 61 67 65 72 2d 3e 66 64 20 3d 20 20 pPager->fd =
2d980 20 28 73 71 6c 69 74 65 33 5f 66 69 6c 65 2a 29 (sqlite3_file*)
2d990 28 70 50 74 72 20 2b 3d 20 52 4f 55 4e 44 38 28 (pPtr += ROUND8(
2d9a0 70 63 61 63 68 65 53 69 7a 65 29 29 3b 0a 20 20 pcacheSize));.
2d9b0 70 50 61 67 65 72 2d 3e 73 6a 66 64 20 3d 20 28 pPager->sjfd = (
2d9c0 73 71 6c 69 74 65 33 5f 66 69 6c 65 2a 29 28 70 sqlite3_file*)(p
2d9d0 50 74 72 20 2b 3d 20 52 4f 55 4e 44 38 28 70 56 Ptr += ROUND8(pV
2d9e0 66 73 2d 3e 73 7a 4f 73 46 69 6c 65 29 29 3b 0a fs->szOsFile));.
2d9f0 20 20 70 50 61 67 65 72 2d 3e 6a 66 64 20 3d 20 pPager->jfd =
2da00 20 28 73 71 6c 69 74 65 33 5f 66 69 6c 65 2a 29 (sqlite3_file*)
2da10 28 70 50 74 72 20 2b 3d 20 6a 6f 75 72 6e 61 6c (pPtr += journal
2da20 46 69 6c 65 53 69 7a 65 29 3b 0a 20 20 70 50 61 FileSize);. pPa
2da30 67 65 72 2d 3e 7a 46 69 6c 65 6e 61 6d 65 20 3d ger->zFilename =
2da40 20 20 20 20 28 63 68 61 72 2a 29 28 70 50 74 72 (char*)(pPtr
2da50 20 2b 3d 20 6a 6f 75 72 6e 61 6c 46 69 6c 65 53 += journalFileS
2da60 69 7a 65 29 3b 0a 20 20 61 73 73 65 72 74 28 20 ize);. assert(
2da70 45 49 47 48 54 5f 42 59 54 45 5f 41 4c 49 47 4e EIGHT_BYTE_ALIGN
2da80 4d 45 4e 54 28 70 50 61 67 65 72 2d 3e 6a 66 64 MENT(pPager->jfd
2da90 29 20 29 3b 0a 0a 20 20 2f 2a 20 46 69 6c 6c 20 ) );.. /* Fill
2daa0 69 6e 20 74 68 65 20 50 61 67 65 72 2e 7a 46 69 in the Pager.zFi
2dab0 6c 65 6e 61 6d 65 20 61 6e 64 20 50 61 67 65 72 lename and Pager
2dac0 2e 7a 4a 6f 75 72 6e 61 6c 20 62 75 66 66 65 72 .zJournal buffer
2dad0 73 2c 20 69 66 20 72 65 71 75 69 72 65 64 2e 20 s, if required.
2dae0 2a 2f 0a 20 20 69 66 28 20 7a 50 61 74 68 6e 61 */. if( zPathna
2daf0 6d 65 20 29 7b 0a 20 20 20 20 61 73 73 65 72 74 me ){. assert
2db00 28 20 6e 50 61 74 68 6e 61 6d 65 3e 30 20 29 3b ( nPathname>0 );
2db10 0a 20 20 20 20 70 50 61 67 65 72 2d 3e 7a 4a 6f . pPager->zJo
2db20 75 72 6e 61 6c 20 3d 20 20 20 28 63 68 61 72 2a urnal = (char*
2db30 29 28 70 50 74 72 20 2b 3d 20 6e 50 61 74 68 6e )(pPtr += nPathn
2db40 61 6d 65 20 2b 20 31 20 2b 20 6e 55 72 69 29 3b ame + 1 + nUri);
2db50 0a 20 20 20 20 6d 65 6d 63 70 79 28 70 50 61 67 . memcpy(pPag
2db60 65 72 2d 3e 7a 46 69 6c 65 6e 61 6d 65 2c 20 7a er->zFilename, z
2db70 50 61 74 68 6e 61 6d 65 2c 20 6e 50 61 74 68 6e Pathname, nPathn
2db80 61 6d 65 29 3b 0a 20 20 20 20 69 66 28 20 6e 55 ame);. if( nU
2db90 72 69 20 29 20 6d 65 6d 63 70 79 28 26 70 50 61 ri ) memcpy(&pPa
2dba0 67 65 72 2d 3e 7a 46 69 6c 65 6e 61 6d 65 5b 6e ger->zFilename[n
2dbb0 50 61 74 68 6e 61 6d 65 2b 31 5d 2c 20 7a 55 72 Pathname+1], zUr
2dbc0 69 2c 20 6e 55 72 69 29 3b 0a 20 20 20 20 6d 65 i, nUri);. me
2dbd0 6d 63 70 79 28 70 50 61 67 65 72 2d 3e 7a 4a 6f mcpy(pPager->zJo
2dbe0 75 72 6e 61 6c 2c 20 7a 50 61 74 68 6e 61 6d 65 urnal, zPathname
2dbf0 2c 20 6e 50 61 74 68 6e 61 6d 65 29 3b 0a 20 20 , nPathname);.
2dc00 20 20 6d 65 6d 63 70 79 28 26 70 50 61 67 65 72 memcpy(&pPager
2dc10 2d 3e 7a 4a 6f 75 72 6e 61 6c 5b 6e 50 61 74 68 ->zJournal[nPath
2dc20 6e 61 6d 65 5d 2c 20 22 2d 6a 6f 75 72 6e 61 6c name], "-journal
2dc30 5c 30 30 30 22 2c 20 38 2b 32 29 3b 0a 20 20 20 \000", 8+2);.
2dc40 20 73 71 6c 69 74 65 33 46 69 6c 65 53 75 66 66 sqlite3FileSuff
2dc50 69 78 33 28 70 50 61 67 65 72 2d 3e 7a 46 69 6c ix3(pPager->zFil
2dc60 65 6e 61 6d 65 2c 20 70 50 61 67 65 72 2d 3e 7a ename, pPager->z
2dc70 4a 6f 75 72 6e 61 6c 29 3b 0a 23 69 66 6e 64 65 Journal);.#ifnde
2dc80 66 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 57 41 f SQLITE_OMIT_WA
2dc90 4c 0a 20 20 20 20 70 50 61 67 65 72 2d 3e 7a 57 L. pPager->zW
2dca0 61 6c 20 3d 20 26 70 50 61 67 65 72 2d 3e 7a 4a al = &pPager->zJ
2dcb0 6f 75 72 6e 61 6c 5b 6e 50 61 74 68 6e 61 6d 65 ournal[nPathname
2dcc0 2b 38 2b 31 5d 3b 0a 20 20 20 20 6d 65 6d 63 70 +8+1];. memcp
2dcd0 79 28 70 50 61 67 65 72 2d 3e 7a 57 61 6c 2c 20 y(pPager->zWal,
2dce0 7a 50 61 74 68 6e 61 6d 65 2c 20 6e 50 61 74 68 zPathname, nPath
2dcf0 6e 61 6d 65 29 3b 0a 20 20 20 20 6d 65 6d 63 70 name);. memcp
2dd00 79 28 26 70 50 61 67 65 72 2d 3e 7a 57 61 6c 5b y(&pPager->zWal[
2dd10 6e 50 61 74 68 6e 61 6d 65 5d 2c 20 22 2d 77 61 nPathname], "-wa
2dd20 6c 5c 30 30 30 22 2c 20 34 2b 31 29 3b 0a 20 20 l\000", 4+1);.
2dd30 20 20 73 71 6c 69 74 65 33 46 69 6c 65 53 75 66 sqlite3FileSuf
2dd40 66 69 78 33 28 70 50 61 67 65 72 2d 3e 7a 46 69 fix3(pPager->zFi
2dd50 6c 65 6e 61 6d 65 2c 20 70 50 61 67 65 72 2d 3e lename, pPager->
2dd60 7a 57 61 6c 29 3b 0a 23 65 6e 64 69 66 0a 20 20 zWal);.#endif.
2dd70 20 20 73 71 6c 69 74 65 33 44 62 46 72 65 65 28 sqlite3DbFree(
2dd80 30 2c 20 7a 50 61 74 68 6e 61 6d 65 29 3b 0a 20 0, zPathname);.
2dd90 20 7d 0a 20 20 70 50 61 67 65 72 2d 3e 70 56 66 }. pPager->pVf
2dda0 73 20 3d 20 70 56 66 73 3b 0a 20 20 70 50 61 67 s = pVfs;. pPag
2ddb0 65 72 2d 3e 76 66 73 46 6c 61 67 73 20 3d 20 76 er->vfsFlags = v
2ddc0 66 73 46 6c 61 67 73 3b 0a 0a 20 20 2f 2a 20 4f fsFlags;.. /* O
2ddd0 70 65 6e 20 74 68 65 20 70 61 67 65 72 20 66 69 pen the pager fi
2dde0 6c 65 2e 0a 20 20 2a 2f 0a 20 20 69 66 28 20 7a le.. */. if( z
2ddf0 46 69 6c 65 6e 61 6d 65 20 26 26 20 7a 46 69 6c Filename && zFil
2de00 65 6e 61 6d 65 5b 30 5d 20 29 7b 0a 20 20 20 20 ename[0] ){.
2de10 69 6e 74 20 66 6f 75 74 20 3d 20 30 3b 20 20 20 int fout = 0;
2de20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
2de30 20 2f 2a 20 56 46 53 20 66 6c 61 67 73 20 72 65 /* VFS flags re
2de40 74 75 72 6e 65 64 20 62 79 20 78 4f 70 65 6e 28 turned by xOpen(
2de50 29 20 2a 2f 0a 20 20 20 20 72 63 20 3d 20 73 71 ) */. rc = sq
2de60 6c 69 74 65 33 4f 73 4f 70 65 6e 28 70 56 66 73 lite3OsOpen(pVfs
2de70 2c 20 70 50 61 67 65 72 2d 3e 7a 46 69 6c 65 6e , pPager->zFilen
2de80 61 6d 65 2c 20 70 50 61 67 65 72 2d 3e 66 64 2c ame, pPager->fd,
2de90 20 76 66 73 46 6c 61 67 73 2c 20 26 66 6f 75 74 vfsFlags, &fout
2dea0 29 3b 0a 20 20 20 20 61 73 73 65 72 74 28 20 21 );. assert( !
2deb0 6d 65 6d 44 62 20 29 3b 0a 20 20 20 20 72 65 61 memDb );. rea
2dec0 64 4f 6e 6c 79 20 3d 20 28 66 6f 75 74 26 53 51 dOnly = (fout&SQ
2ded0 4c 49 54 45 5f 4f 50 45 4e 5f 52 45 41 44 4f 4e LITE_OPEN_READON
2dee0 4c 59 29 3b 0a 0a 20 20 20 20 2f 2a 20 49 66 20 LY);.. /* If
2def0 74 68 65 20 66 69 6c 65 20 77 61 73 20 73 75 63 the file was suc
2df00 63 65 73 73 66 75 6c 6c 79 20 6f 70 65 6e 65 64 cessfully opened
2df10 20 66 6f 72 20 72 65 61 64 2f 77 72 69 74 65 20 for read/write
2df20 61 63 63 65 73 73 2c 0a 20 20 20 20 2a 2a 20 63 access,. ** c
2df30 68 6f 6f 73 65 20 61 20 64 65 66 61 75 6c 74 20 hoose a default
2df40 70 61 67 65 20 73 69 7a 65 20 69 6e 20 63 61 73 page size in cas
2df50 65 20 77 65 20 68 61 76 65 20 74 6f 20 63 72 65 e we have to cre
2df60 61 74 65 20 74 68 65 0a 20 20 20 20 2a 2a 20 64 ate the. ** d
2df70 61 74 61 62 61 73 65 20 66 69 6c 65 2e 20 54 68 atabase file. Th
2df80 65 20 64 65 66 61 75 6c 74 20 70 61 67 65 20 73 e default page s
2df90 69 7a 65 20 69 73 20 74 68 65 20 6d 61 78 69 6d ize is the maxim
2dfa0 75 6d 20 6f 66 3a 0a 20 20 20 20 2a 2a 0a 20 20 um of:. **.
2dfb0 20 20 2a 2a 20 20 20 20 2b 20 53 51 4c 49 54 45 ** + SQLITE
2dfc0 5f 44 45 46 41 55 4c 54 5f 50 41 47 45 5f 53 49 _DEFAULT_PAGE_SI
2dfd0 5a 45 2c 0a 20 20 20 20 2a 2a 20 20 20 20 2b 20 ZE,. ** +
2dfe0 54 68 65 20 76 61 6c 75 65 20 72 65 74 75 72 6e The value return
2dff0 65 64 20 62 79 20 73 71 6c 69 74 65 33 4f 73 53 ed by sqlite3OsS
2e000 65 63 74 6f 72 53 69 7a 65 28 29 0a 20 20 20 20 ectorSize().
2e010 2a 2a 20 20 20 20 2b 20 54 68 65 20 6c 61 72 67 ** + The larg
2e020 65 73 74 20 70 61 67 65 20 73 69 7a 65 20 74 68 est page size th
2e030 61 74 20 63 61 6e 20 62 65 20 77 72 69 74 74 65 at can be writte
2e040 6e 20 61 74 6f 6d 69 63 61 6c 6c 79 2e 0a 20 20 n atomically..
2e050 20 20 2a 2f 0a 20 20 20 20 69 66 28 20 72 63 3d */. if( rc=
2e060 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 =SQLITE_OK ){.
2e070 20 20 20 20 69 6e 74 20 69 44 63 20 3d 20 73 71 int iDc = sq
2e080 6c 69 74 65 33 4f 73 44 65 76 69 63 65 43 68 61 lite3OsDeviceCha
2e090 72 61 63 74 65 72 69 73 74 69 63 73 28 70 50 61 racteristics(pPa
2e0a0 67 65 72 2d 3e 66 64 29 3b 0a 20 20 20 20 20 20 ger->fd);.
2e0b0 69 66 28 20 21 72 65 61 64 4f 6e 6c 79 20 29 7b if( !readOnly ){
2e0c0 0a 20 20 20 20 20 20 20 20 73 65 74 53 65 63 74 . setSect
2e0d0 6f 72 53 69 7a 65 28 70 50 61 67 65 72 29 3b 0a orSize(pPager);.
2e0e0 20 20 20 20 20 20 20 20 61 73 73 65 72 74 28 53 assert(S
2e0f0 51 4c 49 54 45 5f 44 45 46 41 55 4c 54 5f 50 41 QLITE_DEFAULT_PA
2e100 47 45 5f 53 49 5a 45 3c 3d 53 51 4c 49 54 45 5f GE_SIZE<=SQLITE_
2e110 4d 41 58 5f 44 45 46 41 55 4c 54 5f 50 41 47 45 MAX_DEFAULT_PAGE
2e120 5f 53 49 5a 45 29 3b 0a 20 20 20 20 20 20 20 20 _SIZE);.
2e130 69 66 28 20 73 7a 50 61 67 65 44 66 6c 74 3c 70 if( szPageDflt<p
2e140 50 61 67 65 72 2d 3e 73 65 63 74 6f 72 53 69 7a Pager->sectorSiz
2e150 65 20 29 7b 0a 20 20 20 20 20 20 20 20 20 20 69 e ){. i
2e160 66 28 20 70 50 61 67 65 72 2d 3e 73 65 63 74 6f f( pPager->secto
2e170 72 53 69 7a 65 3e 53 51 4c 49 54 45 5f 4d 41 58 rSize>SQLITE_MAX
2e180 5f 44 45 46 41 55 4c 54 5f 50 41 47 45 5f 53 49 _DEFAULT_PAGE_SI
2e190 5a 45 20 29 7b 0a 20 20 20 20 20 20 20 20 20 20 ZE ){.
2e1a0 20 20 73 7a 50 61 67 65 44 66 6c 74 20 3d 20 53 szPageDflt = S
2e1b0 51 4c 49 54 45 5f 4d 41 58 5f 44 45 46 41 55 4c QLITE_MAX_DEFAUL
2e1c0 54 5f 50 41 47 45 5f 53 49 5a 45 3b 0a 20 20 20 T_PAGE_SIZE;.
2e1d0 20 20 20 20 20 20 20 7d 65 6c 73 65 7b 0a 20 20 }else{.
2e1e0 20 20 20 20 20 20 20 20 20 20 73 7a 50 61 67 65 szPage
2e1f0 44 66 6c 74 20 3d 20 28 75 33 32 29 70 50 61 67 Dflt = (u32)pPag
2e200 65 72 2d 3e 73 65 63 74 6f 72 53 69 7a 65 3b 0a er->sectorSize;.
2e210 20 20 20 20 20 20 20 20 20 20 7d 0a 20 20 20 20 }.
2e220 20 20 20 20 7d 0a 23 69 66 64 65 66 20 53 51 4c }.#ifdef SQL
2e230 49 54 45 5f 45 4e 41 42 4c 45 5f 41 54 4f 4d 49 ITE_ENABLE_ATOMI
2e240 43 5f 57 52 49 54 45 0a 20 20 20 20 20 20 20 20 C_WRITE.
2e250 7b 0a 20 20 20 20 20 20 20 20 20 20 69 6e 74 20 {. int
2e260 69 69 3b 0a 20 20 20 20 20 20 20 20 20 20 61 73 ii;. as
2e270 73 65 72 74 28 53 51 4c 49 54 45 5f 49 4f 43 41 sert(SQLITE_IOCA
2e280 50 5f 41 54 4f 4d 49 43 35 31 32 3d 3d 28 35 31 P_ATOMIC512==(51
2e290 32 3e 3e 38 29 29 3b 0a 20 20 20 20 20 20 20 20 2>>8));.
2e2a0 20 20 61 73 73 65 72 74 28 53 51 4c 49 54 45 5f assert(SQLITE_
2e2b0 49 4f 43 41 50 5f 41 54 4f 4d 49 43 36 34 4b 3d IOCAP_ATOMIC64K=
2e2c0 3d 28 36 35 35 33 36 3e 3e 38 29 29 3b 0a 20 20 =(65536>>8));.
2e2d0 20 20 20 20 20 20 20 20 61 73 73 65 72 74 28 53 assert(S
2e2e0 51 4c 49 54 45 5f 4d 41 58 5f 44 45 46 41 55 4c QLITE_MAX_DEFAUL
2e2f0 54 5f 50 41 47 45 5f 53 49 5a 45 3c 3d 36 35 35 T_PAGE_SIZE<=655
2e300 33 36 29 3b 0a 20 20 20 20 20 20 20 20 20 20 66 36);. f
2e310 6f 72 28 69 69 3d 73 7a 50 61 67 65 44 66 6c 74 or(ii=szPageDflt
2e320 3b 20 69 69 3c 3d 53 51 4c 49 54 45 5f 4d 41 58 ; ii<=SQLITE_MAX
2e330 5f 44 45 46 41 55 4c 54 5f 50 41 47 45 5f 53 49 _DEFAULT_PAGE_SI
2e340 5a 45 3b 20 69 69 3d 69 69 2a 32 29 7b 0a 20 20 ZE; ii=ii*2){.
2e350 20 20 20 20 20 20 20 20 20 20 69 66 28 20 69 44 if( iD
2e360 63 26 28 53 51 4c 49 54 45 5f 49 4f 43 41 50 5f c&(SQLITE_IOCAP_
2e370 41 54 4f 4d 49 43 7c 28 69 69 3e 3e 38 29 29 20 ATOMIC|(ii>>8))
2e380 29 7b 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 ){.
2e390 20 73 7a 50 61 67 65 44 66 6c 74 20 3d 20 69 69 szPageDflt = ii
2e3a0 3b 0a 20 20 20 20 20 20 20 20 20 20 20 20 7d 0a ;. }.
2e3b0 20 20 20 20 20 20 20 20 20 20 7d 0a 20 20 20 20 }.
2e3c0 20 20 20 20 7d 0a 23 65 6e 64 69 66 0a 20 20 20 }.#endif.
2e3d0 20 20 20 7d 0a 20 20 20 20 20 20 70 50 61 67 65 }. pPage
2e3e0 72 2d 3e 6e 6f 4c 6f 63 6b 20 3d 20 73 71 6c 69 r->noLock = sqli
2e3f0 74 65 33 5f 75 72 69 5f 62 6f 6f 6c 65 61 6e 28 te3_uri_boolean(
2e400 7a 46 69 6c 65 6e 61 6d 65 2c 20 22 6e 6f 6c 6f zFilename, "nolo
2e410 63 6b 22 2c 20 30 29 3b 0a 20 20 20 20 20 20 69 ck", 0);. i
2e420 66 28 20 28 69 44 63 20 26 20 53 51 4c 49 54 45 f( (iDc & SQLITE
2e430 5f 49 4f 43 41 50 5f 49 4d 4d 55 54 41 42 4c 45 _IOCAP_IMMUTABLE
2e440 29 21 3d 30 0a 20 20 20 20 20 20 20 7c 7c 20 73 )!=0. || s
2e450 71 6c 69 74 65 33 5f 75 72 69 5f 62 6f 6f 6c 65 qlite3_uri_boole
2e460 61 6e 28 7a 46 69 6c 65 6e 61 6d 65 2c 20 22 69 an(zFilename, "i
2e470 6d 6d 75 74 61 62 6c 65 22 2c 20 30 29 20 29 7b mmutable", 0) ){
2e480 0a 20 20 20 20 20 20 20 20 20 20 76 66 73 46 6c . vfsFl
2e490 61 67 73 20 7c 3d 20 53 51 4c 49 54 45 5f 4f 50 ags |= SQLITE_OP
2e4a0 45 4e 5f 52 45 41 44 4f 4e 4c 59 3b 0a 20 20 20 EN_READONLY;.
2e4b0 20 20 20 20 20 20 20 67 6f 74 6f 20 61 63 74 5f goto act_
2e4c0 6c 69 6b 65 5f 74 65 6d 70 5f 66 69 6c 65 3b 0a like_temp_file;.
2e4d0 20 20 20 20 20 20 7d 0a 20 20 20 20 7d 0a 20 20 }. }.
2e4e0 7d 65 6c 73 65 7b 0a 20 20 20 20 2f 2a 20 49 66 }else{. /* If
2e4f0 20 61 20 74 65 6d 70 6f 72 61 72 79 20 66 69 6c a temporary fil
2e500 65 20 69 73 20 72 65 71 75 65 73 74 65 64 2c 20 e is requested,
2e510 69 74 20 69 73 20 6e 6f 74 20 6f 70 65 6e 65 64 it is not opened
2e520 20 69 6d 6d 65 64 69 61 74 65 6c 79 2e 0a 20 20 immediately..
2e530 20 20 2a 2a 20 49 6e 20 74 68 69 73 20 63 61 73 ** In this cas
2e540 65 20 77 65 20 61 63 63 65 70 74 20 74 68 65 20 e we accept the
2e550 64 65 66 61 75 6c 74 20 70 61 67 65 20 73 69 7a default page siz
2e560 65 20 61 6e 64 20 64 65 6c 61 79 20 61 63 74 75 e and delay actu
2e570 61 6c 6c 79 0a 20 20 20 20 2a 2a 20 6f 70 65 6e ally. ** open
2e580 69 6e 67 20 74 68 65 20 66 69 6c 65 20 75 6e 74 ing the file unt
2e590 69 6c 20 74 68 65 20 66 69 72 73 74 20 63 61 6c il the first cal
2e5a0 6c 20 74 6f 20 4f 73 57 72 69 74 65 28 29 2e 0a l to OsWrite()..
2e5b0 20 20 20 20 2a 2a 0a 20 20 20 20 2a 2a 20 54 68 **. ** Th
2e5c0 69 73 20 62 72 61 6e 63 68 20 69 73 20 61 6c 73 is branch is als
2e5d0 6f 20 72 75 6e 20 66 6f 72 20 61 6e 20 69 6e 2d o run for an in-
2e5e0 6d 65 6d 6f 72 79 20 64 61 74 61 62 61 73 65 2e memory database.
2e5f0 20 41 6e 20 69 6e 2d 6d 65 6d 6f 72 79 0a 20 20 An in-memory.
2e600 20 20 2a 2a 20 64 61 74 61 62 61 73 65 20 69 73 ** database is
2e610 20 74 68 65 20 73 61 6d 65 20 61 73 20 61 20 74 the same as a t
2e620 65 6d 70 2d 66 69 6c 65 20 74 68 61 74 20 69 73 emp-file that is
2e630 20 6e 65 76 65 72 20 77 72 69 74 74 65 6e 20 6f never written o
2e640 75 74 20 74 6f 0a 20 20 20 20 2a 2a 20 64 69 73 ut to. ** dis
2e650 6b 20 61 6e 64 20 75 73 65 73 20 61 6e 20 69 6e k and uses an in
2e660 2d 6d 65 6d 6f 72 79 20 72 6f 6c 6c 62 61 63 6b -memory rollback
2e670 20 6a 6f 75 72 6e 61 6c 2e 0a 20 20 20 20 2a 2a journal.. **
2e680 0a 20 20 20 20 2a 2a 20 54 68 69 73 20 62 72 61 . ** This bra
2e690 6e 63 68 20 61 6c 73 6f 20 72 75 6e 73 20 66 6f nch also runs fo
2e6a0 72 20 66 69 6c 65 73 20 6d 61 72 6b 65 64 20 61 r files marked a
2e6b0 73 20 69 6d 6d 75 74 61 62 6c 65 2e 0a 20 20 20 s immutable..
2e6c0 20 2a 2f 20 0a 61 63 74 5f 6c 69 6b 65 5f 74 65 */ .act_like_te
2e6d0 6d 70 5f 66 69 6c 65 3a 0a 20 20 20 20 74 65 6d mp_file:. tem
2e6e0 70 46 69 6c 65 20 3d 20 31 3b 0a 20 20 20 20 70 pFile = 1;. p
2e6f0 50 61 67 65 72 2d 3e 65 53 74 61 74 65 20 3d 20 Pager->eState =
2e700 50 41 47 45 52 5f 52 45 41 44 45 52 3b 20 20 20 PAGER_READER;
2e710 20 20 2f 2a 20 50 72 65 74 65 6e 64 20 77 65 20 /* Pretend we
2e720 61 6c 72 65 61 64 79 20 68 61 76 65 20 61 20 6c already have a l
2e730 6f 63 6b 20 2a 2f 0a 20 20 20 20 70 50 61 67 65 ock */. pPage
2e740 72 2d 3e 65 4c 6f 63 6b 20 3d 20 45 58 43 4c 55 r->eLock = EXCLU
2e750 53 49 56 45 5f 4c 4f 43 4b 3b 20 20 20 20 2f 2a SIVE_LOCK; /*
2e760 20 50 72 65 74 65 6e 64 20 77 65 20 61 72 65 20 Pretend we are
2e770 69 6e 20 45 58 43 4c 55 53 49 56 45 20 6d 6f 64 in EXCLUSIVE mod
2e780 65 20 2a 2f 0a 20 20 20 20 70 50 61 67 65 72 2d e */. pPager-
2e790 3e 6e 6f 4c 6f 63 6b 20 3d 20 31 3b 20 20 20 20 >noLock = 1;
2e7a0 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 44 /* D
2e7b0 6f 20 6e 6f 20 6c 6f 63 6b 69 6e 67 20 2a 2f 0a o no locking */.
2e7c0 20 20 20 20 72 65 61 64 4f 6e 6c 79 20 3d 20 28 readOnly = (
2e7d0 76 66 73 46 6c 61 67 73 26 53 51 4c 49 54 45 5f vfsFlags&SQLITE_
2e7e0 4f 50 45 4e 5f 52 45 41 44 4f 4e 4c 59 29 3b 0a OPEN_READONLY);.
2e7f0 20 20 7d 0a 0a 20 20 2f 2a 20 54 68 65 20 66 6f }.. /* The fo
2e800 6c 6c 6f 77 69 6e 67 20 63 61 6c 6c 20 74 6f 20 llowing call to
2e810 50 61 67 65 72 53 65 74 50 61 67 65 73 69 7a 65 PagerSetPagesize
2e820 28 29 20 73 65 72 76 65 73 20 74 6f 20 73 65 74 () serves to set
2e830 20 74 68 65 20 76 61 6c 75 65 20 6f 66 20 0a 20 the value of .
2e840 20 2a 2a 20 50 61 67 65 72 2e 70 61 67 65 53 69 ** Pager.pageSi
2e850 7a 65 20 61 6e 64 20 74 6f 20 61 6c 6c 6f 63 61 ze and to alloca
2e860 74 65 20 74 68 65 20 50 61 67 65 72 2e 70 54 6d te the Pager.pTm
2e870 70 53 70 61 63 65 20 62 75 66 66 65 72 2e 0a 20 pSpace buffer..
2e880 20 2a 2f 0a 20 20 69 66 28 20 72 63 3d 3d 53 51 */. if( rc==SQ
2e890 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 61 LITE_OK ){. a
2e8a0 73 73 65 72 74 28 20 70 50 61 67 65 72 2d 3e 6d ssert( pPager->m
2e8b0 65 6d 44 62 3d 3d 30 20 29 3b 0a 20 20 20 20 72 emDb==0 );. r
2e8c0 63 20 3d 20 73 71 6c 69 74 65 33 50 61 67 65 72 c = sqlite3Pager
2e8d0 53 65 74 50 61 67 65 73 69 7a 65 28 70 50 61 67 SetPagesize(pPag
2e8e0 65 72 2c 20 26 73 7a 50 61 67 65 44 66 6c 74 2c er, &szPageDflt,
2e8f0 20 2d 31 29 3b 0a 20 20 20 20 74 65 73 74 63 61 -1);. testca
2e900 73 65 28 20 72 63 21 3d 53 51 4c 49 54 45 5f 4f se( rc!=SQLITE_O
2e910 4b 20 29 3b 0a 20 20 7d 0a 0a 20 20 2f 2a 20 49 K );. }.. /* I
2e920 6e 69 74 69 61 6c 69 7a 65 20 74 68 65 20 50 43 nitialize the PC
2e930 61 63 68 65 20 6f 62 6a 65 63 74 2e 20 2a 2f 0a ache object. */.
2e940 20 20 69 66 28 20 72 63 3d 3d 53 51 4c 49 54 45 if( rc==SQLITE
2e950 5f 4f 4b 20 29 7b 0a 20 20 20 20 61 73 73 65 72 _OK ){. asser
2e960 74 28 20 6e 45 78 74 72 61 3c 31 30 30 30 20 29 t( nExtra<1000 )
2e970 3b 0a 20 20 20 20 6e 45 78 74 72 61 20 3d 20 52 ;. nExtra = R
2e980 4f 55 4e 44 38 28 6e 45 78 74 72 61 29 3b 0a 20 OUND8(nExtra);.
2e990 20 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33 50 rc = sqlite3P
2e9a0 63 61 63 68 65 4f 70 65 6e 28 73 7a 50 61 67 65 cacheOpen(szPage
2e9b0 44 66 6c 74 2c 20 6e 45 78 74 72 61 2c 20 21 6d Dflt, nExtra, !m
2e9c0 65 6d 44 62 2c 0a 20 20 20 20 20 20 20 20 20 20 emDb,.
2e9d0 20 20 20 20 20 20 20 20 20 20 20 20 20 21 6d 65 !me
2e9e0 6d 44 62 3f 70 61 67 65 72 53 74 72 65 73 73 3a mDb?pagerStress:
2e9f0 30 2c 20 28 76 6f 69 64 20 2a 29 70 50 61 67 65 0, (void *)pPage
2ea00 72 2c 20 70 50 61 67 65 72 2d 3e 70 50 43 61 63 r, pPager->pPCac
2ea10 68 65 29 3b 0a 20 20 7d 0a 0a 20 20 2f 2a 20 49 he);. }.. /* I
2ea20 66 20 61 6e 20 65 72 72 6f 72 20 6f 63 63 75 72 f an error occur
2ea30 72 65 64 20 61 62 6f 76 65 2c 20 66 72 65 65 20 red above, free
2ea40 74 68 65 20 20 50 61 67 65 72 20 73 74 72 75 63 the Pager struc
2ea50 74 75 72 65 20 61 6e 64 20 63 6c 6f 73 65 20 74 ture and close t
2ea60 68 65 20 66 69 6c 65 2e 0a 20 20 2a 2f 0a 20 20 he file.. */.
2ea70 69 66 28 20 72 63 21 3d 53 51 4c 49 54 45 5f 4f if( rc!=SQLITE_O
2ea80 4b 20 29 7b 0a 20 20 20 20 73 71 6c 69 74 65 33 K ){. sqlite3
2ea90 4f 73 43 6c 6f 73 65 28 70 50 61 67 65 72 2d 3e OsClose(pPager->
2eaa0 66 64 29 3b 0a 20 20 20 20 73 71 6c 69 74 65 33 fd);. sqlite3
2eab0 50 61 67 65 46 72 65 65 28 70 50 61 67 65 72 2d PageFree(pPager-
2eac0 3e 70 54 6d 70 53 70 61 63 65 29 3b 0a 20 20 20 >pTmpSpace);.
2ead0 20 73 71 6c 69 74 65 33 5f 66 72 65 65 28 70 50 sqlite3_free(pP
2eae0 61 67 65 72 29 3b 0a 20 20 20 20 72 65 74 75 72 ager);. retur
2eaf0 6e 20 72 63 3b 0a 20 20 7d 0a 0a 20 20 50 41 47 n rc;. }.. PAG
2eb00 45 52 54 52 41 43 45 28 28 22 4f 50 45 4e 20 25 ERTRACE(("OPEN %
2eb10 64 20 25 73 5c 6e 22 2c 20 46 49 4c 45 48 41 4e d %s\n", FILEHAN
2eb20 44 4c 45 49 44 28 70 50 61 67 65 72 2d 3e 66 64 DLEID(pPager->fd
2eb30 29 2c 20 70 50 61 67 65 72 2d 3e 7a 46 69 6c 65 ), pPager->zFile
2eb40 6e 61 6d 65 29 29 3b 0a 20 20 49 4f 54 52 41 43 name));. IOTRAC
2eb50 45 28 28 22 4f 50 45 4e 20 25 70 20 25 73 5c 6e E(("OPEN %p %s\n
2eb60 22 2c 20 70 50 61 67 65 72 2c 20 70 50 61 67 65 ", pPager, pPage
2eb70 72 2d 3e 7a 46 69 6c 65 6e 61 6d 65 29 29 0a 0a r->zFilename))..
2eb80 20 20 70 50 61 67 65 72 2d 3e 75 73 65 4a 6f 75 pPager->useJou
2eb90 72 6e 61 6c 20 3d 20 28 75 38 29 75 73 65 4a 6f rnal = (u8)useJo
2eba0 75 72 6e 61 6c 3b 0a 20 20 2f 2a 20 70 50 61 67 urnal;. /* pPag
2ebb0 65 72 2d 3e 73 74 6d 74 4f 70 65 6e 20 3d 20 30 er->stmtOpen = 0
2ebc0 3b 20 2a 2f 0a 20 20 2f 2a 20 70 50 61 67 65 72 ; */. /* pPager
2ebd0 2d 3e 73 74 6d 74 49 6e 55 73 65 20 3d 20 30 3b ->stmtInUse = 0;
2ebe0 20 2a 2f 0a 20 20 2f 2a 20 70 50 61 67 65 72 2d */. /* pPager-
2ebf0 3e 6e 52 65 66 20 3d 20 30 3b 20 2a 2f 0a 20 20 >nRef = 0; */.
2ec00 2f 2a 20 70 50 61 67 65 72 2d 3e 73 74 6d 74 53 /* pPager->stmtS
2ec10 69 7a 65 20 3d 20 30 3b 20 2a 2f 0a 20 20 2f 2a ize = 0; */. /*
2ec20 20 70 50 61 67 65 72 2d 3e 73 74 6d 74 4a 53 69 pPager->stmtJSi
2ec30 7a 65 20 3d 20 30 3b 20 2a 2f 0a 20 20 2f 2a 20 ze = 0; */. /*
2ec40 70 50 61 67 65 72 2d 3e 6e 50 61 67 65 20 3d 20 pPager->nPage =
2ec50 30 3b 20 2a 2f 0a 20 20 70 50 61 67 65 72 2d 3e 0; */. pPager->
2ec60 6d 78 50 67 6e 6f 20 3d 20 53 51 4c 49 54 45 5f mxPgno = SQLITE_
2ec70 4d 41 58 5f 50 41 47 45 5f 43 4f 55 4e 54 3b 0a MAX_PAGE_COUNT;.
2ec80 20 20 2f 2a 20 70 50 61 67 65 72 2d 3e 73 74 61 /* pPager->sta
2ec90 74 65 20 3d 20 50 41 47 45 52 5f 55 4e 4c 4f 43 te = PAGER_UNLOC
2eca0 4b 3b 20 2a 2f 0a 20 20 2f 2a 20 70 50 61 67 65 K; */. /* pPage
2ecb0 72 2d 3e 65 72 72 4d 61 73 6b 20 3d 20 30 3b 20 r->errMask = 0;
2ecc0 2a 2f 0a 20 20 70 50 61 67 65 72 2d 3e 74 65 6d */. pPager->tem
2ecd0 70 46 69 6c 65 20 3d 20 28 75 38 29 74 65 6d 70 pFile = (u8)temp
2ece0 46 69 6c 65 3b 0a 20 20 61 73 73 65 72 74 28 20 File;. assert(
2ecf0 74 65 6d 70 46 69 6c 65 3d 3d 50 41 47 45 52 5f tempFile==PAGER_
2ed00 4c 4f 43 4b 49 4e 47 4d 4f 44 45 5f 4e 4f 52 4d LOCKINGMODE_NORM
2ed10 41 4c 20 0a 20 20 20 20 20 20 20 20 20 20 7c 7c AL . ||
2ed20 20 74 65 6d 70 46 69 6c 65 3d 3d 50 41 47 45 52 tempFile==PAGER
2ed30 5f 4c 4f 43 4b 49 4e 47 4d 4f 44 45 5f 45 58 43 _LOCKINGMODE_EXC
2ed40 4c 55 53 49 56 45 20 29 3b 0a 20 20 61 73 73 65 LUSIVE );. asse
2ed50 72 74 28 20 50 41 47 45 52 5f 4c 4f 43 4b 49 4e rt( PAGER_LOCKIN
2ed60 47 4d 4f 44 45 5f 45 58 43 4c 55 53 49 56 45 3d GMODE_EXCLUSIVE=
2ed70 3d 31 20 29 3b 0a 20 20 70 50 61 67 65 72 2d 3e =1 );. pPager->
2ed80 65 78 63 6c 75 73 69 76 65 4d 6f 64 65 20 3d 20 exclusiveMode =
2ed90 28 75 38 29 74 65 6d 70 46 69 6c 65 3b 20 0a 20 (u8)tempFile; .
2eda0 20 70 50 61 67 65 72 2d 3e 63 68 61 6e 67 65 43 pPager->changeC
2edb0 6f 75 6e 74 44 6f 6e 65 20 3d 20 70 50 61 67 65 ountDone = pPage
2edc0 72 2d 3e 74 65 6d 70 46 69 6c 65 3b 0a 20 20 70 r->tempFile;. p
2edd0 50 61 67 65 72 2d 3e 6d 65 6d 44 62 20 3d 20 28 Pager->memDb = (
2ede0 75 38 29 6d 65 6d 44 62 3b 0a 20 20 70 50 61 67 u8)memDb;. pPag
2edf0 65 72 2d 3e 72 65 61 64 4f 6e 6c 79 20 3d 20 28 er->readOnly = (
2ee00 75 38 29 72 65 61 64 4f 6e 6c 79 3b 0a 20 20 61 u8)readOnly;. a
2ee10 73 73 65 72 74 28 20 75 73 65 4a 6f 75 72 6e 61 ssert( useJourna
2ee20 6c 20 7c 7c 20 70 50 61 67 65 72 2d 3e 74 65 6d l || pPager->tem
2ee30 70 46 69 6c 65 20 29 3b 0a 20 20 70 50 61 67 65 pFile );. pPage
2ee40 72 2d 3e 6e 6f 53 79 6e 63 20 3d 20 70 50 61 67 r->noSync = pPag
2ee50 65 72 2d 3e 74 65 6d 70 46 69 6c 65 3b 0a 20 20 er->tempFile;.
2ee60 69 66 28 20 70 50 61 67 65 72 2d 3e 6e 6f 53 79 if( pPager->noSy
2ee70 6e 63 20 29 7b 0a 20 20 20 20 61 73 73 65 72 74 nc ){. assert
2ee80 28 20 70 50 61 67 65 72 2d 3e 66 75 6c 6c 53 79 ( pPager->fullSy
2ee90 6e 63 3d 3d 30 20 29 3b 0a 20 20 20 20 61 73 73 nc==0 );. ass
2eea0 65 72 74 28 20 70 50 61 67 65 72 2d 3e 65 78 74 ert( pPager->ext
2eeb0 72 61 53 79 6e 63 3d 3d 30 20 29 3b 0a 20 20 20 raSync==0 );.
2eec0 20 61 73 73 65 72 74 28 20 70 50 61 67 65 72 2d assert( pPager-
2eed0 3e 73 79 6e 63 46 6c 61 67 73 3d 3d 30 20 29 3b >syncFlags==0 );
2eee0 0a 20 20 20 20 61 73 73 65 72 74 28 20 70 50 61 . assert( pPa
2eef0 67 65 72 2d 3e 77 61 6c 53 79 6e 63 46 6c 61 67 ger->walSyncFlag
2ef00 73 3d 3d 30 20 29 3b 0a 20 20 20 20 61 73 73 65 s==0 );. asse
2ef10 72 74 28 20 70 50 61 67 65 72 2d 3e 63 6b 70 74 rt( pPager->ckpt
2ef20 53 79 6e 63 46 6c 61 67 73 3d 3d 30 20 29 3b 0a SyncFlags==0 );.
2ef30 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 70 50 61 }else{. pPa
2ef40 67 65 72 2d 3e 66 75 6c 6c 53 79 6e 63 20 3d 20 ger->fullSync =
2ef50 31 3b 0a 20 20 20 20 70 50 61 67 65 72 2d 3e 65 1;. pPager->e
2ef60 78 74 72 61 53 79 6e 63 20 3d 20 30 3b 0a 20 20 xtraSync = 0;.
2ef70 20 20 70 50 61 67 65 72 2d 3e 73 79 6e 63 46 6c pPager->syncFl
2ef80 61 67 73 20 3d 20 53 51 4c 49 54 45 5f 53 59 4e ags = SQLITE_SYN
2ef90 43 5f 4e 4f 52 4d 41 4c 3b 0a 20 20 20 20 70 50 C_NORMAL;. pP
2efa0 61 67 65 72 2d 3e 77 61 6c 53 79 6e 63 46 6c 61 ager->walSyncFla
2efb0 67 73 20 3d 20 53 51 4c 49 54 45 5f 53 59 4e 43 gs = SQLITE_SYNC
2efc0 5f 4e 4f 52 4d 41 4c 20 7c 20 57 41 4c 5f 53 59 _NORMAL | WAL_SY
2efd0 4e 43 5f 54 52 41 4e 53 41 43 54 49 4f 4e 53 3b NC_TRANSACTIONS;
2efe0 0a 20 20 20 20 70 50 61 67 65 72 2d 3e 63 6b 70 . pPager->ckp
2eff0 74 53 79 6e 63 46 6c 61 67 73 20 3d 20 53 51 4c tSyncFlags = SQL
2f000 49 54 45 5f 53 59 4e 43 5f 4e 4f 52 4d 41 4c 3b ITE_SYNC_NORMAL;
2f010 0a 20 20 7d 0a 20 20 2f 2a 20 70 50 61 67 65 72 . }. /* pPager
2f020 2d 3e 70 46 69 72 73 74 20 3d 20 30 3b 20 2a 2f ->pFirst = 0; */
2f030 0a 20 20 2f 2a 20 70 50 61 67 65 72 2d 3e 70 46 . /* pPager->pF
2f040 69 72 73 74 53 79 6e 63 65 64 20 3d 20 30 3b 20 irstSynced = 0;
2f050 2a 2f 0a 20 20 2f 2a 20 70 50 61 67 65 72 2d 3e */. /* pPager->
2f060 70 4c 61 73 74 20 3d 20 30 3b 20 2a 2f 0a 20 20 pLast = 0; */.
2f070 70 50 61 67 65 72 2d 3e 6e 45 78 74 72 61 20 3d pPager->nExtra =
2f080 20 28 75 31 36 29 6e 45 78 74 72 61 3b 0a 20 20 (u16)nExtra;.
2f090 70 50 61 67 65 72 2d 3e 6a 6f 75 72 6e 61 6c 53 pPager->journalS
2f0a0 69 7a 65 4c 69 6d 69 74 20 3d 20 53 51 4c 49 54 izeLimit = SQLIT
2f0b0 45 5f 44 45 46 41 55 4c 54 5f 4a 4f 55 52 4e 41 E_DEFAULT_JOURNA
2f0c0 4c 5f 53 49 5a 45 5f 4c 49 4d 49 54 3b 0a 20 20 L_SIZE_LIMIT;.
2f0d0 61 73 73 65 72 74 28 20 69 73 4f 70 65 6e 28 70 assert( isOpen(p
2f0e0 50 61 67 65 72 2d 3e 66 64 29 20 7c 7c 20 74 65 Pager->fd) || te
2f0f0 6d 70 46 69 6c 65 20 29 3b 0a 20 20 73 65 74 53 mpFile );. setS
2f100 65 63 74 6f 72 53 69 7a 65 28 70 50 61 67 65 72 ectorSize(pPager
2f110 29 3b 0a 20 20 69 66 28 20 21 75 73 65 4a 6f 75 );. if( !useJou
2f120 72 6e 61 6c 20 29 7b 0a 20 20 20 20 70 50 61 67 rnal ){. pPag
2f130 65 72 2d 3e 6a 6f 75 72 6e 61 6c 4d 6f 64 65 20 er->journalMode
2f140 3d 20 50 41 47 45 52 5f 4a 4f 55 52 4e 41 4c 4d = PAGER_JOURNALM
2f150 4f 44 45 5f 4f 46 46 3b 0a 20 20 7d 65 6c 73 65 ODE_OFF;. }else
2f160 20 69 66 28 20 6d 65 6d 44 62 20 29 7b 0a 20 20 if( memDb ){.
2f170 20 20 70 50 61 67 65 72 2d 3e 6a 6f 75 72 6e 61 pPager->journa
2f180 6c 4d 6f 64 65 20 3d 20 50 41 47 45 52 5f 4a 4f lMode = PAGER_JO
2f190 55 52 4e 41 4c 4d 4f 44 45 5f 4d 45 4d 4f 52 59 URNALMODE_MEMORY
2f1a0 3b 0a 20 20 7d 0a 20 20 2f 2a 20 70 50 61 67 65 ;. }. /* pPage
2f1b0 72 2d 3e 78 42 75 73 79 48 61 6e 64 6c 65 72 20 r->xBusyHandler
2f1c0 3d 20 30 3b 20 2a 2f 0a 20 20 2f 2a 20 70 50 61 = 0; */. /* pPa
2f1d0 67 65 72 2d 3e 70 42 75 73 79 48 61 6e 64 6c 65 ger->pBusyHandle
2f1e0 72 41 72 67 20 3d 20 30 3b 20 2a 2f 0a 20 20 70 rArg = 0; */. p
2f1f0 50 61 67 65 72 2d 3e 78 52 65 69 6e 69 74 65 72 Pager->xReiniter
2f200 20 3d 20 78 52 65 69 6e 69 74 3b 0a 20 20 2f 2a = xReinit;. /*
2f210 20 6d 65 6d 73 65 74 28 70 50 61 67 65 72 2d 3e memset(pPager->
2f220 61 48 61 73 68 2c 20 30 2c 20 73 69 7a 65 6f 66 aHash, 0, sizeof
2f230 28 70 50 61 67 65 72 2d 3e 61 48 61 73 68 29 29 (pPager->aHash))
2f240 3b 20 2a 2f 0a 20 20 2f 2a 20 70 50 61 67 65 72 ; */. /* pPager
2f250 2d 3e 73 7a 4d 6d 61 70 20 3d 20 53 51 4c 49 54 ->szMmap = SQLIT
2f260 45 5f 44 45 46 41 55 4c 54 5f 4d 4d 41 50 5f 53 E_DEFAULT_MMAP_S
2f270 49 5a 45 20 2f 2f 20 77 69 6c 6c 20 62 65 20 73 IZE // will be s
2f280 65 74 20 62 79 20 62 74 72 65 65 2e 63 20 2a 2f et by btree.c */
2f290 0a 0a 20 20 2a 70 70 50 61 67 65 72 20 3d 20 70 .. *ppPager = p
2f2a0 50 61 67 65 72 3b 0a 20 20 72 65 74 75 72 6e 20 Pager;. return
2f2b0 53 51 4c 49 54 45 5f 4f 4b 3b 0a 7d 0a 0a 0a 2f SQLITE_OK;.}.../
2f2c0 2a 20 56 65 72 69 66 79 20 74 68 61 74 20 74 68 * Verify that th
2f2d0 65 20 64 61 74 61 62 61 73 65 20 66 69 6c 65 20 e database file
2f2e0 68 61 73 20 6e 6f 74 20 62 65 20 64 65 6c 65 74 has not be delet
2f2f0 65 64 20 6f 72 20 72 65 6e 61 6d 65 64 20 6f 75 ed or renamed ou
2f300 74 20 66 72 6f 6d 0a 2a 2a 20 75 6e 64 65 72 20 t from.** under
2f310 74 68 65 20 70 61 67 65 72 2e 20 20 52 65 74 75 the pager. Retu
2f320 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 20 69 66 20 rn SQLITE_OK if
2f330 74 68 65 20 64 61 74 61 62 61 73 65 20 69 73 20 the database is
2f340 73 74 69 6c 6c 20 77 65 72 65 20 69 74 20 6f 75 still were it ou
2f350 67 68 74 0a 2a 2a 20 74 6f 20 62 65 20 6f 6e 20 ght.** to be on
2f360 64 69 73 6b 2e 20 20 52 65 74 75 72 6e 20 6e 6f disk. Return no
2f370 6e 2d 7a 65 72 6f 20 28 53 51 4c 49 54 45 5f 52 n-zero (SQLITE_R
2f380 45 41 44 4f 4e 4c 59 5f 44 42 4d 4f 56 45 44 20 EADONLY_DBMOVED
2f390 6f 72 20 73 6f 6d 65 20 6f 74 68 65 72 20 65 72 or some other er
2f3a0 72 6f 72 0a 2a 2a 20 63 6f 64 65 20 66 72 6f 6d ror.** code from
2f3b0 20 73 71 6c 69 74 65 33 4f 73 41 63 63 65 73 73 sqlite3OsAccess
2f3c0 28 29 29 20 69 66 20 74 68 65 20 64 61 74 61 62 ()) if the datab
2f3d0 61 73 65 20 68 61 73 20 67 6f 6e 65 20 6d 69 73 ase has gone mis
2f3e0 73 69 6e 67 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 sing..*/.static
2f3f0 69 6e 74 20 64 61 74 61 62 61 73 65 49 73 55 6e int databaseIsUn
2f400 6d 6f 76 65 64 28 50 61 67 65 72 20 2a 70 50 61 moved(Pager *pPa
2f410 67 65 72 29 7b 0a 20 20 69 6e 74 20 62 48 61 73 ger){. int bHas
2f420 4d 6f 76 65 64 20 3d 20 30 3b 0a 20 20 69 6e 74 Moved = 0;. int
2f430 20 72 63 3b 0a 0a 20 20 69 66 28 20 70 50 61 67 rc;.. if( pPag
2f440 65 72 2d 3e 74 65 6d 70 46 69 6c 65 20 29 20 72 er->tempFile ) r
2f450 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b eturn SQLITE_OK;
2f460 0a 20 20 69 66 28 20 70 50 61 67 65 72 2d 3e 64 . if( pPager->d
2f470 62 53 69 7a 65 3d 3d 30 20 29 20 72 65 74 75 72 bSize==0 ) retur
2f480 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20 20 61 n SQLITE_OK;. a
2f490 73 73 65 72 74 28 20 70 50 61 67 65 72 2d 3e 7a ssert( pPager->z
2f4a0 46 69 6c 65 6e 61 6d 65 20 26 26 20 70 50 61 67 Filename && pPag
2f4b0 65 72 2d 3e 7a 46 69 6c 65 6e 61 6d 65 5b 30 5d er->zFilename[0]
2f4c0 20 29 3b 0a 20 20 72 63 20 3d 20 73 71 6c 69 74 );. rc = sqlit
2f4d0 65 33 4f 73 46 69 6c 65 43 6f 6e 74 72 6f 6c 28 e3OsFileControl(
2f4e0 70 50 61 67 65 72 2d 3e 66 64 2c 20 53 51 4c 49 pPager->fd, SQLI
2f4f0 54 45 5f 46 43 4e 54 4c 5f 48 41 53 5f 4d 4f 56 TE_FCNTL_HAS_MOV
2f500 45 44 2c 20 26 62 48 61 73 4d 6f 76 65 64 29 3b ED, &bHasMoved);
2f510 0a 20 20 69 66 28 20 72 63 3d 3d 53 51 4c 49 54 . if( rc==SQLIT
2f520 45 5f 4e 4f 54 46 4f 55 4e 44 20 29 7b 0a 20 20 E_NOTFOUND ){.
2f530 20 20 2f 2a 20 49 66 20 74 68 65 20 48 41 53 5f /* If the HAS_
2f540 4d 4f 56 45 44 20 66 69 6c 65 2d 63 6f 6e 74 72 MOVED file-contr
2f550 6f 6c 20 69 73 20 75 6e 69 6d 70 6c 65 6d 65 6e ol is unimplemen
2f560 74 65 64 2c 20 61 73 73 75 6d 65 20 74 68 61 74 ted, assume that
2f570 20 74 68 65 20 66 69 6c 65 0a 20 20 20 20 2a 2a the file. **
2f580 20 68 61 73 20 6e 6f 74 20 62 65 65 6e 20 6d 6f has not been mo
2f590 76 65 64 2e 20 20 54 68 61 74 20 69 73 20 74 68 ved. That is th
2f5a0 65 20 68 69 73 74 6f 72 69 63 61 6c 20 62 65 68 e historical beh
2f5b0 61 76 69 6f 72 20 6f 66 20 53 51 4c 69 74 65 3a avior of SQLite:
2f5c0 20 70 72 69 6f 72 20 74 6f 0a 20 20 20 20 2a 2a prior to. **
2f5d0 20 76 65 72 73 69 6f 6e 20 33 2e 38 2e 33 2c 20 version 3.8.3,
2f5e0 69 74 20 6e 65 76 65 72 20 63 68 65 63 6b 65 64 it never checked
2f5f0 20 2a 2f 0a 20 20 20 20 72 63 20 3d 20 53 51 4c */. rc = SQL
2f600 49 54 45 5f 4f 4b 3b 0a 20 20 7d 65 6c 73 65 20 ITE_OK;. }else
2f610 69 66 28 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4f if( rc==SQLITE_O
2f620 4b 20 26 26 20 62 48 61 73 4d 6f 76 65 64 20 29 K && bHasMoved )
2f630 7b 0a 20 20 20 20 72 63 20 3d 20 53 51 4c 49 54 {. rc = SQLIT
2f640 45 5f 52 45 41 44 4f 4e 4c 59 5f 44 42 4d 4f 56 E_READONLY_DBMOV
2f650 45 44 3b 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e ED;. }. return
2f660 20 72 63 3b 0a 7d 0a 0a 0a 2f 2a 0a 2a 2a 20 54 rc;.}.../*.** T
2f670 68 69 73 20 66 75 6e 63 74 69 6f 6e 20 69 73 20 his function is
2f680 63 61 6c 6c 65 64 20 61 66 74 65 72 20 74 72 61 called after tra
2f690 6e 73 69 74 69 6f 6e 69 6e 67 20 66 72 6f 6d 20 nsitioning from
2f6a0 50 41 47 45 52 5f 55 4e 4c 4f 43 4b 20 74 6f 0a PAGER_UNLOCK to.
2f6b0 2a 2a 20 50 41 47 45 52 5f 53 48 41 52 45 44 20 ** PAGER_SHARED
2f6c0 73 74 61 74 65 2e 20 49 74 20 74 65 73 74 73 20 state. It tests
2f6d0 69 66 20 74 68 65 72 65 20 69 73 20 61 20 68 6f if there is a ho
2f6e0 74 20 6a 6f 75 72 6e 61 6c 20 70 72 65 73 65 6e t journal presen
2f6f0 74 20 69 6e 0a 2a 2a 20 74 68 65 20 66 69 6c 65 t in.** the file
2f700 2d 73 79 73 74 65 6d 20 66 6f 72 20 74 68 65 20 -system for the
2f710 67 69 76 65 6e 20 70 61 67 65 72 2e 20 41 20 68 given pager. A h
2f720 6f 74 20 6a 6f 75 72 6e 61 6c 20 69 73 20 6f 6e ot journal is on
2f730 65 20 74 68 61 74 20 0a 2a 2a 20 6e 65 65 64 73 e that .** needs
2f740 20 74 6f 20 62 65 20 70 6c 61 79 65 64 20 62 61 to be played ba
2f750 63 6b 2e 20 41 63 63 6f 72 64 69 6e 67 20 74 6f ck. According to
2f760 20 74 68 69 73 20 66 75 6e 63 74 69 6f 6e 2c 20 this function,
2f770 61 20 68 6f 74 2d 6a 6f 75 72 6e 61 6c 0a 2a 2a a hot-journal.**
2f780 20 66 69 6c 65 20 65 78 69 73 74 73 20 69 66 20 file exists if
2f790 74 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 63 72 the following cr
2f7a0 69 74 65 72 69 61 20 61 72 65 20 6d 65 74 3a 0a iteria are met:.
2f7b0 2a 2a 0a 2a 2a 20 20 20 2a 20 54 68 65 20 6a 6f **.** * The jo
2f7c0 75 72 6e 61 6c 20 66 69 6c 65 20 65 78 69 73 74 urnal file exist
2f7d0 73 20 69 6e 20 74 68 65 20 66 69 6c 65 20 73 79 s in the file sy
2f7e0 73 74 65 6d 2c 20 61 6e 64 0a 2a 2a 20 20 20 2a stem, and.** *
2f7f0 20 4e 6f 20 70 72 6f 63 65 73 73 20 68 6f 6c 64 No process hold
2f800 73 20 61 20 52 45 53 45 52 56 45 44 20 6f 72 20 s a RESERVED or
2f810 67 72 65 61 74 65 72 20 6c 6f 63 6b 20 6f 6e 20 greater lock on
2f820 74 68 65 20 64 61 74 61 62 61 73 65 20 66 69 6c the database fil
2f830 65 2c 20 61 6e 64 0a 2a 2a 20 20 20 2a 20 54 68 e, and.** * Th
2f840 65 20 64 61 74 61 62 61 73 65 20 66 69 6c 65 20 e database file
2f850 69 74 73 65 6c 66 20 69 73 20 67 72 65 61 74 65 itself is greate
2f860 72 20 74 68 61 6e 20 30 20 62 79 74 65 73 20 69 r than 0 bytes i
2f870 6e 20 73 69 7a 65 2c 20 61 6e 64 0a 2a 2a 20 20 n size, and.**
2f880 20 2a 20 54 68 65 20 66 69 72 73 74 20 62 79 74 * The first byt
2f890 65 20 6f 66 20 74 68 65 20 6a 6f 75 72 6e 61 6c e of the journal
2f8a0 20 66 69 6c 65 20 65 78 69 73 74 73 20 61 6e 64 file exists and
2f8b0 20 69 73 20 6e 6f 74 20 30 78 30 30 2e 0a 2a 2a is not 0x00..**
2f8c0 0a 2a 2a 20 49 66 20 74 68 65 20 63 75 72 72 65 .** If the curre
2f8d0 6e 74 20 73 69 7a 65 20 6f 66 20 74 68 65 20 64 nt size of the d
2f8e0 61 74 61 62 61 73 65 20 66 69 6c 65 20 69 73 20 atabase file is
2f8f0 30 20 62 75 74 20 61 20 6a 6f 75 72 6e 61 6c 20 0 but a journal
2f900 66 69 6c 65 0a 2a 2a 20 65 78 69 73 74 73 2c 20 file.** exists,
2f910 74 68 61 74 20 69 73 20 70 72 6f 62 61 62 6c 79 that is probably
2f920 20 61 6e 20 6f 6c 64 20 6a 6f 75 72 6e 61 6c 20 an old journal
2f930 6c 65 66 74 20 6f 76 65 72 20 66 72 6f 6d 20 61 left over from a
2f940 20 70 72 69 6f 72 0a 2a 2a 20 64 61 74 61 62 61 prior.** databa
2f950 73 65 20 77 69 74 68 20 74 68 65 20 73 61 6d 65 se with the same
2f960 20 6e 61 6d 65 2e 20 49 6e 20 74 68 69 73 20 63 name. In this c
2f970 61 73 65 20 74 68 65 20 6a 6f 75 72 6e 61 6c 20 ase the journal
2f980 66 69 6c 65 20 69 73 0a 2a 2a 20 6a 75 73 74 20 file is.** just
2f990 64 65 6c 65 74 65 64 20 75 73 69 6e 67 20 4f 73 deleted using Os
2f9a0 44 65 6c 65 74 65 2c 20 2a 70 45 78 69 73 74 73 Delete, *pExists
2f9b0 20 69 73 20 73 65 74 20 74 6f 20 30 20 61 6e 64 is set to 0 and
2f9c0 20 53 51 4c 49 54 45 5f 4f 4b 0a 2a 2a 20 69 73 SQLITE_OK.** is
2f9d0 20 72 65 74 75 72 6e 65 64 2e 0a 2a 2a 0a 2a 2a returned..**.**
2f9e0 20 54 68 69 73 20 72 6f 75 74 69 6e 65 20 64 6f This routine do
2f9f0 65 73 20 6e 6f 74 20 63 68 65 63 6b 20 69 66 20 es not check if
2fa00 74 68 65 72 65 20 69 73 20 61 20 6d 61 73 74 65 there is a maste
2fa10 72 20 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 6e 61 r journal filena
2fa20 6d 65 0a 2a 2a 20 61 74 20 74 68 65 20 65 6e 64 me.** at the end
2fa30 20 6f 66 20 74 68 65 20 66 69 6c 65 2e 20 49 66 of the file. If
2fa40 20 74 68 65 72 65 20 69 73 2c 20 61 6e 64 20 74 there is, and t
2fa50 68 61 74 20 6d 61 73 74 65 72 20 6a 6f 75 72 6e hat master journ
2fa60 61 6c 20 66 69 6c 65 0a 2a 2a 20 64 6f 65 73 20 al file.** does
2fa70 6e 6f 74 20 65 78 69 73 74 2c 20 74 68 65 6e 20 not exist, then
2fa80 74 68 65 20 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 the journal file
2fa90 20 69 73 20 6e 6f 74 20 72 65 61 6c 6c 79 20 68 is not really h
2faa0 6f 74 2e 20 49 6e 20 74 68 69 73 0a 2a 2a 20 63 ot. In this.** c
2fab0 61 73 65 20 74 68 69 73 20 72 6f 75 74 69 6e 65 ase this routine
2fac0 20 77 69 6c 6c 20 72 65 74 75 72 6e 20 61 20 66 will return a f
2fad0 61 6c 73 65 2d 70 6f 73 69 74 69 76 65 2e 20 54 alse-positive. T
2fae0 68 65 20 70 61 67 65 72 5f 70 6c 61 79 62 61 63 he pager_playbac
2faf0 6b 28 29 0a 2a 2a 20 72 6f 75 74 69 6e 65 20 77 k().** routine w
2fb00 69 6c 6c 20 64 69 73 63 6f 76 65 72 20 74 68 61 ill discover tha
2fb10 74 20 74 68 65 20 6a 6f 75 72 6e 61 6c 20 66 69 t the journal fi
2fb20 6c 65 20 69 73 20 6e 6f 74 20 72 65 61 6c 6c 79 le is not really
2fb30 20 68 6f 74 20 61 6e 64 20 0a 2a 2a 20 77 69 6c hot and .** wil
2fb40 6c 20 6e 6f 74 20 72 6f 6c 6c 20 69 74 20 62 61 l not roll it ba
2fb50 63 6b 2e 20 0a 2a 2a 0a 2a 2a 20 49 66 20 61 20 ck. .**.** If a
2fb60 68 6f 74 2d 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 hot-journal file
2fb70 20 69 73 20 66 6f 75 6e 64 20 74 6f 20 65 78 69 is found to exi
2fb80 73 74 2c 20 2a 70 45 78 69 73 74 73 20 69 73 20 st, *pExists is
2fb90 73 65 74 20 74 6f 20 31 20 61 6e 64 20 0a 2a 2a set to 1 and .**
2fba0 20 53 51 4c 49 54 45 5f 4f 4b 20 72 65 74 75 72 SQLITE_OK retur
2fbb0 6e 65 64 2e 20 49 66 20 6e 6f 20 68 6f 74 2d 6a ned. If no hot-j
2fbc0 6f 75 72 6e 61 6c 20 66 69 6c 65 20 69 73 20 70 ournal file is p
2fbd0 72 65 73 65 6e 74 2c 20 2a 70 45 78 69 73 74 73 resent, *pExists
2fbe0 20 69 73 0a 2a 2a 20 73 65 74 20 74 6f 20 30 20 is.** set to 0
2fbf0 61 6e 64 20 53 51 4c 49 54 45 5f 4f 4b 20 72 65 and SQLITE_OK re
2fc00 74 75 72 6e 65 64 2e 20 49 66 20 61 6e 20 49 4f turned. If an IO
2fc10 20 65 72 72 6f 72 20 6f 63 63 75 72 73 20 77 68 error occurs wh
2fc20 69 6c 65 20 74 72 79 69 6e 67 0a 2a 2a 20 74 6f ile trying.** to
2fc30 20 64 65 74 65 72 6d 69 6e 65 20 77 68 65 74 68 determine wheth
2fc40 65 72 20 6f 72 20 6e 6f 74 20 61 20 68 6f 74 2d er or not a hot-
2fc50 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 20 65 78 69 journal file exi
2fc60 73 74 73 2c 20 74 68 65 20 49 4f 20 65 72 72 6f sts, the IO erro
2fc70 72 0a 2a 2a 20 63 6f 64 65 20 69 73 20 72 65 74 r.** code is ret
2fc80 75 72 6e 65 64 20 61 6e 64 20 74 68 65 20 76 61 urned and the va
2fc90 6c 75 65 20 6f 66 20 2a 70 45 78 69 73 74 73 20 lue of *pExists
2fca0 69 73 20 75 6e 64 65 66 69 6e 65 64 2e 0a 2a 2f is undefined..*/
2fcb0 0a 73 74 61 74 69 63 20 69 6e 74 20 68 61 73 48 .static int hasH
2fcc0 6f 74 4a 6f 75 72 6e 61 6c 28 50 61 67 65 72 20 otJournal(Pager
2fcd0 2a 70 50 61 67 65 72 2c 20 69 6e 74 20 2a 70 45 *pPager, int *pE
2fce0 78 69 73 74 73 29 7b 0a 20 20 73 71 6c 69 74 65 xists){. sqlite
2fcf0 33 5f 76 66 73 20 2a 20 63 6f 6e 73 74 20 70 56 3_vfs * const pV
2fd00 66 73 20 3d 20 70 50 61 67 65 72 2d 3e 70 56 66 fs = pPager->pVf
2fd10 73 3b 0a 20 20 69 6e 74 20 72 63 20 3d 20 53 51 s;. int rc = SQ
2fd20 4c 49 54 45 5f 4f 4b 3b 20 20 20 20 20 20 20 20 LITE_OK;
2fd30 20 20 20 2f 2a 20 52 65 74 75 72 6e 20 63 6f 64 /* Return cod
2fd40 65 20 2a 2f 0a 20 20 69 6e 74 20 65 78 69 73 74 e */. int exist
2fd50 73 20 3d 20 31 3b 20 20 20 20 20 20 20 20 20 20 s = 1;
2fd60 20 20 20 20 20 2f 2a 20 54 72 75 65 20 69 66 20 /* True if
2fd70 61 20 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 20 69 a journal file i
2fd80 73 20 70 72 65 73 65 6e 74 20 2a 2f 0a 20 20 69 s present */. i
2fd90 6e 74 20 6a 72 6e 6c 4f 70 65 6e 20 3d 20 21 21 nt jrnlOpen = !!
2fda0 69 73 4f 70 65 6e 28 70 50 61 67 65 72 2d 3e 6a isOpen(pPager->j
2fdb0 66 64 29 3b 0a 0a 20 20 61 73 73 65 72 74 28 20 fd);.. assert(
2fdc0 70 50 61 67 65 72 2d 3e 75 73 65 4a 6f 75 72 6e pPager->useJourn
2fdd0 61 6c 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 al );. assert(
2fde0 69 73 4f 70 65 6e 28 70 50 61 67 65 72 2d 3e 66 isOpen(pPager->f
2fdf0 64 29 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 d) );. assert(
2fe00 70 50 61 67 65 72 2d 3e 65 53 74 61 74 65 3d 3d pPager->eState==
2fe10 50 41 47 45 52 5f 4f 50 45 4e 20 29 3b 0a 0a 20 PAGER_OPEN );..
2fe20 20 61 73 73 65 72 74 28 20 6a 72 6e 6c 4f 70 65 assert( jrnlOpe
2fe30 6e 3d 3d 30 20 7c 7c 20 28 20 73 71 6c 69 74 65 n==0 || ( sqlite
2fe40 33 4f 73 44 65 76 69 63 65 43 68 61 72 61 63 74 3OsDeviceCharact
2fe50 65 72 69 73 74 69 63 73 28 70 50 61 67 65 72 2d eristics(pPager-
2fe60 3e 6a 66 64 29 20 26 0a 20 20 20 20 53 51 4c 49 >jfd) &. SQLI
2fe70 54 45 5f 49 4f 43 41 50 5f 55 4e 44 45 4c 45 54 TE_IOCAP_UNDELET
2fe80 41 42 4c 45 5f 57 48 45 4e 5f 4f 50 45 4e 0a 20 ABLE_WHEN_OPEN.
2fe90 20 29 29 3b 0a 0a 20 20 2a 70 45 78 69 73 74 73 ));.. *pExists
2fea0 20 3d 20 30 3b 0a 20 20 69 66 28 20 21 6a 72 6e = 0;. if( !jrn
2feb0 6c 4f 70 65 6e 20 29 7b 0a 20 20 20 20 72 63 20 lOpen ){. rc
2fec0 3d 20 73 71 6c 69 74 65 33 4f 73 41 63 63 65 73 = sqlite3OsAcces
2fed0 73 28 70 56 66 73 2c 20 70 50 61 67 65 72 2d 3e s(pVfs, pPager->
2fee0 7a 4a 6f 75 72 6e 61 6c 2c 20 53 51 4c 49 54 45 zJournal, SQLITE
2fef0 5f 41 43 43 45 53 53 5f 45 58 49 53 54 53 2c 20 _ACCESS_EXISTS,
2ff00 26 65 78 69 73 74 73 29 3b 0a 20 20 7d 0a 20 20 &exists);. }.
2ff10 69 66 28 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4f if( rc==SQLITE_O
2ff20 4b 20 26 26 20 65 78 69 73 74 73 20 29 7b 0a 20 K && exists ){.
2ff30 20 20 20 69 6e 74 20 6c 6f 63 6b 65 64 20 3d 20 int locked =
2ff40 30 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 0; /
2ff50 2a 20 54 72 75 65 20 69 66 20 73 6f 6d 65 20 70 * True if some p
2ff60 72 6f 63 65 73 73 20 68 6f 6c 64 73 20 61 20 52 rocess holds a R
2ff70 45 53 45 52 56 45 44 20 6c 6f 63 6b 20 2a 2f 0a ESERVED lock */.
2ff80 0a 20 20 20 20 2f 2a 20 52 61 63 65 20 63 6f 6e . /* Race con
2ff90 64 69 74 69 6f 6e 20 68 65 72 65 3a 20 20 41 6e dition here: An
2ffa0 6f 74 68 65 72 20 70 72 6f 63 65 73 73 20 6d 69 other process mi
2ffb0 67 68 74 20 68 61 76 65 20 62 65 65 6e 20 68 6f ght have been ho
2ffc0 6c 64 69 6e 67 20 74 68 65 0a 20 20 20 20 2a 2a lding the. **
2ffd0 20 74 68 65 20 52 45 53 45 52 56 45 44 20 6c 6f the RESERVED lo
2ffe0 63 6b 20 61 6e 64 20 68 61 76 65 20 61 20 6a 6f ck and have a jo
2fff0 75 72 6e 61 6c 20 6f 70 65 6e 20 61 74 20 74 68 urnal open at th
30000 65 20 73 71 6c 69 74 65 33 4f 73 41 63 63 65 73 e sqlite3OsAcces
30010 73 28 29 20 0a 20 20 20 20 2a 2a 20 63 61 6c 6c s() . ** call
30020 20 61 62 6f 76 65 2c 20 62 75 74 20 74 68 65 6e above, but then
30030 20 64 65 6c 65 74 65 20 74 68 65 20 6a 6f 75 72 delete the jour
30040 6e 61 6c 20 61 6e 64 20 64 72 6f 70 20 74 68 65 nal and drop the
30050 20 6c 6f 63 6b 20 62 65 66 6f 72 65 0a 20 20 20 lock before.
30060 20 2a 2a 20 77 65 20 67 65 74 20 74 6f 20 74 68 ** we get to th
30070 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 73 71 6c 69 e following sqli
30080 74 65 33 4f 73 43 68 65 63 6b 52 65 73 65 72 76 te3OsCheckReserv
30090 65 64 4c 6f 63 6b 28 29 20 63 61 6c 6c 2e 20 20 edLock() call.
300a0 49 66 20 74 68 61 74 0a 20 20 20 20 2a 2a 20 69 If that. ** i
300b0 73 20 74 68 65 20 63 61 73 65 2c 20 74 68 69 73 s the case, this
300c0 20 72 6f 75 74 69 6e 65 20 6d 69 67 68 74 20 74 routine might t
300d0 68 69 6e 6b 20 74 68 65 72 65 20 69 73 20 61 20 hink there is a
300e0 68 6f 74 20 6a 6f 75 72 6e 61 6c 20 77 68 65 6e hot journal when
300f0 0a 20 20 20 20 2a 2a 20 69 6e 20 66 61 63 74 20 . ** in fact
30100 74 68 65 72 65 20 69 73 20 6e 6f 6e 65 2e 20 20 there is none.
30110 54 68 69 73 20 72 65 73 75 6c 74 73 20 69 6e 20 This results in
30120 61 20 66 61 6c 73 65 2d 70 6f 73 69 74 69 76 65 a false-positive
30130 20 77 68 69 63 68 20 77 69 6c 6c 0a 20 20 20 20 which will.
30140 2a 2a 20 62 65 20 64 65 61 6c 74 20 77 69 74 68 ** be dealt with
30150 20 62 79 20 74 68 65 20 70 6c 61 79 62 61 63 6b by the playback
30160 20 72 6f 75 74 69 6e 65 2e 20 20 54 69 63 6b 65 routine. Ticke
30170 74 20 23 33 38 38 33 2e 0a 20 20 20 20 2a 2f 0a t #3883.. */.
30180 20 20 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33 rc = sqlite3
30190 4f 73 43 68 65 63 6b 52 65 73 65 72 76 65 64 4c OsCheckReservedL
301a0 6f 63 6b 28 70 50 61 67 65 72 2d 3e 66 64 2c 20 ock(pPager->fd,
301b0 26 6c 6f 63 6b 65 64 29 3b 0a 20 20 20 20 69 66 &locked);. if
301c0 28 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 ( rc==SQLITE_OK
301d0 26 26 20 21 6c 6f 63 6b 65 64 20 29 7b 0a 20 20 && !locked ){.
301e0 20 20 20 20 50 67 6e 6f 20 6e 50 61 67 65 3b 20 Pgno nPage;
301f0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
30200 2f 2a 20 4e 75 6d 62 65 72 20 6f 66 20 70 61 67 /* Number of pag
30210 65 73 20 69 6e 20 64 61 74 61 62 61 73 65 20 66 es in database f
30220 69 6c 65 20 2a 2f 0a 0a 20 20 20 20 20 20 72 63 ile */.. rc
30230 20 3d 20 70 61 67 65 72 50 61 67 65 63 6f 75 6e = pagerPagecoun
30240 74 28 70 50 61 67 65 72 2c 20 26 6e 50 61 67 65 t(pPager, &nPage
30250 29 3b 0a 20 20 20 20 20 20 69 66 28 20 72 63 3d );. if( rc=
30260 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 =SQLITE_OK ){.
30270 20 20 20 20 20 20 2f 2a 20 49 66 20 74 68 65 20 /* If the
30280 64 61 74 61 62 61 73 65 20 69 73 20 7a 65 72 6f database is zero
30290 20 70 61 67 65 73 20 69 6e 20 73 69 7a 65 2c 20 pages in size,
302a0 74 68 61 74 20 6d 65 61 6e 73 20 74 68 61 74 20 that means that
302b0 65 69 74 68 65 72 20 28 31 29 20 74 68 65 0a 20 either (1) the.
302c0 20 20 20 20 20 20 20 2a 2a 20 6a 6f 75 72 6e 61 ** journa
302d0 6c 20 69 73 20 61 20 72 65 6d 6e 61 6e 74 20 66 l is a remnant f
302e0 72 6f 6d 20 61 20 70 72 69 6f 72 20 64 61 74 61 rom a prior data
302f0 62 61 73 65 20 77 69 74 68 20 74 68 65 20 73 61 base with the sa
30300 6d 65 20 6e 61 6d 65 20 77 68 65 72 65 0a 20 20 me name where.
30310 20 20 20 20 20 20 2a 2a 20 74 68 65 20 64 61 74 ** the dat
30320 61 62 61 73 65 20 66 69 6c 65 20 62 75 74 20 6e abase file but n
30330 6f 74 20 74 68 65 20 6a 6f 75 72 6e 61 6c 20 77 ot the journal w
30340 61 73 20 64 65 6c 65 74 65 64 2c 20 6f 72 20 28 as deleted, or (
30350 32 29 20 74 68 65 20 69 6e 69 74 69 61 6c 0a 20 2) the initial.
30360 20 20 20 20 20 20 20 2a 2a 20 74 72 61 6e 73 61 ** transa
30370 63 74 69 6f 6e 20 74 68 61 74 20 70 6f 70 75 6c ction that popul
30380 61 74 65 73 20 61 20 6e 65 77 20 64 61 74 61 62 ates a new datab
30390 61 73 65 20 69 73 20 62 65 69 6e 67 20 72 6f 6c ase is being rol
303a0 6c 65 64 20 62 61 63 6b 2e 0a 20 20 20 20 20 20 led back..
303b0 20 20 2a 2a 20 49 6e 20 65 69 74 68 65 72 20 63 ** In either c
303c0 61 73 65 2c 20 74 68 65 20 6a 6f 75 72 6e 61 6c ase, the journal
303d0 20 66 69 6c 65 20 63 61 6e 20 62 65 20 64 65 6c file can be del
303e0 65 74 65 64 2e 20 20 48 6f 77 65 76 65 72 2c 20 eted. However,
303f0 74 61 6b 65 20 63 61 72 65 0a 20 20 20 20 20 20 take care.
30400 20 20 2a 2a 20 6e 6f 74 20 74 6f 20 64 65 6c 65 ** not to dele
30410 74 65 20 74 68 65 20 6a 6f 75 72 6e 61 6c 20 66 te the journal f
30420 69 6c 65 20 69 66 20 69 74 20 69 73 20 61 6c 72 ile if it is alr
30430 65 61 64 79 20 6f 70 65 6e 20 64 75 65 20 74 6f eady open due to
30440 0a 20 20 20 20 20 20 20 20 2a 2a 20 6a 6f 75 72 . ** jour
30450 6e 61 6c 5f 6d 6f 64 65 3d 50 45 52 53 49 53 54 nal_mode=PERSIST
30460 2e 0a 20 20 20 20 20 20 20 20 2a 2f 0a 20 20 20 .. */.
30470 20 20 20 20 20 69 66 28 20 6e 50 61 67 65 3d 3d if( nPage==
30480 30 20 26 26 20 21 6a 72 6e 6c 4f 70 65 6e 20 29 0 && !jrnlOpen )
30490 7b 0a 20 20 20 20 20 20 20 20 20 20 73 71 6c 69 {. sqli
304a0 74 65 33 42 65 67 69 6e 42 65 6e 69 67 6e 4d 61 te3BeginBenignMa
304b0 6c 6c 6f 63 28 29 3b 0a 20 20 20 20 20 20 20 20 lloc();.
304c0 20 20 69 66 28 20 70 61 67 65 72 4c 6f 63 6b 44 if( pagerLockD
304d0 62 28 70 50 61 67 65 72 2c 20 52 45 53 45 52 56 b(pPager, RESERV
304e0 45 44 5f 4c 4f 43 4b 29 3d 3d 53 51 4c 49 54 45 ED_LOCK)==SQLITE
304f0 5f 4f 4b 20 29 7b 0a 20 20 20 20 20 20 20 20 20 _OK ){.
30500 20 20 20 73 71 6c 69 74 65 33 4f 73 44 65 6c 65 sqlite3OsDele
30510 74 65 28 70 56 66 73 2c 20 70 50 61 67 65 72 2d te(pVfs, pPager-
30520 3e 7a 4a 6f 75 72 6e 61 6c 2c 20 30 29 3b 0a 20 >zJournal, 0);.
30530 20 20 20 20 20 20 20 20 20 20 20 69 66 28 20 21 if( !
30540 70 50 61 67 65 72 2d 3e 65 78 63 6c 75 73 69 76 pPager->exclusiv
30550 65 4d 6f 64 65 20 29 20 70 61 67 65 72 55 6e 6c eMode ) pagerUnl
30560 6f 63 6b 44 62 28 70 50 61 67 65 72 2c 20 53 48 ockDb(pPager, SH
30570 41 52 45 44 5f 4c 4f 43 4b 29 3b 0a 20 20 20 20 ARED_LOCK);.
30580 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 20 20 }.
30590 20 20 73 71 6c 69 74 65 33 45 6e 64 42 65 6e 69 sqlite3EndBeni
305a0 67 6e 4d 61 6c 6c 6f 63 28 29 3b 0a 20 20 20 20 gnMalloc();.
305b0 20 20 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 20 }else{.
305c0 20 20 20 20 20 2f 2a 20 54 68 65 20 6a 6f 75 72 /* The jour
305d0 6e 61 6c 20 66 69 6c 65 20 65 78 69 73 74 73 20 nal file exists
305e0 61 6e 64 20 6e 6f 20 6f 74 68 65 72 20 63 6f 6e and no other con
305f0 6e 65 63 74 69 6f 6e 20 68 61 73 20 61 20 72 65 nection has a re
30600 73 65 72 76 65 64 0a 20 20 20 20 20 20 20 20 20 served.
30610 20 2a 2a 20 6f 72 20 67 72 65 61 74 65 72 20 6c ** or greater l
30620 6f 63 6b 20 6f 6e 20 74 68 65 20 64 61 74 61 62 ock on the datab
30630 61 73 65 20 66 69 6c 65 2e 20 4e 6f 77 20 63 68 ase file. Now ch
30640 65 63 6b 20 74 68 61 74 20 74 68 65 72 65 20 69 eck that there i
30650 73 0a 20 20 20 20 20 20 20 20 20 20 2a 2a 20 61 s. ** a
30660 74 20 6c 65 61 73 74 20 6f 6e 65 20 6e 6f 6e 2d t least one non-
30670 7a 65 72 6f 20 62 79 74 65 73 20 61 74 20 74 68 zero bytes at th
30680 65 20 73 74 61 72 74 20 6f 66 20 74 68 65 20 6a e start of the j
30690 6f 75 72 6e 61 6c 20 66 69 6c 65 2e 0a 20 20 20 ournal file..
306a0 20 20 20 20 20 20 20 2a 2a 20 49 66 20 74 68 65 ** If the
306b0 72 65 20 69 73 2c 20 74 68 65 6e 20 77 65 20 63 re is, then we c
306c0 6f 6e 73 69 64 65 72 20 74 68 69 73 20 6a 6f 75 onsider this jou
306d0 72 6e 61 6c 20 74 6f 20 62 65 20 68 6f 74 2e 20 rnal to be hot.
306e0 49 66 20 6e 6f 74 2c 20 0a 20 20 20 20 20 20 20 If not, .
306f0 20 20 20 2a 2a 20 69 74 20 63 61 6e 20 62 65 20 ** it can be
30700 69 67 6e 6f 72 65 64 2e 0a 20 20 20 20 20 20 20 ignored..
30710 20 20 20 2a 2f 0a 20 20 20 20 20 20 20 20 20 20 */.
30720 69 66 28 20 21 6a 72 6e 6c 4f 70 65 6e 20 29 7b if( !jrnlOpen ){
30730 0a 20 20 20 20 20 20 20 20 20 20 20 20 69 6e 74 . int
30740 20 66 20 3d 20 53 51 4c 49 54 45 5f 4f 50 45 4e f = SQLITE_OPEN
30750 5f 52 45 41 44 4f 4e 4c 59 7c 53 51 4c 49 54 45 _READONLY|SQLITE
30760 5f 4f 50 45 4e 5f 4d 41 49 4e 5f 4a 4f 55 52 4e _OPEN_MAIN_JOURN
30770 41 4c 3b 0a 20 20 20 20 20 20 20 20 20 20 20 20 AL;.
30780 72 63 20 3d 20 73 71 6c 69 74 65 33 4f 73 4f 70 rc = sqlite3OsOp
30790 65 6e 28 70 56 66 73 2c 20 70 50 61 67 65 72 2d en(pVfs, pPager-
307a0 3e 7a 4a 6f 75 72 6e 61 6c 2c 20 70 50 61 67 65 >zJournal, pPage
307b0 72 2d 3e 6a 66 64 2c 20 66 2c 20 26 66 29 3b 0a r->jfd, f, &f);.
307c0 20 20 20 20 20 20 20 20 20 20 7d 0a 20 20 20 20 }.
307d0 20 20 20 20 20 20 69 66 28 20 72 63 3d 3d 53 51 if( rc==SQ
307e0 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 20 LITE_OK ){.
307f0 20 20 20 20 20 20 20 75 38 20 66 69 72 73 74 20 u8 first
30800 3d 20 30 3b 0a 20 20 20 20 20 20 20 20 20 20 20 = 0;.
30810 20 72 63 20 3d 20 73 71 6c 69 74 65 33 4f 73 52 rc = sqlite3OsR
30820 65 61 64 28 70 50 61 67 65 72 2d 3e 6a 66 64 2c ead(pPager->jfd,
30830 20 28 76 6f 69 64 20 2a 29 26 66 69 72 73 74 2c (void *)&first,
30840 20 31 2c 20 30 29 3b 0a 20 20 20 20 20 20 20 20 1, 0);.
30850 20 20 20 20 69 66 28 20 72 63 3d 3d 53 51 4c 49 if( rc==SQLI
30860 54 45 5f 49 4f 45 52 52 5f 53 48 4f 52 54 5f 52 TE_IOERR_SHORT_R
30870 45 41 44 20 29 7b 0a 20 20 20 20 20 20 20 20 20 EAD ){.
30880 20 20 20 20 20 72 63 20 3d 20 53 51 4c 49 54 45 rc = SQLITE
30890 5f 4f 4b 3b 0a 20 20 20 20 20 20 20 20 20 20 20 _OK;.
308a0 20 7d 0a 20 20 20 20 20 20 20 20 20 20 20 20 69 }. i
308b0 66 28 20 21 6a 72 6e 6c 4f 70 65 6e 20 29 7b 0a f( !jrnlOpen ){.
308c0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 73 71 sq
308d0 6c 69 74 65 33 4f 73 43 6c 6f 73 65 28 70 50 61 lite3OsClose(pPa
308e0 67 65 72 2d 3e 6a 66 64 29 3b 0a 20 20 20 20 20 ger->jfd);.
308f0 20 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 20 }.
30900 20 20 20 20 20 2a 70 45 78 69 73 74 73 20 3d 20 *pExists =
30910 28 66 69 72 73 74 21 3d 30 29 3b 0a 20 20 20 20 (first!=0);.
30920 20 20 20 20 20 20 7d 65 6c 73 65 20 69 66 28 20 }else if(
30930 72 63 3d 3d 53 51 4c 49 54 45 5f 43 41 4e 54 4f rc==SQLITE_CANTO
30940 50 45 4e 20 29 7b 0a 20 20 20 20 20 20 20 20 20 PEN ){.
30950 20 20 20 2f 2a 20 49 66 20 77 65 20 63 61 6e 6e /* If we cann
30960 6f 74 20 6f 70 65 6e 20 74 68 65 20 72 6f 6c 6c ot open the roll
30970 62 61 63 6b 20 6a 6f 75 72 6e 61 6c 20 66 69 6c back journal fil
30980 65 20 69 6e 20 6f 72 64 65 72 20 74 6f 20 73 65 e in order to se
30990 65 20 69 66 0a 20 20 20 20 20 20 20 20 20 20 20 e if.
309a0 20 2a 2a 20 69 74 20 68 61 73 20 61 20 7a 65 72 ** it has a zer
309b0 6f 20 68 65 61 64 65 72 2c 20 74 68 61 74 20 6d o header, that m
309c0 69 67 68 74 20 62 65 20 64 75 65 20 74 6f 20 61 ight be due to a
309d0 6e 20 49 2f 4f 20 65 72 72 6f 72 2c 20 6f 72 0a n I/O error, or.
309e0 20 20 20 20 20 20 20 20 20 20 20 20 2a 2a 20 69 ** i
309f0 74 20 6d 69 67 68 74 20 62 65 20 64 75 65 20 74 t might be due t
30a00 6f 20 74 68 65 20 72 61 63 65 20 63 6f 6e 64 69 o the race condi
30a10 74 69 6f 6e 20 64 65 73 63 72 69 62 65 64 20 61 tion described a
30a20 62 6f 76 65 20 61 6e 64 20 69 6e 0a 20 20 20 20 bove and in.
30a30 20 20 20 20 20 20 20 20 2a 2a 20 74 69 63 6b 65 ** ticke
30a40 74 20 23 33 38 38 33 2e 20 20 45 69 74 68 65 72 t #3883. Either
30a50 20 77 61 79 2c 20 61 73 73 75 6d 65 20 74 68 61 way, assume tha
30a60 74 20 74 68 65 20 6a 6f 75 72 6e 61 6c 20 69 73 t the journal is
30a70 20 68 6f 74 2e 0a 20 20 20 20 20 20 20 20 20 20 hot..
30a80 20 20 2a 2a 20 54 68 69 73 20 6d 69 67 68 74 20 ** This might
30a90 62 65 20 61 20 66 61 6c 73 65 20 70 6f 73 69 74 be a false posit
30aa0 69 76 65 2e 20 20 42 75 74 20 69 66 20 69 74 20 ive. But if it
30ab0 69 73 2c 20 74 68 65 6e 20 74 68 65 0a 20 20 20 is, then the.
30ac0 20 20 20 20 20 20 20 20 20 2a 2a 20 61 75 74 6f ** auto
30ad0 6d 61 74 69 63 20 6a 6f 75 72 6e 61 6c 20 70 6c matic journal pl
30ae0 61 79 62 61 63 6b 20 61 6e 64 20 72 65 63 6f 76 ayback and recov
30af0 65 72 79 20 6d 65 63 68 61 6e 69 73 6d 20 77 69 ery mechanism wi
30b00 6c 6c 20 64 65 61 6c 0a 20 20 20 20 20 20 20 20 ll deal.
30b10 20 20 20 20 2a 2a 20 77 69 74 68 20 69 74 20 75 ** with it u
30b20 6e 64 65 72 20 61 6e 20 45 58 43 4c 55 53 49 56 nder an EXCLUSIV
30b30 45 20 6c 6f 63 6b 20 77 68 65 72 65 20 77 65 20 E lock where we
30b40 64 6f 20 6e 6f 74 20 6e 65 65 64 20 74 6f 0a 20 do not need to.
30b50 20 20 20 20 20 20 20 20 20 20 20 2a 2a 20 77 6f ** wo
30b60 72 72 79 20 73 6f 20 6d 75 63 68 20 77 69 74 68 rry so much with
30b70 20 72 61 63 65 20 63 6f 6e 64 69 74 69 6f 6e 73 race conditions
30b80 2e 0a 20 20 20 20 20 20 20 20 20 20 20 20 2a 2f .. */
30b90 0a 20 20 20 20 20 20 20 20 20 20 20 20 2a 70 45 . *pE
30ba0 78 69 73 74 73 20 3d 20 31 3b 0a 20 20 20 20 20 xists = 1;.
30bb0 20 20 20 20 20 20 20 72 63 20 3d 20 53 51 4c 49 rc = SQLI
30bc0 54 45 5f 4f 4b 3b 0a 20 20 20 20 20 20 20 20 20 TE_OK;.
30bd0 20 7d 0a 20 20 20 20 20 20 20 20 7d 0a 20 20 20 }. }.
30be0 20 20 20 7d 0a 20 20 20 20 7d 0a 20 20 7d 0a 0a }. }. }..
30bf0 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 7d 0a 0a return rc;.}..
30c00 2f 2a 0a 2a 2a 20 54 68 69 73 20 66 75 6e 63 74 /*.** This funct
30c10 69 6f 6e 20 69 73 20 63 61 6c 6c 65 64 20 74 6f ion is called to
30c20 20 6f 62 74 61 69 6e 20 61 20 73 68 61 72 65 64 obtain a shared
30c30 20 6c 6f 63 6b 20 6f 6e 20 74 68 65 20 64 61 74 lock on the dat
30c40 61 62 61 73 65 20 66 69 6c 65 2e 0a 2a 2a 20 49 abase file..** I
30c50 74 20 69 73 20 69 6c 6c 65 67 61 6c 20 74 6f 20 t is illegal to
30c60 63 61 6c 6c 20 73 71 6c 69 74 65 33 50 61 67 65 call sqlite3Page
30c70 72 47 65 74 28 29 20 75 6e 74 69 6c 20 61 66 74 rGet() until aft
30c80 65 72 20 74 68 69 73 20 66 75 6e 63 74 69 6f 6e er this function
30c90 0a 2a 2a 20 68 61 73 20 62 65 65 6e 20 73 75 63 .** has been suc
30ca0 63 65 73 73 66 75 6c 6c 79 20 63 61 6c 6c 65 64 cessfully called
30cb0 2e 20 49 66 20 61 20 73 68 61 72 65 64 2d 6c 6f . If a shared-lo
30cc0 63 6b 20 69 73 20 61 6c 72 65 61 64 79 20 68 65 ck is already he
30cd0 6c 64 20 77 68 65 6e 0a 2a 2a 20 74 68 69 73 20 ld when.** this
30ce0 66 75 6e 63 74 69 6f 6e 20 69 73 20 63 61 6c 6c function is call
30cf0 65 64 2c 20 69 74 20 69 73 20 61 20 6e 6f 2d 6f ed, it is a no-o
30d00 70 2e 0a 2a 2a 0a 2a 2a 20 54 68 65 20 66 6f 6c p..**.** The fol
30d10 6c 6f 77 69 6e 67 20 6f 70 65 72 61 74 69 6f 6e lowing operation
30d20 73 20 61 72 65 20 61 6c 73 6f 20 70 65 72 66 6f s are also perfo
30d30 72 6d 65 64 20 62 79 20 74 68 69 73 20 66 75 6e rmed by this fun
30d40 63 74 69 6f 6e 2e 0a 2a 2a 0a 2a 2a 20 20 20 31 ction..**.** 1
30d50 29 20 49 66 20 74 68 65 20 70 61 67 65 72 20 69 ) If the pager i
30d60 73 20 63 75 72 72 65 6e 74 6c 79 20 69 6e 20 50 s currently in P
30d70 41 47 45 52 5f 4f 50 45 4e 20 73 74 61 74 65 20 AGER_OPEN state
30d80 28 6e 6f 20 6c 6f 63 6b 20 68 65 6c 64 0a 2a 2a (no lock held.**
30d90 20 20 20 20 20 20 6f 6e 20 74 68 65 20 64 61 74 on the dat
30da0 61 62 61 73 65 20 66 69 6c 65 29 2c 20 74 68 65 abase file), the
30db0 6e 20 61 6e 20 61 74 74 65 6d 70 74 20 69 73 20 n an attempt is
30dc0 6d 61 64 65 20 74 6f 20 6f 62 74 61 69 6e 20 61 made to obtain a
30dd0 0a 2a 2a 20 20 20 20 20 20 53 48 41 52 45 44 20 .** SHARED
30de0 6c 6f 63 6b 20 6f 6e 20 74 68 65 20 64 61 74 61 lock on the data
30df0 62 61 73 65 20 66 69 6c 65 2e 20 49 6d 6d 65 64 base file. Immed
30e00 69 61 74 65 6c 79 20 61 66 74 65 72 20 6f 62 74 iately after obt
30e10 61 69 6e 69 6e 67 0a 2a 2a 20 20 20 20 20 20 74 aining.** t
30e20 68 65 20 53 48 41 52 45 44 20 6c 6f 63 6b 2c 20 he SHARED lock,
30e30 74 68 65 20 66 69 6c 65 2d 73 79 73 74 65 6d 20 the file-system
30e40 69 73 20 63 68 65 63 6b 65 64 20 66 6f 72 20 61 is checked for a
30e50 20 68 6f 74 2d 6a 6f 75 72 6e 61 6c 2c 0a 2a 2a hot-journal,.**
30e60 20 20 20 20 20 20 77 68 69 63 68 20 69 73 20 70 which is p
30e70 6c 61 79 65 64 20 62 61 63 6b 20 69 66 20 70 72 layed back if pr
30e80 65 73 65 6e 74 2e 20 46 6f 6c 6c 6f 77 69 6e 67 esent. Following
30e90 20 61 6e 79 20 68 6f 74 2d 6a 6f 75 72 6e 61 6c any hot-journal
30ea0 20 0a 2a 2a 20 20 20 20 20 20 72 6f 6c 6c 62 61 .** rollba
30eb0 63 6b 2c 20 74 68 65 20 63 6f 6e 74 65 6e 74 73 ck, the contents
30ec0 20 6f 66 20 74 68 65 20 63 61 63 68 65 20 61 72 of the cache ar
30ed0 65 20 76 61 6c 69 64 61 74 65 64 20 62 79 20 63 e validated by c
30ee0 68 65 63 6b 69 6e 67 0a 2a 2a 20 20 20 20 20 20 hecking.**
30ef0 74 68 65 20 27 63 68 61 6e 67 65 2d 63 6f 75 6e the 'change-coun
30f00 74 65 72 27 20 66 69 65 6c 64 20 6f 66 20 74 68 ter' field of th
30f10 65 20 64 61 74 61 62 61 73 65 20 66 69 6c 65 20 e database file
30f20 68 65 61 64 65 72 20 61 6e 64 0a 2a 2a 20 20 20 header and.**
30f30 20 20 20 64 69 73 63 61 72 64 65 64 20 69 66 20 discarded if
30f40 74 68 65 79 20 61 72 65 20 66 6f 75 6e 64 20 74 they are found t
30f50 6f 20 62 65 20 69 6e 76 61 6c 69 64 2e 0a 2a 2a o be invalid..**
30f60 0a 2a 2a 20 20 20 32 29 20 49 66 20 74 68 65 20 .** 2) If the
30f70 70 61 67 65 72 20 69 73 20 72 75 6e 6e 69 6e 67 pager is running
30f80 20 69 6e 20 65 78 63 6c 75 73 69 76 65 2d 6d 6f in exclusive-mo
30f90 64 65 2c 20 61 6e 64 20 74 68 65 72 65 20 61 72 de, and there ar
30fa0 65 20 63 75 72 72 65 6e 74 6c 79 0a 2a 2a 20 20 e currently.**
30fb0 20 20 20 20 6e 6f 20 6f 75 74 73 74 61 6e 64 69 no outstandi
30fc0 6e 67 20 72 65 66 65 72 65 6e 63 65 73 20 74 6f ng references to
30fd0 20 61 6e 79 20 70 61 67 65 73 2c 20 61 6e 64 20 any pages, and
30fe0 69 73 20 69 6e 20 74 68 65 20 65 72 72 6f 72 20 is in the error
30ff0 73 74 61 74 65 2c 0a 2a 2a 20 20 20 20 20 20 74 state,.** t
31000 68 65 6e 20 61 6e 20 61 74 74 65 6d 70 74 20 69 hen an attempt i
31010 73 20 6d 61 64 65 20 74 6f 20 63 6c 65 61 72 20 s made to clear
31020 74 68 65 20 65 72 72 6f 72 20 73 74 61 74 65 20 the error state
31030 62 79 20 64 69 73 63 61 72 64 69 6e 67 0a 2a 2a by discarding.**
31040 20 20 20 20 20 20 74 68 65 20 63 6f 6e 74 65 6e the conten
31050 74 73 20 6f 66 20 74 68 65 20 70 61 67 65 20 63 ts of the page c
31060 61 63 68 65 20 61 6e 64 20 72 6f 6c 6c 69 6e 67 ache and rolling
31070 20 62 61 63 6b 20 61 6e 79 20 6f 70 65 6e 20 6a back any open j
31080 6f 75 72 6e 61 6c 0a 2a 2a 20 20 20 20 20 20 66 ournal.** f
31090 69 6c 65 2e 0a 2a 2a 0a 2a 2a 20 49 66 20 65 76 ile..**.** If ev
310a0 65 72 79 74 68 69 6e 67 20 69 73 20 73 75 63 63 erything is succ
310b0 65 73 73 66 75 6c 2c 20 53 51 4c 49 54 45 5f 4f essful, SQLITE_O
310c0 4b 20 69 73 20 72 65 74 75 72 6e 65 64 2e 20 49 K is returned. I
310d0 66 20 61 6e 20 49 4f 20 65 72 72 6f 72 20 0a 2a f an IO error .*
310e0 2a 20 6f 63 63 75 72 73 20 77 68 69 6c 65 20 6c * occurs while l
310f0 6f 63 6b 69 6e 67 20 74 68 65 20 64 61 74 61 62 ocking the datab
31100 61 73 65 2c 20 63 68 65 63 6b 69 6e 67 20 66 6f ase, checking fo
31110 72 20 61 20 68 6f 74 2d 6a 6f 75 72 6e 61 6c 20 r a hot-journal
31120 66 69 6c 65 20 6f 72 20 0a 2a 2a 20 72 6f 6c 6c file or .** roll
31130 69 6e 67 20 62 61 63 6b 20 61 20 6a 6f 75 72 6e ing back a journ
31140 61 6c 20 66 69 6c 65 2c 20 74 68 65 20 49 4f 20 al file, the IO
31150 65 72 72 6f 72 20 63 6f 64 65 20 69 73 20 72 65 error code is re
31160 74 75 72 6e 65 64 2e 0a 2a 2f 0a 69 6e 74 20 73 turned..*/.int s
31170 71 6c 69 74 65 33 50 61 67 65 72 53 68 61 72 65 qlite3PagerShare
31180 64 4c 6f 63 6b 28 50 61 67 65 72 20 2a 70 50 61 dLock(Pager *pPa
31190 67 65 72 29 7b 0a 20 20 69 6e 74 20 72 63 20 3d ger){. int rc =
311a0 20 53 51 4c 49 54 45 5f 4f 4b 3b 20 20 20 20 20 SQLITE_OK;
311b0 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 52 65 /* Re
311c0 74 75 72 6e 20 63 6f 64 65 20 2a 2f 0a 0a 20 20 turn code */..
311d0 2f 2a 20 54 68 69 73 20 72 6f 75 74 69 6e 65 20 /* This routine
311e0 69 73 20 6f 6e 6c 79 20 63 61 6c 6c 65 64 20 66 is only called f
311f0 72 6f 6d 20 62 2d 74 72 65 65 20 61 6e 64 20 6f rom b-tree and o
31200 6e 6c 79 20 77 68 65 6e 20 74 68 65 72 65 20 61 nly when there a
31210 72 65 20 6e 6f 0a 20 20 2a 2a 20 6f 75 74 73 74 re no. ** outst
31220 61 6e 64 69 6e 67 20 70 61 67 65 73 2e 20 54 68 anding pages. Th
31230 69 73 20 69 6d 70 6c 69 65 73 20 74 68 61 74 20 is implies that
31240 74 68 65 20 70 61 67 65 72 20 73 74 61 74 65 20 the pager state
31250 73 68 6f 75 6c 64 20 65 69 74 68 65 72 0a 20 20 should either.
31260 2a 2a 20 62 65 20 4f 50 45 4e 20 6f 72 20 52 45 ** be OPEN or RE
31270 41 44 45 52 2e 20 52 45 41 44 45 52 20 69 73 20 ADER. READER is
31280 6f 6e 6c 79 20 70 6f 73 73 69 62 6c 65 20 69 66 only possible if
31290 20 74 68 65 20 70 61 67 65 72 20 69 73 20 6f 72 the pager is or
312a0 20 77 61 73 20 69 6e 20 0a 20 20 2a 2a 20 65 78 was in . ** ex
312b0 63 6c 75 73 69 76 65 20 61 63 63 65 73 73 20 6d clusive access m
312c0 6f 64 65 2e 0a 20 20 2a 2f 0a 20 20 61 73 73 65 ode.. */. asse
312d0 72 74 28 20 73 71 6c 69 74 65 33 50 63 61 63 68 rt( sqlite3Pcach
312e0 65 52 65 66 43 6f 75 6e 74 28 70 50 61 67 65 72 eRefCount(pPager
312f0 2d 3e 70 50 43 61 63 68 65 29 3d 3d 30 20 29 3b ->pPCache)==0 );
31300 0a 20 20 61 73 73 65 72 74 28 20 61 73 73 65 72 . assert( asser
31310 74 5f 70 61 67 65 72 5f 73 74 61 74 65 28 70 50 t_pager_state(pP
31320 61 67 65 72 29 20 29 3b 0a 20 20 69 66 28 20 70 ager) );. if( p
31330 50 61 67 65 72 2d 3e 74 65 6d 70 46 69 6c 65 20 Pager->tempFile
31340 26 26 20 70 50 61 67 65 72 2d 3e 65 72 72 43 6f && pPager->errCo
31350 64 65 20 29 20 7b 20 72 65 74 75 72 6e 20 70 50 de ) { return pP
31360 61 67 65 72 2d 3e 65 72 72 43 6f 64 65 3b 20 7d ager->errCode; }
31370 0a 20 20 61 73 73 65 72 74 28 20 70 50 61 67 65 . assert( pPage
31380 72 2d 3e 65 53 74 61 74 65 3d 3d 50 41 47 45 52 r->eState==PAGER
31390 5f 4f 50 45 4e 20 7c 7c 20 70 50 61 67 65 72 2d _OPEN || pPager-
313a0 3e 65 53 74 61 74 65 3d 3d 50 41 47 45 52 5f 52 >eState==PAGER_R
313b0 45 41 44 45 52 20 29 3b 0a 0a 20 20 69 66 28 20 EADER );.. if(
313c0 21 70 61 67 65 72 55 73 65 57 61 6c 28 70 50 61 !pagerUseWal(pPa
313d0 67 65 72 29 20 26 26 20 70 50 61 67 65 72 2d 3e ger) && pPager->
313e0 65 53 74 61 74 65 3d 3d 50 41 47 45 52 5f 4f 50 eState==PAGER_OP
313f0 45 4e 20 29 7b 0a 20 20 20 20 69 6e 74 20 62 48 EN ){. int bH
31400 6f 74 4a 6f 75 72 6e 61 6c 20 3d 20 31 3b 20 20 otJournal = 1;
31410 20 20 20 20 20 20 20 20 2f 2a 20 54 72 75 65 20 /* True
31420 69 66 20 74 68 65 72 65 20 65 78 69 73 74 73 20 if there exists
31430 61 20 68 6f 74 20 6a 6f 75 72 6e 61 6c 2d 66 69 a hot journal-fi
31440 6c 65 20 2a 2f 0a 0a 20 20 20 20 61 73 73 65 72 le */.. asser
31450 74 28 20 21 4d 45 4d 44 42 20 29 3b 0a 0a 20 20 t( !MEMDB );..
31460 20 20 72 63 20 3d 20 70 61 67 65 72 5f 77 61 69 rc = pager_wai
31470 74 5f 6f 6e 5f 6c 6f 63 6b 28 70 50 61 67 65 72 t_on_lock(pPager
31480 2c 20 53 48 41 52 45 44 5f 4c 4f 43 4b 29 3b 0a , SHARED_LOCK);.
31490 20 20 20 20 69 66 28 20 72 63 21 3d 53 51 4c 49 if( rc!=SQLI
314a0 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 20 20 61 TE_OK ){. a
314b0 73 73 65 72 74 28 20 70 50 61 67 65 72 2d 3e 65 ssert( pPager->e
314c0 4c 6f 63 6b 3d 3d 4e 4f 5f 4c 4f 43 4b 20 7c 7c Lock==NO_LOCK ||
314d0 20 70 50 61 67 65 72 2d 3e 65 4c 6f 63 6b 3d 3d pPager->eLock==
314e0 55 4e 4b 4e 4f 57 4e 5f 4c 4f 43 4b 20 29 3b 0a UNKNOWN_LOCK );.
314f0 20 20 20 20 20 20 67 6f 74 6f 20 66 61 69 6c 65 goto faile
31500 64 3b 0a 20 20 20 20 7d 0a 0a 20 20 20 20 2f 2a d;. }.. /*
31510 20 49 66 20 61 20 6a 6f 75 72 6e 61 6c 20 66 69 If a journal fi
31520 6c 65 20 65 78 69 73 74 73 2c 20 61 6e 64 20 74 le exists, and t
31530 68 65 72 65 20 69 73 20 6e 6f 20 52 45 53 45 52 here is no RESER
31540 56 45 44 20 6c 6f 63 6b 20 6f 6e 20 74 68 65 0a VED lock on the.
31550 20 20 20 20 2a 2a 20 64 61 74 61 62 61 73 65 20 ** database
31560 66 69 6c 65 2c 20 74 68 65 6e 20 69 74 20 65 69 file, then it ei
31570 74 68 65 72 20 6e 65 65 64 73 20 74 6f 20 62 65 ther needs to be
31580 20 70 6c 61 79 65 64 20 62 61 63 6b 20 6f 72 20 played back or
31590 64 65 6c 65 74 65 64 2e 0a 20 20 20 20 2a 2f 0a deleted.. */.
315a0 20 20 20 20 69 66 28 20 70 50 61 67 65 72 2d 3e if( pPager->
315b0 65 4c 6f 63 6b 3c 3d 53 48 41 52 45 44 5f 4c 4f eLock<=SHARED_LO
315c0 43 4b 20 29 7b 0a 20 20 20 20 20 20 72 63 20 3d CK ){. rc =
315d0 20 68 61 73 48 6f 74 4a 6f 75 72 6e 61 6c 28 70 hasHotJournal(p
315e0 50 61 67 65 72 2c 20 26 62 48 6f 74 4a 6f 75 72 Pager, &bHotJour
315f0 6e 61 6c 29 3b 0a 20 20 20 20 7d 0a 20 20 20 20 nal);. }.
31600 69 66 28 20 72 63 21 3d 53 51 4c 49 54 45 5f 4f if( rc!=SQLITE_O
31610 4b 20 29 7b 0a 20 20 20 20 20 20 67 6f 74 6f 20 K ){. goto
31620 66 61 69 6c 65 64 3b 0a 20 20 20 20 7d 0a 20 20 failed;. }.
31630 20 20 69 66 28 20 62 48 6f 74 4a 6f 75 72 6e 61 if( bHotJourna
31640 6c 20 29 7b 0a 20 20 20 20 20 20 69 66 28 20 70 l ){. if( p
31650 50 61 67 65 72 2d 3e 72 65 61 64 4f 6e 6c 79 20 Pager->readOnly
31660 29 7b 0a 20 20 20 20 20 20 20 20 72 63 20 3d 20 ){. rc =
31670 53 51 4c 49 54 45 5f 52 45 41 44 4f 4e 4c 59 5f SQLITE_READONLY_
31680 52 4f 4c 4c 42 41 43 4b 3b 0a 20 20 20 20 20 20 ROLLBACK;.
31690 20 20 67 6f 74 6f 20 66 61 69 6c 65 64 3b 0a 20 goto failed;.
316a0 20 20 20 20 20 7d 0a 0a 20 20 20 20 20 20 2f 2a }.. /*
316b0 20 47 65 74 20 61 6e 20 45 58 43 4c 55 53 49 56 Get an EXCLUSIV
316c0 45 20 6c 6f 63 6b 20 6f 6e 20 74 68 65 20 64 61 E lock on the da
316d0 74 61 62 61 73 65 20 66 69 6c 65 2e 20 41 74 20 tabase file. At
316e0 74 68 69 73 20 70 6f 69 6e 74 20 69 74 20 69 73 this point it is
316f0 0a 20 20 20 20 20 20 2a 2a 20 69 6d 70 6f 72 74 . ** import
31700 61 6e 74 20 74 68 61 74 20 61 20 52 45 53 45 52 ant that a RESER
31710 56 45 44 20 6c 6f 63 6b 20 69 73 20 6e 6f 74 20 VED lock is not
31720 6f 62 74 61 69 6e 65 64 20 6f 6e 20 74 68 65 20 obtained on the
31730 77 61 79 20 74 6f 20 74 68 65 0a 20 20 20 20 20 way to the.
31740 20 2a 2a 20 45 58 43 4c 55 53 49 56 45 20 6c 6f ** EXCLUSIVE lo
31750 63 6b 2e 20 49 66 20 69 74 20 77 65 72 65 2c 20 ck. If it were,
31760 61 6e 6f 74 68 65 72 20 70 72 6f 63 65 73 73 20 another process
31770 6d 69 67 68 74 20 6f 70 65 6e 20 74 68 65 0a 20 might open the.
31780 20 20 20 20 20 2a 2a 20 64 61 74 61 62 61 73 65 ** database
31790 20 66 69 6c 65 2c 20 64 65 74 65 63 74 20 74 68 file, detect th
317a0 65 20 52 45 53 45 52 56 45 44 20 6c 6f 63 6b 2c e RESERVED lock,
317b0 20 61 6e 64 20 63 6f 6e 63 6c 75 64 65 20 74 68 and conclude th
317c0 61 74 20 74 68 65 0a 20 20 20 20 20 20 2a 2a 20 at the. **
317d0 64 61 74 61 62 61 73 65 20 69 73 20 73 61 66 65 database is safe
317e0 20 74 6f 20 72 65 61 64 20 77 68 69 6c 65 20 74 to read while t
317f0 68 69 73 20 70 72 6f 63 65 73 73 20 69 73 20 73 his process is s
31800 74 69 6c 6c 20 72 6f 6c 6c 69 6e 67 20 74 68 65 till rolling the
31810 20 0a 20 20 20 20 20 20 2a 2a 20 68 6f 74 2d 6a . ** hot-j
31820 6f 75 72 6e 61 6c 20 62 61 63 6b 2e 0a 20 20 20 ournal back..
31830 20 20 20 2a 2a 20 0a 20 20 20 20 20 20 2a 2a 20 ** . **
31840 42 65 63 61 75 73 65 20 74 68 65 20 69 6e 74 65 Because the inte
31850 72 6d 65 64 69 61 74 65 20 52 45 53 45 52 56 45 rmediate RESERVE
31860 44 20 6c 6f 63 6b 20 69 73 20 6e 6f 74 20 72 65 D lock is not re
31870 71 75 65 73 74 65 64 2c 20 61 6e 79 0a 20 20 20 quested, any.
31880 20 20 20 2a 2a 20 6f 74 68 65 72 20 70 72 6f 63 ** other proc
31890 65 73 73 20 61 74 74 65 6d 70 74 69 6e 67 20 74 ess attempting t
318a0 6f 20 61 63 63 65 73 73 20 74 68 65 20 64 61 74 o access the dat
318b0 61 62 61 73 65 20 66 69 6c 65 20 77 69 6c 6c 20 abase file will
318c0 67 65 74 20 74 6f 20 0a 20 20 20 20 20 20 2a 2a get to . **
318d0 20 74 68 69 73 20 70 6f 69 6e 74 20 69 6e 20 74 this point in t
318e0 68 65 20 63 6f 64 65 20 61 6e 64 20 66 61 69 6c he code and fail
318f0 20 74 6f 20 6f 62 74 61 69 6e 20 69 74 73 20 6f to obtain its o
31900 77 6e 20 45 58 43 4c 55 53 49 56 45 20 6c 6f 63 wn EXCLUSIVE loc
31910 6b 20 0a 20 20 20 20 20 20 2a 2a 20 6f 6e 20 74 k . ** on t
31920 68 65 20 64 61 74 61 62 61 73 65 20 66 69 6c 65 he database file
31930 2e 0a 20 20 20 20 20 20 2a 2a 0a 20 20 20 20 20 .. **.
31940 20 2a 2a 20 55 6e 6c 65 73 73 20 74 68 65 20 70 ** Unless the p
31950 61 67 65 72 20 69 73 20 69 6e 20 6c 6f 63 6b 69 ager is in locki
31960 6e 67 5f 6d 6f 64 65 3d 65 78 63 6c 75 73 69 76 ng_mode=exclusiv
31970 65 20 6d 6f 64 65 2c 20 74 68 65 20 6c 6f 63 6b e mode, the lock
31980 20 69 73 0a 20 20 20 20 20 20 2a 2a 20 64 6f 77 is. ** dow
31990 6e 67 72 61 64 65 64 20 74 6f 20 53 48 41 52 45 ngraded to SHARE
319a0 44 5f 4c 4f 43 4b 20 62 65 66 6f 72 65 20 74 68 D_LOCK before th
319b0 69 73 20 66 75 6e 63 74 69 6f 6e 20 72 65 74 75 is function retu
319c0 72 6e 73 2e 0a 20 20 20 20 20 20 2a 2f 0a 20 20 rns.. */.
319d0 20 20 20 20 72 63 20 3d 20 70 61 67 65 72 4c 6f rc = pagerLo
319e0 63 6b 44 62 28 70 50 61 67 65 72 2c 20 45 58 43 ckDb(pPager, EXC
319f0 4c 55 53 49 56 45 5f 4c 4f 43 4b 29 3b 0a 20 20 LUSIVE_LOCK);.
31a00 20 20 20 20 69 66 28 20 72 63 21 3d 53 51 4c 49 if( rc!=SQLI
31a10 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 20 20 20 TE_OK ){.
31a20 20 67 6f 74 6f 20 66 61 69 6c 65 64 3b 0a 20 20 goto failed;.
31a30 20 20 20 20 7d 0a 20 0a 20 20 20 20 20 20 2f 2a }. . /*
31a40 20 49 66 20 69 74 20 69 73 20 6e 6f 74 20 61 6c If it is not al
31a50 72 65 61 64 79 20 6f 70 65 6e 20 61 6e 64 20 74 ready open and t
31a60 68 65 20 66 69 6c 65 20 65 78 69 73 74 73 20 6f he file exists o
31a70 6e 20 64 69 73 6b 2c 20 6f 70 65 6e 20 74 68 65 n disk, open the
31a80 20 0a 20 20 20 20 20 20 2a 2a 20 6a 6f 75 72 6e . ** journ
31a90 61 6c 20 66 6f 72 20 72 65 61 64 2f 77 72 69 74 al for read/writ
31aa0 65 20 61 63 63 65 73 73 2e 20 57 72 69 74 65 20 e access. Write
31ab0 61 63 63 65 73 73 20 69 73 20 72 65 71 75 69 72 access is requir
31ac0 65 64 20 62 65 63 61 75 73 65 20 0a 20 20 20 20 ed because .
31ad0 20 20 2a 2a 20 69 6e 20 65 78 63 6c 75 73 69 76 ** in exclusiv
31ae0 65 2d 61 63 63 65 73 73 20 6d 6f 64 65 20 74 68 e-access mode th
31af0 65 20 66 69 6c 65 20 64 65 73 63 72 69 70 74 6f e file descripto
31b00 72 20 77 69 6c 6c 20 62 65 20 6b 65 70 74 20 6f r will be kept o
31b10 70 65 6e 20 0a 20 20 20 20 20 20 2a 2a 20 61 6e pen . ** an
31b20 64 20 70 6f 73 73 69 62 6c 79 20 75 73 65 64 20 d possibly used
31b30 66 6f 72 20 61 20 74 72 61 6e 73 61 63 74 69 6f for a transactio
31b40 6e 20 6c 61 74 65 72 20 6f 6e 2e 20 41 6c 73 6f n later on. Also
31b50 2c 20 77 72 69 74 65 2d 61 63 63 65 73 73 20 0a , write-access .
31b60 20 20 20 20 20 20 2a 2a 20 69 73 20 75 73 75 61 ** is usua
31b70 6c 6c 79 20 72 65 71 75 69 72 65 64 20 74 6f 20 lly required to
31b80 66 69 6e 61 6c 69 7a 65 20 74 68 65 20 6a 6f 75 finalize the jou
31b90 72 6e 61 6c 20 69 6e 20 6a 6f 75 72 6e 61 6c 5f rnal in journal_
31ba0 6d 6f 64 65 3d 70 65 72 73 69 73 74 20 0a 20 20 mode=persist .
31bb0 20 20 20 20 2a 2a 20 6d 6f 64 65 20 28 61 6e 64 ** mode (and
31bc0 20 61 6c 73 6f 20 66 6f 72 20 6a 6f 75 72 6e 61 also for journa
31bd0 6c 5f 6d 6f 64 65 3d 74 72 75 6e 63 61 74 65 20 l_mode=truncate
31be0 6f 6e 20 73 6f 6d 65 20 73 79 73 74 65 6d 73 29 on some systems)
31bf0 2e 0a 20 20 20 20 20 20 2a 2a 0a 20 20 20 20 20 .. **.
31c00 20 2a 2a 20 49 66 20 74 68 65 20 6a 6f 75 72 6e ** If the journ
31c10 61 6c 20 64 6f 65 73 20 6e 6f 74 20 65 78 69 73 al does not exis
31c20 74 2c 20 69 74 20 75 73 75 61 6c 6c 79 20 6d 65 t, it usually me
31c30 61 6e 73 20 74 68 61 74 20 73 6f 6d 65 20 0a 20 ans that some .
31c40 20 20 20 20 20 2a 2a 20 6f 74 68 65 72 20 63 6f ** other co
31c50 6e 6e 65 63 74 69 6f 6e 20 6d 61 6e 61 67 65 64 nnection managed
31c60 20 74 6f 20 67 65 74 20 69 6e 20 61 6e 64 20 72 to get in and r
31c70 6f 6c 6c 20 69 74 20 62 61 63 6b 20 62 65 66 6f oll it back befo
31c80 72 65 20 0a 20 20 20 20 20 20 2a 2a 20 74 68 69 re . ** thi
31c90 73 20 63 6f 6e 6e 65 63 74 69 6f 6e 20 6f 62 74 s connection obt
31ca0 61 69 6e 65 64 20 74 68 65 20 65 78 63 6c 75 73 ained the exclus
31cb0 69 76 65 20 6c 6f 63 6b 20 61 62 6f 76 65 2e 20 ive lock above.
31cc0 4f 72 2c 20 69 74 20 0a 20 20 20 20 20 20 2a 2a Or, it . **
31cd0 20 6d 61 79 20 6d 65 61 6e 20 74 68 61 74 20 74 may mean that t
31ce0 68 65 20 70 61 67 65 72 20 77 61 73 20 69 6e 20 he pager was in
31cf0 74 68 65 20 65 72 72 6f 72 2d 73 74 61 74 65 20 the error-state
31d00 77 68 65 6e 20 74 68 69 73 0a 20 20 20 20 20 20 when this.
31d10 2a 2a 20 66 75 6e 63 74 69 6f 6e 20 77 61 73 20 ** function was
31d20 63 61 6c 6c 65 64 20 61 6e 64 20 74 68 65 20 6a called and the j
31d30 6f 75 72 6e 61 6c 20 66 69 6c 65 20 64 6f 65 73 ournal file does
31d40 20 6e 6f 74 20 65 78 69 73 74 2e 0a 20 20 20 20 not exist..
31d50 20 20 2a 2f 0a 20 20 20 20 20 20 69 66 28 20 21 */. if( !
31d60 69 73 4f 70 65 6e 28 70 50 61 67 65 72 2d 3e 6a isOpen(pPager->j
31d70 66 64 29 20 29 7b 0a 20 20 20 20 20 20 20 20 73 fd) ){. s
31d80 71 6c 69 74 65 33 5f 76 66 73 20 2a 20 63 6f 6e qlite3_vfs * con
31d90 73 74 20 70 56 66 73 20 3d 20 70 50 61 67 65 72 st pVfs = pPager
31da0 2d 3e 70 56 66 73 3b 0a 20 20 20 20 20 20 20 20 ->pVfs;.
31db0 69 6e 74 20 62 45 78 69 73 74 73 3b 20 20 20 20 int bExists;
31dc0 20 20 20 20 20 20 20 20 20 20 2f 2a 20 54 72 75 /* Tru
31dd0 65 20 69 66 20 6a 6f 75 72 6e 61 6c 20 66 69 6c e if journal fil
31de0 65 20 65 78 69 73 74 73 20 2a 2f 0a 20 20 20 20 e exists */.
31df0 20 20 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33 rc = sqlite3
31e00 4f 73 41 63 63 65 73 73 28 0a 20 20 20 20 20 20 OsAccess(.
31e10 20 20 20 20 20 20 70 56 66 73 2c 20 70 50 61 67 pVfs, pPag
31e20 65 72 2d 3e 7a 4a 6f 75 72 6e 61 6c 2c 20 53 51 er->zJournal, SQ
31e30 4c 49 54 45 5f 41 43 43 45 53 53 5f 45 58 49 53 LITE_ACCESS_EXIS
31e40 54 53 2c 20 26 62 45 78 69 73 74 73 29 3b 0a 20 TS, &bExists);.
31e50 20 20 20 20 20 20 20 69 66 28 20 72 63 3d 3d 53 if( rc==S
31e60 51 4c 49 54 45 5f 4f 4b 20 26 26 20 62 45 78 69 QLITE_OK && bExi
31e70 73 74 73 20 29 7b 0a 20 20 20 20 20 20 20 20 20 sts ){.
31e80 20 69 6e 74 20 66 6f 75 74 20 3d 20 30 3b 0a 20 int fout = 0;.
31e90 20 20 20 20 20 20 20 20 20 69 6e 74 20 66 20 3d int f =
31ea0 20 53 51 4c 49 54 45 5f 4f 50 45 4e 5f 52 45 41 SQLITE_OPEN_REA
31eb0 44 57 52 49 54 45 7c 53 51 4c 49 54 45 5f 4f 50 DWRITE|SQLITE_OP
31ec0 45 4e 5f 4d 41 49 4e 5f 4a 4f 55 52 4e 41 4c 3b EN_MAIN_JOURNAL;
31ed0 0a 20 20 20 20 20 20 20 20 20 20 61 73 73 65 72 . asser
31ee0 74 28 20 21 70 50 61 67 65 72 2d 3e 74 65 6d 70 t( !pPager->temp
31ef0 46 69 6c 65 20 29 3b 0a 20 20 20 20 20 20 20 20 File );.
31f00 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33 4f 73 rc = sqlite3Os
31f10 4f 70 65 6e 28 70 56 66 73 2c 20 70 50 61 67 65 Open(pVfs, pPage
31f20 72 2d 3e 7a 4a 6f 75 72 6e 61 6c 2c 20 70 50 61 r->zJournal, pPa
31f30 67 65 72 2d 3e 6a 66 64 2c 20 66 2c 20 26 66 6f ger->jfd, f, &fo
31f40 75 74 29 3b 0a 20 20 20 20 20 20 20 20 20 20 61 ut);. a
31f50 73 73 65 72 74 28 20 72 63 21 3d 53 51 4c 49 54 ssert( rc!=SQLIT
31f60 45 5f 4f 4b 20 7c 7c 20 69 73 4f 70 65 6e 28 70 E_OK || isOpen(p
31f70 50 61 67 65 72 2d 3e 6a 66 64 29 20 29 3b 0a 20 Pager->jfd) );.
31f80 20 20 20 20 20 20 20 20 20 69 66 28 20 72 63 3d if( rc=
31f90 3d 53 51 4c 49 54 45 5f 4f 4b 20 26 26 20 66 6f =SQLITE_OK && fo
31fa0 75 74 26 53 51 4c 49 54 45 5f 4f 50 45 4e 5f 52 ut&SQLITE_OPEN_R
31fb0 45 41 44 4f 4e 4c 59 20 29 7b 0a 20 20 20 20 20 EADONLY ){.
31fc0 20 20 20 20 20 20 20 72 63 20 3d 20 53 51 4c 49 rc = SQLI
31fd0 54 45 5f 43 41 4e 54 4f 50 45 4e 5f 42 4b 50 54 TE_CANTOPEN_BKPT
31fe0 3b 0a 20 20 20 20 20 20 20 20 20 20 20 20 73 71 ;. sq
31ff0 6c 69 74 65 33 4f 73 43 6c 6f 73 65 28 70 50 61 lite3OsClose(pPa
32000 67 65 72 2d 3e 6a 66 64 29 3b 0a 20 20 20 20 20 ger->jfd);.
32010 20 20 20 20 20 7d 0a 20 20 20 20 20 20 20 20 7d }. }
32020 0a 20 20 20 20 20 20 7d 0a 20 0a 20 20 20 20 20 . }. .
32030 20 2f 2a 20 50 6c 61 79 62 61 63 6b 20 61 6e 64 /* Playback and
32040 20 64 65 6c 65 74 65 20 74 68 65 20 6a 6f 75 72 delete the jour
32050 6e 61 6c 2e 20 20 44 72 6f 70 20 74 68 65 20 64 nal. Drop the d
32060 61 74 61 62 61 73 65 20 77 72 69 74 65 0a 20 20 atabase write.
32070 20 20 20 20 2a 2a 20 6c 6f 63 6b 20 61 6e 64 20 ** lock and
32080 72 65 61 63 71 75 69 72 65 20 74 68 65 20 72 65 reacquire the re
32090 61 64 20 6c 6f 63 6b 2e 20 50 75 72 67 65 20 74 ad lock. Purge t
320a0 68 65 20 63 61 63 68 65 20 62 65 66 6f 72 65 0a he cache before.
320b0 20 20 20 20 20 20 2a 2a 20 70 6c 61 79 69 6e 67 ** playing
320c0 20 62 61 63 6b 20 74 68 65 20 68 6f 74 2d 6a 6f back the hot-jo
320d0 75 72 6e 61 6c 20 73 6f 20 74 68 61 74 20 77 65 urnal so that we
320e0 20 64 6f 6e 27 74 20 65 6e 64 20 75 70 20 77 69 don't end up wi
320f0 74 68 0a 20 20 20 20 20 20 2a 2a 20 61 6e 20 69 th. ** an i
32100 6e 63 6f 6e 73 69 73 74 65 6e 74 20 63 61 63 68 nconsistent cach
32110 65 2e 20 20 53 79 6e 63 20 74 68 65 20 68 6f 74 e. Sync the hot
32120 20 6a 6f 75 72 6e 61 6c 20 62 65 66 6f 72 65 20 journal before
32130 70 6c 61 79 69 6e 67 0a 20 20 20 20 20 20 2a 2a playing. **
32140 20 69 74 20 62 61 63 6b 20 73 69 6e 63 65 20 74 it back since t
32150 68 65 20 70 72 6f 63 65 73 73 20 74 68 61 74 20 he process that
32160 63 72 61 73 68 65 64 20 61 6e 64 20 6c 65 66 74 crashed and left
32170 20 74 68 65 20 68 6f 74 20 6a 6f 75 72 6e 61 6c the hot journal
32180 0a 20 20 20 20 20 20 2a 2a 20 70 72 6f 62 61 62 . ** probab
32190 6c 79 20 64 69 64 20 6e 6f 74 20 73 79 6e 63 20 ly did not sync
321a0 69 74 20 61 6e 64 20 77 65 20 61 72 65 20 72 65 it and we are re
321b0 71 75 69 72 65 64 20 74 6f 20 61 6c 77 61 79 73 quired to always
321c0 20 73 79 6e 63 0a 20 20 20 20 20 20 2a 2a 20 74 sync. ** t
321d0 68 65 20 6a 6f 75 72 6e 61 6c 20 62 65 66 6f 72 he journal befor
321e0 65 20 70 6c 61 79 69 6e 67 20 69 74 20 62 61 63 e playing it bac
321f0 6b 2e 0a 20 20 20 20 20 20 2a 2f 0a 20 20 20 20 k.. */.
32200 20 20 69 66 28 20 69 73 4f 70 65 6e 28 70 50 61 if( isOpen(pPa
32210 67 65 72 2d 3e 6a 66 64 29 20 29 7b 0a 20 20 20 ger->jfd) ){.
32220 20 20 20 20 20 61 73 73 65 72 74 28 20 72 63 3d assert( rc=
32230 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 3b 0a 20 20 =SQLITE_OK );.
32240 20 20 20 20 20 20 72 63 20 3d 20 70 61 67 65 72 rc = pager
32250 53 79 6e 63 48 6f 74 4a 6f 75 72 6e 61 6c 28 70 SyncHotJournal(p
32260 50 61 67 65 72 29 3b 0a 20 20 20 20 20 20 20 20 Pager);.
32270 69 66 28 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4f if( rc==SQLITE_O
32280 4b 20 29 7b 0a 20 20 20 20 20 20 20 20 20 20 72 K ){. r
32290 63 20 3d 20 70 61 67 65 72 5f 70 6c 61 79 62 61 c = pager_playba
322a0 63 6b 28 70 50 61 67 65 72 2c 20 31 29 3b 0a 20 ck(pPager, 1);.
322b0 20 20 20 20 20 20 20 20 20 70 50 61 67 65 72 2d pPager-
322c0 3e 65 53 74 61 74 65 20 3d 20 50 41 47 45 52 5f >eState = PAGER_
322d0 4f 50 45 4e 3b 0a 20 20 20 20 20 20 20 20 7d 0a OPEN;. }.
322e0 20 20 20 20 20 20 7d 65 6c 73 65 20 69 66 28 20 }else if(
322f0 21 70 50 61 67 65 72 2d 3e 65 78 63 6c 75 73 69 !pPager->exclusi
32300 76 65 4d 6f 64 65 20 29 7b 0a 20 20 20 20 20 20 veMode ){.
32310 20 20 70 61 67 65 72 55 6e 6c 6f 63 6b 44 62 28 pagerUnlockDb(
32320 70 50 61 67 65 72 2c 20 53 48 41 52 45 44 5f 4c pPager, SHARED_L
32330 4f 43 4b 29 3b 0a 20 20 20 20 20 20 7d 0a 0a 20 OCK);. }..
32340 20 20 20 20 20 69 66 28 20 72 63 21 3d 53 51 4c if( rc!=SQL
32350 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 20 20 ITE_OK ){.
32360 20 20 2f 2a 20 54 68 69 73 20 62 72 61 6e 63 68 /* This branch
32370 20 69 73 20 74 61 6b 65 6e 20 69 66 20 61 6e 20 is taken if an
32380 65 72 72 6f 72 20 6f 63 63 75 72 73 20 77 68 69 error occurs whi
32390 6c 65 20 74 72 79 69 6e 67 20 74 6f 20 6f 70 65 le trying to ope
323a0 6e 0a 20 20 20 20 20 20 20 20 2a 2a 20 6f 72 20 n. ** or
323b0 72 6f 6c 6c 20 62 61 63 6b 20 61 20 68 6f 74 2d roll back a hot-
323c0 6a 6f 75 72 6e 61 6c 20 77 68 69 6c 65 20 68 6f journal while ho
323d0 6c 64 69 6e 67 20 61 6e 20 45 58 43 4c 55 53 49 lding an EXCLUSI
323e0 56 45 20 6c 6f 63 6b 2e 20 54 68 65 0a 20 20 20 VE lock. The.
323f0 20 20 20 20 20 2a 2a 20 70 61 67 65 72 5f 75 6e ** pager_un
32400 6c 6f 63 6b 28 29 20 72 6f 75 74 69 6e 65 20 77 lock() routine w
32410 69 6c 6c 20 62 65 20 63 61 6c 6c 65 64 20 62 65 ill be called be
32420 66 6f 72 65 20 72 65 74 75 72 6e 69 6e 67 20 74 fore returning t
32430 6f 20 75 6e 6c 6f 63 6b 0a 20 20 20 20 20 20 20 o unlock.
32440 20 2a 2a 20 74 68 65 20 66 69 6c 65 2e 20 49 66 ** the file. If
32450 20 74 68 65 20 75 6e 6c 6f 63 6b 20 61 74 74 65 the unlock atte
32460 6d 70 74 20 66 61 69 6c 73 2c 20 74 68 65 6e 20 mpt fails, then
32470 50 61 67 65 72 2e 65 4c 6f 63 6b 20 6d 75 73 74 Pager.eLock must
32480 20 62 65 0a 20 20 20 20 20 20 20 20 2a 2a 20 73 be. ** s
32490 65 74 20 74 6f 20 55 4e 4b 4e 4f 57 4e 5f 4c 4f et to UNKNOWN_LO
324a0 43 4b 20 28 73 65 65 20 74 68 65 20 63 6f 6d 6d CK (see the comm
324b0 65 6e 74 20 61 62 6f 76 65 20 74 68 65 20 23 64 ent above the #d
324c0 65 66 69 6e 65 20 66 6f 72 20 0a 20 20 20 20 20 efine for .
324d0 20 20 20 2a 2a 20 55 4e 4b 4e 4f 57 4e 5f 4c 4f ** UNKNOWN_LO
324e0 43 4b 20 61 62 6f 76 65 20 66 6f 72 20 61 6e 20 CK above for an
324f0 65 78 70 6c 61 6e 61 74 69 6f 6e 29 2e 20 0a 20 explanation). .
32500 20 20 20 20 20 20 20 2a 2a 0a 20 20 20 20 20 20 **.
32510 20 20 2a 2a 20 49 6e 20 6f 72 64 65 72 20 74 6f ** In order to
32520 20 67 65 74 20 70 61 67 65 72 5f 75 6e 6c 6f 63 get pager_unloc
32530 6b 28 29 20 74 6f 20 64 6f 20 74 68 69 73 2c 20 k() to do this,
32540 73 65 74 20 50 61 67 65 72 2e 65 53 74 61 74 65 set Pager.eState
32550 20 74 6f 0a 20 20 20 20 20 20 20 20 2a 2a 20 50 to. ** P
32560 41 47 45 52 5f 45 52 52 4f 52 20 6e 6f 77 2e 20 AGER_ERROR now.
32570 54 68 69 73 20 69 73 20 6e 6f 74 20 61 63 74 75 This is not actu
32580 61 6c 6c 79 20 63 6f 75 6e 74 65 64 20 61 73 20 ally counted as
32590 61 20 74 72 61 6e 73 69 74 69 6f 6e 0a 20 20 20 a transition.
325a0 20 20 20 20 20 2a 2a 20 74 6f 20 45 52 52 4f 52 ** to ERROR
325b0 20 73 74 61 74 65 20 69 6e 20 74 68 65 20 73 74 state in the st
325c0 61 74 65 20 64 69 61 67 72 61 6d 20 61 74 20 74 ate diagram at t
325d0 68 65 20 74 6f 70 20 6f 66 20 74 68 69 73 20 66 he top of this f
325e0 69 6c 65 2c 0a 20 20 20 20 20 20 20 20 2a 2a 20 ile,. **
325f0 73 69 6e 63 65 20 77 65 20 6b 6e 6f 77 20 74 68 since we know th
32600 61 74 20 74 68 65 20 73 61 6d 65 20 63 61 6c 6c at the same call
32610 20 74 6f 20 70 61 67 65 72 5f 75 6e 6c 6f 63 6b to pager_unlock
32620 28 29 20 77 69 6c 6c 20 76 65 72 79 0a 20 20 20 () will very.
32630 20 20 20 20 20 2a 2a 20 73 68 6f 72 74 6c 79 20 ** shortly
32640 74 72 61 6e 73 69 74 69 6f 6e 20 74 68 65 20 70 transition the p
32650 61 67 65 72 20 6f 62 6a 65 63 74 20 74 6f 20 74 ager object to t
32660 68 65 20 4f 50 45 4e 20 73 74 61 74 65 2e 20 43 he OPEN state. C
32670 61 6c 6c 69 6e 67 0a 20 20 20 20 20 20 20 20 2a alling. *
32680 2a 20 61 73 73 65 72 74 5f 70 61 67 65 72 5f 73 * assert_pager_s
32690 74 61 74 65 28 29 20 77 6f 75 6c 64 20 66 61 69 tate() would fai
326a0 6c 20 6e 6f 77 2c 20 61 73 20 69 74 20 73 68 6f l now, as it sho
326b0 75 6c 64 20 6e 6f 74 20 62 65 20 70 6f 73 73 69 uld not be possi
326c0 62 6c 65 0a 20 20 20 20 20 20 20 20 2a 2a 20 74 ble. ** t
326d0 6f 20 62 65 20 69 6e 20 45 52 52 4f 52 20 73 74 o be in ERROR st
326e0 61 74 65 20 77 68 65 6e 20 74 68 65 72 65 20 61 ate when there a
326f0 72 65 20 7a 65 72 6f 20 6f 75 74 73 74 61 6e 64 re zero outstand
32700 69 6e 67 20 70 61 67 65 20 0a 20 20 20 20 20 20 ing page .
32710 20 20 2a 2a 20 72 65 66 65 72 65 6e 63 65 73 2e ** references.
32720 0a 20 20 20 20 20 20 20 20 2a 2f 0a 20 20 20 20 . */.
32730 20 20 20 20 70 61 67 65 72 5f 65 72 72 6f 72 28 pager_error(
32740 70 50 61 67 65 72 2c 20 72 63 29 3b 0a 20 20 20 pPager, rc);.
32750 20 20 20 20 20 67 6f 74 6f 20 66 61 69 6c 65 64 goto failed
32760 3b 0a 20 20 20 20 20 20 7d 0a 0a 20 20 20 20 20 ;. }..
32770 20 61 73 73 65 72 74 28 20 70 50 61 67 65 72 2d assert( pPager-
32780 3e 65 53 74 61 74 65 3d 3d 50 41 47 45 52 5f 4f >eState==PAGER_O
32790 50 45 4e 20 29 3b 0a 20 20 20 20 20 20 61 73 73 PEN );. ass
327a0 65 72 74 28 20 28 70 50 61 67 65 72 2d 3e 65 4c ert( (pPager->eL
327b0 6f 63 6b 3d 3d 53 48 41 52 45 44 5f 4c 4f 43 4b ock==SHARED_LOCK
327c0 29 0a 20 20 20 20 20 20 20 20 20 20 20 7c 7c 20 ). ||
327d0 28 70 50 61 67 65 72 2d 3e 65 78 63 6c 75 73 69 (pPager->exclusi
327e0 76 65 4d 6f 64 65 20 26 26 20 70 50 61 67 65 72 veMode && pPager
327f0 2d 3e 65 4c 6f 63 6b 3e 53 48 41 52 45 44 5f 4c ->eLock>SHARED_L
32800 4f 43 4b 29 0a 20 20 20 20 20 20 29 3b 0a 20 20 OCK). );.
32810 20 20 7d 0a 0a 20 20 20 20 69 66 28 20 21 70 50 }.. if( !pP
32820 61 67 65 72 2d 3e 74 65 6d 70 46 69 6c 65 20 26 ager->tempFile &
32830 26 20 70 50 61 67 65 72 2d 3e 68 61 73 48 65 6c & pPager->hasHel
32840 64 53 68 61 72 65 64 4c 6f 63 6b 20 29 7b 0a 20 dSharedLock ){.
32850 20 20 20 20 20 2f 2a 20 54 68 65 20 73 68 61 72 /* The shar
32860 65 64 2d 6c 6f 63 6b 20 68 61 73 20 6a 75 73 74 ed-lock has just
32870 20 62 65 65 6e 20 61 63 71 75 69 72 65 64 20 74 been acquired t
32880 68 65 6e 20 63 68 65 63 6b 20 74 6f 0a 20 20 20 hen check to.
32890 20 20 20 2a 2a 20 73 65 65 20 69 66 20 74 68 65 ** see if the
328a0 20 64 61 74 61 62 61 73 65 20 68 61 73 20 62 65 database has be
328b0 65 6e 20 6d 6f 64 69 66 69 65 64 2e 20 20 49 66 en modified. If
328c0 20 74 68 65 20 64 61 74 61 62 61 73 65 20 68 61 the database ha
328d0 73 20 63 68 61 6e 67 65 64 2c 0a 20 20 20 20 20 s changed,.
328e0 20 2a 2a 20 66 6c 75 73 68 20 74 68 65 20 63 61 ** flush the ca
328f0 63 68 65 2e 20 20 54 68 65 20 68 61 73 48 65 6c che. The hasHel
32900 64 53 68 61 72 65 64 4c 6f 63 6b 20 66 6c 61 67 dSharedLock flag
32910 20 70 72 65 76 65 6e 74 73 20 74 68 69 73 20 66 prevents this f
32920 72 6f 6d 0a 20 20 20 20 20 20 2a 2a 20 6f 63 63 rom. ** occ
32930 75 72 72 69 6e 67 20 6f 6e 20 74 68 65 20 76 65 urring on the ve
32940 72 79 20 66 69 72 73 74 20 61 63 63 65 73 73 20 ry first access
32950 74 6f 20 61 20 66 69 6c 65 2c 20 69 6e 20 6f 72 to a file, in or
32960 64 65 72 20 74 6f 20 73 61 76 65 20 61 0a 20 20 der to save a.
32970 20 20 20 20 2a 2a 20 73 69 6e 67 6c 65 20 75 6e ** single un
32980 6e 65 63 65 73 73 61 72 79 20 73 71 6c 69 74 65 necessary sqlite
32990 33 4f 73 52 65 61 64 28 29 20 63 61 6c 6c 20 61 3OsRead() call a
329a0 74 20 74 68 65 20 73 74 61 72 74 2d 75 70 2e 0a t the start-up..
329b0 20 20 20 20 20 20 2a 2a 0a 20 20 20 20 20 20 2a **. *
329c0 2a 20 44 61 74 61 62 61 73 65 20 63 68 61 6e 67 * Database chang
329d0 65 73 20 61 72 65 20 64 65 74 65 63 74 65 64 20 es are detected
329e0 62 79 20 6c 6f 6f 6b 69 6e 67 20 61 74 20 31 35 by looking at 15
329f0 20 62 79 74 65 73 20 62 65 67 69 6e 6e 69 6e 67 bytes beginning
32a00 0a 20 20 20 20 20 20 2a 2a 20 61 74 20 6f 66 66 . ** at off
32a10 73 65 74 20 32 34 20 69 6e 74 6f 20 74 68 65 20 set 24 into the
32a20 66 69 6c 65 2e 20 20 54 68 65 20 66 69 72 73 74 file. The first
32a30 20 34 20 6f 66 20 74 68 65 73 65 20 31 36 20 62 4 of these 16 b
32a40 79 74 65 73 20 61 72 65 0a 20 20 20 20 20 20 2a ytes are. *
32a50 2a 20 61 20 33 32 2d 62 69 74 20 63 6f 75 6e 74 * a 32-bit count
32a60 65 72 20 74 68 61 74 20 69 73 20 69 6e 63 72 65 er that is incre
32a70 6d 65 6e 74 65 64 20 77 69 74 68 20 65 61 63 68 mented with each
32a80 20 63 68 61 6e 67 65 2e 20 20 54 68 65 0a 20 20 change. The.
32a90 20 20 20 20 2a 2a 20 6f 74 68 65 72 20 62 79 74 ** other byt
32aa0 65 73 20 63 68 61 6e 67 65 20 72 61 6e 64 6f 6d es change random
32ab0 6c 79 20 77 69 74 68 20 65 61 63 68 20 66 69 6c ly with each fil
32ac0 65 20 63 68 61 6e 67 65 20 77 68 65 6e 0a 20 20 e change when.
32ad0 20 20 20 20 2a 2a 20 61 20 63 6f 64 65 63 20 69 ** a codec i
32ae0 73 20 69 6e 20 75 73 65 2e 0a 20 20 20 20 20 20 s in use..
32af0 2a 2a 20 0a 20 20 20 20 20 20 2a 2a 20 54 68 65 ** . ** The
32b00 72 65 20 69 73 20 61 20 76 61 6e 69 73 68 69 6e re is a vanishin
32b10 67 6c 79 20 73 6d 61 6c 6c 20 63 68 61 6e 63 65 gly small chance
32b20 20 74 68 61 74 20 61 20 63 68 61 6e 67 65 20 77 that a change w
32b30 69 6c 6c 20 6e 6f 74 20 62 65 20 0a 20 20 20 20 ill not be .
32b40 20 20 2a 2a 20 64 65 74 65 63 74 65 64 2e 20 20 ** detected.
32b50 54 68 65 20 63 68 61 6e 63 65 20 6f 66 20 61 6e The chance of an
32b60 20 75 6e 64 65 74 65 63 74 65 64 20 63 68 61 6e undetected chan
32b70 67 65 20 69 73 20 73 6f 20 73 6d 61 6c 6c 20 74 ge is so small t
32b80 68 61 74 0a 20 20 20 20 20 20 2a 2a 20 69 74 20 hat. ** it
32b90 63 61 6e 20 62 65 20 6e 65 67 6c 65 63 74 65 64 can be neglected
32ba0 2e 0a 20 20 20 20 20 20 2a 2f 0a 20 20 20 20 20 .. */.
32bb0 20 50 67 6e 6f 20 6e 50 61 67 65 20 3d 20 30 3b Pgno nPage = 0;
32bc0 0a 20 20 20 20 20 20 63 68 61 72 20 64 62 46 69 . char dbFi
32bd0 6c 65 56 65 72 73 5b 73 69 7a 65 6f 66 28 70 50 leVers[sizeof(pP
32be0 61 67 65 72 2d 3e 64 62 46 69 6c 65 56 65 72 73 ager->dbFileVers
32bf0 29 5d 3b 0a 0a 20 20 20 20 20 20 72 63 20 3d 20 )];.. rc =
32c00 70 61 67 65 72 50 61 67 65 63 6f 75 6e 74 28 70 pagerPagecount(p
32c10 50 61 67 65 72 2c 20 26 6e 50 61 67 65 29 3b 0a Pager, &nPage);.
32c20 20 20 20 20 20 20 69 66 28 20 72 63 20 29 20 67 if( rc ) g
32c30 6f 74 6f 20 66 61 69 6c 65 64 3b 0a 0a 20 20 20 oto failed;..
32c40 20 20 20 69 66 28 20 6e 50 61 67 65 3e 30 20 29 if( nPage>0 )
32c50 7b 0a 20 20 20 20 20 20 20 20 49 4f 54 52 41 43 {. IOTRAC
32c60 45 28 28 22 43 4b 56 45 52 53 20 25 70 20 25 64 E(("CKVERS %p %d
32c70 5c 6e 22 2c 20 70 50 61 67 65 72 2c 20 73 69 7a \n", pPager, siz
32c80 65 6f 66 28 64 62 46 69 6c 65 56 65 72 73 29 29 eof(dbFileVers))
32c90 29 3b 0a 20 20 20 20 20 20 20 20 72 63 20 3d 20 );. rc =
32ca0 73 71 6c 69 74 65 33 4f 73 52 65 61 64 28 70 50 sqlite3OsRead(pP
32cb0 61 67 65 72 2d 3e 66 64 2c 20 26 64 62 46 69 6c ager->fd, &dbFil
32cc0 65 56 65 72 73 2c 20 73 69 7a 65 6f 66 28 64 62 eVers, sizeof(db
32cd0 46 69 6c 65 56 65 72 73 29 2c 20 32 34 29 3b 0a FileVers), 24);.
32ce0 20 20 20 20 20 20 20 20 69 66 28 20 72 63 21 3d if( rc!=
32cf0 53 51 4c 49 54 45 5f 4f 4b 20 26 26 20 72 63 21 SQLITE_OK && rc!
32d00 3d 53 51 4c 49 54 45 5f 49 4f 45 52 52 5f 53 48 =SQLITE_IOERR_SH
32d10 4f 52 54 5f 52 45 41 44 20 29 7b 0a 20 20 20 20 ORT_READ ){.
32d20 20 20 20 20 20 20 67 6f 74 6f 20 66 61 69 6c 65 goto faile
32d30 64 3b 0a 20 20 20 20 20 20 20 20 7d 0a 20 20 20 d;. }.
32d40 20 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 20 20 }else{.
32d50 20 20 6d 65 6d 73 65 74 28 64 62 46 69 6c 65 56 memset(dbFileV
32d60 65 72 73 2c 20 30 2c 20 73 69 7a 65 6f 66 28 64 ers, 0, sizeof(d
32d70 62 46 69 6c 65 56 65 72 73 29 29 3b 0a 20 20 20 bFileVers));.
32d80 20 20 20 7d 0a 0a 20 20 20 20 20 20 69 66 28 20 }.. if(
32d90 6d 65 6d 63 6d 70 28 70 50 61 67 65 72 2d 3e 64 memcmp(pPager->d
32da0 62 46 69 6c 65 56 65 72 73 2c 20 64 62 46 69 6c bFileVers, dbFil
32db0 65 56 65 72 73 2c 20 73 69 7a 65 6f 66 28 64 62 eVers, sizeof(db
32dc0 46 69 6c 65 56 65 72 73 29 29 21 3d 30 20 29 7b FileVers))!=0 ){
32dd0 0a 20 20 20 20 20 20 20 20 70 61 67 65 72 5f 72 . pager_r
32de0 65 73 65 74 28 70 50 61 67 65 72 29 3b 0a 0a 20 eset(pPager);..
32df0 20 20 20 20 20 20 20 2f 2a 20 55 6e 6d 61 70 20 /* Unmap
32e00 74 68 65 20 64 61 74 61 62 61 73 65 20 66 69 6c the database fil
32e10 65 2e 20 49 74 20 69 73 20 70 6f 73 73 69 62 6c e. It is possibl
32e20 65 20 74 68 61 74 20 65 78 74 65 72 6e 61 6c 20 e that external
32e30 70 72 6f 63 65 73 73 65 73 0a 20 20 20 20 20 20 processes.
32e40 20 20 2a 2a 20 6d 61 79 20 68 61 76 65 20 74 72 ** may have tr
32e50 75 6e 63 61 74 65 64 20 74 68 65 20 64 61 74 61 uncated the data
32e60 62 61 73 65 20 66 69 6c 65 20 61 6e 64 20 74 68 base file and th
32e70 65 6e 20 65 78 74 65 6e 64 65 64 20 69 74 20 62 en extended it b
32e80 61 63 6b 0a 20 20 20 20 20 20 20 20 2a 2a 20 74 ack. ** t
32e90 6f 20 69 74 73 20 6f 72 69 67 69 6e 61 6c 20 73 o its original s
32ea0 69 7a 65 20 77 68 69 6c 65 20 74 68 69 73 20 70 ize while this p
32eb0 72 6f 63 65 73 73 20 77 61 73 20 6e 6f 74 20 68 rocess was not h
32ec0 6f 6c 64 69 6e 67 20 61 20 6c 6f 63 6b 2e 0a 20 olding a lock..
32ed0 20 20 20 20 20 20 20 2a 2a 20 49 6e 20 74 68 69 ** In thi
32ee0 73 20 63 61 73 65 20 74 68 65 72 65 20 6d 61 79 s case there may
32ef0 20 65 78 69 73 74 20 61 20 50 61 67 65 72 2e 70 exist a Pager.p
32f00 4d 61 70 20 6d 61 70 70 69 6e 67 20 74 68 61 74 Map mapping that
32f10 20 61 70 70 65 61 72 73 0a 20 20 20 20 20 20 20 appears.
32f20 20 2a 2a 20 74 6f 20 62 65 20 74 68 65 20 72 69 ** to be the ri
32f30 67 68 74 20 73 69 7a 65 20 62 75 74 20 69 73 20 ght size but is
32f40 6e 6f 74 20 61 63 74 75 61 6c 6c 79 20 76 61 6c not actually val
32f50 69 64 2e 20 41 76 6f 69 64 20 74 68 69 73 0a 20 id. Avoid this.
32f60 20 20 20 20 20 20 20 2a 2a 20 70 6f 73 73 69 62 ** possib
32f70 69 6c 69 74 79 20 62 79 20 75 6e 6d 61 70 70 69 ility by unmappi
32f80 6e 67 20 74 68 65 20 64 62 20 68 65 72 65 2e 20 ng the db here.
32f90 2a 2f 0a 20 20 20 20 20 20 20 20 69 66 28 20 55 */. if( U
32fa0 53 45 46 45 54 43 48 28 70 50 61 67 65 72 29 20 SEFETCH(pPager)
32fb0 29 7b 0a 20 20 20 20 20 20 20 20 20 20 73 71 6c ){. sql
32fc0 69 74 65 33 4f 73 55 6e 66 65 74 63 68 28 70 50 ite3OsUnfetch(pP
32fd0 61 67 65 72 2d 3e 66 64 2c 20 30 2c 20 30 29 3b ager->fd, 0, 0);
32fe0 0a 20 20 20 20 20 20 20 20 7d 0a 20 20 20 20 20 . }.
32ff0 20 7d 0a 20 20 20 20 7d 0a 0a 20 20 20 20 2f 2a }. }.. /*
33000 20 49 66 20 74 68 65 72 65 20 69 73 20 61 20 57 If there is a W
33010 41 4c 20 66 69 6c 65 20 69 6e 20 74 68 65 20 66 AL file in the f
33020 69 6c 65 2d 73 79 73 74 65 6d 2c 20 6f 70 65 6e ile-system, open
33030 20 74 68 69 73 20 64 61 74 61 62 61 73 65 20 69 this database i
33040 6e 20 57 41 4c 0a 20 20 20 20 2a 2a 20 6d 6f 64 n WAL. ** mod
33050 65 2e 20 4f 74 68 65 72 77 69 73 65 2c 20 74 68 e. Otherwise, th
33060 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 66 75 6e 63 e following func
33070 74 69 6f 6e 20 63 61 6c 6c 20 69 73 20 61 20 6e tion call is a n
33080 6f 2d 6f 70 2e 0a 20 20 20 20 2a 2f 0a 20 20 20 o-op.. */.
33090 20 72 63 20 3d 20 70 61 67 65 72 4f 70 65 6e 57 rc = pagerOpenW
330a0 61 6c 49 66 50 72 65 73 65 6e 74 28 70 50 61 67 alIfPresent(pPag
330b0 65 72 29 3b 0a 23 69 66 6e 64 65 66 20 53 51 4c er);.#ifndef SQL
330c0 49 54 45 5f 4f 4d 49 54 5f 57 41 4c 0a 20 20 20 ITE_OMIT_WAL.
330d0 20 61 73 73 65 72 74 28 20 70 50 61 67 65 72 2d assert( pPager-
330e0 3e 70 57 61 6c 3d 3d 30 20 7c 7c 20 72 63 3d 3d >pWal==0 || rc==
330f0 53 51 4c 49 54 45 5f 4f 4b 20 29 3b 0a 23 65 6e SQLITE_OK );.#en
33100 64 69 66 0a 20 20 7d 0a 0a 20 20 69 66 28 20 70 dif. }.. if( p
33110 61 67 65 72 55 73 65 57 61 6c 28 70 50 61 67 65 agerUseWal(pPage
33120 72 29 20 29 7b 0a 20 20 20 20 61 73 73 65 72 74 r) ){. assert
33130 28 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 ( rc==SQLITE_OK
33140 29 3b 0a 20 20 20 20 72 63 20 3d 20 70 61 67 65 );. rc = page
33150 72 42 65 67 69 6e 52 65 61 64 54 72 61 6e 73 61 rBeginReadTransa
33160 63 74 69 6f 6e 28 70 50 61 67 65 72 29 3b 0a 20 ction(pPager);.
33170 20 7d 0a 0a 20 20 69 66 28 20 70 50 61 67 65 72 }.. if( pPager
33180 2d 3e 65 53 74 61 74 65 3d 3d 50 41 47 45 52 5f ->eState==PAGER_
33190 4f 50 45 4e 20 26 26 20 72 63 3d 3d 53 51 4c 49 OPEN && rc==SQLI
331a0 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 72 63 20 TE_OK ){. rc
331b0 3d 20 70 61 67 65 72 50 61 67 65 63 6f 75 6e 74 = pagerPagecount
331c0 28 70 50 61 67 65 72 2c 20 26 70 50 61 67 65 72 (pPager, &pPager
331d0 2d 3e 64 62 53 69 7a 65 29 3b 0a 20 20 7d 0a 0a ->dbSize);. }..
331e0 20 66 61 69 6c 65 64 3a 0a 20 20 69 66 28 20 72 failed:. if( r
331f0 63 21 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a c!=SQLITE_OK ){.
33200 20 20 20 20 61 73 73 65 72 74 28 20 21 4d 45 4d assert( !MEM
33210 44 42 20 29 3b 0a 20 20 20 20 70 61 67 65 72 5f DB );. pager_
33220 75 6e 6c 6f 63 6b 28 70 50 61 67 65 72 29 3b 0a unlock(pPager);.
33230 20 20 20 20 61 73 73 65 72 74 28 20 70 50 61 67 assert( pPag
33240 65 72 2d 3e 65 53 74 61 74 65 3d 3d 50 41 47 45 er->eState==PAGE
33250 52 5f 4f 50 45 4e 20 29 3b 0a 20 20 7d 65 6c 73 R_OPEN );. }els
33260 65 7b 0a 20 20 20 20 70 50 61 67 65 72 2d 3e 65 e{. pPager->e
33270 53 74 61 74 65 20 3d 20 50 41 47 45 52 5f 52 45 State = PAGER_RE
33280 41 44 45 52 3b 0a 20 20 20 20 70 50 61 67 65 72 ADER;. pPager
33290 2d 3e 68 61 73 48 65 6c 64 53 68 61 72 65 64 4c ->hasHeldSharedL
332a0 6f 63 6b 20 3d 20 31 3b 0a 20 20 7d 0a 20 20 72 ock = 1;. }. r
332b0 65 74 75 72 6e 20 72 63 3b 0a 7d 0a 0a 2f 2a 0a eturn rc;.}../*.
332c0 2a 2a 20 49 66 20 74 68 65 20 72 65 66 65 72 65 ** If the refere
332d0 6e 63 65 20 63 6f 75 6e 74 20 68 61 73 20 72 65 nce count has re
332e0 61 63 68 65 64 20 7a 65 72 6f 2c 20 72 6f 6c 6c ached zero, roll
332f0 62 61 63 6b 20 61 6e 79 20 61 63 74 69 76 65 0a back any active.
33300 2a 2a 20 74 72 61 6e 73 61 63 74 69 6f 6e 20 61 ** transaction a
33310 6e 64 20 75 6e 6c 6f 63 6b 20 74 68 65 20 70 61 nd unlock the pa
33320 67 65 72 2e 0a 2a 2a 0a 2a 2a 20 45 78 63 65 70 ger..**.** Excep
33330 74 2c 20 69 6e 20 6c 6f 63 6b 69 6e 67 5f 6d 6f t, in locking_mo
33340 64 65 3d 45 58 43 4c 55 53 49 56 45 20 77 68 65 de=EXCLUSIVE whe
33350 6e 20 74 68 65 72 65 20 69 73 20 6e 6f 74 68 69 n there is nothi
33360 6e 67 20 74 6f 20 69 6e 0a 2a 2a 20 74 68 65 20 ng to in.** the
33370 72 6f 6c 6c 62 61 63 6b 20 6a 6f 75 72 6e 61 6c rollback journal
33380 2c 20 74 68 65 20 75 6e 6c 6f 63 6b 20 69 73 20 , the unlock is
33390 6e 6f 74 20 70 65 72 66 6f 72 6d 65 64 20 61 6e not performed an
333a0 64 20 74 68 65 72 65 20 69 73 0a 2a 2a 20 6e 6f d there is.** no
333b0 74 68 69 6e 67 20 74 6f 20 72 6f 6c 6c 62 61 63 thing to rollbac
333c0 6b 2c 20 73 6f 20 74 68 69 73 20 72 6f 75 74 69 k, so this routi
333d0 6e 65 20 69 73 20 61 20 6e 6f 2d 6f 70 2e 0a 2a ne is a no-op..*
333e0 2f 20 0a 73 74 61 74 69 63 20 76 6f 69 64 20 70 / .static void p
333f0 61 67 65 72 55 6e 6c 6f 63 6b 49 66 55 6e 75 73 agerUnlockIfUnus
33400 65 64 28 50 61 67 65 72 20 2a 70 50 61 67 65 72 ed(Pager *pPager
33410 29 7b 0a 20 20 69 66 28 20 70 50 61 67 65 72 2d ){. if( pPager-
33420 3e 6e 4d 6d 61 70 4f 75 74 3d 3d 30 20 26 26 20 >nMmapOut==0 &&
33430 28 73 71 6c 69 74 65 33 50 63 61 63 68 65 52 65 (sqlite3PcacheRe
33440 66 43 6f 75 6e 74 28 70 50 61 67 65 72 2d 3e 70 fCount(pPager->p
33450 50 43 61 63 68 65 29 3d 3d 30 29 20 29 7b 0a 20 PCache)==0) ){.
33460 20 20 20 70 61 67 65 72 55 6e 6c 6f 63 6b 41 6e pagerUnlockAn
33470 64 52 6f 6c 6c 62 61 63 6b 28 70 50 61 67 65 72 dRollback(pPager
33480 29 3b 0a 20 20 7d 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 );. }.}../*.**
33490 41 63 71 75 69 72 65 20 61 20 72 65 66 65 72 65 Acquire a refere
334a0 6e 63 65 20 74 6f 20 70 61 67 65 20 6e 75 6d 62 nce to page numb
334b0 65 72 20 70 67 6e 6f 20 69 6e 20 70 61 67 65 72 er pgno in pager
334c0 20 70 50 61 67 65 72 20 28 61 20 70 61 67 65 0a pPager (a page.
334d0 2a 2a 20 72 65 66 65 72 65 6e 63 65 20 68 61 73 ** reference has
334e0 20 74 79 70 65 20 44 62 50 61 67 65 2a 29 2e 20 type DbPage*).
334f0 49 66 20 74 68 65 20 72 65 71 75 65 73 74 65 64 If the requested
33500 20 72 65 66 65 72 65 6e 63 65 20 69 73 20 0a 2a reference is .*
33510 2a 20 73 75 63 63 65 73 73 66 75 6c 6c 79 20 6f * successfully o
33520 62 74 61 69 6e 65 64 2c 20 69 74 20 69 73 20 63 btained, it is c
33530 6f 70 69 65 64 20 74 6f 20 2a 70 70 50 61 67 65 opied to *ppPage
33540 20 61 6e 64 20 53 51 4c 49 54 45 5f 4f 4b 20 72 and SQLITE_OK r
33550 65 74 75 72 6e 65 64 2e 0a 2a 2a 0a 2a 2a 20 49 eturned..**.** I
33560 66 20 74 68 65 20 72 65 71 75 65 73 74 65 64 20 f the requested
33570 70 61 67 65 20 69 73 20 61 6c 72 65 61 64 79 20 page is already
33580 69 6e 20 74 68 65 20 63 61 63 68 65 2c 20 69 74 in the cache, it
33590 20 69 73 20 72 65 74 75 72 6e 65 64 2e 20 0a 2a is returned. .*
335a0 2a 20 4f 74 68 65 72 77 69 73 65 2c 20 61 20 6e * Otherwise, a n
335b0 65 77 20 70 61 67 65 20 6f 62 6a 65 63 74 20 69 ew page object i
335c0 73 20 61 6c 6c 6f 63 61 74 65 64 20 61 6e 64 20 s allocated and
335d0 70 6f 70 75 6c 61 74 65 64 20 77 69 74 68 20 64 populated with d
335e0 61 74 61 0a 2a 2a 20 72 65 61 64 20 66 72 6f 6d ata.** read from
335f0 20 74 68 65 20 64 61 74 61 62 61 73 65 20 66 69 the database fi
33600 6c 65 2e 20 49 6e 20 73 6f 6d 65 20 63 61 73 65 le. In some case
33610 73 2c 20 74 68 65 20 70 63 61 63 68 65 20 6d 6f s, the pcache mo
33620 64 75 6c 65 20 6d 61 79 0a 2a 2a 20 63 68 6f 6f dule may.** choo
33630 73 65 20 6e 6f 74 20 74 6f 20 61 6c 6c 6f 63 61 se not to alloca
33640 74 65 20 61 20 6e 65 77 20 70 61 67 65 20 6f 62 te a new page ob
33650 6a 65 63 74 20 61 6e 64 20 6d 61 79 20 72 65 75 ject and may reu
33660 73 65 20 61 6e 20 65 78 69 73 74 69 6e 67 0a 2a se an existing.*
33670 2a 20 6f 62 6a 65 63 74 20 77 69 74 68 20 6e 6f * object with no
33680 20 6f 75 74 73 74 61 6e 64 69 6e 67 20 72 65 66 outstanding ref
33690 65 72 65 6e 63 65 73 2e 0a 2a 2a 0a 2a 2a 20 54 erences..**.** T
336a0 68 65 20 65 78 74 72 61 20 64 61 74 61 20 61 70 he extra data ap
336b0 70 65 6e 64 65 64 20 74 6f 20 61 20 70 61 67 65 pended to a page
336c0 20 69 73 20 61 6c 77 61 79 73 20 69 6e 69 74 69 is always initi
336d0 61 6c 69 7a 65 64 20 74 6f 20 7a 65 72 6f 73 20 alized to zeros
336e0 74 68 65 20 0a 2a 2a 20 66 69 72 73 74 20 74 69 the .** first ti
336f0 6d 65 20 61 20 70 61 67 65 20 69 73 20 6c 6f 61 me a page is loa
33700 64 65 64 20 69 6e 74 6f 20 6d 65 6d 6f 72 79 2e ded into memory.
33710 20 49 66 20 74 68 65 20 70 61 67 65 20 72 65 71 If the page req
33720 75 65 73 74 65 64 20 69 73 20 0a 2a 2a 20 61 6c uested is .** al
33730 72 65 61 64 79 20 69 6e 20 74 68 65 20 63 61 63 ready in the cac
33740 68 65 20 77 68 65 6e 20 74 68 69 73 20 66 75 6e he when this fun
33750 63 74 69 6f 6e 20 69 73 20 63 61 6c 6c 65 64 2c ction is called,
33760 20 74 68 65 6e 20 74 68 65 20 65 78 74 72 61 0a then the extra.
33770 2a 2a 20 64 61 74 61 20 69 73 20 6c 65 66 74 20 ** data is left
33780 61 73 20 69 74 20 77 61 73 20 77 68 65 6e 20 74 as it was when t
33790 68 65 20 70 61 67 65 20 6f 62 6a 65 63 74 20 77 he page object w
337a0 61 73 20 6c 61 73 74 20 75 73 65 64 2e 0a 2a 2a as last used..**
337b0 0a 2a 2a 20 49 66 20 74 68 65 20 64 61 74 61 62 .** If the datab
337c0 61 73 65 20 69 6d 61 67 65 20 69 73 20 73 6d 61 ase image is sma
337d0 6c 6c 65 72 20 74 68 61 6e 20 74 68 65 20 72 65 ller than the re
337e0 71 75 65 73 74 65 64 20 70 61 67 65 20 6f 72 20 quested page or
337f0 69 66 20 61 20 0a 2a 2a 20 6e 6f 6e 2d 7a 65 72 if a .** non-zer
33800 6f 20 76 61 6c 75 65 20 69 73 20 70 61 73 73 65 o value is passe
33810 64 20 61 73 20 74 68 65 20 6e 6f 43 6f 6e 74 65 d as the noConte
33820 6e 74 20 70 61 72 61 6d 65 74 65 72 20 61 6e 64 nt parameter and
33830 20 74 68 65 20 0a 2a 2a 20 72 65 71 75 65 73 74 the .** request
33840 65 64 20 70 61 67 65 20 69 73 20 6e 6f 74 20 61 ed page is not a
33850 6c 72 65 61 64 79 20 73 74 6f 72 65 64 20 69 6e lready stored in
33860 20 74 68 65 20 63 61 63 68 65 2c 20 74 68 65 6e the cache, then
33870 20 6e 6f 20 0a 2a 2a 20 61 63 74 75 61 6c 20 64 no .** actual d
33880 69 73 6b 20 72 65 61 64 20 6f 63 63 75 72 73 2e isk read occurs.
33890 20 49 6e 20 74 68 69 73 20 63 61 73 65 20 74 68 In this case th
338a0 65 20 6d 65 6d 6f 72 79 20 69 6d 61 67 65 20 6f e memory image o
338b0 66 20 74 68 65 20 0a 2a 2a 20 70 61 67 65 20 69 f the .** page i
338c0 73 20 69 6e 69 74 69 61 6c 69 7a 65 64 20 74 6f s initialized to
338d0 20 61 6c 6c 20 7a 65 72 6f 73 2e 20 0a 2a 2a 0a all zeros. .**.
338e0 2a 2a 20 49 66 20 6e 6f 43 6f 6e 74 65 6e 74 20 ** If noContent
338f0 69 73 20 74 72 75 65 2c 20 69 74 20 6d 65 61 6e is true, it mean
33900 73 20 74 68 61 74 20 77 65 20 64 6f 20 6e 6f 74 s that we do not
33910 20 63 61 72 65 20 61 62 6f 75 74 20 74 68 65 20 care about the
33920 63 6f 6e 74 65 6e 74 73 0a 2a 2a 20 6f 66 20 74 contents.** of t
33930 68 65 20 70 61 67 65 2e 20 54 68 69 73 20 6f 63 he page. This oc
33940 63 75 72 73 20 69 6e 20 74 77 6f 20 73 63 65 6e curs in two scen
33950 61 72 69 6f 73 3a 0a 2a 2a 0a 2a 2a 20 20 20 61 arios:.**.** a
33960 29 20 57 68 65 6e 20 72 65 61 64 69 6e 67 20 61 ) When reading a
33970 20 66 72 65 65 2d 6c 69 73 74 20 6c 65 61 66 20 free-list leaf
33980 70 61 67 65 20 66 72 6f 6d 20 74 68 65 20 64 61 page from the da
33990 74 61 62 61 73 65 2c 20 61 6e 64 0a 2a 2a 0a 2a tabase, and.**.*
339a0 2a 20 20 20 62 29 20 57 68 65 6e 20 61 20 73 61 * b) When a sa
339b0 76 65 70 6f 69 6e 74 20 69 73 20 62 65 69 6e 67 vepoint is being
339c0 20 72 6f 6c 6c 65 64 20 62 61 63 6b 20 61 6e 64 rolled back and
339d0 20 77 65 20 6e 65 65 64 20 74 6f 20 6c 6f 61 64 we need to load
339e0 0a 2a 2a 20 20 20 20 20 20 61 20 6e 65 77 20 70 .** a new p
339f0 61 67 65 20 69 6e 74 6f 20 74 68 65 20 63 61 63 age into the cac
33a00 68 65 20 74 6f 20 62 65 20 66 69 6c 6c 65 64 20 he to be filled
33a10 77 69 74 68 20 74 68 65 20 64 61 74 61 20 72 65 with the data re
33a20 61 64 0a 2a 2a 20 20 20 20 20 20 66 72 6f 6d 20 ad.** from
33a30 74 68 65 20 73 61 76 65 70 6f 69 6e 74 20 6a 6f the savepoint jo
33a40 75 72 6e 61 6c 2e 0a 2a 2a 0a 2a 2a 20 49 66 20 urnal..**.** If
33a50 6e 6f 43 6f 6e 74 65 6e 74 20 69 73 20 74 72 75 noContent is tru
33a60 65 2c 20 74 68 65 6e 20 74 68 65 20 64 61 74 61 e, then the data
33a70 20 72 65 74 75 72 6e 65 64 20 69 73 20 7a 65 72 returned is zer
33a80 6f 65 64 20 69 6e 73 74 65 61 64 20 6f 66 0a 2a oed instead of.*
33a90 2a 20 62 65 69 6e 67 20 72 65 61 64 20 66 72 6f * being read fro
33aa0 6d 20 74 68 65 20 64 61 74 61 62 61 73 65 2e 20 m the database.
33ab0 41 64 64 69 74 69 6f 6e 61 6c 6c 79 2c 20 74 68 Additionally, th
33ac0 65 20 62 69 74 73 20 63 6f 72 72 65 73 70 6f 6e e bits correspon
33ad0 64 69 6e 67 0a 2a 2a 20 74 6f 20 70 67 6e 6f 20 ding.** to pgno
33ae0 69 6e 20 50 61 67 65 72 2e 70 49 6e 4a 6f 75 72 in Pager.pInJour
33af0 6e 61 6c 20 28 62 69 74 76 65 63 20 6f 66 20 70 nal (bitvec of p
33b00 61 67 65 73 20 61 6c 72 65 61 64 79 20 77 72 69 ages already wri
33b10 74 74 65 6e 20 74 6f 20 74 68 65 0a 2a 2a 20 6a tten to the.** j
33b20 6f 75 72 6e 61 6c 20 66 69 6c 65 29 20 61 6e 64 ournal file) and
33b30 20 74 68 65 20 50 61 67 65 72 53 61 76 65 70 6f the PagerSavepo
33b40 69 6e 74 2e 70 49 6e 53 61 76 65 70 6f 69 6e 74 int.pInSavepoint
33b50 20 62 69 74 76 65 63 73 20 6f 66 20 61 6e 79 20 bitvecs of any
33b60 6f 70 65 6e 0a 2a 2a 20 73 61 76 65 70 6f 69 6e open.** savepoin
33b70 74 73 20 61 72 65 20 73 65 74 2e 20 54 68 69 73 ts are set. This
33b80 20 6d 65 61 6e 73 20 69 66 20 74 68 65 20 70 61 means if the pa
33b90 67 65 20 69 73 20 6d 61 64 65 20 77 72 69 74 61 ge is made writa
33ba0 62 6c 65 20 61 74 20 61 6e 79 0a 2a 2a 20 70 6f ble at any.** po
33bb0 69 6e 74 20 69 6e 20 74 68 65 20 66 75 74 75 72 int in the futur
33bc0 65 2c 20 75 73 69 6e 67 20 61 20 63 61 6c 6c 20 e, using a call
33bd0 74 6f 20 73 71 6c 69 74 65 33 50 61 67 65 72 57 to sqlite3PagerW
33be0 72 69 74 65 28 29 2c 20 69 74 73 20 63 6f 6e 74 rite(), its cont
33bf0 65 6e 74 73 0a 2a 2a 20 77 69 6c 6c 20 6e 6f 74 ents.** will not
33c00 20 62 65 20 6a 6f 75 72 6e 61 6c 65 64 2e 20 54 be journaled. T
33c10 68 69 73 20 73 61 76 65 73 20 49 4f 2e 0a 2a 2a his saves IO..**
33c20 0a 2a 2a 20 54 68 65 20 61 63 71 75 69 73 69 74 .** The acquisit
33c30 69 6f 6e 20 6d 69 67 68 74 20 66 61 69 6c 20 66 ion might fail f
33c40 6f 72 20 73 65 76 65 72 61 6c 20 72 65 61 73 6f or several reaso
33c50 6e 73 2e 20 20 49 6e 20 61 6c 6c 20 63 61 73 65 ns. In all case
33c60 73 2c 0a 2a 2a 20 61 6e 20 61 70 70 72 6f 70 72 s,.** an appropr
33c70 69 61 74 65 20 65 72 72 6f 72 20 63 6f 64 65 20 iate error code
33c80 69 73 20 72 65 74 75 72 6e 65 64 20 61 6e 64 20 is returned and
33c90 2a 70 70 50 61 67 65 20 69 73 20 73 65 74 20 74 *ppPage is set t
33ca0 6f 20 4e 55 4c 4c 2e 0a 2a 2a 0a 2a 2a 20 53 65 o NULL..**.** Se
33cb0 65 20 61 6c 73 6f 20 73 71 6c 69 74 65 33 50 61 e also sqlite3Pa
33cc0 67 65 72 4c 6f 6f 6b 75 70 28 29 2e 20 20 42 6f gerLookup(). Bo
33cd0 74 68 20 74 68 69 73 20 72 6f 75 74 69 6e 65 20 th this routine
33ce0 61 6e 64 20 4c 6f 6f 6b 75 70 28 29 20 61 74 74 and Lookup() att
33cf0 65 6d 70 74 0a 2a 2a 20 74 6f 20 66 69 6e 64 20 empt.** to find
33d00 61 20 70 61 67 65 20 69 6e 20 74 68 65 20 69 6e a page in the in
33d10 2d 6d 65 6d 6f 72 79 20 63 61 63 68 65 20 66 69 -memory cache fi
33d20 72 73 74 2e 20 20 49 66 20 74 68 65 20 70 61 67 rst. If the pag
33d30 65 20 69 73 20 6e 6f 74 20 61 6c 72 65 61 64 79 e is not already
33d40 0a 2a 2a 20 69 6e 20 6d 65 6d 6f 72 79 2c 20 74 .** in memory, t
33d50 68 69 73 20 72 6f 75 74 69 6e 65 20 67 6f 65 73 his routine goes
33d60 20 74 6f 20 64 69 73 6b 20 74 6f 20 72 65 61 64 to disk to read
33d70 20 69 74 20 69 6e 20 77 68 65 72 65 61 73 20 4c it in whereas L
33d80 6f 6f 6b 75 70 28 29 0a 2a 2a 20 6a 75 73 74 20 ookup().** just
33d90 72 65 74 75 72 6e 73 20 30 2e 20 20 54 68 69 73 returns 0. This
33da0 20 72 6f 75 74 69 6e 65 20 61 63 71 75 69 72 65 routine acquire
33db0 73 20 61 20 72 65 61 64 2d 6c 6f 63 6b 20 74 68 s a read-lock th
33dc0 65 20 66 69 72 73 74 20 74 69 6d 65 20 69 74 0a e first time it.
33dd0 2a 2a 20 68 61 73 20 74 6f 20 67 6f 20 74 6f 20 ** has to go to
33de0 64 69 73 6b 2c 20 61 6e 64 20 63 6f 75 6c 64 20 disk, and could
33df0 61 6c 73 6f 20 70 6c 61 79 62 61 63 6b 20 61 6e also playback an
33e00 20 6f 6c 64 20 6a 6f 75 72 6e 61 6c 20 69 66 20 old journal if
33e10 6e 65 63 65 73 73 61 72 79 2e 0a 2a 2a 20 53 69 necessary..** Si
33e20 6e 63 65 20 4c 6f 6f 6b 75 70 28 29 20 6e 65 76 nce Lookup() nev
33e30 65 72 20 67 6f 65 73 20 74 6f 20 64 69 73 6b 2c er goes to disk,
33e40 20 69 74 20 6e 65 76 65 72 20 68 61 73 20 74 6f it never has to
33e50 20 64 65 61 6c 20 77 69 74 68 20 6c 6f 63 6b 73 deal with locks
33e60 0a 2a 2a 20 6f 72 20 6a 6f 75 72 6e 61 6c 20 66 .** or journal f
33e70 69 6c 65 73 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c iles..*/.int sql
33e80 69 74 65 33 50 61 67 65 72 47 65 74 28 0a 20 20 ite3PagerGet(.
33e90 50 61 67 65 72 20 2a 70 50 61 67 65 72 2c 20 20 Pager *pPager,
33ea0 20 20 20 20 2f 2a 20 54 68 65 20 70 61 67 65 72 /* The pager
33eb0 20 6f 70 65 6e 20 6f 6e 20 74 68 65 20 64 61 74 open on the dat
33ec0 61 62 61 73 65 20 66 69 6c 65 20 2a 2f 0a 20 20 abase file */.
33ed0 50 67 6e 6f 20 70 67 6e 6f 2c 20 20 20 20 20 20 Pgno pgno,
33ee0 20 20 20 20 2f 2a 20 50 61 67 65 20 6e 75 6d 62 /* Page numb
33ef0 65 72 20 74 6f 20 66 65 74 63 68 20 2a 2f 0a 20 er to fetch */.
33f00 20 44 62 50 61 67 65 20 2a 2a 70 70 50 61 67 65 DbPage **ppPage
33f10 2c 20 20 20 20 2f 2a 20 57 72 69 74 65 20 61 20 , /* Write a
33f20 70 6f 69 6e 74 65 72 20 74 6f 20 74 68 65 20 70 pointer to the p
33f30 61 67 65 20 68 65 72 65 20 2a 2f 0a 20 20 69 6e age here */. in
33f40 74 20 66 6c 61 67 73 20 20 20 20 20 20 20 20 20 t flags
33f50 20 20 2f 2a 20 50 41 47 45 52 5f 47 45 54 5f 58 /* PAGER_GET_X
33f60 58 58 20 66 6c 61 67 73 20 2a 2f 0a 29 7b 0a 20 XX flags */.){.
33f70 20 69 6e 74 20 72 63 20 3d 20 53 51 4c 49 54 45 int rc = SQLITE
33f80 5f 4f 4b 3b 0a 20 20 50 67 48 64 72 20 2a 70 50 _OK;. PgHdr *pP
33f90 67 20 3d 20 30 3b 0a 20 20 75 33 32 20 69 46 72 g = 0;. u32 iFr
33fa0 61 6d 65 20 3d 20 30 3b 20 20 20 20 20 20 20 20 ame = 0;
33fb0 20 20 20 20 20 20 20 20 20 2f 2a 20 46 72 61 6d /* Fram
33fc0 65 20 74 6f 20 72 65 61 64 20 66 72 6f 6d 20 57 e to read from W
33fd0 41 4c 20 66 69 6c 65 20 2a 2f 0a 20 20 63 6f 6e AL file */. con
33fe0 73 74 20 69 6e 74 20 6e 6f 43 6f 6e 74 65 6e 74 st int noContent
33ff0 20 3d 20 28 66 6c 61 67 73 20 26 20 50 41 47 45 = (flags & PAGE
34000 52 5f 47 45 54 5f 4e 4f 43 4f 4e 54 45 4e 54 29 R_GET_NOCONTENT)
34010 3b 0a 0a 20 20 2f 2a 20 49 74 20 69 73 20 61 63 ;.. /* It is ac
34020 63 65 70 74 61 62 6c 65 20 74 6f 20 75 73 65 20 ceptable to use
34030 61 20 72 65 61 64 2d 6f 6e 6c 79 20 28 6d 6d 61 a read-only (mma
34040 70 29 20 70 61 67 65 20 66 6f 72 20 61 6e 79 20 p) page for any
34050 70 61 67 65 20 65 78 63 65 70 74 0a 20 20 2a 2a page except. **
34060 20 70 61 67 65 20 31 20 69 66 20 74 68 65 72 65 page 1 if there
34070 20 69 73 20 6e 6f 20 77 72 69 74 65 2d 74 72 61 is no write-tra
34080 6e 73 61 63 74 69 6f 6e 20 6f 70 65 6e 20 6f 72 nsaction open or
34090 20 74 68 65 20 41 43 51 55 49 52 45 5f 52 45 41 the ACQUIRE_REA
340a0 44 4f 4e 4c 59 0a 20 20 2a 2a 20 66 6c 61 67 20 DONLY. ** flag
340b0 77 61 73 20 73 70 65 63 69 66 69 65 64 20 62 79 was specified by
340c0 20 74 68 65 20 63 61 6c 6c 65 72 2e 20 41 6e 64 the caller. And
340d0 20 73 6f 20 6c 6f 6e 67 20 61 73 20 74 68 65 20 so long as the
340e0 64 62 20 69 73 20 6e 6f 74 20 61 20 0a 20 20 2a db is not a . *
340f0 2a 20 74 65 6d 70 6f 72 61 72 79 20 6f 72 20 69 * temporary or i
34100 6e 2d 6d 65 6d 6f 72 79 20 64 61 74 61 62 61 73 n-memory databas
34110 65 2e 20 20 2a 2f 0a 20 20 63 6f 6e 73 74 20 69 e. */. const i
34120 6e 74 20 62 4d 6d 61 70 4f 6b 20 3d 20 28 70 67 nt bMmapOk = (pg
34130 6e 6f 3e 31 20 26 26 20 55 53 45 46 45 54 43 48 no>1 && USEFETCH
34140 28 70 50 61 67 65 72 29 0a 20 20 20 26 26 20 28 (pPager). && (
34150 70 50 61 67 65 72 2d 3e 65 53 74 61 74 65 3d 3d pPager->eState==
34160 50 41 47 45 52 5f 52 45 41 44 45 52 20 7c 7c 20 PAGER_READER ||
34170 28 66 6c 61 67 73 20 26 20 50 41 47 45 52 5f 47 (flags & PAGER_G
34180 45 54 5f 52 45 41 44 4f 4e 4c 59 29 29 0a 23 69 ET_READONLY)).#i
34190 66 64 65 66 20 53 51 4c 49 54 45 5f 48 41 53 5f fdef SQLITE_HAS_
341a0 43 4f 44 45 43 0a 20 20 20 26 26 20 70 50 61 67 CODEC. && pPag
341b0 65 72 2d 3e 78 43 6f 64 65 63 3d 3d 30 0a 23 65 er->xCodec==0.#e
341c0 6e 64 69 66 0a 20 20 29 3b 0a 0a 20 20 2f 2a 20 ndif. );.. /*
341d0 4f 70 74 69 6d 69 7a 61 74 69 6f 6e 20 6e 6f 74 Optimization not
341e0 65 3a 20 20 41 64 64 69 6e 67 20 74 68 65 20 22 e: Adding the "
341f0 70 67 6e 6f 3c 3d 31 22 20 74 65 72 6d 20 62 65 pgno<=1" term be
34200 66 6f 72 65 20 22 70 67 6e 6f 3d 3d 30 22 20 68 fore "pgno==0" h
34210 65 72 65 0a 20 20 2a 2a 20 61 6c 6c 6f 77 73 20 ere. ** allows
34220 74 68 65 20 63 6f 6d 70 69 6c 65 72 20 6f 70 74 the compiler opt
34230 69 6d 69 7a 65 72 20 74 6f 20 72 65 75 73 65 20 imizer to reuse
34240 74 68 65 20 72 65 73 75 6c 74 73 20 6f 66 20 74 the results of t
34250 68 65 20 22 70 67 6e 6f 3e 31 22 0a 20 20 2a 2a he "pgno>1". **
34260 20 74 65 73 74 20 69 6e 20 74 68 65 20 70 72 65 test in the pre
34270 76 69 6f 75 73 20 73 74 61 74 65 6d 65 6e 74 2c vious statement,
34280 20 61 6e 64 20 61 76 6f 69 64 20 74 65 73 74 69 and avoid testi
34290 6e 67 20 70 67 6e 6f 3d 3d 30 20 69 6e 20 74 68 ng pgno==0 in th
342a0 65 0a 20 20 2a 2a 20 63 6f 6d 6d 6f 6e 20 63 61 e. ** common ca
342b0 73 65 20 77 68 65 72 65 20 70 67 6e 6f 20 69 73 se where pgno is
342c0 20 6c 61 72 67 65 2e 20 2a 2f 0a 20 20 69 66 28 large. */. if(
342d0 20 70 67 6e 6f 3c 3d 31 20 26 26 20 70 67 6e 6f pgno<=1 && pgno
342e0 3d 3d 30 20 29 7b 0a 20 20 20 20 72 65 74 75 72 ==0 ){. retur
342f0 6e 20 53 51 4c 49 54 45 5f 43 4f 52 52 55 50 54 n SQLITE_CORRUPT
34300 5f 42 4b 50 54 3b 0a 20 20 7d 0a 20 20 61 73 73 _BKPT;. }. ass
34310 65 72 74 28 20 70 50 61 67 65 72 2d 3e 65 53 74 ert( pPager->eSt
34320 61 74 65 3e 3d 50 41 47 45 52 5f 52 45 41 44 45 ate>=PAGER_READE
34330 52 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 61 R );. assert( a
34340 73 73 65 72 74 5f 70 61 67 65 72 5f 73 74 61 74 ssert_pager_stat
34350 65 28 70 50 61 67 65 72 29 20 29 3b 0a 20 20 61 e(pPager) );. a
34360 73 73 65 72 74 28 20 6e 6f 43 6f 6e 74 65 6e 74 ssert( noContent
34370 3d 3d 30 20 7c 7c 20 62 4d 6d 61 70 4f 6b 3d 3d ==0 || bMmapOk==
34380 30 20 29 3b 0a 0a 20 20 61 73 73 65 72 74 28 20 0 );.. assert(
34390 70 50 61 67 65 72 2d 3e 68 61 73 48 65 6c 64 53 pPager->hasHeldS
343a0 68 61 72 65 64 4c 6f 63 6b 3d 3d 31 20 29 3b 0a haredLock==1 );.
343b0 0a 20 20 2f 2a 20 49 66 20 74 68 65 20 70 61 67 . /* If the pag
343c0 65 72 20 69 73 20 69 6e 20 74 68 65 20 65 72 72 er is in the err
343d0 6f 72 20 73 74 61 74 65 2c 20 72 65 74 75 72 6e or state, return
343e0 20 61 6e 20 65 72 72 6f 72 20 69 6d 6d 65 64 69 an error immedi
343f0 61 74 65 6c 79 2e 20 0a 20 20 2a 2a 20 4f 74 68 ately. . ** Oth
34400 65 72 77 69 73 65 2c 20 72 65 71 75 65 73 74 20 erwise, request
34410 74 68 65 20 70 61 67 65 20 66 72 6f 6d 20 74 68 the page from th
34420 65 20 50 43 61 63 68 65 20 6c 61 79 65 72 2e 20 e PCache layer.
34430 2a 2f 0a 20 20 69 66 28 20 70 50 61 67 65 72 2d */. if( pPager-
34440 3e 65 72 72 43 6f 64 65 21 3d 53 51 4c 49 54 45 >errCode!=SQLITE
34450 5f 4f 4b 20 29 7b 0a 20 20 20 20 72 63 20 3d 20 _OK ){. rc =
34460 70 50 61 67 65 72 2d 3e 65 72 72 43 6f 64 65 3b pPager->errCode;
34470 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 69 66 . }else{. if
34480 28 20 62 4d 6d 61 70 4f 6b 20 26 26 20 70 61 67 ( bMmapOk && pag
34490 65 72 55 73 65 57 61 6c 28 70 50 61 67 65 72 29 erUseWal(pPager)
344a0 20 29 7b 0a 20 20 20 20 20 20 72 63 20 3d 20 73 ){. rc = s
344b0 71 6c 69 74 65 33 57 61 6c 46 69 6e 64 46 72 61 qlite3WalFindFra
344c0 6d 65 28 70 50 61 67 65 72 2d 3e 70 57 61 6c 2c me(pPager->pWal,
344d0 20 70 67 6e 6f 2c 20 26 69 46 72 61 6d 65 29 3b pgno, &iFrame);
344e0 0a 20 20 20 20 20 20 69 66 28 20 72 63 21 3d 53 . if( rc!=S
344f0 51 4c 49 54 45 5f 4f 4b 20 29 20 67 6f 74 6f 20 QLITE_OK ) goto
34500 70 61 67 65 72 5f 61 63 71 75 69 72 65 5f 65 72 pager_acquire_er
34510 72 3b 0a 20 20 20 20 7d 0a 0a 20 20 20 20 69 66 r;. }.. if
34520 28 20 62 4d 6d 61 70 4f 6b 20 26 26 20 69 46 72 ( bMmapOk && iFr
34530 61 6d 65 3d 3d 30 20 29 7b 0a 20 20 20 20 20 20 ame==0 ){.
34540 76 6f 69 64 20 2a 70 44 61 74 61 20 3d 20 30 3b void *pData = 0;
34550 0a 0a 20 20 20 20 20 20 72 63 20 3d 20 73 71 6c .. rc = sql
34560 69 74 65 33 4f 73 46 65 74 63 68 28 70 50 61 67 ite3OsFetch(pPag
34570 65 72 2d 3e 66 64 2c 20 0a 20 20 20 20 20 20 20 er->fd, .
34580 20 20 20 28 69 36 34 29 28 70 67 6e 6f 2d 31 29 (i64)(pgno-1)
34590 20 2a 20 70 50 61 67 65 72 2d 3e 70 61 67 65 53 * pPager->pageS
345a0 69 7a 65 2c 20 70 50 61 67 65 72 2d 3e 70 61 67 ize, pPager->pag
345b0 65 53 69 7a 65 2c 20 26 70 44 61 74 61 0a 20 20 eSize, &pData.
345c0 20 20 20 20 29 3b 0a 0a 20 20 20 20 20 20 69 66 );.. if
345d0 28 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 ( rc==SQLITE_OK
345e0 26 26 20 70 44 61 74 61 20 29 7b 0a 20 20 20 20 && pData ){.
345f0 20 20 20 20 69 66 28 20 70 50 61 67 65 72 2d 3e if( pPager->
34600 65 53 74 61 74 65 3e 50 41 47 45 52 5f 52 45 41 eState>PAGER_REA
34610 44 45 52 20 29 7b 0a 20 20 20 20 20 20 20 20 20 DER ){.
34620 20 70 50 67 20 3d 20 73 71 6c 69 74 65 33 50 61 pPg = sqlite3Pa
34630 67 65 72 4c 6f 6f 6b 75 70 28 70 50 61 67 65 72 gerLookup(pPager
34640 2c 20 70 67 6e 6f 29 3b 0a 20 20 20 20 20 20 20 , pgno);.
34650 20 7d 0a 20 20 20 20 20 20 20 20 69 66 28 20 70 }. if( p
34660 50 67 3d 3d 30 20 29 7b 0a 20 20 20 20 20 20 20 Pg==0 ){.
34670 20 20 20 72 63 20 3d 20 70 61 67 65 72 41 63 71 rc = pagerAcq
34680 75 69 72 65 4d 61 70 50 61 67 65 28 70 50 61 67 uireMapPage(pPag
34690 65 72 2c 20 70 67 6e 6f 2c 20 70 44 61 74 61 2c er, pgno, pData,
346a0 20 26 70 50 67 29 3b 0a 20 20 20 20 20 20 20 20 &pPg);.
346b0 7d 65 6c 73 65 7b 0a 20 20 20 20 20 20 20 20 20 }else{.
346c0 20 73 71 6c 69 74 65 33 4f 73 55 6e 66 65 74 63 sqlite3OsUnfetc
346d0 68 28 70 50 61 67 65 72 2d 3e 66 64 2c 20 28 69 h(pPager->fd, (i
346e0 36 34 29 28 70 67 6e 6f 2d 31 29 2a 70 50 61 67 64)(pgno-1)*pPag
346f0 65 72 2d 3e 70 61 67 65 53 69 7a 65 2c 20 70 44 er->pageSize, pD
34700 61 74 61 29 3b 0a 20 20 20 20 20 20 20 20 7d 0a ata);. }.
34710 20 20 20 20 20 20 20 20 69 66 28 20 70 50 67 20 if( pPg
34720 29 7b 0a 20 20 20 20 20 20 20 20 20 20 61 73 73 ){. ass
34730 65 72 74 28 20 72 63 3d 3d 53 51 4c 49 54 45 5f ert( rc==SQLITE_
34740 4f 4b 20 29 3b 0a 20 20 20 20 20 20 20 20 20 20 OK );.
34750 2a 70 70 50 61 67 65 20 3d 20 70 50 67 3b 0a 20 *ppPage = pPg;.
34760 20 20 20 20 20 20 20 20 20 72 65 74 75 72 6e 20 return
34770 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20 20 20 20 20 SQLITE_OK;.
34780 20 20 20 7d 0a 20 20 20 20 20 20 7d 0a 20 20 20 }. }.
34790 20 20 20 69 66 28 20 72 63 21 3d 53 51 4c 49 54 if( rc!=SQLIT
347a0 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 20 20 20 20 E_OK ){.
347b0 67 6f 74 6f 20 70 61 67 65 72 5f 61 63 71 75 69 goto pager_acqui
347c0 72 65 5f 65 72 72 3b 0a 20 20 20 20 20 20 7d 0a re_err;. }.
347d0 20 20 20 20 7d 0a 0a 20 20 20 20 7b 0a 20 20 20 }.. {.
347e0 20 20 20 73 71 6c 69 74 65 33 5f 70 63 61 63 68 sqlite3_pcach
347f0 65 5f 70 61 67 65 20 2a 70 42 61 73 65 3b 0a 20 e_page *pBase;.
34800 20 20 20 20 20 70 42 61 73 65 20 3d 20 73 71 6c pBase = sql
34810 69 74 65 33 50 63 61 63 68 65 46 65 74 63 68 28 ite3PcacheFetch(
34820 70 50 61 67 65 72 2d 3e 70 50 43 61 63 68 65 2c pPager->pPCache,
34830 20 70 67 6e 6f 2c 20 33 29 3b 0a 20 20 20 20 20 pgno, 3);.
34840 20 69 66 28 20 70 42 61 73 65 3d 3d 30 20 29 7b if( pBase==0 ){
34850 0a 20 20 20 20 20 20 20 20 72 63 20 3d 20 73 71 . rc = sq
34860 6c 69 74 65 33 50 63 61 63 68 65 46 65 74 63 68 lite3PcacheFetch
34870 53 74 72 65 73 73 28 70 50 61 67 65 72 2d 3e 70 Stress(pPager->p
34880 50 43 61 63 68 65 2c 20 70 67 6e 6f 2c 20 26 70 PCache, pgno, &p
34890 42 61 73 65 29 3b 0a 20 20 20 20 20 20 20 20 69 Base);. i
348a0 66 28 20 72 63 21 3d 53 51 4c 49 54 45 5f 4f 4b f( rc!=SQLITE_OK
348b0 20 29 20 67 6f 74 6f 20 70 61 67 65 72 5f 61 63 ) goto pager_ac
348c0 71 75 69 72 65 5f 65 72 72 3b 0a 20 20 20 20 20 quire_err;.
348d0 20 20 20 69 66 28 20 70 42 61 73 65 3d 3d 30 20 if( pBase==0
348e0 29 7b 0a 20 20 20 20 20 20 20 20 20 20 70 50 67 ){. pPg
348f0 20 3d 20 2a 70 70 50 61 67 65 20 3d 20 30 3b 0a = *ppPage = 0;.
34900 20 20 20 20 20 20 20 20 20 20 72 63 20 3d 20 53 rc = S
34910 51 4c 49 54 45 5f 4e 4f 4d 45 4d 5f 42 4b 50 54 QLITE_NOMEM_BKPT
34920 3b 0a 20 20 20 20 20 20 20 20 20 20 67 6f 74 6f ;. goto
34930 20 70 61 67 65 72 5f 61 63 71 75 69 72 65 5f 65 pager_acquire_e
34940 72 72 3b 0a 20 20 20 20 20 20 20 20 7d 0a 20 20 rr;. }.
34950 20 20 20 20 7d 0a 20 20 20 20 20 20 70 50 67 20 }. pPg
34960 3d 20 2a 70 70 50 61 67 65 20 3d 20 73 71 6c 69 = *ppPage = sqli
34970 74 65 33 50 63 61 63 68 65 46 65 74 63 68 46 69 te3PcacheFetchFi
34980 6e 69 73 68 28 70 50 61 67 65 72 2d 3e 70 50 43 nish(pPager->pPC
34990 61 63 68 65 2c 20 70 67 6e 6f 2c 20 70 42 61 73 ache, pgno, pBas
349a0 65 29 3b 0a 20 20 20 20 20 20 61 73 73 65 72 74 e);. assert
349b0 28 20 70 50 67 21 3d 30 20 29 3b 0a 20 20 20 20 ( pPg!=0 );.
349c0 7d 0a 20 20 7d 0a 0a 20 20 69 66 28 20 72 63 21 }. }.. if( rc!
349d0 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 =SQLITE_OK ){.
349e0 20 20 2f 2a 20 45 69 74 68 65 72 20 74 68 65 20 /* Either the
349f0 63 61 6c 6c 20 74 6f 20 73 71 6c 69 74 65 33 50 call to sqlite3P
34a00 63 61 63 68 65 46 65 74 63 68 28 29 20 72 65 74 cacheFetch() ret
34a10 75 72 6e 65 64 20 61 6e 20 65 72 72 6f 72 20 6f urned an error o
34a20 72 20 74 68 65 0a 20 20 20 20 2a 2a 20 70 61 67 r the. ** pag
34a30 65 72 20 77 61 73 20 61 6c 72 65 61 64 79 20 69 er was already i
34a40 6e 20 74 68 65 20 65 72 72 6f 72 2d 73 74 61 74 n the error-stat
34a50 65 20 77 68 65 6e 20 74 68 69 73 20 66 75 6e 63 e when this func
34a60 74 69 6f 6e 20 77 61 73 20 63 61 6c 6c 65 64 2e tion was called.
34a70 0a 20 20 20 20 2a 2a 20 53 65 74 20 70 50 67 20 . ** Set pPg
34a80 74 6f 20 30 20 61 6e 64 20 6a 75 6d 70 20 74 6f to 0 and jump to
34a90 20 74 68 65 20 65 78 63 65 70 74 69 6f 6e 20 68 the exception h
34aa0 61 6e 64 6c 65 72 2e 20 20 2a 2f 0a 20 20 20 20 andler. */.
34ab0 70 50 67 20 3d 20 30 3b 0a 20 20 20 20 67 6f 74 pPg = 0;. got
34ac0 6f 20 70 61 67 65 72 5f 61 63 71 75 69 72 65 5f o pager_acquire_
34ad0 65 72 72 3b 0a 20 20 7d 0a 20 20 61 73 73 65 72 err;. }. asser
34ae0 74 28 20 70 50 67 3d 3d 28 2a 70 70 50 61 67 65 t( pPg==(*ppPage
34af0 29 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 70 ) );. assert( p
34b00 50 67 2d 3e 70 67 6e 6f 3d 3d 70 67 6e 6f 20 29 Pg->pgno==pgno )
34b10 3b 0a 20 20 61 73 73 65 72 74 28 20 70 50 67 2d ;. assert( pPg-
34b20 3e 70 50 61 67 65 72 3d 3d 70 50 61 67 65 72 20 >pPager==pPager
34b30 7c 7c 20 70 50 67 2d 3e 70 50 61 67 65 72 3d 3d || pPg->pPager==
34b40 30 20 29 3b 0a 0a 20 20 69 66 28 20 70 50 67 2d 0 );.. if( pPg-
34b50 3e 70 50 61 67 65 72 20 26 26 20 21 6e 6f 43 6f >pPager && !noCo
34b60 6e 74 65 6e 74 20 29 7b 0a 20 20 20 20 2f 2a 20 ntent ){. /*
34b70 49 6e 20 74 68 69 73 20 63 61 73 65 20 74 68 65 In this case the
34b80 20 70 63 61 63 68 65 20 61 6c 72 65 61 64 79 20 pcache already
34b90 63 6f 6e 74 61 69 6e 73 20 61 6e 20 69 6e 69 74 contains an init
34ba0 69 61 6c 69 7a 65 64 20 63 6f 70 79 20 6f 66 0a ialized copy of.
34bb0 20 20 20 20 2a 2a 20 74 68 65 20 70 61 67 65 2e ** the page.
34bc0 20 52 65 74 75 72 6e 20 77 69 74 68 6f 75 74 20 Return without
34bd0 66 75 72 74 68 65 72 20 61 64 6f 2e 20 20 2a 2f further ado. */
34be0 0a 20 20 20 20 61 73 73 65 72 74 28 20 70 67 6e . assert( pgn
34bf0 6f 3c 3d 50 41 47 45 52 5f 4d 41 58 5f 50 47 4e o<=PAGER_MAX_PGN
34c00 4f 20 26 26 20 70 67 6e 6f 21 3d 50 41 47 45 52 O && pgno!=PAGER
34c10 5f 4d 4a 5f 50 47 4e 4f 28 70 50 61 67 65 72 29 _MJ_PGNO(pPager)
34c20 20 29 3b 0a 20 20 20 20 70 50 61 67 65 72 2d 3e );. pPager->
34c30 61 53 74 61 74 5b 50 41 47 45 52 5f 53 54 41 54 aStat[PAGER_STAT
34c40 5f 48 49 54 5d 2b 2b 3b 0a 20 20 20 20 72 65 74 _HIT]++;. ret
34c50 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 0a urn SQLITE_OK;..
34c60 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 2f 2a 20 }else{. /*
34c70 54 68 65 20 70 61 67 65 72 20 63 61 63 68 65 20 The pager cache
34c80 68 61 73 20 63 72 65 61 74 65 64 20 61 20 6e 65 has created a ne
34c90 77 20 70 61 67 65 2e 20 49 74 73 20 63 6f 6e 74 w page. Its cont
34ca0 65 6e 74 20 6e 65 65 64 73 20 74 6f 20 0a 20 20 ent needs to .
34cb0 20 20 2a 2a 20 62 65 20 69 6e 69 74 69 61 6c 69 ** be initiali
34cc0 7a 65 64 2e 20 20 2a 2f 0a 0a 20 20 20 20 70 50 zed. */.. pP
34cd0 67 2d 3e 70 50 61 67 65 72 20 3d 20 70 50 61 67 g->pPager = pPag
34ce0 65 72 3b 0a 0a 20 20 20 20 2f 2a 20 54 68 65 20 er;.. /* The
34cf0 6d 61 78 69 6d 75 6d 20 70 61 67 65 20 6e 75 6d maximum page num
34d00 62 65 72 20 69 73 20 32 5e 33 31 2e 20 52 65 74 ber is 2^31. Ret
34d10 75 72 6e 20 53 51 4c 49 54 45 5f 43 4f 52 52 55 urn SQLITE_CORRU
34d20 50 54 20 69 66 20 61 20 70 61 67 65 0a 20 20 20 PT if a page.
34d30 20 2a 2a 20 6e 75 6d 62 65 72 20 67 72 65 61 74 ** number great
34d40 65 72 20 74 68 61 6e 20 74 68 69 73 2c 20 6f 72 er than this, or
34d50 20 74 68 65 20 75 6e 75 73 65 64 20 6c 6f 63 6b the unused lock
34d60 69 6e 67 2d 70 61 67 65 2c 20 69 73 20 72 65 71 ing-page, is req
34d70 75 65 73 74 65 64 2e 20 2a 2f 0a 20 20 20 20 69 uested. */. i
34d80 66 28 20 70 67 6e 6f 3e 50 41 47 45 52 5f 4d 41 f( pgno>PAGER_MA
34d90 58 5f 50 47 4e 4f 20 7c 7c 20 70 67 6e 6f 3d 3d X_PGNO || pgno==
34da0 50 41 47 45 52 5f 4d 4a 5f 50 47 4e 4f 28 70 50 PAGER_MJ_PGNO(pP
34db0 61 67 65 72 29 20 29 7b 0a 20 20 20 20 20 20 72 ager) ){. r
34dc0 63 20 3d 20 53 51 4c 49 54 45 5f 43 4f 52 52 55 c = SQLITE_CORRU
34dd0 50 54 5f 42 4b 50 54 3b 0a 20 20 20 20 20 20 67 PT_BKPT;. g
34de0 6f 74 6f 20 70 61 67 65 72 5f 61 63 71 75 69 72 oto pager_acquir
34df0 65 5f 65 72 72 3b 0a 20 20 20 20 7d 0a 0a 20 20 e_err;. }..
34e00 20 20 69 66 28 20 4d 45 4d 44 42 20 7c 7c 20 70 if( MEMDB || p
34e10 50 61 67 65 72 2d 3e 64 62 53 69 7a 65 3c 70 67 Pager->dbSize<pg
34e20 6e 6f 20 7c 7c 20 6e 6f 43 6f 6e 74 65 6e 74 20 no || noContent
34e30 7c 7c 20 21 69 73 4f 70 65 6e 28 70 50 61 67 65 || !isOpen(pPage
34e40 72 2d 3e 66 64 29 20 29 7b 0a 20 20 20 20 20 20 r->fd) ){.
34e50 69 66 28 20 70 67 6e 6f 3e 70 50 61 67 65 72 2d if( pgno>pPager-
34e60 3e 6d 78 50 67 6e 6f 20 29 7b 0a 20 20 20 20 20 >mxPgno ){.
34e70 20 20 20 72 63 20 3d 20 53 51 4c 49 54 45 5f 46 rc = SQLITE_F
34e80 55 4c 4c 3b 0a 20 20 20 20 20 20 20 20 67 6f 74 ULL;. got
34e90 6f 20 70 61 67 65 72 5f 61 63 71 75 69 72 65 5f o pager_acquire_
34ea0 65 72 72 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20 err;. }.
34eb0 20 20 20 69 66 28 20 6e 6f 43 6f 6e 74 65 6e 74 if( noContent
34ec0 20 29 7b 0a 20 20 20 20 20 20 20 20 2f 2a 20 46 ){. /* F
34ed0 61 69 6c 75 72 65 20 74 6f 20 73 65 74 20 74 68 ailure to set th
34ee0 65 20 62 69 74 73 20 69 6e 20 74 68 65 20 49 6e e bits in the In
34ef0 4a 6f 75 72 6e 61 6c 20 62 69 74 2d 76 65 63 74 Journal bit-vect
34f00 6f 72 73 20 69 73 20 62 65 6e 69 67 6e 2e 0a 20 ors is benign..
34f10 20 20 20 20 20 20 20 2a 2a 20 49 74 20 6d 65 72 ** It mer
34f20 65 6c 79 20 6d 65 61 6e 73 20 74 68 61 74 20 77 ely means that w
34f30 65 20 6d 69 67 68 74 20 64 6f 20 73 6f 6d 65 20 e might do some
34f40 65 78 74 72 61 20 77 6f 72 6b 20 74 6f 20 6a 6f extra work to jo
34f50 75 72 6e 61 6c 20 61 20 0a 20 20 20 20 20 20 20 urnal a .
34f60 20 2a 2a 20 70 61 67 65 20 74 68 61 74 20 64 6f ** page that do
34f70 65 73 20 6e 6f 74 20 6e 65 65 64 20 74 6f 20 62 es not need to b
34f80 65 20 6a 6f 75 72 6e 61 6c 65 64 2e 20 20 4e 65 e journaled. Ne
34f90 76 65 72 74 68 65 6c 65 73 73 2c 20 62 65 20 73 vertheless, be s
34fa0 75 72 65 20 0a 20 20 20 20 20 20 20 20 2a 2a 20 ure . **
34fb0 74 6f 20 74 65 73 74 20 74 68 65 20 63 61 73 65 to test the case
34fc0 20 77 68 65 72 65 20 61 20 6d 61 6c 6c 6f 63 20 where a malloc
34fd0 65 72 72 6f 72 20 6f 63 63 75 72 73 20 77 68 69 error occurs whi
34fe0 6c 65 20 74 72 79 69 6e 67 20 74 6f 20 73 65 74 le trying to set
34ff0 20 0a 20 20 20 20 20 20 20 20 2a 2a 20 61 20 62 . ** a b
35000 69 74 20 69 6e 20 61 20 62 69 74 20 76 65 63 74 it in a bit vect
35010 6f 72 2e 0a 20 20 20 20 20 20 20 20 2a 2f 0a 20 or.. */.
35020 20 20 20 20 20 20 20 73 71 6c 69 74 65 33 42 65 sqlite3Be
35030 67 69 6e 42 65 6e 69 67 6e 4d 61 6c 6c 6f 63 28 ginBenignMalloc(
35040 29 3b 0a 20 20 20 20 20 20 20 20 69 66 28 20 70 );. if( p
35050 67 6e 6f 3c 3d 70 50 61 67 65 72 2d 3e 64 62 4f gno<=pPager->dbO
35060 72 69 67 53 69 7a 65 20 29 7b 0a 20 20 20 20 20 rigSize ){.
35070 20 20 20 20 20 54 45 53 54 4f 4e 4c 59 28 20 72 TESTONLY( r
35080 63 20 3d 20 29 20 73 71 6c 69 74 65 33 42 69 74 c = ) sqlite3Bit
35090 76 65 63 53 65 74 28 70 50 61 67 65 72 2d 3e 70 vecSet(pPager->p
350a0 49 6e 4a 6f 75 72 6e 61 6c 2c 20 70 67 6e 6f 29 InJournal, pgno)
350b0 3b 0a 20 20 20 20 20 20 20 20 20 20 74 65 73 74 ;. test
350c0 63 61 73 65 28 20 72 63 3d 3d 53 51 4c 49 54 45 case( rc==SQLITE
350d0 5f 4e 4f 4d 45 4d 20 29 3b 0a 20 20 20 20 20 20 _NOMEM );.
350e0 20 20 7d 0a 20 20 20 20 20 20 20 20 54 45 53 54 }. TEST
350f0 4f 4e 4c 59 28 20 72 63 20 3d 20 29 20 61 64 64 ONLY( rc = ) add
35100 54 6f 53 61 76 65 70 6f 69 6e 74 42 69 74 76 65 ToSavepointBitve
35110 63 73 28 70 50 61 67 65 72 2c 20 70 67 6e 6f 29 cs(pPager, pgno)
35120 3b 0a 20 20 20 20 20 20 20 20 74 65 73 74 63 61 ;. testca
35130 73 65 28 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4e se( rc==SQLITE_N
35140 4f 4d 45 4d 20 29 3b 0a 20 20 20 20 20 20 20 20 OMEM );.
35150 73 71 6c 69 74 65 33 45 6e 64 42 65 6e 69 67 6e sqlite3EndBenign
35160 4d 61 6c 6c 6f 63 28 29 3b 0a 20 20 20 20 20 20 Malloc();.
35170 7d 0a 20 20 20 20 20 20 6d 65 6d 73 65 74 28 70 }. memset(p
35180 50 67 2d 3e 70 44 61 74 61 2c 20 30 2c 20 70 50 Pg->pData, 0, pP
35190 61 67 65 72 2d 3e 70 61 67 65 53 69 7a 65 29 3b ager->pageSize);
351a0 0a 20 20 20 20 20 20 49 4f 54 52 41 43 45 28 28 . IOTRACE((
351b0 22 5a 45 52 4f 20 25 70 20 25 64 5c 6e 22 2c 20 "ZERO %p %d\n",
351c0 70 50 61 67 65 72 2c 20 70 67 6e 6f 29 29 3b 0a pPager, pgno));.
351d0 20 20 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 20 }else{.
351e0 20 69 66 28 20 70 61 67 65 72 55 73 65 57 61 6c if( pagerUseWal
351f0 28 70 50 61 67 65 72 29 20 26 26 20 62 4d 6d 61 (pPager) && bMma
35200 70 4f 6b 3d 3d 30 20 29 7b 0a 20 20 20 20 20 20 pOk==0 ){.
35210 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33 57 61 rc = sqlite3Wa
35220 6c 46 69 6e 64 46 72 61 6d 65 28 70 50 61 67 65 lFindFrame(pPage
35230 72 2d 3e 70 57 61 6c 2c 20 70 67 6e 6f 2c 20 26 r->pWal, pgno, &
35240 69 46 72 61 6d 65 29 3b 0a 20 20 20 20 20 20 20 iFrame);.
35250 20 69 66 28 20 72 63 21 3d 53 51 4c 49 54 45 5f if( rc!=SQLITE_
35260 4f 4b 20 29 20 67 6f 74 6f 20 70 61 67 65 72 5f OK ) goto pager_
35270 61 63 71 75 69 72 65 5f 65 72 72 3b 0a 20 20 20 acquire_err;.
35280 20 20 20 7d 0a 20 20 20 20 20 20 61 73 73 65 72 }. asser
35290 74 28 20 70 50 67 2d 3e 70 50 61 67 65 72 3d 3d t( pPg->pPager==
352a0 70 50 61 67 65 72 20 29 3b 0a 20 20 20 20 20 20 pPager );.
352b0 70 50 61 67 65 72 2d 3e 61 53 74 61 74 5b 50 41 pPager->aStat[PA
352c0 47 45 52 5f 53 54 41 54 5f 4d 49 53 53 5d 2b 2b GER_STAT_MISS]++
352d0 3b 0a 20 20 20 20 20 20 72 63 20 3d 20 72 65 61 ;. rc = rea
352e0 64 44 62 50 61 67 65 28 70 50 67 2c 20 69 46 72 dDbPage(pPg, iFr
352f0 61 6d 65 29 3b 0a 20 20 20 20 20 20 69 66 28 20 ame);. if(
35300 72 63 21 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b rc!=SQLITE_OK ){
35310 0a 20 20 20 20 20 20 20 20 67 6f 74 6f 20 70 61 . goto pa
35320 67 65 72 5f 61 63 71 75 69 72 65 5f 65 72 72 3b ger_acquire_err;
35330 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 7d 0a 20 . }. }.
35340 20 20 20 70 61 67 65 72 5f 73 65 74 5f 70 61 67 pager_set_pag
35350 65 68 61 73 68 28 70 50 67 29 3b 0a 20 20 7d 0a ehash(pPg);. }.
35360 0a 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 . return SQLITE
35370 5f 4f 4b 3b 0a 0a 70 61 67 65 72 5f 61 63 71 75 _OK;..pager_acqu
35380 69 72 65 5f 65 72 72 3a 0a 20 20 61 73 73 65 72 ire_err:. asser
35390 74 28 20 72 63 21 3d 53 51 4c 49 54 45 5f 4f 4b t( rc!=SQLITE_OK
353a0 20 29 3b 0a 20 20 69 66 28 20 70 50 67 20 29 7b );. if( pPg ){
353b0 0a 20 20 20 20 73 71 6c 69 74 65 33 50 63 61 63 . sqlite3Pcac
353c0 68 65 44 72 6f 70 28 70 50 67 29 3b 0a 20 20 7d heDrop(pPg);. }
353d0 0a 20 20 70 61 67 65 72 55 6e 6c 6f 63 6b 49 66 . pagerUnlockIf
353e0 55 6e 75 73 65 64 28 70 50 61 67 65 72 29 3b 0a Unused(pPager);.
353f0 0a 20 20 2a 70 70 50 61 67 65 20 3d 20 30 3b 0a . *ppPage = 0;.
35400 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 7d 0a 0a return rc;.}..
35410 2f 2a 0a 2a 2a 20 41 63 71 75 69 72 65 20 61 20 /*.** Acquire a
35420 70 61 67 65 20 69 66 20 69 74 20 69 73 20 61 6c page if it is al
35430 72 65 61 64 79 20 69 6e 20 74 68 65 20 69 6e 2d ready in the in-
35440 6d 65 6d 6f 72 79 20 63 61 63 68 65 2e 20 20 44 memory cache. D
35450 6f 0a 2a 2a 20 6e 6f 74 20 72 65 61 64 20 74 68 o.** not read th
35460 65 20 70 61 67 65 20 66 72 6f 6d 20 64 69 73 6b e page from disk
35470 2e 20 20 52 65 74 75 72 6e 20 61 20 70 6f 69 6e . Return a poin
35480 74 65 72 20 74 6f 20 74 68 65 20 70 61 67 65 2c ter to the page,
35490 0a 2a 2a 20 6f 72 20 30 20 69 66 20 74 68 65 20 .** or 0 if the
354a0 70 61 67 65 20 69 73 20 6e 6f 74 20 69 6e 20 63 page is not in c
354b0 61 63 68 65 2e 20 0a 2a 2a 0a 2a 2a 20 53 65 65 ache. .**.** See
354c0 20 61 6c 73 6f 20 73 71 6c 69 74 65 33 50 61 67 also sqlite3Pag
354d0 65 72 47 65 74 28 29 2e 20 20 54 68 65 20 64 69 erGet(). The di
354e0 66 66 65 72 65 6e 63 65 20 62 65 74 77 65 65 6e fference between
354f0 20 74 68 69 73 20 72 6f 75 74 69 6e 65 0a 2a 2a this routine.**
35500 20 61 6e 64 20 73 71 6c 69 74 65 33 50 61 67 65 and sqlite3Page
35510 72 47 65 74 28 29 20 69 73 20 74 68 61 74 20 5f rGet() is that _
35520 67 65 74 28 29 20 77 69 6c 6c 20 67 6f 20 74 6f get() will go to
35530 20 74 68 65 20 64 69 73 6b 20 61 6e 64 20 72 65 the disk and re
35540 61 64 0a 2a 2a 20 69 6e 20 74 68 65 20 70 61 67 ad.** in the pag
35550 65 20 69 66 20 74 68 65 20 70 61 67 65 20 69 73 e if the page is
35560 20 6e 6f 74 20 61 6c 72 65 61 64 79 20 69 6e 20 not already in
35570 63 61 63 68 65 2e 20 20 54 68 69 73 20 72 6f 75 cache. This rou
35580 74 69 6e 65 0a 2a 2a 20 72 65 74 75 72 6e 73 20 tine.** returns
35590 4e 55 4c 4c 20 69 66 20 74 68 65 20 70 61 67 65 NULL if the page
355a0 20 69 73 20 6e 6f 74 20 69 6e 20 63 61 63 68 65 is not in cache
355b0 20 6f 72 20 69 66 20 61 20 64 69 73 6b 20 49 2f or if a disk I/
355c0 4f 20 65 72 72 6f 72 20 0a 2a 2a 20 68 61 73 20 O error .** has
355d0 65 76 65 72 20 68 61 70 70 65 6e 65 64 2e 0a 2a ever happened..*
355e0 2f 0a 44 62 50 61 67 65 20 2a 73 71 6c 69 74 65 /.DbPage *sqlite
355f0 33 50 61 67 65 72 4c 6f 6f 6b 75 70 28 50 61 67 3PagerLookup(Pag
35600 65 72 20 2a 70 50 61 67 65 72 2c 20 50 67 6e 6f er *pPager, Pgno
35610 20 70 67 6e 6f 29 7b 0a 20 20 73 71 6c 69 74 65 pgno){. sqlite
35620 33 5f 70 63 61 63 68 65 5f 70 61 67 65 20 2a 70 3_pcache_page *p
35630 50 61 67 65 3b 0a 20 20 61 73 73 65 72 74 28 20 Page;. assert(
35640 70 50 61 67 65 72 21 3d 30 20 29 3b 0a 20 20 61 pPager!=0 );. a
35650 73 73 65 72 74 28 20 70 67 6e 6f 21 3d 30 20 29 ssert( pgno!=0 )
35660 3b 0a 20 20 61 73 73 65 72 74 28 20 70 50 61 67 ;. assert( pPag
35670 65 72 2d 3e 70 50 43 61 63 68 65 21 3d 30 20 29 er->pPCache!=0 )
35680 3b 0a 20 20 70 50 61 67 65 20 3d 20 73 71 6c 69 ;. pPage = sqli
35690 74 65 33 50 63 61 63 68 65 46 65 74 63 68 28 70 te3PcacheFetch(p
356a0 50 61 67 65 72 2d 3e 70 50 43 61 63 68 65 2c 20 Pager->pPCache,
356b0 70 67 6e 6f 2c 20 30 29 3b 0a 20 20 61 73 73 65 pgno, 0);. asse
356c0 72 74 28 20 70 50 61 67 65 3d 3d 30 20 7c 7c 20 rt( pPage==0 ||
356d0 70 50 61 67 65 72 2d 3e 68 61 73 48 65 6c 64 53 pPager->hasHeldS
356e0 68 61 72 65 64 4c 6f 63 6b 20 29 3b 0a 20 20 69 haredLock );. i
356f0 66 28 20 70 50 61 67 65 3d 3d 30 20 29 20 72 65 f( pPage==0 ) re
35700 74 75 72 6e 20 30 3b 0a 20 20 72 65 74 75 72 6e turn 0;. return
35710 20 73 71 6c 69 74 65 33 50 63 61 63 68 65 46 65 sqlite3PcacheFe
35720 74 63 68 46 69 6e 69 73 68 28 70 50 61 67 65 72 tchFinish(pPager
35730 2d 3e 70 50 43 61 63 68 65 2c 20 70 67 6e 6f 2c ->pPCache, pgno,
35740 20 70 50 61 67 65 29 3b 0a 7d 0a 0a 2f 2a 0a 2a pPage);.}../*.*
35750 2a 20 52 65 6c 65 61 73 65 20 61 20 70 61 67 65 * Release a page
35760 20 72 65 66 65 72 65 6e 63 65 2e 0a 2a 2a 0a 2a reference..**.*
35770 2a 20 49 66 20 74 68 65 20 6e 75 6d 62 65 72 20 * If the number
35780 6f 66 20 72 65 66 65 72 65 6e 63 65 73 20 74 6f of references to
35790 20 74 68 65 20 70 61 67 65 20 64 72 6f 70 20 74 the page drop t
357a0 6f 20 7a 65 72 6f 2c 20 74 68 65 6e 20 74 68 65 o zero, then the
357b0 0a 2a 2a 20 70 61 67 65 20 69 73 20 61 64 64 65 .** page is adde
357c0 64 20 74 6f 20 74 68 65 20 4c 52 55 20 6c 69 73 d to the LRU lis
357d0 74 2e 20 20 57 68 65 6e 20 61 6c 6c 20 72 65 66 t. When all ref
357e0 65 72 65 6e 63 65 73 20 74 6f 20 61 6c 6c 20 70 erences to all p
357f0 61 67 65 73 0a 2a 2a 20 61 72 65 20 72 65 6c 65 ages.** are rele
35800 61 73 65 64 2c 20 61 20 72 6f 6c 6c 62 61 63 6b ased, a rollback
35810 20 6f 63 63 75 72 73 20 61 6e 64 20 74 68 65 20 occurs and the
35820 6c 6f 63 6b 20 6f 6e 20 74 68 65 20 64 61 74 61 lock on the data
35830 62 61 73 65 20 69 73 0a 2a 2a 20 72 65 6d 6f 76 base is.** remov
35840 65 64 2e 0a 2a 2f 0a 76 6f 69 64 20 73 71 6c 69 ed..*/.void sqli
35850 74 65 33 50 61 67 65 72 55 6e 72 65 66 4e 6f 74 te3PagerUnrefNot
35860 4e 75 6c 6c 28 44 62 50 61 67 65 20 2a 70 50 67 Null(DbPage *pPg
35870 29 7b 0a 20 20 50 61 67 65 72 20 2a 70 50 61 67 ){. Pager *pPag
35880 65 72 3b 0a 20 20 61 73 73 65 72 74 28 20 70 50 er;. assert( pP
35890 67 21 3d 30 20 29 3b 0a 20 20 70 50 61 67 65 72 g!=0 );. pPager
358a0 20 3d 20 70 50 67 2d 3e 70 50 61 67 65 72 3b 0a = pPg->pPager;.
358b0 20 20 69 66 28 20 70 50 67 2d 3e 66 6c 61 67 73 if( pPg->flags
358c0 20 26 20 50 47 48 44 52 5f 4d 4d 41 50 20 29 7b & PGHDR_MMAP ){
358d0 0a 20 20 20 20 70 61 67 65 72 52 65 6c 65 61 73 . pagerReleas
358e0 65 4d 61 70 50 61 67 65 28 70 50 67 29 3b 0a 20 eMapPage(pPg);.
358f0 20 7d 65 6c 73 65 7b 0a 20 20 20 20 73 71 6c 69 }else{. sqli
35900 74 65 33 50 63 61 63 68 65 52 65 6c 65 61 73 65 te3PcacheRelease
35910 28 70 50 67 29 3b 0a 20 20 7d 0a 20 20 70 61 67 (pPg);. }. pag
35920 65 72 55 6e 6c 6f 63 6b 49 66 55 6e 75 73 65 64 erUnlockIfUnused
35930 28 70 50 61 67 65 72 29 3b 0a 7d 0a 76 6f 69 64 (pPager);.}.void
35940 20 73 71 6c 69 74 65 33 50 61 67 65 72 55 6e 72 sqlite3PagerUnr
35950 65 66 28 44 62 50 61 67 65 20 2a 70 50 67 29 7b ef(DbPage *pPg){
35960 0a 20 20 69 66 28 20 70 50 67 20 29 20 73 71 6c . if( pPg ) sql
35970 69 74 65 33 50 61 67 65 72 55 6e 72 65 66 4e 6f ite3PagerUnrefNo
35980 74 4e 75 6c 6c 28 70 50 67 29 3b 0a 7d 0a 0a 2f tNull(pPg);.}../
35990 2a 0a 2a 2a 20 54 68 69 73 20 66 75 6e 63 74 69 *.** This functi
359a0 6f 6e 20 69 73 20 63 61 6c 6c 65 64 20 61 74 20 on is called at
359b0 74 68 65 20 73 74 61 72 74 20 6f 66 20 65 76 65 the start of eve
359c0 72 79 20 77 72 69 74 65 20 74 72 61 6e 73 61 63 ry write transac
359d0 74 69 6f 6e 2e 0a 2a 2a 20 54 68 65 72 65 20 6d tion..** There m
359e0 75 73 74 20 61 6c 72 65 61 64 79 20 62 65 20 61 ust already be a
359f0 20 52 45 53 45 52 56 45 44 20 6f 72 20 45 58 43 RESERVED or EXC
35a00 4c 55 53 49 56 45 20 6c 6f 63 6b 20 6f 6e 20 74 LUSIVE lock on t
35a10 68 65 20 64 61 74 61 62 61 73 65 20 0a 2a 2a 20 he database .**
35a20 66 69 6c 65 20 77 68 65 6e 20 74 68 69 73 20 72 file when this r
35a30 6f 75 74 69 6e 65 20 69 73 20 63 61 6c 6c 65 64 outine is called
35a40 2e 0a 2a 2a 0a 2a 2a 20 4f 70 65 6e 20 74 68 65 ..**.** Open the
35a50 20 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 20 66 6f journal file fo
35a60 72 20 70 61 67 65 72 20 70 50 61 67 65 72 20 61 r pager pPager a
35a70 6e 64 20 77 72 69 74 65 20 61 20 6a 6f 75 72 6e nd write a journ
35a80 61 6c 20 68 65 61 64 65 72 0a 2a 2a 20 74 6f 20 al header.** to
35a90 74 68 65 20 73 74 61 72 74 20 6f 66 20 69 74 2e the start of it.
35aa0 20 49 66 20 74 68 65 72 65 20 61 72 65 20 61 63 If there are ac
35ab0 74 69 76 65 20 73 61 76 65 70 6f 69 6e 74 73 2c tive savepoints,
35ac0 20 6f 70 65 6e 20 74 68 65 20 73 75 62 2d 6a 6f open the sub-jo
35ad0 75 72 6e 61 6c 0a 2a 2a 20 61 73 20 77 65 6c 6c urnal.** as well
35ae0 2e 20 54 68 69 73 20 66 75 6e 63 74 69 6f 6e 20 . This function
35af0 69 73 20 6f 6e 6c 79 20 75 73 65 64 20 77 68 65 is only used whe
35b00 6e 20 74 68 65 20 6a 6f 75 72 6e 61 6c 20 66 69 n the journal fi
35b10 6c 65 20 69 73 20 62 65 69 6e 67 20 0a 2a 2a 20 le is being .**
35b20 6f 70 65 6e 65 64 20 74 6f 20 77 72 69 74 65 20 opened to write
35b30 61 20 72 6f 6c 6c 62 61 63 6b 20 6c 6f 67 20 66 a rollback log f
35b40 6f 72 20 61 20 74 72 61 6e 73 61 63 74 69 6f 6e or a transaction
35b50 2e 20 49 74 20 69 73 20 6e 6f 74 20 75 73 65 64 . It is not used
35b60 20 0a 2a 2a 20 77 68 65 6e 20 6f 70 65 6e 69 6e .** when openin
35b70 67 20 61 20 68 6f 74 20 6a 6f 75 72 6e 61 6c 20 g a hot journal
35b80 66 69 6c 65 20 74 6f 20 72 6f 6c 6c 20 69 74 20 file to roll it
35b90 62 61 63 6b 2e 0a 2a 2a 0a 2a 2a 20 49 66 20 74 back..**.** If t
35ba0 68 65 20 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 20 he journal file
35bb0 69 73 20 61 6c 72 65 61 64 79 20 6f 70 65 6e 20 is already open
35bc0 28 61 73 20 69 74 20 6d 61 79 20 62 65 20 69 6e (as it may be in
35bd0 20 65 78 63 6c 75 73 69 76 65 20 6d 6f 64 65 29 exclusive mode)
35be0 2c 0a 2a 2a 20 74 68 65 6e 20 74 68 69 73 20 66 ,.** then this f
35bf0 75 6e 63 74 69 6f 6e 20 6a 75 73 74 20 77 72 69 unction just wri
35c00 74 65 73 20 61 20 6a 6f 75 72 6e 61 6c 20 68 65 tes a journal he
35c10 61 64 65 72 20 74 6f 20 74 68 65 20 73 74 61 72 ader to the star
35c20 74 20 6f 66 20 74 68 65 0a 2a 2a 20 61 6c 72 65 t of the.** alre
35c30 61 64 79 20 6f 70 65 6e 20 66 69 6c 65 2e 20 0a ady open file. .
35c40 2a 2a 0a 2a 2a 20 57 68 65 74 68 65 72 20 6f 72 **.** Whether or
35c50 20 6e 6f 74 20 74 68 65 20 6a 6f 75 72 6e 61 6c not the journal
35c60 20 66 69 6c 65 20 69 73 20 6f 70 65 6e 65 64 20 file is opened
35c70 62 79 20 74 68 69 73 20 66 75 6e 63 74 69 6f 6e by this function
35c80 2c 20 74 68 65 0a 2a 2a 20 50 61 67 65 72 2e 70 , the.** Pager.p
35c90 49 6e 4a 6f 75 72 6e 61 6c 20 62 69 74 76 65 63 InJournal bitvec
35ca0 20 73 74 72 75 63 74 75 72 65 20 69 73 20 61 6c structure is al
35cb0 6c 6f 63 61 74 65 64 2e 0a 2a 2a 0a 2a 2a 20 52 located..**.** R
35cc0 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 20 eturn SQLITE_OK
35cd0 69 66 20 65 76 65 72 79 74 68 69 6e 67 20 69 73 if everything is
35ce0 20 73 75 63 63 65 73 73 66 75 6c 2e 20 4f 74 68 successful. Oth
35cf0 65 72 77 69 73 65 2c 20 72 65 74 75 72 6e 20 0a erwise, return .
35d00 2a 2a 20 53 51 4c 49 54 45 5f 4e 4f 4d 45 4d 20 ** SQLITE_NOMEM
35d10 69 66 20 74 68 65 20 61 74 74 65 6d 70 74 20 74 if the attempt t
35d20 6f 20 61 6c 6c 6f 63 61 74 65 20 50 61 67 65 72 o allocate Pager
35d30 2e 70 49 6e 4a 6f 75 72 6e 61 6c 20 66 61 69 6c .pInJournal fail
35d40 73 2c 20 6f 72 20 0a 2a 2a 20 61 6e 20 49 4f 20 s, or .** an IO
35d50 65 72 72 6f 72 20 63 6f 64 65 20 69 66 20 6f 70 error code if op
35d60 65 6e 69 6e 67 20 6f 72 20 77 72 69 74 69 6e 67 ening or writing
35d70 20 74 68 65 20 6a 6f 75 72 6e 61 6c 20 66 69 6c the journal fil
35d80 65 20 66 61 69 6c 73 2e 0a 2a 2f 0a 73 74 61 74 e fails..*/.stat
35d90 69 63 20 69 6e 74 20 70 61 67 65 72 5f 6f 70 65 ic int pager_ope
35da0 6e 5f 6a 6f 75 72 6e 61 6c 28 50 61 67 65 72 20 n_journal(Pager
35db0 2a 70 50 61 67 65 72 29 7b 0a 20 20 69 6e 74 20 *pPager){. int
35dc0 72 63 20 3d 20 53 51 4c 49 54 45 5f 4f 4b 3b 20 rc = SQLITE_OK;
35dd0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
35de0 20 20 20 20 20 20 20 2f 2a 20 52 65 74 75 72 6e /* Return
35df0 20 63 6f 64 65 20 2a 2f 0a 20 20 73 71 6c 69 74 code */. sqlit
35e00 65 33 5f 76 66 73 20 2a 20 63 6f 6e 73 74 20 70 e3_vfs * const p
35e10 56 66 73 20 3d 20 70 50 61 67 65 72 2d 3e 70 56 Vfs = pPager->pV
35e20 66 73 3b 20 20 20 2f 2a 20 4c 6f 63 61 6c 20 63 fs; /* Local c
35e30 61 63 68 65 20 6f 66 20 76 66 73 20 70 6f 69 6e ache of vfs poin
35e40 74 65 72 20 2a 2f 0a 0a 20 20 61 73 73 65 72 74 ter */.. assert
35e50 28 20 70 50 61 67 65 72 2d 3e 65 53 74 61 74 65 ( pPager->eState
35e60 3d 3d 50 41 47 45 52 5f 57 52 49 54 45 52 5f 4c ==PAGER_WRITER_L
35e70 4f 43 4b 45 44 20 29 3b 0a 20 20 61 73 73 65 72 OCKED );. asser
35e80 74 28 20 61 73 73 65 72 74 5f 70 61 67 65 72 5f t( assert_pager_
35e90 73 74 61 74 65 28 70 50 61 67 65 72 29 20 29 3b state(pPager) );
35ea0 0a 20 20 61 73 73 65 72 74 28 20 70 50 61 67 65 . assert( pPage
35eb0 72 2d 3e 70 49 6e 4a 6f 75 72 6e 61 6c 3d 3d 30 r->pInJournal==0
35ec0 20 29 3b 0a 20 20 0a 20 20 2f 2a 20 49 66 20 61 );. . /* If a
35ed0 6c 72 65 61 64 79 20 69 6e 20 74 68 65 20 65 72 lready in the er
35ee0 72 6f 72 20 73 74 61 74 65 2c 20 74 68 69 73 20 ror state, this
35ef0 66 75 6e 63 74 69 6f 6e 20 69 73 20 61 20 6e 6f function is a no
35f00 2d 6f 70 2e 20 20 42 75 74 20 6f 6e 0a 20 20 2a -op. But on. *
35f10 2a 20 74 68 65 20 6f 74 68 65 72 20 68 61 6e 64 * the other hand
35f20 2c 20 74 68 69 73 20 72 6f 75 74 69 6e 65 20 69 , this routine i
35f30 73 20 6e 65 76 65 72 20 63 61 6c 6c 65 64 20 69 s never called i
35f40 66 20 77 65 20 61 72 65 20 61 6c 72 65 61 64 79 f we are already
35f50 20 69 6e 0a 20 20 2a 2a 20 61 6e 20 65 72 72 6f in. ** an erro
35f60 72 20 73 74 61 74 65 2e 20 2a 2f 0a 20 20 69 66 r state. */. if
35f70 28 20 4e 45 56 45 52 28 70 50 61 67 65 72 2d 3e ( NEVER(pPager->
35f80 65 72 72 43 6f 64 65 29 20 29 20 72 65 74 75 72 errCode) ) retur
35f90 6e 20 70 50 61 67 65 72 2d 3e 65 72 72 43 6f 64 n pPager->errCod
35fa0 65 3b 0a 0a 20 20 69 66 28 20 21 70 61 67 65 72 e;.. if( !pager
35fb0 55 73 65 57 61 6c 28 70 50 61 67 65 72 29 20 26 UseWal(pPager) &
35fc0 26 20 70 50 61 67 65 72 2d 3e 6a 6f 75 72 6e 61 & pPager->journa
35fd0 6c 4d 6f 64 65 21 3d 50 41 47 45 52 5f 4a 4f 55 lMode!=PAGER_JOU
35fe0 52 4e 41 4c 4d 4f 44 45 5f 4f 46 46 20 29 7b 0a RNALMODE_OFF ){.
35ff0 20 20 20 20 70 50 61 67 65 72 2d 3e 70 49 6e 4a pPager->pInJ
36000 6f 75 72 6e 61 6c 20 3d 20 73 71 6c 69 74 65 33 ournal = sqlite3
36010 42 69 74 76 65 63 43 72 65 61 74 65 28 70 50 61 BitvecCreate(pPa
36020 67 65 72 2d 3e 64 62 53 69 7a 65 29 3b 0a 20 20 ger->dbSize);.
36030 20 20 69 66 28 20 70 50 61 67 65 72 2d 3e 70 49 if( pPager->pI
36040 6e 4a 6f 75 72 6e 61 6c 3d 3d 30 20 29 7b 0a 20 nJournal==0 ){.
36050 20 20 20 20 20 72 65 74 75 72 6e 20 53 51 4c 49 return SQLI
36060 54 45 5f 4e 4f 4d 45 4d 5f 42 4b 50 54 3b 0a 20 TE_NOMEM_BKPT;.
36070 20 20 20 7d 0a 20 20 0a 20 20 20 20 2f 2a 20 4f }. . /* O
36080 70 65 6e 20 74 68 65 20 6a 6f 75 72 6e 61 6c 20 pen the journal
36090 66 69 6c 65 20 69 66 20 69 74 20 69 73 20 6e 6f file if it is no
360a0 74 20 61 6c 72 65 61 64 79 20 6f 70 65 6e 2e 20 t already open.
360b0 2a 2f 0a 20 20 20 20 69 66 28 20 21 69 73 4f 70 */. if( !isOp
360c0 65 6e 28 70 50 61 67 65 72 2d 3e 6a 66 64 29 20 en(pPager->jfd)
360d0 29 7b 0a 20 20 20 20 20 20 69 66 28 20 70 50 61 ){. if( pPa
360e0 67 65 72 2d 3e 6a 6f 75 72 6e 61 6c 4d 6f 64 65 ger->journalMode
360f0 3d 3d 50 41 47 45 52 5f 4a 4f 55 52 4e 41 4c 4d ==PAGER_JOURNALM
36100 4f 44 45 5f 4d 45 4d 4f 52 59 20 29 7b 0a 20 20 ODE_MEMORY ){.
36110 20 20 20 20 20 20 73 71 6c 69 74 65 33 4d 65 6d sqlite3Mem
36120 4a 6f 75 72 6e 61 6c 4f 70 65 6e 28 70 50 61 67 JournalOpen(pPag
36130 65 72 2d 3e 6a 66 64 29 3b 0a 20 20 20 20 20 20 er->jfd);.
36140 7d 65 6c 73 65 7b 0a 20 20 20 20 20 20 20 20 69 }else{. i
36150 6e 74 20 66 6c 61 67 73 20 3d 20 53 51 4c 49 54 nt flags = SQLIT
36160 45 5f 4f 50 45 4e 5f 52 45 41 44 57 52 49 54 45 E_OPEN_READWRITE
36170 7c 53 51 4c 49 54 45 5f 4f 50 45 4e 5f 43 52 45 |SQLITE_OPEN_CRE
36180 41 54 45 3b 0a 20 20 20 20 20 20 20 20 69 6e 74 ATE;. int
36190 20 6e 53 70 69 6c 6c 3b 0a 0a 20 20 20 20 20 20 nSpill;..
361a0 20 20 69 66 28 20 70 50 61 67 65 72 2d 3e 74 65 if( pPager->te
361b0 6d 70 46 69 6c 65 20 29 7b 0a 20 20 20 20 20 20 mpFile ){.
361c0 20 20 20 20 66 6c 61 67 73 20 7c 3d 20 28 53 51 flags |= (SQ
361d0 4c 49 54 45 5f 4f 50 45 4e 5f 44 45 4c 45 54 45 LITE_OPEN_DELETE
361e0 4f 4e 43 4c 4f 53 45 7c 53 51 4c 49 54 45 5f 4f ONCLOSE|SQLITE_O
361f0 50 45 4e 5f 54 45 4d 50 5f 4a 4f 55 52 4e 41 4c PEN_TEMP_JOURNAL
36200 29 3b 0a 20 20 20 20 20 20 20 20 20 20 6e 53 70 );. nSp
36210 69 6c 6c 20 3d 20 73 71 6c 69 74 65 33 43 6f 6e ill = sqlite3Con
36220 66 69 67 2e 6e 53 74 6d 74 53 70 69 6c 6c 3b 0a fig.nStmtSpill;.
36230 20 20 20 20 20 20 20 20 7d 65 6c 73 65 7b 0a 20 }else{.
36240 20 20 20 20 20 20 20 20 20 66 6c 61 67 73 20 7c flags |
36250 3d 20 53 51 4c 49 54 45 5f 4f 50 45 4e 5f 4d 41 = SQLITE_OPEN_MA
36260 49 4e 5f 4a 4f 55 52 4e 41 4c 3b 0a 20 20 20 20 IN_JOURNAL;.
36270 20 20 20 20 20 20 6e 53 70 69 6c 6c 20 3d 20 6a nSpill = j
36280 72 6e 6c 42 75 66 66 65 72 53 69 7a 65 28 70 50 rnlBufferSize(pP
36290 61 67 65 72 29 3b 0a 20 20 20 20 20 20 20 20 7d ager);. }
362a0 0a 20 20 20 20 20 20 20 20 20 20 0a 20 20 20 20 . .
362b0 20 20 20 20 2f 2a 20 56 65 72 69 66 79 20 74 68 /* Verify th
362c0 61 74 20 74 68 65 20 64 61 74 61 62 61 73 65 20 at the database
362d0 73 74 69 6c 6c 20 68 61 73 20 74 68 65 20 73 61 still has the sa
362e0 6d 65 20 6e 61 6d 65 20 61 73 20 69 74 20 64 69 me name as it di
362f0 64 20 77 68 65 6e 0a 20 20 20 20 20 20 20 20 2a d when. *
36300 2a 20 69 74 20 77 61 73 20 6f 72 69 67 69 6e 61 * it was origina
36310 6c 6c 79 20 6f 70 65 6e 65 64 2e 20 2a 2f 0a 20 lly opened. */.
36320 20 20 20 20 20 20 20 72 63 20 3d 20 64 61 74 61 rc = data
36330 62 61 73 65 49 73 55 6e 6d 6f 76 65 64 28 70 50 baseIsUnmoved(pP
36340 61 67 65 72 29 3b 0a 20 20 20 20 20 20 20 20 69 ager);. i
36350 66 28 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b f( rc==SQLITE_OK
36360 20 29 7b 0a 20 20 20 20 20 20 20 20 20 20 72 63 ){. rc
36370 20 3d 20 73 71 6c 69 74 65 33 4a 6f 75 72 6e 61 = sqlite3Journa
36380 6c 4f 70 65 6e 20 28 0a 20 20 20 20 20 20 20 20 lOpen (.
36390 20 20 20 20 20 20 70 56 66 73 2c 20 70 50 61 67 pVfs, pPag
363a0 65 72 2d 3e 7a 4a 6f 75 72 6e 61 6c 2c 20 70 50 er->zJournal, pP
363b0 61 67 65 72 2d 3e 6a 66 64 2c 20 66 6c 61 67 73 ager->jfd, flags
363c0 2c 20 6e 53 70 69 6c 6c 0a 20 20 20 20 20 20 20 , nSpill.
363d0 20 20 20 29 3b 0a 20 20 20 20 20 20 20 20 7d 0a );. }.
363e0 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 61 73 }. as
363f0 73 65 72 74 28 20 72 63 21 3d 53 51 4c 49 54 45 sert( rc!=SQLITE
36400 5f 4f 4b 20 7c 7c 20 69 73 4f 70 65 6e 28 70 50 _OK || isOpen(pP
36410 61 67 65 72 2d 3e 6a 66 64 29 20 29 3b 0a 20 20 ager->jfd) );.
36420 20 20 7d 0a 20 20 0a 20 20 0a 20 20 20 20 2f 2a }. . . /*
36430 20 57 72 69 74 65 20 74 68 65 20 66 69 72 73 74 Write the first
36440 20 6a 6f 75 72 6e 61 6c 20 68 65 61 64 65 72 20 journal header
36450 74 6f 20 74 68 65 20 6a 6f 75 72 6e 61 6c 20 66 to the journal f
36460 69 6c 65 20 61 6e 64 20 6f 70 65 6e 20 0a 20 20 ile and open .
36470 20 20 2a 2a 20 74 68 65 20 73 75 62 2d 6a 6f 75 ** the sub-jou
36480 72 6e 61 6c 20 69 66 20 6e 65 63 65 73 73 61 72 rnal if necessar
36490 79 2e 0a 20 20 20 20 2a 2f 0a 20 20 20 20 69 66 y.. */. if
364a0 28 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 ( rc==SQLITE_OK
364b0 29 7b 0a 20 20 20 20 20 20 2f 2a 20 54 4f 44 4f ){. /* TODO
364c0 3a 20 43 68 65 63 6b 20 69 66 20 61 6c 6c 20 6f : Check if all o
364d0 66 20 74 68 65 73 65 20 61 72 65 20 72 65 61 6c f these are real
364e0 6c 79 20 72 65 71 75 69 72 65 64 2e 20 2a 2f 0a ly required. */.
364f0 20 20 20 20 20 20 70 50 61 67 65 72 2d 3e 6e 52 pPager->nR
36500 65 63 20 3d 20 30 3b 0a 20 20 20 20 20 20 70 50 ec = 0;. pP
36510 61 67 65 72 2d 3e 6a 6f 75 72 6e 61 6c 4f 66 66 ager->journalOff
36520 20 3d 20 30 3b 0a 20 20 20 20 20 20 70 50 61 67 = 0;. pPag
36530 65 72 2d 3e 73 65 74 4d 61 73 74 65 72 20 3d 20 er->setMaster =
36540 30 3b 0a 20 20 20 20 20 20 70 50 61 67 65 72 2d 0;. pPager-
36550 3e 6a 6f 75 72 6e 61 6c 48 64 72 20 3d 20 30 3b >journalHdr = 0;
36560 0a 20 20 20 20 20 20 72 63 20 3d 20 77 72 69 74 . rc = writ
36570 65 4a 6f 75 72 6e 61 6c 48 64 72 28 70 50 61 67 eJournalHdr(pPag
36580 65 72 29 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a 0a er);. }. }..
36590 20 20 69 66 28 20 72 63 21 3d 53 51 4c 49 54 45 if( rc!=SQLITE
365a0 5f 4f 4b 20 29 7b 0a 20 20 20 20 73 71 6c 69 74 _OK ){. sqlit
365b0 65 33 42 69 74 76 65 63 44 65 73 74 72 6f 79 28 e3BitvecDestroy(
365c0 70 50 61 67 65 72 2d 3e 70 49 6e 4a 6f 75 72 6e pPager->pInJourn
365d0 61 6c 29 3b 0a 20 20 20 20 70 50 61 67 65 72 2d al);. pPager-
365e0 3e 70 49 6e 4a 6f 75 72 6e 61 6c 20 3d 20 30 3b >pInJournal = 0;
365f0 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 61 73 . }else{. as
36600 73 65 72 74 28 20 70 50 61 67 65 72 2d 3e 65 53 sert( pPager->eS
36610 74 61 74 65 3d 3d 50 41 47 45 52 5f 57 52 49 54 tate==PAGER_WRIT
36620 45 52 5f 4c 4f 43 4b 45 44 20 29 3b 0a 20 20 20 ER_LOCKED );.
36630 20 70 50 61 67 65 72 2d 3e 65 53 74 61 74 65 20 pPager->eState
36640 3d 20 50 41 47 45 52 5f 57 52 49 54 45 52 5f 43 = PAGER_WRITER_C
36650 41 43 48 45 4d 4f 44 3b 0a 20 20 7d 0a 0a 20 20 ACHEMOD;. }..
36660 72 65 74 75 72 6e 20 72 63 3b 0a 7d 0a 0a 2f 2a return rc;.}../*
36670 0a 2a 2a 20 42 65 67 69 6e 20 61 20 77 72 69 74 .** Begin a writ
36680 65 2d 74 72 61 6e 73 61 63 74 69 6f 6e 20 6f 6e e-transaction on
36690 20 74 68 65 20 73 70 65 63 69 66 69 65 64 20 70 the specified p
366a0 61 67 65 72 20 6f 62 6a 65 63 74 2e 20 49 66 20 ager object. If
366b0 61 20 0a 2a 2a 20 77 72 69 74 65 2d 74 72 61 6e a .** write-tran
366c0 73 61 63 74 69 6f 6e 20 68 61 73 20 61 6c 72 65 saction has alre
366d0 61 64 79 20 62 65 65 6e 20 6f 70 65 6e 65 64 2c ady been opened,
366e0 20 74 68 69 73 20 66 75 6e 63 74 69 6f 6e 20 69 this function i
366f0 73 20 61 20 6e 6f 2d 6f 70 2e 0a 2a 2a 0a 2a 2a s a no-op..**.**
36700 20 49 66 20 74 68 65 20 65 78 46 6c 61 67 20 61 If the exFlag a
36710 72 67 75 6d 65 6e 74 20 69 73 20 66 61 6c 73 65 rgument is false
36720 2c 20 74 68 65 6e 20 61 63 71 75 69 72 65 20 61 , then acquire a
36730 74 20 6c 65 61 73 74 20 61 20 52 45 53 45 52 56 t least a RESERV
36740 45 44 0a 2a 2a 20 6c 6f 63 6b 20 6f 6e 20 74 68 ED.** lock on th
36750 65 20 64 61 74 61 62 61 73 65 20 66 69 6c 65 2e e database file.
36760 20 49 66 20 65 78 46 6c 61 67 20 69 73 20 74 72 If exFlag is tr
36770 75 65 2c 20 74 68 65 6e 20 61 63 71 75 69 72 65 ue, then acquire
36780 20 61 74 20 6c 65 61 73 74 0a 2a 2a 20 61 6e 20 at least.** an
36790 45 58 43 4c 55 53 49 56 45 20 6c 6f 63 6b 2e 20 EXCLUSIVE lock.
367a0 49 66 20 73 75 63 68 20 61 20 6c 6f 63 6b 20 69 If such a lock i
367b0 73 20 61 6c 72 65 61 64 79 20 68 65 6c 64 2c 20 s already held,
367c0 6e 6f 20 6c 6f 63 6b 69 6e 67 20 0a 2a 2a 20 66 no locking .** f
367d0 75 6e 63 74 69 6f 6e 73 20 6e 65 65 64 20 62 65 unctions need be
367e0 20 63 61 6c 6c 65 64 2e 0a 2a 2a 0a 2a 2a 20 49 called..**.** I
367f0 66 20 74 68 65 20 73 75 62 6a 49 6e 4d 65 6d 6f f the subjInMemo
36800 72 79 20 61 72 67 75 6d 65 6e 74 20 69 73 20 6e ry argument is n
36810 6f 6e 2d 7a 65 72 6f 2c 20 74 68 65 6e 20 61 6e on-zero, then an
36820 79 20 73 75 62 2d 6a 6f 75 72 6e 61 6c 20 6f 70 y sub-journal op
36830 65 6e 65 64 0a 2a 2a 20 77 69 74 68 69 6e 20 74 ened.** within t
36840 68 69 73 20 74 72 61 6e 73 61 63 74 69 6f 6e 20 his transaction
36850 77 69 6c 6c 20 62 65 20 6f 70 65 6e 65 64 20 61 will be opened a
36860 73 20 61 6e 20 69 6e 2d 6d 65 6d 6f 72 79 20 66 s an in-memory f
36870 69 6c 65 2e 20 54 68 69 73 0a 2a 2a 20 68 61 73 ile. This.** has
36880 20 6e 6f 20 65 66 66 65 63 74 20 69 66 20 74 68 no effect if th
36890 65 20 73 75 62 2d 6a 6f 75 72 6e 61 6c 20 69 73 e sub-journal is
368a0 20 61 6c 72 65 61 64 79 20 6f 70 65 6e 65 64 20 already opened
368b0 28 61 73 20 69 74 20 6d 61 79 20 62 65 20 77 68 (as it may be wh
368c0 65 6e 0a 2a 2a 20 72 75 6e 6e 69 6e 67 20 69 6e en.** running in
368d0 20 65 78 63 6c 75 73 69 76 65 20 6d 6f 64 65 29 exclusive mode)
368e0 20 6f 72 20 69 66 20 74 68 65 20 74 72 61 6e 73 or if the trans
368f0 61 63 74 69 6f 6e 20 64 6f 65 73 20 6e 6f 74 20 action does not
36900 72 65 71 75 69 72 65 20 61 0a 2a 2a 20 73 75 62 require a.** sub
36910 2d 6a 6f 75 72 6e 61 6c 2e 20 49 66 20 74 68 65 -journal. If the
36920 20 73 75 62 6a 49 6e 4d 65 6d 6f 72 79 20 61 72 subjInMemory ar
36930 67 75 6d 65 6e 74 20 69 73 20 7a 65 72 6f 2c 20 gument is zero,
36940 74 68 65 6e 20 61 6e 79 20 72 65 71 75 69 72 65 then any require
36950 64 0a 2a 2a 20 73 75 62 2d 6a 6f 75 72 6e 61 6c d.** sub-journal
36960 20 69 73 20 69 6d 70 6c 65 6d 65 6e 74 65 64 20 is implemented
36970 69 6e 2d 6d 65 6d 6f 72 79 20 69 66 20 70 50 61 in-memory if pPa
36980 67 65 72 20 69 73 20 61 6e 20 69 6e 2d 6d 65 6d ger is an in-mem
36990 6f 72 79 20 64 61 74 61 62 61 73 65 2c 20 0a 2a ory database, .*
369a0 2a 20 6f 72 20 75 73 69 6e 67 20 61 20 74 65 6d * or using a tem
369b0 70 6f 72 61 72 79 20 66 69 6c 65 20 6f 74 68 65 porary file othe
369c0 72 77 69 73 65 2e 0a 2a 2f 0a 69 6e 74 20 73 71 rwise..*/.int sq
369d0 6c 69 74 65 33 50 61 67 65 72 42 65 67 69 6e 28 lite3PagerBegin(
369e0 50 61 67 65 72 20 2a 70 50 61 67 65 72 2c 20 69 Pager *pPager, i
369f0 6e 74 20 65 78 46 6c 61 67 2c 20 69 6e 74 20 73 nt exFlag, int s
36a00 75 62 6a 49 6e 4d 65 6d 6f 72 79 29 7b 0a 20 20 ubjInMemory){.
36a10 69 6e 74 20 72 63 20 3d 20 53 51 4c 49 54 45 5f int rc = SQLITE_
36a20 4f 4b 3b 0a 0a 20 20 69 66 28 20 70 50 61 67 65 OK;.. if( pPage
36a30 72 2d 3e 65 72 72 43 6f 64 65 20 29 20 72 65 74 r->errCode ) ret
36a40 75 72 6e 20 70 50 61 67 65 72 2d 3e 65 72 72 43 urn pPager->errC
36a50 6f 64 65 3b 0a 20 20 61 73 73 65 72 74 28 20 70 ode;. assert( p
36a60 50 61 67 65 72 2d 3e 65 53 74 61 74 65 3e 3d 50 Pager->eState>=P
36a70 41 47 45 52 5f 52 45 41 44 45 52 20 26 26 20 70 AGER_READER && p
36a80 50 61 67 65 72 2d 3e 65 53 74 61 74 65 3c 50 41 Pager->eState<PA
36a90 47 45 52 5f 45 52 52 4f 52 20 29 3b 0a 20 20 70 GER_ERROR );. p
36aa0 50 61 67 65 72 2d 3e 73 75 62 6a 49 6e 4d 65 6d Pager->subjInMem
36ab0 6f 72 79 20 3d 20 28 75 38 29 73 75 62 6a 49 6e ory = (u8)subjIn
36ac0 4d 65 6d 6f 72 79 3b 0a 0a 20 20 69 66 28 20 41 Memory;.. if( A
36ad0 4c 57 41 59 53 28 70 50 61 67 65 72 2d 3e 65 53 LWAYS(pPager->eS
36ae0 74 61 74 65 3d 3d 50 41 47 45 52 5f 52 45 41 44 tate==PAGER_READ
36af0 45 52 29 20 29 7b 0a 20 20 20 20 61 73 73 65 72 ER) ){. asser
36b00 74 28 20 70 50 61 67 65 72 2d 3e 70 49 6e 4a 6f t( pPager->pInJo
36b10 75 72 6e 61 6c 3d 3d 30 20 29 3b 0a 0a 20 20 20 urnal==0 );..
36b20 20 69 66 28 20 70 61 67 65 72 55 73 65 57 61 6c if( pagerUseWal
36b30 28 70 50 61 67 65 72 29 20 29 7b 0a 20 20 20 20 (pPager) ){.
36b40 20 20 2f 2a 20 49 66 20 74 68 65 20 70 61 67 65 /* If the page
36b50 72 20 69 73 20 63 6f 6e 66 69 67 75 72 65 64 20 r is configured
36b60 74 6f 20 75 73 65 20 6c 6f 63 6b 69 6e 67 5f 6d to use locking_m
36b70 6f 64 65 3d 65 78 63 6c 75 73 69 76 65 2c 20 61 ode=exclusive, a
36b80 6e 64 20 61 6e 0a 20 20 20 20 20 20 2a 2a 20 65 nd an. ** e
36b90 78 63 6c 75 73 69 76 65 20 6c 6f 63 6b 20 6f 6e xclusive lock on
36ba0 20 74 68 65 20 64 61 74 61 62 61 73 65 20 69 73 the database is
36bb0 20 6e 6f 74 20 61 6c 72 65 61 64 79 20 68 65 6c not already hel
36bc0 64 2c 20 6f 62 74 61 69 6e 20 69 74 20 6e 6f 77 d, obtain it now
36bd0 2e 0a 20 20 20 20 20 20 2a 2f 0a 20 20 20 20 20 .. */.
36be0 20 69 66 28 20 70 50 61 67 65 72 2d 3e 65 78 63 if( pPager->exc
36bf0 6c 75 73 69 76 65 4d 6f 64 65 20 26 26 20 73 71 lusiveMode && sq
36c00 6c 69 74 65 33 57 61 6c 45 78 63 6c 75 73 69 76 lite3WalExclusiv
36c10 65 4d 6f 64 65 28 70 50 61 67 65 72 2d 3e 70 57 eMode(pPager->pW
36c20 61 6c 2c 20 2d 31 29 20 29 7b 0a 20 20 20 20 20 al, -1) ){.
36c30 20 20 20 72 63 20 3d 20 70 61 67 65 72 4c 6f 63 rc = pagerLoc
36c40 6b 44 62 28 70 50 61 67 65 72 2c 20 45 58 43 4c kDb(pPager, EXCL
36c50 55 53 49 56 45 5f 4c 4f 43 4b 29 3b 0a 20 20 20 USIVE_LOCK);.
36c60 20 20 20 20 20 69 66 28 20 72 63 21 3d 53 51 4c if( rc!=SQL
36c70 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 20 20 ITE_OK ){.
36c80 20 20 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 20 return rc;.
36c90 20 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 20 }.
36ca0 20 28 76 6f 69 64 29 73 71 6c 69 74 65 33 57 61 (void)sqlite3Wa
36cb0 6c 45 78 63 6c 75 73 69 76 65 4d 6f 64 65 28 70 lExclusiveMode(p
36cc0 50 61 67 65 72 2d 3e 70 57 61 6c 2c 20 31 29 3b Pager->pWal, 1);
36cd0 0a 20 20 20 20 20 20 7d 0a 0a 20 20 20 20 20 20 . }..
36ce0 2f 2a 20 47 72 61 62 20 74 68 65 20 77 72 69 74 /* Grab the writ
36cf0 65 20 6c 6f 63 6b 20 6f 6e 20 74 68 65 20 6c 6f e lock on the lo
36d00 67 20 66 69 6c 65 2e 20 49 66 20 73 75 63 63 65 g file. If succe
36d10 73 73 66 75 6c 2c 20 75 70 67 72 61 64 65 20 74 ssful, upgrade t
36d20 6f 0a 20 20 20 20 20 20 2a 2a 20 50 41 47 45 52 o. ** PAGER
36d30 5f 52 45 53 45 52 56 45 44 20 73 74 61 74 65 2e _RESERVED state.
36d40 20 4f 74 68 65 72 77 69 73 65 2c 20 72 65 74 75 Otherwise, retu
36d50 72 6e 20 61 6e 20 65 72 72 6f 72 20 63 6f 64 65 rn an error code
36d60 20 74 6f 20 74 68 65 20 63 61 6c 6c 65 72 2e 0a to the caller..
36d70 20 20 20 20 20 20 2a 2a 20 54 68 65 20 62 75 73 ** The bus
36d80 79 2d 68 61 6e 64 6c 65 72 20 69 73 20 6e 6f 74 y-handler is not
36d90 20 69 6e 76 6f 6b 65 64 20 69 66 20 61 6e 6f 74 invoked if anot
36da0 68 65 72 20 63 6f 6e 6e 65 63 74 69 6f 6e 20 61 her connection a
36db0 6c 72 65 61 64 79 0a 20 20 20 20 20 20 2a 2a 20 lready. **
36dc0 68 6f 6c 64 73 20 74 68 65 20 77 72 69 74 65 2d holds the write-
36dd0 6c 6f 63 6b 2e 20 49 66 20 70 6f 73 73 69 62 6c lock. If possibl
36de0 65 2c 20 74 68 65 20 75 70 70 65 72 20 6c 61 79 e, the upper lay
36df0 65 72 20 77 69 6c 6c 20 63 61 6c 6c 20 69 74 2e er will call it.
36e00 0a 20 20 20 20 20 20 2a 2f 0a 20 20 20 20 20 20 . */.
36e10 72 63 20 3d 20 73 71 6c 69 74 65 33 57 61 6c 42 rc = sqlite3WalB
36e20 65 67 69 6e 57 72 69 74 65 54 72 61 6e 73 61 63 eginWriteTransac
36e30 74 69 6f 6e 28 70 50 61 67 65 72 2d 3e 70 57 61 tion(pPager->pWa
36e40 6c 29 3b 0a 20 20 20 20 7d 65 6c 73 65 7b 0a 20 l);. }else{.
36e50 20 20 20 20 20 2f 2a 20 4f 62 74 61 69 6e 20 61 /* Obtain a
36e60 20 52 45 53 45 52 56 45 44 20 6c 6f 63 6b 20 6f RESERVED lock o
36e70 6e 20 74 68 65 20 64 61 74 61 62 61 73 65 20 66 n the database f
36e80 69 6c 65 2e 20 49 66 20 74 68 65 20 65 78 46 6c ile. If the exFl
36e90 61 67 20 70 61 72 61 6d 65 74 65 72 0a 20 20 20 ag parameter.
36ea0 20 20 20 2a 2a 20 69 73 20 74 72 75 65 2c 20 74 ** is true, t
36eb0 68 65 6e 20 69 6d 6d 65 64 69 61 74 65 6c 79 20 hen immediately
36ec0 75 70 67 72 61 64 65 20 74 68 69 73 20 74 6f 20 upgrade this to
36ed0 61 6e 20 45 58 43 4c 55 53 49 56 45 20 6c 6f 63 an EXCLUSIVE loc
36ee0 6b 2e 20 54 68 65 0a 20 20 20 20 20 20 2a 2a 20 k. The. **
36ef0 62 75 73 79 2d 68 61 6e 64 6c 65 72 20 63 61 6c busy-handler cal
36f00 6c 62 61 63 6b 20 63 61 6e 20 62 65 20 75 73 65 lback can be use
36f10 64 20 77 68 65 6e 20 75 70 67 72 61 64 69 6e 67 d when upgrading
36f20 20 74 6f 20 74 68 65 20 45 58 43 4c 55 53 49 56 to the EXCLUSIV
36f30 45 0a 20 20 20 20 20 20 2a 2a 20 6c 6f 63 6b 2c E. ** lock,
36f40 20 62 75 74 20 6e 6f 74 20 77 68 65 6e 20 6f 62 but not when ob
36f50 74 61 69 6e 69 6e 67 20 74 68 65 20 52 45 53 45 taining the RESE
36f60 52 56 45 44 20 6c 6f 63 6b 2e 0a 20 20 20 20 20 RVED lock..
36f70 20 2a 2f 0a 20 20 20 20 20 20 72 63 20 3d 20 70 */. rc = p
36f80 61 67 65 72 4c 6f 63 6b 44 62 28 70 50 61 67 65 agerLockDb(pPage
36f90 72 2c 20 52 45 53 45 52 56 45 44 5f 4c 4f 43 4b r, RESERVED_LOCK
36fa0 29 3b 0a 20 20 20 20 20 20 69 66 28 20 72 63 3d );. if( rc=
36fb0 3d 53 51 4c 49 54 45 5f 4f 4b 20 26 26 20 65 78 =SQLITE_OK && ex
36fc0 46 6c 61 67 20 29 7b 0a 20 20 20 20 20 20 20 20 Flag ){.
36fd0 72 63 20 3d 20 70 61 67 65 72 5f 77 61 69 74 5f rc = pager_wait_
36fe0 6f 6e 5f 6c 6f 63 6b 28 70 50 61 67 65 72 2c 20 on_lock(pPager,
36ff0 45 58 43 4c 55 53 49 56 45 5f 4c 4f 43 4b 29 3b EXCLUSIVE_LOCK);
37000 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 7d 0a 0a . }. }..
37010 20 20 20 20 69 66 28 20 72 63 3d 3d 53 51 4c 49 if( rc==SQLI
37020 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 20 20 2f TE_OK ){. /
37030 2a 20 43 68 61 6e 67 65 20 74 6f 20 57 52 49 54 * Change to WRIT
37040 45 52 5f 4c 4f 43 4b 45 44 20 73 74 61 74 65 2e ER_LOCKED state.
37050 0a 20 20 20 20 20 20 2a 2a 0a 20 20 20 20 20 20 . **.
37060 2a 2a 20 57 41 4c 20 6d 6f 64 65 20 73 65 74 73 ** WAL mode sets
37070 20 50 61 67 65 72 2e 65 53 74 61 74 65 20 74 6f Pager.eState to
37080 20 50 41 47 45 52 5f 57 52 49 54 45 52 5f 4c 4f PAGER_WRITER_LO
37090 43 4b 45 44 20 6f 72 20 43 41 43 48 45 4d 4f 44 CKED or CACHEMOD
370a0 0a 20 20 20 20 20 20 2a 2a 20 77 68 65 6e 20 69 . ** when i
370b0 74 20 68 61 73 20 61 6e 20 6f 70 65 6e 20 74 72 t has an open tr
370c0 61 6e 73 61 63 74 69 6f 6e 2c 20 62 75 74 20 6e ansaction, but n
370d0 65 76 65 72 20 74 6f 20 44 42 4d 4f 44 20 6f 72 ever to DBMOD or
370e0 20 46 49 4e 49 53 48 45 44 2e 0a 20 20 20 20 20 FINISHED..
370f0 20 2a 2a 20 54 68 69 73 20 69 73 20 62 65 63 61 ** This is beca
37100 75 73 65 20 69 6e 20 74 68 6f 73 65 20 73 74 61 use in those sta
37110 74 65 73 20 74 68 65 20 63 6f 64 65 20 74 6f 20 tes the code to
37120 72 6f 6c 6c 20 62 61 63 6b 20 73 61 76 65 70 6f roll back savepo
37130 69 6e 74 20 0a 20 20 20 20 20 20 2a 2a 20 74 72 int . ** tr
37140 61 6e 73 61 63 74 69 6f 6e 73 20 6d 61 79 20 63 ansactions may c
37150 6f 70 79 20 64 61 74 61 20 66 72 6f 6d 20 74 68 opy data from th
37160 65 20 73 75 62 2d 6a 6f 75 72 6e 61 6c 20 69 6e e sub-journal in
37170 74 6f 20 74 68 65 20 64 61 74 61 62 61 73 65 20 to the database
37180 0a 20 20 20 20 20 20 2a 2a 20 66 69 6c 65 20 61 . ** file a
37190 73 20 77 65 6c 6c 20 61 73 20 69 6e 74 6f 20 74 s well as into t
371a0 68 65 20 70 61 67 65 20 63 61 63 68 65 2e 20 57 he page cache. W
371b0 68 69 63 68 20 77 6f 75 6c 64 20 62 65 20 69 6e hich would be in
371c0 63 6f 72 72 65 63 74 20 69 6e 20 0a 20 20 20 20 correct in .
371d0 20 20 2a 2a 20 57 41 4c 20 6d 6f 64 65 2e 0a 20 ** WAL mode..
371e0 20 20 20 20 20 2a 2f 0a 20 20 20 20 20 20 70 50 */. pP
371f0 61 67 65 72 2d 3e 65 53 74 61 74 65 20 3d 20 50 ager->eState = P
37200 41 47 45 52 5f 57 52 49 54 45 52 5f 4c 4f 43 4b AGER_WRITER_LOCK
37210 45 44 3b 0a 20 20 20 20 20 20 70 50 61 67 65 72 ED;. pPager
37220 2d 3e 64 62 48 69 6e 74 53 69 7a 65 20 3d 20 70 ->dbHintSize = p
37230 50 61 67 65 72 2d 3e 64 62 53 69 7a 65 3b 0a 20 Pager->dbSize;.
37240 20 20 20 20 20 70 50 61 67 65 72 2d 3e 64 62 46 pPager->dbF
37250 69 6c 65 53 69 7a 65 20 3d 20 70 50 61 67 65 72 ileSize = pPager
37260 2d 3e 64 62 53 69 7a 65 3b 0a 20 20 20 20 20 20 ->dbSize;.
37270 70 50 61 67 65 72 2d 3e 64 62 4f 72 69 67 53 69 pPager->dbOrigSi
37280 7a 65 20 3d 20 70 50 61 67 65 72 2d 3e 64 62 53 ze = pPager->dbS
37290 69 7a 65 3b 0a 20 20 20 20 20 20 70 50 61 67 65 ize;. pPage
372a0 72 2d 3e 6a 6f 75 72 6e 61 6c 4f 66 66 20 3d 20 r->journalOff =
372b0 30 3b 0a 20 20 20 20 7d 0a 0a 20 20 20 20 61 73 0;. }.. as
372c0 73 65 72 74 28 20 72 63 3d 3d 53 51 4c 49 54 45 sert( rc==SQLITE
372d0 5f 4f 4b 20 7c 7c 20 70 50 61 67 65 72 2d 3e 65 _OK || pPager->e
372e0 53 74 61 74 65 3d 3d 50 41 47 45 52 5f 52 45 41 State==PAGER_REA
372f0 44 45 52 20 29 3b 0a 20 20 20 20 61 73 73 65 72 DER );. asser
37300 74 28 20 72 63 21 3d 53 51 4c 49 54 45 5f 4f 4b t( rc!=SQLITE_OK
37310 20 7c 7c 20 70 50 61 67 65 72 2d 3e 65 53 74 61 || pPager->eSta
37320 74 65 3d 3d 50 41 47 45 52 5f 57 52 49 54 45 52 te==PAGER_WRITER
37330 5f 4c 4f 43 4b 45 44 20 29 3b 0a 20 20 20 20 61 _LOCKED );. a
37340 73 73 65 72 74 28 20 61 73 73 65 72 74 5f 70 61 ssert( assert_pa
37350 67 65 72 5f 73 74 61 74 65 28 70 50 61 67 65 72 ger_state(pPager
37360 29 20 29 3b 0a 20 20 7d 0a 0a 20 20 50 41 47 45 ) );. }.. PAGE
37370 52 54 52 41 43 45 28 28 22 54 52 41 4e 53 41 43 RTRACE(("TRANSAC
37380 54 49 4f 4e 20 25 64 5c 6e 22 2c 20 50 41 47 45 TION %d\n", PAGE
37390 52 49 44 28 70 50 61 67 65 72 29 29 29 3b 0a 20 RID(pPager)));.
373a0 20 72 65 74 75 72 6e 20 72 63 3b 0a 7d 0a 0a 2f return rc;.}../
373b0 2a 0a 2a 2a 20 57 72 69 74 65 20 70 61 67 65 20 *.** Write page
373c0 70 50 67 20 6f 6e 74 6f 20 74 68 65 20 65 6e 64 pPg onto the end
373d0 20 6f 66 20 74 68 65 20 72 6f 6c 6c 62 61 63 6b of the rollback
373e0 20 6a 6f 75 72 6e 61 6c 2e 0a 2a 2f 0a 73 74 61 journal..*/.sta
373f0 74 69 63 20 53 51 4c 49 54 45 5f 4e 4f 49 4e 4c tic SQLITE_NOINL
37400 49 4e 45 20 69 6e 74 20 70 61 67 65 72 41 64 64 INE int pagerAdd
37410 50 61 67 65 54 6f 52 6f 6c 6c 62 61 63 6b 4a 6f PageToRollbackJo
37420 75 72 6e 61 6c 28 50 67 48 64 72 20 2a 70 50 67 urnal(PgHdr *pPg
37430 29 7b 0a 20 20 50 61 67 65 72 20 2a 70 50 61 67 ){. Pager *pPag
37440 65 72 20 3d 20 70 50 67 2d 3e 70 50 61 67 65 72 er = pPg->pPager
37450 3b 0a 20 20 69 6e 74 20 72 63 3b 0a 20 20 75 33 ;. int rc;. u3
37460 32 20 63 6b 73 75 6d 3b 0a 20 20 63 68 61 72 20 2 cksum;. char
37470 2a 70 44 61 74 61 32 3b 0a 20 20 69 36 34 20 69 *pData2;. i64 i
37480 4f 66 66 20 3d 20 70 50 61 67 65 72 2d 3e 6a 6f Off = pPager->jo
37490 75 72 6e 61 6c 4f 66 66 3b 0a 0a 20 20 2f 2a 20 urnalOff;.. /*
374a0 57 65 20 73 68 6f 75 6c 64 20 6e 65 76 65 72 20 We should never
374b0 77 72 69 74 65 20 74 6f 20 74 68 65 20 6a 6f 75 write to the jou
374c0 72 6e 61 6c 20 66 69 6c 65 20 74 68 65 20 70 61 rnal file the pa
374d0 67 65 20 74 68 61 74 0a 20 20 2a 2a 20 63 6f 6e ge that. ** con
374e0 74 61 69 6e 73 20 74 68 65 20 64 61 74 61 62 61 tains the databa
374f0 73 65 20 6c 6f 63 6b 73 2e 20 20 54 68 65 20 66 se locks. The f
37500 6f 6c 6c 6f 77 69 6e 67 20 61 73 73 65 72 74 20 ollowing assert
37510 76 65 72 69 66 69 65 73 0a 20 20 2a 2a 20 74 68 verifies. ** th
37520 61 74 20 77 65 20 64 6f 20 6e 6f 74 2e 20 2a 2f at we do not. */
37530 0a 20 20 61 73 73 65 72 74 28 20 70 50 67 2d 3e . assert( pPg->
37540 70 67 6e 6f 21 3d 50 41 47 45 52 5f 4d 4a 5f 50 pgno!=PAGER_MJ_P
37550 47 4e 4f 28 70 50 61 67 65 72 29 20 29 3b 0a 0a GNO(pPager) );..
37560 20 20 61 73 73 65 72 74 28 20 70 50 61 67 65 72 assert( pPager
37570 2d 3e 6a 6f 75 72 6e 61 6c 48 64 72 3c 3d 70 50 ->journalHdr<=pP
37580 61 67 65 72 2d 3e 6a 6f 75 72 6e 61 6c 4f 66 66 ager->journalOff
37590 20 29 3b 0a 20 20 43 4f 44 45 43 32 28 70 50 61 );. CODEC2(pPa
375a0 67 65 72 2c 20 70 50 67 2d 3e 70 44 61 74 61 2c ger, pPg->pData,
375b0 20 70 50 67 2d 3e 70 67 6e 6f 2c 20 37 2c 20 72 pPg->pgno, 7, r
375c0 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4e 4f 4d eturn SQLITE_NOM
375d0 45 4d 5f 42 4b 50 54 2c 20 70 44 61 74 61 32 29 EM_BKPT, pData2)
375e0 3b 0a 20 20 63 6b 73 75 6d 20 3d 20 70 61 67 65 ;. cksum = page
375f0 72 5f 63 6b 73 75 6d 28 70 50 61 67 65 72 2c 20 r_cksum(pPager,
37600 28 75 38 2a 29 70 44 61 74 61 32 29 3b 0a 0a 20 (u8*)pData2);..
37610 20 2f 2a 20 45 76 65 6e 20 69 66 20 61 6e 20 49 /* Even if an I
37620 4f 20 6f 72 20 64 69 73 6b 66 75 6c 6c 20 65 72 O or diskfull er
37630 72 6f 72 20 6f 63 63 75 72 73 20 77 68 69 6c 65 ror occurs while
37640 20 6a 6f 75 72 6e 61 6c 6c 69 6e 67 20 74 68 65 journalling the
37650 0a 20 20 2a 2a 20 70 61 67 65 20 69 6e 20 74 68 . ** page in th
37660 65 20 62 6c 6f 63 6b 20 61 62 6f 76 65 2c 20 73 e block above, s
37670 65 74 20 74 68 65 20 6e 65 65 64 2d 73 79 6e 63 et the need-sync
37680 20 66 6c 61 67 20 66 6f 72 20 74 68 65 20 70 61 flag for the pa
37690 67 65 2e 0a 20 20 2a 2a 20 4f 74 68 65 72 77 69 ge.. ** Otherwi
376a0 73 65 2c 20 77 68 65 6e 20 74 68 65 20 74 72 61 se, when the tra
376b0 6e 73 61 63 74 69 6f 6e 20 69 73 20 72 6f 6c 6c nsaction is roll
376c0 65 64 20 62 61 63 6b 2c 20 74 68 65 20 6c 6f 67 ed back, the log
376d0 69 63 20 69 6e 0a 20 20 2a 2a 20 70 6c 61 79 62 ic in. ** playb
376e0 61 63 6b 5f 6f 6e 65 5f 70 61 67 65 28 29 20 77 ack_one_page() w
376f0 69 6c 6c 20 74 68 69 6e 6b 20 74 68 61 74 20 74 ill think that t
37700 68 65 20 70 61 67 65 20 6e 65 65 64 73 20 74 6f he page needs to
37710 20 62 65 20 72 65 73 74 6f 72 65 64 0a 20 20 2a be restored. *
37720 2a 20 69 6e 20 74 68 65 20 64 61 74 61 62 61 73 * in the databas
37730 65 20 66 69 6c 65 2e 20 41 6e 64 20 69 66 20 61 e file. And if a
37740 6e 20 49 4f 20 65 72 72 6f 72 20 6f 63 63 75 72 n IO error occur
37750 73 20 77 68 69 6c 65 20 64 6f 69 6e 67 20 73 6f s while doing so
37760 2c 0a 20 20 2a 2a 20 74 68 65 6e 20 63 6f 72 72 ,. ** then corr
37770 75 70 74 69 6f 6e 20 6d 61 79 20 66 6f 6c 6c 6f uption may follo
37780 77 2e 0a 20 20 2a 2f 0a 20 20 70 50 67 2d 3e 66 w.. */. pPg->f
37790 6c 61 67 73 20 7c 3d 20 50 47 48 44 52 5f 4e 45 lags |= PGHDR_NE
377a0 45 44 5f 53 59 4e 43 3b 0a 0a 20 20 72 63 20 3d ED_SYNC;.. rc =
377b0 20 77 72 69 74 65 33 32 62 69 74 73 28 70 50 61 write32bits(pPa
377c0 67 65 72 2d 3e 6a 66 64 2c 20 69 4f 66 66 2c 20 ger->jfd, iOff,
377d0 70 50 67 2d 3e 70 67 6e 6f 29 3b 0a 20 20 69 66 pPg->pgno);. if
377e0 28 20 72 63 21 3d 53 51 4c 49 54 45 5f 4f 4b 20 ( rc!=SQLITE_OK
377f0 29 20 72 65 74 75 72 6e 20 72 63 3b 0a 20 20 72 ) return rc;. r
37800 63 20 3d 20 73 71 6c 69 74 65 33 4f 73 57 72 69 c = sqlite3OsWri
37810 74 65 28 70 50 61 67 65 72 2d 3e 6a 66 64 2c 20 te(pPager->jfd,
37820 70 44 61 74 61 32 2c 20 70 50 61 67 65 72 2d 3e pData2, pPager->
37830 70 61 67 65 53 69 7a 65 2c 20 69 4f 66 66 2b 34 pageSize, iOff+4
37840 29 3b 0a 20 20 69 66 28 20 72 63 21 3d 53 51 4c );. if( rc!=SQL
37850 49 54 45 5f 4f 4b 20 29 20 72 65 74 75 72 6e 20 ITE_OK ) return
37860 72 63 3b 0a 20 20 72 63 20 3d 20 77 72 69 74 65 rc;. rc = write
37870 33 32 62 69 74 73 28 70 50 61 67 65 72 2d 3e 6a 32bits(pPager->j
37880 66 64 2c 20 69 4f 66 66 2b 70 50 61 67 65 72 2d fd, iOff+pPager-
37890 3e 70 61 67 65 53 69 7a 65 2b 34 2c 20 63 6b 73 >pageSize+4, cks
378a0 75 6d 29 3b 0a 20 20 69 66 28 20 72 63 21 3d 53 um);. if( rc!=S
378b0 51 4c 49 54 45 5f 4f 4b 20 29 20 72 65 74 75 72 QLITE_OK ) retur
378c0 6e 20 72 63 3b 0a 0a 20 20 49 4f 54 52 41 43 45 n rc;.. IOTRACE
378d0 28 28 22 4a 4f 55 54 20 25 70 20 25 64 20 25 6c (("JOUT %p %d %l
378e0 6c 64 20 25 64 5c 6e 22 2c 20 70 50 61 67 65 72 ld %d\n", pPager
378f0 2c 20 70 50 67 2d 3e 70 67 6e 6f 2c 20 0a 20 20 , pPg->pgno, .
37900 20 20 20 20 20 20 20 20 20 70 50 61 67 65 72 2d pPager-
37910 3e 6a 6f 75 72 6e 61 6c 4f 66 66 2c 20 70 50 61 >journalOff, pPa
37920 67 65 72 2d 3e 70 61 67 65 53 69 7a 65 29 29 3b ger->pageSize));
37930 0a 20 20 50 41 47 45 52 5f 49 4e 43 52 28 73 71 . PAGER_INCR(sq
37940 6c 69 74 65 33 5f 70 61 67 65 72 5f 77 72 69 74 lite3_pager_writ
37950 65 6a 5f 63 6f 75 6e 74 29 3b 0a 20 20 50 41 47 ej_count);. PAG
37960 45 52 54 52 41 43 45 28 28 22 4a 4f 55 52 4e 41 ERTRACE(("JOURNA
37970 4c 20 25 64 20 70 61 67 65 20 25 64 20 6e 65 65 L %d page %d nee
37980 64 53 79 6e 63 3d 25 64 20 68 61 73 68 28 25 30 dSync=%d hash(%0
37990 38 78 29 5c 6e 22 2c 0a 20 20 20 20 20 20 20 50 8x)\n",. P
379a0 41 47 45 52 49 44 28 70 50 61 67 65 72 29 2c 20 AGERID(pPager),
379b0 70 50 67 2d 3e 70 67 6e 6f 2c 20 0a 20 20 20 20 pPg->pgno, .
379c0 20 20 20 28 28 70 50 67 2d 3e 66 6c 61 67 73 26 ((pPg->flags&
379d0 50 47 48 44 52 5f 4e 45 45 44 5f 53 59 4e 43 29 PGHDR_NEED_SYNC)
379e0 3f 31 3a 30 29 2c 20 70 61 67 65 72 5f 70 61 67 ?1:0), pager_pag
379f0 65 68 61 73 68 28 70 50 67 29 29 29 3b 0a 0a 20 ehash(pPg)));..
37a00 20 70 50 61 67 65 72 2d 3e 6a 6f 75 72 6e 61 6c pPager->journal
37a10 4f 66 66 20 2b 3d 20 38 20 2b 20 70 50 61 67 65 Off += 8 + pPage
37a20 72 2d 3e 70 61 67 65 53 69 7a 65 3b 0a 20 20 70 r->pageSize;. p
37a30 50 61 67 65 72 2d 3e 6e 52 65 63 2b 2b 3b 0a 20 Pager->nRec++;.
37a40 20 61 73 73 65 72 74 28 20 70 50 61 67 65 72 2d assert( pPager-
37a50 3e 70 49 6e 4a 6f 75 72 6e 61 6c 21 3d 30 20 29 >pInJournal!=0 )
37a60 3b 0a 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33 ;. rc = sqlite3
37a70 42 69 74 76 65 63 53 65 74 28 70 50 61 67 65 72 BitvecSet(pPager
37a80 2d 3e 70 49 6e 4a 6f 75 72 6e 61 6c 2c 20 70 50 ->pInJournal, pP
37a90 67 2d 3e 70 67 6e 6f 29 3b 0a 20 20 74 65 73 74 g->pgno);. test
37aa0 63 61 73 65 28 20 72 63 3d 3d 53 51 4c 49 54 45 case( rc==SQLITE
37ab0 5f 4e 4f 4d 45 4d 20 29 3b 0a 20 20 61 73 73 65 _NOMEM );. asse
37ac0 72 74 28 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4f rt( rc==SQLITE_O
37ad0 4b 20 7c 7c 20 72 63 3d 3d 53 51 4c 49 54 45 5f K || rc==SQLITE_
37ae0 4e 4f 4d 45 4d 20 29 3b 0a 20 20 72 63 20 7c 3d NOMEM );. rc |=
37af0 20 61 64 64 54 6f 53 61 76 65 70 6f 69 6e 74 42 addToSavepointB
37b00 69 74 76 65 63 73 28 70 50 61 67 65 72 2c 20 70 itvecs(pPager, p
37b10 50 67 2d 3e 70 67 6e 6f 29 3b 0a 20 20 61 73 73 Pg->pgno);. ass
37b20 65 72 74 28 20 72 63 3d 3d 53 51 4c 49 54 45 5f ert( rc==SQLITE_
37b30 4f 4b 20 7c 7c 20 72 63 3d 3d 53 51 4c 49 54 45 OK || rc==SQLITE
37b40 5f 4e 4f 4d 45 4d 20 29 3b 0a 20 20 72 65 74 75 _NOMEM );. retu
37b50 72 6e 20 72 63 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 rn rc;.}../*.**
37b60 4d 61 72 6b 20 61 20 73 69 6e 67 6c 65 20 64 61 Mark a single da
37b70 74 61 20 70 61 67 65 20 61 73 20 77 72 69 74 65 ta page as write
37b80 61 62 6c 65 2e 20 54 68 65 20 70 61 67 65 20 69 able. The page i
37b90 73 20 77 72 69 74 74 65 6e 20 69 6e 74 6f 20 74 s written into t
37ba0 68 65 20 0a 2a 2a 20 6d 61 69 6e 20 6a 6f 75 72 he .** main jour
37bb0 6e 61 6c 20 6f 72 20 73 75 62 2d 6a 6f 75 72 6e nal or sub-journ
37bc0 61 6c 20 61 73 20 72 65 71 75 69 72 65 64 2e 20 al as required.
37bd0 49 66 20 74 68 65 20 70 61 67 65 20 69 73 20 77 If the page is w
37be0 72 69 74 74 65 6e 20 69 6e 74 6f 0a 2a 2a 20 6f ritten into.** o
37bf0 6e 65 20 6f 66 20 74 68 65 20 6a 6f 75 72 6e 61 ne of the journa
37c00 6c 73 2c 20 74 68 65 20 63 6f 72 72 65 73 70 6f ls, the correspo
37c10 6e 64 69 6e 67 20 62 69 74 20 69 73 20 73 65 74 nding bit is set
37c20 20 69 6e 20 74 68 65 20 0a 2a 2a 20 50 61 67 65 in the .** Page
37c30 72 2e 70 49 6e 4a 6f 75 72 6e 61 6c 20 62 69 74 r.pInJournal bit
37c40 76 65 63 20 61 6e 64 20 74 68 65 20 50 61 67 65 vec and the Page
37c50 72 53 61 76 65 70 6f 69 6e 74 2e 70 49 6e 53 61 rSavepoint.pInSa
37c60 76 65 70 6f 69 6e 74 20 62 69 74 76 65 63 73 0a vepoint bitvecs.
37c70 2a 2a 20 6f 66 20 61 6e 79 20 6f 70 65 6e 20 73 ** of any open s
37c80 61 76 65 70 6f 69 6e 74 73 20 61 73 20 61 70 70 avepoints as app
37c90 72 6f 70 72 69 61 74 65 2e 0a 2a 2f 0a 73 74 61 ropriate..*/.sta
37ca0 74 69 63 20 69 6e 74 20 70 61 67 65 72 5f 77 72 tic int pager_wr
37cb0 69 74 65 28 50 67 48 64 72 20 2a 70 50 67 29 7b ite(PgHdr *pPg){
37cc0 0a 20 20 50 61 67 65 72 20 2a 70 50 61 67 65 72 . Pager *pPager
37cd0 20 3d 20 70 50 67 2d 3e 70 50 61 67 65 72 3b 0a = pPg->pPager;.
37ce0 20 20 69 6e 74 20 72 63 20 3d 20 53 51 4c 49 54 int rc = SQLIT
37cf0 45 5f 4f 4b 3b 0a 0a 20 20 2f 2a 20 54 68 69 73 E_OK;.. /* This
37d00 20 72 6f 75 74 69 6e 65 20 69 73 20 6e 6f 74 20 routine is not
37d10 63 61 6c 6c 65 64 20 75 6e 6c 65 73 73 20 61 20 called unless a
37d20 77 72 69 74 65 2d 74 72 61 6e 73 61 63 74 69 6f write-transactio
37d30 6e 20 68 61 73 20 61 6c 72 65 61 64 79 20 0a 20 n has already .
37d40 20 2a 2a 20 62 65 65 6e 20 73 74 61 72 74 65 64 ** been started
37d50 2e 20 54 68 65 20 6a 6f 75 72 6e 61 6c 20 66 69 . The journal fi
37d60 6c 65 20 6d 61 79 20 6f 72 20 6d 61 79 20 6e 6f le may or may no
37d70 74 20 62 65 20 6f 70 65 6e 20 61 74 20 74 68 69 t be open at thi
37d80 73 20 70 6f 69 6e 74 2e 0a 20 20 2a 2a 20 49 74 s point.. ** It
37d90 20 69 73 20 6e 65 76 65 72 20 63 61 6c 6c 65 64 is never called
37da0 20 69 6e 20 74 68 65 20 45 52 52 4f 52 20 73 74 in the ERROR st
37db0 61 74 65 2e 0a 20 20 2a 2f 0a 20 20 61 73 73 65 ate.. */. asse
37dc0 72 74 28 20 70 50 61 67 65 72 2d 3e 65 53 74 61 rt( pPager->eSta
37dd0 74 65 3d 3d 50 41 47 45 52 5f 57 52 49 54 45 52 te==PAGER_WRITER
37de0 5f 4c 4f 43 4b 45 44 0a 20 20 20 20 20 20 20 7c _LOCKED. |
37df0 7c 20 70 50 61 67 65 72 2d 3e 65 53 74 61 74 65 | pPager->eState
37e00 3d 3d 50 41 47 45 52 5f 57 52 49 54 45 52 5f 43 ==PAGER_WRITER_C
37e10 41 43 48 45 4d 4f 44 0a 20 20 20 20 20 20 20 7c ACHEMOD. |
37e20 7c 20 70 50 61 67 65 72 2d 3e 65 53 74 61 74 65 | pPager->eState
37e30 3d 3d 50 41 47 45 52 5f 57 52 49 54 45 52 5f 44 ==PAGER_WRITER_D
37e40 42 4d 4f 44 0a 20 20 29 3b 0a 20 20 61 73 73 65 BMOD. );. asse
37e50 72 74 28 20 61 73 73 65 72 74 5f 70 61 67 65 72 rt( assert_pager
37e60 5f 73 74 61 74 65 28 70 50 61 67 65 72 29 20 29 _state(pPager) )
37e70 3b 0a 20 20 61 73 73 65 72 74 28 20 70 50 61 67 ;. assert( pPag
37e80 65 72 2d 3e 65 72 72 43 6f 64 65 3d 3d 30 20 29 er->errCode==0 )
37e90 3b 0a 20 20 61 73 73 65 72 74 28 20 70 50 61 67 ;. assert( pPag
37ea0 65 72 2d 3e 72 65 61 64 4f 6e 6c 79 3d 3d 30 20 er->readOnly==0
37eb0 29 3b 0a 20 20 43 48 45 43 4b 5f 50 41 47 45 28 );. CHECK_PAGE(
37ec0 70 50 67 29 3b 0a 0a 20 20 2f 2a 20 54 68 65 20 pPg);.. /* The
37ed0 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 20 6e 65 65 journal file nee
37ee0 64 73 20 74 6f 20 62 65 20 6f 70 65 6e 65 64 2e ds to be opened.
37ef0 20 48 69 67 68 65 72 20 6c 65 76 65 6c 20 72 6f Higher level ro
37f00 75 74 69 6e 65 73 20 68 61 76 65 20 61 6c 72 65 utines have alre
37f10 61 64 79 0a 20 20 2a 2a 20 6f 62 74 61 69 6e 65 ady. ** obtaine
37f20 64 20 74 68 65 20 6e 65 63 65 73 73 61 72 79 20 d the necessary
37f30 6c 6f 63 6b 73 20 74 6f 20 62 65 67 69 6e 20 74 locks to begin t
37f40 68 65 20 77 72 69 74 65 2d 74 72 61 6e 73 61 63 he write-transac
37f50 74 69 6f 6e 2c 20 62 75 74 20 74 68 65 0a 20 20 tion, but the.
37f60 2a 2a 20 72 6f 6c 6c 62 61 63 6b 20 6a 6f 75 72 ** rollback jour
37f70 6e 61 6c 20 6d 69 67 68 74 20 6e 6f 74 20 79 65 nal might not ye
37f80 74 20 62 65 20 6f 70 65 6e 2e 20 4f 70 65 6e 20 t be open. Open
37f90 69 74 20 6e 6f 77 20 69 66 20 74 68 69 73 20 69 it now if this i
37fa0 73 20 74 68 65 20 63 61 73 65 2e 0a 20 20 2a 2a s the case.. **
37fb0 0a 20 20 2a 2a 20 54 68 69 73 20 69 73 20 64 6f . ** This is do
37fc0 6e 65 20 62 65 66 6f 72 65 20 63 61 6c 6c 69 6e ne before callin
37fd0 67 20 73 71 6c 69 74 65 33 50 63 61 63 68 65 4d g sqlite3PcacheM
37fe0 61 6b 65 44 69 72 74 79 28 29 20 6f 6e 20 74 68 akeDirty() on th
37ff0 65 20 70 61 67 65 2e 20 0a 20 20 2a 2a 20 4f 74 e page. . ** Ot
38000 68 65 72 77 69 73 65 2c 20 69 66 20 69 74 20 77 herwise, if it w
38010 65 72 65 20 64 6f 6e 65 20 61 66 74 65 72 20 63 ere done after c
38020 61 6c 6c 69 6e 67 20 73 71 6c 69 74 65 33 50 63 alling sqlite3Pc
38030 61 63 68 65 4d 61 6b 65 44 69 72 74 79 28 29 2c acheMakeDirty(),
38040 20 74 68 65 6e 0a 20 20 2a 2a 20 61 6e 20 65 72 then. ** an er
38050 72 6f 72 20 6d 69 67 68 74 20 6f 63 63 75 72 20 ror might occur
38060 61 6e 64 20 74 68 65 20 70 61 67 65 72 20 77 6f and the pager wo
38070 75 6c 64 20 65 6e 64 20 75 70 20 69 6e 20 57 52 uld end up in WR
38080 49 54 45 52 5f 4c 4f 43 4b 45 44 20 73 74 61 74 ITER_LOCKED stat
38090 65 0a 20 20 2a 2a 20 77 69 74 68 20 70 61 67 65 e. ** with page
380a0 73 20 6d 61 72 6b 65 64 20 61 73 20 64 69 72 74 s marked as dirt
380b0 79 20 69 6e 20 74 68 65 20 63 61 63 68 65 2e 0a y in the cache..
380c0 20 20 2a 2f 0a 20 20 69 66 28 20 70 50 61 67 65 */. if( pPage
380d0 72 2d 3e 65 53 74 61 74 65 3d 3d 50 41 47 45 52 r->eState==PAGER
380e0 5f 57 52 49 54 45 52 5f 4c 4f 43 4b 45 44 20 29 _WRITER_LOCKED )
380f0 7b 0a 20 20 20 20 72 63 20 3d 20 70 61 67 65 72 {. rc = pager
38100 5f 6f 70 65 6e 5f 6a 6f 75 72 6e 61 6c 28 70 50 _open_journal(pP
38110 61 67 65 72 29 3b 0a 20 20 20 20 69 66 28 20 72 ager);. if( r
38120 63 21 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 20 72 c!=SQLITE_OK ) r
38130 65 74 75 72 6e 20 72 63 3b 0a 20 20 7d 0a 20 20 eturn rc;. }.
38140 61 73 73 65 72 74 28 20 70 50 61 67 65 72 2d 3e assert( pPager->
38150 65 53 74 61 74 65 3e 3d 50 41 47 45 52 5f 57 52 eState>=PAGER_WR
38160 49 54 45 52 5f 43 41 43 48 45 4d 4f 44 20 29 3b ITER_CACHEMOD );
38170 0a 20 20 61 73 73 65 72 74 28 20 61 73 73 65 72 . assert( asser
38180 74 5f 70 61 67 65 72 5f 73 74 61 74 65 28 70 50 t_pager_state(pP
38190 61 67 65 72 29 20 29 3b 0a 0a 20 20 2f 2a 20 4d ager) );.. /* M
381a0 61 72 6b 20 74 68 65 20 70 61 67 65 20 74 68 61 ark the page tha
381b0 74 20 69 73 20 61 62 6f 75 74 20 74 6f 20 62 65 t is about to be
381c0 20 6d 6f 64 69 66 69 65 64 20 61 73 20 64 69 72 modified as dir
381d0 74 79 2e 20 2a 2f 0a 20 20 73 71 6c 69 74 65 33 ty. */. sqlite3
381e0 50 63 61 63 68 65 4d 61 6b 65 44 69 72 74 79 28 PcacheMakeDirty(
381f0 70 50 67 29 3b 0a 0a 20 20 2f 2a 20 49 66 20 61 pPg);.. /* If a
38200 20 72 6f 6c 6c 62 61 63 6b 20 6a 6f 75 72 6e 61 rollback journa
38210 6c 20 69 73 20 69 6e 20 75 73 65 2c 20 74 68 65 l is in use, the
38220 6d 20 6d 61 6b 65 20 73 75 72 65 20 74 68 65 20 m make sure the
38230 70 61 67 65 20 74 68 61 74 20 69 73 20 61 62 6f page that is abo
38240 75 74 0a 20 20 2a 2a 20 74 6f 20 63 68 61 6e 67 ut. ** to chang
38250 65 20 69 73 20 69 6e 20 74 68 65 20 72 6f 6c 6c e is in the roll
38260 62 61 63 6b 20 6a 6f 75 72 6e 61 6c 2c 20 6f 72 back journal, or
38270 20 69 66 20 74 68 65 20 70 61 67 65 20 69 73 20 if the page is
38280 61 20 6e 65 77 20 70 61 67 65 20 6f 66 66 0a 20 a new page off.
38290 20 2a 2a 20 74 68 65 6e 20 65 6e 64 20 6f 66 20 ** then end of
382a0 74 68 65 20 66 69 6c 65 2c 20 6d 61 6b 65 20 73 the file, make s
382b0 75 72 65 20 69 74 20 69 73 20 6d 61 72 6b 65 64 ure it is marked
382c0 20 61 73 20 50 47 48 44 52 5f 4e 45 45 44 5f 53 as PGHDR_NEED_S
382d0 59 4e 43 2e 0a 20 20 2a 2f 0a 20 20 61 73 73 65 YNC.. */. asse
382e0 72 74 28 20 28 70 50 61 67 65 72 2d 3e 70 49 6e rt( (pPager->pIn
382f0 4a 6f 75 72 6e 61 6c 21 3d 30 29 20 3d 3d 20 69 Journal!=0) == i
38300 73 4f 70 65 6e 28 70 50 61 67 65 72 2d 3e 6a 66 sOpen(pPager->jf
38310 64 29 20 29 3b 0a 20 20 69 66 28 20 70 50 61 67 d) );. if( pPag
38320 65 72 2d 3e 70 49 6e 4a 6f 75 72 6e 61 6c 21 3d er->pInJournal!=
38330 30 0a 20 20 20 26 26 20 73 71 6c 69 74 65 33 42 0. && sqlite3B
38340 69 74 76 65 63 54 65 73 74 4e 6f 74 4e 75 6c 6c itvecTestNotNull
38350 28 70 50 61 67 65 72 2d 3e 70 49 6e 4a 6f 75 72 (pPager->pInJour
38360 6e 61 6c 2c 20 70 50 67 2d 3e 70 67 6e 6f 29 3d nal, pPg->pgno)=
38370 3d 30 0a 20 20 29 7b 0a 20 20 20 20 61 73 73 65 =0. ){. asse
38380 72 74 28 20 70 61 67 65 72 55 73 65 57 61 6c 28 rt( pagerUseWal(
38390 70 50 61 67 65 72 29 3d 3d 30 20 29 3b 0a 20 20 pPager)==0 );.
383a0 20 20 69 66 28 20 70 50 67 2d 3e 70 67 6e 6f 3c if( pPg->pgno<
383b0 3d 70 50 61 67 65 72 2d 3e 64 62 4f 72 69 67 53 =pPager->dbOrigS
383c0 69 7a 65 20 29 7b 0a 20 20 20 20 20 20 72 63 20 ize ){. rc
383d0 3d 20 70 61 67 65 72 41 64 64 50 61 67 65 54 6f = pagerAddPageTo
383e0 52 6f 6c 6c 62 61 63 6b 4a 6f 75 72 6e 61 6c 28 RollbackJournal(
383f0 70 50 67 29 3b 0a 20 20 20 20 20 20 69 66 28 20 pPg);. if(
38400 72 63 21 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b rc!=SQLITE_OK ){
38410 0a 20 20 20 20 20 20 20 20 72 65 74 75 72 6e 20 . return
38420 72 63 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 rc;. }.
38430 7d 65 6c 73 65 7b 0a 20 20 20 20 20 20 69 66 28 }else{. if(
38440 20 70 50 61 67 65 72 2d 3e 65 53 74 61 74 65 21 pPager->eState!
38450 3d 50 41 47 45 52 5f 57 52 49 54 45 52 5f 44 42 =PAGER_WRITER_DB
38460 4d 4f 44 20 29 7b 0a 20 20 20 20 20 20 20 20 70 MOD ){. p
38470 50 67 2d 3e 66 6c 61 67 73 20 7c 3d 20 50 47 48 Pg->flags |= PGH
38480 44 52 5f 4e 45 45 44 5f 53 59 4e 43 3b 0a 20 20 DR_NEED_SYNC;.
38490 20 20 20 20 7d 0a 20 20 20 20 20 20 50 41 47 45 }. PAGE
384a0 52 54 52 41 43 45 28 28 22 41 50 50 45 4e 44 20 RTRACE(("APPEND
384b0 25 64 20 70 61 67 65 20 25 64 20 6e 65 65 64 53 %d page %d needS
384c0 79 6e 63 3d 25 64 5c 6e 22 2c 0a 20 20 20 20 20 ync=%d\n",.
384d0 20 20 20 20 20 20 20 20 20 50 41 47 45 52 49 44 PAGERID
384e0 28 70 50 61 67 65 72 29 2c 20 70 50 67 2d 3e 70 (pPager), pPg->p
384f0 67 6e 6f 2c 0a 20 20 20 20 20 20 20 20 20 20 20 gno,.
38500 20 20 28 28 70 50 67 2d 3e 66 6c 61 67 73 26 50 ((pPg->flags&P
38510 47 48 44 52 5f 4e 45 45 44 5f 53 59 4e 43 29 3f GHDR_NEED_SYNC)?
38520 31 3a 30 29 29 29 3b 0a 20 20 20 20 7d 0a 20 20 1:0)));. }.
38530 7d 0a 0a 20 20 2f 2a 20 54 68 65 20 50 47 48 44 }.. /* The PGHD
38540 52 5f 44 49 52 54 59 20 62 69 74 20 69 73 20 73 R_DIRTY bit is s
38550 65 74 20 61 62 6f 76 65 20 77 68 65 6e 20 74 68 et above when th
38560 65 20 70 61 67 65 20 77 61 73 20 61 64 64 65 64 e page was added
38570 20 74 6f 20 74 68 65 20 64 69 72 74 79 2d 6c 69 to the dirty-li
38580 73 74 0a 20 20 2a 2a 20 61 6e 64 20 62 65 66 6f st. ** and befo
38590 72 65 20 77 72 69 74 69 6e 67 20 74 68 65 20 70 re writing the p
385a0 61 67 65 20 69 6e 74 6f 20 74 68 65 20 72 6f 6c age into the rol
385b0 6c 62 61 63 6b 20 6a 6f 75 72 6e 61 6c 2e 20 20 lback journal.
385c0 57 61 69 74 20 75 6e 74 69 6c 20 6e 6f 77 2c 0a Wait until now,.
385d0 20 20 2a 2a 20 61 66 74 65 72 20 74 68 65 20 70 ** after the p
385e0 61 67 65 20 68 61 73 20 62 65 65 6e 20 73 75 63 age has been suc
385f0 63 65 73 73 66 75 6c 6c 79 20 6a 6f 75 72 6e 61 cessfully journa
38600 6c 6c 65 64 2c 20 62 65 66 6f 72 65 20 73 65 74 lled, before set
38610 74 69 6e 67 20 74 68 65 0a 20 20 2a 2a 20 50 47 ting the. ** PG
38620 48 44 52 5f 57 52 49 54 45 41 42 4c 45 20 62 69 HDR_WRITEABLE bi
38630 74 20 74 68 61 74 20 69 6e 64 69 63 61 74 65 73 t that indicates
38640 20 74 68 61 74 20 74 68 65 20 70 61 67 65 20 63 that the page c
38650 61 6e 20 62 65 20 73 61 66 65 6c 79 20 6d 6f 64 an be safely mod
38660 69 66 69 65 64 2e 0a 20 20 2a 2f 0a 20 20 70 50 ified.. */. pP
38670 67 2d 3e 66 6c 61 67 73 20 7c 3d 20 50 47 48 44 g->flags |= PGHD
38680 52 5f 57 52 49 54 45 41 42 4c 45 3b 0a 20 20 0a R_WRITEABLE;. .
38690 20 20 2f 2a 20 49 66 20 74 68 65 20 73 74 61 74 /* If the stat
386a0 65 6d 65 6e 74 20 6a 6f 75 72 6e 61 6c 20 69 73 ement journal is
386b0 20 6f 70 65 6e 20 61 6e 64 20 74 68 65 20 70 61 open and the pa
386c0 67 65 20 69 73 20 6e 6f 74 20 69 6e 20 69 74 2c ge is not in it,
386d0 0a 20 20 2a 2a 20 74 68 65 6e 20 77 72 69 74 65 . ** then write
386e0 20 74 68 65 20