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 21 69 73 4f 70 assert( !isOp
9cf0: 65 6e 28 70 2d 3e 66 64 29 20 29 3b 0a 20 20 20 en(p->fd) );.
9d00: 20 61 73 73 65 72 74 28 20 70 2d 3e 6e 6f 53 79 assert( p->noSy
9d10: 6e 63 20 29 3b 0a 20 20 20 20 61 73 73 65 72 74 nc );. assert
9d20: 28 20 70 2d 3e 6a 6f 75 72 6e 61 6c 4d 6f 64 65 ( p->journalMode
9d30: 3d 3d 50 41 47 45 52 5f 4a 4f 55 52 4e 41 4c 4d ==PAGER_JOURNALM
9d40: 4f 44 45 5f 4f 46 46 20 0a 20 20 20 20 20 20 20 ODE_OFF .
9d50: 20 20 7c 7c 20 70 2d 3e 6a 6f 75 72 6e 61 6c 4d || p->journalM
9d60: 6f 64 65 3d 3d 50 41 47 45 52 5f 4a 4f 55 52 4e ode==PAGER_JOURN
9d70: 41 4c 4d 4f 44 45 5f 4d 45 4d 4f 52 59 20 0a 20 ALMODE_MEMORY .
9d80: 20 20 20 29 3b 0a 20 20 20 20 61 73 73 65 72 74 );. assert
9d90: 28 20 70 2d 3e 65 53 74 61 74 65 21 3d 50 41 47 ( p->eState!=PAG
9da0: 45 52 5f 45 52 52 4f 52 20 26 26 20 70 2d 3e 65 ER_ERROR && p->e
9db0: 53 74 61 74 65 21 3d 50 41 47 45 52 5f 4f 50 45 State!=PAGER_OPE
9dc0: 4e 20 29 3b 0a 20 20 20 20 61 73 73 65 72 74 28 N );. assert(
9dd0: 20 70 61 67 65 72 55 73 65 57 61 6c 28 70 29 3d pagerUseWal(p)=
9de0: 3d 30 20 29 3b 0a 20 20 7d 0a 0a 20 20 2f 2a 20 =0 );. }.. /*
9df0: 49 66 20 63 68 61 6e 67 65 43 6f 75 6e 74 44 6f If changeCountDo
9e00: 6e 65 20 69 73 20 73 65 74 2c 20 61 20 52 45 53 ne is set, a RES
9e10: 45 52 56 45 44 20 6c 6f 63 6b 20 6f 72 20 67 72 ERVED lock or gr
9e20: 65 61 74 65 72 20 6d 75 73 74 20 62 65 20 68 65 eater must be he
9e30: 6c 64 0a 20 20 2a 2a 20 6f 6e 20 74 68 65 20 66 ld. ** on the f
9e40: 69 6c 65 2e 0a 20 20 2a 2f 0a 20 20 61 73 73 65 ile.. */. asse
9e50: 72 74 28 20 70 50 61 67 65 72 2d 3e 63 68 61 6e rt( pPager->chan
9e60: 67 65 43 6f 75 6e 74 44 6f 6e 65 3d 3d 30 20 7c geCountDone==0 |
9e70: 7c 20 70 50 61 67 65 72 2d 3e 65 4c 6f 63 6b 3e | pPager->eLock>
9e80: 3d 52 45 53 45 52 56 45 44 5f 4c 4f 43 4b 20 29 =RESERVED_LOCK )
9e90: 3b 0a 20 20 61 73 73 65 72 74 28 20 70 2d 3e 65 ;. assert( p->e
9ea0: 4c 6f 63 6b 21 3d 50 45 4e 44 49 4e 47 5f 4c 4f Lock!=PENDING_LO
9eb0: 43 4b 20 29 3b 0a 0a 20 20 73 77 69 74 63 68 28 CK );.. switch(
9ec0: 20 70 2d 3e 65 53 74 61 74 65 20 29 7b 0a 20 20 p->eState ){.
9ed0: 20 20 63 61 73 65 20 50 41 47 45 52 5f 4f 50 45 case PAGER_OPE
9ee0: 4e 3a 0a 20 20 20 20 20 20 61 73 73 65 72 74 28 N:. assert(
9ef0: 20 21 4d 45 4d 44 42 20 29 3b 0a 20 20 20 20 20 !MEMDB );.
9f00: 20 61 73 73 65 72 74 28 20 70 50 61 67 65 72 2d assert( pPager-
9f10: 3e 65 72 72 43 6f 64 65 3d 3d 53 51 4c 49 54 45 >errCode==SQLITE
9f20: 5f 4f 4b 20 29 3b 0a 20 20 20 20 20 20 61 73 73 _OK );. ass
9f30: 65 72 74 28 20 73 71 6c 69 74 65 33 50 63 61 63 ert( sqlite3Pcac
9f40: 68 65 52 65 66 43 6f 75 6e 74 28 70 50 61 67 65 heRefCount(pPage
9f50: 72 2d 3e 70 50 43 61 63 68 65 29 3d 3d 30 20 7c r->pPCache)==0 |
9f60: 7c 20 70 50 61 67 65 72 2d 3e 74 65 6d 70 46 69 | pPager->tempFi
9f70: 6c 65 20 29 3b 0a 20 20 20 20 20 20 62 72 65 61 le );. brea
9f80: 6b 3b 0a 0a 20 20 20 20 63 61 73 65 20 50 41 47 k;.. case PAG
9f90: 45 52 5f 52 45 41 44 45 52 3a 0a 20 20 20 20 20 ER_READER:.
9fa0: 20 61 73 73 65 72 74 28 20 70 50 61 67 65 72 2d assert( pPager-
9fb0: 3e 65 72 72 43 6f 64 65 3d 3d 53 51 4c 49 54 45 >errCode==SQLITE
9fc0: 5f 4f 4b 20 29 3b 0a 20 20 20 20 20 20 61 73 73 _OK );. ass
9fd0: 65 72 74 28 20 70 2d 3e 65 4c 6f 63 6b 21 3d 55 ert( p->eLock!=U
9fe0: 4e 4b 4e 4f 57 4e 5f 4c 4f 43 4b 20 29 3b 0a 20 NKNOWN_LOCK );.
9ff0: 20 20 20 20 20 61 73 73 65 72 74 28 20 70 2d 3e assert( p->
a000: 65 4c 6f 63 6b 3e 3d 53 48 41 52 45 44 5f 4c 4f eLock>=SHARED_LO
a010: 43 4b 20 29 3b 0a 20 20 20 20 20 20 62 72 65 61 CK );. brea
a020: 6b 3b 0a 0a 20 20 20 20 63 61 73 65 20 50 41 47 k;.. case PAG
a030: 45 52 5f 57 52 49 54 45 52 5f 4c 4f 43 4b 45 44 ER_WRITER_LOCKED
a040: 3a 0a 20 20 20 20 20 20 61 73 73 65 72 74 28 20 :. assert(
a050: 70 2d 3e 65 4c 6f 63 6b 21 3d 55 4e 4b 4e 4f 57 p->eLock!=UNKNOW
a060: 4e 5f 4c 4f 43 4b 20 29 3b 0a 20 20 20 20 20 20 N_LOCK );.
a070: 61 73 73 65 72 74 28 20 70 50 61 67 65 72 2d 3e assert( pPager->
a080: 65 72 72 43 6f 64 65 3d 3d 53 51 4c 49 54 45 5f errCode==SQLITE_
a090: 4f 4b 20 29 3b 0a 20 20 20 20 20 20 69 66 28 20 OK );. if(
a0a0: 21 70 61 67 65 72 55 73 65 57 61 6c 28 70 50 61 !pagerUseWal(pPa
a0b0: 67 65 72 29 20 29 7b 0a 20 20 20 20 20 20 20 20 ger) ){.
a0c0: 61 73 73 65 72 74 28 20 70 2d 3e 65 4c 6f 63 6b assert( p->eLock
a0d0: 3e 3d 52 45 53 45 52 56 45 44 5f 4c 4f 43 4b 20 >=RESERVED_LOCK
a0e0: 29 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 20 );. }.
a0f0: 20 61 73 73 65 72 74 28 20 70 50 61 67 65 72 2d assert( pPager-
a100: 3e 64 62 53 69 7a 65 3d 3d 70 50 61 67 65 72 2d >dbSize==pPager-
a110: 3e 64 62 4f 72 69 67 53 69 7a 65 20 29 3b 0a 20 >dbOrigSize );.
a120: 20 20 20 20 20 61 73 73 65 72 74 28 20 70 50 61 assert( pPa
a130: 67 65 72 2d 3e 64 62 4f 72 69 67 53 69 7a 65 3d ger->dbOrigSize=
a140: 3d 70 50 61 67 65 72 2d 3e 64 62 46 69 6c 65 53 =pPager->dbFileS
a150: 69 7a 65 20 29 3b 0a 20 20 20 20 20 20 61 73 73 ize );. ass
a160: 65 72 74 28 20 70 50 61 67 65 72 2d 3e 64 62 4f ert( pPager->dbO
a170: 72 69 67 53 69 7a 65 3d 3d 70 50 61 67 65 72 2d rigSize==pPager-
a180: 3e 64 62 48 69 6e 74 53 69 7a 65 20 29 3b 0a 20 >dbHintSize );.
a190: 20 20 20 20 20 61 73 73 65 72 74 28 20 70 50 61 assert( pPa
a1a0: 67 65 72 2d 3e 73 65 74 4d 61 73 74 65 72 3d 3d ger->setMaster==
a1b0: 30 20 29 3b 0a 20 20 20 20 20 20 62 72 65 61 6b 0 );. break
a1c0: 3b 0a 0a 20 20 20 20 63 61 73 65 20 50 41 47 45 ;.. case PAGE
a1d0: 52 5f 57 52 49 54 45 52 5f 43 41 43 48 45 4d 4f R_WRITER_CACHEMO
a1e0: 44 3a 0a 20 20 20 20 20 20 61 73 73 65 72 74 28 D:. assert(
a1f0: 20 70 2d 3e 65 4c 6f 63 6b 21 3d 55 4e 4b 4e 4f p->eLock!=UNKNO
a200: 57 4e 5f 4c 4f 43 4b 20 29 3b 0a 20 20 20 20 20 WN_LOCK );.
a210: 20 61 73 73 65 72 74 28 20 70 50 61 67 65 72 2d assert( pPager-
a220: 3e 65 72 72 43 6f 64 65 3d 3d 53 51 4c 49 54 45 >errCode==SQLITE
a230: 5f 4f 4b 20 29 3b 0a 20 20 20 20 20 20 69 66 28 _OK );. if(
a240: 20 21 70 61 67 65 72 55 73 65 57 61 6c 28 70 50 !pagerUseWal(pP
a250: 61 67 65 72 29 20 29 7b 0a 20 20 20 20 20 20 20 ager) ){.
a260: 20 2f 2a 20 49 74 20 69 73 20 70 6f 73 73 69 62 /* It is possib
a270: 6c 65 20 74 68 61 74 20 69 66 20 6a 6f 75 72 6e le that if journ
a280: 61 6c 5f 6d 6f 64 65 3d 77 61 6c 20 68 65 72 65 al_mode=wal here
a290: 20 74 68 61 74 20 6e 65 69 74 68 65 72 20 74 68 that neither th
a2a0: 65 0a 20 20 20 20 20 20 20 20 2a 2a 20 6a 6f 75 e. ** jou
a2b0: 72 6e 61 6c 20 66 69 6c 65 20 6e 6f 72 20 74 68 rnal file nor th
a2c0: 65 20 57 41 4c 20 66 69 6c 65 20 61 72 65 20 6f e WAL file are o
a2d0: 70 65 6e 2e 20 54 68 69 73 20 68 61 70 70 65 6e pen. This happen
a2e0: 73 20 64 75 72 69 6e 67 0a 20 20 20 20 20 20 20 s during.
a2f0: 20 2a 2a 20 61 20 72 6f 6c 6c 62 61 63 6b 20 74 ** a rollback t
a300: 72 61 6e 73 61 63 74 69 6f 6e 20 74 68 61 74 20 ransaction that
a310: 73 77 69 74 63 68 65 73 20 66 72 6f 6d 20 6a 6f switches from jo
a320: 75 72 6e 61 6c 5f 6d 6f 64 65 3d 6f 66 66 0a 20 urnal_mode=off.
a330: 20 20 20 20 20 20 20 2a 2a 20 74 6f 20 6a 6f 75 ** to jou
a340: 72 6e 61 6c 5f 6d 6f 64 65 3d 77 61 6c 2e 0a 20 rnal_mode=wal..
a350: 20 20 20 20 20 20 20 2a 2f 0a 20 20 20 20 20 20 */.
a360: 20 20 61 73 73 65 72 74 28 20 70 2d 3e 65 4c 6f assert( p->eLo
a370: 63 6b 3e 3d 52 45 53 45 52 56 45 44 5f 4c 4f 43 ck>=RESERVED_LOC
a380: 4b 20 29 3b 0a 20 20 20 20 20 20 20 20 61 73 73 K );. ass
a390: 65 72 74 28 20 69 73 4f 70 65 6e 28 70 2d 3e 6a ert( isOpen(p->j
a3a0: 66 64 29 20 0a 20 20 20 20 20 20 20 20 20 20 20 fd) .
a3b0: 20 20 7c 7c 20 70 2d 3e 6a 6f 75 72 6e 61 6c 4d || p->journalM
a3c0: 6f 64 65 3d 3d 50 41 47 45 52 5f 4a 4f 55 52 4e ode==PAGER_JOURN
a3d0: 41 4c 4d 4f 44 45 5f 4f 46 46 20 0a 20 20 20 20 ALMODE_OFF .
a3e0: 20 20 20 20 20 20 20 20 20 7c 7c 20 70 2d 3e 6a || p->j
a3f0: 6f 75 72 6e 61 6c 4d 6f 64 65 3d 3d 50 41 47 45 ournalMode==PAGE
a400: 52 5f 4a 4f 55 52 4e 41 4c 4d 4f 44 45 5f 57 41 R_JOURNALMODE_WA
a410: 4c 20 0a 20 20 20 20 20 20 20 20 29 3b 0a 20 20 L . );.
a420: 20 20 20 20 7d 0a 20 20 20 20 20 20 61 73 73 65 }. asse
a430: 72 74 28 20 70 50 61 67 65 72 2d 3e 64 62 4f 72 rt( pPager->dbOr
a440: 69 67 53 69 7a 65 3d 3d 70 50 61 67 65 72 2d 3e igSize==pPager->
a450: 64 62 46 69 6c 65 53 69 7a 65 20 29 3b 0a 20 20 dbFileSize );.
a460: 20 20 20 20 61 73 73 65 72 74 28 20 70 50 61 67 assert( pPag
a470: 65 72 2d 3e 64 62 4f 72 69 67 53 69 7a 65 3d 3d er->dbOrigSize==
a480: 70 50 61 67 65 72 2d 3e 64 62 48 69 6e 74 53 69 pPager->dbHintSi
a490: 7a 65 20 29 3b 0a 20 20 20 20 20 20 62 72 65 61 ze );. brea
a4a0: 6b 3b 0a 0a 20 20 20 20 63 61 73 65 20 50 41 47 k;.. case PAG
a4b0: 45 52 5f 57 52 49 54 45 52 5f 44 42 4d 4f 44 3a ER_WRITER_DBMOD:
a4c0: 0a 20 20 20 20 20 20 61 73 73 65 72 74 28 20 70 . assert( p
a4d0: 2d 3e 65 4c 6f 63 6b 3d 3d 45 58 43 4c 55 53 49 ->eLock==EXCLUSI
a4e0: 56 45 5f 4c 4f 43 4b 20 29 3b 0a 20 20 20 20 20 VE_LOCK );.
a4f0: 20 61 73 73 65 72 74 28 20 70 50 61 67 65 72 2d assert( pPager-
a500: 3e 65 72 72 43 6f 64 65 3d 3d 53 51 4c 49 54 45 >errCode==SQLITE
a510: 5f 4f 4b 20 29 3b 0a 20 20 20 20 20 20 61 73 73 _OK );. ass
a520: 65 72 74 28 20 21 70 61 67 65 72 55 73 65 57 61 ert( !pagerUseWa
a530: 6c 28 70 50 61 67 65 72 29 20 29 3b 0a 20 20 20 l(pPager) );.
a540: 20 20 20 61 73 73 65 72 74 28 20 70 2d 3e 65 4c assert( p->eL
a550: 6f 63 6b 3e 3d 45 58 43 4c 55 53 49 56 45 5f 4c ock>=EXCLUSIVE_L
a560: 4f 43 4b 20 29 3b 0a 20 20 20 20 20 20 61 73 73 OCK );. ass
a570: 65 72 74 28 20 69 73 4f 70 65 6e 28 70 2d 3e 6a ert( isOpen(p->j
a580: 66 64 29 20 0a 20 20 20 20 20 20 20 20 20 20 20 fd) .
a590: 7c 7c 20 70 2d 3e 6a 6f 75 72 6e 61 6c 4d 6f 64 || p->journalMod
a5a0: 65 3d 3d 50 41 47 45 52 5f 4a 4f 55 52 4e 41 4c e==PAGER_JOURNAL
a5b0: 4d 4f 44 45 5f 4f 46 46 20 0a 20 20 20 20 20 20 MODE_OFF .
a5c0: 20 20 20 20 20 7c 7c 20 70 2d 3e 6a 6f 75 72 6e || p->journ
a5d0: 61 6c 4d 6f 64 65 3d 3d 50 41 47 45 52 5f 4a 4f alMode==PAGER_JO
a5e0: 55 52 4e 41 4c 4d 4f 44 45 5f 57 41 4c 20 0a 20 URNALMODE_WAL .
a5f0: 20 20 20 20 20 29 3b 0a 20 20 20 20 20 20 61 73 );. as
a600: 73 65 72 74 28 20 70 50 61 67 65 72 2d 3e 64 62 sert( pPager->db
a610: 4f 72 69 67 53 69 7a 65 3c 3d 70 50 61 67 65 72 OrigSize<=pPager
a620: 2d 3e 64 62 48 69 6e 74 53 69 7a 65 20 29 3b 0a ->dbHintSize );.
a630: 20 20 20 20 20 20 62 72 65 61 6b 3b 0a 0a 20 20 break;..
a640: 20 20 63 61 73 65 20 50 41 47 45 52 5f 57 52 49 case PAGER_WRI
a650: 54 45 52 5f 46 49 4e 49 53 48 45 44 3a 0a 20 20 TER_FINISHED:.
a660: 20 20 20 20 61 73 73 65 72 74 28 20 70 2d 3e 65 assert( p->e
a670: 4c 6f 63 6b 3d 3d 45 58 43 4c 55 53 49 56 45 5f Lock==EXCLUSIVE_
a680: 4c 4f 43 4b 20 29 3b 0a 20 20 20 20 20 20 61 73 LOCK );. as
a690: 73 65 72 74 28 20 70 50 61 67 65 72 2d 3e 65 72 sert( pPager->er
a6a0: 72 43 6f 64 65 3d 3d 53 51 4c 49 54 45 5f 4f 4b rCode==SQLITE_OK
a6b0: 20 29 3b 0a 20 20 20 20 20 20 61 73 73 65 72 74 );. assert
a6c0: 28 20 21 70 61 67 65 72 55 73 65 57 61 6c 28 70 ( !pagerUseWal(p
a6d0: 50 61 67 65 72 29 20 29 3b 0a 20 20 20 20 20 20 Pager) );.
a6e0: 61 73 73 65 72 74 28 20 69 73 4f 70 65 6e 28 70 assert( isOpen(p
a6f0: 2d 3e 6a 66 64 29 20 0a 20 20 20 20 20 20 20 20 ->jfd) .
a700: 20 20 20 7c 7c 20 70 2d 3e 6a 6f 75 72 6e 61 6c || p->journal
a710: 4d 6f 64 65 3d 3d 50 41 47 45 52 5f 4a 4f 55 52 Mode==PAGER_JOUR
a720: 4e 41 4c 4d 4f 44 45 5f 4f 46 46 20 0a 20 20 20 NALMODE_OFF .
a730: 20 20 20 20 20 20 20 20 7c 7c 20 70 2d 3e 6a 6f || p->jo
a740: 75 72 6e 61 6c 4d 6f 64 65 3d 3d 50 41 47 45 52 urnalMode==PAGER
a750: 5f 4a 4f 55 52 4e 41 4c 4d 4f 44 45 5f 57 41 4c _JOURNALMODE_WAL
a760: 20 0a 20 20 20 20 20 20 29 3b 0a 20 20 20 20 20 . );.
a770: 20 62 72 65 61 6b 3b 0a 0a 20 20 20 20 63 61 73 break;.. cas
a780: 65 20 50 41 47 45 52 5f 45 52 52 4f 52 3a 0a 20 e PAGER_ERROR:.
a790: 20 20 20 20 20 2f 2a 20 54 68 65 72 65 20 6d 75 /* There mu
a7a0: 73 74 20 62 65 20 61 74 20 6c 65 61 73 74 20 6f st be at least o
a7b0: 6e 65 20 6f 75 74 73 74 61 6e 64 69 6e 67 20 72 ne outstanding r
a7c0: 65 66 65 72 65 6e 63 65 20 74 6f 20 74 68 65 20 eference to the
a7d0: 70 61 67 65 72 20 69 66 0a 20 20 20 20 20 20 2a pager if. *
a7e0: 2a 20 69 6e 20 45 52 52 4f 52 20 73 74 61 74 65 * in ERROR state
a7f0: 2e 20 4f 74 68 65 72 77 69 73 65 20 74 68 65 20 . Otherwise the
a800: 70 61 67 65 72 20 73 68 6f 75 6c 64 20 68 61 76 pager should hav
a810: 65 20 61 6c 72 65 61 64 79 20 64 72 6f 70 70 65 e already droppe
a820: 64 0a 20 20 20 20 20 20 2a 2a 20 62 61 63 6b 20 d. ** back
a830: 74 6f 20 4f 50 45 4e 20 73 74 61 74 65 2e 0a 20 to OPEN state..
a840: 20 20 20 20 20 2a 2f 0a 20 20 20 20 20 20 61 73 */. as
a850: 73 65 72 74 28 20 70 50 61 67 65 72 2d 3e 65 72 sert( pPager->er
a860: 72 43 6f 64 65 21 3d 53 51 4c 49 54 45 5f 4f 4b rCode!=SQLITE_OK
a870: 20 29 3b 0a 20 20 20 20 20 20 61 73 73 65 72 74 );. assert
a880: 28 20 73 71 6c 69 74 65 33 50 63 61 63 68 65 52 ( sqlite3PcacheR
a890: 65 66 43 6f 75 6e 74 28 70 50 61 67 65 72 2d 3e efCount(pPager->
a8a0: 70 50 43 61 63 68 65 29 3e 30 20 7c 7c 20 70 50 pPCache)>0 || pP
a8b0: 61 67 65 72 2d 3e 74 65 6d 70 46 69 6c 65 20 29 ager->tempFile )
a8c0: 3b 0a 20 20 20 20 20 20 62 72 65 61 6b 3b 0a 20 ;. break;.
a8d0: 20 7d 0a 0a 20 20 72 65 74 75 72 6e 20 31 3b 0a }.. return 1;.
a8e0: 7d 0a 23 65 6e 64 69 66 20 2f 2a 20 69 66 6e 64 }.#endif /* ifnd
a8f0: 65 66 20 4e 44 45 42 55 47 20 2a 2f 0a 0a 23 69 ef NDEBUG */..#i
a900: 66 64 65 66 20 53 51 4c 49 54 45 5f 44 45 42 55 fdef SQLITE_DEBU
a910: 47 20 0a 2f 2a 0a 2a 2a 20 52 65 74 75 72 6e 20 G ./*.** Return
a920: 61 20 70 6f 69 6e 74 65 72 20 74 6f 20 61 20 68 a pointer to a h
a930: 75 6d 61 6e 20 72 65 61 64 61 62 6c 65 20 73 74 uman readable st
a940: 72 69 6e 67 20 69 6e 20 61 20 73 74 61 74 69 63 ring in a static
a950: 20 62 75 66 66 65 72 0a 2a 2a 20 63 6f 6e 74 61 buffer.** conta
a960: 69 6e 69 6e 67 20 74 68 65 20 73 74 61 74 65 20 ining the state
a970: 6f 66 20 74 68 65 20 50 61 67 65 72 20 6f 62 6a of the Pager obj
a980: 65 63 74 20 70 61 73 73 65 64 20 61 73 20 61 6e ect passed as an
a990: 20 61 72 67 75 6d 65 6e 74 2e 20 54 68 69 73 0a argument. This.
a9a0: 2a 2a 20 69 73 20 69 6e 74 65 6e 64 65 64 20 74 ** is intended t
a9b0: 6f 20 62 65 20 75 73 65 64 20 77 69 74 68 69 6e o be used within
a9c0: 20 64 65 62 75 67 67 65 72 73 2e 20 46 6f 72 20 debuggers. For
a9d0: 65 78 61 6d 70 6c 65 2c 20 61 73 20 61 6e 20 61 example, as an a
a9e0: 6c 74 65 72 6e 61 74 69 76 65 0a 2a 2a 20 74 6f lternative.** to
a9f0: 20 22 70 72 69 6e 74 20 2a 70 50 61 67 65 72 22 "print *pPager"
aa00: 20 69 6e 20 67 64 62 3a 0a 2a 2a 0a 2a 2a 20 28 in gdb:.**.** (
aa10: 67 64 62 29 20 70 72 69 6e 74 66 20 22 25 73 22 gdb) printf "%s"
aa20: 2c 20 70 72 69 6e 74 5f 70 61 67 65 72 5f 73 74 , print_pager_st
aa30: 61 74 65 28 70 50 61 67 65 72 29 0a 2a 2f 0a 73 ate(pPager).*/.s
aa40: 74 61 74 69 63 20 63 68 61 72 20 2a 70 72 69 6e tatic char *prin
aa50: 74 5f 70 61 67 65 72 5f 73 74 61 74 65 28 50 61 t_pager_state(Pa
aa60: 67 65 72 20 2a 70 29 7b 0a 20 20 73 74 61 74 69 ger *p){. stati
aa70: 63 20 63 68 61 72 20 7a 52 65 74 5b 31 30 32 34 c char zRet[1024
aa80: 5d 3b 0a 0a 20 20 73 71 6c 69 74 65 33 5f 73 6e ];.. sqlite3_sn
aa90: 70 72 69 6e 74 66 28 31 30 32 34 2c 20 7a 52 65 printf(1024, zRe
aaa0: 74 2c 0a 20 20 20 20 20 20 22 46 69 6c 65 6e 61 t,. "Filena
aab0: 6d 65 3a 20 20 20 20 20 20 25 73 5c 6e 22 0a 20 me: %s\n".
aac0: 20 20 20 20 20 22 53 74 61 74 65 3a 20 20 20 20 "State:
aad0: 20 20 20 20 20 25 73 20 65 72 72 43 6f 64 65 3d %s errCode=
aae0: 25 64 5c 6e 22 0a 20 20 20 20 20 20 22 4c 6f 63 %d\n". "Loc
aaf0: 6b 3a 20 20 20 20 20 20 20 20 20 20 25 73 5c 6e k: %s\n
ab00: 22 0a 20 20 20 20 20 20 22 4c 6f 63 6b 69 6e 67 ". "Locking
ab10: 20 6d 6f 64 65 3a 20 20 6c 6f 63 6b 69 6e 67 5f mode: locking_
ab20: 6d 6f 64 65 3d 25 73 5c 6e 22 0a 20 20 20 20 20 mode=%s\n".
ab30: 20 22 4a 6f 75 72 6e 61 6c 20 6d 6f 64 65 3a 20 "Journal mode:
ab40: 20 6a 6f 75 72 6e 61 6c 5f 6d 6f 64 65 3d 25 73 journal_mode=%s
ab50: 5c 6e 22 0a 20 20 20 20 20 20 22 42 61 63 6b 69 \n". "Backi
ab60: 6e 67 20 73 74 6f 72 65 3a 20 74 65 6d 70 46 69 ng store: tempFi
ab70: 6c 65 3d 25 64 20 6d 65 6d 44 62 3d 25 64 20 75 le=%d memDb=%d u
ab80: 73 65 4a 6f 75 72 6e 61 6c 3d 25 64 5c 6e 22 0a seJournal=%d\n".
ab90: 20 20 20 20 20 20 22 4a 6f 75 72 6e 61 6c 3a 20 "Journal:
aba0: 20 20 20 20 20 20 6a 6f 75 72 6e 61 6c 4f 66 66 journalOff
abb0: 3d 25 6c 6c 64 20 6a 6f 75 72 6e 61 6c 48 64 72 =%lld journalHdr
abc0: 3d 25 6c 6c 64 5c 6e 22 0a 20 20 20 20 20 20 22 =%lld\n". "
abd0: 53 69 7a 65 3a 20 20 20 20 20 20 20 20 20 20 64 Size: d
abe0: 62 73 69 7a 65 3d 25 64 20 64 62 4f 72 69 67 53 bsize=%d dbOrigS
abf0: 69 7a 65 3d 25 64 20 64 62 46 69 6c 65 53 69 7a ize=%d dbFileSiz
ac00: 65 3d 25 64 5c 6e 22 0a 20 20 20 20 20 20 2c 20 e=%d\n". ,
ac10: 70 2d 3e 7a 46 69 6c 65 6e 61 6d 65 0a 20 20 20 p->zFilename.
ac20: 20 20 20 2c 20 70 2d 3e 65 53 74 61 74 65 3d 3d , p->eState==
ac30: 50 41 47 45 52 5f 4f 50 45 4e 20 20 20 20 20 20 PAGER_OPEN
ac40: 20 20 20 20 20 20 3f 20 22 4f 50 45 4e 22 20 3a ? "OPEN" :
ac50: 0a 20 20 20 20 20 20 20 20 70 2d 3e 65 53 74 61 . p->eSta
ac60: 74 65 3d 3d 50 41 47 45 52 5f 52 45 41 44 45 52 te==PAGER_READER
ac70: 20 20 20 20 20 20 20 20 20 20 3f 20 22 52 45 41 ? "REA
ac80: 44 45 52 22 20 3a 0a 20 20 20 20 20 20 20 20 70 DER" :. p
ac90: 2d 3e 65 53 74 61 74 65 3d 3d 50 41 47 45 52 5f ->eState==PAGER_
aca0: 57 52 49 54 45 52 5f 4c 4f 43 4b 45 44 20 20 20 WRITER_LOCKED
acb0: 3f 20 22 57 52 49 54 45 52 5f 4c 4f 43 4b 45 44 ? "WRITER_LOCKED
acc0: 22 20 3a 0a 20 20 20 20 20 20 20 20 70 2d 3e 65 " :. p->e
acd0: 53 74 61 74 65 3d 3d 50 41 47 45 52 5f 57 52 49 State==PAGER_WRI
ace0: 54 45 52 5f 43 41 43 48 45 4d 4f 44 20 3f 20 22 TER_CACHEMOD ? "
acf0: 57 52 49 54 45 52 5f 43 41 43 48 45 4d 4f 44 22 WRITER_CACHEMOD"
ad00: 20 3a 0a 20 20 20 20 20 20 20 20 70 2d 3e 65 53 :. p->eS
ad10: 74 61 74 65 3d 3d 50 41 47 45 52 5f 57 52 49 54 tate==PAGER_WRIT
ad20: 45 52 5f 44 42 4d 4f 44 20 20 20 20 3f 20 22 57 ER_DBMOD ? "W
ad30: 52 49 54 45 52 5f 44 42 4d 4f 44 22 20 3a 0a 20 RITER_DBMOD" :.
ad40: 20 20 20 20 20 20 20 70 2d 3e 65 53 74 61 74 65 p->eState
ad50: 3d 3d 50 41 47 45 52 5f 57 52 49 54 45 52 5f 46 ==PAGER_WRITER_F
ad60: 49 4e 49 53 48 45 44 20 3f 20 22 57 52 49 54 45 INISHED ? "WRITE
ad70: 52 5f 46 49 4e 49 53 48 45 44 22 20 3a 0a 20 20 R_FINISHED" :.
ad80: 20 20 20 20 20 20 70 2d 3e 65 53 74 61 74 65 3d p->eState=
ad90: 3d 50 41 47 45 52 5f 45 52 52 4f 52 20 20 20 20 =PAGER_ERROR
ada0: 20 20 20 20 20 20 20 3f 20 22 45 52 52 4f 52 22 ? "ERROR"
adb0: 20 3a 20 22 3f 65 72 72 6f 72 3f 22 0a 20 20 20 : "?error?".
adc0: 20 20 20 2c 20 28 69 6e 74 29 70 2d 3e 65 72 72 , (int)p->err
add0: 43 6f 64 65 0a 20 20 20 20 20 20 2c 20 70 2d 3e Code. , p->
ade0: 65 4c 6f 63 6b 3d 3d 4e 4f 5f 4c 4f 43 4b 20 20 eLock==NO_LOCK
adf0: 20 20 20 20 20 20 20 3f 20 22 4e 4f 5f 4c 4f 43 ? "NO_LOC
ae00: 4b 22 20 3a 0a 20 20 20 20 20 20 20 20 70 2d 3e K" :. p->
ae10: 65 4c 6f 63 6b 3d 3d 52 45 53 45 52 56 45 44 5f eLock==RESERVED_
ae20: 4c 4f 43 4b 20 20 20 3f 20 22 52 45 53 45 52 56 LOCK ? "RESERV
ae30: 45 44 22 20 3a 0a 20 20 20 20 20 20 20 20 70 2d ED" :. p-
ae40: 3e 65 4c 6f 63 6b 3d 3d 45 58 43 4c 55 53 49 56 >eLock==EXCLUSIV
ae50: 45 5f 4c 4f 43 4b 20 20 3f 20 22 45 58 43 4c 55 E_LOCK ? "EXCLU
ae60: 53 49 56 45 22 20 3a 0a 20 20 20 20 20 20 20 20 SIVE" :.
ae70: 70 2d 3e 65 4c 6f 63 6b 3d 3d 53 48 41 52 45 44 p->eLock==SHARED
ae80: 5f 4c 4f 43 4b 20 20 20 20 20 3f 20 22 53 48 41 _LOCK ? "SHA
ae90: 52 45 44 22 20 3a 0a 20 20 20 20 20 20 20 20 70 RED" :. p
aea0: 2d 3e 65 4c 6f 63 6b 3d 3d 55 4e 4b 4e 4f 57 4e ->eLock==UNKNOWN
aeb0: 5f 4c 4f 43 4b 20 20 20 20 3f 20 22 55 4e 4b 4e _LOCK ? "UNKN
aec0: 4f 57 4e 22 20 3a 20 22 3f 65 72 72 6f 72 3f 22 OWN" : "?error?"
aed0: 0a 20 20 20 20 20 20 2c 20 70 2d 3e 65 78 63 6c . , p->excl
aee0: 75 73 69 76 65 4d 6f 64 65 20 3f 20 22 65 78 63 usiveMode ? "exc
aef0: 6c 75 73 69 76 65 22 20 3a 20 22 6e 6f 72 6d 61 lusive" : "norma
af00: 6c 22 0a 20 20 20 20 20 20 2c 20 70 2d 3e 6a 6f l". , p->jo
af10: 75 72 6e 61 6c 4d 6f 64 65 3d 3d 50 41 47 45 52 urnalMode==PAGER
af20: 5f 4a 4f 55 52 4e 41 4c 4d 4f 44 45 5f 4d 45 4d _JOURNALMODE_MEM
af30: 4f 52 59 20 20 20 3f 20 22 6d 65 6d 6f 72 79 22 ORY ? "memory"
af40: 20 3a 0a 20 20 20 20 20 20 20 20 70 2d 3e 6a 6f :. p->jo
af50: 75 72 6e 61 6c 4d 6f 64 65 3d 3d 50 41 47 45 52 urnalMode==PAGER
af60: 5f 4a 4f 55 52 4e 41 4c 4d 4f 44 45 5f 4f 46 46 _JOURNALMODE_OFF
af70: 20 20 20 20 20 20 3f 20 22 6f 66 66 22 20 3a 0a ? "off" :.
af80: 20 20 20 20 20 20 20 20 70 2d 3e 6a 6f 75 72 6e p->journ
af90: 61 6c 4d 6f 64 65 3d 3d 50 41 47 45 52 5f 4a 4f alMode==PAGER_JO
afa0: 55 52 4e 41 4c 4d 4f 44 45 5f 44 45 4c 45 54 45 URNALMODE_DELETE
afb0: 20 20 20 3f 20 22 64 65 6c 65 74 65 22 20 3a 0a ? "delete" :.
afc0: 20 20 20 20 20 20 20 20 70 2d 3e 6a 6f 75 72 6e p->journ
afd0: 61 6c 4d 6f 64 65 3d 3d 50 41 47 45 52 5f 4a 4f alMode==PAGER_JO
afe0: 55 52 4e 41 4c 4d 4f 44 45 5f 50 45 52 53 49 53 URNALMODE_PERSIS
aff0: 54 20 20 3f 20 22 70 65 72 73 69 73 74 22 20 3a T ? "persist" :
b000: 0a 20 20 20 20 20 20 20 20 70 2d 3e 6a 6f 75 72 . p->jour
b010: 6e 61 6c 4d 6f 64 65 3d 3d 50 41 47 45 52 5f 4a nalMode==PAGER_J
b020: 4f 55 52 4e 41 4c 4d 4f 44 45 5f 54 52 55 4e 43 OURNALMODE_TRUNC
b030: 41 54 45 20 3f 20 22 74 72 75 6e 63 61 74 65 22 ATE ? "truncate"
b040: 20 3a 0a 20 20 20 20 20 20 20 20 70 2d 3e 6a 6f :. p->jo
b050: 75 72 6e 61 6c 4d 6f 64 65 3d 3d 50 41 47 45 52 urnalMode==PAGER
b060: 5f 4a 4f 55 52 4e 41 4c 4d 4f 44 45 5f 57 41 4c _JOURNALMODE_WAL
b070: 20 20 20 20 20 20 3f 20 22 77 61 6c 22 20 3a 20 ? "wal" :
b080: 22 3f 65 72 72 6f 72 3f 22 0a 20 20 20 20 20 20 "?error?".
b090: 2c 20 28 69 6e 74 29 70 2d 3e 74 65 6d 70 46 69 , (int)p->tempFi
b0a0: 6c 65 2c 20 28 69 6e 74 29 70 2d 3e 6d 65 6d 44 le, (int)p->memD
b0b0: 62 2c 20 28 69 6e 74 29 70 2d 3e 75 73 65 4a 6f b, (int)p->useJo
b0c0: 75 72 6e 61 6c 0a 20 20 20 20 20 20 2c 20 70 2d urnal. , p-
b0d0: 3e 6a 6f 75 72 6e 61 6c 4f 66 66 2c 20 70 2d 3e >journalOff, p->
b0e0: 6a 6f 75 72 6e 61 6c 48 64 72 0a 20 20 20 20 20 journalHdr.
b0f0: 20 2c 20 28 69 6e 74 29 70 2d 3e 64 62 53 69 7a , (int)p->dbSiz
b100: 65 2c 20 28 69 6e 74 29 70 2d 3e 64 62 4f 72 69 e, (int)p->dbOri
b110: 67 53 69 7a 65 2c 20 28 69 6e 74 29 70 2d 3e 64 gSize, (int)p->d
b120: 62 46 69 6c 65 53 69 7a 65 0a 20 20 29 3b 0a 0a bFileSize. );..
b130: 20 20 72 65 74 75 72 6e 20 7a 52 65 74 3b 0a 7d return zRet;.}
b140: 0a 23 65 6e 64 69 66 0a 0a 2f 2a 0a 2a 2a 20 52 .#endif../*.** R
b150: 65 74 75 72 6e 20 74 72 75 65 20 69 66 20 69 74 eturn true if it
b160: 20 69 73 20 6e 65 63 65 73 73 61 72 79 20 74 6f is necessary to
b170: 20 77 72 69 74 65 20 70 61 67 65 20 2a 70 50 67 write page *pPg
b180: 20 69 6e 74 6f 20 74 68 65 20 73 75 62 2d 6a 6f into the sub-jo
b190: 75 72 6e 61 6c 2e 0a 2a 2a 20 41 20 70 61 67 65 urnal..** A page
b1a0: 20 6e 65 65 64 73 20 74 6f 20 62 65 20 77 72 69 needs to be wri
b1b0: 74 74 65 6e 20 69 6e 74 6f 20 74 68 65 20 73 75 tten into the su
b1c0: 62 2d 6a 6f 75 72 6e 61 6c 20 69 66 20 74 68 65 b-journal if the
b1d0: 72 65 20 65 78 69 73 74 73 20 6f 6e 65 0a 2a 2a re exists one.**
b1e0: 20 6f 72 20 6d 6f 72 65 20 6f 70 65 6e 20 73 61 or more open sa
b1f0: 76 65 70 6f 69 6e 74 73 20 66 6f 72 20 77 68 69 vepoints for whi
b200: 63 68 3a 0a 2a 2a 0a 2a 2a 20 20 20 2a 20 54 68 ch:.**.** * Th
b210: 65 20 70 61 67 65 2d 6e 75 6d 62 65 72 20 69 73 e page-number is
b220: 20 6c 65 73 73 20 74 68 61 6e 20 6f 72 20 65 71 less than or eq
b230: 75 61 6c 20 74 6f 20 50 61 67 65 72 53 61 76 65 ual to PagerSave
b240: 70 6f 69 6e 74 2e 6e 4f 72 69 67 2c 20 61 6e 64 point.nOrig, and
b250: 0a 2a 2a 20 20 20 2a 20 54 68 65 20 62 69 74 20 .** * The bit
b260: 63 6f 72 72 65 73 70 6f 6e 64 69 6e 67 20 74 6f corresponding to
b270: 20 74 68 65 20 70 61 67 65 2d 6e 75 6d 62 65 72 the page-number
b280: 20 69 73 20 6e 6f 74 20 73 65 74 20 69 6e 0a 2a is not set in.*
b290: 2a 20 20 20 20 20 50 61 67 65 72 53 61 76 65 70 * PagerSavep
b2a0: 6f 69 6e 74 2e 70 49 6e 53 61 76 65 70 6f 69 6e oint.pInSavepoin
b2b0: 74 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74 t..*/.static int
b2c0: 20 73 75 62 6a 52 65 71 75 69 72 65 73 50 61 67 subjRequiresPag
b2d0: 65 28 50 67 48 64 72 20 2a 70 50 67 29 7b 0a 20 e(PgHdr *pPg){.
b2e0: 20 50 61 67 65 72 20 2a 70 50 61 67 65 72 20 3d Pager *pPager =
b2f0: 20 70 50 67 2d 3e 70 50 61 67 65 72 3b 0a 20 20 pPg->pPager;.
b300: 50 61 67 65 72 53 61 76 65 70 6f 69 6e 74 20 2a PagerSavepoint *
b310: 70 3b 0a 20 20 50 67 6e 6f 20 70 67 6e 6f 20 3d p;. Pgno pgno =
b320: 20 70 50 67 2d 3e 70 67 6e 6f 3b 0a 20 20 69 6e pPg->pgno;. in
b330: 74 20 69 3b 0a 20 20 66 6f 72 28 69 3d 30 3b 20 t i;. for(i=0;
b340: 69 3c 70 50 61 67 65 72 2d 3e 6e 53 61 76 65 70 i<pPager->nSavep
b350: 6f 69 6e 74 3b 20 69 2b 2b 29 7b 0a 20 20 20 20 oint; i++){.
b360: 70 20 3d 20 26 70 50 61 67 65 72 2d 3e 61 53 61 p = &pPager->aSa
b370: 76 65 70 6f 69 6e 74 5b 69 5d 3b 0a 20 20 20 20 vepoint[i];.
b380: 69 66 28 20 70 2d 3e 6e 4f 72 69 67 3e 3d 70 67 if( p->nOrig>=pg
b390: 6e 6f 20 26 26 20 30 3d 3d 73 71 6c 69 74 65 33 no && 0==sqlite3
b3a0: 42 69 74 76 65 63 54 65 73 74 4e 6f 74 4e 75 6c BitvecTestNotNul
b3b0: 6c 28 70 2d 3e 70 49 6e 53 61 76 65 70 6f 69 6e l(p->pInSavepoin
b3c0: 74 2c 20 70 67 6e 6f 29 20 29 7b 0a 20 20 20 20 t, pgno) ){.
b3d0: 20 20 72 65 74 75 72 6e 20 31 3b 0a 20 20 20 20 return 1;.
b3e0: 7d 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e 20 30 }. }. return 0
b3f0: 3b 0a 7d 0a 0a 23 69 66 64 65 66 20 53 51 4c 49 ;.}..#ifdef SQLI
b400: 54 45 5f 44 45 42 55 47 0a 2f 2a 0a 2a 2a 20 52 TE_DEBUG./*.** R
b410: 65 74 75 72 6e 20 74 72 75 65 20 69 66 20 74 68 eturn true if th
b420: 65 20 70 61 67 65 20 69 73 20 61 6c 72 65 61 64 e page is alread
b430: 79 20 69 6e 20 74 68 65 20 6a 6f 75 72 6e 61 6c y in the journal
b440: 20 66 69 6c 65 2e 0a 2a 2f 0a 73 74 61 74 69 63 file..*/.static
b450: 20 69 6e 74 20 70 61 67 65 49 6e 4a 6f 75 72 6e int pageInJourn
b460: 61 6c 28 50 61 67 65 72 20 2a 70 50 61 67 65 72 al(Pager *pPager
b470: 2c 20 50 67 48 64 72 20 2a 70 50 67 29 7b 0a 20 , PgHdr *pPg){.
b480: 20 72 65 74 75 72 6e 20 73 71 6c 69 74 65 33 42 return sqlite3B
b490: 69 74 76 65 63 54 65 73 74 28 70 50 61 67 65 72 itvecTest(pPager
b4a0: 2d 3e 70 49 6e 4a 6f 75 72 6e 61 6c 2c 20 70 50 ->pInJournal, pP
b4b0: 67 2d 3e 70 67 6e 6f 29 3b 0a 7d 0a 23 65 6e 64 g->pgno);.}.#end
b4c0: 69 66 0a 0a 2f 2a 0a 2a 2a 20 52 65 61 64 20 61 if../*.** Read a
b4d0: 20 33 32 2d 62 69 74 20 69 6e 74 65 67 65 72 20 32-bit integer
b4e0: 66 72 6f 6d 20 74 68 65 20 67 69 76 65 6e 20 66 from the given f
b4f0: 69 6c 65 20 64 65 73 63 72 69 70 74 6f 72 2e 20 ile descriptor.
b500: 20 53 74 6f 72 65 20 74 68 65 20 69 6e 74 65 67 Store the integ
b510: 65 72 0a 2a 2a 20 74 68 61 74 20 69 73 20 72 65 er.** that is re
b520: 61 64 20 69 6e 20 2a 70 52 65 73 2e 20 20 52 65 ad in *pRes. Re
b530: 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 20 69 turn SQLITE_OK i
b540: 66 20 65 76 65 72 79 74 68 69 6e 67 20 77 6f 72 f everything wor
b550: 6b 65 64 2c 20 6f 72 20 61 6e 0a 2a 2a 20 65 72 ked, or an.** er
b560: 72 6f 72 20 63 6f 64 65 20 69 73 20 73 6f 6d 65 ror code is some
b570: 74 68 69 6e 67 20 67 6f 65 73 20 77 72 6f 6e 67 thing goes wrong
b580: 2e 0a 2a 2a 0a 2a 2a 20 41 6c 6c 20 76 61 6c 75 ..**.** All valu
b590: 65 73 20 61 72 65 20 73 74 6f 72 65 64 20 6f 6e es are stored on
b5a0: 20 64 69 73 6b 20 61 73 20 62 69 67 2d 65 6e 64 disk as big-end
b5b0: 69 61 6e 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 69 ian..*/.static i
b5c0: 6e 74 20 72 65 61 64 33 32 62 69 74 73 28 73 71 nt read32bits(sq
b5d0: 6c 69 74 65 33 5f 66 69 6c 65 20 2a 66 64 2c 20 lite3_file *fd,
b5e0: 69 36 34 20 6f 66 66 73 65 74 2c 20 75 33 32 20 i64 offset, u32
b5f0: 2a 70 52 65 73 29 7b 0a 20 20 75 6e 73 69 67 6e *pRes){. unsign
b600: 65 64 20 63 68 61 72 20 61 63 5b 34 5d 3b 0a 20 ed char ac[4];.
b610: 20 69 6e 74 20 72 63 20 3d 20 73 71 6c 69 74 65 int rc = sqlite
b620: 33 4f 73 52 65 61 64 28 66 64 2c 20 61 63 2c 20 3OsRead(fd, ac,
b630: 73 69 7a 65 6f 66 28 61 63 29 2c 20 6f 66 66 73 sizeof(ac), offs
b640: 65 74 29 3b 0a 20 20 69 66 28 20 72 63 3d 3d 53 et);. if( rc==S
b650: 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 QLITE_OK ){.
b660: 2a 70 52 65 73 20 3d 20 73 71 6c 69 74 65 33 47 *pRes = sqlite3G
b670: 65 74 34 62 79 74 65 28 61 63 29 3b 0a 20 20 7d et4byte(ac);. }
b680: 0a 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 7d 0a . return rc;.}.
b690: 0a 2f 2a 0a 2a 2a 20 57 72 69 74 65 20 61 20 33 ./*.** Write a 3
b6a0: 32 2d 62 69 74 20 69 6e 74 65 67 65 72 20 69 6e 2-bit integer in
b6b0: 74 6f 20 61 20 73 74 72 69 6e 67 20 62 75 66 66 to a string buff
b6c0: 65 72 20 69 6e 20 62 69 67 2d 65 6e 64 69 61 6e er in big-endian
b6d0: 20 62 79 74 65 20 6f 72 64 65 72 2e 0a 2a 2f 0a byte order..*/.
b6e0: 23 64 65 66 69 6e 65 20 70 75 74 33 32 62 69 74 #define put32bit
b6f0: 73 28 41 2c 42 29 20 20 73 71 6c 69 74 65 33 50 s(A,B) sqlite3P
b700: 75 74 34 62 79 74 65 28 28 75 38 2a 29 41 2c 42 ut4byte((u8*)A,B
b710: 29 0a 0a 0a 2f 2a 0a 2a 2a 20 57 72 69 74 65 20 ).../*.** Write
b720: 61 20 33 32 2d 62 69 74 20 69 6e 74 65 67 65 72 a 32-bit integer
b730: 20 69 6e 74 6f 20 74 68 65 20 67 69 76 65 6e 20 into the given
b740: 66 69 6c 65 20 64 65 73 63 72 69 70 74 6f 72 2e file descriptor.
b750: 20 20 52 65 74 75 72 6e 20 53 51 4c 49 54 45 5f Return SQLITE_
b760: 4f 4b 0a 2a 2a 20 6f 6e 20 73 75 63 63 65 73 73 OK.** on success
b770: 20 6f 72 20 61 6e 20 65 72 72 6f 72 20 63 6f 64 or an error cod
b780: 65 20 69 73 20 73 6f 6d 65 74 68 69 6e 67 20 67 e is something g
b790: 6f 65 73 20 77 72 6f 6e 67 2e 0a 2a 2f 0a 73 74 oes wrong..*/.st
b7a0: 61 74 69 63 20 69 6e 74 20 77 72 69 74 65 33 32 atic int write32
b7b0: 62 69 74 73 28 73 71 6c 69 74 65 33 5f 66 69 6c bits(sqlite3_fil
b7c0: 65 20 2a 66 64 2c 20 69 36 34 20 6f 66 66 73 65 e *fd, i64 offse
b7d0: 74 2c 20 75 33 32 20 76 61 6c 29 7b 0a 20 20 63 t, u32 val){. c
b7e0: 68 61 72 20 61 63 5b 34 5d 3b 0a 20 20 70 75 74 har ac[4];. put
b7f0: 33 32 62 69 74 73 28 61 63 2c 20 76 61 6c 29 3b 32bits(ac, val);
b800: 0a 20 20 72 65 74 75 72 6e 20 73 71 6c 69 74 65 . return sqlite
b810: 33 4f 73 57 72 69 74 65 28 66 64 2c 20 61 63 2c 3OsWrite(fd, ac,
b820: 20 34 2c 20 6f 66 66 73 65 74 29 3b 0a 7d 0a 0a 4, offset);.}..
b830: 2f 2a 0a 2a 2a 20 55 6e 6c 6f 63 6b 20 74 68 65 /*.** Unlock the
b840: 20 64 61 74 61 62 61 73 65 20 66 69 6c 65 20 74 database file t
b850: 6f 20 6c 65 76 65 6c 20 65 4c 6f 63 6b 2c 20 77 o level eLock, w
b860: 68 69 63 68 20 6d 75 73 74 20 62 65 20 65 69 74 hich must be eit
b870: 68 65 72 20 4e 4f 5f 4c 4f 43 4b 0a 2a 2a 20 6f her NO_LOCK.** o
b880: 72 20 53 48 41 52 45 44 5f 4c 4f 43 4b 2e 20 52 r SHARED_LOCK. R
b890: 65 67 61 72 64 6c 65 73 73 20 6f 66 20 77 68 65 egardless of whe
b8a0: 74 68 65 72 20 6f 72 20 6e 6f 74 20 74 68 65 20 ther or not the
b8b0: 63 61 6c 6c 20 74 6f 20 78 55 6e 6c 6f 63 6b 28 call to xUnlock(
b8c0: 29 0a 2a 2a 20 73 75 63 63 65 65 64 73 2c 20 73 ).** succeeds, s
b8d0: 65 74 20 74 68 65 20 50 61 67 65 72 2e 65 4c 6f et the Pager.eLo
b8e0: 63 6b 20 76 61 72 69 61 62 6c 65 20 74 6f 20 6d ck variable to m
b8f0: 61 74 63 68 20 74 68 65 20 28 61 74 74 65 6d 70 atch the (attemp
b900: 74 65 64 29 20 6e 65 77 20 6c 6f 63 6b 2e 0a 2a ted) new lock..*
b910: 2a 0a 2a 2a 20 45 78 63 65 70 74 2c 20 69 66 20 *.** Except, if
b920: 50 61 67 65 72 2e 65 4c 6f 63 6b 20 69 73 20 73 Pager.eLock is s
b930: 65 74 20 74 6f 20 55 4e 4b 4e 4f 57 4e 5f 4c 4f et to UNKNOWN_LO
b940: 43 4b 20 77 68 65 6e 20 74 68 69 73 20 66 75 6e CK when this fun
b950: 63 74 69 6f 6e 20 69 73 0a 2a 2a 20 63 61 6c 6c ction is.** call
b960: 65 64 2c 20 64 6f 20 6e 6f 74 20 6d 6f 64 69 66 ed, do not modif
b970: 79 20 69 74 2e 20 53 65 65 20 74 68 65 20 63 6f y it. See the co
b980: 6d 6d 65 6e 74 20 61 62 6f 76 65 20 74 68 65 20 mment above the
b990: 23 64 65 66 69 6e 65 20 6f 66 20 0a 2a 2a 20 55 #define of .** U
b9a0: 4e 4b 4e 4f 57 4e 5f 4c 4f 43 4b 20 66 6f 72 20 NKNOWN_LOCK for
b9b0: 61 6e 20 65 78 70 6c 61 6e 61 74 69 6f 6e 20 6f an explanation o
b9c0: 66 20 74 68 69 73 2e 0a 2a 2f 0a 73 74 61 74 69 f this..*/.stati
b9d0: 63 20 69 6e 74 20 70 61 67 65 72 55 6e 6c 6f 63 c int pagerUnloc
b9e0: 6b 44 62 28 50 61 67 65 72 20 2a 70 50 61 67 65 kDb(Pager *pPage
b9f0: 72 2c 20 69 6e 74 20 65 4c 6f 63 6b 29 7b 0a 20 r, int eLock){.
ba00: 20 69 6e 74 20 72 63 20 3d 20 53 51 4c 49 54 45 int rc = SQLITE
ba10: 5f 4f 4b 3b 0a 0a 20 20 61 73 73 65 72 74 28 20 _OK;.. assert(
ba20: 21 70 50 61 67 65 72 2d 3e 65 78 63 6c 75 73 69 !pPager->exclusi
ba30: 76 65 4d 6f 64 65 20 7c 7c 20 70 50 61 67 65 72 veMode || pPager
ba40: 2d 3e 65 4c 6f 63 6b 3d 3d 65 4c 6f 63 6b 20 29 ->eLock==eLock )
ba50: 3b 0a 20 20 61 73 73 65 72 74 28 20 65 4c 6f 63 ;. assert( eLoc
ba60: 6b 3d 3d 4e 4f 5f 4c 4f 43 4b 20 7c 7c 20 65 4c k==NO_LOCK || eL
ba70: 6f 63 6b 3d 3d 53 48 41 52 45 44 5f 4c 4f 43 4b ock==SHARED_LOCK
ba80: 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 65 4c );. assert( eL
ba90: 6f 63 6b 21 3d 4e 4f 5f 4c 4f 43 4b 20 7c 7c 20 ock!=NO_LOCK ||
baa0: 70 61 67 65 72 55 73 65 57 61 6c 28 70 50 61 67 pagerUseWal(pPag
bab0: 65 72 29 3d 3d 30 20 29 3b 0a 20 20 69 66 28 20 er)==0 );. if(
bac0: 69 73 4f 70 65 6e 28 70 50 61 67 65 72 2d 3e 66 isOpen(pPager->f
bad0: 64 29 20 29 7b 0a 20 20 20 20 61 73 73 65 72 74 d) ){. assert
bae0: 28 20 70 50 61 67 65 72 2d 3e 65 4c 6f 63 6b 3e ( pPager->eLock>
baf0: 3d 65 4c 6f 63 6b 20 29 3b 0a 20 20 20 20 72 63 =eLock );. rc
bb00: 20 3d 20 70 50 61 67 65 72 2d 3e 6e 6f 4c 6f 63 = pPager->noLoc
bb10: 6b 20 3f 20 53 51 4c 49 54 45 5f 4f 4b 20 3a 20 k ? SQLITE_OK :
bb20: 73 71 6c 69 74 65 33 4f 73 55 6e 6c 6f 63 6b 28 sqlite3OsUnlock(
bb30: 70 50 61 67 65 72 2d 3e 66 64 2c 20 65 4c 6f 63 pPager->fd, eLoc
bb40: 6b 29 3b 0a 20 20 20 20 69 66 28 20 70 50 61 67 k);. if( pPag
bb50: 65 72 2d 3e 65 4c 6f 63 6b 21 3d 55 4e 4b 4e 4f er->eLock!=UNKNO
bb60: 57 4e 5f 4c 4f 43 4b 20 29 7b 0a 20 20 20 20 20 WN_LOCK ){.
bb70: 20 70 50 61 67 65 72 2d 3e 65 4c 6f 63 6b 20 3d pPager->eLock =
bb80: 20 28 75 38 29 65 4c 6f 63 6b 3b 0a 20 20 20 20 (u8)eLock;.
bb90: 7d 0a 20 20 20 20 49 4f 54 52 41 43 45 28 28 22 }. IOTRACE(("
bba0: 55 4e 4c 4f 43 4b 20 25 70 20 25 64 5c 6e 22 2c UNLOCK %p %d\n",
bbb0: 20 70 50 61 67 65 72 2c 20 65 4c 6f 63 6b 29 29 pPager, eLock))
bbc0: 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e 20 72 63 . }. return rc
bbd0: 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 4c 6f 63 6b 20 ;.}../*.** Lock
bbe0: 74 68 65 20 64 61 74 61 62 61 73 65 20 66 69 6c the database fil
bbf0: 65 20 74 6f 20 6c 65 76 65 6c 20 65 4c 6f 63 6b e to level eLock
bc00: 2c 20 77 68 69 63 68 20 6d 75 73 74 20 62 65 20 , which must be
bc10: 65 69 74 68 65 72 20 53 48 41 52 45 44 5f 4c 4f either SHARED_LO
bc20: 43 4b 2c 0a 2a 2a 20 52 45 53 45 52 56 45 44 5f CK,.** RESERVED_
bc30: 4c 4f 43 4b 20 6f 72 20 45 58 43 4c 55 53 49 56 LOCK or EXCLUSIV
bc40: 45 5f 4c 4f 43 4b 2e 20 49 66 20 74 68 65 20 63 E_LOCK. If the c
bc50: 61 6c 6c 65 72 20 69 73 20 73 75 63 63 65 73 73 aller is success
bc60: 66 75 6c 2c 20 73 65 74 20 74 68 65 0a 2a 2a 20 ful, set the.**
bc70: 50 61 67 65 72 2e 65 4c 6f 63 6b 20 76 61 72 69 Pager.eLock vari
bc80: 61 62 6c 65 20 74 6f 20 74 68 65 20 6e 65 77 20 able to the new
bc90: 6c 6f 63 6b 69 6e 67 20 73 74 61 74 65 2e 20 0a locking state. .
bca0: 2a 2a 0a 2a 2a 20 45 78 63 65 70 74 2c 20 69 66 **.** Except, if
bcb0: 20 50 61 67 65 72 2e 65 4c 6f 63 6b 20 69 73 20 Pager.eLock is
bcc0: 73 65 74 20 74 6f 20 55 4e 4b 4e 4f 57 4e 5f 4c set to UNKNOWN_L
bcd0: 4f 43 4b 20 77 68 65 6e 20 74 68 69 73 20 66 75 OCK when this fu
bce0: 6e 63 74 69 6f 6e 20 69 73 20 0a 2a 2a 20 63 61 nction is .** ca
bcf0: 6c 6c 65 64 2c 20 64 6f 20 6e 6f 74 20 6d 6f 64 lled, do not mod
bd00: 69 66 79 20 69 74 20 75 6e 6c 65 73 73 20 74 68 ify it unless th
bd10: 65 20 6e 65 77 20 6c 6f 63 6b 69 6e 67 20 73 74 e new locking st
bd20: 61 74 65 20 69 73 20 45 58 43 4c 55 53 49 56 45 ate is EXCLUSIVE
bd30: 5f 4c 4f 43 4b 2e 20 0a 2a 2a 20 53 65 65 20 74 _LOCK. .** See t
bd40: 68 65 20 63 6f 6d 6d 65 6e 74 20 61 62 6f 76 65 he comment above
bd50: 20 74 68 65 20 23 64 65 66 69 6e 65 20 6f 66 20 the #define of
bd60: 55 4e 4b 4e 4f 57 4e 5f 4c 4f 43 4b 20 66 6f 72 UNKNOWN_LOCK for
bd70: 20 61 6e 20 65 78 70 6c 61 6e 61 74 69 6f 6e 20 an explanation
bd80: 0a 2a 2a 20 6f 66 20 74 68 69 73 2e 0a 2a 2f 0a .** of this..*/.
bd90: 73 74 61 74 69 63 20 69 6e 74 20 70 61 67 65 72 static int pager
bda0: 4c 6f 63 6b 44 62 28 50 61 67 65 72 20 2a 70 50 LockDb(Pager *pP
bdb0: 61 67 65 72 2c 20 69 6e 74 20 65 4c 6f 63 6b 29 ager, int eLock)
bdc0: 7b 0a 20 20 69 6e 74 20 72 63 20 3d 20 53 51 4c {. int rc = SQL
bdd0: 49 54 45 5f 4f 4b 3b 0a 0a 20 20 61 73 73 65 72 ITE_OK;.. asser
bde0: 74 28 20 65 4c 6f 63 6b 3d 3d 53 48 41 52 45 44 t( eLock==SHARED
bdf0: 5f 4c 4f 43 4b 20 7c 7c 20 65 4c 6f 63 6b 3d 3d _LOCK || eLock==
be00: 52 45 53 45 52 56 45 44 5f 4c 4f 43 4b 20 7c 7c RESERVED_LOCK ||
be10: 20 65 4c 6f 63 6b 3d 3d 45 58 43 4c 55 53 49 56 eLock==EXCLUSIV
be20: 45 5f 4c 4f 43 4b 20 29 3b 0a 20 20 69 66 28 20 E_LOCK );. if(
be30: 70 50 61 67 65 72 2d 3e 65 4c 6f 63 6b 3c 65 4c pPager->eLock<eL
be40: 6f 63 6b 20 7c 7c 20 70 50 61 67 65 72 2d 3e 65 ock || pPager->e
be50: 4c 6f 63 6b 3d 3d 55 4e 4b 4e 4f 57 4e 5f 4c 4f Lock==UNKNOWN_LO
be60: 43 4b 20 29 7b 0a 20 20 20 20 72 63 20 3d 20 70 CK ){. rc = p
be70: 50 61 67 65 72 2d 3e 6e 6f 4c 6f 63 6b 20 3f 20 Pager->noLock ?
be80: 53 51 4c 49 54 45 5f 4f 4b 20 3a 20 73 71 6c 69 SQLITE_OK : sqli
be90: 74 65 33 4f 73 4c 6f 63 6b 28 70 50 61 67 65 72 te3OsLock(pPager
bea0: 2d 3e 66 64 2c 20 65 4c 6f 63 6b 29 3b 0a 20 20 ->fd, eLock);.
beb0: 20 20 69 66 28 20 72 63 3d 3d 53 51 4c 49 54 45 if( rc==SQLITE
bec0: 5f 4f 4b 20 26 26 20 28 70 50 61 67 65 72 2d 3e _OK && (pPager->
bed0: 65 4c 6f 63 6b 21 3d 55 4e 4b 4e 4f 57 4e 5f 4c eLock!=UNKNOWN_L
bee0: 4f 43 4b 7c 7c 65 4c 6f 63 6b 3d 3d 45 58 43 4c OCK||eLock==EXCL
bef0: 55 53 49 56 45 5f 4c 4f 43 4b 29 20 29 7b 0a 20 USIVE_LOCK) ){.
bf00: 20 20 20 20 20 70 50 61 67 65 72 2d 3e 65 4c 6f pPager->eLo
bf10: 63 6b 20 3d 20 28 75 38 29 65 4c 6f 63 6b 3b 0a ck = (u8)eLock;.
bf20: 20 20 20 20 20 20 49 4f 54 52 41 43 45 28 28 22 IOTRACE(("
bf30: 4c 4f 43 4b 20 25 70 20 25 64 5c 6e 22 2c 20 70 LOCK %p %d\n", p
bf40: 50 61 67 65 72 2c 20 65 4c 6f 63 6b 29 29 0a 20 Pager, eLock)).
bf50: 20 20 20 7d 0a 20 20 7d 0a 20 20 72 65 74 75 72 }. }. retur
bf60: 6e 20 72 63 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 54 n rc;.}../*.** T
bf70: 68 69 73 20 66 75 6e 63 74 69 6f 6e 20 64 65 74 his function det
bf80: 65 72 6d 69 6e 65 73 20 77 68 65 74 68 65 72 20 ermines whether
bf90: 6f 72 20 6e 6f 74 20 74 68 65 20 61 74 6f 6d 69 or not the atomi
bfa0: 63 2d 77 72 69 74 65 20 6f 70 74 69 6d 69 7a 61 c-write optimiza
bfb0: 74 69 6f 6e 0a 2a 2a 20 63 61 6e 20 62 65 20 75 tion.** can be u
bfc0: 73 65 64 20 77 69 74 68 20 74 68 69 73 20 70 61 sed with this pa
bfd0: 67 65 72 2e 20 54 68 65 20 6f 70 74 69 6d 69 7a ger. The optimiz
bfe0: 61 74 69 6f 6e 20 63 61 6e 20 62 65 20 75 73 65 ation can be use
bff0: 64 20 69 66 3a 0a 2a 2a 0a 2a 2a 20 20 28 61 29 d if:.**.** (a)
c000: 20 74 68 65 20 76 61 6c 75 65 20 72 65 74 75 72 the value retur
c010: 6e 65 64 20 62 79 20 4f 73 44 65 76 69 63 65 43 ned by OsDeviceC
c020: 68 61 72 61 63 74 65 72 69 73 74 69 63 73 28 29 haracteristics()
c030: 20 69 6e 64 69 63 61 74 65 73 20 74 68 61 74 0a indicates that.
c040: 2a 2a 20 20 20 20 20 20 61 20 64 61 74 61 62 61 ** a databa
c050: 73 65 20 70 61 67 65 20 6d 61 79 20 62 65 20 77 se page may be w
c060: 72 69 74 74 65 6e 20 61 74 6f 6d 69 63 61 6c 6c ritten atomicall
c070: 79 2c 20 61 6e 64 0a 2a 2a 20 20 28 62 29 20 74 y, and.** (b) t
c080: 68 65 20 76 61 6c 75 65 20 72 65 74 75 72 6e 65 he value returne
c090: 64 20 62 79 20 4f 73 53 65 63 74 6f 72 53 69 7a d by OsSectorSiz
c0a0: 65 28 29 20 69 73 20 6c 65 73 73 20 74 68 61 6e e() is less than
c0b0: 20 6f 72 20 65 71 75 61 6c 0a 2a 2a 20 20 20 20 or equal.**
c0c0: 20 20 74 6f 20 74 68 65 20 70 61 67 65 20 73 69 to the page si
c0d0: 7a 65 2e 0a 2a 2a 0a 2a 2a 20 54 68 65 20 6f 70 ze..**.** The op
c0e0: 74 69 6d 69 7a 61 74 69 6f 6e 20 69 73 20 61 6c timization is al
c0f0: 73 6f 20 61 6c 77 61 79 73 20 65 6e 61 62 6c 65 so always enable
c100: 64 20 66 6f 72 20 74 65 6d 70 6f 72 61 72 79 20 d for temporary
c110: 66 69 6c 65 73 2e 20 49 74 20 69 73 0a 2a 2a 20 files. It is.**
c120: 61 6e 20 65 72 72 6f 72 20 74 6f 20 63 61 6c 6c an error to call
c130: 20 74 68 69 73 20 66 75 6e 63 74 69 6f 6e 20 69 this function i
c140: 66 20 70 50 61 67 65 72 20 69 73 20 6f 70 65 6e f pPager is open
c150: 65 64 20 6f 6e 20 61 6e 20 69 6e 2d 6d 65 6d 6f ed on an in-memo
c160: 72 79 0a 2a 2a 20 64 61 74 61 62 61 73 65 2e 0a ry.** database..
c170: 2a 2a 0a 2a 2a 20 49 66 20 74 68 65 20 6f 70 74 **.** If the opt
c180: 69 6d 69 7a 61 74 69 6f 6e 20 63 61 6e 6e 6f 74 imization cannot
c190: 20 62 65 20 75 73 65 64 2c 20 30 20 69 73 20 72 be used, 0 is r
c1a0: 65 74 75 72 6e 65 64 2e 20 49 66 20 69 74 20 63 eturned. If it c
c1b0: 61 6e 20 62 65 20 75 73 65 64 2c 0a 2a 2a 20 74 an be used,.** t
c1c0: 68 65 6e 20 74 68 65 20 76 61 6c 75 65 20 72 65 hen the value re
c1d0: 74 75 72 6e 65 64 20 69 73 20 74 68 65 20 73 69 turned is the si
c1e0: 7a 65 20 6f 66 20 74 68 65 20 6a 6f 75 72 6e 61 ze of the journa
c1f0: 6c 20 66 69 6c 65 20 77 68 65 6e 20 69 74 0a 2a l file when it.*
c200: 2a 20 63 6f 6e 74 61 69 6e 73 20 72 6f 6c 6c 62 * contains rollb
c210: 61 63 6b 20 64 61 74 61 20 66 6f 72 20 65 78 61 ack data for exa
c220: 63 74 6c 79 20 6f 6e 65 20 70 61 67 65 2e 0a 2a ctly one page..*
c230: 2f 0a 23 69 66 64 65 66 20 53 51 4c 49 54 45 5f /.#ifdef SQLITE_
c240: 45 4e 41 42 4c 45 5f 41 54 4f 4d 49 43 5f 57 52 ENABLE_ATOMIC_WR
c250: 49 54 45 0a 73 74 61 74 69 63 20 69 6e 74 20 6a ITE.static int j
c260: 72 6e 6c 42 75 66 66 65 72 53 69 7a 65 28 50 61 rnlBufferSize(Pa
c270: 67 65 72 20 2a 70 50 61 67 65 72 29 7b 0a 20 20 ger *pPager){.
c280: 61 73 73 65 72 74 28 20 21 4d 45 4d 44 42 20 29 assert( !MEMDB )
c290: 3b 0a 20 20 69 66 28 20 21 70 50 61 67 65 72 2d ;. if( !pPager-
c2a0: 3e 74 65 6d 70 46 69 6c 65 20 29 7b 0a 20 20 20 >tempFile ){.
c2b0: 20 69 6e 74 20 64 63 3b 20 20 20 20 20 20 20 20 int dc;
c2c0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
c2d0: 20 20 20 2f 2a 20 44 65 76 69 63 65 20 63 68 61 /* Device cha
c2e0: 72 61 63 74 65 72 69 73 74 69 63 73 20 2a 2f 0a racteristics */.
c2f0: 20 20 20 20 69 6e 74 20 6e 53 65 63 74 6f 72 3b int nSector;
c300: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
c310: 20 20 20 20 20 20 2f 2a 20 53 65 63 74 6f 72 20 /* Sector
c320: 73 69 7a 65 20 2a 2f 0a 20 20 20 20 69 6e 74 20 size */. int
c330: 73 7a 50 61 67 65 3b 20 20 20 20 20 20 20 20 20 szPage;
c340: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a /*
c350: 20 50 61 67 65 20 73 69 7a 65 20 2a 2f 0a 0a 20 Page size */..
c360: 20 20 20 61 73 73 65 72 74 28 20 69 73 4f 70 65 assert( isOpe
c370: 6e 28 70 50 61 67 65 72 2d 3e 66 64 29 20 29 3b n(pPager->fd) );
c380: 0a 20 20 20 20 64 63 20 3d 20 73 71 6c 69 74 65 . dc = sqlite
c390: 33 4f 73 44 65 76 69 63 65 43 68 61 72 61 63 74 3OsDeviceCharact
c3a0: 65 72 69 73 74 69 63 73 28 70 50 61 67 65 72 2d eristics(pPager-
c3b0: 3e 66 64 29 3b 0a 20 20 20 20 6e 53 65 63 74 6f >fd);. nSecto
c3c0: 72 20 3d 20 70 50 61 67 65 72 2d 3e 73 65 63 74 r = pPager->sect
c3d0: 6f 72 53 69 7a 65 3b 0a 20 20 20 20 73 7a 50 61 orSize;. szPa
c3e0: 67 65 20 3d 20 70 50 61 67 65 72 2d 3e 70 61 67 ge = pPager->pag
c3f0: 65 53 69 7a 65 3b 0a 0a 20 20 20 20 61 73 73 65 eSize;.. asse
c400: 72 74 28 53 51 4c 49 54 45 5f 49 4f 43 41 50 5f rt(SQLITE_IOCAP_
c410: 41 54 4f 4d 49 43 35 31 32 3d 3d 28 35 31 32 3e ATOMIC512==(512>
c420: 3e 38 29 29 3b 0a 20 20 20 20 61 73 73 65 72 74 >8));. assert
c430: 28 53 51 4c 49 54 45 5f 49 4f 43 41 50 5f 41 54 (SQLITE_IOCAP_AT
c440: 4f 4d 49 43 36 34 4b 3d 3d 28 36 35 35 33 36 3e OMIC64K==(65536>
c450: 3e 38 29 29 3b 0a 20 20 20 20 69 66 28 20 30 3d >8));. if( 0=
c460: 3d 28 64 63 26 28 53 51 4c 49 54 45 5f 49 4f 43 =(dc&(SQLITE_IOC
c470: 41 50 5f 41 54 4f 4d 49 43 7c 28 73 7a 50 61 67 AP_ATOMIC|(szPag
c480: 65 3e 3e 38 29 29 20 7c 7c 20 6e 53 65 63 74 6f e>>8)) || nSecto
c490: 72 3e 73 7a 50 61 67 65 29 20 29 7b 0a 20 20 20 r>szPage) ){.
c4a0: 20 20 20 72 65 74 75 72 6e 20 30 3b 0a 20 20 20 return 0;.
c4b0: 20 7d 0a 20 20 7d 0a 0a 20 20 72 65 74 75 72 6e }. }.. return
c4c0: 20 4a 4f 55 52 4e 41 4c 5f 48 44 52 5f 53 5a 28 JOURNAL_HDR_SZ(
c4d0: 70 50 61 67 65 72 29 20 2b 20 4a 4f 55 52 4e 41 pPager) + JOURNA
c4e0: 4c 5f 50 47 5f 53 5a 28 70 50 61 67 65 72 29 3b L_PG_SZ(pPager);
c4f0: 0a 7d 0a 23 65 6c 73 65 0a 23 20 64 65 66 69 6e .}.#else.# defin
c500: 65 20 6a 72 6e 6c 42 75 66 66 65 72 53 69 7a 65 e jrnlBufferSize
c510: 28 78 29 20 30 0a 23 65 6e 64 69 66 0a 0a 2f 2a (x) 0.#endif../*
c520: 0a 2a 2a 20 49 66 20 53 51 4c 49 54 45 5f 43 48 .** If SQLITE_CH
c530: 45 43 4b 5f 50 41 47 45 53 20 69 73 20 64 65 66 ECK_PAGES is def
c540: 69 6e 65 64 20 74 68 65 6e 20 77 65 20 64 6f 20 ined then we do
c550: 73 6f 6d 65 20 73 61 6e 69 74 79 20 63 68 65 63 some sanity chec
c560: 6b 69 6e 67 0a 2a 2a 20 6f 6e 20 74 68 65 20 63 king.** on the c
c570: 61 63 68 65 20 75 73 69 6e 67 20 61 20 68 61 73 ache using a has
c580: 68 20 66 75 6e 63 74 69 6f 6e 2e 20 20 54 68 69 h function. Thi
c590: 73 20 69 73 20 75 73 65 64 20 66 6f 72 20 74 65 s is used for te
c5a0: 73 74 69 6e 67 0a 2a 2a 20 61 6e 64 20 64 65 62 sting.** and deb
c5b0: 75 67 67 69 6e 67 20 6f 6e 6c 79 2e 0a 2a 2f 0a ugging only..*/.
c5c0: 23 69 66 64 65 66 20 53 51 4c 49 54 45 5f 43 48 #ifdef SQLITE_CH
c5d0: 45 43 4b 5f 50 41 47 45 53 0a 2f 2a 0a 2a 2a 20 ECK_PAGES./*.**
c5e0: 52 65 74 75 72 6e 20 61 20 33 32 2d 62 69 74 20 Return a 32-bit
c5f0: 68 61 73 68 20 6f 66 20 74 68 65 20 70 61 67 65 hash of the page
c600: 20 64 61 74 61 20 66 6f 72 20 70 50 61 67 65 2e data for pPage.
c610: 0a 2a 2f 0a 73 74 61 74 69 63 20 75 33 32 20 70 .*/.static u32 p
c620: 61 67 65 72 5f 64 61 74 61 68 61 73 68 28 69 6e ager_datahash(in
c630: 74 20 6e 42 79 74 65 2c 20 75 6e 73 69 67 6e 65 t nByte, unsigne
c640: 64 20 63 68 61 72 20 2a 70 44 61 74 61 29 7b 0a d char *pData){.
c650: 20 20 75 33 32 20 68 61 73 68 20 3d 20 30 3b 0a u32 hash = 0;.
c660: 20 20 69 6e 74 20 69 3b 0a 20 20 66 6f 72 28 69 int i;. for(i
c670: 3d 30 3b 20 69 3c 6e 42 79 74 65 3b 20 69 2b 2b =0; i<nByte; i++
c680: 29 7b 0a 20 20 20 20 68 61 73 68 20 3d 20 28 68 ){. hash = (h
c690: 61 73 68 2a 31 30 33 39 29 20 2b 20 70 44 61 74 ash*1039) + pDat
c6a0: 61 5b 69 5d 3b 0a 20 20 7d 0a 20 20 72 65 74 75 a[i];. }. retu
c6b0: 72 6e 20 68 61 73 68 3b 0a 7d 0a 73 74 61 74 69 rn hash;.}.stati
c6c0: 63 20 75 33 32 20 70 61 67 65 72 5f 70 61 67 65 c u32 pager_page
c6d0: 68 61 73 68 28 50 67 48 64 72 20 2a 70 50 61 67 hash(PgHdr *pPag
c6e0: 65 29 7b 0a 20 20 72 65 74 75 72 6e 20 70 61 67 e){. return pag
c6f0: 65 72 5f 64 61 74 61 68 61 73 68 28 70 50 61 67 er_datahash(pPag
c700: 65 2d 3e 70 50 61 67 65 72 2d 3e 70 61 67 65 53 e->pPager->pageS
c710: 69 7a 65 2c 20 28 75 6e 73 69 67 6e 65 64 20 63 ize, (unsigned c
c720: 68 61 72 20 2a 29 70 50 61 67 65 2d 3e 70 44 61 har *)pPage->pDa
c730: 74 61 29 3b 0a 7d 0a 73 74 61 74 69 63 20 76 6f ta);.}.static vo
c740: 69 64 20 70 61 67 65 72 5f 73 65 74 5f 70 61 67 id pager_set_pag
c750: 65 68 61 73 68 28 50 67 48 64 72 20 2a 70 50 61 ehash(PgHdr *pPa
c760: 67 65 29 7b 0a 20 20 70 50 61 67 65 2d 3e 70 61 ge){. pPage->pa
c770: 67 65 48 61 73 68 20 3d 20 70 61 67 65 72 5f 70 geHash = pager_p
c780: 61 67 65 68 61 73 68 28 70 50 61 67 65 29 3b 0a agehash(pPage);.
c790: 7d 0a 0a 2f 2a 0a 2a 2a 20 54 68 65 20 43 48 45 }../*.** The CHE
c7a0: 43 4b 5f 50 41 47 45 20 6d 61 63 72 6f 20 74 61 CK_PAGE macro ta
c7b0: 6b 65 73 20 61 20 50 67 48 64 72 2a 20 61 73 20 kes a PgHdr* as
c7c0: 61 6e 20 61 72 67 75 6d 65 6e 74 2e 20 49 66 20 an argument. If
c7d0: 53 51 4c 49 54 45 5f 43 48 45 43 4b 5f 50 41 47 SQLITE_CHECK_PAG
c7e0: 45 53 0a 2a 2a 20 69 73 20 64 65 66 69 6e 65 64 ES.** is defined
c7f0: 2c 20 61 6e 64 20 4e 44 45 42 55 47 20 69 73 20 , and NDEBUG is
c800: 6e 6f 74 20 64 65 66 69 6e 65 64 2c 20 61 6e 20 not defined, an
c810: 61 73 73 65 72 74 28 29 20 73 74 61 74 65 6d 65 assert() stateme
c820: 6e 74 20 63 68 65 63 6b 73 0a 2a 2a 20 74 68 61 nt checks.** tha
c830: 74 20 74 68 65 20 70 61 67 65 20 69 73 20 65 69 t the page is ei
c840: 74 68 65 72 20 64 69 72 74 79 20 6f 72 20 73 74 ther dirty or st
c850: 69 6c 6c 20 6d 61 74 63 68 65 73 20 74 68 65 20 ill matches the
c860: 63 61 6c 63 75 6c 61 74 65 64 20 70 61 67 65 2d calculated page-
c870: 68 61 73 68 2e 0a 2a 2f 0a 23 64 65 66 69 6e 65 hash..*/.#define
c880: 20 43 48 45 43 4b 5f 50 41 47 45 28 78 29 20 63 CHECK_PAGE(x) c
c890: 68 65 63 6b 50 61 67 65 28 78 29 0a 73 74 61 74 heckPage(x).stat
c8a0: 69 63 20 76 6f 69 64 20 63 68 65 63 6b 50 61 67 ic void checkPag
c8b0: 65 28 50 67 48 64 72 20 2a 70 50 67 29 7b 0a 20 e(PgHdr *pPg){.
c8c0: 20 50 61 67 65 72 20 2a 70 50 61 67 65 72 20 3d Pager *pPager =
c8d0: 20 70 50 67 2d 3e 70 50 61 67 65 72 3b 0a 20 20 pPg->pPager;.
c8e0: 61 73 73 65 72 74 28 20 70 50 61 67 65 72 2d 3e assert( pPager->
c8f0: 65 53 74 61 74 65 21 3d 50 41 47 45 52 5f 45 52 eState!=PAGER_ER
c900: 52 4f 52 20 29 3b 0a 20 20 61 73 73 65 72 74 28 ROR );. assert(
c910: 20 28 70 50 67 2d 3e 66 6c 61 67 73 26 50 47 48 (pPg->flags&PGH
c920: 44 52 5f 44 49 52 54 59 29 20 7c 7c 20 70 50 67 DR_DIRTY) || pPg
c930: 2d 3e 70 61 67 65 48 61 73 68 3d 3d 70 61 67 65 ->pageHash==page
c940: 72 5f 70 61 67 65 68 61 73 68 28 70 50 67 29 20 r_pagehash(pPg)
c950: 29 3b 0a 7d 0a 0a 23 65 6c 73 65 0a 23 64 65 66 );.}..#else.#def
c960: 69 6e 65 20 70 61 67 65 72 5f 64 61 74 61 68 61 ine pager_dataha
c970: 73 68 28 58 2c 59 29 20 20 30 0a 23 64 65 66 69 sh(X,Y) 0.#defi
c980: 6e 65 20 70 61 67 65 72 5f 70 61 67 65 68 61 73 ne pager_pagehas
c990: 68 28 58 29 20 20 30 0a 23 64 65 66 69 6e 65 20 h(X) 0.#define
c9a0: 70 61 67 65 72 5f 73 65 74 5f 70 61 67 65 68 61 pager_set_pageha
c9b0: 73 68 28 58 29 0a 23 64 65 66 69 6e 65 20 43 48 sh(X).#define CH
c9c0: 45 43 4b 5f 50 41 47 45 28 78 29 0a 23 65 6e 64 ECK_PAGE(x).#end
c9d0: 69 66 20 20 2f 2a 20 53 51 4c 49 54 45 5f 43 48 if /* SQLITE_CH
c9e0: 45 43 4b 5f 50 41 47 45 53 20 2a 2f 0a 0a 2f 2a ECK_PAGES */../*
c9f0: 0a 2a 2a 20 57 68 65 6e 20 74 68 69 73 20 69 73 .** When this is
ca00: 20 63 61 6c 6c 65 64 20 74 68 65 20 6a 6f 75 72 called the jour
ca10: 6e 61 6c 20 66 69 6c 65 20 66 6f 72 20 70 61 67 nal file for pag
ca20: 65 72 20 70 50 61 67 65 72 20 6d 75 73 74 20 62 er pPager must b
ca30: 65 20 6f 70 65 6e 2e 0a 2a 2a 20 54 68 69 73 20 e open..** This
ca40: 66 75 6e 63 74 69 6f 6e 20 61 74 74 65 6d 70 74 function attempt
ca50: 73 20 74 6f 20 72 65 61 64 20 61 20 6d 61 73 74 s to read a mast
ca60: 65 72 20 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 20 er journal file
ca70: 6e 61 6d 65 20 66 72 6f 6d 20 74 68 65 20 0a 2a name from the .*
ca80: 2a 20 65 6e 64 20 6f 66 20 74 68 65 20 66 69 6c * end of the fil
ca90: 65 20 61 6e 64 2c 20 69 66 20 73 75 63 63 65 73 e and, if succes
caa0: 73 66 75 6c 2c 20 63 6f 70 69 65 73 20 69 74 20 sful, copies it
cab0: 69 6e 74 6f 20 6d 65 6d 6f 72 79 20 73 75 70 70 into memory supp
cac0: 6c 69 65 64 20 0a 2a 2a 20 62 79 20 74 68 65 20 lied .** by the
cad0: 63 61 6c 6c 65 72 2e 20 53 65 65 20 63 6f 6d 6d caller. See comm
cae0: 65 6e 74 73 20 61 62 6f 76 65 20 77 72 69 74 65 ents above write
caf0: 4d 61 73 74 65 72 4a 6f 75 72 6e 61 6c 28 29 20 MasterJournal()
cb00: 66 6f 72 20 74 68 65 20 66 6f 72 6d 61 74 0a 2a for the format.*
cb10: 2a 20 75 73 65 64 20 74 6f 20 73 74 6f 72 65 20 * used to store
cb20: 61 20 6d 61 73 74 65 72 20 6a 6f 75 72 6e 61 6c a master journal
cb30: 20 66 69 6c 65 20 6e 61 6d 65 20 61 74 20 74 68 file name at th
cb40: 65 20 65 6e 64 20 6f 66 20 61 20 6a 6f 75 72 6e e end of a journ
cb50: 61 6c 20 66 69 6c 65 2e 0a 2a 2a 0a 2a 2a 20 7a al file..**.** z
cb60: 4d 61 73 74 65 72 20 6d 75 73 74 20 70 6f 69 6e Master must poin
cb70: 74 20 74 6f 20 61 20 62 75 66 66 65 72 20 6f 66 t to a buffer of
cb80: 20 61 74 20 6c 65 61 73 74 20 6e 4d 61 73 74 65 at least nMaste
cb90: 72 20 62 79 74 65 73 20 61 6c 6c 6f 63 61 74 65 r bytes allocate
cba0: 64 20 62 79 0a 2a 2a 20 74 68 65 20 63 61 6c 6c d by.** the call
cbb0: 65 72 2e 20 54 68 69 73 20 73 68 6f 75 6c 64 20 er. This should
cbc0: 62 65 20 73 71 6c 69 74 65 33 5f 76 66 73 2e 6d be sqlite3_vfs.m
cbd0: 78 50 61 74 68 6e 61 6d 65 2b 31 20 28 74 6f 20 xPathname+1 (to
cbe0: 65 6e 73 75 72 65 20 74 68 65 72 65 20 69 73 0a ensure there is.
cbf0: 2a 2a 20 65 6e 6f 75 67 68 20 73 70 61 63 65 20 ** enough space
cc00: 74 6f 20 77 72 69 74 65 20 74 68 65 20 6d 61 73 to write the mas
cc10: 74 65 72 20 6a 6f 75 72 6e 61 6c 20 6e 61 6d 65 ter journal name
cc20: 29 2e 20 49 66 20 74 68 65 20 6d 61 73 74 65 72 ). If the master
cc30: 20 6a 6f 75 72 6e 61 6c 0a 2a 2a 20 6e 61 6d 65 journal.** name
cc40: 20 69 6e 20 74 68 65 20 6a 6f 75 72 6e 61 6c 20 in the journal
cc50: 69 73 20 6c 6f 6e 67 65 72 20 74 68 61 6e 20 6e is longer than n
cc60: 4d 61 73 74 65 72 20 62 79 74 65 73 20 28 69 6e Master bytes (in
cc70: 63 6c 75 64 69 6e 67 20 61 0a 2a 2a 20 6e 75 6c cluding a.** nul
cc80: 2d 74 65 72 6d 69 6e 61 74 6f 72 29 2c 20 74 68 -terminator), th
cc90: 65 6e 20 74 68 69 73 20 69 73 20 68 61 6e 64 6c en this is handl
cca0: 65 64 20 61 73 20 69 66 20 6e 6f 20 6d 61 73 74 ed as if no mast
ccb0: 65 72 20 6a 6f 75 72 6e 61 6c 20 6e 61 6d 65 0a er journal name.
ccc0: 2a 2a 20 77 65 72 65 20 70 72 65 73 65 6e 74 20 ** were present
ccd0: 69 6e 20 74 68 65 20 6a 6f 75 72 6e 61 6c 2e 0a in the journal..
cce0: 2a 2a 0a 2a 2a 20 49 66 20 61 20 6d 61 73 74 65 **.** If a maste
ccf0: 72 20 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 20 6e r journal file n
cd00: 61 6d 65 20 69 73 20 70 72 65 73 65 6e 74 20 61 ame is present a
cd10: 74 20 74 68 65 20 65 6e 64 20 6f 66 20 74 68 65 t the end of the
cd20: 20 6a 6f 75 72 6e 61 6c 0a 2a 2a 20 66 69 6c 65 journal.** file
cd30: 2c 20 74 68 65 6e 20 69 74 20 69 73 20 63 6f 70 , then it is cop
cd40: 69 65 64 20 69 6e 74 6f 20 74 68 65 20 62 75 66 ied into the buf
cd50: 66 65 72 20 70 6f 69 6e 74 65 64 20 74 6f 20 62 fer pointed to b
cd60: 79 20 7a 4d 61 73 74 65 72 2e 20 41 0a 2a 2a 20 y zMaster. A.**
cd70: 6e 75 6c 2d 74 65 72 6d 69 6e 61 74 6f 72 20 62 nul-terminator b
cd80: 79 74 65 20 69 73 20 61 70 70 65 6e 64 65 64 20 yte is appended
cd90: 74 6f 20 74 68 65 20 62 75 66 66 65 72 20 66 6f to the buffer fo
cda0: 6c 6c 6f 77 69 6e 67 20 74 68 65 20 6d 61 73 74 llowing the mast
cdb0: 65 72 0a 2a 2a 20 6a 6f 75 72 6e 61 6c 20 66 69 er.** journal fi
cdc0: 6c 65 20 6e 61 6d 65 2e 0a 2a 2a 0a 2a 2a 20 49 le name..**.** I
cdd0: 66 20 69 74 20 69 73 20 64 65 74 65 72 6d 69 6e f it is determin
cde0: 65 64 20 74 68 61 74 20 6e 6f 20 6d 61 73 74 65 ed that no maste
cdf0: 72 20 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 20 6e r journal file n
ce00: 61 6d 65 20 69 73 20 70 72 65 73 65 6e 74 20 0a ame is present .
ce10: 2a 2a 20 7a 4d 61 73 74 65 72 5b 30 5d 20 69 73 ** zMaster[0] is
ce20: 20 73 65 74 20 74 6f 20 30 20 61 6e 64 20 53 51 set to 0 and SQ
ce30: 4c 49 54 45 5f 4f 4b 20 72 65 74 75 72 6e 65 64 LITE_OK returned
ce40: 2e 0a 2a 2a 0a 2a 2a 20 49 66 20 61 6e 20 65 72 ..**.** If an er
ce50: 72 6f 72 20 6f 63 63 75 72 73 20 77 68 69 6c 65 ror occurs while
ce60: 20 72 65 61 64 69 6e 67 20 66 72 6f 6d 20 74 68 reading from th
ce70: 65 20 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 2c 20 e journal file,
ce80: 61 6e 20 53 51 4c 69 74 65 0a 2a 2a 20 65 72 72 an SQLite.** err
ce90: 6f 72 20 63 6f 64 65 20 69 73 20 72 65 74 75 72 or code is retur
cea0: 6e 65 64 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 69 ned..*/.static i
ceb0: 6e 74 20 72 65 61 64 4d 61 73 74 65 72 4a 6f 75 nt readMasterJou
cec0: 72 6e 61 6c 28 73 71 6c 69 74 65 33 5f 66 69 6c rnal(sqlite3_fil
ced0: 65 20 2a 70 4a 72 6e 6c 2c 20 63 68 61 72 20 2a e *pJrnl, char *
cee0: 7a 4d 61 73 74 65 72 2c 20 75 33 32 20 6e 4d 61 zMaster, u32 nMa
cef0: 73 74 65 72 29 7b 0a 20 20 69 6e 74 20 72 63 3b ster){. int rc;
cf00: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
cf10: 20 20 20 20 2f 2a 20 52 65 74 75 72 6e 20 63 6f /* Return co
cf20: 64 65 20 2a 2f 0a 20 20 75 33 32 20 6c 65 6e 3b de */. u32 len;
cf30: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
cf40: 20 20 20 2f 2a 20 4c 65 6e 67 74 68 20 69 6e 20 /* Length in
cf50: 62 79 74 65 73 20 6f 66 20 6d 61 73 74 65 72 20 bytes of master
cf60: 6a 6f 75 72 6e 61 6c 20 6e 61 6d 65 20 2a 2f 0a journal name */.
cf70: 20 20 69 36 34 20 73 7a 4a 3b 20 20 20 20 20 20 i64 szJ;
cf80: 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 /*
cf90: 54 6f 74 61 6c 20 73 69 7a 65 20 69 6e 20 62 79 Total size in by
cfa0: 74 65 73 20 6f 66 20 6a 6f 75 72 6e 61 6c 20 66 tes of journal f
cfb0: 69 6c 65 20 70 4a 72 6e 6c 20 2a 2f 0a 20 20 75 ile pJrnl */. u
cfc0: 33 32 20 63 6b 73 75 6d 3b 20 20 20 20 20 20 20 32 cksum;
cfd0: 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4d 4a 20 /* MJ
cfe0: 63 68 65 63 6b 73 75 6d 20 76 61 6c 75 65 20 72 checksum value r
cff0: 65 61 64 20 66 72 6f 6d 20 6a 6f 75 72 6e 61 6c ead from journal
d000: 20 2a 2f 0a 20 20 75 33 32 20 75 3b 20 20 20 20 */. u32 u;
d010: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
d020: 20 2f 2a 20 55 6e 73 69 67 6e 65 64 20 6c 6f 6f /* Unsigned loo
d030: 70 20 63 6f 75 6e 74 65 72 20 2a 2f 0a 20 20 75 p counter */. u
d040: 6e 73 69 67 6e 65 64 20 63 68 61 72 20 61 4d 61 nsigned char aMa
d050: 67 69 63 5b 38 5d 3b 20 20 20 2f 2a 20 41 20 62 gic[8]; /* A b
d060: 75 66 66 65 72 20 74 6f 20 68 6f 6c 64 20 74 68 uffer to hold th
d070: 65 20 6d 61 67 69 63 20 68 65 61 64 65 72 20 2a e magic header *
d080: 2f 0a 20 20 7a 4d 61 73 74 65 72 5b 30 5d 20 3d /. zMaster[0] =
d090: 20 27 5c 30 27 3b 0a 0a 20 20 69 66 28 20 53 51 '\0';.. if( SQ
d0a0: 4c 49 54 45 5f 4f 4b 21 3d 28 72 63 20 3d 20 73 LITE_OK!=(rc = s
d0b0: 71 6c 69 74 65 33 4f 73 46 69 6c 65 53 69 7a 65 qlite3OsFileSize
d0c0: 28 70 4a 72 6e 6c 2c 20 26 73 7a 4a 29 29 0a 20 (pJrnl, &szJ)).
d0d0: 20 20 7c 7c 20 73 7a 4a 3c 31 36 0a 20 20 20 7c || szJ<16. |
d0e0: 7c 20 53 51 4c 49 54 45 5f 4f 4b 21 3d 28 72 63 | SQLITE_OK!=(rc
d0f0: 20 3d 20 72 65 61 64 33 32 62 69 74 73 28 70 4a = read32bits(pJ
d100: 72 6e 6c 2c 20 73 7a 4a 2d 31 36 2c 20 26 6c 65 rnl, szJ-16, &le
d110: 6e 29 29 0a 20 20 20 7c 7c 20 6c 65 6e 3e 3d 6e n)). || len>=n
d120: 4d 61 73 74 65 72 20 0a 20 20 20 7c 7c 20 6c 65 Master . || le
d130: 6e 3d 3d 30 20 0a 20 20 20 7c 7c 20 53 51 4c 49 n==0 . || SQLI
d140: 54 45 5f 4f 4b 21 3d 28 72 63 20 3d 20 72 65 61 TE_OK!=(rc = rea
d150: 64 33 32 62 69 74 73 28 70 4a 72 6e 6c 2c 20 73 d32bits(pJrnl, s
d160: 7a 4a 2d 31 32 2c 20 26 63 6b 73 75 6d 29 29 0a zJ-12, &cksum)).
d170: 20 20 20 7c 7c 20 53 51 4c 49 54 45 5f 4f 4b 21 || SQLITE_OK!
d180: 3d 28 72 63 20 3d 20 73 71 6c 69 74 65 33 4f 73 =(rc = sqlite3Os
d190: 52 65 61 64 28 70 4a 72 6e 6c 2c 20 61 4d 61 67 Read(pJrnl, aMag
d1a0: 69 63 2c 20 38 2c 20 73 7a 4a 2d 38 29 29 0a 20 ic, 8, szJ-8)).
d1b0: 20 20 7c 7c 20 6d 65 6d 63 6d 70 28 61 4d 61 67 || memcmp(aMag
d1c0: 69 63 2c 20 61 4a 6f 75 72 6e 61 6c 4d 61 67 69 ic, aJournalMagi
d1d0: 63 2c 20 38 29 0a 20 20 20 7c 7c 20 53 51 4c 49 c, 8). || SQLI
d1e0: 54 45 5f 4f 4b 21 3d 28 72 63 20 3d 20 73 71 6c TE_OK!=(rc = sql
d1f0: 69 74 65 33 4f 73 52 65 61 64 28 70 4a 72 6e 6c ite3OsRead(pJrnl
d200: 2c 20 7a 4d 61 73 74 65 72 2c 20 6c 65 6e 2c 20 , zMaster, len,
d210: 73 7a 4a 2d 31 36 2d 6c 65 6e 29 29 0a 20 20 29 szJ-16-len)). )
d220: 7b 0a 20 20 20 20 72 65 74 75 72 6e 20 72 63 3b {. return rc;
d230: 0a 20 20 7d 0a 0a 20 20 2f 2a 20 53 65 65 20 69 . }.. /* See i
d240: 66 20 74 68 65 20 63 68 65 63 6b 73 75 6d 20 6d f the checksum m
d250: 61 74 63 68 65 73 20 74 68 65 20 6d 61 73 74 65 atches the maste
d260: 72 20 6a 6f 75 72 6e 61 6c 20 6e 61 6d 65 20 2a r journal name *
d270: 2f 0a 20 20 66 6f 72 28 75 3d 30 3b 20 75 3c 6c /. for(u=0; u<l
d280: 65 6e 3b 20 75 2b 2b 29 7b 0a 20 20 20 20 63 6b en; u++){. ck
d290: 73 75 6d 20 2d 3d 20 7a 4d 61 73 74 65 72 5b 75 sum -= zMaster[u
d2a0: 5d 3b 0a 20 20 7d 0a 20 20 69 66 28 20 63 6b 73 ];. }. if( cks
d2b0: 75 6d 20 29 7b 0a 20 20 20 20 2f 2a 20 49 66 20 um ){. /* If
d2c0: 74 68 65 20 63 68 65 63 6b 73 75 6d 20 64 6f 65 the checksum doe
d2d0: 73 6e 27 74 20 61 64 64 20 75 70 2c 20 74 68 65 sn't add up, the
d2e0: 6e 20 6f 6e 65 20 6f 72 20 6d 6f 72 65 20 6f 66 n one or more of
d2f0: 20 74 68 65 20 64 69 73 6b 20 73 65 63 74 6f 72 the disk sector
d300: 73 0a 20 20 20 20 2a 2a 20 63 6f 6e 74 61 69 6e s. ** contain
d310: 69 6e 67 20 74 68 65 20 6d 61 73 74 65 72 20 6a ing the master j
d320: 6f 75 72 6e 61 6c 20 66 69 6c 65 6e 61 6d 65 20 ournal filename
d330: 69 73 20 63 6f 72 72 75 70 74 65 64 2e 20 54 68 is corrupted. Th
d340: 69 73 20 6d 65 61 6e 73 0a 20 20 20 20 2a 2a 20 is means. **
d350: 64 65 66 69 6e 69 74 65 6c 79 20 72 6f 6c 6c 20 definitely roll
d360: 62 61 63 6b 2c 20 73 6f 20 6a 75 73 74 20 72 65 back, so just re
d370: 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 20 61 turn SQLITE_OK a
d380: 6e 64 20 72 65 70 6f 72 74 20 61 20 28 6e 75 6c nd report a (nul
d390: 29 0a 20 20 20 20 2a 2a 20 6d 61 73 74 65 72 2d ). ** master-
d3a0: 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 6e 61 6d 65 journal filename
d3b0: 2e 0a 20 20 20 20 2a 2f 0a 20 20 20 20 6c 65 6e .. */. len
d3c0: 20 3d 20 30 3b 0a 20 20 7d 0a 20 20 7a 4d 61 73 = 0;. }. zMas
d3d0: 74 65 72 5b 6c 65 6e 5d 20 3d 20 27 5c 30 27 3b ter[len] = '\0';
d3e0: 0a 20 20 20 0a 20 20 72 65 74 75 72 6e 20 53 51 . . return SQ
d3f0: 4c 49 54 45 5f 4f 4b 3b 0a 7d 0a 0a 2f 2a 0a 2a LITE_OK;.}../*.*
d400: 2a 20 52 65 74 75 72 6e 20 74 68 65 20 6f 66 66 * Return the off
d410: 73 65 74 20 6f 66 20 74 68 65 20 73 65 63 74 6f set of the secto
d420: 72 20 62 6f 75 6e 64 61 72 79 20 61 74 20 6f 72 r boundary at or
d430: 20 69 6d 6d 65 64 69 61 74 65 6c 79 20 0a 2a 2a immediately .**
d440: 20 66 6f 6c 6c 6f 77 69 6e 67 20 74 68 65 20 76 following the v
d450: 61 6c 75 65 20 69 6e 20 70 50 61 67 65 72 2d 3e alue in pPager->
d460: 6a 6f 75 72 6e 61 6c 4f 66 66 2c 20 61 73 73 75 journalOff, assu
d470: 6d 69 6e 67 20 61 20 73 65 63 74 6f 72 20 0a 2a ming a sector .*
d480: 2a 20 73 69 7a 65 20 6f 66 20 70 50 61 67 65 72 * size of pPager
d490: 2d 3e 73 65 63 74 6f 72 53 69 7a 65 20 62 79 74 ->sectorSize byt
d4a0: 65 73 2e 0a 2a 2a 0a 2a 2a 20 69 2e 65 20 66 6f es..**.** i.e fo
d4b0: 72 20 61 20 73 65 63 74 6f 72 20 73 69 7a 65 20 r a sector size
d4c0: 6f 66 20 35 31 32 3a 0a 2a 2a 0a 2a 2a 20 20 20 of 512:.**.**
d4d0: 50 61 67 65 72 2e 6a 6f 75 72 6e 61 6c 4f 66 66 Pager.journalOff
d4e0: 20 20 20 20 20 20 20 20 20 20 52 65 74 75 72 6e Return
d4f0: 20 76 61 6c 75 65 0a 2a 2a 20 20 20 2d 2d 2d 2d value.** ----
d500: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
d510: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
d520: 2d 2d 2d 0a 2a 2a 20 20 20 30 20 20 20 20 20 20 ---.** 0
d530: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
d540: 20 20 20 30 0a 2a 2a 20 20 20 35 31 32 20 20 20 0.** 512
d550: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
d560: 20 20 20 20 35 31 32 0a 2a 2a 20 20 20 31 30 30 512.** 100
d570: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
d580: 20 20 20 20 20 20 20 35 31 32 0a 2a 2a 20 20 20 512.**
d590: 32 30 30 30 20 20 20 20 20 20 20 20 20 20 20 20 2000
d5a0: 20 20 20 20 20 20 20 20 20 20 32 30 34 38 0a 2a 2048.*
d5b0: 2a 20 0a 2a 2f 0a 73 74 61 74 69 63 20 69 36 34 * .*/.static i64
d5c0: 20 6a 6f 75 72 6e 61 6c 48 64 72 4f 66 66 73 65 journalHdrOffse
d5d0: 74 28 50 61 67 65 72 20 2a 70 50 61 67 65 72 29 t(Pager *pPager)
d5e0: 7b 0a 20 20 69 36 34 20 6f 66 66 73 65 74 20 3d {. i64 offset =
d5f0: 20 30 3b 0a 20 20 69 36 34 20 63 20 3d 20 70 50 0;. i64 c = pP
d600: 61 67 65 72 2d 3e 6a 6f 75 72 6e 61 6c 4f 66 66 ager->journalOff
d610: 3b 0a 20 20 69 66 28 20 63 20 29 7b 0a 20 20 20 ;. if( c ){.
d620: 20 6f 66 66 73 65 74 20 3d 20 28 28 63 2d 31 29 offset = ((c-1)
d630: 2f 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 20 2b 20 31 29 20 2a 20 4a pPager) + 1) * J
d650: 4f 55 52 4e 41 4c 5f 48 44 52 5f 53 5a 28 70 50 OURNAL_HDR_SZ(pP
d660: 61 67 65 72 29 3b 0a 20 20 7d 0a 20 20 61 73 73 ager);. }. ass
d670: 65 72 74 28 20 6f 66 66 73 65 74 25 4a 4f 55 52 ert( offset%JOUR
d680: 4e 41 4c 5f 48 44 52 5f 53 5a 28 70 50 61 67 65 NAL_HDR_SZ(pPage
d690: 72 29 3d 3d 30 20 29 3b 0a 20 20 61 73 73 65 72 r)==0 );. asser
d6a0: 74 28 20 6f 66 66 73 65 74 3e 3d 63 20 29 3b 0a t( offset>=c );.
d6b0: 20 20 61 73 73 65 72 74 28 20 28 6f 66 66 73 65 assert( (offse
d6c0: 74 2d 63 29 3c 4a 4f 55 52 4e 41 4c 5f 48 44 52 t-c)<JOURNAL_HDR
d6d0: 5f 53 5a 28 70 50 61 67 65 72 29 20 29 3b 0a 20 _SZ(pPager) );.
d6e0: 20 72 65 74 75 72 6e 20 6f 66 66 73 65 74 3b 0a return offset;.
d6f0: 7d 0a 0a 2f 2a 0a 2a 2a 20 54 68 65 20 6a 6f 75 }../*.** The jou
d700: 72 6e 61 6c 20 66 69 6c 65 20 6d 75 73 74 20 62 rnal file must b
d710: 65 20 6f 70 65 6e 20 77 68 65 6e 20 74 68 69 73 e open when this
d720: 20 66 75 6e 63 74 69 6f 6e 20 69 73 20 63 61 6c function is cal
d730: 6c 65 64 2e 0a 2a 2a 0a 2a 2a 20 54 68 69 73 20 led..**.** This
d740: 66 75 6e 63 74 69 6f 6e 20 69 73 20 61 20 6e 6f function is a no
d750: 2d 6f 70 20 69 66 20 74 68 65 20 6a 6f 75 72 6e -op if the journ
d760: 61 6c 20 66 69 6c 65 20 68 61 73 20 6e 6f 74 20 al file has not
d770: 62 65 65 6e 20 77 72 69 74 74 65 6e 20 74 6f 0a been written to.
d780: 2a 2a 20 77 69 74 68 69 6e 20 74 68 65 20 63 75 ** within the cu
d790: 72 72 65 6e 74 20 74 72 61 6e 73 61 63 74 69 6f rrent transactio
d7a0: 6e 20 28 69 2e 65 2e 20 69 66 20 50 61 67 65 72 n (i.e. if Pager
d7b0: 2e 6a 6f 75 72 6e 61 6c 4f 66 66 3d 3d 30 29 2e .journalOff==0).
d7c0: 0a 2a 2a 0a 2a 2a 20 49 66 20 64 6f 54 72 75 6e .**.** If doTrun
d7d0: 63 61 74 65 20 69 73 20 6e 6f 6e 2d 7a 65 72 6f cate is non-zero
d7e0: 20 6f 72 20 74 68 65 20 50 61 67 65 72 2e 6a 6f or the Pager.jo
d7f0: 75 72 6e 61 6c 53 69 7a 65 4c 69 6d 69 74 20 76 urnalSizeLimit v
d800: 61 72 69 61 62 6c 65 20 69 73 0a 2a 2a 20 73 65 ariable is.** se
d810: 74 20 74 6f 20 30 2c 20 74 68 65 6e 20 74 72 75 t to 0, then tru
d820: 6e 63 61 74 65 20 74 68 65 20 6a 6f 75 72 6e 61 ncate the journa
d830: 6c 20 66 69 6c 65 20 74 6f 20 7a 65 72 6f 20 62 l file to zero b
d840: 79 74 65 73 20 69 6e 20 73 69 7a 65 2e 20 4f 74 ytes in size. Ot
d850: 68 65 72 77 69 73 65 2c 0a 2a 2a 20 7a 65 72 6f herwise,.** zero
d860: 20 74 68 65 20 32 38 2d 62 79 74 65 20 68 65 61 the 28-byte hea
d870: 64 65 72 20 61 74 20 74 68 65 20 73 74 61 72 74 der at the start
d880: 20 6f 66 20 74 68 65 20 6a 6f 75 72 6e 61 6c 20 of the journal
d890: 66 69 6c 65 2e 20 49 6e 20 65 69 74 68 65 72 20 file. In either
d8a0: 63 61 73 65 2c 20 0a 2a 2a 20 69 66 20 74 68 65 case, .** if the
d8b0: 20 70 61 67 65 72 20 69 73 20 6e 6f 74 20 69 6e pager is not in
d8c0: 20 6e 6f 2d 73 79 6e 63 20 6d 6f 64 65 2c 20 73 no-sync mode, s
d8d0: 79 6e 63 20 74 68 65 20 6a 6f 75 72 6e 61 6c 20 ync the journal
d8e0: 66 69 6c 65 20 69 6d 6d 65 64 69 61 74 65 6c 79 file immediately
d8f0: 20 0a 2a 2a 20 61 66 74 65 72 20 77 72 69 74 69 .** after writi
d900: 6e 67 20 6f 72 20 74 72 75 6e 63 61 74 69 6e 67 ng or truncating
d910: 20 69 74 2e 0a 2a 2a 0a 2a 2a 20 49 66 20 50 61 it..**.** If Pa
d920: 67 65 72 2e 6a 6f 75 72 6e 61 6c 53 69 7a 65 4c ger.journalSizeL
d930: 69 6d 69 74 20 69 73 20 73 65 74 20 74 6f 20 61 imit is set to a
d940: 20 70 6f 73 69 74 69 76 65 2c 20 6e 6f 6e 2d 7a positive, non-z
d950: 65 72 6f 20 76 61 6c 75 65 2c 20 61 6e 64 0a 2a ero value, and.*
d960: 2a 20 66 6f 6c 6c 6f 77 69 6e 67 20 74 68 65 20 * following the
d970: 74 72 75 6e 63 61 74 69 6f 6e 20 6f 72 20 7a 65 truncation or ze
d980: 72 6f 69 6e 67 20 64 65 73 63 72 69 62 65 64 20 roing described
d990: 61 62 6f 76 65 20 74 68 65 20 73 69 7a 65 20 6f above the size o
d9a0: 66 20 74 68 65 20 0a 2a 2a 20 6a 6f 75 72 6e 61 f the .** journa
d9b0: 6c 20 66 69 6c 65 20 69 6e 20 62 79 74 65 73 20 l file in bytes
d9c0: 69 73 20 6c 61 72 67 65 72 20 74 68 61 6e 20 74 is larger than t
d9d0: 68 69 73 20 76 61 6c 75 65 2c 20 74 68 65 6e 20 his value, then
d9e0: 74 72 75 6e 63 61 74 65 20 74 68 65 0a 2a 2a 20 truncate the.**
d9f0: 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 20 74 6f 20 journal file to
da00: 50 61 67 65 72 2e 6a 6f 75 72 6e 61 6c 53 69 7a Pager.journalSiz
da10: 65 4c 69 6d 69 74 20 62 79 74 65 73 2e 20 54 68 eLimit bytes. Th
da20: 65 20 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 20 64 e journal file d
da30: 6f 65 73 0a 2a 2a 20 6e 6f 74 20 6e 65 65 64 20 oes.** not need
da40: 74 6f 20 62 65 20 73 79 6e 63 65 64 20 66 6f 6c to be synced fol
da50: 6c 6f 77 69 6e 67 20 74 68 69 73 20 6f 70 65 72 lowing this oper
da60: 61 74 69 6f 6e 2e 0a 2a 2a 0a 2a 2a 20 49 66 20 ation..**.** If
da70: 61 6e 20 49 4f 20 65 72 72 6f 72 20 6f 63 63 75 an IO error occu
da80: 72 73 2c 20 61 62 61 6e 64 6f 6e 20 70 72 6f 63 rs, abandon proc
da90: 65 73 73 69 6e 67 20 61 6e 64 20 72 65 74 75 72 essing and retur
daa0: 6e 20 74 68 65 20 49 4f 20 65 72 72 6f 72 20 63 n the IO error c
dab0: 6f 64 65 2e 0a 2a 2a 20 4f 74 68 65 72 77 69 73 ode..** Otherwis
dac0: 65 2c 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 e, return SQLITE
dad0: 5f 4f 4b 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 69 _OK..*/.static i
dae0: 6e 74 20 7a 65 72 6f 4a 6f 75 72 6e 61 6c 48 64 nt zeroJournalHd
daf0: 72 28 50 61 67 65 72 20 2a 70 50 61 67 65 72 2c r(Pager *pPager,
db00: 20 69 6e 74 20 64 6f 54 72 75 6e 63 61 74 65 29 int doTruncate)
db10: 7b 0a 20 20 69 6e 74 20 72 63 20 3d 20 53 51 4c {. int rc = SQL
db20: 49 54 45 5f 4f 4b 3b 20 20 20 20 20 20 20 20 20 ITE_OK;
db30: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
db40: 20 20 20 20 20 20 2f 2a 20 52 65 74 75 72 6e 20 /* Return
db50: 63 6f 64 65 20 2a 2f 0a 20 20 61 73 73 65 72 74 code */. assert
db60: 28 20 69 73 4f 70 65 6e 28 70 50 61 67 65 72 2d ( isOpen(pPager-
db70: 3e 6a 66 64 29 20 29 3b 0a 20 20 61 73 73 65 72 >jfd) );. asser
db80: 74 28 20 21 73 71 6c 69 74 65 33 4a 6f 75 72 6e t( !sqlite3Journ
db90: 61 6c 49 73 49 6e 4d 65 6d 6f 72 79 28 70 50 61 alIsInMemory(pPa
dba0: 67 65 72 2d 3e 6a 66 64 29 20 29 3b 0a 20 20 69 ger->jfd) );. i
dbb0: 66 28 20 70 50 61 67 65 72 2d 3e 6a 6f 75 72 6e f( pPager->journ
dbc0: 61 6c 4f 66 66 20 29 7b 0a 20 20 20 20 63 6f 6e alOff ){. con
dbd0: 73 74 20 69 36 34 20 69 4c 69 6d 69 74 20 3d 20 st i64 iLimit =
dbe0: 70 50 61 67 65 72 2d 3e 6a 6f 75 72 6e 61 6c 53 pPager->journalS
dbf0: 69 7a 65 4c 69 6d 69 74 3b 20 20 20 20 2f 2a 20 izeLimit; /*
dc00: 4c 6f 63 61 6c 20 63 61 63 68 65 20 6f 66 20 6a Local cache of j
dc10: 73 6c 20 2a 2f 0a 0a 20 20 20 20 49 4f 54 52 41 sl */.. IOTRA
dc20: 43 45 28 28 22 4a 5a 45 52 4f 48 44 52 20 25 70 CE(("JZEROHDR %p
dc30: 5c 6e 22 2c 20 70 50 61 67 65 72 29 29 0a 20 20 \n", pPager)).
dc40: 20 20 69 66 28 20 64 6f 54 72 75 6e 63 61 74 65 if( doTruncate
dc50: 20 7c 7c 20 69 4c 69 6d 69 74 3d 3d 30 20 29 7b || iLimit==0 ){
dc60: 0a 20 20 20 20 20 20 72 63 20 3d 20 73 71 6c 69 . rc = sqli
dc70: 74 65 33 4f 73 54 72 75 6e 63 61 74 65 28 70 50 te3OsTruncate(pP
dc80: 61 67 65 72 2d 3e 6a 66 64 2c 20 30 29 3b 0a 20 ager->jfd, 0);.
dc90: 20 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 20 20 }else{.
dca0: 73 74 61 74 69 63 20 63 6f 6e 73 74 20 63 68 61 static const cha
dcb0: 72 20 7a 65 72 6f 48 64 72 5b 32 38 5d 20 3d 20 r zeroHdr[28] =
dcc0: 7b 30 7d 3b 0a 20 20 20 20 20 20 72 63 20 3d 20 {0};. rc =
dcd0: 73 71 6c 69 74 65 33 4f 73 57 72 69 74 65 28 70 sqlite3OsWrite(p
dce0: 50 61 67 65 72 2d 3e 6a 66 64 2c 20 7a 65 72 6f Pager->jfd, zero
dcf0: 48 64 72 2c 20 73 69 7a 65 6f 66 28 7a 65 72 6f Hdr, sizeof(zero
dd00: 48 64 72 29 2c 20 30 29 3b 0a 20 20 20 20 7d 0a Hdr), 0);. }.
dd10: 20 20 20 20 69 66 28 20 72 63 3d 3d 53 51 4c 49 if( rc==SQLI
dd20: 54 45 5f 4f 4b 20 26 26 20 21 70 50 61 67 65 72 TE_OK && !pPager
dd30: 2d 3e 6e 6f 53 79 6e 63 20 29 7b 0a 20 20 20 20 ->noSync ){.
dd40: 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33 4f 73 rc = sqlite3Os
dd50: 53 79 6e 63 28 70 50 61 67 65 72 2d 3e 6a 66 64 Sync(pPager->jfd
dd60: 2c 20 53 51 4c 49 54 45 5f 53 59 4e 43 5f 44 41 , SQLITE_SYNC_DA
dd70: 54 41 4f 4e 4c 59 7c 70 50 61 67 65 72 2d 3e 73 TAONLY|pPager->s
dd80: 79 6e 63 46 6c 61 67 73 29 3b 0a 20 20 20 20 7d yncFlags);. }
dd90: 0a 0a 20 20 20 20 2f 2a 20 41 74 20 74 68 69 73 .. /* At this
dda0: 20 70 6f 69 6e 74 20 74 68 65 20 74 72 61 6e 73 point the trans
ddb0: 61 63 74 69 6f 6e 20 69 73 20 63 6f 6d 6d 69 74 action is commit
ddc0: 74 65 64 20 62 75 74 20 74 68 65 20 77 72 69 74 ted but the writ
ddd0: 65 20 6c 6f 63 6b 20 0a 20 20 20 20 2a 2a 20 69 e lock . ** i
dde0: 73 20 73 74 69 6c 6c 20 68 65 6c 64 20 6f 6e 20 s still held on
ddf0: 74 68 65 20 66 69 6c 65 2e 20 49 66 20 74 68 65 the file. If the
de00: 72 65 20 69 73 20 61 20 73 69 7a 65 20 6c 69 6d re is a size lim
de10: 69 74 20 63 6f 6e 66 69 67 75 72 65 64 20 66 6f it configured fo
de20: 72 20 0a 20 20 20 20 2a 2a 20 74 68 65 20 70 65 r . ** the pe
de30: 72 73 69 73 74 65 6e 74 20 6a 6f 75 72 6e 61 6c rsistent journal
de40: 20 61 6e 64 20 74 68 65 20 6a 6f 75 72 6e 61 6c and the journal
de50: 20 66 69 6c 65 20 63 75 72 72 65 6e 74 6c 79 20 file currently
de60: 63 6f 6e 73 75 6d 65 73 20 6d 6f 72 65 0a 20 20 consumes more.
de70: 20 20 2a 2a 20 73 70 61 63 65 20 74 68 61 6e 20 ** space than
de80: 74 68 61 74 20 6c 69 6d 69 74 20 61 6c 6c 6f 77 that limit allow
de90: 73 20 66 6f 72 2c 20 74 72 75 6e 63 61 74 65 20 s for, truncate
dea0: 69 74 20 6e 6f 77 2e 20 54 68 65 72 65 20 69 73 it now. There is
deb0: 20 6e 6f 20 6e 65 65 64 0a 20 20 20 20 2a 2a 20 no need. **
dec0: 74 6f 20 73 79 6e 63 20 74 68 65 20 66 69 6c 65 to sync the file
ded0: 20 66 6f 6c 6c 6f 77 69 6e 67 20 74 68 69 73 20 following this
dee0: 6f 70 65 72 61 74 69 6f 6e 2e 0a 20 20 20 20 2a operation.. *
def0: 2f 0a 20 20 20 20 69 66 28 20 72 63 3d 3d 53 51 /. if( rc==SQ
df00: 4c 49 54 45 5f 4f 4b 20 26 26 20 69 4c 69 6d 69 LITE_OK && iLimi
df10: 74 3e 30 20 29 7b 0a 20 20 20 20 20 20 69 36 34 t>0 ){. i64
df20: 20 73 7a 3b 0a 20 20 20 20 20 20 72 63 20 3d 20 sz;. rc =
df30: 73 71 6c 69 74 65 33 4f 73 46 69 6c 65 53 69 7a sqlite3OsFileSiz
df40: 65 28 70 50 61 67 65 72 2d 3e 6a 66 64 2c 20 26 e(pPager->jfd, &
df50: 73 7a 29 3b 0a 20 20 20 20 20 20 69 66 28 20 72 sz);. if( r
df60: 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 26 26 20 c==SQLITE_OK &&
df70: 73 7a 3e 69 4c 69 6d 69 74 20 29 7b 0a 20 20 20 sz>iLimit ){.
df80: 20 20 20 20 20 72 63 20 3d 20 73 71 6c 69 74 65 rc = sqlite
df90: 33 4f 73 54 72 75 6e 63 61 74 65 28 70 50 61 67 3OsTruncate(pPag
dfa0: 65 72 2d 3e 6a 66 64 2c 20 69 4c 69 6d 69 74 29 er->jfd, iLimit)
dfb0: 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 7d 0a ;. }. }.
dfc0: 20 20 7d 0a 20 20 72 65 74 75 72 6e 20 72 63 3b }. return rc;
dfd0: 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 54 68 65 20 6a 6f .}../*.** The jo
dfe0: 75 72 6e 61 6c 20 66 69 6c 65 20 6d 75 73 74 20 urnal file must
dff0: 62 65 20 6f 70 65 6e 20 77 68 65 6e 20 74 68 69 be open when thi
e000: 73 20 72 6f 75 74 69 6e 65 20 69 73 20 63 61 6c s routine is cal
e010: 6c 65 64 2e 20 41 20 6a 6f 75 72 6e 61 6c 0a 2a led. A journal.*
e020: 2a 20 68 65 61 64 65 72 20 28 4a 4f 55 52 4e 41 * header (JOURNA
e030: 4c 5f 48 44 52 5f 53 5a 20 62 79 74 65 73 29 20 L_HDR_SZ bytes)
e040: 69 73 20 77 72 69 74 74 65 6e 20 69 6e 74 6f 20 is written into
e050: 74 68 65 20 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 the journal file
e060: 20 61 74 20 74 68 65 0a 2a 2a 20 63 75 72 72 65 at the.** curre
e070: 6e 74 20 6c 6f 63 61 74 69 6f 6e 2e 0a 2a 2a 0a nt location..**.
e080: 2a 2a 20 54 68 65 20 66 6f 72 6d 61 74 20 66 6f ** The format fo
e090: 72 20 74 68 65 20 6a 6f 75 72 6e 61 6c 20 68 65 r the journal he
e0a0: 61 64 65 72 20 69 73 20 61 73 20 66 6f 6c 6c 6f ader is as follo
e0b0: 77 73 3a 0a 2a 2a 20 2d 20 38 20 62 79 74 65 73 ws:.** - 8 bytes
e0c0: 3a 20 4d 61 67 69 63 20 69 64 65 6e 74 69 66 79 : Magic identify
e0d0: 69 6e 67 20 6a 6f 75 72 6e 61 6c 20 66 6f 72 6d ing journal form
e0e0: 61 74 2e 0a 2a 2a 20 2d 20 34 20 62 79 74 65 73 at..** - 4 bytes
e0f0: 3a 20 4e 75 6d 62 65 72 20 6f 66 20 72 65 63 6f : Number of reco
e100: 72 64 73 20 69 6e 20 6a 6f 75 72 6e 61 6c 2c 20 rds in journal,
e110: 6f 72 20 2d 31 20 6e 6f 2d 73 79 6e 63 20 6d 6f or -1 no-sync mo
e120: 64 65 20 69 73 20 6f 6e 2e 0a 2a 2a 20 2d 20 34 de is on..** - 4
e130: 20 62 79 74 65 73 3a 20 52 61 6e 64 6f 6d 20 6e bytes: Random n
e140: 75 6d 62 65 72 20 75 73 65 64 20 66 6f 72 20 70 umber used for p
e150: 61 67 65 20 68 61 73 68 2e 0a 2a 2a 20 2d 20 34 age hash..** - 4
e160: 20 62 79 74 65 73 3a 20 49 6e 69 74 69 61 6c 20 bytes: Initial
e170: 64 61 74 61 62 61 73 65 20 70 61 67 65 20 63 6f database page co
e180: 75 6e 74 2e 0a 2a 2a 20 2d 20 34 20 62 79 74 65 unt..** - 4 byte
e190: 73 3a 20 53 65 63 74 6f 72 20 73 69 7a 65 20 75 s: Sector size u
e1a0: 73 65 64 20 62 79 20 74 68 65 20 70 72 6f 63 65 sed by the proce
e1b0: 73 73 20 74 68 61 74 20 77 72 6f 74 65 20 74 68 ss that wrote th
e1c0: 69 73 20 6a 6f 75 72 6e 61 6c 2e 0a 2a 2a 20 2d is journal..** -
e1d0: 20 34 20 62 79 74 65 73 3a 20 44 61 74 61 62 61 4 bytes: Databa
e1e0: 73 65 20 70 61 67 65 20 73 69 7a 65 2e 0a 2a 2a se page size..**
e1f0: 20 0a 2a 2a 20 46 6f 6c 6c 6f 77 65 64 20 62 79 .** Followed by
e200: 20 28 4a 4f 55 52 4e 41 4c 5f 48 44 52 5f 53 5a (JOURNAL_HDR_SZ
e210: 20 2d 20 32 38 29 20 62 79 74 65 73 20 6f 66 20 - 28) bytes of
e220: 75 6e 75 73 65 64 20 73 70 61 63 65 2e 0a 2a 2f unused space..*/
e230: 0a 73 74 61 74 69 63 20 69 6e 74 20 77 72 69 74 .static int writ
e240: 65 4a 6f 75 72 6e 61 6c 48 64 72 28 50 61 67 65 eJournalHdr(Page
e250: 72 20 2a 70 50 61 67 65 72 29 7b 0a 20 20 69 6e r *pPager){. in
e260: 74 20 72 63 20 3d 20 53 51 4c 49 54 45 5f 4f 4b t rc = SQLITE_OK
e270: 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 ;
e280: 20 20 2f 2a 20 52 65 74 75 72 6e 20 63 6f 64 65 /* Return code
e290: 20 2a 2f 0a 20 20 63 68 61 72 20 2a 7a 48 65 61 */. char *zHea
e2a0: 64 65 72 20 3d 20 70 50 61 67 65 72 2d 3e 70 54 der = pPager->pT
e2b0: 6d 70 53 70 61 63 65 3b 20 20 2f 2a 20 54 65 6d mpSpace; /* Tem
e2c0: 70 6f 72 61 72 79 20 73 70 61 63 65 20 75 73 65 porary space use
e2d0: 64 20 74 6f 20 62 75 69 6c 64 20 68 65 61 64 65 d to build heade
e2e0: 72 20 2a 2f 0a 20 20 75 33 32 20 6e 48 65 61 64 r */. u32 nHead
e2f0: 65 72 20 3d 20 28 75 33 32 29 70 50 61 67 65 72 er = (u32)pPager
e300: 2d 3e 70 61 67 65 53 69 7a 65 3b 2f 2a 20 53 69 ->pageSize;/* Si
e310: 7a 65 20 6f 66 20 62 75 66 66 65 72 20 70 6f 69 ze of buffer poi
e320: 6e 74 65 64 20 74 6f 20 62 79 20 7a 48 65 61 64 nted to by zHead
e330: 65 72 20 2a 2f 0a 20 20 75 33 32 20 6e 57 72 69 er */. u32 nWri
e340: 74 65 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 te;
e350: 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 42 /* B
e360: 79 74 65 73 20 6f 66 20 68 65 61 64 65 72 20 73 ytes of header s
e370: 65 63 74 6f 72 20 77 72 69 74 74 65 6e 20 2a 2f ector written */
e380: 0a 20 20 69 6e 74 20 69 69 3b 20 20 20 20 20 20 . int ii;
e390: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
e3a0: 20 20 20 20 20 20 20 2f 2a 20 4c 6f 6f 70 20 63 /* Loop c
e3b0: 6f 75 6e 74 65 72 20 2a 2f 0a 0a 20 20 61 73 73 ounter */.. ass
e3c0: 65 72 74 28 20 69 73 4f 70 65 6e 28 70 50 61 67 ert( isOpen(pPag
e3d0: 65 72 2d 3e 6a 66 64 29 20 29 3b 20 20 20 20 20 er->jfd) );
e3e0: 20 2f 2a 20 4a 6f 75 72 6e 61 6c 20 66 69 6c 65 /* Journal file
e3f0: 20 6d 75 73 74 20 62 65 20 6f 70 65 6e 2e 20 2a must be open. *
e400: 2f 0a 0a 20 20 69 66 28 20 6e 48 65 61 64 65 72 /.. if( nHeader
e410: 3e 4a 4f 55 52 4e 41 4c 5f 48 44 52 5f 53 5a 28 >JOURNAL_HDR_SZ(
e420: 70 50 61 67 65 72 29 20 29 7b 0a 20 20 20 20 6e pPager) ){. n
e430: 48 65 61 64 65 72 20 3d 20 4a 4f 55 52 4e 41 4c Header = JOURNAL
e440: 5f 48 44 52 5f 53 5a 28 70 50 61 67 65 72 29 3b _HDR_SZ(pPager);
e450: 0a 20 20 7d 0a 0a 20 20 2f 2a 20 49 66 20 74 68 . }.. /* If th
e460: 65 72 65 20 61 72 65 20 61 63 74 69 76 65 20 73 ere are active s
e470: 61 76 65 70 6f 69 6e 74 73 20 61 6e 64 20 61 6e avepoints and an
e480: 79 20 6f 66 20 74 68 65 6d 20 77 65 72 65 20 63 y of them were c
e490: 72 65 61 74 65 64 20 0a 20 20 2a 2a 20 73 69 6e reated . ** sin
e4a0: 63 65 20 74 68 65 20 6d 6f 73 74 20 72 65 63 65 ce the most rece
e4b0: 6e 74 20 6a 6f 75 72 6e 61 6c 20 68 65 61 64 65 nt journal heade
e4c0: 72 20 77 61 73 20 77 72 69 74 74 65 6e 2c 20 75 r was written, u
e4d0: 70 64 61 74 65 20 74 68 65 20 0a 20 20 2a 2a 20 pdate the . **
e4e0: 50 61 67 65 72 53 61 76 65 70 6f 69 6e 74 2e 69 PagerSavepoint.i
e4f0: 48 64 72 4f 66 66 73 65 74 20 66 69 65 6c 64 73 HdrOffset fields
e500: 20 6e 6f 77 2e 0a 20 20 2a 2f 0a 20 20 66 6f 72 now.. */. for
e510: 28 69 69 3d 30 3b 20 69 69 3c 70 50 61 67 65 72 (ii=0; ii<pPager
e520: 2d 3e 6e 53 61 76 65 70 6f 69 6e 74 3b 20 69 69 ->nSavepoint; ii
e530: 2b 2b 29 7b 0a 20 20 20 20 69 66 28 20 70 50 61 ++){. if( pPa
e540: 67 65 72 2d 3e 61 53 61 76 65 70 6f 69 6e 74 5b ger->aSavepoint[
e550: 69 69 5d 2e 69 48 64 72 4f 66 66 73 65 74 3d 3d ii].iHdrOffset==
e560: 30 20 29 7b 0a 20 20 20 20 20 20 70 50 61 67 65 0 ){. pPage
e570: 72 2d 3e 61 53 61 76 65 70 6f 69 6e 74 5b 69 69 r->aSavepoint[ii
e580: 5d 2e 69 48 64 72 4f 66 66 73 65 74 20 3d 20 70 ].iHdrOffset = p
e590: 50 61 67 65 72 2d 3e 6a 6f 75 72 6e 61 6c 4f 66 Pager->journalOf
e5a0: 66 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a 0a 20 20 f;. }. }..
e5b0: 70 50 61 67 65 72 2d 3e 6a 6f 75 72 6e 61 6c 48 pPager->journalH
e5c0: 64 72 20 3d 20 70 50 61 67 65 72 2d 3e 6a 6f 75 dr = pPager->jou
e5d0: 72 6e 61 6c 4f 66 66 20 3d 20 6a 6f 75 72 6e 61 rnalOff = journa
e5e0: 6c 48 64 72 4f 66 66 73 65 74 28 70 50 61 67 65 lHdrOffset(pPage
e5f0: 72 29 3b 0a 0a 20 20 2f 2a 20 0a 20 20 2a 2a 20 r);.. /* . **
e600: 57 72 69 74 65 20 74 68 65 20 6e 52 65 63 20 46 Write the nRec F
e610: 69 65 6c 64 20 2d 20 74 68 65 20 6e 75 6d 62 65 ield - the numbe
e620: 72 20 6f 66 20 70 61 67 65 20 72 65 63 6f 72 64 r of page record
e630: 73 20 74 68 61 74 20 66 6f 6c 6c 6f 77 20 74 68 s that follow th
e640: 69 73 0a 20 20 2a 2a 20 6a 6f 75 72 6e 61 6c 20 is. ** journal
e650: 68 65 61 64 65 72 2e 20 4e 6f 72 6d 61 6c 6c 79 header. Normally
e660: 2c 20 7a 65 72 6f 20 69 73 20 77 72 69 74 74 65 , zero is writte
e670: 6e 20 74 6f 20 74 68 69 73 20 76 61 6c 75 65 20 n to this value
e680: 61 74 20 74 68 69 73 20 74 69 6d 65 2e 0a 20 20 at this time..
e690: 2a 2a 20 41 66 74 65 72 20 74 68 65 20 72 65 63 ** After the rec
e6a0: 6f 72 64 73 20 61 72 65 20 61 64 64 65 64 20 74 ords are added t
e6b0: 6f 20 74 68 65 20 6a 6f 75 72 6e 61 6c 20 28 61 o the journal (a
e6c0: 6e 64 20 74 68 65 20 6a 6f 75 72 6e 61 6c 20 73 nd the journal s
e6d0: 79 6e 63 65 64 2c 20 0a 20 20 2a 2a 20 69 66 20 ynced, . ** if
e6e0: 69 6e 20 66 75 6c 6c 2d 73 79 6e 63 20 6d 6f 64 in full-sync mod
e6f0: 65 29 2c 20 74 68 65 20 7a 65 72 6f 20 69 73 20 e), the zero is
e700: 6f 76 65 72 77 72 69 74 74 65 6e 20 77 69 74 68 overwritten with
e710: 20 74 68 65 20 74 72 75 65 20 6e 75 6d 62 65 72 the true number
e720: 0a 20 20 2a 2a 20 6f 66 20 72 65 63 6f 72 64 73 . ** of records
e730: 20 28 73 65 65 20 73 79 6e 63 4a 6f 75 72 6e 61 (see syncJourna
e740: 6c 28 29 29 2e 0a 20 20 2a 2a 0a 20 20 2a 2a 20 l()).. **. **
e750: 41 20 66 61 73 74 65 72 20 61 6c 74 65 72 6e 61 A faster alterna
e760: 74 69 76 65 20 69 73 20 74 6f 20 77 72 69 74 65 tive is to write
e770: 20 30 78 46 46 46 46 46 46 46 46 20 74 6f 20 74 0xFFFFFFFF to t
e780: 68 65 20 6e 52 65 63 20 66 69 65 6c 64 2e 20 57 he nRec field. W
e790: 68 65 6e 0a 20 20 2a 2a 20 72 65 61 64 69 6e 67 hen. ** reading
e7a0: 20 74 68 65 20 6a 6f 75 72 6e 61 6c 20 74 68 69 the journal thi
e7b0: 73 20 76 61 6c 75 65 20 74 65 6c 6c 73 20 53 51 s value tells SQ
e7c0: 4c 69 74 65 20 74 6f 20 61 73 73 75 6d 65 20 74 Lite to assume t
e7d0: 68 61 74 20 74 68 65 0a 20 20 2a 2a 20 72 65 73 hat the. ** res
e7e0: 74 20 6f 66 20 74 68 65 20 6a 6f 75 72 6e 61 6c t of the journal
e7f0: 20 66 69 6c 65 20 63 6f 6e 74 61 69 6e 73 20 76 file contains v
e800: 61 6c 69 64 20 70 61 67 65 20 72 65 63 6f 72 64 alid page record
e810: 73 2e 20 54 68 69 73 20 61 73 73 75 6d 70 74 69 s. This assumpti
e820: 6f 6e 0a 20 20 2a 2a 20 69 73 20 64 61 6e 67 65 on. ** is dange
e830: 72 6f 75 73 2c 20 61 73 20 69 66 20 61 20 66 61 rous, as if a fa
e840: 69 6c 75 72 65 20 6f 63 63 75 72 72 65 64 20 77 ilure occurred w
e850: 68 69 6c 73 74 20 77 72 69 74 69 6e 67 20 74 6f hilst writing to
e860: 20 74 68 65 20 6a 6f 75 72 6e 61 6c 0a 20 20 2a the journal. *
e870: 2a 20 66 69 6c 65 20 69 74 20 6d 61 79 20 63 6f * file it may co
e880: 6e 74 61 69 6e 20 73 6f 6d 65 20 67 61 72 62 61 ntain some garba
e890: 67 65 20 64 61 74 61 2e 20 54 68 65 72 65 20 61 ge data. There a
e8a0: 72 65 20 74 77 6f 20 73 63 65 6e 61 72 69 6f 73 re two scenarios
e8b0: 0a 20 20 2a 2a 20 77 68 65 72 65 20 74 68 69 73 . ** where this
e8c0: 20 72 69 73 6b 20 63 61 6e 20 62 65 20 69 67 6e risk can be ign
e8d0: 6f 72 65 64 3a 0a 20 20 2a 2a 0a 20 20 2a 2a 20 ored:. **. **
e8e0: 20 20 2a 20 57 68 65 6e 20 74 68 65 20 70 61 67 * When the pag
e8f0: 65 72 20 69 73 20 69 6e 20 6e 6f 2d 73 79 6e 63 er is in no-sync
e900: 20 6d 6f 64 65 2e 20 43 6f 72 72 75 70 74 69 6f mode. Corruptio
e910: 6e 20 63 61 6e 20 66 6f 6c 6c 6f 77 20 61 0a 20 n can follow a.
e920: 20 2a 2a 20 20 20 20 20 70 6f 77 65 72 20 66 61 ** power fa
e930: 69 6c 75 72 65 20 69 6e 20 74 68 69 73 20 63 61 ilure in this ca
e940: 73 65 20 61 6e 79 77 61 79 2e 0a 20 20 2a 2a 0a se anyway.. **.
e950: 20 20 2a 2a 20 20 20 2a 20 57 68 65 6e 20 74 68 ** * When th
e960: 65 20 53 51 4c 49 54 45 5f 49 4f 43 41 50 5f 53 e SQLITE_IOCAP_S
e970: 41 46 45 5f 41 50 50 45 4e 44 20 66 6c 61 67 20 AFE_APPEND flag
e980: 69 73 20 73 65 74 2e 20 54 68 69 73 20 67 75 61 is set. This gua
e990: 72 61 6e 74 65 65 73 0a 20 20 2a 2a 20 20 20 20 rantees. **
e9a0: 20 74 68 61 74 20 67 61 72 62 61 67 65 20 64 61 that garbage da
e9b0: 74 61 20 69 73 20 6e 65 76 65 72 20 61 70 70 65 ta is never appe
e9c0: 6e 64 65 64 20 74 6f 20 74 68 65 20 6a 6f 75 72 nded to the jour
e9d0: 6e 61 6c 20 66 69 6c 65 2e 0a 20 20 2a 2f 0a 20 nal file.. */.
e9e0: 20 61 73 73 65 72 74 28 20 69 73 4f 70 65 6e 28 assert( isOpen(
e9f0: 70 50 61 67 65 72 2d 3e 66 64 29 20 7c 7c 20 70 pPager->fd) || p
ea00: 50 61 67 65 72 2d 3e 6e 6f 53 79 6e 63 20 29 3b Pager->noSync );
ea10: 0a 20 20 69 66 28 20 70 50 61 67 65 72 2d 3e 6e . if( pPager->n
ea20: 6f 53 79 6e 63 20 7c 7c 20 28 70 50 61 67 65 72 oSync || (pPager
ea30: 2d 3e 6a 6f 75 72 6e 61 6c 4d 6f 64 65 3d 3d 50 ->journalMode==P
ea40: 41 47 45 52 5f 4a 4f 55 52 4e 41 4c 4d 4f 44 45 AGER_JOURNALMODE
ea50: 5f 4d 45 4d 4f 52 59 29 0a 20 20 20 7c 7c 20 28 _MEMORY). || (
ea60: 73 71 6c 69 74 65 33 4f 73 44 65 76 69 63 65 43 sqlite3OsDeviceC
ea70: 68 61 72 61 63 74 65 72 69 73 74 69 63 73 28 70 haracteristics(p
ea80: 50 61 67 65 72 2d 3e 66 64 29 26 53 51 4c 49 54 Pager->fd)&SQLIT
ea90: 45 5f 49 4f 43 41 50 5f 53 41 46 45 5f 41 50 50 E_IOCAP_SAFE_APP
eaa0: 45 4e 44 29 20 0a 20 20 29 7b 0a 20 20 20 20 6d END) . ){. m
eab0: 65 6d 63 70 79 28 7a 48 65 61 64 65 72 2c 20 61 emcpy(zHeader, a
eac0: 4a 6f 75 72 6e 61 6c 4d 61 67 69 63 2c 20 73 69 JournalMagic, si
ead0: 7a 65 6f 66 28 61 4a 6f 75 72 6e 61 6c 4d 61 67 zeof(aJournalMag
eae0: 69 63 29 29 3b 0a 20 20 20 20 70 75 74 33 32 62 ic));. put32b
eaf0: 69 74 73 28 26 7a 48 65 61 64 65 72 5b 73 69 7a its(&zHeader[siz
eb00: 65 6f 66 28 61 4a 6f 75 72 6e 61 6c 4d 61 67 69 eof(aJournalMagi
eb10: 63 29 5d 2c 20 30 78 66 66 66 66 66 66 66 66 29 c)], 0xffffffff)
eb20: 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 6d ;. }else{. m
eb30: 65 6d 73 65 74 28 7a 48 65 61 64 65 72 2c 20 30 emset(zHeader, 0
eb40: 2c 20 73 69 7a 65 6f 66 28 61 4a 6f 75 72 6e 61 , sizeof(aJourna
eb50: 6c 4d 61 67 69 63 29 2b 34 29 3b 0a 20 20 7d 0a lMagic)+4);. }.
eb60: 0a 20 20 2f 2a 20 54 68 65 20 72 61 6e 64 6f 6d . /* The random
eb70: 20 63 68 65 63 6b 2d 68 61 73 68 20 69 6e 69 74 check-hash init
eb80: 69 61 6c 69 7a 65 72 20 2a 2f 20 0a 20 20 73 71 ializer */ . sq
eb90: 6c 69 74 65 33 5f 72 61 6e 64 6f 6d 6e 65 73 73 lite3_randomness
eba0: 28 73 69 7a 65 6f 66 28 70 50 61 67 65 72 2d 3e (sizeof(pPager->
ebb0: 63 6b 73 75 6d 49 6e 69 74 29 2c 20 26 70 50 61 cksumInit), &pPa
ebc0: 67 65 72 2d 3e 63 6b 73 75 6d 49 6e 69 74 29 3b ger->cksumInit);
ebd0: 0a 20 20 70 75 74 33 32 62 69 74 73 28 26 7a 48 . put32bits(&zH
ebe0: 65 61 64 65 72 5b 73 69 7a 65 6f 66 28 61 4a 6f eader[sizeof(aJo
ebf0: 75 72 6e 61 6c 4d 61 67 69 63 29 2b 34 5d 2c 20 urnalMagic)+4],
ec00: 70 50 61 67 65 72 2d 3e 63 6b 73 75 6d 49 6e 69 pPager->cksumIni
ec10: 74 29 3b 0a 20 20 2f 2a 20 54 68 65 20 69 6e 69 t);. /* The ini
ec20: 74 69 61 6c 20 64 61 74 61 62 61 73 65 20 73 69 tial database si
ec30: 7a 65 20 2a 2f 0a 20 20 70 75 74 33 32 62 69 74 ze */. put32bit
ec40: 73 28 26 7a 48 65 61 64 65 72 5b 73 69 7a 65 6f s(&zHeader[sizeo
ec50: 66 28 61 4a 6f 75 72 6e 61 6c 4d 61 67 69 63 29 f(aJournalMagic)
ec60: 2b 38 5d 2c 20 70 50 61 67 65 72 2d 3e 64 62 4f +8], pPager->dbO
ec70: 72 69 67 53 69 7a 65 29 3b 0a 20 20 2f 2a 20 54 rigSize);. /* T
ec80: 68 65 20 61 73 73 75 6d 65 64 20 73 65 63 74 6f he assumed secto
ec90: 72 20 73 69 7a 65 20 66 6f 72 20 74 68 69 73 20 r size for this
eca0: 70 72 6f 63 65 73 73 20 2a 2f 0a 20 20 70 75 74 process */. put
ecb0: 33 32 62 69 74 73 28 26 7a 48 65 61 64 65 72 5b 32bits(&zHeader[
ecc0: 73 69 7a 65 6f 66 28 61 4a 6f 75 72 6e 61 6c 4d sizeof(aJournalM
ecd0: 61 67 69 63 29 2b 31 32 5d 2c 20 70 50 61 67 65 agic)+12], pPage
ece0: 72 2d 3e 73 65 63 74 6f 72 53 69 7a 65 29 3b 0a r->sectorSize);.
ecf0: 0a 20 20 2f 2a 20 54 68 65 20 70 61 67 65 20 73 . /* The page s
ed00: 69 7a 65 20 2a 2f 0a 20 20 70 75 74 33 32 62 69 ize */. put32bi
ed10: 74 73 28 26 7a 48 65 61 64 65 72 5b 73 69 7a 65 ts(&zHeader[size
ed20: 6f 66 28 61 4a 6f 75 72 6e 61 6c 4d 61 67 69 63 of(aJournalMagic
ed30: 29 2b 31 36 5d 2c 20 70 50 61 67 65 72 2d 3e 70 )+16], pPager->p
ed40: 61 67 65 53 69 7a 65 29 3b 0a 0a 20 20 2f 2a 20 ageSize);.. /*
ed50: 49 6e 69 74 69 61 6c 69 7a 69 6e 67 20 74 68 65 Initializing the
ed60: 20 74 61 69 6c 20 6f 66 20 74 68 65 20 62 75 66 tail of the buf
ed70: 66 65 72 20 69 73 20 6e 6f 74 20 6e 65 63 65 73 fer is not neces
ed80: 73 61 72 79 2e 20 20 45 76 65 72 79 74 68 69 6e sary. Everythin
ed90: 67 0a 20 20 2a 2a 20 77 6f 72 6b 73 20 66 69 6e g. ** works fin
eda0: 64 20 69 66 20 74 68 65 20 66 6f 6c 6c 6f 77 69 d if the followi
edb0: 6e 67 20 6d 65 6d 73 65 74 28 29 20 69 73 20 6f ng memset() is o
edc0: 6d 69 74 74 65 64 2e 20 20 42 75 74 20 69 6e 69 mitted. But ini
edd0: 74 69 61 6c 69 7a 69 6e 67 0a 20 20 2a 2a 20 74 tializing. ** t
ede0: 68 65 20 6d 65 6d 6f 72 79 20 70 72 65 76 65 6e he memory preven
edf0: 74 73 20 76 61 6c 67 72 69 6e 64 20 66 72 6f 6d ts valgrind from
ee00: 20 63 6f 6d 70 6c 61 69 6e 69 6e 67 2c 20 73 6f complaining, so
ee10: 20 77 65 20 61 72 65 20 77 69 6c 6c 69 6e 67 20 we are willing
ee20: 74 6f 0a 20 20 2a 2a 20 74 61 6b 65 20 74 68 65 to. ** take the
ee30: 20 70 65 72 66 6f 72 6d 61 6e 63 65 20 68 69 74 performance hit
ee40: 2e 0a 20 20 2a 2f 0a 20 20 6d 65 6d 73 65 74 28 .. */. memset(
ee50: 26 7a 48 65 61 64 65 72 5b 73 69 7a 65 6f 66 28 &zHeader[sizeof(
ee60: 61 4a 6f 75 72 6e 61 6c 4d 61 67 69 63 29 2b 32 aJournalMagic)+2
ee70: 30 5d 2c 20 30 2c 0a 20 20 20 20 20 20 20 20 20 0], 0,.
ee80: 6e 48 65 61 64 65 72 2d 28 73 69 7a 65 6f 66 28 nHeader-(sizeof(
ee90: 61 4a 6f 75 72 6e 61 6c 4d 61 67 69 63 29 2b 32 aJournalMagic)+2
eea0: 30 29 29 3b 0a 0a 20 20 2f 2a 20 49 6e 20 74 68 0));.. /* In th
eeb0: 65 6f 72 79 2c 20 69 74 20 69 73 20 6f 6e 6c 79 eory, it is only
eec0: 20 6e 65 63 65 73 73 61 72 79 20 74 6f 20 77 72 necessary to wr
eed0: 69 74 65 20 74 68 65 20 32 38 20 62 79 74 65 73 ite the 28 bytes
eee0: 20 74 68 61 74 20 74 68 65 20 0a 20 20 2a 2a 20 that the . **
eef0: 6a 6f 75 72 6e 61 6c 20 68 65 61 64 65 72 20 63 journal header c
ef00: 6f 6e 73 75 6d 65 73 20 74 6f 20 74 68 65 20 6a onsumes to the j
ef10: 6f 75 72 6e 61 6c 20 66 69 6c 65 20 68 65 72 65 ournal file here
ef20: 2e 20 54 68 65 6e 20 69 6e 63 72 65 6d 65 6e 74 . Then increment
ef30: 20 74 68 65 20 0a 20 20 2a 2a 20 50 61 67 65 72 the . ** Pager
ef40: 2e 6a 6f 75 72 6e 61 6c 4f 66 66 20 76 61 72 69 .journalOff vari
ef50: 61 62 6c 65 20 62 79 20 4a 4f 55 52 4e 41 4c 5f able by JOURNAL_
ef60: 48 44 52 5f 53 5a 20 73 6f 20 74 68 61 74 20 74 HDR_SZ so that t
ef70: 68 65 20 6e 65 78 74 20 0a 20 20 2a 2a 20 72 65 he next . ** re
ef80: 63 6f 72 64 20 69 73 20 77 72 69 74 74 65 6e 20 cord is written
ef90: 74 6f 20 74 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 to the following
efa0: 20 73 65 63 74 6f 72 20 28 6c 65 61 76 69 6e 67 sector (leaving
efb0: 20 61 20 67 61 70 20 69 6e 20 74 68 65 20 66 69 a gap in the fi
efc0: 6c 65 0a 20 20 2a 2a 20 74 68 61 74 20 77 69 6c le. ** that wil
efd0: 6c 20 62 65 20 69 6d 70 6c 69 63 69 74 6c 79 20 l be implicitly
efe0: 66 69 6c 6c 65 64 20 69 6e 20 62 79 20 74 68 65 filled in by the
eff0: 20 4f 53 29 2e 0a 20 20 2a 2a 0a 20 20 2a 2a 20 OS).. **. **
f000: 48 6f 77 65 76 65 72 20 69 74 20 68 61 73 20 62 However it has b
f010: 65 65 6e 20 64 69 73 63 6f 76 65 72 65 64 20 74 een discovered t
f020: 68 61 74 20 6f 6e 20 73 6f 6d 65 20 73 79 73 74 hat on some syst
f030: 65 6d 73 20 74 68 69 73 20 70 61 74 74 65 72 6e ems this pattern
f040: 20 63 61 6e 20 0a 20 20 2a 2a 20 62 65 20 73 69 can . ** be si
f050: 67 6e 69 66 69 63 61 6e 74 6c 79 20 73 6c 6f 77 gnificantly slow
f060: 65 72 20 74 68 61 6e 20 63 6f 6e 74 69 67 75 6f er than contiguo
f070: 75 73 6c 79 20 77 72 69 74 69 6e 67 20 64 61 74 usly writing dat
f080: 61 20 74 6f 20 74 68 65 20 66 69 6c 65 2c 0a 20 a to the file,.
f090: 20 2a 2a 20 65 76 65 6e 20 69 66 20 74 68 61 74 ** even if that
f0a0: 20 6d 65 61 6e 73 20 65 78 70 6c 69 63 69 74 6c means explicitl
f0b0: 79 20 77 72 69 74 69 6e 67 20 64 61 74 61 20 74 y writing data t
f0c0: 6f 20 74 68 65 20 62 6c 6f 63 6b 20 6f 66 20 0a o the block of .
f0d0: 20 20 2a 2a 20 28 4a 4f 55 52 4e 41 4c 5f 48 44 ** (JOURNAL_HD
f0e0: 52 5f 53 5a 20 2d 20 32 38 29 20 62 79 74 65 73 R_SZ - 28) bytes
f0f0: 20 74 68 61 74 20 77 69 6c 6c 20 6e 6f 74 20 62 that will not b
f100: 65 20 75 73 65 64 2e 20 53 6f 20 74 68 61 74 20 e used. So that
f110: 69 73 20 77 68 61 74 0a 20 20 2a 2a 20 69 73 20 is what. ** is
f120: 64 6f 6e 65 2e 20 0a 20 20 2a 2a 0a 20 20 2a 2a done. . **. **
f130: 20 54 68 65 20 6c 6f 6f 70 20 69 73 20 72 65 71 The loop is req
f140: 75 69 72 65 64 20 68 65 72 65 20 69 6e 20 63 61 uired here in ca
f150: 73 65 20 74 68 65 20 73 65 63 74 6f 72 2d 73 69 se the sector-si
f160: 7a 65 20 69 73 20 6c 61 72 67 65 72 20 74 68 61 ze is larger tha
f170: 6e 20 74 68 65 20 0a 20 20 2a 2a 20 64 61 74 61 n the . ** data
f180: 62 61 73 65 20 70 61 67 65 20 73 69 7a 65 2e 20 base page size.
f190: 53 69 6e 63 65 20 74 68 65 20 7a 48 65 61 64 65 Since the zHeade
f1a0: 72 20 62 75 66 66 65 72 20 69 73 20 6f 6e 6c 79 r buffer is only
f1b0: 20 50 61 67 65 72 2e 70 61 67 65 53 69 7a 65 0a Pager.pageSize.
f1c0: 20 20 2a 2a 20 62 79 74 65 73 20 69 6e 20 73 69 ** bytes in si
f1d0: 7a 65 2c 20 6d 6f 72 65 20 74 68 61 6e 20 6f 6e ze, more than on
f1e0: 65 20 63 61 6c 6c 20 74 6f 20 73 71 6c 69 74 65 e call to sqlite
f1f0: 33 4f 73 57 72 69 74 65 28 29 20 6d 61 79 20 62 3OsWrite() may b
f200: 65 20 72 65 71 75 69 72 65 64 0a 20 20 2a 2a 20 e required. **
f210: 74 6f 20 70 6f 70 75 6c 61 74 65 20 74 68 65 20 to populate the
f220: 65 6e 74 69 72 65 20 6a 6f 75 72 6e 61 6c 20 68 entire journal h
f230: 65 61 64 65 72 20 73 65 63 74 6f 72 2e 0a 20 20 eader sector..
f240: 2a 2f 20 0a 20 20 66 6f 72 28 6e 57 72 69 74 65 */ . for(nWrite
f250: 3d 30 3b 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4f =0; rc==SQLITE_O
f260: 4b 26 26 6e 57 72 69 74 65 3c 4a 4f 55 52 4e 41 K&&nWrite<JOURNA
f270: 4c 5f 48 44 52 5f 53 5a 28 70 50 61 67 65 72 29 L_HDR_SZ(pPager)
f280: 3b 20 6e 57 72 69 74 65 2b 3d 6e 48 65 61 64 65 ; nWrite+=nHeade
f290: 72 29 7b 0a 20 20 20 20 49 4f 54 52 41 43 45 28 r){. IOTRACE(
f2a0: 28 22 4a 48 44 52 20 25 70 20 25 6c 6c 64 20 25 ("JHDR %p %lld %
f2b0: 64 5c 6e 22 2c 20 70 50 61 67 65 72 2c 20 70 50 d\n", pPager, pP
f2c0: 61 67 65 72 2d 3e 6a 6f 75 72 6e 61 6c 48 64 72 ager->journalHdr
f2d0: 2c 20 6e 48 65 61 64 65 72 29 29 0a 20 20 20 20 , nHeader)).
f2e0: 72 63 20 3d 20 73 71 6c 69 74 65 33 4f 73 57 72 rc = sqlite3OsWr
f2f0: 69 74 65 28 70 50 61 67 65 72 2d 3e 6a 66 64 2c ite(pPager->jfd,
f300: 20 7a 48 65 61 64 65 72 2c 20 6e 48 65 61 64 65 zHeader, nHeade
f310: 72 2c 20 70 50 61 67 65 72 2d 3e 6a 6f 75 72 6e r, pPager->journ
f320: 61 6c 4f 66 66 29 3b 0a 20 20 20 20 61 73 73 65 alOff);. asse
f330: 72 74 28 20 70 50 61 67 65 72 2d 3e 6a 6f 75 72 rt( pPager->jour
f340: 6e 61 6c 48 64 72 20 3c 3d 20 70 50 61 67 65 72 nalHdr <= pPager
f350: 2d 3e 6a 6f 75 72 6e 61 6c 4f 66 66 20 29 3b 0a ->journalOff );.
f360: 20 20 20 20 70 50 61 67 65 72 2d 3e 6a 6f 75 72 pPager->jour
f370: 6e 61 6c 4f 66 66 20 2b 3d 20 6e 48 65 61 64 65 nalOff += nHeade
f380: 72 3b 0a 20 20 7d 0a 0a 20 20 72 65 74 75 72 6e r;. }.. return
f390: 20 72 63 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 54 68 rc;.}../*.** Th
f3a0: 65 20 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 20 6d e journal file m
f3b0: 75 73 74 20 62 65 20 6f 70 65 6e 20 77 68 65 6e ust be open when
f3c0: 20 74 68 69 73 20 69 73 20 63 61 6c 6c 65 64 2e this is called.
f3d0: 20 41 20 6a 6f 75 72 6e 61 6c 20 68 65 61 64 65 A journal heade
f3e0: 72 20 66 69 6c 65 0a 2a 2a 20 28 4a 4f 55 52 4e r file.** (JOURN
f3f0: 41 4c 5f 48 44 52 5f 53 5a 20 62 79 74 65 73 29 AL_HDR_SZ bytes)
f400: 20 69 73 20 72 65 61 64 20 66 72 6f 6d 20 74 68 is read from th
f410: 65 20 63 75 72 72 65 6e 74 20 6c 6f 63 61 74 69 e current locati
f420: 6f 6e 20 69 6e 20 74 68 65 20 6a 6f 75 72 6e 61 on in the journa
f430: 6c 0a 2a 2a 20 66 69 6c 65 2e 20 54 68 65 20 63 l.** file. The c
f440: 75 72 72 65 6e 74 20 6c 6f 63 61 74 69 6f 6e 20 urrent location
f450: 69 6e 20 74 68 65 20 6a 6f 75 72 6e 61 6c 20 66 in the journal f
f460: 69 6c 65 20 69 73 20 67 69 76 65 6e 20 62 79 0a ile is given by.
f470: 2a 2a 20 70 50 61 67 65 72 2d 3e 6a 6f 75 72 6e ** pPager->journ
f480: 61 6c 4f 66 66 2e 20 53 65 65 20 63 6f 6d 6d 65 alOff. See comme
f490: 6e 74 73 20 61 62 6f 76 65 20 66 75 6e 63 74 69 nts above functi
f4a0: 6f 6e 20 77 72 69 74 65 4a 6f 75 72 6e 61 6c 48 on writeJournalH
f4b0: 64 72 28 29 20 66 6f 72 0a 2a 2a 20 61 20 64 65 dr() for.** a de
f4c0: 73 63 72 69 70 74 69 6f 6e 20 6f 66 20 74 68 65 scription of the
f4d0: 20 6a 6f 75 72 6e 61 6c 20 68 65 61 64 65 72 20 journal header
f4e0: 66 6f 72 6d 61 74 2e 0a 2a 2a 0a 2a 2a 20 49 66 format..**.** If
f4f0: 20 74 68 65 20 68 65 61 64 65 72 20 69 73 20 72 the header is r
f500: 65 61 64 20 73 75 63 63 65 73 73 66 75 6c 6c 79 ead successfully
f510: 2c 20 2a 70 4e 52 65 63 20 69 73 20 73 65 74 20 , *pNRec is set
f520: 74 6f 20 74 68 65 20 6e 75 6d 62 65 72 20 6f 66 to the number of
f530: 0a 2a 2a 20 70 61 67 65 20 72 65 63 6f 72 64 73 .** page records
f540: 20 66 6f 6c 6c 6f 77 69 6e 67 20 74 68 69 73 20 following this
f550: 68 65 61 64 65 72 20 61 6e 64 20 2a 70 44 62 53 header and *pDbS
f560: 69 7a 65 20 69 73 20 73 65 74 20 74 6f 20 74 68 ize is set to th
f570: 65 20 73 69 7a 65 20 6f 66 20 74 68 65 0a 2a 2a e size of the.**
f580: 20 64 61 74 61 62 61 73 65 20 62 65 66 6f 72 65 database before
f590: 20 74 68 65 20 74 72 61 6e 73 61 63 74 69 6f 6e the transaction
f5a0: 20 62 65 67 61 6e 2c 20 69 6e 20 70 61 67 65 73 began, in pages
f5b0: 2e 20 41 6c 73 6f 2c 20 70 50 61 67 65 72 2d 3e . Also, pPager->
f5c0: 63 6b 73 75 6d 49 6e 69 74 0a 2a 2a 20 69 73 20 cksumInit.** is
f5d0: 73 65 74 20 74 6f 20 74 68 65 20 76 61 6c 75 65 set to the value
f5e0: 20 72 65 61 64 20 66 72 6f 6d 20 74 68 65 20 6a read from the j
f5f0: 6f 75 72 6e 61 6c 20 68 65 61 64 65 72 2e 20 53 ournal header. S
f600: 51 4c 49 54 45 5f 4f 4b 20 69 73 20 72 65 74 75 QLITE_OK is retu
f610: 72 6e 65 64 0a 2a 2a 20 69 6e 20 74 68 69 73 20 rned.** in this
f620: 63 61 73 65 2e 0a 2a 2a 0a 2a 2a 20 49 66 20 74 case..**.** If t
f630: 68 65 20 6a 6f 75 72 6e 61 6c 20 68 65 61 64 65 he journal heade
f640: 72 20 66 69 6c 65 20 61 70 70 65 61 72 73 20 74 r file appears t
f650: 6f 20 62 65 20 63 6f 72 72 75 70 74 65 64 2c 20 o be corrupted,
f660: 53 51 4c 49 54 45 5f 44 4f 4e 45 20 69 73 0a 2a SQLITE_DONE is.*
f670: 2a 20 72 65 74 75 72 6e 65 64 20 61 6e 64 20 2a * returned and *
f680: 70 4e 52 65 63 20 61 6e 64 20 2a 50 44 62 53 69 pNRec and *PDbSi
f690: 7a 65 20 61 72 65 20 75 6e 64 65 66 69 6e 65 64 ze are undefined
f6a0: 2e 20 20 49 66 20 4a 4f 55 52 4e 41 4c 5f 48 44 . If JOURNAL_HD
f6b0: 52 5f 53 5a 20 62 79 74 65 73 0a 2a 2a 20 63 61 R_SZ bytes.** ca
f6c0: 6e 6e 6f 74 20 62 65 20 72 65 61 64 20 66 72 6f nnot be read fro
f6d0: 6d 20 74 68 65 20 6a 6f 75 72 6e 61 6c 20 66 69 m the journal fi
f6e0: 6c 65 20 61 6e 20 65 72 72 6f 72 20 63 6f 64 65 le an error code
f6f0: 20 69 73 20 72 65 74 75 72 6e 65 64 2e 0a 2a 2f is returned..*/
f700: 0a 73 74 61 74 69 63 20 69 6e 74 20 72 65 61 64 .static int read
f710: 4a 6f 75 72 6e 61 6c 48 64 72 28 0a 20 20 50 61 JournalHdr(. Pa
f720: 67 65 72 20 2a 70 50 61 67 65 72 2c 20 20 20 20 ger *pPager,
f730: 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 50 61 /* Pa
f740: 67 65 72 20 6f 62 6a 65 63 74 20 2a 2f 0a 20 20 ger object */.
f750: 69 6e 74 20 69 73 48 6f 74 2c 0a 20 20 69 36 34 int isHot,. i64
f760: 20 6a 6f 75 72 6e 61 6c 53 69 7a 65 2c 20 20 20 journalSize,
f770: 20 20 20 20 20 20 20 20 20 20 2f 2a 20 53 69 7a /* Siz
f780: 65 20 6f 66 20 74 68 65 20 6f 70 65 6e 20 6a 6f e of the open jo
f790: 75 72 6e 61 6c 20 66 69 6c 65 20 69 6e 20 62 79 urnal file in by
f7a0: 74 65 73 20 2a 2f 0a 20 20 75 33 32 20 2a 70 4e tes */. u32 *pN
f7b0: 52 65 63 2c 20 20 20 20 20 20 20 20 20 20 20 20 Rec,
f7c0: 20 20 20 20 20 20 2f 2a 20 4f 55 54 3a 20 56 61 /* OUT: Va
f7d0: 6c 75 65 20 72 65 61 64 20 66 72 6f 6d 20 74 68 lue read from th
f7e0: 65 20 6e 52 65 63 20 66 69 65 6c 64 20 2a 2f 0a e nRec field */.
f7f0: 20 20 75 33 32 20 2a 70 44 62 53 69 7a 65 20 20 u32 *pDbSize
f800: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f /
f810: 2a 20 4f 55 54 3a 20 56 61 6c 75 65 20 6f 66 20 * OUT: Value of
f820: 6f 72 69 67 69 6e 61 6c 20 64 61 74 61 62 61 73 original databas
f830: 65 20 73 69 7a 65 20 66 69 65 6c 64 20 2a 2f 0a e size field */.
f840: 29 7b 0a 20 20 69 6e 74 20 72 63 3b 20 20 20 20 ){. int rc;
f850: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
f860: 20 20 2f 2a 20 52 65 74 75 72 6e 20 63 6f 64 65 /* Return code
f870: 20 2a 2f 0a 20 20 75 6e 73 69 67 6e 65 64 20 63 */. unsigned c
f880: 68 61 72 20 61 4d 61 67 69 63 5b 38 5d 3b 20 20 har aMagic[8];
f890: 20 20 20 2f 2a 20 41 20 62 75 66 66 65 72 20 74 /* A buffer t
f8a0: 6f 20 68 6f 6c 64 20 74 68 65 20 6d 61 67 69 63 o hold the magic
f8b0: 20 68 65 61 64 65 72 20 2a 2f 0a 20 20 69 36 34 header */. i64
f8c0: 20 69 48 64 72 4f 66 66 3b 20 20 20 20 20 20 20 iHdrOff;
f8d0: 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4f 66 66 /* Off
f8e0: 73 65 74 20 6f 66 20 6a 6f 75 72 6e 61 6c 20 68 set of journal h
f8f0: 65 61 64 65 72 20 62 65 69 6e 67 20 72 65 61 64 eader being read
f900: 20 2a 2f 0a 0a 20 20 61 73 73 65 72 74 28 20 69 */.. assert( i
f910: 73 4f 70 65 6e 28 70 50 61 67 65 72 2d 3e 6a 66 sOpen(pPager->jf
f920: 64 29 20 29 3b 20 20 20 20 20 20 2f 2a 20 4a 6f d) ); /* Jo
f930: 75 72 6e 61 6c 20 66 69 6c 65 20 6d 75 73 74 20 urnal file must
f940: 62 65 20 6f 70 65 6e 2e 20 2a 2f 0a 0a 20 20 2f be open. */.. /
f950: 2a 20 41 64 76 61 6e 63 65 20 50 61 67 65 72 2e * Advance Pager.
f960: 6a 6f 75 72 6e 61 6c 4f 66 66 20 74 6f 20 74 68 journalOff to th
f970: 65 20 73 74 61 72 74 20 6f 66 20 74 68 65 20 6e e start of the n
f980: 65 78 74 20 73 65 63 74 6f 72 2e 20 49 66 20 74 ext sector. If t
f990: 68 65 0a 20 20 2a 2a 20 6a 6f 75 72 6e 61 6c 20 he. ** journal
f9a0: 66 69 6c 65 20 69 73 20 74 6f 6f 20 73 6d 61 6c file is too smal
f9b0: 6c 20 66 6f 72 20 74 68 65 72 65 20 74 6f 20 62 l for there to b
f9c0: 65 20 61 20 68 65 61 64 65 72 20 73 74 6f 72 65 e a header store
f9d0: 64 20 61 74 20 74 68 69 73 0a 20 20 2a 2a 20 70 d at this. ** p
f9e0: 6f 69 6e 74 2c 20 72 65 74 75 72 6e 20 53 51 4c oint, return SQL
f9f0: 49 54 45 5f 44 4f 4e 45 2e 0a 20 20 2a 2f 0a 20 ITE_DONE.. */.
fa00: 20 70 50 61 67 65 72 2d 3e 6a 6f 75 72 6e 61 6c pPager->journal
fa10: 4f 66 66 20 3d 20 6a 6f 75 72 6e 61 6c 48 64 72 Off = journalHdr
fa20: 4f 66 66 73 65 74 28 70 50 61 67 65 72 29 3b 0a Offset(pPager);.
fa30: 20 20 69 66 28 20 70 50 61 67 65 72 2d 3e 6a 6f if( pPager->jo
fa40: 75 72 6e 61 6c 4f 66 66 2b 4a 4f 55 52 4e 41 4c urnalOff+JOURNAL
fa50: 5f 48 44 52 5f 53 5a 28 70 50 61 67 65 72 29 20 _HDR_SZ(pPager)
fa60: 3e 20 6a 6f 75 72 6e 61 6c 53 69 7a 65 20 29 7b > journalSize ){
fa70: 0a 20 20 20 20 72 65 74 75 72 6e 20 53 51 4c 49 . return SQLI
fa80: 54 45 5f 44 4f 4e 45 3b 0a 20 20 7d 0a 20 20 69 TE_DONE;. }. i
fa90: 48 64 72 4f 66 66 20 3d 20 70 50 61 67 65 72 2d HdrOff = pPager-
faa0: 3e 6a 6f 75 72 6e 61 6c 4f 66 66 3b 0a 0a 20 20 >journalOff;..
fab0: 2f 2a 20 52 65 61 64 20 69 6e 20 74 68 65 20 66 /* Read in the f
fac0: 69 72 73 74 20 38 20 62 79 74 65 73 20 6f 66 20 irst 8 bytes of
fad0: 74 68 65 20 6a 6f 75 72 6e 61 6c 20 68 65 61 64 the journal head
fae0: 65 72 2e 20 49 66 20 74 68 65 79 20 64 6f 20 6e er. If they do n
faf0: 6f 74 20 6d 61 74 63 68 0a 20 20 2a 2a 20 74 68 ot match. ** th
fb00: 65 20 20 6d 61 67 69 63 20 73 74 72 69 6e 67 20 e magic string
fb10: 66 6f 75 6e 64 20 61 74 20 74 68 65 20 73 74 61 found at the sta
fb20: 72 74 20 6f 66 20 65 61 63 68 20 6a 6f 75 72 6e rt of each journ
fb30: 61 6c 20 68 65 61 64 65 72 2c 20 72 65 74 75 72 al header, retur
fb40: 6e 0a 20 20 2a 2a 20 53 51 4c 49 54 45 5f 44 4f n. ** SQLITE_DO
fb50: 4e 45 2e 20 49 66 20 61 6e 20 49 4f 20 65 72 72 NE. If an IO err
fb60: 6f 72 20 6f 63 63 75 72 73 2c 20 72 65 74 75 72 or occurs, retur
fb70: 6e 20 61 6e 20 65 72 72 6f 72 20 63 6f 64 65 2e n an error code.
fb80: 20 4f 74 68 65 72 77 69 73 65 2c 0a 20 20 2a 2a Otherwise,. **
fb90: 20 70 72 6f 63 65 65 64 2e 0a 20 20 2a 2f 0a 20 proceed.. */.
fba0: 20 69 66 28 20 69 73 48 6f 74 20 7c 7c 20 69 48 if( isHot || iH
fbb0: 64 72 4f 66 66 21 3d 70 50 61 67 65 72 2d 3e 6a drOff!=pPager->j
fbc0: 6f 75 72 6e 61 6c 48 64 72 20 29 7b 0a 20 20 20 ournalHdr ){.
fbd0: 20 72 63 20 3d 20 73 71 6c 69 74 65 33 4f 73 52 rc = sqlite3OsR
fbe0: 65 61 64 28 70 50 61 67 65 72 2d 3e 6a 66 64 2c ead(pPager->jfd,
fbf0: 20 61 4d 61 67 69 63 2c 20 73 69 7a 65 6f 66 28 aMagic, sizeof(
fc00: 61 4d 61 67 69 63 29 2c 20 69 48 64 72 4f 66 66 aMagic), iHdrOff
fc10: 29 3b 0a 20 20 20 20 69 66 28 20 72 63 20 29 7b );. if( rc ){
fc20: 0a 20 20 20 20 20 20 72 65 74 75 72 6e 20 72 63 . return rc
fc30: 3b 0a 20 20 20 20 7d 0a 20 20 20 20 69 66 28 20 ;. }. if(
fc40: 6d 65 6d 63 6d 70 28 61 4d 61 67 69 63 2c 20 61 memcmp(aMagic, a
fc50: 4a 6f 75 72 6e 61 6c 4d 61 67 69 63 2c 20 73 69 JournalMagic, si
fc60: 7a 65 6f 66 28 61 4d 61 67 69 63 29 29 21 3d 30 zeof(aMagic))!=0
fc70: 20 29 7b 0a 20 20 20 20 20 20 72 65 74 75 72 6e ){. return
fc80: 20 53 51 4c 49 54 45 5f 44 4f 4e 45 3b 0a 20 20 SQLITE_DONE;.
fc90: 20 20 7d 0a 20 20 7d 0a 0a 20 20 2f 2a 20 52 65 }. }.. /* Re
fca0: 61 64 20 74 68 65 20 66 69 72 73 74 20 74 68 72 ad the first thr
fcb0: 65 65 20 33 32 2d 62 69 74 20 66 69 65 6c 64 73 ee 32-bit fields
fcc0: 20 6f 66 20 74 68 65 20 6a 6f 75 72 6e 61 6c 20 of the journal
fcd0: 68 65 61 64 65 72 3a 20 54 68 65 20 6e 52 65 63 header: The nRec
fce0: 0a 20 20 2a 2a 20 66 69 65 6c 64 2c 20 74 68 65 . ** field, the
fcf0: 20 63 68 65 63 6b 73 75 6d 2d 69 6e 69 74 69 61 checksum-initia
fd00: 6c 69 7a 65 72 20 61 6e 64 20 74 68 65 20 64 61 lizer and the da
fd10: 74 61 62 61 73 65 20 73 69 7a 65 20 61 74 20 74 tabase size at t
fd20: 68 65 20 73 74 61 72 74 0a 20 20 2a 2a 20 6f 66 he start. ** of
fd30: 20 74 68 65 20 74 72 61 6e 73 61 63 74 69 6f 6e the transaction
fd40: 2e 20 52 65 74 75 72 6e 20 61 6e 20 65 72 72 6f . Return an erro
fd50: 72 20 63 6f 64 65 20 69 66 20 61 6e 79 74 68 69 r code if anythi
fd60: 6e 67 20 67 6f 65 73 20 77 72 6f 6e 67 2e 0a 20 ng goes wrong..
fd70: 20 2a 2f 0a 20 20 69 66 28 20 53 51 4c 49 54 45 */. if( SQLITE
fd80: 5f 4f 4b 21 3d 28 72 63 20 3d 20 72 65 61 64 33 _OK!=(rc = read3
fd90: 32 62 69 74 73 28 70 50 61 67 65 72 2d 3e 6a 66 2bits(pPager->jf
fda0: 64 2c 20 69 48 64 72 4f 66 66 2b 38 2c 20 70 4e d, iHdrOff+8, pN
fdb0: 52 65 63 29 29 0a 20 20 20 7c 7c 20 53 51 4c 49 Rec)). || SQLI
fdc0: 54 45 5f 4f 4b 21 3d 28 72 63 20 3d 20 72 65 61 TE_OK!=(rc = rea
fdd0: 64 33 32 62 69 74 73 28 70 50 61 67 65 72 2d 3e d32bits(pPager->
fde0: 6a 66 64 2c 20 69 48 64 72 4f 66 66 2b 31 32 2c jfd, iHdrOff+12,
fdf0: 20 26 70 50 61 67 65 72 2d 3e 63 6b 73 75 6d 49 &pPager->cksumI
fe00: 6e 69 74 29 29 0a 20 20 20 7c 7c 20 53 51 4c 49 nit)). || SQLI
fe10: 54 45 5f 4f 4b 21 3d 28 72 63 20 3d 20 72 65 61 TE_OK!=(rc = rea
fe20: 64 33 32 62 69 74 73 28 70 50 61 67 65 72 2d 3e d32bits(pPager->
fe30: 6a 66 64 2c 20 69 48 64 72 4f 66 66 2b 31 36 2c jfd, iHdrOff+16,
fe40: 20 70 44 62 53 69 7a 65 29 29 0a 20 20 29 7b 0a pDbSize)). ){.
fe50: 20 20 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 20 return rc;.
fe60: 20 7d 0a 0a 20 20 69 66 28 20 70 50 61 67 65 72 }.. if( pPager
fe70: 2d 3e 6a 6f 75 72 6e 61 6c 4f 66 66 3d 3d 30 20 ->journalOff==0
fe80: 29 7b 0a 20 20 20 20 75 33 32 20 69 50 61 67 65 ){. u32 iPage
fe90: 53 69 7a 65 3b 20 20 20 20 20 20 20 20 20 20 20 Size;
fea0: 20 20 20 20 2f 2a 20 50 61 67 65 2d 73 69 7a 65 /* Page-size
feb0: 20 66 69 65 6c 64 20 6f 66 20 6a 6f 75 72 6e 61 field of journa
fec0: 6c 20 68 65 61 64 65 72 20 2a 2f 0a 20 20 20 20 l header */.
fed0: 75 33 32 20 69 53 65 63 74 6f 72 53 69 7a 65 3b u32 iSectorSize;
fee0: 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 /*
fef0: 53 65 63 74 6f 72 2d 73 69 7a 65 20 66 69 65 6c Sector-size fiel
ff00: 64 20 6f 66 20 6a 6f 75 72 6e 61 6c 20 68 65 61 d of journal hea
ff10: 64 65 72 20 2a 2f 0a 0a 20 20 20 20 2f 2a 20 52 der */.. /* R
ff20: 65 61 64 20 74 68 65 20 70 61 67 65 2d 73 69 7a ead the page-siz
ff30: 65 20 61 6e 64 20 73 65 63 74 6f 72 2d 73 69 7a e and sector-siz
ff40: 65 20 6a 6f 75 72 6e 61 6c 20 68 65 61 64 65 72 e journal header
ff50: 20 66 69 65 6c 64 73 2e 20 2a 2f 0a 20 20 20 20 fields. */.
ff60: 69 66 28 20 53 51 4c 49 54 45 5f 4f 4b 21 3d 28 if( SQLITE_OK!=(
ff70: 72 63 20 3d 20 72 65 61 64 33 32 62 69 74 73 28 rc = read32bits(
ff80: 70 50 61 67 65 72 2d 3e 6a 66 64 2c 20 69 48 64 pPager->jfd, iHd
ff90: 72 4f 66 66 2b 32 30 2c 20 26 69 53 65 63 74 6f rOff+20, &iSecto
ffa0: 72 53 69 7a 65 29 29 0a 20 20 20 20 20 7c 7c 20 rSize)). ||
ffb0: 53 51 4c 49 54 45 5f 4f 4b 21 3d 28 72 63 20 3d SQLITE_OK!=(rc =
ffc0: 20 72 65 61 64 33 32 62 69 74 73 28 70 50 61 67 read32bits(pPag
ffd0: 65 72 2d 3e 6a 66 64 2c 20 69 48 64 72 4f 66 66 er->jfd, iHdrOff
ffe0: 2b 32 34 2c 20 26 69 50 61 67 65 53 69 7a 65 29 +24, &iPageSize)
fff0: 29 0a 20 20 20 20 29 7b 0a 20 20 20 20 20 20 72 ). ){. r
10000 65 74 75 72 6e 20 72 63 3b 0a 20 20 20 20 7d 0a eturn rc;. }.
10010 0a 20 20 20 20 2f 2a 20 56 65 72 73 69 6f 6e 73 . /* Versions
10020 20 6f 66 20 53 51 4c 69 74 65 20 70 72 69 6f 72 of SQLite prior
10030 20 74 6f 20 33 2e 35 2e 38 20 73 65 74 20 74 68 to 3.5.8 set th
10040 65 20 70 61 67 65 2d 73 69 7a 65 20 66 69 65 6c e page-size fiel
10050 64 20 6f 66 20 74 68 65 0a 20 20 20 20 2a 2a 20 d of the. **
10060 6a 6f 75 72 6e 61 6c 20 68 65 61 64 65 72 20 74 journal header t
10070 6f 20 7a 65 72 6f 2e 20 49 6e 20 74 68 69 73 20 o zero. In this
10080 63 61 73 65 2c 20 61 73 73 75 6d 65 20 74 68 61 case, assume tha
10090 74 20 74 68 65 20 50 61 67 65 72 2e 70 61 67 65 t the Pager.page
100a0 53 69 7a 65 0a 20 20 20 20 2a 2a 20 76 61 72 69 Size. ** vari
100b0 61 62 6c 65 20 69 73 20 61 6c 72 65 61 64 79 20 able is already
100c0 73 65 74 20 74 6f 20 74 68 65 20 63 6f 72 72 65 set to the corre
100d0 63 74 20 70 61 67 65 20 73 69 7a 65 2e 0a 20 20 ct page size..
100e0 20 20 2a 2f 0a 20 20 20 20 69 66 28 20 69 50 61 */. if( iPa
100f0 67 65 53 69 7a 65 3d 3d 30 20 29 7b 0a 20 20 20 geSize==0 ){.
10100 20 20 20 69 50 61 67 65 53 69 7a 65 20 3d 20 70 iPageSize = p
10110 50 61 67 65 72 2d 3e 70 61 67 65 53 69 7a 65 3b Pager->pageSize;
10120 0a 20 20 20 20 7d 0a 0a 20 20 20 20 2f 2a 20 43 . }.. /* C
10130 68 65 63 6b 20 74 68 61 74 20 74 68 65 20 76 61 heck that the va
10140 6c 75 65 73 20 72 65 61 64 20 66 72 6f 6d 20 74 lues read from t
10150 68 65 20 70 61 67 65 2d 73 69 7a 65 20 61 6e 64 he page-size and
10160 20 73 65 63 74 6f 72 2d 73 69 7a 65 20 66 69 65 sector-size fie
10170 6c 64 73 0a 20 20 20 20 2a 2a 20 61 72 65 20 77 lds. ** are w
10180 69 74 68 69 6e 20 72 61 6e 67 65 2e 20 54 6f 20 ithin range. To
10190 62 65 20 27 69 6e 20 72 61 6e 67 65 27 2c 20 62 be 'in range', b
101a0 6f 74 68 20 76 61 6c 75 65 73 20 6e 65 65 64 20 oth values need
101b0 74 6f 20 62 65 20 61 20 70 6f 77 65 72 0a 20 20 to be a power.
101c0 20 20 2a 2a 20 6f 66 20 74 77 6f 20 67 72 65 61 ** of two grea
101d0 74 65 72 20 74 68 61 6e 20 6f 72 20 65 71 75 61 ter than or equa
101e0 6c 20 74 6f 20 35 31 32 20 6f 72 20 33 32 2c 20 l to 512 or 32,
101f0 61 6e 64 20 6e 6f 74 20 67 72 65 61 74 65 72 20 and not greater
10200 74 68 61 6e 20 74 68 65 69 72 20 0a 20 20 20 20 than their .
10210 2a 2a 20 72 65 73 70 65 63 74 69 76 65 20 63 6f ** respective co
10220 6d 70 69 6c 65 20 74 69 6d 65 20 6d 61 78 69 6d mpile time maxim
10230 75 6d 20 6c 69 6d 69 74 73 2e 0a 20 20 20 20 2a um limits.. *
10240 2f 0a 20 20 20 20 69 66 28 20 69 50 61 67 65 53 /. if( iPageS
10250 69 7a 65 3c 35 31 32 20 20 20 20 20 20 20 20 20 ize<512
10260 20 20 20 20 20 20 20 20 20 7c 7c 20 69 53 65 63 || iSec
10270 74 6f 72 53 69 7a 65 3c 33 32 0a 20 20 20 20 20 torSize<32.
10280 7c 7c 20 69 50 61 67 65 53 69 7a 65 3e 53 51 4c || iPageSize>SQL
10290 49 54 45 5f 4d 41 58 5f 50 41 47 45 5f 53 49 5a ITE_MAX_PAGE_SIZ
102a0 45 20 7c 7c 20 69 53 65 63 74 6f 72 53 69 7a 65 E || iSectorSize
102b0 3e 4d 41 58 5f 53 45 43 54 4f 52 5f 53 49 5a 45 >MAX_SECTOR_SIZE
102c0 0a 20 20 20 20 20 7c 7c 20 28 28 69 50 61 67 65 . || ((iPage
102d0 53 69 7a 65 2d 31 29 26 69 50 61 67 65 53 69 7a Size-1)&iPageSiz
102e0 65 29 21 3d 30 20 20 20 7c 7c 20 28 28 69 53 65 e)!=0 || ((iSe
102f0 63 74 6f 72 53 69 7a 65 2d 31 29 26 69 53 65 63 ctorSize-1)&iSec
10300 74 6f 72 53 69 7a 65 29 21 3d 30 20 0a 20 20 20 torSize)!=0 .
10310 20 29 7b 0a 20 20 20 20 20 20 2f 2a 20 49 66 20 ){. /* If
10320 74 68 65 20 65 69 74 68 65 72 20 74 68 65 20 70 the either the p
10330 61 67 65 2d 73 69 7a 65 20 6f 72 20 73 65 63 74 age-size or sect
10340 6f 72 2d 73 69 7a 65 20 69 6e 20 74 68 65 20 6a or-size in the j
10350 6f 75 72 6e 61 6c 2d 68 65 61 64 65 72 20 69 73 ournal-header is
10360 20 0a 20 20 20 20 20 20 2a 2a 20 69 6e 76 61 6c . ** inval
10370 69 64 2c 20 74 68 65 6e 20 74 68 65 20 70 72 6f id, then the pro
10380 63 65 73 73 20 74 68 61 74 20 77 72 6f 74 65 20 cess that wrote
10390 74 68 65 20 6a 6f 75 72 6e 61 6c 2d 68 65 61 64 the journal-head
103a0 65 72 20 6d 75 73 74 20 68 61 76 65 20 0a 20 20 er must have .
103b0 20 20 20 20 2a 2a 20 63 72 61 73 68 65 64 20 62 ** crashed b
103c0 65 66 6f 72 65 20 74 68 65 20 68 65 61 64 65 72 efore the header
103d0 20 77 61 73 20 73 79 6e 63 65 64 2e 20 49 6e 20 was synced. In
103e0 74 68 69 73 20 63 61 73 65 20 73 74 6f 70 20 72 this case stop r
103f0 65 61 64 69 6e 67 20 0a 20 20 20 20 20 20 2a 2a eading . **
10400 20 74 68 65 20 6a 6f 75 72 6e 61 6c 20 66 69 6c the journal fil
10410 65 20 68 65 72 65 2e 0a 20 20 20 20 20 20 2a 2f e here.. */
10420 0a 20 20 20 20 20 20 72 65 74 75 72 6e 20 53 51 . return SQ
10430 4c 49 54 45 5f 44 4f 4e 45 3b 0a 20 20 20 20 7d LITE_DONE;. }
10440 0a 0a 20 20 20 20 2f 2a 20 55 70 64 61 74 65 20 .. /* Update
10450 74 68 65 20 70 61 67 65 2d 73 69 7a 65 20 74 6f the page-size to
10460 20 6d 61 74 63 68 20 74 68 65 20 76 61 6c 75 65 match the value
10470 20 72 65 61 64 20 66 72 6f 6d 20 74 68 65 20 6a read from the j
10480 6f 75 72 6e 61 6c 2e 20 0a 20 20 20 20 2a 2a 20 ournal. . **
10490 55 73 65 20 61 20 74 65 73 74 63 61 73 65 28 29 Use a testcase()
104a0 20 6d 61 63 72 6f 20 74 6f 20 6d 61 6b 65 20 73 macro to make s
104b0 75 72 65 20 74 68 61 74 20 6d 61 6c 6c 6f 63 20 ure that malloc
104c0 66 61 69 6c 75 72 65 20 77 69 74 68 69 6e 20 0a failure within .
104d0 20 20 20 20 2a 2a 20 50 61 67 65 72 53 65 74 50 ** PagerSetP
104e0 61 67 65 73 69 7a 65 28 29 20 69 73 20 74 65 73 agesize() is tes
104f0 74 65 64 2e 0a 20 20 20 20 2a 2f 0a 20 20 20 20 ted.. */.
10500 72 63 20 3d 20 73 71 6c 69 74 65 33 50 61 67 65 rc = sqlite3Page
10510 72 53 65 74 50 61 67 65 73 69 7a 65 28 70 50 61 rSetPagesize(pPa
10520 67 65 72 2c 20 26 69 50 61 67 65 53 69 7a 65 2c ger, &iPageSize,
10530 20 2d 31 29 3b 0a 20 20 20 20 74 65 73 74 63 61 -1);. testca
10540 73 65 28 20 72 63 21 3d 53 51 4c 49 54 45 5f 4f se( rc!=SQLITE_O
10550 4b 20 29 3b 0a 0a 20 20 20 20 2f 2a 20 55 70 64 K );.. /* Upd
10560 61 74 65 20 74 68 65 20 61 73 73 75 6d 65 64 20 ate the assumed
10570 73 65 63 74 6f 72 2d 73 69 7a 65 20 74 6f 20 6d sector-size to m
10580 61 74 63 68 20 74 68 65 20 76 61 6c 75 65 20 75 atch the value u
10590 73 65 64 20 62 79 20 0a 20 20 20 20 2a 2a 20 74 sed by . ** t
105a0 68 65 20 70 72 6f 63 65 73 73 20 74 68 61 74 20 he process that
105b0 63 72 65 61 74 65 64 20 74 68 69 73 20 6a 6f 75 created this jou
105c0 72 6e 61 6c 2e 20 49 66 20 74 68 69 73 20 6a 6f rnal. If this jo
105d0 75 72 6e 61 6c 20 77 61 73 0a 20 20 20 20 2a 2a urnal was. **
105e0 20 63 72 65 61 74 65 64 20 62 79 20 61 20 70 72 created by a pr
105f0 6f 63 65 73 73 20 6f 74 68 65 72 20 74 68 61 6e ocess other than
10600 20 74 68 69 73 20 6f 6e 65 2c 20 74 68 65 6e 20 this one, then
10610 74 68 69 73 20 72 6f 75 74 69 6e 65 0a 20 20 20 this routine.
10620 20 2a 2a 20 69 73 20 62 65 69 6e 67 20 63 61 6c ** is being cal
10630 6c 65 64 20 66 72 6f 6d 20 77 69 74 68 69 6e 20 led from within
10640 70 61 67 65 72 5f 70 6c 61 79 62 61 63 6b 28 29 pager_playback()
10650 2e 20 54 68 65 20 6c 6f 63 61 6c 20 76 61 6c 75 . The local valu
10660 65 0a 20 20 20 20 2a 2a 20 6f 66 20 50 61 67 65 e. ** of Page
10670 72 2e 73 65 63 74 6f 72 53 69 7a 65 20 69 73 20 r.sectorSize is
10680 72 65 73 74 6f 72 65 64 20 61 74 20 74 68 65 20 restored at the
10690 65 6e 64 20 6f 66 20 74 68 61 74 20 72 6f 75 74 end of that rout
106a0 69 6e 65 2e 0a 20 20 20 20 2a 2f 0a 20 20 20 20 ine.. */.
106b0 70 50 61 67 65 72 2d 3e 73 65 63 74 6f 72 53 69 pPager->sectorSi
106c0 7a 65 20 3d 20 69 53 65 63 74 6f 72 53 69 7a 65 ze = iSectorSize
106d0 3b 0a 20 20 7d 0a 0a 20 20 70 50 61 67 65 72 2d ;. }.. pPager-
106e0 3e 6a 6f 75 72 6e 61 6c 4f 66 66 20 2b 3d 20 4a >journalOff += J
106f0 4f 55 52 4e 41 4c 5f 48 44 52 5f 53 5a 28 70 50 OURNAL_HDR_SZ(pP
10700 61 67 65 72 29 3b 0a 20 20 72 65 74 75 72 6e 20 ager);. return
10710 72 63 3b 0a 7d 0a 0a 0a 2f 2a 0a 2a 2a 20 57 72 rc;.}.../*.** Wr
10720 69 74 65 20 74 68 65 20 73 75 70 70 6c 69 65 64 ite the supplied
10730 20 6d 61 73 74 65 72 20 6a 6f 75 72 6e 61 6c 20 master journal
10740 6e 61 6d 65 20 69 6e 74 6f 20 74 68 65 20 6a 6f name into the jo
10750 75 72 6e 61 6c 20 66 69 6c 65 20 66 6f 72 20 70 urnal file for p
10760 61 67 65 72 0a 2a 2a 20 70 50 61 67 65 72 20 61 ager.** pPager a
10770 74 20 74 68 65 20 63 75 72 72 65 6e 74 20 6c 6f t the current lo
10780 63 61 74 69 6f 6e 2e 20 54 68 65 20 6d 61 73 74 cation. The mast
10790 65 72 20 6a 6f 75 72 6e 61 6c 20 6e 61 6d 65 20 er journal name
107a0 6d 75 73 74 20 62 65 20 74 68 65 20 6c 61 73 74 must be the last
107b0 0a 2a 2a 20 74 68 69 6e 67 20 77 72 69 74 74 65 .** thing writte
107c0 6e 20 74 6f 20 61 20 6a 6f 75 72 6e 61 6c 20 66 n to a journal f
107d0 69 6c 65 2e 20 49 66 20 74 68 65 20 70 61 67 65 ile. If the page
107e0 72 20 69 73 20 69 6e 20 66 75 6c 6c 2d 73 79 6e r is in full-syn
107f0 63 20 6d 6f 64 65 2c 20 74 68 65 0a 2a 2a 20 6a c mode, the.** j
10800 6f 75 72 6e 61 6c 20 66 69 6c 65 20 64 65 73 63 ournal file desc
10810 72 69 70 74 6f 72 20 69 73 20 61 64 76 61 6e 63 riptor is advanc
10820 65 64 20 74 6f 20 74 68 65 20 6e 65 78 74 20 73 ed to the next s
10830 65 63 74 6f 72 20 62 6f 75 6e 64 61 72 79 20 62 ector boundary b
10840 65 66 6f 72 65 0a 2a 2a 20 61 6e 79 74 68 69 6e efore.** anythin
10850 67 20 69 73 20 77 72 69 74 74 65 6e 2e 20 54 68 g is written. Th
10860 65 20 66 6f 72 6d 61 74 20 69 73 3a 0a 2a 2a 0a e format is:.**.
10870 2a 2a 20 20 20 2b 20 34 20 62 79 74 65 73 3a 20 ** + 4 bytes:
10880 50 41 47 45 52 5f 4d 4a 5f 50 47 4e 4f 2e 0a 2a PAGER_MJ_PGNO..*
10890 2a 20 20 20 2b 20 4e 20 62 79 74 65 73 3a 20 4d * + N bytes: M
108a0 61 73 74 65 72 20 6a 6f 75 72 6e 61 6c 20 66 69 aster journal fi
108b0 6c 65 6e 61 6d 65 20 69 6e 20 75 74 66 2d 38 2e lename in utf-8.
108c0 0a 2a 2a 20 20 20 2b 20 34 20 62 79 74 65 73 3a .** + 4 bytes:
108d0 20 4e 20 28 6c 65 6e 67 74 68 20 6f 66 20 6d 61 N (length of ma
108e0 73 74 65 72 20 6a 6f 75 72 6e 61 6c 20 6e 61 6d ster journal nam
108f0 65 20 69 6e 20 62 79 74 65 73 2c 20 6e 6f 20 6e e in bytes, no n
10900 75 6c 2d 74 65 72 6d 69 6e 61 74 6f 72 29 2e 0a ul-terminator)..
10910 2a 2a 20 20 20 2b 20 34 20 62 79 74 65 73 3a 20 ** + 4 bytes:
10920 4d 61 73 74 65 72 20 6a 6f 75 72 6e 61 6c 20 6e Master journal n
10930 61 6d 65 20 63 68 65 63 6b 73 75 6d 2e 0a 2a 2a ame checksum..**
10940 20 20 20 2b 20 38 20 62 79 74 65 73 3a 20 61 4a + 8 bytes: aJ
10950 6f 75 72 6e 61 6c 4d 61 67 69 63 5b 5d 2e 0a 2a ournalMagic[]..*
10960 2a 0a 2a 2a 20 54 68 65 20 6d 61 73 74 65 72 20 *.** The master
10970 6a 6f 75 72 6e 61 6c 20 70 61 67 65 20 63 68 65 journal page che
10980 63 6b 73 75 6d 20 69 73 20 74 68 65 20 73 75 6d cksum is the sum
10990 20 6f 66 20 74 68 65 20 62 79 74 65 73 20 69 6e of the bytes in
109a0 20 74 68 65 20 6d 61 73 74 65 72 0a 2a 2a 20 6a the master.** j
109b0 6f 75 72 6e 61 6c 20 6e 61 6d 65 2c 20 77 68 65 ournal name, whe
109c0 72 65 20 65 61 63 68 20 62 79 74 65 20 69 73 20 re each byte is
109d0 69 6e 74 65 72 70 72 65 74 65 64 20 61 73 20 61 interpreted as a
109e0 20 73 69 67 6e 65 64 20 38 2d 62 69 74 20 69 6e signed 8-bit in
109f0 74 65 67 65 72 2e 0a 2a 2a 0a 2a 2a 20 49 66 20 teger..**.** If
10a00 7a 4d 61 73 74 65 72 20 69 73 20 61 20 4e 55 4c zMaster is a NUL
10a10 4c 20 70 6f 69 6e 74 65 72 20 28 6f 63 63 75 72 L pointer (occur
10a20 73 20 66 6f 72 20 61 20 73 69 6e 67 6c 65 20 64 s for a single d
10a30 61 74 61 62 61 73 65 20 74 72 61 6e 73 61 63 74 atabase transact
10a40 69 6f 6e 29 2c 20 0a 2a 2a 20 74 68 69 73 20 63 ion), .** this c
10a50 61 6c 6c 20 69 73 20 61 20 6e 6f 2d 6f 70 2e 0a all is a no-op..
10a60 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74 20 77 72 */.static int wr
10a70 69 74 65 4d 61 73 74 65 72 4a 6f 75 72 6e 61 6c iteMasterJournal
10a80 28 50 61 67 65 72 20 2a 70 50 61 67 65 72 2c 20 (Pager *pPager,
10a90 63 6f 6e 73 74 20 63 68 61 72 20 2a 7a 4d 61 73 const char *zMas
10aa0 74 65 72 29 7b 0a 20 20 69 6e 74 20 72 63 3b 20 ter){. int rc;
10ab0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
10ac0 20 20 20 20 20 20 20 20 20 2f 2a 20 52 65 74 75 /* Retu
10ad0 72 6e 20 63 6f 64 65 20 2a 2f 0a 20 20 69 6e 74 rn code */. int
10ae0 20 6e 4d 61 73 74 65 72 3b 20 20 20 20 20 20 20 nMaster;
10af0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a /*
10b00 20 4c 65 6e 67 74 68 20 6f 66 20 73 74 72 69 6e Length of strin
10b10 67 20 7a 4d 61 73 74 65 72 20 2a 2f 0a 20 20 69 g zMaster */. i
10b20 36 34 20 69 48 64 72 4f 66 66 3b 20 20 20 20 20 64 iHdrOff;
10b30 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
10b40 2f 2a 20 4f 66 66 73 65 74 20 6f 66 20 68 65 61 /* Offset of hea
10b50 64 65 72 20 69 6e 20 6a 6f 75 72 6e 61 6c 20 66 der in journal f
10b60 69 6c 65 20 2a 2f 0a 20 20 69 36 34 20 6a 72 6e ile */. i64 jrn
10b70 6c 53 69 7a 65 3b 20 20 20 20 20 20 20 20 20 20 lSize;
10b80 20 20 20 20 20 20 20 20 20 20 2f 2a 20 53 69 7a /* Siz
10b90 65 20 6f 66 20 6a 6f 75 72 6e 61 6c 20 66 69 6c e of journal fil
10ba0 65 20 6f 6e 20 64 69 73 6b 20 2a 2f 0a 20 20 75 e on disk */. u
10bb0 33 32 20 63 6b 73 75 6d 20 3d 20 30 3b 20 20 20 32 cksum = 0;
10bc0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
10bd0 2f 2a 20 43 68 65 63 6b 73 75 6d 20 6f 66 20 73 /* Checksum of s
10be0 74 72 69 6e 67 20 7a 4d 61 73 74 65 72 20 2a 2f tring zMaster */
10bf0 0a 0a 20 20 61 73 73 65 72 74 28 20 70 50 61 67 .. assert( pPag
10c00 65 72 2d 3e 73 65 74 4d 61 73 74 65 72 3d 3d 30 er->setMaster==0
10c10 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 21 70 );. assert( !p
10c20 61 67 65 72 55 73 65 57 61 6c 28 70 50 61 67 65 agerUseWal(pPage
10c30 72 29 20 29 3b 0a 0a 20 20 69 66 28 20 21 7a 4d r) );.. if( !zM
10c40 61 73 74 65 72 20 0a 20 20 20 7c 7c 20 70 50 61 aster . || pPa
10c50 67 65 72 2d 3e 6a 6f 75 72 6e 61 6c 4d 6f 64 65 ger->journalMode
10c60 3d 3d 50 41 47 45 52 5f 4a 4f 55 52 4e 41 4c 4d ==PAGER_JOURNALM
10c70 4f 44 45 5f 4d 45 4d 4f 52 59 20 0a 20 20 20 7c ODE_MEMORY . |
10c80 7c 20 21 69 73 4f 70 65 6e 28 70 50 61 67 65 72 | !isOpen(pPager
10c90 2d 3e 6a 66 64 29 0a 20 20 29 7b 0a 20 20 20 20 ->jfd). ){.
10ca0 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b return SQLITE_OK
10cb0 3b 0a 20 20 7d 0a 20 20 70 50 61 67 65 72 2d 3e ;. }. pPager->
10cc0 73 65 74 4d 61 73 74 65 72 20 3d 20 31 3b 0a 20 setMaster = 1;.
10cd0 20 61 73 73 65 72 74 28 20 70 50 61 67 65 72 2d assert( pPager-
10ce0 3e 6a 6f 75 72 6e 61 6c 48 64 72 20 3c 3d 20 70 >journalHdr <= p
10cf0 50 61 67 65 72 2d 3e 6a 6f 75 72 6e 61 6c 4f 66 Pager->journalOf
10d00 66 20 29 3b 0a 0a 20 20 2f 2a 20 43 61 6c 63 75 f );.. /* Calcu
10d10 6c 61 74 65 20 74 68 65 20 6c 65 6e 67 74 68 20 late the length
10d20 69 6e 20 62 79 74 65 73 20 61 6e 64 20 74 68 65 in bytes and the
10d30 20 63 68 65 63 6b 73 75 6d 20 6f 66 20 7a 4d 61 checksum of zMa
10d40 73 74 65 72 20 2a 2f 0a 20 20 66 6f 72 28 6e 4d ster */. for(nM
10d50 61 73 74 65 72 3d 30 3b 20 7a 4d 61 73 74 65 72 aster=0; zMaster
10d60 5b 6e 4d 61 73 74 65 72 5d 3b 20 6e 4d 61 73 74 [nMaster]; nMast
10d70 65 72 2b 2b 29 7b 0a 20 20 20 20 63 6b 73 75 6d er++){. cksum
10d80 20 2b 3d 20 7a 4d 61 73 74 65 72 5b 6e 4d 61 73 += zMaster[nMas
10d90 74 65 72 5d 3b 0a 20 20 7d 0a 0a 20 20 2f 2a 20 ter];. }.. /*
10da0 49 66 20 69 6e 20 66 75 6c 6c 2d 73 79 6e 63 20 If in full-sync
10db0 6d 6f 64 65 2c 20 61 64 76 61 6e 63 65 20 74 6f mode, advance to
10dc0 20 74 68 65 20 6e 65 78 74 20 64 69 73 6b 20 73 the next disk s
10dd0 65 63 74 6f 72 20 62 65 66 6f 72 65 20 77 72 69 ector before wri
10de0 74 69 6e 67 0a 20 20 2a 2a 20 74 68 65 20 6d 61 ting. ** the ma
10df0 73 74 65 72 20 6a 6f 75 72 6e 61 6c 20 6e 61 6d ster journal nam
10e00 65 2e 20 54 68 69 73 20 69 73 20 69 6e 20 63 61 e. This is in ca
10e10 73 65 20 74 68 65 20 70 72 65 76 69 6f 75 73 20 se the previous
10e20 70 61 67 65 20 77 72 69 74 74 65 6e 20 74 6f 0a page written to.
10e30 20 20 2a 2a 20 74 68 65 20 6a 6f 75 72 6e 61 6c ** the journal
10e40 20 68 61 73 20 61 6c 72 65 61 64 79 20 62 65 65 has already bee
10e50 6e 20 73 79 6e 63 65 64 2e 0a 20 20 2a 2f 0a 20 n synced.. */.
10e60 20 69 66 28 20 70 50 61 67 65 72 2d 3e 66 75 6c if( pPager->ful
10e70 6c 53 79 6e 63 20 29 7b 0a 20 20 20 20 70 50 61 lSync ){. pPa
10e80 67 65 72 2d 3e 6a 6f 75 72 6e 61 6c 4f 66 66 20 ger->journalOff
10e90 3d 20 6a 6f 75 72 6e 61 6c 48 64 72 4f 66 66 73 = journalHdrOffs
10ea0 65 74 28 70 50 61 67 65 72 29 3b 0a 20 20 7d 0a et(pPager);. }.
10eb0 20 20 69 48 64 72 4f 66 66 20 3d 20 70 50 61 67 iHdrOff = pPag
10ec0 65 72 2d 3e 6a 6f 75 72 6e 61 6c 4f 66 66 3b 0a er->journalOff;.
10ed0 0a 20 20 2f 2a 20 57 72 69 74 65 20 74 68 65 20 . /* Write the
10ee0 6d 61 73 74 65 72 20 6a 6f 75 72 6e 61 6c 20 64 master journal d
10ef0 61 74 61 20 74 6f 20 74 68 65 20 65 6e 64 20 6f ata to the end o
10f00 66 20 74 68 65 20 6a 6f 75 72 6e 61 6c 20 66 69 f the journal fi
10f10 6c 65 2e 20 49 66 0a 20 20 2a 2a 20 61 6e 20 65 le. If. ** an e
10f20 72 72 6f 72 20 6f 63 63 75 72 73 2c 20 72 65 74 rror occurs, ret
10f30 75 72 6e 20 74 68 65 20 65 72 72 6f 72 20 63 6f urn the error co
10f40 64 65 20 74 6f 20 74 68 65 20 63 61 6c 6c 65 72 de to the caller
10f50 2e 0a 20 20 2a 2f 0a 20 20 69 66 28 20 28 30 20 .. */. if( (0
10f60 21 3d 20 28 72 63 20 3d 20 77 72 69 74 65 33 32 != (rc = write32
10f70 62 69 74 73 28 70 50 61 67 65 72 2d 3e 6a 66 64 bits(pPager->jfd
10f80 2c 20 69 48 64 72 4f 66 66 2c 20 50 41 47 45 52 , iHdrOff, PAGER
10f90 5f 4d 4a 5f 50 47 4e 4f 28 70 50 61 67 65 72 29 _MJ_PGNO(pPager)
10fa0 29 29 29 0a 20 20 20 7c 7c 20 28 30 20 21 3d 20 ))). || (0 !=
10fb0 28 72 63 20 3d 20 73 71 6c 69 74 65 33 4f 73 57 (rc = sqlite3OsW
10fc0 72 69 74 65 28 70 50 61 67 65 72 2d 3e 6a 66 64 rite(pPager->jfd
10fd0 2c 20 7a 4d 61 73 74 65 72 2c 20 6e 4d 61 73 74 , zMaster, nMast
10fe0 65 72 2c 20 69 48 64 72 4f 66 66 2b 34 29 29 29 er, iHdrOff+4)))
10ff0 0a 20 20 20 7c 7c 20 28 30 20 21 3d 20 28 72 63 . || (0 != (rc
11000 20 3d 20 77 72 69 74 65 33 32 62 69 74 73 28 70 = write32bits(p
11010 50 61 67 65 72 2d 3e 6a 66 64 2c 20 69 48 64 72 Pager->jfd, iHdr
11020 4f 66 66 2b 34 2b 6e 4d 61 73 74 65 72 2c 20 6e Off+4+nMaster, n
11030 4d 61 73 74 65 72 29 29 29 0a 20 20 20 7c 7c 20 Master))). ||
11040 28 30 20 21 3d 20 28 72 63 20 3d 20 77 72 69 74 (0 != (rc = writ
11050 65 33 32 62 69 74 73 28 70 50 61 67 65 72 2d 3e e32bits(pPager->
11060 6a 66 64 2c 20 69 48 64 72 4f 66 66 2b 34 2b 6e jfd, iHdrOff+4+n
11070 4d 61 73 74 65 72 2b 34 2c 20 63 6b 73 75 6d 29 Master+4, cksum)
11080 29 29 0a 20 20 20 7c 7c 20 28 30 20 21 3d 20 28 )). || (0 != (
11090 72 63 20 3d 20 73 71 6c 69 74 65 33 4f 73 57 72 rc = sqlite3OsWr
110a0 69 74 65 28 70 50 61 67 65 72 2d 3e 6a 66 64 2c ite(pPager->jfd,
110b0 20 61 4a 6f 75 72 6e 61 6c 4d 61 67 69 63 2c 20 aJournalMagic,
110c0 38 2c 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 8,.
110d0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
110e0 20 20 20 20 69 48 64 72 4f 66 66 2b 34 2b 6e 4d iHdrOff+4+nM
110f0 61 73 74 65 72 2b 38 29 29 29 0a 20 20 29 7b 0a aster+8))). ){.
11100 20 20 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 20 return rc;.
11110 20 7d 0a 20 20 70 50 61 67 65 72 2d 3e 6a 6f 75 }. pPager->jou
11120 72 6e 61 6c 4f 66 66 20 2b 3d 20 28 6e 4d 61 73 rnalOff += (nMas
11130 74 65 72 2b 32 30 29 3b 0a 0a 20 20 2f 2a 20 49 ter+20);.. /* I
11140 66 20 74 68 65 20 70 61 67 65 72 20 69 73 20 69 f the pager is i
11150 6e 20 70 65 72 69 73 74 65 6e 74 2d 6a 6f 75 72 n peristent-jour
11160 6e 61 6c 20 6d 6f 64 65 2c 20 74 68 65 6e 20 74 nal mode, then t
11170 68 65 20 70 68 79 73 69 63 61 6c 20 0a 20 20 2a he physical . *
11180 2a 20 6a 6f 75 72 6e 61 6c 2d 66 69 6c 65 20 6d * journal-file m
11190 61 79 20 65 78 74 65 6e 64 20 70 61 73 74 20 74 ay extend past t
111a0 68 65 20 65 6e 64 20 6f 66 20 74 68 65 20 6d 61 he end of the ma
111b0 73 74 65 72 2d 6a 6f 75 72 6e 61 6c 20 6e 61 6d ster-journal nam
111c0 65 0a 20 20 2a 2a 20 61 6e 64 20 38 20 62 79 74 e. ** and 8 byt
111d0 65 73 20 6f 66 20 6d 61 67 69 63 20 64 61 74 61 es of magic data
111e0 20 6a 75 73 74 20 77 72 69 74 74 65 6e 20 74 6f just written to
111f0 20 74 68 65 20 66 69 6c 65 2e 20 54 68 69 73 20 the file. This
11200 69 73 20 0a 20 20 2a 2a 20 64 61 6e 67 65 72 6f is . ** dangero
11210 75 73 20 62 65 63 61 75 73 65 20 74 68 65 20 63 us because the c
11220 6f 64 65 20 74 6f 20 72 6f 6c 6c 62 61 63 6b 20 ode to rollback
11230 61 20 68 6f 74 2d 6a 6f 75 72 6e 61 6c 20 66 69 a hot-journal fi
11240 6c 65 0a 20 20 2a 2a 20 77 69 6c 6c 20 6e 6f 74 le. ** will not
11250 20 62 65 20 61 62 6c 65 20 74 6f 20 66 69 6e 64 be able to find
11260 20 74 68 65 20 6d 61 73 74 65 72 2d 6a 6f 75 72 the master-jour
11270 6e 61 6c 20 6e 61 6d 65 20 74 6f 20 64 65 74 65 nal name to dete
11280 72 6d 69 6e 65 20 0a 20 20 2a 2a 20 77 68 65 74 rmine . ** whet
11290 68 65 72 20 6f 72 20 6e 6f 74 20 74 68 65 20 6a her or not the j
112a0 6f 75 72 6e 61 6c 20 69 73 20 68 6f 74 2e 20 0a ournal is hot. .
112b0 20 20 2a 2a 0a 20 20 2a 2a 20 45 61 73 69 65 73 **. ** Easies
112c0 74 20 74 68 69 6e 67 20 74 6f 20 64 6f 20 69 6e t thing to do in
112d0 20 74 68 69 73 20 73 63 65 6e 61 72 69 6f 20 69 this scenario i
112e0 73 20 74 6f 20 74 72 75 6e 63 61 74 65 20 74 68 s to truncate th
112f0 65 20 6a 6f 75 72 6e 61 6c 20 0a 20 20 2a 2a 20 e journal . **
11300 66 69 6c 65 20 74 6f 20 74 68 65 20 72 65 71 75 file to the requ
11310 69 72 65 64 20 73 69 7a 65 2e 0a 20 20 2a 2f 20 ired size.. */
11320 0a 20 20 69 66 28 20 53 51 4c 49 54 45 5f 4f 4b . if( SQLITE_OK
11330 3d 3d 28 72 63 20 3d 20 73 71 6c 69 74 65 33 4f ==(rc = sqlite3O
11340 73 46 69 6c 65 53 69 7a 65 28 70 50 61 67 65 72 sFileSize(pPager
11350 2d 3e 6a 66 64 2c 20 26 6a 72 6e 6c 53 69 7a 65 ->jfd, &jrnlSize
11360 29 29 0a 20 20 20 26 26 20 6a 72 6e 6c 53 69 7a )). && jrnlSiz
11370 65 3e 70 50 61 67 65 72 2d 3e 6a 6f 75 72 6e 61 e>pPager->journa
11380 6c 4f 66 66 0a 20 20 29 7b 0a 20 20 20 20 72 63 lOff. ){. rc
11390 20 3d 20 73 71 6c 69 74 65 33 4f 73 54 72 75 6e = sqlite3OsTrun
113a0 63 61 74 65 28 70 50 61 67 65 72 2d 3e 6a 66 64 cate(pPager->jfd
113b0 2c 20 70 50 61 67 65 72 2d 3e 6a 6f 75 72 6e 61 , pPager->journa
113c0 6c 4f 66 66 29 3b 0a 20 20 7d 0a 20 20 72 65 74 lOff);. }. ret
113d0 75 72 6e 20 72 63 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a urn rc;.}../*.**
113e0 20 44 69 73 63 61 72 64 20 74 68 65 20 65 6e 74 Discard the ent
113f0 69 72 65 20 63 6f 6e 74 65 6e 74 73 20 6f 66 20 ire contents of
11400 74 68 65 20 69 6e 2d 6d 65 6d 6f 72 79 20 70 61 the in-memory pa
11410 67 65 2d 63 61 63 68 65 2e 0a 2a 2f 0a 73 74 61 ge-cache..*/.sta
11420 74 69 63 20 76 6f 69 64 20 70 61 67 65 72 5f 72 tic void pager_r
11430 65 73 65 74 28 50 61 67 65 72 20 2a 70 50 61 67 eset(Pager *pPag
11440 65 72 29 7b 0a 20 20 70 50 61 67 65 72 2d 3e 69 er){. pPager->i
11450 44 61 74 61 56 65 72 73 69 6f 6e 2b 2b 3b 0a 20 DataVersion++;.
11460 20 73 71 6c 69 74 65 33 42 61 63 6b 75 70 52 65 sqlite3BackupRe
11470 73 74 61 72 74 28 70 50 61 67 65 72 2d 3e 70 42 start(pPager->pB
11480 61 63 6b 75 70 29 3b 0a 20 20 73 71 6c 69 74 65 ackup);. sqlite
11490 33 50 63 61 63 68 65 43 6c 65 61 72 28 70 50 61 3PcacheClear(pPa
114a0 67 65 72 2d 3e 70 50 43 61 63 68 65 29 3b 0a 7d ger->pPCache);.}
114b0 0a 0a 2f 2a 0a 2a 2a 20 52 65 74 75 72 6e 20 74 ../*.** Return t
114c0 68 65 20 70 50 61 67 65 72 2d 3e 69 44 61 74 61 he pPager->iData
114d0 56 65 72 73 69 6f 6e 20 76 61 6c 75 65 0a 2a 2f Version value.*/
114e0 0a 75 33 32 20 73 71 6c 69 74 65 33 50 61 67 65 .u32 sqlite3Page
114f0 72 44 61 74 61 56 65 72 73 69 6f 6e 28 50 61 67 rDataVersion(Pag
11500 65 72 20 2a 70 50 61 67 65 72 29 7b 0a 20 20 61 er *pPager){. a
11510 73 73 65 72 74 28 20 70 50 61 67 65 72 2d 3e 65 ssert( pPager->e
11520 53 74 61 74 65 3e 50 41 47 45 52 5f 4f 50 45 4e State>PAGER_OPEN
11530 20 29 3b 0a 20 20 72 65 74 75 72 6e 20 70 50 61 );. return pPa
11540 67 65 72 2d 3e 69 44 61 74 61 56 65 72 73 69 6f ger->iDataVersio
11550 6e 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 46 72 65 65 n;.}../*.** Free
11560 20 61 6c 6c 20 73 74 72 75 63 74 75 72 65 73 20 all structures
11570 69 6e 20 74 68 65 20 50 61 67 65 72 2e 61 53 61 in the Pager.aSa
11580 76 65 70 6f 69 6e 74 5b 5d 20 61 72 72 61 79 20 vepoint[] array
11590 61 6e 64 20 73 65 74 20 62 6f 74 68 0a 2a 2a 20 and set both.**
115a0 50 61 67 65 72 2e 61 53 61 76 65 70 6f 69 6e 74 Pager.aSavepoint
115b0 20 61 6e 64 20 50 61 67 65 72 2e 6e 53 61 76 65 and Pager.nSave
115c0 70 6f 69 6e 74 20 74 6f 20 7a 65 72 6f 2e 20 43 point to zero. C
115d0 6c 6f 73 65 20 74 68 65 20 73 75 62 2d 6a 6f 75 lose the sub-jou
115e0 72 6e 61 6c 0a 2a 2a 20 69 66 20 69 74 20 69 73 rnal.** if it is
115f0 20 6f 70 65 6e 20 61 6e 64 20 74 68 65 20 70 61 open and the pa
11600 67 65 72 20 69 73 20 6e 6f 74 20 69 6e 20 65 78 ger is not in ex
11610 63 6c 75 73 69 76 65 20 6d 6f 64 65 2e 0a 2a 2f clusive mode..*/
11620 0a 73 74 61 74 69 63 20 76 6f 69 64 20 72 65 6c .static void rel
11630 65 61 73 65 41 6c 6c 53 61 76 65 70 6f 69 6e 74 easeAllSavepoint
11640 73 28 50 61 67 65 72 20 2a 70 50 61 67 65 72 29 s(Pager *pPager)
11650 7b 0a 20 20 69 6e 74 20 69 69 3b 20 20 20 20 20 {. int ii;
11660 20 20 20 20 20 20 20 20 20 20 2f 2a 20 49 74 65 /* Ite
11670 72 61 74 6f 72 20 66 6f 72 20 6c 6f 6f 70 69 6e rator for loopin
11680 67 20 74 68 72 6f 75 67 68 20 50 61 67 65 72 2e g through Pager.
11690 61 53 61 76 65 70 6f 69 6e 74 20 2a 2f 0a 20 20 aSavepoint */.
116a0 66 6f 72 28 69 69 3d 30 3b 20 69 69 3c 70 50 61 for(ii=0; ii<pPa
116b0 67 65 72 2d 3e 6e 53 61 76 65 70 6f 69 6e 74 3b ger->nSavepoint;
116c0 20 69 69 2b 2b 29 7b 0a 20 20 20 20 73 71 6c 69 ii++){. sqli
116d0 74 65 33 42 69 74 76 65 63 44 65 73 74 72 6f 79 te3BitvecDestroy
116e0 28 70 50 61 67 65 72 2d 3e 61 53 61 76 65 70 6f (pPager->aSavepo
116f0 69 6e 74 5b 69 69 5d 2e 70 49 6e 53 61 76 65 70 int[ii].pInSavep
11700 6f 69 6e 74 29 3b 0a 20 20 7d 0a 20 20 69 66 28 oint);. }. if(
11710 20 21 70 50 61 67 65 72 2d 3e 65 78 63 6c 75 73 !pPager->exclus
11720 69 76 65 4d 6f 64 65 20 7c 7c 20 73 71 6c 69 74 iveMode || sqlit
11730 65 33 4a 6f 75 72 6e 61 6c 49 73 49 6e 4d 65 6d e3JournalIsInMem
11740 6f 72 79 28 70 50 61 67 65 72 2d 3e 73 6a 66 64 ory(pPager->sjfd
11750 29 20 29 7b 0a 20 20 20 20 73 71 6c 69 74 65 33 ) ){. sqlite3
11760 4f 73 43 6c 6f 73 65 28 70 50 61 67 65 72 2d 3e OsClose(pPager->
11770 73 6a 66 64 29 3b 0a 20 20 7d 0a 20 20 73 71 6c sjfd);. }. sql
11780 69 74 65 33 5f 66 72 65 65 28 70 50 61 67 65 72 ite3_free(pPager
11790 2d 3e 61 53 61 76 65 70 6f 69 6e 74 29 3b 0a 20 ->aSavepoint);.
117a0 20 70 50 61 67 65 72 2d 3e 61 53 61 76 65 70 6f pPager->aSavepo
117b0 69 6e 74 20 3d 20 30 3b 0a 20 20 70 50 61 67 65 int = 0;. pPage
117c0 72 2d 3e 6e 53 61 76 65 70 6f 69 6e 74 20 3d 20 r->nSavepoint =
117d0 30 3b 0a 20 20 70 50 61 67 65 72 2d 3e 6e 53 75 0;. pPager->nSu
117e0 62 52 65 63 20 3d 20 30 3b 0a 7d 0a 0a 2f 2a 0a bRec = 0;.}../*.
117f0 2a 2a 20 53 65 74 20 74 68 65 20 62 69 74 20 6e ** Set the bit n
11800 75 6d 62 65 72 20 70 67 6e 6f 20 69 6e 20 74 68 umber pgno in th
11810 65 20 50 61 67 65 72 53 61 76 65 70 6f 69 6e 74 e PagerSavepoint
11820 2e 70 49 6e 53 61 76 65 70 6f 69 6e 74 20 0a 2a .pInSavepoint .*
11830 2a 20 62 69 74 76 65 63 73 20 6f 66 20 61 6c 6c * bitvecs of all
11840 20 6f 70 65 6e 20 73 61 76 65 70 6f 69 6e 74 73 open savepoints
11850 2e 20 52 65 74 75 72 6e 20 53 51 4c 49 54 45 5f . Return SQLITE_
11860 4f 4b 20 69 66 20 73 75 63 63 65 73 73 66 75 6c OK if successful
11870 0a 2a 2a 20 6f 72 20 53 51 4c 49 54 45 5f 4e 4f .** or SQLITE_NO
11880 4d 45 4d 20 69 66 20 61 20 6d 61 6c 6c 6f 63 20 MEM if a malloc
11890 66 61 69 6c 75 72 65 20 6f 63 63 75 72 73 2e 0a failure occurs..
118a0 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74 20 61 64 */.static int ad
118b0 64 54 6f 53 61 76 65 70 6f 69 6e 74 42 69 74 76 dToSavepointBitv
118c0 65 63 73 28 50 61 67 65 72 20 2a 70 50 61 67 65 ecs(Pager *pPage
118d0 72 2c 20 50 67 6e 6f 20 70 67 6e 6f 29 7b 0a 20 r, Pgno pgno){.
118e0 20 69 6e 74 20 69 69 3b 20 20 20 20 20 20 20 20 int ii;
118f0 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4c 6f /* Lo
11900 6f 70 20 63 6f 75 6e 74 65 72 20 2a 2f 0a 20 20 op counter */.
11910 69 6e 74 20 72 63 20 3d 20 53 51 4c 49 54 45 5f int rc = SQLITE_
11920 4f 4b 3b 20 20 20 20 20 20 20 2f 2a 20 52 65 73 OK; /* Res
11930 75 6c 74 20 63 6f 64 65 20 2a 2f 0a 0a 20 20 66 ult code */.. f
11940 6f 72 28 69 69 3d 30 3b 20 69 69 3c 70 50 61 67 or(ii=0; ii<pPag
11950 65 72 2d 3e 6e 53 61 76 65 70 6f 69 6e 74 3b 20 er->nSavepoint;
11960 69 69 2b 2b 29 7b 0a 20 20 20 20 50 61 67 65 72 ii++){. Pager
11970 53 61 76 65 70 6f 69 6e 74 20 2a 70 20 3d 20 26 Savepoint *p = &
11980 70 50 61 67 65 72 2d 3e 61 53 61 76 65 70 6f 69 pPager->aSavepoi
11990 6e 74 5b 69 69 5d 3b 0a 20 20 20 20 69 66 28 20 nt[ii];. if(
119a0 70 67 6e 6f 3c 3d 70 2d 3e 6e 4f 72 69 67 20 29 pgno<=p->nOrig )
119b0 7b 0a 20 20 20 20 20 20 72 63 20 7c 3d 20 73 71 {. rc |= sq
119c0 6c 69 74 65 33 42 69 74 76 65 63 53 65 74 28 70 lite3BitvecSet(p
119d0 2d 3e 70 49 6e 53 61 76 65 70 6f 69 6e 74 2c 20 ->pInSavepoint,
119e0 70 67 6e 6f 29 3b 0a 20 20 20 20 20 20 74 65 73 pgno);. tes
119f0 74 63 61 73 65 28 20 72 63 3d 3d 53 51 4c 49 54 tcase( rc==SQLIT
11a00 45 5f 4e 4f 4d 45 4d 20 29 3b 0a 20 20 20 20 20 E_NOMEM );.
11a10 20 61 73 73 65 72 74 28 20 72 63 3d 3d 53 51 4c assert( rc==SQL
11a20 49 54 45 5f 4f 4b 20 7c 7c 20 72 63 3d 3d 53 51 ITE_OK || rc==SQ
11a30 4c 49 54 45 5f 4e 4f 4d 45 4d 20 29 3b 0a 20 20 LITE_NOMEM );.
11a40 20 20 7d 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e }. }. return
11a50 20 72 63 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 54 68 rc;.}../*.** Th
11a60 69 73 20 66 75 6e 63 74 69 6f 6e 20 69 73 20 61 is function is a
11a70 20 6e 6f 2d 6f 70 20 69 66 20 74 68 65 20 70 61 no-op if the pa
11a80 67 65 72 20 69 73 20 69 6e 20 65 78 63 6c 75 73 ger is in exclus
11a90 69 76 65 20 6d 6f 64 65 20 61 6e 64 20 6e 6f 74 ive mode and not
11aa0 0a 2a 2a 20 69 6e 20 74 68 65 20 45 52 52 4f 52 .** in the ERROR
11ab0 20 73 74 61 74 65 2e 20 4f 74 68 65 72 77 69 73 state. Otherwis
11ac0 65 2c 20 69 74 20 73 77 69 74 63 68 65 73 20 74 e, it switches t
11ad0 68 65 20 70 61 67 65 72 20 74 6f 20 50 41 47 45 he pager to PAGE
11ae0 52 5f 4f 50 45 4e 0a 2a 2a 20 73 74 61 74 65 2e R_OPEN.** state.
11af0 0a 2a 2a 0a 2a 2a 20 49 66 20 74 68 65 20 70 61 .**.** If the pa
11b00 67 65 72 20 69 73 20 6e 6f 74 20 69 6e 20 65 78 ger is not in ex
11b10 63 6c 75 73 69 76 65 2d 61 63 63 65 73 73 20 6d clusive-access m
11b20 6f 64 65 2c 20 74 68 65 20 64 61 74 61 62 61 73 ode, the databas
11b30 65 20 66 69 6c 65 20 69 73 0a 2a 2a 20 63 6f 6d e file is.** com
11b40 70 6c 65 74 65 6c 79 20 75 6e 6c 6f 63 6b 65 64 pletely unlocked
11b50 2e 20 49 66 20 74 68 65 20 66 69 6c 65 20 69 73 . If the file is
11b60 20 75 6e 6c 6f 63 6b 65 64 20 61 6e 64 20 74 68 unlocked and th
11b70 65 20 66 69 6c 65 2d 73 79 73 74 65 6d 20 64 6f e file-system do
11b80 65 73 0a 2a 2a 20 6e 6f 74 20 65 78 68 69 62 69 es.** not exhibi
11b90 74 20 74 68 65 20 55 4e 44 45 4c 45 54 41 42 4c t the UNDELETABL
11ba0 45 5f 57 48 45 4e 5f 4f 50 45 4e 20 70 72 6f 70 E_WHEN_OPEN prop
11bb0 65 72 74 79 2c 20 74 68 65 20 6a 6f 75 72 6e 61 erty, the journa
11bc0 6c 20 66 69 6c 65 20 69 73 0a 2a 2a 20 63 6c 6f l file is.** clo
11bd0 73 65 64 20 28 69 66 20 69 74 20 69 73 20 6f 70 sed (if it is op
11be0 65 6e 29 2e 0a 2a 2a 0a 2a 2a 20 49 66 20 74 68 en)..**.** If th
11bf0 65 20 70 61 67 65 72 20 69 73 20 69 6e 20 45 52 e pager is in ER
11c00 52 4f 52 20 73 74 61 74 65 20 77 68 65 6e 20 74 ROR state when t
11c10 68 69 73 20 66 75 6e 63 74 69 6f 6e 20 69 73 20 his function is
11c20 63 61 6c 6c 65 64 2c 20 74 68 65 20 0a 2a 2a 20 called, the .**
11c30 63 6f 6e 74 65 6e 74 73 20 6f 66 20 74 68 65 20 contents of the
11c40 70 61 67 65 72 20 63 61 63 68 65 20 61 72 65 20 pager cache are
11c50 64 69 73 63 61 72 64 65 64 20 62 65 66 6f 72 65 discarded before
11c60 20 73 77 69 74 63 68 69 6e 67 20 62 61 63 6b 20 switching back
11c70 74 6f 20 0a 2a 2a 20 74 68 65 20 4f 50 45 4e 20 to .** the OPEN
11c80 73 74 61 74 65 2e 20 52 65 67 61 72 64 6c 65 73 state. Regardles
11c90 73 20 6f 66 20 77 68 65 74 68 65 72 20 74 68 65 s of whether the
11ca0 20 70 61 67 65 72 20 69 73 20 69 6e 20 65 78 63 pager is in exc
11cb0 6c 75 73 69 76 65 2d 6d 6f 64 65 0a 2a 2a 20 6f lusive-mode.** o
11cc0 72 20 6e 6f 74 2c 20 61 6e 79 20 6a 6f 75 72 6e r not, any journ
11cd0 61 6c 20 66 69 6c 65 20 6c 65 66 74 20 69 6e 20 al file left in
11ce0 74 68 65 20 66 69 6c 65 2d 73 79 73 74 65 6d 20 the file-system
11cf0 77 69 6c 6c 20 62 65 20 74 72 65 61 74 65 64 0a will be treated.
11d00 2a 2a 20 61 73 20 61 20 68 6f 74 2d 6a 6f 75 72 ** as a hot-jour
11d10 6e 61 6c 20 61 6e 64 20 72 6f 6c 6c 65 64 20 62 nal and rolled b
11d20 61 63 6b 20 74 68 65 20 6e 65 78 74 20 74 69 6d ack the next tim
11d30 65 20 61 20 72 65 61 64 2d 74 72 61 6e 73 61 63 e a read-transac
11d40 74 69 6f 6e 0a 2a 2a 20 69 73 20 6f 70 65 6e 65 tion.** is opene
11d50 64 20 28 62 79 20 74 68 69 73 20 6f 72 20 62 79 d (by this or by
11d60 20 61 6e 79 20 6f 74 68 65 72 20 63 6f 6e 6e 65 any other conne
11d70 63 74 69 6f 6e 29 2e 0a 2a 2f 0a 73 74 61 74 69 ction)..*/.stati
11d80 63 20 76 6f 69 64 20 70 61 67 65 72 5f 75 6e 6c c void pager_unl
11d90 6f 63 6b 28 50 61 67 65 72 20 2a 70 50 61 67 65 ock(Pager *pPage
11da0 72 29 7b 0a 0a 20 20 61 73 73 65 72 74 28 20 70 r){.. assert( p
11db0 50 61 67 65 72 2d 3e 65 53 74 61 74 65 3d 3d 50 Pager->eState==P
11dc0 41 47 45 52 5f 52 45 41 44 45 52 20 0a 20 20 20 AGER_READER .
11dd0 20 20 20 20 7c 7c 20 70 50 61 67 65 72 2d 3e 65 || pPager->e
11de0 53 74 61 74 65 3d 3d 50 41 47 45 52 5f 4f 50 45 State==PAGER_OPE
11df0 4e 20 0a 20 20 20 20 20 20 20 7c 7c 20 70 50 61 N . || pPa
11e00 67 65 72 2d 3e 65 53 74 61 74 65 3d 3d 50 41 47 ger->eState==PAG
11e10 45 52 5f 45 52 52 4f 52 20 0a 20 20 29 3b 0a 0a ER_ERROR . );..
11e20 20 20 73 71 6c 69 74 65 33 42 69 74 76 65 63 44 sqlite3BitvecD
11e30 65 73 74 72 6f 79 28 70 50 61 67 65 72 2d 3e 70 estroy(pPager->p
11e40 49 6e 4a 6f 75 72 6e 61 6c 29 3b 0a 20 20 70 50 InJournal);. pP
11e50 61 67 65 72 2d 3e 70 49 6e 4a 6f 75 72 6e 61 6c ager->pInJournal
11e60 20 3d 20 30 3b 0a 20 20 72 65 6c 65 61 73 65 41 = 0;. releaseA
11e70 6c 6c 53 61 76 65 70 6f 69 6e 74 73 28 70 50 61 llSavepoints(pPa
11e80 67 65 72 29 3b 0a 0a 20 20 69 66 28 20 70 61 67 ger);.. if( pag
11e90 65 72 55 73 65 57 61 6c 28 70 50 61 67 65 72 29 erUseWal(pPager)
11ea0 20 29 7b 0a 20 20 20 20 61 73 73 65 72 74 28 20 ){. assert(
11eb0 21 69 73 4f 70 65 6e 28 70 50 61 67 65 72 2d 3e !isOpen(pPager->
11ec0 6a 66 64 29 20 29 3b 0a 20 20 20 20 73 71 6c 69 jfd) );. sqli
11ed0 74 65 33 57 61 6c 45 6e 64 52 65 61 64 54 72 61 te3WalEndReadTra
11ee0 6e 73 61 63 74 69 6f 6e 28 70 50 61 67 65 72 2d nsaction(pPager-
11ef0 3e 70 57 61 6c 29 3b 0a 20 20 20 20 70 50 61 67 >pWal);. pPag
11f00 65 72 2d 3e 65 53 74 61 74 65 20 3d 20 50 41 47 er->eState = PAG
11f10 45 52 5f 4f 50 45 4e 3b 0a 20 20 7d 65 6c 73 65 ER_OPEN;. }else
11f20 20 69 66 28 20 21 70 50 61 67 65 72 2d 3e 65 78 if( !pPager->ex
11f30 63 6c 75 73 69 76 65 4d 6f 64 65 20 29 7b 0a 20 clusiveMode ){.
11f40 20 20 20 69 6e 74 20 72 63 3b 20 20 20 20 20 20 int rc;
11f50 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
11f60 20 2f 2a 20 45 72 72 6f 72 20 63 6f 64 65 20 72 /* Error code r
11f70 65 74 75 72 6e 65 64 20 62 79 20 70 61 67 65 72 eturned by pager
11f80 55 6e 6c 6f 63 6b 44 62 28 29 20 2a 2f 0a 20 20 UnlockDb() */.
11f90 20 20 69 6e 74 20 69 44 63 20 3d 20 69 73 4f 70 int iDc = isOp
11fa0 65 6e 28 70 50 61 67 65 72 2d 3e 66 64 29 3f 73 en(pPager->fd)?s
11fb0 71 6c 69 74 65 33 4f 73 44 65 76 69 63 65 43 68 qlite3OsDeviceCh
11fc0 61 72 61 63 74 65 72 69 73 74 69 63 73 28 70 50 aracteristics(pP
11fd0 61 67 65 72 2d 3e 66 64 29 3a 30 3b 0a 0a 20 20 ager->fd):0;..
11fe0 20 20 2f 2a 20 49 66 20 74 68 65 20 6f 70 65 72 /* If the oper
11ff0 61 74 69 6e 67 20 73 79 73 74 65 6d 20 73 75 70 ating system sup
12000 70 6f 72 74 20 64 65 6c 65 74 69 6f 6e 20 6f 66 port deletion of
12010 20 6f 70 65 6e 20 66 69 6c 65 73 2c 20 74 68 65 open files, the
12020 6e 0a 20 20 20 20 2a 2a 20 63 6c 6f 73 65 20 74 n. ** close t
12030 68 65 20 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 20 he journal file
12040 77 68 65 6e 20 64 72 6f 70 70 69 6e 67 20 74 68 when dropping th
12050 65 20 64 61 74 61 62 61 73 65 20 6c 6f 63 6b 2e e database lock.
12060 20 20 4f 74 68 65 72 77 69 73 65 0a 20 20 20 20 Otherwise.
12070 2a 2a 20 61 6e 6f 74 68 65 72 20 63 6f 6e 6e 65 ** another conne
12080 63 74 69 6f 6e 20 77 69 74 68 20 6a 6f 75 72 6e ction with journ
12090 61 6c 5f 6d 6f 64 65 3d 64 65 6c 65 74 65 20 6d al_mode=delete m
120a0 69 67 68 74 20 64 65 6c 65 74 65 20 74 68 65 20 ight delete the
120b0 66 69 6c 65 0a 20 20 20 20 2a 2a 20 6f 75 74 20 file. ** out
120c0 66 72 6f 6d 20 75 6e 64 65 72 20 75 73 2e 0a 20 from under us..
120d0 20 20 20 2a 2f 0a 20 20 20 20 61 73 73 65 72 74 */. assert
120e0 28 20 28 50 41 47 45 52 5f 4a 4f 55 52 4e 41 4c ( (PAGER_JOURNAL
120f0 4d 4f 44 45 5f 4d 45 4d 4f 52 59 20 20 20 26 20 MODE_MEMORY &
12100 35 29 21 3d 31 20 29 3b 0a 20 20 20 20 61 73 73 5)!=1 );. ass
12110 65 72 74 28 20 28 50 41 47 45 52 5f 4a 4f 55 52 ert( (PAGER_JOUR
12120 4e 41 4c 4d 4f 44 45 5f 4f 46 46 20 20 20 20 20 NALMODE_OFF
12130 20 26 20 35 29 21 3d 31 20 29 3b 0a 20 20 20 20 & 5)!=1 );.
12140 61 73 73 65 72 74 28 20 28 50 41 47 45 52 5f 4a assert( (PAGER_J
12150 4f 55 52 4e 41 4c 4d 4f 44 45 5f 57 41 4c 20 20 OURNALMODE_WAL
12160 20 20 20 20 26 20 35 29 21 3d 31 20 29 3b 0a 20 & 5)!=1 );.
12170 20 20 20 61 73 73 65 72 74 28 20 28 50 41 47 45 assert( (PAGE
12180 52 5f 4a 4f 55 52 4e 41 4c 4d 4f 44 45 5f 44 45 R_JOURNALMODE_DE
12190 4c 45 54 45 20 20 20 26 20 35 29 21 3d 31 20 29 LETE & 5)!=1 )
121a0 3b 0a 20 20 20 20 61 73 73 65 72 74 28 20 28 50 ;. assert( (P
121b0 41 47 45 52 5f 4a 4f 55 52 4e 41 4c 4d 4f 44 45 AGER_JOURNALMODE
121c0 5f 54 52 55 4e 43 41 54 45 20 26 20 35 29 3d 3d _TRUNCATE & 5)==
121d0 31 20 29 3b 0a 20 20 20 20 61 73 73 65 72 74 28 1 );. assert(
121e0 20 28 50 41 47 45 52 5f 4a 4f 55 52 4e 41 4c 4d (PAGER_JOURNALM
121f0 4f 44 45 5f 50 45 52 53 49 53 54 20 20 26 20 35 ODE_PERSIST & 5
12200 29 3d 3d 31 20 29 3b 0a 20 20 20 20 69 66 28 20 )==1 );. if(
12210 30 3d 3d 28 69 44 63 20 26 20 53 51 4c 49 54 45 0==(iDc & SQLITE
12220 5f 49 4f 43 41 50 5f 55 4e 44 45 4c 45 54 41 42 _IOCAP_UNDELETAB
12230 4c 45 5f 57 48 45 4e 5f 4f 50 45 4e 29 0a 20 20 LE_WHEN_OPEN).
12240 20 20 20 7c 7c 20 31 21 3d 28 70 50 61 67 65 72 || 1!=(pPager
12250 2d 3e 6a 6f 75 72 6e 61 6c 4d 6f 64 65 20 26 20 ->journalMode &
12260 35 29 0a 20 20 20 20 29 7b 0a 20 20 20 20 20 20 5). ){.
12270 73 71 6c 69 74 65 33 4f 73 43 6c 6f 73 65 28 70 sqlite3OsClose(p
12280 50 61 67 65 72 2d 3e 6a 66 64 29 3b 0a 20 20 20 Pager->jfd);.
12290 20 7d 0a 0a 20 20 20 20 2f 2a 20 49 66 20 74 68 }.. /* If th
122a0 65 20 70 61 67 65 72 20 69 73 20 69 6e 20 74 68 e pager is in th
122b0 65 20 45 52 52 4f 52 20 73 74 61 74 65 20 61 6e e ERROR state an
122c0 64 20 74 68 65 20 63 61 6c 6c 20 74 6f 20 75 6e d the call to un
122d0 6c 6f 63 6b 20 74 68 65 20 64 61 74 61 62 61 73 lock the databas
122e0 65 0a 20 20 20 20 2a 2a 20 66 69 6c 65 20 66 61 e. ** file fa
122f0 69 6c 73 2c 20 73 65 74 20 74 68 65 20 63 75 72 ils, set the cur
12300 72 65 6e 74 20 6c 6f 63 6b 20 74 6f 20 55 4e 4b rent lock to UNK
12310 4e 4f 57 4e 5f 4c 4f 43 4b 2e 20 53 65 65 20 74 NOWN_LOCK. See t
12320 68 65 20 63 6f 6d 6d 65 6e 74 0a 20 20 20 20 2a he comment. *
12330 2a 20 61 62 6f 76 65 20 74 68 65 20 23 64 65 66 * above the #def
12340 69 6e 65 20 66 6f 72 20 55 4e 4b 4e 4f 57 4e 5f ine for UNKNOWN_
12350 4c 4f 43 4b 20 66 6f 72 20 61 6e 20 65 78 70 6c LOCK for an expl
12360 61 6e 61 74 69 6f 6e 20 6f 66 20 77 68 79 20 74 anation of why t
12370 68 69 73 0a 20 20 20 20 2a 2a 20 69 73 20 6e 65 his. ** is ne
12380 63 65 73 73 61 72 79 2e 0a 20 20 20 20 2a 2f 0a cessary.. */.
12390 20 20 20 20 72 63 20 3d 20 70 61 67 65 72 55 6e rc = pagerUn
123a0 6c 6f 63 6b 44 62 28 70 50 61 67 65 72 2c 20 4e lockDb(pPager, N
123b0 4f 5f 4c 4f 43 4b 29 3b 0a 20 20 20 20 69 66 28 O_LOCK);. if(
123c0 20 72 63 21 3d 53 51 4c 49 54 45 5f 4f 4b 20 26 rc!=SQLITE_OK &
123d0 26 20 70 50 61 67 65 72 2d 3e 65 53 74 61 74 65 & pPager->eState
123e0 3d 3d 50 41 47 45 52 5f 45 52 52 4f 52 20 29 7b ==PAGER_ERROR ){
123f0 0a 20 20 20 20 20 20 70 50 61 67 65 72 2d 3e 65 . pPager->e
12400 4c 6f 63 6b 20 3d 20 55 4e 4b 4e 4f 57 4e 5f 4c Lock = UNKNOWN_L
12410 4f 43 4b 3b 0a 20 20 20 20 7d 0a 0a 20 20 20 20 OCK;. }..
12420 2f 2a 20 54 68 65 20 70 61 67 65 72 20 73 74 61 /* The pager sta
12430 74 65 20 6d 61 79 20 62 65 20 63 68 61 6e 67 65 te may be change
12440 64 20 66 72 6f 6d 20 50 41 47 45 52 5f 45 52 52 d from PAGER_ERR
12450 4f 52 20 74 6f 20 50 41 47 45 52 5f 4f 50 45 4e OR to PAGER_OPEN
12460 20 68 65 72 65 0a 20 20 20 20 2a 2a 20 77 69 74 here. ** wit
12470 68 6f 75 74 20 63 6c 65 61 72 69 6e 67 20 74 68 hout clearing th
12480 65 20 65 72 72 6f 72 20 63 6f 64 65 2e 20 54 68 e error code. Th
12490 69 73 20 69 73 20 69 6e 74 65 6e 74 69 6f 6e 61 is is intentiona
124a0 6c 20 2d 20 74 68 65 20 65 72 72 6f 72 0a 20 20 l - the error.
124b0 20 20 2a 2a 20 63 6f 64 65 20 69 73 20 63 6c 65 ** code is cle
124c0 61 72 65 64 20 61 6e 64 20 74 68 65 20 63 61 63 ared and the cac
124d0 68 65 20 72 65 73 65 74 20 69 6e 20 74 68 65 20 he reset in the
124e0 62 6c 6f 63 6b 20 62 65 6c 6f 77 2e 0a 20 20 20 block below..
124f0 20 2a 2f 0a 20 20 20 20 61 73 73 65 72 74 28 20 */. assert(
12500 70 50 61 67 65 72 2d 3e 65 72 72 43 6f 64 65 20 pPager->errCode
12510 7c 7c 20 70 50 61 67 65 72 2d 3e 65 53 74 61 74 || pPager->eStat
12520 65 21 3d 50 41 47 45 52 5f 45 52 52 4f 52 20 29 e!=PAGER_ERROR )
12530 3b 0a 20 20 20 20 70 50 61 67 65 72 2d 3e 63 68 ;. pPager->ch
12540 61 6e 67 65 43 6f 75 6e 74 44 6f 6e 65 20 3d 20 angeCountDone =
12550 30 3b 0a 20 20 20 20 70 50 61 67 65 72 2d 3e 65 0;. pPager->e
12560 53 74 61 74 65 20 3d 20 50 41 47 45 52 5f 4f 50 State = PAGER_OP
12570 45 4e 3b 0a 20 20 7d 0a 0a 20 20 2f 2a 20 49 66 EN;. }.. /* If
12580 20 50 61 67 65 72 2e 65 72 72 43 6f 64 65 20 69 Pager.errCode i
12590 73 20 73 65 74 2c 20 74 68 65 20 63 6f 6e 74 65 s set, the conte
125a0 6e 74 73 20 6f 66 20 74 68 65 20 70 61 67 65 72 nts of the pager
125b0 20 63 61 63 68 65 20 63 61 6e 6e 6f 74 20 62 65 cache cannot be
125c0 0a 20 20 2a 2a 20 74 72 75 73 74 65 64 2e 20 4e . ** trusted. N
125d0 6f 77 20 74 68 61 74 20 74 68 65 72 65 20 61 72 ow that there ar
125e0 65 20 6e 6f 20 6f 75 74 73 74 61 6e 64 69 6e 67 e no outstanding
125f0 20 72 65 66 65 72 65 6e 63 65 73 20 74 6f 20 74 references to t
12600 68 65 20 70 61 67 65 72 2c 0a 20 20 2a 2a 20 69 he pager,. ** i
12610 74 20 63 61 6e 20 73 61 66 65 6c 79 20 6d 6f 76 t can safely mov
12620 65 20 62 61 63 6b 20 74 6f 20 50 41 47 45 52 5f e back to PAGER_
12630 4f 50 45 4e 20 73 74 61 74 65 2e 20 54 68 69 73 OPEN state. This
12640 20 68 61 70 70 65 6e 73 20 69 6e 20 62 6f 74 68 happens in both
12650 0a 20 20 2a 2a 20 6e 6f 72 6d 61 6c 20 61 6e 64 . ** normal and
12660 20 65 78 63 6c 75 73 69 76 65 2d 6c 6f 63 6b 69 exclusive-locki
12670 6e 67 20 6d 6f 64 65 2e 0a 20 20 2a 2f 0a 20 20 ng mode.. */.
12680 61 73 73 65 72 74 28 20 70 50 61 67 65 72 2d 3e assert( pPager->
12690 65 72 72 43 6f 64 65 3d 3d 53 51 4c 49 54 45 5f errCode==SQLITE_
126a0 4f 4b 20 7c 7c 20 21 4d 45 4d 44 42 20 29 3b 0a OK || !MEMDB );.
126b0 20 20 69 66 28 20 70 50 61 67 65 72 2d 3e 65 72 if( pPager->er
126c0 72 43 6f 64 65 20 29 7b 0a 20 20 20 20 69 66 28 rCode ){. if(
126d0 20 70 50 61 67 65 72 2d 3e 74 65 6d 70 46 69 6c pPager->tempFil
126e0 65 3d 3d 30 20 29 7b 0a 20 20 20 20 20 20 70 61 e==0 ){. pa
126f0 67 65 72 5f 72 65 73 65 74 28 70 50 61 67 65 72 ger_reset(pPager
12700 29 3b 0a 20 20 20 20 20 20 70 50 61 67 65 72 2d );. pPager-
12710 3e 63 68 61 6e 67 65 43 6f 75 6e 74 44 6f 6e 65 >changeCountDone
12720 20 3d 20 30 3b 0a 20 20 20 20 20 20 70 50 61 67 = 0;. pPag
12730 65 72 2d 3e 65 53 74 61 74 65 20 3d 20 50 41 47 er->eState = PAG
12740 45 52 5f 4f 50 45 4e 3b 0a 20 20 20 20 7d 65 6c ER_OPEN;. }el
12750 73 65 7b 0a 20 20 20 20 20 20 70 50 61 67 65 72 se{. pPager
12760 2d 3e 65 53 74 61 74 65 20 3d 20 28 69 73 4f 70 ->eState = (isOp
12770 65 6e 28 70 50 61 67 65 72 2d 3e 6a 66 64 29 20 en(pPager->jfd)
12780 3f 20 50 41 47 45 52 5f 4f 50 45 4e 20 3a 20 50 ? PAGER_OPEN : P
12790 41 47 45 52 5f 52 45 41 44 45 52 29 3b 0a 20 20 AGER_READER);.
127a0 20 20 7d 0a 20 20 20 20 69 66 28 20 55 53 45 46 }. if( USEF
127b0 45 54 43 48 28 70 50 61 67 65 72 29 20 29 20 73 ETCH(pPager) ) s
127c0 71 6c 69 74 65 33 4f 73 55 6e 66 65 74 63 68 28 qlite3OsUnfetch(
127d0 70 50 61 67 65 72 2d 3e 66 64 2c 20 30 2c 20 30 pPager->fd, 0, 0
127e0 29 3b 0a 20 20 20 20 70 50 61 67 65 72 2d 3e 65 );. pPager->e
127f0 72 72 43 6f 64 65 20 3d 20 53 51 4c 49 54 45 5f rrCode = SQLITE_
12800 4f 4b 3b 0a 20 20 7d 0a 0a 20 20 70 50 61 67 65 OK;. }.. pPage
12810 72 2d 3e 6a 6f 75 72 6e 61 6c 4f 66 66 20 3d 20 r->journalOff =
12820 30 3b 0a 20 20 70 50 61 67 65 72 2d 3e 6a 6f 75 0;. pPager->jou
12830 72 6e 61 6c 48 64 72 20 3d 20 30 3b 0a 20 20 70 rnalHdr = 0;. p
12840 50 61 67 65 72 2d 3e 73 65 74 4d 61 73 74 65 72 Pager->setMaster
12850 20 3d 20 30 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 54 = 0;.}../*.** T
12860 68 69 73 20 66 75 6e 63 74 69 6f 6e 20 69 73 20 his function is
12870 63 61 6c 6c 65 64 20 77 68 65 6e 65 76 65 72 20 called whenever
12880 61 6e 20 49 4f 45 52 52 20 6f 72 20 46 55 4c 4c an IOERR or FULL
12890 20 65 72 72 6f 72 20 74 68 61 74 20 72 65 71 75 error that requ
128a0 69 72 65 73 0a 2a 2a 20 74 68 65 20 70 61 67 65 ires.** the page
128b0 72 20 74 6f 20 74 72 61 6e 73 69 74 69 6f 6e 20 r to transition
128c0 69 6e 74 6f 20 74 68 65 20 45 52 52 4f 52 20 73 into the ERROR s
128d0 74 61 74 65 20 6d 61 79 20 61 68 76 65 20 6f 63 tate may ahve oc
128e0 63 75 72 72 65 64 2e 0a 2a 2a 20 54 68 65 20 66 curred..** The f
128f0 69 72 73 74 20 61 72 67 75 6d 65 6e 74 20 69 73 irst argument is
12900 20 61 20 70 6f 69 6e 74 65 72 20 74 6f 20 74 68 a pointer to th
12910 65 20 70 61 67 65 72 20 73 74 72 75 63 74 75 72 e pager structur
12920 65 2c 20 74 68 65 20 73 65 63 6f 6e 64 20 0a 2a e, the second .*
12930 2a 20 74 68 65 20 65 72 72 6f 72 2d 63 6f 64 65 * the error-code
12940 20 61 62 6f 75 74 20 74 6f 20 62 65 20 72 65 74 about to be ret
12950 75 72 6e 65 64 20 62 79 20 61 20 70 61 67 65 72 urned by a pager
12960 20 41 50 49 20 66 75 6e 63 74 69 6f 6e 2e 20 54 API function. T
12970 68 65 20 0a 2a 2a 20 76 61 6c 75 65 20 72 65 74 he .** value ret
12980 75 72 6e 65 64 20 69 73 20 61 20 63 6f 70 79 20 urned is a copy
12990 6f 66 20 74 68 65 20 73 65 63 6f 6e 64 20 61 72 of the second ar
129a0 67 75 6d 65 6e 74 20 74 6f 20 74 68 69 73 20 66 gument to this f
129b0 75 6e 63 74 69 6f 6e 2e 20 0a 2a 2a 0a 2a 2a 20 unction. .**.**
129c0 49 66 20 74 68 65 20 73 65 63 6f 6e 64 20 61 72 If the second ar
129d0 67 75 6d 65 6e 74 20 69 73 20 53 51 4c 49 54 45 gument is SQLITE
129e0 5f 46 55 4c 4c 2c 20 53 51 4c 49 54 45 5f 49 4f _FULL, SQLITE_IO
129f0 45 52 52 20 6f 72 20 6f 6e 65 20 6f 66 20 74 68 ERR or one of th
12a00 65 0a 2a 2a 20 49 4f 45 52 52 20 73 75 62 2d 63 e.** IOERR sub-c
12a10 6f 64 65 73 2c 20 74 68 65 20 70 61 67 65 72 20 odes, the pager
12a20 65 6e 74 65 72 73 20 74 68 65 20 45 52 52 4f 52 enters the ERROR
12a30 20 73 74 61 74 65 20 61 6e 64 20 74 68 65 20 65 state and the e
12a40 72 72 6f 72 20 63 6f 64 65 0a 2a 2a 20 69 73 20 rror code.** is
12a50 73 74 6f 72 65 64 20 69 6e 20 50 61 67 65 72 2e stored in Pager.
12a60 65 72 72 43 6f 64 65 2e 20 57 68 69 6c 65 20 74 errCode. While t
12a70 68 65 20 70 61 67 65 72 20 72 65 6d 61 69 6e 73 he pager remains
12a80 20 69 6e 20 74 68 65 20 45 52 52 4f 52 20 73 74 in the ERROR st
12a90 61 74 65 2c 0a 2a 2a 20 61 6c 6c 20 6d 61 6a 6f ate,.** all majo
12aa0 72 20 41 50 49 20 63 61 6c 6c 73 20 6f 6e 20 74 r API calls on t
12ab0 68 65 20 50 61 67 65 72 20 77 69 6c 6c 20 69 6d he Pager will im
12ac0 6d 65 64 69 61 74 65 6c 79 20 72 65 74 75 72 6e mediately return
12ad0 20 50 61 67 65 72 2e 65 72 72 43 6f 64 65 2e 0a Pager.errCode..
12ae0 2a 2a 0a 2a 2a 20 54 68 65 20 45 52 52 4f 52 20 **.** The ERROR
12af0 73 74 61 74 65 20 69 6e 64 69 63 61 74 65 73 20 state indicates
12b00 74 68 61 74 20 74 68 65 20 63 6f 6e 74 65 6e 74 that the content
12b10 73 20 6f 66 20 74 68 65 20 70 61 67 65 72 2d 63 s of the pager-c
12b20 61 63 68 65 20 0a 2a 2a 20 63 61 6e 6e 6f 74 20 ache .** cannot
12b30 62 65 20 74 72 75 73 74 65 64 2e 20 54 68 69 73 be trusted. This
12b40 20 73 74 61 74 65 20 63 61 6e 20 62 65 20 63 6c state can be cl
12b50 65 61 72 65 64 20 62 79 20 63 6f 6d 70 6c 65 74 eared by complet
12b60 65 6c 79 20 64 69 73 63 61 72 64 69 6e 67 20 0a ely discarding .
12b70 2a 2a 20 74 68 65 20 63 6f 6e 74 65 6e 74 73 20 ** the contents
12b80 6f 66 20 74 68 65 20 70 61 67 65 72 2d 63 61 63 of the pager-cac
12b90 68 65 2e 20 49 66 20 61 20 74 72 61 6e 73 61 63 he. If a transac
12ba0 74 69 6f 6e 20 77 61 73 20 61 63 74 69 76 65 20 tion was active
12bb0 77 68 65 6e 0a 2a 2a 20 74 68 65 20 70 65 72 73 when.** the pers
12bc0 69 73 74 65 6e 74 20 65 72 72 6f 72 20 6f 63 63 istent error occ
12bd0 75 72 72 65 64 2c 20 74 68 65 6e 20 74 68 65 20 urred, then the
12be0 72 6f 6c 6c 62 61 63 6b 20 6a 6f 75 72 6e 61 6c rollback journal
12bf0 20 6d 61 79 20 6e 65 65 64 0a 2a 2a 20 74 6f 20 may need.** to
12c00 62 65 20 72 65 70 6c 61 79 65 64 20 74 6f 20 72 be replayed to r
12c10 65 73 74 6f 72 65 20 74 68 65 20 63 6f 6e 74 65 estore the conte
12c20 6e 74 73 20 6f 66 20 74 68 65 20 64 61 74 61 62 nts of the datab
12c30 61 73 65 20 66 69 6c 65 20 28 61 73 20 69 66 0a ase file (as if.
12c40 2a 2a 20 69 74 20 77 65 72 65 20 61 20 68 6f 74 ** it were a hot
12c50 2d 6a 6f 75 72 6e 61 6c 29 2e 0a 2a 2f 0a 73 74 -journal)..*/.st
12c60 61 74 69 63 20 69 6e 74 20 70 61 67 65 72 5f 65 atic int pager_e
12c70 72 72 6f 72 28 50 61 67 65 72 20 2a 70 50 61 67 rror(Pager *pPag
12c80 65 72 2c 20 69 6e 74 20 72 63 29 7b 0a 20 20 69 er, int rc){. i
12c90 6e 74 20 72 63 32 20 3d 20 72 63 20 26 20 30 78 nt rc2 = rc & 0x
12ca0 66 66 3b 0a 20 20 61 73 73 65 72 74 28 20 72 63 ff;. assert( rc
12cb0 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 7c 7c 20 21 ==SQLITE_OK || !
12cc0 4d 45 4d 44 42 20 29 3b 0a 20 20 61 73 73 65 72 MEMDB );. asser
12cd0 74 28 0a 20 20 20 20 20 20 20 70 50 61 67 65 72 t(. pPager
12ce0 2d 3e 65 72 72 43 6f 64 65 3d 3d 53 51 4c 49 54 ->errCode==SQLIT
12cf0 45 5f 46 55 4c 4c 20 7c 7c 0a 20 20 20 20 20 20 E_FULL ||.
12d00 20 70 50 61 67 65 72 2d 3e 65 72 72 43 6f 64 65 pPager->errCode
12d10 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 7c 7c 0a 20 ==SQLITE_OK ||.
12d20 20 20 20 20 20 20 28 70 50 61 67 65 72 2d 3e 65 (pPager->e
12d30 72 72 43 6f 64 65 20 26 20 30 78 66 66 29 3d 3d rrCode & 0xff)==
12d40 53 51 4c 49 54 45 5f 49 4f 45 52 52 0a 20 20 29 SQLITE_IOERR. )
12d50 3b 0a 20 20 69 66 28 20 72 63 32 3d 3d 53 51 4c ;. if( rc2==SQL
12d60 49 54 45 5f 46 55 4c 4c 20 7c 7c 20 72 63 32 3d ITE_FULL || rc2=
12d70 3d 53 51 4c 49 54 45 5f 49 4f 45 52 52 20 29 7b =SQLITE_IOERR ){
12d80 0a 20 20 20 20 70 50 61 67 65 72 2d 3e 65 72 72 . pPager->err
12d90 43 6f 64 65 20 3d 20 72 63 3b 0a 20 20 20 20 70 Code = rc;. p
12da0 50 61 67 65 72 2d 3e 65 53 74 61 74 65 20 3d 20 Pager->eState =
12db0 50 41 47 45 52 5f 45 52 52 4f 52 3b 0a 20 20 7d PAGER_ERROR;. }
12dc0 0a 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 7d 0a . return rc;.}.
12dd0 0a 73 74 61 74 69 63 20 69 6e 74 20 70 61 67 65 .static int page
12de0 72 5f 74 72 75 6e 63 61 74 65 28 50 61 67 65 72 r_truncate(Pager
12df0 20 2a 70 50 61 67 65 72 2c 20 50 67 6e 6f 20 6e *pPager, Pgno n
12e00 50 61 67 65 29 3b 0a 0a 2f 2a 0a 2a 2a 20 54 68 Page);../*.** Th
12e10 65 20 77 72 69 74 65 20 74 72 61 6e 73 61 63 74 e write transact
12e20 69 6f 6e 20 6f 70 65 6e 20 6f 6e 20 74 68 65 20 ion open on the
12e30 70 61 67 65 72 20 70 61 73 73 65 64 20 61 73 20 pager passed as
12e40 74 68 65 20 6f 6e 6c 79 20 61 72 67 75 6d 65 6e the only argumen
12e50 74 20 69 73 0a 2a 2a 20 62 65 69 6e 67 20 63 6f t is.** being co
12e60 6d 6d 69 74 74 65 64 2e 20 54 68 69 73 20 66 75 mmitted. This fu
12e70 6e 63 74 69 6f 6e 20 72 65 74 75 72 6e 73 20 74 nction returns t
12e80 72 75 65 20 69 66 20 61 6c 6c 20 64 69 72 74 79 rue if all dirty
12e90 20 70 61 67 65 73 20 73 68 6f 75 6c 64 0a 2a 2a pages should.**
12ea0 20 62 65 20 66 6c 75 73 68 65 64 20 74 6f 20 64 be flushed to d
12eb0 69 73 6b 2c 20 6f 72 20 66 61 6c 73 65 20 6f 74 isk, or false ot
12ec0 68 65 72 77 69 73 65 2e 20 50 61 67 65 73 20 73 herwise. Pages s
12ed0 68 6f 75 6c 64 20 62 65 20 66 6c 75 73 68 65 64 hould be flushed
12ee0 20 74 6f 20 64 69 73 6b 0a 2a 2a 20 75 6e 6c 65 to disk.** unle
12ef0 73 73 20 6f 6e 65 20 6f 66 20 74 68 65 20 66 6f ss one of the fo
12f00 6c 6c 6f 77 69 6e 67 20 69 73 20 74 72 75 65 3a llowing is true:
12f10 0a 2a 2a 0a 2a 2a 20 20 20 2a 20 54 68 65 20 64 .**.** * The d
12f20 62 20 69 73 20 61 6e 20 69 6e 2d 6d 65 6d 6f 72 b is an in-memor
12f30 79 20 64 61 74 61 62 61 73 65 2e 0a 2a 2a 0a 2a y database..**.*
12f40 2a 20 20 20 2a 20 54 68 65 20 64 62 20 69 73 20 * * The db is
12f50 61 20 74 65 6d 70 6f 72 61 72 79 20 64 61 74 61 a temporary data
12f60 62 61 73 65 20 61 6e 64 20 74 68 65 20 64 62 20 base and the db
12f70 66 69 6c 65 20 68 61 73 20 6e 6f 74 20 62 65 65 file has not bee
12f80 6e 20 6f 70 65 6e 65 64 2e 0a 2a 2a 0a 2a 2a 20 n opened..**.**
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 63 61 63 68 65 se and the cache
12fc0 20 63 6f 6e 74 61 69 6e 73 20 6c 65 73 73 20 74 contains less t
12fd0 68 61 6e 0a 2a 2a 20 20 20 20 20 43 2f 34 20 64 han.** C/4 d
12fe0 69 72 74 79 20 70 61 67 65 73 2c 20 77 68 65 72 irty pages, wher
12ff0 65 20 43 20 69 73 20 74 68 65 20 63 6f 6e 66 69 e C is the confi
13000 67 75 72 65 64 20 63 61 63 68 65 2d 73 69 7a 65 gured cache-size
13010 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74 20 ..*/.static int
13020 70 61 67 65 72 46 6c 75 73 68 4f 6e 43 6f 6d 6d pagerFlushOnComm
13030 69 74 28 50 61 67 65 72 20 2a 70 50 61 67 65 72 it(Pager *pPager
13040 29 7b 0a 20 20 69 66 28 20 70 50 61 67 65 72 2d ){. if( pPager-
13050 3e 74 65 6d 70 46 69 6c 65 3d 3d 30 20 29 20 72 >tempFile==0 ) r
13060 65 74 75 72 6e 20 31 3b 0a 20 20 69 66 28 20 21 eturn 1;. if( !
13070 69 73 4f 70 65 6e 28 70 50 61 67 65 72 2d 3e 66 isOpen(pPager->f
13080 64 29 20 29 20 72 65 74 75 72 6e 20 30 3b 0a 20 d) ) return 0;.
13090 20 72 65 74 75 72 6e 20 28 73 71 6c 69 74 65 33 return (sqlite3
130a0 50 43 61 63 68 65 50 65 72 63 65 6e 74 44 69 72 PCachePercentDir
130b0 74 79 28 70 50 61 67 65 72 2d 3e 70 50 43 61 63 ty(pPager->pPCac
130c0 68 65 29 3e 3d 32 35 29 3b 0a 7d 0a 0a 2f 2a 0a he)>=25);.}../*.
130d0 2a 2a 20 54 68 69 73 20 72 6f 75 74 69 6e 65 20 ** This routine
130e0 65 6e 64 73 20 61 20 74 72 61 6e 73 61 63 74 69 ends a transacti
130f0 6f 6e 2e 20 41 20 74 72 61 6e 73 61 63 74 69 6f on. A transactio
13100 6e 20 69 73 20 75 73 75 61 6c 6c 79 20 65 6e 64 n is usually end
13110 65 64 20 62 79 20 0a 2a 2a 20 65 69 74 68 65 72 ed by .** either
13120 20 61 20 43 4f 4d 4d 49 54 20 6f 72 20 61 20 52 a COMMIT or a R
13130 4f 4c 4c 42 41 43 4b 20 6f 70 65 72 61 74 69 6f OLLBACK operatio
13140 6e 2e 20 54 68 69 73 20 72 6f 75 74 69 6e 65 20 n. This routine
13150 6d 61 79 20 62 65 20 63 61 6c 6c 65 64 20 0a 2a may be called .*
13160 2a 20 61 66 74 65 72 20 72 6f 6c 6c 62 61 63 6b * after rollback
13170 20 6f 66 20 61 20 68 6f 74 2d 6a 6f 75 72 6e 61 of a hot-journa
13180 6c 2c 20 6f 72 20 69 66 20 61 6e 20 65 72 72 6f l, or if an erro
13190 72 20 6f 63 63 75 72 73 20 77 68 69 6c 65 20 6f r occurs while o
131a0 70 65 6e 69 6e 67 0a 2a 2a 20 74 68 65 20 6a 6f pening.** the jo
131b0 75 72 6e 61 6c 20 66 69 6c 65 20 6f 72 20 77 72 urnal file or wr
131c0 69 74 69 6e 67 20 74 68 65 20 76 65 72 79 20 66 iting the very f
131d0 69 72 73 74 20 6a 6f 75 72 6e 61 6c 2d 68 65 61 irst journal-hea
131e0 64 65 72 20 6f 66 20 61 0a 2a 2a 20 64 61 74 61 der of a.** data
131f0 62 61 73 65 20 74 72 61 6e 73 61 63 74 69 6f 6e base transaction
13200 2e 0a 2a 2a 20 0a 2a 2a 20 54 68 69 73 20 72 6f ..** .** This ro
13210 75 74 69 6e 65 20 69 73 20 6e 65 76 65 72 20 63 utine is never c
13220 61 6c 6c 65 64 20 69 6e 20 50 41 47 45 52 5f 45 alled in PAGER_E
13230 52 52 4f 52 20 73 74 61 74 65 2e 20 49 66 20 69 RROR state. If i
13240 74 20 69 73 20 63 61 6c 6c 65 64 0a 2a 2a 20 69 t is called.** i
13250 6e 20 50 41 47 45 52 5f 4e 4f 4e 45 20 6f 72 20 n PAGER_NONE or
13260 50 41 47 45 52 5f 53 48 41 52 45 44 20 73 74 61 PAGER_SHARED sta
13270 74 65 20 61 6e 64 20 74 68 65 20 6c 6f 63 6b 20 te and the lock
13280 68 65 6c 64 20 69 73 20 6c 65 73 73 0a 2a 2a 20 held is less.**
13290 65 78 63 6c 75 73 69 76 65 20 74 68 61 6e 20 61 exclusive than a
132a0 20 52 45 53 45 52 56 45 44 20 6c 6f 63 6b 2c 20 RESERVED lock,
132b0 69 74 20 69 73 20 61 20 6e 6f 2d 6f 70 2e 0a 2a it is a no-op..*
132c0 2a 0a 2a 2a 20 4f 74 68 65 72 77 69 73 65 2c 20 *.** Otherwise,
132d0 61 6e 79 20 61 63 74 69 76 65 20 73 61 76 65 70 any active savep
132e0 6f 69 6e 74 73 20 61 72 65 20 72 65 6c 65 61 73 oints are releas
132f0 65 64 2e 0a 2a 2a 0a 2a 2a 20 49 66 20 74 68 65 ed..**.** If the
13300 20 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 20 69 73 journal file is
13310 20 6f 70 65 6e 2c 20 74 68 65 6e 20 69 74 20 69 open, then it i
13320 73 20 22 66 69 6e 61 6c 69 7a 65 64 22 2e 20 4f s "finalized". O
13330 6e 63 65 20 61 20 6a 6f 75 72 6e 61 6c 20 0a 2a nce a journal .*
13340 2a 20 66 69 6c 65 20 68 61 73 20 62 65 65 6e 20 * file has been
13350 66 69 6e 61 6c 69 7a 65 64 20 69 74 20 69 73 20 finalized it is
13360 6e 6f 74 20 70 6f 73 73 69 62 6c 65 20 74 6f 20 not possible to
13370 75 73 65 20 69 74 20 74 6f 20 72 6f 6c 6c 20 62 use it to roll b
13380 61 63 6b 20 61 20 0a 2a 2a 20 74 72 61 6e 73 61 ack a .** transa
13390 63 74 69 6f 6e 2e 20 4e 6f 72 20 77 69 6c 6c 20 ction. Nor will
133a0 69 74 20 62 65 20 63 6f 6e 73 69 64 65 72 65 64 it be considered
133b0 20 74 6f 20 62 65 20 61 20 68 6f 74 2d 6a 6f 75 to be a hot-jou
133c0 72 6e 61 6c 20 62 79 20 74 68 69 73 0a 2a 2a 20 rnal by this.**
133d0 6f 72 20 61 6e 79 20 6f 74 68 65 72 20 64 61 74 or any other dat
133e0 61 62 61 73 65 20 63 6f 6e 6e 65 63 74 69 6f 6e abase connection
133f0 2e 20 45 78 61 63 74 6c 79 20 68 6f 77 20 61 20 . Exactly how a
13400 6a 6f 75 72 6e 61 6c 20 69 73 20 66 69 6e 61 6c journal is final
13410 69 7a 65 64 0a 2a 2a 20 64 65 70 65 6e 64 73 20 ized.** depends
13420 6f 6e 20 77 68 65 74 68 65 72 20 6f 72 20 6e 6f on whether or no
13430 74 20 74 68 65 20 70 61 67 65 72 20 69 73 20 72 t the pager is r
13440 75 6e 6e 69 6e 67 20 69 6e 20 65 78 63 6c 75 73 unning in exclus
13450 69 76 65 20 6d 6f 64 65 20 61 6e 64 0a 2a 2a 20 ive mode and.**
13460 74 68 65 20 63 75 72 72 65 6e 74 20 6a 6f 75 72 the current jour
13470 6e 61 6c 2d 6d 6f 64 65 20 28 50 61 67 65 72 2e nal-mode (Pager.
13480 6a 6f 75 72 6e 61 6c 4d 6f 64 65 20 76 61 6c 75 journalMode valu
13490 65 29 2c 20 61 73 20 66 6f 6c 6c 6f 77 73 3a 0a e), as follows:.
134a0 2a 2a 0a 2a 2a 20 20 20 6a 6f 75 72 6e 61 6c 4d **.** journalM
134b0 6f 64 65 3d 3d 4d 45 4d 4f 52 59 0a 2a 2a 20 20 ode==MEMORY.**
134c0 20 20 20 4a 6f 75 72 6e 61 6c 20 66 69 6c 65 20 Journal file
134d0 64 65 73 63 72 69 70 74 6f 72 20 69 73 20 73 69 descriptor is si
134e0 6d 70 6c 79 20 63 6c 6f 73 65 64 2e 20 54 68 69 mply closed. Thi
134f0 73 20 64 65 73 74 72 6f 79 73 20 61 6e 20 0a 2a s destroys an .*
13500 2a 20 20 20 20 20 69 6e 2d 6d 65 6d 6f 72 79 20 * in-memory
13510 6a 6f 75 72 6e 61 6c 2e 0a 2a 2a 0a 2a 2a 20 20 journal..**.**
13520 20 6a 6f 75 72 6e 61 6c 4d 6f 64 65 3d 3d 54 52 journalMode==TR
13530 55 4e 43 41 54 45 0a 2a 2a 20 20 20 20 20 4a 6f UNCATE.** Jo
13540 75 72 6e 61 6c 20 66 69 6c 65 20 69 73 20 74 72 urnal file is tr
13550 75 6e 63 61 74 65 64 20 74 6f 20 7a 65 72 6f 20 uncated to zero
13560 62 79 74 65 73 20 69 6e 20 73 69 7a 65 2e 0a 2a bytes in size..*
13570 2a 0a 2a 2a 20 20 20 6a 6f 75 72 6e 61 6c 4d 6f *.** journalMo
13580 64 65 3d 3d 50 45 52 53 49 53 54 0a 2a 2a 20 20 de==PERSIST.**
13590 20 20 20 54 68 65 20 66 69 72 73 74 20 32 38 20 The first 28
135a0 62 79 74 65 73 20 6f 66 20 74 68 65 20 6a 6f 75 bytes of the jou
135b0 72 6e 61 6c 20 66 69 6c 65 20 61 72 65 20 7a 65 rnal file are ze
135c0 72 6f 65 64 2e 20 54 68 69 73 20 69 6e 76 61 6c roed. This inval
135d0 69 64 61 74 65 73 0a 2a 2a 20 20 20 20 20 74 68 idates.** th
135e0 65 20 66 69 72 73 74 20 6a 6f 75 72 6e 61 6c 20 e first journal
135f0 68 65 61 64 65 72 20 69 6e 20 74 68 65 20 66 69 header in the fi
13600 6c 65 2c 20 61 6e 64 20 68 65 6e 63 65 20 74 68 le, and hence th
13610 65 20 65 6e 74 69 72 65 20 6a 6f 75 72 6e 61 6c e entire journal
13620 0a 2a 2a 20 20 20 20 20 66 69 6c 65 2e 20 41 6e .** file. An
13630 20 69 6e 76 61 6c 69 64 20 6a 6f 75 72 6e 61 6c invalid journal
13640 20 66 69 6c 65 20 63 61 6e 6e 6f 74 20 62 65 20 file cannot be
13650 72 6f 6c 6c 65 64 20 62 61 63 6b 2e 0a 2a 2a 0a rolled back..**.
13660 2a 2a 20 20 20 6a 6f 75 72 6e 61 6c 4d 6f 64 65 ** journalMode
13670 3d 3d 44 45 4c 45 54 45 0a 2a 2a 20 20 20 20 20 ==DELETE.**
13680 54 68 65 20 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 The journal file
13690 20 69 73 20 63 6c 6f 73 65 64 20 61 6e 64 20 64 is closed and d
136a0 65 6c 65 74 65 64 20 75 73 69 6e 67 20 73 71 6c eleted using sql
136b0 69 74 65 33 4f 73 44 65 6c 65 74 65 28 29 2e 0a ite3OsDelete()..
136c0 2a 2a 0a 2a 2a 20 20 20 20 20 49 66 20 74 68 65 **.** If the
136d0 20 70 61 67 65 72 20 69 73 20 72 75 6e 6e 69 6e pager is runnin
136e0 67 20 69 6e 20 65 78 63 6c 75 73 69 76 65 20 6d g in exclusive m
136f0 6f 64 65 2c 20 74 68 69 73 20 6d 65 74 68 6f 64 ode, this method
13700 20 6f 66 20 66 69 6e 61 6c 69 7a 69 6e 67 0a 2a of finalizing.*
13710 2a 20 20 20 20 20 74 68 65 20 6a 6f 75 72 6e 61 * the journa
13720 6c 20 66 69 6c 65 20 69 73 20 6e 65 76 65 72 20 l file is never
13730 75 73 65 64 2e 20 49 6e 73 74 65 61 64 2c 20 69 used. Instead, i
13740 66 20 74 68 65 20 6a 6f 75 72 6e 61 6c 4d 6f 64 f the journalMod
13750 65 20 69 73 0a 2a 2a 20 20 20 20 20 44 45 4c 45 e is.** DELE
13760 54 45 20 61 6e 64 20 74 68 65 20 70 61 67 65 72 TE and the pager
13770 20 69 73 20 69 6e 20 65 78 63 6c 75 73 69 76 65 is in exclusive
13780 20 6d 6f 64 65 2c 20 74 68 65 20 6d 65 74 68 6f mode, the metho
13790 64 20 64 65 73 63 72 69 62 65 64 20 75 6e 64 65 d described unde
137a0 72 0a 2a 2a 20 20 20 20 20 6a 6f 75 72 6e 61 6c r.** journal
137b0 4d 6f 64 65 3d 3d 50 45 52 53 49 53 54 20 69 73 Mode==PERSIST is
137c0 20 75 73 65 64 20 69 6e 73 74 65 61 64 2e 0a 2a used instead..*
137d0 2a 0a 2a 2a 20 41 66 74 65 72 20 74 68 65 20 6a *.** After the j
137e0 6f 75 72 6e 61 6c 20 69 73 20 66 69 6e 61 6c 69 ournal is finali
137f0 7a 65 64 2c 20 74 68 65 20 70 61 67 65 72 20 6d zed, the pager m
13800 6f 76 65 73 20 74 6f 20 50 41 47 45 52 5f 52 45 oves to PAGER_RE
13810 41 44 45 52 20 73 74 61 74 65 2e 0a 2a 2a 20 49 ADER state..** I
13820 66 20 72 75 6e 6e 69 6e 67 20 69 6e 20 6e 6f 6e f running in non
13830 2d 65 78 63 6c 75 73 69 76 65 20 72 6f 6c 6c 62 -exclusive rollb
13840 61 63 6b 20 6d 6f 64 65 2c 20 74 68 65 20 6c 6f ack mode, the lo
13850 63 6b 20 6f 6e 20 74 68 65 20 66 69 6c 65 20 69 ck on the file i
13860 73 20 0a 2a 2a 20 64 6f 77 6e 67 72 61 64 65 64 s .** downgraded
13870 20 74 6f 20 61 20 53 48 41 52 45 44 5f 4c 4f 43 to a SHARED_LOC
13880 4b 2e 0a 2a 2a 0a 2a 2a 20 53 51 4c 49 54 45 5f K..**.** SQLITE_
13890 4f 4b 20 69 73 20 72 65 74 75 72 6e 65 64 20 69 OK is returned i
138a0 66 20 6e 6f 20 65 72 72 6f 72 20 6f 63 63 75 72 f no error occur
138b0 73 2e 20 49 66 20 61 6e 20 65 72 72 6f 72 20 6f s. If an error o
138c0 63 63 75 72 73 20 64 75 72 69 6e 67 0a 2a 2a 20 ccurs during.**
138d0 61 6e 79 20 6f 66 20 74 68 65 20 49 4f 20 6f 70 any of the IO op
138e0 65 72 61 74 69 6f 6e 73 20 74 6f 20 66 69 6e 61 erations to fina
138f0 6c 69 7a 65 20 74 68 65 20 6a 6f 75 72 6e 61 6c lize the journal
13900 20 66 69 6c 65 20 6f 72 20 75 6e 6c 6f 63 6b 20 file or unlock
13910 74 68 65 0a 2a 2a 20 64 61 74 61 62 61 73 65 20 the.** database
13920 74 68 65 6e 20 74 68 65 20 49 4f 20 65 72 72 6f then the IO erro
13930 72 20 63 6f 64 65 20 69 73 20 72 65 74 75 72 6e r code is return
13940 65 64 20 74 6f 20 74 68 65 20 75 73 65 72 2e 20 ed to the user.
13950 49 66 20 74 68 65 20 0a 2a 2a 20 6f 70 65 72 61 If the .** opera
13960 74 69 6f 6e 20 74 6f 20 66 69 6e 61 6c 69 7a 65 tion to finalize
13970 20 74 68 65 20 6a 6f 75 72 6e 61 6c 20 66 69 6c the journal fil
13980 65 20 66 61 69 6c 73 2c 20 74 68 65 6e 20 74 68 e fails, then th
13990 65 20 63 6f 64 65 20 73 74 69 6c 6c 0a 2a 2a 20 e code still.**
139a0 74 72 69 65 73 20 74 6f 20 75 6e 6c 6f 63 6b 20 tries to unlock
139b0 74 68 65 20 64 61 74 61 62 61 73 65 20 66 69 6c the database fil
139c0 65 20 69 66 20 6e 6f 74 20 69 6e 20 65 78 63 6c e if not in excl
139d0 75 73 69 76 65 20 6d 6f 64 65 2e 20 49 66 20 74 usive mode. If t
139e0 68 65 0a 2a 2a 20 75 6e 6c 6f 63 6b 20 6f 70 65 he.** unlock ope
139f0 72 61 74 69 6f 6e 20 66 61 69 6c 73 20 61 73 20 ration fails as
13a00 77 65 6c 6c 2c 20 74 68 65 6e 20 74 68 65 20 66 well, then the f
13a10 69 72 73 74 20 65 72 72 6f 72 20 63 6f 64 65 20 irst error code
13a20 72 65 6c 61 74 65 64 0a 2a 2a 20 74 6f 20 74 68 related.** to th
13a30 65 20 66 69 72 73 74 20 65 72 72 6f 72 20 65 6e e first error en
13a40 63 6f 75 6e 74 65 72 65 64 20 28 74 68 65 20 6a countered (the j
13a50 6f 75 72 6e 61 6c 20 66 69 6e 61 6c 69 7a 61 74 ournal finalizat
13a60 69 6f 6e 20 6f 6e 65 29 20 69 73 0a 2a 2a 20 72 ion one) is.** r
13a70 65 74 75 72 6e 65 64 2e 0a 2a 2f 0a 73 74 61 74 eturned..*/.stat
13a80 69 63 20 69 6e 74 20 70 61 67 65 72 5f 65 6e 64 ic int pager_end
13a90 5f 74 72 61 6e 73 61 63 74 69 6f 6e 28 50 61 67 _transaction(Pag
13aa0 65 72 20 2a 70 50 61 67 65 72 2c 20 69 6e 74 20 er *pPager, int
13ab0 68 61 73 4d 61 73 74 65 72 2c 20 69 6e 74 20 62 hasMaster, int b
13ac0 43 6f 6d 6d 69 74 29 7b 0a 20 20 69 6e 74 20 72 Commit){. int r
13ad0 63 20 3d 20 53 51 4c 49 54 45 5f 4f 4b 3b 20 20 c = SQLITE_OK;
13ae0 20 20 20 20 2f 2a 20 45 72 72 6f 72 20 63 6f 64 /* Error cod
13af0 65 20 66 72 6f 6d 20 6a 6f 75 72 6e 61 6c 20 66 e from journal f
13b00 69 6e 61 6c 69 7a 61 74 69 6f 6e 20 6f 70 65 72 inalization oper
13b10 61 74 69 6f 6e 20 2a 2f 0a 20 20 69 6e 74 20 72 ation */. int r
13b20 63 32 20 3d 20 53 51 4c 49 54 45 5f 4f 4b 3b 20 c2 = SQLITE_OK;
13b30 20 20 20 20 2f 2a 20 45 72 72 6f 72 20 63 6f 64 /* Error cod
13b40 65 20 66 72 6f 6d 20 64 62 20 66 69 6c 65 20 75 e from db file u
13b50 6e 6c 6f 63 6b 20 6f 70 65 72 61 74 69 6f 6e 20 nlock operation
13b60 2a 2f 0a 0a 20 20 2f 2a 20 44 6f 20 6e 6f 74 68 */.. /* Do noth
13b70 69 6e 67 20 69 66 20 74 68 65 20 70 61 67 65 72 ing if the pager
13b80 20 64 6f 65 73 20 6e 6f 74 20 68 61 76 65 20 61 does not have a
13b90 6e 20 6f 70 65 6e 20 77 72 69 74 65 20 74 72 61 n open write tra
13ba0 6e 73 61 63 74 69 6f 6e 0a 20 20 2a 2a 20 6f 72 nsaction. ** or
13bb0 20 61 74 20 6c 65 61 73 74 20 61 20 52 45 53 45 at least a RESE
13bc0 52 56 45 44 20 6c 6f 63 6b 2e 20 54 68 69 73 20 RVED lock. This
13bd0 66 75 6e 63 74 69 6f 6e 20 6d 61 79 20 62 65 20 function may be
13be0 63 61 6c 6c 65 64 20 77 68 65 6e 20 74 68 65 72 called when ther
13bf0 65 0a 20 20 2a 2a 20 69 73 20 6e 6f 20 77 72 69 e. ** is no wri
13c00 74 65 2d 74 72 61 6e 73 61 63 74 69 6f 6e 20 61 te-transaction a
13c10 63 74 69 76 65 20 62 75 74 20 61 20 52 45 53 45 ctive but a RESE
13c20 52 56 45 44 20 6f 72 20 67 72 65 61 74 65 72 20 RVED or greater
13c30 6c 6f 63 6b 20 69 73 0a 20 20 2a 2a 20 68 65 6c lock is. ** hel
13c40 64 20 75 6e 64 65 72 20 74 77 6f 20 63 69 72 63 d under two circ
13c50 75 6d 73 74 61 6e 63 65 73 3a 0a 20 20 2a 2a 0a umstances:. **.
13c60 20 20 2a 2a 20 20 20 31 2e 20 41 66 74 65 72 20 ** 1. After
13c70 61 20 73 75 63 63 65 73 73 66 75 6c 20 68 6f 74 a successful hot
13c80 2d 6a 6f 75 72 6e 61 6c 20 72 6f 6c 6c 62 61 63 -journal rollbac
13c90 6b 2c 20 69 74 20 69 73 20 63 61 6c 6c 65 64 20 k, it is called
13ca0 77 69 74 68 0a 20 20 2a 2a 20 20 20 20 20 20 65 with. ** e
13cb0 53 74 61 74 65 3d 3d 50 41 47 45 52 5f 4e 4f 4e State==PAGER_NON
13cc0 45 20 61 6e 64 20 65 4c 6f 63 6b 3d 3d 45 58 43 E and eLock==EXC
13cd0 4c 55 53 49 56 45 5f 4c 4f 43 4b 2e 0a 20 20 2a LUSIVE_LOCK.. *
13ce0 2a 0a 20 20 2a 2a 20 20 20 32 2e 20 49 66 20 61 *. ** 2. If a
13cf0 20 63 6f 6e 6e 65 63 74 69 6f 6e 20 77 69 74 68 connection with
13d00 20 6c 6f 63 6b 69 6e 67 5f 6d 6f 64 65 3d 65 78 locking_mode=ex
13d10 63 6c 75 73 69 76 65 20 68 6f 6c 64 69 6e 67 20 clusive holding
13d20 61 6e 20 45 58 43 4c 55 53 49 56 45 20 0a 20 20 an EXCLUSIVE .
13d30 2a 2a 20 20 20 20 20 20 6c 6f 63 6b 20 73 77 69 ** lock swi
13d40 74 63 68 65 73 20 62 61 63 6b 20 74 6f 20 6c 6f tches back to lo
13d50 63 6b 69 6e 67 5f 6d 6f 64 65 3d 6e 6f 72 6d 61 cking_mode=norma
13d60 6c 20 61 6e 64 20 74 68 65 6e 20 65 78 65 63 75 l and then execu
13d70 74 65 73 20 61 0a 20 20 2a 2a 20 20 20 20 20 20 tes a. **
13d80 72 65 61 64 2d 74 72 61 6e 73 61 63 74 69 6f 6e read-transaction
13d90 2c 20 74 68 69 73 20 66 75 6e 63 74 69 6f 6e 20 , this function
13da0 69 73 20 63 61 6c 6c 65 64 20 77 69 74 68 20 65 is called with e
13db0 53 74 61 74 65 3d 3d 50 41 47 45 52 5f 52 45 41 State==PAGER_REA
13dc0 44 45 52 20 0a 20 20 2a 2a 20 20 20 20 20 20 61 DER . ** a
13dd0 6e 64 20 65 4c 6f 63 6b 3d 3d 45 58 43 4c 55 53 nd eLock==EXCLUS
13de0 49 56 45 5f 4c 4f 43 4b 20 77 68 65 6e 20 74 68 IVE_LOCK when th
13df0 65 20 72 65 61 64 2d 74 72 61 6e 73 61 63 74 69 e read-transacti
13e00 6f 6e 20 69 73 20 63 6c 6f 73 65 64 2e 0a 20 20 on is closed..
13e10 2a 2f 0a 20 20 61 73 73 65 72 74 28 20 61 73 73 */. assert( ass
13e20 65 72 74 5f 70 61 67 65 72 5f 73 74 61 74 65 28 ert_pager_state(
13e30 70 50 61 67 65 72 29 20 29 3b 0a 20 20 61 73 73 pPager) );. ass
13e40 65 72 74 28 20 70 50 61 67 65 72 2d 3e 65 53 74 ert( pPager->eSt
13e50 61 74 65 21 3d 50 41 47 45 52 5f 45 52 52 4f 52 ate!=PAGER_ERROR
13e60 20 29 3b 0a 20 20 69 66 28 20 70 50 61 67 65 72 );. if( pPager
13e70 2d 3e 65 53 74 61 74 65 3c 50 41 47 45 52 5f 57 ->eState<PAGER_W
13e80 52 49 54 45 52 5f 4c 4f 43 4b 45 44 20 26 26 20 RITER_LOCKED &&
13e90 70 50 61 67 65 72 2d 3e 65 4c 6f 63 6b 3c 52 45 pPager->eLock<RE
13ea0 53 45 52 56 45 44 5f 4c 4f 43 4b 20 29 7b 0a 20 SERVED_LOCK ){.
13eb0 20 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 return SQLITE
13ec0 5f 4f 4b 3b 0a 20 20 7d 0a 0a 20 20 72 65 6c 65 _OK;. }.. rele
13ed0 61 73 65 41 6c 6c 53 61 76 65 70 6f 69 6e 74 73 aseAllSavepoints
13ee0 28 70 50 61 67 65 72 29 3b 0a 20 20 61 73 73 65 (pPager);. asse
13ef0 72 74 28 20 69 73 4f 70 65 6e 28 70 50 61 67 65 rt( isOpen(pPage
13f00 72 2d 3e 6a 66 64 29 20 7c 7c 20 70 50 61 67 65 r->jfd) || pPage
13f10 72 2d 3e 70 49 6e 4a 6f 75 72 6e 61 6c 3d 3d 30 r->pInJournal==0
13f20 20 29 3b 0a 20 20 69 66 28 20 69 73 4f 70 65 6e );. if( isOpen
13f30 28 70 50 61 67 65 72 2d 3e 6a 66 64 29 20 29 7b (pPager->jfd) ){
13f40 0a 20 20 20 20 61 73 73 65 72 74 28 20 21 70 61 . assert( !pa
13f50 67 65 72 55 73 65 57 61 6c 28 70 50 61 67 65 72 gerUseWal(pPager
13f60 29 20 29 3b 0a 0a 20 20 20 20 2f 2a 20 46 69 6e ) );.. /* Fin
13f70 61 6c 69 7a 65 20 74 68 65 20 6a 6f 75 72 6e 61 alize the journa
13f80 6c 20 66 69 6c 65 2e 20 2a 2f 0a 20 20 20 20 69 l file. */. i
13f90 66 28 20 73 71 6c 69 74 65 33 4a 6f 75 72 6e 61 f( sqlite3Journa
13fa0 6c 49 73 49 6e 4d 65 6d 6f 72 79 28 70 50 61 67 lIsInMemory(pPag
13fb0 65 72 2d 3e 6a 66 64 29 20 29 7b 0a 20 20 20 20 er->jfd) ){.
13fc0 20 20 2f 2a 20 61 73 73 65 72 74 28 20 70 50 61 /* assert( pPa
13fd0 67 65 72 2d 3e 6a 6f 75 72 6e 61 6c 4d 6f 64 65 ger->journalMode
13fe0 3d 3d 50 41 47 45 52 5f 4a 4f 55 52 4e 41 4c 4d ==PAGER_JOURNALM
13ff0 4f 44 45 5f 4d 45 4d 4f 52 59 20 29 3b 20 2a 2f ODE_MEMORY ); */
14000 0a 20 20 20 20 20 20 73 71 6c 69 74 65 33 4f 73 . sqlite3Os
14010 43 6c 6f 73 65 28 70 50 61 67 65 72 2d 3e 6a 66 Close(pPager->jf
14020 64 29 3b 0a 20 20 20 20 7d 65 6c 73 65 20 69 66 d);. }else if
14030 28 20 70 50 61 67 65 72 2d 3e 6a 6f 75 72 6e 61 ( pPager->journa
14040 6c 4d 6f 64 65 3d 3d 50 41 47 45 52 5f 4a 4f 55 lMode==PAGER_JOU
14050 52 4e 41 4c 4d 4f 44 45 5f 54 52 55 4e 43 41 54 RNALMODE_TRUNCAT
14060 45 20 29 7b 0a 20 20 20 20 20 20 69 66 28 20 70 E ){. if( p
14070 50 61 67 65 72 2d 3e 6a 6f 75 72 6e 61 6c 4f 66 Pager->journalOf
14080 66 3d 3d 30 20 29 7b 0a 20 20 20 20 20 20 20 20 f==0 ){.
14090 72 63 20 3d 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a rc = SQLITE_OK;.
140a0 20 20 20 20 20 20 7d 65 6c 73 65 7b 0a 20 20 20 }else{.
140b0 20 20 20 20 20 72 63 20 3d 20 73 71 6c 69 74 65 rc = sqlite
140c0 33 4f 73 54 72 75 6e 63 61 74 65 28 70 50 61 67 3OsTruncate(pPag
140d0 65 72 2d 3e 6a 66 64 2c 20 30 29 3b 0a 20 20 20 er->jfd, 0);.
140e0 20 20 20 20 20 69 66 28 20 72 63 3d 3d 53 51 4c if( rc==SQL
140f0 49 54 45 5f 4f 4b 20 26 26 20 70 50 61 67 65 72 ITE_OK && pPager
14100 2d 3e 66 75 6c 6c 53 79 6e 63 20 29 7b 0a 20 20 ->fullSync ){.
14110 20 20 20 20 20 20 20 20 2f 2a 20 4d 61 6b 65 20 /* Make
14120 73 75 72 65 20 74 68 65 20 6e 65 77 20 66 69 6c sure the new fil
14130 65 20 73 69 7a 65 20 69 73 20 77 72 69 74 74 65 e size is writte
14140 6e 20 69 6e 74 6f 20 74 68 65 20 69 6e 6f 64 65 n into the inode
14150 20 72 69 67 68 74 20 61 77 61 79 2e 0a 20 20 20 right away..
14160 20 20 20 20 20 20 20 2a 2a 20 4f 74 68 65 72 77 ** Otherw
14170 69 73 65 20 74 68 65 20 6a 6f 75 72 6e 61 6c 20 ise the journal
14180 6d 69 67 68 74 20 72 65 73 75 72 72 65 63 74 20 might resurrect
14190 66 6f 6c 6c 6f 77 69 6e 67 20 61 20 70 6f 77 65 following a powe
141a0 72 20 6c 6f 73 73 20 61 6e 64 0a 20 20 20 20 20 r loss and.
141b0 20 20 20 20 20 2a 2a 20 63 61 75 73 65 20 74 68 ** cause th
141c0 65 20 6c 61 73 74 20 74 72 61 6e 73 61 63 74 69 e last transacti
141d0 6f 6e 20 74 6f 20 72 6f 6c 6c 20 62 61 63 6b 2e on to roll back.
141e0 20 20 53 65 65 0a 20 20 20 20 20 20 20 20 20 20 See.
141f0 2a 2a 20 68 74 74 70 73 3a 2f 2f 62 75 67 7a 69 ** https://bugzi
14200 6c 6c 61 2e 6d 6f 7a 69 6c 6c 61 2e 6f 72 67 2f lla.mozilla.org/
14210 73 68 6f 77 5f 62 75 67 2e 63 67 69 3f 69 64 3d show_bug.cgi?id=
14220 31 30 37 32 37 37 33 0a 20 20 20 20 20 20 20 20 1072773.
14230 20 20 2a 2f 0a 20 20 20 20 20 20 20 20 20 20 72 */. r
14240 63 20 3d 20 73 71 6c 69 74 65 33 4f 73 53 79 6e c = sqlite3OsSyn
14250 63 28 70 50 61 67 65 72 2d 3e 6a 66 64 2c 20 70 c(pPager->jfd, p
14260 50 61 67 65 72 2d 3e 73 79 6e 63 46 6c 61 67 73 Pager->syncFlags
14270 29 3b 0a 20 20 20 20 20 20 20 20 7d 0a 20 20 20 );. }.
14280 20 20 20 7d 0a 20 20 20 20 20 20 70 50 61 67 65 }. pPage
14290 72 2d 3e 6a 6f 75 72 6e 61 6c 4f 66 66 20 3d 20 r->journalOff =
142a0 30 3b 0a 20 20 20 20 7d 65 6c 73 65 20 69 66 28 0;. }else if(
142b0 20 70 50 61 67 65 72 2d 3e 6a 6f 75 72 6e 61 6c pPager->journal
142c0 4d 6f 64 65 3d 3d 50 41 47 45 52 5f 4a 4f 55 52 Mode==PAGER_JOUR
142d0 4e 41 4c 4d 4f 44 45 5f 50 45 52 53 49 53 54 0a NALMODE_PERSIST.
142e0 20 20 20 20 20 20 7c 7c 20 28 70 50 61 67 65 72 || (pPager
142f0 2d 3e 65 78 63 6c 75 73 69 76 65 4d 6f 64 65 20 ->exclusiveMode
14300 26 26 20 70 50 61 67 65 72 2d 3e 6a 6f 75 72 6e && pPager->journ
14310 61 6c 4d 6f 64 65 21 3d 50 41 47 45 52 5f 4a 4f alMode!=PAGER_JO
14320 55 52 4e 41 4c 4d 4f 44 45 5f 57 41 4c 29 0a 20 URNALMODE_WAL).
14330 20 20 20 29 7b 0a 20 20 20 20 20 20 72 63 20 3d ){. rc =
14340 20 7a 65 72 6f 4a 6f 75 72 6e 61 6c 48 64 72 28 zeroJournalHdr(
14350 70 50 61 67 65 72 2c 20 68 61 73 4d 61 73 74 65 pPager, hasMaste
14360 72 29 3b 0a 20 20 20 20 20 20 70 50 61 67 65 72 r);. pPager
14370 2d 3e 6a 6f 75 72 6e 61 6c 4f 66 66 20 3d 20 30 ->journalOff = 0
14380 3b 0a 20 20 20 20 7d 65 6c 73 65 7b 0a 20 20 20 ;. }else{.
14390 20 20 20 2f 2a 20 54 68 69 73 20 62 72 61 6e 63 /* This branc
143a0 68 20 6d 61 79 20 62 65 20 65 78 65 63 75 74 65 h may be execute
143b0 64 20 77 69 74 68 20 50 61 67 65 72 2e 6a 6f 75 d with Pager.jou
143c0 72 6e 61 6c 4d 6f 64 65 3d 3d 4d 45 4d 4f 52 59 rnalMode==MEMORY
143d0 20 69 66 0a 20 20 20 20 20 20 2a 2a 20 61 20 68 if. ** a h
143e0 6f 74 2d 6a 6f 75 72 6e 61 6c 20 77 61 73 20 6a ot-journal was j
143f0 75 73 74 20 72 6f 6c 6c 65 64 20 62 61 63 6b 2e ust rolled back.
14400 20 49 6e 20 74 68 69 73 20 63 61 73 65 20 74 68 In this case th
14410 65 20 6a 6f 75 72 6e 61 6c 0a 20 20 20 20 20 20 e journal.
14420 2a 2a 20 66 69 6c 65 20 73 68 6f 75 6c 64 20 62 ** file should b
14430 65 20 63 6c 6f 73 65 64 20 61 6e 64 20 64 65 6c e closed and del
14440 65 74 65 64 2e 20 49 66 20 74 68 69 73 20 63 6f eted. If this co
14450 6e 6e 65 63 74 69 6f 6e 20 77 72 69 74 65 73 20 nnection writes
14460 74 6f 0a 20 20 20 20 20 20 2a 2a 20 74 68 65 20 to. ** the
14470 64 61 74 61 62 61 73 65 20 66 69 6c 65 2c 20 69 database file, i
14480 74 20 77 69 6c 6c 20 64 6f 20 73 6f 20 75 73 69 t will do so usi
14490 6e 67 20 61 6e 20 69 6e 2d 6d 65 6d 6f 72 79 20 ng an in-memory
144a0 6a 6f 75 72 6e 61 6c 2e 0a 20 20 20 20 20 20 2a journal.. *
144b0 2f 0a 20 20 20 20 20 20 69 6e 74 20 62 44 65 6c /. int bDel
144c0 65 74 65 20 3d 20 21 70 50 61 67 65 72 2d 3e 74 ete = !pPager->t
144d0 65 6d 70 46 69 6c 65 3b 0a 20 20 20 20 20 20 61 empFile;. a
144e0 73 73 65 72 74 28 20 73 71 6c 69 74 65 33 4a 6f ssert( sqlite3Jo
144f0 75 72 6e 61 6c 49 73 49 6e 4d 65 6d 6f 72 79 28 urnalIsInMemory(
14500 70 50 61 67 65 72 2d 3e 6a 66 64 29 3d 3d 30 20 pPager->jfd)==0
14510 29 3b 0a 20 20 20 20 20 20 61 73 73 65 72 74 28 );. assert(
14520 20 70 50 61 67 65 72 2d 3e 6a 6f 75 72 6e 61 6c pPager->journal
14530 4d 6f 64 65 3d 3d 50 41 47 45 52 5f 4a 4f 55 52 Mode==PAGER_JOUR
14540 4e 41 4c 4d 4f 44 45 5f 44 45 4c 45 54 45 20 0a NALMODE_DELETE .
14550 20 20 20 20 20 20 20 20 20 20 20 7c 7c 20 70 50 || pP
14560 61 67 65 72 2d 3e 6a 6f 75 72 6e 61 6c 4d 6f 64 ager->journalMod
14570 65 3d 3d 50 41 47 45 52 5f 4a 4f 55 52 4e 41 4c e==PAGER_JOURNAL
14580 4d 4f 44 45 5f 4d 45 4d 4f 52 59 20 0a 20 20 20 MODE_MEMORY .
14590 20 20 20 20 20 20 20 20 7c 7c 20 70 50 61 67 65 || pPage
145a0 72 2d 3e 6a 6f 75 72 6e 61 6c 4d 6f 64 65 3d 3d r->journalMode==
145b0 50 41 47 45 52 5f 4a 4f 55 52 4e 41 4c 4d 4f 44 PAGER_JOURNALMOD
145c0 45 5f 57 41 4c 20 0a 20 20 20 20 20 20 29 3b 0a E_WAL . );.
145d0 20 20 20 20 20 20 73 71 6c 69 74 65 33 4f 73 43 sqlite3OsC
145e0 6c 6f 73 65 28 70 50 61 67 65 72 2d 3e 6a 66 64 lose(pPager->jfd
145f0 29 3b 0a 20 20 20 20 20 20 69 66 28 20 62 44 65 );. if( bDe
14600 6c 65 74 65 20 29 7b 0a 20 20 20 20 20 20 20 20 lete ){.
14610 72 63 20 3d 20 73 71 6c 69 74 65 33 4f 73 44 65 rc = sqlite3OsDe
14620 6c 65 74 65 28 70 50 61 67 65 72 2d 3e 70 56 66 lete(pPager->pVf
14630 73 2c 20 70 50 61 67 65 72 2d 3e 7a 4a 6f 75 72 s, pPager->zJour
14640 6e 61 6c 2c 20 70 50 61 67 65 72 2d 3e 65 78 74 nal, pPager->ext
14650 72 61 53 79 6e 63 29 3b 0a 20 20 20 20 20 20 7d raSync);. }
14660 0a 20 20 20 20 7d 0a 20 20 7d 0a 0a 23 69 66 64 . }. }..#ifd
14670 65 66 20 53 51 4c 49 54 45 5f 43 48 45 43 4b 5f ef SQLITE_CHECK_
14680 50 41 47 45 53 0a 20 20 73 71 6c 69 74 65 33 50 PAGES. sqlite3P
14690 63 61 63 68 65 49 74 65 72 61 74 65 44 69 72 74 cacheIterateDirt
146a0 79 28 70 50 61 67 65 72 2d 3e 70 50 43 61 63 68 y(pPager->pPCach
146b0 65 2c 20 70 61 67 65 72 5f 73 65 74 5f 70 61 67 e, pager_set_pag
146c0 65 68 61 73 68 29 3b 0a 20 20 69 66 28 20 70 50 ehash);. if( pP
146d0 61 67 65 72 2d 3e 64 62 53 69 7a 65 3d 3d 30 20 ager->dbSize==0
146e0 26 26 20 73 71 6c 69 74 65 33 50 63 61 63 68 65 && sqlite3Pcache
146f0 52 65 66 43 6f 75 6e 74 28 70 50 61 67 65 72 2d RefCount(pPager-
14700 3e 70 50 43 61 63 68 65 29 3e 30 20 29 7b 0a 20 >pPCache)>0 ){.
14710 20 20 20 50 67 48 64 72 20 2a 70 20 3d 20 73 71 PgHdr *p = sq
14720 6c 69 74 65 33 50 61 67 65 72 4c 6f 6f 6b 75 70 lite3PagerLookup
14730 28 70 50 61 67 65 72 2c 20 31 29 3b 0a 20 20 20 (pPager, 1);.
14740 20 69 66 28 20 70 20 29 7b 0a 20 20 20 20 20 20 if( p ){.
14750 70 2d 3e 70 61 67 65 48 61 73 68 20 3d 20 30 3b p->pageHash = 0;
14760 0a 20 20 20 20 20 20 73 71 6c 69 74 65 33 50 61 . sqlite3Pa
14770 67 65 72 55 6e 72 65 66 4e 6f 74 4e 75 6c 6c 28 gerUnrefNotNull(
14780 70 29 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a 23 65 p);. }. }.#e
14790 6e 64 69 66 0a 0a 20 20 73 71 6c 69 74 65 33 42 ndif.. sqlite3B
147a0 69 74 76 65 63 44 65 73 74 72 6f 79 28 70 50 61 itvecDestroy(pPa
147b0 67 65 72 2d 3e 70 49 6e 4a 6f 75 72 6e 61 6c 29 ger->pInJournal)
147c0 3b 0a 20 20 70 50 61 67 65 72 2d 3e 70 49 6e 4a ;. pPager->pInJ
147d0 6f 75 72 6e 61 6c 20 3d 20 30 3b 0a 20 20 70 50 ournal = 0;. pP
147e0 61 67 65 72 2d 3e 6e 52 65 63 20 3d 20 30 3b 0a ager->nRec = 0;.
147f0 20 20 69 66 28 20 4d 45 4d 44 42 20 7c 7c 20 70 if( MEMDB || p
14800 61 67 65 72 46 6c 75 73 68 4f 6e 43 6f 6d 6d 69 agerFlushOnCommi
14810 74 28 70 50 61 67 65 72 29 20 29 7b 0a 20 20 20 t(pPager) ){.
14820 20 73 71 6c 69 74 65 33 50 63 61 63 68 65 43 6c sqlite3PcacheCl
14830 65 61 6e 41 6c 6c 28 70 50 61 67 65 72 2d 3e 70 eanAll(pPager->p
14840 50 43 61 63 68 65 29 3b 0a 20 20 7d 65 6c 73 65 PCache);. }else
14850 7b 0a 20 20 20 20 73 71 6c 69 74 65 33 50 63 61 {. sqlite3Pca
14860 63 68 65 43 6c 65 61 72 57 72 69 74 61 62 6c 65 cheClearWritable
14870 28 70 50 61 67 65 72 2d 3e 70 50 43 61 63 68 65 (pPager->pPCache
14880 29 3b 0a 20 20 7d 0a 20 20 73 71 6c 69 74 65 33 );. }. sqlite3
14890 50 63 61 63 68 65 54 72 75 6e 63 61 74 65 28 70 PcacheTruncate(p
148a0 50 61 67 65 72 2d 3e 70 50 43 61 63 68 65 2c 20 Pager->pPCache,
148b0 70 50 61 67 65 72 2d 3e 64 62 53 69 7a 65 29 3b pPager->dbSize);
148c0 0a 0a 20 20 69 66 28 20 70 61 67 65 72 55 73 65 .. if( pagerUse
148d0 57 61 6c 28 70 50 61 67 65 72 29 20 29 7b 0a 20 Wal(pPager) ){.
148e0 20 20 20 2f 2a 20 44 72 6f 70 20 74 68 65 20 57 /* Drop the W
148f0 41 4c 20 77 72 69 74 65 2d 6c 6f 63 6b 2c 20 69 AL write-lock, i
14900 66 20 61 6e 79 2e 20 41 6c 73 6f 2c 20 69 66 20 f any. Also, if
14910 74 68 65 20 63 6f 6e 6e 65 63 74 69 6f 6e 20 77 the connection w
14920 61 73 20 69 6e 20 0a 20 20 20 20 2a 2a 20 6c 6f as in . ** lo
14930 63 6b 69 6e 67 5f 6d 6f 64 65 3d 65 78 63 6c 75 cking_mode=exclu
14940 73 69 76 65 20 6d 6f 64 65 20 62 75 74 20 69 73 sive mode but is
14950 20 6e 6f 20 6c 6f 6e 67 65 72 2c 20 64 72 6f 70 no longer, drop
14960 20 74 68 65 20 45 58 43 4c 55 53 49 56 45 20 0a the EXCLUSIVE .
14970 20 20 20 20 2a 2a 20 6c 6f 63 6b 20 68 65 6c 64 ** lock held
14980 20 6f 6e 20 74 68 65 20 64 61 74 61 62 61 73 65 on the database
14990 20 66 69 6c 65 2e 0a 20 20 20 20 2a 2f 0a 20 20 file.. */.
149a0 20 20 72 63 32 20 3d 20 73 71 6c 69 74 65 33 57 rc2 = sqlite3W
149b0 61 6c 45 6e 64 57 72 69 74 65 54 72 61 6e 73 61 alEndWriteTransa
149c0 63 74 69 6f 6e 28 70 50 61 67 65 72 2d 3e 70 57 ction(pPager->pW
149d0 61 6c 29 3b 0a 20 20 20 20 61 73 73 65 72 74 28 al);. assert(
149e0 20 72 63 32 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 rc2==SQLITE_OK
149f0 29 3b 0a 20 20 7d 65 6c 73 65 20 69 66 28 20 72 );. }else if( r
14a00 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 26 26 20 c==SQLITE_OK &&
14a10 62 43 6f 6d 6d 69 74 20 26 26 20 70 50 61 67 65 bCommit && pPage
14a20 72 2d 3e 64 62 46 69 6c 65 53 69 7a 65 3e 70 50 r->dbFileSize>pP
14a30 61 67 65 72 2d 3e 64 62 53 69 7a 65 20 29 7b 0a ager->dbSize ){.
14a40 20 20 20 20 2f 2a 20 54 68 69 73 20 62 72 61 6e /* This bran
14a50 63 68 20 69 73 20 74 61 6b 65 6e 20 77 68 65 6e ch is taken when
14a60 20 63 6f 6d 6d 69 74 74 69 6e 67 20 61 20 74 72 committing a tr
14a70 61 6e 73 61 63 74 69 6f 6e 20 69 6e 20 72 6f 6c ansaction in rol
14a80 6c 62 61 63 6b 2d 6a 6f 75 72 6e 61 6c 0a 20 20 lback-journal.
14a90 20 20 2a 2a 20 6d 6f 64 65 20 69 66 20 74 68 65 ** mode if the
14aa0 20 64 61 74 61 62 61 73 65 20 66 69 6c 65 20 6f database file o
14ab0 6e 20 64 69 73 6b 20 69 73 20 6c 61 72 67 65 72 n disk is larger
14ac0 20 74 68 61 6e 20 74 68 65 20 64 61 74 61 62 61 than the databa
14ad0 73 65 20 69 6d 61 67 65 2e 0a 20 20 20 20 2a 2a se image.. **
14ae0 20 41 74 20 74 68 69 73 20 70 6f 69 6e 74 20 74 At this point t
14af0 68 65 20 6a 6f 75 72 6e 61 6c 20 68 61 73 20 62 he journal has b
14b00 65 65 6e 20 66 69 6e 61 6c 69 7a 65 64 20 61 6e een finalized an
14b10 64 20 74 68 65 20 74 72 61 6e 73 61 63 74 69 6f d the transactio
14b20 6e 20 0a 20 20 20 20 2a 2a 20 73 75 63 63 65 73 n . ** succes
14b30 73 66 75 6c 6c 79 20 63 6f 6d 6d 69 74 74 65 64 sfully committed
14b40 2c 20 62 75 74 20 74 68 65 20 45 58 43 4c 55 53 , but the EXCLUS
14b50 49 56 45 20 6c 6f 63 6b 20 69 73 20 73 74 69 6c IVE lock is stil
14b60 6c 20 68 65 6c 64 20 6f 6e 20 74 68 65 0a 20 20 l held on the.
14b70 20 20 2a 2a 20 66 69 6c 65 2e 20 53 6f 20 69 74 ** file. So it
14b80 20 69 73 20 73 61 66 65 20 74 6f 20 74 72 75 6e is safe to trun
14b90 63 61 74 65 20 74 68 65 20 64 61 74 61 62 61 73 cate the databas
14ba0 65 20 66 69 6c 65 20 74 6f 20 69 74 73 20 6d 69 e file to its mi
14bb0 6e 69 6d 75 6d 0a 20 20 20 20 2a 2a 20 72 65 71 nimum. ** req
14bc0 75 69 72 65 64 20 73 69 7a 65 2e 20 20 2a 2f 0a uired size. */.
14bd0 20 20 20 20 61 73 73 65 72 74 28 20 70 50 61 67 assert( pPag
14be0 65 72 2d 3e 65 4c 6f 63 6b 3d 3d 45 58 43 4c 55 er->eLock==EXCLU
14bf0 53 49 56 45 5f 4c 4f 43 4b 20 29 3b 0a 20 20 20 SIVE_LOCK );.
14c00 20 72 63 20 3d 20 70 61 67 65 72 5f 74 72 75 6e rc = pager_trun
14c10 63 61 74 65 28 70 50 61 67 65 72 2c 20 70 50 61 cate(pPager, pPa
14c20 67 65 72 2d 3e 64 62 53 69 7a 65 29 3b 0a 20 20 ger->dbSize);.
14c30 7d 0a 0a 20 20 69 66 28 20 72 63 3d 3d 53 51 4c }.. if( rc==SQL
14c40 49 54 45 5f 4f 4b 20 26 26 20 62 43 6f 6d 6d 69 ITE_OK && bCommi
14c50 74 20 26 26 20 69 73 4f 70 65 6e 28 70 50 61 67 t && isOpen(pPag
14c60 65 72 2d 3e 66 64 29 20 29 7b 0a 20 20 20 20 72 er->fd) ){. r
14c70 63 20 3d 20 73 71 6c 69 74 65 33 4f 73 46 69 6c c = sqlite3OsFil
14c80 65 43 6f 6e 74 72 6f 6c 28 70 50 61 67 65 72 2d eControl(pPager-
14c90 3e 66 64 2c 20 53 51 4c 49 54 45 5f 46 43 4e 54 >fd, SQLITE_FCNT
14ca0 4c 5f 43 4f 4d 4d 49 54 5f 50 48 41 53 45 54 57 L_COMMIT_PHASETW
14cb0 4f 2c 20 30 29 3b 0a 20 20 20 20 69 66 28 20 72 O, 0);. if( r
14cc0 63 3d 3d 53 51 4c 49 54 45 5f 4e 4f 54 46 4f 55 c==SQLITE_NOTFOU
14cd0 4e 44 20 29 20 72 63 20 3d 20 53 51 4c 49 54 45 ND ) rc = SQLITE
14ce0 5f 4f 4b 3b 0a 20 20 7d 0a 0a 20 20 69 66 28 20 _OK;. }.. if(
14cf0 21 70 50 61 67 65 72 2d 3e 65 78 63 6c 75 73 69 !pPager->exclusi
14d00 76 65 4d 6f 64 65 20 0a 20 20 20 26 26 20 28 21 veMode . && (!
14d10 70 61 67 65 72 55 73 65 57 61 6c 28 70 50 61 67 pagerUseWal(pPag
14d20 65 72 29 20 7c 7c 20 73 71 6c 69 74 65 33 57 61 er) || sqlite3Wa
14d30 6c 45 78 63 6c 75 73 69 76 65 4d 6f 64 65 28 70 lExclusiveMode(p
14d40 50 61 67 65 72 2d 3e 70 57 61 6c 2c 20 30 29 29 Pager->pWal, 0))
14d50 0a 20 20 29 7b 0a 20 20 20 20 72 63 32 20 3d 20 . ){. rc2 =
14d60 70 61 67 65 72 55 6e 6c 6f 63 6b 44 62 28 70 50 pagerUnlockDb(pP
14d70 61 67 65 72 2c 20 53 48 41 52 45 44 5f 4c 4f 43 ager, SHARED_LOC
14d80 4b 29 3b 0a 20 20 20 20 70 50 61 67 65 72 2d 3e K);. pPager->
14d90 63 68 61 6e 67 65 43 6f 75 6e 74 44 6f 6e 65 20 changeCountDone
14da0 3d 20 30 3b 0a 20 20 7d 0a 20 20 70 50 61 67 65 = 0;. }. pPage
14db0 72 2d 3e 65 53 74 61 74 65 20 3d 20 50 41 47 45 r->eState = PAGE
14dc0 52 5f 52 45 41 44 45 52 3b 0a 20 20 70 50 61 67 R_READER;. pPag
14dd0 65 72 2d 3e 73 65 74 4d 61 73 74 65 72 20 3d 20 er->setMaster =
14de0 30 3b 0a 0a 20 20 72 65 74 75 72 6e 20 28 72 63 0;.. return (rc
14df0 3d 3d 53 51 4c 49 54 45 5f 4f 4b 3f 72 63 32 3a ==SQLITE_OK?rc2:
14e00 72 63 29 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 45 78 rc);.}../*.** Ex
14e10 65 63 75 74 65 20 61 20 72 6f 6c 6c 62 61 63 6b ecute a rollback
14e20 20 69 66 20 61 20 74 72 61 6e 73 61 63 74 69 6f if a transactio
14e30 6e 20 69 73 20 61 63 74 69 76 65 20 61 6e 64 20 n is active and
14e40 75 6e 6c 6f 63 6b 20 74 68 65 20 0a 2a 2a 20 64 unlock the .** d
14e50 61 74 61 62 61 73 65 20 66 69 6c 65 2e 20 0a 2a atabase file. .*
14e60 2a 0a 2a 2a 20 49 66 20 74 68 65 20 70 61 67 65 *.** If the page
14e70 72 20 68 61 73 20 61 6c 72 65 61 64 79 20 65 6e r has already en
14e80 74 65 72 65 64 20 74 68 65 20 45 52 52 4f 52 20 tered the ERROR
14e90 73 74 61 74 65 2c 20 64 6f 20 6e 6f 74 20 61 74 state, do not at
14ea0 74 65 6d 70 74 20 0a 2a 2a 20 74 68 65 20 72 6f tempt .** the ro
14eb0 6c 6c 62 61 63 6b 20 61 74 20 74 68 69 73 20 74 llback at this t
14ec0 69 6d 65 2e 20 49 6e 73 74 65 61 64 2c 20 70 61 ime. Instead, pa
14ed0 67 65 72 5f 75 6e 6c 6f 63 6b 28 29 20 69 73 20 ger_unlock() is
14ee0 63 61 6c 6c 65 64 2e 20 54 68 65 0a 2a 2a 20 63 called. The.** c
14ef0 61 6c 6c 20 74 6f 20 70 61 67 65 72 5f 75 6e 6c all to pager_unl
14f00 6f 63 6b 28 29 20 77 69 6c 6c 20 64 69 73 63 61 ock() will disca
14f10 72 64 20 61 6c 6c 20 69 6e 2d 6d 65 6d 6f 72 79 rd all in-memory
14f20 20 70 61 67 65 73 2c 20 75 6e 6c 6f 63 6b 0a 2a pages, unlock.*
14f30 2a 20 74 68 65 20 64 61 74 61 62 61 73 65 20 66 * the database f
14f40 69 6c 65 20 61 6e 64 20 6d 6f 76 65 20 74 68 65 ile and move the
14f50 20 70 61 67 65 72 20 62 61 63 6b 20 74 6f 20 4f pager back to O
14f60 50 45 4e 20 73 74 61 74 65 2e 20 49 66 20 74 68 PEN state. If th
14f70 69 73 20 0a 2a 2a 20 6d 65 61 6e 73 20 74 68 61 is .** means tha
14f80 74 20 74 68 65 72 65 20 69 73 20 61 20 68 6f 74 t there is a hot
14f90 2d 6a 6f 75 72 6e 61 6c 20 6c 65 66 74 20 69 6e -journal left in
14fa0 20 74 68 65 20 66 69 6c 65 2d 73 79 73 74 65 6d the file-system
14fb0 2c 20 74 68 65 20 6e 65 78 74 20 0a 2a 2a 20 63 , the next .** c
14fc0 6f 6e 6e 65 63 74 69 6f 6e 20 74 6f 20 6f 62 74 onnection to obt
14fd0 61 69 6e 20 61 20 73 68 61 72 65 64 20 6c 6f 63 ain a shared loc
14fe0 6b 20 6f 6e 20 74 68 65 20 70 61 67 65 72 20 28 k on the pager (
14ff0 77 68 69 63 68 20 6d 61 79 20 62 65 20 74 68 69 which may be thi
15000 73 20 6f 6e 65 29 20 0a 2a 2a 20 77 69 6c 6c 20 s one) .** will
15010 72 6f 6c 6c 20 69 74 20 62 61 63 6b 2e 0a 2a 2a roll it back..**
15020 0a 2a 2a 20 49 66 20 74 68 65 20 70 61 67 65 72 .** If the pager
15030 20 68 61 73 20 6e 6f 74 20 61 6c 72 65 61 64 79 has not already
15040 20 65 6e 74 65 72 65 64 20 74 68 65 20 45 52 52 entered the ERR
15050 4f 52 20 73 74 61 74 65 2c 20 62 75 74 20 61 6e OR state, but an
15060 20 49 4f 20 6f 72 0a 2a 2a 20 6d 61 6c 6c 6f 63 IO or.** malloc
15070 20 65 72 72 6f 72 20 6f 63 63 75 72 73 20 64 75 error occurs du
15080 72 69 6e 67 20 61 20 72 6f 6c 6c 62 61 63 6b 2c ring a rollback,
15090 20 74 68 65 6e 20 74 68 69 73 20 77 69 6c 6c 20 then this will
150a0 69 74 73 65 6c 66 20 63 61 75 73 65 20 0a 2a 2a itself cause .**
150b0 20 74 68 65 20 70 61 67 65 72 20 74 6f 20 65 6e the pager to en
150c0 74 65 72 20 74 68 65 20 45 52 52 4f 52 20 73 74 ter the ERROR st
150d0 61 74 65 2e 20 57 68 69 63 68 20 77 69 6c 6c 20 ate. Which will
150e0 62 65 20 63 6c 65 61 72 65 64 20 62 79 20 74 68 be cleared by th
150f0 65 0a 2a 2a 20 63 61 6c 6c 20 74 6f 20 70 61 67 e.** call to pag
15100 65 72 5f 75 6e 6c 6f 63 6b 28 29 2c 20 61 73 20 er_unlock(), as
15110 64 65 73 63 72 69 62 65 64 20 61 62 6f 76 65 2e described above.
15120 0a 2a 2f 0a 73 74 61 74 69 63 20 76 6f 69 64 20 .*/.static void
15130 70 61 67 65 72 55 6e 6c 6f 63 6b 41 6e 64 52 6f pagerUnlockAndRo
15140 6c 6c 62 61 63 6b 28 50 61 67 65 72 20 2a 70 50 llback(Pager *pP
15150 61 67 65 72 29 7b 0a 20 20 69 66 28 20 70 50 61 ager){. if( pPa
15160 67 65 72 2d 3e 65 53 74 61 74 65 21 3d 50 41 47 ger->eState!=PAG
15170 45 52 5f 45 52 52 4f 52 20 26 26 20 70 50 61 67 ER_ERROR && pPag
15180 65 72 2d 3e 65 53 74 61 74 65 21 3d 50 41 47 45 er->eState!=PAGE
15190 52 5f 4f 50 45 4e 20 29 7b 0a 20 20 20 20 61 73 R_OPEN ){. as
151a0 73 65 72 74 28 20 61 73 73 65 72 74 5f 70 61 67 sert( assert_pag
151b0 65 72 5f 73 74 61 74 65 28 70 50 61 67 65 72 29 er_state(pPager)
151c0 20 29 3b 0a 20 20 20 20 69 66 28 20 70 50 61 67 );. if( pPag
151d0 65 72 2d 3e 65 53 74 61 74 65 3e 3d 50 41 47 45 er->eState>=PAGE
151e0 52 5f 57 52 49 54 45 52 5f 4c 4f 43 4b 45 44 20 R_WRITER_LOCKED
151f0 29 7b 0a 20 20 20 20 20 20 73 71 6c 69 74 65 33 ){. sqlite3
15200 42 65 67 69 6e 42 65 6e 69 67 6e 4d 61 6c 6c 6f BeginBenignMallo
15210 63 28 29 3b 0a 20 20 20 20 20 20 73 71 6c 69 74 c();. sqlit
15220 65 33 50 61 67 65 72 52 6f 6c 6c 62 61 63 6b 28 e3PagerRollback(
15230 70 50 61 67 65 72 29 3b 0a 20 20 20 20 20 20 73 pPager);. s
15240 71 6c 69 74 65 33 45 6e 64 42 65 6e 69 67 6e 4d qlite3EndBenignM
15250 61 6c 6c 6f 63 28 29 3b 0a 20 20 20 20 7d 65 6c alloc();. }el
15260 73 65 20 69 66 28 20 21 70 50 61 67 65 72 2d 3e se if( !pPager->
15270 65 78 63 6c 75 73 69 76 65 4d 6f 64 65 20 29 7b exclusiveMode ){
15280 0a 20 20 20 20 20 20 61 73 73 65 72 74 28 20 70 . assert( p
15290 50 61 67 65 72 2d 3e 65 53 74 61 74 65 3d 3d 50 Pager->eState==P
152a0 41 47 45 52 5f 52 45 41 44 45 52 20 29 3b 0a 20 AGER_READER );.
152b0 20 20 20 20 20 70 61 67 65 72 5f 65 6e 64 5f 74 pager_end_t
152c0 72 61 6e 73 61 63 74 69 6f 6e 28 70 50 61 67 65 ransaction(pPage
152d0 72 2c 20 30 2c 20 30 29 3b 0a 20 20 20 20 7d 0a r, 0, 0);. }.
152e0 20 20 7d 0a 20 20 70 61 67 65 72 5f 75 6e 6c 6f }. pager_unlo
152f0 63 6b 28 70 50 61 67 65 72 29 3b 0a 7d 0a 0a 2f ck(pPager);.}../
15300 2a 0a 2a 2a 20 50 61 72 61 6d 65 74 65 72 20 61 *.** Parameter a
15310 44 61 74 61 20 6d 75 73 74 20 70 6f 69 6e 74 20 Data must point
15320 74 6f 20 61 20 62 75 66 66 65 72 20 6f 66 20 70 to a buffer of p
15330 50 61 67 65 72 2d 3e 70 61 67 65 53 69 7a 65 20 Pager->pageSize
15340 62 79 74 65 73 0a 2a 2a 20 6f 66 20 64 61 74 61 bytes.** of data
15350 2e 20 43 6f 6d 70 75 74 65 20 61 6e 64 20 72 65 . Compute and re
15360 74 75 72 6e 20 61 20 63 68 65 63 6b 73 75 6d 20 turn a checksum
15370 62 61 73 65 64 20 6f 6e 74 20 74 68 65 20 63 6f based ont the co
15380 6e 74 65 6e 74 73 20 6f 66 20 74 68 65 20 0a 2a ntents of the .*
15390 2a 20 70 61 67 65 20 6f 66 20 64 61 74 61 20 61 * page of data a
153a0 6e 64 20 74 68 65 20 63 75 72 72 65 6e 74 20 76 nd the current v
153b0 61 6c 75 65 20 6f 66 20 70 50 61 67 65 72 2d 3e alue of pPager->
153c0 63 6b 73 75 6d 49 6e 69 74 2e 0a 2a 2a 0a 2a 2a cksumInit..**.**
153d0 20 54 68 69 73 20 69 73 20 6e 6f 74 20 61 20 72 This is not a r
153e0 65 61 6c 20 63 68 65 63 6b 73 75 6d 2e 20 49 74 eal checksum. It
153f0 20 69 73 20 72 65 61 6c 6c 79 20 6a 75 73 74 20 is really just
15400 74 68 65 20 73 75 6d 20 6f 66 20 74 68 65 20 0a the sum of the .
15410 2a 2a 20 72 61 6e 64 6f 6d 20 69 6e 69 74 69 61 ** random initia
15420 6c 20 76 61 6c 75 65 20 28 70 50 61 67 65 72 2d l value (pPager-
15430 3e 63 6b 73 75 6d 49 6e 69 74 29 20 61 6e 64 20 >cksumInit) and
15440 65 76 65 72 79 20 32 30 30 74 68 20 62 79 74 65 every 200th byte
15450 0a 2a 2a 20 6f 66 20 74 68 65 20 70 61 67 65 20 .** of the page
15460 64 61 74 61 2c 20 73 74 61 72 74 69 6e 67 20 77 data, starting w
15470 69 74 68 20 62 79 74 65 20 6f 66 66 73 65 74 20 ith byte offset
15480 28 70 50 61 67 65 72 2d 3e 70 61 67 65 53 69 7a (pPager->pageSiz
15490 65 25 32 30 30 29 2e 0a 2a 2a 20 45 61 63 68 20 e%200)..** Each
154a0 62 79 74 65 20 69 73 20 69 6e 74 65 72 70 72 65 byte is interpre
154b0 74 65 64 20 61 73 20 61 6e 20 38 2d 62 69 74 20 ted as an 8-bit
154c0 75 6e 73 69 67 6e 65 64 20 69 6e 74 65 67 65 72 unsigned integer
154d0 2e 0a 2a 2a 0a 2a 2a 20 43 68 61 6e 67 69 6e 67 ..**.** Changing
154e0 20 74 68 65 20 66 6f 72 6d 75 6c 61 20 75 73 65 the formula use
154f0 64 20 74 6f 20 63 6f 6d 70 75 74 65 20 74 68 69 d to compute thi
15500 73 20 63 68 65 63 6b 73 75 6d 20 72 65 73 75 6c s checksum resul
15510 74 73 20 69 6e 20 61 6e 0a 2a 2a 20 69 6e 63 6f ts in an.** inco
15520 6d 70 61 74 69 62 6c 65 20 6a 6f 75 72 6e 61 6c mpatible journal
15530 20 66 69 6c 65 20 66 6f 72 6d 61 74 2e 0a 2a 2a file format..**
15540 0a 2a 2a 20 49 66 20 6a 6f 75 72 6e 61 6c 20 63 .** If journal c
15550 6f 72 72 75 70 74 69 6f 6e 20 6f 63 63 75 72 73 orruption occurs
15560 20 64 75 65 20 74 6f 20 61 20 70 6f 77 65 72 20 due to a power
15570 66 61 69 6c 75 72 65 2c 20 74 68 65 20 6d 6f 73 failure, the mos
15580 74 20 6c 69 6b 65 6c 79 20 0a 2a 2a 20 73 63 65 t likely .** sce
15590 6e 61 72 69 6f 20 69 73 20 74 68 61 74 20 6f 6e nario is that on
155a0 65 20 65 6e 64 20 6f 72 20 74 68 65 20 6f 74 68 e end or the oth
155b0 65 72 20 6f 66 20 74 68 65 20 72 65 63 6f 72 64 er of the record
155c0 20 77 69 6c 6c 20 62 65 20 63 68 61 6e 67 65 64 will be changed
155d0 2e 20 0a 2a 2a 20 49 74 20 69 73 20 6d 75 63 68 . .** It is much
155e0 20 6c 65 73 73 20 6c 69 6b 65 6c 79 20 74 68 61 less likely tha
155f0 74 20 74 68 65 20 74 77 6f 20 65 6e 64 73 20 6f t the two ends o
15600 66 20 74 68 65 20 6a 6f 75 72 6e 61 6c 20 72 65 f the journal re
15610 63 6f 72 64 20 77 69 6c 6c 20 62 65 0a 2a 2a 20 cord will be.**
15620 63 6f 72 72 65 63 74 20 61 6e 64 20 74 68 65 20 correct and the
15630 6d 69 64 64 6c 65 20 62 65 20 63 6f 72 72 75 70 middle be corrup
15640 74 2e 20 20 54 68 75 73 2c 20 74 68 69 73 20 22 t. Thus, this "
15650 63 68 65 63 6b 73 75 6d 22 20 73 63 68 65 6d 65 checksum" scheme
15660 2c 0a 2a 2a 20 74 68 6f 75 67 68 20 66 61 73 74 ,.** though fast
15670 20 61 6e 64 20 73 69 6d 70 6c 65 2c 20 63 61 74 and simple, cat
15680 63 68 65 73 20 74 68 65 20 6d 6f 73 74 6c 79 20 ches the mostly
15690 6c 69 6b 65 6c 79 20 6b 69 6e 64 20 6f 66 20 63 likely kind of c
156a0 6f 72 72 75 70 74 69 6f 6e 2e 0a 2a 2f 0a 73 74 orruption..*/.st
156b0 61 74 69 63 20 75 33 32 20 70 61 67 65 72 5f 63 atic u32 pager_c
156c0 6b 73 75 6d 28 50 61 67 65 72 20 2a 70 50 61 67 ksum(Pager *pPag
156d0 65 72 2c 20 63 6f 6e 73 74 20 75 38 20 2a 61 44 er, const u8 *aD
156e0 61 74 61 29 7b 0a 20 20 75 33 32 20 63 6b 73 75 ata){. u32 cksu
156f0 6d 20 3d 20 70 50 61 67 65 72 2d 3e 63 6b 73 75 m = pPager->cksu
15700 6d 49 6e 69 74 3b 20 20 20 20 20 20 20 20 20 2f mInit; /
15710 2a 20 43 68 65 63 6b 73 75 6d 20 76 61 6c 75 65 * Checksum value
15720 20 74 6f 20 72 65 74 75 72 6e 20 2a 2f 0a 20 20 to return */.
15730 69 6e 74 20 69 20 3d 20 70 50 61 67 65 72 2d 3e int i = pPager->
15740 70 61 67 65 53 69 7a 65 2d 32 30 30 3b 20 20 20 pageSize-200;
15750 20 20 20 20 20 20 20 2f 2a 20 4c 6f 6f 70 20 63 /* Loop c
15760 6f 75 6e 74 65 72 20 2a 2f 0a 20 20 77 68 69 6c ounter */. whil
15770 65 28 20 69 3e 30 20 29 7b 0a 20 20 20 20 63 6b e( i>0 ){. ck
15780 73 75 6d 20 2b 3d 20 61 44 61 74 61 5b 69 5d 3b sum += aData[i];
15790 0a 20 20 20 20 69 20 2d 3d 20 32 30 30 3b 0a 20 . i -= 200;.
157a0 20 7d 0a 20 20 72 65 74 75 72 6e 20 63 6b 73 75 }. return cksu
157b0 6d 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 52 65 70 6f m;.}../*.** Repo
157c0 72 74 20 74 68 65 20 63 75 72 72 65 6e 74 20 70 rt the current p
157d0 61 67 65 20 73 69 7a 65 20 61 6e 64 20 6e 75 6d age size and num
157e0 62 65 72 20 6f 66 20 72 65 73 65 72 76 65 64 20 ber of reserved
157f0 62 79 74 65 73 20 62 61 63 6b 0a 2a 2a 20 74 6f bytes back.** to
15800 20 74 68 65 20 63 6f 64 65 63 2e 0a 2a 2f 0a 23 the codec..*/.#
15810 69 66 64 65 66 20 53 51 4c 49 54 45 5f 48 41 53 ifdef SQLITE_HAS
15820 5f 43 4f 44 45 43 0a 73 74 61 74 69 63 20 76 6f _CODEC.static vo
15830 69 64 20 70 61 67 65 72 52 65 70 6f 72 74 53 69 id pagerReportSi
15840 7a 65 28 50 61 67 65 72 20 2a 70 50 61 67 65 72 ze(Pager *pPager
15850 29 7b 0a 20 20 69 66 28 20 70 50 61 67 65 72 2d ){. if( pPager-
15860 3e 78 43 6f 64 65 63 53 69 7a 65 43 68 6e 67 20 >xCodecSizeChng
15870 29 7b 0a 20 20 20 20 70 50 61 67 65 72 2d 3e 78 ){. pPager->x
15880 43 6f 64 65 63 53 69 7a 65 43 68 6e 67 28 70 50 CodecSizeChng(pP
15890 61 67 65 72 2d 3e 70 43 6f 64 65 63 2c 20 70 50 ager->pCodec, pP
158a0 61 67 65 72 2d 3e 70 61 67 65 53 69 7a 65 2c 0a ager->pageSize,.
158b0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
158c0 20 20 20 20 20 20 20 20 20 20 20 28 69 6e 74 29 (int)
158d0 70 50 61 67 65 72 2d 3e 6e 52 65 73 65 72 76 65 pPager->nReserve
158e0 29 3b 0a 20 20 7d 0a 7d 0a 23 65 6c 73 65 0a 23 );. }.}.#else.#
158f0 20 64 65 66 69 6e 65 20 70 61 67 65 72 52 65 70 define pagerRep
15900 6f 72 74 53 69 7a 65 28 58 29 20 20 20 20 20 2f ortSize(X) /
15910 2a 20 4e 6f 2d 6f 70 20 69 66 20 77 65 20 64 6f * No-op if we do
15920 20 6e 6f 74 20 73 75 70 70 6f 72 74 20 61 20 63 not support a c
15930 6f 64 65 63 20 2a 2f 0a 23 65 6e 64 69 66 0a 0a odec */.#endif..
15940 23 69 66 64 65 66 20 53 51 4c 49 54 45 5f 48 41 #ifdef SQLITE_HA
15950 53 5f 43 4f 44 45 43 0a 2f 2a 0a 2a 2a 20 4d 61 S_CODEC./*.** Ma
15960 6b 65 20 73 75 72 65 20 74 68 65 20 6e 75 6d 62 ke sure the numb
15970 65 72 20 6f 66 20 72 65 73 65 72 76 65 64 20 62 er of reserved b
15980 69 74 73 20 69 73 20 74 68 65 20 73 61 6d 65 20 its is the same
15990 69 6e 20 74 68 65 20 64 65 73 74 69 6e 61 74 69 in the destinati
159a0 6f 6e 0a 2a 2a 20 70 61 67 65 72 20 61 73 20 69 on.** pager as i
159b0 74 20 69 73 20 69 6e 20 74 68 65 20 73 6f 75 72 t is in the sour
159c0 63 65 2e 20 20 54 68 69 73 20 63 6f 6d 65 73 20 ce. This comes
159d0 75 70 20 77 68 65 6e 20 61 20 56 41 43 55 55 4d up when a VACUUM
159e0 20 63 68 61 6e 67 65 73 20 74 68 65 0a 2a 2a 20 changes the.**
159f0 6e 75 6d 62 65 72 20 6f 66 20 72 65 73 65 72 76 number of reserv
15a00 65 64 20 62 69 74 73 20 74 6f 20 74 68 65 20 22 ed bits to the "
15a10 6f 70 74 69 6d 61 6c 22 20 61 6d 6f 75 6e 74 2e optimal" amount.
15a20 0a 2a 2f 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 .*/.void sqlite3
15a30 50 61 67 65 72 41 6c 69 67 6e 52 65 73 65 72 76 PagerAlignReserv
15a40 65 28 50 61 67 65 72 20 2a 70 44 65 73 74 2c 20 e(Pager *pDest,
15a50 50 61 67 65 72 20 2a 70 53 72 63 29 7b 0a 20 20 Pager *pSrc){.
15a60 69 66 28 20 70 44 65 73 74 2d 3e 6e 52 65 73 65 if( pDest->nRese
15a70 72 76 65 21 3d 70 53 72 63 2d 3e 6e 52 65 73 65 rve!=pSrc->nRese
15a80 72 76 65 20 29 7b 0a 20 20 20 20 70 44 65 73 74 rve ){. pDest
15a90 2d 3e 6e 52 65 73 65 72 76 65 20 3d 20 70 53 72 ->nReserve = pSr
15aa0 63 2d 3e 6e 52 65 73 65 72 76 65 3b 0a 20 20 20 c->nReserve;.
15ab0 20 70 61 67 65 72 52 65 70 6f 72 74 53 69 7a 65 pagerReportSize
15ac0 28 70 44 65 73 74 29 3b 0a 20 20 7d 0a 7d 0a 23 (pDest);. }.}.#
15ad0 65 6e 64 69 66 0a 0a 2f 2a 0a 2a 2a 20 52 65 61 endif../*.** Rea
15ae0 64 20 61 20 73 69 6e 67 6c 65 20 70 61 67 65 20 d a single page
15af0 66 72 6f 6d 20 65 69 74 68 65 72 20 74 68 65 20 from either the
15b00 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 20 28 69 66 journal file (if
15b10 20 69 73 4d 61 69 6e 4a 72 6e 6c 3d 3d 31 29 20 isMainJrnl==1)
15b20 6f 72 0a 2a 2a 20 66 72 6f 6d 20 74 68 65 20 73 or.** from the s
15b30 75 62 2d 6a 6f 75 72 6e 61 6c 20 28 69 66 20 69 ub-journal (if i
15b40 73 4d 61 69 6e 4a 72 6e 6c 3d 3d 30 29 20 61 6e sMainJrnl==0) an
15b50 64 20 70 6c 61 79 62 61 63 6b 20 74 68 61 74 20 d playback that
15b60 70 61 67 65 2e 0a 2a 2a 20 54 68 65 20 70 61 67 page..** The pag
15b70 65 20 62 65 67 69 6e 73 20 61 74 20 6f 66 66 73 e begins at offs
15b80 65 74 20 2a 70 4f 66 66 73 65 74 20 69 6e 74 6f et *pOffset into
15b90 20 74 68 65 20 66 69 6c 65 2e 20 54 68 65 20 2a the file. The *
15ba0 70 4f 66 66 73 65 74 0a 2a 2a 20 76 61 6c 75 65 pOffset.** value
15bb0 20 69 73 20 69 6e 63 72 65 61 73 65 64 20 74 6f is increased to
15bc0 20 74 68 65 20 73 74 61 72 74 20 6f 66 20 74 68 the start of th
15bd0 65 20 6e 65 78 74 20 70 61 67 65 20 69 6e 20 74 e next page in t
15be0 68 65 20 6a 6f 75 72 6e 61 6c 2e 0a 2a 2a 0a 2a he journal..**.*
15bf0 2a 20 54 68 65 20 6d 61 69 6e 20 72 6f 6c 6c 62 * The main rollb
15c00 61 63 6b 20 6a 6f 75 72 6e 61 6c 20 75 73 65 73 ack journal uses
15c10 20 63 68 65 63 6b 73 75 6d 73 20 2d 20 74 68 65 checksums - the
15c20 20 73 74 61 74 65 6d 65 6e 74 20 6a 6f 75 72 6e statement journ
15c30 61 6c 20 64 6f 65 73 20 0a 2a 2a 20 6e 6f 74 2e al does .** not.
15c40 0a 2a 2a 0a 2a 2a 20 49 66 20 74 68 65 20 70 61 .**.** If the pa
15c50 67 65 20 6e 75 6d 62 65 72 20 6f 66 20 74 68 65 ge number of the
15c60 20 70 61 67 65 20 72 65 63 6f 72 64 20 72 65 61 page record rea
15c70 64 20 66 72 6f 6d 20 74 68 65 20 28 73 75 62 2d d from the (sub-
15c80 29 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 0a 2a 2a )journal file.**
15c90 20 69 73 20 67 72 65 61 74 65 72 20 74 68 61 6e is greater than
15ca0 20 74 68 65 20 63 75 72 72 65 6e 74 20 76 61 6c the current val
15cb0 75 65 20 6f 66 20 50 61 67 65 72 2e 64 62 53 69 ue of Pager.dbSi
15cc0 7a 65 2c 20 74 68 65 6e 20 70 6c 61 79 62 61 63 ze, then playbac
15cd0 6b 20 69 73 0a 2a 2a 20 73 6b 69 70 70 65 64 20 k is.** skipped
15ce0 61 6e 64 20 53 51 4c 49 54 45 5f 4f 4b 20 69 73 and SQLITE_OK is
15cf0 20 72 65 74 75 72 6e 65 64 2e 0a 2a 2a 0a 2a 2a returned..**.**
15d00 20 49 66 20 70 44 6f 6e 65 20 69 73 20 6e 6f 74 If pDone is not
15d10 20 4e 55 4c 4c 2c 20 74 68 65 6e 20 69 74 20 69 NULL, then it i
15d20 73 20 61 20 72 65 63 6f 72 64 20 6f 66 20 70 61 s a record of pa
15d30 67 65 73 20 74 68 61 74 20 68 61 76 65 20 61 6c ges that have al
15d40 72 65 61 64 79 0a 2a 2a 20 62 65 65 6e 20 70 6c ready.** been pl
15d50 61 79 65 64 20 62 61 63 6b 2e 20 20 49 66 20 74 ayed back. If t
15d60 68 65 20 70 61 67 65 20 61 74 20 2a 70 4f 66 66 he page at *pOff
15d70 73 65 74 20 68 61 73 20 61 6c 72 65 61 64 79 20 set has already
15d80 62 65 65 6e 20 70 6c 61 79 65 64 20 62 61 63 6b been played back
15d90 0a 2a 2a 20 28 69 66 20 74 68 65 20 63 6f 72 72 .** (if the corr
15da0 65 73 70 6f 6e 64 69 6e 67 20 70 44 6f 6e 65 20 esponding pDone
15db0 62 69 74 20 69 73 20 73 65 74 29 20 74 68 65 6e bit is set) then
15dc0 20 73 6b 69 70 20 74 68 65 20 70 6c 61 79 62 61 skip the playba
15dd0 63 6b 2e 0a 2a 2a 20 4d 61 6b 65 20 73 75 72 65 ck..** Make sure
15de0 20 74 68 65 20 70 44 6f 6e 65 20 62 69 74 20 63 the pDone bit c
15df0 6f 72 72 65 73 70 6f 6e 64 69 6e 67 20 74 6f 20 orresponding to
15e00 74 68 65 20 2a 70 4f 66 66 73 65 74 20 70 61 67 the *pOffset pag
15e10 65 20 69 73 20 73 65 74 0a 2a 2a 20 70 72 69 6f e is set.** prio
15e20 72 20 74 6f 20 72 65 74 75 72 6e 69 6e 67 2e 0a r to returning..
15e30 2a 2a 0a 2a 2a 20 49 66 20 74 68 65 20 70 61 67 **.** If the pag
15e40 65 20 72 65 63 6f 72 64 20 69 73 20 73 75 63 63 e record is succ
15e50 65 73 73 66 75 6c 6c 79 20 72 65 61 64 20 66 72 essfully read fr
15e60 6f 6d 20 74 68 65 20 28 73 75 62 2d 29 6a 6f 75 om the (sub-)jou
15e70 72 6e 61 6c 20 66 69 6c 65 0a 2a 2a 20 61 6e 64 rnal file.** and
15e80 20 70 6c 61 79 65 64 20 62 61 63 6b 2c 20 74 68 played back, th
15e90 65 6e 20 53 51 4c 49 54 45 5f 4f 4b 20 69 73 20 en SQLITE_OK is
15ea0 72 65 74 75 72 6e 65 64 2e 20 49 66 20 61 6e 20 returned. If an
15eb0 49 4f 20 65 72 72 6f 72 20 6f 63 63 75 72 73 0a IO error occurs.
15ec0 2a 2a 20 77 68 69 6c 65 20 72 65 61 64 69 6e 67 ** while reading
15ed0 20 74 68 65 20 72 65 63 6f 72 64 20 66 72 6f 6d the record from
15ee0 20 74 68 65 20 28 73 75 62 2d 29 6a 6f 75 72 6e the (sub-)journ
15ef0 61 6c 20 66 69 6c 65 20 6f 72 20 77 68 69 6c 65 al file or while
15f00 20 77 72 69 74 69 6e 67 0a 2a 2a 20 74 6f 20 74 writing.** to t
15f10 68 65 20 64 61 74 61 62 61 73 65 20 66 69 6c 65 he database file
15f20 2c 20 74 68 65 6e 20 74 68 65 20 49 4f 20 65 72 , then the IO er
15f30 72 6f 72 20 63 6f 64 65 20 69 73 20 72 65 74 75 ror code is retu
15f40 72 6e 65 64 2e 20 49 66 20 64 61 74 61 0a 2a 2a rned. If data.**
15f50 20 69 73 20 73 75 63 63 65 73 73 66 75 6c 6c 79 is successfully
15f60 20 72 65 61 64 20 66 72 6f 6d 20 74 68 65 20 28 read from the (
15f70 73 75 62 2d 29 6a 6f 75 72 6e 61 6c 20 66 69 6c sub-)journal fil
15f80 65 20 62 75 74 20 61 70 70 65 61 72 73 20 74 6f e but appears to
15f90 20 62 65 0a 2a 2a 20 63 6f 72 72 75 70 74 65 64 be.** corrupted
15fa0 2c 20 53 51 4c 49 54 45 5f 44 4f 4e 45 20 69 73 , SQLITE_DONE is
15fb0 20 72 65 74 75 72 6e 65 64 2e 20 44 61 74 61 20 returned. Data
15fc0 69 73 20 63 6f 6e 73 69 64 65 72 65 64 20 63 6f is considered co
15fd0 72 72 75 70 74 65 64 20 69 6e 0a 2a 2a 20 74 77 rrupted in.** tw
15fe0 6f 20 63 69 72 63 75 6d 73 74 61 6e 63 65 73 3a o circumstances:
15ff0 0a 2a 2a 20 0a 2a 2a 20 20 20 2a 20 49 66 20 74 .** .** * If t
16000 68 65 20 72 65 63 6f 72 64 20 70 61 67 65 2d 6e he record page-n
16010 75 6d 62 65 72 20 69 73 20 69 6c 6c 65 67 61 6c umber is illegal
16020 20 28 30 20 6f 72 20 50 41 47 45 52 5f 4d 4a 5f (0 or PAGER_MJ_
16030 50 47 4e 4f 29 2c 20 6f 72 0a 2a 2a 20 20 20 2a PGNO), or.** *
16040 20 49 66 20 74 68 65 20 72 65 63 6f 72 64 20 69 If the record i
16050 73 20 62 65 69 6e 67 20 72 6f 6c 6c 65 64 20 62 s being rolled b
16060 61 63 6b 20 66 72 6f 6d 20 74 68 65 20 6d 61 69 ack from the mai
16070 6e 20 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 0a 2a n journal file.*
16080 2a 20 20 20 20 20 61 6e 64 20 74 68 65 20 63 68 * and the ch
16090 65 63 6b 73 75 6d 20 66 69 65 6c 64 20 64 6f 65 ecksum field doe
160a0 73 20 6e 6f 74 20 6d 61 74 63 68 20 74 68 65 20 s not match the
160b0 72 65 63 6f 72 64 20 63 6f 6e 74 65 6e 74 2e 0a record content..
160c0 2a 2a 0a 2a 2a 20 4e 65 69 74 68 65 72 20 6f 66 **.** Neither of
160d0 20 74 68 65 73 65 20 74 77 6f 20 73 63 65 6e 61 these two scena
160e0 72 69 6f 73 20 61 72 65 20 70 6f 73 73 69 62 6c rios are possibl
160f0 65 20 64 75 72 69 6e 67 20 61 20 73 61 76 65 70 e during a savep
16100 6f 69 6e 74 20 72 6f 6c 6c 62 61 63 6b 2e 0a 2a oint rollback..*
16110 2a 0a 2a 2a 20 49 66 20 74 68 69 73 20 69 73 20 *.** If this is
16120 61 20 73 61 76 65 70 6f 69 6e 74 20 72 6f 6c 6c a savepoint roll
16130 62 61 63 6b 2c 20 74 68 65 6e 20 6d 65 6d 6f 72 back, then memor
16140 79 20 6d 61 79 20 68 61 76 65 20 74 6f 20 62 65 y may have to be
16150 20 64 79 6e 61 6d 69 63 61 6c 6c 79 0a 2a 2a 20 dynamically.**
16160 61 6c 6c 6f 63 61 74 65 64 20 62 79 20 74 68 69 allocated by thi
16170 73 20 66 75 6e 63 74 69 6f 6e 2e 20 49 66 20 74 s function. If t
16180 68 69 73 20 69 73 20 74 68 65 20 63 61 73 65 20 his is the case
16190 61 6e 64 20 61 6e 20 61 6c 6c 6f 63 61 74 69 6f and an allocatio
161a0 6e 20 66 61 69 6c 73 2c 0a 2a 2a 20 53 51 4c 49 n fails,.** SQLI
161b0 54 45 5f 4e 4f 4d 45 4d 20 69 73 20 72 65 74 75 TE_NOMEM is retu
161c0 72 6e 65 64 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 rned..*/.static
161d0 69 6e 74 20 70 61 67 65 72 5f 70 6c 61 79 62 61 int pager_playba
161e0 63 6b 5f 6f 6e 65 5f 70 61 67 65 28 0a 20 20 50 ck_one_page(. P
161f0 61 67 65 72 20 2a 70 50 61 67 65 72 2c 20 20 20 ager *pPager,
16200 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 /*
16210 54 68 65 20 70 61 67 65 72 20 62 65 69 6e 67 20 The pager being
16220 70 6c 61 79 65 64 20 62 61 63 6b 20 2a 2f 0a 20 played back */.
16230 20 69 36 34 20 2a 70 4f 66 66 73 65 74 2c 20 20 i64 *pOffset,
16240 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f /
16250 2a 20 4f 66 66 73 65 74 20 6f 66 20 72 65 63 6f * Offset of reco
16260 72 64 20 74 6f 20 70 6c 61 79 62 61 63 6b 20 2a rd to playback *
16270 2f 0a 20 20 42 69 74 76 65 63 20 2a 70 44 6f 6e /. Bitvec *pDon
16280 65 2c 20 20 20 20 20 20 20 20 20 20 20 20 20 20 e,
16290 20 20 2f 2a 20 42 69 74 76 65 63 20 6f 66 20 70 /* Bitvec of p
162a0 61 67 65 73 20 61 6c 72 65 61 64 79 20 70 6c 61 ages already pla
162b0 79 65 64 20 62 61 63 6b 20 2a 2f 0a 20 20 69 6e yed back */. in
162c0 74 20 69 73 4d 61 69 6e 4a 72 6e 6c 2c 20 20 20 t isMainJrnl,
162d0 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 31 /* 1
162e0 20 2d 3e 20 6d 61 69 6e 20 6a 6f 75 72 6e 61 6c -> main journal
162f0 2e 20 30 20 2d 3e 20 73 75 62 2d 6a 6f 75 72 6e . 0 -> sub-journ
16300 61 6c 2e 20 2a 2f 0a 20 20 69 6e 74 20 69 73 53 al. */. int isS
16310 61 76 65 70 6e 74 20 20 20 20 20 20 20 20 20 20 avepnt
16320 20 20 20 20 20 20 20 2f 2a 20 54 72 75 65 20 66 /* True f
16330 6f 72 20 61 20 73 61 76 65 70 6f 69 6e 74 20 72 or a savepoint r
16340 6f 6c 6c 62 61 63 6b 20 2a 2f 0a 29 7b 0a 20 20 ollback */.){.
16350 69 6e 74 20 72 63 3b 0a 20 20 50 67 48 64 72 20 int rc;. PgHdr
16360 2a 70 50 67 3b 20 20 20 20 20 20 20 20 20 20 20 *pPg;
16370 20 20 20 20 20 20 20 20 2f 2a 20 41 6e 20 65 78 /* An ex
16380 69 73 74 69 6e 67 20 70 61 67 65 20 69 6e 20 74 isting page in t
16390 68 65 20 63 61 63 68 65 20 2a 2f 0a 20 20 50 67 he cache */. Pg
163a0 6e 6f 20 70 67 6e 6f 3b 20 20 20 20 20 20 20 20 no pgno;
163b0 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 54 /* T
163c0 68 65 20 70 61 67 65 20 6e 75 6d 62 65 72 20 6f he page number o
163d0 66 20 61 20 70 61 67 65 20 69 6e 20 6a 6f 75 72 f a page in jour
163e0 6e 61 6c 20 2a 2f 0a 20 20 75 33 32 20 63 6b 73 nal */. u32 cks
163f0 75 6d 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 um;
16400 20 20 20 20 20 20 20 2f 2a 20 43 68 65 63 6b 73 /* Checks
16410 75 6d 20 75 73 65 64 20 66 6f 72 20 73 61 6e 69 um used for sani
16420 74 79 20 63 68 65 63 6b 69 6e 67 20 2a 2f 0a 20 ty checking */.
16430 20 63 68 61 72 20 2a 61 44 61 74 61 3b 20 20 20 char *aData;
16440 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f /
16450 2a 20 54 65 6d 70 6f 72 61 72 79 20 73 74 6f 72 * Temporary stor
16460 61 67 65 20 66 6f 72 20 74 68 65 20 70 61 67 65 age for the page
16470 20 2a 2f 0a 20 20 73 71 6c 69 74 65 33 5f 66 69 */. sqlite3_fi
16480 6c 65 20 2a 6a 66 64 3b 20 20 20 20 20 20 20 20 le *jfd;
16490 20 20 20 20 2f 2a 20 54 68 65 20 66 69 6c 65 20 /* The file
164a0 64 65 73 63 72 69 70 74 6f 72 20 66 6f 72 20 74 descriptor for t
164b0 68 65 20 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 20 he journal file
164c0 2a 2f 0a 20 20 69 6e 74 20 69 73 53 79 6e 63 65 */. int isSynce
164d0 64 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 d;
164e0 20 20 20 2f 2a 20 54 72 75 65 20 69 66 20 6a 6f /* True if jo
164f0 75 72 6e 61 6c 20 70 61 67 65 20 69 73 20 73 79 urnal page is sy
16500 6e 63 65 64 20 2a 2f 0a 0a 20 20 61 73 73 65 72 nced */.. asser
16510 74 28 20 28 69 73 4d 61 69 6e 4a 72 6e 6c 26 7e t( (isMainJrnl&~
16520 31 29 3d 3d 30 20 29 3b 20 20 20 20 20 20 2f 2a 1)==0 ); /*
16530 20 69 73 4d 61 69 6e 4a 72 6e 6c 20 69 73 20 30 isMainJrnl is 0
16540 20 6f 72 20 31 20 2a 2f 0a 20 20 61 73 73 65 72 or 1 */. asser
16550 74 28 20 28 69 73 53 61 76 65 70 6e 74 26 7e 31 t( (isSavepnt&~1
16560 29 3d 3d 30 20 29 3b 20 20 20 20 20 20 20 2f 2a )==0 ); /*
16570 20 69 73 53 61 76 65 70 6e 74 20 69 73 20 30 20 isSavepnt is 0
16580 6f 72 20 31 20 2a 2f 0a 20 20 61 73 73 65 72 74 or 1 */. assert
16590 28 20 69 73 4d 61 69 6e 4a 72 6e 6c 20 7c 7c 20 ( isMainJrnl ||
165a0 70 44 6f 6e 65 20 29 3b 20 20 20 20 20 2f 2a 20 pDone ); /*
165b0 70 44 6f 6e 65 20 61 6c 77 61 79 73 20 75 73 65 pDone always use
165c0 64 20 6f 6e 20 73 75 62 2d 6a 6f 75 72 6e 61 6c d on sub-journal
165d0 73 20 2a 2f 0a 20 20 61 73 73 65 72 74 28 20 69 s */. assert( i
165e0 73 53 61 76 65 70 6e 74 20 7c 7c 20 70 44 6f 6e sSavepnt || pDon
165f0 65 3d 3d 30 20 29 3b 20 20 20 2f 2a 20 70 44 6f e==0 ); /* pDo
16600 6e 65 20 6e 65 76 65 72 20 75 73 65 64 20 6f 6e ne never used on
16610 20 6e 6f 6e 2d 73 61 76 65 70 6f 69 6e 74 20 2a non-savepoint *
16620 2f 0a 0a 20 20 61 44 61 74 61 20 3d 20 70 50 61 /.. aData = pPa
16630 67 65 72 2d 3e 70 54 6d 70 53 70 61 63 65 3b 0a ger->pTmpSpace;.
16640 20 20 61 73 73 65 72 74 28 20 61 44 61 74 61 20 assert( aData
16650 29 3b 20 20 20 20 20 20 20 20 20 2f 2a 20 54 65 ); /* Te
16660 6d 70 20 73 74 6f 72 61 67 65 20 6d 75 73 74 20 mp storage must
16670 68 61 76 65 20 61 6c 72 65 61 64 79 20 62 65 65 have already bee
16680 6e 20 61 6c 6c 6f 63 61 74 65 64 20 2a 2f 0a 20 n allocated */.
16690 20 61 73 73 65 72 74 28 20 70 61 67 65 72 55 73 assert( pagerUs
166a0 65 57 61 6c 28 70 50 61 67 65 72 29 3d 3d 30 20 eWal(pPager)==0
166b0 7c 7c 20 28 21 69 73 4d 61 69 6e 4a 72 6e 6c 20 || (!isMainJrnl
166c0 26 26 20 69 73 53 61 76 65 70 6e 74 29 20 29 3b && isSavepnt) );
166d0 0a 0a 20 20 2f 2a 20 45 69 74 68 65 72 20 74 68 .. /* Either th
166e0 65 20 73 74 61 74 65 20 69 73 20 67 72 65 61 74 e state is great
166f0 65 72 20 74 68 61 6e 20 50 41 47 45 52 5f 57 52 er than PAGER_WR
16700 49 54 45 52 5f 43 41 43 48 45 4d 4f 44 20 28 61 ITER_CACHEMOD (a
16710 20 74 72 61 6e 73 61 63 74 69 6f 6e 20 0a 20 20 transaction .
16720 2a 2a 20 6f 72 20 73 61 76 65 70 6f 69 6e 74 20 ** or savepoint
16730 72 6f 6c 6c 62 61 63 6b 20 64 6f 6e 65 20 61 74 rollback done at
16740 20 74 68 65 20 72 65 71 75 65 73 74 20 6f 66 20 the request of
16750 74 68 65 20 63 61 6c 6c 65 72 29 20 6f 72 20 74 the caller) or t
16760 68 69 73 20 69 73 0a 20 20 2a 2a 20 61 20 68 6f his is. ** a ho
16770 74 2d 6a 6f 75 72 6e 61 6c 20 72 6f 6c 6c 62 61 t-journal rollba
16780 63 6b 2e 20 49 66 20 69 74 20 69 73 20 61 20 68 ck. If it is a h
16790 6f 74 2d 6a 6f 75 72 6e 61 6c 20 72 6f 6c 6c 62 ot-journal rollb
167a0 61 63 6b 2c 20 74 68 65 20 70 61 67 65 72 0a 20 ack, the pager.
167b0 20 2a 2a 20 69 73 20 69 6e 20 73 74 61 74 65 20 ** is in state
167c0 4f 50 45 4e 20 61 6e 64 20 68 6f 6c 64 73 20 61 OPEN and holds a
167d0 6e 20 45 58 43 4c 55 53 49 56 45 20 6c 6f 63 6b n EXCLUSIVE lock
167e0 2e 20 48 6f 74 2d 6a 6f 75 72 6e 61 6c 20 72 6f . Hot-journal ro
167f0 6c 6c 62 61 63 6b 0a 20 20 2a 2a 20 6f 6e 6c 79 llback. ** only
16800 20 72 65 61 64 73 20 66 72 6f 6d 20 74 68 65 20 reads from the
16810 6d 61 69 6e 20 6a 6f 75 72 6e 61 6c 2c 20 6e 6f main journal, no
16820 74 20 74 68 65 20 73 75 62 2d 6a 6f 75 72 6e 61 t the sub-journa
16830 6c 2e 0a 20 20 2a 2f 0a 20 20 61 73 73 65 72 74 l.. */. assert
16840 28 20 70 50 61 67 65 72 2d 3e 65 53 74 61 74 65 ( pPager->eState
16850 3e 3d 50 41 47 45 52 5f 57 52 49 54 45 52 5f 43 >=PAGER_WRITER_C
16860 41 43 48 45 4d 4f 44 0a 20 20 20 20 20 20 20 7c ACHEMOD. |
16870 7c 20 28 70 50 61 67 65 72 2d 3e 65 53 74 61 74 | (pPager->eStat
16880 65 3d 3d 50 41 47 45 52 5f 4f 50 45 4e 20 26 26 e==PAGER_OPEN &&
16890 20 70 50 61 67 65 72 2d 3e 65 4c 6f 63 6b 3d 3d pPager->eLock==
168a0 45 58 43 4c 55 53 49 56 45 5f 4c 4f 43 4b 29 0a EXCLUSIVE_LOCK).
168b0 20 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 70 );. assert( p
168c0 50 61 67 65 72 2d 3e 65 53 74 61 74 65 3e 3d 50 Pager->eState>=P
168d0 41 47 45 52 5f 57 52 49 54 45 52 5f 43 41 43 48 AGER_WRITER_CACH
168e0 45 4d 4f 44 20 7c 7c 20 69 73 4d 61 69 6e 4a 72 EMOD || isMainJr
168f0 6e 6c 20 29 3b 0a 0a 20 20 2f 2a 20 52 65 61 64 nl );.. /* Read
16900 20 74 68 65 20 70 61 67 65 20 6e 75 6d 62 65 72 the page number
16910 20 61 6e 64 20 70 61 67 65 20 64 61 74 61 20 66 and page data f
16920 72 6f 6d 20 74 68 65 20 6a 6f 75 72 6e 61 6c 20 rom the journal
16930 6f 72 20 73 75 62 2d 6a 6f 75 72 6e 61 6c 0a 20 or sub-journal.
16940 20 2a 2a 20 66 69 6c 65 2e 20 52 65 74 75 72 6e ** file. Return
16950 20 61 6e 20 65 72 72 6f 72 20 63 6f 64 65 20 74 an error code t
16960 6f 20 74 68 65 20 63 61 6c 6c 65 72 20 69 66 20 o the caller if
16970 61 6e 20 49 4f 20 65 72 72 6f 72 20 6f 63 63 75 an IO error occu
16980 72 73 2e 0a 20 20 2a 2f 0a 20 20 6a 66 64 20 3d rs.. */. jfd =
16990 20 69 73 4d 61 69 6e 4a 72 6e 6c 20 3f 20 70 50 isMainJrnl ? pP
169a0 61 67 65 72 2d 3e 6a 66 64 20 3a 20 70 50 61 67 ager->jfd : pPag
169b0 65 72 2d 3e 73 6a 66 64 3b 0a 20 20 72 63 20 3d er->sjfd;. rc =
169c0 20 72 65 61 64 33 32 62 69 74 73 28 6a 66 64 2c read32bits(jfd,
169d0 20 2a 70 4f 66 66 73 65 74 2c 20 26 70 67 6e 6f *pOffset, &pgno
169e0 29 3b 0a 20 20 69 66 28 20 72 63 21 3d 53 51 4c );. if( rc!=SQL
169f0 49 54 45 5f 4f 4b 20 29 20 72 65 74 75 72 6e 20 ITE_OK ) return
16a00 72 63 3b 0a 20 20 72 63 20 3d 20 73 71 6c 69 74 rc;. rc = sqlit
16a10 65 33 4f 73 52 65 61 64 28 6a 66 64 2c 20 28 75 e3OsRead(jfd, (u
16a20 38 2a 29 61 44 61 74 61 2c 20 70 50 61 67 65 72 8*)aData, pPager
16a30 2d 3e 70 61 67 65 53 69 7a 65 2c 20 28 2a 70 4f ->pageSize, (*pO
16a40 66 66 73 65 74 29 2b 34 29 3b 0a 20 20 69 66 28 ffset)+4);. if(
16a50 20 72 63 21 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 rc!=SQLITE_OK )
16a60 20 72 65 74 75 72 6e 20 72 63 3b 0a 20 20 2a 70 return rc;. *p
16a70 4f 66 66 73 65 74 20 2b 3d 20 70 50 61 67 65 72 Offset += pPager
16a80 2d 3e 70 61 67 65 53 69 7a 65 20 2b 20 34 20 2b ->pageSize + 4 +
16a90 20 69 73 4d 61 69 6e 4a 72 6e 6c 2a 34 3b 0a 0a isMainJrnl*4;..
16aa0 20 20 2f 2a 20 53 61 6e 69 74 79 20 63 68 65 63 /* Sanity chec
16ab0 6b 69 6e 67 20 6f 6e 20 74 68 65 20 70 61 67 65 king on the page
16ac0 2e 20 20 54 68 69 73 20 69 73 20 6d 6f 72 65 20 . This is more
16ad0 69 6d 70 6f 72 74 61 6e 74 20 74 68 61 74 20 49 important that I
16ae0 20 6f 72 69 67 69 6e 61 6c 6c 79 0a 20 20 2a 2a originally. **
16af0 20 74 68 6f 75 67 68 74 2e 20 20 49 66 20 61 20 thought. If a
16b00 70 6f 77 65 72 20 66 61 69 6c 75 72 65 20 6f 63 power failure oc
16b10 63 75 72 73 20 77 68 69 6c 65 20 74 68 65 20 6a curs while the j
16b20 6f 75 72 6e 61 6c 20 69 73 20 62 65 69 6e 67 20 ournal is being
16b30 77 72 69 74 74 65 6e 2c 0a 20 20 2a 2a 20 69 74 written,. ** it
16b40 20 63 6f 75 6c 64 20 63 61 75 73 65 20 69 6e 76 could cause inv
16b50 61 6c 69 64 20 64 61 74 61 20 74 6f 20 62 65 20 alid data to be
16b60 77 72 69 74 74 65 6e 20 69 6e 74 6f 20 74 68 65 written into the
16b70 20 6a 6f 75 72 6e 61 6c 2e 20 20 57 65 20 6e 65 journal. We ne
16b80 65 64 20 74 6f 0a 20 20 2a 2a 20 64 65 74 65 63 ed to. ** detec
16b90 74 20 74 68 69 73 20 69 6e 76 61 6c 69 64 20 64 t this invalid d
16ba0 61 74 61 20 28 77 69 74 68 20 68 69 67 68 20 70 ata (with high p
16bb0 72 6f 62 61 62 69 6c 69 74 79 29 20 61 6e 64 20 robability) and
16bc0 69 67 6e 6f 72 65 20 69 74 2e 0a 20 20 2a 2f 0a ignore it.. */.
16bd0 20 20 69 66 28 20 70 67 6e 6f 3d 3d 30 20 7c 7c if( pgno==0 ||
16be0 20 70 67 6e 6f 3d 3d 50 41 47 45 52 5f 4d 4a 5f pgno==PAGER_MJ_
16bf0 50 47 4e 4f 28 70 50 61 67 65 72 29 20 29 7b 0a PGNO(pPager) ){.
16c00 20 20 20 20 61 73 73 65 72 74 28 20 21 69 73 53 assert( !isS
16c10 61 76 65 70 6e 74 20 29 3b 0a 20 20 20 20 72 65 avepnt );. re
16c20 74 75 72 6e 20 53 51 4c 49 54 45 5f 44 4f 4e 45 turn SQLITE_DONE
16c30 3b 0a 20 20 7d 0a 20 20 69 66 28 20 70 67 6e 6f ;. }. if( pgno
16c40 3e 28 50 67 6e 6f 29 70 50 61 67 65 72 2d 3e 64 >(Pgno)pPager->d
16c50 62 53 69 7a 65 20 7c 7c 20 73 71 6c 69 74 65 33 bSize || sqlite3
16c60 42 69 74 76 65 63 54 65 73 74 28 70 44 6f 6e 65 BitvecTest(pDone
16c70 2c 20 70 67 6e 6f 29 20 29 7b 0a 20 20 20 20 72 , pgno) ){. r
16c80 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b eturn SQLITE_OK;
16c90 0a 20 20 7d 0a 20 20 69 66 28 20 69 73 4d 61 69 . }. if( isMai
16ca0 6e 4a 72 6e 6c 20 29 7b 0a 20 20 20 20 72 63 20 nJrnl ){. rc
16cb0 3d 20 72 65 61 64 33 32 62 69 74 73 28 6a 66 64 = read32bits(jfd
16cc0 2c 20 28 2a 70 4f 66 66 73 65 74 29 2d 34 2c 20 , (*pOffset)-4,
16cd0 26 63 6b 73 75 6d 29 3b 0a 20 20 20 20 69 66 28 &cksum);. if(
16ce0 20 72 63 20 29 20 72 65 74 75 72 6e 20 72 63 3b rc ) return rc;
16cf0 0a 20 20 20 20 69 66 28 20 21 69 73 53 61 76 65 . if( !isSave
16d00 70 6e 74 20 26 26 20 70 61 67 65 72 5f 63 6b 73 pnt && pager_cks
16d10 75 6d 28 70 50 61 67 65 72 2c 20 28 75 38 2a 29 um(pPager, (u8*)
16d20 61 44 61 74 61 29 21 3d 63 6b 73 75 6d 20 29 7b aData)!=cksum ){
16d30 0a 20 20 20 20 20 20 72 65 74 75 72 6e 20 53 51 . return SQ
16d40 4c 49 54 45 5f 44 4f 4e 45 3b 0a 20 20 20 20 7d LITE_DONE;. }
16d50 0a 20 20 7d 0a 0a 20 20 2f 2a 20 49 66 20 74 68 . }.. /* If th
16d60 69 73 20 70 61 67 65 20 68 61 73 20 61 6c 72 65 is page has alre
16d70 61 64 79 20 62 65 65 6e 20 70 6c 61 79 65 64 20 ady been played
16d80 62 61 63 6b 20 62 65 66 6f 72 65 20 64 75 72 69 back before duri
16d90 6e 67 20 74 68 65 20 63 75 72 72 65 6e 74 0a 20 ng the current.
16da0 20 2a 2a 20 72 6f 6c 6c 62 61 63 6b 2c 20 74 68 ** rollback, th
16db0 65 6e 20 64 6f 6e 27 74 20 62 6f 74 68 65 72 20 en don't bother
16dc0 74 6f 20 70 6c 61 79 20 69 74 20 62 61 63 6b 20 to play it back
16dd0 61 67 61 69 6e 2e 0a 20 20 2a 2f 0a 20 20 69 66 again.. */. if
16de0 28 20 70 44 6f 6e 65 20 26 26 20 28 72 63 20 3d ( pDone && (rc =
16df0 20 73 71 6c 69 74 65 33 42 69 74 76 65 63 53 65 sqlite3BitvecSe
16e00 74 28 70 44 6f 6e 65 2c 20 70 67 6e 6f 29 29 21 t(pDone, pgno))!
16e10 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 =SQLITE_OK ){.
16e20 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 20 20 7d return rc;. }
16e30 0a 0a 20 20 2f 2a 20 57 68 65 6e 20 70 6c 61 79 .. /* When play
16e40 69 6e 67 20 62 61 63 6b 20 70 61 67 65 20 31 2c ing back page 1,
16e50 20 72 65 73 74 6f 72 65 20 74 68 65 20 6e 52 65 restore the nRe
16e60 73 65 72 76 65 20 73 65 74 74 69 6e 67 0a 20 20 serve setting.
16e70 2a 2f 0a 20 20 69 66 28 20 70 67 6e 6f 3d 3d 31 */. if( pgno==1
16e80 20 26 26 20 70 50 61 67 65 72 2d 3e 6e 52 65 73 && pPager->nRes
16e90 65 72 76 65 21 3d 28 28 75 38 2a 29 61 44 61 74 erve!=((u8*)aDat
16ea0 61 29 5b 32 30 5d 20 29 7b 0a 20 20 20 20 70 50 a)[20] ){. pP
16eb0 61 67 65 72 2d 3e 6e 52 65 73 65 72 76 65 20 3d ager->nReserve =
16ec0 20 28 28 75 38 2a 29 61 44 61 74 61 29 5b 32 30 ((u8*)aData)[20
16ed0 5d 3b 0a 20 20 20 20 70 61 67 65 72 52 65 70 6f ];. pagerRepo
16ee0 72 74 53 69 7a 65 28 70 50 61 67 65 72 29 3b 0a rtSize(pPager);.
16ef0 20 20 7d 0a 0a 20 20 2f 2a 20 49 66 20 74 68 65 }.. /* If the
16f00 20 70 61 67 65 72 20 69 73 20 69 6e 20 43 41 43 pager is in CAC
16f10 48 45 4d 4f 44 20 73 74 61 74 65 2c 20 74 68 65 HEMOD state, the
16f20 6e 20 74 68 65 72 65 20 6d 75 73 74 20 62 65 20 n there must be
16f30 61 20 63 6f 70 79 20 6f 66 20 74 68 69 73 0a 20 a copy of this.
16f40 20 2a 2a 20 70 61 67 65 20 69 6e 20 74 68 65 20 ** page in the
16f50 70 61 67 65 72 20 63 61 63 68 65 2e 20 49 6e 20 pager cache. In
16f60 74 68 69 73 20 63 61 73 65 20 6a 75 73 74 20 75 this case just u
16f70 70 64 61 74 65 20 74 68 65 20 70 61 67 65 72 20 pdate the pager
16f80 63 61 63 68 65 2c 0a 20 20 2a 2a 20 6e 6f 74 20 cache,. ** not
16f90 74 68 65 20 64 61 74 61 62 61 73 65 20 66 69 6c the database fil
16fa0 65 2e 20 54 68 65 20 70 61 67 65 20 69 73 20 6c e. The page is l
16fb0 65 66 74 20 6d 61 72 6b 65 64 20 64 69 72 74 79 eft marked dirty
16fc0 20 69 6e 20 74 68 69 73 20 63 61 73 65 2e 0a 20 in this case..
16fd0 20 2a 2a 0a 20 20 2a 2a 20 41 6e 20 65 78 63 65 **. ** An exce
16fe0 70 74 69 6f 6e 20 74 6f 20 74 68 65 20 61 62 6f ption to the abo
16ff0 76 65 20 72 75 6c 65 3a 20 49 66 20 74 68 65 20 ve rule: If the
17000 64 61 74 61 62 61 73 65 20 69 73 20 69 6e 20 6e database is in n
17010 6f 2d 73 79 6e 63 20 6d 6f 64 65 0a 20 20 2a 2a o-sync mode. **
17020 20 61 6e 64 20 61 20 70 61 67 65 20 69 73 20 6d and a page is m
17030 6f 76 65 64 20 64 75 72 69 6e 67 20 61 6e 20 69 oved during an i
17040 6e 63 72 65 6d 65 6e 74 61 6c 20 76 61 63 75 75 ncremental vacuu
17050 6d 20 74 68 65 6e 20 74 68 65 20 70 61 67 65 20 m then the page
17060 6d 61 79 0a 20 20 2a 2a 20 6e 6f 74 20 62 65 20 may. ** not be
17070 69 6e 20 74 68 65 20 70 61 67 65 72 20 63 61 63 in the pager cac
17080 68 65 2e 20 4c 61 74 65 72 3a 20 69 66 20 61 20 he. Later: if a
17090 6d 61 6c 6c 6f 63 28 29 20 6f 72 20 49 4f 20 65 malloc() or IO e
170a0 72 72 6f 72 20 6f 63 63 75 72 73 0a 20 20 2a 2a rror occurs. **
170b0 20 64 75 72 69 6e 67 20 61 20 4d 6f 76 65 70 61 during a Movepa
170c0 67 65 28 29 20 63 61 6c 6c 2c 20 74 68 65 6e 20 ge() call, then
170d0 74 68 65 20 70 61 67 65 20 6d 61 79 20 6e 6f 74 the page may not
170e0 20 62 65 20 69 6e 20 74 68 65 20 63 61 63 68 65 be in the cache
170f0 0a 20 20 2a 2a 20 65 69 74 68 65 72 2e 20 53 6f . ** either. So
17100 20 74 68 65 20 63 6f 6e 64 69 74 69 6f 6e 20 64 the condition d
17110 65 73 63 72 69 62 65 64 20 69 6e 20 74 68 65 20 escribed in the
17120 61 62 6f 76 65 20 70 61 72 61 67 72 61 70 68 20 above paragraph
17130 69 73 20 6e 6f 74 0a 20 20 2a 2a 20 61 73 73 65 is not. ** asse
17140 72 74 28 29 61 62 6c 65 2e 0a 20 20 2a 2a 0a 20 rt()able.. **.
17150 20 2a 2a 20 49 66 20 69 6e 20 57 52 49 54 45 52 ** If in WRITER
17160 5f 44 42 4d 4f 44 2c 20 57 52 49 54 45 52 5f 46 _DBMOD, WRITER_F
17170 49 4e 49 53 48 45 44 20 6f 72 20 4f 50 45 4e 20 INISHED or OPEN
17180 73 74 61 74 65 2c 20 74 68 65 6e 20 77 65 20 75 state, then we u
17190 70 64 61 74 65 20 74 68 65 0a 20 20 2a 2a 20 70 pdate the. ** p
171a0 61 67 65 72 20 63 61 63 68 65 20 69 66 20 69 74 ager cache if it
171b0 20 65 78 69 73 74 73 20 61 6e 64 20 74 68 65 20 exists and the
171c0 6d 61 69 6e 20 66 69 6c 65 2e 20 54 68 65 20 70 main file. The p
171d0 61 67 65 20 69 73 20 74 68 65 6e 20 6d 61 72 6b age is then mark
171e0 65 64 20 0a 20 20 2a 2a 20 6e 6f 74 20 64 69 72 ed . ** not dir
171f0 74 79 2e 20 53 69 6e 63 65 20 74 68 69 73 20 63 ty. Since this c
17200 6f 64 65 20 69 73 20 6f 6e 6c 79 20 65 78 65 63 ode is only exec
17210 75 74 65 64 20 69 6e 20 50 41 47 45 52 5f 4f 50 uted in PAGER_OP
17220 45 4e 20 73 74 61 74 65 20 66 6f 72 0a 20 20 2a EN state for. *
17230 2a 20 61 20 68 6f 74 2d 6a 6f 75 72 6e 61 6c 20 * a hot-journal
17240 72 6f 6c 6c 62 61 63 6b 2c 20 69 74 20 69 73 20 rollback, it is
17250 67 75 61 72 61 6e 74 65 65 64 20 74 68 61 74 20 guaranteed that
17260 74 68 65 20 70 61 67 65 2d 63 61 63 68 65 20 69 the page-cache i
17270 73 20 65 6d 70 74 79 0a 20 20 2a 2a 20 69 66 20 s empty. ** if
17280 74 68 65 20 70 61 67 65 72 20 69 73 20 69 6e 20 the pager is in
17290 4f 50 45 4e 20 73 74 61 74 65 2e 0a 20 20 2a 2a OPEN state.. **
172a0 0a 20 20 2a 2a 20 54 69 63 6b 65 74 20 23 31 31 . ** Ticket #11
172b0 37 31 3a 20 20 54 68 65 20 73 74 61 74 65 6d 65 71: The stateme
172c0 6e 74 20 6a 6f 75 72 6e 61 6c 20 6d 69 67 68 74 nt journal might
172d0 20 63 6f 6e 74 61 69 6e 20 70 61 67 65 20 63 6f contain page co
172e0 6e 74 65 6e 74 20 74 68 61 74 20 69 73 0a 20 20 ntent that is.
172f0 2a 2a 20 64 69 66 66 65 72 65 6e 74 20 66 72 6f ** different fro
17300 6d 20 74 68 65 20 70 61 67 65 20 63 6f 6e 74 65 m the page conte
17310 6e 74 20 61 74 20 74 68 65 20 73 74 61 72 74 20 nt at the start
17320 6f 66 20 74 68 65 20 74 72 61 6e 73 61 63 74 69 of the transacti
17330 6f 6e 2e 0a 20 20 2a 2a 20 54 68 69 73 20 6f 63 on.. ** This oc
17340 63 75 72 73 20 77 68 65 6e 20 61 20 70 61 67 65 curs when a page
17350 20 69 73 20 63 68 61 6e 67 65 64 20 70 72 69 6f is changed prio
17360 72 20 74 6f 20 74 68 65 20 73 74 61 72 74 20 6f r to the start o
17370 66 20 61 20 73 74 61 74 65 6d 65 6e 74 0a 20 20 f a statement.
17380 2a 2a 20 74 68 65 6e 20 63 68 61 6e 67 65 64 20 ** then changed
17390 61 67 61 69 6e 20 77 69 74 68 69 6e 20 74 68 65 again within the
173a0 20 73 74 61 74 65 6d 65 6e 74 2e 20 20 57 68 65 statement. Whe
173b0 6e 20 72 6f 6c 6c 69 6e 67 20 62 61 63 6b 20 73 n rolling back s
173c0 75 63 68 20 61 0a 20 20 2a 2a 20 73 74 61 74 65 uch a. ** state
173d0 6d 65 6e 74 20 77 65 20 6d 75 73 74 20 6e 6f 74 ment we must not
173e0 20 77 72 69 74 65 20 74 6f 20 74 68 65 20 6f 72 write to the or
173f0 69 67 69 6e 61 6c 20 64 61 74 61 62 61 73 65 20 iginal database
17400 75 6e 6c 65 73 73 20 77 65 20 6b 6e 6f 77 0a 20 unless we know.
17410 20 2a 2a 20 66 6f 72 20 63 65 72 74 61 69 6e 20 ** for certain
17420 74 68 61 74 20 6f 72 69 67 69 6e 61 6c 20 70 61 that original pa
17430 67 65 20 63 6f 6e 74 65 6e 74 73 20 61 72 65 20 ge contents are
17440 73 79 6e 63 65 64 20 69 6e 74 6f 20 74 68 65 20 synced into the
17450 6d 61 69 6e 20 72 6f 6c 6c 62 61 63 6b 0a 20 20 main rollback.
17460 2a 2a 20 6a 6f 75 72 6e 61 6c 2e 20 20 4f 74 68 ** journal. Oth
17470 65 72 77 69 73 65 2c 20 61 20 70 6f 77 65 72 20 erwise, a power
17480 6c 6f 73 73 20 6d 69 67 68 74 20 6c 65 61 76 65 loss might leave
17490 20 6d 6f 64 69 66 69 65 64 20 64 61 74 61 20 69 modified data i
174a0 6e 20 74 68 65 0a 20 20 2a 2a 20 64 61 74 61 62 n the. ** datab
174b0 61 73 65 20 66 69 6c 65 20 77 69 74 68 6f 75 74 ase file without
174c0 20 61 6e 20 65 6e 74 72 79 20 69 6e 20 74 68 65 an entry in the
174d0 20 72 6f 6c 6c 62 61 63 6b 20 6a 6f 75 72 6e 61 rollback journa
174e0 6c 20 74 68 61 74 20 63 61 6e 0a 20 20 2a 2a 20 l that can. **
174f0 72 65 73 74 6f 72 65 20 74 68 65 20 64 61 74 61 restore the data
17500 62 61 73 65 20 74 6f 20 69 74 73 20 6f 72 69 67 base to its orig
17510 69 6e 61 6c 20 66 6f 72 6d 2e 20 20 54 77 6f 20 inal form. Two
17520 63 6f 6e 64 69 74 69 6f 6e 73 20 6d 75 73 74 20 conditions must
17530 62 65 0a 20 20 2a 2a 20 6d 65 74 20 62 65 66 6f be. ** met befo
17540 72 65 20 77 72 69 74 69 6e 67 20 74 6f 20 74 68 re writing to th
17550 65 20 64 61 74 61 62 61 73 65 20 66 69 6c 65 73 e database files
17560 2e 20 28 31 29 20 74 68 65 20 64 61 74 61 62 61 . (1) the databa
17570 73 65 20 6d 75 73 74 20 62 65 0a 20 20 2a 2a 20 se must be. **
17580 6c 6f 63 6b 65 64 2e 20 20 28 32 29 20 77 65 20 locked. (2) we
17590 6b 6e 6f 77 20 74 68 61 74 20 74 68 65 20 6f 72 know that the or
175a0 69 67 69 6e 61 6c 20 70 61 67 65 20 63 6f 6e 74 iginal page cont
175b0 65 6e 74 20 69 73 20 66 75 6c 6c 79 20 73 79 6e ent is fully syn
175c0 63 65 64 0a 20 20 2a 2a 20 69 6e 20 74 68 65 20 ced. ** in the
175d0 6d 61 69 6e 20 6a 6f 75 72 6e 61 6c 20 65 69 74 main journal eit
175e0 68 65 72 20 62 65 63 61 75 73 65 20 74 68 65 20 her because the
175f0 70 61 67 65 20 69 73 20 6e 6f 74 20 69 6e 20 63 page is not in c
17600 61 63 68 65 20 6f 72 20 65 6c 73 65 0a 20 20 2a ache or else. *
17610 2a 20 74 68 65 20 70 61 67 65 20 69 73 20 6d 61 * the page is ma
17620 72 6b 65 64 20 61 73 20 6e 65 65 64 53 79 6e 63 rked as needSync
17630 3d 3d 30 2e 0a 20 20 2a 2a 0a 20 20 2a 2a 20 32 ==0.. **. ** 2
17640 30 30 38 2d 30 34 2d 31 34 3a 20 20 57 68 65 6e 008-04-14: When
17650 20 61 74 74 65 6d 70 74 69 6e 67 20 74 6f 20 76 attempting to v
17660 61 63 75 75 6d 20 61 20 63 6f 72 72 75 70 74 20 acuum a corrupt
17670 64 61 74 61 62 61 73 65 20 66 69 6c 65 2c 20 69 database file, i
17680 74 0a 20 20 2a 2a 20 69 73 20 70 6f 73 73 69 62 t. ** is possib
17690 6c 65 20 74 6f 20 66 61 69 6c 20 61 20 73 74 61 le to fail a sta
176a0 74 65 6d 65 6e 74 20 6f 6e 20 61 20 64 61 74 61 tement on a data
176b0 62 61 73 65 20 74 68 61 74 20 64 6f 65 73 20 6e base that does n
176c0 6f 74 20 79 65 74 20 65 78 69 73 74 2e 0a 20 20 ot yet exist..
176d0 2a 2a 20 44 6f 20 6e 6f 74 20 61 74 74 65 6d 70 ** Do not attemp
176e0 74 20 74 6f 20 77 72 69 74 65 20 69 66 20 64 61 t to write if da
176f0 74 61 62 61 73 65 20 66 69 6c 65 20 68 61 73 20 tabase file has
17700 6e 65 76 65 72 20 62 65 65 6e 20 6f 70 65 6e 65 never been opene
17710 64 2e 0a 20 20 2a 2f 0a 20 20 69 66 28 20 70 61 d.. */. if( pa
17720 67 65 72 55 73 65 57 61 6c 28 70 50 61 67 65 72 gerUseWal(pPager
17730 29 20 29 7b 0a 20 20 20 20 70 50 67 20 3d 20 30 ) ){. pPg = 0
17740 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 70 ;. }else{. p
17750 50 67 20 3d 20 73 71 6c 69 74 65 33 50 61 67 65 Pg = sqlite3Page
17760 72 4c 6f 6f 6b 75 70 28 70 50 61 67 65 72 2c 20 rLookup(pPager,
17770 70 67 6e 6f 29 3b 0a 20 20 7d 0a 20 20 61 73 73 pgno);. }. ass
17780 65 72 74 28 20 70 50 67 20 7c 7c 20 21 4d 45 4d ert( pPg || !MEM
17790 44 42 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 DB );. assert(
177a0 70 50 61 67 65 72 2d 3e 65 53 74 61 74 65 21 3d pPager->eState!=
177b0 50 41 47 45 52 5f 4f 50 45 4e 20 7c 7c 20 70 50 PAGER_OPEN || pP
177c0 67 3d 3d 30 20 7c 7c 20 70 50 61 67 65 72 2d 3e g==0 || pPager->
177d0 74 65 6d 70 46 69 6c 65 20 29 3b 0a 20 20 50 41 tempFile );. PA
177e0 47 45 52 54 52 41 43 45 28 28 22 50 4c 41 59 42 GERTRACE(("PLAYB
177f0 41 43 4b 20 25 64 20 70 61 67 65 20 25 64 20 68 ACK %d page %d h
17800 61 73 68 28 25 30 38 78 29 20 25 73 5c 6e 22 2c ash(%08x) %s\n",
17810 0a 20 20 20 20 20 20 20 20 20 20 20 50 41 47 45 . PAGE
17820 52 49 44 28 70 50 61 67 65 72 29 2c 20 70 67 6e RID(pPager), pgn
17830 6f 2c 20 70 61 67 65 72 5f 64 61 74 61 68 61 73 o, pager_datahas
17840 68 28 70 50 61 67 65 72 2d 3e 70 61 67 65 53 69 h(pPager->pageSi
17850 7a 65 2c 20 28 75 38 2a 29 61 44 61 74 61 29 2c ze, (u8*)aData),
17860 0a 20 20 20 20 20 20 20 20 20 20 20 28 69 73 4d . (isM
17870 61 69 6e 4a 72 6e 6c 3f 22 6d 61 69 6e 2d 6a 6f ainJrnl?"main-jo
17880 75 72 6e 61 6c 22 3a 22 73 75 62 2d 6a 6f 75 72 urnal":"sub-jour
17890 6e 61 6c 22 29 0a 20 20 29 29 3b 0a 20 20 69 66 nal"). ));. if
178a0 28 20 69 73 4d 61 69 6e 4a 72 6e 6c 20 29 7b 0a ( isMainJrnl ){.
178b0 20 20 20 20 69 73 53 79 6e 63 65 64 20 3d 20 70 isSynced = p
178c0 50 61 67 65 72 2d 3e 6e 6f 53 79 6e 63 20 7c 7c Pager->noSync ||
178d0 20 28 2a 70 4f 66 66 73 65 74 20 3c 3d 20 70 50 (*pOffset <= pP
178e0 61 67 65 72 2d 3e 6a 6f 75 72 6e 61 6c 48 64 72 ager->journalHdr
178f0 29 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 );. }else{.
17900 69 73 53 79 6e 63 65 64 20 3d 20 28 70 50 67 3d isSynced = (pPg=
17910 3d 30 20 7c 7c 20 30 3d 3d 28 70 50 67 2d 3e 66 =0 || 0==(pPg->f
17920 6c 61 67 73 20 26 20 50 47 48 44 52 5f 4e 45 45 lags & PGHDR_NEE
17930 44 5f 53 59 4e 43 29 29 3b 0a 20 20 7d 0a 20 20 D_SYNC));. }.
17940 69 66 28 20 69 73 4f 70 65 6e 28 70 50 61 67 65 if( isOpen(pPage
17950 72 2d 3e 66 64 29 0a 20 20 20 26 26 20 28 70 50 r->fd). && (pP
17960 61 67 65 72 2d 3e 65 53 74 61 74 65 3e 3d 50 41 ager->eState>=PA
17970 47 45 52 5f 57 52 49 54 45 52 5f 44 42 4d 4f 44 GER_WRITER_DBMOD
17980 20 7c 7c 20 70 50 61 67 65 72 2d 3e 65 53 74 61 || pPager->eSta
17990 74 65 3d 3d 50 41 47 45 52 5f 4f 50 45 4e 29 0a te==PAGER_OPEN).
179a0 20 20 20 26 26 20 69 73 53 79 6e 63 65 64 0a 20 && isSynced.
179b0 20 29 7b 0a 20 20 20 20 69 36 34 20 6f 66 73 74 ){. i64 ofst
179c0 20 3d 20 28 70 67 6e 6f 2d 31 29 2a 28 69 36 34 = (pgno-1)*(i64
179d0 29 70 50 61 67 65 72 2d 3e 70 61 67 65 53 69 7a )pPager->pageSiz
179e0 65 3b 0a 20 20 20 20 74 65 73 74 63 61 73 65 28 e;. testcase(
179f0 20 21 69 73 53 61 76 65 70 6e 74 20 26 26 20 70 !isSavepnt && p
17a00 50 67 21 3d 30 20 26 26 20 28 70 50 67 2d 3e 66 Pg!=0 && (pPg->f
17a10 6c 61 67 73 26 50 47 48 44 52 5f 4e 45 45 44 5f lags&PGHDR_NEED_
17a20 53 59 4e 43 29 21 3d 30 20 29 3b 0a 20 20 20 20 SYNC)!=0 );.
17a30 61 73 73 65 72 74 28 20 21 70 61 67 65 72 55 73 assert( !pagerUs
17a40 65 57 61 6c 28 70 50 61 67 65 72 29 20 29 3b 0a eWal(pPager) );.
17a50 20 20 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33 rc = sqlite3
17a60 4f 73 57 72 69 74 65 28 70 50 61 67 65 72 2d 3e OsWrite(pPager->
17a70 66 64 2c 20 28 75 38 20 2a 29 61 44 61 74 61 2c fd, (u8 *)aData,
17a80 20 70 50 61 67 65 72 2d 3e 70 61 67 65 53 69 7a pPager->pageSiz
17a90 65 2c 20 6f 66 73 74 29 3b 0a 20 20 20 20 69 66 e, ofst);. if
17aa0 28 20 70 67 6e 6f 3e 70 50 61 67 65 72 2d 3e 64 ( pgno>pPager->d
17ab0 62 46 69 6c 65 53 69 7a 65 20 29 7b 0a 20 20 20 bFileSize ){.
17ac0 20 20 20 70 50 61 67 65 72 2d 3e 64 62 46 69 6c pPager->dbFil
17ad0 65 53 69 7a 65 20 3d 20 70 67 6e 6f 3b 0a 20 20 eSize = pgno;.
17ae0 20 20 7d 0a 20 20 20 20 69 66 28 20 70 50 61 67 }. if( pPag
17af0 65 72 2d 3e 70 42 61 63 6b 75 70 20 29 7b 0a 20 er->pBackup ){.
17b00 20 20 20 20 20 43 4f 44 45 43 31 28 70 50 61 67 CODEC1(pPag
17b10 65 72 2c 20 61 44 61 74 61 2c 20 70 67 6e 6f 2c er, aData, pgno,
17b20 20 33 2c 20 72 63 3d 53 51 4c 49 54 45 5f 4e 4f 3, rc=SQLITE_NO
17b30 4d 45 4d 5f 42 4b 50 54 29 3b 0a 20 20 20 20 20 MEM_BKPT);.
17b40 20 73 71 6c 69 74 65 33 42 61 63 6b 75 70 55 70 sqlite3BackupUp
17b50 64 61 74 65 28 70 50 61 67 65 72 2d 3e 70 42 61 date(pPager->pBa
17b60 63 6b 75 70 2c 20 70 67 6e 6f 2c 20 28 75 38 2a ckup, pgno, (u8*
17b70 29 61 44 61 74 61 29 3b 0a 20 20 20 20 20 20 43 )aData);. C
17b80 4f 44 45 43 32 28 70 50 61 67 65 72 2c 20 61 44 ODEC2(pPager, aD
17b90 61 74 61 2c 20 70 67 6e 6f 2c 20 37 2c 20 72 63 ata, pgno, 7, rc
17ba0 3d 53 51 4c 49 54 45 5f 4e 4f 4d 45 4d 5f 42 4b =SQLITE_NOMEM_BK
17bb0 50 54 2c 20 61 44 61 74 61 29 3b 0a 20 20 20 20 PT, aData);.
17bc0 7d 0a 20 20 7d 65 6c 73 65 20 69 66 28 20 21 69 }. }else if( !i
17bd0 73 4d 61 69 6e 4a 72 6e 6c 20 26 26 20 70 50 67 sMainJrnl && pPg
17be0 3d 3d 30 20 29 7b 0a 20 20 20 20 2f 2a 20 49 66 ==0 ){. /* If
17bf0 20 74 68 69 73 20 69 73 20 61 20 72 6f 6c 6c 62 this is a rollb
17c00 61 63 6b 20 6f 66 20 61 20 73 61 76 65 70 6f 69 ack of a savepoi
17c10 6e 74 20 61 6e 64 20 64 61 74 61 20 77 61 73 20 nt and data was
17c20 6e 6f 74 20 77 72 69 74 74 65 6e 20 74 6f 0a 20 not written to.
17c30 20 20 20 2a 2a 20 74 68 65 20 64 61 74 61 62 61 ** the databa
17c40 73 65 20 61 6e 64 20 74 68 65 20 70 61 67 65 20 se and the page
17c50 69 73 20 6e 6f 74 20 69 6e 2d 6d 65 6d 6f 72 79 is not in-memory
17c60 2c 20 74 68 65 72 65 20 69 73 20 61 20 70 6f 74 , there is a pot
17c70 65 6e 74 69 61 6c 0a 20 20 20 20 2a 2a 20 70 72 ential. ** pr
17c80 6f 62 6c 65 6d 2e 20 57 68 65 6e 20 74 68 65 20 oblem. When the
17c90 70 61 67 65 20 69 73 20 6e 65 78 74 20 66 65 74 page is next fet
17ca0 63 68 65 64 20 62 79 20 74 68 65 20 62 2d 74 72 ched by the b-tr
17cb0 65 65 20 6c 61 79 65 72 2c 20 69 74 20 0a 20 20 ee layer, it .
17cc0 20 20 2a 2a 20 77 69 6c 6c 20 62 65 20 72 65 61 ** will be rea
17cd0 64 20 66 72 6f 6d 20 74 68 65 20 64 61 74 61 62 d from the datab
17ce0 61 73 65 20 66 69 6c 65 2c 20 77 68 69 63 68 20 ase file, which
17cf0 6d 61 79 20 6f 72 20 6d 61 79 20 6e 6f 74 20 62 may or may not b
17d00 65 20 0a 20 20 20 20 2a 2a 20 63 75 72 72 65 6e e . ** curren
17d10 74 2e 20 0a 20 20 20 20 2a 2a 0a 20 20 20 20 2a t. . **. *
17d20 2a 20 54 68 65 72 65 20 61 72 65 20 61 20 63 6f * There are a co
17d30 75 70 6c 65 20 6f 66 20 64 69 66 66 65 72 65 6e uple of differen
17d40 74 20 77 61 79 73 20 74 68 69 73 20 63 61 6e 20 t ways this can
17d50 68 61 70 70 65 6e 2e 20 41 6c 6c 20 61 72 65 20 happen. All are
17d60 71 75 69 74 65 0a 20 20 20 20 2a 2a 20 6f 62 73 quite. ** obs
17d70 63 75 72 65 2e 20 57 68 65 6e 20 72 75 6e 6e 69 cure. When runni
17d80 6e 67 20 69 6e 20 73 79 6e 63 68 72 6f 6e 6f 75 ng in synchronou
17d90 73 20 6d 6f 64 65 2c 20 74 68 69 73 20 63 61 6e s mode, this can
17da0 20 6f 6e 6c 79 20 68 61 70 70 65 6e 20 0a 20 20 only happen .
17db0 20 20 2a 2a 20 69 66 20 74 68 65 20 70 61 67 65 ** if the page
17dc0 20 69 73 20 6f 6e 20 74 68 65 20 66 72 65 65 2d is on the free-
17dd0 6c 69 73 74 20 61 74 20 74 68 65 20 73 74 61 72 list at the star
17de0 74 20 6f 66 20 74 68 65 20 74 72 61 6e 73 61 63 t of the transac
17df0 74 69 6f 6e 2c 20 74 68 65 6e 0a 20 20 20 20 2a tion, then. *
17e00 2a 20 70 6f 70 75 6c 61 74 65 64 2c 20 74 68 65 * populated, the
17e10 6e 20 6d 6f 76 65 64 20 75 73 69 6e 67 20 73 71 n moved using sq
17e20 6c 69 74 65 33 50 61 67 65 72 4d 6f 76 65 70 61 lite3PagerMovepa
17e30 67 65 28 29 2e 0a 20 20 20 20 2a 2a 0a 20 20 20 ge().. **.
17e40 20 2a 2a 20 54 68 65 20 73 6f 6c 75 74 69 6f 6e ** The solution
17e50 20 69 73 20 74 6f 20 61 64 64 20 61 6e 20 69 6e is to add an in
17e60 2d 6d 65 6d 6f 72 79 20 70 61 67 65 20 74 6f 20 -memory page to
17e70 74 68 65 20 63 61 63 68 65 20 63 6f 6e 74 61 69 the cache contai
17e80 6e 69 6e 67 0a 20 20 20 20 2a 2a 20 74 68 65 20 ning. ** the
17e90 64 61 74 61 20 6a 75 73 74 20 72 65 61 64 20 66 data just read f
17ea0 72 6f 6d 20 74 68 65 20 73 75 62 2d 6a 6f 75 72 rom the sub-jour
17eb0 6e 61 6c 2e 20 4d 61 72 6b 20 74 68 65 20 70 61 nal. Mark the pa
17ec0 67 65 20 61 73 20 64 69 72 74 79 20 0a 20 20 20 ge as dirty .
17ed0 20 2a 2a 20 61 6e 64 20 69 66 20 74 68 65 20 70 ** and if the p
17ee0 61 67 65 72 20 72 65 71 75 69 72 65 73 20 61 20 ager requires a
17ef0 6a 6f 75 72 6e 61 6c 2d 73 79 6e 63 2c 20 74 68 journal-sync, th
17f00 65 6e 20 6d 61 72 6b 20 74 68 65 20 70 61 67 65 en mark the page
17f10 20 61 73 20 0a 20 20 20 20 2a 2a 20 72 65 71 75 as . ** requ
17f20 69 72 69 6e 67 20 61 20 6a 6f 75 72 6e 61 6c 2d iring a journal-
17f30 73 79 6e 63 20 62 65 66 6f 72 65 20 69 74 20 69 sync before it i
17f40 73 20 77 72 69 74 74 65 6e 2e 0a 20 20 20 20 2a s written.. *
17f50 2f 0a 20 20 20 20 61 73 73 65 72 74 28 20 69 73 /. assert( is
17f60 53 61 76 65 70 6e 74 20 29 3b 0a 20 20 20 20 61 Savepnt );. a
17f70 73 73 65 72 74 28 20 28 70 50 61 67 65 72 2d 3e ssert( (pPager->
17f80 64 6f 4e 6f 74 53 70 69 6c 6c 20 26 20 53 50 49 doNotSpill & SPI
17f90 4c 4c 46 4c 41 47 5f 52 4f 4c 4c 42 41 43 4b 29 LLFLAG_ROLLBACK)
17fa0 3d 3d 30 20 29 3b 0a 20 20 20 20 70 50 61 67 65 ==0 );. pPage
17fb0 72 2d 3e 64 6f 4e 6f 74 53 70 69 6c 6c 20 7c 3d r->doNotSpill |=
17fc0 20 53 50 49 4c 4c 46 4c 41 47 5f 52 4f 4c 4c 42 SPILLFLAG_ROLLB
17fd0 41 43 4b 3b 0a 20 20 20 20 72 63 20 3d 20 73 71 ACK;. rc = sq
17fe0 6c 69 74 65 33 50 61 67 65 72 47 65 74 28 70 50 lite3PagerGet(pP
17ff0 61 67 65 72 2c 20 70 67 6e 6f 2c 20 26 70 50 67 ager, pgno, &pPg
18000 2c 20 31 29 3b 0a 20 20 20 20 61 73 73 65 72 74 , 1);. assert
18010 28 20 28 70 50 61 67 65 72 2d 3e 64 6f 4e 6f 74 ( (pPager->doNot
18020 53 70 69 6c 6c 20 26 20 53 50 49 4c 4c 46 4c 41 Spill & SPILLFLA
18030 47 5f 52 4f 4c 4c 42 41 43 4b 29 21 3d 30 20 29 G_ROLLBACK)!=0 )
18040 3b 0a 20 20 20 20 70 50 61 67 65 72 2d 3e 64 6f ;. pPager->do
18050 4e 6f 74 53 70 69 6c 6c 20 26 3d 20 7e 53 50 49 NotSpill &= ~SPI
18060 4c 4c 46 4c 41 47 5f 52 4f 4c 4c 42 41 43 4b 3b LLFLAG_ROLLBACK;
18070 0a 20 20 20 20 69 66 28 20 72 63 21 3d 53 51 4c . if( rc!=SQL
18080 49 54 45 5f 4f 4b 20 29 20 72 65 74 75 72 6e 20 ITE_OK ) return
18090 72 63 3b 0a 20 20 20 20 70 50 67 2d 3e 66 6c 61 rc;. pPg->fla
180a0 67 73 20 26 3d 20 7e 50 47 48 44 52 5f 4e 45 45 gs &= ~PGHDR_NEE
180b0 44 5f 52 45 41 44 3b 0a 20 20 20 20 73 71 6c 69 D_READ;. sqli
180c0 74 65 33 50 63 61 63 68 65 4d 61 6b 65 44 69 72 te3PcacheMakeDir
180d0 74 79 28 70 50 67 29 3b 0a 20 20 7d 0a 20 20 69 ty(pPg);. }. i
180e0 66 28 20 70 50 67 20 29 7b 0a 20 20 20 20 2f 2a f( pPg ){. /*
180f0 20 4e 6f 20 70 61 67 65 20 73 68 6f 75 6c 64 20 No page should
18100 65 76 65 72 20 62 65 20 65 78 70 6c 69 63 69 74 ever be explicit
18110 6c 79 20 72 6f 6c 6c 65 64 20 62 61 63 6b 20 74 ly rolled back t
18120 68 61 74 20 69 73 20 69 6e 20 75 73 65 2c 20 65 hat is in use, e
18130 78 63 65 70 74 0a 20 20 20 20 2a 2a 20 66 6f 72 xcept. ** for
18140 20 70 61 67 65 20 31 20 77 68 69 63 68 20 69 73 page 1 which is
18150 20 68 65 6c 64 20 69 6e 20 75 73 65 20 69 6e 20 held in use in
18160 6f 72 64 65 72 20 74 6f 20 6b 65 65 70 20 74 68 order to keep th
18170 65 20 6c 6f 63 6b 20 6f 6e 20 74 68 65 0a 20 20 e lock on the.
18180 20 20 2a 2a 20 64 61 74 61 62 61 73 65 20 61 63 ** database ac
18190 74 69 76 65 2e 20 48 6f 77 65 76 65 72 20 73 75 tive. However su
181a0 63 68 20 61 20 70 61 67 65 20 6d 61 79 20 62 65 ch a page may be
181b0 20 72 6f 6c 6c 65 64 20 62 61 63 6b 20 61 73 20 rolled back as
181c0 61 20 72 65 73 75 6c 74 0a 20 20 20 20 2a 2a 20 a result. **
181d0 6f 66 20 61 6e 20 69 6e 74 65 72 6e 61 6c 20 65 of an internal e
181e0 72 72 6f 72 20 72 65 73 75 6c 74 69 6e 67 20 69 rror resulting i
181f0 6e 20 61 6e 20 61 75 74 6f 6d 61 74 69 63 20 63 n an automatic c
18200 61 6c 6c 20 74 6f 0a 20 20 20 20 2a 2a 20 73 71 all to. ** sq
18210 6c 69 74 65 33 50 61 67 65 72 52 6f 6c 6c 62 61 lite3PagerRollba
18220 63 6b 28 29 2e 0a 20 20 20 20 2a 2f 0a 20 20 20 ck().. */.
18230 20 76 6f 69 64 20 2a 70 44 61 74 61 3b 0a 20 20 void *pData;.
18240 20 20 70 44 61 74 61 20 3d 20 70 50 67 2d 3e 70 pData = pPg->p
18250 44 61 74 61 3b 0a 20 20 20 20 6d 65 6d 63 70 79 Data;. memcpy
18260 28 70 44 61 74 61 2c 20 28 75 38 2a 29 61 44 61 (pData, (u8*)aDa
18270 74 61 2c 20 70 50 61 67 65 72 2d 3e 70 61 67 65 ta, pPager->page
18280 53 69 7a 65 29 3b 0a 20 20 20 20 70 50 61 67 65 Size);. pPage
18290 72 2d 3e 78 52 65 69 6e 69 74 65 72 28 70 50 67 r->xReiniter(pPg
182a0 29 3b 0a 20 20 20 20 69 66 28 20 69 73 4d 61 69 );. if( isMai
182b0 6e 4a 72 6e 6c 20 26 26 20 28 21 69 73 53 61 76 nJrnl && (!isSav
182c0 65 70 6e 74 20 7c 7c 20 2a 70 4f 66 66 73 65 74 epnt || *pOffset
182d0 3c 3d 70 50 61 67 65 72 2d 3e 6a 6f 75 72 6e 61 <=pPager->journa
182e0 6c 48 64 72 29 20 29 7b 0a 20 20 20 20 20 20 2f lHdr) ){. /
182f0 2a 20 49 66 20 74 68 65 20 63 6f 6e 74 65 6e 74 * If the content
18300 73 20 6f 66 20 74 68 69 73 20 70 61 67 65 20 77 s of this page w
18310 65 72 65 20 6a 75 73 74 20 72 65 73 74 6f 72 65 ere just restore
18320 64 20 66 72 6f 6d 20 74 68 65 20 6d 61 69 6e 20 d from the main
18330 0a 20 20 20 20 20 20 2a 2a 20 6a 6f 75 72 6e 61 . ** journa
18340 6c 20 66 69 6c 65 2c 20 74 68 65 6e 20 69 74 73 l file, then its
18350 20 63 6f 6e 74 65 6e 74 20 6d 75 73 74 20 62 65 content must be
18360 20 61 73 20 74 68 65 79 20 77 65 72 65 20 77 68 as they were wh
18370 65 6e 20 74 68 65 20 0a 20 20 20 20 20 20 2a 2a en the . **
18380 20 74 72 61 6e 73 61 63 74 69 6f 6e 20 77 61 73 transaction was
18390 20 66 69 72 73 74 20 6f 70 65 6e 65 64 2e 20 49 first opened. I
183a0 6e 20 74 68 69 73 20 63 61 73 65 20 77 65 20 63 n this case we c
183b0 61 6e 20 6d 61 72 6b 20 74 68 65 20 70 61 67 65 an mark the page
183c0 0a 20 20 20 20 20 20 2a 2a 20 61 73 20 63 6c 65 . ** as cle
183d0 61 6e 2c 20 73 69 6e 63 65 20 74 68 65 72 65 20 an, since there
183e0 77 69 6c 6c 20 62 65 20 6e 6f 20 6e 65 65 64 20 will be no need
183f0 74 6f 20 77 72 69 74 65 20 69 74 20 6f 75 74 20 to write it out
18400 74 6f 20 74 68 65 0a 20 20 20 20 20 20 2a 2a 20 to the. **
18410 64 61 74 61 62 61 73 65 2e 0a 20 20 20 20 20 20 database..
18420 2a 2a 0a 20 20 20 20 20 20 2a 2a 20 54 68 65 72 **. ** Ther
18430 65 20 69 73 20 6f 6e 65 20 65 78 63 65 70 74 69 e is one excepti
18440 6f 6e 20 74 6f 20 74 68 69 73 20 72 75 6c 65 2e on to this rule.
18450 20 49 66 20 74 68 65 20 70 61 67 65 20 69 73 20 If the page is
18460 62 65 69 6e 67 20 72 6f 6c 6c 65 64 0a 20 20 20 being rolled.
18470 20 20 20 2a 2a 20 62 61 63 6b 20 61 73 20 70 61 ** back as pa
18480 72 74 20 6f 66 20 61 20 73 61 76 65 70 6f 69 6e rt of a savepoin
18490 74 20 28 6f 72 20 73 74 61 74 65 6d 65 6e 74 29 t (or statement)
184a0 20 72 6f 6c 6c 62 61 63 6b 20 66 72 6f 6d 20 61 rollback from a
184b0 6e 20 0a 20 20 20 20 20 20 2a 2a 20 75 6e 73 79 n . ** unsy
184c0 6e 63 65 64 20 70 6f 72 74 69 6f 6e 20 6f 66 20 nced portion of
184d0 74 68 65 20 6d 61 69 6e 20 6a 6f 75 72 6e 61 6c the main journal
184e0 20 66 69 6c 65 2c 20 74 68 65 6e 20 69 74 20 69 file, then it i
184f0 73 20 6e 6f 74 20 73 61 66 65 0a 20 20 20 20 20 s not safe.
18500 20 2a 2a 20 74 6f 20 6d 61 72 6b 20 74 68 65 20 ** to mark the
18510 70 61 67 65 20 61 73 20 63 6c 65 61 6e 2e 20 54 page as clean. T
18520 68 69 73 20 69 73 20 62 65 63 61 75 73 65 20 6d his is because m
18530 61 72 6b 69 6e 67 20 74 68 65 20 70 61 67 65 20 arking the page
18540 61 73 0a 20 20 20 20 20 20 2a 2a 20 63 6c 65 61 as. ** clea
18550 6e 20 77 69 6c 6c 20 63 6c 65 61 72 20 74 68 65 n will clear the
18560 20 50 47 48 44 52 5f 4e 45 45 44 5f 53 59 4e 43 PGHDR_NEED_SYNC
18570 20 66 6c 61 67 2e 20 53 69 6e 63 65 20 74 68 65 flag. Since the
18580 20 70 61 67 65 20 69 73 0a 20 20 20 20 20 20 2a page is. *
18590 2a 20 61 6c 72 65 61 64 79 20 69 6e 20 74 68 65 * already in the
185a0 20 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 20 28 72 journal file (r
185b0 65 63 6f 72 64 65 64 20 69 6e 20 50 61 67 65 72 ecorded in Pager
185c0 2e 70 49 6e 4a 6f 75 72 6e 61 6c 29 20 61 6e 64 .pInJournal) and
185d0 0a 20 20 20 20 20 20 2a 2a 20 74 68 65 20 50 47 . ** the PG
185e0 48 44 52 5f 4e 45 45 44 5f 53 59 4e 43 20 66 6c HDR_NEED_SYNC fl
185f0 61 67 20 69 73 20 63 6c 65 61 72 65 64 2c 20 69 ag is cleared, i
18600 66 20 74 68 65 20 70 61 67 65 20 69 73 20 77 72 f the page is wr
18610 69 74 74 65 6e 20 74 6f 0a 20 20 20 20 20 20 2a itten to. *
18620 2a 20 61 67 61 69 6e 20 77 69 74 68 69 6e 20 74 * again within t
18630 68 69 73 20 74 72 61 6e 73 61 63 74 69 6f 6e 2c his transaction,
18640 20 69 74 20 77 69 6c 6c 20 62 65 20 6d 61 72 6b it will be mark
18650 65 64 20 61 73 20 64 69 72 74 79 20 62 75 74 0a ed as dirty but.
18660 20 20 20 20 20 20 2a 2a 20 74 68 65 20 50 47 48 ** the PGH
18670 44 52 5f 4e 45 45 44 5f 53 59 4e 43 20 66 6c 61 DR_NEED_SYNC fla
18680 67 20 77 69 6c 6c 20 6e 6f 74 20 62 65 20 73 65 g will not be se
18690 74 2e 20 49 74 20 63 6f 75 6c 64 20 74 68 65 6e t. It could then
186a0 20 70 6f 74 65 6e 74 69 61 6c 6c 79 0a 20 20 20 potentially.
186b0 20 20 20 2a 2a 20 62 65 20 77 72 69 74 74 65 6e ** be written
186c0 20 6f 75 74 20 69 6e 74 6f 20 74 68 65 20 64 61 out into the da
186d0 74 61 62 61 73 65 20 66 69 6c 65 20 62 65 66 6f tabase file befo
186e0 72 65 20 69 74 73 20 6a 6f 75 72 6e 61 6c 20 66 re its journal f
186f0 69 6c 65 0a 20 20 20 20 20 20 2a 2a 20 73 65 67 ile. ** seg
18700 6d 65 6e 74 20 69 73 20 73 79 6e 63 65 64 2e 20 ment is synced.
18710 49 66 20 61 20 63 72 61 73 68 20 6f 63 63 75 72 If a crash occur
18720 73 20 64 75 72 69 6e 67 20 6f 72 20 66 6f 6c 6c s during or foll
18730 6f 77 69 6e 67 20 74 68 69 73 2c 0a 20 20 20 20 owing this,.
18740 20 20 2a 2a 20 64 61 74 61 62 61 73 65 20 63 6f ** database co
18750 72 72 75 70 74 69 6f 6e 20 6d 61 79 20 65 6e 73 rruption may ens
18760 75 65 2e 0a 20 20 20 20 20 20 2a 2a 0a 20 20 20 ue.. **.
18770 20 20 20 2a 2a 20 55 70 64 61 74 65 3a 20 41 6e ** Update: An
18780 6f 74 68 65 72 20 65 78 63 65 70 74 69 6f 6e 20 other exception
18790 69 73 20 66 6f 72 20 74 65 6d 70 20 66 69 6c 65 is for temp file
187a0 73 20 74 68 61 74 20 61 72 65 20 6e 6f 74 20 0a s that are not .
187b0 20 20 20 20 20 20 2a 2a 20 69 6e 2d 6d 65 6d 6f ** in-memo
187c0 72 79 20 64 61 74 61 62 61 73 65 73 2e 20 49 6e ry databases. In
187d0 20 74 68 69 73 20 63 61 73 65 20 74 68 65 20 70 this case the p
187e0 61 67 65 20 6d 61 79 20 68 61 76 65 20 62 65 65 age may have bee
187f0 6e 20 64 69 72 74 79 0a 20 20 20 20 20 20 2a 2a n dirty. **
18800 20 61 74 20 74 68 65 20 73 74 61 72 74 20 6f 66 at the start of
18810 20 74 68 65 20 74 72 61 6e 73 61 63 74 69 6f 6e the transaction
18820 2e 0a 20 20 20 20 20 20 2a 2f 0a 20 20 20 20 20 .. */.
18830 20 61 73 73 65 72 74 28 20 21 70 61 67 65 72 55 assert( !pagerU
18840 73 65 57 61 6c 28 70 50 61 67 65 72 29 20 29 3b seWal(pPager) );
18850 0a 20 20 20 20 20 20 69 66 28 20 70 50 61 67 65 . if( pPage
18860 72 2d 3e 74 65 6d 70 46 69 6c 65 3d 3d 30 20 29 r->tempFile==0 )
18870 20 73 71 6c 69 74 65 33 50 63 61 63 68 65 4d 61 sqlite3PcacheMa
18880 6b 65 43 6c 65 61 6e 28 70 50 67 29 3b 0a 20 20 keClean(pPg);.
18890 20 20 7d 0a 20 20 20 20 70 61 67 65 72 5f 73 65 }. pager_se
188a0 74 5f 70 61 67 65 68 61 73 68 28 70 50 67 29 3b t_pagehash(pPg);
188b0 0a 0a 20 20 20 20 2f 2a 20 49 66 20 74 68 69 73 .. /* If this
188c0 20 77 61 73 20 70 61 67 65 20 31 2c 20 74 68 65 was page 1, the
188d0 6e 20 72 65 73 74 6f 72 65 20 74 68 65 20 76 61 n restore the va
188e0 6c 75 65 20 6f 66 20 50 61 67 65 72 2e 64 62 46 lue of Pager.dbF
188f0 69 6c 65 56 65 72 73 2e 0a 20 20 20 20 2a 2a 20 ileVers.. **
18900 44 6f 20 74 68 69 73 20 62 65 66 6f 72 65 20 61 Do this before a
18910 6e 79 20 64 65 63 6f 64 69 6e 67 2e 20 2a 2f 0a ny decoding. */.
18920 20 20 20 20 69 66 28 20 70 67 6e 6f 3d 3d 31 20 if( pgno==1
18930 29 7b 0a 20 20 20 20 20 20 6d 65 6d 63 70 79 28 ){. memcpy(
18940 26 70 50 61 67 65 72 2d 3e 64 62 46 69 6c 65 56 &pPager->dbFileV
18950 65 72 73 2c 20 26 28 28 75 38 2a 29 70 44 61 74 ers, &((u8*)pDat
18960 61 29 5b 32 34 5d 2c 73 69 7a 65 6f 66 28 70 50 a)[24],sizeof(pP
18970 61 67 65 72 2d 3e 64 62 46 69 6c 65 56 65 72 73 ager->dbFileVers
18980 29 29 3b 0a 20 20 20 20 7d 0a 0a 20 20 20 20 2f ));. }.. /
18990 2a 20 44 65 63 6f 64 65 20 74 68 65 20 70 61 67 * Decode the pag
189a0 65 20 6a 75 73 74 20 72 65 61 64 20 66 72 6f 6d e just read from
189b0 20 64 69 73 6b 20 2a 2f 0a 20 20 20 20 43 4f 44 disk */. COD
189c0 45 43 31 28 70 50 61 67 65 72 2c 20 70 44 61 74 EC1(pPager, pDat
189d0 61 2c 20 70 50 67 2d 3e 70 67 6e 6f 2c 20 33 2c a, pPg->pgno, 3,
189e0 20 72 63 3d 53 51 4c 49 54 45 5f 4e 4f 4d 45 4d rc=SQLITE_NOMEM
189f0 5f 42 4b 50 54 29 3b 0a 20 20 20 20 73 71 6c 69 _BKPT);. sqli
18a00 74 65 33 50 63 61 63 68 65 52 65 6c 65 61 73 65 te3PcacheRelease
18a10 28 70 50 67 29 3b 0a 20 20 7d 0a 20 20 72 65 74 (pPg);. }. ret
18a20 75 72 6e 20 72 63 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a urn rc;.}../*.**
18a30 20 50 61 72 61 6d 65 74 65 72 20 7a 4d 61 73 74 Parameter zMast
18a40 65 72 20 69 73 20 74 68 65 20 6e 61 6d 65 20 6f er is the name o
18a50 66 20 61 20 6d 61 73 74 65 72 20 6a 6f 75 72 6e f a master journ
18a60 61 6c 20 66 69 6c 65 2e 20 41 20 73 69 6e 67 6c al file. A singl
18a70 65 20 6a 6f 75 72 6e 61 6c 0a 2a 2a 20 66 69 6c e journal.** fil
18a80 65 20 74 68 61 74 20 72 65 66 65 72 72 65 64 20 e that referred
18a90 74 6f 20 74 68 65 20 6d 61 73 74 65 72 20 6a 6f to the master jo
18aa0 75 72 6e 61 6c 20 66 69 6c 65 20 68 61 73 20 6a urnal file has j
18ab0 75 73 74 20 62 65 65 6e 20 72 6f 6c 6c 65 64 20 ust been rolled
18ac0 62 61 63 6b 2e 0a 2a 2a 20 54 68 69 73 20 72 6f back..** This ro
18ad0 75 74 69 6e 65 20 63 68 65 63 6b 73 20 69 66 20 utine checks if
18ae0 69 74 20 69 73 20 70 6f 73 73 69 62 6c 65 20 74 it is possible t
18af0 6f 20 64 65 6c 65 74 65 20 74 68 65 20 6d 61 73 o delete the mas
18b00 74 65 72 20 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 ter journal file
18b10 2c 0a 2a 2a 20 61 6e 64 20 64 6f 65 73 20 73 6f ,.** and does so
18b20 20 69 66 20 69 74 20 69 73 2e 0a 2a 2a 0a 2a 2a if it is..**.**
18b30 20 41 72 67 75 6d 65 6e 74 20 7a 4d 61 73 74 65 Argument zMaste
18b40 72 20 6d 61 79 20 70 6f 69 6e 74 20 74 6f 20 50 r may point to P
18b50 61 67 65 72 2e 70 54 6d 70 53 70 61 63 65 2e 20 ager.pTmpSpace.
18b60 53 6f 20 74 68 61 74 20 62 75 66 66 65 72 20 69 So that buffer i
18b70 73 20 6e 6f 74 20 0a 2a 2a 20 61 76 61 69 6c 61 s not .** availa
18b80 62 6c 65 20 66 6f 72 20 75 73 65 20 77 69 74 68 ble for use with
18b90 69 6e 20 74 68 69 73 20 66 75 6e 63 74 69 6f 6e in this function
18ba0 2e 0a 2a 2a 0a 2a 2a 20 57 68 65 6e 20 61 20 6d ..**.** When a m
18bb0 61 73 74 65 72 20 6a 6f 75 72 6e 61 6c 20 66 69 aster journal fi
18bc0 6c 65 20 69 73 20 63 72 65 61 74 65 64 2c 20 69 le is created, i
18bd0 74 20 69 73 20 70 6f 70 75 6c 61 74 65 64 20 77 t is populated w
18be0 69 74 68 20 74 68 65 20 6e 61 6d 65 73 20 0a 2a ith the names .*
18bf0 2a 20 6f 66 20 61 6c 6c 20 6f 66 20 69 74 73 20 * of all of its
18c00 63 68 69 6c 64 20 6a 6f 75 72 6e 61 6c 73 2c 20 child journals,
18c10 6f 6e 65 20 61 66 74 65 72 20 61 6e 6f 74 68 65 one after anothe
18c20 72 2c 20 66 6f 72 6d 61 74 74 65 64 20 61 73 20 r, formatted as
18c30 75 74 66 2d 38 20 0a 2a 2a 20 65 6e 63 6f 64 65 utf-8 .** encode
18c40 64 20 74 65 78 74 2e 20 54 68 65 20 65 6e 64 20 d text. The end
18c50 6f 66 20 65 61 63 68 20 63 68 69 6c 64 20 6a 6f of each child jo
18c60 75 72 6e 61 6c 20 66 69 6c 65 20 69 73 20 6d 61 urnal file is ma
18c70 72 6b 65 64 20 77 69 74 68 20 61 20 0a 2a 2a 20 rked with a .**
18c80 6e 75 6c 2d 74 65 72 6d 69 6e 61 74 6f 72 20 62 nul-terminator b
18c90 79 74 65 20 28 30 78 30 30 29 2e 20 69 2e 65 2e yte (0x00). i.e.
18ca0 20 74 68 65 20 65 6e 74 69 72 65 20 63 6f 6e 74 the entire cont
18cb0 65 6e 74 73 20 6f 66 20 61 20 6d 61 73 74 65 72 ents of a master
18cc0 20 6a 6f 75 72 6e 61 6c 0a 2a 2a 20 66 69 6c 65 journal.** file
18cd0 20 66 6f 72 20 61 20 74 72 61 6e 73 61 63 74 69 for a transacti
18ce0 6f 6e 20 69 6e 76 6f 6c 76 69 6e 67 20 74 77 6f on involving two
18cf0 20 64 61 74 61 62 61 73 65 73 20 6d 69 67 68 74 databases might
18d00 20 62 65 3a 0a 2a 2a 0a 2a 2a 20 20 20 22 2f 68 be:.**.** "/h
18d10 6f 6d 65 2f 62 69 6c 6c 2f 61 2e 64 62 2d 6a 6f ome/bill/a.db-jo
18d20 75 72 6e 61 6c 5c 78 30 30 2f 68 6f 6d 65 2f 62 urnal\x00/home/b
18d30 69 6c 6c 2f 62 2e 64 62 2d 6a 6f 75 72 6e 61 6c ill/b.db-journal
18d40 5c 78 30 30 22 0a 2a 2a 0a 2a 2a 20 41 20 6d 61 \x00".**.** A ma
18d50 73 74 65 72 20 6a 6f 75 72 6e 61 6c 20 66 69 6c ster journal fil
18d60 65 20 6d 61 79 20 6f 6e 6c 79 20 62 65 20 64 65 e may only be de
18d70 6c 65 74 65 64 20 6f 6e 63 65 20 61 6c 6c 20 6f leted once all o
18d80 66 20 69 74 73 20 63 68 69 6c 64 20 0a 2a 2a 20 f its child .**
18d90 6a 6f 75 72 6e 61 6c 73 20 68 61 76 65 20 62 65 journals have be
18da0 65 6e 20 72 6f 6c 6c 65 64 20 62 61 63 6b 2e 0a en rolled back..
18db0 2a 2a 0a 2a 2a 20 54 68 69 73 20 66 75 6e 63 74 **.** This funct
18dc0 69 6f 6e 20 72 65 61 64 73 20 74 68 65 20 63 6f ion reads the co
18dd0 6e 74 65 6e 74 73 20 6f 66 20 74 68 65 20 6d 61 ntents of the ma
18de0 73 74 65 72 2d 6a 6f 75 72 6e 61 6c 20 66 69 6c ster-journal fil
18df0 65 20 69 6e 74 6f 20 0a 2a 2a 20 6d 65 6d 6f 72 e into .** memor
18e00 79 20 61 6e 64 20 6c 6f 6f 70 73 20 74 68 72 6f y and loops thro
18e10 75 67 68 20 65 61 63 68 20 6f 66 20 74 68 65 20 ugh each of the
18e20 63 68 69 6c 64 20 6a 6f 75 72 6e 61 6c 20 6e 61 child journal na
18e30 6d 65 73 2e 20 46 6f 72 0a 2a 2a 20 65 61 63 68 mes. For.** each
18e40 20 63 68 69 6c 64 20 6a 6f 75 72 6e 61 6c 2c 20 child journal,
18e50 69 74 20 63 68 65 63 6b 73 20 69 66 3a 0a 2a 2a it checks if:.**
18e60 0a 2a 2a 20 20 20 2a 20 69 66 20 74 68 65 20 63 .** * if the c
18e70 68 69 6c 64 20 6a 6f 75 72 6e 61 6c 20 65 78 69 hild journal exi
18e80 73 74 73 2c 20 61 6e 64 20 69 66 20 73 6f 0a 2a sts, and if so.*
18e90 2a 20 20 20 2a 20 69 66 20 74 68 65 20 63 68 69 * * if the chi
18ea0 6c 64 20 6a 6f 75 72 6e 61 6c 20 63 6f 6e 74 61 ld journal conta
18eb0 69 6e 73 20 61 20 72 65 66 65 72 65 6e 63 65 20 ins a reference
18ec0 74 6f 20 6d 61 73 74 65 72 20 6a 6f 75 72 6e 61 to master journa
18ed0 6c 20 0a 2a 2a 20 20 20 20 20 66 69 6c 65 20 7a l .** file z
18ee0 4d 61 73 74 65 72 0a 2a 2a 0a 2a 2a 20 49 66 20 Master.**.** If
18ef0 61 20 63 68 69 6c 64 20 6a 6f 75 72 6e 61 6c 20 a child journal
18f00 63 61 6e 20 62 65 20 66 6f 75 6e 64 20 74 68 61 can be found tha
18f10 74 20 6d 61 74 63 68 65 73 20 62 6f 74 68 20 6f t matches both o
18f20 66 20 74 68 65 20 63 72 69 74 65 72 69 61 0a 2a f the criteria.*
18f30 2a 20 61 62 6f 76 65 2c 20 74 68 69 73 20 66 75 * above, this fu
18f40 6e 63 74 69 6f 6e 20 72 65 74 75 72 6e 73 20 77 nction returns w
18f50 69 74 68 6f 75 74 20 64 6f 69 6e 67 20 61 6e 79 ithout doing any
18f60 74 68 69 6e 67 2e 20 4f 74 68 65 72 77 69 73 65 thing. Otherwise
18f70 2c 20 69 66 0a 2a 2a 20 6e 6f 20 73 75 63 68 20 , if.** no such
18f80 63 68 69 6c 64 20 6a 6f 75 72 6e 61 6c 20 63 61 child journal ca
18f90 6e 20 62 65 20 66 6f 75 6e 64 2c 20 66 69 6c 65 n be found, file
18fa0 20 7a 4d 61 73 74 65 72 20 69 73 20 64 65 6c 65 zMaster is dele
18fb0 74 65 64 20 66 72 6f 6d 0a 2a 2a 20 74 68 65 20 ted from.** the
18fc0 66 69 6c 65 2d 73 79 73 74 65 6d 20 75 73 69 6e file-system usin
18fd0 67 20 73 71 6c 69 74 65 33 4f 73 44 65 6c 65 74 g sqlite3OsDelet
18fe0 65 28 29 2e 0a 2a 2a 0a 2a 2a 20 49 66 20 61 6e e()..**.** If an
18ff0 20 49 4f 20 65 72 72 6f 72 20 77 69 74 68 69 6e IO error within
19000 20 74 68 69 73 20 66 75 6e 63 74 69 6f 6e 2c 20 this function,
19010 61 6e 20 65 72 72 6f 72 20 63 6f 64 65 20 69 73 an error code is
19020 20 72 65 74 75 72 6e 65 64 2e 20 54 68 69 73 0a returned. This.
19030 2a 2a 20 66 75 6e 63 74 69 6f 6e 20 61 6c 6c 6f ** function allo
19040 63 61 74 65 73 20 6d 65 6d 6f 72 79 20 62 79 20 cates memory by
19050 63 61 6c 6c 69 6e 67 20 73 71 6c 69 74 65 33 4d calling sqlite3M
19060 61 6c 6c 6f 63 28 29 2e 20 49 66 20 61 6e 20 61 alloc(). If an a
19070 6c 6c 6f 63 61 74 69 6f 6e 0a 2a 2a 20 66 61 69 llocation.** fai
19080 6c 73 2c 20 53 51 4c 49 54 45 5f 4e 4f 4d 45 4d ls, SQLITE_NOMEM
19090 20 69 73 20 72 65 74 75 72 6e 65 64 2e 20 4f 74 is returned. Ot
190a0 68 65 72 77 69 73 65 2c 20 69 66 20 6e 6f 20 49 herwise, if no I
190b0 4f 20 6f 72 20 6d 61 6c 6c 6f 63 20 65 72 72 6f O or malloc erro
190c0 72 73 20 0a 2a 2a 20 6f 63 63 75 72 2c 20 53 51 rs .** occur, SQ
190d0 4c 49 54 45 5f 4f 4b 20 69 73 20 72 65 74 75 72 LITE_OK is retur
190e0 6e 65 64 2e 0a 2a 2a 0a 2a 2a 20 54 4f 44 4f 3a ned..**.** TODO:
190f0 20 54 68 69 73 20 66 75 6e 63 74 69 6f 6e 20 61 This function a
19100 6c 6c 6f 63 61 74 65 73 20 61 20 73 69 6e 67 6c llocates a singl
19110 65 20 62 6c 6f 63 6b 20 6f 66 20 6d 65 6d 6f 72 e block of memor
19120 79 20 74 6f 20 6c 6f 61 64 0a 2a 2a 20 74 68 65 y to load.** the
19130 20 65 6e 74 69 72 65 20 63 6f 6e 74 65 6e 74 73 entire contents
19140 20 6f 66 20 74 68 65 20 6d 61 73 74 65 72 20 6a of the master j
19150 6f 75 72 6e 61 6c 20 66 69 6c 65 2e 20 54 68 69 ournal file. Thi
19160 73 20 63 6f 75 6c 64 20 62 65 0a 2a 2a 20 61 20 s could be.** a
19170 63 6f 75 70 6c 65 20 6f 66 20 6b 69 6c 6f 62 79 couple of kiloby
19180 74 65 73 20 6f 72 20 73 6f 20 2d 20 70 6f 74 65 tes or so - pote
19190 6e 74 69 61 6c 6c 79 20 6c 61 72 67 65 72 20 74 ntially larger t
191a0 68 61 6e 20 74 68 65 20 70 61 67 65 20 0a 2a 2a han the page .**
191b0 20 73 69 7a 65 2e 0a 2a 2f 0a 73 74 61 74 69 63 size..*/.static
191c0 20 69 6e 74 20 70 61 67 65 72 5f 64 65 6c 6d 61 int pager_delma
191d0 73 74 65 72 28 50 61 67 65 72 20 2a 70 50 61 67 ster(Pager *pPag
191e0 65 72 2c 20 63 6f 6e 73 74 20 63 68 61 72 20 2a er, const char *
191f0 7a 4d 61 73 74 65 72 29 7b 0a 20 20 73 71 6c 69 zMaster){. sqli
19200 74 65 33 5f 76 66 73 20 2a 70 56 66 73 20 3d 20 te3_vfs *pVfs =
19210 70 50 61 67 65 72 2d 3e 70 56 66 73 3b 0a 20 20 pPager->pVfs;.
19220 69 6e 74 20 72 63 3b 20 20 20 20 20 20 20 20 20 int rc;
19230 20 20 20 20 20 20 20 20 20 20 2f 2a 20 52 65 74 /* Ret
19240 75 72 6e 20 63 6f 64 65 20 2a 2f 0a 20 20 73 71 urn code */. sq
19250 6c 69 74 65 33 5f 66 69 6c 65 20 2a 70 4d 61 73 lite3_file *pMas
19260 74 65 72 3b 20 20 20 20 2f 2a 20 4d 61 6c 6c 6f ter; /* Mallo
19270 63 27 64 20 6d 61 73 74 65 72 2d 6a 6f 75 72 6e c'd master-journ
19280 61 6c 20 66 69 6c 65 20 64 65 73 63 72 69 70 74 al file descript
19290 6f 72 20 2a 2f 0a 20 20 73 71 6c 69 74 65 33 5f or */. sqlite3_
192a0 66 69 6c 65 20 2a 70 4a 6f 75 72 6e 61 6c 3b 20 file *pJournal;
192b0 20 20 2f 2a 20 4d 61 6c 6c 6f 63 27 64 20 63 68 /* Malloc'd ch
192c0 69 6c 64 2d 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 ild-journal file
192d0 20 64 65 73 63 72 69 70 74 6f 72 20 2a 2f 0a 20 descriptor */.
192e0 20 63 68 61 72 20 2a 7a 4d 61 73 74 65 72 4a 6f char *zMasterJo
192f0 75 72 6e 61 6c 20 3d 20 30 3b 20 2f 2a 20 43 6f urnal = 0; /* Co
19300 6e 74 65 6e 74 73 20 6f 66 20 6d 61 73 74 65 72 ntents of master
19310 20 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 20 2a 2f journal file */
19320 0a 20 20 69 36 34 20 6e 4d 61 73 74 65 72 4a 6f . i64 nMasterJo
19330 75 72 6e 61 6c 3b 20 20 20 20 20 20 20 2f 2a 20 urnal; /*
19340 53 69 7a 65 20 6f 66 20 6d 61 73 74 65 72 20 6a Size of master j
19350 6f 75 72 6e 61 6c 20 66 69 6c 65 20 2a 2f 0a 20 ournal file */.
19360 20 63 68 61 72 20 2a 7a 4a 6f 75 72 6e 61 6c 3b char *zJournal;
19370 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 50 6f /* Po
19380 69 6e 74 65 72 20 74 6f 20 6f 6e 65 20 6a 6f 75 inter to one jou
19390 72 6e 61 6c 20 77 69 74 68 69 6e 20 4d 4a 20 66 rnal within MJ f
193a0 69 6c 65 20 2a 2f 0a 20 20 63 68 61 72 20 2a 7a ile */. char *z
193b0 4d 61 73 74 65 72 50 74 72 3b 20 20 20 20 20 20 MasterPtr;
193c0 20 20 20 2f 2a 20 53 70 61 63 65 20 74 6f 20 68 /* Space to h
193d0 6f 6c 64 20 4d 4a 20 66 69 6c 65 6e 61 6d 65 20 old MJ filename
193e0 66 72 6f 6d 20 61 20 6a 6f 75 72 6e 61 6c 20 66 from a journal f
193f0 69 6c 65 20 2a 2f 0a 20 20 69 6e 74 20 6e 4d 61 ile */. int nMa
19400 73 74 65 72 50 74 72 3b 20 20 20 20 20 20 20 20 sterPtr;
19410 20 20 20 2f 2a 20 41 6d 6f 75 6e 74 20 6f 66 20 /* Amount of
19420 73 70 61 63 65 20 61 6c 6c 6f 63 61 74 65 64 20 space allocated
19430 74 6f 20 7a 4d 61 73 74 65 72 50 74 72 5b 5d 20 to zMasterPtr[]
19440 2a 2f 0a 0a 20 20 2f 2a 20 41 6c 6c 6f 63 61 74 */.. /* Allocat
19450 65 20 73 70 61 63 65 20 66 6f 72 20 62 6f 74 68 e space for both
19460 20 74 68 65 20 70 4a 6f 75 72 6e 61 6c 20 61 6e the pJournal an
19470 64 20 70 4d 61 73 74 65 72 20 66 69 6c 65 20 64 d pMaster file d
19480 65 73 63 72 69 70 74 6f 72 73 2e 0a 20 20 2a 2a escriptors.. **
19490 20 49 66 20 73 75 63 63 65 73 73 66 75 6c 2c 20 If successful,
194a0 6f 70 65 6e 20 74 68 65 20 6d 61 73 74 65 72 20 open the master
194b0 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 20 66 6f 72 journal file for
194c0 20 72 65 61 64 69 6e 67 2e 0a 20 20 2a 2f 0a 20 reading.. */.
194d0 20 70 4d 61 73 74 65 72 20 3d 20 28 73 71 6c 69 pMaster = (sqli
194e0 74 65 33 5f 66 69 6c 65 20 2a 29 73 71 6c 69 74 te3_file *)sqlit
194f0 65 33 4d 61 6c 6c 6f 63 5a 65 72 6f 28 70 56 66 e3MallocZero(pVf
19500 73 2d 3e 73 7a 4f 73 46 69 6c 65 20 2a 20 32 29 s->szOsFile * 2)
19510 3b 0a 20 20 70 4a 6f 75 72 6e 61 6c 20 3d 20 28 ;. pJournal = (
19520 73 71 6c 69 74 65 33 5f 66 69 6c 65 20 2a 29 28 sqlite3_file *)(
19530 28 28 75 38 20 2a 29 70 4d 61 73 74 65 72 29 20 ((u8 *)pMaster)
19540 2b 20 70 56 66 73 2d 3e 73 7a 4f 73 46 69 6c 65 + pVfs->szOsFile
19550 29 3b 0a 20 20 69 66 28 20 21 70 4d 61 73 74 65 );. if( !pMaste
19560 72 20 29 7b 0a 20 20 20 20 72 63 20 3d 20 53 51 r ){. rc = SQ
19570 4c 49 54 45 5f 4e 4f 4d 45 4d 5f 42 4b 50 54 3b LITE_NOMEM_BKPT;
19580 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 63 6f . }else{. co
19590 6e 73 74 20 69 6e 74 20 66 6c 61 67 73 20 3d 20 nst int flags =
195a0 28 53 51 4c 49 54 45 5f 4f 50 45 4e 5f 52 45 41 (SQLITE_OPEN_REA
195b0 44 4f 4e 4c 59 7c 53 51 4c 49 54 45 5f 4f 50 45 DONLY|SQLITE_OPE
195c0 4e 5f 4d 41 53 54 45 52 5f 4a 4f 55 52 4e 41 4c N_MASTER_JOURNAL
195d0 29 3b 0a 20 20 20 20 72 63 20 3d 20 73 71 6c 69 );. rc = sqli
195e0 74 65 33 4f 73 4f 70 65 6e 28 70 56 66 73 2c 20 te3OsOpen(pVfs,
195f0 7a 4d 61 73 74 65 72 2c 20 70 4d 61 73 74 65 72 zMaster, pMaster
19600 2c 20 66 6c 61 67 73 2c 20 30 29 3b 0a 20 20 7d , flags, 0);. }
19610 0a 20 20 69 66 28 20 72 63 21 3d 53 51 4c 49 54 . if( rc!=SQLIT
19620 45 5f 4f 4b 20 29 20 67 6f 74 6f 20 64 65 6c 6d E_OK ) goto delm
19630 61 73 74 65 72 5f 6f 75 74 3b 0a 0a 20 20 2f 2a aster_out;.. /*
19640 20 4c 6f 61 64 20 74 68 65 20 65 6e 74 69 72 65 Load the entire
19650 20 6d 61 73 74 65 72 20 6a 6f 75 72 6e 61 6c 20 master journal
19660 66 69 6c 65 20 69 6e 74 6f 20 73 70 61 63 65 20 file into space
19670 6f 62 74 61 69 6e 65 64 20 66 72 6f 6d 0a 20 20 obtained from.
19680 2a 2a 20 73 71 6c 69 74 65 33 5f 6d 61 6c 6c 6f ** sqlite3_mallo
19690 63 28 29 20 61 6e 64 20 70 6f 69 6e 74 65 64 20 c() and pointed
196a0 74 6f 20 62 79 20 7a 4d 61 73 74 65 72 4a 6f 75 to by zMasterJou
196b0 72 6e 61 6c 2e 20 20 20 41 6c 73 6f 20 6f 62 74 rnal. Also obt
196c0 61 69 6e 0a 20 20 2a 2a 20 73 75 66 66 69 63 69 ain. ** suffici
196d0 65 6e 74 20 73 70 61 63 65 20 28 69 6e 20 7a 4d ent space (in zM
196e0 61 73 74 65 72 50 74 72 29 20 74 6f 20 68 6f 6c asterPtr) to hol
196f0 64 20 74 68 65 20 6e 61 6d 65 73 20 6f 66 20 6d d the names of m
19700 61 73 74 65 72 0a 20 20 2a 2a 20 6a 6f 75 72 6e aster. ** journ
19710 61 6c 20 66 69 6c 65 73 20 65 78 74 72 61 63 74 al files extract
19720 65 64 20 66 72 6f 6d 20 72 65 67 75 6c 61 72 20 ed from regular
19730 72 6f 6c 6c 62 61 63 6b 2d 6a 6f 75 72 6e 61 6c rollback-journal
19740 73 2e 0a 20 20 2a 2f 0a 20 20 72 63 20 3d 20 73 s.. */. rc = s
19750 71 6c 69 74 65 33 4f 73 46 69 6c 65 53 69 7a 65 qlite3OsFileSize
19760 28 70 4d 61 73 74 65 72 2c 20 26 6e 4d 61 73 74 (pMaster, &nMast
19770 65 72 4a 6f 75 72 6e 61 6c 29 3b 0a 20 20 69 66 erJournal);. if
19780 28 20 72 63 21 3d 53 51 4c 49 54 45 5f 4f 4b 20 ( rc!=SQLITE_OK
19790 29 20 67 6f 74 6f 20 64 65 6c 6d 61 73 74 65 72 ) goto delmaster
197a0 5f 6f 75 74 3b 0a 20 20 6e 4d 61 73 74 65 72 50 _out;. nMasterP
197b0 74 72 20 3d 20 70 56 66 73 2d 3e 6d 78 50 61 74 tr = pVfs->mxPat
197c0 68 6e 61 6d 65 2b 31 3b 0a 20 20 7a 4d 61 73 74 hname+1;. zMast
197d0 65 72 4a 6f 75 72 6e 61 6c 20 3d 20 73 71 6c 69 erJournal = sqli
197e0 74 65 33 4d 61 6c 6c 6f 63 28 6e 4d 61 73 74 65 te3Malloc(nMaste
197f0 72 4a 6f 75 72 6e 61 6c 20 2b 20 6e 4d 61 73 74 rJournal + nMast
19800 65 72 50 74 72 20 2b 20 31 29 3b 0a 20 20 69 66 erPtr + 1);. if
19810 28 20 21 7a 4d 61 73 74 65 72 4a 6f 75 72 6e 61 ( !zMasterJourna
19820 6c 20 29 7b 0a 20 20 20 20 72 63 20 3d 20 53 51 l ){. rc = SQ
19830 4c 49 54 45 5f 4e 4f 4d 45 4d 5f 42 4b 50 54 3b LITE_NOMEM_BKPT;
19840 0a 20 20 20 20 67 6f 74 6f 20 64 65 6c 6d 61 73 . goto delmas
19850 74 65 72 5f 6f 75 74 3b 0a 20 20 7d 0a 20 20 7a ter_out;. }. z
19860 4d 61 73 74 65 72 50 74 72 20 3d 20 26 7a 4d 61 MasterPtr = &zMa
19870 73 74 65 72 4a 6f 75 72 6e 61 6c 5b 6e 4d 61 73 sterJournal[nMas
19880 74 65 72 4a 6f 75 72 6e 61 6c 2b 31 5d 3b 0a 20 terJournal+1];.
19890 20 72 63 20 3d 20 73 71 6c 69 74 65 33 4f 73 52 rc = sqlite3OsR
198a0 65 61 64 28 70 4d 61 73 74 65 72 2c 20 7a 4d 61 ead(pMaster, zMa
198b0 73 74 65 72 4a 6f 75 72 6e 61 6c 2c 20 28 69 6e sterJournal, (in
198c0 74 29 6e 4d 61 73 74 65 72 4a 6f 75 72 6e 61 6c t)nMasterJournal
198d0 2c 20 30 29 3b 0a 20 20 69 66 28 20 72 63 21 3d , 0);. if( rc!=
198e0 53 51 4c 49 54 45 5f 4f 4b 20 29 20 67 6f 74 6f SQLITE_OK ) goto
198f0 20 64 65 6c 6d 61 73 74 65 72 5f 6f 75 74 3b 0a delmaster_out;.
19900 20 20 7a 4d 61 73 74 65 72 4a 6f 75 72 6e 61 6c zMasterJournal
19910 5b 6e 4d 61 73 74 65 72 4a 6f 75 72 6e 61 6c 5d [nMasterJournal]
19920 20 3d 20 30 3b 0a 0a 20 20 7a 4a 6f 75 72 6e 61 = 0;.. zJourna
19930 6c 20 3d 20 7a 4d 61 73 74 65 72 4a 6f 75 72 6e l = zMasterJourn
19940 61 6c 3b 0a 20 20 77 68 69 6c 65 28 20 28 7a 4a al;. while( (zJ
19950 6f 75 72 6e 61 6c 2d 7a 4d 61 73 74 65 72 4a 6f ournal-zMasterJo
19960 75 72 6e 61 6c 29 3c 6e 4d 61 73 74 65 72 4a 6f urnal)<nMasterJo
19970 75 72 6e 61 6c 20 29 7b 0a 20 20 20 20 69 6e 74 urnal ){. int
19980 20 65 78 69 73 74 73 3b 0a 20 20 20 20 72 63 20 exists;. rc
19990 3d 20 73 71 6c 69 74 65 33 4f 73 41 63 63 65 73 = sqlite3OsAcces
199a0 73 28 70 56 66 73 2c 20 7a 4a 6f 75 72 6e 61 6c s(pVfs, zJournal
199b0 2c 20 53 51 4c 49 54 45 5f 41 43 43 45 53 53 5f , SQLITE_ACCESS_
199c0 45 58 49 53 54 53 2c 20 26 65 78 69 73 74 73 29 EXISTS, &exists)
199d0 3b 0a 20 20 20 20 69 66 28 20 72 63 21 3d 53 51 ;. if( rc!=SQ
199e0 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 20 LITE_OK ){.
199f0 20 67 6f 74 6f 20 64 65 6c 6d 61 73 74 65 72 5f goto delmaster_
19a00 6f 75 74 3b 0a 20 20 20 20 7d 0a 20 20 20 20 69 out;. }. i
19a10 66 28 20 65 78 69 73 74 73 20 29 7b 0a 20 20 20 f( exists ){.
19a20 20 20 20 2f 2a 20 4f 6e 65 20 6f 66 20 74 68 65 /* One of the
19a30 20 6a 6f 75 72 6e 61 6c 73 20 70 6f 69 6e 74 65 journals pointe
19a40 64 20 74 6f 20 62 79 20 74 68 65 20 6d 61 73 74 d to by the mast
19a50 65 72 20 6a 6f 75 72 6e 61 6c 20 65 78 69 73 74 er journal exist
19a60 73 2e 0a 20 20 20 20 20 20 2a 2a 20 4f 70 65 6e s.. ** Open
19a70 20 69 74 20 61 6e 64 20 63 68 65 63 6b 20 69 66 it and check if
19a80 20 69 74 20 70 6f 69 6e 74 73 20 61 74 20 74 68 it points at th
19a90 65 20 6d 61 73 74 65 72 20 6a 6f 75 72 6e 61 6c e master journal
19aa0 2e 20 49 66 0a 20 20 20 20 20 20 2a 2a 20 73 6f . If. ** so
19ab0 2c 20 72 65 74 75 72 6e 20 77 69 74 68 6f 75 74 , return without
19ac0 20 64 65 6c 65 74 69 6e 67 20 74 68 65 20 6d 61 deleting the ma
19ad0 73 74 65 72 20 6a 6f 75 72 6e 61 6c 20 66 69 6c ster journal fil
19ae0 65 2e 0a 20 20 20 20 20 20 2a 2f 0a 20 20 20 20 e.. */.
19af0 20 20 69 6e 74 20 63 3b 0a 20 20 20 20 20 20 69 int c;. i
19b00 6e 74 20 66 6c 61 67 73 20 3d 20 28 53 51 4c 49 nt flags = (SQLI
19b10 54 45 5f 4f 50 45 4e 5f 52 45 41 44 4f 4e 4c 59 TE_OPEN_READONLY
19b20 7c 53 51 4c 49 54 45 5f 4f 50 45 4e 5f 4d 41 49 |SQLITE_OPEN_MAI
19b30 4e 5f 4a 4f 55 52 4e 41 4c 29 3b 0a 20 20 20 20 N_JOURNAL);.
19b40 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33 4f 73 rc = sqlite3Os
19b50 4f 70 65 6e 28 70 56 66 73 2c 20 7a 4a 6f 75 72 Open(pVfs, zJour
19b60 6e 61 6c 2c 20 70 4a 6f 75 72 6e 61 6c 2c 20 66 nal, pJournal, f
19b70 6c 61 67 73 2c 20 30 29 3b 0a 20 20 20 20 20 20 lags, 0);.
19b80 69 66 28 20 72 63 21 3d 53 51 4c 49 54 45 5f 4f if( rc!=SQLITE_O
19b90 4b 20 29 7b 0a 20 20 20 20 20 20 20 20 67 6f 74 K ){. got
19ba0 6f 20 64 65 6c 6d 61 73 74 65 72 5f 6f 75 74 3b o delmaster_out;
19bb0 0a 20 20 20 20 20 20 7d 0a 0a 20 20 20 20 20 20 . }..
19bc0 72 63 20 3d 20 72 65 61 64 4d 61 73 74 65 72 4a rc = readMasterJ
19bd0 6f 75 72 6e 61 6c 28 70 4a 6f 75 72 6e 61 6c 2c ournal(pJournal,
19be0 20 7a 4d 61 73 74 65 72 50 74 72 2c 20 6e 4d 61 zMasterPtr, nMa
19bf0 73 74 65 72 50 74 72 29 3b 0a 20 20 20 20 20 20 sterPtr);.
19c00 73 71 6c 69 74 65 33 4f 73 43 6c 6f 73 65 28 70 sqlite3OsClose(p
19c10 4a 6f 75 72 6e 61 6c 29 3b 0a 20 20 20 20 20 20 Journal);.
19c20 69 66 28 20 72 63 21 3d 53 51 4c 49 54 45 5f 4f if( rc!=SQLITE_O
19c30 4b 20 29 7b 0a 20 20 20 20 20 20 20 20 67 6f 74 K ){. got
19c40 6f 20 64 65 6c 6d 61 73 74 65 72 5f 6f 75 74 3b o delmaster_out;
19c50 0a 20 20 20 20 20 20 7d 0a 0a 20 20 20 20 20 20 . }..
19c60 63 20 3d 20 7a 4d 61 73 74 65 72 50 74 72 5b 30 c = zMasterPtr[0
19c70 5d 21 3d 30 20 26 26 20 73 74 72 63 6d 70 28 7a ]!=0 && strcmp(z
19c80 4d 61 73 74 65 72 50 74 72 2c 20 7a 4d 61 73 74 MasterPtr, zMast
19c90 65 72 29 3d 3d 30 3b 0a 20 20 20 20 20 20 69 66 er)==0;. if
19ca0 28 20 63 20 29 7b 0a 20 20 20 20 20 20 20 20 2f ( c ){. /
19cb0 2a 20 57 65 20 68 61 76 65 20 61 20 6d 61 74 63 * We have a matc
19cc0 68 2e 20 44 6f 20 6e 6f 74 20 64 65 6c 65 74 65 h. Do not delete
19cd0 20 74 68 65 20 6d 61 73 74 65 72 20 6a 6f 75 72 the master jour
19ce0 6e 61 6c 20 66 69 6c 65 2e 20 2a 2f 0a 20 20 20 nal file. */.
19cf0 20 20 20 20 20 67 6f 74 6f 20 64 65 6c 6d 61 73 goto delmas
19d00 74 65 72 5f 6f 75 74 3b 0a 20 20 20 20 20 20 7d ter_out;. }
19d10 0a 20 20 20 20 7d 0a 20 20 20 20 7a 4a 6f 75 72 . }. zJour
19d20 6e 61 6c 20 2b 3d 20 28 73 71 6c 69 74 65 33 53 nal += (sqlite3S
19d30 74 72 6c 65 6e 33 30 28 7a 4a 6f 75 72 6e 61 6c trlen30(zJournal
19d40 29 2b 31 29 3b 0a 20 20 7d 0a 20 0a 20 20 73 71 )+1);. }. . sq
19d50 6c 69 74 65 33 4f 73 43 6c 6f 73 65 28 70 4d 61 lite3OsClose(pMa
19d60 73 74 65 72 29 3b 0a 20 20 72 63 20 3d 20 73 71 ster);. rc = sq
19d70 6c 69 74 65 33 4f 73 44 65 6c 65 74 65 28 70 56 lite3OsDelete(pV
19d80 66 73 2c 20 7a 4d 61 73 74 65 72 2c 20 30 29 3b fs, zMaster, 0);
19d90 0a 0a 64 65 6c 6d 61 73 74 65 72 5f 6f 75 74 3a ..delmaster_out:
19da0 0a 20 20 73 71 6c 69 74 65 33 5f 66 72 65 65 28 . sqlite3_free(
19db0 7a 4d 61 73 74 65 72 4a 6f 75 72 6e 61 6c 29 3b zMasterJournal);
19dc0 0a 20 20 69 66 28 20 70 4d 61 73 74 65 72 20 29 . if( pMaster )
19dd0 7b 0a 20 20 20 20 73 71 6c 69 74 65 33 4f 73 43 {. sqlite3OsC
19de0 6c 6f 73 65 28 70 4d 61 73 74 65 72 29 3b 0a 20 lose(pMaster);.
19df0 20 20 20 61 73 73 65 72 74 28 20 21 69 73 4f 70 assert( !isOp
19e00 65 6e 28 70 4a 6f 75 72 6e 61 6c 29 20 29 3b 0a en(pJournal) );.
19e10 20 20 20 20 73 71 6c 69 74 65 33 5f 66 72 65 65 sqlite3_free
19e20 28 70 4d 61 73 74 65 72 29 3b 0a 20 20 7d 0a 20 (pMaster);. }.
19e30 20 72 65 74 75 72 6e 20 72 63 3b 0a 7d 0a 0a 0a return rc;.}...
19e40 2f 2a 0a 2a 2a 20 54 68 69 73 20 66 75 6e 63 74 /*.** This funct
19e50 69 6f 6e 20 69 73 20 75 73 65 64 20 74 6f 20 63 ion is used to c
19e60 68 61 6e 67 65 20 74 68 65 20 61 63 74 75 61 6c hange the actual
19e70 20 73 69 7a 65 20 6f 66 20 74 68 65 20 64 61 74 size of the dat
19e80 61 62 61 73 65 20 0a 2a 2a 20 66 69 6c 65 20 69 abase .** file i
19e90 6e 20 74 68 65 20 66 69 6c 65 2d 73 79 73 74 65 n the file-syste
19ea0 6d 2e 20 54 68 69 73 20 6f 6e 6c 79 20 68 61 70 m. This only hap
19eb0 70 65 6e 73 20 77 68 65 6e 20 63 6f 6d 6d 69 74 pens when commit
19ec0 74 69 6e 67 20 61 20 74 72 61 6e 73 61 63 74 69 ting a transacti
19ed0 6f 6e 2c 0a 2a 2a 20 6f 72 20 72 6f 6c 6c 69 6e on,.** or rollin
19ee0 67 20 62 61 63 6b 20 61 20 74 72 61 6e 73 61 63 g back a transac
19ef0 74 69 6f 6e 20 28 69 6e 63 6c 75 64 69 6e 67 20 tion (including
19f00 72 6f 6c 6c 69 6e 67 20 62 61 63 6b 20 61 20 68 rolling back a h
19f10 6f 74 2d 6a 6f 75 72 6e 61 6c 29 2e 0a 2a 2a 0a ot-journal)..**.
19f20 2a 2a 20 49 66 20 74 68 65 20 6d 61 69 6e 20 64 ** If the main d
19f30 61 74 61 62 61 73 65 20 66 69 6c 65 20 69 73 20 atabase file is
19f40 6e 6f 74 20 6f 70 65 6e 2c 20 6f 72 20 74 68 65 not open, or the
19f50 20 70 61 67 65 72 20 69 73 20 6e 6f 74 20 69 6e pager is not in
19f60 20 65 69 74 68 65 72 0a 2a 2a 20 44 42 4d 4f 44 either.** DBMOD
19f70 20 6f 72 20 4f 50 45 4e 20 73 74 61 74 65 2c 20 or OPEN state,
19f80 74 68 69 73 20 66 75 6e 63 74 69 6f 6e 20 69 73 this function is
19f90 20 61 20 6e 6f 2d 6f 70 2e 20 4f 74 68 65 72 77 a no-op. Otherw
19fa0 69 73 65 2c 20 74 68 65 20 73 69 7a 65 20 0a 2a ise, the size .*
19fb0 2a 20 6f 66 20 74 68 65 20 66 69 6c 65 20 69 73 * of the file is
19fc0 20 63 68 61 6e 67 65 64 20 74 6f 20 6e 50 61 67 changed to nPag
19fd0 65 20 70 61 67 65 73 20 28 6e 50 61 67 65 2a 70 e pages (nPage*p
19fe0 50 61 67 65 72 2d 3e 70 61 67 65 53 69 7a 65 20 Pager->pageSize
19ff0 62 79 74 65 73 29 2e 20 0a 2a 2a 20 49 66 20 74 bytes). .** If t
1a000 68 65 20 66 69 6c 65 20 6f 6e 20 64 69 73 6b 20 he file on disk
1a010 69 73 20 63 75 72 72 65 6e 74 6c 79 20 6c 61 72 is currently lar
1a020 67 65 72 20 74 68 61 6e 20 6e 50 61 67 65 20 70 ger than nPage p
1a030 61 67 65 73 2c 20 74 68 65 6e 20 75 73 65 20 74 ages, then use t
1a040 68 65 20 56 46 53 0a 2a 2a 20 78 54 72 75 6e 63 he VFS.** xTrunc
1a050 61 74 65 28 29 20 6d 65 74 68 6f 64 20 74 6f 20 ate() method to
1a060 74 72 75 6e 63 61 74 65 20 69 74 2e 0a 2a 2a 0a truncate it..**.
1a070 2a 2a 20 4f 72 2c 20 69 74 20 6d 69 67 68 74 20 ** Or, it might
1a080 62 65 20 74 68 65 20 63 61 73 65 20 74 68 61 74 be the case that
1a090 20 74 68 65 20 66 69 6c 65 20 6f 6e 20 64 69 73 the file on dis
1a0a0 6b 20 69 73 20 73 6d 61 6c 6c 65 72 20 74 68 61 k is smaller tha
1a0b0 6e 20 0a 2a 2a 20 6e 50 61 67 65 20 70 61 67 65 n .** nPage page
1a0c0 73 2e 20 53 6f 6d 65 20 6f 70 65 72 61 74 69 6e s. Some operatin
1a0d0 67 20 73 79 73 74 65 6d 20 69 6d 70 6c 65 6d 65 g system impleme
1a0e0 6e 74 61 74 69 6f 6e 73 20 63 61 6e 20 67 65 74 ntations can get
1a0f0 20 63 6f 6e 66 75 73 65 64 20 69 66 20 0a 2a 2a confused if .**
1a100 20 79 6f 75 20 74 72 79 20 74 6f 20 74 72 75 6e you try to trun
1a110 63 61 74 65 20 61 20 66 69 6c 65 20 74 6f 20 73 cate a file to s
1a120 6f 6d 65 20 73 69 7a 65 20 74 68 61 74 20 69 73 ome size that is
1a130 20 6c 61 72 67 65 72 20 74 68 61 6e 20 69 74 20 larger than it
1a140 0a 2a 2a 20 63 75 72 72 65 6e 74 6c 79 20 69 73 .** currently is
1a150 2c 20 73 6f 20 64 65 74 65 63 74 20 74 68 69 73 , so detect this
1a160 20 63 61 73 65 20 61 6e 64 20 77 72 69 74 65 20 case and write
1a170 61 20 73 69 6e 67 6c 65 20 7a 65 72 6f 20 62 79 a single zero by
1a180 74 65 20 74 6f 20 0a 2a 2a 20 74 68 65 20 65 6e te to .** the en
1a190 64 20 6f 66 20 74 68 65 20 6e 65 77 20 66 69 6c d of the new fil
1a1a0 65 20 69 6e 73 74 65 61 64 2e 0a 2a 2a 0a 2a 2a e instead..**.**
1a1b0 20 49 66 20 73 75 63 63 65 73 73 66 75 6c 2c 20 If successful,
1a1c0 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b return SQLITE_OK
1a1d0 2e 20 49 66 20 61 6e 20 49 4f 20 65 72 72 6f 72 . If an IO error
1a1e0 20 6f 63 63 75 72 73 20 77 68 69 6c 65 20 6d 6f occurs while mo
1a1f0 64 69 66 79 69 6e 67 0a 2a 2a 20 74 68 65 20 64 difying.** the d
1a200 61 74 61 62 61 73 65 20 66 69 6c 65 2c 20 72 65 atabase file, re
1a210 74 75 72 6e 20 74 68 65 20 65 72 72 6f 72 20 63 turn the error c
1a220 6f 64 65 20 74 6f 20 74 68 65 20 63 61 6c 6c 65 ode to the calle
1a230 72 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74 r..*/.static int
1a240 20 70 61 67 65 72 5f 74 72 75 6e 63 61 74 65 28 pager_truncate(
1a250 50 61 67 65 72 20 2a 70 50 61 67 65 72 2c 20 50 Pager *pPager, P
1a260 67 6e 6f 20 6e 50 61 67 65 29 7b 0a 20 20 69 6e gno nPage){. in
1a270 74 20 72 63 20 3d 20 53 51 4c 49 54 45 5f 4f 4b t rc = SQLITE_OK
1a280 3b 0a 20 20 61 73 73 65 72 74 28 20 70 50 61 67 ;. assert( pPag
1a290 65 72 2d 3e 65 53 74 61 74 65 21 3d 50 41 47 45 er->eState!=PAGE
1a2a0 52 5f 45 52 52 4f 52 20 29 3b 0a 20 20 61 73 73 R_ERROR );. ass
1a2b0 65 72 74 28 20 70 50 61 67 65 72 2d 3e 65 53 74 ert( pPager->eSt
1a2c0 61 74 65 21 3d 50 41 47 45 52 5f 52 45 41 44 45 ate!=PAGER_READE
1a2d0 52 20 29 3b 0a 20 20 0a 20 20 69 66 28 20 69 73 R );. . if( is
1a2e0 4f 70 65 6e 28 70 50 61 67 65 72 2d 3e 66 64 29 Open(pPager->fd)
1a2f0 20 0a 20 20 20 26 26 20 28 70 50 61 67 65 72 2d . && (pPager-
1a300 3e 65 53 74 61 74 65 3e 3d 50 41 47 45 52 5f 57 >eState>=PAGER_W
1a310 52 49 54 45 52 5f 44 42 4d 4f 44 20 7c 7c 20 70 RITER_DBMOD || p
1a320 50 61 67 65 72 2d 3e 65 53 74 61 74 65 3d 3d 50 Pager->eState==P
1a330 41 47 45 52 5f 4f 50 45 4e 29 20 0a 20 20 29 7b AGER_OPEN) . ){
1a340 0a 20 20 20 20 69 36 34 20 63 75 72 72 65 6e 74 . i64 current
1a350 53 69 7a 65 2c 20 6e 65 77 53 69 7a 65 3b 0a 20 Size, newSize;.
1a360 20 20 20 69 6e 74 20 73 7a 50 61 67 65 20 3d 20 int szPage =
1a370 70 50 61 67 65 72 2d 3e 70 61 67 65 53 69 7a 65 pPager->pageSize
1a380 3b 0a 20 20 20 20 61 73 73 65 72 74 28 20 70 50 ;. assert( pP
1a390 61 67 65 72 2d 3e 65 4c 6f 63 6b 3d 3d 45 58 43 ager->eLock==EXC
1a3a0 4c 55 53 49 56 45 5f 4c 4f 43 4b 20 29 3b 0a 20 LUSIVE_LOCK );.
1a3b0 20 20 20 2f 2a 20 54 4f 44 4f 3a 20 49 73 20 69 /* TODO: Is i
1a3c0 74 20 73 61 66 65 20 74 6f 20 75 73 65 20 50 61 t safe to use Pa
1a3d0 67 65 72 2e 64 62 46 69 6c 65 53 69 7a 65 20 68 ger.dbFileSize h
1a3e0 65 72 65 3f 20 2a 2f 0a 20 20 20 20 72 63 20 3d ere? */. rc =
1a3f0 20 73 71 6c 69 74 65 33 4f 73 46 69 6c 65 53 69 sqlite3OsFileSi
1a400 7a 65 28 70 50 61 67 65 72 2d 3e 66 64 2c 20 26 ze(pPager->fd, &
1a410 63 75 72 72 65 6e 74 53 69 7a 65 29 3b 0a 20 20 currentSize);.
1a420 20 20 6e 65 77 53 69 7a 65 20 3d 20 73 7a 50 61 newSize = szPa
1a430 67 65 2a 28 69 36 34 29 6e 50 61 67 65 3b 0a 20 ge*(i64)nPage;.
1a440 20 20 20 69 66 28 20 72 63 3d 3d 53 51 4c 49 54 if( rc==SQLIT
1a450 45 5f 4f 4b 20 26 26 20 63 75 72 72 65 6e 74 53 E_OK && currentS
1a460 69 7a 65 21 3d 6e 65 77 53 69 7a 65 20 29 7b 0a ize!=newSize ){.
1a470 20 20 20 20 20 20 69 66 28 20 63 75 72 72 65 6e if( curren
1a480 74 53 69 7a 65 3e 6e 65 77 53 69 7a 65 20 29 7b tSize>newSize ){
1a490 0a 20 20 20 20 20 20 20 20 72 63 20 3d 20 73 71 . rc = sq
1a4a0 6c 69 74 65 33 4f 73 54 72 75 6e 63 61 74 65 28 lite3OsTruncate(
1a4b0 70 50 61 67 65 72 2d 3e 66 64 2c 20 6e 65 77 53 pPager->fd, newS
1a4c0 69 7a 65 29 3b 0a 20 20 20 20 20 20 7d 65 6c 73 ize);. }els
1a4d0 65 20 69 66 28 20 28 63 75 72 72 65 6e 74 53 69 e if( (currentSi
1a4e0 7a 65 2b 73 7a 50 61 67 65 29 3c 3d 6e 65 77 53 ze+szPage)<=newS
1a4f0 69 7a 65 20 29 7b 0a 20 20 20 20 20 20 20 20 63 ize ){. c
1a500 68 61 72 20 2a 70 54 6d 70 20 3d 20 70 50 61 67 har *pTmp = pPag
1a510 65 72 2d 3e 70 54 6d 70 53 70 61 63 65 3b 0a 20 er->pTmpSpace;.
1a520 20 20 20 20 20 20 20 6d 65 6d 73 65 74 28 70 54 memset(pT
1a530 6d 70 2c 20 30 2c 20 73 7a 50 61 67 65 29 3b 0a mp, 0, szPage);.
1a540 20 20 20 20 20 20 20 20 74 65 73 74 63 61 73 65 testcase
1a550 28 20 28 6e 65 77 53 69 7a 65 2d 73 7a 50 61 67 ( (newSize-szPag
1a560 65 29 20 3d 3d 20 63 75 72 72 65 6e 74 53 69 7a e) == currentSiz
1a570 65 20 29 3b 0a 20 20 20 20 20 20 20 20 74 65 73 e );. tes
1a580 74 63 61 73 65 28 20 28 6e 65 77 53 69 7a 65 2d tcase( (newSize-
1a590 73 7a 50 61 67 65 29 20 3e 20 20 63 75 72 72 65 szPage) > curre
1a5a0 6e 74 53 69 7a 65 20 29 3b 0a 20 20 20 20 20 20 ntSize );.
1a5b0 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33 4f 73 rc = sqlite3Os
1a5c0 57 72 69 74 65 28 70 50 61 67 65 72 2d 3e 66 64 Write(pPager->fd
1a5d0 2c 20 70 54 6d 70 2c 20 73 7a 50 61 67 65 2c 20 , pTmp, szPage,
1a5e0 6e 65 77 53 69 7a 65 2d 73 7a 50 61 67 65 29 3b newSize-szPage);
1a5f0 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 69 . }. i
1a600 66 28 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b f( rc==SQLITE_OK
1a610 20 29 7b 0a 20 20 20 20 20 20 20 20 70 50 61 67 ){. pPag
1a620 65 72 2d 3e 64 62 46 69 6c 65 53 69 7a 65 20 3d er->dbFileSize =
1a630 20 6e 50 61 67 65 3b 0a 20 20 20 20 20 20 7d 0a nPage;. }.
1a640 20 20 20 20 7d 0a 20 20 7d 0a 20 20 72 65 74 75 }. }. retu
1a650 72 6e 20 72 63 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 rn rc;.}../*.**
1a660 52 65 74 75 72 6e 20 61 20 73 61 6e 69 74 69 7a Return a sanitiz
1a670 65 64 20 76 65 72 73 69 6f 6e 20 6f 66 20 74 68 ed version of th
1a680 65 20 73 65 63 74 6f 72 2d 73 69 7a 65 20 6f 66 e sector-size of
1a690 20 4f 53 20 66 69 6c 65 20 70 46 69 6c 65 2e 20 OS file pFile.
1a6a0 54 68 65 0a 2a 2a 20 72 65 74 75 72 6e 20 76 61 The.** return va
1a6b0 6c 75 65 20 69 73 20 67 75 61 72 61 6e 74 65 65 lue is guarantee
1a6c0 64 20 74 6f 20 6c 69 65 20 62 65 74 77 65 65 6e d to lie between
1a6d0 20 33 32 20 61 6e 64 20 4d 41 58 5f 53 45 43 54 32 and MAX_SECT
1a6e0 4f 52 5f 53 49 5a 45 2e 0a 2a 2f 0a 69 6e 74 20 OR_SIZE..*/.int
1a6f0 73 71 6c 69 74 65 33 53 65 63 74 6f 72 53 69 7a sqlite3SectorSiz
1a700 65 28 73 71 6c 69 74 65 33 5f 66 69 6c 65 20 2a e(sqlite3_file *
1a710 70 46 69 6c 65 29 7b 0a 20 20 69 6e 74 20 69 52 pFile){. int iR
1a720 65 74 20 3d 20 73 71 6c 69 74 65 33 4f 73 53 65 et = sqlite3OsSe
1a730 63 74 6f 72 53 69 7a 65 28 70 46 69 6c 65 29 3b ctorSize(pFile);
1a740 0a 20 20 69 66 28 20 69 52 65 74 3c 33 32 20 29 . if( iRet<32 )
1a750 7b 0a 20 20 20 20 69 52 65 74 20 3d 20 35 31 32 {. iRet = 512
1a760 3b 0a 20 20 7d 65 6c 73 65 20 69 66 28 20 69 52 ;. }else if( iR
1a770 65 74 3e 4d 41 58 5f 53 45 43 54 4f 52 5f 53 49 et>MAX_SECTOR_SI
1a780 5a 45 20 29 7b 0a 20 20 20 20 61 73 73 65 72 74 ZE ){. assert
1a790 28 20 4d 41 58 5f 53 45 43 54 4f 52 5f 53 49 5a ( MAX_SECTOR_SIZ
1a7a0 45 3e 3d 35 31 32 20 29 3b 0a 20 20 20 20 69 52 E>=512 );. iR
1a7b0 65 74 20 3d 20 4d 41 58 5f 53 45 43 54 4f 52 5f et = MAX_SECTOR_
1a7c0 53 49 5a 45 3b 0a 20 20 7d 0a 20 20 72 65 74 75 SIZE;. }. retu
1a7d0 72 6e 20 69 52 65 74 3b 0a 7d 0a 0a 2f 2a 0a 2a rn iRet;.}../*.*
1a7e0 2a 20 53 65 74 20 74 68 65 20 76 61 6c 75 65 20 * Set the value
1a7f0 6f 66 20 74 68 65 20 50 61 67 65 72 2e 73 65 63 of the Pager.sec
1a800 74 6f 72 53 69 7a 65 20 76 61 72 69 61 62 6c 65 torSize variable
1a810 20 66 6f 72 20 74 68 65 20 67 69 76 65 6e 0a 2a for the given.*
1a820 2a 20 70 61 67 65 72 20 62 61 73 65 64 20 6f 6e * pager based on
1a830 20 74 68 65 20 76 61 6c 75 65 20 72 65 74 75 72 the value retur
1a840 6e 65 64 20 62 79 20 74 68 65 20 78 53 65 63 74 ned by the xSect
1a850 6f 72 53 69 7a 65 20 6d 65 74 68 6f 64 0a 2a 2a orSize method.**
1a860 20 6f 66 20 74 68 65 20 6f 70 65 6e 20 64 61 74 of the open dat
1a870 61 62 61 73 65 20 66 69 6c 65 2e 20 54 68 65 20 abase file. The
1a880 73 65 63 74 6f 72 20 73 69 7a 65 20 77 69 6c 6c sector size will
1a890 20 62 65 20 75 73 65 64 20 0a 2a 2a 20 74 6f 20 be used .** to
1a8a0 64 65 74 65 72 6d 69 6e 65 20 74 68 65 20 73 69 determine the si
1a8b0 7a 65 20 61 6e 64 20 61 6c 69 67 6e 6d 65 6e 74 ze and alignment
1a8c0 20 6f 66 20 6a 6f 75 72 6e 61 6c 20 68 65 61 64 of journal head
1a8d0 65 72 20 61 6e 64 20 0a 2a 2a 20 6d 61 73 74 65 er and .** maste
1a8e0 72 20 6a 6f 75 72 6e 61 6c 20 70 6f 69 6e 74 65 r journal pointe
1a8f0 72 73 20 77 69 74 68 69 6e 20 63 72 65 61 74 65 rs within create
1a900 64 20 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 73 2e d journal files.
1a910 0a 2a 2a 0a 2a 2a 20 46 6f 72 20 74 65 6d 70 6f .**.** For tempo
1a920 72 61 72 79 20 66 69 6c 65 73 20 74 68 65 20 65 rary files the e
1a930 66 66 65 63 74 69 76 65 20 73 65 63 74 6f 72 20 ffective sector
1a940 73 69 7a 65 20 69 73 20 61 6c 77 61 79 73 20 35 size is always 5
1a950 31 32 20 62 79 74 65 73 2e 0a 2a 2a 0a 2a 2a 20 12 bytes..**.**
1a960 4f 74 68 65 72 77 69 73 65 2c 20 66 6f 72 20 6e Otherwise, for n
1a970 6f 6e 2d 74 65 6d 70 6f 72 61 72 79 20 66 69 6c on-temporary fil
1a980 65 73 2c 20 74 68 65 20 65 66 66 65 63 74 69 76 es, the effectiv
1a990 65 20 73 65 63 74 6f 72 20 73 69 7a 65 20 69 73 e sector size is
1a9a0 0a 2a 2a 20 74 68 65 20 76 61 6c 75 65 20 72 65 .** the value re
1a9b0 74 75 72 6e 65 64 20 62 79 20 74 68 65 20 78 53 turned by the xS
1a9c0 65 63 74 6f 72 53 69 7a 65 28 29 20 6d 65 74 68 ectorSize() meth
1a9d0 6f 64 20 72 6f 75 6e 64 65 64 20 75 70 20 74 6f od rounded up to
1a9e0 20 33 32 20 69 66 0a 2a 2a 20 69 74 20 69 73 20 32 if.** it is
1a9f0 6c 65 73 73 20 74 68 61 6e 20 33 32 2c 20 6f 72 less than 32, or
1aa00 20 72 6f 75 6e 64 65 64 20 64 6f 77 6e 20 74 6f rounded down to
1aa10 20 4d 41 58 5f 53 45 43 54 4f 52 5f 53 49 5a 45 MAX_SECTOR_SIZE
1aa20 20 69 66 20 69 74 0a 2a 2a 20 69 73 20 67 72 65 if it.** is gre
1aa30 61 74 65 72 20 74 68 61 6e 20 4d 41 58 5f 53 45 ater than MAX_SE
1aa40 43 54 4f 52 5f 53 49 5a 45 2e 0a 2a 2a 0a 2a 2a CTOR_SIZE..**.**
1aa50 20 49 66 20 74 68 65 20 66 69 6c 65 20 68 61 73 If the file has
1aa60 20 74 68 65 20 53 51 4c 49 54 45 5f 49 4f 43 41 the SQLITE_IOCA
1aa70 50 5f 50 4f 57 45 52 53 41 46 45 5f 4f 56 45 52 P_POWERSAFE_OVER
1aa80 57 52 49 54 45 20 70 72 6f 70 65 72 74 79 2c 20 WRITE property,
1aa90 74 68 65 6e 20 73 65 74 0a 2a 2a 20 74 68 65 20 then set.** the
1aaa0 65 66 66 65 63 74 69 76 65 20 73 65 63 74 6f 72 effective sector
1aab0 20 73 69 7a 65 20 74 6f 20 69 74 73 20 6d 69 6e size to its min
1aac0 69 6d 75 6d 20 76 61 6c 75 65 20 28 35 31 32 29 imum value (512)
1aad0 2e 20 20 54 68 65 20 70 75 72 70 6f 73 65 20 6f . The purpose o
1aae0 66 0a 2a 2a 20 70 50 61 67 65 72 2d 3e 73 65 63 f.** pPager->sec
1aaf0 74 6f 72 53 69 7a 65 20 69 73 20 74 6f 20 64 65 torSize is to de
1ab00 66 69 6e 65 20 74 68 65 20 22 62 6c 61 73 74 20 fine the "blast
1ab10 72 61 64 69 75 73 22 20 6f 66 20 62 79 74 65 73 radius" of bytes
1ab20 20 74 68 61 74 0a 2a 2a 20 6d 69 67 68 74 20 63 that.** might c
1ab30 68 61 6e 67 65 20 69 66 20 61 20 63 72 61 73 68 hange if a crash
1ab40 20 6f 63 63 75 72 73 20 77 68 69 6c 65 20 77 72 occurs while wr
1ab50 69 74 69 6e 67 20 74 6f 20 61 20 73 69 6e 67 6c iting to a singl
1ab60 65 20 62 79 74 65 20 69 6e 0a 2a 2a 20 74 68 61 e byte in.** tha
1ab70 74 20 72 61 6e 67 65 2e 20 20 42 75 74 20 77 69 t range. But wi
1ab80 74 68 20 50 4f 57 45 52 53 41 46 45 5f 4f 56 45 th POWERSAFE_OVE
1ab90 52 57 52 49 54 45 2c 20 74 68 65 20 62 6c 61 73 RWRITE, the blas
1aba0 74 20 72 61 64 69 75 73 20 69 73 20 7a 65 72 6f t radius is zero
1abb0 0a 2a 2a 20 28 74 68 61 74 20 69 73 20 77 68 61 .** (that is wha
1abc0 74 20 50 4f 57 45 52 53 41 46 45 5f 4f 56 45 52 t POWERSAFE_OVER
1abd0 57 52 49 54 45 20 6d 65 61 6e 73 29 2c 20 73 6f WRITE means), so
1abe0 20 77 65 20 6d 69 6e 69 6d 69 7a 65 20 74 68 65 we minimize the
1abf0 20 73 65 63 74 6f 72 0a 2a 2a 20 73 69 7a 65 2e sector.** size.
1ac00 20 20 46 6f 72 20 62 61 63 6b 77 61 72 64 73 20 For backwards
1ac10 63 6f 6d 70 61 74 69 62 69 6c 69 74 79 20 6f 66 compatibility of
1ac20 20 74 68 65 20 72 6f 6c 6c 62 61 63 6b 20 6a 6f the rollback jo
1ac30 75 72 6e 61 6c 20 66 69 6c 65 20 66 6f 72 6d 61 urnal file forma
1ac40 74 2c 0a 2a 2a 20 77 65 20 63 61 6e 6e 6f 74 20 t,.** we cannot
1ac50 72 65 64 75 63 65 20 74 68 65 20 65 66 66 65 63 reduce the effec
1ac60 74 69 76 65 20 73 65 63 74 6f 72 20 73 69 7a 65 tive sector size
1ac70 20 62 65 6c 6f 77 20 35 31 32 2e 0a 2a 2f 0a 73 below 512..*/.s
1ac80 74 61 74 69 63 20 76 6f 69 64 20 73 65 74 53 65 tatic void setSe
1ac90 63 74 6f 72 53 69 7a 65 28 50 61 67 65 72 20 2a ctorSize(Pager *
1aca0 70 50 61 67 65 72 29 7b 0a 20 20 61 73 73 65 72 pPager){. asser
1acb0 74 28 20 69 73 4f 70 65 6e 28 70 50 61 67 65 72 t( isOpen(pPager
1acc0 2d 3e 66 64 29 20 7c 7c 20 70 50 61 67 65 72 2d ->fd) || pPager-
1acd0 3e 74 65 6d 70 46 69 6c 65 20 29 3b 0a 0a 20 20 >tempFile );..
1ace0 69 66 28 20 70 50 61 67 65 72 2d 3e 74 65 6d 70 if( pPager->temp
1acf0 46 69 6c 65 0a 20 20 20 7c 7c 20 28 73 71 6c 69 File. || (sqli
1ad00 74 65 33 4f 73 44 65 76 69 63 65 43 68 61 72 61 te3OsDeviceChara
1ad10 63 74 65 72 69 73 74 69 63 73 28 70 50 61 67 65 cteristics(pPage
1ad20 72 2d 3e 66 64 29 20 26 20 0a 20 20 20 20 20 20 r->fd) & .
1ad30 20 20 20 20 20 20 20 20 53 51 4c 49 54 45 5f 49 SQLITE_I
1ad40 4f 43 41 50 5f 50 4f 57 45 52 53 41 46 45 5f 4f OCAP_POWERSAFE_O
1ad50 56 45 52 57 52 49 54 45 29 21 3d 30 0a 20 20 29 VERWRITE)!=0. )
1ad60 7b 0a 20 20 20 20 2f 2a 20 53 65 63 74 6f 72 20 {. /* Sector
1ad70 73 69 7a 65 20 64 6f 65 73 6e 27 74 20 6d 61 74 size doesn't mat
1ad80 74 65 72 20 66 6f 72 20 74 65 6d 70 6f 72 61 72 ter for temporar
1ad90 79 20 66 69 6c 65 73 2e 20 41 6c 73 6f 2c 20 74 y files. Also, t
1ada0 68 65 20 66 69 6c 65 0a 20 20 20 20 2a 2a 20 6d he file. ** m
1adb0 61 79 20 6e 6f 74 20 68 61 76 65 20 62 65 65 6e ay not have been
1adc0 20 6f 70 65 6e 65 64 20 79 65 74 2c 20 69 6e 20 opened yet, in
1add0 77 68 69 63 68 20 63 61 73 65 20 74 68 65 20 4f which case the O
1ade0 73 53 65 63 74 6f 72 53 69 7a 65 28 29 0a 20 20 sSectorSize().
1adf0 20 20 2a 2a 20 63 61 6c 6c 20 77 69 6c 6c 20 73 ** call will s
1ae00 65 67 66 61 75 6c 74 2e 20 2a 2f 0a 20 20 20 20 egfault. */.
1ae10 70 50 61 67 65 72 2d 3e 73 65 63 74 6f 72 53 69 pPager->sectorSi
1ae20 7a 65 20 3d 20 35 31 32 3b 0a 20 20 7d 65 6c 73 ze = 512;. }els
1ae30 65 7b 0a 20 20 20 20 70 50 61 67 65 72 2d 3e 73 e{. pPager->s
1ae40 65 63 74 6f 72 53 69 7a 65 20 3d 20 73 71 6c 69 ectorSize = sqli
1ae50 74 65 33 53 65 63 74 6f 72 53 69 7a 65 28 70 50 te3SectorSize(pP
1ae60 61 67 65 72 2d 3e 66 64 29 3b 0a 20 20 7d 0a 7d ager->fd);. }.}
1ae70 0a 0a 2f 2a 0a 2a 2a 20 50 6c 61 79 62 61 63 6b ../*.** Playback
1ae80 20 74 68 65 20 6a 6f 75 72 6e 61 6c 20 61 6e 64 the journal and
1ae90 20 74 68 75 73 20 72 65 73 74 6f 72 65 20 74 68 thus restore th
1aea0 65 20 64 61 74 61 62 61 73 65 20 66 69 6c 65 20 e database file
1aeb0 74 6f 0a 2a 2a 20 74 68 65 20 73 74 61 74 65 20 to.** the state
1aec0 69 74 20 77 61 73 20 69 6e 20 62 65 66 6f 72 65 it was in before
1aed0 20 77 65 20 73 74 61 72 74 65 64 20 6d 61 6b 69 we started maki
1aee0 6e 67 20 63 68 61 6e 67 65 73 2e 20 20 0a 2a 2a ng changes. .**
1aef0 0a 2a 2a 20 54 68 65 20 6a 6f 75 72 6e 61 6c 20 .** The journal
1af00 66 69 6c 65 20 66 6f 72 6d 61 74 20 69 73 20 61 file format is a
1af10 73 20 66 6f 6c 6c 6f 77 73 3a 20 0a 2a 2a 0a 2a s follows: .**.*
1af20 2a 20 20 28 31 29 20 20 38 20 62 79 74 65 20 70 * (1) 8 byte p
1af30 72 65 66 69 78 2e 20 20 41 20 63 6f 70 79 20 6f refix. A copy o
1af40 66 20 61 4a 6f 75 72 6e 61 6c 4d 61 67 69 63 5b f aJournalMagic[
1af50 5d 2e 0a 2a 2a 20 20 28 32 29 20 20 34 20 62 79 ]..** (2) 4 by
1af60 74 65 20 62 69 67 2d 65 6e 64 69 61 6e 20 69 6e te big-endian in
1af70 74 65 67 65 72 20 77 68 69 63 68 20 69 73 20 74 teger which is t
1af80 68 65 20 6e 75 6d 62 65 72 20 6f 66 20 76 61 6c he number of val
1af90 69 64 20 70 61 67 65 20 72 65 63 6f 72 64 73 0a id page records.
1afa0 2a 2a 20 20 20 20 20 20 20 69 6e 20 74 68 65 20 ** in the
1afb0 6a 6f 75 72 6e 61 6c 2e 20 20 49 66 20 74 68 69 journal. If thi
1afc0 73 20 76 61 6c 75 65 20 69 73 20 30 78 66 66 66 s value is 0xfff
1afd0 66 66 66 66 66 2c 20 74 68 65 6e 20 63 6f 6d 70 fffff, then comp
1afe0 75 74 65 20 74 68 65 0a 2a 2a 20 20 20 20 20 20 ute the.**
1aff0 20 6e 75 6d 62 65 72 20 6f 66 20 70 61 67 65 20 number of page
1b000 72 65 63 6f 72 64 73 20 66 72 6f 6d 20 74 68 65 records from the
1b010 20 6a 6f 75 72 6e 61 6c 20 73 69 7a 65 2e 0a 2a journal size..*
1b020 2a 20 20 28 33 29 20 20 34 20 62 79 74 65 20 62 * (3) 4 byte b
1b030 69 67 2d 65 6e 64 69 61 6e 20 69 6e 74 65 67 65 ig-endian intege
1b040 72 20 77 68 69 63 68 20 69 73 20 74 68 65 20 69 r which is the i
1b050 6e 69 74 69 61 6c 20 76 61 6c 75 65 20 66 6f 72 nitial value for
1b060 20 74 68 65 20 0a 2a 2a 20 20 20 20 20 20 20 73 the .** s
1b070 61 6e 69 74 79 20 63 68 65 63 6b 73 75 6d 2e 0a anity checksum..
1b080 2a 2a 20 20 28 34 29 20 20 34 20 62 79 74 65 20 ** (4) 4 byte
1b090 69 6e 74 65 67 65 72 20 77 68 69 63 68 20 69 73 integer which is
1b0a0 20 74 68 65 20 6e 75 6d 62 65 72 20 6f 66 20 70 the number of p
1b0b0 61 67 65 73 20 74 6f 20 74 72 75 6e 63 61 74 65 ages to truncate
1b0c0 20 74 68 65 0a 2a 2a 20 20 20 20 20 20 20 64 61 the.** da
1b0d0 74 61 62 61 73 65 20 74 6f 20 64 75 72 69 6e 67 tabase to during
1b0e0 20 61 20 72 6f 6c 6c 62 61 63 6b 2e 0a 2a 2a 20 a rollback..**
1b0f0 20 28 35 29 20 20 34 20 62 79 74 65 20 62 69 67 (5) 4 byte big
1b100 2d 65 6e 64 69 61 6e 20 69 6e 74 65 67 65 72 20 -endian integer
1b110 77 68 69 63 68 20 69 73 20 74 68 65 20 73 65 63 which is the sec
1b120 74 6f 72 20 73 69 7a 65 2e 20 20 54 68 65 20 68 tor size. The h
1b130 65 61 64 65 72 0a 2a 2a 20 20 20 20 20 20 20 69 eader.** i
1b140 73 20 74 68 69 73 20 6d 61 6e 79 20 62 79 74 65 s this many byte
1b150 73 20 69 6e 20 73 69 7a 65 2e 0a 2a 2a 20 20 28 s in size..** (
1b160 36 29 20 20 34 20 62 79 74 65 20 62 69 67 2d 65 6) 4 byte big-e
1b170 6e 64 69 61 6e 20 69 6e 74 65 67 65 72 20 77 68 ndian integer wh
1b180 69 63 68 20 69 73 20 74 68 65 20 70 61 67 65 20 ich is the page
1b190 73 69 7a 65 2e 0a 2a 2a 20 20 28 37 29 20 20 7a size..** (7) z
1b1a0 65 72 6f 20 70 61 64 64 69 6e 67 20 6f 75 74 20 ero padding out
1b1b0 74 6f 20 74 68 65 20 6e 65 78 74 20 73 65 63 74 to the next sect
1b1c0 6f 72 20 73 69 7a 65 2e 0a 2a 2a 20 20 28 38 29 or size..** (8)
1b1d0 20 20 5a 65 72 6f 20 6f 72 20 6d 6f 72 65 20 70 Zero or more p
1b1e0 61 67 65 73 20 69 6e 73 74 61 6e 63 65 73 2c 20 ages instances,
1b1f0 65 61 63 68 20 61 73 20 66 6f 6c 6c 6f 77 73 3a each as follows:
1b200 0a 2a 2a 20 20 20 20 20 20 20 20 2b 20 20 34 20 .** + 4
1b210 62 79 74 65 20 70 61 67 65 20 6e 75 6d 62 65 72 byte page number
1b220 2e 0a 2a 2a 20 20 20 20 20 20 20 20 2b 20 20 70 ..** + p
1b230 50 61 67 65 72 2d 3e 70 61 67 65 53 69 7a 65 20 Pager->pageSize
1b240 62 79 74 65 73 20 6f 66 20 64 61 74 61 2e 0a 2a bytes of data..*
1b250 2a 20 20 20 20 20 20 20 20 2b 20 20 34 20 62 79 * + 4 by
1b260 74 65 20 63 68 65 63 6b 73 75 6d 0a 2a 2a 0a 2a te checksum.**.*
1b270 2a 20 57 68 65 6e 20 77 65 20 73 70 65 61 6b 20 * When we speak
1b280 6f 66 20 74 68 65 20 6a 6f 75 72 6e 61 6c 20 68 of the journal h
1b290 65 61 64 65 72 2c 20 77 65 20 6d 65 61 6e 20 74 eader, we mean t
1b2a0 68 65 20 66 69 72 73 74 20 37 20 69 74 65 6d 73 he first 7 items
1b2b0 20 61 62 6f 76 65 2e 0a 2a 2a 20 45 61 63 68 20 above..** Each
1b2c0 65 6e 74 72 79 20 69 6e 20 74 68 65 20 6a 6f 75 entry in the jou
1b2d0 72 6e 61 6c 20 69 73 20 61 6e 20 69 6e 73 74 61 rnal is an insta
1b2e0 6e 63 65 20 6f 66 20 74 68 65 20 38 74 68 20 69 nce of the 8th i
1b2f0 74 65 6d 2e 0a 2a 2a 0a 2a 2a 20 43 61 6c 6c 20 tem..**.** Call
1b300 74 68 65 20 76 61 6c 75 65 20 66 72 6f 6d 20 74 the value from t
1b310 68 65 20 73 65 63 6f 6e 64 20 62 75 6c 6c 65 74 he second bullet
1b320 20 22 6e 52 65 63 22 2e 20 20 6e 52 65 63 20 69 "nRec". nRec i
1b330 73 20 74 68 65 20 6e 75 6d 62 65 72 20 6f 66 0a s the number of.
1b340 2a 2a 20 76 61 6c 69 64 20 70 61 67 65 20 65 6e ** valid page en
1b350 74 72 69 65 73 20 69 6e 20 74 68 65 20 6a 6f 75 tries in the jou
1b360 72 6e 61 6c 2e 20 20 49 6e 20 6d 6f 73 74 20 63 rnal. In most c
1b370 61 73 65 73 2c 20 79 6f 75 20 63 61 6e 20 63 6f ases, you can co
1b380 6d 70 75 74 65 20 74 68 65 0a 2a 2a 20 76 61 6c mpute the.** val
1b390 75 65 20 6f 66 20 6e 52 65 63 20 66 72 6f 6d 20 ue of nRec from
1b3a0 74 68 65 20 73 69 7a 65 20 6f 66 20 74 68 65 20 the size of the
1b3b0 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 2e 20 20 42 journal file. B
1b3c0 75 74 20 69 66 20 61 20 70 6f 77 65 72 0a 2a 2a ut if a power.**
1b3d0 20 66 61 69 6c 75 72 65 20 6f 63 63 75 72 72 65 failure occurre
1b3e0 64 20 77 68 69 6c 65 20 74 68 65 20 6a 6f 75 72 d while the jour
1b3f0 6e 61 6c 20 77 61 73 20 62 65 69 6e 67 20 77 72 nal was being wr
1b400 69 74 74 65 6e 2c 20 69 74 20 63 6f 75 6c 64 20 itten, it could
1b410 62 65 20 74 68 65 0a 2a 2a 20 63 61 73 65 20 74 be the.** case t
1b420 68 61 74 20 74 68 65 20 73 69 7a 65 20 6f 66 20 hat the size of
1b430 74 68 65 20 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 the journal file
1b440 20 68 61 64 20 61 6c 72 65 61 64 79 20 62 65 65 had already bee
1b450 6e 20 69 6e 63 72 65 61 73 65 64 20 62 75 74 0a n increased but.
1b460 2a 2a 20 74 68 65 20 65 78 74 72 61 20 65 6e 74 ** the extra ent
1b470 72 69 65 73 20 68 61 64 20 6e 6f 74 20 79 65 74 ries had not yet
1b480 20 6d 61 64 65 20 69 74 20 73 61 66 65 6c 79 20 made it safely
1b490 74 6f 20 64 69 73 6b 2e 20 20 49 6e 20 73 75 63 to disk. In suc
1b4a0 68 20 61 20 63 61 73 65 2c 0a 2a 2a 20 74 68 65 h a case,.** the
1b4b0 20 76 61 6c 75 65 20 6f 66 20 6e 52 65 63 20 63 value of nRec c
1b4c0 6f 6d 70 75 74 65 64 20 66 72 6f 6d 20 74 68 65 omputed from the
1b4d0 20 66 69 6c 65 20 73 69 7a 65 20 77 6f 75 6c 64 file size would
1b4e0 20 62 65 20 74 6f 6f 20 6c 61 72 67 65 2e 20 20 be too large.
1b4f0 46 6f 72 0a 2a 2a 20 74 68 61 74 20 72 65 61 73 For.** that reas
1b500 6f 6e 2c 20 77 65 20 61 6c 77 61 79 73 20 75 73 on, we always us
1b510 65 20 74 68 65 20 6e 52 65 63 20 76 61 6c 75 65 e the nRec value
1b520 20 69 6e 20 74 68 65 20 68 65 61 64 65 72 2e 0a in the header..
1b530 2a 2a 0a 2a 2a 20 49 66 20 74 68 65 20 6e 52 65 **.** If the nRe
1b540 63 20 76 61 6c 75 65 20 69 73 20 30 78 66 66 66 c value is 0xfff
1b550 66 66 66 66 66 20 69 74 20 6d 65 61 6e 73 20 74 fffff it means t
1b560 68 61 74 20 6e 52 65 63 20 73 68 6f 75 6c 64 20 hat nRec should
1b570 62 65 20 63 6f 6d 70 75 74 65 64 0a 2a 2a 20 66 be computed.** f
1b580 72 6f 6d 20 74 68 65 20 66 69 6c 65 20 73 69 7a rom the file siz
1b590 65 2e 20 20 54 68 69 73 20 76 61 6c 75 65 20 69 e. This value i
1b5a0 73 20 75 73 65 64 20 77 68 65 6e 20 74 68 65 20 s used when the
1b5b0 75 73 65 72 20 73 65 6c 65 63 74 73 20 74 68 65 user selects the
1b5c0 0a 2a 2a 20 6e 6f 2d 73 79 6e 63 20 6f 70 74 69 .** no-sync opti
1b5d0 6f 6e 20 66 6f 72 20 74 68 65 20 6a 6f 75 72 6e on for the journ
1b5e0 61 6c 2e 20 20 41 20 70 6f 77 65 72 20 66 61 69 al. A power fai
1b5f0 6c 75 72 65 20 63 6f 75 6c 64 20 6c 65 61 64 20 lure could lead
1b600 74 6f 20 63 6f 72 72 75 70 74 69 6f 6e 0a 2a 2a to corruption.**
1b610 20 69 6e 20 74 68 69 73 20 63 61 73 65 2e 20 20 in this case.
1b620 42 75 74 20 66 6f 72 20 74 68 69 6e 67 73 20 6c But for things l
1b630 69 6b 65 20 74 65 6d 70 6f 72 61 72 79 20 74 61 ike temporary ta
1b640 62 6c 65 20 28 77 68 69 63 68 20 77 69 6c 6c 20 ble (which will
1b650 62 65 0a 2a 2a 20 64 65 6c 65 74 65 64 20 77 68 be.** deleted wh
1b660 65 6e 20 74 68 65 20 70 6f 77 65 72 20 69 73 20 en the power is
1b670 72 65 73 74 6f 72 65 64 29 20 77 65 20 64 6f 6e restored) we don
1b680 27 74 20 63 61 72 65 2e 20 20 0a 2a 2a 0a 2a 2a 't care. .**.**
1b690 20 49 66 20 74 68 65 20 66 69 6c 65 20 6f 70 65 If the file ope
1b6a0 6e 65 64 20 61 73 20 74 68 65 20 6a 6f 75 72 6e ned as the journ
1b6b0 61 6c 20 66 69 6c 65 20 69 73 20 6e 6f 74 20 61 al file is not a
1b6c0 20 77 65 6c 6c 2d 66 6f 72 6d 65 64 0a 2a 2a 20 well-formed.**
1b6d0 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 20 74 68 65 journal file the
1b6e0 6e 20 61 6c 6c 20 70 61 67 65 73 20 75 70 20 74 n all pages up t
1b6f0 6f 20 74 68 65 20 66 69 72 73 74 20 63 6f 72 72 o the first corr
1b700 75 70 74 65 64 20 70 61 67 65 20 61 72 65 20 72 upted page are r
1b710 6f 6c 6c 65 64 0a 2a 2a 20 62 61 63 6b 20 28 6f olled.** back (o
1b720 72 20 6e 6f 20 70 61 67 65 73 20 69 66 20 74 68 r no pages if th
1b730 65 20 6a 6f 75 72 6e 61 6c 20 68 65 61 64 65 72 e journal header
1b740 20 69 73 20 63 6f 72 72 75 70 74 65 64 29 2e 20 is corrupted).
1b750 54 68 65 20 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 The journal file
1b760 0a 2a 2a 20 69 73 20 74 68 65 6e 20 64 65 6c 65 .** is then dele
1b770 74 65 64 20 61 6e 64 20 53 51 4c 49 54 45 5f 4f ted and SQLITE_O
1b780 4b 20 72 65 74 75 72 6e 65 64 2c 20 6a 75 73 74 K returned, just
1b790 20 61 73 20 69 66 20 6e 6f 20 63 6f 72 72 75 70 as if no corrup
1b7a0 74 69 6f 6e 20 68 61 64 0a 2a 2a 20 62 65 65 6e tion had.** been
1b7b0 20 65 6e 63 6f 75 6e 74 65 72 65 64 2e 0a 2a 2a encountered..**
1b7c0 0a 2a 2a 20 49 66 20 61 6e 20 49 2f 4f 20 6f 72 .** If an I/O or
1b7d0 20 6d 61 6c 6c 6f 63 28 29 20 65 72 72 6f 72 20 malloc() error
1b7e0 6f 63 63 75 72 73 2c 20 74 68 65 20 6a 6f 75 72 occurs, the jour
1b7f0 6e 61 6c 2d 66 69 6c 65 20 69 73 20 6e 6f 74 20 nal-file is not
1b800 64 65 6c 65 74 65 64 0a 2a 2a 20 61 6e 64 20 61 deleted.** and a
1b810 6e 20 65 72 72 6f 72 20 63 6f 64 65 20 69 73 20 n error code is
1b820 72 65 74 75 72 6e 65 64 2e 0a 2a 2a 0a 2a 2a 20 returned..**.**
1b830 54 68 65 20 69 73 48 6f 74 20 70 61 72 61 6d 65 The isHot parame
1b840 74 65 72 20 69 6e 64 69 63 61 74 65 73 20 74 68 ter indicates th
1b850 61 74 20 77 65 20 61 72 65 20 74 72 79 69 6e 67 at we are trying
1b860 20 74 6f 20 72 6f 6c 6c 62 61 63 6b 20 61 20 6a to rollback a j
1b870 6f 75 72 6e 61 6c 0a 2a 2a 20 74 68 61 74 20 6d ournal.** that m
1b880 69 67 68 74 20 62 65 20 61 20 68 6f 74 20 6a 6f ight be a hot jo
1b890 75 72 6e 61 6c 2e 20 20 4f 72 2c 20 69 74 20 63 urnal. Or, it c
1b8a0 6f 75 6c 64 20 62 65 20 74 68 61 74 20 74 68 65 ould be that the
1b8b0 20 6a 6f 75 72 6e 61 6c 20 69 73 20 0a 2a 2a 20 journal is .**
1b8c0 70 72 65 73 65 72 76 65 64 20 62 65 63 61 75 73 preserved becaus
1b8d0 65 20 6f 66 20 4a 4f 55 52 4e 41 4c 4d 4f 44 45 e of JOURNALMODE
1b8e0 5f 50 45 52 53 49 53 54 20 6f 72 20 4a 4f 55 52 _PERSIST or JOUR
1b8f0 4e 41 4c 4d 4f 44 45 5f 54 52 55 4e 43 41 54 45 NALMODE_TRUNCATE
1b900 2e 0a 2a 2a 20 49 66 20 74 68 65 20 6a 6f 75 72 ..** If the jour
1b910 6e 61 6c 20 72 65 61 6c 6c 79 20 69 73 20 68 6f nal really is ho
1b920 74 2c 20 72 65 73 65 74 20 74 68 65 20 70 61 67 t, reset the pag
1b930 65 72 20 63 61 63 68 65 20 70 72 69 6f 72 20 72 er cache prior r
1b940 6f 6c 6c 69 6e 67 0a 2a 2a 20 62 61 63 6b 20 61 olling.** back a
1b950 6e 79 20 63 6f 6e 74 65 6e 74 2e 20 20 49 66 20 ny content. If
1b960 74 68 65 20 6a 6f 75 72 6e 61 6c 20 69 73 20 6d the journal is m
1b970 65 72 65 6c 79 20 70 65 72 73 69 73 74 65 6e 74 erely persistent
1b980 2c 20 6e 6f 20 72 65 73 65 74 20 69 73 0a 2a 2a , no reset is.**
1b990 20 6e 65 65 64 65 64 2e 0a 2a 2f 0a 73 74 61 74 needed..*/.stat
1b9a0 69 63 20 69 6e 74 20 70 61 67 65 72 5f 70 6c 61 ic int pager_pla
1b9b0 79 62 61 63 6b 28 50 61 67 65 72 20 2a 70 50 61 yback(Pager *pPa
1b9c0 67 65 72 2c 20 69 6e 74 20 69 73 48 6f 74 29 7b ger, int isHot){
1b9d0 0a 20 20 73 71 6c 69 74 65 33 5f 76 66 73 20 2a . sqlite3_vfs *
1b9e0 70 56 66 73 20 3d 20 70 50 61 67 65 72 2d 3e 70 pVfs = pPager->p
1b9f0 56 66 73 3b 0a 20 20 69 36 34 20 73 7a 4a 3b 20 Vfs;. i64 szJ;
1ba00 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
1ba10 2f 2a 20 53 69 7a 65 20 6f 66 20 74 68 65 20 6a /* Size of the j
1ba20 6f 75 72 6e 61 6c 20 66 69 6c 65 20 69 6e 20 62 ournal file in b
1ba30 79 74 65 73 20 2a 2f 0a 20 20 75 33 32 20 6e 52 ytes */. u32 nR
1ba40 65 63 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 ec;
1ba50 20 20 20 2f 2a 20 4e 75 6d 62 65 72 20 6f 66 20 /* Number of
1ba60 52 65 63 6f 72 64 73 20 69 6e 20 74 68 65 20 6a Records in the j
1ba70 6f 75 72 6e 61 6c 20 2a 2f 0a 20 20 75 33 32 20 ournal */. u32
1ba80 75 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 u;
1ba90 20 20 20 20 20 2f 2a 20 55 6e 73 69 67 6e 65 64 /* Unsigned
1baa0 20 6c 6f 6f 70 20 63 6f 75 6e 74 65 72 20 2a 2f loop counter */
1bab0 0a 20 20 50 67 6e 6f 20 6d 78 50 67 20 3d 20 30 . Pgno mxPg = 0
1bac0 3b 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 53 ; /* S
1bad0 69 7a 65 20 6f 66 20 74 68 65 20 6f 72 69 67 69 ize of the origi
1bae0 6e 61 6c 20 66 69 6c 65 20 69 6e 20 70 61 67 65 nal file in page
1baf0 73 20 2a 2f 0a 20 20 69 6e 74 20 72 63 3b 20 20 s */. int rc;
1bb00 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
1bb10 2f 2a 20 52 65 73 75 6c 74 20 63 6f 64 65 20 6f /* Result code o
1bb20 66 20 61 20 73 75 62 72 6f 75 74 69 6e 65 20 2a f a subroutine *
1bb30 2f 0a 20 20 69 6e 74 20 72 65 73 20 3d 20 31 3b /. int res = 1;
1bb40 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 /*
1bb50 56 61 6c 75 65 20 72 65 74 75 72 6e 65 64 20 62 Value returned b
1bb60 79 20 73 71 6c 69 74 65 33 4f 73 41 63 63 65 73 y sqlite3OsAcces
1bb70 73 28 29 20 2a 2f 0a 20 20 63 68 61 72 20 2a 7a s() */. char *z
1bb80 4d 61 73 74 65 72 20 3d 20 30 3b 20 20 20 20 20 Master = 0;
1bb90 20 20 2f 2a 20 4e 61 6d 65 20 6f 66 20 6d 61 73 /* Name of mas
1bba0 74 65 72 20 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 ter journal file
1bbb0 20 69 66 20 61 6e 79 20 2a 2f 0a 20 20 69 6e 74 if any */. int
1bbc0 20 6e 65 65 64 50 61 67 65 72 52 65 73 65 74 3b needPagerReset;
1bbd0 20 20 20 20 20 20 2f 2a 20 54 72 75 65 20 74 6f /* True to
1bbe0 20 72 65 73 65 74 20 70 61 67 65 20 70 72 69 6f reset page prio
1bbf0 72 20 74 6f 20 66 69 72 73 74 20 70 61 67 65 20 r to first page
1bc00 72 6f 6c 6c 62 61 63 6b 20 2a 2f 0a 20 20 69 6e rollback */. in
1bc10 74 20 6e 50 6c 61 79 62 61 63 6b 20 3d 20 30 3b t nPlayback = 0;
1bc20 20 20 20 20 20 20 20 2f 2a 20 54 6f 74 61 6c 20 /* Total
1bc30 6e 75 6d 62 65 72 20 6f 66 20 70 61 67 65 73 20 number of pages
1bc40 72 65 73 74 6f 72 65 64 20 66 72 6f 6d 20 6a 6f restored from jo
1bc50 75 72 6e 61 6c 20 2a 2f 0a 0a 20 20 2f 2a 20 46 urnal */.. /* F
1bc60 69 67 75 72 65 20 6f 75 74 20 68 6f 77 20 6d 61 igure out how ma
1bc70 6e 79 20 72 65 63 6f 72 64 73 20 61 72 65 20 69 ny records are i
1bc80 6e 20 74 68 65 20 6a 6f 75 72 6e 61 6c 2e 20 20 n the journal.
1bc90 41 62 6f 72 74 20 65 61 72 6c 79 20 69 66 0a 20 Abort early if.
1bca0 20 2a 2a 20 74 68 65 20 6a 6f 75 72 6e 61 6c 20 ** the journal
1bcb0 69 73 20 65 6d 70 74 79 2e 0a 20 20 2a 2f 0a 20 is empty.. */.
1bcc0 20 61 73 73 65 72 74 28 20 69 73 4f 70 65 6e 28 assert( isOpen(
1bcd0 70 50 61 67 65 72 2d 3e 6a 66 64 29 20 29 3b 0a pPager->jfd) );.
1bce0 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33 4f 73 rc = sqlite3Os
1bcf0 46 69 6c 65 53 69 7a 65 28 70 50 61 67 65 72 2d FileSize(pPager-
1bd00 3e 6a 66 64 2c 20 26 73 7a 4a 29 3b 0a 20 20 69 >jfd, &szJ);. i
1bd10 66 28 20 72 63 21 3d 53 51 4c 49 54 45 5f 4f 4b f( rc!=SQLITE_OK
1bd20 20 29 7b 0a 20 20 20 20 67 6f 74 6f 20 65 6e 64 ){. goto end
1bd30 5f 70 6c 61 79 62 61 63 6b 3b 0a 20 20 7d 0a 0a _playback;. }..
1bd40 20 20 2f 2a 20 52 65 61 64 20 74 68 65 20 6d 61 /* Read the ma
1bd50 73 74 65 72 20 6a 6f 75 72 6e 61 6c 20 6e 61 6d ster journal nam
1bd60 65 20 66 72 6f 6d 20 74 68 65 20 6a 6f 75 72 6e e from the journ
1bd70 61 6c 2c 20 69 66 20 69 74 20 69 73 20 70 72 65 al, if it is pre
1bd80 73 65 6e 74 2e 0a 20 20 2a 2a 20 49 66 20 61 20 sent.. ** If a
1bd90 6d 61 73 74 65 72 20 6a 6f 75 72 6e 61 6c 20 66 master journal f
1bda0 69 6c 65 20 6e 61 6d 65 20 69 73 20 73 70 65 63 ile name is spec
1bdb0 69 66 69 65 64 2c 20 62 75 74 20 74 68 65 20 66 ified, but the f
1bdc0 69 6c 65 20 69 73 20 6e 6f 74 0a 20 20 2a 2a 20 ile is not. **
1bdd0 70 72 65 73 65 6e 74 20 6f 6e 20 64 69 73 6b 2c present on disk,
1bde0 20 74 68 65 6e 20 74 68 65 20 6a 6f 75 72 6e 61 then the journa
1bdf0 6c 20 69 73 20 6e 6f 74 20 68 6f 74 20 61 6e 64 l is not hot and
1be00 20 64 6f 65 73 20 6e 6f 74 20 6e 65 65 64 20 74 does not need t
1be10 6f 20 62 65 0a 20 20 2a 2a 20 70 6c 61 79 65 64 o be. ** played
1be20 20 62 61 63 6b 2e 0a 20 20 2a 2a 0a 20 20 2a 2a back.. **. **
1be30 20 54 4f 44 4f 3a 20 54 65 63 68 6e 69 63 61 6c TODO: Technical
1be40 6c 79 20 74 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 ly the following
1be50 20 69 73 20 61 6e 20 65 72 72 6f 72 20 62 65 63 is an error bec
1be60 61 75 73 65 20 69 74 20 61 73 73 75 6d 65 73 20 ause it assumes
1be70 74 68 61 74 0a 20 20 2a 2a 20 62 75 66 66 65 72 that. ** buffer
1be80 20 50 61 67 65 72 2e 70 54 6d 70 53 70 61 63 65 Pager.pTmpSpace
1be90 20 69 73 20 28 6d 78 50 61 74 68 6e 61 6d 65 2b is (mxPathname+
1bea0 31 29 20 62 79 74 65 73 20 6f 72 20 6c 61 72 67 1) bytes or larg
1beb0 65 72 2e 20 69 2e 65 2e 20 74 68 61 74 0a 20 20 er. i.e. that.
1bec0 2a 2a 20 28 70 50 61 67 65 72 2d 3e 70 61 67 65 ** (pPager->page
1bed0 53 69 7a 65 20 3e 3d 20 70 50 61 67 65 72 2d 3e Size >= pPager->
1bee0 70 56 66 73 2d 3e 6d 78 50 61 74 68 6e 61 6d 65 pVfs->mxPathname
1bef0 2b 31 29 2e 20 55 73 69 6e 67 20 6f 73 5f 75 6e +1). Using os_un
1bf00 69 78 2e 63 2c 0a 20 20 2a 2a 20 6d 78 50 61 74 ix.c,. ** mxPat
1bf10 68 6e 61 6d 65 20 69 73 20 35 31 32 2c 20 77 68 hname is 512, wh
1bf20 69 63 68 20 69 73 20 74 68 65 20 73 61 6d 65 20 ich is the same
1bf30 61 73 20 74 68 65 20 6d 69 6e 69 6d 75 6d 20 61 as the minimum a
1bf40 6c 6c 6f 77 61 62 6c 65 20 76 61 6c 75 65 0a 20 llowable value.
1bf50 20 2a 2a 20 66 6f 72 20 70 61 67 65 53 69 7a 65 ** for pageSize
1bf60 2e 0a 20 20 2a 2f 0a 20 20 7a 4d 61 73 74 65 72 .. */. zMaster
1bf70 20 3d 20 70 50 61 67 65 72 2d 3e 70 54 6d 70 53 = pPager->pTmpS
1bf80 70 61 63 65 3b 0a 20 20 72 63 20 3d 20 72 65 61 pace;. rc = rea
1bf90 64 4d 61 73 74 65 72 4a 6f 75 72 6e 61 6c 28 70 dMasterJournal(p
1bfa0 50 61 67 65 72 2d 3e 6a 66 64 2c 20 7a 4d 61 73 Pager->jfd, zMas
1bfb0 74 65 72 2c 20 70 50 61 67 65 72 2d 3e 70 56 66 ter, pPager->pVf
1bfc0 73 2d 3e 6d 78 50 61 74 68 6e 61 6d 65 2b 31 29 s->mxPathname+1)
1bfd0 3b 0a 20 20 69 66 28 20 72 63 3d 3d 53 51 4c 49 ;. if( rc==SQLI
1bfe0 54 45 5f 4f 4b 20 26 26 20 7a 4d 61 73 74 65 72 TE_OK && zMaster
1bff0 5b 30 5d 20 29 7b 0a 20 20 20 20 72 63 20 3d 20 [0] ){. rc =
1c000 73 71 6c 69 74 65 33 4f 73 41 63 63 65 73 73 28 sqlite3OsAccess(
1c010 70 56 66 73 2c 20 7a 4d 61 73 74 65 72 2c 20 53 pVfs, zMaster, S
1c020 51 4c 49 54 45 5f 41 43 43 45 53 53 5f 45 58 49 QLITE_ACCESS_EXI
1c030 53 54 53 2c 20 26 72 65 73 29 3b 0a 20 20 7d 0a STS, &res);. }.
1c040 20 20 7a 4d 61 73 74 65 72 20 3d 20 30 3b 0a 20 zMaster = 0;.
1c050 20 69 66 28 20 72 63 21 3d 53 51 4c 49 54 45 5f if( rc!=SQLITE_
1c060 4f 4b 20 7c 7c 20 21 72 65 73 20 29 7b 0a 20 20 OK || !res ){.
1c070 20 20 67 6f 74 6f 20 65 6e 64 5f 70 6c 61 79 62 goto end_playb
1c080 61 63 6b 3b 0a 20 20 7d 0a 20 20 70 50 61 67 65 ack;. }. pPage
1c090 72 2d 3e 6a 6f 75 72 6e 61 6c 4f 66 66 20 3d 20 r->journalOff =
1c0a0 30 3b 0a 20 20 6e 65 65 64 50 61 67 65 72 52 65 0;. needPagerRe
1c0b0 73 65 74 20 3d 20 69 73 48 6f 74 3b 0a 0a 20 20 set = isHot;..
1c0c0 2f 2a 20 54 68 69 73 20 6c 6f 6f 70 20 74 65 72 /* This loop ter
1c0d0 6d 69 6e 61 74 65 73 20 65 69 74 68 65 72 20 77 minates either w
1c0e0 68 65 6e 20 61 20 72 65 61 64 4a 6f 75 72 6e 61 hen a readJourna
1c0f0 6c 48 64 72 28 29 20 6f 72 20 0a 20 20 2a 2a 20 lHdr() or . **
1c100 70 61 67 65 72 5f 70 6c 61 79 62 61 63 6b 5f 6f pager_playback_o
1c110 6e 65 5f 70 61 67 65 28 29 20 63 61 6c 6c 20 72 ne_page() call r
1c120 65 74 75 72 6e 73 20 53 51 4c 49 54 45 5f 44 4f eturns SQLITE_DO
1c130 4e 45 20 6f 72 20 61 6e 20 49 4f 20 65 72 72 6f NE or an IO erro
1c140 72 20 0a 20 20 2a 2a 20 6f 63 63 75 72 73 2e 20 r . ** occurs.
1c150 0a 20 20 2a 2f 0a 20 20 77 68 69 6c 65 28 20 31 . */. while( 1
1c160 20 29 7b 0a 20 20 20 20 2f 2a 20 52 65 61 64 20 ){. /* Read
1c170 74 68 65 20 6e 65 78 74 20 6a 6f 75 72 6e 61 6c the next journal
1c180 20 68 65 61 64 65 72 20 66 72 6f 6d 20 74 68 65 header from the
1c190 20 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 2e 20 20 journal file.
1c1a0 49 66 20 74 68 65 72 65 20 61 72 65 0a 20 20 20 If there are.
1c1b0 20 2a 2a 20 6e 6f 74 20 65 6e 6f 75 67 68 20 62 ** not enough b
1c1c0 79 74 65 73 20 6c 65 66 74 20 69 6e 20 74 68 65 ytes left in the
1c1d0 20 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 20 66 6f journal file fo
1c1e0 72 20 61 20 63 6f 6d 70 6c 65 74 65 20 68 65 61 r a complete hea
1c1f0 64 65 72 2c 20 6f 72 0a 20 20 20 20 2a 2a 20 69 der, or. ** i
1c200 74 20 69 73 20 63 6f 72 72 75 70 74 65 64 2c 20 t is corrupted,
1c210 74 68 65 6e 20 61 20 70 72 6f 63 65 73 73 20 6d then a process m
1c220 75 73 74 20 68 61 76 65 20 66 61 69 6c 65 64 20 ust have failed
1c230 77 68 69 6c 65 20 77 72 69 74 69 6e 67 20 69 74 while writing it
1c240 2e 0a 20 20 20 20 2a 2a 20 54 68 69 73 20 69 6e .. ** This in
1c250 64 69 63 61 74 65 73 20 6e 6f 74 68 69 6e 67 20 dicates nothing
1c260 6d 6f 72 65 20 6e 65 65 64 73 20 74 6f 20 62 65 more needs to be
1c270 20 72 6f 6c 6c 65 64 20 62 61 63 6b 2e 0a 20 20 rolled back..
1c280 20 20 2a 2f 0a 20 20 20 20 72 63 20 3d 20 72 65 */. rc = re
1c290 61 64 4a 6f 75 72 6e 61 6c 48 64 72 28 70 50 61 adJournalHdr(pPa
1c2a0 67 65 72 2c 20 69 73 48 6f 74 2c 20 73 7a 4a 2c ger, isHot, szJ,
1c2b0 20 26 6e 52 65 63 2c 20 26 6d 78 50 67 29 3b 0a &nRec, &mxPg);.
1c2c0 20 20 20 20 69 66 28 20 72 63 21 3d 53 51 4c 49 if( rc!=SQLI
1c2d0 54 45 5f 4f 4b 20 29 7b 20 0a 20 20 20 20 20 20 TE_OK ){ .
1c2e0 69 66 28 20 72 63 3d 3d 53 51 4c 49 54 45 5f 44 if( rc==SQLITE_D
1c2f0 4f 4e 45 20 29 7b 0a 20 20 20 20 20 20 20 20 72 ONE ){. r
1c300 63 20 3d 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20 c = SQLITE_OK;.
1c310 20 20 20 20 20 7d 0a 20 20 20 20 20 20 67 6f 74 }. got
1c320 6f 20 65 6e 64 5f 70 6c 61 79 62 61 63 6b 3b 0a o end_playback;.
1c330 20 20 20 20 7d 0a 0a 20 20 20 20 2f 2a 20 49 66 }.. /* If
1c340 20 6e 52 65 63 20 69 73 20 30 78 66 66 66 66 66 nRec is 0xfffff
1c350 66 66 66 2c 20 74 68 65 6e 20 74 68 69 73 20 6a fff, then this j
1c360 6f 75 72 6e 61 6c 20 77 61 73 20 63 72 65 61 74 ournal was creat
1c370 65 64 20 62 79 20 61 20 70 72 6f 63 65 73 73 0a ed by a process.
1c380 20 20 20 20 2a 2a 20 77 6f 72 6b 69 6e 67 20 69 ** working i
1c390 6e 20 6e 6f 2d 73 79 6e 63 20 6d 6f 64 65 2e 20 n no-sync mode.
1c3a0 54 68 69 73 20 6d 65 61 6e 73 20 74 68 61 74 20 This means that
1c3b0 74 68 65 20 72 65 73 74 20 6f 66 20 74 68 65 20 the rest of the
1c3c0 6a 6f 75 72 6e 61 6c 0a 20 20 20 20 2a 2a 20 66 journal. ** f
1c3d0 69 6c 65 20 63 6f 6e 73 69 73 74 73 20 6f 66 20 ile consists of
1c3e0 70 61 67 65 73 2c 20 74 68 65 72 65 20 61 72 65 pages, there are
1c3f0 20 6e 6f 20 6d 6f 72 65 20 6a 6f 75 72 6e 61 6c no more journal
1c400 20 68 65 61 64 65 72 73 2e 20 43 6f 6d 70 75 74 headers. Comput
1c410 65 0a 20 20 20 20 2a 2a 20 74 68 65 20 76 61 6c e. ** the val
1c420 75 65 20 6f 66 20 6e 52 65 63 20 62 61 73 65 64 ue of nRec based
1c430 20 6f 6e 20 74 68 69 73 20 61 73 73 75 6d 70 74 on this assumpt
1c440 69 6f 6e 2e 0a 20 20 20 20 2a 2f 0a 20 20 20 20 ion.. */.
1c450 69 66 28 20 6e 52 65 63 3d 3d 30 78 66 66 66 66 if( nRec==0xffff
1c460 66 66 66 66 20 29 7b 0a 20 20 20 20 20 20 61 73 ffff ){. as
1c470 73 65 72 74 28 20 70 50 61 67 65 72 2d 3e 6a 6f sert( pPager->jo
1c480 75 72 6e 61 6c 4f 66 66 3d 3d 4a 4f 55 52 4e 41 urnalOff==JOURNA
1c490 4c 5f 48 44 52 5f 53 5a 28 70 50 61 67 65 72 29 L_HDR_SZ(pPager)
1c4a0 20 29 3b 0a 20 20 20 20 20 20 6e 52 65 63 20 3d );. nRec =
1c4b0 20 28 69 6e 74 29 28 28 73 7a 4a 20 2d 20 4a 4f (int)((szJ - JO
1c4c0 55 52 4e 41 4c 5f 48 44 52 5f 53 5a 28 70 50 61 URNAL_HDR_SZ(pPa
1c4d0 67 65 72 29 29 2f 4a 4f 55 52 4e 41 4c 5f 50 47 ger))/JOURNAL_PG
1c4e0 5f 53 5a 28 70 50 61 67 65 72 29 29 3b 0a 20 20 _SZ(pPager));.
1c4f0 20 20 7d 0a 0a 20 20 20 20 2f 2a 20 49 66 20 6e }.. /* If n
1c500 52 65 63 20 69 73 20 30 20 61 6e 64 20 74 68 69 Rec is 0 and thi
1c510 73 20 72 6f 6c 6c 62 61 63 6b 20 69 73 20 6f 66 s rollback is of
1c520 20 61 20 74 72 61 6e 73 61 63 74 69 6f 6e 20 63 a transaction c
1c530 72 65 61 74 65 64 20 62 79 20 74 68 69 73 0a 20 reated by this.
1c540 20 20 20 2a 2a 20 70 72 6f 63 65 73 73 20 61 6e ** process an
1c550 64 20 69 66 20 74 68 69 73 20 69 73 20 74 68 65 d if this is the
1c560 20 66 69 6e 61 6c 20 68 65 61 64 65 72 20 69 6e final header in
1c570 20 74 68 65 20 6a 6f 75 72 6e 61 6c 2c 20 74 68 the journal, th
1c580 65 6e 20 69 74 20 6d 65 61 6e 73 0a 20 20 20 20 en it means.
1c590 2a 2a 20 74 68 61 74 20 74 68 69 73 20 70 61 72 ** that this par
1c5a0 74 20 6f 66 20 74 68 65 20 6a 6f 75 72 6e 61 6c t of the journal
1c5b0 20 77 61 73 20 62 65 69 6e 67 20 66 69 6c 6c 65 was being fille
1c5c0 64 20 62 75 74 20 68 61 73 20 6e 6f 74 20 79 65 d but has not ye
1c5d0 74 20 62 65 65 6e 0a 20 20 20 20 2a 2a 20 73 79 t been. ** sy
1c5e0 6e 63 65 64 20 74 6f 20 64 69 73 6b 2e 20 20 43 nced to disk. C
1c5f0 6f 6d 70 75 74 65 20 74 68 65 20 6e 75 6d 62 65 ompute the numbe
1c600 72 20 6f 66 20 70 61 67 65 73 20 62 61 73 65 64 r of pages based
1c610 20 6f 6e 20 74 68 65 20 72 65 6d 61 69 6e 69 6e on the remainin
1c620 67 0a 20 20 20 20 2a 2a 20 73 69 7a 65 20 6f 66 g. ** size of
1c630 20 74 68 65 20 66 69 6c 65 2e 0a 20 20 20 20 2a the file.. *
1c640 2a 0a 20 20 20 20 2a 2a 20 54 68 65 20 74 68 69 *. ** The thi
1c650 72 64 20 74 65 72 6d 20 6f 66 20 74 68 65 20 74 rd term of the t
1c660 65 73 74 20 77 61 73 20 61 64 64 65 64 20 74 6f est was added to
1c670 20 66 69 78 20 74 69 63 6b 65 74 20 23 32 35 36 fix ticket #256
1c680 35 2e 0a 20 20 20 20 2a 2a 20 57 68 65 6e 20 72 5.. ** When r
1c690 6f 6c 6c 69 6e 67 20 62 61 63 6b 20 61 20 68 6f olling back a ho
1c6a0 74 20 6a 6f 75 72 6e 61 6c 2c 20 6e 52 65 63 3d t journal, nRec=
1c6b0 3d 30 20 61 6c 77 61 79 73 20 6d 65 61 6e 73 20 =0 always means
1c6c0 74 68 61 74 20 74 68 65 20 6e 65 78 74 0a 20 20 that the next.
1c6d0 20 20 2a 2a 20 63 68 75 6e 6b 20 6f 66 20 74 68 ** chunk of th
1c6e0 65 20 6a 6f 75 72 6e 61 6c 20 63 6f 6e 74 61 69 e journal contai
1c6f0 6e 73 20 7a 65 72 6f 20 70 61 67 65 73 20 74 6f ns zero pages to
1c700 20 62 65 20 72 6f 6c 6c 65 64 20 62 61 63 6b 2e be rolled back.
1c710 20 20 42 75 74 0a 20 20 20 20 2a 2a 20 77 68 65 But. ** whe
1c720 6e 20 64 6f 69 6e 67 20 61 20 52 4f 4c 4c 42 41 n doing a ROLLBA
1c730 43 4b 20 61 6e 64 20 74 68 65 20 6e 52 65 63 3d CK and the nRec=
1c740 3d 30 20 63 68 75 6e 6b 20 69 73 20 74 68 65 20 =0 chunk is the
1c750 6c 61 73 74 20 63 68 75 6e 6b 20 69 6e 0a 20 20 last chunk in.
1c760 20 20 2a 2a 20 74 68 65 20 6a 6f 75 72 6e 61 6c ** the journal
1c770 2c 20 69 74 20 6d 65 61 6e 73 20 74 68 61 74 20 , it means that
1c780 74 68 65 20 6a 6f 75 72 6e 61 6c 20 6d 69 67 68 the journal migh
1c790 74 20 63 6f 6e 74 61 69 6e 20 61 64 64 69 74 69 t contain additi
1c7a0 6f 6e 61 6c 0a 20 20 20 20 2a 2a 20 70 61 67 65 onal. ** page
1c7b0 73 20 74 68 61 74 20 6e 65 65 64 20 74 6f 20 62 s that need to b
1c7c0 65 20 72 6f 6c 6c 65 64 20 62 61 63 6b 20 61 6e e rolled back an
1c7d0 64 20 74 68 61 74 20 74 68 65 20 6e 75 6d 62 65 d that the numbe
1c7e0 72 20 6f 66 20 70 61 67 65 73 20 0a 20 20 20 20 r of pages .
1c7f0 2a 2a 20 73 68 6f 75 6c 64 20 62 65 20 63 6f 6d ** should be com
1c800 70 75 74 65 64 20 62 61 73 65 64 20 6f 6e 20 74 puted based on t
1c810 68 65 20 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 20 he journal file
1c820 73 69 7a 65 2e 0a 20 20 20 20 2a 2f 0a 20 20 20 size.. */.
1c830 20 69 66 28 20 6e 52 65 63 3d 3d 30 20 26 26 20 if( nRec==0 &&
1c840 21 69 73 48 6f 74 20 26 26 0a 20 20 20 20 20 20 !isHot &&.
1c850 20 20 70 50 61 67 65 72 2d 3e 6a 6f 75 72 6e 61 pPager->journa
1c860 6c 48 64 72 2b 4a 4f 55 52 4e 41 4c 5f 48 44 52 lHdr+JOURNAL_HDR
1c870 5f 53 5a 28 70 50 61 67 65 72 29 3d 3d 70 50 61 _SZ(pPager)==pPa
1c880 67 65 72 2d 3e 6a 6f 75 72 6e 61 6c 4f 66 66 20 ger->journalOff
1c890 29 7b 0a 20 20 20 20 20 20 6e 52 65 63 20 3d 20 ){. nRec =
1c8a0 28 69 6e 74 29 28 28 73 7a 4a 20 2d 20 70 50 61 (int)((szJ - pPa
1c8b0 67 65 72 2d 3e 6a 6f 75 72 6e 61 6c 4f 66 66 29 ger->journalOff)
1c8c0 20 2f 20 4a 4f 55 52 4e 41 4c 5f 50 47 5f 53 5a / JOURNAL_PG_SZ
1c8d0 28 70 50 61 67 65 72 29 29 3b 0a 20 20 20 20 7d (pPager));. }
1c8e0 0a 0a 20 20 20 20 2f 2a 20 49 66 20 74 68 69 73 .. /* If this
1c8f0 20 69 73 20 74 68 65 20 66 69 72 73 74 20 68 65 is the first he
1c900 61 64 65 72 20 72 65 61 64 20 66 72 6f 6d 20 74 ader read from t
1c910 68 65 20 6a 6f 75 72 6e 61 6c 2c 20 74 72 75 6e he journal, trun
1c920 63 61 74 65 20 74 68 65 0a 20 20 20 20 2a 2a 20 cate the. **
1c930 64 61 74 61 62 61 73 65 20 66 69 6c 65 20 62 61 database file ba
1c940 63 6b 20 74 6f 20 69 74 73 20 6f 72 69 67 69 6e ck to its origin
1c950 61 6c 20 73 69 7a 65 2e 0a 20 20 20 20 2a 2f 0a al size.. */.
1c960 20 20 20 20 69 66 28 20 70 50 61 67 65 72 2d 3e if( pPager->
1c970 6a 6f 75 72 6e 61 6c 4f 66 66 3d 3d 4a 4f 55 52 journalOff==JOUR
1c980 4e 41 4c 5f 48 44 52 5f 53 5a 28 70 50 61 67 65 NAL_HDR_SZ(pPage
1c990 72 29 20 29 7b 0a 20 20 20 20 20 20 72 63 20 3d r) ){. rc =
1c9a0 20 70 61 67 65 72 5f 74 72 75 6e 63 61 74 65 28 pager_truncate(
1c9b0 70 50 61 67 65 72 2c 20 6d 78 50 67 29 3b 0a 20 pPager, mxPg);.
1c9c0 20 20 20 20 20 69 66 28 20 72 63 21 3d 53 51 4c if( rc!=SQL
1c9d0 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 20 20 ITE_OK ){.
1c9e0 20 20 67 6f 74 6f 20 65 6e 64 5f 70 6c 61 79 62 goto end_playb
1c9f0 61 63 6b 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20 ack;. }.
1ca00 20 20 20 70 50 61 67 65 72 2d 3e 64 62 53 69 7a pPager->dbSiz
1ca10 65 20 3d 20 6d 78 50 67 3b 0a 20 20 20 20 7d 0a e = mxPg;. }.
1ca20 0a 20 20 20 20 2f 2a 20 43 6f 70 79 20 6f 72 69 . /* Copy ori
1ca30 67 69 6e 61 6c 20 70 61 67 65 73 20 6f 75 74 20 ginal pages out
1ca40 6f 66 20 74 68 65 20 6a 6f 75 72 6e 61 6c 20 61 of the journal a
1ca50 6e 64 20 62 61 63 6b 20 69 6e 74 6f 20 74 68 65 nd back into the
1ca60 20 0a 20 20 20 20 2a 2a 20 64 61 74 61 62 61 73 . ** databas
1ca70 65 20 66 69 6c 65 20 61 6e 64 2f 6f 72 20 70 61 e file and/or pa
1ca80 67 65 20 63 61 63 68 65 2e 0a 20 20 20 20 2a 2f ge cache.. */
1ca90 0a 20 20 20 20 66 6f 72 28 75 3d 30 3b 20 75 3c . for(u=0; u<
1caa0 6e 52 65 63 3b 20 75 2b 2b 29 7b 0a 20 20 20 20 nRec; u++){.
1cab0 20 20 69 66 28 20 6e 65 65 64 50 61 67 65 72 52 if( needPagerR
1cac0 65 73 65 74 20 29 7b 0a 20 20 20 20 20 20 20 20 eset ){.
1cad0 70 61 67 65 72 5f 72 65 73 65 74 28 70 50 61 67 pager_reset(pPag
1cae0 65 72 29 3b 0a 20 20 20 20 20 20 20 20 6e 65 65 er);. nee
1caf0 64 50 61 67 65 72 52 65 73 65 74 20 3d 20 30 3b dPagerReset = 0;
1cb00 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 72 . }. r
1cb10 63 20 3d 20 70 61 67 65 72 5f 70 6c 61 79 62 61 c = pager_playba
1cb20 63 6b 5f 6f 6e 65 5f 70 61 67 65 28 70 50 61 67 ck_one_page(pPag
1cb30 65 72 2c 26 70 50 61 67 65 72 2d 3e 6a 6f 75 72 er,&pPager->jour
1cb40 6e 61 6c 4f 66 66 2c 30 2c 31 2c 30 29 3b 0a 20 nalOff,0,1,0);.
1cb50 20 20 20 20 20 69 66 28 20 72 63 3d 3d 53 51 4c if( rc==SQL
1cb60 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 20 20 ITE_OK ){.
1cb70 20 20 6e 50 6c 61 79 62 61 63 6b 2b 2b 3b 0a 20 nPlayback++;.
1cb80 20 20 20 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 }else{.
1cb90 20 20 20 20 69 66 28 20 72 63 3d 3d 53 51 4c 49 if( rc==SQLI
1cba0 54 45 5f 44 4f 4e 45 20 29 7b 0a 20 20 20 20 20 TE_DONE ){.
1cbb0 20 20 20 20 20 70 50 61 67 65 72 2d 3e 6a 6f 75 pPager->jou
1cbc0 72 6e 61 6c 4f 66 66 20 3d 20 73 7a 4a 3b 0a 20 rnalOff = szJ;.
1cbd0 20 20 20 20 20 20 20 20 20 62 72 65 61 6b 3b 0a break;.
1cbe0 20 20 20 20 20 20 20 20 7d 65 6c 73 65 20 69 66 }else if
1cbf0 28 20 72 63 3d 3d 53 51 4c 49 54 45 5f 49 4f 45 ( rc==SQLITE_IOE
1cc00 52 52 5f 53 48 4f 52 54 5f 52 45 41 44 20 29 7b RR_SHORT_READ ){
1cc10 0a 20 20 20 20 20 20 20 20 20 20 2f 2a 20 49 66 . /* If
1cc20 20 74 68 65 20 6a 6f 75 72 6e 61 6c 20 68 61 73 the journal has
1cc30 20 62 65 65 6e 20 74 72 75 6e 63 61 74 65 64 2c been truncated,
1cc40 20 73 69 6d 70 6c 79 20 73 74 6f 70 20 72 65 61 simply stop rea
1cc50 64 69 6e 67 20 61 6e 64 0a 20 20 20 20 20 20 20 ding and.
1cc60 20 20 20 2a 2a 20 70 72 6f 63 65 73 73 69 6e 67 ** processing
1cc70 20 74 68 65 20 6a 6f 75 72 6e 61 6c 2e 20 54 68 the journal. Th
1cc80 69 73 20 6d 69 67 68 74 20 68 61 70 70 65 6e 20 is might happen
1cc90 69 66 20 74 68 65 20 6a 6f 75 72 6e 61 6c 20 77 if the journal w
1cca0 61 73 0a 20 20 20 20 20 20 20 20 20 20 2a 2a 20 as. **
1ccb0 6e 6f 74 20 63 6f 6d 70 6c 65 74 65 6c 79 20 77 not completely w
1ccc0 72 69 74 74 65 6e 20 61 6e 64 20 73 79 6e 63 65 ritten and synce
1ccd0 64 20 70 72 69 6f 72 20 74 6f 20 61 20 63 72 61 d prior to a cra
1cce0 73 68 2e 20 20 49 6e 20 74 68 61 74 0a 20 20 20 sh. In that.
1ccf0 20 20 20 20 20 20 20 2a 2a 20 63 61 73 65 2c 20 ** case,
1cd00 74 68 65 20 64 61 74 61 62 61 73 65 20 73 68 6f the database sho
1cd10 75 6c 64 20 68 61 76 65 20 6e 65 76 65 72 20 62 uld have never b
1cd20 65 65 6e 20 77 72 69 74 74 65 6e 20 69 6e 20 74 een written in t
1cd30 68 65 0a 20 20 20 20 20 20 20 20 20 20 2a 2a 20 he. **
1cd40 66 69 72 73 74 20 70 6c 61 63 65 20 73 6f 20 69 first place so i
1cd50 74 20 69 73 20 4f 4b 20 74 6f 20 73 69 6d 70 6c t is OK to simpl
1cd60 79 20 61 62 61 6e 64 6f 6e 20 74 68 65 20 72 6f y abandon the ro
1cd70 6c 6c 62 61 63 6b 2e 20 2a 2f 0a 20 20 20 20 20 llback. */.
1cd80 20 20 20 20 20 72 63 20 3d 20 53 51 4c 49 54 45 rc = SQLITE
1cd90 5f 4f 4b 3b 0a 20 20 20 20 20 20 20 20 20 20 67 _OK;. g
1cda0 6f 74 6f 20 65 6e 64 5f 70 6c 61 79 62 61 63 6b oto end_playback
1cdb0 3b 0a 20 20 20 20 20 20 20 20 7d 65 6c 73 65 7b ;. }else{
1cdc0 0a 20 20 20 20 20 20 20 20 20 20 2f 2a 20 49 66 . /* If
1cdd0 20 77 65 20 61 72 65 20 75 6e 61 62 6c 65 20 74 we are unable t
1cde0 6f 20 72 6f 6c 6c 62 61 63 6b 2c 20 71 75 69 74 o rollback, quit
1cdf0 20 61 6e 64 20 72 65 74 75 72 6e 20 74 68 65 20 and return the
1ce00 65 72 72 6f 72 0a 20 20 20 20 20 20 20 20 20 20 error.
1ce10 2a 2a 20 63 6f 64 65 2e 20 20 54 68 69 73 20 77 ** code. This w
1ce20 69 6c 6c 20 63 61 75 73 65 20 74 68 65 20 70 61 ill cause the pa
1ce30 67 65 72 20 74 6f 20 65 6e 74 65 72 20 74 68 65 ger to enter the
1ce40 20 65 72 72 6f 72 20 73 74 61 74 65 0a 20 20 20 error state.
1ce50 20 20 20 20 20 20 20 2a 2a 20 73 6f 20 74 68 61 ** so tha
1ce60 74 20 6e 6f 20 66 75 72 74 68 65 72 20 68 61 72 t no further har
1ce70 6d 20 77 69 6c 6c 20 62 65 20 64 6f 6e 65 2e 20 m will be done.
1ce80 20 50 65 72 68 61 70 73 20 74 68 65 20 6e 65 78 Perhaps the nex
1ce90 74 0a 20 20 20 20 20 20 20 20 20 20 2a 2a 20 70 t. ** p
1cea0 72 6f 63 65 73 73 20 74 6f 20 63 6f 6d 65 20 61 rocess to come a
1ceb0 6c 6f 6e 67 20 77 69 6c 6c 20 62 65 20 61 62 6c long will be abl
1cec0 65 20 74 6f 20 72 6f 6c 6c 62 61 63 6b 20 74 68 e to rollback th
1ced0 65 20 64 61 74 61 62 61 73 65 2e 0a 20 20 20 20 e database..
1cee0 20 20 20 20 20 20 2a 2f 0a 20 20 20 20 20 20 20 */.
1cef0 20 20 20 67 6f 74 6f 20 65 6e 64 5f 70 6c 61 79 goto end_play
1cf00 62 61 63 6b 3b 0a 20 20 20 20 20 20 20 20 7d 0a back;. }.
1cf10 20 20 20 20 20 20 7d 0a 20 20 20 20 7d 0a 20 20 }. }.
1cf20 7d 0a 20 20 2f 2a 4e 4f 54 52 45 41 43 48 45 44 }. /*NOTREACHED
1cf30 2a 2f 0a 20 20 61 73 73 65 72 74 28 20 30 20 29 */. assert( 0 )
1cf40 3b 0a 0a 65 6e 64 5f 70 6c 61 79 62 61 63 6b 3a ;..end_playback:
1cf50 0a 20 20 2f 2a 20 46 6f 6c 6c 6f 77 69 6e 67 20 . /* Following
1cf60 61 20 72 6f 6c 6c 62 61 63 6b 2c 20 74 68 65 20 a rollback, the
1cf70 64 61 74 61 62 61 73 65 20 66 69 6c 65 20 73 68 database file sh
1cf80 6f 75 6c 64 20 62 65 20 62 61 63 6b 20 69 6e 20 ould be back in
1cf90 69 74 73 20 6f 72 69 67 69 6e 61 6c 0a 20 20 2a its original. *
1cfa0 2a 20 73 74 61 74 65 20 70 72 69 6f 72 20 74 6f * state prior to
1cfb0 20 74 68 65 20 73 74 61 72 74 20 6f 66 20 74 68 the start of th
1cfc0 65 20 74 72 61 6e 73 61 63 74 69 6f 6e 2c 20 73 e transaction, s
1cfd0 6f 20 69 6e 76 6f 6b 65 20 74 68 65 0a 20 20 2a o invoke the. *
1cfe0 2a 20 53 51 4c 49 54 45 5f 46 43 4e 54 4c 5f 44 * SQLITE_FCNTL_D
1cff0 42 5f 55 4e 43 48 41 4e 47 45 44 20 66 69 6c 65 B_UNCHANGED file
1d000 2d 63 6f 6e 74 72 6f 6c 20 6d 65 74 68 6f 64 20 -control method
1d010 74 6f 20 64 69 73 61 62 6c 65 20 74 68 65 0a 20 to disable the.
1d020 20 2a 2a 20 61 73 73 65 72 74 69 6f 6e 20 74 68 ** assertion th
1d030 61 74 20 74 68 65 20 74 72 61 6e 73 61 63 74 69 at the transacti
1d040 6f 6e 20 63 6f 75 6e 74 65 72 20 77 61 73 20 6d on counter was m
1d050 6f 64 69 66 69 65 64 2e 0a 20 20 2a 2f 0a 23 69 odified.. */.#i
1d060 66 64 65 66 20 53 51 4c 49 54 45 5f 44 45 42 55 fdef SQLITE_DEBU
1d070 47 0a 20 20 69 66 28 20 70 50 61 67 65 72 2d 3e G. if( pPager->
1d080 66 64 2d 3e 70 4d 65 74 68 6f 64 73 20 29 7b 0a fd->pMethods ){.
1d090 20 20 20 20 73 71 6c 69 74 65 33 4f 73 46 69 6c sqlite3OsFil
1d0a0 65 43 6f 6e 74 72 6f 6c 48 69 6e 74 28 70 50 61 eControlHint(pPa
1d0b0 67 65 72 2d 3e 66 64 2c 53 51 4c 49 54 45 5f 46 ger->fd,SQLITE_F
1d0c0 43 4e 54 4c 5f 44 42 5f 55 4e 43 48 41 4e 47 45 CNTL_DB_UNCHANGE
1d0d0 44 2c 30 29 3b 0a 20 20 7d 0a 23 65 6e 64 69 66 D,0);. }.#endif
1d0e0 0a 0a 20 20 2f 2a 20 49 66 20 74 68 69 73 20 70 .. /* If this p
1d0f0 6c 61 79 62 61 63 6b 20 69 73 20 68 61 70 70 65 layback is happe
1d100 6e 69 6e 67 20 61 75 74 6f 6d 61 74 69 63 61 6c ning automatical
1d110 6c 79 20 61 73 20 61 20 72 65 73 75 6c 74 20 6f ly as a result o
1d120 66 20 61 6e 20 49 4f 20 6f 72 20 0a 20 20 2a 2a f an IO or . **
1d130 20 6d 61 6c 6c 6f 63 20 65 72 72 6f 72 20 74 68 malloc error th
1d140 61 74 20 6f 63 63 75 72 72 65 64 20 61 66 74 65 at occurred afte
1d150 72 20 74 68 65 20 63 68 61 6e 67 65 2d 63 6f 75 r the change-cou
1d160 6e 74 65 72 20 77 61 73 20 75 70 64 61 74 65 64 nter was updated
1d170 20 62 75 74 20 0a 20 20 2a 2a 20 62 65 66 6f 72 but . ** befor
1d180 65 20 74 68 65 20 74 72 61 6e 73 61 63 74 69 6f e the transactio
1d190 6e 20 77 61 73 20 63 6f 6d 6d 69 74 74 65 64 2c n was committed,
1d1a0 20 74 68 65 6e 20 74 68 65 20 63 68 61 6e 67 65 then the change
1d1b0 2d 63 6f 75 6e 74 65 72 20 0a 20 20 2a 2a 20 6d -counter . ** m
1d1c0 6f 64 69 66 69 63 61 74 69 6f 6e 20 6d 61 79 20 odification may
1d1d0 6a 75 73 74 20 68 61 76 65 20 62 65 65 6e 20 72 just have been r
1d1e0 65 76 65 72 74 65 64 2e 20 49 66 20 74 68 69 73 everted. If this
1d1f0 20 68 61 70 70 65 6e 73 20 69 6e 20 65 78 63 6c happens in excl
1d200 75 73 69 76 65 20 0a 20 20 2a 2a 20 6d 6f 64 65 usive . ** mode
1d210 2c 20 74 68 65 6e 20 73 75 62 73 65 71 75 65 6e , then subsequen
1d220 74 20 74 72 61 6e 73 61 63 74 69 6f 6e 73 20 70 t transactions p
1d230 65 72 66 6f 72 6d 65 64 20 62 79 20 74 68 65 20 erformed by the
1d240 63 6f 6e 6e 65 63 74 69 6f 6e 20 77 69 6c 6c 20 connection will
1d250 6e 6f 74 0a 20 20 2a 2a 20 75 70 64 61 74 65 20 not. ** update
1d260 74 68 65 20 63 68 61 6e 67 65 2d 63 6f 75 6e 74 the change-count
1d270 65 72 20 61 74 20 61 6c 6c 2e 20 54 68 69 73 20 er at all. This
1d280 6d 61 79 20 6c 65 61 64 20 74 6f 20 63 61 63 68 may lead to cach
1d290 65 20 69 6e 63 6f 6e 73 69 73 74 65 6e 63 79 0a e inconsistency.
1d2a0 20 20 2a 2a 20 70 72 6f 62 6c 65 6d 73 20 66 6f ** problems fo
1d2b0 72 20 6f 74 68 65 72 20 70 72 6f 63 65 73 73 65 r other processe
1d2c0 73 20 61 74 20 73 6f 6d 65 20 70 6f 69 6e 74 20 s at some point
1d2d0 69 6e 20 74 68 65 20 66 75 74 75 72 65 2e 20 53 in the future. S
1d2e0 6f 2c 20 6a 75 73 74 0a 20 20 2a 2a 20 69 6e 20 o, just. ** in
1d2f0 63 61 73 65 20 74 68 69 73 20 68 61 73 20 68 61 case this has ha
1d300 70 70 65 6e 65 64 2c 20 63 6c 65 61 72 20 74 68 ppened, clear th
1d310 65 20 63 68 61 6e 67 65 43 6f 75 6e 74 44 6f 6e e changeCountDon
1d320 65 20 66 6c 61 67 20 6e 6f 77 2e 0a 20 20 2a 2f e flag now.. */
1d330 0a 20 20 70 50 61 67 65 72 2d 3e 63 68 61 6e 67 . pPager->chang
1d340 65 43 6f 75 6e 74 44 6f 6e 65 20 3d 20 70 50 61 eCountDone = pPa
1d350 67 65 72 2d 3e 74 65 6d 70 46 69 6c 65 3b 0a 0a ger->tempFile;..
1d360 20 20 69 66 28 20 72 63 3d 3d 53 51 4c 49 54 45 if( rc==SQLITE
1d370 5f 4f 4b 20 29 7b 0a 20 20 20 20 7a 4d 61 73 74 _OK ){. zMast
1d380 65 72 20 3d 20 70 50 61 67 65 72 2d 3e 70 54 6d er = pPager->pTm
1d390 70 53 70 61 63 65 3b 0a 20 20 20 20 72 63 20 3d pSpace;. rc =
1d3a0 20 72 65 61 64 4d 61 73 74 65 72 4a 6f 75 72 6e readMasterJourn
1d3b0 61 6c 28 70 50 61 67 65 72 2d 3e 6a 66 64 2c 20 al(pPager->jfd,
1d3c0 7a 4d 61 73 74 65 72 2c 20 70 50 61 67 65 72 2d zMaster, pPager-
1d3d0 3e 70 56 66 73 2d 3e 6d 78 50 61 74 68 6e 61 6d >pVfs->mxPathnam
1d3e0 65 2b 31 29 3b 0a 20 20 20 20 74 65 73 74 63 61 e+1);. testca
1d3f0 73 65 28 20 72 63 21 3d 53 51 4c 49 54 45 5f 4f se( rc!=SQLITE_O
1d400 4b 20 29 3b 0a 20 20 7d 0a 20 20 69 66 28 20 72 K );. }. if( r
1d410 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b 0a 20 20 20 c==SQLITE_OK.
1d420 26 26 20 28 70 50 61 67 65 72 2d 3e 65 53 74 61 && (pPager->eSta
1d430 74 65 3e 3d 50 41 47 45 52 5f 57 52 49 54 45 52 te>=PAGER_WRITER
1d440 5f 44 42 4d 4f 44 20 7c 7c 20 70 50 61 67 65 72 _DBMOD || pPager
1d450 2d 3e 65 53 74 61 74 65 3d 3d 50 41 47 45 52 5f ->eState==PAGER_
1d460 4f 50 45 4e 29 0a 20 20 29 7b 0a 20 20 20 20 72 OPEN). ){. r
1d470 63 20 3d 20 73 71 6c 69 74 65 33 50 61 67 65 72 c = sqlite3Pager
1d480 53 79 6e 63 28 70 50 61 67 65 72 2c 20 30 29 3b Sync(pPager, 0);
1d490 0a 20 20 7d 0a 20 20 69 66 28 20 72 63 3d 3d 53 . }. if( rc==S
1d4a0 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 QLITE_OK ){.
1d4b0 72 63 20 3d 20 70 61 67 65 72 5f 65 6e 64 5f 74 rc = pager_end_t
1d4c0 72 61 6e 73 61 63 74 69 6f 6e 28 70 50 61 67 65 ransaction(pPage
1d4d0 72 2c 20 7a 4d 61 73 74 65 72 5b 30 5d 21 3d 27 r, zMaster[0]!='
1d4e0 5c 30 27 2c 20 30 29 3b 0a 20 20 20 20 74 65 73 \0', 0);. tes
1d4f0 74 63 61 73 65 28 20 72 63 21 3d 53 51 4c 49 54 tcase( rc!=SQLIT
1d500 45 5f 4f 4b 20 29 3b 0a 20 20 7d 0a 20 20 69 66 E_OK );. }. if
1d510 28 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 ( rc==SQLITE_OK
1d520 26 26 20 7a 4d 61 73 74 65 72 5b 30 5d 20 26 26 && zMaster[0] &&
1d530 20 72 65 73 20 29 7b 0a 20 20 20 20 2f 2a 20 49 res ){. /* I
1d540 66 20 74 68 65 72 65 20 77 61 73 20 61 20 6d 61 f there was a ma
1d550 73 74 65 72 20 6a 6f 75 72 6e 61 6c 20 61 6e 64 ster journal and
1d560 20 74 68 69 73 20 72 6f 75 74 69 6e 65 20 77 69 this routine wi
1d570 6c 6c 20 72 65 74 75 72 6e 20 73 75 63 63 65 73 ll return succes
1d580 73 2c 0a 20 20 20 20 2a 2a 20 73 65 65 20 69 66 s,. ** see if
1d590 20 69 74 20 69 73 20 70 6f 73 73 69 62 6c 65 20 it is possible
1d5a0 74 6f 20 64 65 6c 65 74 65 20 74 68 65 20 6d 61 to delete the ma
1d5b0 73 74 65 72 20 6a 6f 75 72 6e 61 6c 2e 0a 20 20 ster journal..
1d5c0 20 20 2a 2f 0a 20 20 20 20 72 63 20 3d 20 70 61 */. rc = pa
1d5d0 67 65 72 5f 64 65 6c 6d 61 73 74 65 72 28 70 50 ger_delmaster(pP
1d5e0 61 67 65 72 2c 20 7a 4d 61 73 74 65 72 29 3b 0a ager, zMaster);.
1d5f0 20 20 20 20 74 65 73 74 63 61 73 65 28 20 72 63 testcase( rc
1d600 21 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 3b 0a 20 !=SQLITE_OK );.
1d610 20 7d 0a 20 20 69 66 28 20 69 73 48 6f 74 20 26 }. if( isHot &
1d620 26 20 6e 50 6c 61 79 62 61 63 6b 20 29 7b 0a 20 & nPlayback ){.
1d630 20 20 20 73 71 6c 69 74 65 33 5f 6c 6f 67 28 53 sqlite3_log(S
1d640 51 4c 49 54 45 5f 4e 4f 54 49 43 45 5f 52 45 43 QLITE_NOTICE_REC
1d650 4f 56 45 52 5f 52 4f 4c 4c 42 41 43 4b 2c 20 22 OVER_ROLLBACK, "
1d660 72 65 63 6f 76 65 72 65 64 20 25 64 20 70 61 67 recovered %d pag
1d670 65 73 20 66 72 6f 6d 20 25 73 22 2c 0a 20 20 20 es from %s",.
1d680 20 20 20 20 20 20 20 20 20 20 20 20 20 6e 50 6c nPl
1d690 61 79 62 61 63 6b 2c 20 70 50 61 67 65 72 2d 3e ayback, pPager->
1d6a0 7a 4a 6f 75 72 6e 61 6c 29 3b 0a 20 20 7d 0a 0a zJournal);. }..
1d6b0 20 20 2f 2a 20 54 68 65 20 50 61 67 65 72 2e 73 /* The Pager.s
1d6c0 65 63 74 6f 72 53 69 7a 65 20 76 61 72 69 61 62 ectorSize variab
1d6d0 6c 65 20 6d 61 79 20 68 61 76 65 20 62 65 65 6e le may have been
1d6e0 20 75 70 64 61 74 65 64 20 77 68 69 6c 65 20 72 updated while r
1d6f0 6f 6c 6c 69 6e 67 0a 20 20 2a 2a 20 62 61 63 6b olling. ** back
1d700 20 61 20 6a 6f 75 72 6e 61 6c 20 63 72 65 61 74 a journal creat
1d710 65 64 20 62 79 20 61 20 70 72 6f 63 65 73 73 20 ed by a process
1d720 77 69 74 68 20 61 20 64 69 66 66 65 72 65 6e 74 with a different
1d730 20 73 65 63 74 6f 72 20 73 69 7a 65 0a 20 20 2a sector size. *
1d740 2a 20 76 61 6c 75 65 2e 20 52 65 73 65 74 20 69 * value. Reset i
1d750 74 20 74 6f 20 74 68 65 20 63 6f 72 72 65 63 74 t to the correct
1d760 20 76 61 6c 75 65 20 66 6f 72 20 74 68 69 73 20 value for this
1d770 70 72 6f 63 65 73 73 2e 0a 20 20 2a 2f 0a 20 20 process.. */.
1d780 73 65 74 53 65 63 74 6f 72 53 69 7a 65 28 70 50 setSectorSize(pP
1d790 61 67 65 72 29 3b 0a 20 20 72 65 74 75 72 6e 20 ager);. return
1d7a0 72 63 3b 0a 7d 0a 0a 0a 2f 2a 0a 2a 2a 20 52 65 rc;.}.../*.** Re
1d7b0 61 64 20 74 68 65 20 63 6f 6e 74 65 6e 74 20 66 ad the content f
1d7c0 6f 72 20 70 61 67 65 20 70 50 67 20 6f 75 74 20 or page pPg out
1d7d0 6f 66 20 74 68 65 20 64 61 74 61 62 61 73 65 20 of the database
1d7e0 66 69 6c 65 20 61 6e 64 20 69 6e 74 6f 20 0a 2a file and into .*
1d7f0 2a 20 70 50 67 2d 3e 70 44 61 74 61 2e 20 41 20 * pPg->pData. A
1d800 73 68 61 72 65 64 20 6c 6f 63 6b 20 6f 72 20 67 shared lock or g
1d810 72 65 61 74 65 72 20 6d 75 73 74 20 62 65 20 68 reater must be h
1d820 65 6c 64 20 6f 6e 20 74 68 65 20 64 61 74 61 62 eld on the datab
1d830 61 73 65 0a 2a 2a 20 66 69 6c 65 20 62 65 66 6f ase.** file befo
1d840 72 65 20 74 68 69 73 20 66 75 6e 63 74 69 6f 6e re this function
1d850 20 69 73 20 63 61 6c 6c 65 64 2e 0a 2a 2a 0a 2a is called..**.*
1d860 2a 20 49 66 20 70 61 67 65 20 31 20 69 73 20 72 * If page 1 is r
1d870 65 61 64 2c 20 74 68 65 6e 20 74 68 65 20 76 61 ead, then the va
1d880 6c 75 65 20 6f 66 20 50 61 67 65 72 2e 64 62 46 lue of Pager.dbF
1d890 69 6c 65 56 65 72 73 5b 5d 20 69 73 20 73 65 74 ileVers[] is set
1d8a0 20 74 6f 0a 2a 2a 20 74 68 65 20 76 61 6c 75 65 to.** the value
1d8b0 20 72 65 61 64 20 66 72 6f 6d 20 74 68 65 20 64 read from the d
1d8c0 61 74 61 62 61 73 65 20 66 69 6c 65 2e 0a 2a 2a atabase file..**
1d8d0 0a 2a 2a 20 49 66 20 61 6e 20 49 4f 20 65 72 72 .** If an IO err
1d8e0 6f 72 20 6f 63 63 75 72 73 2c 20 74 68 65 6e 20 or occurs, then
1d8f0 74 68 65 20 49 4f 20 65 72 72 6f 72 20 69 73 20 the IO error is
1d900 72 65 74 75 72 6e 65 64 20 74 6f 20 74 68 65 20 returned to the
1d910 63 61 6c 6c 65 72 2e 0a 2a 2a 20 4f 74 68 65 72 caller..** Other
1d920 77 69 73 65 2c 20 53 51 4c 49 54 45 5f 4f 4b 20 wise, SQLITE_OK
1d930 69 73 20 72 65 74 75 72 6e 65 64 2e 0a 2a 2f 0a is returned..*/.
1d940 73 74 61 74 69 63 20 69 6e 74 20 72 65 61 64 44 static int readD
1d950 62 50 61 67 65 28 50 67 48 64 72 20 2a 70 50 67 bPage(PgHdr *pPg
1d960 2c 20 75 33 32 20 69 46 72 61 6d 65 29 7b 0a 20 , u32 iFrame){.
1d970 20 50 61 67 65 72 20 2a 70 50 61 67 65 72 20 3d Pager *pPager =
1d980 20 70 50 67 2d 3e 70 50 61 67 65 72 3b 20 2f 2a pPg->pPager; /*
1d990 20 50 61 67 65 72 20 6f 62 6a 65 63 74 20 61 73 Pager object as
1d9a0 73 6f 63 69 61 74 65 64 20 77 69 74 68 20 70 61 sociated with pa
1d9b0 67 65 20 70 50 67 20 2a 2f 0a 20 20 50 67 6e 6f ge pPg */. Pgno
1d9c0 20 70 67 6e 6f 20 3d 20 70 50 67 2d 3e 70 67 6e pgno = pPg->pgn
1d9d0 6f 3b 20 20 20 20 20 20 20 2f 2a 20 50 61 67 65 o; /* Page
1d9e0 20 6e 75 6d 62 65 72 20 74 6f 20 72 65 61 64 20 number to read
1d9f0 2a 2f 0a 20 20 69 6e 74 20 72 63 20 3d 20 53 51 */. int rc = SQ
1da00 4c 49 54 45 5f 4f 4b 3b 20 20 20 20 20 20 20 20 LITE_OK;
1da10 20 20 2f 2a 20 52 65 74 75 72 6e 20 63 6f 64 65 /* Return code
1da20 20 2a 2f 0a 20 20 69 6e 74 20 70 67 73 7a 20 3d */. int pgsz =
1da30 20 70 50 61 67 65 72 2d 3e 70 61 67 65 53 69 7a pPager->pageSiz
1da40 65 3b 20 2f 2a 20 4e 75 6d 62 65 72 20 6f 66 20 e; /* Number of
1da50 62 79 74 65 73 20 74 6f 20 72 65 61 64 20 2a 2f bytes to read */
1da60 0a 0a 20 20 61 73 73 65 72 74 28 20 70 50 61 67 .. assert( pPag
1da70 65 72 2d 3e 65 53 74 61 74 65 3e 3d 50 41 47 45 er->eState>=PAGE
1da80 52 5f 52 45 41 44 45 52 20 26 26 20 21 4d 45 4d R_READER && !MEM
1da90 44 42 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 DB );. assert(
1daa0 69 73 4f 70 65 6e 28 70 50 61 67 65 72 2d 3e 66 isOpen(pPager->f
1dab0 64 29 20 29 3b 0a 0a 23 69 66 6e 64 65 66 20 53 d) );..#ifndef S
1dac0 51 4c 49 54 45 5f 4f 4d 49 54 5f 57 41 4c 0a 20 QLITE_OMIT_WAL.
1dad0 20 69 66 28 20 69 46 72 61 6d 65 20 29 7b 0a 20 if( iFrame ){.
1dae0 20 20 20 2f 2a 20 54 72 79 20 74 6f 20 70 75 6c /* Try to pul
1daf0 6c 20 74 68 65 20 70 61 67 65 20 66 72 6f 6d 20 l the page from
1db00 74 68 65 20 77 72 69 74 65 2d 61 68 65 61 64 20 the write-ahead
1db10 6c 6f 67 2e 20 2a 2f 0a 20 20 20 20 72 63 20 3d log. */. rc =
1db20 20 73 71 6c 69 74 65 33 57 61 6c 52 65 61 64 46 sqlite3WalReadF
1db30 72 61 6d 65 28 70 50 61 67 65 72 2d 3e 70 57 61 rame(pPager->pWa
1db40 6c 2c 20 69 46 72 61 6d 65 2c 20 70 67 73 7a 2c l, iFrame, pgsz,
1db50 20 70 50 67 2d 3e 70 44 61 74 61 29 3b 0a 20 20 pPg->pData);.
1db60 7d 65 6c 73 65 0a 23 65 6e 64 69 66 0a 20 20 7b }else.#endif. {
1db70 0a 20 20 20 20 69 36 34 20 69 4f 66 66 73 65 74 . i64 iOffset
1db80 20 3d 20 28 70 67 6e 6f 2d 31 29 2a 28 69 36 34 = (pgno-1)*(i64
1db90 29 70 50 61 67 65 72 2d 3e 70 61 67 65 53 69 7a )pPager->pageSiz
1dba0 65 3b 0a 20 20 20 20 72 63 20 3d 20 73 71 6c 69 e;. rc = sqli
1dbb0 74 65 33 4f 73 52 65 61 64 28 70 50 61 67 65 72 te3OsRead(pPager
1dbc0 2d 3e 66 64 2c 20 70 50 67 2d 3e 70 44 61 74 61 ->fd, pPg->pData
1dbd0 2c 20 70 67 73 7a 2c 20 69 4f 66 66 73 65 74 29 , pgsz, iOffset)
1dbe0 3b 0a 20 20 20 20 69 66 28 20 72 63 3d 3d 53 51 ;. if( rc==SQ
1dbf0 4c 49 54 45 5f 49 4f 45 52 52 5f 53 48 4f 52 54 LITE_IOERR_SHORT
1dc00 5f 52 45 41 44 20 29 7b 0a 20 20 20 20 20 20 72 _READ ){. r
1dc10 63 20 3d 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20 c = SQLITE_OK;.
1dc20 20 20 20 7d 0a 20 20 7d 0a 0a 20 20 69 66 28 20 }. }.. if(
1dc30 70 67 6e 6f 3d 3d 31 20 29 7b 0a 20 20 20 20 69 pgno==1 ){. i
1dc40 66 28 20 72 63 20 29 7b 0a 20 20 20 20 20 20 2f f( rc ){. /
1dc50 2a 20 49 66 20 74 68 65 20 72 65 61 64 20 69 73 * If the read is
1dc60 20 75 6e 73 75 63 63 65 73 73 66 75 6c 2c 20 73 unsuccessful, s
1dc70 65 74 20 74 68 65 20 64 62 46 69 6c 65 56 65 72 et the dbFileVer
1dc80 73 5b 5d 20 74 6f 20 73 6f 6d 65 74 68 69 6e 67 s[] to something
1dc90 0a 20 20 20 20 20 20 2a 2a 20 74 68 61 74 20 77 . ** that w
1dca0 69 6c 6c 20 6e 65 76 65 72 20 62 65 20 61 20 76 ill never be a v
1dcb0 61 6c 69 64 20 66 69 6c 65 20 76 65 72 73 69 6f alid file versio
1dcc0 6e 2e 20 20 64 62 46 69 6c 65 56 65 72 73 5b 5d n. dbFileVers[]
1dcd0 20 69 73 20 61 20 63 6f 70 79 0a 20 20 20 20 20 is a copy.
1dce0 20 2a 2a 20 6f 66 20 62 79 74 65 73 20 32 34 2e ** of bytes 24.
1dcf0 2e 33 39 20 6f 66 20 74 68 65 20 64 61 74 61 62 .39 of the datab
1dd00 61 73 65 2e 20 20 42 79 74 65 73 20 32 38 2e 2e ase. Bytes 28..
1dd10 33 31 20 73 68 6f 75 6c 64 20 61 6c 77 61 79 73 31 should always
1dd20 20 62 65 0a 20 20 20 20 20 20 2a 2a 20 7a 65 72 be. ** zer
1dd30 6f 20 6f 72 20 74 68 65 20 73 69 7a 65 20 6f 66 o or the size of
1dd40 20 74 68 65 20 64 61 74 61 62 61 73 65 20 69 6e the database in
1dd50 20 70 61 67 65 2e 20 42 79 74 65 73 20 33 32 2e page. Bytes 32.
1dd60 2e 33 35 20 61 6e 64 20 33 35 2e 2e 33 39 0a 20 .35 and 35..39.
1dd70 20 20 20 20 20 2a 2a 20 73 68 6f 75 6c 64 20 62 ** should b
1dd80 65 20 70 61 67 65 20 6e 75 6d 62 65 72 73 20 77 e page numbers w
1dd90 68 69 63 68 20 61 72 65 20 6e 65 76 65 72 20 30 hich are never 0
1dda0 78 66 66 66 66 66 66 66 66 2e 20 20 53 6f 20 66 xffffffff. So f
1ddb0 69 6c 6c 69 6e 67 0a 20 20 20 20 20 20 2a 2a 20 illing. **
1ddc0 70 50 61 67 65 72 2d 3e 64 62 46 69 6c 65 56 65 pPager->dbFileVe
1ddd0 72 73 5b 5d 20 77 69 74 68 20 61 6c 6c 20 30 78 rs[] with all 0x
1dde0 66 66 20 62 79 74 65 73 20 73 68 6f 75 6c 64 20 ff bytes should
1ddf0 73 75 66 66 69 63 65 2e 0a 20 20 20 20 20 20 2a suffice.. *
1de00 2a 0a 20 20 20 20 20 20 2a 2a 20 46 6f 72 20 61 *. ** For a
1de10 6e 20 65 6e 63 72 79 70 74 65 64 20 64 61 74 61 n encrypted data
1de20 62 61 73 65 2c 20 74 68 65 20 73 69 74 75 61 74 base, the situat
1de30 69 6f 6e 20 69 73 20 6d 6f 72 65 20 63 6f 6d 70 ion is more comp
1de40 6c 65 78 3a 20 20 62 79 74 65 73 0a 20 20 20 20 lex: bytes.
1de50 20 20 2a 2a 20 32 34 2e 2e 33 39 20 6f 66 20 74 ** 24..39 of t
1de60 68 65 20 64 61 74 61 62 61 73 65 20 61 72 65 20 he database are
1de70 77 68 69 74 65 20 6e 6f 69 73 65 2e 20 20 42 75 white noise. Bu
1de80 74 20 74 68 65 20 70 72 6f 62 61 62 69 6c 69 74 t the probabilit
1de90 79 20 6f 66 0a 20 20 20 20 20 20 2a 2a 20 77 68 y of. ** wh
1dea0 69 74 65 20 6e 6f 69 73 65 20 65 71 75 61 6c 69 ite noise equali
1deb0 6e 67 20 31 36 20 62 79 74 65 73 20 6f 66 20 30 ng 16 bytes of 0
1dec0 78 66 66 20 69 73 20 76 61 6e 69 73 68 69 6e 67 xff is vanishing
1ded0 6c 79 20 73 6d 61 6c 6c 20 73 6f 0a 20 20 20 20 ly small so.
1dee0 20 20 2a 2a 20 77 65 20 73 68 6f 75 6c 64 20 73 ** we should s
1def0 74 69 6c 6c 20 62 65 20 6f 6b 2e 0a 20 20 20 20 till be ok..
1df00 20 20 2a 2f 0a 20 20 20 20 20 20 6d 65 6d 73 65 */. memse
1df10 74 28 70 50 61 67 65 72 2d 3e 64 62 46 69 6c 65 t(pPager->dbFile
1df20 56 65 72 73 2c 20 30 78 66 66 2c 20 73 69 7a 65 Vers, 0xff, size
1df30 6f 66 28 70 50 61 67 65 72 2d 3e 64 62 46 69 6c of(pPager->dbFil
1df40 65 56 65 72 73 29 29 3b 0a 20 20 20 20 7d 65 6c eVers));. }el
1df50 73 65 7b 0a 20 20 20 20 20 20 75 38 20 2a 64 62 se{. u8 *db
1df60 46 69 6c 65 56 65 72 73 20 3d 20 26 28 28 75 38 FileVers = &((u8
1df70 2a 29 70 50 67 2d 3e 70 44 61 74 61 29 5b 32 34 *)pPg->pData)[24
1df80 5d 3b 0a 20 20 20 20 20 20 6d 65 6d 63 70 79 28 ];. memcpy(
1df90 26 70 50 61 67 65 72 2d 3e 64 62 46 69 6c 65 56 &pPager->dbFileV
1dfa0 65 72 73 2c 20 64 62 46 69 6c 65 56 65 72 73 2c ers, dbFileVers,
1dfb0 20 73 69 7a 65 6f 66 28 70 50 61 67 65 72 2d 3e sizeof(pPager->
1dfc0 64 62 46 69 6c 65 56 65 72 73 29 29 3b 0a 20 20 dbFileVers));.
1dfd0 20 20 7d 0a 20 20 7d 0a 20 20 43 4f 44 45 43 31 }. }. CODEC1
1dfe0 28 70 50 61 67 65 72 2c 20 70 50 67 2d 3e 70 44 (pPager, pPg->pD
1dff0 61 74 61 2c 20 70 67 6e 6f 2c 20 33 2c 20 72 63 ata, pgno, 3, rc
1e000 20 3d 20 53 51 4c 49 54 45 5f 4e 4f 4d 45 4d 5f = SQLITE_NOMEM_
1e010 42 4b 50 54 29 3b 0a 0a 20 20 50 41 47 45 52 5f BKPT);.. PAGER_
1e020 49 4e 43 52 28 73 71 6c 69 74 65 33 5f 70 61 67 INCR(sqlite3_pag
1e030 65 72 5f 72 65 61 64 64 62 5f 63 6f 75 6e 74 29 er_readdb_count)
1e040 3b 0a 20 20 50 41 47 45 52 5f 49 4e 43 52 28 70 ;. PAGER_INCR(p
1e050 50 61 67 65 72 2d 3e 6e 52 65 61 64 29 3b 0a 20 Pager->nRead);.
1e060 20 49 4f 54 52 41 43 45 28 28 22 50 47 49 4e 20 IOTRACE(("PGIN
1e070 25 70 20 25 64 5c 6e 22 2c 20 70 50 61 67 65 72 %p %d\n", pPager
1e080 2c 20 70 67 6e 6f 29 29 3b 0a 20 20 50 41 47 45 , pgno));. PAGE
1e090 52 54 52 41 43 45 28 28 22 46 45 54 43 48 20 25 RTRACE(("FETCH %
1e0a0 64 20 70 61 67 65 20 25 64 20 68 61 73 68 28 25 d page %d hash(%
1e0b0 30 38 78 29 5c 6e 22 2c 0a 20 20 20 20 20 20 20 08x)\n",.
1e0c0 20 20 20 20 20 20 20 20 50 41 47 45 52 49 44 28 PAGERID(
1e0d0 70 50 61 67 65 72 29 2c 20 70 67 6e 6f 2c 20 70 pPager), pgno, p
1e0e0 61 67 65 72 5f 70 61 67 65 68 61 73 68 28 70 50 ager_pagehash(pP
1e0f0 67 29 29 29 3b 0a 0a 20 20 72 65 74 75 72 6e 20 g)));.. return
1e100 72 63 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 55 70 64 rc;.}../*.** Upd
1e110 61 74 65 20 74 68 65 20 76 61 6c 75 65 20 6f 66 ate the value of
1e120 20 74 68 65 20 63 68 61 6e 67 65 2d 63 6f 75 6e the change-coun
1e130 74 65 72 20 61 74 20 6f 66 66 73 65 74 73 20 32 ter at offsets 2
1e140 34 20 61 6e 64 20 39 32 20 69 6e 0a 2a 2a 20 74 4 and 92 in.** t
1e150 68 65 20 68 65 61 64 65 72 20 61 6e 64 20 74 68 he header and th
1e160 65 20 73 71 6c 69 74 65 20 76 65 72 73 69 6f 6e e sqlite version
1e170 20 6e 75 6d 62 65 72 20 61 74 20 6f 66 66 73 65 number at offse
1e180 74 20 39 36 2e 0a 2a 2a 0a 2a 2a 20 54 68 69 73 t 96..**.** This
1e190 20 69 73 20 61 6e 20 75 6e 63 6f 6e 64 69 74 69 is an unconditi
1e1a0 6f 6e 61 6c 20 75 70 64 61 74 65 2e 20 20 53 65 onal update. Se
1e1b0 65 20 61 6c 73 6f 20 74 68 65 20 70 61 67 65 72 e also the pager
1e1c0 5f 69 6e 63 72 5f 63 68 61 6e 67 65 63 6f 75 6e _incr_changecoun
1e1d0 74 65 72 28 29 0a 2a 2a 20 72 6f 75 74 69 6e 65 ter().** routine
1e1e0 20 77 68 69 63 68 20 6f 6e 6c 79 20 75 70 64 61 which only upda
1e1f0 74 65 73 20 74 68 65 20 63 68 61 6e 67 65 2d 63 tes the change-c
1e200 6f 75 6e 74 65 72 20 69 66 20 74 68 65 20 75 70 ounter if the up
1e210 64 61 74 65 20 69 73 20 61 63 74 75 61 6c 6c 79 date is actually
1e220 0a 2a 2a 20 6e 65 65 64 65 64 2c 20 61 73 20 64 .** needed, as d
1e230 65 74 65 72 6d 69 6e 65 64 20 62 79 20 74 68 65 etermined by the
1e240 20 70 50 61 67 65 72 2d 3e 63 68 61 6e 67 65 43 pPager->changeC
1e250 6f 75 6e 74 44 6f 6e 65 20 73 74 61 74 65 20 76 ountDone state v
1e260 61 72 69 61 62 6c 65 2e 0a 2a 2f 0a 73 74 61 74 ariable..*/.stat
1e270 69 63 20 76 6f 69 64 20 70 61 67 65 72 5f 77 72 ic void pager_wr
1e280 69 74 65 5f 63 68 61 6e 67 65 63 6f 75 6e 74 65 ite_changecounte
1e290 72 28 50 67 48 64 72 20 2a 70 50 67 29 7b 0a 20 r(PgHdr *pPg){.
1e2a0 20 75 33 32 20 63 68 61 6e 67 65 5f 63 6f 75 6e u32 change_coun
1e2b0 74 65 72 3b 0a 0a 20 20 2f 2a 20 49 6e 63 72 65 ter;.. /* Incre
1e2c0 6d 65 6e 74 20 74 68 65 20 76 61 6c 75 65 20 6a ment the value j
1e2d0 75 73 74 20 72 65 61 64 20 61 6e 64 20 77 72 69 ust read and wri
1e2e0 74 65 20 69 74 20 62 61 63 6b 20 74 6f 20 62 79 te it back to by
1e2f0 74 65 20 32 34 2e 20 2a 2f 0a 20 20 63 68 61 6e te 24. */. chan
1e300 67 65 5f 63 6f 75 6e 74 65 72 20 3d 20 73 71 6c ge_counter = sql
1e310 69 74 65 33 47 65 74 34 62 79 74 65 28 28 75 38 ite3Get4byte((u8
1e320 2a 29 70 50 67 2d 3e 70 50 61 67 65 72 2d 3e 64 *)pPg->pPager->d
1e330 62 46 69 6c 65 56 65 72 73 29 2b 31 3b 0a 20 20 bFileVers)+1;.
1e340 70 75 74 33 32 62 69 74 73 28 28 28 63 68 61 72 put32bits(((char
1e350 2a 29 70 50 67 2d 3e 70 44 61 74 61 29 2b 32 34 *)pPg->pData)+24
1e360 2c 20 63 68 61 6e 67 65 5f 63 6f 75 6e 74 65 72 , change_counter
1e370 29 3b 0a 0a 20 20 2f 2a 20 41 6c 73 6f 20 73 74 );.. /* Also st
1e380 6f 72 65 20 74 68 65 20 53 51 4c 69 74 65 20 76 ore the SQLite v
1e390 65 72 73 69 6f 6e 20 6e 75 6d 62 65 72 20 69 6e ersion number in
1e3a0 20 62 79 74 65 73 20 39 36 2e 2e 39 39 20 61 6e bytes 96..99 an
1e3b0 64 20 69 6e 0a 20 20 2a 2a 20 62 79 74 65 73 20 d in. ** bytes
1e3c0 39 32 2e 2e 39 35 20 73 74 6f 72 65 20 74 68 65 92..95 store the
1e3d0 20 63 68 61 6e 67 65 20 63 6f 75 6e 74 65 72 20 change counter
1e3e0 66 6f 72 20 77 68 69 63 68 20 74 68 65 20 76 65 for which the ve
1e3f0 72 73 69 6f 6e 20 6e 75 6d 62 65 72 0a 20 20 2a rsion number. *
1e400 2a 20 69 73 20 76 61 6c 69 64 2e 20 2a 2f 0a 20 * is valid. */.
1e410 20 70 75 74 33 32 62 69 74 73 28 28 28 63 68 61 put32bits(((cha
1e420 72 2a 29 70 50 67 2d 3e 70 44 61 74 61 29 2b 39 r*)pPg->pData)+9
1e430 32 2c 20 63 68 61 6e 67 65 5f 63 6f 75 6e 74 65 2, change_counte
1e440 72 29 3b 0a 20 20 70 75 74 33 32 62 69 74 73 28 r);. put32bits(
1e450 28 28 63 68 61 72 2a 29 70 50 67 2d 3e 70 44 61 ((char*)pPg->pDa
1e460 74 61 29 2b 39 36 2c 20 53 51 4c 49 54 45 5f 56 ta)+96, SQLITE_V
1e470 45 52 53 49 4f 4e 5f 4e 55 4d 42 45 52 29 3b 0a ERSION_NUMBER);.
1e480 7d 0a 0a 23 69 66 6e 64 65 66 20 53 51 4c 49 54 }..#ifndef SQLIT
1e490 45 5f 4f 4d 49 54 5f 57 41 4c 0a 2f 2a 0a 2a 2a E_OMIT_WAL./*.**
1e4a0 20 54 68 69 73 20 66 75 6e 63 74 69 6f 6e 20 69 This function i
1e4b0 73 20 69 6e 76 6f 6b 65 64 20 6f 6e 63 65 20 66 s invoked once f
1e4c0 6f 72 20 65 61 63 68 20 70 61 67 65 20 74 68 61 or each page tha
1e4d0 74 20 68 61 73 20 61 6c 72 65 61 64 79 20 62 65 t has already be
1e4e0 65 6e 20 0a 2a 2a 20 77 72 69 74 74 65 6e 20 69 en .** written i
1e4f0 6e 74 6f 20 74 68 65 20 6c 6f 67 20 66 69 6c 65 nto the log file
1e500 20 77 68 65 6e 20 61 20 57 41 4c 20 74 72 61 6e when a WAL tran
1e510 73 61 63 74 69 6f 6e 20 69 73 20 72 6f 6c 6c 65 saction is rolle
1e520 64 20 62 61 63 6b 2e 0a 2a 2a 20 50 61 72 61 6d d back..** Param
1e530 65 74 65 72 20 69 50 67 20 69 73 20 74 68 65 20 eter iPg is the
1e540 70 61 67 65 20 6e 75 6d 62 65 72 20 6f 66 20 73 page number of s
1e550 61 69 64 20 70 61 67 65 2e 20 54 68 65 20 70 43 aid page. The pC
1e560 74 78 20 61 72 67 75 6d 65 6e 74 20 0a 2a 2a 20 tx argument .**
1e570 69 73 20 61 63 74 75 61 6c 6c 79 20 61 20 70 6f is actually a po
1e580 69 6e 74 65 72 20 74 6f 20 74 68 65 20 50 61 67 inter to the Pag
1e590 65 72 20 73 74 72 75 63 74 75 72 65 2e 0a 2a 2a er structure..**
1e5a0 0a 2a 2a 20 49 66 20 70 61 67 65 20 69 50 67 20 .** If page iPg
1e5b0 69 73 20 70 72 65 73 65 6e 74 20 69 6e 20 74 68 is present in th
1e5c0 65 20 63 61 63 68 65 2c 20 61 6e 64 20 68 61 73 e cache, and has
1e5d0 20 6e 6f 20 6f 75 74 73 74 61 6e 64 69 6e 67 20 no outstanding
1e5e0 72 65 66 65 72 65 6e 63 65 73 2c 0a 2a 2a 20 69 references,.** i
1e5f0 74 20 69 73 20 64 69 73 63 61 72 64 65 64 2e 20 t is discarded.
1e600 4f 74 68 65 72 77 69 73 65 2c 20 69 66 20 74 68 Otherwise, if th
1e610 65 72 65 20 61 72 65 20 6f 6e 65 20 6f 72 20 6d ere are one or m
1e620 6f 72 65 20 6f 75 74 73 74 61 6e 64 69 6e 67 0a ore outstanding.
1e630 2a 2a 20 72 65 66 65 72 65 6e 63 65 73 2c 20 74 ** references, t
1e640 68 65 20 70 61 67 65 20 63 6f 6e 74 65 6e 74 20 he page content
1e650 69 73 20 72 65 6c 6f 61 64 65 64 20 66 72 6f 6d is reloaded from
1e660 20 74 68 65 20 64 61 74 61 62 61 73 65 2e 20 49 the database. I
1e670 66 20 74 68 65 0a 2a 2a 20 61 74 74 65 6d 70 74 f the.** attempt
1e680 20 74 6f 20 72 65 6c 6f 61 64 20 63 6f 6e 74 65 to reload conte
1e690 6e 74 20 66 72 6f 6d 20 74 68 65 20 64 61 74 61 nt from the data
1e6a0 62 61 73 65 20 69 73 20 72 65 71 75 69 72 65 64 base is required
1e6b0 20 61 6e 64 20 66 61 69 6c 73 2c 20 0a 2a 2a 20 and fails, .**
1e6c0 72 65 74 75 72 6e 20 61 6e 20 53 51 4c 69 74 65 return an SQLite
1e6d0 20 65 72 72 6f 72 20 63 6f 64 65 2e 20 4f 74 68 error code. Oth
1e6e0 65 72 77 69 73 65 2c 20 53 51 4c 49 54 45 5f 4f erwise, SQLITE_O
1e6f0 4b 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74 K..*/.static int
1e700 20 70 61 67 65 72 55 6e 64 6f 43 61 6c 6c 62 61 pagerUndoCallba
1e710 63 6b 28 76 6f 69 64 20 2a 70 43 74 78 2c 20 50 ck(void *pCtx, P
1e720 67 6e 6f 20 69 50 67 29 7b 0a 20 20 69 6e 74 20 gno iPg){. int
1e730 72 63 20 3d 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a rc = SQLITE_OK;.
1e740 20 20 50 61 67 65 72 20 2a 70 50 61 67 65 72 20 Pager *pPager
1e750 3d 20 28 50 61 67 65 72 20 2a 29 70 43 74 78 3b = (Pager *)pCtx;
1e760 0a 20 20 50 67 48 64 72 20 2a 70 50 67 3b 0a 0a . PgHdr *pPg;..
1e770 20 20 61 73 73 65 72 74 28 20 70 61 67 65 72 55 assert( pagerU
1e780 73 65 57 61 6c 28 70 50 61 67 65 72 29 20 29 3b seWal(pPager) );
1e790 0a 20 20 70 50 67 20 3d 20 73 71 6c 69 74 65 33 . pPg = sqlite3
1e7a0 50 61 67 65 72 4c 6f 6f 6b 75 70 28 70 50 61 67 PagerLookup(pPag
1e7b0 65 72 2c 20 69 50 67 29 3b 0a 20 20 69 66 28 20 er, iPg);. if(
1e7c0 70 50 67 20 29 7b 0a 20 20 20 20 69 66 28 20 73 pPg ){. if( s
1e7d0 71 6c 69 74 65 33 50 63 61 63 68 65 50 61 67 65 qlite3PcachePage
1e7e0 52 65 66 63 6f 75 6e 74 28 70 50 67 29 3d 3d 31 Refcount(pPg)==1
1e7f0 20 29 7b 0a 20 20 20 20 20 20 73 71 6c 69 74 65 ){. sqlite
1e800 33 50 63 61 63 68 65 44 72 6f 70 28 70 50 67 29 3PcacheDrop(pPg)
1e810 3b 0a 20 20 20 20 7d 65 6c 73 65 7b 0a 20 20 20 ;. }else{.
1e820 20 20 20 75 33 32 20 69 46 72 61 6d 65 20 3d 20 u32 iFrame =
1e830 30 3b 0a 20 20 20 20 20 20 72 63 20 3d 20 73 71 0;. rc = sq
1e840 6c 69 74 65 33 57 61 6c 46 69 6e 64 46 72 61 6d lite3WalFindFram
1e850 65 28 70 50 61 67 65 72 2d 3e 70 57 61 6c 2c 20 e(pPager->pWal,
1e860 70 50 67 2d 3e 70 67 6e 6f 2c 20 26 69 46 72 61 pPg->pgno, &iFra
1e870 6d 65 29 3b 0a 20 20 20 20 20 20 69 66 28 20 72 me);. if( r
1e880 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a c==SQLITE_OK ){.
1e890 20 20 20 20 20 20 20 20 72 63 20 3d 20 72 65 61 rc = rea
1e8a0 64 44 62 50 61 67 65 28 70 50 67 2c 20 69 46 72 dDbPage(pPg, iFr
1e8b0 61 6d 65 29 3b 0a 20 20 20 20 20 20 7d 0a 20 20 ame);. }.
1e8c0 20 20 20 20 69 66 28 20 72 63 3d 3d 53 51 4c 49 if( rc==SQLI
1e8d0 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 20 20 20 TE_OK ){.
1e8e0 20 70 50 61 67 65 72 2d 3e 78 52 65 69 6e 69 74 pPager->xReinit
1e8f0 65 72 28 70 50 67 29 3b 0a 20 20 20 20 20 20 7d er(pPg);. }
1e900 0a 20 20 20 20 20 20 73 71 6c 69 74 65 33 50 61 . sqlite3Pa
1e910 67 65 72 55 6e 72 65 66 4e 6f 74 4e 75 6c 6c 28 gerUnrefNotNull(
1e920 70 50 67 29 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a pPg);. }. }.
1e930 0a 20 20 2f 2a 20 4e 6f 72 6d 61 6c 6c 79 2c 20 . /* Normally,
1e940 69 66 20 61 20 74 72 61 6e 73 61 63 74 69 6f 6e if a transaction
1e950 20 69 73 20 72 6f 6c 6c 65 64 20 62 61 63 6b 2c is rolled back,
1e960 20 61 6e 79 20 62 61 63 6b 75 70 20 70 72 6f 63 any backup proc
1e970 65 73 73 65 73 20 61 72 65 0a 20 20 2a 2a 20 75 esses are. ** u
1e980 70 64 61 74 65 64 20 61 73 20 64 61 74 61 20 69 pdated as data i
1e990 73 20 63 6f 70 69 65 64 20 6f 75 74 20 6f 66 20 s copied out of
1e9a0 74 68 65 20 72 6f 6c 6c 62 61 63 6b 20 6a 6f 75 the rollback jou
1e9b0 72 6e 61 6c 20 61 6e 64 20 69 6e 74 6f 20 74 68 rnal and into th
1e9c0 65 0a 20 20 2a 2a 20 64 61 74 61 62 61 73 65 2e e. ** database.
1e9d0 20 54 68 69 73 20 69 73 20 6e 6f 74 20 67 65 6e This is not gen
1e9e0 65 72 61 6c 6c 79 20 70 6f 73 73 69 62 6c 65 20 erally possible
1e9f0 77 69 74 68 20 61 20 57 41 4c 20 64 61 74 61 62 with a WAL datab
1ea00 61 73 65 2c 20 61 73 0a 20 20 2a 2a 20 72 6f 6c ase, as. ** rol
1ea10 6c 62 61 63 6b 20 69 6e 76 6f 6c 76 65 73 20 73 lback involves s
1ea20 69 6d 70 6c 79 20 74 72 75 6e 63 61 74 69 6e 67 imply truncating
1ea30 20 74 68 65 20 6c 6f 67 20 66 69 6c 65 2e 20 54 the log file. T
1ea40 68 65 72 65 66 6f 72 65 2c 20 69 66 20 6f 6e 65 herefore, if one
1ea50 0a 20 20 2a 2a 20 6f 72 20 6d 6f 72 65 20 66 72 . ** or more fr
1ea60 61 6d 65 73 20 68 61 76 65 20 61 6c 72 65 61 64 ames have alread
1ea70 79 20 62 65 65 6e 20 77 72 69 74 74 65 6e 20 74 y been written t
1ea80 6f 20 74 68 65 20 6c 6f 67 20 28 61 6e 64 20 74 o the log (and t
1ea90 68 65 72 65 66 6f 72 65 20 0a 20 20 2a 2a 20 61 herefore . ** a
1eaa0 6c 73 6f 20 63 6f 70 69 65 64 20 69 6e 74 6f 20 lso copied into
1eab0 74 68 65 20 62 61 63 6b 75 70 20 64 61 74 61 62 the backup datab
1eac0 61 73 65 73 29 20 61 73 20 70 61 72 74 20 6f 66 ases) as part of
1ead0 20 74 68 69 73 20 74 72 61 6e 73 61 63 74 69 6f this transactio
1eae0 6e 2c 0a 20 20 2a 2a 20 74 68 65 20 62 61 63 6b n,. ** the back
1eaf0 75 70 73 20 6d 75 73 74 20 62 65 20 72 65 73 74 ups must be rest
1eb00 61 72 74 65 64 2e 0a 20 20 2a 2f 0a 20 20 73 71 arted.. */. sq
1eb10 6c 69 74 65 33 42 61 63 6b 75 70 52 65 73 74 61 lite3BackupResta
1eb20 72 74 28 70 50 61 67 65 72 2d 3e 70 42 61 63 6b rt(pPager->pBack
1eb30 75 70 29 3b 0a 0a 20 20 72 65 74 75 72 6e 20 72 up);.. return r
1eb40 63 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 54 68 69 73 c;.}../*.** This
1eb50 20 66 75 6e 63 74 69 6f 6e 20 69 73 20 63 61 6c function is cal
1eb60 6c 65 64 20 74 6f 20 72 6f 6c 6c 62 61 63 6b 20 led to rollback
1eb70 61 20 74 72 61 6e 73 61 63 74 69 6f 6e 20 6f 6e a transaction on
1eb80 20 61 20 57 41 4c 20 64 61 74 61 62 61 73 65 2e a WAL database.
1eb90 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74 20 70 .*/.static int p
1eba0 61 67 65 72 52 6f 6c 6c 62 61 63 6b 57 61 6c 28 agerRollbackWal(
1ebb0 50 61 67 65 72 20 2a 70 50 61 67 65 72 29 7b 0a Pager *pPager){.
1ebc0 20 20 69 6e 74 20 72 63 3b 20 20 20 20 20 20 20 int rc;
1ebd0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
1ebe0 20 20 2f 2a 20 52 65 74 75 72 6e 20 43 6f 64 65 /* Return Code
1ebf0 20 2a 2f 0a 20 20 50 67 48 64 72 20 2a 70 4c 69 */. PgHdr *pLi
1ec00 73 74 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 st;
1ec10 20 20 20 20 20 20 2f 2a 20 4c 69 73 74 20 6f 66 /* List of
1ec20 20 64 69 72 74 79 20 70 61 67 65 73 20 74 6f 20 dirty pages to
1ec30 72 65 76 65 72 74 20 2a 2f 0a 0a 20 20 2f 2a 20 revert */.. /*
1ec40 46 6f 72 20 61 6c 6c 20 70 61 67 65 73 20 69 6e For all pages in
1ec50 20 74 68 65 20 63 61 63 68 65 20 74 68 61 74 20 the cache that
1ec60 61 72 65 20 63 75 72 72 65 6e 74 6c 79 20 64 69 are currently di
1ec70 72 74 79 20 6f 72 20 68 61 76 65 20 61 6c 72 65 rty or have alre
1ec80 61 64 79 0a 20 20 2a 2a 20 62 65 65 6e 20 77 72 ady. ** been wr
1ec90 69 74 74 65 6e 20 28 62 75 74 20 6e 6f 74 20 63 itten (but not c
1eca0 6f 6d 6d 69 74 74 65 64 29 20 74 6f 20 74 68 65 ommitted) to the
1ecb0 20 6c 6f 67 20 66 69 6c 65 2c 20 64 6f 20 6f 6e log file, do on
1ecc0 65 20 6f 66 20 74 68 65 20 0a 20 20 2a 2a 20 66 e of the . ** f
1ecd0 6f 6c 6c 6f 77 69 6e 67 3a 0a 20 20 2a 2a 0a 20 ollowing:. **.
1ece0 20 2a 2a 20 20 20 2b 20 44 69 73 63 61 72 64 20 ** + Discard
1ecf0 74 68 65 20 63 61 63 68 65 64 20 70 61 67 65 20 the cached page
1ed00 28 69 66 20 72 65 66 63 6f 75 6e 74 3d 3d 30 29 (if refcount==0)
1ed10 2c 20 6f 72 0a 20 20 2a 2a 20 20 20 2b 20 52 65 , or. ** + Re
1ed20 6c 6f 61 64 20 70 61 67 65 20 63 6f 6e 74 65 6e load page conten
1ed30 74 20 66 72 6f 6d 20 74 68 65 20 64 61 74 61 62 t from the datab
1ed40 61 73 65 20 28 69 66 20 72 65 66 63 6f 75 6e 74 ase (if refcount
1ed50 3e 30 29 2e 0a 20 20 2a 2f 0a 20 20 70 50 61 67 >0).. */. pPag
1ed60 65 72 2d 3e 64 62 53 69 7a 65 20 3d 20 70 50 61 er->dbSize = pPa
1ed70 67 65 72 2d 3e 64 62 4f 72 69 67 53 69 7a 65 3b ger->dbOrigSize;
1ed80 0a 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33 57 . rc = sqlite3W
1ed90 61 6c 55 6e 64 6f 28 70 50 61 67 65 72 2d 3e 70 alUndo(pPager->p
1eda0 57 61 6c 2c 20 70 61 67 65 72 55 6e 64 6f 43 61 Wal, pagerUndoCa
1edb0 6c 6c 62 61 63 6b 2c 20 28 76 6f 69 64 20 2a 29 llback, (void *)
1edc0 70 50 61 67 65 72 29 3b 0a 20 20 70 4c 69 73 74 pPager);. pList
1edd0 20 3d 20 73 71 6c 69 74 65 33 50 63 61 63 68 65 = sqlite3Pcache
1ede0 44 69 72 74 79 4c 69 73 74 28 70 50 61 67 65 72 DirtyList(pPager
1edf0 2d 3e 70 50 43 61 63 68 65 29 3b 0a 20 20 77 68 ->pPCache);. wh
1ee00 69 6c 65 28 20 70 4c 69 73 74 20 26 26 20 72 63 ile( pList && rc
1ee10 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 ==SQLITE_OK ){.
1ee20 20 20 20 50 67 48 64 72 20 2a 70 4e 65 78 74 20 PgHdr *pNext
1ee30 3d 20 70 4c 69 73 74 2d 3e 70 44 69 72 74 79 3b = pList->pDirty;
1ee40 0a 20 20 20 20 72 63 20 3d 20 70 61 67 65 72 55 . rc = pagerU
1ee50 6e 64 6f 43 61 6c 6c 62 61 63 6b 28 28 76 6f 69 ndoCallback((voi
1ee60 64 20 2a 29 70 50 61 67 65 72 2c 20 70 4c 69 73 d *)pPager, pLis
1ee70 74 2d 3e 70 67 6e 6f 29 3b 0a 20 20 20 20 70 4c t->pgno);. pL
1ee80 69 73 74 20 3d 20 70 4e 65 78 74 3b 0a 20 20 7d ist = pNext;. }
1ee90 0a 0a 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 7d .. return rc;.}
1eea0 0a 0a 2f 2a 0a 2a 2a 20 54 68 69 73 20 66 75 6e ../*.** This fun
1eeb0 63 74 69 6f 6e 20 69 73 20 61 20 77 72 61 70 70 ction is a wrapp
1eec0 65 72 20 61 72 6f 75 6e 64 20 73 71 6c 69 74 65 er around sqlite
1eed0 33 57 61 6c 46 72 61 6d 65 73 28 29 2e 20 41 73 3WalFrames(). As
1eee0 20 77 65 6c 6c 20 61 73 20 6c 6f 67 67 69 6e 67 well as logging
1eef0 0a 2a 2a 20 74 68 65 20 63 6f 6e 74 65 6e 74 73 .** the contents
1ef00 20 6f 66 20 74 68 65 20 6c 69 73 74 20 6f 66 20 of the list of
1ef10 70 61 67 65 73 20 68 65 61 64 65 64 20 62 79 20 pages headed by
1ef20 70 4c 69 73 74 20 28 63 6f 6e 6e 65 63 74 65 64 pList (connected
1ef30 20 62 79 20 70 44 69 72 74 79 29 2c 0a 2a 2a 20 by pDirty),.**
1ef40 74 68 69 73 20 66 75 6e 63 74 69 6f 6e 20 6e 6f this function no
1ef50 74 69 66 69 65 73 20 61 6e 79 20 61 63 74 69 76 tifies any activ
1ef60 65 20 62 61 63 6b 75 70 20 70 72 6f 63 65 73 73 e backup process
1ef70 65 73 20 74 68 61 74 20 74 68 65 20 70 61 67 65 es that the page
1ef80 73 20 68 61 76 65 0a 2a 2a 20 63 68 61 6e 67 65 s have.** change
1ef90 64 2e 20 0a 2a 2a 0a 2a 2a 20 54 68 65 20 6c 69 d. .**.** The li
1efa0 73 74 20 6f 66 20 70 61 67 65 73 20 70 61 73 73 st of pages pass
1efb0 65 64 20 69 6e 74 6f 20 74 68 69 73 20 72 6f 75 ed into this rou
1efc0 74 69 6e 65 20 69 73 20 61 6c 77 61 79 73 20 73 tine is always s
1efd0 6f 72 74 65 64 20 62 79 20 70 61 67 65 20 6e 75 orted by page nu
1efe0 6d 62 65 72 2e 0a 2a 2a 20 48 65 6e 63 65 2c 20 mber..** Hence,
1eff0 69 66 20 70 61 67 65 20 31 20 61 70 70 65 61 72 if page 1 appear
1f000 73 20 61 6e 79 77 68 65 72 65 20 6f 6e 20 74 68 s anywhere on th
1f010 65 20 6c 69 73 74 2c 20 69 74 20 77 69 6c 6c 20 e list, it will
1f020 62 65 20 74 68 65 20 66 69 72 73 74 20 70 61 67 be the first pag
1f030 65 2e 0a 2a 2f 20 0a 73 74 61 74 69 63 20 69 6e e..*/ .static in
1f040 74 20 70 61 67 65 72 57 61 6c 46 72 61 6d 65 73 t pagerWalFrames
1f050 28 0a 20 20 50 61 67 65 72 20 2a 70 50 61 67 65 (. Pager *pPage
1f060 72 2c 20 20 20 20 20 20 20 20 20 20 20 20 20 20 r,
1f070 20 20 20 20 2f 2a 20 50 61 67 65 72 20 6f 62 6a /* Pager obj
1f080 65 63 74 20 2a 2f 0a 20 20 50 67 48 64 72 20 2a ect */. PgHdr *
1f090 70 4c 69 73 74 2c 20 20 20 20 20 20 20 20 20 20 pList,
1f0a0 20 20 20 20 20 20 20 20 20 2f 2a 20 4c 69 73 74 /* List
1f0b0 20 6f 66 20 66 72 61 6d 65 73 20 74 6f 20 6c 6f of frames to lo
1f0c0 67 20 2a 2f 0a 20 20 50 67 6e 6f 20 6e 54 72 75 g */. Pgno nTru
1f0d0 6e 63 61 74 65 2c 20 20 20 20 20 20 20 20 20 20 ncate,
1f0e0 20 20 20 20 20 20 20 2f 2a 20 44 61 74 61 62 61 /* Databa
1f0f0 73 65 20 73 69 7a 65 20 61 66 74 65 72 20 74 68 se size after th
1f100 69 73 20 63 6f 6d 6d 69 74 20 2a 2f 0a 20 20 69 is commit */. i
1f110 6e 74 20 69 73 43 6f 6d 6d 69 74 20 20 20 20 20 nt isCommit
1f120 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f /
1f130 2a 20 54 72 75 65 20 69 66 20 74 68 69 73 20 69 * True if this i
1f140 73 20 61 20 63 6f 6d 6d 69 74 20 2a 2f 0a 29 7b s a commit */.){
1f150 0a 20 20 69 6e 74 20 72 63 3b 20 20 20 20 20 20 . int rc;
1f160 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
1f170 20 20 20 2f 2a 20 52 65 74 75 72 6e 20 63 6f 64 /* Return cod
1f180 65 20 2a 2f 0a 20 20 69 6e 74 20 6e 4c 69 73 74 e */. int nList
1f190 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 ;
1f1a0 20 20 20 20 20 20 20 2f 2a 20 4e 75 6d 62 65 72 /* Number
1f1b0 20 6f 66 20 70 61 67 65 73 20 69 6e 20 70 4c 69 of pages in pLi
1f1c0 73 74 20 2a 2f 0a 20 20 50 67 48 64 72 20 2a 70 st */. PgHdr *p
1f1d0 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 ;
1f1e0 20 20 20 20 20 20 20 20 2f 2a 20 46 6f 72 20 6c /* For l
1f1f0 6f 6f 70 69 6e 67 20 6f 76 65 72 20 70 61 67 65 ooping over page
1f200 73 20 2a 2f 0a 0a 20 20 61 73 73 65 72 74 28 20 s */.. assert(
1f210 70 50 61 67 65 72 2d 3e 70 57 61 6c 20 29 3b 0a pPager->pWal );.
1f220 20 20 61 73 73 65 72 74 28 20 70 4c 69 73 74 20 assert( pList
1f230 29 3b 0a 23 69 66 64 65 66 20 53 51 4c 49 54 45 );.#ifdef SQLITE
1f240 5f 44 45 42 55 47 0a 20 20 2f 2a 20 56 65 72 69 _DEBUG. /* Veri
1f250 66 79 20 74 68 61 74 20 74 68 65 20 70 61 67 65 fy that the page
1f260 20 6c 69 73 74 20 69 73 20 69 6e 20 61 63 63 65 list is in acce
1f270 6e 64 69 6e 67 20 6f 72 64 65 72 20 2a 2f 0a 20 nding order */.
1f280 20 66 6f 72 28 70 3d 70 4c 69 73 74 3b 20 70 20 for(p=pList; p
1f290 26 26 20 70 2d 3e 70 44 69 72 74 79 3b 20 70 3d && p->pDirty; p=
1f2a0 70 2d 3e 70 44 69 72 74 79 29 7b 0a 20 20 20 20 p->pDirty){.
1f2b0 61 73 73 65 72 74 28 20 70 2d 3e 70 67 6e 6f 20 assert( p->pgno
1f2c0 3c 20 70 2d 3e 70 44 69 72 74 79 2d 3e 70 67 6e < p->pDirty->pgn
1f2d0 6f 20 29 3b 0a 20 20 7d 0a 23 65 6e 64 69 66 0a o );. }.#endif.
1f2e0 0a 20 20 61 73 73 65 72 74 28 20 70 4c 69 73 74 . assert( pList
1f2f0 2d 3e 70 44 69 72 74 79 3d 3d 30 20 7c 7c 20 69 ->pDirty==0 || i
1f300 73 43 6f 6d 6d 69 74 20 29 3b 0a 20 20 69 66 28 sCommit );. if(
1f310 20 69 73 43 6f 6d 6d 69 74 20 29 7b 0a 20 20 20 isCommit ){.
1f320 20 2f 2a 20 49 66 20 61 20 57 41 4c 20 74 72 61 /* If a WAL tra
1f330 6e 73 61 63 74 69 6f 6e 20 69 73 20 62 65 69 6e nsaction is bein
1f340 67 20 63 6f 6d 6d 69 74 74 65 64 2c 20 74 68 65 g committed, the
1f350 72 65 20 69 73 20 6e 6f 20 70 6f 69 6e 74 20 69 re is no point i
1f360 6e 20 77 72 69 74 69 6e 67 0a 20 20 20 20 2a 2a n writing. **
1f370 20 61 6e 79 20 70 61 67 65 73 20 77 69 74 68 20 any pages with
1f380 70 61 67 65 20 6e 75 6d 62 65 72 73 20 67 72 65 page numbers gre
1f390 61 74 65 72 20 74 68 61 6e 20 6e 54 72 75 6e 63 ater than nTrunc
1f3a0 61 74 65 20 69 6e 74 6f 20 74 68 65 20 57 41 4c ate into the WAL
1f3b0 20 66 69 6c 65 2e 0a 20 20 20 20 2a 2a 20 54 68 file.. ** Th
1f3c0 65 79 20 77 69 6c 6c 20 6e 65 76 65 72 20 62 65 ey will never be
1f3d0 20 72 65 61 64 20 62 79 20 61 6e 79 20 63 6c 69 read by any cli
1f3e0 65 6e 74 2e 20 53 6f 20 72 65 6d 6f 76 65 20 74 ent. So remove t
1f3f0 68 65 6d 20 66 72 6f 6d 20 74 68 65 20 70 44 69 hem from the pDi
1f400 72 74 79 0a 20 20 20 20 2a 2a 20 6c 69 73 74 20 rty. ** list
1f410 68 65 72 65 2e 20 2a 2f 0a 20 20 20 20 50 67 48 here. */. PgH
1f420 64 72 20 2a 2a 70 70 4e 65 78 74 20 3d 20 26 70 dr **ppNext = &p
1f430 4c 69 73 74 3b 0a 20 20 20 20 6e 4c 69 73 74 20 List;. nList
1f440 3d 20 30 3b 0a 20 20 20 20 66 6f 72 28 70 3d 70 = 0;. for(p=p
1f450 4c 69 73 74 3b 20 28 2a 70 70 4e 65 78 74 20 3d List; (*ppNext =
1f460 20 70 29 21 3d 30 3b 20 70 3d 70 2d 3e 70 44 69 p)!=0; p=p->pDi
1f470 72 74 79 29 7b 0a 20 20 20 20 20 20 69 66 28 20 rty){. if(
1f480 70 2d 3e 70 67 6e 6f 3c 3d 6e 54 72 75 6e 63 61 p->pgno<=nTrunca
1f490 74 65 20 29 7b 0a 20 20 20 20 20 20 20 20 70 70 te ){. pp
1f4a0 4e 65 78 74 20 3d 20 26 70 2d 3e 70 44 69 72 74 Next = &p->pDirt
1f4b0 79 3b 0a 20 20 20 20 20 20 20 20 6e 4c 69 73 74 y;. nList
1f4c0 2b 2b 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 ++;. }.
1f4d0 7d 0a 20 20 20 20 61 73 73 65 72 74 28 20 70 4c }. assert( pL
1f4e0 69 73 74 20 29 3b 0a 20 20 7d 65 6c 73 65 7b 0a ist );. }else{.
1f4f0 20 20 20 20 6e 4c 69 73 74 20 3d 20 31 3b 0a 20 nList = 1;.
1f500 20 7d 0a 20 20 70 50 61 67 65 72 2d 3e 61 53 74 }. pPager->aSt
1f510 61 74 5b 50 41 47 45 52 5f 53 54 41 54 5f 57 52 at[PAGER_STAT_WR
1f520 49 54 45 5d 20 2b 3d 20 6e 4c 69 73 74 3b 0a 0a ITE] += nList;..
1f530 20 20 69 66 28 20 70 4c 69 73 74 2d 3e 70 67 6e if( pList->pgn
1f540 6f 3d 3d 31 20 29 20 70 61 67 65 72 5f 77 72 69 o==1 ) pager_wri
1f550 74 65 5f 63 68 61 6e 67 65 63 6f 75 6e 74 65 72 te_changecounter
1f560 28 70 4c 69 73 74 29 3b 0a 20 20 72 63 20 3d 20 (pList);. rc =
1f570 73 71 6c 69 74 65 33 57 61 6c 46 72 61 6d 65 73 sqlite3WalFrames
1f580 28 70 50 61 67 65 72 2d 3e 70 57 61 6c 2c 20 0a (pPager->pWal, .
1f590 20 20 20 20 20 20 70 50 61 67 65 72 2d 3e 70 61 pPager->pa
1f5a0 67 65 53 69 7a 65 2c 20 70 4c 69 73 74 2c 20 6e geSize, pList, n
1f5b0 54 72 75 6e 63 61 74 65 2c 20 69 73 43 6f 6d 6d Truncate, isComm
1f5c0 69 74 2c 20 70 50 61 67 65 72 2d 3e 77 61 6c 53 it, pPager->walS
1f5d0 79 6e 63 46 6c 61 67 73 0a 20 20 29 3b 0a 20 20 yncFlags. );.
1f5e0 69 66 28 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4f if( rc==SQLITE_O
1f5f0 4b 20 26 26 20 70 50 61 67 65 72 2d 3e 70 42 61 K && pPager->pBa
1f600 63 6b 75 70 20 29 7b 0a 20 20 20 20 66 6f 72 28 ckup ){. for(
1f610 70 3d 70 4c 69 73 74 3b 20 70 3b 20 70 3d 70 2d p=pList; p; p=p-
1f620 3e 70 44 69 72 74 79 29 7b 0a 20 20 20 20 20 20 >pDirty){.
1f630 73 71 6c 69 74 65 33 42 61 63 6b 75 70 55 70 64 sqlite3BackupUpd
1f640 61 74 65 28 70 50 61 67 65 72 2d 3e 70 42 61 63 ate(pPager->pBac
1f650 6b 75 70 2c 20 70 2d 3e 70 67 6e 6f 2c 20 28 75 kup, p->pgno, (u
1f660 38 20 2a 29 70 2d 3e 70 44 61 74 61 29 3b 0a 20 8 *)p->pData);.
1f670 20 20 20 7d 0a 20 20 7d 0a 0a 23 69 66 64 65 66 }. }..#ifdef
1f680 20 53 51 4c 49 54 45 5f 43 48 45 43 4b 5f 50 41 SQLITE_CHECK_PA
1f690 47 45 53 0a 20 20 70 4c 69 73 74 20 3d 20 73 71 GES. pList = sq
1f6a0 6c 69 74 65 33 50 63 61 63 68 65 44 69 72 74 79 lite3PcacheDirty
1f6b0 4c 69 73 74 28 70 50 61 67 65 72 2d 3e 70 50 43 List(pPager->pPC
1f6c0 61 63 68 65 29 3b 0a 20 20 66 6f 72 28 70 3d 70 ache);. for(p=p
1f6d0 4c 69 73 74 3b 20 70 3b 20 70 3d 70 2d 3e 70 44 List; p; p=p->pD
1f6e0 69 72 74 79 29 7b 0a 20 20 20 20 70 61 67 65 72 irty){. pager
1f6f0 5f 73 65 74 5f 70 61 67 65 68 61 73 68 28 70 29 _set_pagehash(p)
1f700 3b 0a 20 20 7d 0a 23 65 6e 64 69 66 0a 0a 20 20 ;. }.#endif..
1f710 72 65 74 75 72 6e 20 72 63 3b 0a 7d 0a 0a 2f 2a return rc;.}../*
1f720 0a 2a 2a 20 42 65 67 69 6e 20 61 20 72 65 61 64 .** Begin a read
1f730 20 74 72 61 6e 73 61 63 74 69 6f 6e 20 6f 6e 20 transaction on
1f740 74 68 65 20 57 41 4c 2e 0a 2a 2a 0a 2a 2a 20 54 the WAL..**.** T
1f750 68 69 73 20 72 6f 75 74 69 6e 65 20 75 73 65 64 his routine used
1f760 20 74 6f 20 62 65 20 63 61 6c 6c 65 64 20 22 70 to be called "p
1f770 61 67 65 72 4f 70 65 6e 53 6e 61 70 73 68 6f 74 agerOpenSnapshot
1f780 28 29 22 20 62 65 63 61 75 73 65 20 69 74 20 65 ()" because it e
1f790 73 73 65 6e 74 69 61 6c 6c 79 0a 2a 2a 20 6d 61 ssentially.** ma
1f7a0 6b 65 73 20 61 20 73 6e 61 70 73 68 6f 74 20 6f kes a snapshot o
1f7b0 66 20 74 68 65 20 64 61 74 61 62 61 73 65 20 61 f the database a
1f7c0 74 20 74 68 65 20 63 75 72 72 65 6e 74 20 70 6f t the current po
1f7d0 69 6e 74 20 69 6e 20 74 69 6d 65 20 61 6e 64 20 int in time and
1f7e0 70 72 65 73 65 72 76 65 73 0a 2a 2a 20 74 68 61 preserves.** tha
1f7f0 74 20 73 6e 61 70 73 68 6f 74 20 66 6f 72 20 75 t snapshot for u
1f800 73 65 20 62 79 20 74 68 65 20 72 65 61 64 65 72 se by the reader
1f810 20 69 6e 20 73 70 69 74 65 20 6f 66 20 63 6f 6e in spite of con
1f820 63 75 72 72 65 6e 74 6c 79 20 63 68 61 6e 67 65 currently change
1f830 73 20 62 79 0a 2a 2a 20 6f 74 68 65 72 20 77 72 s by.** other wr
1f840 69 74 65 72 73 20 6f 72 20 63 68 65 63 6b 70 6f iters or checkpo
1f850 69 6e 74 65 72 73 2e 0a 2a 2f 0a 73 74 61 74 69 inters..*/.stati
1f860 63 20 69 6e 74 20 70 61 67 65 72 42 65 67 69 6e c int pagerBegin
1f870 52 65 61 64 54 72 61 6e 73 61 63 74 69 6f 6e 28 ReadTransaction(
1f880 50 61 67 65 72 20 2a 70 50 61 67 65 72 29 7b 0a Pager *pPager){.
1f890 20 20 69 6e 74 20 72 63 3b 20 20 20 20 20 20 20 int rc;
1f8a0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
1f8b0 20 20 2f 2a 20 52 65 74 75 72 6e 20 63 6f 64 65 /* Return code
1f8c0 20 2a 2f 0a 20 20 69 6e 74 20 63 68 61 6e 67 65 */. int change
1f8d0 64 20 3d 20 30 3b 20 20 20 20 20 20 20 20 20 20 d = 0;
1f8e0 20 20 20 20 20 20 2f 2a 20 54 72 75 65 20 69 66 /* True if
1f8f0 20 63 61 63 68 65 20 6d 75 73 74 20 62 65 20 72 cache must be r
1f900 65 73 65 74 20 2a 2f 0a 0a 20 20 61 73 73 65 72 eset */.. asser
1f910 74 28 20 70 61 67 65 72 55 73 65 57 61 6c 28 70 t( pagerUseWal(p
1f920 50 61 67 65 72 29 20 29 3b 0a 20 20 61 73 73 65 Pager) );. asse
1f930 72 74 28 20 70 50 61 67 65 72 2d 3e 65 53 74 61 rt( pPager->eSta
1f940 74 65 3d 3d 50 41 47 45 52 5f 4f 50 45 4e 20 7c te==PAGER_OPEN |
1f950 7c 20 70 50 61 67 65 72 2d 3e 65 53 74 61 74 65 | pPager->eState
1f960 3d 3d 50 41 47 45 52 5f 52 45 41 44 45 52 20 29 ==PAGER_READER )
1f970 3b 0a 0a 20 20 2f 2a 20 73 71 6c 69 74 65 33 57 ;.. /* sqlite3W
1f980 61 6c 45 6e 64 52 65 61 64 54 72 61 6e 73 61 63 alEndReadTransac
1f990 74 69 6f 6e 28 29 20 77 61 73 20 6e 6f 74 20 63 tion() was not c
1f9a0 61 6c 6c 65 64 20 66 6f 72 20 74 68 65 20 70 72 alled for the pr
1f9b0 65 76 69 6f 75 73 0a 20 20 2a 2a 20 74 72 61 6e evious. ** tran
1f9c0 73 61 63 74 69 6f 6e 20 69 6e 20 6c 6f 63 6b 69 saction in locki
1f9d0 6e 67 5f 6d 6f 64 65 3d 45 58 43 4c 55 53 49 56 ng_mode=EXCLUSIV
1f9e0 45 2e 20 20 53 6f 20 63 61 6c 6c 20 69 74 20 6e E. So call it n
1f9f0 6f 77 2e 20 20 49 66 20 77 65 0a 20 20 2a 2a 20 ow. If we. **
1fa00 61 72 65 20 69 6e 20 6c 6f 63 6b 69 6e 67 5f 6d are in locking_m
1fa10 6f 64 65 3d 4e 4f 52 4d 41 4c 20 61 6e 64 20 45 ode=NORMAL and E
1fa20 6e 64 52 65 61 64 28 29 20 77 61 73 20 70 72 65 ndRead() was pre
1fa30 76 69 6f 75 73 6c 79 20 63 61 6c 6c 65 64 2c 0a viously called,.
1fa40 20 20 2a 2a 20 74 68 65 20 64 75 70 6c 69 63 61 ** the duplica
1fa50 74 65 20 63 61 6c 6c 20 69 73 20 68 61 72 6d 6c te call is harml
1fa60 65 73 73 2e 0a 20 20 2a 2f 0a 20 20 73 71 6c 69 ess.. */. sqli
1fa70 74 65 33 57 61 6c 45 6e 64 52 65 61 64 54 72 61 te3WalEndReadTra
1fa80 6e 73 61 63 74 69 6f 6e 28 70 50 61 67 65 72 2d nsaction(pPager-
1fa90 3e 70 57 61 6c 29 3b 0a 0a 20 20 72 63 20 3d 20 >pWal);.. rc =
1faa0 73 71 6c 69 74 65 33 57 61 6c 42 65 67 69 6e 52 sqlite3WalBeginR
1fab0 65 61 64 54 72 61 6e 73 61 63 74 69 6f 6e 28 70 eadTransaction(p
1fac0 50 61 67 65 72 2d 3e 70 57 61 6c 2c 20 26 63 68 Pager->pWal, &ch
1fad0 61 6e 67 65 64 29 3b 0a 20 20 69 66 28 20 72 63 anged);. if( rc
1fae0 21 3d 53 51 4c 49 54 45 5f 4f 4b 20 7c 7c 20 63 !=SQLITE_OK || c
1faf0 68 61 6e 67 65 64 20 29 7b 0a 20 20 20 20 70 61 hanged ){. pa
1fb00 67 65 72 5f 72 65 73 65 74 28 70 50 61 67 65 72 ger_reset(pPager
1fb10 29 3b 0a 20 20 20 20 69 66 28 20 55 53 45 46 45 );. if( USEFE
1fb20 54 43 48 28 70 50 61 67 65 72 29 20 29 20 73 71 TCH(pPager) ) sq
1fb30 6c 69 74 65 33 4f 73 55 6e 66 65 74 63 68 28 70 lite3OsUnfetch(p
1fb40 50 61 67 65 72 2d 3e 66 64 2c 20 30 2c 20 30 29 Pager->fd, 0, 0)
1fb50 3b 0a 20 20 7d 0a 0a 20 20 72 65 74 75 72 6e 20 ;. }.. return
1fb60 72 63 3b 0a 7d 0a 23 65 6e 64 69 66 0a 0a 2f 2a rc;.}.#endif../*
1fb70 0a 2a 2a 20 54 68 69 73 20 66 75 6e 63 74 69 6f .** This functio
1fb80 6e 20 69 73 20 63 61 6c 6c 65 64 20 61 73 20 70 n is called as p
1fb90 61 72 74 20 6f 66 20 74 68 65 20 74 72 61 6e 73 art of the trans
1fba0 69 74 69 6f 6e 20 66 72 6f 6d 20 50 41 47 45 52 ition from PAGER
1fbb0 5f 4f 50 45 4e 0a 2a 2a 20 74 6f 20 50 41 47 45 _OPEN.** to PAGE
1fbc0 52 5f 52 45 41 44 45 52 20 73 74 61 74 65 20 74 R_READER state t
1fbd0 6f 20 64 65 74 65 72 6d 69 6e 65 20 74 68 65 20 o determine the
1fbe0 73 69 7a 65 20 6f 66 20 74 68 65 20 64 61 74 61 size of the data
1fbf0 62 61 73 65 20 66 69 6c 65 0a 2a 2a 20 69 6e 20 base file.** in
1fc00 70 61 67 65 73 20 28 61 73 73 75 6d 69 6e 67 20 pages (assuming
1fc10 74 68 65 20 70 61 67 65 20 73 69 7a 65 20 63 75 the page size cu
1fc20 72 72 65 6e 74 6c 79 20 73 74 6f 72 65 64 20 69 rrently stored i
1fc30 6e 20 50 61 67 65 72 2e 70 61 67 65 53 69 7a 65 n Pager.pageSize
1fc40 29 2e 0a 2a 2a 0a 2a 2a 20 49 66 20 6e 6f 20 65 )..**.** If no e
1fc50 72 72 6f 72 20 6f 63 63 75 72 73 2c 20 53 51 4c rror occurs, SQL
1fc60 49 54 45 5f 4f 4b 20 69 73 20 72 65 74 75 72 6e ITE_OK is return
1fc70 65 64 20 61 6e 64 20 74 68 65 20 73 69 7a 65 20 ed and the size
1fc80 6f 66 20 74 68 65 20 64 61 74 61 62 61 73 65 0a of the database.
1fc90 2a 2a 20 69 6e 20 70 61 67 65 73 20 69 73 20 73 ** in pages is s
1fca0 74 6f 72 65 64 20 69 6e 20 2a 70 6e 50 61 67 65 tored in *pnPage
1fcb0 2e 20 4f 74 68 65 72 77 69 73 65 2c 20 61 6e 20 . Otherwise, an
1fcc0 65 72 72 6f 72 20 63 6f 64 65 20 28 70 65 72 68 error code (perh
1fcd0 61 70 73 0a 2a 2a 20 53 51 4c 49 54 45 5f 49 4f aps.** SQLITE_IO
1fce0 45 52 52 5f 46 53 54 41 54 29 20 69 73 20 72 65 ERR_FSTAT) is re
1fcf0 74 75 72 6e 65 64 20 61 6e 64 20 2a 70 6e 50 61 turned and *pnPa
1fd00 67 65 20 69 73 20 6c 65 66 74 20 75 6e 6d 6f 64 ge is left unmod
1fd10 69 66 69 65 64 2e 0a 2a 2f 0a 73 74 61 74 69 63 ified..*/.static
1fd20 20 69 6e 74 20 70 61 67 65 72 50 61 67 65 63 6f int pagerPageco
1fd30 75 6e 74 28 50 61 67 65 72 20 2a 70 50 61 67 65 unt(Pager *pPage
1fd40 72 2c 20 50 67 6e 6f 20 2a 70 6e 50 61 67 65 29 r, Pgno *pnPage)
1fd50 7b 0a 20 20 50 67 6e 6f 20 6e 50 61 67 65 3b 20 {. Pgno nPage;
1fd60 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
1fd70 20 20 20 20 2f 2a 20 56 61 6c 75 65 20 74 6f 20 /* Value to
1fd80 72 65 74 75 72 6e 20 76 69 61 20 2a 70 6e 50 61 return via *pnPa
1fd90 67 65 20 2a 2f 0a 0a 20 20 2f 2a 20 51 75 65 72 ge */.. /* Quer
1fda0 79 20 74 68 65 20 57 41 4c 20 73 75 62 2d 73 79 y the WAL sub-sy
1fdb0 73 74 65 6d 20 66 6f 72 20 74 68 65 20 64 61 74 stem for the dat
1fdc0 61 62 61 73 65 20 73 69 7a 65 2e 20 54 68 65 20 abase size. The
1fdd0 57 61 6c 44 62 73 69 7a 65 28 29 0a 20 20 2a 2a WalDbsize(). **
1fde0 20 66 75 6e 63 74 69 6f 6e 20 72 65 74 75 72 6e function return
1fdf0 73 20 7a 65 72 6f 20 69 66 20 74 68 65 20 57 41 s zero if the WA
1fe00 4c 20 69 73 20 6e 6f 74 20 6f 70 65 6e 20 28 69 L is not open (i
1fe10 2e 65 2e 20 50 61 67 65 72 2e 70 57 61 6c 3d 3d .e. Pager.pWal==
1fe20 30 29 2c 20 6f 72 0a 20 20 2a 2a 20 69 66 20 74 0), or. ** if t
1fe30 68 65 20 64 61 74 61 62 61 73 65 20 73 69 7a 65 he database size
1fe40 20 69 73 20 6e 6f 74 20 61 76 61 69 6c 61 62 6c is not availabl
1fe50 65 2e 20 54 68 65 20 64 61 74 61 62 61 73 65 20 e. The database
1fe60 73 69 7a 65 20 69 73 20 6e 6f 74 0a 20 20 2a 2a size is not. **
1fe70 20 61 76 61 69 6c 61 62 6c 65 20 66 72 6f 6d 20 available from
1fe80 74 68 65 20 57 41 4c 20 73 75 62 2d 73 79 73 74 the WAL sub-syst
1fe90 65 6d 20 69 66 20 74 68 65 20 6c 6f 67 20 66 69 em if the log fi
1fea0 6c 65 20 69 73 20 65 6d 70 74 79 20 6f 72 0a 20 le is empty or.
1feb0 20 2a 2a 20 63 6f 6e 74 61 69 6e 73 20 6e 6f 20 ** contains no
1fec0 76 61 6c 69 64 20 63 6f 6d 6d 69 74 74 65 64 20 valid committed
1fed0 74 72 61 6e 73 61 63 74 69 6f 6e 73 2e 0a 20 20 transactions..
1fee0 2a 2f 0a 20 20 61 73 73 65 72 74 28 20 70 50 61 */. assert( pPa
1fef0 67 65 72 2d 3e 65 53 74 61 74 65 3d 3d 50 41 47 ger->eState==PAG
1ff00 45 52 5f 4f 50 45 4e 20 29 3b 0a 20 20 61 73 73 ER_OPEN );. ass
1ff10 65 72 74 28 20 70 50 61 67 65 72 2d 3e 65 4c 6f ert( pPager->eLo
1ff20 63 6b 3e 3d 53 48 41 52 45 44 5f 4c 4f 43 4b 20 ck>=SHARED_LOCK
1ff30 29 3b 0a 20 20 61 73 73 65 72 74 28 20 69 73 4f );. assert( isO
1ff40 70 65 6e 28 70 50 61 67 65 72 2d 3e 66 64 29 20 pen(pPager->fd)
1ff50 29 3b 0a 20 20 61 73 73 65 72 74 28 20 70 50 61 );. assert( pPa
1ff60 67 65 72 2d 3e 74 65 6d 70 46 69 6c 65 3d 3d 30 ger->tempFile==0
1ff70 20 29 3b 0a 20 20 6e 50 61 67 65 20 3d 20 73 71 );. nPage = sq
1ff80 6c 69 74 65 33 57 61 6c 44 62 73 69 7a 65 28 70 lite3WalDbsize(p
1ff90 50 61 67 65 72 2d 3e 70 57 61 6c 29 3b 0a 0a 20 Pager->pWal);..
1ffa0 20 2f 2a 20 49 66 20 74 68 65 20 6e 75 6d 62 65 /* If the numbe
1ffb0 72 20 6f 66 20 70 61 67 65 73 20 69 6e 20 74 68 r of pages in th
1ffc0 65 20 64 61 74 61 62 61 73 65 20 69 73 20 6e 6f e database is no
1ffd0 74 20 61 76 61 69 6c 61 62 6c 65 20 66 72 6f 6d t available from
1ffe0 20 74 68 65 0a 20 20 2a 2a 20 57 41 4c 20 73 75 the. ** WAL su
1fff0 62 2d 73 79 73 74 65 6d 2c 20 64 65 74 65 72 6d b-system, determ
20000 69 6e 65 20 74 68 65 20 70 61 67 65 20 63 6f 75 ine the page cou
20010 6e 74 65 20 62 61 73 65 64 20 6f 6e 20 74 68 65 nte based on the
20020 20 73 69 7a 65 20 6f 66 0a 20 20 2a 2a 20 74 68 size of. ** th
20030 65 20 64 61 74 61 62 61 73 65 20 66 69 6c 65 2e e database file.
20040 20 20 49 66 20 74 68 65 20 73 69 7a 65 20 6f 66 If the size of
20050 20 74 68 65 20 64 61 74 61 62 61 73 65 20 66 69 the database fi
20060 6c 65 20 69 73 20 6e 6f 74 20 61 6e 0a 20 20 2a le is not an. *
20070 2a 20 69 6e 74 65 67 65 72 20 6d 75 6c 74 69 70 * integer multip
20080 6c 65 20 6f 66 20 74 68 65 20 70 61 67 65 2d 73 le of the page-s
20090 69 7a 65 2c 20 72 6f 75 6e 64 20 75 70 20 74 68 ize, round up th
200a0 65 20 72 65 73 75 6c 74 2e 0a 20 20 2a 2f 0a 20 e result.. */.
200b0 20 69 66 28 20 6e 50 61 67 65 3d 3d 30 20 26 26 if( nPage==0 &&
200c0 20 41 4c 57 41 59 53 28 69 73 4f 70 65 6e 28 70 ALWAYS(isOpen(p
200d0 50 61 67 65 72 2d 3e 66 64 29 29 20 29 7b 0a 20 Pager->fd)) ){.
200e0 20 20 20 69 36 34 20 6e 20 3d 20 30 3b 20 20 20 i64 n = 0;
200f0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
20100 20 2f 2a 20 53 69 7a 65 20 6f 66 20 64 62 20 66 /* Size of db f
20110 69 6c 65 20 69 6e 20 62 79 74 65 73 20 2a 2f 0a ile in bytes */.
20120 20 20 20 20 69 6e 74 20 72 63 20 3d 20 73 71 6c int rc = sql
20130 69 74 65 33 4f 73 46 69 6c 65 53 69 7a 65 28 70 ite3OsFileSize(p
20140 50 61 67 65 72 2d 3e 66 64 2c 20 26 6e 29 3b 0a Pager->fd, &n);.
20150 20 20 20 20 69 66 28 20 72 63 21 3d 53 51 4c 49 if( rc!=SQLI
20160 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 20 20 72 TE_OK ){. r
20170 65 74 75 72 6e 20 72 63 3b 0a 20 20 20 20 7d 0a eturn rc;. }.
20180 20 20 20 20 6e 50 61 67 65 20 3d 20 28 50 67 6e nPage = (Pgn
20190 6f 29 28 28 6e 2b 70 50 61 67 65 72 2d 3e 70 61 o)((n+pPager->pa
201a0 67 65 53 69 7a 65 2d 31 29 20 2f 20 70 50 61 67 geSize-1) / pPag
201b0 65 72 2d 3e 70 61 67 65 53 69 7a 65 29 3b 0a 20 er->pageSize);.
201c0 20 7d 0a 0a 20 20 2f 2a 20 49 66 20 74 68 65 20 }.. /* If the
201d0 63 75 72 72 65 6e 74 20 6e 75 6d 62 65 72 20 6f current number o
201e0 66 20 70 61 67 65 73 20 69 6e 20 74 68 65 20 66 f pages in the f
201f0 69 6c 65 20 69 73 20 67 72 65 61 74 65 72 20 74 ile is greater t
20200 68 61 6e 20 74 68 65 0a 20 20 2a 2a 20 63 6f 6e han the. ** con
20210 66 69 67 75 72 65 64 20 6d 61 78 69 6d 75 6d 20 figured maximum
20220 70 61 67 65 72 20 6e 75 6d 62 65 72 2c 20 69 6e pager number, in
20230 63 72 65 61 73 65 20 74 68 65 20 61 6c 6c 6f 77 crease the allow
20240 65 64 20 6c 69 6d 69 74 20 73 6f 0a 20 20 2a 2a ed limit so. **
20250 20 74 68 61 74 20 74 68 65 20 66 69 6c 65 20 63 that the file c
20260 61 6e 20 62 65 20 72 65 61 64 2e 0a 20 20 2a 2f an be read.. */
20270 0a 20 20 69 66 28 20 6e 50 61 67 65 3e 70 50 61 . if( nPage>pPa
20280 67 65 72 2d 3e 6d 78 50 67 6e 6f 20 29 7b 0a 20 ger->mxPgno ){.
20290 20 20 20 70 50 61 67 65 72 2d 3e 6d 78 50 67 6e pPager->mxPgn
202a0 6f 20 3d 20 28 50 67 6e 6f 29 6e 50 61 67 65 3b o = (Pgno)nPage;
202b0 0a 20 20 7d 0a 0a 20 20 2a 70 6e 50 61 67 65 20 . }.. *pnPage
202c0 3d 20 6e 50 61 67 65 3b 0a 20 20 72 65 74 75 72 = nPage;. retur
202d0 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 7d 0a 0a n SQLITE_OK;.}..
202e0 23 69 66 6e 64 65 66 20 53 51 4c 49 54 45 5f 4f #ifndef SQLITE_O
202f0 4d 49 54 5f 57 41 4c 0a 2f 2a 0a 2a 2a 20 43 68 MIT_WAL./*.** Ch
20300 65 63 6b 20 69 66 20 74 68 65 20 2a 2d 77 61 6c eck if the *-wal
20310 20 66 69 6c 65 20 74 68 61 74 20 63 6f 72 72 65 file that corre
20320 73 70 6f 6e 64 73 20 74 6f 20 74 68 65 20 64 61 sponds to the da
20330 74 61 62 61 73 65 20 6f 70 65 6e 65 64 20 62 79 tabase opened by
20340 20 70 50 61 67 65 72 0a 2a 2a 20 65 78 69 73 74 pPager.** exist
20350 73 20 69 66 20 74 68 65 20 64 61 74 61 62 61 73 s if the databas
20360 65 20 69 73 20 6e 6f 74 20 65 6d 70 79 2c 20 6f e is not empy, o
20370 72 20 76 65 72 69 66 79 20 74 68 61 74 20 74 68 r verify that th
20380 65 20 2a 2d 77 61 6c 20 66 69 6c 65 20 64 6f 65 e *-wal file doe
20390 73 0a 2a 2a 20 6e 6f 74 20 65 78 69 73 74 20 28 s.** not exist (
203a0 62 79 20 64 65 6c 65 74 69 6e 67 20 69 74 29 20 by deleting it)
203b0 69 66 20 74 68 65 20 64 61 74 61 62 61 73 65 20 if the database
203c0 66 69 6c 65 20 69 73 20 65 6d 70 74 79 2e 0a 2a file is empty..*
203d0 2a 0a 2a 2a 20 49 66 20 74 68 65 20 64 61 74 61 *.** If the data
203e0 62 61 73 65 20 69 73 20 6e 6f 74 20 65 6d 70 74 base is not empt
203f0 79 20 61 6e 64 20 74 68 65 20 2a 2d 77 61 6c 20 y and the *-wal
20400 66 69 6c 65 20 65 78 69 73 74 73 2c 20 6f 70 65 file exists, ope
20410 6e 20 74 68 65 20 70 61 67 65 72 0a 2a 2a 20 69 n the pager.** i
20420 6e 20 57 41 4c 20 6d 6f 64 65 2e 20 20 49 66 20 n WAL mode. If
20430 74 68 65 20 64 61 74 61 62 61 73 65 20 69 73 20 the database is
20440 65 6d 70 74 79 20 6f 72 20 69 66 20 6e 6f 20 2a empty or if no *
20450 2d 77 61 6c 20 66 69 6c 65 20 65 78 69 73 74 73 -wal file exists
20460 20 61 6e 64 0a 2a 2a 20 69 66 20 6e 6f 20 65 72 and.** if no er
20470 72 6f 72 20 6f 63 63 75 72 73 2c 20 6d 61 6b 65 ror occurs, make
20480 20 73 75 72 65 20 50 61 67 65 72 2e 6a 6f 75 72 sure Pager.jour
20490 6e 61 6c 4d 6f 64 65 20 69 73 20 6e 6f 74 20 73 nalMode is not s
204a0 65 74 20 74 6f 0a 2a 2a 20 50 41 47 45 52 5f 4a et to.** PAGER_J
204b0 4f 55 52 4e 41 4c 4d 4f 44 45 5f 57 41 4c 2e 0a OURNALMODE_WAL..
204c0 2a 2a 0a 2a 2a 20 52 65 74 75 72 6e 20 53 51 4c **.** Return SQL
204d0 49 54 45 5f 4f 4b 20 6f 72 20 61 6e 20 65 72 72 ITE_OK or an err
204e0 6f 72 20 63 6f 64 65 2e 0a 2a 2a 0a 2a 2a 20 54 or code..**.** T
204f0 68 65 20 63 61 6c 6c 65 72 20 6d 75 73 74 20 68 he caller must h
20500 6f 6c 64 20 61 20 53 48 41 52 45 44 20 6c 6f 63 old a SHARED loc
20510 6b 20 6f 6e 20 74 68 65 20 64 61 74 61 62 61 73 k on the databas
20520 65 20 66 69 6c 65 20 74 6f 20 63 61 6c 6c 20 74 e file to call t
20530 68 69 73 0a 2a 2a 20 66 75 6e 63 74 69 6f 6e 2e his.** function.
20540 20 42 65 63 61 75 73 65 20 61 6e 20 45 58 43 4c Because an EXCL
20550 55 53 49 56 45 20 6c 6f 63 6b 20 6f 6e 20 74 68 USIVE lock on th
20560 65 20 64 62 20 66 69 6c 65 20 69 73 20 72 65 71 e db file is req
20570 75 69 72 65 64 20 74 6f 20 64 65 6c 65 74 65 20 uired to delete
20580 0a 2a 2a 20 61 20 57 41 4c 20 6f 6e 20 61 20 6e .** a WAL on a n
20590 6f 6e 65 2d 65 6d 70 74 79 20 64 61 74 61 62 61 one-empty databa
205a0 73 65 2c 20 74 68 69 73 20 65 6e 73 75 72 65 73 se, this ensures
205b0 20 74 68 65 72 65 20 69 73 20 6e 6f 20 72 61 63 there is no rac
205c0 65 20 63 6f 6e 64 69 74 69 6f 6e 20 0a 2a 2a 20 e condition .**
205d0 62 65 74 77 65 65 6e 20 74 68 65 20 78 41 63 63 between the xAcc
205e0 65 73 73 28 29 20 62 65 6c 6f 77 20 61 6e 64 20 ess() below and
205f0 61 6e 20 78 44 65 6c 65 74 65 28 29 20 62 65 69 an xDelete() bei
20600 6e 67 20 65 78 65 63 75 74 65 64 20 62 79 20 73 ng executed by s
20610 6f 6d 65 20 0a 2a 2a 20 6f 74 68 65 72 20 63 6f ome .** other co
20620 6e 6e 65 63 74 69 6f 6e 2e 0a 2a 2f 0a 73 74 61 nnection..*/.sta
20630 74 69 63 20 69 6e 74 20 70 61 67 65 72 4f 70 65 tic int pagerOpe
20640 6e 57 61 6c 49 66 50 72 65 73 65 6e 74 28 50 61 nWalIfPresent(Pa
20650 67 65 72 20 2a 70 50 61 67 65 72 29 7b 0a 20 20 ger *pPager){.
20660 69 6e 74 20 72 63 20 3d 20 53 51 4c 49 54 45 5f int rc = SQLITE_
20670 4f 4b 3b 0a 20 20 61 73 73 65 72 74 28 20 70 50 OK;. assert( pP
20680 61 67 65 72 2d 3e 65 53 74 61 74 65 3d 3d 50 41 ager->eState==PA
20690 47 45 52 5f 4f 50 45 4e 20 29 3b 0a 20 20 61 73 GER_OPEN );. as
206a0 73 65 72 74 28 20 70 50 61 67 65 72 2d 3e 65 4c sert( pPager->eL
206b0 6f 63 6b 3e 3d 53 48 41 52 45 44 5f 4c 4f 43 4b ock>=SHARED_LOCK
206c0 20 29 3b 0a 0a 20 20 69 66 28 20 21 70 50 61 67 );.. if( !pPag
206d0 65 72 2d 3e 74 65 6d 70 46 69 6c 65 20 29 7b 0a er->tempFile ){.
206e0 20 20 20 20 69 6e 74 20 69 73 57 61 6c 3b 20 20 int isWal;
206f0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
20700 20 20 2f 2a 20 54 72 75 65 20 69 66 20 57 41 4c /* True if WAL
20710 20 66 69 6c 65 20 65 78 69 73 74 73 20 2a 2f 0a file exists */.
20720 20 20 20 20 50 67 6e 6f 20 6e 50 61 67 65 3b 20 Pgno nPage;
20730 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
20740 20 20 2f 2a 20 53 69 7a 65 20 6f 66 20 74 68 65 /* Size of the
20750 20 64 61 74 61 62 61 73 65 20 66 69 6c 65 20 2a database file *
20760 2f 0a 0a 20 20 20 20 72 63 20 3d 20 70 61 67 65 /.. rc = page
20770 72 50 61 67 65 63 6f 75 6e 74 28 70 50 61 67 65 rPagecount(pPage
20780 72 2c 20 26 6e 50 61 67 65 29 3b 0a 20 20 20 20 r, &nPage);.
20790 69 66 28 20 72 63 20 29 20 72 65 74 75 72 6e 20 if( rc ) return
207a0 72 63 3b 0a 20 20 20 20 69 66 28 20 6e 50 61 67 rc;. if( nPag
207b0 65 3d 3d 30 20 29 7b 0a 20 20 20 20 20 20 72 63 e==0 ){. rc
207c0 20 3d 20 73 71 6c 69 74 65 33 4f 73 44 65 6c 65 = sqlite3OsDele
207d0 74 65 28 70 50 61 67 65 72 2d 3e 70 56 66 73 2c te(pPager->pVfs,
207e0 20 70 50 61 67 65 72 2d 3e 7a 57 61 6c 2c 20 30 pPager->zWal, 0
207f0 29 3b 0a 20 20 20 20 20 20 69 66 28 20 72 63 3d );. if( rc=
20800 3d 53 51 4c 49 54 45 5f 49 4f 45 52 52 5f 44 45 =SQLITE_IOERR_DE
20810 4c 45 54 45 5f 4e 4f 45 4e 54 20 29 20 72 63 20 LETE_NOENT ) rc
20820 3d 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20 20 20 = SQLITE_OK;.
20830 20 20 20 69 73 57 61 6c 20 3d 20 30 3b 0a 20 20 isWal = 0;.
20840 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 20 20 72 }else{. r
20850 63 20 3d 20 73 71 6c 69 74 65 33 4f 73 41 63 63 c = sqlite3OsAcc
20860 65 73 73 28 0a 20 20 20 20 20 20 20 20 20 20 70 ess(. p
20870 50 61 67 65 72 2d 3e 70 56 66 73 2c 20 70 50 61 Pager->pVfs, pPa
20880 67 65 72 2d 3e 7a 57 61 6c 2c 20 53 51 4c 49 54 ger->zWal, SQLIT
20890 45 5f 41 43 43 45 53 53 5f 45 58 49 53 54 53 2c E_ACCESS_EXISTS,
208a0 20 26 69 73 57 61 6c 0a 20 20 20 20 20 20 29 3b &isWal. );
208b0 0a 20 20 20 20 7d 0a 20 20 20 20 69 66 28 20 72 . }. if( r
208c0 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a c==SQLITE_OK ){.
208d0 20 20 20 20 20 20 69 66 28 20 69 73 57 61 6c 20 if( isWal
208e0 29 7b 0a 20 20 20 20 20 20 20 20 74 65 73 74 63 ){. testc
208f0 61 73 65 28 20 73 71 6c 69 74 65 33 50 63 61 63 ase( sqlite3Pcac
20900 68 65 50 61 67 65 63 6f 75 6e 74 28 70 50 61 67 hePagecount(pPag
20910 65 72 2d 3e 70 50 43 61 63 68 65 29 3d 3d 30 20 er->pPCache)==0
20920 29 3b 0a 20 20 20 20 20 20 20 20 72 63 20 3d 20 );. rc =
20930 73 71 6c 69 74 65 33 50 61 67 65 72 4f 70 65 6e sqlite3PagerOpen
20940 57 61 6c 28 70 50 61 67 65 72 2c 20 30 29 3b 0a Wal(pPager, 0);.
20950 20 20 20 20 20 20 7d 65 6c 73 65 20 69 66 28 20 }else if(
20960 70 50 61 67 65 72 2d 3e 6a 6f 75 72 6e 61 6c 4d pPager->journalM
20970 6f 64 65 3d 3d 50 41 47 45 52 5f 4a 4f 55 52 4e ode==PAGER_JOURN
20980 41 4c 4d 4f 44 45 5f 57 41 4c 20 29 7b 0a 20 20 ALMODE_WAL ){.
20990 20 20 20 20 20 20 70 50 61 67 65 72 2d 3e 6a 6f pPager->jo
209a0 75 72 6e 61 6c 4d 6f 64 65 20 3d 20 50 41 47 45 urnalMode = PAGE
209b0 52 5f 4a 4f 55 52 4e 41 4c 4d 4f 44 45 5f 44 45 R_JOURNALMODE_DE
209c0 4c 45 54 45 3b 0a 20 20 20 20 20 20 7d 0a 20 20 LETE;. }.
209d0 20 20 7d 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e }. }. return
209e0 20 72 63 3b 0a 7d 0a 23 65 6e 64 69 66 0a 0a 2f rc;.}.#endif../
209f0 2a 0a 2a 2a 20 50 6c 61 79 62 61 63 6b 20 73 61 *.** Playback sa
20a00 76 65 70 6f 69 6e 74 20 70 53 61 76 65 70 6f 69 vepoint pSavepoi
20a10 6e 74 2e 20 4f 72 2c 20 69 66 20 70 53 61 76 65 nt. Or, if pSave
20a20 70 6f 69 6e 74 3d 3d 4e 55 4c 4c 2c 20 74 68 65 point==NULL, the
20a30 6e 20 70 6c 61 79 62 61 63 6b 0a 2a 2a 20 74 68 n playback.** th
20a40 65 20 65 6e 74 69 72 65 20 6d 61 73 74 65 72 20 e entire master
20a50 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 2e 20 54 68 journal file. Th
20a60 65 20 63 61 73 65 20 70 53 61 76 65 70 6f 69 6e e case pSavepoin
20a70 74 3d 3d 4e 55 4c 4c 20 6f 63 63 75 72 73 20 77 t==NULL occurs w
20a80 68 65 6e 20 0a 2a 2a 20 61 20 52 4f 4c 4c 42 41 hen .** a ROLLBA
20a90 43 4b 20 54 4f 20 63 6f 6d 6d 61 6e 64 20 69 73 CK TO command is
20aa0 20 69 6e 76 6f 6b 65 64 20 6f 6e 20 61 20 53 41 invoked on a SA
20ab0 56 45 50 4f 49 4e 54 20 74 68 61 74 20 69 73 20 VEPOINT that is
20ac0 61 20 74 72 61 6e 73 61 63 74 69 6f 6e 20 0a 2a a transaction .*
20ad0 2a 20 73 61 76 65 70 6f 69 6e 74 2e 0a 2a 2a 0a * savepoint..**.
20ae0 2a 2a 20 57 68 65 6e 20 70 53 61 76 65 70 6f 69 ** When pSavepoi
20af0 6e 74 20 69 73 20 6e 6f 74 20 4e 55 4c 4c 20 28 nt is not NULL (
20b00 6d 65 61 6e 69 6e 67 20 61 20 6e 6f 6e 2d 74 72 meaning a non-tr
20b10 61 6e 73 61 63 74 69 6f 6e 20 73 61 76 65 70 6f ansaction savepo
20b20 69 6e 74 20 69 73 20 0a 2a 2a 20 62 65 69 6e 67 int is .** being
20b30 20 72 6f 6c 6c 65 64 20 62 61 63 6b 29 2c 20 74 rolled back), t
20b40 68 65 6e 20 74 68 65 20 72 6f 6c 6c 62 61 63 6b hen the rollback
20b50 20 63 6f 6e 73 69 73 74 73 20 6f 66 20 75 70 20 consists of up
20b60 74 6f 20 74 68 72 65 65 20 73 74 61 67 65 73 2c to three stages,
20b70 0a 2a 2a 20 70 65 72 66 6f 72 6d 65 64 20 69 6e .** performed in
20b80 20 74 68 65 20 6f 72 64 65 72 20 73 70 65 63 69 the order speci
20b90 66 69 65 64 3a 0a 2a 2a 0a 2a 2a 20 20 20 2a 20 fied:.**.** *
20ba0 50 61 67 65 73 20 61 72 65 20 70 6c 61 79 65 64 Pages are played
20bb0 20 62 61 63 6b 20 66 72 6f 6d 20 74 68 65 20 6d back from the m
20bc0 61 69 6e 20 6a 6f 75 72 6e 61 6c 20 73 74 61 72 ain journal star
20bd0 74 69 6e 67 20 61 74 20 62 79 74 65 0a 2a 2a 20 ting at byte.**
20be0 20 20 20 20 6f 66 66 73 65 74 20 50 61 67 65 72 offset Pager
20bf0 53 61 76 65 70 6f 69 6e 74 2e 69 4f 66 66 73 65 Savepoint.iOffse
20c00 74 20 61 6e 64 20 63 6f 6e 74 69 6e 75 69 6e 67 t and continuing
20c10 20 74 6f 20 0a 2a 2a 20 20 20 20 20 50 61 67 65 to .** Page
20c20 72 53 61 76 65 70 6f 69 6e 74 2e 69 48 64 72 4f rSavepoint.iHdrO
20c30 66 66 73 65 74 2c 20 6f 72 20 74 6f 20 74 68 65 ffset, or to the
20c40 20 65 6e 64 20 6f 66 20 74 68 65 20 6d 61 69 6e end of the main
20c50 20 6a 6f 75 72 6e 61 6c 0a 2a 2a 20 20 20 20 20 journal.**
20c60 66 69 6c 65 20 69 66 20 50 61 67 65 72 53 61 76 file if PagerSav
20c70 65 70 6f 69 6e 74 2e 69 48 64 72 4f 66 66 73 65 epoint.iHdrOffse
20c80 74 20 69 73 20 7a 65 72 6f 2e 0a 2a 2a 0a 2a 2a t is zero..**.**
20c90 20 20 20 2a 20 49 66 20 50 61 67 65 72 53 61 76 * If PagerSav
20ca0 65 70 6f 69 6e 74 2e 69 48 64 72 4f 66 66 73 65 epoint.iHdrOffse
20cb0 74 20 69 73 20 6e 6f 74 20 7a 65 72 6f 2c 20 74 t is not zero, t
20cc0 68 65 6e 20 70 61 67 65 73 20 61 72 65 20 70 6c hen pages are pl
20cd0 61 79 65 64 0a 2a 2a 20 20 20 20 20 62 61 63 6b ayed.** back
20ce0 20 73 74 61 72 74 69 6e 67 20 66 72 6f 6d 20 74 starting from t
20cf0 68 65 20 6a 6f 75 72 6e 61 6c 20 68 65 61 64 65 he journal heade
20d00 72 20 69 6d 6d 65 64 69 61 74 65 6c 79 20 66 6f r immediately fo
20d10 6c 6c 6f 77 69 6e 67 20 0a 2a 2a 20 20 20 20 20 llowing .**
20d20 50 61 67 65 72 53 61 76 65 70 6f 69 6e 74 2e 69 PagerSavepoint.i
20d30 48 64 72 4f 66 66 73 65 74 20 74 6f 20 74 68 65 HdrOffset to the
20d40 20 65 6e 64 20 6f 66 20 74 68 65 20 6d 61 69 6e end of the main
20d50 20 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 2e 0a 2a journal file..*
20d60 2a 0a 2a 2a 20 20 20 2a 20 50 61 67 65 73 20 61 *.** * Pages a
20d70 72 65 20 74 68 65 6e 20 70 6c 61 79 65 64 20 62 re then played b
20d80 61 63 6b 20 66 72 6f 6d 20 74 68 65 20 73 75 62 ack from the sub
20d90 2d 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 2c 20 73 -journal file, s
20da0 74 61 72 74 69 6e 67 0a 2a 2a 20 20 20 20 20 77 tarting.** w
20db0 69 74 68 20 74 68 65 20 50 61 67 65 72 53 61 76 ith the PagerSav
20dc0 65 70 6f 69 6e 74 2e 69 53 75 62 52 65 63 20 61 epoint.iSubRec a
20dd0 6e 64 20 63 6f 6e 74 69 6e 75 69 6e 67 20 74 6f nd continuing to
20de0 20 74 68 65 20 65 6e 64 20 6f 66 0a 2a 2a 20 20 the end of.**
20df0 20 20 20 74 68 65 20 6a 6f 75 72 6e 61 6c 20 66 the journal f
20e00 69 6c 65 2e 0a 2a 2a 0a 2a 2a 20 54 68 72 6f 75 ile..**.** Throu
20e10 67 68 6f 75 74 20 74 68 65 20 72 6f 6c 6c 62 61 ghout the rollba
20e20 63 6b 20 70 72 6f 63 65 73 73 2c 20 65 61 63 68 ck process, each
20e30 20 74 69 6d 65 20 61 20 70 61 67 65 20 69 73 20 time a page is
20e40 72 6f 6c 6c 65 64 20 62 61 63 6b 2c 20 74 68 65 rolled back, the
20e50 0a 2a 2a 20 63 6f 72 72 65 73 70 6f 6e 64 69 6e .** correspondin
20e60 67 20 62 69 74 20 69 73 20 73 65 74 20 69 6e 20 g bit is set in
20e70 61 20 62 69 74 76 65 63 20 73 74 72 75 63 74 75 a bitvec structu
20e80 72 65 20 28 76 61 72 69 61 62 6c 65 20 70 44 6f re (variable pDo
20e90 6e 65 20 69 6e 20 74 68 65 0a 2a 2a 20 69 6d 70 ne in the.** imp
20ea0 6c 65 6d 65 6e 74 61 74 69 6f 6e 20 62 65 6c 6f lementation belo
20eb0 77 29 2e 20 54 68 69 73 20 69 73 20 75 73 65 64 w). This is used
20ec0 20 74 6f 20 65 6e 73 75 72 65 20 74 68 61 74 20 to ensure that
20ed0 61 20 70 61 67 65 20 69 73 20 6f 6e 6c 79 0a 2a a page is only.*
20ee0 2a 20 72 6f 6c 6c 65 64 20 62 61 63 6b 20 74 68 * rolled back th
20ef0 65 20 66 69 72 73 74 20 74 69 6d 65 20 69 74 20 e first time it
20f00 69 73 20 65 6e 63 6f 75 6e 74 65 72 65 64 20 69 is encountered i
20f10 6e 20 65 69 74 68 65 72 20 6a 6f 75 72 6e 61 6c n either journal
20f20 2e 0a 2a 2a 0a 2a 2a 20 49 66 20 70 53 61 76 65 ..**.** If pSave
20f30 70 6f 69 6e 74 20 69 73 20 4e 55 4c 4c 2c 20 74 point is NULL, t
20f40 68 65 6e 20 70 61 67 65 73 20 61 72 65 20 6f 6e hen pages are on
20f50 6c 79 20 70 6c 61 79 65 64 20 62 61 63 6b 20 66 ly played back f
20f60 72 6f 6d 20 74 68 65 20 6d 61 69 6e 0a 2a 2a 20 rom the main.**
20f70 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 2e 20 54 68 journal file. Th
20f80 65 72 65 20 69 73 20 6e 6f 20 6e 65 65 64 20 66 ere is no need f
20f90 6f 72 20 61 20 62 69 74 76 65 63 20 69 6e 20 74 or a bitvec in t
20fa0 68 69 73 20 63 61 73 65 2e 0a 2a 2a 0a 2a 2a 20 his case..**.**
20fb0 49 6e 20 65 69 74 68 65 72 20 63 61 73 65 2c 20 In either case,
20fc0 62 65 66 6f 72 65 20 70 6c 61 79 62 61 63 6b 20 before playback
20fd0 63 6f 6d 6d 65 6e 63 65 73 20 74 68 65 20 50 61 commences the Pa
20fe0 67 65 72 2e 64 62 53 69 7a 65 20 76 61 72 69 61 ger.dbSize varia
20ff0 62 6c 65 0a 2a 2a 20 69 73 20 72 65 73 65 74 20 ble.** is reset
21000 74 6f 20 74 68 65 20 76 61 6c 75 65 20 74 68 61 to the value tha
21010 74 20 69 74 20 68 65 6c 64 20 61 74 20 74 68 65 t it held at the
21020 20 73 74 61 72 74 20 6f 66 20 74 68 65 20 73 61 start of the sa
21030 76 65 70 6f 69 6e 74 20 0a 2a 2a 20 28 6f 72 20 vepoint .** (or
21040 74 72 61 6e 73 61 63 74 69 6f 6e 29 2e 20 4e 6f transaction). No
21050 20 70 61 67 65 20 77 69 74 68 20 61 20 70 61 67 page with a pag
21060 65 2d 6e 75 6d 62 65 72 20 67 72 65 61 74 65 72 e-number greater
21070 20 74 68 61 6e 20 74 68 69 73 20 76 61 6c 75 65 than this value
21080 0a 2a 2a 20 69 73 20 70 6c 61 79 65 64 20 62 61 .** is played ba
21090 63 6b 2e 20 49 66 20 6f 6e 65 20 69 73 20 65 6e ck. If one is en
210a0 63 6f 75 6e 74 65 72 65 64 20 69 74 20 69 73 20 countered it is
210b0 73 69 6d 70 6c 79 20 73 6b 69 70 70 65 64 2e 0a simply skipped..
210c0 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74 20 70 61 */.static int pa
210d0 67 65 72 50 6c 61 79 62 61 63 6b 53 61 76 65 70 gerPlaybackSavep
210e0 6f 69 6e 74 28 50 61 67 65 72 20 2a 70 50 61 67 oint(Pager *pPag
210f0 65 72 2c 20 50 61 67 65 72 53 61 76 65 70 6f 69 er, PagerSavepoi
21100 6e 74 20 2a 70 53 61 76 65 70 6f 69 6e 74 29 7b nt *pSavepoint){
21110 0a 20 20 69 36 34 20 73 7a 4a 3b 20 20 20 20 20 . i64 szJ;
21120 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 45 /* E
21130 66 66 65 63 74 69 76 65 20 73 69 7a 65 20 6f 66 ffective size of
21140 20 74 68 65 20 6d 61 69 6e 20 6a 6f 75 72 6e 61 the main journa
21150 6c 20 2a 2f 0a 20 20 69 36 34 20 69 48 64 72 4f l */. i64 iHdrO
21160 66 66 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 ff;
21170 2f 2a 20 45 6e 64 20 6f 66 20 66 69 72 73 74 20 /* End of first
21180 73 65 67 6d 65 6e 74 20 6f 66 20 6d 61 69 6e 2d segment of main-
21190 6a 6f 75 72 6e 61 6c 20 72 65 63 6f 72 64 73 20 journal records
211a0 2a 2f 0a 20 20 69 6e 74 20 72 63 20 3d 20 53 51 */. int rc = SQ
211b0 4c 49 54 45 5f 4f 4b 3b 20 20 20 20 20 20 2f 2a LITE_OK; /*
211c0 20 52 65 74 75 72 6e 20 63 6f 64 65 20 2a 2f 0a Return code */.
211d0 20 20 42 69 74 76 65 63 20 2a 70 44 6f 6e 65 20 Bitvec *pDone
211e0 3d 20 30 3b 20 20 20 20 20 20 20 2f 2a 20 42 69 = 0; /* Bi
211f0 74 76 65 63 20 74 6f 20 65 6e 73 75 72 65 20 70 tvec to ensure p
21200 61 67 65 73 20 70 6c 61 79 65 64 20 62 61 63 6b ages played back
21210 20 6f 6e 6c 79 20 6f 6e 63 65 20 2a 2f 0a 0a 20 only once */..
21220 20 61 73 73 65 72 74 28 20 70 50 61 67 65 72 2d assert( pPager-
21230 3e 65 53 74 61 74 65 21 3d 50 41 47 45 52 5f 45 >eState!=PAGER_E
21240 52 52 4f 52 20 29 3b 0a 20 20 61 73 73 65 72 74 RROR );. assert
21250 28 20 70 50 61 67 65 72 2d 3e 65 53 74 61 74 65 ( pPager->eState
21260 3e 3d 50 41 47 45 52 5f 57 52 49 54 45 52 5f 4c >=PAGER_WRITER_L
21270 4f 43 4b 45 44 20 29 3b 0a 0a 20 20 2f 2a 20 41 OCKED );.. /* A
21280 6c 6c 6f 63 61 74 65 20 61 20 62 69 74 76 65 63 llocate a bitvec
21290 20 74 6f 20 75 73 65 20 74 6f 20 73 74 6f 72 65 to use to store
212a0 20 74 68 65 20 73 65 74 20 6f 66 20 70 61 67 65 the set of page
212b0 73 20 72 6f 6c 6c 65 64 20 62 61 63 6b 20 2a 2f s rolled back */
212c0 0a 20 20 69 66 28 20 70 53 61 76 65 70 6f 69 6e . if( pSavepoin
212d0 74 20 29 7b 0a 20 20 20 20 70 44 6f 6e 65 20 3d t ){. pDone =
212e0 20 73 71 6c 69 74 65 33 42 69 74 76 65 63 43 72 sqlite3BitvecCr
212f0 65 61 74 65 28 70 53 61 76 65 70 6f 69 6e 74 2d eate(pSavepoint-
21300 3e 6e 4f 72 69 67 29 3b 0a 20 20 20 20 69 66 28 >nOrig);. if(
21310 20 21 70 44 6f 6e 65 20 29 7b 0a 20 20 20 20 20 !pDone ){.
21320 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4e return SQLITE_N
21330 4f 4d 45 4d 5f 42 4b 50 54 3b 0a 20 20 20 20 7d OMEM_BKPT;. }
21340 0a 20 20 7d 0a 0a 20 20 2f 2a 20 53 65 74 20 74 . }.. /* Set t
21350 68 65 20 64 61 74 61 62 61 73 65 20 73 69 7a 65 he database size
21360 20 62 61 63 6b 20 74 6f 20 74 68 65 20 76 61 6c back to the val
21370 75 65 20 69 74 20 77 61 73 20 62 65 66 6f 72 65 ue it was before
21380 20 74 68 65 20 73 61 76 65 70 6f 69 6e 74 20 0a the savepoint .
21390 20 20 2a 2a 20 62 65 69 6e 67 20 72 65 76 65 72 ** being rever
213a0 74 65 64 20 77 61 73 20 6f 70 65 6e 65 64 2e 0a ted was opened..
213b0 20 20 2a 2f 0a 20 20 70 50 61 67 65 72 2d 3e 64 */. pPager->d
213c0 62 53 69 7a 65 20 3d 20 70 53 61 76 65 70 6f 69 bSize = pSavepoi
213d0 6e 74 20 3f 20 70 53 61 76 65 70 6f 69 6e 74 2d nt ? pSavepoint-
213e0 3e 6e 4f 72 69 67 20 3a 20 70 50 61 67 65 72 2d >nOrig : pPager-
213f0 3e 64 62 4f 72 69 67 53 69 7a 65 3b 0a 20 20 70 >dbOrigSize;. p
21400 50 61 67 65 72 2d 3e 63 68 61 6e 67 65 43 6f 75 Pager->changeCou
21410 6e 74 44 6f 6e 65 20 3d 20 70 50 61 67 65 72 2d ntDone = pPager-
21420 3e 74 65 6d 70 46 69 6c 65 3b 0a 0a 20 20 69 66 >tempFile;.. if
21430 28 20 21 70 53 61 76 65 70 6f 69 6e 74 20 26 26 ( !pSavepoint &&
21440 20 70 61 67 65 72 55 73 65 57 61 6c 28 70 50 61 pagerUseWal(pPa
21450 67 65 72 29 20 29 7b 0a 20 20 20 20 72 65 74 75 ger) ){. retu
21460 72 6e 20 70 61 67 65 72 52 6f 6c 6c 62 61 63 6b rn pagerRollback
21470 57 61 6c 28 70 50 61 67 65 72 29 3b 0a 20 20 7d Wal(pPager);. }
21480 0a 0a 20 20 2f 2a 20 55 73 65 20 70 50 61 67 65 .. /* Use pPage
21490 72 2d 3e 6a 6f 75 72 6e 61 6c 4f 66 66 20 61 73 r->journalOff as
214a0 20 74 68 65 20 65 66 66 65 63 74 69 76 65 20 73 the effective s
214b0 69 7a 65 20 6f 66 20 74 68 65 20 6d 61 69 6e 20 ize of the main
214c0 72 6f 6c 6c 62 61 63 6b 0a 20 20 2a 2a 20 6a 6f rollback. ** jo
214d0 75 72 6e 61 6c 2e 20 20 54 68 65 20 61 63 74 75 urnal. The actu
214e0 61 6c 20 66 69 6c 65 20 6d 69 67 68 74 20 62 65 al file might be
214f0 20 6c 61 72 67 65 72 20 74 68 61 6e 20 74 68 69 larger than thi
21500 73 20 69 6e 0a 20 20 2a 2a 20 50 41 47 45 52 5f s in. ** PAGER_
21510 4a 4f 55 52 4e 41 4c 4d 4f 44 45 5f 54 52 55 4e JOURNALMODE_TRUN
21520 43 41 54 45 20 6f 72 20 50 41 47 45 52 5f 4a 4f CATE or PAGER_JO
21530 55 52 4e 41 4c 4d 4f 44 45 5f 50 45 52 53 49 53 URNALMODE_PERSIS
21540 54 2e 20 20 42 75 74 20 61 6e 79 74 68 69 6e 67 T. But anything
21550 0a 20 20 2a 2a 20 70 61 73 74 20 70 50 61 67 65 . ** past pPage
21560 72 2d 3e 6a 6f 75 72 6e 61 6c 4f 66 66 20 69 73 r->journalOff is
21570 20 6f 66 66 2d 6c 69 6d 69 74 73 20 74 6f 20 75 off-limits to u
21580 73 2e 0a 20 20 2a 2f 0a 20 20 73 7a 4a 20 3d 20 s.. */. szJ =
21590 70 50 61 67 65 72 2d 3e 6a 6f 75 72 6e 61 6c 4f pPager->journalO
215a0 66 66 3b 0a 20 20 61 73 73 65 72 74 28 20 70 61 ff;. assert( pa
215b0 67 65 72 55 73 65 57 61 6c 28 70 50 61 67 65 72 gerUseWal(pPager
215c0 29 3d 3d 30 20 7c 7c 20 73 7a 4a 3d 3d 30 20 29 )==0 || szJ==0 )
215d0 3b 0a 0a 20 20 2f 2a 20 42 65 67 69 6e 20 62 79 ;.. /* Begin by
215e0 20 72 6f 6c 6c 69 6e 67 20 62 61 63 6b 20 72 65 rolling back re
215f0 63 6f 72 64 73 20 66 72 6f 6d 20 74 68 65 20 6d cords from the m
21600 61 69 6e 20 6a 6f 75 72 6e 61 6c 20 73 74 61 72 ain journal star
21610 74 69 6e 67 20 61 74 0a 20 20 2a 2a 20 50 61 67 ting at. ** Pag
21620 65 72 53 61 76 65 70 6f 69 6e 74 2e 69 4f 66 66 erSavepoint.iOff
21630 73 65 74 20 61 6e 64 20 63 6f 6e 74 69 6e 75 69 set and continui
21640 6e 67 20 74 6f 20 74 68 65 20 6e 65 78 74 20 6a ng to the next j
21650 6f 75 72 6e 61 6c 20 68 65 61 64 65 72 2e 0a 20 ournal header..
21660 20 2a 2a 20 54 68 65 72 65 20 6d 69 67 68 74 20 ** There might
21670 62 65 20 72 65 63 6f 72 64 73 20 69 6e 20 74 68 be records in th
21680 65 20 6d 61 69 6e 20 6a 6f 75 72 6e 61 6c 20 74 e main journal t
21690 68 61 74 20 68 61 76 65 20 61 20 70 61 67 65 20 hat have a page
216a0 6e 75 6d 62 65 72 0a 20 20 2a 2a 20 67 72 65 61 number. ** grea
216b0 74 65 72 20 74 68 61 6e 20 74 68 65 20 63 75 72 ter than the cur
216c0 72 65 6e 74 20 64 61 74 61 62 61 73 65 20 73 69 rent database si
216d0 7a 65 20 28 70 50 61 67 65 72 2d 3e 64 62 53 69 ze (pPager->dbSi
216e0 7a 65 29 20 62 75 74 20 74 68 6f 73 65 0a 20 20 ze) but those.
216f0 2a 2a 20 77 69 6c 6c 20 62 65 20 73 6b 69 70 70 ** will be skipp
21700 65 64 20 61 75 74 6f 6d 61 74 69 63 61 6c 6c 79 ed automatically
21710 2e 20 20 50 61 67 65 73 20 61 72 65 20 61 64 64 . Pages are add
21720 65 64 20 74 6f 20 70 44 6f 6e 65 20 61 73 20 74 ed to pDone as t
21730 68 65 79 0a 20 20 2a 2a 20 61 72 65 20 70 6c 61 hey. ** are pla
21740 79 65 64 20 62 61 63 6b 2e 0a 20 20 2a 2f 0a 20 yed back.. */.
21750 20 69 66 28 20 70 53 61 76 65 70 6f 69 6e 74 20 if( pSavepoint
21760 26 26 20 21 70 61 67 65 72 55 73 65 57 61 6c 28 && !pagerUseWal(
21770 70 50 61 67 65 72 29 20 29 7b 0a 20 20 20 20 69 pPager) ){. i
21780 48 64 72 4f 66 66 20 3d 20 70 53 61 76 65 70 6f HdrOff = pSavepo
21790 69 6e 74 2d 3e 69 48 64 72 4f 66 66 73 65 74 20 int->iHdrOffset
217a0 3f 20 70 53 61 76 65 70 6f 69 6e 74 2d 3e 69 48 ? pSavepoint->iH
217b0 64 72 4f 66 66 73 65 74 20 3a 20 73 7a 4a 3b 0a drOffset : szJ;.
217c0 20 20 20 20 70 50 61 67 65 72 2d 3e 6a 6f 75 72 pPager->jour
217d0 6e 61 6c 4f 66 66 20 3d 20 70 53 61 76 65 70 6f nalOff = pSavepo
217e0 69 6e 74 2d 3e 69 4f 66 66 73 65 74 3b 0a 20 20 int->iOffset;.
217f0 20 20 77 68 69 6c 65 28 20 72 63 3d 3d 53 51 4c while( rc==SQL
21800 49 54 45 5f 4f 4b 20 26 26 20 70 50 61 67 65 72 ITE_OK && pPager
21810 2d 3e 6a 6f 75 72 6e 61 6c 4f 66 66 3c 69 48 64 ->journalOff<iHd
21820 72 4f 66 66 20 29 7b 0a 20 20 20 20 20 20 72 63 rOff ){. rc
21830 20 3d 20 70 61 67 65 72 5f 70 6c 61 79 62 61 63 = pager_playbac
21840 6b 5f 6f 6e 65 5f 70 61 67 65 28 70 50 61 67 65 k_one_page(pPage
21850 72 2c 20 26 70 50 61 67 65 72 2d 3e 6a 6f 75 72 r, &pPager->jour
21860 6e 61 6c 4f 66 66 2c 20 70 44 6f 6e 65 2c 20 31 nalOff, pDone, 1
21870 2c 20 31 29 3b 0a 20 20 20 20 7d 0a 20 20 20 20 , 1);. }.
21880 61 73 73 65 72 74 28 20 72 63 21 3d 53 51 4c 49 assert( rc!=SQLI
21890 54 45 5f 44 4f 4e 45 20 29 3b 0a 20 20 7d 65 6c TE_DONE );. }el
218a0 73 65 7b 0a 20 20 20 20 70 50 61 67 65 72 2d 3e se{. pPager->
218b0 6a 6f 75 72 6e 61 6c 4f 66 66 20 3d 20 30 3b 0a journalOff = 0;.
218c0 20 20 7d 0a 0a 20 20 2f 2a 20 43 6f 6e 74 69 6e }.. /* Contin
218d0 75 65 20 72 6f 6c 6c 69 6e 67 20 62 61 63 6b 20 ue rolling back
218e0 72 65 63 6f 72 64 73 20 6f 75 74 20 6f 66 20 74 records out of t
218f0 68 65 20 6d 61 69 6e 20 6a 6f 75 72 6e 61 6c 20 he main journal
21900 73 74 61 72 74 69 6e 67 20 61 74 0a 20 20 2a 2a starting at. **
21910 20 74 68 65 20 66 69 72 73 74 20 6a 6f 75 72 6e the first journ
21920 61 6c 20 68 65 61 64 65 72 20 73 65 65 6e 20 61 al header seen a
21930 6e 64 20 63 6f 6e 74 69 6e 75 69 6e 67 20 75 6e nd continuing un
21940 74 69 6c 20 74 68 65 20 65 66 66 65 63 74 69 76 til the effectiv
21950 65 20 65 6e 64 0a 20 20 2a 2a 20 6f 66 20 74 68 e end. ** of th
21960 65 20 6d 61 69 6e 20 6a 6f 75 72 6e 61 6c 20 66 e main journal f
21970 69 6c 65 2e 20 20 43 6f 6e 74 69 6e 75 65 20 74 ile. Continue t
21980 6f 20 73 6b 69 70 20 6f 75 74 2d 6f 66 2d 72 61 o skip out-of-ra
21990 6e 67 65 20 70 61 67 65 73 20 61 6e 64 0a 20 20 nge pages and.
219a0 2a 2a 20 63 6f 6e 74 69 6e 75 65 20 61 64 64 69 ** continue addi
219b0 6e 67 20 70 61 67 65 73 20 72 6f 6c 6c 65 64 20 ng pages rolled
219c0 62 61 63 6b 20 74 6f 20 70 44 6f 6e 65 2e 0a 20 back to pDone..
219d0 20 2a 2f 0a 20 20 77 68 69 6c 65 28 20 72 63 3d */. while( rc=
219e0 3d 53 51 4c 49 54 45 5f 4f 4b 20 26 26 20 70 50 =SQLITE_OK && pP
219f0 61 67 65 72 2d 3e 6a 6f 75 72 6e 61 6c 4f 66 66 ager->journalOff
21a00 3c 73 7a 4a 20 29 7b 0a 20 20 20 20 75 33 32 20 <szJ ){. u32
21a10 69 69 3b 20 20 20 20 20 20 20 20 20 20 20 20 2f ii; /
21a20 2a 20 4c 6f 6f 70 20 63 6f 75 6e 74 65 72 20 2a * Loop counter *
21a30 2f 0a 20 20 20 20 75 33 32 20 6e 4a 52 65 63 20 /. u32 nJRec
21a40 3d 20 30 3b 20 20 20 20 20 2f 2a 20 4e 75 6d 62 = 0; /* Numb
21a50 65 72 20 6f 66 20 4a 6f 75 72 6e 61 6c 20 52 65 er of Journal Re
21a60 63 6f 72 64 73 20 2a 2f 0a 20 20 20 20 75 33 32 cords */. u32
21a70 20 64 75 6d 6d 79 3b 0a 20 20 20 20 72 63 20 3d dummy;. rc =
21a80 20 72 65 61 64 4a 6f 75 72 6e 61 6c 48 64 72 28 readJournalHdr(
21a90 70 50 61 67 65 72 2c 20 30 2c 20 73 7a 4a 2c 20 pPager, 0, szJ,
21aa0 26 6e 4a 52 65 63 2c 20 26 64 75 6d 6d 79 29 3b &nJRec, &dummy);
21ab0 0a 20 20 20 20 61 73 73 65 72 74 28 20 72 63 21 . assert( rc!
21ac0 3d 53 51 4c 49 54 45 5f 44 4f 4e 45 20 29 3b 0a =SQLITE_DONE );.
21ad0 0a 20 20 20 20 2f 2a 0a 20 20 20 20 2a 2a 20 54 . /*. ** T
21ae0 68 65 20 22 70 50 61 67 65 72 2d 3e 6a 6f 75 72 he "pPager->jour
21af0 6e 61 6c 48 64 72 2b 4a 4f 55 52 4e 41 4c 5f 48 nalHdr+JOURNAL_H
21b00 44 52 5f 53 5a 28 70 50 61 67 65 72 29 3d 3d 70 DR_SZ(pPager)==p
21b10 50 61 67 65 72 2d 3e 6a 6f 75 72 6e 61 6c 4f 66 Pager->journalOf
21b20 66 22 0a 20 20 20 20 2a 2a 20 74 65 73 74 20 69 f". ** test i
21b30 73 20 72 65 6c 61 74 65 64 20 74 6f 20 74 69 63 s related to tic
21b40 6b 65 74 20 23 32 35 36 35 2e 20 20 53 65 65 20 ket #2565. See
21b50 74 68 65 20 64 69 73 63 75 73 73 69 6f 6e 20 69 the discussion i
21b60 6e 20 74 68 65 0a 20 20 20 20 2a 2a 20 70 61 67 n the. ** pag
21b70 65 72 5f 70 6c 61 79 62 61 63 6b 28 29 20 66 75 er_playback() fu
21b80 6e 63 74 69 6f 6e 20 66 6f 72 20 61 64 64 69 74 nction for addit
21b90 69 6f 6e 61 6c 20 69 6e 66 6f 72 6d 61 74 69 6f ional informatio
21ba0 6e 2e 0a 20 20 20 20 2a 2f 0a 20 20 20 20 69 66 n.. */. if
21bb0 28 20 6e 4a 52 65 63 3d 3d 30 20 0a 20 20 20 20 ( nJRec==0 .
21bc0 20 26 26 20 70 50 61 67 65 72 2d 3e 6a 6f 75 72 && pPager->jour
21bd0 6e 61 6c 48 64 72 2b 4a 4f 55 52 4e 41 4c 5f 48 nalHdr+JOURNAL_H
21be0 44 52 5f 53 5a 28 70 50 61 67 65 72 29 3d 3d 70 DR_SZ(pPager)==p
21bf0 50 61 67 65 72 2d 3e 6a 6f 75 72 6e 61 6c 4f 66 Pager->journalOf
21c00 66 0a 20 20 20 20 29 7b 0a 20 20 20 20 20 20 6e f. ){. n
21c10 4a 52 65 63 20 3d 20 28 75 33 32 29 28 28 73 7a JRec = (u32)((sz
21c20 4a 20 2d 20 70 50 61 67 65 72 2d 3e 6a 6f 75 72 J - pPager->jour
21c30 6e 61 6c 4f 66 66 29 2f 4a 4f 55 52 4e 41 4c 5f nalOff)/JOURNAL_
21c40 50 47 5f 53 5a 28 70 50 61 67 65 72 29 29 3b 0a PG_SZ(pPager));.
21c50 20 20 20 20 7d 0a 20 20 20 20 66 6f 72 28 69 69 }. for(ii
21c60 3d 30 3b 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4f =0; rc==SQLITE_O
21c70 4b 20 26 26 20 69 69 3c 6e 4a 52 65 63 20 26 26 K && ii<nJRec &&
21c80 20 70 50 61 67 65 72 2d 3e 6a 6f 75 72 6e 61 6c pPager->journal
21c90 4f 66 66 3c 73 7a 4a 3b 20 69 69 2b 2b 29 7b 0a Off<szJ; ii++){.
21ca0 20 20 20 20 20 20 72 63 20 3d 20 70 61 67 65 72 rc = pager
21cb0 5f 70 6c 61 79 62 61 63 6b 5f 6f 6e 65 5f 70 61 _playback_one_pa
21cc0 67 65 28 70 50 61 67 65 72 2c 20 26 70 50 61 67 ge(pPager, &pPag
21cd0 65 72 2d 3e 6a 6f 75 72 6e 61 6c 4f 66 66 2c 20 er->journalOff,
21ce0 70 44 6f 6e 65 2c 20 31 2c 20 31 29 3b 0a 20 20 pDone, 1, 1);.
21cf0 20 20 7d 0a 20 20 20 20 61 73 73 65 72 74 28 20 }. assert(
21d00 72 63 21 3d 53 51 4c 49 54 45 5f 44 4f 4e 45 20 rc!=SQLITE_DONE
21d10 29 3b 0a 20 20 7d 0a 20 20 61 73 73 65 72 74 28 );. }. assert(
21d20 20 72 63 21 3d 53 51 4c 49 54 45 5f 4f 4b 20 7c rc!=SQLITE_OK |
21d30 7c 20 70 50 61 67 65 72 2d 3e 6a 6f 75 72 6e 61 | pPager->journa
21d40 6c 4f 66 66 3e 3d 73 7a 4a 20 29 3b 0a 0a 20 20 lOff>=szJ );..
21d50 2f 2a 20 46 69 6e 61 6c 6c 79 2c 20 20 72 6f 6c /* Finally, rol
21d60 6c 62 61 63 6b 20 70 61 67 65 73 20 66 72 6f 6d lback pages from
21d70 20 74 68 65 20 73 75 62 2d 6a 6f 75 72 6e 61 6c the sub-journal
21d80 2e 20 20 50 61 67 65 20 74 68 61 74 20 77 65 72 . Page that wer
21d90 65 0a 20 20 2a 2a 20 70 72 65 76 69 6f 75 73 6c e. ** previousl
21da0 79 20 72 6f 6c 6c 65 64 20 62 61 63 6b 20 6f 75 y rolled back ou
21db0 74 20 6f 66 20 74 68 65 20 6d 61 69 6e 20 6a 6f t of the main jo
21dc0 75 72 6e 61 6c 20 28 61 6e 64 20 61 72 65 20 68 urnal (and are h
21dd0 65 6e 63 65 20 69 6e 20 70 44 6f 6e 65 29 0a 20 ence in pDone).
21de0 20 2a 2a 20 77 69 6c 6c 20 62 65 20 73 6b 69 70 ** will be skip
21df0 70 65 64 2e 20 20 4f 75 74 2d 6f 66 2d 72 61 6e ped. Out-of-ran
21e00 67 65 20 70 61 67 65 73 20 61 72 65 20 61 6c 73 ge pages are als
21e10 6f 20 73 6b 69 70 70 65 64 2e 0a 20 20 2a 2f 0a o skipped.. */.
21e20 20 20 69 66 28 20 70 53 61 76 65 70 6f 69 6e 74 if( pSavepoint
21e30 20 29 7b 0a 20 20 20 20 75 33 32 20 69 69 3b 20 ){. u32 ii;
21e40 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4c 6f /* Lo
21e50 6f 70 20 63 6f 75 6e 74 65 72 20 2a 2f 0a 20 20 op counter */.
21e60 20 20 69 36 34 20 6f 66 66 73 65 74 20 3d 20 28 i64 offset = (
21e70 69 36 34 29 70 53 61 76 65 70 6f 69 6e 74 2d 3e i64)pSavepoint->
21e80 69 53 75 62 52 65 63 2a 28 34 2b 70 50 61 67 65 iSubRec*(4+pPage
21e90 72 2d 3e 70 61 67 65 53 69 7a 65 29 3b 0a 0a 20 r->pageSize);..
21ea0 20 20 20 69 66 28 20 70 61 67 65 72 55 73 65 57 if( pagerUseW
21eb0 61 6c 28 70 50 61 67 65 72 29 20 29 7b 0a 20 20 al(pPager) ){.
21ec0 20 20 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33 rc = sqlite3
21ed0 57 61 6c 53 61 76 65 70 6f 69 6e 74 55 6e 64 6f WalSavepointUndo
21ee0 28 70 50 61 67 65 72 2d 3e 70 57 61 6c 2c 20 70 (pPager->pWal, p
21ef0 53 61 76 65 70 6f 69 6e 74 2d 3e 61 57 61 6c 44 Savepoint->aWalD
21f00 61 74 61 29 3b 0a 20 20 20 20 7d 0a 20 20 20 20 ata);. }.
21f10 66 6f 72 28 69 69 3d 70 53 61 76 65 70 6f 69 6e for(ii=pSavepoin
21f20 74 2d 3e 69 53 75 62 52 65 63 3b 20 72 63 3d 3d t->iSubRec; rc==
21f30 53 51 4c 49 54 45 5f 4f 4b 20 26 26 20 69 69 3c SQLITE_OK && ii<
21f40 70 50 61 67 65 72 2d 3e 6e 53 75 62 52 65 63 3b pPager->nSubRec;
21f50 20 69 69 2b 2b 29 7b 0a 20 20 20 20 20 20 61 73 ii++){. as
21f60 73 65 72 74 28 20 6f 66 66 73 65 74 3d 3d 28 69 sert( offset==(i
21f70 36 34 29 69 69 2a 28 34 2b 70 50 61 67 65 72 2d 64)ii*(4+pPager-
21f80 3e 70 61 67 65 53 69 7a 65 29 20 29 3b 0a 20 20 >pageSize) );.
21f90 20 20 20 20 72 63 20 3d 20 70 61 67 65 72 5f 70 rc = pager_p
21fa0 6c 61 79 62 61 63 6b 5f 6f 6e 65 5f 70 61 67 65 layback_one_page
21fb0 28 70 50 61 67 65 72 2c 20 26 6f 66 66 73 65 74 (pPager, &offset
21fc0 2c 20 70 44 6f 6e 65 2c 20 30 2c 20 31 29 3b 0a , pDone, 0, 1);.
21fd0 20 20 20 20 7d 0a 20 20 20 20 61 73 73 65 72 74 }. assert
21fe0 28 20 72 63 21 3d 53 51 4c 49 54 45 5f 44 4f 4e ( rc!=SQLITE_DON
21ff0 45 20 29 3b 0a 20 20 7d 0a 0a 20 20 73 71 6c 69 E );. }.. sqli
22000 74 65 33 42 69 74 76 65 63 44 65 73 74 72 6f 79 te3BitvecDestroy
22010 28 70 44 6f 6e 65 29 3b 0a 20 20 69 66 28 20 72 (pDone);. if( r
22020 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a c==SQLITE_OK ){.
22030 20 20 20 20 70 50 61 67 65 72 2d 3e 6a 6f 75 72 pPager->jour
22040 6e 61 6c 4f 66 66 20 3d 20 73 7a 4a 3b 0a 20 20 nalOff = szJ;.
22050 7d 0a 0a 20 20 72 65 74 75 72 6e 20 72 63 3b 0a }.. return rc;.
22060 7d 0a 0a 2f 2a 0a 2a 2a 20 43 68 61 6e 67 65 20 }../*.** Change
22070 74 68 65 20 6d 61 78 69 6d 75 6d 20 6e 75 6d 62 the maximum numb
22080 65 72 20 6f 66 20 69 6e 2d 6d 65 6d 6f 72 79 20 er of in-memory
22090 70 61 67 65 73 20 74 68 61 74 20 61 72 65 20 61 pages that are a
220a0 6c 6c 6f 77 65 64 0a 2a 2a 20 62 65 66 6f 72 65 llowed.** before
220b0 20 61 74 74 65 6d 70 74 69 6e 67 20 74 6f 20 72 attempting to r
220c0 65 63 79 63 6c 65 20 63 6c 65 61 6e 20 61 6e 64 ecycle clean and
220d0 20 75 6e 75 73 65 64 20 70 61 67 65 73 2e 0a 2a unused pages..*
220e0 2f 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 50 61 /.void sqlite3Pa
220f0 67 65 72 53 65 74 43 61 63 68 65 73 69 7a 65 28 gerSetCachesize(
22100 50 61 67 65 72 20 2a 70 50 61 67 65 72 2c 20 69 Pager *pPager, i
22110 6e 74 20 6d 78 50 61 67 65 29 7b 0a 20 20 73 71 nt mxPage){. sq
22120 6c 69 74 65 33 50 63 61 63 68 65 53 65 74 43 61 lite3PcacheSetCa
22130 63 68 65 73 69 7a 65 28 70 50 61 67 65 72 2d 3e chesize(pPager->
22140 70 50 43 61 63 68 65 2c 20 6d 78 50 61 67 65 29 pPCache, mxPage)
22150 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 43 68 61 6e 67 ;.}../*.** Chang
22160 65 20 74 68 65 20 6d 61 78 69 6d 75 6d 20 6e 75 e the maximum nu
22170 6d 62 65 72 20 6f 66 20 69 6e 2d 6d 65 6d 6f 72 mber of in-memor
22180 79 20 70 61 67 65 73 20 74 68 61 74 20 61 72 65 y pages that are
22190 20 61 6c 6c 6f 77 65 64 0a 2a 2a 20 62 65 66 6f allowed.** befo
221a0 72 65 20 61 74 74 65 6d 70 74 69 6e 67 20 74 6f re attempting to
221b0 20 73 70 69 6c 6c 20 70 61 67 65 73 20 74 6f 20 spill pages to
221c0 6a 6f 75 72 6e 61 6c 2e 0a 2a 2f 0a 69 6e 74 20 journal..*/.int
221d0 73 71 6c 69 74 65 33 50 61 67 65 72 53 65 74 53 sqlite3PagerSetS
221e0 70 69 6c 6c 73 69 7a 65 28 50 61 67 65 72 20 2a pillsize(Pager *
221f0 70 50 61 67 65 72 2c 20 69 6e 74 20 6d 78 50 61 pPager, int mxPa
22200 67 65 29 7b 0a 20 20 72 65 74 75 72 6e 20 73 71 ge){. return sq
22210 6c 69 74 65 33 50 63 61 63 68 65 53 65 74 53 70 lite3PcacheSetSp
22220 69 6c 6c 73 69 7a 65 28 70 50 61 67 65 72 2d 3e illsize(pPager->
22230 70 50 43 61 63 68 65 2c 20 6d 78 50 61 67 65 29 pPCache, mxPage)
22240 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 49 6e 76 6f 6b ;.}../*.** Invok
22250 65 20 53 51 4c 49 54 45 5f 46 43 4e 54 4c 5f 4d e SQLITE_FCNTL_M
22260 4d 41 50 5f 53 49 5a 45 20 62 61 73 65 64 20 6f MAP_SIZE based o
22270 6e 20 74 68 65 20 63 75 72 72 65 6e 74 20 76 61 n the current va
22280 6c 75 65 20 6f 66 20 73 7a 4d 6d 61 70 2e 0a 2a lue of szMmap..*
22290 2f 0a 73 74 61 74 69 63 20 76 6f 69 64 20 70 61 /.static void pa
222a0 67 65 72 46 69 78 4d 61 70 6c 69 6d 69 74 28 50 gerFixMaplimit(P
222b0 61 67 65 72 20 2a 70 50 61 67 65 72 29 7b 0a 23 ager *pPager){.#
222c0 69 66 20 53 51 4c 49 54 45 5f 4d 41 58 5f 4d 4d if SQLITE_MAX_MM
222d0 41 50 5f 53 49 5a 45 3e 30 0a 20 20 73 71 6c 69 AP_SIZE>0. sqli
222e0 74 65 33 5f 66 69 6c 65 20 2a 66 64 20 3d 20 70 te3_file *fd = p
222f0 50 61 67 65 72 2d 3e 66 64 3b 0a 20 20 69 66 28 Pager->fd;. if(
22300 20 69 73 4f 70 65 6e 28 66 64 29 20 26 26 20 66 isOpen(fd) && f
22310 64 2d 3e 70 4d 65 74 68 6f 64 73 2d 3e 69 56 65 d->pMethods->iVe
22320 72 73 69 6f 6e 3e 3d 33 20 29 7b 0a 20 20 20 20 rsion>=3 ){.
22330 73 71 6c 69 74 65 33 5f 69 6e 74 36 34 20 73 7a sqlite3_int64 sz
22340 3b 0a 20 20 20 20 73 7a 20 3d 20 70 50 61 67 65 ;. sz = pPage
22350 72 2d 3e 73 7a 4d 6d 61 70 3b 0a 20 20 20 20 70 r->szMmap;. p
22360 50 61 67 65 72 2d 3e 62 55 73 65 46 65 74 63 68 Pager->bUseFetch
22370 20 3d 20 28 73 7a 3e 30 29 3b 0a 20 20 20 20 73 = (sz>0);. s
22380 71 6c 69 74 65 33 4f 73 46 69 6c 65 43 6f 6e 74 qlite3OsFileCont
22390 72 6f 6c 48 69 6e 74 28 70 50 61 67 65 72 2d 3e rolHint(pPager->
223a0 66 64 2c 20 53 51 4c 49 54 45 5f 46 43 4e 54 4c fd, SQLITE_FCNTL
223b0 5f 4d 4d 41 50 5f 53 49 5a 45 2c 20 26 73 7a 29 _MMAP_SIZE, &sz)
223c0 3b 0a 20 20 7d 0a 23 65 6e 64 69 66 0a 7d 0a 0a ;. }.#endif.}..
223d0 2f 2a 0a 2a 2a 20 43 68 61 6e 67 65 20 74 68 65 /*.** Change the
223e0 20 6d 61 78 69 6d 75 6d 20 73 69 7a 65 20 6f 66 maximum size of
223f0 20 61 6e 79 20 6d 65 6d 6f 72 79 20 6d 61 70 70 any memory mapp
22400 69 6e 67 20 6d 61 64 65 20 6f 66 20 74 68 65 20 ing made of the
22410 64 61 74 61 62 61 73 65 20 66 69 6c 65 2e 0a 2a database file..*
22420 2f 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 50 61 /.void sqlite3Pa
22430 67 65 72 53 65 74 4d 6d 61 70 4c 69 6d 69 74 28 gerSetMmapLimit(
22440 50 61 67 65 72 20 2a 70 50 61 67 65 72 2c 20 73 Pager *pPager, s
22450 71 6c 69 74 65 33 5f 69 6e 74 36 34 20 73 7a 4d qlite3_int64 szM
22460 6d 61 70 29 7b 0a 20 20 70 50 61 67 65 72 2d 3e map){. pPager->
22470 73 7a 4d 6d 61 70 20 3d 20 73 7a 4d 6d 61 70 3b szMmap = szMmap;
22480 0a 20 20 70 61 67 65 72 46 69 78 4d 61 70 6c 69 . pagerFixMapli
22490 6d 69 74 28 70 50 61 67 65 72 29 3b 0a 7d 0a 0a mit(pPager);.}..
224a0 2f 2a 0a 2a 2a 20 46 72 65 65 20 61 73 20 6d 75 /*.** Free as mu
224b0 63 68 20 6d 65 6d 6f 72 79 20 61 73 20 70 6f 73 ch memory as pos
224c0 73 69 62 6c 65 20 66 72 6f 6d 20 74 68 65 20 70 sible from the p
224d0 61 67 65 72 2e 0a 2a 2f 0a 76 6f 69 64 20 73 71 ager..*/.void sq
224e0 6c 69 74 65 33 50 61 67 65 72 53 68 72 69 6e 6b lite3PagerShrink
224f0 28 50 61 67 65 72 20 2a 70 50 61 67 65 72 29 7b (Pager *pPager){
22500 0a 20 20 73 71 6c 69 74 65 33 50 63 61 63 68 65 . sqlite3Pcache
22510 53 68 72 69 6e 6b 28 70 50 61 67 65 72 2d 3e 70 Shrink(pPager->p
22520 50 43 61 63 68 65 29 3b 0a 7d 0a 0a 2f 2a 0a 2a PCache);.}../*.*
22530 2a 20 41 64 6a 75 73 74 20 73 65 74 74 69 6e 67 * Adjust setting
22540 73 20 6f 66 20 74 68 65 20 70 61 67 65 72 20 74 s of the pager t
22550 6f 20 74 68 6f 73 65 20 73 70 65 63 69 66 69 65 o those specifie
22560 64 20 69 6e 20 74 68 65 20 70 67 46 6c 61 67 73 d in the pgFlags
22570 20 70 61 72 61 6d 65 74 65 72 2e 0a 2a 2a 0a 2a parameter..**.*
22580 2a 20 54 68 65 20 22 6c 65 76 65 6c 22 20 69 6e * The "level" in
22590 20 70 67 46 6c 61 67 73 20 26 20 50 41 47 45 52 pgFlags & PAGER
225a0 5f 53 59 4e 43 48 52 4f 4e 4f 55 53 5f 4d 41 53 _SYNCHRONOUS_MAS
225b0 4b 20 73 65 74 73 20 74 68 65 20 72 6f 62 75 73 K sets the robus
225c0 74 6e 65 73 73 0a 2a 2a 20 6f 66 20 74 68 65 20 tness.** of the
225d0 64 61 74 61 62 61 73 65 20 74 6f 20 64 61 6d 61 database to dama
225e0 67 65 20 64 75 65 20 74 6f 20 4f 53 20 63 72 61 ge due to OS cra
225f0 73 68 65 73 20 6f 72 20 70 6f 77 65 72 20 66 61 shes or power fa
22600 69 6c 75 72 65 73 20 62 79 0a 2a 2a 20 63 68 61 ilures by.** cha
22610 6e 67 69 6e 67 20 74 68 65 20 6e 75 6d 62 65 72 nging the number
22620 20 6f 66 20 73 79 6e 63 73 28 29 73 20 77 68 65 of syncs()s whe
22630 6e 20 77 72 69 74 69 6e 67 20 74 68 65 20 6a 6f n writing the jo
22640 75 72 6e 61 6c 73 2e 0a 2a 2a 20 54 68 65 72 65 urnals..** There
22650 20 61 72 65 20 66 6f 75 72 20 6c 65 76 65 6c 73 are four levels
22660 3a 0a 2a 2a 0a 2a 2a 20 20 20 20 4f 46 46 20 20 :.**.** OFF
22670 20 20 20 20 20 73 71 6c 69 74 65 33 4f 73 53 79 sqlite3OsSy
22680 6e 63 28 29 20 69 73 20 6e 65 76 65 72 20 63 61 nc() is never ca
22690 6c 6c 65 64 2e 20 20 54 68 69 73 20 69 73 20 74 lled. This is t
226a0 68 65 20 64 65 66 61 75 6c 74 0a 2a 2a 20 20 20 he default.**
226b0 20 20 20 20 20 20 20 20 20 20 20 66 6f 72 20 74 for t
226c0 65 6d 70 6f 72 61 72 79 20 61 6e 64 20 74 72 61 emporary and tra
226d0 6e 73 69 65 6e 74 20 66 69 6c 65 73 2e 0a 2a 2a nsient files..**
226e0 0a 2a 2a 20 20 20 20 4e 4f 52 4d 41 4c 20 20 20 .** NORMAL
226f0 20 54 68 65 20 6a 6f 75 72 6e 61 6c 20 69 73 20 The journal is
22700 73 79 6e 63 65 64 20 6f 6e 63 65 20 62 65 66 6f synced once befo
22710 72 65 20 77 72 69 74 65 73 20 62 65 67 69 6e 20 re writes begin
22720 6f 6e 20 74 68 65 0a 2a 2a 20 20 20 20 20 20 20 on the.**
22730 20 20 20 20 20 20 20 64 61 74 61 62 61 73 65 2e database.
22740 20 20 54 68 69 73 20 69 73 20 6e 6f 72 6d 61 6c This is normal
22750 6c 79 20 61 64 65 71 75 61 74 65 20 70 72 6f 74 ly adequate prot
22760 65 63 74 69 6f 6e 2c 20 62 75 74 0a 2a 2a 20 20 ection, but.**
22770 20 20 20 20 20 20 20 20 20 20 20 20 69 74 20 69 it i
22780 73 20 74 68 65 6f 72 65 74 69 63 61 6c 6c 79 20 s theoretically
22790 70 6f 73 73 69 62 6c 65 2c 20 74 68 6f 75 67 68 possible, though
227a0 20 76 65 72 79 20 75 6e 6c 69 6b 65 6c 79 2c 0a very unlikely,.
227b0 2a 2a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 **
227c0 74 68 61 74 20 61 6e 20 69 6e 6f 70 65 72 74 75 that an inopertu
227d0 6e 65 20 70 6f 77 65 72 20 66 61 69 6c 75 72 65 ne power failure
227e0 20 63 6f 75 6c 64 20 6c 65 61 76 65 20 74 68 65 could leave the
227f0 20 6a 6f 75 72 6e 61 6c 0a 2a 2a 20 20 20 20 20 journal.**
22800 20 20 20 20 20 20 20 20 20 69 6e 20 61 20 73 74 in a st
22810 61 74 65 20 77 68 69 63 68 20 77 6f 75 6c 64 20 ate which would
22820 63 61 75 73 65 20 64 61 6d 61 67 65 20 74 6f 20 cause damage to
22830 74 68 65 20 64 61 74 61 62 61 73 65 0a 2a 2a 20 the database.**
22840 20 20 20 20 20 20 20 20 20 20 20 20 20 77 68 65 whe
22850 6e 20 69 74 20 69 73 20 72 6f 6c 6c 65 64 20 62 n it is rolled b
22860 61 63 6b 2e 0a 2a 2a 0a 2a 2a 20 20 20 20 46 55 ack..**.** FU
22870 4c 4c 20 20 20 20 20 20 54 68 65 20 6a 6f 75 72 LL The jour
22880 6e 61 6c 20 69 73 20 73 79 6e 63 65 64 20 74 77 nal is synced tw
22890 69 63 65 20 62 65 66 6f 72 65 20 77 72 69 74 65 ice before write
228a0 73 20 62 65 67 69 6e 20 6f 6e 20 74 68 65 0a 2a s begin on the.*
228b0 2a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 64 * d
228c0 61 74 61 62 61 73 65 20 28 77 69 74 68 20 73 6f atabase (with so
228d0 6d 65 20 61 64 64 69 74 69 6f 6e 61 6c 20 69 6e me additional in
228e0 66 6f 72 6d 61 74 69 6f 6e 20 2d 20 74 68 65 20 formation - the
228f0 6e 52 65 63 20 66 69 65 6c 64 0a 2a 2a 20 20 20 nRec field.**
22900 20 20 20 20 20 20 20 20 20 20 20 6f 66 20 74 68 of th
22910 65 20 6a 6f 75 72 6e 61 6c 20 68 65 61 64 65 72 e journal header
22920 20 2d 20 62 65 69 6e 67 20 77 72 69 74 74 65 6e - being written
22930 20 69 6e 20 62 65 74 77 65 65 6e 20 74 68 65 20 in between the
22940 74 77 6f 0a 2a 2a 20 20 20 20 20 20 20 20 20 20 two.**
22950 20 20 20 20 73 79 6e 63 73 29 2e 20 20 49 66 20 syncs). If
22960 77 65 20 61 73 73 75 6d 65 20 74 68 61 74 20 77 we assume that w
22970 72 69 74 69 6e 67 20 61 0a 2a 2a 20 20 20 20 20 riting a.**
22980 20 20 20 20 20 20 20 20 20 73 69 6e 67 6c 65 20 single
22990 64 69 73 6b 20 73 65 63 74 6f 72 20 69 73 20 61 disk sector is a
229a0 74 6f 6d 69 63 2c 20 74 68 65 6e 20 74 68 69 73 tomic, then this
229b0 20 6d 6f 64 65 20 70 72 6f 76 69 64 65 73 0a 2a mode provides.*
229c0 2a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 61 * a
229d0 73 73 75 72 61 6e 63 65 20 74 68 61 74 20 74 68 ssurance that th
229e0 65 20 6a 6f 75 72 6e 61 6c 20 77 69 6c 6c 20 6e e journal will n
229f0 6f 74 20 62 65 20 63 6f 72 72 75 70 74 65 64 20 ot be corrupted
22a00 74 6f 20 74 68 65 0a 2a 2a 20 20 20 20 20 20 20 to the.**
22a10 20 20 20 20 20 20 20 70 6f 69 6e 74 20 6f 66 20 point of
22a20 63 61 75 73 69 6e 67 20 64 61 6d 61 67 65 20 74 causing damage t
22a30 6f 20 74 68 65 20 64 61 74 61 62 61 73 65 20 64 o the database d
22a40 75 72 69 6e 67 20 72 6f 6c 6c 62 61 63 6b 2e 0a uring rollback..
22a50 2a 2a 0a 2a 2a 20 20 20 20 45 58 54 52 41 20 20 **.** EXTRA
22a60 20 20 20 54 68 69 73 20 69 73 20 6c 69 6b 65 20 This is like
22a70 46 55 4c 4c 20 65 78 63 65 70 74 20 74 68 61 74 FULL except that
22a80 20 69 73 20 61 6c 73 6f 20 73 79 6e 63 73 20 74 is also syncs t
22a90 68 65 20 64 69 72 65 63 74 6f 72 79 0a 2a 2a 20 he directory.**
22aa0 20 20 20 20 20 20 20 20 20 20 20 20 20 74 68 61 tha
22ab0 74 20 63 6f 6e 74 61 69 6e 73 20 74 68 65 20 72 t contains the r
22ac0 6f 6c 6c 62 61 63 6b 20 6a 6f 75 72 6e 61 6c 20 ollback journal
22ad0 61 66 74 65 72 20 74 68 65 20 72 6f 6c 6c 62 61 after the rollba
22ae0 63 6b 0a 2a 2a 20 20 20 20 20 20 20 20 20 20 20 ck.**
22af0 20 20 20 6a 6f 75 72 6e 61 6c 20 69 73 20 75 6e journal is un
22b00 6c 69 6e 6b 65 64 2e 0a 2a 2a 0a 2a 2a 20 54 68 linked..**.** Th
22b10 65 20 61 62 6f 76 65 20 69 73 20 66 6f 72 20 61 e above is for a
22b20 20 72 6f 6c 6c 62 61 63 6b 2d 6a 6f 75 72 6e 61 rollback-journa
22b30 6c 20 6d 6f 64 65 2e 20 20 46 6f 72 20 57 41 4c l mode. For WAL
22b40 20 6d 6f 64 65 2c 20 4f 46 46 20 63 6f 6e 74 69 mode, OFF conti
22b50 6e 75 65 73 0a 2a 2a 20 74 6f 20 6d 65 61 6e 20 nues.** to mean
22b60 74 68 61 74 20 6e 6f 20 73 79 6e 63 73 20 65 76 that no syncs ev
22b70 65 72 20 6f 63 63 75 72 2e 20 20 4e 4f 52 4d 41 er occur. NORMA
22b80 4c 20 6d 65 61 6e 73 20 74 68 61 74 20 74 68 65 L means that the
22b90 20 57 41 4c 20 69 73 20 73 79 6e 63 65 64 0a 2a WAL is synced.*
22ba0 2a 20 70 72 69 6f 72 20 74 6f 20 74 68 65 20 73 * prior to the s
22bb0 74 61 72 74 20 6f 66 20 63 68 65 63 6b 70 6f 69 tart of checkpoi
22bc0 6e 74 20 61 6e 64 20 74 68 61 74 20 74 68 65 20 nt and that the
22bd0 64 61 74 61 62 61 73 65 20 66 69 6c 65 20 69 73 database file is
22be0 20 73 79 6e 63 65 64 0a 2a 2a 20 61 74 20 74 68 synced.** at th
22bf0 65 20 63 6f 6e 63 6c 75 73 69 6f 6e 20 6f 66 20 e conclusion of
22c00 74 68 65 20 63 68 65 63 6b 70 6f 69 6e 74 20 69 the checkpoint i
22c10 66 20 74 68 65 20 65 6e 74 69 72 65 20 63 6f 6e f the entire con
22c20 74 65 6e 74 20 6f 66 20 74 68 65 20 57 41 4c 0a tent of the WAL.
22c30 2a 2a 20 77 61 73 20 77 72 69 74 74 65 6e 20 62 ** was written b
22c40 61 63 6b 20 69 6e 74 6f 20 74 68 65 20 64 61 74 ack into the dat
22c50 61 62 61 73 65 2e 20 20 42 75 74 20 6e 6f 20 73 abase. But no s
22c60 79 6e 63 20 6f 70 65 72 61 74 69 6f 6e 73 20 6f ync operations o
22c70 63 63 75 72 20 66 6f 72 0a 2a 2a 20 61 6e 20 6f ccur for.** an o
22c80 72 64 69 6e 61 72 79 20 63 6f 6d 6d 69 74 20 69 rdinary commit i
22c90 6e 20 4e 4f 52 4d 41 4c 20 6d 6f 64 65 20 77 69 n NORMAL mode wi
22ca0 74 68 20 57 41 4c 2e 20 20 46 55 4c 4c 20 6d 65 th WAL. FULL me
22cb0 61 6e 73 20 74 68 61 74 20 74 68 65 20 57 41 4c ans that the WAL
22cc0 0a 2a 2a 20 66 69 6c 65 20 69 73 20 73 79 6e 63 .** file is sync
22cd0 65 64 20 66 6f 6c 6c 6f 77 69 6e 67 20 65 61 63 ed following eac
22ce0 68 20 63 6f 6d 6d 69 74 20 6f 70 65 72 61 74 69 h commit operati
22cf0 6f 6e 2c 20 69 6e 20 61 64 64 69 74 69 6f 6e 20 on, in addition
22d00 74 6f 20 74 68 65 0a 2a 2a 20 73 79 6e 63 73 20 to the.** syncs
22d10 61 73 73 6f 63 69 61 74 65 64 20 77 69 74 68 20 associated with
22d20 4e 4f 52 4d 41 4c 2e 20 20 54 68 65 72 65 20 69 NORMAL. There i
22d30 73 20 6e 6f 20 64 69 66 66 65 72 65 6e 63 65 20 s no difference
22d40 62 65 74 77 65 65 6e 20 46 55 4c 4c 0a 2a 2a 20 between FULL.**
22d50 61 6e 64 20 45 58 54 52 41 20 66 6f 72 20 57 41 and EXTRA for WA
22d60 4c 20 6d 6f 64 65 2e 0a 2a 2a 0a 2a 2a 20 44 6f L mode..**.** Do
22d70 20 6e 6f 74 20 63 6f 6e 66 75 73 65 20 73 79 6e not confuse syn
22d80 63 68 72 6f 6e 6f 75 73 3d 46 55 4c 4c 20 77 69 chronous=FULL wi
22d90 74 68 20 53 51 4c 49 54 45 5f 53 59 4e 43 5f 46 th SQLITE_SYNC_F
22da0 55 4c 4c 2e 20 20 54 68 65 0a 2a 2a 20 53 51 4c ULL. The.** SQL
22db0 49 54 45 5f 53 59 4e 43 5f 46 55 4c 4c 20 6d 61 ITE_SYNC_FULL ma
22dc0 63 72 6f 20 6d 65 61 6e 73 20 74 6f 20 75 73 65 cro means to use
22dd0 20 74 68 65 20 4d 61 63 4f 53 58 2d 73 74 79 6c the MacOSX-styl
22de0 65 20 66 75 6c 6c 2d 66 73 79 6e 63 0a 2a 2a 20 e full-fsync.**
22df0 75 73 69 6e 67 20 66 63 6e 74 6c 28 46 5f 46 55 using fcntl(F_FU
22e00 4c 4c 46 53 59 4e 43 29 2e 20 20 53 51 4c 49 54 LLFSYNC). SQLIT
22e10 45 5f 53 59 4e 43 5f 4e 4f 52 4d 41 4c 20 6d 65 E_SYNC_NORMAL me
22e20 61 6e 73 20 74 6f 20 64 6f 20 61 6e 0a 2a 2a 20 ans to do an.**
22e30 6f 72 64 69 6e 61 72 79 20 66 73 79 6e 63 28 29 ordinary fsync()
22e40 20 63 61 6c 6c 2e 20 20 54 68 65 72 65 20 69 73 call. There is
22e50 20 6e 6f 20 64 69 66 66 65 72 65 6e 63 65 20 62 no difference b
22e60 65 74 77 65 65 6e 20 53 51 4c 49 54 45 5f 53 59 etween SQLITE_SY
22e70 4e 43 5f 46 55 4c 4c 0a 2a 2a 20 61 6e 64 20 53 NC_FULL.** and S
22e80 51 4c 49 54 45 5f 53 59 4e 43 5f 4e 4f 52 4d 41 QLITE_SYNC_NORMA
22e90 4c 20 6f 6e 20 70 6c 61 74 66 6f 72 6d 73 20 6f L on platforms o
22ea0 74 68 65 72 20 74 68 61 6e 20 4d 61 63 4f 53 58 ther than MacOSX
22eb0 2e 20 20 42 75 74 20 74 68 65 0a 2a 2a 20 73 79 . But the.** sy
22ec0 6e 63 68 72 6f 6e 6f 75 73 3d 46 55 4c 4c 20 76 nchronous=FULL v
22ed0 65 72 73 75 73 20 73 79 6e 63 68 72 6f 6e 6f 75 ersus synchronou
22ee0 73 3d 4e 4f 52 4d 41 4c 20 73 65 74 74 69 6e 67 s=NORMAL setting
22ef0 20 64 65 74 65 72 6d 69 6e 65 73 20 77 68 65 6e determines when
22f00 0a 2a 2a 20 74 68 65 20 78 53 79 6e 63 20 70 72 .** the xSync pr
22f10 69 6d 69 74 69 76 65 20 69 73 20 63 61 6c 6c 65 imitive is calle
22f20 64 20 61 6e 64 20 69 73 20 72 65 6c 65 76 61 6e d and is relevan
22f30 74 20 74 6f 20 61 6c 6c 20 70 6c 61 74 66 6f 72 t to all platfor
22f40 6d 73 2e 0a 2a 2a 0a 2a 2a 20 4e 75 6d 65 72 69 ms..**.** Numeri
22f50 63 20 76 61 6c 75 65 73 20 61 73 73 6f 63 69 61 c values associa
22f60 74 65 64 20 77 69 74 68 20 74 68 65 73 65 20 73 ted with these s
22f70 74 61 74 65 73 20 61 72 65 20 4f 46 46 3d 3d 31 tates are OFF==1
22f80 2c 20 4e 4f 52 4d 41 4c 3d 32 2c 0a 2a 2a 20 61 , NORMAL=2,.** a
22f90 6e 64 20 46 55 4c 4c 3d 33 2e 0a 2a 2f 0a 23 69 nd FULL=3..*/.#i
22fa0 66 6e 64 65 66 20 53 51 4c 49 54 45 5f 4f 4d 49 fndef SQLITE_OMI
22fb0 54 5f 50 41 47 45 52 5f 50 52 41 47 4d 41 53 0a T_PAGER_PRAGMAS.
22fc0 76 6f 69 64 20 73 71 6c 69 74 65 33 50 61 67 65 void sqlite3Page
22fd0 72 53 65 74 46 6c 61 67 73 28 0a 20 20 50 61 67 rSetFlags(. Pag
22fe0 65 72 20 2a 70 50 61 67 65 72 2c 20 20 20 20 20 er *pPager,
22ff0 20 20 20 2f 2a 20 54 68 65 20 70 61 67 65 72 20 /* The pager
23000 74 6f 20 73 65 74 20 73 61 66 65 74 79 20 6c 65 to set safety le
23010 76 65 6c 20 66 6f 72 20 2a 2f 0a 20 20 75 6e 73 vel for */. uns
23020 69 67 6e 65 64 20 70 67 46 6c 61 67 73 20 20 20 igned pgFlags
23030 20 20 20 2f 2a 20 56 61 72 69 6f 75 73 20 66 6c /* Various fl
23040 61 67 73 20 2a 2f 0a 29 7b 0a 20 20 75 6e 73 69 ags */.){. unsi
23050 67 6e 65 64 20 6c 65 76 65 6c 20 3d 20 70 67 46 gned level = pgF
23060 6c 61 67 73 20 26 20 50 41 47 45 52 5f 53 59 4e lags & PAGER_SYN
23070 43 48 52 4f 4e 4f 55 53 5f 4d 41 53 4b 3b 0a 20 CHRONOUS_MASK;.
23080 20 69 66 28 20 70 50 61 67 65 72 2d 3e 74 65 6d if( pPager->tem
23090 70 46 69 6c 65 20 29 7b 0a 20 20 20 20 70 50 61 pFile ){. pPa
230a0 67 65 72 2d 3e 6e 6f 53 79 6e 63 20 3d 20 31 3b ger->noSync = 1;
230b0 0a 20 20 20 20 70 50 61 67 65 72 2d 3e 66 75 6c . pPager->ful
230c0 6c 53 79 6e 63 20 3d 20 30 3b 0a 20 20 20 20 70 lSync = 0;. p
230d0 50 61 67 65 72 2d 3e 65 78 74 72 61 53 79 6e 63 Pager->extraSync
230e0 20 3d 20 30 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20 = 0;. }else{.
230f0 20 20 20 70 50 61 67 65 72 2d 3e 6e 6f 53 79 6e pPager->noSyn
23100 63 20 3d 20 20 6c 65 76 65 6c 3d 3d 50 41 47 45 c = level==PAGE
23110 52 5f 53 59 4e 43 48 52 4f 4e 4f 55 53 5f 4f 46 R_SYNCHRONOUS_OF
23120 46 20 3f 31 3a 30 3b 0a 20 20 20 20 70 50 61 67 F ?1:0;. pPag
23130 65 72 2d 3e 66 75 6c 6c 53 79 6e 63 20 3d 20 6c er->fullSync = l
23140 65 76 65 6c 3e 3d 50 41 47 45 52 5f 53 59 4e 43 evel>=PAGER_SYNC
23150 48 52 4f 4e 4f 55 53 5f 46 55 4c 4c 20 3f 31 3a HRONOUS_FULL ?1:
23160 30 3b 0a 20 20 20 20 70 50 61 67 65 72 2d 3e 65 0;. pPager->e
23170 78 74 72 61 53 79 6e 63 20 3d 20 6c 65 76 65 6c xtraSync = level
23180 3d 3d 50 41 47 45 52 5f 53 59 4e 43 48 52 4f 4e ==PAGER_SYNCHRON
23190 4f 55 53 5f 45 58 54 52 41 20 3f 31 3a 30 3b 0a OUS_EXTRA ?1:0;.
231a0 20 20 7d 0a 20 20 69 66 28 20 70 50 61 67 65 72 }. if( pPager
231b0 2d 3e 6e 6f 53 79 6e 63 20 29 7b 0a 20 20 20 20 ->noSync ){.
231c0 70 50 61 67 65 72 2d 3e 73 79 6e 63 46 6c 61 67 pPager->syncFlag
231d0 73 20 3d 20 30 3b 0a 20 20 20 20 70 50 61 67 65 s = 0;. pPage
231e0 72 2d 3e 63 6b 70 74 53 79 6e 63 46 6c 61 67 73 r->ckptSyncFlags
231f0 20 3d 20 30 3b 0a 20 20 7d 65 6c 73 65 20 69 66 = 0;. }else if
23200 28 20 70 67 46 6c 61 67 73 20 26 20 50 41 47 45 ( pgFlags & PAGE
23210 52 5f 46 55 4c 4c 46 53 59 4e 43 20 29 7b 0a 20 R_FULLFSYNC ){.
23220 20 20 20 70 50 61 67 65 72 2d 3e 73 79 6e 63 46 pPager->syncF
23230 6c 61 67 73 20 3d 20 53 51 4c 49 54 45 5f 53 59 lags = SQLITE_SY
23240 4e 43 5f 46 55 4c 4c 3b 0a 20 20 20 20 70 50 61 NC_FULL;. pPa
23250 67 65 72 2d 3e 63 6b 70 74 53 79 6e 63 46 6c 61 ger->ckptSyncFla
23260 67 73 20 3d 20 53 51 4c 49 54 45 5f 53 59 4e 43 gs = SQLITE_SYNC
23270 5f 46 55 4c 4c 3b 0a 20 20 7d 65 6c 73 65 20 69 _FULL;. }else i
23280 66 28 20 70 67 46 6c 61 67 73 20 26 20 50 41 47 f( pgFlags & PAG
23290 45 52 5f 43 4b 50 54 5f 46 55 4c 4c 46 53 59 4e ER_CKPT_FULLFSYN
232a0 43 20 29 7b 0a 20 20 20 20 70 50 61 67 65 72 2d C ){. pPager-
232b0 3e 73 79 6e 63 46 6c 61 67 73 20 3d 20 53 51 4c >syncFlags = SQL
232c0 49 54 45 5f 53 59 4e 43 5f 4e 4f 52 4d 41 4c 3b ITE_SYNC_NORMAL;
232d0 0a 20 20 20 20 70 50 61 67 65 72 2d 3e 63 6b 70 . pPager->ckp
232e0 74 53 79 6e 63 46 6c 61 67 73 20 3d 20 53 51 4c tSyncFlags = SQL
232f0 49 54 45 5f 53 59 4e 43 5f 46 55 4c 4c 3b 0a 20 ITE_SYNC_FULL;.
23300 20 7d 65 6c 73 65 7b 0a 20 20 20 20 70 50 61 67 }else{. pPag
23310 65 72 2d 3e 73 79 6e 63 46 6c 61 67 73 20 3d 20 er->syncFlags =
23320 53 51 4c 49 54 45 5f 53 59 4e 43 5f 4e 4f 52 4d SQLITE_SYNC_NORM
23330 41 4c 3b 0a 20 20 20 20 70 50 61 67 65 72 2d 3e AL;. pPager->
23340 63 6b 70 74 53 79 6e 63 46 6c 61 67 73 20 3d 20 ckptSyncFlags =
23350 53 51 4c 49 54 45 5f 53 59 4e 43 5f 4e 4f 52 4d SQLITE_SYNC_NORM
23360 41 4c 3b 0a 20 20 7d 0a 20 20 70 50 61 67 65 72 AL;. }. pPager
23370 2d 3e 77 61 6c 53 79 6e 63 46 6c 61 67 73 20 3d ->walSyncFlags =
23380 20 70 50 61 67 65 72 2d 3e 73 79 6e 63 46 6c 61 pPager->syncFla
23390 67 73 3b 0a 20 20 69 66 28 20 70 50 61 67 65 72 gs;. if( pPager
233a0 2d 3e 66 75 6c 6c 53 79 6e 63 20 29 7b 0a 20 20 ->fullSync ){.
233b0 20 20 70 50 61 67 65 72 2d 3e 77 61 6c 53 79 6e pPager->walSyn
233c0 63 46 6c 61 67 73 20 7c 3d 20 57 41 4c 5f 53 59 cFlags |= WAL_SY
233d0 4e 43 5f 54 52 41 4e 53 41 43 54 49 4f 4e 53 3b NC_TRANSACTIONS;
233e0 0a 20 20 7d 0a 20 20 69 66 28 20 70 67 46 6c 61 . }. if( pgFla
233f0 67 73 20 26 20 50 41 47 45 52 5f 43 41 43 48 45 gs & PAGER_CACHE
23400 53 50 49 4c 4c 20 29 7b 0a 20 20 20 20 70 50 61 SPILL ){. pPa
23410 67 65 72 2d 3e 64 6f 4e 6f 74 53 70 69 6c 6c 20 ger->doNotSpill
23420 26 3d 20 7e 53 50 49 4c 4c 46 4c 41 47 5f 4f 46 &= ~SPILLFLAG_OF
23430 46 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 F;. }else{.
23440 70 50 61 67 65 72 2d 3e 64 6f 4e 6f 74 53 70 69 pPager->doNotSpi
23450 6c 6c 20 7c 3d 20 53 50 49 4c 4c 46 4c 41 47 5f ll |= SPILLFLAG_
23460 4f 46 46 3b 0a 20 20 7d 0a 7d 0a 23 65 6e 64 69 OFF;. }.}.#endi
23470 66 0a 0a 2f 2a 0a 2a 2a 20 54 68 65 20 66 6f 6c f../*.** The fol
23480 6c 6f 77 69 6e 67 20 67 6c 6f 62 61 6c 20 76 61 lowing global va
23490 72 69 61 62 6c 65 20 69 73 20 69 6e 63 72 65 6d riable is increm
234a0 65 6e 74 65 64 20 77 68 65 6e 65 76 65 72 20 74 ented whenever t
234b0 68 65 20 6c 69 62 72 61 72 79 0a 2a 2a 20 61 74 he library.** at
234c0 74 65 6d 70 74 73 20 74 6f 20 6f 70 65 6e 20 61 tempts to open a
234d0 20 74 65 6d 70 6f 72 61 72 79 20 66 69 6c 65 2e temporary file.
234e0 20 20 54 68 69 73 20 69 6e 66 6f 72 6d 61 74 69 This informati
234f0 6f 6e 20 69 73 20 75 73 65 64 20 66 6f 72 0a 2a on is used for.*
23500 2a 20 74 65 73 74 69 6e 67 20 61 6e 64 20 61 6e * testing and an
23510 61 6c 79 73 69 73 20 6f 6e 6c 79 2e 20 20 0a 2a alysis only. .*
23520 2f 0a 23 69 66 64 65 66 20 53 51 4c 49 54 45 5f /.#ifdef SQLITE_
23530 54 45 53 54 0a 69 6e 74 20 73 71 6c 69 74 65 33 TEST.int sqlite3
23540 5f 6f 70 65 6e 74 65 6d 70 5f 63 6f 75 6e 74 20 _opentemp_count
23550 3d 20 30 3b 0a 23 65 6e 64 69 66 0a 0a 2f 2a 0a = 0;.#endif../*.
23560 2a 2a 20 4f 70 65 6e 20 61 20 74 65 6d 70 6f 72 ** Open a tempor
23570 61 72 79 20 66 69 6c 65 2e 0a 2a 2a 0a 2a 2a 20 ary file..**.**
23580 57 72 69 74 65 20 74 68 65 20 66 69 6c 65 20 64 Write the file d
23590 65 73 63 72 69 70 74 6f 72 20 69 6e 74 6f 20 2a escriptor into *
235a0 70 46 69 6c 65 2e 20 52 65 74 75 72 6e 20 53 51 pFile. Return SQ
235b0 4c 49 54 45 5f 4f 4b 20 6f 6e 20 73 75 63 63 65 LITE_OK on succe
235c0 73 73 20 0a 2a 2a 20 6f 72 20 73 6f 6d 65 20 6f ss .** or some o
235d0 74 68 65 72 20 65 72 72 6f 72 20 63 6f 64 65 20 ther error code
235e0 69 66 20 77 65 20 66 61 69 6c 2e 20 54 68 65 20 if we fail. The
235f0 4f 53 20 77 69 6c 6c 20 61 75 74 6f 6d 61 74 69 OS will automati
23600 63 61 6c 6c 79 20 0a 2a 2a 20 64 65 6c 65 74 65 cally .** delete
23610 20 74 68 65 20 74 65 6d 70 6f 72 61 72 79 20 66 the temporary f
23620 69 6c 65 20 77 68 65 6e 20 69 74 20 69 73 20 63 ile when it is c
23630 6c 6f 73 65 64 2e 0a 2a 2a 0a 2a 2a 20 54 68 65 losed..**.** The
23640 20 66 6c 61 67 73 20 70 61 73 73 65 64 20 74 6f flags passed to
23650 20 74 68 65 20 56 46 53 20 6c 61 79 65 72 20 78 the VFS layer x
23660 4f 70 65 6e 28 29 20 63 61 6c 6c 20 61 72 65 20 Open() call are
23670 74 68 6f 73 65 20 73 70 65 63 69 66 69 65 64 0a those specified.
23680 2a 2a 20 62 79 20 70 61 72 61 6d 65 74 65 72 20 ** by parameter
23690 76 66 73 46 6c 61 67 73 20 4f 52 65 64 20 77 69 vfsFlags ORed wi
236a0 74 68 20 74 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 th the following
236b0 3a 0a 2a 2a 0a 2a 2a 20 20 20 20 20 53 51 4c 49 :.**.** SQLI
236c0 54 45 5f 4f 50 45 4e 5f 52 45 41 44 57 52 49 54 TE_OPEN_READWRIT
236d0 45 0a 2a 2a 20 20 20 20 20 53 51 4c 49 54 45 5f E.** SQLITE_
236e0 4f 50 45 4e 5f 43 52 45 41 54 45 0a 2a 2a 20 20 OPEN_CREATE.**
236f0 20 20 20 53 51 4c 49 54 45 5f 4f 50 45 4e 5f 45 SQLITE_OPEN_E
23700 58 43 4c 55 53 49 56 45 0a 2a 2a 20 20 20 20 20 XCLUSIVE.**
23710 53 51 4c 49 54 45 5f 4f 50 45 4e 5f 44 45 4c 45 SQLITE_OPEN_DELE
23720 54 45 4f 4e 43 4c 4f 53 45 0a 2a 2f 0a 73 74 61 TEONCLOSE.*/.sta
23730 74 69 63 20 69 6e 74 20 70 61 67 65 72 4f 70 65 tic int pagerOpe
23740 6e 74 65 6d 70 28 0a 20 20 50 61 67 65 72 20 2a ntemp(. Pager *
23750 70 50 61 67 65 72 2c 20 20 20 20 20 20 20 20 2f pPager, /
23760 2a 20 54 68 65 20 70 61 67 65 72 20 6f 62 6a 65 * The pager obje
23770 63 74 20 2a 2f 0a 20 20 73 71 6c 69 74 65 33 5f ct */. sqlite3_
23780 66 69 6c 65 20 2a 70 46 69 6c 65 2c 20 20 2f 2a file *pFile, /*
23790 20 57 72 69 74 65 20 74 68 65 20 66 69 6c 65 20 Write the file
237a0 64 65 73 63 72 69 70 74 6f 72 20 68 65 72 65 20 descriptor here
237b0 2a 2f 0a 20 20 69 6e 74 20 76 66 73 46 6c 61 67 */. int vfsFlag
237c0 73 20 20 20 20 20 20 20 20 20 20 2f 2a 20 46 6c s /* Fl
237d0 61 67 73 20 70 61 73 73 65 64 20 74 68 72 6f 75 ags passed throu
237e0 67 68 20 74 6f 20 74 68 65 20 56 46 53 20 2a 2f gh to the VFS */
237f0 0a 29 7b 0a 20 20 69 6e 74 20 72 63 3b 20 20 20 .){. int rc;
23800 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 52 /* R
23810 65 74 75 72 6e 20 63 6f 64 65 20 2a 2f 0a 0a 23 eturn code */..#
23820 69 66 64 65 66 20 53 51 4c 49 54 45 5f 54 45 53 ifdef SQLITE_TES
23830 54 0a 20 20 73 71 6c 69 74 65 33 5f 6f 70 65 6e T. sqlite3_open
23840 74 65 6d 70 5f 63 6f 75 6e 74 2b 2b 3b 20 20 2f temp_count++; /
23850 2a 20 55 73 65 64 20 66 6f 72 20 74 65 73 74 69 * Used for testi
23860 6e 67 20 61 6e 64 20 61 6e 61 6c 79 73 69 73 20 ng and analysis
23870 6f 6e 6c 79 20 2a 2f 0a 23 65 6e 64 69 66 0a 0a only */.#endif..
23880 20 20 76 66 73 46 6c 61 67 73 20 7c 3d 20 20 53 vfsFlags |= S
23890 51 4c 49 54 45 5f 4f 50 45 4e 5f 52 45 41 44 57 QLITE_OPEN_READW
238a0 52 49 54 45 20 7c 20 53 51 4c 49 54 45 5f 4f 50 RITE | SQLITE_OP
238b0 45 4e 5f 43 52 45 41 54 45 20 7c 0a 20 20 20 20 EN_CREATE |.
238c0 20 20 20 20 20 20 20 20 53 51 4c 49 54 45 5f 4f SQLITE_O
238d0 50 45 4e 5f 45 58 43 4c 55 53 49 56 45 20 7c 20 PEN_EXCLUSIVE |
238e0 53 51 4c 49 54 45 5f 4f 50 45 4e 5f 44 45 4c 45 SQLITE_OPEN_DELE
238f0 54 45 4f 4e 43 4c 4f 53 45 3b 0a 20 20 72 63 20 TEONCLOSE;. rc
23900 3d 20 73 71 6c 69 74 65 33 4f 73 4f 70 65 6e 28 = sqlite3OsOpen(
23910 70 50 61 67 65 72 2d 3e 70 56 66 73 2c 20 30 2c pPager->pVfs, 0,
23920 20 70 46 69 6c 65 2c 20 76 66 73 46 6c 61 67 73 pFile, vfsFlags
23930 2c 20 30 29 3b 0a 20 20 61 73 73 65 72 74 28 20 , 0);. assert(
23940 72 63 21 3d 53 51 4c 49 54 45 5f 4f 4b 20 7c 7c rc!=SQLITE_OK ||
23950 20 69 73 4f 70 65 6e 28 70 46 69 6c 65 29 20 29 isOpen(pFile) )
23960 3b 0a 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 7d ;. return rc;.}
23970 0a 0a 2f 2a 0a 2a 2a 20 53 65 74 20 74 68 65 20 ../*.** Set the
23980 62 75 73 79 20 68 61 6e 64 6c 65 72 20 66 75 6e busy handler fun
23990 63 74 69 6f 6e 2e 0a 2a 2a 0a 2a 2a 20 54 68 65 ction..**.** The
239a0 20 70 61 67 65 72 20 69 6e 76 6f 6b 65 73 20 74 pager invokes t
239b0 68 65 20 62 75 73 79 2d 68 61 6e 64 6c 65 72 20 he busy-handler
239c0 69 66 20 73 71 6c 69 74 65 33 4f 73 4c 6f 63 6b if sqlite3OsLock
239d0 28 29 20 72 65 74 75 72 6e 73 20 0a 2a 2a 20 53 () returns .** S
239e0 51 4c 49 54 45 5f 42 55 53 59 20 77 68 65 6e 20 QLITE_BUSY when
239f0 74 72 79 69 6e 67 20 74 6f 20 75 70 67 72 61 64 trying to upgrad
23a00 65 20 66 72 6f 6d 20 6e 6f 2d 6c 6f 63 6b 20 74 e from no-lock t
23a10 6f 20 61 20 53 48 41 52 45 44 20 6c 6f 63 6b 2c o a SHARED lock,
23a20 0a 2a 2a 20 6f 72 20 77 68 65 6e 20 74 72 79 69 .** or when tryi
23a30 6e 67 20 74 6f 20 75 70 67 72 61 64 65 20 66 72 ng to upgrade fr
23a40 6f 6d 20 61 20 52 45 53 45 52 56 45 44 20 6c 6f om a RESERVED lo
23a50 63 6b 20 74 6f 20 61 6e 20 45 58 43 4c 55 53 49 ck to an EXCLUSI
23a60 56 45 20 0a 2a 2a 20 6c 6f 63 6b 2e 20 49 74 20 VE .** lock. It
23a70 64 6f 65 73 20 2a 6e 6f 74 2a 20 69 6e 76 6f 6b does *not* invok
23a80 65 20 74 68 65 20 62 75 73 79 20 68 61 6e 64 6c e the busy handl
23a90 65 72 20 77 68 65 6e 20 75 70 67 72 61 64 69 6e er when upgradin
23aa0 67 20 66 72 6f 6d 0a 2a 2a 20 53 48 41 52 45 44 g from.** SHARED
23ab0 20 74 6f 20 52 45 53 45 52 56 45 44 2c 20 6f 72 to RESERVED, or
23ac0 20 77 68 65 6e 20 75 70 67 72 61 64 69 6e 67 20 when upgrading
23ad0 66 72 6f 6d 20 53 48 41 52 45 44 20 74 6f 20 45 from SHARED to E
23ae0 58 43 4c 55 53 49 56 45 0a 2a 2a 20 28 77 68 69 XCLUSIVE.** (whi
23af0 63 68 20 6f 63 63 75 72 73 20 64 75 72 69 6e 67 ch occurs during
23b00 20 68 6f 74 2d 6a 6f 75 72 6e 61 6c 20 72 6f 6c hot-journal rol
23b10 6c 62 61 63 6b 29 2e 20 53 75 6d 6d 61 72 79 3a lback). Summary:
23b20 0a 2a 2a 0a 2a 2a 20 20 20 54 72 61 6e 73 69 74 .**.** Transit
23b30 69 6f 6e 20 20 20 20 20 20 20 20 20 20 20 20 20 ion
23b40 20 20 20 20 20 20 20 20 20 20 20 7c 20 49 6e 76 | Inv
23b50 6f 6b 65 73 20 78 42 75 73 79 48 61 6e 64 6c 65 okes xBusyHandle
23b60 72 0a 2a 2a 20 20 20 2d 2d 2d 2d 2d 2d 2d 2d 2d r.** ---------
23b70 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
23b80 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
23b90 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a ---------------.
23ba0 2a 2a 20 20 20 4e 4f 5f 4c 4f 43 4b 20 20 20 20 ** NO_LOCK
23bb0 20 20 20 2d 3e 20 53 48 41 52 45 44 5f 4c 4f 43 -> SHARED_LOC
23bc0 4b 20 20 20 20 20 20 7c 20 59 65 73 0a 2a 2a 20 K | Yes.**
23bd0 20 20 53 48 41 52 45 44 5f 4c 4f 43 4b 20 20 20 SHARED_LOCK
23be0 2d 3e 20 52 45 53 45 52 56 45 44 5f 4c 4f 43 4b -> RESERVED_LOCK
23bf0 20 20 20 20 7c 20 4e 6f 0a 2a 2a 20 20 20 53 48 | No.** SH
23c00 41 52 45 44 5f 4c 4f 43 4b 20 20 20 2d 3e 20 45 ARED_LOCK -> E
23c10 58 43 4c 55 53 49 56 45 5f 4c 4f 43 4b 20 20 20 XCLUSIVE_LOCK
23c20 7c 20 4e 6f 0a 2a 2a 20 20 20 52 45 53 45 52 56 | No.** RESERV
23c30 45 44 5f 4c 4f 43 4b 20 2d 3e 20 45 58 43 4c 55 ED_LOCK -> EXCLU
23c40 53 49 56 45 5f 4c 4f 43 4b 20 20 20 7c 20 59 65 SIVE_LOCK | Ye
23c50 73 0a 2a 2a 0a 2a 2a 20 49 66 20 74 68 65 20 62 s.**.** If the b
23c60 75 73 79 2d 68 61 6e 64 6c 65 72 20 63 61 6c 6c usy-handler call
23c70 62 61 63 6b 20 72 65 74 75 72 6e 73 20 6e 6f 6e back returns non
23c80 2d 7a 65 72 6f 2c 20 74 68 65 20 6c 6f 63 6b 20 -zero, the lock
23c90 69 73 20 0a 2a 2a 20 72 65 74 72 69 65 64 2e 20 is .** retried.
23ca0 49 66 20 69 74 20 72 65 74 75 72 6e 73 20 7a 65 If it returns ze
23cb0 72 6f 2c 20 74 68 65 6e 20 74 68 65 20 53 51 4c ro, then the SQL
23cc0 49 54 45 5f 42 55 53 59 20 65 72 72 6f 72 20 69 ITE_BUSY error i
23cd0 73 0a 2a 2a 20 72 65 74 75 72 6e 65 64 20 74 6f s.** returned to
23ce0 20 74 68 65 20 63 61 6c 6c 65 72 20 6f 66 20 74 the caller of t
23cf0 68 65 20 70 61 67 65 72 20 41 50 49 20 66 75 6e he pager API fun
23d00 63 74 69 6f 6e 2e 0a 2a 2f 0a 76 6f 69 64 20 73 ction..*/.void s
23d10 71 6c 69 74 65 33 50 61 67 65 72 53 65 74 42 75 qlite3PagerSetBu
23d20 73 79 68 61 6e 64 6c 65 72 28 0a 20 20 50 61 67 syhandler(. Pag
23d30 65 72 20 2a 70 50 61 67 65 72 2c 20 20 20 20 20 er *pPager,
23d40 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
23d50 20 20 2f 2a 20 50 61 67 65 72 20 6f 62 6a 65 63 /* Pager objec
23d60 74 20 2a 2f 0a 20 20 69 6e 74 20 28 2a 78 42 75 t */. int (*xBu
23d70 73 79 48 61 6e 64 6c 65 72 29 28 76 6f 69 64 20 syHandler)(void
23d80 2a 29 2c 20 20 20 20 20 20 20 20 20 2f 2a 20 50 *), /* P
23d90 6f 69 6e 74 65 72 20 74 6f 20 62 75 73 79 2d 68 ointer to busy-h
23da0 61 6e 64 6c 65 72 20 66 75 6e 63 74 69 6f 6e 20 andler function
23db0 2a 2f 0a 20 20 76 6f 69 64 20 2a 70 42 75 73 79 */. void *pBusy
23dc0 48 61 6e 64 6c 65 72 41 72 67 20 20 20 20 20 20 HandlerArg
23dd0 20 20 20 20 20 20 20 20 20 20 2f 2a 20 41 72 67 /* Arg
23de0 75 6d 65 6e 74 20 74 6f 20 70 61 73 73 20 74 6f ument to pass to
23df0 20 78 42 75 73 79 48 61 6e 64 6c 65 72 20 2a 2f xBusyHandler */
23e00 0a 29 7b 0a 20 20 70 50 61 67 65 72 2d 3e 78 42 .){. pPager->xB
23e10 75 73 79 48 61 6e 64 6c 65 72 20 3d 20 78 42 75 usyHandler = xBu
23e20 73 79 48 61 6e 64 6c 65 72 3b 0a 20 20 70 50 61 syHandler;. pPa
23e30 67 65 72 2d 3e 70 42 75 73 79 48 61 6e 64 6c 65 ger->pBusyHandle
23e40 72 41 72 67 20 3d 20 70 42 75 73 79 48 61 6e 64 rArg = pBusyHand
23e50 6c 65 72 41 72 67 3b 0a 0a 20 20 69 66 28 20 69 lerArg;.. if( i
23e60 73 4f 70 65 6e 28 70 50 61 67 65 72 2d 3e 66 64 sOpen(pPager->fd
23e70 29 20 29 7b 0a 20 20 20 20 76 6f 69 64 20 2a 2a ) ){. void **
23e80 61 70 20 3d 20 28 76 6f 69 64 20 2a 2a 29 26 70 ap = (void **)&p
23e90 50 61 67 65 72 2d 3e 78 42 75 73 79 48 61 6e 64 Pager->xBusyHand
23ea0 6c 65 72 3b 0a 20 20 20 20 61 73 73 65 72 74 28 ler;. assert(
23eb0 20 28 28 69 6e 74 28 2a 29 28 76 6f 69 64 20 2a ((int(*)(void *
23ec0 29 29 28 61 70 5b 30 5d 29 29 3d 3d 78 42 75 73 ))(ap[0]))==xBus
23ed0 79 48 61 6e 64 6c 65 72 20 29 3b 0a 20 20 20 20 yHandler );.
23ee0 61 73 73 65 72 74 28 20 61 70 5b 31 5d 3d 3d 70 assert( ap[1]==p
23ef0 42 75 73 79 48 61 6e 64 6c 65 72 41 72 67 20 29 BusyHandlerArg )
23f00 3b 0a 20 20 20 20 73 71 6c 69 74 65 33 4f 73 46 ;. sqlite3OsF
23f10 69 6c 65 43 6f 6e 74 72 6f 6c 48 69 6e 74 28 70 ileControlHint(p
23f20 50 61 67 65 72 2d 3e 66 64 2c 20 53 51 4c 49 54 Pager->fd, SQLIT
23f30 45 5f 46 43 4e 54 4c 5f 42 55 53 59 48 41 4e 44 E_FCNTL_BUSYHAND
23f40 4c 45 52 2c 20 28 76 6f 69 64 20 2a 29 61 70 29 LER, (void *)ap)
23f50 3b 0a 20 20 7d 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 43 ;. }.}../*.** C
23f60 68 61 6e 67 65 20 74 68 65 20 70 61 67 65 20 73 hange the page s
23f70 69 7a 65 20 75 73 65 64 20 62 79 20 74 68 65 20 ize used by the
23f80 50 61 67 65 72 20 6f 62 6a 65 63 74 2e 20 54 68 Pager object. Th
23f90 65 20 6e 65 77 20 70 61 67 65 20 73 69 7a 65 20 e new page size
23fa0 0a 2a 2a 20 69 73 20 70 61 73 73 65 64 20 69 6e .** is passed in
23fb0 20 2a 70 50 61 67 65 53 69 7a 65 2e 0a 2a 2a 0a *pPageSize..**.
23fc0 2a 2a 20 49 66 20 74 68 65 20 70 61 67 65 72 20 ** If the pager
23fd0 69 73 20 69 6e 20 74 68 65 20 65 72 72 6f 72 20 is in the error
23fe0 73 74 61 74 65 20 77 68 65 6e 20 74 68 69 73 20 state when this
23ff0 66 75 6e 63 74 69 6f 6e 20 69 73 20 63 61 6c 6c function is call
24000 65 64 2c 20 69 74 0a 2a 2a 20 69 73 20 61 20 6e ed, it.** is a n
24010 6f 2d 6f 70 2e 20 54 68 65 20 76 61 6c 75 65 20 o-op. The value
24020 72 65 74 75 72 6e 65 64 20 69 73 20 74 68 65 20 returned is the
24030 65 72 72 6f 72 20 73 74 61 74 65 20 65 72 72 6f error state erro
24040 72 20 63 6f 64 65 20 28 69 2e 65 2e 20 0a 2a 2a r code (i.e. .**
24050 20 6f 6e 65 20 6f 66 20 53 51 4c 49 54 45 5f 49 one of SQLITE_I
24060 4f 45 52 52 2c 20 61 6e 20 53 51 4c 49 54 45 5f OERR, an SQLITE_
24070 49 4f 45 52 52 5f 78 78 78 20 73 75 62 2d 63 6f IOERR_xxx sub-co
24080 64 65 20 6f 72 20 53 51 4c 49 54 45 5f 46 55 4c de or SQLITE_FUL
24090 4c 29 2e 0a 2a 2a 0a 2a 2a 20 4f 74 68 65 72 77 L)..**.** Otherw
240a0 69 73 65 2c 20 69 66 20 61 6c 6c 20 6f 66 20 74 ise, if all of t
240b0 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 61 72 65 he following are
240c0 20 74 72 75 65 3a 0a 2a 2a 0a 2a 2a 20 20 20 2a true:.**.** *
240d0 20 74 68 65 20 6e 65 77 20 70 61 67 65 20 73 69 the new page si
240e0 7a 65 20 28 76 61 6c 75 65 20 6f 66 20 2a 70 50 ze (value of *pP
240f0 61 67 65 53 69 7a 65 29 20 69 73 20 76 61 6c 69 ageSize) is vali
24100 64 20 28 61 20 70 6f 77 65 72 20 0a 2a 2a 20 20 d (a power .**
24110 20 20 20 6f 66 20 74 77 6f 20 62 65 74 77 65 65 of two betwee
24120 6e 20 35 31 32 20 61 6e 64 20 53 51 4c 49 54 45 n 512 and SQLITE
24130 5f 4d 41 58 5f 50 41 47 45 5f 53 49 5a 45 2c 20 _MAX_PAGE_SIZE,
24140 69 6e 63 6c 75 73 69 76 65 29 2c 20 61 6e 64 0a inclusive), and.
24150 2a 2a 0a 2a 2a 20 20 20 2a 20 74 68 65 72 65 20 **.** * there
24160 61 72 65 20 6e 6f 20 6f 75 74 73 74 61 6e 64 69 are no outstandi
24170 6e 67 20 70 61 67 65 20 72 65 66 65 72 65 6e 63 ng page referenc
24180 65 73 2c 20 61 6e 64 0a 2a 2a 0a 2a 2a 20 20 20 es, and.**.**
24190 2a 20 74 68 65 20 64 61 74 61 62 61 73 65 20 69 * the database i
241a0 73 20 65 69 74 68 65 72 20 6e 6f 74 20 61 6e 20 s either not an
241b0 69 6e 2d 6d 65 6d 6f 72 79 20 64 61 74 61 62 61 in-memory databa
241c0 73 65 20 6f 72 20 69 74 20 69 73 0a 2a 2a 20 20 se or it is.**
241d0 20 20 20 61 6e 20 69 6e 2d 6d 65 6d 6f 72 79 20 an in-memory
241e0 64 61 74 61 62 61 73 65 20 74 68 61 74 20 63 75 database that cu
241f0 72 72 65 6e 74 6c 79 20 63 6f 6e 73 69 73 74 73 rrently consists
24200 20 6f 66 20 7a 65 72 6f 20 70 61 67 65 73 2e 0a of zero pages..
24210 2a 2a 0a 2a 2a 20 74 68 65 6e 20 74 68 65 20 70 **.** then the p
24220 61 67 65 72 20 6f 62 6a 65 63 74 20 70 61 67 65 ager object page
24230 20 73 69 7a 65 20 69 73 20 73 65 74 20 74 6f 20 size is set to
24240 2a 70 50 61 67 65 53 69 7a 65 2e 0a 2a 2a 0a 2a *pPageSize..**.*
24250 2a 20 49 66 20 74 68 65 20 70 61 67 65 20 73 69 * If the page si
24260 7a 65 20 69 73 20 63 68 61 6e 67 65 64 2c 20 74 ze is changed, t
24270 68 65 6e 20 74 68 69 73 20 66 75 6e 63 74 69 6f hen this functio
24280 6e 20 75 73 65 73 20 73 71 6c 69 74 65 33 50 61 n uses sqlite3Pa
24290 67 65 72 4d 61 6c 6c 6f 63 28 29 20 0a 2a 2a 20 gerMalloc() .**
242a0 74 6f 20 6f 62 74 61 69 6e 20 61 20 6e 65 77 20 to obtain a new
242b0 50 61 67 65 72 2e 70 54 6d 70 53 70 61 63 65 20 Pager.pTmpSpace
242c0 62 75 66 66 65 72 2e 20 49 66 20 74 68 69 73 20 buffer. If this
242d0 61 6c 6c 6f 63 61 74 69 6f 6e 20 61 74 74 65 6d allocation attem
242e0 70 74 20 0a 2a 2a 20 66 61 69 6c 73 2c 20 53 51 pt .** fails, SQ
242f0 4c 49 54 45 5f 4e 4f 4d 45 4d 20 69 73 20 72 65 LITE_NOMEM is re
24300 74 75 72 6e 65 64 20 61 6e 64 20 74 68 65 20 70 turned and the p
24310 61 67 65 20 73 69 7a 65 20 72 65 6d 61 69 6e 73 age size remains
24320 20 75 6e 63 68 61 6e 67 65 64 2e 20 0a 2a 2a 20 unchanged. .**
24330 49 6e 20 61 6c 6c 20 6f 74 68 65 72 20 63 61 73 In all other cas
24340 65 73 2c 20 53 51 4c 49 54 45 5f 4f 4b 20 69 73 es, SQLITE_OK is
24350 20 72 65 74 75 72 6e 65 64 2e 0a 2a 2a 0a 2a 2a returned..**.**
24360 20 49 66 20 74 68 65 20 70 61 67 65 20 73 69 7a If the page siz
24370 65 20 69 73 20 6e 6f 74 20 63 68 61 6e 67 65 64 e is not changed
24380 2c 20 65 69 74 68 65 72 20 62 65 63 61 75 73 65 , either because
24390 20 6f 6e 65 20 6f 66 20 74 68 65 20 65 6e 75 6d one of the enum
243a0 65 72 61 74 65 64 0a 2a 2a 20 63 6f 6e 64 69 74 erated.** condit
243b0 69 6f 6e 73 20 61 62 6f 76 65 20 69 73 20 6e 6f ions above is no
243c0 74 20 74 72 75 65 2c 20 74 68 65 20 70 61 67 65 t true, the page
243d0 72 20 77 61 73 20 69 6e 20 65 72 72 6f 72 20 73 r was in error s
243e0 74 61 74 65 20 77 68 65 6e 20 74 68 69 73 0a 2a tate when this.*
243f0 2a 20 66 75 6e 63 74 69 6f 6e 20 77 61 73 20 63 * function was c
24400 61 6c 6c 65 64 2c 20 6f 72 20 62 65 63 61 75 73 alled, or becaus
24410 65 20 74 68 65 20 6d 65 6d 6f 72 79 20 61 6c 6c e the memory all
24420 6f 63 61 74 69 6f 6e 20 61 74 74 65 6d 70 74 20 ocation attempt
24430 66 61 69 6c 65 64 2c 20 0a 2a 2a 20 74 68 65 6e failed, .** then
24440 20 2a 70 50 61 67 65 53 69 7a 65 20 69 73 20 73 *pPageSize is s
24450 65 74 20 74 6f 20 74 68 65 20 6f 6c 64 2c 20 72 et to the old, r
24460 65 74 61 69 6e 65 64 20 70 61 67 65 20 73 69 7a etained page siz
24470 65 20 62 65 66 6f 72 65 20 72 65 74 75 72 6e 69 e before returni
24480 6e 67 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 ng..*/.int sqlit
24490 65 33 50 61 67 65 72 53 65 74 50 61 67 65 73 69 e3PagerSetPagesi
244a0 7a 65 28 50 61 67 65 72 20 2a 70 50 61 67 65 72 ze(Pager *pPager
244b0 2c 20 75 33 32 20 2a 70 50 61 67 65 53 69 7a 65 , u32 *pPageSize
244c0 2c 20 69 6e 74 20 6e 52 65 73 65 72 76 65 29 7b , int nReserve){
244d0 0a 20 20 69 6e 74 20 72 63 20 3d 20 53 51 4c 49 . int rc = SQLI
244e0 54 45 5f 4f 4b 3b 0a 0a 20 20 2f 2a 20 49 74 20 TE_OK;.. /* It
244f0 69 73 20 6e 6f 74 20 70 6f 73 73 69 62 6c 65 20 is not possible
24500 74 6f 20 64 6f 20 61 20 66 75 6c 6c 20 61 73 73 to do a full ass
24510 65 72 74 5f 70 61 67 65 72 5f 73 74 61 74 65 28 ert_pager_state(
24520 29 20 68 65 72 65 2c 20 61 73 20 74 68 69 73 0a ) here, as this.
24530 20 20 2a 2a 20 66 75 6e 63 74 69 6f 6e 20 6d 61 ** function ma
24540 79 20 62 65 20 63 61 6c 6c 65 64 20 66 72 6f 6d y be called from
24550 20 77 69 74 68 69 6e 20 50 61 67 65 72 4f 70 65 within PagerOpe
24560 6e 28 29 2c 20 62 65 66 6f 72 65 20 74 68 65 20 n(), before the
24570 73 74 61 74 65 0a 20 20 2a 2a 20 6f 66 20 74 68 state. ** of th
24580 65 20 50 61 67 65 72 20 6f 62 6a 65 63 74 20 69 e Pager object i
24590 73 20 69 6e 74 65 72 6e 61 6c 6c 79 20 63 6f 6e s internally con
245a0 73 69 73 74 65 6e 74 2e 0a 20 20 2a 2a 0a 20 20 sistent.. **.
245b0 2a 2a 20 41 74 20 6f 6e 65 20 70 6f 69 6e 74 20 ** At one point
245c0 74 68 69 73 20 66 75 6e 63 74 69 6f 6e 20 72 65 this function re
245d0 74 75 72 6e 65 64 20 61 6e 20 65 72 72 6f 72 20 turned an error
245e0 69 66 20 74 68 65 20 70 61 67 65 72 20 77 61 73 if the pager was
245f0 20 69 6e 20 0a 20 20 2a 2a 20 50 41 47 45 52 5f in . ** PAGER_
24600 45 52 52 4f 52 20 73 74 61 74 65 2e 20 42 75 74 ERROR state. But
24610 20 73 69 6e 63 65 20 50 41 47 45 52 5f 45 52 52 since PAGER_ERR
24620 4f 52 20 73 74 61 74 65 20 67 75 61 72 61 6e 74 OR state guarant
24630 65 65 73 20 74 68 61 74 0a 20 20 2a 2a 20 74 68 ees that. ** th
24640 65 72 65 20 69 73 20 61 74 20 6c 65 61 73 74 20 ere is at least
24650 6f 6e 65 20 6f 75 74 73 74 61 6e 64 69 6e 67 20 one outstanding
24660 70 61 67 65 20 72 65 66 65 72 65 6e 63 65 2c 20 page reference,
24670 74 68 69 73 20 66 75 6e 63 74 69 6f 6e 0a 20 20 this function.
24680 2a 2a 20 69 73 20 61 20 6e 6f 2d 6f 70 20 66 6f ** is a no-op fo
24690 72 20 74 68 61 74 20 63 61 73 65 20 61 6e 79 68 r that case anyh
246a0 6f 77 2e 0a 20 20 2a 2f 0a 0a 20 20 75 33 32 20 ow.. */.. u32
246b0 70 61 67 65 53 69 7a 65 20 3d 20 2a 70 50 61 67 pageSize = *pPag
246c0 65 53 69 7a 65 3b 0a 20 20 61 73 73 65 72 74 28 eSize;. assert(
246d0 20 70 61 67 65 53 69 7a 65 3d 3d 30 20 7c 7c 20 pageSize==0 ||
246e0 28 70 61 67 65 53 69 7a 65 3e 3d 35 31 32 20 26 (pageSize>=512 &
246f0 26 20 70 61 67 65 53 69 7a 65 3c 3d 53 51 4c 49 & pageSize<=SQLI
24700 54 45 5f 4d 41 58 5f 50 41 47 45 5f 53 49 5a 45 TE_MAX_PAGE_SIZE
24710 29 20 29 3b 0a 20 20 69 66 28 20 28 70 50 61 67 ) );. if( (pPag
24720 65 72 2d 3e 6d 65 6d 44 62 3d 3d 30 20 7c 7c 20 er->memDb==0 ||
24730 70 50 61 67 65 72 2d 3e 64 62 53 69 7a 65 3d 3d pPager->dbSize==
24740 30 29 0a 20 20 20 26 26 20 73 71 6c 69 74 65 33 0). && sqlite3
24750 50 63 61 63 68 65 52 65 66 43 6f 75 6e 74 28 70 PcacheRefCount(p
24760 50 61 67 65 72 2d 3e 70 50 43 61 63 68 65 29 3d Pager->pPCache)=
24770 3d 30 20 0a 20 20 20 26 26 20 70 61 67 65 53 69 =0 . && pageSi
24780 7a 65 20 26 26 20 70 61 67 65 53 69 7a 65 21 3d ze && pageSize!=
24790 28 75 33 32 29 70 50 61 67 65 72 2d 3e 70 61 67 (u32)pPager->pag
247a0 65 53 69 7a 65 20 0a 20 20 29 7b 0a 20 20 20 20 eSize . ){.
247b0 63 68 61 72 20 2a 70 4e 65 77 20 3d 20 4e 55 4c char *pNew = NUL
247c0 4c 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 2f L; /
247d0 2a 20 4e 65 77 20 74 65 6d 70 20 73 70 61 63 65 * New temp space
247e0 20 2a 2f 0a 20 20 20 20 69 36 34 20 6e 42 79 74 */. i64 nByt
247f0 65 20 3d 20 30 3b 0a 0a 20 20 20 20 69 66 28 20 e = 0;.. if(
24800 70 50 61 67 65 72 2d 3e 65 53 74 61 74 65 3e 50 pPager->eState>P
24810 41 47 45 52 5f 4f 50 45 4e 20 26 26 20 69 73 4f AGER_OPEN && isO
24820 70 65 6e 28 70 50 61 67 65 72 2d 3e 66 64 29 20 pen(pPager->fd)
24830 29 7b 0a 20 20 20 20 20 20 72 63 20 3d 20 73 71 ){. rc = sq
24840 6c 69 74 65 33 4f 73 46 69 6c 65 53 69 7a 65 28 lite3OsFileSize(
24850 70 50 61 67 65 72 2d 3e 66 64 2c 20 26 6e 42 79 pPager->fd, &nBy
24860 74 65 29 3b 0a 20 20 20 20 7d 0a 20 20 20 20 69 te);. }. i
24870 66 28 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b f( rc==SQLITE_OK
24880 20 29 7b 0a 20 20 20 20 20 20 70 4e 65 77 20 3d ){. pNew =
24890 20 28 63 68 61 72 20 2a 29 73 71 6c 69 74 65 33 (char *)sqlite3
248a0 50 61 67 65 4d 61 6c 6c 6f 63 28 70 61 67 65 53 PageMalloc(pageS
248b0 69 7a 65 29 3b 0a 20 20 20 20 20 20 69 66 28 20 ize);. if(
248c0 21 70 4e 65 77 20 29 20 72 63 20 3d 20 53 51 4c !pNew ) rc = SQL
248d0 49 54 45 5f 4e 4f 4d 45 4d 5f 42 4b 50 54 3b 0a ITE_NOMEM_BKPT;.
248e0 20 20 20 20 7d 0a 0a 20 20 20 20 69 66 28 20 72 }.. if( r
248f0 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a c==SQLITE_OK ){.
24900 20 20 20 20 20 20 70 61 67 65 72 5f 72 65 73 65 pager_rese
24910 74 28 70 50 61 67 65 72 29 3b 0a 20 20 20 20 20 t(pPager);.
24920 20 72 63 20 3d 20 73 71 6c 69 74 65 33 50 63 61 rc = sqlite3Pca
24930 63 68 65 53 65 74 50 61 67 65 53 69 7a 65 28 70 cheSetPageSize(p
24940 50 61 67 65 72 2d 3e 70 50 43 61 63 68 65 2c 20 Pager->pPCache,
24950 70 61 67 65 53 69 7a 65 29 3b 0a 20 20 20 20 7d pageSize);. }
24960 0a 20 20 20 20 69 66 28 20 72 63 3d 3d 53 51 4c . if( rc==SQL
24970 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 20 20 ITE_OK ){.
24980 73 71 6c 69 74 65 33 50 61 67 65 46 72 65 65 28 sqlite3PageFree(
24990 70 50 61 67 65 72 2d 3e 70 54 6d 70 53 70 61 63 pPager->pTmpSpac
249a0 65 29 3b 0a 20 20 20 20 20 20 70 50 61 67 65 72 e);. pPager
249b0 2d 3e 70 54 6d 70 53 70 61 63 65 20 3d 20 70 4e ->pTmpSpace = pN
249c0 65 77 3b 0a 20 20 20 20 20 20 70 50 61 67 65 72 ew;. pPager
249d0 2d 3e 64 62 53 69 7a 65 20 3d 20 28 50 67 6e 6f ->dbSize = (Pgno
249e0 29 28 28 6e 42 79 74 65 2b 70 61 67 65 53 69 7a )((nByte+pageSiz
249f0 65 2d 31 29 2f 70 61 67 65 53 69 7a 65 29 3b 0a e-1)/pageSize);.
24a00 20 20 20 20 20 20 70 50 61 67 65 72 2d 3e 70 61 pPager->pa
24a10 67 65 53 69 7a 65 20 3d 20 70 61 67 65 53 69 7a geSize = pageSiz
24a20 65 3b 0a 20 20 20 20 7d 65 6c 73 65 7b 0a 20 20 e;. }else{.
24a30 20 20 20 20 73 71 6c 69 74 65 33 50 61 67 65 46 sqlite3PageF
24a40 72 65 65 28 70 4e 65 77 29 3b 0a 20 20 20 20 7d ree(pNew);. }
24a50 0a 20 20 7d 0a 0a 20 20 2a 70 50 61 67 65 53 69 . }.. *pPageSi
24a60 7a 65 20 3d 20 70 50 61 67 65 72 2d 3e 70 61 67 ze = pPager->pag
24a70 65 53 69 7a 65 3b 0a 20 20 69 66 28 20 72 63 3d eSize;. if( rc=
24a80 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 =SQLITE_OK ){.
24a90 20 20 69 66 28 20 6e 52 65 73 65 72 76 65 3c 30 if( nReserve<0
24aa0 20 29 20 6e 52 65 73 65 72 76 65 20 3d 20 70 50 ) nReserve = pP
24ab0 61 67 65 72 2d 3e 6e 52 65 73 65 72 76 65 3b 0a ager->nReserve;.
24ac0 20 20 20 20 61 73 73 65 72 74 28 20 6e 52 65 73 assert( nRes
24ad0 65 72 76 65 3e 3d 30 20 26 26 20 6e 52 65 73 65 erve>=0 && nRese
24ae0 72 76 65 3c 31 30 30 30 20 29 3b 0a 20 20 20 20 rve<1000 );.
24af0 70 50 61 67 65 72 2d 3e 6e 52 65 73 65 72 76 65 pPager->nReserve
24b00 20 3d 20 28 69 31 36 29 6e 52 65 73 65 72 76 65 = (i16)nReserve
24b10 3b 0a 20 20 20 20 70 61 67 65 72 52 65 70 6f 72 ;. pagerRepor
24b20 74 53 69 7a 65 28 70 50 61 67 65 72 29 3b 0a 20 tSize(pPager);.
24b30 20 20 20 70 61 67 65 72 46 69 78 4d 61 70 6c 69 pagerFixMapli
24b40 6d 69 74 28 70 50 61 67 65 72 29 3b 0a 20 20 7d mit(pPager);. }
24b50 0a 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 7d 0a . return rc;.}.
24b60 0a 2f 2a 0a 2a 2a 20 52 65 74 75 72 6e 20 61 20 ./*.** Return a
24b70 70 6f 69 6e 74 65 72 20 74 6f 20 74 68 65 20 22 pointer to the "
24b80 74 65 6d 70 6f 72 61 72 79 20 70 61 67 65 22 20 temporary page"
24b90 62 75 66 66 65 72 20 68 65 6c 64 20 69 6e 74 65 buffer held inte
24ba0 72 6e 61 6c 6c 79 0a 2a 2a 20 62 79 20 74 68 65 rnally.** by the
24bb0 20 70 61 67 65 72 2e 20 20 54 68 69 73 20 69 73 pager. This is
24bc0 20 61 20 62 75 66 66 65 72 20 74 68 61 74 20 69 a buffer that i
24bd0 73 20 62 69 67 20 65 6e 6f 75 67 68 20 74 6f 20 s big enough to
24be0 68 6f 6c 64 20 74 68 65 0a 2a 2a 20 65 6e 74 69 hold the.** enti
24bf0 72 65 20 63 6f 6e 74 65 6e 74 20 6f 66 20 61 20 re content of a
24c00 64 61 74 61 62 61 73 65 20 70 61 67 65 2e 20 20 database page.
24c10 54 68 69 73 20 62 75 66 66 65 72 20 69 73 20 75 This buffer is u
24c20 73 65 64 20 69 6e 74 65 72 6e 61 6c 6c 79 0a 2a sed internally.*
24c30 2a 20 64 75 72 69 6e 67 20 72 6f 6c 6c 62 61 63 * during rollbac
24c40 6b 20 61 6e 64 20 77 69 6c 6c 20 62 65 20 6f 76 k and will be ov
24c50 65 72 77 72 69 74 74 65 6e 20 77 68 65 6e 65 76 erwritten whenev
24c60 65 72 20 61 20 72 6f 6c 6c 62 61 63 6b 0a 2a 2a er a rollback.**
24c70 20 6f 63 63 75 72 73 2e 20 20 42 75 74 20 6f 74 occurs. But ot
24c80 68 65 72 20 6d 6f 64 75 6c 65 73 20 61 72 65 20 her modules are
24c90 66 72 65 65 20 74 6f 20 75 73 65 20 69 74 20 74 free to use it t
24ca0 6f 6f 2c 20 61 73 20 6c 6f 6e 67 20 61 73 0a 2a oo, as long as.*
24cb0 2a 20 6e 6f 20 72 6f 6c 6c 62 61 63 6b 73 20 61 * no rollbacks a
24cc0 72 65 20 68 61 70 70 65 6e 69 6e 67 2e 0a 2a 2f re happening..*/
24cd0 0a 76 6f 69 64 20 2a 73 71 6c 69 74 65 33 50 61 .void *sqlite3Pa
24ce0 67 65 72 54 65 6d 70 53 70 61 63 65 28 50 61 67 gerTempSpace(Pag
24cf0 65 72 20 2a 70 50 61 67 65 72 29 7b 0a 20 20 72 er *pPager){. r
24d00 65 74 75 72 6e 20 70 50 61 67 65 72 2d 3e 70 54 eturn pPager->pT
24d10 6d 70 53 70 61 63 65 3b 0a 7d 0a 0a 2f 2a 0a 2a mpSpace;.}../*.*
24d20 2a 20 41 74 74 65 6d 70 74 20 74 6f 20 73 65 74 * Attempt to set
24d30 20 74 68 65 20 6d 61 78 69 6d 75 6d 20 64 61 74 the maximum dat
24d40 61 62 61 73 65 20 70 61 67 65 20 63 6f 75 6e 74 abase page count
24d50 20 69 66 20 6d 78 50 61 67 65 20 69 73 20 70 6f if mxPage is po
24d60 73 69 74 69 76 65 2e 20 0a 2a 2a 20 4d 61 6b 65 sitive. .** Make
24d70 20 6e 6f 20 63 68 61 6e 67 65 73 20 69 66 20 6d no changes if m
24d80 78 50 61 67 65 20 69 73 20 7a 65 72 6f 20 6f 72 xPage is zero or
24d90 20 6e 65 67 61 74 69 76 65 2e 20 20 41 6e 64 20 negative. And
24da0 6e 65 76 65 72 20 72 65 64 75 63 65 20 74 68 65 never reduce the
24db0 0a 2a 2a 20 6d 61 78 69 6d 75 6d 20 70 61 67 65 .** maximum page
24dc0 20 63 6f 75 6e 74 20 62 65 6c 6f 77 20 74 68 65 count below the
24dd0 20 63 75 72 72 65 6e 74 20 73 69 7a 65 20 6f 66 current size of
24de0 20 74 68 65 20 64 61 74 61 62 61 73 65 2e 0a 2a the database..*
24df0 2a 0a 2a 2a 20 52 65 67 61 72 64 6c 65 73 73 20 *.** Regardless
24e00 6f 66 20 6d 78 50 61 67 65 2c 20 72 65 74 75 72 of mxPage, retur
24e10 6e 20 74 68 65 20 63 75 72 72 65 6e 74 20 6d 61 n the current ma
24e20 78 69 6d 75 6d 20 70 61 67 65 20 63 6f 75 6e 74 ximum page count
24e30 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 ..*/.int sqlite3
24e40 50 61 67 65 72 4d 61 78 50 61 67 65 43 6f 75 6e PagerMaxPageCoun
24e50 74 28 50 61 67 65 72 20 2a 70 50 61 67 65 72 2c t(Pager *pPager,
24e60 20 69 6e 74 20 6d 78 50 61 67 65 29 7b 0a 20 20 int mxPage){.
24e70 69 66 28 20 6d 78 50 61 67 65 3e 30 20 29 7b 0a if( mxPage>0 ){.
24e80 20 20 20 20 70 50 61 67 65 72 2d 3e 6d 78 50 67 pPager->mxPg
24e90 6e 6f 20 3d 20 6d 78 50 61 67 65 3b 0a 20 20 7d no = mxPage;. }
24ea0 0a 20 20 61 73 73 65 72 74 28 20 70 50 61 67 65 . assert( pPage
24eb0 72 2d 3e 65 53 74 61 74 65 21 3d 50 41 47 45 52 r->eState!=PAGER
24ec0 5f 4f 50 45 4e 20 29 3b 20 20 20 20 20 20 2f 2a _OPEN ); /*
24ed0 20 43 61 6c 6c 65 64 20 6f 6e 6c 79 20 62 79 20 Called only by
24ee0 4f 50 5f 4d 61 78 50 67 63 6e 74 20 2a 2f 0a 20 OP_MaxPgcnt */.
24ef0 20 61 73 73 65 72 74 28 20 70 50 61 67 65 72 2d assert( pPager-
24f00 3e 6d 78 50 67 6e 6f 3e 3d 70 50 61 67 65 72 2d >mxPgno>=pPager-
24f10 3e 64 62 53 69 7a 65 20 29 3b 20 20 2f 2a 20 4f >dbSize ); /* O
24f20 50 5f 4d 61 78 50 67 63 6e 74 20 65 6e 66 6f 72 P_MaxPgcnt enfor
24f30 63 65 73 20 74 68 69 73 20 2a 2f 0a 20 20 72 65 ces this */. re
24f40 74 75 72 6e 20 70 50 61 67 65 72 2d 3e 6d 78 50 turn pPager->mxP
24f50 67 6e 6f 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 54 68 gno;.}../*.** Th
24f60 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 73 65 74 20 e following set
24f70 6f 66 20 72 6f 75 74 69 6e 65 73 20 61 72 65 20 of routines are
24f80 75 73 65 64 20 74 6f 20 64 69 73 61 62 6c 65 20 used to disable
24f90 74 68 65 20 73 69 6d 75 6c 61 74 65 64 0a 2a 2a the simulated.**
24fa0 20 49 2f 4f 20 65 72 72 6f 72 20 6d 65 63 68 61 I/O error mecha
24fb0 6e 69 73 6d 2e 20 20 54 68 65 73 65 20 72 6f 75 nism. These rou
24fc0 74 69 6e 65 73 20 61 72 65 20 75 73 65 64 20 74 tines are used t
24fd0 6f 20 61 76 6f 69 64 20 73 69 6d 75 6c 61 74 65 o avoid simulate
24fe0 64 0a 2a 2a 20 65 72 72 6f 72 73 20 69 6e 20 70 d.** errors in p
24ff0 6c 61 63 65 73 20 77 68 65 72 65 20 77 65 20 64 laces where we d
25000 6f 20 6e 6f 74 20 63 61 72 65 20 61 62 6f 75 74 o not care about
25010 20 65 72 72 6f 72 73 2e 0a 2a 2a 0a 2a 2a 20 55 errors..**.** U
25020 6e 6c 65 73 73 20 2d 44 53 51 4c 49 54 45 5f 54 nless -DSQLITE_T
25030 45 53 54 3d 31 20 69 73 20 75 73 65 64 2c 20 74 EST=1 is used, t
25040 68 65 73 65 20 72 6f 75 74 69 6e 65 73 20 61 72 hese routines ar
25050 65 20 61 6c 6c 20 6e 6f 2d 6f 70 73 0a 2a 2a 20 e all no-ops.**
25060 61 6e 64 20 67 65 6e 65 72 61 74 65 20 6e 6f 20 and generate no
25070 63 6f 64 65 2e 0a 2a 2f 0a 23 69 66 64 65 66 20 code..*/.#ifdef
25080 53 51 4c 49 54 45 5f 54 45 53 54 0a 65 78 74 65 SQLITE_TEST.exte
25090 72 6e 20 69 6e 74 20 73 71 6c 69 74 65 33 5f 69 rn int sqlite3_i
250a0 6f 5f 65 72 72 6f 72 5f 70 65 6e 64 69 6e 67 3b o_error_pending;
250b0 0a 65 78 74 65 72 6e 20 69 6e 74 20 73 71 6c 69 .extern int sqli
250c0 74 65 33 5f 69 6f 5f 65 72 72 6f 72 5f 68 69 74 te3_io_error_hit
250d0 3b 0a 73 74 61 74 69 63 20 69 6e 74 20 73 61 76 ;.static int sav
250e0 65 64 5f 63 6e 74 3b 0a 76 6f 69 64 20 64 69 73 ed_cnt;.void dis
250f0 61 62 6c 65 5f 73 69 6d 75 6c 61 74 65 64 5f 69 able_simulated_i
25100 6f 5f 65 72 72 6f 72 73 28 76 6f 69 64 29 7b 0a o_errors(void){.
25110 20 20 73 61 76 65 64 5f 63 6e 74 20 3d 20 73 71 saved_cnt = sq
25120 6c 69 74 65 33 5f 69 6f 5f 65 72 72 6f 72 5f 70 lite3_io_error_p
25130 65 6e 64 69 6e 67 3b 0a 20 20 73 71 6c 69 74 65 ending;. sqlite
25140 33 5f 69 6f 5f 65 72 72 6f 72 5f 70 65 6e 64 69 3_io_error_pendi
25150 6e 67 20 3d 20 2d 31 3b 0a 7d 0a 76 6f 69 64 20 ng = -1;.}.void
25160 65 6e 61 62 6c 65 5f 73 69 6d 75 6c 61 74 65 64 enable_simulated
25170 5f 69 6f 5f 65 72 72 6f 72 73 28 76 6f 69 64 29 _io_errors(void)
25180 7b 0a 20 20 73 71 6c 69 74 65 33 5f 69 6f 5f 65 {. sqlite3_io_e
25190 72 72 6f 72 5f 70 65 6e 64 69 6e 67 20 3d 20 73 rror_pending = s
251a0 61 76 65 64 5f 63 6e 74 3b 0a 7d 0a 23 65 6c 73 aved_cnt;.}.#els
251b0 65 0a 23 20 64 65 66 69 6e 65 20 64 69 73 61 62 e.# define disab
251c0 6c 65 5f 73 69 6d 75 6c 61 74 65 64 5f 69 6f 5f le_simulated_io_
251d0 65 72 72 6f 72 73 28 29 0a 23 20 64 65 66 69 6e errors().# defin
251e0 65 20 65 6e 61 62 6c 65 5f 73 69 6d 75 6c 61 74 e enable_simulat
251f0 65 64 5f 69 6f 5f 65 72 72 6f 72 73 28 29 0a 23 ed_io_errors().#
25200 65 6e 64 69 66 0a 0a 2f 2a 0a 2a 2a 20 52 65 61 endif../*.** Rea
25210 64 20 74 68 65 20 66 69 72 73 74 20 4e 20 62 79 d the first N by
25220 74 65 73 20 66 72 6f 6d 20 74 68 65 20 62 65 67 tes from the beg
25230 69 6e 6e 69 6e 67 20 6f 66 20 74 68 65 20 66 69 inning of the fi
25240 6c 65 20 69 6e 74 6f 20 6d 65 6d 6f 72 79 0a 2a le into memory.*
25250 2a 20 74 68 61 74 20 70 44 65 73 74 20 70 6f 69 * that pDest poi
25260 6e 74 73 20 74 6f 2e 20 0a 2a 2a 0a 2a 2a 20 49 nts to. .**.** I
25270 66 20 74 68 65 20 70 61 67 65 72 20 77 61 73 20 f the pager was
25280 6f 70 65 6e 65 64 20 6f 6e 20 61 20 74 72 61 6e opened on a tran
25290 73 69 65 6e 74 20 66 69 6c 65 20 28 7a 46 69 6c sient file (zFil
252a0 65 6e 61 6d 65 3d 3d 22 22 29 2c 20 6f 72 0a 2a ename==""), or.*
252b0 2a 20 6f 70 65 6e 65 64 20 6f 6e 20 61 20 66 69 * opened on a fi
252c0 6c 65 20 6c 65 73 73 20 74 68 61 6e 20 4e 20 62 le less than N b
252d0 79 74 65 73 20 69 6e 20 73 69 7a 65 2c 20 74 68 ytes in size, th
252e0 65 20 6f 75 74 70 75 74 20 62 75 66 66 65 72 20 e output buffer
252f0 69 73 0a 2a 2a 20 7a 65 72 6f 65 64 20 61 6e 64 is.** zeroed and
25300 20 53 51 4c 49 54 45 5f 4f 4b 20 72 65 74 75 72 SQLITE_OK retur
25310 6e 65 64 2e 20 54 68 65 20 72 61 74 69 6f 6e 61 ned. The rationa
25320 6c 65 20 66 6f 72 20 74 68 69 73 20 69 73 20 74 le for this is t
25330 68 61 74 20 74 68 69 73 20 0a 2a 2a 20 66 75 6e hat this .** fun
25340 63 74 69 6f 6e 20 69 73 20 75 73 65 64 20 74 6f ction is used to
25350 20 72 65 61 64 20 64 61 74 61 62 61 73 65 20 68 read database h
25360 65 61 64 65 72 73 2c 20 61 6e 64 20 61 20 6e 65 eaders, and a ne
25370 77 20 74 72 61 6e 73 69 65 6e 74 20 6f 72 0a 2a w transient or.*
25380 2a 20 7a 65 72 6f 20 73 69 7a 65 64 20 64 61 74 * zero sized dat
25390 61 62 61 73 65 20 68 61 73 20 61 20 68 65 61 64 abase has a head
253a0 65 72 20 74 68 61 6e 20 63 6f 6e 73 69 73 74 73 er than consists
253b0 20 65 6e 74 69 72 65 6c 79 20 6f 66 20 7a 65 72 entirely of zer
253c0 6f 65 73 2e 0a 2a 2a 0a 2a 2a 20 49 66 20 61 6e oes..**.** If an
253d0 79 20 49 4f 20 65 72 72 6f 72 20 61 70 61 72 74 y IO error apart
253e0 20 66 72 6f 6d 20 53 51 4c 49 54 45 5f 49 4f 45 from SQLITE_IOE
253f0 52 52 5f 53 48 4f 52 54 5f 52 45 41 44 20 69 73 RR_SHORT_READ is
25400 20 65 6e 63 6f 75 6e 74 65 72 65 64 2c 0a 2a 2a encountered,.**
25410 20 74 68 65 20 65 72 72 6f 72 20 63 6f 64 65 20 the error code
25420 69 73 20 72 65 74 75 72 6e 65 64 20 74 6f 20 74 is returned to t
25430 68 65 20 63 61 6c 6c 65 72 20 61 6e 64 20 74 68 he caller and th
25440 65 20 63 6f 6e 74 65 6e 74 73 20 6f 66 20 74 68 e contents of th
25450 65 0a 2a 2a 20 6f 75 74 70 75 74 20 62 75 66 66 e.** output buff
25460 65 72 20 75 6e 64 65 66 69 6e 65 64 2e 0a 2a 2f er undefined..*/
25470 0a 69 6e 74 20 73 71 6c 69 74 65 33 50 61 67 65 .int sqlite3Page
25480 72 52 65 61 64 46 69 6c 65 68 65 61 64 65 72 28 rReadFileheader(
25490 50 61 67 65 72 20 2a 70 50 61 67 65 72 2c 20 69 Pager *pPager, i
254a0 6e 74 20 4e 2c 20 75 6e 73 69 67 6e 65 64 20 63 nt N, unsigned c
254b0 68 61 72 20 2a 70 44 65 73 74 29 7b 0a 20 20 69 har *pDest){. i
254c0 6e 74 20 72 63 20 3d 20 53 51 4c 49 54 45 5f 4f nt rc = SQLITE_O
254d0 4b 3b 0a 20 20 6d 65 6d 73 65 74 28 70 44 65 73 K;. memset(pDes
254e0 74 2c 20 30 2c 20 4e 29 3b 0a 20 20 61 73 73 65 t, 0, N);. asse
254f0 72 74 28 20 69 73 4f 70 65 6e 28 70 50 61 67 65 rt( isOpen(pPage
25500 72 2d 3e 66 64 29 20 7c 7c 20 70 50 61 67 65 72 r->fd) || pPager
25510 2d 3e 74 65 6d 70 46 69 6c 65 20 29 3b 0a 0a 20 ->tempFile );..
25520 20 2f 2a 20 54 68 69 73 20 72 6f 75 74 69 6e 65 /* This routine
25530 20 69 73 20 6f 6e 6c 79 20 63 61 6c 6c 65 64 20 is only called
25540 62 79 20 62 74 72 65 65 20 69 6d 6d 65 64 69 61 by btree immedia
25550 74 65 6c 79 20 61 66 74 65 72 20 63 72 65 61 74 tely after creat
25560 69 6e 67 0a 20 20 2a 2a 20 74 68 65 20 50 61 67 ing. ** the Pag
25570 65 72 20 6f 62 6a 65 63 74 2e 20 20 54 68 65 72 er object. Ther
25580 65 20 68 61 73 20 6e 6f 74 20 62 65 65 6e 20 61 e has not been a
25590 6e 20 6f 70 70 6f 72 74 75 6e 69 74 79 20 74 6f n opportunity to
255a0 20 74 72 61 6e 73 69 74 69 6f 6e 0a 20 20 2a 2a transition. **
255b0 20 74 6f 20 57 41 4c 20 6d 6f 64 65 20 79 65 74 to WAL mode yet
255c0 2e 0a 20 20 2a 2f 0a 20 20 61 73 73 65 72 74 28 .. */. assert(
255d0 20 21 70 61 67 65 72 55 73 65 57 61 6c 28 70 50 !pagerUseWal(pP
255e0 61 67 65 72 29 20 29 3b 0a 0a 20 20 69 66 28 20 ager) );.. if(
255f0 69 73 4f 70 65 6e 28 70 50 61 67 65 72 2d 3e 66 isOpen(pPager->f
25600 64 29 20 29 7b 0a 20 20 20 20 49 4f 54 52 41 43 d) ){. IOTRAC
25610 45 28 28 22 44 42 48 44 52 20 25 70 20 30 20 25 E(("DBHDR %p 0 %
25620 64 5c 6e 22 2c 20 70 50 61 67 65 72 2c 20 4e 29 d\n", pPager, N)
25630 29 0a 20 20 20 20 72 63 20 3d 20 73 71 6c 69 74 ). rc = sqlit
25640 65 33 4f 73 52 65 61 64 28 70 50 61 67 65 72 2d e3OsRead(pPager-
25650 3e 66 64 2c 20 70 44 65 73 74 2c 20 4e 2c 20 30 >fd, pDest, N, 0
25660 29 3b 0a 20 20 20 20 69 66 28 20 72 63 3d 3d 53 );. if( rc==S
25670 51 4c 49 54 45 5f 49 4f 45 52 52 5f 53 48 4f 52 QLITE_IOERR_SHOR
25680 54 5f 52 45 41 44 20 29 7b 0a 20 20 20 20 20 20 T_READ ){.
25690 72 63 20 3d 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a rc = SQLITE_OK;.
256a0 20 20 20 20 7d 0a 20 20 7d 0a 20 20 72 65 74 75 }. }. retu
256b0 72 6e 20 72 63 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 rn rc;.}../*.**
256c0 54 68 69 73 20 66 75 6e 63 74 69 6f 6e 20 6d 61 This function ma
256d0 79 20 6f 6e 6c 79 20 62 65 20 63 61 6c 6c 65 64 y only be called
256e0 20 77 68 65 6e 20 61 20 72 65 61 64 2d 74 72 61 when a read-tra
256f0 6e 73 61 63 74 69 6f 6e 20 69 73 20 6f 70 65 6e nsaction is open
25700 20 6f 6e 0a 2a 2a 20 74 68 65 20 70 61 67 65 72 on.** the pager
25710 2e 20 49 74 20 72 65 74 75 72 6e 73 20 74 68 65 . It returns the
25720 20 74 6f 74 61 6c 20 6e 75 6d 62 65 72 20 6f 66 total number of
25730 20 70 61 67 65 73 20 69 6e 20 74 68 65 20 64 61 pages in the da
25740 74 61 62 61 73 65 2e 0a 2a 2a 0a 2a 2a 20 48 6f tabase..**.** Ho
25750 77 65 76 65 72 2c 20 69 66 20 74 68 65 20 66 69 wever, if the fi
25760 6c 65 20 69 73 20 62 65 74 77 65 65 6e 20 31 20 le is between 1
25770 61 6e 64 20 3c 70 61 67 65 2d 73 69 7a 65 3e 20 and <page-size>
25780 62 79 74 65 73 20 69 6e 20 73 69 7a 65 2c 20 74 bytes in size, t
25790 68 65 6e 20 0a 2a 2a 20 74 68 69 73 20 69 73 20 hen .** this is
257a0 63 6f 6e 73 69 64 65 72 65 64 20 61 20 31 20 70 considered a 1 p
257b0 61 67 65 20 66 69 6c 65 2e 0a 2a 2f 0a 76 6f 69 age file..*/.voi
257c0 64 20 73 71 6c 69 74 65 33 50 61 67 65 72 50 61 d sqlite3PagerPa
257d0 67 65 63 6f 75 6e 74 28 50 61 67 65 72 20 2a 70 gecount(Pager *p
257e0 50 61 67 65 72 2c 20 69 6e 74 20 2a 70 6e 50 61 Pager, int *pnPa
257f0 67 65 29 7b 0a 20 20 61 73 73 65 72 74 28 20 70 ge){. assert( p
25800 50 61 67 65 72 2d 3e 65 53 74 61 74 65 3e 3d 50 Pager->eState>=P
25810 41 47 45 52 5f 52 45 41 44 45 52 20 29 3b 0a 20 AGER_READER );.
25820 20 61 73 73 65 72 74 28 20 70 50 61 67 65 72 2d assert( pPager-
25830 3e 65 53 74 61 74 65 21 3d 50 41 47 45 52 5f 57 >eState!=PAGER_W
25840 52 49 54 45 52 5f 46 49 4e 49 53 48 45 44 20 29 RITER_FINISHED )
25850 3b 0a 20 20 2a 70 6e 50 61 67 65 20 3d 20 28 69 ;. *pnPage = (i
25860 6e 74 29 70 50 61 67 65 72 2d 3e 64 62 53 69 7a nt)pPager->dbSiz
25870 65 3b 0a 7d 0a 0a 0a 2f 2a 0a 2a 2a 20 54 72 79 e;.}.../*.** Try
25880 20 74 6f 20 6f 62 74 61 69 6e 20 61 20 6c 6f 63 to obtain a loc
25890 6b 20 6f 66 20 74 79 70 65 20 6c 6f 63 6b 74 79 k of type lockty
258a0 70 65 20 6f 6e 20 74 68 65 20 64 61 74 61 62 61 pe on the databa
258b0 73 65 20 66 69 6c 65 2e 20 49 66 0a 2a 2a 20 61 se file. If.** a
258c0 20 73 69 6d 69 6c 61 72 20 6f 72 20 67 72 65 61 similar or grea
258d0 74 65 72 20 6c 6f 63 6b 20 69 73 20 61 6c 72 65 ter lock is alre
258e0 61 64 79 20 68 65 6c 64 2c 20 74 68 69 73 20 66 ady held, this f
258f0 75 6e 63 74 69 6f 6e 20 69 73 20 61 20 6e 6f 2d unction is a no-
25900 6f 70 0a 2a 2a 20 28 72 65 74 75 72 6e 69 6e 67 op.** (returning
25910 20 53 51 4c 49 54 45 5f 4f 4b 20 69 6d 6d 65 64 SQLITE_OK immed
25920 69 61 74 65 6c 79 29 2e 0a 2a 2a 0a 2a 2a 20 4f iately)..**.** O
25930 74 68 65 72 77 69 73 65 2c 20 61 74 74 65 6d 70 therwise, attemp
25940 74 20 74 6f 20 6f 62 74 61 69 6e 20 74 68 65 20 t to obtain the
25950 6c 6f 63 6b 20 75 73 69 6e 67 20 73 71 6c 69 74 lock using sqlit
25960 65 33 4f 73 4c 6f 63 6b 28 29 2e 20 49 6e 76 6f e3OsLock(). Invo
25970 6b 65 20 0a 2a 2a 20 74 68 65 20 62 75 73 79 20 ke .** the busy
25980 63 61 6c 6c 62 61 63 6b 20 69 66 20 74 68 65 20 callback if the
25990 6c 6f 63 6b 20 69 73 20 63 75 72 72 65 6e 74 6c lock is currentl
259a0 79 20 6e 6f 74 20 61 76 61 69 6c 61 62 6c 65 2e y not available.
259b0 20 52 65 70 65 61 74 20 0a 2a 2a 20 75 6e 74 69 Repeat .** unti
259c0 6c 20 74 68 65 20 62 75 73 79 20 63 61 6c 6c 62 l the busy callb
259d0 61 63 6b 20 72 65 74 75 72 6e 73 20 66 61 6c 73 ack returns fals
259e0 65 20 6f 72 20 75 6e 74 69 6c 20 74 68 65 20 61 e or until the a
259f0 74 74 65 6d 70 74 20 74 6f 20 0a 2a 2a 20 6f 62 ttempt to .** ob
25a00 74 61 69 6e 20 74 68 65 20 6c 6f 63 6b 20 73 75 tain the lock su
25a10 63 63 65 65 64 73 2e 0a 2a 2a 0a 2a 2a 20 52 65 cceeds..**.** Re
25a20 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 20 6f turn SQLITE_OK o
25a30 6e 20 73 75 63 63 65 73 73 20 61 6e 64 20 61 6e n success and an
25a40 20 65 72 72 6f 72 20 63 6f 64 65 20 69 66 20 77 error code if w
25a50 65 20 63 61 6e 6e 6f 74 20 6f 62 74 61 69 6e 0a e cannot obtain.
25a60 2a 2a 20 74 68 65 20 6c 6f 63 6b 2e 20 49 66 20 ** the lock. If
25a70 74 68 65 20 6c 6f 63 6b 20 69 73 20 6f 62 74 61 the lock is obta
25a80 69 6e 65 64 20 73 75 63 63 65 73 73 66 75 6c 6c ined successfull
25a90 79 2c 20 73 65 74 20 74 68 65 20 50 61 67 65 72 y, set the Pager
25aa0 2e 73 74 61 74 65 20 0a 2a 2a 20 76 61 72 69 61 .state .** varia
25ab0 62 6c 65 20 74 6f 20 6c 6f 63 6b 74 79 70 65 20 ble to locktype
25ac0 62 65 66 6f 72 65 20 72 65 74 75 72 6e 69 6e 67 before returning
25ad0 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74 20 ..*/.static int
25ae0 70 61 67 65 72 5f 77 61 69 74 5f 6f 6e 5f 6c 6f pager_wait_on_lo
25af0 63 6b 28 50 61 67 65 72 20 2a 70 50 61 67 65 72 ck(Pager *pPager
25b00 2c 20 69 6e 74 20 6c 6f 63 6b 74 79 70 65 29 7b , int locktype){
25b10 0a 20 20 69 6e 74 20 72 63 3b 20 20 20 20 20 20 . int rc;
25b20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
25b30 20 20 20 20 20 20 20 20 2f 2a 20 52 65 74 75 72 /* Retur
25b40 6e 20 63 6f 64 65 20 2a 2f 0a 0a 20 20 2f 2a 20 n code */.. /*
25b50 43 68 65 63 6b 20 74 68 61 74 20 74 68 69 73 20 Check that this
25b60 69 73 20 65 69 74 68 65 72 20 61 20 6e 6f 2d 6f is either a no-o
25b70 70 20 28 62 65 63 61 75 73 65 20 74 68 65 20 72 p (because the r
25b80 65 71 75 65 73 74 65 64 20 6c 6f 63 6b 20 69 73 equested lock is
25b90 20 0a 20 20 2a 2a 20 61 6c 72 65 61 64 79 20 68 . ** already h
25ba0 65 6c 64 29 2c 20 6f 72 20 6f 6e 65 20 6f 66 20 eld), or one of
25bb0 74 68 65 20 74 72 61 6e 73 69 74 69 6f 6e 73 20 the transitions
25bc0 74 68 61 74 20 74 68 65 20 62 75 73 79 2d 68 61 that the busy-ha
25bd0 6e 64 6c 65 72 0a 20 20 2a 2a 20 6d 61 79 20 62 ndler. ** may b
25be0 65 20 69 6e 76 6f 6b 65 64 20 64 75 72 69 6e 67 e invoked during
25bf0 2c 20 61 63 63 6f 72 64 69 6e 67 20 74 6f 20 74 , according to t
25c00 68 65 20 63 6f 6d 6d 65 6e 74 20 61 62 6f 76 65 he comment above
25c10 0a 20 20 2a 2a 20 73 71 6c 69 74 65 33 50 61 67 . ** sqlite3Pag
25c20 65 72 53 65 74 42 75 73 79 68 61 6e 64 6c 65 72 erSetBusyhandler
25c30 28 29 2e 0a 20 20 2a 2f 0a 20 20 61 73 73 65 72 ().. */. asser
25c40 74 28 20 28 70 50 61 67 65 72 2d 3e 65 4c 6f 63 t( (pPager->eLoc
25c50 6b 3e 3d 6c 6f 63 6b 74 79 70 65 29 0a 20 20 20 k>=locktype).
25c60 20 20 20 20 7c 7c 20 28 70 50 61 67 65 72 2d 3e || (pPager->
25c70 65 4c 6f 63 6b 3d 3d 4e 4f 5f 4c 4f 43 4b 20 26 eLock==NO_LOCK &
25c80 26 20 6c 6f 63 6b 74 79 70 65 3d 3d 53 48 41 52 & locktype==SHAR
25c90 45 44 5f 4c 4f 43 4b 29 0a 20 20 20 20 20 20 20 ED_LOCK).
25ca0 7c 7c 20 28 70 50 61 67 65 72 2d 3e 65 4c 6f 63 || (pPager->eLoc
25cb0 6b 3d 3d 52 45 53 45 52 56 45 44 5f 4c 4f 43 4b k==RESERVED_LOCK
25cc0 20 26 26 20 6c 6f 63 6b 74 79 70 65 3d 3d 45 58 && locktype==EX
25cd0 43 4c 55 53 49 56 45 5f 4c 4f 43 4b 29 0a 20 20 CLUSIVE_LOCK).
25ce0 29 3b 0a 0a 20 20 64 6f 20 7b 0a 20 20 20 20 72 );.. do {. r
25cf0 63 20 3d 20 70 61 67 65 72 4c 6f 63 6b 44 62 28 c = pagerLockDb(
25d00 70 50 61 67 65 72 2c 20 6c 6f 63 6b 74 79 70 65 pPager, locktype
25d10 29 3b 0a 20 20 7d 77 68 69 6c 65 28 20 72 63 3d );. }while( rc=
25d20 3d 53 51 4c 49 54 45 5f 42 55 53 59 20 26 26 20 =SQLITE_BUSY &&
25d30 70 50 61 67 65 72 2d 3e 78 42 75 73 79 48 61 6e pPager->xBusyHan
25d40 64 6c 65 72 28 70 50 61 67 65 72 2d 3e 70 42 75 dler(pPager->pBu
25d50 73 79 48 61 6e 64 6c 65 72 41 72 67 29 20 29 3b syHandlerArg) );
25d60 0a 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 7d 0a . return rc;.}.
25d70 0a 2f 2a 0a 2a 2a 20 46 75 6e 63 74 69 6f 6e 20 ./*.** Function
25d80 61 73 73 65 72 74 54 72 75 6e 63 61 74 65 43 6f assertTruncateCo
25d90 6e 73 74 72 61 69 6e 74 28 70 50 61 67 65 72 29 nstraint(pPager)
25da0 20 63 68 65 63 6b 73 20 74 68 61 74 20 6f 6e 65 checks that one
25db0 20 6f 66 20 74 68 65 20 0a 2a 2a 20 66 6f 6c 6c of the .** foll
25dc0 6f 77 69 6e 67 20 69 73 20 74 72 75 65 20 66 6f owing is true fo
25dd0 72 20 61 6c 6c 20 64 69 72 74 79 20 70 61 67 65 r all dirty page
25de0 73 20 63 75 72 72 65 6e 74 6c 79 20 69 6e 20 74 s currently in t
25df0 68 65 20 70 61 67 65 2d 63 61 63 68 65 3a 0a 2a he page-cache:.*
25e00 2a 0a 2a 2a 20 20 20 61 29 20 54 68 65 20 70 61 *.** a) The pa
25e10 67 65 20 6e 75 6d 62 65 72 20 69 73 20 6c 65 73 ge number is les
25e20 73 20 74 68 61 6e 20 6f 72 20 65 71 75 61 6c 20 s than or equal
25e30 74 6f 20 74 68 65 20 73 69 7a 65 20 6f 66 20 74 to the size of t
25e40 68 65 20 0a 2a 2a 20 20 20 20 20 20 63 75 72 72 he .** curr
25e50 65 6e 74 20 64 61 74 61 62 61 73 65 20 69 6d 61 ent database ima
25e60 67 65 2c 20 69 6e 20 70 61 67 65 73 2c 20 4f 52 ge, in pages, OR
25e70 0a 2a 2a 0a 2a 2a 20 20 20 62 29 20 69 66 20 74 .**.** b) if t
25e80 68 65 20 70 61 67 65 20 63 6f 6e 74 65 6e 74 20 he page content
25e90 77 65 72 65 20 77 72 69 74 74 65 6e 20 61 74 20 were written at
25ea0 74 68 69 73 20 74 69 6d 65 2c 20 69 74 20 77 6f this time, it wo
25eb0 75 6c 64 20 6e 6f 74 0a 2a 2a 20 20 20 20 20 20 uld not.**
25ec0 62 65 20 6e 65 63 65 73 73 61 72 79 20 74 6f 20 be necessary to
25ed0 77 72 69 74 65 20 74 68 65 20 63 75 72 72 65 6e write the curren
25ee0 74 20 63 6f 6e 74 65 6e 74 20 6f 75 74 20 74 6f t content out to
25ef0 20 74 68 65 20 73 75 62 2d 6a 6f 75 72 6e 61 6c the sub-journal
25f00 0a 2a 2a 20 20 20 20 20 20 28 61 73 20 64 65 74 .** (as det
25f10 65 72 6d 69 6e 65 64 20 62 79 20 66 75 6e 63 74 ermined by funct
25f20 69 6f 6e 20 73 75 62 6a 52 65 71 75 69 72 65 73 ion subjRequires
25f30 50 61 67 65 28 29 29 2e 0a 2a 2a 0a 2a 2a 20 49 Page())..**.** I
25f40 66 20 74 68 65 20 63 6f 6e 64 69 74 69 6f 6e 20 f the condition
25f50 61 73 73 65 72 74 65 64 20 62 79 20 74 68 69 73 asserted by this
25f60 20 66 75 6e 63 74 69 6f 6e 20 77 65 72 65 20 6e function were n
25f70 6f 74 20 74 72 75 65 2c 20 61 6e 64 20 74 68 65 ot true, and the
25f80 0a 2a 2a 20 64 69 72 74 79 20 70 61 67 65 20 77 .** dirty page w
25f90 65 72 65 20 74 6f 20 62 65 20 64 69 73 63 61 72 ere to be discar
25fa0 64 65 64 20 66 72 6f 6d 20 74 68 65 20 63 61 63 ded from the cac
25fb0 68 65 20 76 69 61 20 74 68 65 20 70 61 67 65 72 he via the pager
25fc0 53 74 72 65 73 73 28 29 0a 2a 2a 20 72 6f 75 74 Stress().** rout
25fd0 69 6e 65 2c 20 70 61 67 65 72 53 74 72 65 73 73 ine, pagerStress
25fe0 28 29 20 77 6f 75 6c 64 20 6e 6f 74 20 77 72 69 () would not wri
25ff0 74 65 20 74 68 65 20 63 75 72 72 65 6e 74 20 70 te the current p
26000 61 67 65 20 63 6f 6e 74 65 6e 74 20 74 6f 0a 2a age content to.*
26010 2a 20 74 68 65 20 64 61 74 61 62 61 73 65 20 66 * the database f
26020 69 6c 65 2e 20 49 66 20 61 20 73 61 76 65 70 6f ile. If a savepo
26030 69 6e 74 20 74 72 61 6e 73 61 63 74 69 6f 6e 20 int transaction
26040 77 65 72 65 20 72 6f 6c 6c 65 64 20 62 61 63 6b were rolled back
26050 20 61 66 74 65 72 0a 2a 2a 20 74 68 69 73 20 68 after.** this h
26060 61 70 70 65 6e 65 64 2c 20 74 68 65 20 63 6f 72 appened, the cor
26070 72 65 63 74 20 62 65 68 61 76 69 6f 72 20 77 6f rect behavior wo
26080 75 6c 64 20 62 65 20 74 6f 20 72 65 73 74 6f 72 uld be to restor
26090 65 20 74 68 65 20 63 75 72 72 65 6e 74 0a 2a 2a e the current.**
260a0 20 63 6f 6e 74 65 6e 74 20 6f 66 20 74 68 65 20 content of the
260b0 70 61 67 65 2e 20 48 6f 77 65 76 65 72 2c 20 73 page. However, s
260c0 69 6e 63 65 20 74 68 69 73 20 63 6f 6e 74 65 6e ince this conten
260d0 74 20 69 73 20 6e 6f 74 20 70 72 65 73 65 6e 74 t is not present
260e0 20 69 6e 20 65 69 74 68 65 72 0a 2a 2a 20 74 68 in either.** th
260f0 65 20 64 61 74 61 62 61 73 65 20 66 69 6c 65 20 e database file
26100 6f 72 20 74 68 65 20 70 6f 72 74 69 6f 6e 20 6f or the portion o
26110 66 20 74 68 65 20 72 6f 6c 6c 62 61 63 6b 20 6a f the rollback j
26120 6f 75 72 6e 61 6c 20 61 6e 64 20 0a 2a 2a 20 73 ournal and .** s
26130 75 62 2d 6a 6f 75 72 6e 61 6c 20 72 6f 6c 6c 65 ub-journal rolle
26140 64 20 62 61 63 6b 20 74 68 65 20 63 6f 6e 74 65 d back the conte
26150 6e 74 20 63 6f 75 6c 64 20 6e 6f 74 20 62 65 20 nt could not be
26160 72 65 73 74 6f 72 65 64 20 61 6e 64 20 74 68 65 restored and the
26170 0a 2a 2a 20 64 61 74 61 62 61 73 65 20 69 6d 61 .** database ima
26180 67 65 20 77 6f 75 6c 64 20 62 65 63 6f 6d 65 20 ge would become
26190 63 6f 72 72 75 70 74 2e 20 49 74 20 69 73 20 74 corrupt. It is t
261a0 68 65 72 65 66 6f 72 65 20 66 6f 72 74 75 6e 61 herefore fortuna
261b0 74 65 20 74 68 61 74 20 0a 2a 2a 20 74 68 69 73 te that .** this
261c0 20 63 69 72 63 75 6d 73 74 61 6e 63 65 20 63 61 circumstance ca
261d0 6e 6e 6f 74 20 61 72 69 73 65 2e 0a 2a 2f 0a 23 nnot arise..*/.#
261e0 69 66 20 64 65 66 69 6e 65 64 28 53 51 4c 49 54 if defined(SQLIT
261f0 45 5f 44 45 42 55 47 29 0a 73 74 61 74 69 63 20 E_DEBUG).static
26200 76 6f 69 64 20 61 73 73 65 72 74 54 72 75 6e 63 void assertTrunc
26210 61 74 65 43 6f 6e 73 74 72 61 69 6e 74 43 62 28 ateConstraintCb(
26220 50 67 48 64 72 20 2a 70 50 67 29 7b 0a 20 20 61 PgHdr *pPg){. a
26230 73 73 65 72 74 28 20 70 50 67 2d 3e 66 6c 61 67 ssert( pPg->flag
26240 73 26 50 47 48 44 52 5f 44 49 52 54 59 20 29 3b s&PGHDR_DIRTY );
26250 0a 20 20 61 73 73 65 72 74 28 20 21 73 75 62 6a . assert( !subj
26260 52 65 71 75 69 72 65 73 50 61 67 65 28 70 50 67 RequiresPage(pPg
26270 29 20 7c 7c 20 70 50 67 2d 3e 70 67 6e 6f 3c 3d ) || pPg->pgno<=
26280 70 50 67 2d 3e 70 50 61 67 65 72 2d 3e 64 62 53 pPg->pPager->dbS
26290 69 7a 65 20 29 3b 0a 7d 0a 73 74 61 74 69 63 20 ize );.}.static
262a0 76 6f 69 64 20 61 73 73 65 72 74 54 72 75 6e 63 void assertTrunc
262b0 61 74 65 43 6f 6e 73 74 72 61 69 6e 74 28 50 61 ateConstraint(Pa
262c0 67 65 72 20 2a 70 50 61 67 65 72 29 7b 0a 20 20 ger *pPager){.
262d0 73 71 6c 69 74 65 33 50 63 61 63 68 65 49 74 65 sqlite3PcacheIte
262e0 72 61 74 65 44 69 72 74 79 28 70 50 61 67 65 72 rateDirty(pPager
262f0 2d 3e 70 50 43 61 63 68 65 2c 20 61 73 73 65 72 ->pPCache, asser
26300 74 54 72 75 6e 63 61 74 65 43 6f 6e 73 74 72 61 tTruncateConstra
26310 69 6e 74 43 62 29 3b 0a 7d 0a 23 65 6c 73 65 0a intCb);.}.#else.
26320 23 20 64 65 66 69 6e 65 20 61 73 73 65 72 74 54 # define assertT
26330 72 75 6e 63 61 74 65 43 6f 6e 73 74 72 61 69 6e runcateConstrain
26340 74 28 70 50 61 67 65 72 29 0a 23 65 6e 64 69 66 t(pPager).#endif
26350 0a 0a 2f 2a 0a 2a 2a 20 54 72 75 6e 63 61 74 65 ../*.** Truncate
26360 20 74 68 65 20 69 6e 2d 6d 65 6d 6f 72 79 20 64 the in-memory d
26370 61 74 61 62 61 73 65 20 66 69 6c 65 20 69 6d 61 atabase file ima
26380 67 65 20 74 6f 20 6e 50 61 67 65 20 70 61 67 65 ge to nPage page
26390 73 2e 20 54 68 69 73 20 0a 2a 2a 20 66 75 6e 63 s. This .** func
263a0 74 69 6f 6e 20 64 6f 65 73 20 6e 6f 74 20 61 63 tion does not ac
263b0 74 75 61 6c 6c 79 20 6d 6f 64 69 66 79 20 74 68 tually modify th
263c0 65 20 64 61 74 61 62 61 73 65 20 66 69 6c 65 20 e database file
263d0 6f 6e 20 64 69 73 6b 2e 20 49 74 20 0a 2a 2a 20 on disk. It .**
263e0 6a 75 73 74 20 73 65 74 73 20 74 68 65 20 69 6e just sets the in
263f0 74 65 72 6e 61 6c 20 73 74 61 74 65 20 6f 66 20 ternal state of
26400 74 68 65 20 70 61 67 65 72 20 6f 62 6a 65 63 74 the pager object
26410 20 73 6f 20 74 68 61 74 20 74 68 65 20 0a 2a 2a so that the .**
26420 20 74 72 75 6e 63 61 74 69 6f 6e 20 77 69 6c 6c truncation will
26430 20 62 65 20 64 6f 6e 65 20 77 68 65 6e 20 74 68 be done when th
26440 65 20 63 75 72 72 65 6e 74 20 74 72 61 6e 73 61 e current transa
26450 63 74 69 6f 6e 20 69 73 20 63 6f 6d 6d 69 74 74 ction is committ
26460 65 64 2e 0a 2a 2a 0a 2a 2a 20 54 68 69 73 20 66 ed..**.** This f
26470 75 6e 63 74 69 6f 6e 20 69 73 20 6f 6e 6c 79 20 unction is only
26480 63 61 6c 6c 65 64 20 72 69 67 68 74 20 62 65 66 called right bef
26490 6f 72 65 20 63 6f 6d 6d 69 74 74 69 6e 67 20 61 ore committing a
264a0 20 74 72 61 6e 73 61 63 74 69 6f 6e 2e 0a 2a 2a transaction..**
264b0 20 4f 6e 63 65 20 74 68 69 73 20 66 75 6e 63 74 Once this funct
264c0 69 6f 6e 20 68 61 73 20 62 65 65 6e 20 63 61 6c ion has been cal
264d0 6c 65 64 2c 20 74 68 65 20 74 72 61 6e 73 61 63 led, the transac
264e0 74 69 6f 6e 20 6d 75 73 74 20 65 69 74 68 65 72 tion must either
264f0 20 62 65 0a 2a 2a 20 72 6f 6c 6c 65 64 20 62 61 be.** rolled ba
26500 63 6b 20 6f 72 20 63 6f 6d 6d 69 74 74 65 64 2e ck or committed.
26510 20 49 74 20 69 73 20 6e 6f 74 20 73 61 66 65 20 It is not safe
26520 74 6f 20 63 61 6c 6c 20 74 68 69 73 20 66 75 6e to call this fun
26530 63 74 69 6f 6e 20 61 6e 64 0a 2a 2a 20 74 68 65 ction and.** the
26540 6e 20 63 6f 6e 74 69 6e 75 65 20 77 72 69 74 69 n continue writi
26550 6e 67 20 74 6f 20 74 68 65 20 64 61 74 61 62 61 ng to the databa
26560 73 65 2e 0a 2a 2f 0a 76 6f 69 64 20 73 71 6c 69 se..*/.void sqli
26570 74 65 33 50 61 67 65 72 54 72 75 6e 63 61 74 65 te3PagerTruncate
26580 49 6d 61 67 65 28 50 61 67 65 72 20 2a 70 50 61 Image(Pager *pPa
26590 67 65 72 2c 20 50 67 6e 6f 20 6e 50 61 67 65 29 ger, Pgno nPage)
265a0 7b 0a 20 20 61 73 73 65 72 74 28 20 70 50 61 67 {. assert( pPag
265b0 65 72 2d 3e 64 62 53 69 7a 65 3e 3d 6e 50 61 67 er->dbSize>=nPag
265c0 65 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 70 e );. assert( p
265d0 50 61 67 65 72 2d 3e 65 53 74 61 74 65 3e 3d 50 Pager->eState>=P
265e0 41 47 45 52 5f 57 52 49 54 45 52 5f 43 41 43 48 AGER_WRITER_CACH
265f0 45 4d 4f 44 20 29 3b 0a 20 20 70 50 61 67 65 72 EMOD );. pPager
26600 2d 3e 64 62 53 69 7a 65 20 3d 20 6e 50 61 67 65 ->dbSize = nPage
26610 3b 0a 0a 20 20 2f 2a 20 41 74 20 6f 6e 65 20 70 ;.. /* At one p
26620 6f 69 6e 74 20 74 68 65 20 63 6f 64 65 20 68 65 oint the code he
26630 72 65 20 63 61 6c 6c 65 64 20 61 73 73 65 72 74 re called assert
26640 54 72 75 6e 63 61 74 65 43 6f 6e 73 74 72 61 69 TruncateConstrai
26650 6e 74 28 29 20 74 6f 0a 20 20 2a 2a 20 65 6e 73 nt() to. ** ens
26660 75 72 65 20 74 68 61 74 20 61 6c 6c 20 70 61 67 ure that all pag
26670 65 73 20 62 65 69 6e 67 20 74 72 75 6e 63 61 74 es being truncat
26680 65 64 20 61 77 61 79 20 62 79 20 74 68 69 73 20 ed away by this
26690 6f 70 65 72 61 74 69 6f 6e 20 61 72 65 2c 0a 20 operation are,.
266a0 20 2a 2a 20 69 66 20 6f 6e 65 20 6f 72 20 6d 6f ** if one or mo
266b0 72 65 20 73 61 76 65 70 6f 69 6e 74 73 20 61 72 re savepoints ar
266c0 65 20 6f 70 65 6e 2c 20 70 72 65 73 65 6e 74 20 e open, present
266d0 69 6e 20 74 68 65 20 73 61 76 65 70 6f 69 6e 74 in the savepoint
266e0 20 0a 20 20 2a 2a 20 6a 6f 75 72 6e 61 6c 20 73 . ** journal s
266f0 6f 20 74 68 61 74 20 74 68 65 79 20 63 61 6e 20 o that they can
26700 62 65 20 72 65 73 74 6f 72 65 64 20 69 66 20 74 be restored if t
26710 68 65 20 73 61 76 65 70 6f 69 6e 74 20 69 73 20 he savepoint is
26720 72 6f 6c 6c 65 64 0a 20 20 2a 2a 20 62 61 63 6b rolled. ** back
26730 2e 20 54 68 69 73 20 69 73 20 6e 6f 20 6c 6f 6e . This is no lon
26740 67 65 72 20 6e 65 63 65 73 73 61 72 79 20 61 73 ger necessary as
26750 20 74 68 69 73 20 66 75 6e 63 74 69 6f 6e 20 69 this function i
26760 73 20 6e 6f 77 20 6f 6e 6c 79 0a 20 20 2a 2a 20 s now only. **
26770 63 61 6c 6c 65 64 20 72 69 67 68 74 20 62 65 66 called right bef
26780 6f 72 65 20 63 6f 6d 6d 69 74 74 69 6e 67 20 61 ore committing a
26790 20 74 72 61 6e 73 61 63 74 69 6f 6e 2e 20 53 6f transaction. So
267a0 20 61 6c 74 68 6f 75 67 68 20 74 68 65 20 0a 20 although the .
267b0 20 2a 2a 20 50 61 67 65 72 20 6f 62 6a 65 63 74 ** Pager object
267c0 20 6d 61 79 20 73 74 69 6c 6c 20 68 61 76 65 20 may still have
267d0 6f 70 65 6e 20 73 61 76 65 70 6f 69 6e 74 73 20 open savepoints
267e0 28 50 61 67 65 72 2e 6e 53 61 76 65 70 6f 69 6e (Pager.nSavepoin
267f0 74 21 3d 30 29 2c 20 0a 20 20 2a 2a 20 74 68 65 t!=0), . ** the
26800 79 20 63 61 6e 6e 6f 74 20 62 65 20 72 6f 6c 6c y cannot be roll
26810 65 64 20 62 61 63 6b 2e 20 53 6f 20 74 68 65 20 ed back. So the
26820 61 73 73 65 72 74 54 72 75 6e 63 61 74 65 43 6f assertTruncateCo
26830 6e 73 74 72 61 69 6e 74 28 29 20 63 61 6c 6c 0a nstraint() call.
26840 20 20 2a 2a 20 69 73 20 6e 6f 20 6c 6f 6e 67 65 ** is no longe
26850 72 20 63 6f 72 72 65 63 74 2e 20 2a 2f 0a 7d 0a r correct. */.}.
26860 0a 0a 2f 2a 0a 2a 2a 20 54 68 69 73 20 66 75 6e ../*.** This fun
26870 63 74 69 6f 6e 20 69 73 20 63 61 6c 6c 65 64 20 ction is called
26880 62 65 66 6f 72 65 20 61 74 74 65 6d 70 74 69 6e before attemptin
26890 67 20 61 20 68 6f 74 2d 6a 6f 75 72 6e 61 6c 20 g a hot-journal
268a0 72 6f 6c 6c 62 61 63 6b 2e 20 49 74 0a 2a 2a 20 rollback. It.**
268b0 73 79 6e 63 73 20 74 68 65 20 6a 6f 75 72 6e 61 syncs the journa
268c0 6c 20 66 69 6c 65 20 74 6f 20 64 69 73 6b 2c 20 l file to disk,
268d0 74 68 65 6e 20 73 65 74 73 20 70 50 61 67 65 72 then sets pPager
268e0 2d 3e 6a 6f 75 72 6e 61 6c 48 64 72 20 74 6f 20 ->journalHdr to
268f0 74 68 65 0a 2a 2a 20 73 69 7a 65 20 6f 66 20 74 the.** size of t
26900 68 65 20 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 20 he journal file
26910 73 6f 20 74 68 61 74 20 74 68 65 20 70 61 67 65 so that the page
26920 72 5f 70 6c 61 79 62 61 63 6b 28 29 20 72 6f 75 r_playback() rou
26930 74 69 6e 65 20 6b 6e 6f 77 73 0a 2a 2a 20 74 68 tine knows.** th
26940 61 74 20 74 68 65 20 65 6e 74 69 72 65 20 6a 6f at the entire jo
26950 75 72 6e 61 6c 20 66 69 6c 65 20 68 61 73 20 62 urnal file has b
26960 65 65 6e 20 73 79 6e 63 65 64 2e 0a 2a 2a 0a 2a een synced..**.*
26970 2a 20 53 79 6e 63 69 6e 67 20 61 20 68 6f 74 2d * Syncing a hot-
26980 6a 6f 75 72 6e 61 6c 20 74 6f 20 64 69 73 6b 20 journal to disk
26990 62 65 66 6f 72 65 20 61 74 74 65 6d 70 74 69 6e before attemptin
269a0 67 20 74 6f 20 72 6f 6c 6c 20 69 74 20 62 61 63 g to roll it bac
269b0 6b 20 65 6e 73 75 72 65 73 20 0a 2a 2a 20 74 68 k ensures .** th
269c0 61 74 20 69 66 20 61 20 70 6f 77 65 72 2d 66 61 at if a power-fa
269d0 69 6c 75 72 65 20 6f 63 63 75 72 73 20 64 75 72 ilure occurs dur
269e0 69 6e 67 20 74 68 65 20 72 6f 6c 6c 62 61 63 6b ing the rollback
269f0 2c 20 74 68 65 20 70 72 6f 63 65 73 73 20 74 68 , the process th
26a00 61 74 0a 2a 2a 20 61 74 74 65 6d 70 74 73 20 72 at.** attempts r
26a10 6f 6c 6c 62 61 63 6b 20 66 6f 6c 6c 6f 77 69 6e ollback followin
26a20 67 20 73 79 73 74 65 6d 20 72 65 63 6f 76 65 72 g system recover
26a30 79 20 73 65 65 73 20 74 68 65 20 73 61 6d 65 20 y sees the same
26a40 6a 6f 75 72 6e 61 6c 0a 2a 2a 20 63 6f 6e 74 65 journal.** conte
26a50 6e 74 20 61 73 20 74 68 69 73 20 70 72 6f 63 65 nt as this proce
26a60 73 73 2e 0a 2a 2a 0a 2a 2a 20 49 66 20 65 76 65 ss..**.** If eve
26a70 72 79 74 68 69 6e 67 20 67 6f 65 73 20 61 73 20 rything goes as
26a80 70 6c 61 6e 6e 65 64 2c 20 53 51 4c 49 54 45 5f planned, SQLITE_
26a90 4f 4b 20 69 73 20 72 65 74 75 72 6e 65 64 2e 20 OK is returned.
26aa0 4f 74 68 65 72 77 69 73 65 2c 20 0a 2a 2a 20 61 Otherwise, .** a
26ab0 6e 20 53 51 4c 69 74 65 20 65 72 72 6f 72 20 63 n SQLite error c
26ac0 6f 64 65 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 69 ode..*/.static i
26ad0 6e 74 20 70 61 67 65 72 53 79 6e 63 48 6f 74 4a nt pagerSyncHotJ
26ae0 6f 75 72 6e 61 6c 28 50 61 67 65 72 20 2a 70 50 ournal(Pager *pP
26af0 61 67 65 72 29 7b 0a 20 20 69 6e 74 20 72 63 20 ager){. int rc
26b00 3d 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20 20 69 = SQLITE_OK;. i
26b10 66 28 20 21 70 50 61 67 65 72 2d 3e 6e 6f 53 79 f( !pPager->noSy
26b20 6e 63 20 29 7b 0a 20 20 20 20 72 63 20 3d 20 73 nc ){. rc = s
26b30 71 6c 69 74 65 33 4f 73 53 79 6e 63 28 70 50 61 qlite3OsSync(pPa
26b40 67 65 72 2d 3e 6a 66 64 2c 20 53 51 4c 49 54 45 ger->jfd, SQLITE
26b50 5f 53 59 4e 43 5f 4e 4f 52 4d 41 4c 29 3b 0a 20 _SYNC_NORMAL);.
26b60 20 7d 0a 20 20 69 66 28 20 72 63 3d 3d 53 51 4c }. if( rc==SQL
26b70 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 72 63 ITE_OK ){. rc
26b80 20 3d 20 73 71 6c 69 74 65 33 4f 73 46 69 6c 65 = sqlite3OsFile
26b90 53 69 7a 65 28 70 50 61 67 65 72 2d 3e 6a 66 64 Size(pPager->jfd
26ba0 2c 20 26 70 50 61 67 65 72 2d 3e 6a 6f 75 72 6e , &pPager->journ
26bb0 61 6c 48 64 72 29 3b 0a 20 20 7d 0a 20 20 72 65 alHdr);. }. re
26bc0 74 75 72 6e 20 72 63 3b 0a 7d 0a 0a 2f 2a 0a 2a turn rc;.}../*.*
26bd0 2a 20 4f 62 74 61 69 6e 20 61 20 72 65 66 65 72 * Obtain a refer
26be0 65 6e 63 65 20 74 6f 20 61 20 6d 65 6d 6f 72 79 ence to a memory
26bf0 20 6d 61 70 70 65 64 20 70 61 67 65 20 6f 62 6a mapped page obj
26c00 65 63 74 20 66 6f 72 20 70 61 67 65 20 6e 75 6d ect for page num
26c10 62 65 72 20 70 67 6e 6f 2e 20 0a 2a 2a 20 54 68 ber pgno. .** Th
26c20 65 20 6e 65 77 20 6f 62 6a 65 63 74 20 77 69 6c e new object wil
26c30 6c 20 75 73 65 20 74 68 65 20 70 6f 69 6e 74 65 l use the pointe
26c40 72 20 70 44 61 74 61 2c 20 6f 62 74 61 69 6e 65 r pData, obtaine
26c50 64 20 66 72 6f 6d 20 78 46 65 74 63 68 28 29 2e d from xFetch().
26c60 0a 2a 2a 20 49 66 20 73 75 63 63 65 73 73 66 75 .** If successfu
26c70 6c 2c 20 73 65 74 20 2a 70 70 50 61 67 65 20 74 l, set *ppPage t
26c80 6f 20 70 6f 69 6e 74 20 74 6f 20 74 68 65 20 6e o point to the n
26c90 65 77 20 70 61 67 65 20 72 65 66 65 72 65 6e 63 ew page referenc
26ca0 65 0a 2a 2a 20 61 6e 64 20 72 65 74 75 72 6e 20 e.** and return
26cb0 53 51 4c 49 54 45 5f 4f 4b 2e 20 4f 74 68 65 72 SQLITE_OK. Other
26cc0 77 69 73 65 2c 20 72 65 74 75 72 6e 20 61 6e 20 wise, return an
26cd0 53 51 4c 69 74 65 20 65 72 72 6f 72 20 63 6f 64 SQLite error cod
26ce0 65 20 61 6e 64 20 73 65 74 0a 2a 2a 20 2a 70 70 e and set.** *pp
26cf0 50 61 67 65 20 74 6f 20 7a 65 72 6f 2e 0a 2a 2a Page to zero..**
26d00 0a 2a 2a 20 50 61 67 65 20 72 65 66 65 72 65 6e .** Page referen
26d10 63 65 73 20 6f 62 74 61 69 6e 65 64 20 62 79 20 ces obtained by
26d20 63 61 6c 6c 69 6e 67 20 74 68 69 73 20 66 75 6e calling this fun
26d30 63 74 69 6f 6e 20 73 68 6f 75 6c 64 20 62 65 20 ction should be
26d40 72 65 6c 65 61 73 65 64 0a 2a 2a 20 62 79 20 63 released.** by c
26d50 61 6c 6c 69 6e 67 20 70 61 67 65 72 52 65 6c 65 alling pagerRele
26d60 61 73 65 4d 61 70 50 61 67 65 28 29 2e 0a 2a 2f aseMapPage()..*/
26d70 0a 73 74 61 74 69 63 20 69 6e 74 20 70 61 67 65 .static int page
26d80 72 41 63 71 75 69 72 65 4d 61 70 50 61 67 65 28 rAcquireMapPage(
26d90 0a 20 20 50 61 67 65 72 20 2a 70 50 61 67 65 72 . Pager *pPager
26da0 2c 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 ,
26db0 20 20 20 2f 2a 20 50 61 67 65 72 20 6f 62 6a 65 /* Pager obje
26dc0 63 74 20 2a 2f 0a 20 20 50 67 6e 6f 20 70 67 6e ct */. Pgno pgn
26dd0 6f 2c 20 20 20 20 20 20 20 20 20 20 20 20 20 20 o,
26de0 20 20 20 20 20 20 20 20 2f 2a 20 50 61 67 65 20 /* Page
26df0 6e 75 6d 62 65 72 20 2a 2f 0a 20 20 76 6f 69 64 number */. void
26e00 20 2a 70 44 61 74 61 2c 20 20 20 20 20 20 20 20 *pData,
26e10 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 78 /* x
26e20 46 65 74 63 68 28 29 27 64 20 64 61 74 61 20 66 Fetch()'d data f
26e30 6f 72 20 74 68 69 73 20 70 61 67 65 20 2a 2f 0a or this page */.
26e40 20 20 50 67 48 64 72 20 2a 2a 70 70 50 61 67 65 PgHdr **ppPage
26e50 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
26e60 20 20 2f 2a 20 4f 55 54 3a 20 41 63 71 75 69 72 /* OUT: Acquir
26e70 65 64 20 70 61 67 65 20 6f 62 6a 65 63 74 20 2a ed page object *
26e80 2f 0a 29 7b 0a 20 20 50 67 48 64 72 20 2a 70 3b /.){. PgHdr *p;
26e90 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
26ea0 20 20 20 20 20 20 20 2f 2a 20 4d 65 6d 6f 72 79 /* Memory
26eb0 20 6d 61 70 70 65 64 20 70 61 67 65 20 74 6f 20 mapped page to
26ec0 72 65 74 75 72 6e 20 2a 2f 0a 20 20 0a 20 20 69 return */. . i
26ed0 66 28 20 70 50 61 67 65 72 2d 3e 70 4d 6d 61 70 f( pPager->pMmap
26ee0 46 72 65 65 6c 69 73 74 20 29 7b 0a 20 20 20 20 Freelist ){.
26ef0 2a 70 70 50 61 67 65 20 3d 20 70 20 3d 20 70 50 *ppPage = p = pP
26f00 61 67 65 72 2d 3e 70 4d 6d 61 70 46 72 65 65 6c ager->pMmapFreel
26f10 69 73 74 3b 0a 20 20 20 20 70 50 61 67 65 72 2d ist;. pPager-
26f20 3e 70 4d 6d 61 70 46 72 65 65 6c 69 73 74 20 3d >pMmapFreelist =
26f30 20 70 2d 3e 70 44 69 72 74 79 3b 0a 20 20 20 20 p->pDirty;.
26f40 70 2d 3e 70 44 69 72 74 79 20 3d 20 30 3b 0a 20 p->pDirty = 0;.
26f50 20 20 20 6d 65 6d 73 65 74 28 70 2d 3e 70 45 78 memset(p->pEx
26f60 74 72 61 2c 20 30 2c 20 70 50 61 67 65 72 2d 3e tra, 0, pPager->
26f70 6e 45 78 74 72 61 29 3b 0a 20 20 7d 65 6c 73 65 nExtra);. }else
26f80 7b 0a 20 20 20 20 2a 70 70 50 61 67 65 20 3d 20 {. *ppPage =
26f90 70 20 3d 20 28 50 67 48 64 72 20 2a 29 73 71 6c p = (PgHdr *)sql
26fa0 69 74 65 33 4d 61 6c 6c 6f 63 5a 65 72 6f 28 73 ite3MallocZero(s
26fb0 69 7a 65 6f 66 28 50 67 48 64 72 29 20 2b 20 70 izeof(PgHdr) + p
26fc0 50 61 67 65 72 2d 3e 6e 45 78 74 72 61 29 3b 0a Pager->nExtra);.
26fd0 20 20 20 20 69 66 28 20 70 3d 3d 30 20 29 7b 0a if( p==0 ){.
26fe0 20 20 20 20 20 20 73 71 6c 69 74 65 33 4f 73 55 sqlite3OsU
26ff0 6e 66 65 74 63 68 28 70 50 61 67 65 72 2d 3e 66 nfetch(pPager->f
27000 64 2c 20 28 69 36 34 29 28 70 67 6e 6f 2d 31 29 d, (i64)(pgno-1)
27010 20 2a 20 70 50 61 67 65 72 2d 3e 70 61 67 65 53 * pPager->pageS
27020 69 7a 65 2c 20 70 44 61 74 61 29 3b 0a 20 20 20 ize, pData);.
27030 20 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 return SQLITE
27040 5f 4e 4f 4d 45 4d 5f 42 4b 50 54 3b 0a 20 20 20 _NOMEM_BKPT;.
27050 20 7d 0a 20 20 20 20 70 2d 3e 70 45 78 74 72 61 }. p->pExtra
27060 20 3d 20 28 76 6f 69 64 20 2a 29 26 70 5b 31 5d = (void *)&p[1]
27070 3b 0a 20 20 20 20 70 2d 3e 66 6c 61 67 73 20 3d ;. p->flags =
27080 20 50 47 48 44 52 5f 4d 4d 41 50 3b 0a 20 20 20 PGHDR_MMAP;.
27090 20 70 2d 3e 6e 52 65 66 20 3d 20 31 3b 0a 20 20 p->nRef = 1;.
270a0 20 20 70 2d 3e 70 50 61 67 65 72 20 3d 20 70 50 p->pPager = pP
270b0 61 67 65 72 3b 0a 20 20 7d 0a 0a 20 20 61 73 73 ager;. }.. ass
270c0 65 72 74 28 20 70 2d 3e 70 45 78 74 72 61 3d 3d ert( p->pExtra==
270d0 28 76 6f 69 64 20 2a 29 26 70 5b 31 5d 20 29 3b (void *)&p[1] );
270e0 0a 20 20 61 73 73 65 72 74 28 20 70 2d 3e 70 50 . assert( p->pP
270f0 61 67 65 3d 3d 30 20 29 3b 0a 20 20 61 73 73 65 age==0 );. asse
27100 72 74 28 20 70 2d 3e 66 6c 61 67 73 3d 3d 50 47 rt( p->flags==PG
27110 48 44 52 5f 4d 4d 41 50 20 29 3b 0a 20 20 61 73 HDR_MMAP );. as
27120 73 65 72 74 28 20 70 2d 3e 70 50 61 67 65 72 3d sert( p->pPager=
27130 3d 70 50 61 67 65 72 20 29 3b 0a 20 20 61 73 73 =pPager );. ass
27140 65 72 74 28 20 70 2d 3e 6e 52 65 66 3d 3d 31 20 ert( p->nRef==1
27150 29 3b 0a 0a 20 20 70 2d 3e 70 67 6e 6f 20 3d 20 );.. p->pgno =
27160 70 67 6e 6f 3b 0a 20 20 70 2d 3e 70 44 61 74 61 pgno;. p->pData
27170 20 3d 20 70 44 61 74 61 3b 0a 20 20 70 50 61 67 = pData;. pPag
27180 65 72 2d 3e 6e 4d 6d 61 70 4f 75 74 2b 2b 3b 0a er->nMmapOut++;.
27190 0a 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 . return SQLITE
271a0 5f 4f 4b 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 52 65 _OK;.}../*.** Re
271b0 6c 65 61 73 65 20 61 20 72 65 66 65 72 65 6e 63 lease a referenc
271c0 65 20 74 6f 20 70 61 67 65 20 70 50 67 2e 20 70 e to page pPg. p
271d0 50 67 20 6d 75 73 74 20 68 61 76 65 20 62 65 65 Pg must have bee
271e0 6e 20 72 65 74 75 72 6e 65 64 20 62 79 20 61 6e n returned by an
271f0 20 0a 2a 2a 20 65 61 72 6c 69 65 72 20 63 61 6c .** earlier cal
27200 6c 20 74 6f 20 70 61 67 65 72 41 63 71 75 69 72 l to pagerAcquir
27210 65 4d 61 70 50 61 67 65 28 29 2e 0a 2a 2f 0a 73 eMapPage()..*/.s
27220 74 61 74 69 63 20 76 6f 69 64 20 70 61 67 65 72 tatic void pager
27230 52 65 6c 65 61 73 65 4d 61 70 50 61 67 65 28 50 ReleaseMapPage(P
27240 67 48 64 72 20 2a 70 50 67 29 7b 0a 20 20 50 61 gHdr *pPg){. Pa
27250 67 65 72 20 2a 70 50 61 67 65 72 20 3d 20 70 50 ger *pPager = pP
27260 67 2d 3e 70 50 61 67 65 72 3b 0a 20 20 70 50 61 g->pPager;. pPa
27270 67 65 72 2d 3e 6e 4d 6d 61 70 4f 75 74 2d 2d 3b ger->nMmapOut--;
27280 0a 20 20 70 50 67 2d 3e 70 44 69 72 74 79 20 3d . pPg->pDirty =
27290 20 70 50 61 67 65 72 2d 3e 70 4d 6d 61 70 46 72 pPager->pMmapFr
272a0 65 65 6c 69 73 74 3b 0a 20 20 70 50 61 67 65 72 eelist;. pPager
272b0 2d 3e 70 4d 6d 61 70 46 72 65 65 6c 69 73 74 20 ->pMmapFreelist
272c0 3d 20 70 50 67 3b 0a 0a 20 20 61 73 73 65 72 74 = pPg;.. assert
272d0 28 20 70 50 61 67 65 72 2d 3e 66 64 2d 3e 70 4d ( pPager->fd->pM
272e0 65 74 68 6f 64 73 2d 3e 69 56 65 72 73 69 6f 6e ethods->iVersion
272f0 3e 3d 33 20 29 3b 0a 20 20 73 71 6c 69 74 65 33 >=3 );. sqlite3
27300 4f 73 55 6e 66 65 74 63 68 28 70 50 61 67 65 72 OsUnfetch(pPager
27310 2d 3e 66 64 2c 20 28 69 36 34 29 28 70 50 67 2d ->fd, (i64)(pPg-
27320 3e 70 67 6e 6f 2d 31 29 2a 70 50 61 67 65 72 2d >pgno-1)*pPager-
27330 3e 70 61 67 65 53 69 7a 65 2c 20 70 50 67 2d 3e >pageSize, pPg->
27340 70 44 61 74 61 29 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a pData);.}../*.**
27350 20 46 72 65 65 20 61 6c 6c 20 50 67 48 64 72 20 Free all PgHdr
27360 6f 62 6a 65 63 74 73 20 73 74 6f 72 65 64 20 69 objects stored i
27370 6e 20 74 68 65 20 50 61 67 65 72 2e 70 4d 6d 61 n the Pager.pMma
27380 70 46 72 65 65 6c 69 73 74 20 6c 69 73 74 2e 0a pFreelist list..
27390 2a 2f 0a 73 74 61 74 69 63 20 76 6f 69 64 20 70 */.static void p
273a0 61 67 65 72 46 72 65 65 4d 61 70 48 64 72 73 28 agerFreeMapHdrs(
273b0 50 61 67 65 72 20 2a 70 50 61 67 65 72 29 7b 0a Pager *pPager){.
273c0 20 20 50 67 48 64 72 20 2a 70 3b 0a 20 20 50 67 PgHdr *p;. Pg
273d0 48 64 72 20 2a 70 4e 65 78 74 3b 0a 20 20 66 6f Hdr *pNext;. fo
273e0 72 28 70 3d 70 50 61 67 65 72 2d 3e 70 4d 6d 61 r(p=pPager->pMma
273f0 70 46 72 65 65 6c 69 73 74 3b 20 70 3b 20 70 3d pFreelist; p; p=
27400 70 4e 65 78 74 29 7b 0a 20 20 20 20 70 4e 65 78 pNext){. pNex
27410 74 20 3d 20 70 2d 3e 70 44 69 72 74 79 3b 0a 20 t = p->pDirty;.
27420 20 20 20 73 71 6c 69 74 65 33 5f 66 72 65 65 28 sqlite3_free(
27430 70 29 3b 0a 20 20 7d 0a 7d 0a 0a 0a 2f 2a 0a 2a p);. }.}.../*.*
27440 2a 20 53 68 75 74 64 6f 77 6e 20 74 68 65 20 70 * Shutdown the p
27450 61 67 65 20 63 61 63 68 65 2e 20 20 46 72 65 65 age cache. Free
27460 20 61 6c 6c 20 6d 65 6d 6f 72 79 20 61 6e 64 20 all memory and
27470 63 6c 6f 73 65 20 61 6c 6c 20 66 69 6c 65 73 2e close all files.
27480 0a 2a 2a 0a 2a 2a 20 49 66 20 61 20 74 72 61 6e .**.** If a tran
27490 73 61 63 74 69 6f 6e 20 77 61 73 20 69 6e 20 70 saction was in p
274a0 72 6f 67 72 65 73 73 20 77 68 65 6e 20 74 68 69 rogress when thi
274b0 73 20 72 6f 75 74 69 6e 65 20 69 73 20 63 61 6c s routine is cal
274c0 6c 65 64 2c 20 74 68 61 74 0a 2a 2a 20 74 72 61 led, that.** tra
274d0 6e 73 61 63 74 69 6f 6e 20 69 73 20 72 6f 6c 6c nsaction is roll
274e0 65 64 20 62 61 63 6b 2e 20 20 41 6c 6c 20 6f 75 ed back. All ou
274f0 74 73 74 61 6e 64 69 6e 67 20 70 61 67 65 73 20 tstanding pages
27500 61 72 65 20 69 6e 76 61 6c 69 64 61 74 65 64 0a are invalidated.
27510 2a 2a 20 61 6e 64 20 74 68 65 69 72 20 6d 65 6d ** and their mem
27520 6f 72 79 20 69 73 20 66 72 65 65 64 2e 20 20 41 ory is freed. A
27530 6e 79 20 61 74 74 65 6d 70 74 20 74 6f 20 75 73 ny attempt to us
27540 65 20 61 20 70 61 67 65 20 61 73 73 6f 63 69 61 e a page associa
27550 74 65 64 0a 2a 2a 20 77 69 74 68 20 74 68 69 73 ted.** with this
27560 20 70 61 67 65 20 63 61 63 68 65 20 61 66 74 65 page cache afte
27570 72 20 74 68 69 73 20 66 75 6e 63 74 69 6f 6e 20 r this function
27580 72 65 74 75 72 6e 73 20 77 69 6c 6c 20 6c 69 6b returns will lik
27590 65 6c 79 0a 2a 2a 20 72 65 73 75 6c 74 20 69 6e ely.** result in
275a0 20 61 20 63 6f 72 65 64 75 6d 70 2e 0a 2a 2a 0a a coredump..**.
275b0 2a 2a 20 54 68 69 73 20 66 75 6e 63 74 69 6f 6e ** This function
275c0 20 61 6c 77 61 79 73 20 73 75 63 63 65 65 64 73 always succeeds
275d0 2e 20 49 66 20 61 20 74 72 61 6e 73 61 63 74 69 . If a transacti
275e0 6f 6e 20 69 73 20 61 63 74 69 76 65 20 61 6e 20 on is active an
275f0 61 74 74 65 6d 70 74 0a 2a 2a 20 69 73 20 6d 61 attempt.** is ma
27600 64 65 20 74 6f 20 72 6f 6c 6c 20 69 74 20 62 61 de to roll it ba
27610 63 6b 2e 20 49 66 20 61 6e 20 65 72 72 6f 72 20 ck. If an error
27620 6f 63 63 75 72 73 20 64 75 72 69 6e 67 20 74 68 occurs during th
27630 65 20 72 6f 6c 6c 62 61 63 6b 20 0a 2a 2a 20 61 e rollback .** a
27640 20 68 6f 74 20 6a 6f 75 72 6e 61 6c 20 6d 61 79 hot journal may
27650 20 62 65 20 6c 65 66 74 20 69 6e 20 74 68 65 20 be left in the
27660 66 69 6c 65 73 79 73 74 65 6d 20 62 75 74 20 6e filesystem but n
27670 6f 20 65 72 72 6f 72 20 69 73 20 72 65 74 75 72 o error is retur
27680 6e 65 64 0a 2a 2a 20 74 6f 20 74 68 65 20 63 61 ned.** to the ca
27690 6c 6c 65 72 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c ller..*/.int sql
276a0 69 74 65 33 50 61 67 65 72 43 6c 6f 73 65 28 50 ite3PagerClose(P
276b0 61 67 65 72 20 2a 70 50 61 67 65 72 29 7b 0a 20 ager *pPager){.
276c0 20 75 38 20 2a 70 54 6d 70 20 3d 20 28 75 38 20 u8 *pTmp = (u8
276d0 2a 29 70 50 61 67 65 72 2d 3e 70 54 6d 70 53 70 *)pPager->pTmpSp
276e0 61 63 65 3b 0a 0a 20 20 61 73 73 65 72 74 28 20 ace;.. assert(
276f0 61 73 73 65 72 74 5f 70 61 67 65 72 5f 73 74 61 assert_pager_sta
27700 74 65 28 70 50 61 67 65 72 29 20 29 3b 0a 20 20 te(pPager) );.
27710 64 69 73 61 62 6c 65 5f 73 69 6d 75 6c 61 74 65 disable_simulate
27720 64 5f 69 6f 5f 65 72 72 6f 72 73 28 29 3b 0a 20 d_io_errors();.
27730 20 73 71 6c 69 74 65 33 42 65 67 69 6e 42 65 6e sqlite3BeginBen
27740 69 67 6e 4d 61 6c 6c 6f 63 28 29 3b 0a 20 20 70 ignMalloc();. p
27750 61 67 65 72 46 72 65 65 4d 61 70 48 64 72 73 28 agerFreeMapHdrs(
27760 70 50 61 67 65 72 29 3b 0a 20 20 2f 2a 20 70 50 pPager);. /* pP
27770 61 67 65 72 2d 3e 65 72 72 43 6f 64 65 20 3d 20 ager->errCode =
27780 30 3b 20 2a 2f 0a 20 20 70 50 61 67 65 72 2d 3e 0; */. pPager->
27790 65 78 63 6c 75 73 69 76 65 4d 6f 64 65 20 3d 20 exclusiveMode =
277a0 30 3b 0a 23 69 66 6e 64 65 66 20 53 51 4c 49 54 0;.#ifndef SQLIT
277b0 45 5f 4f 4d 49 54 5f 57 41 4c 0a 20 20 73 71 6c E_OMIT_WAL. sql
277c0 69 74 65 33 57 61 6c 43 6c 6f 73 65 28 70 50 61 ite3WalClose(pPa
277d0 67 65 72 2d 3e 70 57 61 6c 2c 20 70 50 61 67 65 ger->pWal, pPage
277e0 72 2d 3e 63 6b 70 74 53 79 6e 63 46 6c 61 67 73 r->ckptSyncFlags
277f0 2c 20 70 50 61 67 65 72 2d 3e 70 61 67 65 53 69 , pPager->pageSi
27800 7a 65 2c 20 70 54 6d 70 29 3b 0a 20 20 70 50 61 ze, pTmp);. pPa
27810 67 65 72 2d 3e 70 57 61 6c 20 3d 20 30 3b 0a 23 ger->pWal = 0;.#
27820 65 6e 64 69 66 0a 20 20 70 61 67 65 72 5f 72 65 endif. pager_re
27830 73 65 74 28 70 50 61 67 65 72 29 3b 0a 20 20 69 set(pPager);. i
27840 66 28 20 4d 45 4d 44 42 20 29 7b 0a 20 20 20 20 f( MEMDB ){.
27850 70 61 67 65 72 5f 75 6e 6c 6f 63 6b 28 70 50 61 pager_unlock(pPa
27860 67 65 72 29 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20 ger);. }else{.
27870 20 20 20 2f 2a 20 49 66 20 69 74 20 69 73 20 6f /* If it is o
27880 70 65 6e 2c 20 73 79 6e 63 20 74 68 65 20 6a 6f pen, sync the jo
27890 75 72 6e 61 6c 20 66 69 6c 65 20 62 65 66 6f 72 urnal file befor
278a0 65 20 63 61 6c 6c 69 6e 67 20 55 6e 6c 6f 63 6b e calling Unlock
278b0 41 6e 64 52 6f 6c 6c 62 61 63 6b 2e 0a 20 20 20 AndRollback..
278c0 20 2a 2a 20 49 66 20 74 68 69 73 20 69 73 20 6e ** If this is n
278d0 6f 74 20 64 6f 6e 65 2c 20 74 68 65 6e 20 61 6e ot done, then an
278e0 20 75 6e 73 79 6e 63 65 64 20 70 6f 72 74 69 6f unsynced portio
278f0 6e 20 6f 66 20 74 68 65 20 6f 70 65 6e 20 6a 6f n of the open jo
27900 75 72 6e 61 6c 20 0a 20 20 20 20 2a 2a 20 66 69 urnal . ** fi
27910 6c 65 20 6d 61 79 20 62 65 20 70 6c 61 79 65 64 le may be played
27920 20 62 61 63 6b 20 69 6e 74 6f 20 74 68 65 20 64 back into the d
27930 61 74 61 62 61 73 65 2e 20 49 66 20 61 20 70 6f atabase. If a po
27940 77 65 72 20 66 61 69 6c 75 72 65 20 6f 63 63 75 wer failure occu
27950 72 73 20 0a 20 20 20 20 2a 2a 20 77 68 69 6c 65 rs . ** while
27960 20 74 68 69 73 20 69 73 20 68 61 70 70 65 6e 69 this is happeni
27970 6e 67 2c 20 74 68 65 20 64 61 74 61 62 61 73 65 ng, the database
27980 20 63 6f 75 6c 64 20 62 65 63 6f 6d 65 20 63 6f could become co
27990 72 72 75 70 74 2e 0a 20 20 20 20 2a 2a 0a 20 20 rrupt.. **.
279a0 20 20 2a 2a 20 49 66 20 61 6e 20 65 72 72 6f 72 ** If an error
279b0 20 6f 63 63 75 72 73 20 77 68 69 6c 65 20 74 72 occurs while tr
279c0 79 69 6e 67 20 74 6f 20 73 79 6e 63 20 74 68 65 ying to sync the
279d0 20 6a 6f 75 72 6e 61 6c 2c 20 73 68 69 66 74 20 journal, shift
279e0 74 68 65 20 70 61 67 65 72 0a 20 20 20 20 2a 2a the pager. **
279f0 20 69 6e 74 6f 20 74 68 65 20 45 52 52 4f 52 20 into the ERROR
27a00 73 74 61 74 65 2e 20 54 68 69 73 20 63 61 75 73 state. This caus
27a10 65 73 20 55 6e 6c 6f 63 6b 41 6e 64 52 6f 6c 6c es UnlockAndRoll
27a20 62 61 63 6b 20 74 6f 20 75 6e 6c 6f 63 6b 20 74 back to unlock t
27a30 68 65 0a 20 20 20 20 2a 2a 20 64 61 74 61 62 61 he. ** databa
27a40 73 65 20 61 6e 64 20 63 6c 6f 73 65 20 74 68 65 se and close the
27a50 20 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 20 77 69 journal file wi
27a60 74 68 6f 75 74 20 61 74 74 65 6d 70 74 69 6e 67 thout attempting
27a70 20 74 6f 20 72 6f 6c 6c 20 69 74 0a 20 20 20 20 to roll it.
27a80 2a 2a 20 62 61 63 6b 20 6f 72 20 66 69 6e 61 6c ** back or final
27a90 69 7a 65 20 69 74 2e 20 54 68 65 20 6e 65 78 74 ize it. The next
27aa0 20 64 61 74 61 62 61 73 65 20 75 73 65 72 20 77 database user w
27ab0 69 6c 6c 20 68 61 76 65 20 74 6f 20 64 6f 20 68 ill have to do h
27ac0 6f 74 2d 6a 6f 75 72 6e 61 6c 0a 20 20 20 20 2a ot-journal. *
27ad0 2a 20 72 6f 6c 6c 62 61 63 6b 20 62 65 66 6f 72 * rollback befor
27ae0 65 20 61 63 63 65 73 73 69 6e 67 20 74 68 65 20 e accessing the
27af0 64 61 74 61 62 61 73 65 20 66 69 6c 65 2e 0a 20 database file..
27b00 20 20 20 2a 2f 0a 20 20 20 20 69 66 28 20 69 73 */. if( is
27b10 4f 70 65 6e 28 70 50 61 67 65 72 2d 3e 6a 66 64 Open(pPager->jfd
27b20 29 20 29 7b 0a 20 20 20 20 20 20 70 61 67 65 72 ) ){. pager
27b30 5f 65 72 72 6f 72 28 70 50 61 67 65 72 2c 20 70 _error(pPager, p
27b40 61 67 65 72 53 79 6e 63 48 6f 74 4a 6f 75 72 6e agerSyncHotJourn
27b50 61 6c 28 70 50 61 67 65 72 29 29 3b 0a 20 20 20 al(pPager));.
27b60 20 7d 0a 20 20 20 20 70 61 67 65 72 55 6e 6c 6f }. pagerUnlo
27b70 63 6b 41 6e 64 52 6f 6c 6c 62 61 63 6b 28 70 50 ckAndRollback(pP
27b80 61 67 65 72 29 3b 0a 20 20 7d 0a 20 20 73 71 6c ager);. }. sql
27b90 69 74 65 33 45 6e 64 42 65 6e 69 67 6e 4d 61 6c ite3EndBenignMal
27ba0 6c 6f 63 28 29 3b 0a 20 20 65 6e 61 62 6c 65 5f loc();. enable_
27bb0 73 69 6d 75 6c 61 74 65 64 5f 69 6f 5f 65 72 72 simulated_io_err
27bc0 6f 72 73 28 29 3b 0a 20 20 50 41 47 45 52 54 52 ors();. PAGERTR
27bd0 41 43 45 28 28 22 43 4c 4f 53 45 20 25 64 5c 6e ACE(("CLOSE %d\n
27be0 22 2c 20 50 41 47 45 52 49 44 28 70 50 61 67 65 ", PAGERID(pPage
27bf0 72 29 29 29 3b 0a 20 20 49 4f 54 52 41 43 45 28 r)));. IOTRACE(
27c00 28 22 43 4c 4f 53 45 20 25 70 5c 6e 22 2c 20 70 ("CLOSE %p\n", p
27c10 50 61 67 65 72 29 29 0a 20 20 73 71 6c 69 74 65 Pager)). sqlite
27c20 33 4f 73 43 6c 6f 73 65 28 70 50 61 67 65 72 2d 3OsClose(pPager-
27c30 3e 6a 66 64 29 3b 0a 20 20 73 71 6c 69 74 65 33 >jfd);. sqlite3
27c40 4f 73 43 6c 6f 73 65 28 70 50 61 67 65 72 2d 3e OsClose(pPager->
27c50 66 64 29 3b 0a 20 20 73 71 6c 69 74 65 33 50 61 fd);. sqlite3Pa
27c60 67 65 46 72 65 65 28 70 54 6d 70 29 3b 0a 20 20 geFree(pTmp);.
27c70 73 71 6c 69 74 65 33 50 63 61 63 68 65 43 6c 6f sqlite3PcacheClo
27c80 73 65 28 70 50 61 67 65 72 2d 3e 70 50 43 61 63 se(pPager->pPCac
27c90 68 65 29 3b 0a 0a 23 69 66 64 65 66 20 53 51 4c he);..#ifdef SQL
27ca0 49 54 45 5f 48 41 53 5f 43 4f 44 45 43 0a 20 20 ITE_HAS_CODEC.
27cb0 69 66 28 20 70 50 61 67 65 72 2d 3e 78 43 6f 64 if( pPager->xCod
27cc0 65 63 46 72 65 65 20 29 20 70 50 61 67 65 72 2d ecFree ) pPager-
27cd0 3e 78 43 6f 64 65 63 46 72 65 65 28 70 50 61 67 >xCodecFree(pPag
27ce0 65 72 2d 3e 70 43 6f 64 65 63 29 3b 0a 23 65 6e er->pCodec);.#en
27cf0 64 69 66 0a 0a 20 20 61 73 73 65 72 74 28 20 21 dif.. assert( !
27d00 70 50 61 67 65 72 2d 3e 61 53 61 76 65 70 6f 69 pPager->aSavepoi
27d10 6e 74 20 26 26 20 21 70 50 61 67 65 72 2d 3e 70 nt && !pPager->p
27d20 49 6e 4a 6f 75 72 6e 61 6c 20 29 3b 0a 20 20 61 InJournal );. a
27d30 73 73 65 72 74 28 20 21 69 73 4f 70 65 6e 28 70 ssert( !isOpen(p
27d40 50 61 67 65 72 2d 3e 6a 66 64 29 20 26 26 20 21 Pager->jfd) && !
27d50 69 73 4f 70 65 6e 28 70 50 61 67 65 72 2d 3e 73 isOpen(pPager->s
27d60 6a 66 64 29 20 29 3b 0a 0a 20 20 73 71 6c 69 74 jfd) );.. sqlit
27d70 65 33 5f 66 72 65 65 28 70 50 61 67 65 72 29 3b e3_free(pPager);
27d80 0a 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 . return SQLITE
27d90 5f 4f 4b 3b 0a 7d 0a 0a 23 69 66 20 21 64 65 66 _OK;.}..#if !def
27da0 69 6e 65 64 28 4e 44 45 42 55 47 29 20 7c 7c 20 ined(NDEBUG) ||
27db0 64 65 66 69 6e 65 64 28 53 51 4c 49 54 45 5f 54 defined(SQLITE_T
27dc0 45 53 54 29 0a 2f 2a 0a 2a 2a 20 52 65 74 75 72 EST)./*.** Retur
27dd0 6e 20 74 68 65 20 70 61 67 65 20 6e 75 6d 62 65 n the page numbe
27de0 72 20 66 6f 72 20 70 61 67 65 20 70 50 67 2e 0a r for page pPg..
27df0 2a 2f 0a 50 67 6e 6f 20 73 71 6c 69 74 65 33 50 */.Pgno sqlite3P
27e00 61 67 65 72 50 61 67 65 6e 75 6d 62 65 72 28 44 agerPagenumber(D
27e10 62 50 61 67 65 20 2a 70 50 67 29 7b 0a 20 20 72 bPage *pPg){. r
27e20 65 74 75 72 6e 20 70 50 67 2d 3e 70 67 6e 6f 3b eturn pPg->pgno;
27e30 0a 7d 0a 23 65 6e 64 69 66 0a 0a 2f 2a 0a 2a 2a .}.#endif../*.**
27e40 20 49 6e 63 72 65 6d 65 6e 74 20 74 68 65 20 72 Increment the r
27e50 65 66 65 72 65 6e 63 65 20 63 6f 75 6e 74 20 66 eference count f
27e60 6f 72 20 70 61 67 65 20 70 50 67 2e 0a 2a 2f 0a or page pPg..*/.
27e70 76 6f 69 64 20 73 71 6c 69 74 65 33 50 61 67 65 void sqlite3Page
27e80 72 52 65 66 28 44 62 50 61 67 65 20 2a 70 50 67 rRef(DbPage *pPg
27e90 29 7b 0a 20 20 73 71 6c 69 74 65 33 50 63 61 63 ){. sqlite3Pcac
27ea0 68 65 52 65 66 28 70 50 67 29 3b 0a 7d 0a 0a 2f heRef(pPg);.}../
27eb0 2a 0a 2a 2a 20 53 79 6e 63 20 74 68 65 20 6a 6f *.** Sync the jo
27ec0 75 72 6e 61 6c 2e 20 49 6e 20 6f 74 68 65 72 20 urnal. In other
27ed0 77 6f 72 64 73 2c 20 6d 61 6b 65 20 73 75 72 65 words, make sure
27ee0 20 61 6c 6c 20 74 68 65 20 70 61 67 65 73 20 74 all the pages t
27ef0 68 61 74 20 68 61 76 65 0a 2a 2a 20 62 65 65 6e hat have.** been
27f00 20 77 72 69 74 74 65 6e 20 74 6f 20 74 68 65 20 written to the
27f10 6a 6f 75 72 6e 61 6c 20 68 61 76 65 20 61 63 74 journal have act
27f20 75 61 6c 6c 79 20 72 65 61 63 68 65 64 20 74 68 ually reached th
27f30 65 20 73 75 72 66 61 63 65 20 6f 66 20 74 68 65 e surface of the
27f40 0a 2a 2a 20 64 69 73 6b 20 61 6e 64 20 63 61 6e .** disk and can
27f50 20 62 65 20 72 65 73 74 6f 72 65 64 20 69 6e 20 be restored in
27f60 74 68 65 20 65 76 65 6e 74 20 6f 66 20 61 20 68 the event of a h
27f70 6f 74 2d 6a 6f 75 72 6e 61 6c 20 72 6f 6c 6c 62 ot-journal rollb
27f80 61 63 6b 2e 0a 2a 2a 0a 2a 2a 20 49 66 20 74 68 ack..**.** If th
27f90 65 20 50 61 67 65 72 2e 6e 6f 53 79 6e 63 20 66 e Pager.noSync f
27fa0 6c 61 67 20 69 73 20 73 65 74 2c 20 74 68 65 6e lag is set, then
27fb0 20 74 68 69 73 20 66 75 6e 63 74 69 6f 6e 20 69 this function i
27fc0 73 20 61 20 6e 6f 2d 6f 70 2e 0a 2a 2a 20 4f 74 s a no-op..** Ot
27fd0 68 65 72 77 69 73 65 2c 20 74 68 65 20 61 63 74 herwise, the act
27fe0 69 6f 6e 73 20 72 65 71 75 69 72 65 64 20 64 65 ions required de
27ff0 70 65 6e 64 20 6f 6e 20 74 68 65 20 6a 6f 75 72 pend on the jour
28000 6e 61 6c 2d 6d 6f 64 65 20 61 6e 64 20 74 68 65 nal-mode and the
28010 20 0a 2a 2a 20 64 65 76 69 63 65 20 63 68 61 72 .** device char
28020 61 63 74 65 72 69 73 74 69 63 73 20 6f 66 20 74 acteristics of t
28030 68 65 20 66 69 6c 65 2d 73 79 73 74 65 6d 2c 20 he file-system,
28040 61 73 20 66 6f 6c 6c 6f 77 73 3a 0a 2a 2a 0a 2a as follows:.**.*
28050 2a 20 20 20 2a 20 49 66 20 74 68 65 20 6a 6f 75 * * If the jou
28060 72 6e 61 6c 20 66 69 6c 65 20 69 73 20 61 6e 20 rnal file is an
28070 69 6e 2d 6d 65 6d 6f 72 79 20 6a 6f 75 72 6e 61 in-memory journa
28080 6c 20 66 69 6c 65 2c 20 6e 6f 20 61 63 74 69 6f l file, no actio
28090 6e 20 6e 65 65 64 0a 2a 2a 20 20 20 20 20 62 65 n need.** be
280a0 20 74 61 6b 65 6e 2e 0a 2a 2a 0a 2a 2a 20 20 20 taken..**.**
280b0 2a 20 4f 74 68 65 72 77 69 73 65 2c 20 69 66 20 * Otherwise, if
280c0 74 68 65 20 64 65 76 69 63 65 20 64 6f 65 73 20 the device does
280d0 6e 6f 74 20 73 75 70 70 6f 72 74 20 74 68 65 20 not support the
280e0 53 41 46 45 5f 41 50 50 45 4e 44 20 70 72 6f 70 SAFE_APPEND prop
280f0 65 72 74 79 2c 0a 2a 2a 20 20 20 20 20 74 68 65 erty,.** the
28100 6e 20 74 68 65 20 6e 52 65 63 20 66 69 65 6c 64 n the nRec field
28110 20 6f 66 20 74 68 65 20 6d 6f 73 74 20 72 65 63 of the most rec
28120 65 6e 74 6c 79 20 77 72 69 74 74 65 6e 20 6a 6f ently written jo
28130 75 72 6e 61 6c 20 68 65 61 64 65 72 0a 2a 2a 20 urnal header.**
28140 20 20 20 20 69 73 20 75 70 64 61 74 65 64 20 74 is updated t
28150 6f 20 63 6f 6e 74 61 69 6e 20 74 68 65 20 6e 75 o contain the nu
28160 6d 62 65 72 20 6f 66 20 6a 6f 75 72 6e 61 6c 20 mber of journal
28170 72 65 63 6f 72 64 73 20 74 68 61 74 20 68 61 76 records that hav
28180 65 0a 2a 2a 20 20 20 20 20 62 65 65 6e 20 77 72 e.** been wr
28190 69 74 74 65 6e 20 66 6f 6c 6c 6f 77 69 6e 67 20 itten following
281a0 69 74 2e 20 49 66 20 74 68 65 20 70 61 67 65 72 it. If the pager
281b0 20 69 73 20 6f 70 65 72 61 74 69 6e 67 20 69 6e is operating in
281c0 20 66 75 6c 6c 2d 73 79 6e 63 0a 2a 2a 20 20 20 full-sync.**
281d0 20 20 6d 6f 64 65 2c 20 74 68 65 6e 20 74 68 65 mode, then the
281e0 20 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 20 69 73 journal file is
281f0 20 73 79 6e 63 65 64 20 62 65 66 6f 72 65 20 74 synced before t
28200 68 69 73 20 66 69 65 6c 64 20 69 73 20 75 70 64 his field is upd
28210 61 74 65 64 2e 0a 2a 2a 0a 2a 2a 20 20 20 2a 20 ated..**.** *
28220 49 66 20 74 68 65 20 64 65 76 69 63 65 20 64 6f If the device do
28230 65 73 20 6e 6f 74 20 73 75 70 70 6f 72 74 20 74 es not support t
28240 68 65 20 53 45 51 55 45 4e 54 49 41 4c 20 70 72 he SEQUENTIAL pr
28250 6f 70 65 72 74 79 2c 20 74 68 65 6e 20 0a 2a 2a operty, then .**
28260 20 20 20 20 20 6a 6f 75 72 6e 61 6c 20 66 69 6c journal fil
28270 65 20 69 73 20 73 79 6e 63 65 64 2e 0a 2a 2a 0a e is synced..**.
28280 2a 2a 20 4f 72 2c 20 69 6e 20 70 73 65 75 64 6f ** Or, in pseudo
28290 2d 63 6f 64 65 3a 0a 2a 2a 0a 2a 2a 20 20 20 69 -code:.**.** i
282a0 66 28 20 4e 4f 54 20 3c 69 6e 2d 6d 65 6d 6f 72 f( NOT <in-memor
282b0 79 20 6a 6f 75 72 6e 61 6c 3e 20 29 7b 0a 2a 2a y journal> ){.**
282c0 20 20 20 20 20 69 66 28 20 4e 4f 54 20 53 41 46 if( NOT SAF
282d0 45 5f 41 50 50 45 4e 44 20 29 7b 0a 2a 2a 20 20 E_APPEND ){.**
282e0 20 20 20 20 20 69 66 28 20 3c 66 75 6c 6c 2d 73 if( <full-s
282f0 79 6e 63 20 6d 6f 64 65 3e 20 29 20 78 53 79 6e ync mode> ) xSyn
28300 63 28 3c 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 3e c(<journal file>
28310 29 3b 0a 2a 2a 20 20 20 20 20 20 20 3c 75 70 64 );.** <upd
28320 61 74 65 20 6e 52 65 63 20 66 69 65 6c 64 3e 0a ate nRec field>.
28330 2a 2a 20 20 20 20 20 7d 20 0a 2a 2a 20 20 20 20 ** } .**
28340 20 69 66 28 20 4e 4f 54 20 53 45 51 55 45 4e 54 if( NOT SEQUENT
28350 49 41 4c 20 29 20 78 53 79 6e 63 28 3c 6a 6f 75 IAL ) xSync(<jou
28360 72 6e 61 6c 20 66 69 6c 65 3e 29 3b 0a 2a 2a 20 rnal file>);.**
28370 20 20 7d 0a 2a 2a 0a 2a 2a 20 49 66 20 73 75 63 }.**.** If suc
28380 63 65 73 73 66 75 6c 2c 20 74 68 69 73 20 72 6f cessful, this ro
28390 75 74 69 6e 65 20 63 6c 65 61 72 73 20 74 68 65 utine clears the
283a0 20 50 47 48 44 52 5f 4e 45 45 44 5f 53 59 4e 43 PGHDR_NEED_SYNC
283b0 20 66 6c 61 67 20 6f 66 20 65 76 65 72 79 20 0a flag of every .
283c0 2a 2a 20 70 61 67 65 20 63 75 72 72 65 6e 74 6c ** page currentl
283d0 79 20 68 65 6c 64 20 69 6e 20 6d 65 6d 6f 72 79 y held in memory
283e0 20 62 65 66 6f 72 65 20 72 65 74 75 72 6e 69 6e before returnin
283f0 67 20 53 51 4c 49 54 45 5f 4f 4b 2e 20 49 66 20 g SQLITE_OK. If
28400 61 6e 20 49 4f 0a 2a 2a 20 65 72 72 6f 72 20 69 an IO.** error i
28410 73 20 65 6e 63 6f 75 6e 74 65 72 65 64 2c 20 74 s encountered, t
28420 68 65 6e 20 74 68 65 20 49 4f 20 65 72 72 6f 72 hen the IO error
28430 20 63 6f 64 65 20 69 73 20 72 65 74 75 72 6e 65 code is returne
28440 64 20 74 6f 20 74 68 65 20 63 61 6c 6c 65 72 2e d to the caller.
28450 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74 20 73 .*/.static int s
28460 79 6e 63 4a 6f 75 72 6e 61 6c 28 50 61 67 65 72 yncJournal(Pager
28470 20 2a 70 50 61 67 65 72 2c 20 69 6e 74 20 6e 65 *pPager, int ne
28480 77 48 64 72 29 7b 0a 20 20 69 6e 74 20 72 63 3b wHdr){. int rc;
28490 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
284a0 20 20 20 20 20 20 20 20 20 2f 2a 20 52 65 74 75 /* Retu
284b0 72 6e 20 63 6f 64 65 20 2a 2f 0a 0a 20 20 61 73 rn code */.. as
284c0 73 65 72 74 28 20 70 50 61 67 65 72 2d 3e 65 53 sert( pPager->eS
284d0 74 61 74 65 3d 3d 50 41 47 45 52 5f 57 52 49 54 tate==PAGER_WRIT
284e0 45 52 5f 43 41 43 48 45 4d 4f 44 0a 20 20 20 20 ER_CACHEMOD.
284f0 20 20 20 7c 7c 20 70 50 61 67 65 72 2d 3e 65 53 || pPager->eS
28500 74 61 74 65 3d 3d 50 41 47 45 52 5f 57 52 49 54 tate==PAGER_WRIT
28510 45 52 5f 44 42 4d 4f 44 0a 20 20 29 3b 0a 20 20 ER_DBMOD. );.
28520 61 73 73 65 72 74 28 20 61 73 73 65 72 74 5f 70 assert( assert_p
28530 61 67 65 72 5f 73 74 61 74 65 28 70 50 61 67 65 ager_state(pPage
28540 72 29 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 r) );. assert(
28550 21 70 61 67 65 72 55 73 65 57 61 6c 28 70 50 61 !pagerUseWal(pPa
28560 67 65 72 29 20 29 3b 0a 0a 20 20 72 63 20 3d 20 ger) );.. rc =
28570 73 71 6c 69 74 65 33 50 61 67 65 72 45 78 63 6c sqlite3PagerExcl
28580 75 73 69 76 65 4c 6f 63 6b 28 70 50 61 67 65 72 usiveLock(pPager
28590 29 3b 0a 20 20 69 66 28 20 72 63 21 3d 53 51 4c );. if( rc!=SQL
285a0 49 54 45 5f 4f 4b 20 29 20 72 65 74 75 72 6e 20 ITE_OK ) return
285b0 72 63 3b 0a 0a 20 20 69 66 28 20 21 70 50 61 67 rc;.. if( !pPag
285c0 65 72 2d 3e 6e 6f 53 79 6e 63 20 29 7b 0a 20 20 er->noSync ){.
285d0 20 20 61 73 73 65 72 74 28 20 21 70 50 61 67 65 assert( !pPage
285e0 72 2d 3e 74 65 6d 70 46 69 6c 65 20 29 3b 0a 20 r->tempFile );.
285f0 20 20 20 69 66 28 20 69 73 4f 70 65 6e 28 70 50 if( isOpen(pP
28600 61 67 65 72 2d 3e 6a 66 64 29 20 26 26 20 70 50 ager->jfd) && pP
28610 61 67 65 72 2d 3e 6a 6f 75 72 6e 61 6c 4d 6f 64 ager->journalMod
28620 65 21 3d 50 41 47 45 52 5f 4a 4f 55 52 4e 41 4c e!=PAGER_JOURNAL
28630 4d 4f 44 45 5f 4d 45 4d 4f 52 59 20 29 7b 0a 20 MODE_MEMORY ){.
28640 20 20 20 20 20 63 6f 6e 73 74 20 69 6e 74 20 69 const int i
28650 44 63 20 3d 20 73 71 6c 69 74 65 33 4f 73 44 65 Dc = sqlite3OsDe
28660 76 69 63 65 43 68 61 72 61 63 74 65 72 69 73 74 viceCharacterist
28670 69 63 73 28 70 50 61 67 65 72 2d 3e 66 64 29 3b ics(pPager->fd);
28680 0a 20 20 20 20 20 20 61 73 73 65 72 74 28 20 69 . assert( i
28690 73 4f 70 65 6e 28 70 50 61 67 65 72 2d 3e 6a 66 sOpen(pPager->jf
286a0 64 29 20 29 3b 0a 0a 20 20 20 20 20 20 69 66 28 d) );.. if(
286b0 20 30 3d 3d 28 69 44 63 26 53 51 4c 49 54 45 5f 0==(iDc&SQLITE_
286c0 49 4f 43 41 50 5f 53 41 46 45 5f 41 50 50 45 4e IOCAP_SAFE_APPEN
286d0 44 29 20 29 7b 0a 20 20 20 20 20 20 20 20 2f 2a D) ){. /*
286e0 20 54 68 69 73 20 62 6c 6f 63 6b 20 64 65 61 6c This block deal
286f0 73 20 77 69 74 68 20 61 6e 20 6f 62 73 63 75 72 s with an obscur
28700 65 20 70 72 6f 62 6c 65 6d 2e 20 49 66 20 74 68 e problem. If th
28710 65 20 6c 61 73 74 20 63 6f 6e 6e 65 63 74 69 6f e last connectio
28720 6e 0a 20 20 20 20 20 20 20 20 2a 2a 20 74 68 61 n. ** tha
28730 74 20 77 72 6f 74 65 20 74 6f 20 74 68 69 73 20 t wrote to this
28740 64 61 74 61 62 61 73 65 20 77 61 73 20 6f 70 65 database was ope
28750 72 61 74 69 6e 67 20 69 6e 20 70 65 72 73 69 73 rating in persis
28760 74 65 6e 74 2d 6a 6f 75 72 6e 61 6c 0a 20 20 20 tent-journal.
28770 20 20 20 20 20 2a 2a 20 6d 6f 64 65 2c 20 74 68 ** mode, th
28780 65 6e 20 74 68 65 20 6a 6f 75 72 6e 61 6c 20 66 en the journal f
28790 69 6c 65 20 6d 61 79 20 61 74 20 74 68 69 73 20 ile may at this
287a0 70 6f 69 6e 74 20 61 63 74 75 61 6c 6c 79 20 62 point actually b
287b0 65 20 6c 61 72 67 65 72 0a 20 20 20 20 20 20 20 e larger.
287c0 20 2a 2a 20 74 68 61 6e 20 50 61 67 65 72 2e 6a ** than Pager.j
287d0 6f 75 72 6e 61 6c 4f 66 66 20 62 79 74 65 73 2e ournalOff bytes.
287e0 20 49 66 20 74 68 65 20 6e 65 78 74 20 74 68 69 If the next thi
287f0 6e 67 20 69 6e 20 74 68 65 20 6a 6f 75 72 6e 61 ng in the journa
28800 6c 0a 20 20 20 20 20 20 20 20 2a 2a 20 66 69 6c l. ** fil
28810 65 20 68 61 70 70 65 6e 73 20 74 6f 20 62 65 20 e happens to be
28820 61 20 6a 6f 75 72 6e 61 6c 2d 68 65 61 64 65 72 a journal-header
28830 20 28 77 72 69 74 74 65 6e 20 61 73 20 70 61 72 (written as par
28840 74 20 6f 66 20 74 68 65 0a 20 20 20 20 20 20 20 t of the.
28850 20 2a 2a 20 70 72 65 76 69 6f 75 73 20 63 6f 6e ** previous con
28860 6e 65 63 74 69 6f 6e 27 73 20 74 72 61 6e 73 61 nection's transa
28870 63 74 69 6f 6e 29 2c 20 61 6e 64 20 61 20 63 72 ction), and a cr
28880 61 73 68 20 6f 72 20 70 6f 77 65 72 2d 66 61 69 ash or power-fai
28890 6c 75 72 65 20 0a 20 20 20 20 20 20 20 20 2a 2a lure . **
288a0 20 6f 63 63 75 72 73 20 61 66 74 65 72 20 6e 52 occurs after nR
288b0 65 63 20 69 73 20 75 70 64 61 74 65 64 20 62 75 ec is updated bu
288c0 74 20 62 65 66 6f 72 65 20 74 68 69 73 20 63 6f t before this co
288d0 6e 6e 65 63 74 69 6f 6e 20 77 72 69 74 65 73 20 nnection writes
288e0 0a 20 20 20 20 20 20 20 20 2a 2a 20 61 6e 79 74 . ** anyt
288f0 68 69 6e 67 20 65 6c 73 65 20 74 6f 20 74 68 65 hing else to the
28900 20 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 20 28 6f journal file (o
28910 72 20 63 6f 6d 6d 69 74 73 2f 72 6f 6c 6c 73 20 r commits/rolls
28920 62 61 63 6b 20 69 74 73 20 0a 20 20 20 20 20 20 back its .
28930 20 20 2a 2a 20 74 72 61 6e 73 61 63 74 69 6f 6e ** transaction
28940 29 2c 20 74 68 65 6e 20 53 51 4c 69 74 65 20 6d ), then SQLite m
28950 61 79 20 62 65 63 6f 6d 65 20 63 6f 6e 66 75 73 ay become confus
28960 65 64 20 77 68 65 6e 20 64 6f 69 6e 67 20 74 68 ed when doing th
28970 65 20 0a 20 20 20 20 20 20 20 20 2a 2a 20 68 6f e . ** ho
28980 74 2d 6a 6f 75 72 6e 61 6c 20 72 6f 6c 6c 62 61 t-journal rollba
28990 63 6b 20 66 6f 6c 6c 6f 77 69 6e 67 20 72 65 63 ck following rec
289a0 6f 76 65 72 79 2e 20 49 74 20 6d 61 79 20 72 6f overy. It may ro
289b0 6c 6c 20 62 61 63 6b 20 61 6c 6c 0a 20 20 20 20 ll back all.
289c0 20 20 20 20 2a 2a 20 6f 66 20 74 68 69 73 20 63 ** of this c
289d0 6f 6e 6e 65 63 74 69 6f 6e 73 20 64 61 74 61 2c onnections data,
289e0 20 74 68 65 6e 20 70 72 6f 63 65 65 64 20 74 6f then proceed to
289f0 20 72 6f 6c 6c 69 6e 67 20 62 61 63 6b 20 74 68 rolling back th
28a00 65 20 6f 6c 64 2c 0a 20 20 20 20 20 20 20 20 2a e old,. *
28a10 2a 20 6f 75 74 2d 6f 66 2d 64 61 74 65 20 64 61 * out-of-date da
28a20 74 61 20 74 68 61 74 20 66 6f 6c 6c 6f 77 73 20 ta that follows
28a30 69 74 2e 20 44 61 74 61 62 61 73 65 20 63 6f 72 it. Database cor
28a40 72 75 70 74 69 6f 6e 2e 0a 20 20 20 20 20 20 20 ruption..
28a50 20 2a 2a 0a 20 20 20 20 20 20 20 20 2a 2a 20 54 **. ** T
28a60 6f 20 77 6f 72 6b 20 61 72 6f 75 6e 64 20 74 68 o work around th
28a70 69 73 2c 20 69 66 20 74 68 65 20 6a 6f 75 72 6e is, if the journ
28a80 61 6c 20 66 69 6c 65 20 64 6f 65 73 20 61 70 70 al file does app
28a90 65 61 72 20 74 6f 20 63 6f 6e 74 61 69 6e 0a 20 ear to contain.
28aa0 20 20 20 20 20 20 20 2a 2a 20 61 20 76 61 6c 69 ** a vali
28ab0 64 20 68 65 61 64 65 72 20 66 6f 6c 6c 6f 77 69 d header followi
28ac0 6e 67 20 50 61 67 65 72 2e 6a 6f 75 72 6e 61 6c ng Pager.journal
28ad0 4f 66 66 2c 20 74 68 65 6e 20 77 72 69 74 65 20 Off, then write
28ae0 61 20 30 78 30 30 0a 20 20 20 20 20 20 20 20 2a a 0x00. *
28af0 2a 20 62 79 74 65 20 74 6f 20 74 68 65 20 73 74 * byte to the st
28b00 61 72 74 20 6f 66 20 69 74 20 74 6f 20 70 72 65 art of it to pre
28b10 76 65 6e 74 20 69 74 20 66 72 6f 6d 20 62 65 69 vent it from bei
28b20 6e 67 20 72 65 63 6f 67 6e 69 7a 65 64 2e 0a 20 ng recognized..
28b30 20 20 20 20 20 20 20 2a 2a 0a 20 20 20 20 20 20 **.
28b40 20 20 2a 2a 20 56 61 72 69 61 62 6c 65 20 69 4e ** Variable iN
28b50 65 78 74 48 64 72 4f 66 66 73 65 74 20 69 73 20 extHdrOffset is
28b60 73 65 74 20 74 6f 20 74 68 65 20 6f 66 66 73 65 set to the offse
28b70 74 20 61 74 20 77 68 69 63 68 20 74 68 69 73 0a t at which this.
28b80 20 20 20 20 20 20 20 20 2a 2a 20 70 72 6f 62 6c ** probl
28b90 65 6d 61 74 69 63 20 68 65 61 64 65 72 20 77 69 ematic header wi
28ba0 6c 6c 20 6f 63 63 75 72 2c 20 69 66 20 69 74 20 ll occur, if it
28bb0 65 78 69 73 74 73 2e 20 61 4d 61 67 69 63 20 69 exists. aMagic i
28bc0 73 20 75 73 65 64 20 0a 20 20 20 20 20 20 20 20 s used .
28bd0 2a 2a 20 61 73 20 61 20 74 65 6d 70 6f 72 61 72 ** as a temporar
28be0 79 20 62 75 66 66 65 72 20 74 6f 20 69 6e 73 70 y buffer to insp
28bf0 65 63 74 20 74 68 65 20 66 69 72 73 74 20 63 6f ect the first co
28c00 75 70 6c 65 20 6f 66 20 62 79 74 65 73 20 6f 66 uple of bytes of
28c10 0a 20 20 20 20 20 20 20 20 2a 2a 20 74 68 65 20 . ** the
28c20 70 6f 74 65 6e 74 69 61 6c 20 6a 6f 75 72 6e 61 potential journa
28c30 6c 20 68 65 61 64 65 72 2e 0a 20 20 20 20 20 20 l header..
28c40 20 20 2a 2f 0a 20 20 20 20 20 20 20 20 69 36 34 */. i64
28c50 20 69 4e 65 78 74 48 64 72 4f 66 66 73 65 74 3b iNextHdrOffset;
28c60 0a 20 20 20 20 20 20 20 20 75 38 20 61 4d 61 67 . u8 aMag
28c70 69 63 5b 38 5d 3b 0a 20 20 20 20 20 20 20 20 75 ic[8];. u
28c80 38 20 7a 48 65 61 64 65 72 5b 73 69 7a 65 6f 66 8 zHeader[sizeof
28c90 28 61 4a 6f 75 72 6e 61 6c 4d 61 67 69 63 29 2b (aJournalMagic)+
28ca0 34 5d 3b 0a 0a 20 20 20 20 20 20 20 20 6d 65 6d 4];.. mem
28cb0 63 70 79 28 7a 48 65 61 64 65 72 2c 20 61 4a 6f cpy(zHeader, aJo
28cc0 75 72 6e 61 6c 4d 61 67 69 63 2c 20 73 69 7a 65 urnalMagic, size
28cd0 6f 66 28 61 4a 6f 75 72 6e 61 6c 4d 61 67 69 63 of(aJournalMagic
28ce0 29 29 3b 0a 20 20 20 20 20 20 20 20 70 75 74 33 ));. put3
28cf0 32 62 69 74 73 28 26 7a 48 65 61 64 65 72 5b 73 2bits(&zHeader[s
28d00 69 7a 65 6f 66 28 61 4a 6f 75 72 6e 61 6c 4d 61 izeof(aJournalMa
28d10 67 69 63 29 5d 2c 20 70 50 61 67 65 72 2d 3e 6e gic)], pPager->n
28d20 52 65 63 29 3b 0a 0a 20 20 20 20 20 20 20 20 69 Rec);.. i
28d30 4e 65 78 74 48 64 72 4f 66 66 73 65 74 20 3d 20 NextHdrOffset =
28d40 6a 6f 75 72 6e 61 6c 48 64 72 4f 66 66 73 65 74 journalHdrOffset
28d50 28 70 50 61 67 65 72 29 3b 0a 20 20 20 20 20 20 (pPager);.
28d60 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33 4f 73 rc = sqlite3Os
28d70 52 65 61 64 28 70 50 61 67 65 72 2d 3e 6a 66 64 Read(pPager->jfd
28d80 2c 20 61 4d 61 67 69 63 2c 20 38 2c 20 69 4e 65 , aMagic, 8, iNe
28d90 78 74 48 64 72 4f 66 66 73 65 74 29 3b 0a 20 20 xtHdrOffset);.
28da0 20 20 20 20 20 20 69 66 28 20 72 63 3d 3d 53 51 if( rc==SQ
28db0 4c 49 54 45 5f 4f 4b 20 26 26 20 30 3d 3d 6d 65 LITE_OK && 0==me
28dc0 6d 63 6d 70 28 61 4d 61 67 69 63 2c 20 61 4a 6f mcmp(aMagic, aJo
28dd0 75 72 6e 61 6c 4d 61 67 69 63 2c 20 38 29 20 29 urnalMagic, 8) )
28de0 7b 0a 20 20 20 20 20 20 20 20 20 20 73 74 61 74 {. stat
28df0 69 63 20 63 6f 6e 73 74 20 75 38 20 7a 65 72 6f ic const u8 zero
28e00 62 79 74 65 20 3d 20 30 3b 0a 20 20 20 20 20 20 byte = 0;.
28e10 20 20 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33 rc = sqlite3
28e20 4f 73 57 72 69 74 65 28 70 50 61 67 65 72 2d 3e OsWrite(pPager->
28e30 6a 66 64 2c 20 26 7a 65 72 6f 62 79 74 65 2c 20 jfd, &zerobyte,
28e40 31 2c 20 69 4e 65 78 74 48 64 72 4f 66 66 73 65 1, iNextHdrOffse
28e50 74 29 3b 0a 20 20 20 20 20 20 20 20 7d 0a 20 20 t);. }.
28e60 20 20 20 20 20 20 69 66 28 20 72 63 21 3d 53 51 if( rc!=SQ
28e70 4c 49 54 45 5f 4f 4b 20 26 26 20 72 63 21 3d 53 LITE_OK && rc!=S
28e80 51 4c 49 54 45 5f 49 4f 45 52 52 5f 53 48 4f 52 QLITE_IOERR_SHOR
28e90 54 5f 52 45 41 44 20 29 7b 0a 20 20 20 20 20 20 T_READ ){.
28ea0 20 20 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 20 return rc;.
28eb0 20 20 20 20 20 20 20 7d 0a 0a 20 20 20 20 20 20 }..
28ec0 20 20 2f 2a 20 57 72 69 74 65 20 74 68 65 20 6e /* Write the n
28ed0 52 65 63 20 76 61 6c 75 65 20 69 6e 74 6f 20 74 Rec value into t
28ee0 68 65 20 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 20 he journal file
28ef0 68 65 61 64 65 72 2e 20 49 66 20 69 6e 0a 20 20 header. If in.
28f00 20 20 20 20 20 20 2a 2a 20 66 75 6c 6c 2d 73 79 ** full-sy
28f10 6e 63 68 72 6f 6e 6f 75 73 20 6d 6f 64 65 2c 20 nchronous mode,
28f20 73 79 6e 63 20 74 68 65 20 6a 6f 75 72 6e 61 6c sync the journal
28f30 20 66 69 72 73 74 2e 20 54 68 69 73 20 65 6e 73 first. This ens
28f40 75 72 65 73 20 74 68 61 74 0a 20 20 20 20 20 20 ures that.
28f50 20 20 2a 2a 20 61 6c 6c 20 64 61 74 61 20 68 61 ** all data ha
28f60 73 20 72 65 61 6c 6c 79 20 68 69 74 20 74 68 65 s really hit the
28f70 20 64 69 73 6b 20 62 65 66 6f 72 65 20 6e 52 65 disk before nRe
28f80 63 20 69 73 20 75 70 64 61 74 65 64 20 74 6f 20 c is updated to
28f90 6d 61 72 6b 0a 20 20 20 20 20 20 20 20 2a 2a 20 mark. **
28fa0 69 74 20 61 73 20 61 20 63 61 6e 64 69 64 61 74 it as a candidat
28fb0 65 20 66 6f 72 20 72 6f 6c 6c 62 61 63 6b 2e 0a e for rollback..
28fc0 20 20 20 20 20 20 20 20 2a 2a 0a 20 20 20 20 20 **.
28fd0 20 20 20 2a 2a 20 54 68 69 73 20 69 73 20 6e 6f ** This is no
28fe0 74 20 72 65 71 75 69 72 65 64 20 69 66 20 74 68 t required if th
28ff0 65 20 70 65 72 73 69 73 74 65 6e 74 20 6d 65 64 e persistent med
29000 69 61 20 73 75 70 70 6f 72 74 73 20 74 68 65 0a ia supports the.
29010 20 20 20 20 20 20 20 20 2a 2a 20 53 41 46 45 5f ** SAFE_
29020 41 50 50 45 4e 44 20 70 72 6f 70 65 72 74 79 2e APPEND property.
29030 20 42 65 63 61 75 73 65 20 69 6e 20 74 68 69 73 Because in this
29040 20 63 61 73 65 20 69 74 20 69 73 20 6e 6f 74 20 case it is not
29050 70 6f 73 73 69 62 6c 65 20 0a 20 20 20 20 20 20 possible .
29060 20 20 2a 2a 20 66 6f 72 20 67 61 72 62 61 67 65 ** for garbage
29070 20 64 61 74 61 20 74 6f 20 62 65 20 61 70 70 65 data to be appe
29080 6e 64 65 64 20 74 6f 20 74 68 65 20 66 69 6c 65 nded to the file
29090 2c 20 74 68 65 20 6e 52 65 63 20 66 69 65 6c 64 , the nRec field
290a0 0a 20 20 20 20 20 20 20 20 2a 2a 20 69 73 20 70 . ** is p
290b0 6f 70 75 6c 61 74 65 64 20 77 69 74 68 20 30 78 opulated with 0x
290c0 46 46 46 46 46 46 46 46 20 77 68 65 6e 20 74 68 FFFFFFFF when th
290d0 65 20 6a 6f 75 72 6e 61 6c 20 68 65 61 64 65 72 e journal header
290e0 20 69 73 20 77 72 69 74 74 65 6e 0a 20 20 20 20 is written.
290f0 20 20 20 20 2a 2a 20 61 6e 64 20 6e 65 76 65 72 ** and never
29100 20 6e 65 65 64 73 20 74 6f 20 62 65 20 75 70 64 needs to be upd
29110 61 74 65 64 2e 0a 20 20 20 20 20 20 20 20 2a 2f ated.. */
29120 0a 20 20 20 20 20 20 20 20 69 66 28 20 70 50 61 . if( pPa
29130 67 65 72 2d 3e 66 75 6c 6c 53 79 6e 63 20 26 26 ger->fullSync &&
29140 20 30 3d 3d 28 69 44 63 26 53 51 4c 49 54 45 5f 0==(iDc&SQLITE_
29150 49 4f 43 41 50 5f 53 45 51 55 45 4e 54 49 41 4c IOCAP_SEQUENTIAL
29160 29 20 29 7b 0a 20 20 20 20 20 20 20 20 20 20 50 ) ){. P
29170 41 47 45 52 54 52 41 43 45 28 28 22 53 59 4e 43 AGERTRACE(("SYNC
29180 20 6a 6f 75 72 6e 61 6c 20 6f 66 20 25 64 5c 6e journal of %d\n
29190 22 2c 20 50 41 47 45 52 49 44 28 70 50 61 67 65 ", PAGERID(pPage
291a0 72 29 29 29 3b 0a 20 20 20 20 20 20 20 20 20 20 r)));.
291b0 49 4f 54 52 41 43 45 28 28 22 4a 53 59 4e 43 20 IOTRACE(("JSYNC
291c0 25 70 5c 6e 22 2c 20 70 50 61 67 65 72 29 29 0a %p\n", pPager)).
291d0 20 20 20 20 20 20 20 20 20 20 72 63 20 3d 20 73 rc = s
291e0 71 6c 69 74 65 33 4f 73 53 79 6e 63 28 70 50 61 qlite3OsSync(pPa
291f0 67 65 72 2d 3e 6a 66 64 2c 20 70 50 61 67 65 72 ger->jfd, pPager
29200 2d 3e 73 79 6e 63 46 6c 61 67 73 29 3b 0a 20 20 ->syncFlags);.
29210 20 20 20 20 20 20 20 20 69 66 28 20 72 63 21 3d if( rc!=
29220 53 51 4c 49 54 45 5f 4f 4b 20 29 20 72 65 74 75 SQLITE_OK ) retu
29230 72 6e 20 72 63 3b 0a 20 20 20 20 20 20 20 20 7d rn rc;. }
29240 0a 20 20 20 20 20 20 20 20 49 4f 54 52 41 43 45 . IOTRACE
29250 28 28 22 4a 48 44 52 20 25 70 20 25 6c 6c 64 5c (("JHDR %p %lld\
29260 6e 22 2c 20 70 50 61 67 65 72 2c 20 70 50 61 67 n", pPager, pPag
29270 65 72 2d 3e 6a 6f 75 72 6e 61 6c 48 64 72 29 29 er->journalHdr))
29280 3b 0a 20 20 20 20 20 20 20 20 72 63 20 3d 20 73 ;. rc = s
29290 71 6c 69 74 65 33 4f 73 57 72 69 74 65 28 0a 20 qlite3OsWrite(.
292a0 20 20 20 20 20 20 20 20 20 20 20 70 50 61 67 65 pPage
292b0 72 2d 3e 6a 66 64 2c 20 7a 48 65 61 64 65 72 2c r->jfd, zHeader,
292c0 20 73 69 7a 65 6f 66 28 7a 48 65 61 64 65 72 29 sizeof(zHeader)
292d0 2c 20 70 50 61 67 65 72 2d 3e 6a 6f 75 72 6e 61 , pPager->journa
292e0 6c 48 64 72 0a 20 20 20 20 20 20 20 20 29 3b 0a lHdr. );.
292f0 20 20 20 20 20 20 20 20 69 66 28 20 72 63 21 3d if( rc!=
29300 53 51 4c 49 54 45 5f 4f 4b 20 29 20 72 65 74 75 SQLITE_OK ) retu
29310 72 6e 20 72 63 3b 0a 20 20 20 20 20 20 7d 0a 20 rn rc;. }.
29320 20 20 20 20 20 69 66 28 20 30 3d 3d 28 69 44 63 if( 0==(iDc
29330 26 53 51 4c 49 54 45 5f 49 4f 43 41 50 5f 53 45 &SQLITE_IOCAP_SE
29340 51 55 45 4e 54 49 41 4c 29 20 29 7b 0a 20 20 20 QUENTIAL) ){.
29350 20 20 20 20 20 50 41 47 45 52 54 52 41 43 45 28 PAGERTRACE(
29360 28 22 53 59 4e 43 20 6a 6f 75 72 6e 61 6c 20 6f ("SYNC journal o
29370 66 20 25 64 5c 6e 22 2c 20 50 41 47 45 52 49 44 f %d\n", PAGERID
29380 28 70 50 61 67 65 72 29 29 29 3b 0a 20 20 20 20 (pPager)));.
29390 20 20 20 20 49 4f 54 52 41 43 45 28 28 22 4a 53 IOTRACE(("JS
293a0 59 4e 43 20 25 70 5c 6e 22 2c 20 70 50 61 67 65 YNC %p\n", pPage
293b0 72 29 29 0a 20 20 20 20 20 20 20 20 72 63 20 3d r)). rc =
293c0 20 73 71 6c 69 74 65 33 4f 73 53 79 6e 63 28 70 sqlite3OsSync(p
293d0 50 61 67 65 72 2d 3e 6a 66 64 2c 20 70 50 61 67 Pager->jfd, pPag
293e0 65 72 2d 3e 73 79 6e 63 46 6c 61 67 73 7c 20 0a er->syncFlags| .
293f0 20 20 20 20 20 20 20 20 20 20 28 70 50 61 67 65 (pPage
29400 72 2d 3e 73 79 6e 63 46 6c 61 67 73 3d 3d 53 51 r->syncFlags==SQ
29410 4c 49 54 45 5f 53 59 4e 43 5f 46 55 4c 4c 3f 53 LITE_SYNC_FULL?S
29420 51 4c 49 54 45 5f 53 59 4e 43 5f 44 41 54 41 4f QLITE_SYNC_DATAO
29430 4e 4c 59 3a 30 29 0a 20 20 20 20 20 20 20 20 29 NLY:0). )
29440 3b 0a 20 20 20 20 20 20 20 20 69 66 28 20 72 63 ;. if( rc
29450 21 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 20 72 65 !=SQLITE_OK ) re
29460 74 75 72 6e 20 72 63 3b 0a 20 20 20 20 20 20 7d turn rc;. }
29470 0a 0a 20 20 20 20 20 20 70 50 61 67 65 72 2d 3e .. pPager->
29480 6a 6f 75 72 6e 61 6c 48 64 72 20 3d 20 70 50 61 journalHdr = pPa
29490 67 65 72 2d 3e 6a 6f 75 72 6e 61 6c 4f 66 66 3b ger->journalOff;
294a0 0a 20 20 20 20 20 20 69 66 28 20 6e 65 77 48 64 . if( newHd
294b0 72 20 26 26 20 30 3d 3d 28 69 44 63 26 53 51 4c r && 0==(iDc&SQL
294c0 49 54 45 5f 49 4f 43 41 50 5f 53 41 46 45 5f 41 ITE_IOCAP_SAFE_A
294d0 50 50 45 4e 44 29 20 29 7b 0a 20 20 20 20 20 20 PPEND) ){.
294e0 20 20 70 50 61 67 65 72 2d 3e 6e 52 65 63 20 3d pPager->nRec =
294f0 20 30 3b 0a 20 20 20 20 20 20 20 20 72 63 20 3d 0;. rc =
29500 20 77 72 69 74 65 4a 6f 75 72 6e 61 6c 48 64 72 writeJournalHdr
29510 28 70 50 61 67 65 72 29 3b 0a 20 20 20 20 20 20 (pPager);.
29520 20 20 69 66 28 20 72 63 21 3d 53 51 4c 49 54 45 if( rc!=SQLITE
29530 5f 4f 4b 20 29 20 72 65 74 75 72 6e 20 72 63 3b _OK ) return rc;
29540 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 7d 65 6c . }. }el
29550 73 65 7b 0a 20 20 20 20 20 20 70 50 61 67 65 72 se{. pPager
29560 2d 3e 6a 6f 75 72 6e 61 6c 48 64 72 20 3d 20 70 ->journalHdr = p
29570 50 61 67 65 72 2d 3e 6a 6f 75 72 6e 61 6c 4f 66 Pager->journalOf
29580 66 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a 0a 20 20 f;. }. }..
29590 2f 2a 20 55 6e 6c 65 73 73 20 74 68 65 20 70 61 /* Unless the pa
295a0 67 65 72 20 69 73 20 69 6e 20 6e 6f 53 79 6e 63 ger is in noSync
295b0 20 6d 6f 64 65 2c 20 74 68 65 20 6a 6f 75 72 6e mode, the journ
295c0 61 6c 20 66 69 6c 65 20 77 61 73 20 6a 75 73 74 al file was just
295d0 20 0a 20 20 2a 2a 20 73 75 63 63 65 73 73 66 75 . ** successfu
295e0 6c 6c 79 20 73 79 6e 63 65 64 2e 20 45 69 74 68 lly synced. Eith
295f0 65 72 20 77 61 79 2c 20 63 6c 65 61 72 20 74 68 er way, clear th
29600 65 20 50 47 48 44 52 5f 4e 45 45 44 5f 53 59 4e e PGHDR_NEED_SYN
29610 43 20 66 6c 61 67 20 6f 6e 20 0a 20 20 2a 2a 20 C flag on . **
29620 61 6c 6c 20 70 61 67 65 73 2e 0a 20 20 2a 2f 0a all pages.. */.
29630 20 20 73 71 6c 69 74 65 33 50 63 61 63 68 65 43 sqlite3PcacheC
29640 6c 65 61 72 53 79 6e 63 46 6c 61 67 73 28 70 50 learSyncFlags(pP
29650 61 67 65 72 2d 3e 70 50 43 61 63 68 65 29 3b 0a ager->pPCache);.
29660 20 20 70 50 61 67 65 72 2d 3e 65 53 74 61 74 65 pPager->eState
29670 20 3d 20 50 41 47 45 52 5f 57 52 49 54 45 52 5f = PAGER_WRITER_
29680 44 42 4d 4f 44 3b 0a 20 20 61 73 73 65 72 74 28 DBMOD;. assert(
29690 20 61 73 73 65 72 74 5f 70 61 67 65 72 5f 73 74 assert_pager_st
296a0 61 74 65 28 70 50 61 67 65 72 29 20 29 3b 0a 20 ate(pPager) );.
296b0 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f return SQLITE_O
296c0 4b 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 54 68 65 20 K;.}../*.** The
296d0 61 72 67 75 6d 65 6e 74 20 69 73 20 74 68 65 20 argument is the
296e0 66 69 72 73 74 20 69 6e 20 61 20 6c 69 6e 6b 65 first in a linke
296f0 64 20 6c 69 73 74 20 6f 66 20 64 69 72 74 79 20 d list of dirty
29700 70 61 67 65 73 20 63 6f 6e 6e 65 63 74 65 64 0a pages connected.
29710 2a 2a 20 62 79 20 74 68 65 20 50 67 48 64 72 2e ** by the PgHdr.
29720 70 44 69 72 74 79 20 70 6f 69 6e 74 65 72 2e 20 pDirty pointer.
29730 54 68 69 73 20 66 75 6e 63 74 69 6f 6e 20 77 72 This function wr
29740 69 74 65 73 20 65 61 63 68 20 6f 6e 65 20 6f 66 ites each one of
29750 20 74 68 65 0a 2a 2a 20 69 6e 2d 6d 65 6d 6f 72 the.** in-memor
29760 79 20 70 61 67 65 73 20 69 6e 20 74 68 65 20 6c y pages in the l
29770 69 73 74 20 74 6f 20 74 68 65 20 64 61 74 61 62 ist to the datab
29780 61 73 65 20 66 69 6c 65 2e 20 54 68 65 20 61 72 ase file. The ar
29790 67 75 6d 65 6e 74 20 6d 61 79 0a 2a 2a 20 62 65 gument may.** be
297a0 20 4e 55 4c 4c 2c 20 72 65 70 72 65 73 65 6e 74 NULL, represent
297b0 69 6e 67 20 61 6e 20 65 6d 70 74 79 20 6c 69 73 ing an empty lis
297c0 74 2e 20 49 6e 20 74 68 69 73 20 63 61 73 65 20 t. In this case
297d0 74 68 69 73 20 66 75 6e 63 74 69 6f 6e 20 69 73 this function is
297e0 0a 2a 2a 20 61 20 6e 6f 2d 6f 70 2e 0a 2a 2a 0a .** a no-op..**.
297f0 2a 2a 20 54 68 65 20 70 61 67 65 72 20 6d 75 73 ** The pager mus
29800 74 20 68 6f 6c 64 20 61 74 20 6c 65 61 73 74 20 t hold at least
29810 61 20 52 45 53 45 52 56 45 44 20 6c 6f 63 6b 20 a RESERVED lock
29820 77 68 65 6e 20 74 68 69 73 20 66 75 6e 63 74 69 when this functi
29830 6f 6e 0a 2a 2a 20 69 73 20 63 61 6c 6c 65 64 2e on.** is called.
29840 20 42 65 66 6f 72 65 20 77 72 69 74 69 6e 67 20 Before writing
29850 61 6e 79 74 68 69 6e 67 20 74 6f 20 74 68 65 20 anything to the
29860 64 61 74 61 62 61 73 65 20 66 69 6c 65 2c 20 74 database file, t
29870 68 69 73 20 6c 6f 63 6b 0a 2a 2a 20 69 73 20 75 his lock.** is u
29880 70 67 72 61 64 65 64 20 74 6f 20 61 6e 20 45 58 pgraded to an EX
29890 43 4c 55 53 49 56 45 20 6c 6f 63 6b 2e 20 49 66 CLUSIVE lock. If
298a0 20 74 68 65 20 6c 6f 63 6b 20 63 61 6e 6e 6f 74 the lock cannot
298b0 20 62 65 20 6f 62 74 61 69 6e 65 64 2c 0a 2a 2a be obtained,.**
298c0 20 53 51 4c 49 54 45 5f 42 55 53 59 20 69 73 20 SQLITE_BUSY is
298d0 72 65 74 75 72 6e 65 64 20 61 6e 64 20 6e 6f 20 returned and no
298e0 64 61 74 61 20 69 73 20 77 72 69 74 74 65 6e 20 data is written
298f0 74 6f 20 74 68 65 20 64 61 74 61 62 61 73 65 20 to the database
29900 66 69 6c 65 2e 0a 2a 2a 20 0a 2a 2a 20 49 66 20 file..** .** If
29910 74 68 65 20 70 61 67 65 72 20 69 73 20 61 20 74 the pager is a t
29920 65 6d 70 2d 66 69 6c 65 20 70 61 67 65 72 20 61 emp-file pager a
29930 6e 64 20 74 68 65 20 61 63 74 75 61 6c 20 66 69 nd the actual fi
29940 6c 65 2d 73 79 73 74 65 6d 20 66 69 6c 65 0a 2a le-system file.*
29950 2a 20 69 73 20 6e 6f 74 20 79 65 74 20 6f 70 65 * is not yet ope
29960 6e 2c 20 69 74 20 69 73 20 63 72 65 61 74 65 64 n, it is created
29970 20 61 6e 64 20 6f 70 65 6e 65 64 20 62 65 66 6f and opened befo
29980 72 65 20 61 6e 79 20 64 61 74 61 20 69 73 20 0a re any data is .
29990 2a 2a 20 77 72 69 74 74 65 6e 20 6f 75 74 2e 0a ** written out..
299a0 2a 2a 0a 2a 2a 20 4f 6e 63 65 20 74 68 65 20 6c **.** Once the l
299b0 6f 63 6b 20 68 61 73 20 62 65 65 6e 20 75 70 67 ock has been upg
299c0 72 61 64 65 64 20 61 6e 64 2c 20 69 66 20 6e 65 raded and, if ne
299d0 63 65 73 73 61 72 79 2c 20 74 68 65 20 66 69 6c cessary, the fil
299e0 65 20 6f 70 65 6e 65 64 2c 0a 2a 2a 20 74 68 65 e opened,.** the
299f0 20 70 61 67 65 73 20 61 72 65 20 77 72 69 74 74 pages are writt
29a00 65 6e 20 6f 75 74 20 74 6f 20 74 68 65 20 64 61 en out to the da
29a10 74 61 62 61 73 65 20 66 69 6c 65 20 69 6e 20 6c tabase file in l
29a20 69 73 74 20 6f 72 64 65 72 2e 20 57 72 69 74 69 ist order. Writi
29a30 6e 67 0a 2a 2a 20 61 20 70 61 67 65 20 69 73 20 ng.** a page is
29a40 73 6b 69 70 70 65 64 20 69 66 20 69 74 20 6d 65 skipped if it me
29a50 65 74 73 20 65 69 74 68 65 72 20 6f 66 20 74 68 ets either of th
29a60 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 63 72 69 74 e following crit
29a70 65 72 69 61 3a 0a 2a 2a 0a 2a 2a 20 20 20 2a 20 eria:.**.** *
29a80 54 68 65 20 70 61 67 65 20 6e 75 6d 62 65 72 20 The page number
29a90 69 73 20 67 72 65 61 74 65 72 20 74 68 61 6e 20 is greater than
29aa0 50 61 67 65 72 2e 64 62 53 69 7a 65 2c 20 6f 72 Pager.dbSize, or
29ab0 0a 2a 2a 20 20 20 2a 20 54 68 65 20 50 47 48 44 .** * The PGHD
29ac0 52 5f 44 4f 4e 54 5f 57 52 49 54 45 20 66 6c 61 R_DONT_WRITE fla
29ad0 67 20 69 73 20 73 65 74 20 6f 6e 20 74 68 65 20 g is set on the
29ae0 70 61 67 65 2e 0a 2a 2a 0a 2a 2a 20 49 66 20 77 page..**.** If w
29af0 72 69 74 69 6e 67 20 6f 75 74 20 61 20 70 61 67 riting out a pag
29b00 65 20 63 61 75 73 65 73 20 74 68 65 20 64 61 74 e causes the dat
29b10 61 62 61 73 65 20 66 69 6c 65 20 74 6f 20 67 72 abase file to gr
29b20 6f 77 2c 20 50 61 67 65 72 2e 64 62 46 69 6c 65 ow, Pager.dbFile
29b30 53 69 7a 65 0a 2a 2a 20 69 73 20 75 70 64 61 74 Size.** is updat
29b40 65 64 20 61 63 63 6f 72 64 69 6e 67 6c 79 2e 20 ed accordingly.
29b50 49 66 20 70 61 67 65 20 31 20 69 73 20 77 72 69 If page 1 is wri
29b60 74 74 65 6e 20 6f 75 74 2c 20 74 68 65 6e 20 74 tten out, then t
29b70 68 65 20 76 61 6c 75 65 20 63 61 63 68 65 64 0a he value cached.
29b80 2a 2a 20 69 6e 20 50 61 67 65 72 2e 64 62 46 69 ** in Pager.dbFi
29b90 6c 65 56 65 72 73 5b 5d 20 69 73 20 75 70 64 61 leVers[] is upda
29ba0 74 65 64 20 74 6f 20 6d 61 74 63 68 20 74 68 65 ted to match the
29bb0 20 6e 65 77 20 76 61 6c 75 65 20 73 74 6f 72 65 new value store
29bc0 64 20 69 6e 0a 2a 2a 20 74 68 65 20 64 61 74 61 d in.** the data
29bd0 62 61 73 65 20 66 69 6c 65 2e 0a 2a 2a 0a 2a 2a base file..**.**
29be0 20 49 66 20 65 76 65 72 79 74 68 69 6e 67 20 69 If everything i
29bf0 73 20 73 75 63 63 65 73 73 66 75 6c 2c 20 53 51 s successful, SQ
29c00 4c 49 54 45 5f 4f 4b 20 69 73 20 72 65 74 75 72 LITE_OK is retur
29c10 6e 65 64 2e 20 49 66 20 61 6e 20 49 4f 20 65 72 ned. If an IO er
29c20 72 6f 72 20 0a 2a 2a 20 6f 63 63 75 72 73 2c 20 ror .** occurs,
29c30 61 6e 20 49 4f 20 65 72 72 6f 72 20 63 6f 64 65 an IO error code
29c40 20 69 73 20 72 65 74 75 72 6e 65 64 2e 20 4f 72 is returned. Or
29c50 2c 20 69 66 20 74 68 65 20 45 58 43 4c 55 53 49 , if the EXCLUSI
29c60 56 45 20 6c 6f 63 6b 20 63 61 6e 6e 6f 74 0a 2a VE lock cannot.*
29c70 2a 20 62 65 20 6f 62 74 61 69 6e 65 64 2c 20 53 * be obtained, S
29c80 51 4c 49 54 45 5f 42 55 53 59 20 69 73 20 72 65 QLITE_BUSY is re
29c90 74 75 72 6e 65 64 2e 0a 2a 2f 0a 73 74 61 74 69 turned..*/.stati
29ca0 63 20 69 6e 74 20 70 61 67 65 72 5f 77 72 69 74 c int pager_writ
29cb0 65 5f 70 61 67 65 6c 69 73 74 28 50 61 67 65 72 e_pagelist(Pager
29cc0 20 2a 70 50 61 67 65 72 2c 20 50 67 48 64 72 20 *pPager, PgHdr
29cd0 2a 70 4c 69 73 74 29 7b 0a 20 20 69 6e 74 20 72 *pList){. int r
29ce0 63 20 3d 20 53 51 4c 49 54 45 5f 4f 4b 3b 20 20 c = SQLITE_OK;
29cf0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
29d00 2f 2a 20 52 65 74 75 72 6e 20 63 6f 64 65 20 2a /* Return code *
29d10 2f 0a 0a 20 20 2f 2a 20 54 68 69 73 20 66 75 6e /.. /* This fun
29d20 63 74 69 6f 6e 20 69 73 20 6f 6e 6c 79 20 63 61 ction is only ca
29d30 6c 6c 65 64 20 66 6f 72 20 72 6f 6c 6c 62 61 63 lled for rollbac
29d40 6b 20 70 61 67 65 72 73 20 69 6e 20 57 52 49 54 k pagers in WRIT
29d50 45 52 5f 44 42 4d 4f 44 20 73 74 61 74 65 2e 20 ER_DBMOD state.
29d60 2a 2f 0a 20 20 61 73 73 65 72 74 28 20 21 70 61 */. assert( !pa
29d70 67 65 72 55 73 65 57 61 6c 28 70 50 61 67 65 72 gerUseWal(pPager
29d80 29 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 70 ) );. assert( p
29d90 50 61 67 65 72 2d 3e 74 65 6d 70 46 69 6c 65 20 Pager->tempFile
29da0 7c 7c 20 70 50 61 67 65 72 2d 3e 65 53 74 61 74 || pPager->eStat
29db0 65 3d 3d 50 41 47 45 52 5f 57 52 49 54 45 52 5f e==PAGER_WRITER_
29dc0 44 42 4d 4f 44 20 29 3b 0a 20 20 61 73 73 65 72 DBMOD );. asser
29dd0 74 28 20 70 50 61 67 65 72 2d 3e 65 4c 6f 63 6b t( pPager->eLock
29de0 3d 3d 45 58 43 4c 55 53 49 56 45 5f 4c 4f 43 4b ==EXCLUSIVE_LOCK
29df0 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 69 73 );. assert( is
29e00 4f 70 65 6e 28 70 50 61 67 65 72 2d 3e 66 64 29 Open(pPager->fd)
29e10 20 7c 7c 20 70 4c 69 73 74 2d 3e 70 44 69 72 74 || pList->pDirt
29e20 79 3d 3d 30 20 29 3b 0a 0a 20 20 2f 2a 20 49 66 y==0 );.. /* If
29e30 20 74 68 65 20 66 69 6c 65 20 69 73 20 61 20 74 the file is a t
29e40 65 6d 70 2d 66 69 6c 65 20 68 61 73 20 6e 6f 74 emp-file has not
29e50 20 79 65 74 20 62 65 65 6e 20 6f 70 65 6e 65 64 yet been opened
29e60 2c 20 6f 70 65 6e 20 69 74 20 6e 6f 77 2e 20 49 , open it now. I
29e70 74 0a 20 20 2a 2a 20 69 73 20 6e 6f 74 20 70 6f t. ** is not po
29e80 73 73 69 62 6c 65 20 66 6f 72 20 72 63 20 74 6f ssible for rc to
29e90 20 62 65 20 6f 74 68 65 72 20 74 68 61 6e 20 53 be other than S
29ea0 51 4c 49 54 45 5f 4f 4b 20 69 66 20 74 68 69 73 QLITE_OK if this
29eb0 20 62 72 61 6e 63 68 0a 20 20 2a 2a 20 69 73 20 branch. ** is
29ec0 74 61 6b 65 6e 2c 20 61 73 20 70 61 67 65 72 5f taken, as pager_
29ed0 77 61 69 74 5f 6f 6e 5f 6c 6f 63 6b 28 29 20 69 wait_on_lock() i
29ee0 73 20 61 20 6e 6f 2d 6f 70 20 66 6f 72 20 74 65 s a no-op for te
29ef0 6d 70 2d 66 69 6c 65 73 2e 0a 20 20 2a 2f 0a 20 mp-files.. */.
29f00 20 69 66 28 20 21 69 73 4f 70 65 6e 28 70 50 61 if( !isOpen(pPa
29f10 67 65 72 2d 3e 66 64 29 20 29 7b 0a 20 20 20 20 ger->fd) ){.
29f20 61 73 73 65 72 74 28 20 70 50 61 67 65 72 2d 3e assert( pPager->
29f30 74 65 6d 70 46 69 6c 65 20 26 26 20 72 63 3d 3d tempFile && rc==
29f40 53 51 4c 49 54 45 5f 4f 4b 20 29 3b 0a 20 20 20 SQLITE_OK );.
29f50 20 72 63 20 3d 20 70 61 67 65 72 4f 70 65 6e 74 rc = pagerOpent
29f60 65 6d 70 28 70 50 61 67 65 72 2c 20 70 50 61 67 emp(pPager, pPag
29f70 65 72 2d 3e 66 64 2c 20 70 50 61 67 65 72 2d 3e er->fd, pPager->
29f80 76 66 73 46 6c 61 67 73 29 3b 0a 20 20 7d 0a 0a vfsFlags);. }..
29f90 20 20 2f 2a 20 42 65 66 6f 72 65 20 74 68 65 20 /* Before the
29fa0 66 69 72 73 74 20 77 72 69 74 65 2c 20 67 69 76 first write, giv
29fb0 65 20 74 68 65 20 56 46 53 20 61 20 68 69 6e 74 e the VFS a hint
29fc0 20 6f 66 20 77 68 61 74 20 74 68 65 20 66 69 6e of what the fin
29fd0 61 6c 0a 20 20 2a 2a 20 66 69 6c 65 20 73 69 7a al. ** file siz
29fe0 65 20 77 69 6c 6c 20 62 65 2e 0a 20 20 2a 2f 0a e will be.. */.
29ff0 20 20 61 73 73 65 72 74 28 20 72 63 21 3d 53 51 assert( rc!=SQ
2a000 4c 49 54 45 5f 4f 4b 20 7c 7c 20 69 73 4f 70 65 LITE_OK || isOpe
2a010 6e 28 70 50 61 67 65 72 2d 3e 66 64 29 20 29 3b n(pPager->fd) );
2a020 0a 20 20 69 66 28 20 72 63 3d 3d 53 51 4c 49 54 . if( rc==SQLIT
2a030 45 5f 4f 4b 20 0a 20 20 20 26 26 20 70 50 61 67 E_OK . && pPag
2a040 65 72 2d 3e 64 62 48 69 6e 74 53 69 7a 65 3c 70 er->dbHintSize<p
2a050 50 61 67 65 72 2d 3e 64 62 53 69 7a 65 0a 20 20 Pager->dbSize.
2a060 20 26 26 20 28 70 4c 69 73 74 2d 3e 70 44 69 72 && (pList->pDir
2a070 74 79 20 7c 7c 20 70 4c 69 73 74 2d 3e 70 67 6e ty || pList->pgn
2a080 6f 3e 70 50 61 67 65 72 2d 3e 64 62 48 69 6e 74 o>pPager->dbHint
2a090 53 69 7a 65 29 0a 20 20 29 7b 0a 20 20 20 20 73 Size). ){. s
2a0a0 71 6c 69 74 65 33 5f 69 6e 74 36 34 20 73 7a 46 qlite3_int64 szF
2a0b0 69 6c 65 20 3d 20 70 50 61 67 65 72 2d 3e 70 61 ile = pPager->pa
2a0c0 67 65 53 69 7a 65 20 2a 20 28 73 71 6c 69 74 65 geSize * (sqlite
2a0d0 33 5f 69 6e 74 36 34 29 70 50 61 67 65 72 2d 3e 3_int64)pPager->
2a0e0 64 62 53 69 7a 65 3b 0a 20 20 20 20 73 71 6c 69 dbSize;. sqli
2a0f0 74 65 33 4f 73 46 69 6c 65 43 6f 6e 74 72 6f 6c te3OsFileControl
2a100 48 69 6e 74 28 70 50 61 67 65 72 2d 3e 66 64 2c Hint(pPager->fd,
2a110 20 53 51 4c 49 54 45 5f 46 43 4e 54 4c 5f 53 49 SQLITE_FCNTL_SI
2a120 5a 45 5f 48 49 4e 54 2c 20 26 73 7a 46 69 6c 65 ZE_HINT, &szFile
2a130 29 3b 0a 20 20 20 20 70 50 61 67 65 72 2d 3e 64 );. pPager->d
2a140 62 48 69 6e 74 53 69 7a 65 20 3d 20 70 50 61 67 bHintSize = pPag
2a150 65 72 2d 3e 64 62 53 69 7a 65 3b 0a 20 20 7d 0a er->dbSize;. }.
2a160 0a 20 20 77 68 69 6c 65 28 20 72 63 3d 3d 53 51 . while( rc==SQ
2a170 4c 49 54 45 5f 4f 4b 20 26 26 20 70 4c 69 73 74 LITE_OK && pList
2a180 20 29 7b 0a 20 20 20 20 50 67 6e 6f 20 70 67 6e ){. Pgno pgn
2a190 6f 20 3d 20 70 4c 69 73 74 2d 3e 70 67 6e 6f 3b o = pList->pgno;
2a1a0 0a 0a 20 20 20 20 2f 2a 20 49 66 20 74 68 65 72 .. /* If ther
2a1b0 65 20 61 72 65 20 64 69 72 74 79 20 70 61 67 65 e are dirty page
2a1c0 73 20 69 6e 20 74 68 65 20 70 61 67 65 20 63 61 s in the page ca
2a1d0 63 68 65 20 77 69 74 68 20 70 61 67 65 20 6e 75 che with page nu
2a1e0 6d 62 65 72 73 20 67 72 65 61 74 65 72 0a 20 20 mbers greater.
2a1f0 20 20 2a 2a 20 74 68 61 6e 20 50 61 67 65 72 2e ** than Pager.
2a200 64 62 53 69 7a 65 2c 20 74 68 69 73 20 6d 65 61 dbSize, this mea
2a210 6e 73 20 73 71 6c 69 74 65 33 50 61 67 65 72 54 ns sqlite3PagerT
2a220 72 75 6e 63 61 74 65 49 6d 61 67 65 28 29 20 77 runcateImage() w
2a230 61 73 20 63 61 6c 6c 65 64 20 74 6f 0a 20 20 20 as called to.
2a240 20 2a 2a 20 6d 61 6b 65 20 74 68 65 20 66 69 6c ** make the fil
2a250 65 20 73 6d 61 6c 6c 65 72 20 28 70 72 65 73 75 e smaller (presu
2a260 6d 61 62 6c 79 20 62 79 20 61 75 74 6f 2d 76 61 mably by auto-va
2a270 63 75 75 6d 20 63 6f 64 65 29 2e 20 44 6f 20 6e cuum code). Do n
2a280 6f 74 20 77 72 69 74 65 0a 20 20 20 20 2a 2a 20 ot write. **
2a290 61 6e 79 20 73 75 63 68 20 70 61 67 65 73 20 74 any such pages t
2a2a0 6f 20 74 68 65 20 66 69 6c 65 2e 0a 20 20 20 20 o the file..
2a2b0 2a 2a 0a 20 20 20 20 2a 2a 20 41 6c 73 6f 2c 20 **. ** Also,
2a2c0 64 6f 20 6e 6f 74 20 77 72 69 74 65 20 6f 75 74 do not write out
2a2d0 20 61 6e 79 20 70 61 67 65 20 74 68 61 74 20 68 any page that h
2a2e0 61 73 20 74 68 65 20 50 47 48 44 52 5f 44 4f 4e as the PGHDR_DON
2a2f0 54 5f 57 52 49 54 45 20 66 6c 61 67 0a 20 20 20 T_WRITE flag.
2a300 20 2a 2a 20 73 65 74 20 28 73 65 74 20 62 79 20 ** set (set by
2a310 73 71 6c 69 74 65 33 50 61 67 65 72 44 6f 6e 74 sqlite3PagerDont
2a320 57 72 69 74 65 28 29 29 2e 0a 20 20 20 20 2a 2f Write()).. */
2a330 0a 20 20 20 20 69 66 28 20 70 67 6e 6f 3c 3d 70 . if( pgno<=p
2a340 50 61 67 65 72 2d 3e 64 62 53 69 7a 65 20 26 26 Pager->dbSize &&
2a350 20 30 3d 3d 28 70 4c 69 73 74 2d 3e 66 6c 61 67 0==(pList->flag
2a360 73 26 50 47 48 44 52 5f 44 4f 4e 54 5f 57 52 49 s&PGHDR_DONT_WRI
2a370 54 45 29 20 29 7b 0a 20 20 20 20 20 20 69 36 34 TE) ){. i64
2a380 20 6f 66 66 73 65 74 20 3d 20 28 70 67 6e 6f 2d offset = (pgno-
2a390 31 29 2a 28 69 36 34 29 70 50 61 67 65 72 2d 3e 1)*(i64)pPager->
2a3a0 70 61 67 65 53 69 7a 65 3b 20 20 20 2f 2a 20 4f pageSize; /* O
2a3b0 66 66 73 65 74 20 74 6f 20 77 72 69 74 65 20 2a ffset to write *
2a3c0 2f 0a 20 20 20 20 20 20 63 68 61 72 20 2a 70 44 /. char *pD
2a3d0 61 74 61 3b 20 20 20 20 20 20 20 20 20 20 20 20 ata;
2a3e0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
2a3f0 20 20 20 20 20 20 20 2f 2a 20 44 61 74 61 20 74 /* Data t
2a400 6f 20 77 72 69 74 65 20 2a 2f 20 20 20 20 0a 0a o write */ ..
2a410 20 20 20 20 20 20 61 73 73 65 72 74 28 20 28 70 assert( (p
2a420 4c 69 73 74 2d 3e 66 6c 61 67 73 26 50 47 48 44 List->flags&PGHD
2a430 52 5f 4e 45 45 44 5f 53 59 4e 43 29 3d 3d 30 20 R_NEED_SYNC)==0
2a440 29 3b 0a 20 20 20 20 20 20 69 66 28 20 70 4c 69 );. if( pLi
2a450 73 74 2d 3e 70 67 6e 6f 3d 3d 31 20 29 20 70 61 st->pgno==1 ) pa
2a460 67 65 72 5f 77 72 69 74 65 5f 63 68 61 6e 67 65 ger_write_change
2a470 63 6f 75 6e 74 65 72 28 70 4c 69 73 74 29 3b 0a counter(pList);.
2a480 0a 20 20 20 20 20 20 2f 2a 20 45 6e 63 6f 64 65 . /* Encode
2a490 20 74 68 65 20 64 61 74 61 62 61 73 65 20 2a 2f the database */
2a4a0 0a 20 20 20 20 20 20 43 4f 44 45 43 32 28 70 50 . CODEC2(pP
2a4b0 61 67 65 72 2c 20 70 4c 69 73 74 2d 3e 70 44 61 ager, pList->pDa
2a4c0 74 61 2c 20 70 67 6e 6f 2c 20 36 2c 20 72 65 74 ta, pgno, 6, ret
2a4d0 75 72 6e 20 53 51 4c 49 54 45 5f 4e 4f 4d 45 4d urn SQLITE_NOMEM
2a4e0 5f 42 4b 50 54 2c 20 70 44 61 74 61 29 3b 0a 0a _BKPT, pData);..
2a4f0 20 20 20 20 20 20 2f 2a 20 57 72 69 74 65 20 6f /* Write o
2a500 75 74 20 74 68 65 20 70 61 67 65 20 64 61 74 61 ut the page data
2a510 2e 20 2a 2f 0a 20 20 20 20 20 20 72 63 20 3d 20 . */. rc =
2a520 73 71 6c 69 74 65 33 4f 73 57 72 69 74 65 28 70 sqlite3OsWrite(p
2a530 50 61 67 65 72 2d 3e 66 64 2c 20 70 44 61 74 61 Pager->fd, pData
2a540 2c 20 70 50 61 67 65 72 2d 3e 70 61 67 65 53 69 , pPager->pageSi
2a550 7a 65 2c 20 6f 66 66 73 65 74 29 3b 0a 0a 20 20 ze, offset);..
2a560 20 20 20 20 2f 2a 20 49 66 20 70 61 67 65 20 31 /* If page 1
2a570 20 77 61 73 20 6a 75 73 74 20 77 72 69 74 74 65 was just writte
2a580 6e 2c 20 75 70 64 61 74 65 20 50 61 67 65 72 2e n, update Pager.
2a590 64 62 46 69 6c 65 56 65 72 73 20 74 6f 20 6d 61 dbFileVers to ma
2a5a0 74 63 68 0a 20 20 20 20 20 20 2a 2a 20 74 68 65 tch. ** the
2a5b0 20 76 61 6c 75 65 20 6e 6f 77 20 73 74 6f 72 65 value now store
2a5c0 64 20 69 6e 20 74 68 65 20 64 61 74 61 62 61 73 d in the databas
2a5d0 65 20 66 69 6c 65 2e 20 49 66 20 77 72 69 74 69 e file. If writi
2a5e0 6e 67 20 74 68 69 73 20 0a 20 20 20 20 20 20 2a ng this . *
2a5f0 2a 20 70 61 67 65 20 63 61 75 73 65 64 20 74 68 * page caused th
2a600 65 20 64 61 74 61 62 61 73 65 20 66 69 6c 65 20 e database file
2a610 74 6f 20 67 72 6f 77 2c 20 75 70 64 61 74 65 20 to grow, update
2a620 64 62 46 69 6c 65 53 69 7a 65 2e 20 0a 20 20 20 dbFileSize. .
2a630 20 20 20 2a 2f 0a 20 20 20 20 20 20 69 66 28 20 */. if(
2a640 70 67 6e 6f 3d 3d 31 20 29 7b 0a 20 20 20 20 20 pgno==1 ){.
2a650 20 20 20 6d 65 6d 63 70 79 28 26 70 50 61 67 65 memcpy(&pPage
2a660 72 2d 3e 64 62 46 69 6c 65 56 65 72 73 2c 20 26 r->dbFileVers, &
2a670 70 44 61 74 61 5b 32 34 5d 2c 20 73 69 7a 65 6f pData[24], sizeo
2a680 66 28 70 50 61 67 65 72 2d 3e 64 62 46 69 6c 65 f(pPager->dbFile
2a690 56 65 72 73 29 29 3b 0a 20 20 20 20 20 20 7d 0a Vers));. }.
2a6a0 20 20 20 20 20 20 69 66 28 20 70 67 6e 6f 3e 70 if( pgno>p
2a6b0 50 61 67 65 72 2d 3e 64 62 46 69 6c 65 53 69 7a Pager->dbFileSiz
2a6c0 65 20 29 7b 0a 20 20 20 20 20 20 20 20 70 50 61 e ){. pPa
2a6d0 67 65 72 2d 3e 64 62 46 69 6c 65 53 69 7a 65 20 ger->dbFileSize
2a6e0 3d 20 70 67 6e 6f 3b 0a 20 20 20 20 20 20 7d 0a = pgno;. }.
2a6f0 20 20 20 20 20 20 70 50 61 67 65 72 2d 3e 61 53 pPager->aS
2a700 74 61 74 5b 50 41 47 45 52 5f 53 54 41 54 5f 57 tat[PAGER_STAT_W
2a710 52 49 54 45 5d 2b 2b 3b 0a 0a 20 20 20 20 20 20 RITE]++;..
2a720 2f 2a 20 55 70 64 61 74 65 20 61 6e 79 20 62 61 /* Update any ba
2a730 63 6b 75 70 20 6f 62 6a 65 63 74 73 20 63 6f 70 ckup objects cop
2a740 79 69 6e 67 20 74 68 65 20 63 6f 6e 74 65 6e 74 ying the content
2a750 73 20 6f 66 20 74 68 69 73 20 70 61 67 65 72 2e s of this pager.
2a760 20 2a 2f 0a 20 20 20 20 20 20 73 71 6c 69 74 65 */. sqlite
2a770 33 42 61 63 6b 75 70 55 70 64 61 74 65 28 70 50 3BackupUpdate(pP
2a780 61 67 65 72 2d 3e 70 42 61 63 6b 75 70 2c 20 70 ager->pBackup, p
2a790 67 6e 6f 2c 20 28 75 38 2a 29 70 4c 69 73 74 2d gno, (u8*)pList-
2a7a0 3e 70 44 61 74 61 29 3b 0a 0a 20 20 20 20 20 20 >pData);..
2a7b0 50 41 47 45 52 54 52 41 43 45 28 28 22 53 54 4f PAGERTRACE(("STO
2a7c0 52 45 20 25 64 20 70 61 67 65 20 25 64 20 68 61 RE %d page %d ha
2a7d0 73 68 28 25 30 38 78 29 5c 6e 22 2c 0a 20 20 20 sh(%08x)\n",.
2a7e0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
2a7f0 50 41 47 45 52 49 44 28 70 50 61 67 65 72 29 2c PAGERID(pPager),
2a800 20 70 67 6e 6f 2c 20 70 61 67 65 72 5f 70 61 67 pgno, pager_pag
2a810 65 68 61 73 68 28 70 4c 69 73 74 29 29 29 3b 0a ehash(pList)));.
2a820 20 20 20 20 20 20 49 4f 54 52 41 43 45 28 28 22 IOTRACE(("
2a830 50 47 4f 55 54 20 25 70 20 25 64 5c 6e 22 2c 20 PGOUT %p %d\n",
2a840 70 50 61 67 65 72 2c 20 70 67 6e 6f 29 29 3b 0a pPager, pgno));.
2a850 20 20 20 20 20 20 50 41 47 45 52 5f 49 4e 43 52 PAGER_INCR
2a860 28 73 71 6c 69 74 65 33 5f 70 61 67 65 72 5f 77 (sqlite3_pager_w
2a870 72 69 74 65 64 62 5f 63 6f 75 6e 74 29 3b 0a 20 ritedb_count);.
2a880 20 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 20 20 }else{.
2a890 50 41 47 45 52 54 52 41 43 45 28 28 22 4e 4f 53 PAGERTRACE(("NOS
2a8a0 54 4f 52 45 20 25 64 20 70 61 67 65 20 25 64 5c TORE %d page %d\
2a8b0 6e 22 2c 20 50 41 47 45 52 49 44 28 70 50 61 67 n", PAGERID(pPag
2a8c0 65 72 29 2c 20 70 67 6e 6f 29 29 3b 0a 20 20 20 er), pgno));.
2a8d0 20 7d 0a 20 20 20 20 70 61 67 65 72 5f 73 65 74 }. pager_set
2a8e0 5f 70 61 67 65 68 61 73 68 28 70 4c 69 73 74 29 _pagehash(pList)
2a8f0 3b 0a 20 20 20 20 70 4c 69 73 74 20 3d 20 70 4c ;. pList = pL
2a900 69 73 74 2d 3e 70 44 69 72 74 79 3b 0a 20 20 7d ist->pDirty;. }
2a910 0a 0a 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 7d .. return rc;.}
2a920 0a 0a 2f 2a 0a 2a 2a 20 45 6e 73 75 72 65 20 74 ../*.** Ensure t
2a930 68 61 74 20 74 68 65 20 73 75 62 2d 6a 6f 75 72 hat the sub-jour
2a940 6e 61 6c 20 66 69 6c 65 20 69 73 20 6f 70 65 6e nal file is open
2a950 2e 20 49 66 20 69 74 20 69 73 20 61 6c 72 65 61 . If it is alrea
2a960 64 79 20 6f 70 65 6e 2c 20 74 68 69 73 20 0a 2a dy open, this .*
2a970 2a 20 66 75 6e 63 74 69 6f 6e 20 69 73 20 61 20 * function is a
2a980 6e 6f 2d 6f 70 2e 0a 2a 2a 0a 2a 2a 20 53 51 4c no-op..**.** SQL
2a990 49 54 45 5f 4f 4b 20 69 73 20 72 65 74 75 72 6e ITE_OK is return
2a9a0 65 64 20 69 66 20 65 76 65 72 79 74 68 69 6e 67 ed if everything
2a9b0 20 67 6f 65 73 20 61 63 63 6f 72 64 69 6e 67 20 goes according
2a9c0 74 6f 20 70 6c 61 6e 2e 20 41 6e 20 0a 2a 2a 20 to plan. An .**
2a9d0 53 51 4c 49 54 45 5f 49 4f 45 52 52 5f 58 58 58 SQLITE_IOERR_XXX
2a9e0 20 65 72 72 6f 72 20 63 6f 64 65 20 69 73 20 72 error code is r
2a9f0 65 74 75 72 6e 65 64 20 69 66 20 61 20 63 61 6c eturned if a cal
2aa00 6c 20 74 6f 20 73 71 6c 69 74 65 33 4f 73 4f 70 l to sqlite3OsOp
2aa10 65 6e 28 29 20 0a 2a 2a 20 66 61 69 6c 73 2e 0a en() .** fails..
2aa20 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74 20 6f 70 */.static int op
2aa30 65 6e 53 75 62 4a 6f 75 72 6e 61 6c 28 50 61 67 enSubJournal(Pag
2aa40 65 72 20 2a 70 50 61 67 65 72 29 7b 0a 20 20 69 er *pPager){. i
2aa50 6e 74 20 72 63 20 3d 20 53 51 4c 49 54 45 5f 4f nt rc = SQLITE_O
2aa60 4b 3b 0a 20 20 69 66 28 20 21 69 73 4f 70 65 6e K;. if( !isOpen
2aa70 28 70 50 61 67 65 72 2d 3e 73 6a 66 64 29 20 29 (pPager->sjfd) )
2aa80 7b 0a 20 20 20 20 63 6f 6e 73 74 20 69 6e 74 20 {. const int
2aa90 66 6c 61 67 73 20 3d 20 20 53 51 4c 49 54 45 5f flags = SQLITE_
2aaa0 4f 50 45 4e 5f 53 55 42 4a 4f 55 52 4e 41 4c 20 OPEN_SUBJOURNAL
2aab0 7c 20 53 51 4c 49 54 45 5f 4f 50 45 4e 5f 52 45 | SQLITE_OPEN_RE
2aac0 41 44 57 52 49 54 45 20 0a 20 20 20 20 20 20 7c ADWRITE . |
2aad0 20 53 51 4c 49 54 45 5f 4f 50 45 4e 5f 43 52 45 SQLITE_OPEN_CRE
2aae0 41 54 45 20 7c 20 53 51 4c 49 54 45 5f 4f 50 45 ATE | SQLITE_OPE
2aaf0 4e 5f 45 58 43 4c 55 53 49 56 45 20 0a 20 20 20 N_EXCLUSIVE .
2ab00 20 20 20 7c 20 53 51 4c 49 54 45 5f 4f 50 45 4e | SQLITE_OPEN
2ab10 5f 44 45 4c 45 54 45 4f 4e 43 4c 4f 53 45 3b 0a _DELETEONCLOSE;.
2ab20 20 20 20 20 69 6e 74 20 6e 53 74 6d 74 53 70 69 int nStmtSpi
2ab30 6c 6c 20 3d 20 73 71 6c 69 74 65 33 43 6f 6e 66 ll = sqlite3Conf
2ab40 69 67 2e 6e 53 74 6d 74 53 70 69 6c 6c 3b 0a 20 ig.nStmtSpill;.
2ab50 20 20 20 69 66 28 20 70 50 61 67 65 72 2d 3e 6a if( pPager->j
2ab60 6f 75 72 6e 61 6c 4d 6f 64 65 3d 3d 50 41 47 45 ournalMode==PAGE
2ab70 52 5f 4a 4f 55 52 4e 41 4c 4d 4f 44 45 5f 4d 45 R_JOURNALMODE_ME
2ab80 4d 4f 52 59 20 7c 7c 20 70 50 61 67 65 72 2d 3e MORY || pPager->
2ab90 73 75 62 6a 49 6e 4d 65 6d 6f 72 79 20 29 7b 0a subjInMemory ){.
2aba0 20 20 20 20 20 20 6e 53 74 6d 74 53 70 69 6c 6c nStmtSpill
2abb0 20 3d 20 2d 31 3b 0a 20 20 20 20 7d 0a 20 20 20 = -1;. }.
2abc0 20 72 63 20 3d 20 73 71 6c 69 74 65 33 4a 6f 75 rc = sqlite3Jou
2abd0 72 6e 61 6c 4f 70 65 6e 28 70 50 61 67 65 72 2d rnalOpen(pPager-
2abe0 3e 70 56 66 73 2c 20 30 2c 20 70 50 61 67 65 72 >pVfs, 0, pPager
2abf0 2d 3e 73 6a 66 64 2c 20 66 6c 61 67 73 2c 20 6e ->sjfd, flags, n
2ac00 53 74 6d 74 53 70 69 6c 6c 29 3b 0a 20 20 7d 0a StmtSpill);. }.
2ac10 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 7d 0a 0a return rc;.}..
2ac20 2f 2a 0a 2a 2a 20 41 70 70 65 6e 64 20 61 20 72 /*.** Append a r
2ac30 65 63 6f 72 64 20 6f 66 20 74 68 65 20 63 75 72 ecord of the cur
2ac40 72 65 6e 74 20 73 74 61 74 65 20 6f 66 20 70 61 rent state of pa
2ac50 67 65 20 70 50 67 20 74 6f 20 74 68 65 20 73 75 ge pPg to the su
2ac60 62 2d 6a 6f 75 72 6e 61 6c 2e 20 0a 2a 2a 0a 2a b-journal. .**.*
2ac70 2a 20 49 66 20 73 75 63 63 65 73 73 66 75 6c 2c * If successful,
2ac80 20 73 65 74 20 74 68 65 20 62 69 74 20 63 6f 72 set the bit cor
2ac90 72 65 73 70 6f 6e 64 69 6e 67 20 74 6f 20 70 50 responding to pP
2aca0 67 2d 3e 70 67 6e 6f 20 69 6e 20 74 68 65 20 62 g->pgno in the b
2acb0 69 74 76 65 63 73 0a 2a 2a 20 66 6f 72 20 61 6c itvecs.** for al
2acc0 6c 20 6f 70 65 6e 20 73 61 76 65 70 6f 69 6e 74 l open savepoint
2acd0 73 20 62 65 66 6f 72 65 20 72 65 74 75 72 6e 69 s before returni
2ace0 6e 67 2e 0a 2a 2a 0a 2a 2a 20 54 68 69 73 20 66 ng..**.** This f
2acf0 75 6e 63 74 69 6f 6e 20 72 65 74 75 72 6e 73 20 unction returns
2ad00 53 51 4c 49 54 45 5f 4f 4b 20 69 66 20 65 76 65 SQLITE_OK if eve
2ad10 72 79 74 68 69 6e 67 20 69 73 20 73 75 63 63 65 rything is succe
2ad20 73 73 66 75 6c 2c 20 61 6e 20 49 4f 0a 2a 2a 20 ssful, an IO.**
2ad30 65 72 72 6f 72 20 63 6f 64 65 20 69 66 20 74 68 error code if th
2ad40 65 20 61 74 74 65 6d 70 74 20 74 6f 20 77 72 69 e attempt to wri
2ad50 74 65 20 74 6f 20 74 68 65 20 73 75 62 2d 6a 6f te to the sub-jo
2ad60 75 72 6e 61 6c 20 66 61 69 6c 73 2c 20 6f 72 20 urnal fails, or
2ad70 0a 2a 2a 20 53 51 4c 49 54 45 5f 4e 4f 4d 45 4d .** SQLITE_NOMEM
2ad80 20 69 66 20 61 20 6d 61 6c 6c 6f 63 20 66 61 69 if a malloc fai
2ad90 6c 73 20 77 68 69 6c 65 20 73 65 74 74 69 6e 67 ls while setting
2ada0 20 61 20 62 69 74 20 69 6e 20 61 20 73 61 76 65 a bit in a save
2adb0 70 6f 69 6e 74 0a 2a 2a 20 62 69 74 76 65 63 2e point.** bitvec.
2adc0 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74 20 73 .*/.static int s
2add0 75 62 6a 6f 75 72 6e 61 6c 50 61 67 65 28 50 67 ubjournalPage(Pg
2ade0 48 64 72 20 2a 70 50 67 29 7b 0a 20 20 69 6e 74 Hdr *pPg){. int
2adf0 20 72 63 20 3d 20 53 51 4c 49 54 45 5f 4f 4b 3b rc = SQLITE_OK;
2ae00 0a 20 20 50 61 67 65 72 20 2a 70 50 61 67 65 72 . Pager *pPager
2ae10 20 3d 20 70 50 67 2d 3e 70 50 61 67 65 72 3b 0a = pPg->pPager;.
2ae20 20 20 69 66 28 20 70 50 61 67 65 72 2d 3e 6a 6f if( pPager->jo
2ae30 75 72 6e 61 6c 4d 6f 64 65 21 3d 50 41 47 45 52 urnalMode!=PAGER
2ae40 5f 4a 4f 55 52 4e 41 4c 4d 4f 44 45 5f 4f 46 46 _JOURNALMODE_OFF
2ae50 20 29 7b 0a 0a 20 20 20 20 2f 2a 20 4f 70 65 6e ){.. /* Open
2ae60 20 74 68 65 20 73 75 62 2d 6a 6f 75 72 6e 61 6c the sub-journal
2ae70 2c 20 69 66 20 69 74 20 68 61 73 20 6e 6f 74 20 , if it has not
2ae80 61 6c 72 65 61 64 79 20 62 65 65 6e 20 6f 70 65 already been ope
2ae90 6e 65 64 20 2a 2f 0a 20 20 20 20 61 73 73 65 72 ned */. asser
2aea0 74 28 20 70 50 61 67 65 72 2d 3e 75 73 65 4a 6f t( pPager->useJo
2aeb0 75 72 6e 61 6c 20 29 3b 0a 20 20 20 20 61 73 73 urnal );. ass
2aec0 65 72 74 28 20 69 73 4f 70 65 6e 28 70 50 61 67 ert( isOpen(pPag
2aed0 65 72 2d 3e 6a 66 64 29 20 7c 7c 20 70 61 67 65 er->jfd) || page
2aee0 72 55 73 65 57 61 6c 28 70 50 61 67 65 72 29 20 rUseWal(pPager)
2aef0 29 3b 0a 20 20 20 20 61 73 73 65 72 74 28 20 69 );. assert( i
2af00 73 4f 70 65 6e 28 70 50 61 67 65 72 2d 3e 73 6a sOpen(pPager->sj
2af10 66 64 29 20 7c 7c 20 70 50 61 67 65 72 2d 3e 6e fd) || pPager->n
2af20 53 75 62 52 65 63 3d 3d 30 20 29 3b 0a 20 20 20 SubRec==0 );.
2af30 20 61 73 73 65 72 74 28 20 70 61 67 65 72 55 73 assert( pagerUs
2af40 65 57 61 6c 28 70 50 61 67 65 72 29 20 0a 20 20 eWal(pPager) .
2af50 20 20 20 20 20 20 20 7c 7c 20 70 61 67 65 49 6e || pageIn
2af60 4a 6f 75 72 6e 61 6c 28 70 50 61 67 65 72 2c 20 Journal(pPager,
2af70 70 50 67 29 20 0a 20 20 20 20 20 20 20 20 20 7c pPg) . |
2af80 7c 20 70 50 67 2d 3e 70 67 6e 6f 3e 70 50 61 67 | pPg->pgno>pPag
2af90 65 72 2d 3e 64 62 4f 72 69 67 53 69 7a 65 20 0a er->dbOrigSize .
2afa0 20 20 20 20 29 3b 0a 20 20 20 20 72 63 20 3d 20 );. rc =
2afb0 6f 70 65 6e 53 75 62 4a 6f 75 72 6e 61 6c 28 70 openSubJournal(p
2afc0 50 61 67 65 72 29 3b 0a 0a 20 20 20 20 2f 2a 20 Pager);.. /*
2afd0 49 66 20 74 68 65 20 73 75 62 2d 6a 6f 75 72 6e If the sub-journ
2afe0 61 6c 20 77 61 73 20 6f 70 65 6e 65 64 20 73 75 al was opened su
2aff0 63 63 65 73 73 66 75 6c 6c 79 20 28 6f 72 20 77 ccessfully (or w
2b000 61 73 20 61 6c 72 65 61 64 79 20 6f 70 65 6e 29 as already open)
2b010 2c 0a 20 20 20 20 2a 2a 20 77 72 69 74 65 20 74 ,. ** write t
2b020 68 65 20 6a 6f 75 72 6e 61 6c 20 72 65 63 6f 72 he journal recor
2b030 64 20 69 6e 74 6f 20 74 68 65 20 66 69 6c 65 2e d into the file.
2b040 20 20 2a 2f 0a 20 20 20 20 69 66 28 20 72 63 3d */. if( rc=
2b050 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 =SQLITE_OK ){.
2b060 20 20 20 20 76 6f 69 64 20 2a 70 44 61 74 61 20 void *pData
2b070 3d 20 70 50 67 2d 3e 70 44 61 74 61 3b 0a 20 20 = pPg->pData;.
2b080 20 20 20 20 69 36 34 20 6f 66 66 73 65 74 20 3d i64 offset =
2b090 20 28 69 36 34 29 70 50 61 67 65 72 2d 3e 6e 53 (i64)pPager->nS
2b0a0 75 62 52 65 63 2a 28 34 2b 70 50 61 67 65 72 2d ubRec*(4+pPager-
2b0b0 3e 70 61 67 65 53 69 7a 65 29 3b 0a 20 20 20 20 >pageSize);.
2b0c0 20 20 63 68 61 72 20 2a 70 44 61 74 61 32 3b 0a char *pData2;.
2b0d0 20 20 0a 20 20 20 20 20 20 43 4f 44 45 43 32 28 . CODEC2(
2b0e0 70 50 61 67 65 72 2c 20 70 44 61 74 61 2c 20 70 pPager, pData, p
2b0f0 50 67 2d 3e 70 67 6e 6f 2c 20 37 2c 20 72 65 74 Pg->pgno, 7, ret
2b100 75 72 6e 20 53 51 4c 49 54 45 5f 4e 4f 4d 45 4d urn SQLITE_NOMEM
2b110 5f 42 4b 50 54 2c 20 70 44 61 74 61 32 29 3b 0a _BKPT, pData2);.
2b120 20 20 20 20 20 20 50 41 47 45 52 54 52 41 43 45 PAGERTRACE
2b130 28 28 22 53 54 4d 54 2d 4a 4f 55 52 4e 41 4c 20 (("STMT-JOURNAL
2b140 25 64 20 70 61 67 65 20 25 64 5c 6e 22 2c 20 50 %d page %d\n", P
2b150 41 47 45 52 49 44 28 70 50 61 67 65 72 29 2c 20 AGERID(pPager),
2b160 70 50 67 2d 3e 70 67 6e 6f 29 29 3b 0a 20 20 20 pPg->pgno));.
2b170 20 20 20 72 63 20 3d 20 77 72 69 74 65 33 32 62 rc = write32b
2b180 69 74 73 28 70 50 61 67 65 72 2d 3e 73 6a 66 64 its(pPager->sjfd
2b190 2c 20 6f 66 66 73 65 74 2c 20 70 50 67 2d 3e 70 , offset, pPg->p
2b1a0 67 6e 6f 29 3b 0a 20 20 20 20 20 20 69 66 28 20 gno);. if(
2b1b0 72 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b rc==SQLITE_OK ){
2b1c0 0a 20 20 20 20 20 20 20 20 72 63 20 3d 20 73 71 . rc = sq
2b1d0 6c 69 74 65 33 4f 73 57 72 69 74 65 28 70 50 61 lite3OsWrite(pPa
2b1e0 67 65 72 2d 3e 73 6a 66 64 2c 20 70 44 61 74 61 ger->sjfd, pData
2b1f0 32 2c 20 70 50 61 67 65 72 2d 3e 70 61 67 65 53 2, pPager->pageS
2b200 69 7a 65 2c 20 6f 66 66 73 65 74 2b 34 29 3b 0a ize, offset+4);.
2b210 20 20 20 20 20 20 7d 0a 20 20 20 20 7d 0a 20 20 }. }.
2b220 7d 0a 20 20 69 66 28 20 72 63 3d 3d 53 51 4c 49 }. if( rc==SQLI
2b230 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 70 50 61 TE_OK ){. pPa
2b240 67 65 72 2d 3e 6e 53 75 62 52 65 63 2b 2b 3b 0a ger->nSubRec++;.
2b250 20 20 20 20 61 73 73 65 72 74 28 20 70 50 61 67 assert( pPag
2b260 65 72 2d 3e 6e 53 61 76 65 70 6f 69 6e 74 3e 30 er->nSavepoint>0
2b270 20 29 3b 0a 20 20 20 20 72 63 20 3d 20 61 64 64 );. rc = add
2b280 54 6f 53 61 76 65 70 6f 69 6e 74 42 69 74 76 65 ToSavepointBitve
2b290 63 73 28 70 50 61 67 65 72 2c 20 70 50 67 2d 3e cs(pPager, pPg->
2b2a0 70 67 6e 6f 29 3b 0a 20 20 7d 0a 20 20 72 65 74 pgno);. }. ret
2b2b0 75 72 6e 20 72 63 3b 0a 7d 0a 73 74 61 74 69 63 urn rc;.}.static
2b2c0 20 69 6e 74 20 73 75 62 6a 6f 75 72 6e 61 6c 50 int subjournalP
2b2d0 61 67 65 49 66 52 65 71 75 69 72 65 64 28 50 67 ageIfRequired(Pg
2b2e0 48 64 72 20 2a 70 50 67 29 7b 0a 20 20 69 66 28 Hdr *pPg){. if(
2b2f0 20 73 75 62 6a 52 65 71 75 69 72 65 73 50 61 67 subjRequiresPag
2b300 65 28 70 50 67 29 20 29 7b 0a 20 20 20 20 72 65 e(pPg) ){. re
2b310 74 75 72 6e 20 73 75 62 6a 6f 75 72 6e 61 6c 50 turn subjournalP
2b320 61 67 65 28 70 50 67 29 3b 0a 20 20 7d 65 6c 73 age(pPg);. }els
2b330 65 7b 0a 20 20 20 20 72 65 74 75 72 6e 20 53 51 e{. return SQ
2b340 4c 49 54 45 5f 4f 4b 3b 0a 20 20 7d 0a 7d 0a 0a LITE_OK;. }.}..
2b350 2f 2a 0a 2a 2a 20 54 68 69 73 20 66 75 6e 63 74 /*.** This funct
2b360 69 6f 6e 20 69 73 20 63 61 6c 6c 65 64 20 62 79 ion is called by
2b370 20 74 68 65 20 70 63 61 63 68 65 20 6c 61 79 65 the pcache laye
2b380 72 20 77 68 65 6e 20 69 74 20 68 61 73 20 72 65 r when it has re
2b390 61 63 68 65 64 20 73 6f 6d 65 0a 2a 2a 20 73 6f ached some.** so
2b3a0 66 74 20 6d 65 6d 6f 72 79 20 6c 69 6d 69 74 2e ft memory limit.
2b3b0 20 54 68 65 20 66 69 72 73 74 20 61 72 67 75 6d The first argum
2b3c0 65 6e 74 20 69 73 20 61 20 70 6f 69 6e 74 65 72 ent is a pointer
2b3d0 20 74 6f 20 61 20 50 61 67 65 72 20 6f 62 6a 65 to a Pager obje
2b3e0 63 74 0a 2a 2a 20 28 63 61 73 74 20 61 73 20 61 ct.** (cast as a
2b3f0 20 76 6f 69 64 2a 29 2e 20 54 68 65 20 70 61 67 void*). The pag
2b400 65 72 20 69 73 20 61 6c 77 61 79 73 20 27 70 75 er is always 'pu
2b410 72 67 65 61 62 6c 65 27 20 28 6e 6f 74 20 61 6e rgeable' (not an
2b420 20 69 6e 2d 6d 65 6d 6f 72 79 0a 2a 2a 20 64 61 in-memory.** da
2b430 74 61 62 61 73 65 29 2e 20 54 68 65 20 73 65 63 tabase). The sec
2b440 6f 6e 64 20 61 72 67 75 6d 65 6e 74 20 69 73 20 ond argument is
2b450 61 20 72 65 66 65 72 65 6e 63 65 20 74 6f 20 61 a reference to a
2b460 20 70 61 67 65 20 74 68 61 74 20 69 73 20 0a 2a page that is .*
2b470 2a 20 63 75 72 72 65 6e 74 6c 79 20 64 69 72 74 * currently dirt
2b480 79 20 62 75 74 20 68 61 73 20 6e 6f 20 6f 75 74 y but has no out
2b490 73 74 61 6e 64 69 6e 67 20 72 65 66 65 72 65 6e standing referen
2b4a0 63 65 73 2e 20 54 68 65 20 70 61 67 65 0a 2a 2a ces. The page.**
2b4b0 20 69 73 20 61 6c 77 61 79 73 20 61 73 73 6f 63 is always assoc
2b4c0 69 61 74 65 64 20 77 69 74 68 20 74 68 65 20 50 iated with the P
2b4d0 61 67 65 72 20 6f 62 6a 65 63 74 20 70 61 73 73 ager object pass
2b4e0 65 64 20 61 73 20 74 68 65 20 66 69 72 73 74 20 ed as the first
2b4f0 0a 2a 2a 20 61 72 67 75 6d 65 6e 74 2e 0a 2a 2a .** argument..**
2b500 0a 2a 2a 20 54 68 65 20 6a 6f 62 20 6f 66 20 74 .** The job of t
2b510 68 69 73 20 66 75 6e 63 74 69 6f 6e 20 69 73 20 his function is
2b520 74 6f 20 6d 61 6b 65 20 70 50 67 20 63 6c 65 61 to make pPg clea
2b530 6e 20 62 79 20 77 72 69 74 69 6e 67 20 69 74 73 n by writing its
2b540 20 63 6f 6e 74 65 6e 74 73 0a 2a 2a 20 6f 75 74 contents.** out
2b550 20 74 6f 20 74 68 65 20 64 61 74 61 62 61 73 65 to the database
2b560 20 66 69 6c 65 2c 20 69 66 20 70 6f 73 73 69 62 file, if possib
2b570 6c 65 2e 20 54 68 69 73 20 6d 61 79 20 69 6e 76 le. This may inv
2b580 6f 6c 76 65 20 73 79 6e 63 69 6e 67 20 74 68 65 olve syncing the
2b590 0a 2a 2a 20 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 .** journal file
2b5a0 2e 20 0a 2a 2a 0a 2a 2a 20 49 66 20 73 75 63 63 . .**.** If succ
2b5b0 65 73 73 66 75 6c 2c 20 73 71 6c 69 74 65 33 50 essful, sqlite3P
2b5c0 63 61 63 68 65 4d 61 6b 65 43 6c 65 61 6e 28 29 cacheMakeClean()
2b5d0 20 69 73 20 63 61 6c 6c 65 64 20 6f 6e 20 74 68 is called on th
2b5e0 65 20 70 61 67 65 20 61 6e 64 0a 2a 2a 20 53 51 e page and.** SQ
2b5f0 4c 49 54 45 5f 4f 4b 20 72 65 74 75 72 6e 65 64 LITE_OK returned
2b600 2e 20 49 66 20 61 6e 20 49 4f 20 65 72 72 6f 72 . If an IO error
2b610 20 6f 63 63 75 72 73 20 77 68 69 6c 65 20 74 72 occurs while tr
2b620 79 69 6e 67 20 74 6f 20 6d 61 6b 65 20 74 68 65 ying to make the
2b630 0a 2a 2a 20 70 61 67 65 20 63 6c 65 61 6e 2c 20 .** page clean,
2b640 74 68 65 20 49 4f 20 65 72 72 6f 72 20 63 6f 64 the IO error cod
2b650 65 20 69 73 20 72 65 74 75 72 6e 65 64 2e 20 49 e is returned. I
2b660 66 20 74 68 65 20 70 61 67 65 20 63 61 6e 6e 6f f the page canno
2b670 74 20 62 65 0a 2a 2a 20 6d 61 64 65 20 63 6c 65 t be.** made cle
2b680 61 6e 20 66 6f 72 20 73 6f 6d 65 20 6f 74 68 65 an for some othe
2b690 72 20 72 65 61 73 6f 6e 2c 20 62 75 74 20 6e 6f r reason, but no
2b6a0 20 65 72 72 6f 72 20 6f 63 63 75 72 73 2c 20 74 error occurs, t
2b6b0 68 65 6e 20 53 51 4c 49 54 45 5f 4f 4b 0a 2a 2a hen SQLITE_OK.**
2b6c0 20 69 73 20 72 65 74 75 72 6e 65 64 20 62 79 20 is returned by
2b6d0 73 71 6c 69 74 65 33 50 63 61 63 68 65 4d 61 6b sqlite3PcacheMak
2b6e0 65 43 6c 65 61 6e 28 29 20 69 73 20 6e 6f 74 20 eClean() is not
2b6f0 63 61 6c 6c 65 64 2e 0a 2a 2f 0a 73 74 61 74 69 called..*/.stati
2b700 63 20 69 6e 74 20 70 61 67 65 72 53 74 72 65 73 c int pagerStres
2b710 73 28 76 6f 69 64 20 2a 70 2c 20 50 67 48 64 72 s(void *p, PgHdr
2b720 20 2a 70 50 67 29 7b 0a 20 20 50 61 67 65 72 20 *pPg){. Pager
2b730 2a 70 50 61 67 65 72 20 3d 20 28 50 61 67 65 72 *pPager = (Pager
2b740 20 2a 29 70 3b 0a 20 20 69 6e 74 20 72 63 20 3d *)p;. int rc =
2b750 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 0a 20 20 61 SQLITE_OK;.. a
2b760 73 73 65 72 74 28 20 70 50 67 2d 3e 70 50 61 67 ssert( pPg->pPag
2b770 65 72 3d 3d 70 50 61 67 65 72 20 29 3b 0a 20 20 er==pPager );.
2b780 61 73 73 65 72 74 28 20 70 50 67 2d 3e 66 6c 61 assert( pPg->fla
2b790 67 73 26 50 47 48 44 52 5f 44 49 52 54 59 20 29 gs&PGHDR_DIRTY )
2b7a0 3b 0a 0a 20 20 2f 2a 20 54 68 65 20 64 6f 4e 6f ;.. /* The doNo
2b7b0 74 53 70 69 6c 6c 20 4e 4f 53 59 4e 43 20 62 69 tSpill NOSYNC bi
2b7c0 74 20 69 73 20 73 65 74 20 64 75 72 69 6e 67 20 t is set during
2b7d0 74 69 6d 65 73 20 77 68 65 6e 20 64 6f 69 6e 67 times when doing
2b7e0 20 61 20 73 79 6e 63 20 6f 66 0a 20 20 2a 2a 20 a sync of. **
2b7f0 6a 6f 75 72 6e 61 6c 20 28 61 6e 64 20 61 64 64 journal (and add
2b800 69 6e 67 20 61 20 6e 65 77 20 68 65 61 64 65 72 ing a new header
2b810 29 20 69 73 20 6e 6f 74 20 61 6c 6c 6f 77 65 64 ) is not allowed
2b820 2e 20 20 54 68 69 73 20 6f 63 63 75 72 73 0a 20 . This occurs.
2b830 20 2a 2a 20 64 75 72 69 6e 67 20 63 61 6c 6c 73 ** during calls
2b840 20 74 6f 20 73 71 6c 69 74 65 33 50 61 67 65 72 to sqlite3Pager
2b850 57 72 69 74 65 28 29 20 77 68 69 6c 65 20 74 72 Write() while tr
2b860 79 69 6e 67 20 74 6f 20 6a 6f 75 72 6e 61 6c 20 ying to journal
2b870 6d 75 6c 74 69 70 6c 65 0a 20 20 2a 2a 20 70 61 multiple. ** pa
2b880 67 65 73 20 62 65 6c 6f 6e 67 69 6e 67 20 74 6f ges belonging to
2b890 20 74 68 65 20 73 61 6d 65 20 73 65 63 74 6f 72 the same sector
2b8a0 2e 0a 20 20 2a 2a 0a 20 20 2a 2a 20 54 68 65 20 .. **. ** The
2b8b0 64 6f 4e 6f 74 53 70 69 6c 6c 20 52 4f 4c 4c 42 doNotSpill ROLLB
2b8c0 41 43 4b 20 61 6e 64 20 4f 46 46 20 62 69 74 73 ACK and OFF bits
2b8d0 20 69 6e 68 69 62 69 74 73 20 61 6c 6c 20 63 61 inhibits all ca
2b8e0 63 68 65 20 73 70 69 6c 6c 69 6e 67 0a 20 20 2a che spilling. *
2b8f0 2a 20 72 65 67 61 72 64 6c 65 73 73 20 6f 66 20 * regardless of
2b900 77 68 65 74 68 65 72 20 6f 72 20 6e 6f 74 20 61 whether or not a
2b910 20 73 79 6e 63 20 69 73 20 72 65 71 75 69 72 65 sync is require
2b920 64 2e 20 20 54 68 69 73 20 69 73 20 73 65 74 20 d. This is set
2b930 64 75 72 69 6e 67 0a 20 20 2a 2a 20 61 20 72 6f during. ** a ro
2b940 6c 6c 62 61 63 6b 20 6f 72 20 62 79 20 75 73 65 llback or by use
2b950 72 20 72 65 71 75 65 73 74 2c 20 72 65 73 70 65 r request, respe
2b960 63 74 69 76 65 6c 79 2e 0a 20 20 2a 2a 0a 20 20 ctively.. **.
2b970 2a 2a 20 53 70 69 6c 6c 69 6e 67 20 69 73 20 61 ** Spilling is a
2b980 6c 73 6f 20 70 72 6f 68 69 62 69 74 65 64 20 77 lso prohibited w
2b990 68 65 6e 20 69 6e 20 61 6e 20 65 72 72 6f 72 20 hen in an error
2b9a0 73 74 61 74 65 20 73 69 6e 63 65 20 74 68 61 74 state since that
2b9b0 20 63 6f 75 6c 64 0a 20 20 2a 2a 20 6c 65 61 64 could. ** lead
2b9c0 20 74 6f 20 64 61 74 61 62 61 73 65 20 63 6f 72 to database cor
2b9d0 72 75 70 74 69 6f 6e 2e 20 20 20 49 6e 20 74 68 ruption. In th
2b9e0 65 20 63 75 72 72 65 6e 74 20 69 6d 70 6c 65 6d e current implem
2b9f0 65 6e 74 61 74 69 6f 6e 20 69 74 20 0a 20 20 2a entation it . *
2ba00 2a 20 69 73 20 69 6d 70 6f 73 73 69 62 6c 65 20 * is impossible
2ba10 66 6f 72 20 73 71 6c 69 74 65 33 50 63 61 63 68 for sqlite3Pcach
2ba20 65 46 65 74 63 68 28 29 20 74 6f 20 62 65 20 63 eFetch() to be c
2ba30 61 6c 6c 65 64 20 77 69 74 68 20 63 72 65 61 74 alled with creat
2ba40 65 46 6c 61 67 3d 3d 33 0a 20 20 2a 2a 20 77 68 eFlag==3. ** wh
2ba50 69 6c 65 20 69 6e 20 74 68 65 20 65 72 72 6f 72 ile in the error
2ba60 20 73 74 61 74 65 2c 20 68 65 6e 63 65 20 69 74 state, hence it
2ba70 20 69 73 20 69 6d 70 6f 73 73 69 62 6c 65 20 66 is impossible f
2ba80 6f 72 20 74 68 69 73 20 72 6f 75 74 69 6e 65 20 or this routine
2ba90 74 6f 0a 20 20 2a 2a 20 62 65 20 63 61 6c 6c 65 to. ** be calle
2baa0 64 20 69 6e 20 74 68 65 20 65 72 72 6f 72 20 73 d in the error s
2bab0 74 61 74 65 2e 20 20 4e 65 76 65 72 74 68 65 6c tate. Neverthel
2bac0 65 73 73 2c 20 77 65 20 69 6e 63 6c 75 64 65 20 ess, we include
2bad0 61 20 4e 45 56 45 52 28 29 0a 20 20 2a 2a 20 74 a NEVER(). ** t
2bae0 65 73 74 20 66 6f 72 20 74 68 65 20 65 72 72 6f est for the erro
2baf0 72 20 73 74 61 74 65 20 61 73 20 61 20 73 61 66 r state as a saf
2bb00 65 67 75 61 72 64 20 61 67 61 69 6e 73 74 20 66 eguard against f
2bb10 75 74 75 72 65 20 63 68 61 6e 67 65 73 2e 0a 20 uture changes..
2bb20 20 2a 2f 0a 20 20 69 66 28 20 4e 45 56 45 52 28 */. if( NEVER(
2bb30 70 50 61 67 65 72 2d 3e 65 72 72 43 6f 64 65 29 pPager->errCode)
2bb40 20 29 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 ) return SQLITE
2bb50 5f 4f 4b 3b 0a 20 20 74 65 73 74 63 61 73 65 28 _OK;. testcase(
2bb60 20 70 50 61 67 65 72 2d 3e 64 6f 4e 6f 74 53 70 pPager->doNotSp
2bb70 69 6c 6c 20 26 20 53 50 49 4c 4c 46 4c 41 47 5f ill & SPILLFLAG_
2bb80 52 4f 4c 4c 42 41 43 4b 20 29 3b 0a 20 20 74 65 ROLLBACK );. te
2bb90 73 74 63 61 73 65 28 20 70 50 61 67 65 72 2d 3e stcase( pPager->
2bba0 64 6f 4e 6f 74 53 70 69 6c 6c 20 26 20 53 50 49 doNotSpill & SPI
2bbb0 4c 4c 46 4c 41 47 5f 4f 46 46 20 29 3b 0a 20 20 LLFLAG_OFF );.
2bbc0 74 65 73 74 63 61 73 65 28 20 70 50 61 67 65 72 testcase( pPager
2bbd0 2d 3e 64 6f 4e 6f 74 53 70 69 6c 6c 20 26 20 53 ->doNotSpill & S
2bbe0 50 49 4c 4c 46 4c 41 47 5f 4e 4f 53 59 4e 43 20 PILLFLAG_NOSYNC
2bbf0 29 3b 0a 20 20 69 66 28 20 70 50 61 67 65 72 2d );. if( pPager-
2bc00 3e 64 6f 4e 6f 74 53 70 69 6c 6c 0a 20 20 20 26 >doNotSpill. &
2bc10 26 20 28 28 70 50 61 67 65 72 2d 3e 64 6f 4e 6f & ((pPager->doNo
2bc20 74 53 70 69 6c 6c 20 26 20 28 53 50 49 4c 4c 46 tSpill & (SPILLF
2bc30 4c 41 47 5f 52 4f 4c 4c 42 41 43 4b 7c 53 50 49 LAG_ROLLBACK|SPI
2bc40 4c 4c 46 4c 41 47 5f 4f 46 46 29 29 21 3d 30 0a LLFLAG_OFF))!=0.
2bc50 20 20 20 20 20 20 7c 7c 20 28 70 50 67 2d 3e 66 || (pPg->f
2bc60 6c 61 67 73 20 26 20 50 47 48 44 52 5f 4e 45 45 lags & PGHDR_NEE
2bc70 44 5f 53 59 4e 43 29 21 3d 30 29 0a 20 20 29 7b D_SYNC)!=0). ){
2bc80 0a 20 20 20 20 72 65 74 75 72 6e 20 53 51 4c 49 . return SQLI
2bc90 54 45 5f 4f 4b 3b 0a 20 20 7d 0a 0a 20 20 70 50 TE_OK;. }.. pP
2bca0 67 2d 3e 70 44 69 72 74 79 20 3d 20 30 3b 0a 20 g->pDirty = 0;.
2bcb0 20 69 66 28 20 70 61 67 65 72 55 73 65 57 61 6c if( pagerUseWal
2bcc0 28 70 50 61 67 65 72 29 20 29 7b 0a 20 20 20 20 (pPager) ){.
2bcd0 2f 2a 20 57 72 69 74 65 20 61 20 73 69 6e 67 6c /* Write a singl
2bce0 65 20 66 72 61 6d 65 20 66 6f 72 20 74 68 69 73 e frame for this
2bcf0 20 70 61 67 65 20 74 6f 20 74 68 65 20 6c 6f 67 page to the log
2bd00 2e 20 2a 2f 0a 20 20 20 20 72 63 20 3d 20 73 75 . */. rc = su
2bd10 62 6a 6f 75 72 6e 61 6c 50 61 67 65 49 66 52 65 bjournalPageIfRe
2bd20 71 75 69 72 65 64 28 70 50 67 29 3b 20 0a 20 20 quired(pPg); .
2bd30 20 20 69 66 28 20 72 63 3d 3d 53 51 4c 49 54 45 if( rc==SQLITE
2bd40 5f 4f 4b 20 29 7b 0a 20 20 20 20 20 20 72 63 20 _OK ){. rc
2bd50 3d 20 70 61 67 65 72 57 61 6c 46 72 61 6d 65 73 = pagerWalFrames
2bd60 28 70 50 61 67 65 72 2c 20 70 50 67 2c 20 30 2c (pPager, pPg, 0,
2bd70 20 30 29 3b 0a 20 20 20 20 7d 0a 20 20 7d 65 6c 0);. }. }el
2bd80 73 65 7b 0a 20 20 0a 20 20 20 20 2f 2a 20 53 79 se{. . /* Sy
2bd90 6e 63 20 74 68 65 20 6a 6f 75 72 6e 61 6c 20 66 nc the journal f
2bda0 69 6c 65 20 69 66 20 72 65 71 75 69 72 65 64 2e ile if required.
2bdb0 20 2a 2f 0a 20 20 20 20 69 66 28 20 70 50 67 2d */. if( pPg-
2bdc0 3e 66 6c 61 67 73 26 50 47 48 44 52 5f 4e 45 45 >flags&PGHDR_NEE
2bdd0 44 5f 53 59 4e 43 20 0a 20 20 20 20 20 7c 7c 20 D_SYNC . ||
2bde0 70 50 61 67 65 72 2d 3e 65 53 74 61 74 65 3d 3d pPager->eState==
2bdf0 50 41 47 45 52 5f 57 52 49 54 45 52 5f 43 41 43 PAGER_WRITER_CAC
2be00 48 45 4d 4f 44 0a 20 20 20 20 29 7b 0a 20 20 20 HEMOD. ){.
2be10 20 20 20 72 63 20 3d 20 73 79 6e 63 4a 6f 75 72 rc = syncJour
2be20 6e 61 6c 28 70 50 61 67 65 72 2c 20 31 29 3b 0a nal(pPager, 1);.
2be30 20 20 20 20 7d 0a 20 20 0a 20 20 20 20 2f 2a 20 }. . /*
2be40 57 72 69 74 65 20 74 68 65 20 63 6f 6e 74 65 6e Write the conten
2be50 74 73 20 6f 66 20 74 68 65 20 70 61 67 65 20 6f ts of the page o
2be60 75 74 20 74 6f 20 74 68 65 20 64 61 74 61 62 61 ut to the databa
2be70 73 65 20 66 69 6c 65 2e 20 2a 2f 0a 20 20 20 20 se file. */.
2be80 69 66 28 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4f if( rc==SQLITE_O
2be90 4b 20 29 7b 0a 20 20 20 20 20 20 61 73 73 65 72 K ){. asser
2bea0 74 28 20 28 70 50 67 2d 3e 66 6c 61 67 73 26 50 t( (pPg->flags&P
2beb0 47 48 44 52 5f 4e 45 45 44 5f 53 59 4e 43 29 3d GHDR_NEED_SYNC)=
2bec0 3d 30 20 29 3b 0a 20 20 20 20 20 20 72 63 20 3d =0 );. rc =
2bed0 20 70 61 67 65 72 5f 77 72 69 74 65 5f 70 61 67 pager_write_pag
2bee0 65 6c 69 73 74 28 70 50 61 67 65 72 2c 20 70 50 elist(pPager, pP
2bef0 67 29 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a 0a 20 g);. }. }..
2bf00 20 2f 2a 20 4d 61 72 6b 20 74 68 65 20 70 61 67 /* Mark the pag
2bf10 65 20 61 73 20 63 6c 65 61 6e 2e 20 2a 2f 0a 20 e as clean. */.
2bf20 20 69 66 28 20 72 63 3d 3d 53 51 4c 49 54 45 5f if( rc==SQLITE_
2bf30 4f 4b 20 29 7b 0a 20 20 20 20 50 41 47 45 52 54 OK ){. PAGERT
2bf40 52 41 43 45 28 28 22 53 54 52 45 53 53 20 25 64 RACE(("STRESS %d
2bf50 20 70 61 67 65 20 25 64 5c 6e 22 2c 20 50 41 47 page %d\n", PAG
2bf60 45 52 49 44 28 70 50 61 67 65 72 29 2c 20 70 50 ERID(pPager), pP
2bf70 67 2d 3e 70 67 6e 6f 29 29 3b 0a 20 20 20 20 73 g->pgno));. s
2bf80 71 6c 69 74 65 33 50 63 61 63 68 65 4d 61 6b 65 qlite3PcacheMake
2bf90 43 6c 65 61 6e 28 70 50 67 29 3b 0a 20 20 7d 0a Clean(pPg);. }.
2bfa0 0a 20 20 72 65 74 75 72 6e 20 70 61 67 65 72 5f . return pager_
2bfb0 65 72 72 6f 72 28 70 50 61 67 65 72 2c 20 72 63 error(pPager, rc
2bfc0 29 3b 20 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 46 6c 75 ); .}../*.** Flu
2bfd0 73 68 20 61 6c 6c 20 75 6e 72 65 66 65 72 65 6e sh all unreferen
2bfe0 63 65 64 20 64 69 72 74 79 20 70 61 67 65 73 20 ced dirty pages
2bff0 74 6f 20 64 69 73 6b 2e 0a 2a 2f 0a 69 6e 74 20 to disk..*/.int
2c000 73 71 6c 69 74 65 33 50 61 67 65 72 46 6c 75 73 sqlite3PagerFlus
2c010 68 28 50 61 67 65 72 20 2a 70 50 61 67 65 72 29 h(Pager *pPager)
2c020 7b 0a 20 20 69 6e 74 20 72 63 20 3d 20 70 50 61 {. int rc = pPa
2c030 67 65 72 2d 3e 65 72 72 43 6f 64 65 3b 0a 20 20 ger->errCode;.
2c040 69 66 28 20 21 4d 45 4d 44 42 20 29 7b 0a 20 20 if( !MEMDB ){.
2c050 20 20 50 67 48 64 72 20 2a 70 4c 69 73 74 20 3d PgHdr *pList =
2c060 20 73 71 6c 69 74 65 33 50 63 61 63 68 65 44 69 sqlite3PcacheDi
2c070 72 74 79 4c 69 73 74 28 70 50 61 67 65 72 2d 3e rtyList(pPager->
2c080 70 50 43 61 63 68 65 29 3b 0a 20 20 20 20 61 73 pPCache);. as
2c090 73 65 72 74 28 20 61 73 73 65 72 74 5f 70 61 67 sert( assert_pag
2c0a0 65 72 5f 73 74 61 74 65 28 70 50 61 67 65 72 29 er_state(pPager)
2c0b0 20 29 3b 0a 20 20 20 20 77 68 69 6c 65 28 20 72 );. while( r
2c0c0 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 26 26 20 c==SQLITE_OK &&
2c0d0 70 4c 69 73 74 20 29 7b 0a 20 20 20 20 20 20 50 pList ){. P
2c0e0 67 48 64 72 20 2a 70 4e 65 78 74 20 3d 20 70 4c gHdr *pNext = pL
2c0f0 69 73 74 2d 3e 70 44 69 72 74 79 3b 0a 20 20 20 ist->pDirty;.
2c100 20 20 20 69 66 28 20 70 4c 69 73 74 2d 3e 6e 52 if( pList->nR
2c110 65 66 3d 3d 30 20 29 7b 0a 20 20 20 20 20 20 20 ef==0 ){.
2c120 20 72 63 20 3d 20 70 61 67 65 72 53 74 72 65 73 rc = pagerStres
2c130 73 28 28 76 6f 69 64 2a 29 70 50 61 67 65 72 2c s((void*)pPager,
2c140 20 70 4c 69 73 74 29 3b 0a 20 20 20 20 20 20 7d pList);. }
2c150 0a 20 20 20 20 20 20 70 4c 69 73 74 20 3d 20 70 . pList = p
2c160 4e 65 78 74 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a Next;. }. }.
2c170 0a 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 7d 0a . return rc;.}.
2c180 0a 2f 2a 0a 2a 2a 20 41 6c 6c 6f 63 61 74 65 20 ./*.** Allocate
2c190 61 6e 64 20 69 6e 69 74 69 61 6c 69 7a 65 20 61 and initialize a
2c1a0 20 6e 65 77 20 50 61 67 65 72 20 6f 62 6a 65 63 new Pager objec
2c1b0 74 20 61 6e 64 20 70 75 74 20 61 20 70 6f 69 6e t and put a poin
2c1c0 74 65 72 20 74 6f 20 69 74 0a 2a 2a 20 69 6e 20 ter to it.** in
2c1d0 2a 70 70 50 61 67 65 72 2e 20 54 68 65 20 70 61 *ppPager. The pa
2c1e0 67 65 72 20 73 68 6f 75 6c 64 20 65 76 65 6e 74 ger should event
2c1f0 75 61 6c 6c 79 20 62 65 20 66 72 65 65 64 20 62 ually be freed b
2c200 79 20 70 61 73 73 69 6e 67 20 69 74 0a 2a 2a 20 y passing it.**
2c210 74 6f 20 73 71 6c 69 74 65 33 50 61 67 65 72 43 to sqlite3PagerC
2c220 6c 6f 73 65 28 29 2e 0a 2a 2a 0a 2a 2a 20 54 68 lose()..**.** Th
2c230 65 20 7a 46 69 6c 65 6e 61 6d 65 20 61 72 67 75 e zFilename argu
2c240 6d 65 6e 74 20 69 73 20 74 68 65 20 70 61 74 68 ment is the path
2c250 20 74 6f 20 74 68 65 20 64 61 74 61 62 61 73 65 to the database
2c260 20 66 69 6c 65 20 74 6f 20 6f 70 65 6e 2e 0a 2a file to open..*
2c270 2a 20 49 66 20 7a 46 69 6c 65 6e 61 6d 65 20 69 * If zFilename i
2c280 73 20 4e 55 4c 4c 20 74 68 65 6e 20 61 20 72 61 s NULL then a ra
2c290 6e 64 6f 6d 6c 79 2d 6e 61 6d 65 64 20 74 65 6d ndomly-named tem
2c2a0 70 6f 72 61 72 79 20 66 69 6c 65 20 69 73 20 63 porary file is c
2c2b0 72 65 61 74 65 64 0a 2a 2a 20 61 6e 64 20 75 73 reated.** and us
2c2c0 65 64 20 61 73 20 74 68 65 20 66 69 6c 65 20 74 ed as the file t
2c2d0 6f 20 62 65 20 63 61 63 68 65 64 2e 20 54 65 6d o be cached. Tem
2c2e0 70 6f 72 61 72 79 20 66 69 6c 65 73 20 61 72 65 porary files are
2c2f0 20 62 65 20 64 65 6c 65 74 65 64 0a 2a 2a 20 61 be deleted.** a
2c300 75 74 6f 6d 61 74 69 63 61 6c 6c 79 20 77 68 65 utomatically whe
2c310 6e 20 74 68 65 79 20 61 72 65 20 63 6c 6f 73 65 n they are close
2c320 64 2e 20 49 66 20 7a 46 69 6c 65 6e 61 6d 65 20 d. If zFilename
2c330 69 73 20 22 3a 6d 65 6d 6f 72 79 3a 22 20 74 68 is ":memory:" th
2c340 65 6e 20 0a 2a 2a 20 61 6c 6c 20 69 6e 66 6f 72 en .** all infor
2c350 6d 61 74 69 6f 6e 20 69 73 20 68 65 6c 64 20 69 mation is held i
2c360 6e 20 63 61 63 68 65 2e 20 49 74 20 69 73 20 6e n cache. It is n
2c370 65 76 65 72 20 77 72 69 74 74 65 6e 20 74 6f 20 ever written to
2c380 64 69 73 6b 2e 20 0a 2a 2a 20 54 68 69 73 20 63 disk. .** This c
2c390 61 6e 20 62 65 20 75 73 65 64 20 74 6f 20 69 6d an be used to im
2c3a0 70 6c 65 6d 65 6e 74 20 61 6e 20 69 6e 2d 6d 65 plement an in-me
2c3b0 6d 6f 72 79 20 64 61 74 61 62 61 73 65 2e 0a 2a mory database..*
2c3c0 2a 0a 2a 2a 20 54 68 65 20 6e 45 78 74 72 61 20 *.** The nExtra
2c3d0 70 61 72 61 6d 65 74 65 72 20 73 70 65 63 69 66 parameter specif
2c3e0 69 65 73 20 74 68 65 20 6e 75 6d 62 65 72 20 6f ies the number o
2c3f0 66 20 62 79 74 65 73 20 6f 66 20 73 70 61 63 65 f bytes of space
2c400 20 61 6c 6c 6f 63 61 74 65 64 0a 2a 2a 20 61 6c allocated.** al
2c410 6f 6e 67 20 77 69 74 68 20 65 61 63 68 20 70 61 ong with each pa
2c420 67 65 20 72 65 66 65 72 65 6e 63 65 2e 20 54 68 ge reference. Th
2c430 69 73 20 73 70 61 63 65 20 69 73 20 61 76 61 69 is space is avai
2c440 6c 61 62 6c 65 20 74 6f 20 74 68 65 20 75 73 65 lable to the use
2c450 72 0a 2a 2a 20 76 69 61 20 74 68 65 20 73 71 6c r.** via the sql
2c460 69 74 65 33 50 61 67 65 72 47 65 74 45 78 74 72 ite3PagerGetExtr
2c470 61 28 29 20 41 50 49 2e 0a 2a 2a 0a 2a 2a 20 54 a() API..**.** T
2c480 68 65 20 66 6c 61 67 73 20 61 72 67 75 6d 65 6e he flags argumen
2c490 74 20 69 73 20 75 73 65 64 20 74 6f 20 73 70 65 t is used to spe
2c4a0 63 69 66 79 20 70 72 6f 70 65 72 74 69 65 73 20 cify properties
2c4b0 74 68 61 74 20 61 66 66 65 63 74 20 74 68 65 0a that affect the.
2c4c0 2a 2a 20 6f 70 65 72 61 74 69 6f 6e 20 6f 66 20 ** operation of
2c4d0 74 68 65 20 70 61 67 65 72 2e 20 49 74 20 73 68 the pager. It sh
2c4e0 6f 75 6c 64 20 62 65 20 70 61 73 73 65 64 20 73 ould be passed s
2c4f0 6f 6d 65 20 62 69 74 77 69 73 65 20 63 6f 6d 62 ome bitwise comb
2c500 69 6e 61 74 69 6f 6e 0a 2a 2a 20 6f 66 20 74 68 ination.** of th
2c510 65 20 50 41 47 45 52 5f 2a 20 66 6c 61 67 73 2e e PAGER_* flags.
2c520 0a 2a 2a 0a 2a 2a 20 54 68 65 20 76 66 73 46 6c .**.** The vfsFl
2c530 61 67 73 20 70 61 72 61 6d 65 74 65 72 20 69 73 ags parameter is
2c540 20 61 20 62 69 74 6d 61 73 6b 20 74 6f 20 70 61 a bitmask to pa
2c550 73 73 20 74 6f 20 74 68 65 20 66 6c 61 67 73 20 ss to the flags
2c560 70 61 72 61 6d 65 74 65 72 0a 2a 2a 20 6f 66 20 parameter.** of
2c570 74 68 65 20 78 4f 70 65 6e 28 29 20 6d 65 74 68 the xOpen() meth
2c580 6f 64 20 6f 66 20 74 68 65 20 73 75 70 70 6c 69 od of the suppli
2c590 65 64 20 56 46 53 20 77 68 65 6e 20 6f 70 65 6e ed VFS when open
2c5a0 69 6e 67 20 66 69 6c 65 73 2e 20 0a 2a 2a 0a 2a ing files. .**.*
2c5b0 2a 20 49 66 20 74 68 65 20 70 61 67 65 72 20 6f * If the pager o
2c5c0 62 6a 65 63 74 20 69 73 20 61 6c 6c 6f 63 61 74 bject is allocat
2c5d0 65 64 20 61 6e 64 20 74 68 65 20 73 70 65 63 69 ed and the speci
2c5e0 66 69 65 64 20 66 69 6c 65 20 6f 70 65 6e 65 64 fied file opened
2c5f0 20 0a 2a 2a 20 73 75 63 63 65 73 73 66 75 6c 6c .** successfull
2c600 79 2c 20 53 51 4c 49 54 45 5f 4f 4b 20 69 73 20 y, SQLITE_OK is
2c610 72 65 74 75 72 6e 65 64 20 61 6e 64 20 2a 70 70 returned and *pp
2c620 50 61 67 65 72 20 73 65 74 20 74 6f 20 70 6f 69 Pager set to poi
2c630 6e 74 20 74 6f 0a 2a 2a 20 74 68 65 20 6e 65 77 nt to.** the new
2c640 20 70 61 67 65 72 20 6f 62 6a 65 63 74 2e 20 49 pager object. I
2c650 66 20 61 6e 20 65 72 72 6f 72 20 6f 63 63 75 72 f an error occur
2c660 73 2c 20 2a 70 70 50 61 67 65 72 20 69 73 20 73 s, *ppPager is s
2c670 65 74 20 74 6f 20 4e 55 4c 4c 0a 2a 2a 20 61 6e et to NULL.** an
2c680 64 20 65 72 72 6f 72 20 63 6f 64 65 20 72 65 74 d error code ret
2c690 75 72 6e 65 64 2e 20 54 68 69 73 20 66 75 6e 63 urned. This func
2c6a0 74 69 6f 6e 20 6d 61 79 20 72 65 74 75 72 6e 20 tion may return
2c6b0 53 51 4c 49 54 45 5f 4e 4f 4d 45 4d 0a 2a 2a 20 SQLITE_NOMEM.**
2c6c0 28 73 71 6c 69 74 65 33 4d 61 6c 6c 6f 63 28 29 (sqlite3Malloc()
2c6d0 20 69 73 20 75 73 65 64 20 74 6f 20 61 6c 6c 6f is used to allo
2c6e0 63 61 74 65 20 6d 65 6d 6f 72 79 29 2c 20 53 51 cate memory), SQ
2c6f0 4c 49 54 45 5f 43 41 4e 54 4f 50 45 4e 20 6f 72 LITE_CANTOPEN or
2c700 20 0a 2a 2a 20 76 61 72 69 6f 75 73 20 53 51 4c .** various SQL
2c710 49 54 45 5f 49 4f 5f 58 58 58 20 65 72 72 6f 72 ITE_IO_XXX error
2c720 73 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 s..*/.int sqlite
2c730 33 50 61 67 65 72 4f 70 65 6e 28 0a 20 20 73 71 3PagerOpen(. sq
2c740 6c 69 74 65 33 5f 76 66 73 20 2a 70 56 66 73 2c lite3_vfs *pVfs,
2c750 20 20 20 20 20 20 20 2f 2a 20 54 68 65 20 76 69 /* The vi
2c760 72 74 75 61 6c 20 66 69 6c 65 20 73 79 73 74 65 rtual file syste
2c770 6d 20 74 6f 20 75 73 65 20 2a 2f 0a 20 20 50 61 m to use */. Pa
2c780 67 65 72 20 2a 2a 70 70 50 61 67 65 72 2c 20 20 ger **ppPager,
2c790 20 20 20 20 20 20 20 2f 2a 20 4f 55 54 3a 20 52 /* OUT: R
2c7a0 65 74 75 72 6e 20 74 68 65 20 50 61 67 65 72 20 eturn the Pager
2c7b0 73 74 72 75 63 74 75 72 65 20 68 65 72 65 20 2a structure here *
2c7c0 2f 0a 20 20 63 6f 6e 73 74 20 63 68 61 72 20 2a /. const char *
2c7d0 7a 46 69 6c 65 6e 61 6d 65 2c 20 20 20 2f 2a 20 zFilename, /*
2c7e0 4e 61 6d 65 20 6f 66 20 74 68 65 20 64 61 74 61 Name of the data
2c7f0 62 61 73 65 20 66 69 6c 65 20 74 6f 20 6f 70 65 base file to ope
2c800 6e 20 2a 2f 0a 20 20 69 6e 74 20 6e 45 78 74 72 n */. int nExtr
2c810 61 2c 20 20 20 20 20 20 20 20 20 20 20 20 20 20 a,
2c820 2f 2a 20 45 78 74 72 61 20 62 79 74 65 73 20 61 /* Extra bytes a
2c830 70 70 65 6e 64 20 74 6f 20 65 61 63 68 20 69 6e ppend to each in
2c840 2d 6d 65 6d 6f 72 79 20 70 61 67 65 20 2a 2f 0a -memory page */.
2c850 20 20 69 6e 74 20 66 6c 61 67 73 2c 20 20 20 20 int flags,
2c860 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 66 6c /* fl
2c870 61 67 73 20 63 6f 6e 74 72 6f 6c 6c 69 6e 67 20 ags controlling
2c880 74 68 69 73 20 66 69 6c 65 20 2a 2f 0a 20 20 69 this file */. i
2c890 6e 74 20 76 66 73 46 6c 61 67 73 2c 20 20 20 20 nt vfsFlags,
2c8a0 20 20 20 20 20 20 20 20 2f 2a 20 66 6c 61 67 73 /* flags
2c8b0 20 70 61 73 73 65 64 20 74 68 72 6f 75 67 68 20 passed through
2c8c0 74 6f 20 73 71 6c 69 74 65 33 5f 76 66 73 2e 78 to sqlite3_vfs.x
2c8d0 4f 70 65 6e 28 29 20 2a 2f 0a 20 20 76 6f 69 64 Open() */. void
2c8e0 20 28 2a 78 52 65 69 6e 69 74 29 28 44 62 50 61 (*xReinit)(DbPa
2c8f0 67 65 2a 29 20 2f 2a 20 46 75 6e 63 74 69 6f 6e ge*) /* Function
2c900 20 74 6f 20 72 65 69 6e 69 74 69 61 6c 69 7a 65 to reinitialize
2c910 20 70 61 67 65 73 20 2a 2f 0a 29 7b 0a 20 20 75 pages */.){. u
2c920 38 20 2a 70 50 74 72 3b 0a 20 20 50 61 67 65 72 8 *pPtr;. Pager
2c930 20 2a 70 50 61 67 65 72 20 3d 20 30 3b 20 20 20 *pPager = 0;
2c940 20 20 20 20 2f 2a 20 50 61 67 65 72 20 6f 62 6a /* Pager obj
2c950 65 63 74 20 74 6f 20 61 6c 6c 6f 63 61 74 65 20 ect to allocate
2c960 61 6e 64 20 72 65 74 75 72 6e 20 2a 2f 0a 20 20 and return */.
2c970 69 6e 74 20 72 63 20 3d 20 53 51 4c 49 54 45 5f int rc = SQLITE_
2c980 4f 4b 3b 20 20 20 20 20 20 2f 2a 20 52 65 74 75 OK; /* Retu
2c990 72 6e 20 63 6f 64 65 20 2a 2f 0a 20 20 69 6e 74 rn code */. int
2c9a0 20 74 65 6d 70 46 69 6c 65 20 3d 20 30 3b 20 20 tempFile = 0;
2c9b0 20 20 20 20 20 20 2f 2a 20 54 72 75 65 20 66 6f /* True fo
2c9c0 72 20 74 65 6d 70 20 66 69 6c 65 73 20 28 69 6e r temp files (in
2c9d0 63 6c 2e 20 69 6e 2d 6d 65 6d 6f 72 79 20 66 69 cl. in-memory fi
2c9e0 6c 65 73 29 20 2a 2f 0a 20 20 69 6e 74 20 6d 65 les) */. int me
2c9f0 6d 44 62 20 3d 20 30 3b 20 20 20 20 20 20 20 20 mDb = 0;
2ca00 20 20 20 2f 2a 20 54 72 75 65 20 69 66 20 74 68 /* True if th
2ca10 69 73 20 69 73 20 61 6e 20 69 6e 2d 6d 65 6d 6f is is an in-memo
2ca20 72 79 20 66 69 6c 65 20 2a 2f 0a 20 20 69 6e 74 ry file */. int
2ca30 20 72 65 61 64 4f 6e 6c 79 20 3d 20 30 3b 20 20 readOnly = 0;
2ca40 20 20 20 20 20 20 2f 2a 20 54 72 75 65 20 69 66 /* True if
2ca50 20 74 68 69 73 20 69 73 20 61 20 72 65 61 64 2d this is a read-
2ca60 6f 6e 6c 79 20 66 69 6c 65 20 2a 2f 0a 20 20 69 only file */. i
2ca70 6e 74 20 6a 6f 75 72 6e 61 6c 46 69 6c 65 53 69 nt journalFileSi
2ca80 7a 65 3b 20 20 20 20 20 2f 2a 20 42 79 74 65 73 ze; /* Bytes
2ca90 20 74 6f 20 61 6c 6c 6f 63 61 74 65 20 66 6f 72 to allocate for
2caa0 20 65 61 63 68 20 6a 6f 75 72 6e 61 6c 20 66 64 each journal fd
2cab0 20 2a 2f 0a 20 20 63 68 61 72 20 2a 7a 50 61 74 */. char *zPat
2cac0 68 6e 61 6d 65 20 3d 20 30 3b 20 20 20 20 20 2f hname = 0; /
2cad0 2a 20 46 75 6c 6c 20 70 61 74 68 20 74 6f 20 64 * Full path to d
2cae0 61 74 61 62 61 73 65 20 66 69 6c 65 20 2a 2f 0a atabase file */.
2caf0 20 20 69 6e 74 20 6e 50 61 74 68 6e 61 6d 65 20 int nPathname
2cb00 3d 20 30 3b 20 20 20 20 20 20 20 2f 2a 20 4e 75 = 0; /* Nu
2cb10 6d 62 65 72 20 6f 66 20 62 79 74 65 73 20 69 6e mber of bytes in
2cb20 20 7a 50 61 74 68 6e 61 6d 65 20 2a 2f 0a 20 20 zPathname */.
2cb30 69 6e 74 20 75 73 65 4a 6f 75 72 6e 61 6c 20 3d int useJournal =
2cb40 20 28 66 6c 61 67 73 20 26 20 50 41 47 45 52 5f (flags & PAGER_
2cb50 4f 4d 49 54 5f 4a 4f 55 52 4e 41 4c 29 3d 3d 30 OMIT_JOURNAL)==0
2cb60 3b 20 2f 2a 20 46 61 6c 73 65 20 74 6f 20 6f 6d ; /* False to om
2cb70 69 74 20 6a 6f 75 72 6e 61 6c 20 2a 2f 0a 20 20 it journal */.
2cb80 69 6e 74 20 70 63 61 63 68 65 53 69 7a 65 20 3d int pcacheSize =
2cb90 20 73 71 6c 69 74 65 33 50 63 61 63 68 65 53 69 sqlite3PcacheSi
2cba0 7a 65 28 29 3b 20 20 20 20 20 20 20 2f 2a 20 42 ze(); /* B
2cbb0 79 74 65 73 20 74 6f 20 61 6c 6c 6f 63 61 74 65 ytes to allocate
2cbc0 20 66 6f 72 20 50 43 61 63 68 65 20 2a 2f 0a 20 for PCache */.
2cbd0 20 75 33 32 20 73 7a 50 61 67 65 44 66 6c 74 20 u32 szPageDflt
2cbe0 3d 20 53 51 4c 49 54 45 5f 44 45 46 41 55 4c 54 = SQLITE_DEFAULT
2cbf0 5f 50 41 47 45 5f 53 49 5a 45 3b 20 20 2f 2a 20 _PAGE_SIZE; /*
2cc00 44 65 66 61 75 6c 74 20 70 61 67 65 20 73 69 7a Default page siz
2cc10 65 20 2a 2f 0a 20 20 63 6f 6e 73 74 20 63 68 61 e */. const cha
2cc20 72 20 2a 7a 55 72 69 20 3d 20 30 3b 20 20 20 20 r *zUri = 0;
2cc30 2f 2a 20 55 52 49 20 61 72 67 73 20 74 6f 20 63 /* URI args to c
2cc40 6f 70 79 20 2a 2f 0a 20 20 69 6e 74 20 6e 55 72 opy */. int nUr
2cc50 69 20 3d 20 30 3b 20 20 20 20 20 20 20 20 20 20 i = 0;
2cc60 20 20 2f 2a 20 4e 75 6d 62 65 72 20 6f 66 20 62 /* Number of b
2cc70 79 74 65 73 20 6f 66 20 55 52 49 20 61 72 67 73 ytes of URI args
2cc80 20 61 74 20 2a 7a 55 72 69 20 2a 2f 0a 0a 20 20 at *zUri */..
2cc90 2f 2a 20 46 69 67 75 72 65 20 6f 75 74 20 68 6f /* Figure out ho
2cca0 77 20 6d 75 63 68 20 73 70 61 63 65 20 69 73 20 w much space is
2ccb0 72 65 71 75 69 72 65 64 20 66 6f 72 20 65 61 63 required for eac
2ccc0 68 20 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 2d 68 h journal file-h
2ccd0 61 6e 64 6c 65 0a 20 20 2a 2a 20 28 74 68 65 72 andle. ** (ther
2cce0 65 20 61 72 65 20 74 77 6f 20 6f 66 20 74 68 65 e are two of the
2ccf0 6d 2c 20 74 68 65 20 6d 61 69 6e 20 6a 6f 75 72 m, the main jour
2cd00 6e 61 6c 20 61 6e 64 20 74 68 65 20 73 75 62 2d nal and the sub-
2cd10 6a 6f 75 72 6e 61 6c 29 2e 20 20 2a 2f 0a 20 20 journal). */.
2cd20 6a 6f 75 72 6e 61 6c 46 69 6c 65 53 69 7a 65 20 journalFileSize
2cd30 3d 20 52 4f 55 4e 44 38 28 73 71 6c 69 74 65 33 = ROUND8(sqlite3
2cd40 4a 6f 75 72 6e 61 6c 53 69 7a 65 28 70 56 66 73 JournalSize(pVfs
2cd50 29 29 3b 0a 0a 20 20 2f 2a 20 53 65 74 20 74 68 ));.. /* Set th
2cd60 65 20 6f 75 74 70 75 74 20 76 61 72 69 61 62 6c e output variabl
2cd70 65 20 74 6f 20 4e 55 4c 4c 20 69 6e 20 63 61 73 e to NULL in cas
2cd80 65 20 61 6e 20 65 72 72 6f 72 20 6f 63 63 75 72 e an error occur
2cd90 73 2e 20 2a 2f 0a 20 20 2a 70 70 50 61 67 65 72 s. */. *ppPager
2cda0 20 3d 20 30 3b 0a 0a 23 69 66 6e 64 65 66 20 53 = 0;..#ifndef S
2cdb0 51 4c 49 54 45 5f 4f 4d 49 54 5f 4d 45 4d 4f 52 QLITE_OMIT_MEMOR
2cdc0 59 44 42 0a 20 20 69 66 28 20 66 6c 61 67 73 20 YDB. if( flags
2cdd0 26 20 50 41 47 45 52 5f 4d 45 4d 4f 52 59 20 29 & PAGER_MEMORY )
2cde0 7b 0a 20 20 20 20 6d 65 6d 44 62 20 3d 20 31 3b {. memDb = 1;
2cdf0 0a 20 20 20 20 69 66 28 20 7a 46 69 6c 65 6e 61 . if( zFilena
2ce00 6d 65 20 26 26 20 7a 46 69 6c 65 6e 61 6d 65 5b me && zFilename[
2ce10 30 5d 20 29 7b 0a 20 20 20 20 20 20 7a 50 61 74 0] ){. zPat
2ce20 68 6e 61 6d 65 20 3d 20 73 71 6c 69 74 65 33 44 hname = sqlite3D
2ce30 62 53 74 72 44 75 70 28 30 2c 20 7a 46 69 6c 65 bStrDup(0, zFile
2ce40 6e 61 6d 65 29 3b 0a 20 20 20 20 20 20 69 66 28 name);. if(
2ce50 20 7a 50 61 74 68 6e 61 6d 65 3d 3d 30 20 20 29 zPathname==0 )
2ce60 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4e return SQLITE_N
2ce70 4f 4d 45 4d 5f 42 4b 50 54 3b 0a 20 20 20 20 20 OMEM_BKPT;.
2ce80 20 6e 50 61 74 68 6e 61 6d 65 20 3d 20 73 71 6c nPathname = sql
2ce90 69 74 65 33 53 74 72 6c 65 6e 33 30 28 7a 50 61 ite3Strlen30(zPa
2cea0 74 68 6e 61 6d 65 29 3b 0a 20 20 20 20 20 20 7a thname);. z
2ceb0 46 69 6c 65 6e 61 6d 65 20 3d 20 30 3b 0a 20 20 Filename = 0;.
2cec0 20 20 7d 0a 20 20 7d 0a 23 65 6e 64 69 66 0a 0a }. }.#endif..
2ced0 20 20 2f 2a 20 43 6f 6d 70 75 74 65 20 61 6e 64 /* Compute and
2cee0 20 73 74 6f 72 65 20 74 68 65 20 66 75 6c 6c 20 store the full
2cef0 70 61 74 68 6e 61 6d 65 20 69 6e 20 61 6e 20 61 pathname in an a
2cf00 6c 6c 6f 63 61 74 65 64 20 62 75 66 66 65 72 20 llocated buffer
2cf10 70 6f 69 6e 74 65 64 0a 20 20 2a 2a 20 74 6f 20 pointed. ** to
2cf20 62 79 20 7a 50 61 74 68 6e 61 6d 65 2c 20 6c 65 by zPathname, le
2cf30 6e 67 74 68 20 6e 50 61 74 68 6e 61 6d 65 2e 20 ngth nPathname.
2cf40 4f 72 2c 20 69 66 20 74 68 69 73 20 69 73 20 61 Or, if this is a
2cf50 20 74 65 6d 70 6f 72 61 72 79 20 66 69 6c 65 2c temporary file,
2cf60 0a 20 20 2a 2a 20 6c 65 61 76 65 20 62 6f 74 68 . ** leave both
2cf70 20 6e 50 61 74 68 6e 61 6d 65 20 61 6e 64 20 7a nPathname and z
2cf80 50 61 74 68 6e 61 6d 65 20 73 65 74 20 74 6f 20 Pathname set to
2cf90 30 2e 0a 20 20 2a 2f 0a 20 20 69 66 28 20 7a 46 0.. */. if( zF
2cfa0 69 6c 65 6e 61 6d 65 20 26 26 20 7a 46 69 6c 65 ilename && zFile
2cfb0 6e 61 6d 65 5b 30 5d 20 29 7b 0a 20 20 20 20 63 name[0] ){. c
2cfc0 6f 6e 73 74 20 63 68 61 72 20 2a 7a 3b 0a 20 20 onst char *z;.
2cfd0 20 20 6e 50 61 74 68 6e 61 6d 65 20 3d 20 70 56 nPathname = pV
2cfe0 66 73 2d 3e 6d 78 50 61 74 68 6e 61 6d 65 2b 31 fs->mxPathname+1
2cff0 3b 0a 20 20 20 20 7a 50 61 74 68 6e 61 6d 65 20 ;. zPathname
2d000 3d 20 73 71 6c 69 74 65 33 44 62 4d 61 6c 6c 6f = sqlite3DbMallo
2d010 63 52 61 77 28 30 2c 20 6e 50 61 74 68 6e 61 6d cRaw(0, nPathnam
2d020 65 2a 32 29 3b 0a 20 20 20 20 69 66 28 20 7a 50 e*2);. if( zP
2d030 61 74 68 6e 61 6d 65 3d 3d 30 20 29 7b 0a 20 20 athname==0 ){.
2d040 20 20 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 return SQLIT
2d050 45 5f 4e 4f 4d 45 4d 5f 42 4b 50 54 3b 0a 20 20 E_NOMEM_BKPT;.
2d060 20 20 7d 0a 20 20 20 20 7a 50 61 74 68 6e 61 6d }. zPathnam
2d070 65 5b 30 5d 20 3d 20 30 3b 20 2f 2a 20 4d 61 6b e[0] = 0; /* Mak
2d080 65 20 73 75 72 65 20 69 6e 69 74 69 61 6c 69 7a e sure initializ
2d090 65 64 20 65 76 65 6e 20 69 66 20 46 75 6c 6c 50 ed even if FullP
2d0a0 61 74 68 6e 61 6d 65 28 29 20 66 61 69 6c 73 20 athname() fails
2d0b0 2a 2f 0a 20 20 20 20 72 63 20 3d 20 73 71 6c 69 */. rc = sqli
2d0c0 74 65 33 4f 73 46 75 6c 6c 50 61 74 68 6e 61 6d te3OsFullPathnam
2d0d0 65 28 70 56 66 73 2c 20 7a 46 69 6c 65 6e 61 6d e(pVfs, zFilenam
2d0e0 65 2c 20 6e 50 61 74 68 6e 61 6d 65 2c 20 7a 50 e, nPathname, zP
2d0f0 61 74 68 6e 61 6d 65 29 3b 0a 20 20 20 20 6e 50 athname);. nP
2d100 61 74 68 6e 61 6d 65 20 3d 20 73 71 6c 69 74 65 athname = sqlite
2d110 33 53 74 72 6c 65 6e 33 30 28 7a 50 61 74 68 6e 3Strlen30(zPathn
2d120 61 6d 65 29 3b 0a 20 20 20 20 7a 20 3d 20 7a 55 ame);. z = zU
2d130 72 69 20 3d 20 26 7a 46 69 6c 65 6e 61 6d 65 5b ri = &zFilename[
2d140 73 71 6c 69 74 65 33 53 74 72 6c 65 6e 33 30 28 sqlite3Strlen30(
2d150 7a 46 69 6c 65 6e 61 6d 65 29 2b 31 5d 3b 0a 20 zFilename)+1];.
2d160 20 20 20 77 68 69 6c 65 28 20 2a 7a 20 29 7b 0a while( *z ){.
2d170 20 20 20 20 20 20 7a 20 2b 3d 20 73 71 6c 69 74 z += sqlit
2d180 65 33 53 74 72 6c 65 6e 33 30 28 7a 29 2b 31 3b e3Strlen30(z)+1;
2d190 0a 20 20 20 20 20 20 7a 20 2b 3d 20 73 71 6c 69 . z += sqli
2d1a0 74 65 33 53 74 72 6c 65 6e 33 30 28 7a 29 2b 31 te3Strlen30(z)+1
2d1b0 3b 0a 20 20 20 20 7d 0a 20 20 20 20 6e 55 72 69 ;. }. nUri
2d1c0 20 3d 20 28 69 6e 74 29 28 26 7a 5b 31 5d 20 2d = (int)(&z[1] -
2d1d0 20 7a 55 72 69 29 3b 0a 20 20 20 20 61 73 73 65 zUri);. asse
2d1e0 72 74 28 20 6e 55 72 69 3e 3d 30 20 29 3b 0a 20 rt( nUri>=0 );.
2d1f0 20 20 20 69 66 28 20 72 63 3d 3d 53 51 4c 49 54 if( rc==SQLIT
2d200 45 5f 4f 4b 20 26 26 20 6e 50 61 74 68 6e 61 6d E_OK && nPathnam
2d210 65 2b 38 3e 70 56 66 73 2d 3e 6d 78 50 61 74 68 e+8>pVfs->mxPath
2d220 6e 61 6d 65 20 29 7b 0a 20 20 20 20 20 20 2f 2a name ){. /*
2d230 20 54 68 69 73 20 62 72 61 6e 63 68 20 69 73 20 This branch is
2d240 74 61 6b 65 6e 20 77 68 65 6e 20 74 68 65 20 6a taken when the j
2d250 6f 75 72 6e 61 6c 20 70 61 74 68 20 72 65 71 75 ournal path requ
2d260 69 72 65 64 20 62 79 0a 20 20 20 20 20 20 2a 2a ired by. **
2d270 20 74 68 65 20 64 61 74 61 62 61 73 65 20 62 65 the database be
2d280 69 6e 67 20 6f 70 65 6e 65 64 20 77 69 6c 6c 20 ing opened will
2d290 62 65 20 6d 6f 72 65 20 74 68 61 6e 20 70 56 66 be more than pVf
2d2a0 73 2d 3e 6d 78 50 61 74 68 6e 61 6d 65 0a 20 20 s->mxPathname.
2d2b0 20 20 20 20 2a 2a 20 62 79 74 65 73 20 69 6e 20 ** bytes in
2d2c0 6c 65 6e 67 74 68 2e 20 54 68 69 73 20 6d 65 61 length. This mea
2d2d0 6e 73 20 74 68 65 20 64 61 74 61 62 61 73 65 20 ns the database
2d2e0 63 61 6e 6e 6f 74 20 62 65 20 6f 70 65 6e 65 64 cannot be opened
2d2f0 2c 0a 20 20 20 20 20 20 2a 2a 20 61 73 20 69 74 ,. ** as it
2d300 20 77 69 6c 6c 20 6e 6f 74 20 62 65 20 70 6f 73 will not be pos
2d310 73 69 62 6c 65 20 74 6f 20 6f 70 65 6e 20 74 68 sible to open th
2d320 65 20 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 20 6f e journal file o
2d330 72 20 65 76 65 6e 0a 20 20 20 20 20 20 2a 2a 20 r even. **
2d340 63 68 65 63 6b 20 66 6f 72 20 61 20 68 6f 74 2d check for a hot-
2d350 6a 6f 75 72 6e 61 6c 20 62 65 66 6f 72 65 20 72 journal before r
2d360 65 61 64 69 6e 67 2e 0a 20 20 20 20 20 20 2a 2f eading.. */
2d370 0a 20 20 20 20 20 20 72 63 20 3d 20 53 51 4c 49 . rc = SQLI
2d380 54 45 5f 43 41 4e 54 4f 50 45 4e 5f 42 4b 50 54 TE_CANTOPEN_BKPT
2d390 3b 0a 20 20 20 20 7d 0a 20 20 20 20 69 66 28 20 ;. }. if(
2d3a0 72 63 21 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b rc!=SQLITE_OK ){
2d3b0 0a 20 20 20 20 20 20 73 71 6c 69 74 65 33 44 62 . sqlite3Db
2d3c0 46 72 65 65 28 30 2c 20 7a 50 61 74 68 6e 61 6d Free(0, zPathnam
2d3d0 65 29 3b 0a 20 20 20 20 20 20 72 65 74 75 72 6e e);. return
2d3e0 20 72 63 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a 0a rc;. }. }..
2d3f0 20 20 2f 2a 20 41 6c 6c 6f 63 61 74 65 20 6d 65 /* Allocate me
2d400 6d 6f 72 79 20 66 6f 72 20 74 68 65 20 50 61 67 mory for the Pag
2d410 65 72 20 73 74 72 75 63 74 75 72 65 2c 20 50 43 er structure, PC
2d420 61 63 68 65 20 6f 62 6a 65 63 74 2c 20 74 68 65 ache object, the
2d430 0a 20 20 2a 2a 20 74 68 72 65 65 20 66 69 6c 65 . ** three file
2d440 20 64 65 73 63 72 69 70 74 6f 72 73 2c 20 74 68 descriptors, th
2d450 65 20 64 61 74 61 62 61 73 65 20 66 69 6c 65 20 e database file
2d460 6e 61 6d 65 20 61 6e 64 20 74 68 65 20 6a 6f 75 name and the jou
2d470 72 6e 61 6c 20 0a 20 20 2a 2a 20 66 69 6c 65 20 rnal . ** file
2d480 6e 61 6d 65 2e 20 54 68 65 20 6c 61 79 6f 75 74 name. The layout
2d490 20 69 6e 20 6d 65 6d 6f 72 79 20 69 73 20 61 73 in memory is as
2d4a0 20 66 6f 6c 6c 6f 77 73 3a 0a 20 20 2a 2a 0a 20 follows:. **.
2d4b0 20 2a 2a 20 20 20 20 20 50 61 67 65 72 20 6f 62 ** Pager ob
2d4c0 6a 65 63 74 20 20 20 20 20 20 20 20 20 20 20 20 ject
2d4d0 20 20 20 20 20 20 20 20 28 73 69 7a 65 6f 66 28 (sizeof(
2d4e0 50 61 67 65 72 29 20 62 79 74 65 73 29 0a 20 20 Pager) bytes).
2d4f0 2a 2a 20 20 20 20 20 50 43 61 63 68 65 20 6f 62 ** PCache ob
2d500 6a 65 63 74 20 20 20 20 20 20 20 20 20 20 20 20 ject
2d510 20 20 20 20 20 20 20 28 73 71 6c 69 74 65 33 50 (sqlite3P
2d520 63 61 63 68 65 53 69 7a 65 28 29 20 62 79 74 65 cacheSize() byte
2d530 73 29 0a 20 20 2a 2a 20 20 20 20 20 44 61 74 61 s). ** Data
2d540 62 61 73 65 20 66 69 6c 65 20 68 61 6e 64 6c 65 base file handle
2d550 20 20 20 20 20 20 20 20 20 20 20 20 28 70 56 66 (pVf
2d560 73 2d 3e 73 7a 4f 73 46 69 6c 65 20 62 79 74 65 s->szOsFile byte
2d570 73 29 0a 20 20 2a 2a 20 20 20 20 20 53 75 62 2d s). ** Sub-
2d580 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 20 68 61 6e journal file han
2d590 64 6c 65 20 20 20 20 20 20 20 20 20 28 6a 6f 75 dle (jou
2d5a0 72 6e 61 6c 46 69 6c 65 53 69 7a 65 20 62 79 74 rnalFileSize byt
2d5b0 65 73 29 0a 20 20 2a 2a 20 20 20 20 20 4d 61 69 es). ** Mai
2d5c0 6e 20 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 20 68 n journal file h
2d5d0 61 6e 64 6c 65 20 20 20 20 20 20 20 20 28 6a 6f andle (jo
2d5e0 75 72 6e 61 6c 46 69 6c 65 53 69 7a 65 20 62 79 urnalFileSize by
2d5f0 74 65 73 29 0a 20 20 2a 2a 20 20 20 20 20 44 61 tes). ** Da
2d600 74 61 62 61 73 65 20 66 69 6c 65 20 6e 61 6d 65 tabase file name
2d610 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 6e (n
2d620 50 61 74 68 6e 61 6d 65 2b 31 20 62 79 74 65 73 Pathname+1 bytes
2d630 29 0a 20 20 2a 2a 20 20 20 20 20 4a 6f 75 72 6e ). ** Journ
2d640 61 6c 20 66 69 6c 65 20 6e 61 6d 65 20 20 20 20 al file name
2d650 20 20 20 20 20 20 20 20 20 20 20 28 6e 50 61 74 (nPat
2d660 68 6e 61 6d 65 2b 38 2b 31 20 62 79 74 65 73 29 hname+8+1 bytes)
2d670 0a 20 20 2a 2f 0a 20 20 70 50 74 72 20 3d 20 28 . */. pPtr = (
2d680 75 38 20 2a 29 73 71 6c 69 74 65 33 4d 61 6c 6c u8 *)sqlite3Mall
2d690 6f 63 5a 65 72 6f 28 0a 20 20 20 20 52 4f 55 4e ocZero(. ROUN
2d6a0 44 38 28 73 69 7a 65 6f 66 28 2a 70 50 61 67 65 D8(sizeof(*pPage
2d6b0 72 29 29 20 2b 20 20 20 20 20 20 2f 2a 20 50 61 r)) + /* Pa
2d6c0 67 65 72 20 73 74 72 75 63 74 75 72 65 20 2a 2f ger structure */
2d6d0 0a 20 20 20 20 52 4f 55 4e 44 38 28 70 63 61 63 . ROUND8(pcac
2d6e0 68 65 53 69 7a 65 29 20 2b 20 20 20 20 20 20 20 heSize) +
2d6f0 20 20 20 20 2f 2a 20 50 43 61 63 68 65 20 6f 62 /* PCache ob
2d700 6a 65 63 74 20 2a 2f 0a 20 20 20 20 52 4f 55 4e ject */. ROUN
2d710 44 38 28 70 56 66 73 2d 3e 73 7a 4f 73 46 69 6c D8(pVfs->szOsFil
2d720 65 29 20 2b 20 20 20 20 20 20 20 2f 2a 20 54 68 e) + /* Th
2d730 65 20 6d 61 69 6e 20 64 62 20 66 69 6c 65 20 2a e main db file *
2d740 2f 0a 20 20 20 20 6a 6f 75 72 6e 61 6c 46 69 6c /. journalFil
2d750 65 53 69 7a 65 20 2a 20 32 20 2b 20 20 20 20 20 eSize * 2 +
2d760 20 20 20 20 20 2f 2a 20 54 68 65 20 74 77 6f 20 /* The two
2d770 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 73 20 2a 2f journal files */
2d780 20 0a 20 20 20 20 6e 50 61 74 68 6e 61 6d 65 20 . nPathname
2d790 2b 20 31 20 2b 20 6e 55 72 69 20 2b 20 20 20 20 + 1 + nUri +
2d7a0 20 20 20 20 20 2f 2a 20 7a 46 69 6c 65 6e 61 6d /* zFilenam
2d7b0 65 20 2a 2f 0a 20 20 20 20 6e 50 61 74 68 6e 61 e */. nPathna
2d7c0 6d 65 20 2b 20 38 20 2b 20 32 20 20 20 20 20 20 me + 8 + 2
2d7d0 20 20 20 20 20 20 20 20 2f 2a 20 7a 4a 6f 75 72 /* zJour
2d7e0 6e 61 6c 20 2a 2f 0a 23 69 66 6e 64 65 66 20 53 nal */.#ifndef S
2d7f0 51 4c 49 54 45 5f 4f 4d 49 54 5f 57 41 4c 0a 20 QLITE_OMIT_WAL.
2d800 20 20 20 2b 20 6e 50 61 74 68 6e 61 6d 65 20 2b + nPathname +
2d810 20 34 20 2b 20 32 20 20 20 20 20 20 20 20 20 20 4 + 2
2d820 20 20 2f 2a 20 7a 57 61 6c 20 2a 2f 0a 23 65 6e /* zWal */.#en
2d830 64 69 66 0a 20 20 29 3b 0a 20 20 61 73 73 65 72 dif. );. asser
2d840 74 28 20 45 49 47 48 54 5f 42 59 54 45 5f 41 4c t( EIGHT_BYTE_AL
2d850 49 47 4e 4d 45 4e 54 28 53 51 4c 49 54 45 5f 49 IGNMENT(SQLITE_I
2d860 4e 54 5f 54 4f 5f 50 54 52 28 6a 6f 75 72 6e 61 NT_TO_PTR(journa
2d870 6c 46 69 6c 65 53 69 7a 65 29 29 20 29 3b 0a 20 lFileSize)) );.
2d880 20 69 66 28 20 21 70 50 74 72 20 29 7b 0a 20 20 if( !pPtr ){.
2d890 20 20 73 71 6c 69 74 65 33 44 62 46 72 65 65 28 sqlite3DbFree(
2d8a0 30 2c 20 7a 50 61 74 68 6e 61 6d 65 29 3b 0a 20 0, zPathname);.
2d8b0 20 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 return SQLITE
2d8c0 5f 4e 4f 4d 45 4d 5f 42 4b 50 54 3b 0a 20 20 7d _NOMEM_BKPT;. }
2d8d0 0a 20 20 70 50 61 67 65 72 20 3d 20 20 20 20 20 . pPager =
2d8e0 20 20 20 20 20 20 20 20 20 28 50 61 67 65 72 2a (Pager*
2d8f0 29 28 70 50 74 72 29 3b 0a 20 20 70 50 61 67 65 )(pPtr);. pPage
2d900 72 2d 3e 70 50 43 61 63 68 65 20 3d 20 20 20 20 r->pPCache =
2d910 28 50 43 61 63 68 65 2a 29 28 70 50 74 72 20 2b (PCache*)(pPtr +
2d920 3d 20 52 4f 55 4e 44 38 28 73 69 7a 65 6f 66 28 = ROUND8(sizeof(
2d930 2a 70 50 61 67 65 72 29 29 29 3b 0a 20 20 70 50 *pPager)));. pP
2d940 61 67 65 72 2d 3e 66 64 20 3d 20 20 20 28 73 71 ager->fd = (sq
2d950 6c 69 74 65 33 5f 66 69 6c 65 2a 29 28 70 50 74 lite3_file*)(pPt
2d960 72 20 2b 3d 20 52 4f 55 4e 44 38 28 70 63 61 63 r += ROUND8(pcac
2d970 68 65 53 69 7a 65 29 29 3b 0a 20 20 70 50 61 67 heSize));. pPag
2d980 65 72 2d 3e 73 6a 66 64 20 3d 20 28 73 71 6c 69 er->sjfd = (sqli
2d990 74 65 33 5f 66 69 6c 65 2a 29 28 70 50 74 72 20 te3_file*)(pPtr
2d9a0 2b 3d 20 52 4f 55 4e 44 38 28 70 56 66 73 2d 3e += ROUND8(pVfs->
2d9b0 73 7a 4f 73 46 69 6c 65 29 29 3b 0a 20 20 70 50 szOsFile));. pP
2d9c0 61 67 65 72 2d 3e 6a 66 64 20 3d 20 20 28 73 71 ager->jfd = (sq
2d9d0 6c 69 74 65 33 5f 66 69 6c 65 2a 29 28 70 50 74 lite3_file*)(pPt
2d9e0 72 20 2b 3d 20 6a 6f 75 72 6e 61 6c 46 69 6c 65 r += journalFile
2d9f0 53 69 7a 65 29 3b 0a 20 20 70 50 61 67 65 72 2d Size);. pPager-
2da00 3e 7a 46 69 6c 65 6e 61 6d 65 20 3d 20 20 20 20 >zFilename =
2da10 28 63 68 61 72 2a 29 28 70 50 74 72 20 2b 3d 20 (char*)(pPtr +=
2da20 6a 6f 75 72 6e 61 6c 46 69 6c 65 53 69 7a 65 29 journalFileSize)
2da30 3b 0a 20 20 61 73 73 65 72 74 28 20 45 49 47 48 ;. assert( EIGH
2da40 54 5f 42 59 54 45 5f 41 4c 49 47 4e 4d 45 4e 54 T_BYTE_ALIGNMENT
2da50 28 70 50 61 67 65 72 2d 3e 6a 66 64 29 20 29 3b (pPager->jfd) );
2da60 0a 0a 20 20 2f 2a 20 46 69 6c 6c 20 69 6e 20 74 .. /* Fill in t
2da70 68 65 20 50 61 67 65 72 2e 7a 46 69 6c 65 6e 61 he Pager.zFilena
2da80 6d 65 20 61 6e 64 20 50 61 67 65 72 2e 7a 4a 6f me and Pager.zJo
2da90 75 72 6e 61 6c 20 62 75 66 66 65 72 73 2c 20 69 urnal buffers, i
2daa0 66 20 72 65 71 75 69 72 65 64 2e 20 2a 2f 0a 20 f required. */.
2dab0 20 69 66 28 20 7a 50 61 74 68 6e 61 6d 65 20 29 if( zPathname )
2dac0 7b 0a 20 20 20 20 61 73 73 65 72 74 28 20 6e 50 {. assert( nP
2dad0 61 74 68 6e 61 6d 65 3e 30 20 29 3b 0a 20 20 20 athname>0 );.
2dae0 20 70 50 61 67 65 72 2d 3e 7a 4a 6f 75 72 6e 61 pPager->zJourna
2daf0 6c 20 3d 20 20 20 28 63 68 61 72 2a 29 28 70 50 l = (char*)(pP
2db00 74 72 20 2b 3d 20 6e 50 61 74 68 6e 61 6d 65 20 tr += nPathname
2db10 2b 20 31 20 2b 20 6e 55 72 69 29 3b 0a 20 20 20 + 1 + nUri);.
2db20 20 6d 65 6d 63 70 79 28 70 50 61 67 65 72 2d 3e memcpy(pPager->
2db30 7a 46 69 6c 65 6e 61 6d 65 2c 20 7a 50 61 74 68 zFilename, zPath
2db40 6e 61 6d 65 2c 20 6e 50 61 74 68 6e 61 6d 65 29 name, nPathname)
2db50 3b 0a 20 20 20 20 69 66 28 20 6e 55 72 69 20 29 ;. if( nUri )
2db60 20 6d 65 6d 63 70 79 28 26 70 50 61 67 65 72 2d memcpy(&pPager-
2db70 3e 7a 46 69 6c 65 6e 61 6d 65 5b 6e 50 61 74 68 >zFilename[nPath
2db80 6e 61 6d 65 2b 31 5d 2c 20 7a 55 72 69 2c 20 6e name+1], zUri, n
2db90 55 72 69 29 3b 0a 20 20 20 20 6d 65 6d 63 70 79 Uri);. memcpy
2dba0 28 70 50 61 67 65 72 2d 3e 7a 4a 6f 75 72 6e 61 (pPager->zJourna
2dbb0 6c 2c 20 7a 50 61 74 68 6e 61 6d 65 2c 20 6e 50 l, zPathname, nP
2dbc0 61 74 68 6e 61 6d 65 29 3b 0a 20 20 20 20 6d 65 athname);. me
2dbd0 6d 63 70 79 28 26 70 50 61 67 65 72 2d 3e 7a 4a mcpy(&pPager->zJ
2dbe0 6f 75 72 6e 61 6c 5b 6e 50 61 74 68 6e 61 6d 65 ournal[nPathname
2dbf0 5d 2c 20 22 2d 6a 6f 75 72 6e 61 6c 5c 30 30 30 ], "-journal\000
2dc00 22 2c 20 38 2b 32 29 3b 0a 20 20 20 20 73 71 6c ", 8+2);. sql
2dc10 69 74 65 33 46 69 6c 65 53 75 66 66 69 78 33 28 ite3FileSuffix3(
2dc20 70 50 61 67 65 72 2d 3e 7a 46 69 6c 65 6e 61 6d pPager->zFilenam
2dc30 65 2c 20 70 50 61 67 65 72 2d 3e 7a 4a 6f 75 72 e, pPager->zJour
2dc40 6e 61 6c 29 3b 0a 23 69 66 6e 64 65 66 20 53 51 nal);.#ifndef SQ
2dc50 4c 49 54 45 5f 4f 4d 49 54 5f 57 41 4c 0a 20 20 LITE_OMIT_WAL.
2dc60 20 20 70 50 61 67 65 72 2d 3e 7a 57 61 6c 20 3d pPager->zWal =
2dc70 20 26 70 50 61 67 65 72 2d 3e 7a 4a 6f 75 72 6e &pPager->zJourn
2dc80 61 6c 5b 6e 50 61 74 68 6e 61 6d 65 2b 38 2b 31 al[nPathname+8+1
2dc90 5d 3b 0a 20 20 20 20 6d 65 6d 63 70 79 28 70 50 ];. memcpy(pP
2dca0 61 67 65 72 2d 3e 7a 57 61 6c 2c 20 7a 50 61 74 ager->zWal, zPat
2dcb0 68 6e 61 6d 65 2c 20 6e 50 61 74 68 6e 61 6d 65 hname, nPathname
2dcc0 29 3b 0a 20 20 20 20 6d 65 6d 63 70 79 28 26 70 );. memcpy(&p
2dcd0 50 61 67 65 72 2d 3e 7a 57 61 6c 5b 6e 50 61 74 Pager->zWal[nPat
2dce0 68 6e 61 6d 65 5d 2c 20 22 2d 77 61 6c 5c 30 30 hname], "-wal\00
2dcf0 30 22 2c 20 34 2b 31 29 3b 0a 20 20 20 20 73 71 0", 4+1);. sq
2dd00 6c 69 74 65 33 46 69 6c 65 53 75 66 66 69 78 33 lite3FileSuffix3
2dd10 28 70 50 61 67 65 72 2d 3e 7a 46 69 6c 65 6e 61 (pPager->zFilena
2dd20 6d 65 2c 20 70 50 61 67 65 72 2d 3e 7a 57 61 6c me, pPager->zWal
2dd30 29 3b 0a 23 65 6e 64 69 66 0a 20 20 20 20 73 71 );.#endif. sq
2dd40 6c 69 74 65 33 44 62 46 72 65 65 28 30 2c 20 7a lite3DbFree(0, z
2dd50 50 61 74 68 6e 61 6d 65 29 3b 0a 20 20 7d 0a 20 Pathname);. }.
2dd60 20 70 50 61 67 65 72 2d 3e 70 56 66 73 20 3d 20 pPager->pVfs =
2dd70 70 56 66 73 3b 0a 20 20 70 50 61 67 65 72 2d 3e pVfs;. pPager->
2dd80 76 66 73 46 6c 61 67 73 20 3d 20 76 66 73 46 6c vfsFlags = vfsFl
2dd90 61 67 73 3b 0a 0a 20 20 2f 2a 20 4f 70 65 6e 20 ags;.. /* Open
2dda0 74 68 65 20 70 61 67 65 72 20 66 69 6c 65 2e 0a the pager file..
2ddb0 20 20 2a 2f 0a 20 20 69 66 28 20 7a 46 69 6c 65 */. if( zFile
2ddc0 6e 61 6d 65 20 26 26 20 7a 46 69 6c 65 6e 61 6d name && zFilenam
2ddd0 65 5b 30 5d 20 29 7b 0a 20 20 20 20 69 6e 74 20 e[0] ){. int
2dde0 66 6f 75 74 20 3d 20 30 3b 20 20 20 20 20 20 20 fout = 0;
2ddf0 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 /*
2de00 56 46 53 20 66 6c 61 67 73 20 72 65 74 75 72 6e VFS flags return
2de10 65 64 20 62 79 20 78 4f 70 65 6e 28 29 20 2a 2f ed by xOpen() */
2de20 0a 20 20 20 20 72 63 20 3d 20 73 71 6c 69 74 65 . rc = sqlite
2de30 33 4f 73 4f 70 65 6e 28 70 56 66 73 2c 20 70 50 3OsOpen(pVfs, pP
2de40 61 67 65 72 2d 3e 7a 46 69 6c 65 6e 61 6d 65 2c ager->zFilename,
2de50 20 70 50 61 67 65 72 2d 3e 66 64 2c 20 76 66 73 pPager->fd, vfs
2de60 46 6c 61 67 73 2c 20 26 66 6f 75 74 29 3b 0a 20 Flags, &fout);.
2de70 20 20 20 61 73 73 65 72 74 28 20 21 6d 65 6d 44 assert( !memD
2de80 62 20 29 3b 0a 20 20 20 20 72 65 61 64 4f 6e 6c b );. readOnl
2de90 79 20 3d 20 28 66 6f 75 74 26 53 51 4c 49 54 45 y = (fout&SQLITE
2dea0 5f 4f 50 45 4e 5f 52 45 41 44 4f 4e 4c 59 29 3b _OPEN_READONLY);
2deb0 0a 0a 20 20 20 20 2f 2a 20 49 66 20 74 68 65 20 .. /* If the
2dec0 66 69 6c 65 20 77 61 73 20 73 75 63 63 65 73 73 file was success
2ded0 66 75 6c 6c 79 20 6f 70 65 6e 65 64 20 66 6f 72 fully opened for
2dee0 20 72 65 61 64 2f 77 72 69 74 65 20 61 63 63 65 read/write acce
2def0 73 73 2c 0a 20 20 20 20 2a 2a 20 63 68 6f 6f 73 ss,. ** choos
2df00 65 20 61 20 64 65 66 61 75 6c 74 20 70 61 67 65 e a default page
2df10 20 73 69 7a 65 20 69 6e 20 63 61 73 65 20 77 65 size in case we
2df20 20 68 61 76 65 20 74 6f 20 63 72 65 61 74 65 20 have to create
2df30 74 68 65 0a 20 20 20 20 2a 2a 20 64 61 74 61 62 the. ** datab
2df40 61 73 65 20 66 69 6c 65 2e 20 54 68 65 20 64 65 ase file. The de
2df50 66 61 75 6c 74 20 70 61 67 65 20 73 69 7a 65 20 fault page size
2df60 69 73 20 74 68 65 20 6d 61 78 69 6d 75 6d 20 6f is the maximum o
2df70 66 3a 0a 20 20 20 20 2a 2a 0a 20 20 20 20 2a 2a f:. **. **
2df80 20 20 20 20 2b 20 53 51 4c 49 54 45 5f 44 45 46 + SQLITE_DEF
2df90 41 55 4c 54 5f 50 41 47 45 5f 53 49 5a 45 2c 0a AULT_PAGE_SIZE,.
2dfa0 20 20 20 20 2a 2a 20 20 20 20 2b 20 54 68 65 20 ** + The
2dfb0 76 61 6c 75 65 20 72 65 74 75 72 6e 65 64 20 62 value returned b
2dfc0 79 20 73 71 6c 69 74 65 33 4f 73 53 65 63 74 6f y sqlite3OsSecto
2dfd0 72 53 69 7a 65 28 29 0a 20 20 20 20 2a 2a 20 20 rSize(). **
2dfe0 20 20 2b 20 54 68 65 20 6c 61 72 67 65 73 74 20 + The largest
2dff0 70 61 67 65 20 73 69 7a 65 20 74 68 61 74 20 63 page size that c
2e000 61 6e 20 62 65 20 77 72 69 74 74 65 6e 20 61 74 an be written at
2e010 6f 6d 69 63 61 6c 6c 79 2e 0a 20 20 20 20 2a 2f omically.. */
2e020 0a 20 20 20 20 69 66 28 20 72 63 3d 3d 53 51 4c . if( rc==SQL
2e030 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 20 20 ITE_OK ){.
2e040 69 6e 74 20 69 44 63 20 3d 20 73 71 6c 69 74 65 int iDc = sqlite
2e050 33 4f 73 44 65 76 69 63 65 43 68 61 72 61 63 74 3OsDeviceCharact
2e060 65 72 69 73 74 69 63 73 28 70 50 61 67 65 72 2d eristics(pPager-
2e070 3e 66 64 29 3b 0a 20 20 20 20 20 20 69 66 28 20 >fd);. if(
2e080 21 72 65 61 64 4f 6e 6c 79 20 29 7b 0a 20 20 20 !readOnly ){.
2e090 20 20 20 20 20 73 65 74 53 65 63 74 6f 72 53 69 setSectorSi
2e0a0 7a 65 28 70 50 61 67 65 72 29 3b 0a 20 20 20 20 ze(pPager);.
2e0b0 20 20 20 20 61 73 73 65 72 74 28 53 51 4c 49 54 assert(SQLIT
2e0c0 45 5f 44 45 46 41 55 4c 54 5f 50 41 47 45 5f 53 E_DEFAULT_PAGE_S
2e0d0 49 5a 45 3c 3d 53 51 4c 49 54 45 5f 4d 41 58 5f IZE<=SQLITE_MAX_
2e0e0 44 45 46 41 55 4c 54 5f 50 41 47 45 5f 53 49 5a DEFAULT_PAGE_SIZ
2e0f0 45 29 3b 0a 20 20 20 20 20 20 20 20 69 66 28 20 E);. if(
2e100 73 7a 50 61 67 65 44 66 6c 74 3c 70 50 61 67 65 szPageDflt<pPage
2e110 72 2d 3e 73 65 63 74 6f 72 53 69 7a 65 20 29 7b r->sectorSize ){
2e120 0a 20 20 20 20 20 20 20 20 20 20 69 66 28 20 70 . if( p
2e130 50 61 67 65 72 2d 3e 73 65 63 74 6f 72 53 69 7a Pager->sectorSiz
2e140 65 3e 53 51 4c 49 54 45 5f 4d 41 58 5f 44 45 46 e>SQLITE_MAX_DEF
2e150 41 55 4c 54 5f 50 41 47 45 5f 53 49 5a 45 20 29 AULT_PAGE_SIZE )
2e160 7b 0a 20 20 20 20 20 20 20 20 20 20 20 20 73 7a {. sz
2e170 50 61 67 65 44 66 6c 74 20 3d 20 53 51 4c 49 54 PageDflt = SQLIT
2e180 45 5f 4d 41 58 5f 44 45 46 41 55 4c 54 5f 50 41 E_MAX_DEFAULT_PA
2e190 47 45 5f 53 49 5a 45 3b 0a 20 20 20 20 20 20 20 GE_SIZE;.
2e1a0 20 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 20 20 }else{.
2e1b0 20 20 20 20 20 20 73 7a 50 61 67 65 44 66 6c 74 szPageDflt
2e1c0 20 3d 20 28 75 33 32 29 70 50 61 67 65 72 2d 3e = (u32)pPager->
2e1d0 73 65 63 74 6f 72 53 69 7a 65 3b 0a 20 20 20 20 sectorSize;.
2e1e0 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 20 20 }.
2e1f0 7d 0a 23 69 66 64 65 66 20 53 51 4c 49 54 45 5f }.#ifdef SQLITE_
2e200 45 4e 41 42 4c 45 5f 41 54 4f 4d 49 43 5f 57 52 ENABLE_ATOMIC_WR
2e210 49 54 45 0a 20 20 20 20 20 20 20 20 7b 0a 20 20 ITE. {.
2e220 20 20 20 20 20 20 20 20 69 6e 74 20 69 69 3b 0a int ii;.
2e230 20 20 20 20 20 20 20 20 20 20 61 73 73 65 72 74 assert
2e240 28 53 51 4c 49 54 45 5f 49 4f 43 41 50 5f 41 54 (SQLITE_IOCAP_AT
2e250 4f 4d 49 43 35 31 32 3d 3d 28 35 31 32 3e 3e 38 OMIC512==(512>>8
2e260 29 29 3b 0a 20 20 20 20 20 20 20 20 20 20 61 73 ));. 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 36 34 4b 3d 3d 28 36 35 P_ATOMIC64K==(65
2e290 35 33 36 3e 3e 38 29 29 3b 0a 20 20 20 20 20 20 536>>8));.
2e2a0 20 20 20 20 61 73 73 65 72 74 28 53 51 4c 49 54 assert(SQLIT
2e2b0 45 5f 4d 41 58 5f 44 45 46 41 55 4c 54 5f 50 41 E_MAX_DEFAULT_PA
2e2c0 47 45 5f 53 49 5a 45 3c 3d 36 35 35 33 36 29 3b GE_SIZE<=65536);
2e2d0 0a 20 20 20 20 20 20 20 20 20 20 66 6f 72 28 69 . for(i
2e2e0 69 3d 73 7a 50 61 67 65 44 66 6c 74 3b 20 69 69 i=szPageDflt; ii
2e2f0 3c 3d 53 51 4c 49 54 45 5f 4d 41 58 5f 44 45 46 <=SQLITE_MAX_DEF
2e300 41 55 4c 54 5f 50 41 47 45 5f 53 49 5a 45 3b 20 AULT_PAGE_SIZE;
2e310 69 69 3d 69 69 2a 32 29 7b 0a 20 20 20 20 20 20 ii=ii*2){.
2e320 20 20 20 20 20 20 69 66 28 20 69 44 63 26 28 53 if( iDc&(S
2e330 51 4c 49 54 45 5f 49 4f 43 41 50 5f 41 54 4f 4d QLITE_IOCAP_ATOM
2e340 49 43 7c 28 69 69 3e 3e 38 29 29 20 29 7b 0a 20 IC|(ii>>8)) ){.
2e350 20 20 20 20 20 20 20 20 20 20 20 20 20 73 7a 50 szP
2e360 61 67 65 44 66 6c 74 20 3d 20 69 69 3b 0a 20 20 ageDflt = ii;.
2e370 20 20 20 20 20 20 20 20 20 20 7d 0a 20 20 20 20 }.
2e380 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 20 20 }.
2e390 7d 0a 23 65 6e 64 69 66 0a 20 20 20 20 20 20 7d }.#endif. }
2e3a0 0a 20 20 20 20 20 20 70 50 61 67 65 72 2d 3e 6e . pPager->n
2e3b0 6f 4c 6f 63 6b 20 3d 20 73 71 6c 69 74 65 33 5f oLock = sqlite3_
2e3c0 75 72 69 5f 62 6f 6f 6c 65 61 6e 28 7a 46 69 6c uri_boolean(zFil
2e3d0 65 6e 61 6d 65 2c 20 22 6e 6f 6c 6f 63 6b 22 2c ename, "nolock",
2e3e0 20 30 29 3b 0a 20 20 20 20 20 20 69 66 28 20 28 0);. if( (
2e3f0 69 44 63 20 26 20 53 51 4c 49 54 45 5f 49 4f 43 iDc & SQLITE_IOC
2e400 41 50 5f 49 4d 4d 55 54 41 42 4c 45 29 21 3d 30 AP_IMMUTABLE)!=0
2e410 0a 20 20 20 20 20 20 20 7c 7c 20 73 71 6c 69 74 . || sqlit
2e420 65 33 5f 75 72 69 5f 62 6f 6f 6c 65 61 6e 28 7a e3_uri_boolean(z
2e430 46 69 6c 65 6e 61 6d 65 2c 20 22 69 6d 6d 75 74 Filename, "immut
2e440 61 62 6c 65 22 2c 20 30 29 20 29 7b 0a 20 20 20 able", 0) ){.
2e450 20 20 20 20 20 20 20 76 66 73 46 6c 61 67 73 20 vfsFlags
2e460 7c 3d 20 53 51 4c 49 54 45 5f 4f 50 45 4e 5f 52 |= SQLITE_OPEN_R
2e470 45 41 44 4f 4e 4c 59 3b 0a 20 20 20 20 20 20 20 EADONLY;.
2e480 20 20 20 67 6f 74 6f 20 61 63 74 5f 6c 69 6b 65 goto act_like
2e490 5f 74 65 6d 70 5f 66 69 6c 65 3b 0a 20 20 20 20 _temp_file;.
2e4a0 20 20 7d 0a 20 20 20 20 7d 0a 20 20 7d 65 6c 73 }. }. }els
2e4b0 65 7b 0a 20 20 20 20 2f 2a 20 49 66 20 61 20 74 e{. /* If a t
2e4c0 65 6d 70 6f 72 61 72 79 20 66 69 6c 65 20 69 73 emporary file is
2e4d0 20 72 65 71 75 65 73 74 65 64 2c 20 69 74 20 69 requested, it i
2e4e0 73 20 6e 6f 74 20 6f 70 65 6e 65 64 20 69 6d 6d s not opened imm
2e4f0 65 64 69 61 74 65 6c 79 2e 0a 20 20 20 20 2a 2a ediately.. **
2e500 20 49 6e 20 74 68 69 73 20 63 61 73 65 20 77 65 In this case we
2e510 20 61 63 63 65 70 74 20 74 68 65 20 64 65 66 61 accept the defa
2e520 75 6c 74 20 70 61 67 65 20 73 69 7a 65 20 61 6e ult page size an
2e530 64 20 64 65 6c 61 79 20 61 63 74 75 61 6c 6c 79 d delay actually
2e540 0a 20 20 20 20 2a 2a 20 6f 70 65 6e 69 6e 67 20 . ** opening
2e550 74 68 65 20 66 69 6c 65 20 75 6e 74 69 6c 20 74 the file until t
2e560 68 65 20 66 69 72 73 74 20 63 61 6c 6c 20 74 6f he first call to
2e570 20 4f 73 57 72 69 74 65 28 29 2e 0a 20 20 20 20 OsWrite()..
2e580 2a 2a 0a 20 20 20 20 2a 2a 20 54 68 69 73 20 62 **. ** This b
2e590 72 61 6e 63 68 20 69 73 20 61 6c 73 6f 20 72 75 ranch is also ru
2e5a0 6e 20 66 6f 72 20 61 6e 20 69 6e 2d 6d 65 6d 6f n for an in-memo
2e5b0 72 79 20 64 61 74 61 62 61 73 65 2e 20 41 6e 20 ry database. An
2e5c0 69 6e 2d 6d 65 6d 6f 72 79 0a 20 20 20 20 2a 2a in-memory. **
2e5d0 20 64 61 74 61 62 61 73 65 20 69 73 20 74 68 65 database is the
2e5e0 20 73 61 6d 65 20 61 73 20 61 20 74 65 6d 70 2d same as a temp-
2e5f0 66 69 6c 65 20 74 68 61 74 20 69 73 20 6e 65 76 file that is nev
2e600 65 72 20 77 72 69 74 74 65 6e 20 6f 75 74 20 74 er written out t
2e610 6f 0a 20 20 20 20 2a 2a 20 64 69 73 6b 20 61 6e o. ** disk an
2e620 64 20 75 73 65 73 20 61 6e 20 69 6e 2d 6d 65 6d d uses an in-mem
2e630 6f 72 79 20 72 6f 6c 6c 62 61 63 6b 20 6a 6f 75 ory rollback jou
2e640 72 6e 61 6c 2e 0a 20 20 20 20 2a 2a 0a 20 20 20 rnal.. **.
2e650 20 2a 2a 20 54 68 69 73 20 62 72 61 6e 63 68 20 ** This branch
2e660 61 6c 73 6f 20 72 75 6e 73 20 66 6f 72 20 66 69 also runs for fi
2e670 6c 65 73 20 6d 61 72 6b 65 64 20 61 73 20 69 6d les marked as im
2e680 6d 75 74 61 62 6c 65 2e 0a 20 20 20 20 2a 2f 20 mutable.. */
2e690 0a 61 63 74 5f 6c 69 6b 65 5f 74 65 6d 70 5f 66 .act_like_temp_f
2e6a0 69 6c 65 3a 0a 20 20 20 20 74 65 6d 70 46 69 6c ile:. tempFil
2e6b0 65 20 3d 20 31 3b 0a 20 20 20 20 70 50 61 67 65 e = 1;. pPage
2e6c0 72 2d 3e 65 53 74 61 74 65 20 3d 20 50 41 47 45 r->eState = PAGE
2e6d0 52 5f 52 45 41 44 45 52 3b 20 20 20 20 20 2f 2a R_READER; /*
2e6e0 20 50 72 65 74 65 6e 64 20 77 65 20 61 6c 72 65 Pretend we alre
2e6f0 61 64 79 20 68 61 76 65 20 61 20 6c 6f 63 6b 20 ady have a lock
2e700 2a 2f 0a 20 20 20 20 70 50 61 67 65 72 2d 3e 65 */. pPager->e
2e710 4c 6f 63 6b 20 3d 20 45 58 43 4c 55 53 49 56 45 Lock = EXCLUSIVE
2e720 5f 4c 4f 43 4b 3b 20 20 20 20 2f 2a 20 50 72 65 _LOCK; /* Pre
2e730 74 65 6e 64 20 77 65 20 61 72 65 20 69 6e 20 45 tend we are in E
2e740 58 43 4c 55 53 49 56 45 20 6d 6f 64 65 20 2a 2f XCLUSIVE mode */
2e750 0a 20 20 20 20 70 50 61 67 65 72 2d 3e 6e 6f 4c . pPager->noL
2e760 6f 63 6b 20 3d 20 31 3b 20 20 20 20 20 20 20 20 ock = 1;
2e770 20 20 20 20 20 20 20 20 2f 2a 20 44 6f 20 6e 6f /* Do no
2e780 20 6c 6f 63 6b 69 6e 67 20 2a 2f 0a 20 20 20 20 locking */.
2e790 72 65 61 64 4f 6e 6c 79 20 3d 20 28 76 66 73 46 readOnly = (vfsF
2e7a0 6c 61 67 73 26 53 51 4c 49 54 45 5f 4f 50 45 4e lags&SQLITE_OPEN
2e7b0 5f 52 45 41 44 4f 4e 4c 59 29 3b 0a 20 20 7d 0a _READONLY);. }.
2e7c0 0a 20 20 2f 2a 20 54 68 65 20 66 6f 6c 6c 6f 77 . /* The follow
2e7d0 69 6e 67 20 63 61 6c 6c 20 74 6f 20 50 61 67 65 ing call to Page
2e7e0 72 53 65 74 50 61 67 65 73 69 7a 65 28 29 20 73 rSetPagesize() s
2e7f0 65 72 76 65 73 20 74 6f 20 73 65 74 20 74 68 65 erves to set the
2e800 20 76 61 6c 75 65 20 6f 66 20 0a 20 20 2a 2a 20 value of . **
2e810 50 61 67 65 72 2e 70 61 67 65 53 69 7a 65 20 61 Pager.pageSize a
2e820 6e 64 20 74 6f 20 61 6c 6c 6f 63 61 74 65 20 74 nd to allocate t
2e830 68 65 20 50 61 67 65 72 2e 70 54 6d 70 53 70 61 he Pager.pTmpSpa
2e840 63 65 20 62 75 66 66 65 72 2e 0a 20 20 2a 2f 0a ce buffer.. */.
2e850 20 20 69 66 28 20 72 63 3d 3d 53 51 4c 49 54 45 if( rc==SQLITE
2e860 5f 4f 4b 20 29 7b 0a 20 20 20 20 61 73 73 65 72 _OK ){. asser
2e870 74 28 20 70 50 61 67 65 72 2d 3e 6d 65 6d 44 62 t( pPager->memDb
2e880 3d 3d 30 20 29 3b 0a 20 20 20 20 72 63 20 3d 20 ==0 );. rc =
2e890 73 71 6c 69 74 65 33 50 61 67 65 72 53 65 74 50 sqlite3PagerSetP
2e8a0 61 67 65 73 69 7a 65 28 70 50 61 67 65 72 2c 20 agesize(pPager,
2e8b0 26 73 7a 50 61 67 65 44 66 6c 74 2c 20 2d 31 29 &szPageDflt, -1)
2e8c0 3b 0a 20 20 20 20 74 65 73 74 63 61 73 65 28 20 ;. testcase(
2e8d0 72 63 21 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 3b rc!=SQLITE_OK );
2e8e0 0a 20 20 7d 0a 0a 20 20 2f 2a 20 49 6e 69 74 69 . }.. /* Initi
2e8f0 61 6c 69 7a 65 20 74 68 65 20 50 43 61 63 68 65 alize the PCache
2e900 20 6f 62 6a 65 63 74 2e 20 2a 2f 0a 20 20 69 66 object. */. if
2e910 28 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 ( rc==SQLITE_OK
2e920 29 7b 0a 20 20 20 20 61 73 73 65 72 74 28 20 6e ){. assert( n
2e930 45 78 74 72 61 3c 31 30 30 30 20 29 3b 0a 20 20 Extra<1000 );.
2e940 20 20 6e 45 78 74 72 61 20 3d 20 52 4f 55 4e 44 nExtra = ROUND
2e950 38 28 6e 45 78 74 72 61 29 3b 0a 20 20 20 20 72 8(nExtra);. r
2e960 63 20 3d 20 73 71 6c 69 74 65 33 50 63 61 63 68 c = sqlite3Pcach
2e970 65 4f 70 65 6e 28 73 7a 50 61 67 65 44 66 6c 74 eOpen(szPageDflt
2e980 2c 20 6e 45 78 74 72 61 2c 20 21 6d 65 6d 44 62 , nExtra, !memDb
2e990 2c 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 ,.
2e9a0 20 20 20 20 20 20 20 20 20 21 6d 65 6d 44 62 3f !memDb?
2e9b0 70 61 67 65 72 53 74 72 65 73 73 3a 30 2c 20 28 pagerStress:0, (
2e9c0 76 6f 69 64 20 2a 29 70 50 61 67 65 72 2c 20 70 void *)pPager, p
2e9d0 50 61 67 65 72 2d 3e 70 50 43 61 63 68 65 29 3b Pager->pPCache);
2e9e0 0a 20 20 7d 0a 0a 20 20 2f 2a 20 49 66 20 61 6e . }.. /* If an
2e9f0 20 65 72 72 6f 72 20 6f 63 63 75 72 72 65 64 20 error occurred
2ea00 61 62 6f 76 65 2c 20 66 72 65 65 20 74 68 65 20 above, free the
2ea10 20 50 61 67 65 72 20 73 74 72 75 63 74 75 72 65 Pager structure
2ea20 20 61 6e 64 20 63 6c 6f 73 65 20 74 68 65 20 66 and close the f
2ea30 69 6c 65 2e 0a 20 20 2a 2f 0a 20 20 69 66 28 20 ile.. */. if(
2ea40 72 63 21 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b rc!=SQLITE_OK ){
2ea50 0a 20 20 20 20 73 71 6c 69 74 65 33 4f 73 43 6c . sqlite3OsCl
2ea60 6f 73 65 28 70 50 61 67 65 72 2d 3e 66 64 29 3b ose(pPager->fd);
2ea70 0a 20 20 20 20 73 71 6c 69 74 65 33 50 61 67 65 . sqlite3Page
2ea80 46 72 65 65 28 70 50 61 67 65 72 2d 3e 70 54 6d Free(pPager->pTm
2ea90 70 53 70 61 63 65 29 3b 0a 20 20 20 20 73 71 6c pSpace);. sql
2eaa0 69 74 65 33 5f 66 72 65 65 28 70 50 61 67 65 72 ite3_free(pPager
2eab0 29 3b 0a 20 20 20 20 72 65 74 75 72 6e 20 72 63 );. return rc
2eac0 3b 0a 20 20 7d 0a 0a 20 20 50 41 47 45 52 54 52 ;. }.. PAGERTR
2ead0 41 43 45 28 28 22 4f 50 45 4e 20 25 64 20 25 73 ACE(("OPEN %d %s
2eae0 5c 6e 22 2c 20 46 49 4c 45 48 41 4e 44 4c 45 49 \n", FILEHANDLEI
2eaf0 44 28 70 50 61 67 65 72 2d 3e 66 64 29 2c 20 70 D(pPager->fd), p
2eb00 50 61 67 65 72 2d 3e 7a 46 69 6c 65 6e 61 6d 65 Pager->zFilename
2eb10 29 29 3b 0a 20 20 49 4f 54 52 41 43 45 28 28 22 ));. IOTRACE(("
2eb20 4f 50 45 4e 20 25 70 20 25 73 5c 6e 22 2c 20 70 OPEN %p %s\n", p
2eb30 50 61 67 65 72 2c 20 70 50 61 67 65 72 2d 3e 7a Pager, pPager->z
2eb40 46 69 6c 65 6e 61 6d 65 29 29 0a 0a 20 20 70 50 Filename)).. pP
2eb50 61 67 65 72 2d 3e 75 73 65 4a 6f 75 72 6e 61 6c ager->useJournal
2eb60 20 3d 20 28 75 38 29 75 73 65 4a 6f 75 72 6e 61 = (u8)useJourna
2eb70 6c 3b 0a 20 20 2f 2a 20 70 50 61 67 65 72 2d 3e l;. /* pPager->
2eb80 73 74 6d 74 4f 70 65 6e 20 3d 20 30 3b 20 2a 2f stmtOpen = 0; */
2eb90 0a 20 20 2f 2a 20 70 50 61 67 65 72 2d 3e 73 74 . /* pPager->st
2eba0 6d 74 49 6e 55 73 65 20 3d 20 30 3b 20 2a 2f 0a mtInUse = 0; */.
2ebb0 20 20 2f 2a 20 70 50 61 67 65 72 2d 3e 6e 52 65 /* pPager->nRe
2ebc0 66 20 3d 20 30 3b 20 2a 2f 0a 20 20 2f 2a 20 70 f = 0; */. /* p
2ebd0 50 61 67 65 72 2d 3e 73 74 6d 74 53 69 7a 65 20 Pager->stmtSize
2ebe0 3d 20 30 3b 20 2a 2f 0a 20 20 2f 2a 20 70 50 61 = 0; */. /* pPa
2ebf0 67 65 72 2d 3e 73 74 6d 74 4a 53 69 7a 65 20 3d ger->stmtJSize =
2ec00 20 30 3b 20 2a 2f 0a 20 20 2f 2a 20 70 50 61 67 0; */. /* pPag
2ec10 65 72 2d 3e 6e 50 61 67 65 20 3d 20 30 3b 20 2a er->nPage = 0; *
2ec20 2f 0a 20 20 70 50 61 67 65 72 2d 3e 6d 78 50 67 /. pPager->mxPg
2ec30 6e 6f 20 3d 20 53 51 4c 49 54 45 5f 4d 41 58 5f no = SQLITE_MAX_
2ec40 50 41 47 45 5f 43 4f 55 4e 54 3b 0a 20 20 2f 2a PAGE_COUNT;. /*
2ec50 20 70 50 61 67 65 72 2d 3e 73 74 61 74 65 20 3d pPager->state =
2ec60 20 50 41 47 45 52 5f 55 4e 4c 4f 43 4b 3b 20 2a PAGER_UNLOCK; *
2ec70 2f 0a 20 20 2f 2a 20 70 50 61 67 65 72 2d 3e 65 /. /* pPager->e
2ec80 72 72 4d 61 73 6b 20 3d 20 30 3b 20 2a 2f 0a 20 rrMask = 0; */.
2ec90 20 70 50 61 67 65 72 2d 3e 74 65 6d 70 46 69 6c pPager->tempFil
2eca0 65 20 3d 20 28 75 38 29 74 65 6d 70 46 69 6c 65 e = (u8)tempFile
2ecb0 3b 0a 20 20 61 73 73 65 72 74 28 20 74 65 6d 70 ;. assert( temp
2ecc0 46 69 6c 65 3d 3d 50 41 47 45 52 5f 4c 4f 43 4b File==PAGER_LOCK
2ecd0 49 4e 47 4d 4f 44 45 5f 4e 4f 52 4d 41 4c 20 0a INGMODE_NORMAL .
2ece0 20 20 20 20 20 20 20 20 20 20 7c 7c 20 74 65 6d || tem
2ecf0 70 46 69 6c 65 3d 3d 50 41 47 45 52 5f 4c 4f 43 pFile==PAGER_LOC
2ed00 4b 49 4e 47 4d 4f 44 45 5f 45 58 43 4c 55 53 49 KINGMODE_EXCLUSI
2ed10 56 45 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 VE );. assert(
2ed20 50 41 47 45 52 5f 4c 4f 43 4b 49 4e 47 4d 4f 44 PAGER_LOCKINGMOD
2ed30 45 5f 45 58 43 4c 55 53 49 56 45 3d 3d 31 20 29 E_EXCLUSIVE==1 )
2ed40 3b 0a 20 20 70 50 61 67 65 72 2d 3e 65 78 63 6c ;. pPager->excl
2ed50 75 73 69 76 65 4d 6f 64 65 20 3d 20 28 75 38 29 usiveMode = (u8)
2ed60 74 65 6d 70 46 69 6c 65 3b 20 0a 20 20 70 50 61 tempFile; . pPa
2ed70 67 65 72 2d 3e 63 68 61 6e 67 65 43 6f 75 6e 74 ger->changeCount
2ed80 44 6f 6e 65 20 3d 20 70 50 61 67 65 72 2d 3e 74 Done = pPager->t
2ed90 65 6d 70 46 69 6c 65 3b 0a 20 20 70 50 61 67 65 empFile;. pPage
2eda0 72 2d 3e 6d 65 6d 44 62 20 3d 20 28 75 38 29 6d r->memDb = (u8)m
2edb0 65 6d 44 62 3b 0a 20 20 70 50 61 67 65 72 2d 3e emDb;. pPager->
2edc0 72 65 61 64 4f 6e 6c 79 20 3d 20 28 75 38 29 72 readOnly = (u8)r
2edd0 65 61 64 4f 6e 6c 79 3b 0a 20 20 61 73 73 65 72 eadOnly;. asser
2ede0 74 28 20 75 73 65 4a 6f 75 72 6e 61 6c 20 7c 7c t( useJournal ||
2edf0 20 70 50 61 67 65 72 2d 3e 74 65 6d 70 46 69 6c pPager->tempFil
2ee00 65 20 29 3b 0a 20 20 70 50 61 67 65 72 2d 3e 6e e );. pPager->n
2ee10 6f 53 79 6e 63 20 3d 20 70 50 61 67 65 72 2d 3e oSync = pPager->
2ee20 74 65 6d 70 46 69 6c 65 3b 0a 20 20 69 66 28 20 tempFile;. if(
2ee30 70 50 61 67 65 72 2d 3e 6e 6f 53 79 6e 63 20 29 pPager->noSync )
2ee40 7b 0a 20 20 20 20 61 73 73 65 72 74 28 20 70 50 {. assert( pP
2ee50 61 67 65 72 2d 3e 66 75 6c 6c 53 79 6e 63 3d 3d ager->fullSync==
2ee60 30 20 29 3b 0a 20 20 20 20 61 73 73 65 72 74 28 0 );. assert(
2ee70 20 70 50 61 67 65 72 2d 3e 65 78 74 72 61 53 79 pPager->extraSy
2ee80 6e 63 3d 3d 30 20 29 3b 0a 20 20 20 20 61 73 73 nc==0 );. ass
2ee90 65 72 74 28 20 70 50 61 67 65 72 2d 3e 73 79 6e ert( pPager->syn
2eea0 63 46 6c 61 67 73 3d 3d 30 20 29 3b 0a 20 20 20 cFlags==0 );.
2eeb0 20 61 73 73 65 72 74 28 20 70 50 61 67 65 72 2d assert( pPager-
2eec0 3e 77 61 6c 53 79 6e 63 46 6c 61 67 73 3d 3d 30 >walSyncFlags==0
2eed0 20 29 3b 0a 20 20 20 20 61 73 73 65 72 74 28 20 );. assert(
2eee0 70 50 61 67 65 72 2d 3e 63 6b 70 74 53 79 6e 63 pPager->ckptSync
2eef0 46 6c 61 67 73 3d 3d 30 20 29 3b 0a 20 20 7d 65 Flags==0 );. }e
2ef00 6c 73 65 7b 0a 20 20 20 20 70 50 61 67 65 72 2d lse{. pPager-
2ef10 3e 66 75 6c 6c 53 79 6e 63 20 3d 20 31 3b 0a 20 >fullSync = 1;.
2ef20 20 20 20 70 50 61 67 65 72 2d 3e 65 78 74 72 61 pPager->extra
2ef30 53 79 6e 63 20 3d 20 30 3b 0a 20 20 20 20 70 50 Sync = 0;. pP
2ef40 61 67 65 72 2d 3e 73 79 6e 63 46 6c 61 67 73 20 ager->syncFlags
2ef50 3d 20 53 51 4c 49 54 45 5f 53 59 4e 43 5f 4e 4f = SQLITE_SYNC_NO
2ef60 52 4d 41 4c 3b 0a 20 20 20 20 70 50 61 67 65 72 RMAL;. pPager
2ef70 2d 3e 77 61 6c 53 79 6e 63 46 6c 61 67 73 20 3d ->walSyncFlags =
2ef80 20 53 51 4c 49 54 45 5f 53 59 4e 43 5f 4e 4f 52 SQLITE_SYNC_NOR
2ef90 4d 41 4c 20 7c 20 57 41 4c 5f 53 59 4e 43 5f 54 MAL | WAL_SYNC_T
2efa0 52 41 4e 53 41 43 54 49 4f 4e 53 3b 0a 20 20 20 RANSACTIONS;.
2efb0 20 70 50 61 67 65 72 2d 3e 63 6b 70 74 53 79 6e pPager->ckptSyn
2efc0 63 46 6c 61 67 73 20 3d 20 53 51 4c 49 54 45 5f cFlags = SQLITE_
2efd0 53 59 4e 43 5f 4e 4f 52 4d 41 4c 3b 0a 20 20 7d SYNC_NORMAL;. }
2efe0 0a 20 20 2f 2a 20 70 50 61 67 65 72 2d 3e 70 46 . /* pPager->pF
2eff0 69 72 73 74 20 3d 20 30 3b 20 2a 2f 0a 20 20 2f irst = 0; */. /
2f000 2a 20 70 50 61 67 65 72 2d 3e 70 46 69 72 73 74 * pPager->pFirst
2f010 53 79 6e 63 65 64 20 3d 20 30 3b 20 2a 2f 0a 20 Synced = 0; */.
2f020 20 2f 2a 20 70 50 61 67 65 72 2d 3e 70 4c 61 73 /* pPager->pLas
2f030 74 20 3d 20 30 3b 20 2a 2f 0a 20 20 70 50 61 67 t = 0; */. pPag
2f040 65 72 2d 3e 6e 45 78 74 72 61 20 3d 20 28 75 31 er->nExtra = (u1
2f050 36 29 6e 45 78 74 72 61 3b 0a 20 20 70 50 61 67 6)nExtra;. pPag
2f060 65 72 2d 3e 6a 6f 75 72 6e 61 6c 53 69 7a 65 4c er->journalSizeL
2f070 69 6d 69 74 20 3d 20 53 51 4c 49 54 45 5f 44 45 imit = SQLITE_DE
2f080 46 41 55 4c 54 5f 4a 4f 55 52 4e 41 4c 5f 53 49 FAULT_JOURNAL_SI
2f090 5a 45 5f 4c 49 4d 49 54 3b 0a 20 20 61 73 73 65 ZE_LIMIT;. asse
2f0a0 72 74 28 20 69 73 4f 70 65 6e 28 70 50 61 67 65 rt( isOpen(pPage
2f0b0 72 2d 3e 66 64 29 20 7c 7c 20 74 65 6d 70 46 69 r->fd) || tempFi
2f0c0 6c 65 20 29 3b 0a 20 20 73 65 74 53 65 63 74 6f le );. setSecto
2f0d0 72 53 69 7a 65 28 70 50 61 67 65 72 29 3b 0a 20 rSize(pPager);.
2f0e0 20 69 66 28 20 21 75 73 65 4a 6f 75 72 6e 61 6c if( !useJournal
2f0f0 20 29 7b 0a 20 20 20 20 70 50 61 67 65 72 2d 3e ){. pPager->
2f100 6a 6f 75 72 6e 61 6c 4d 6f 64 65 20 3d 20 50 41 journalMode = PA
2f110 47 45 52 5f 4a 4f 55 52 4e 41 4c 4d 4f 44 45 5f GER_JOURNALMODE_
2f120 4f 46 46 3b 0a 20 20 7d 65 6c 73 65 20 69 66 28 OFF;. }else if(
2f130 20 6d 65 6d 44 62 20 29 7b 0a 20 20 20 20 70 50 memDb ){. pP
2f140 61 67 65 72 2d 3e 6a 6f 75 72 6e 61 6c 4d 6f 64 ager->journalMod
2f150 65 20 3d 20 50 41 47 45 52 5f 4a 4f 55 52 4e 41 e = PAGER_JOURNA
2f160 4c 4d 4f 44 45 5f 4d 45 4d 4f 52 59 3b 0a 20 20 LMODE_MEMORY;.
2f170 7d 0a 20 20 2f 2a 20 70 50 61 67 65 72 2d 3e 78 }. /* pPager->x
2f180 42 75 73 79 48 61 6e 64 6c 65 72 20 3d 20 30 3b BusyHandler = 0;
2f190 20 2a 2f 0a 20 20 2f 2a 20 70 50 61 67 65 72 2d */. /* pPager-
2f1a0 3e 70 42 75 73 79 48 61 6e 64 6c 65 72 41 72 67 >pBusyHandlerArg
2f1b0 20 3d 20 30 3b 20 2a 2f 0a 20 20 70 50 61 67 65 = 0; */. pPage
2f1c0 72 2d 3e 78 52 65 69 6e 69 74 65 72 20 3d 20 78 r->xReiniter = x
2f1d0 52 65 69 6e 69 74 3b 0a 20 20 2f 2a 20 6d 65 6d Reinit;. /* mem
2f1e0 73 65 74 28 70 50 61 67 65 72 2d 3e 61 48 61 73 set(pPager->aHas
2f1f0 68 2c 20 30 2c 20 73 69 7a 65 6f 66 28 70 50 61 h, 0, sizeof(pPa
2f200 67 65 72 2d 3e 61 48 61 73 68 29 29 3b 20 2a 2f ger->aHash)); */
2f210 0a 20 20 2f 2a 20 70 50 61 67 65 72 2d 3e 73 7a . /* pPager->sz
2f220 4d 6d 61 70 20 3d 20 53 51 4c 49 54 45 5f 44 45 Mmap = SQLITE_DE
2f230 46 41 55 4c 54 5f 4d 4d 41 50 5f 53 49 5a 45 20 FAULT_MMAP_SIZE
2f240 2f 2f 20 77 69 6c 6c 20 62 65 20 73 65 74 20 62 // will be set b
2f250 79 20 62 74 72 65 65 2e 63 20 2a 2f 0a 0a 20 20 y btree.c */..
2f260 2a 70 70 50 61 67 65 72 20 3d 20 70 50 61 67 65 *ppPager = pPage
2f270 72 3b 0a 20 20 72 65 74 75 72 6e 20 53 51 4c 49 r;. return SQLI
2f280 54 45 5f 4f 4b 3b 0a 7d 0a 0a 0a 2f 2a 20 56 65 TE_OK;.}.../* Ve
2f290 72 69 66 79 20 74 68 61 74 20 74 68 65 20 64 61 rify that the da
2f2a0 74 61 62 61 73 65 20 66 69 6c 65 20 68 61 73 20 tabase file has
2f2b0 6e 6f 74 20 62 65 20 64 65 6c 65 74 65 64 20 6f not be deleted o
2f2c0 72 20 72 65 6e 61 6d 65 64 20 6f 75 74 20 66 72 r renamed out fr
2f2d0 6f 6d 0a 2a 2a 20 75 6e 64 65 72 20 74 68 65 20 om.** under the
2f2e0 70 61 67 65 72 2e 20 20 52 65 74 75 72 6e 20 53 pager. Return S
2f2f0 51 4c 49 54 45 5f 4f 4b 20 69 66 20 74 68 65 20 QLITE_OK if the
2f300 64 61 74 61 62 61 73 65 20 69 73 20 73 74 69 6c database is stil
2f310 6c 20 77 65 72 65 20 69 74 20 6f 75 67 68 74 0a l were it ought.
2f320 2a 2a 20 74 6f 20 62 65 20 6f 6e 20 64 69 73 6b ** to be on disk
2f330 2e 20 20 52 65 74 75 72 6e 20 6e 6f 6e 2d 7a 65 . Return non-ze
2f340 72 6f 20 28 53 51 4c 49 54 45 5f 52 45 41 44 4f ro (SQLITE_READO
2f350 4e 4c 59 5f 44 42 4d 4f 56 45 44 20 6f 72 20 73 NLY_DBMOVED or s
2f360 6f 6d 65 20 6f 74 68 65 72 20 65 72 72 6f 72 0a ome other error.
2f370 2a 2a 20 63 6f 64 65 20 66 72 6f 6d 20 73 71 6c ** code from sql
2f380 69 74 65 33 4f 73 41 63 63 65 73 73 28 29 29 20 ite3OsAccess())
2f390 69 66 20 74 68 65 20 64 61 74 61 62 61 73 65 20 if the database
2f3a0 68 61 73 20 67 6f 6e 65 20 6d 69 73 73 69 6e 67 has gone missing
2f3b0 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74 20 ..*/.static int
2f3c0 64 61 74 61 62 61 73 65 49 73 55 6e 6d 6f 76 65 databaseIsUnmove
2f3d0 64 28 50 61 67 65 72 20 2a 70 50 61 67 65 72 29 d(Pager *pPager)
2f3e0 7b 0a 20 20 69 6e 74 20 62 48 61 73 4d 6f 76 65 {. int bHasMove
2f3f0 64 20 3d 20 30 3b 0a 20 20 69 6e 74 20 72 63 3b d = 0;. int rc;
2f400 0a 0a 20 20 69 66 28 20 70 50 61 67 65 72 2d 3e .. if( pPager->
2f410 74 65 6d 70 46 69 6c 65 20 29 20 72 65 74 75 72 tempFile ) retur
2f420 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20 20 69 n SQLITE_OK;. i
2f430 66 28 20 70 50 61 67 65 72 2d 3e 64 62 53 69 7a f( pPager->dbSiz
2f440 65 3d 3d 30 20 29 20 72 65 74 75 72 6e 20 53 51 e==0 ) return SQ
2f450 4c 49 54 45 5f 4f 4b 3b 0a 20 20 61 73 73 65 72 LITE_OK;. asser
2f460 74 28 20 70 50 61 67 65 72 2d 3e 7a 46 69 6c 65 t( pPager->zFile
2f470 6e 61 6d 65 20 26 26 20 70 50 61 67 65 72 2d 3e name && pPager->
2f480 7a 46 69 6c 65 6e 61 6d 65 5b 30 5d 20 29 3b 0a zFilename[0] );.
2f490 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33 4f 73 rc = sqlite3Os
2f4a0 46 69 6c 65 43 6f 6e 74 72 6f 6c 28 70 50 61 67 FileControl(pPag
2f4b0 65 72 2d 3e 66 64 2c 20 53 51 4c 49 54 45 5f 46 er->fd, SQLITE_F
2f4c0 43 4e 54 4c 5f 48 41 53 5f 4d 4f 56 45 44 2c 20 CNTL_HAS_MOVED,
2f4d0 26 62 48 61 73 4d 6f 76 65 64 29 3b 0a 20 20 69 &bHasMoved);. i
2f4e0 66 28 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4e 4f f( rc==SQLITE_NO
2f4f0 54 46 4f 55 4e 44 20 29 7b 0a 20 20 20 20 2f 2a TFOUND ){. /*
2f500 20 49 66 20 74 68 65 20 48 41 53 5f 4d 4f 56 45 If the HAS_MOVE
2f510 44 20 66 69 6c 65 2d 63 6f 6e 74 72 6f 6c 20 69 D file-control i
2f520 73 20 75 6e 69 6d 70 6c 65 6d 65 6e 74 65 64 2c s unimplemented,
2f530 20 61 73 73 75 6d 65 20 74 68 61 74 20 74 68 65 assume that the
2f540 20 66 69 6c 65 0a 20 20 20 20 2a 2a 20 68 61 73 file. ** has
2f550 20 6e 6f 74 20 62 65 65 6e 20 6d 6f 76 65 64 2e not been moved.
2f560 20 20 54 68 61 74 20 69 73 20 74 68 65 20 68 69 That is the hi
2f570 73 74 6f 72 69 63 61 6c 20 62 65 68 61 76 69 6f storical behavio
2f580 72 20 6f 66 20 53 51 4c 69 74 65 3a 20 70 72 69 r of SQLite: pri
2f590 6f 72 20 74 6f 0a 20 20 20 20 2a 2a 20 76 65 72 or to. ** ver
2f5a0 73 69 6f 6e 20 33 2e 38 2e 33 2c 20 69 74 20 6e sion 3.8.3, it n
2f5b0 65 76 65 72 20 63 68 65 63 6b 65 64 20 2a 2f 0a ever checked */.
2f5c0 20 20 20 20 72 63 20 3d 20 53 51 4c 49 54 45 5f rc = SQLITE_
2f5d0 4f 4b 3b 0a 20 20 7d 65 6c 73 65 20 69 66 28 20 OK;. }else if(
2f5e0 72 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 26 26 rc==SQLITE_OK &&
2f5f0 20 62 48 61 73 4d 6f 76 65 64 20 29 7b 0a 20 20 bHasMoved ){.
2f600 20 20 72 63 20 3d 20 53 51 4c 49 54 45 5f 52 45 rc = SQLITE_RE
2f610 41 44 4f 4e 4c 59 5f 44 42 4d 4f 56 45 44 3b 0a ADONLY_DBMOVED;.
2f620 20 20 7d 0a 20 20 72 65 74 75 72 6e 20 72 63 3b }. return rc;
2f630 0a 7d 0a 0a 0a 2f 2a 0a 2a 2a 20 54 68 69 73 20 .}.../*.** This
2f640 66 75 6e 63 74 69 6f 6e 20 69 73 20 63 61 6c 6c function is call
2f650 65 64 20 61 66 74 65 72 20 74 72 61 6e 73 69 74 ed after transit
2f660 69 6f 6e 69 6e 67 20 66 72 6f 6d 20 50 41 47 45 ioning from PAGE
2f670 52 5f 55 4e 4c 4f 43 4b 20 74 6f 0a 2a 2a 20 50 R_UNLOCK to.** P
2f680 41 47 45 52 5f 53 48 41 52 45 44 20 73 74 61 74 AGER_SHARED stat
2f690 65 2e 20 49 74 20 74 65 73 74 73 20 69 66 20 74 e. It tests if t
2f6a0 68 65 72 65 20 69 73 20 61 20 68 6f 74 20 6a 6f here is a hot jo
2f6b0 75 72 6e 61 6c 20 70 72 65 73 65 6e 74 20 69 6e urnal present in
2f6c0 0a 2a 2a 20 74 68 65 20 66 69 6c 65 2d 73 79 73 .** the file-sys
2f6d0 74 65 6d 20 66 6f 72 20 74 68 65 20 67 69 76 65 tem for the give
2f6e0 6e 20 70 61 67 65 72 2e 20 41 20 68 6f 74 20 6a n pager. A hot j
2f6f0 6f 75 72 6e 61 6c 20 69 73 20 6f 6e 65 20 74 68 ournal is one th
2f700 61 74 20 0a 2a 2a 20 6e 65 65 64 73 20 74 6f 20 at .** needs to
2f710 62 65 20 70 6c 61 79 65 64 20 62 61 63 6b 2e 20 be played back.
2f720 41 63 63 6f 72 64 69 6e 67 20 74 6f 20 74 68 69 According to thi
2f730 73 20 66 75 6e 63 74 69 6f 6e 2c 20 61 20 68 6f s function, a ho
2f740 74 2d 6a 6f 75 72 6e 61 6c 0a 2a 2a 20 66 69 6c t-journal.** fil
2f750 65 20 65 78 69 73 74 73 20 69 66 20 74 68 65 20 e exists if the
2f760 66 6f 6c 6c 6f 77 69 6e 67 20 63 72 69 74 65 72 following criter
2f770 69 61 20 61 72 65 20 6d 65 74 3a 0a 2a 2a 0a 2a ia are met:.**.*
2f780 2a 20 20 20 2a 20 54 68 65 20 6a 6f 75 72 6e 61 * * The journa
2f790 6c 20 66 69 6c 65 20 65 78 69 73 74 73 20 69 6e l file exists in
2f7a0 20 74 68 65 20 66 69 6c 65 20 73 79 73 74 65 6d the file system
2f7b0 2c 20 61 6e 64 0a 2a 2a 20 20 20 2a 20 4e 6f 20 , and.** * No
2f7c0 70 72 6f 63 65 73 73 20 68 6f 6c 64 73 20 61 20 process holds a
2f7d0 52 45 53 45 52 56 45 44 20 6f 72 20 67 72 65 61 RESERVED or grea
2f7e0 74 65 72 20 6c 6f 63 6b 20 6f 6e 20 74 68 65 20 ter lock on the
2f7f0 64 61 74 61 62 61 73 65 20 66 69 6c 65 2c 20 61 database file, a
2f800 6e 64 0a 2a 2a 20 20 20 2a 20 54 68 65 20 64 61 nd.** * The da
2f810 74 61 62 61 73 65 20 66 69 6c 65 20 69 74 73 65 tabase file itse
2f820 6c 66 20 69 73 20 67 72 65 61 74 65 72 20 74 68 lf is greater th
2f830 61 6e 20 30 20 62 79 74 65 73 20 69 6e 20 73 69 an 0 bytes in si
2f840 7a 65 2c 20 61 6e 64 0a 2a 2a 20 20 20 2a 20 54 ze, and.** * T
2f850 68 65 20 66 69 72 73 74 20 62 79 74 65 20 6f 66 he first byte of
2f860 20 74 68 65 20 6a 6f 75 72 6e 61 6c 20 66 69 6c the journal fil
2f870 65 20 65 78 69 73 74 73 20 61 6e 64 20 69 73 20 e exists and is
2f880 6e 6f 74 20 30 78 30 30 2e 0a 2a 2a 0a 2a 2a 20 not 0x00..**.**
2f890 49 66 20 74 68 65 20 63 75 72 72 65 6e 74 20 73 If the current s
2f8a0 69 7a 65 20 6f 66 20 74 68 65 20 64 61 74 61 62 ize of the datab
2f8b0 61 73 65 20 66 69 6c 65 20 69 73 20 30 20 62 75 ase file is 0 bu
2f8c0 74 20 61 20 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 t a journal file
2f8d0 0a 2a 2a 20 65 78 69 73 74 73 2c 20 74 68 61 74 .** exists, that
2f8e0 20 69 73 20 70 72 6f 62 61 62 6c 79 20 61 6e 20 is probably an
2f8f0 6f 6c 64 20 6a 6f 75 72 6e 61 6c 20 6c 65 66 74 old journal left
2f900 20 6f 76 65 72 20 66 72 6f 6d 20 61 20 70 72 69 over from a pri
2f910 6f 72 0a 2a 2a 20 64 61 74 61 62 61 73 65 20 77 or.** database w
2f920 69 74 68 20 74 68 65 20 73 61 6d 65 20 6e 61 6d ith the same nam
2f930 65 2e 20 49 6e 20 74 68 69 73 20 63 61 73 65 20 e. In this case
2f940 74 68 65 20 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 the journal file
2f950 20 69 73 0a 2a 2a 20 6a 75 73 74 20 64 65 6c 65 is.** just dele
2f960 74 65 64 20 75 73 69 6e 67 20 4f 73 44 65 6c 65 ted using OsDele
2f970 74 65 2c 20 2a 70 45 78 69 73 74 73 20 69 73 20 te, *pExists is
2f980 73 65 74 20 74 6f 20 30 20 61 6e 64 20 53 51 4c set to 0 and SQL
2f990 49 54 45 5f 4f 4b 0a 2a 2a 20 69 73 20 72 65 74 ITE_OK.** is ret
2f9a0 75 72 6e 65 64 2e 0a 2a 2a 0a 2a 2a 20 54 68 69 urned..**.** Thi
2f9b0 73 20 72 6f 75 74 69 6e 65 20 64 6f 65 73 20 6e s routine does n
2f9c0 6f 74 20 63 68 65 63 6b 20 69 66 20 74 68 65 72 ot check if ther
2f9d0 65 20 69 73 20 61 20 6d 61 73 74 65 72 20 6a 6f e is a master jo
2f9e0 75 72 6e 61 6c 20 66 69 6c 65 6e 61 6d 65 0a 2a urnal filename.*
2f9f0 2a 20 61 74 20 74 68 65 20 65 6e 64 20 6f 66 20 * at the end of
2fa00 74 68 65 20 66 69 6c 65 2e 20 49 66 20 74 68 65 the file. If the
2fa10 72 65 20 69 73 2c 20 61 6e 64 20 74 68 61 74 20 re is, and that
2fa20 6d 61 73 74 65 72 20 6a 6f 75 72 6e 61 6c 20 66 master journal f
2fa30 69 6c 65 0a 2a 2a 20 64 6f 65 73 20 6e 6f 74 20 ile.** does not
2fa40 65 78 69 73 74 2c 20 74 68 65 6e 20 74 68 65 20 exist, then the
2fa50 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 20 69 73 20 journal file is
2fa60 6e 6f 74 20 72 65 61 6c 6c 79 20 68 6f 74 2e 20 not really hot.
2fa70 49 6e 20 74 68 69 73 0a 2a 2a 20 63 61 73 65 20 In this.** case
2fa80 74 68 69 73 20 72 6f 75 74 69 6e 65 20 77 69 6c this routine wil
2fa90 6c 20 72 65 74 75 72 6e 20 61 20 66 61 6c 73 65 l return a false
2faa0 2d 70 6f 73 69 74 69 76 65 2e 20 54 68 65 20 70 -positive. The p
2fab0 61 67 65 72 5f 70 6c 61 79 62 61 63 6b 28 29 0a ager_playback().
2fac0 2a 2a 20 72 6f 75 74 69 6e 65 20 77 69 6c 6c 20 ** routine will
2fad0 64 69 73 63 6f 76 65 72 20 74 68 61 74 20 74 68 discover that th
2fae0 65 20 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 20 69 e journal file i
2faf0 73 20 6e 6f 74 20 72 65 61 6c 6c 79 20 68 6f 74 s not really hot
2fb00 20 61 6e 64 20 0a 2a 2a 20 77 69 6c 6c 20 6e 6f and .** will no
2fb10 74 20 72 6f 6c 6c 20 69 74 20 62 61 63 6b 2e 20 t roll it back.
2fb20 0a 2a 2a 0a 2a 2a 20 49 66 20 61 20 68 6f 74 2d .**.** If a hot-
2fb30 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 20 69 73 20 journal file is
2fb40 66 6f 75 6e 64 20 74 6f 20 65 78 69 73 74 2c 20 found to exist,
2fb50 2a 70 45 78 69 73 74 73 20 69 73 20 73 65 74 20 *pExists is set
2fb60 74 6f 20 31 20 61 6e 64 20 0a 2a 2a 20 53 51 4c to 1 and .** SQL
2fb70 49 54 45 5f 4f 4b 20 72 65 74 75 72 6e 65 64 2e ITE_OK returned.
2fb80 20 49 66 20 6e 6f 20 68 6f 74 2d 6a 6f 75 72 6e If no hot-journ
2fb90 61 6c 20 66 69 6c 65 20 69 73 20 70 72 65 73 65 al file is prese
2fba0 6e 74 2c 20 2a 70 45 78 69 73 74 73 20 69 73 0a nt, *pExists is.
2fbb0 2a 2a 20 73 65 74 20 74 6f 20 30 20 61 6e 64 20 ** set to 0 and
2fbc0 53 51 4c 49 54 45 5f 4f 4b 20 72 65 74 75 72 6e SQLITE_OK return
2fbd0 65 64 2e 20 49 66 20 61 6e 20 49 4f 20 65 72 72 ed. If an IO err
2fbe0 6f 72 20 6f 63 63 75 72 73 20 77 68 69 6c 65 20 or occurs while
2fbf0 74 72 79 69 6e 67 0a 2a 2a 20 74 6f 20 64 65 74 trying.** to det
2fc00 65 72 6d 69 6e 65 20 77 68 65 74 68 65 72 20 6f ermine whether o
2fc10 72 20 6e 6f 74 20 61 20 68 6f 74 2d 6a 6f 75 72 r not a hot-jour
2fc20 6e 61 6c 20 66 69 6c 65 20 65 78 69 73 74 73 2c nal file exists,
2fc30 20 74 68 65 20 49 4f 20 65 72 72 6f 72 0a 2a 2a the IO error.**
2fc40 20 63 6f 64 65 20 69 73 20 72 65 74 75 72 6e 65 code is returne
2fc50 64 20 61 6e 64 20 74 68 65 20 76 61 6c 75 65 20 d and the value
2fc60 6f 66 20 2a 70 45 78 69 73 74 73 20 69 73 20 75 of *pExists is u
2fc70 6e 64 65 66 69 6e 65 64 2e 0a 2a 2f 0a 73 74 61 ndefined..*/.sta
2fc80 74 69 63 20 69 6e 74 20 68 61 73 48 6f 74 4a 6f tic int hasHotJo
2fc90 75 72 6e 61 6c 28 50 61 67 65 72 20 2a 70 50 61 urnal(Pager *pPa
2fca0 67 65 72 2c 20 69 6e 74 20 2a 70 45 78 69 73 74 ger, int *pExist
2fcb0 73 29 7b 0a 20 20 73 71 6c 69 74 65 33 5f 76 66 s){. sqlite3_vf
2fcc0 73 20 2a 20 63 6f 6e 73 74 20 70 56 66 73 20 3d s * const pVfs =
2fcd0 20 70 50 61 67 65 72 2d 3e 70 56 66 73 3b 0a 20 pPager->pVfs;.
2fce0 20 69 6e 74 20 72 63 20 3d 20 53 51 4c 49 54 45 int rc = SQLITE
2fcf0 5f 4f 4b 3b 20 20 20 20 20 20 20 20 20 20 20 2f _OK; /
2fd00 2a 20 52 65 74 75 72 6e 20 63 6f 64 65 20 2a 2f * Return code */
2fd10 0a 20 20 69 6e 74 20 65 78 69 73 74 73 20 3d 20 . int exists =
2fd20 31 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 1;
2fd30 20 2f 2a 20 54 72 75 65 20 69 66 20 61 20 6a 6f /* True if a jo
2fd40 75 72 6e 61 6c 20 66 69 6c 65 20 69 73 20 70 72 urnal file is pr
2fd50 65 73 65 6e 74 20 2a 2f 0a 20 20 69 6e 74 20 6a esent */. int j
2fd60 72 6e 6c 4f 70 65 6e 20 3d 20 21 21 69 73 4f 70 rnlOpen = !!isOp
2fd70 65 6e 28 70 50 61 67 65 72 2d 3e 6a 66 64 29 3b en(pPager->jfd);
2fd80 0a 0a 20 20 61 73 73 65 72 74 28 20 70 50 61 67 .. assert( pPag
2fd90 65 72 2d 3e 75 73 65 4a 6f 75 72 6e 61 6c 20 29 er->useJournal )
2fda0 3b 0a 20 20 61 73 73 65 72 74 28 20 69 73 4f 70 ;. assert( isOp
2fdb0 65 6e 28 70 50 61 67 65 72 2d 3e 66 64 29 20 29 en(pPager->fd) )
2fdc0 3b 0a 20 20 61 73 73 65 72 74 28 20 70 50 61 67 ;. assert( pPag
2fdd0 65 72 2d 3e 65 53 74 61 74 65 3d 3d 50 41 47 45 er->eState==PAGE
2fde0 52 5f 4f 50 45 4e 20 29 3b 0a 0a 20 20 61 73 73 R_OPEN );.. ass
2fdf0 65 72 74 28 20 6a 72 6e 6c 4f 70 65 6e 3d 3d 30 ert( jrnlOpen==0
2fe00 20 7c 7c 20 28 20 73 71 6c 69 74 65 33 4f 73 44 || ( sqlite3OsD
2fe10 65 76 69 63 65 43 68 61 72 61 63 74 65 72 69 73 eviceCharacteris
2fe20 74 69 63 73 28 70 50 61 67 65 72 2d 3e 6a 66 64 tics(pPager->jfd
2fe30 29 20 26 0a 20 20 20 20 53 51 4c 49 54 45 5f 49 ) &. SQLITE_I
2fe40 4f 43 41 50 5f 55 4e 44 45 4c 45 54 41 42 4c 45 OCAP_UNDELETABLE
2fe50 5f 57 48 45 4e 5f 4f 50 45 4e 0a 20 20 29 29 3b _WHEN_OPEN. ));
2fe60 0a 0a 20 20 2a 70 45 78 69 73 74 73 20 3d 20 30 .. *pExists = 0
2fe70 3b 0a 20 20 69 66 28 20 21 6a 72 6e 6c 4f 70 65 ;. if( !jrnlOpe
2fe80 6e 20 29 7b 0a 20 20 20 20 72 63 20 3d 20 73 71 n ){. rc = sq
2fe90 6c 69 74 65 33 4f 73 41 63 63 65 73 73 28 70 56 lite3OsAccess(pV
2fea0 66 73 2c 20 70 50 61 67 65 72 2d 3e 7a 4a 6f 75 fs, pPager->zJou
2feb0 72 6e 61 6c 2c 20 53 51 4c 49 54 45 5f 41 43 43 rnal, SQLITE_ACC
2fec0 45 53 53 5f 45 58 49 53 54 53 2c 20 26 65 78 69 ESS_EXISTS, &exi
2fed0 73 74 73 29 3b 0a 20 20 7d 0a 20 20 69 66 28 20 sts);. }. if(
2fee0 72 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 26 26 rc==SQLITE_OK &&
2fef0 20 65 78 69 73 74 73 20 29 7b 0a 20 20 20 20 69 exists ){. i
2ff00 6e 74 20 6c 6f 63 6b 65 64 20 3d 20 30 3b 20 20 nt locked = 0;
2ff10 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 54 72 /* Tr
2ff20 75 65 20 69 66 20 73 6f 6d 65 20 70 72 6f 63 65 ue if some proce
2ff30 73 73 20 68 6f 6c 64 73 20 61 20 52 45 53 45 52 ss holds a RESER
2ff40 56 45 44 20 6c 6f 63 6b 20 2a 2f 0a 0a 20 20 20 VED lock */..
2ff50 20 2f 2a 20 52 61 63 65 20 63 6f 6e 64 69 74 69 /* Race conditi
2ff60 6f 6e 20 68 65 72 65 3a 20 20 41 6e 6f 74 68 65 on here: Anothe
2ff70 72 20 70 72 6f 63 65 73 73 20 6d 69 67 68 74 20 r process might
2ff80 68 61 76 65 20 62 65 65 6e 20 68 6f 6c 64 69 6e have been holdin
2ff90 67 20 74 68 65 0a 20 20 20 20 2a 2a 20 74 68 65 g the. ** the
2ffa0 20 52 45 53 45 52 56 45 44 20 6c 6f 63 6b 20 61 RESERVED lock a
2ffb0 6e 64 20 68 61 76 65 20 61 20 6a 6f 75 72 6e 61 nd have a journa
2ffc0 6c 20 6f 70 65 6e 20 61 74 20 74 68 65 20 73 71 l open at the sq
2ffd0 6c 69 74 65 33 4f 73 41 63 63 65 73 73 28 29 20 lite3OsAccess()
2ffe0 0a 20 20 20 20 2a 2a 20 63 61 6c 6c 20 61 62 6f . ** call abo
2fff0 76 65 2c 20 62 75 74 20 74 68 65 6e 20 64 65 6c ve, but then del
30000 65 74 65 20 74 68 65 20 6a 6f 75 72 6e 61 6c 20 ete the journal
30010 61 6e 64 20 64 72 6f 70 20 74 68 65 20 6c 6f 63 and drop the loc
30020 6b 20 62 65 66 6f 72 65 0a 20 20 20 20 2a 2a 20 k before. **
30030 77 65 20 67 65 74 20 74 6f 20 74 68 65 20 66 6f we get to the fo
30040 6c 6c 6f 77 69 6e 67 20 73 71 6c 69 74 65 33 4f llowing sqlite3O
30050 73 43 68 65 63 6b 52 65 73 65 72 76 65 64 4c 6f sCheckReservedLo
30060 63 6b 28 29 20 63 61 6c 6c 2e 20 20 49 66 20 74 ck() call. If t
30070 68 61 74 0a 20 20 20 20 2a 2a 20 69 73 20 74 68 hat. ** is th
30080 65 20 63 61 73 65 2c 20 74 68 69 73 20 72 6f 75 e case, this rou
30090 74 69 6e 65 20 6d 69 67 68 74 20 74 68 69 6e 6b tine might think
300a0 20 74 68 65 72 65 20 69 73 20 61 20 68 6f 74 20 there is a hot
300b0 6a 6f 75 72 6e 61 6c 20 77 68 65 6e 0a 20 20 20 journal when.
300c0 20 2a 2a 20 69 6e 20 66 61 63 74 20 74 68 65 72 ** in fact ther
300d0 65 20 69 73 20 6e 6f 6e 65 2e 20 20 54 68 69 73 e is none. This
300e0 20 72 65 73 75 6c 74 73 20 69 6e 20 61 20 66 61 results in a fa
300f0 6c 73 65 2d 70 6f 73 69 74 69 76 65 20 77 68 69 lse-positive whi
30100 63 68 20 77 69 6c 6c 0a 20 20 20 20 2a 2a 20 62 ch will. ** b
30110 65 20 64 65 61 6c 74 20 77 69 74 68 20 62 79 20 e dealt with by
30120 74 68 65 20 70 6c 61 79 62 61 63 6b 20 72 6f 75 the playback rou
30130 74 69 6e 65 2e 20 20 54 69 63 6b 65 74 20 23 33 tine. Ticket #3
30140 38 38 33 2e 0a 20 20 20 20 2a 2f 0a 20 20 20 20 883.. */.
30150 72 63 20 3d 20 73 71 6c 69 74 65 33 4f 73 43 68 rc = sqlite3OsCh
30160 65 63 6b 52 65 73 65 72 76 65 64 4c 6f 63 6b 28 eckReservedLock(
30170 70 50 61 67 65 72 2d 3e 66 64 2c 20 26 6c 6f 63 pPager->fd, &loc
30180 6b 65 64 29 3b 0a 20 20 20 20 69 66 28 20 72 63 ked);. if( rc
30190 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 26 26 20 21 ==SQLITE_OK && !
301a0 6c 6f 63 6b 65 64 20 29 7b 0a 20 20 20 20 20 20 locked ){.
301b0 50 67 6e 6f 20 6e 50 61 67 65 3b 20 20 20 20 20 Pgno nPage;
301c0 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4e /* N
301d0 75 6d 62 65 72 20 6f 66 20 70 61 67 65 73 20 69 umber of pages i
301e0 6e 20 64 61 74 61 62 61 73 65 20 66 69 6c 65 20 n database file
301f0 2a 2f 0a 0a 20 20 20 20 20 20 61 73 73 65 72 74 */.. assert
30200 28 20 70 50 61 67 65 72 2d 3e 74 65 6d 70 46 69 ( pPager->tempFi
30210 6c 65 3d 3d 30 20 29 3b 0a 20 20 20 20 20 20 72 le==0 );. r
30220 63 20 3d 20 70 61 67 65 72 50 61 67 65 63 6f 75 c = pagerPagecou
30230 6e 74 28 70 50 61 67 65 72 2c 20 26 6e 50 61 67 nt(pPager, &nPag
30240 65 29 3b 0a 20 20 20 20 20 20 69 66 28 20 72 63 e);. if( rc
30250 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 ==SQLITE_OK ){.
30260 20 20 20 20 20 20 20 2f 2a 20 49 66 20 74 68 65 /* If the
30270 20 64 61 74 61 62 61 73 65 20 69 73 20 7a 65 72 database is zer
30280 6f 20 70 61 67 65 73 20 69 6e 20 73 69 7a 65 2c o pages in size,
30290 20 74 68 61 74 20 6d 65 61 6e 73 20 74 68 61 74 that means that
302a0 20 65 69 74 68 65 72 20 28 31 29 20 74 68 65 0a either (1) the.
302b0 20 20 20 20 20 20 20 20 2a 2a 20 6a 6f 75 72 6e ** journ
302c0 61 6c 20 69 73 20 61 20 72 65 6d 6e 61 6e 74 20 al is a remnant
302d0 66 72 6f 6d 20 61 20 70 72 69 6f 72 20 64 61 74 from a prior dat
302e0 61 62 61 73 65 20 77 69 74 68 20 74 68 65 20 73 abase with the s
302f0 61 6d 65 20 6e 61 6d 65 20 77 68 65 72 65 0a 20 ame name where.
30300 20 20 20 20 20 20 20 2a 2a 20 74 68 65 20 64 61 ** the da
30310 74 61 62 61 73 65 20 66 69 6c 65 20 62 75 74 20 tabase file but
30320 6e 6f 74 20 74 68 65 20 6a 6f 75 72 6e 61 6c 20 not the journal
30330 77 61 73 20 64 65 6c 65 74 65 64 2c 20 6f 72 20 was deleted, or
30340 28 32 29 20 74 68 65 20 69 6e 69 74 69 61 6c 0a (2) the initial.
30350 20 20 20 20 20 20 20 20 2a 2a 20 74 72 61 6e 73 ** trans
30360 61 63 74 69 6f 6e 20 74 68 61 74 20 70 6f 70 75 action that popu
30370 6c 61 74 65 73 20 61 20 6e 65 77 20 64 61 74 61 lates a new data
30380 62 61 73 65 20 69 73 20 62 65 69 6e 67 20 72 6f base is being ro
30390 6c 6c 65 64 20 62 61 63 6b 2e 0a 20 20 20 20 20 lled back..
303a0 20 20 20 2a 2a 20 49 6e 20 65 69 74 68 65 72 20 ** In either
303b0 63 61 73 65 2c 20 74 68 65 20 6a 6f 75 72 6e 61 case, the journa
303c0 6c 20 66 69 6c 65 20 63 61 6e 20 62 65 20 64 65 l file can be de
303d0 6c 65 74 65 64 2e 20 20 48 6f 77 65 76 65 72 2c leted. However,
303e0 20 74 61 6b 65 20 63 61 72 65 0a 20 20 20 20 20 take care.
303f0 20 20 20 2a 2a 20 6e 6f 74 20 74 6f 20 64 65 6c ** not to del
30400 65 74 65 20 74 68 65 20 6a 6f 75 72 6e 61 6c 20 ete the journal
30410 66 69 6c 65 20 69 66 20 69 74 20 69 73 20 61 6c file if it is al
30420 72 65 61 64 79 20 6f 70 65 6e 20 64 75 65 20 74 ready open due t
30430 6f 0a 20 20 20 20 20 20 20 20 2a 2a 20 6a 6f 75 o. ** jou
30440 72 6e 61 6c 5f 6d 6f 64 65 3d 50 45 52 53 49 53 rnal_mode=PERSIS
30450 54 2e 0a 20 20 20 20 20 20 20 20 2a 2f 0a 20 20 T.. */.
30460 20 20 20 20 20 20 69 66 28 20 6e 50 61 67 65 3d if( nPage=
30470 3d 30 20 26 26 20 21 6a 72 6e 6c 4f 70 65 6e 20 =0 && !jrnlOpen
30480 29 7b 0a 20 20 20 20 20 20 20 20 20 20 73 71 6c ){. sql
30490 69 74 65 33 42 65 67 69 6e 42 65 6e 69 67 6e 4d ite3BeginBenignM
304a0 61 6c 6c 6f 63 28 29 3b 0a 20 20 20 20 20 20 20 alloc();.
304b0 20 20 20 69 66 28 20 70 61 67 65 72 4c 6f 63 6b if( pagerLock
304c0 44 62 28 70 50 61 67 65 72 2c 20 52 45 53 45 52 Db(pPager, RESER
304d0 56 45 44 5f 4c 4f 43 4b 29 3d 3d 53 51 4c 49 54 VED_LOCK)==SQLIT
304e0 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 20 20 20 20 E_OK ){.
304f0 20 20 20 20 73 71 6c 69 74 65 33 4f 73 44 65 6c sqlite3OsDel
30500 65 74 65 28 70 56 66 73 2c 20 70 50 61 67 65 72 ete(pVfs, pPager
30510 2d 3e 7a 4a 6f 75 72 6e 61 6c 2c 20 30 29 3b 0a ->zJournal, 0);.
30520 20 20 20 20 20 20 20 20 20 20 20 20 69 66 28 20 if(
30530 21 70 50 61 67 65 72 2d 3e 65 78 63 6c 75 73 69 !pPager->exclusi
30540 76 65 4d 6f 64 65 20 29 20 70 61 67 65 72 55 6e veMode ) pagerUn
30550 6c 6f 63 6b 44 62 28 70 50 61 67 65 72 2c 20 53 lockDb(pPager, S
30560 48 41 52 45 44 5f 4c 4f 43 4b 29 3b 0a 20 20 20 HARED_LOCK);.
30570 20 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 20 }.
30580 20 20 20 73 71 6c 69 74 65 33 45 6e 64 42 65 6e sqlite3EndBen
30590 69 67 6e 4d 61 6c 6c 6f 63 28 29 3b 0a 20 20 20 ignMalloc();.
305a0 20 20 20 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 }else{.
305b0 20 20 20 20 20 20 2f 2a 20 54 68 65 20 6a 6f 75 /* The jou
305c0 72 6e 61 6c 20 66 69 6c 65 20 65 78 69 73 74 73 rnal file exists
305d0 20 61 6e 64 20 6e 6f 20 6f 74 68 65 72 20 63 6f and no other co
305e0 6e 6e 65 63 74 69 6f 6e 20 68 61 73 20 61 20 72 nnection has a r
305f0 65 73 65 72 76 65 64 0a 20 20 20 20 20 20 20 20 eserved.
30600 20 20 2a 2a 20 6f 72 20 67 72 65 61 74 65 72 20 ** or greater
30610 6c 6f 63 6b 20 6f 6e 20 74 68 65 20 64 61 74 61 lock on the data
30620 62 61 73 65 20 66 69 6c 65 2e 20 4e 6f 77 20 63 base file. Now c
30630 68 65 63 6b 20 74 68 61 74 20 74 68 65 72 65 20 heck that there
30640 69 73 0a 20 20 20 20 20 20 20 20 20 20 2a 2a 20 is. **
30650 61 74 20 6c 65 61 73 74 20 6f 6e 65 20 6e 6f 6e at least one non
30660 2d 7a 65 72 6f 20 62 79 74 65 73 20 61 74 20 74 -zero bytes at t
30670 68 65 20 73 74 61 72 74 20 6f 66 20 74 68 65 20 he start of the
30680 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 2e 0a 20 20 journal file..
30690 20 20 20 20 20 20 20 20 2a 2a 20 49 66 20 74 68 ** If th
306a0 65 72 65 20 69 73 2c 20 74 68 65 6e 20 77 65 20 ere is, then we
306b0 63 6f 6e 73 69 64 65 72 20 74 68 69 73 20 6a 6f consider this jo
306c0 75 72 6e 61 6c 20 74 6f 20 62 65 20 68 6f 74 2e urnal to be hot.
306d0 20 49 66 20 6e 6f 74 2c 20 0a 20 20 20 20 20 20 If not, .
306e0 20 20 20 20 2a 2a 20 69 74 20 63 61 6e 20 62 65 ** it can be
306f0 20 69 67 6e 6f 72 65 64 2e 0a 20 20 20 20 20 20 ignored..
30700 20 20 20 20 2a 2f 0a 20 20 20 20 20 20 20 20 20 */.
30710 20 69 66 28 20 21 6a 72 6e 6c 4f 70 65 6e 20 29 if( !jrnlOpen )
30720 7b 0a 20 20 20 20 20 20 20 20 20 20 20 20 69 6e {. in
30730 74 20 66 20 3d 20 53 51 4c 49 54 45 5f 4f 50 45 t f = SQLITE_OPE
30740 4e 5f 52 45 41 44 4f 4e 4c 59 7c 53 51 4c 49 54 N_READONLY|SQLIT
30750 45 5f 4f 50 45 4e 5f 4d 41 49 4e 5f 4a 4f 55 52 E_OPEN_MAIN_JOUR
30760 4e 41 4c 3b 0a 20 20 20 20 20 20 20 20 20 20 20 NAL;.
30770 20 72 63 20 3d 20 73 71 6c 69 74 65 33 4f 73 4f rc = sqlite3OsO
30780 70 65 6e 28 70 56 66 73 2c 20 70 50 61 67 65 72 pen(pVfs, pPager
30790 2d 3e 7a 4a 6f 75 72 6e 61 6c 2c 20 70 50 61 67 ->zJournal, pPag
307a0 65 72 2d 3e 6a 66 64 2c 20 66 2c 20 26 66 29 3b er->jfd, f, &f);
307b0 0a 20 20 20 20 20 20 20 20 20 20 7d 0a 20 20 20 . }.
307c0 20 20 20 20 20 20 20 69 66 28 20 72 63 3d 3d 53 if( rc==S
307d0 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 QLITE_OK ){.
307e0 20 20 20 20 20 20 20 20 75 38 20 66 69 72 73 74 u8 first
307f0 20 3d 20 30 3b 0a 20 20 20 20 20 20 20 20 20 20 = 0;.
30800 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33 4f 73 rc = sqlite3Os
30810 52 65 61 64 28 70 50 61 67 65 72 2d 3e 6a 66 64 Read(pPager->jfd
30820 2c 20 28 76 6f 69 64 20 2a 29 26 66 69 72 73 74 , (void *)&first
30830 2c 20 31 2c 20 30 29 3b 0a 20 20 20 20 20 20 20 , 1, 0);.
30840 20 20 20 20 20 69 66 28 20 72 63 3d 3d 53 51 4c if( rc==SQL
30850 49 54 45 5f 49 4f 45 52 52 5f 53 48 4f 52 54 5f ITE_IOERR_SHORT_
30860 52 45 41 44 20 29 7b 0a 20 20 20 20 20 20 20 20 READ ){.
30870 20 20 20 20 20 20 72 63 20 3d 20 53 51 4c 49 54 rc = SQLIT
30880 45 5f 4f 4b 3b 0a 20 20 20 20 20 20 20 20 20 20 E_OK;.
30890 20 20 7d 0a 20 20 20 20 20 20 20 20 20 20 20 20 }.
308a0 69 66 28 20 21 6a 72 6e 6c 4f 70 65 6e 20 29 7b if( !jrnlOpen ){
308b0 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 73 . s
308c0 71 6c 69 74 65 33 4f 73 43 6c 6f 73 65 28 70 50 qlite3OsClose(pP
308d0 61 67 65 72 2d 3e 6a 66 64 29 3b 0a 20 20 20 20 ager->jfd);.
308e0 20 20 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 }.
308f0 20 20 20 20 20 20 2a 70 45 78 69 73 74 73 20 3d *pExists =
30900 20 28 66 69 72 73 74 21 3d 30 29 3b 0a 20 20 20 (first!=0);.
30910 20 20 20 20 20 20 20 7d 65 6c 73 65 20 69 66 28 }else if(
30920 20 72 63 3d 3d 53 51 4c 49 54 45 5f 43 41 4e 54 rc==SQLITE_CANT
30930 4f 50 45 4e 20 29 7b 0a 20 20 20 20 20 20 20 20 OPEN ){.
30940 20 20 20 20 2f 2a 20 49 66 20 77 65 20 63 61 6e /* If we can
30950 6e 6f 74 20 6f 70 65 6e 20 74 68 65 20 72 6f 6c not open the rol
30960 6c 62 61 63 6b 20 6a 6f 75 72 6e 61 6c 20 66 69 lback journal fi
30970 6c 65 20 69 6e 20 6f 72 64 65 72 20 74 6f 20 73 le in order to s
30980 65 65 20 69 66 0a 20 20 20 20 20 20 20 20 20 20 ee if.
30990 20 20 2a 2a 20 69 74 20 68 61 73 20 61 20 7a 65 ** it has a ze
309a0 72 6f 20 68 65 61 64 65 72 2c 20 74 68 61 74 20 ro header, that
309b0 6d 69 67 68 74 20 62 65 20 64 75 65 20 74 6f 20 might be due to
309c0 61 6e 20 49 2f 4f 20 65 72 72 6f 72 2c 20 6f 72 an I/O error, or
309d0 0a 20 20 20 20 20 20 20 20 20 20 20 20 2a 2a 20 . **
309e0 69 74 20 6d 69 67 68 74 20 62 65 20 64 75 65 20 it might be due
309f0 74 6f 20 74 68 65 20 72 61 63 65 20 63 6f 6e 64 to the race cond
30a00 69 74 69 6f 6e 20 64 65 73 63 72 69 62 65 64 20 ition described
30a10 61 62 6f 76 65 20 61 6e 64 20 69 6e 0a 20 20 20 above and in.
30a20 20 20 20 20 20 20 20 20 20 2a 2a 20 74 69 63 6b ** tick
30a30 65 74 20 23 33 38 38 33 2e 20 20 45 69 74 68 65 et #3883. Eithe
30a40 72 20 77 61 79 2c 20 61 73 73 75 6d 65 20 74 68 r way, assume th
30a50 61 74 20 74 68 65 20 6a 6f 75 72 6e 61 6c 20 69 at the journal i
30a60 73 20 68 6f 74 2e 0a 20 20 20 20 20 20 20 20 20 s hot..
30a70 20 20 20 2a 2a 20 54 68 69 73 20 6d 69 67 68 74 ** This might
30a80 20 62 65 20 61 20 66 61 6c 73 65 20 70 6f 73 69 be a false posi
30a90 74 69 76 65 2e 20 20 42 75 74 20 69 66 20 69 74 tive. But if it
30aa0 20 69 73 2c 20 74 68 65 6e 20 74 68 65 0a 20 20 is, then the.
30ab0 20 20 20 20 20 20 20 20 20 20 2a 2a 20 61 75 74 ** aut
30ac0 6f 6d 61 74 69 63 20 6a 6f 75 72 6e 61 6c 20 70 omatic journal p
30ad0 6c 61 79 62 61 63 6b 20 61 6e 64 20 72 65 63 6f layback and reco
30ae0 76 65 72 79 20 6d 65 63 68 61 6e 69 73 6d 20 77 very mechanism w
30af0 69 6c 6c 20 64 65 61 6c 0a 20 20 20 20 20 20 20 ill deal.
30b00 20 20 20 20 20 2a 2a 20 77 69 74 68 20 69 74 20 ** with it
30b10 75 6e 64 65 72 20 61 6e 20 45 58 43 4c 55 53 49 under an EXCLUSI
30b20 56 45 20 6c 6f 63 6b 20 77 68 65 72 65 20 77 65 VE lock where we
30b30 20 64 6f 20 6e 6f 74 20 6e 65 65 64 20 74 6f 0a do not need to.
30b40 20 20 20 20 20 20 20 20 20 20 20 20 2a 2a 20 77 ** w
30b50 6f 72 72 79 20 73 6f 20 6d 75 63 68 20 77 69 74 orry so much wit
30b60 68 20 72 61 63 65 20 63 6f 6e 64 69 74 69 6f 6e h race condition
30b70 73 2e 0a 20 20 20 20 20 20 20 20 20 20 20 20 2a s.. *
30b80 2f 0a 20 20 20 20 20 20 20 20 20 20 20 20 2a 70 /. *p
30b90 45 78 69 73 74 73 20 3d 20 31 3b 0a 20 20 20 20 Exists = 1;.
30ba0 20 20 20 20 20 20 20 20 72 63 20 3d 20 53 51 4c rc = SQL
30bb0 49 54 45 5f 4f 4b 3b 0a 20 20 20 20 20 20 20 20 ITE_OK;.
30bc0 20 20 7d 0a 20 20 20 20 20 20 20 20 7d 0a 20 20 }. }.
30bd0 20 20 20 20 7d 0a 20 20 20 20 7d 0a 20 20 7d 0a }. }. }.
30be0 0a 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 7d 0a . return rc;.}.
30bf0 0a 2f 2a 0a 2a 2a 20 54 68 69 73 20 66 75 6e 63 ./*.** This func
30c00 74 69 6f 6e 20 69 73 20 63 61 6c 6c 65 64 20 74 tion is called t
30c10 6f 20 6f 62 74 61 69 6e 20 61 20 73 68 61 72 65 o obtain a share
30c20 64 20 6c 6f 63 6b 20 6f 6e 20 74 68 65 20 64 61 d lock on the da
30c30 74 61 62 61 73 65 20 66 69 6c 65 2e 0a 2a 2a 20 tabase file..**
30c40 49 74 20 69 73 20 69 6c 6c 65 67 61 6c 20 74 6f It is illegal to
30c50 20 63 61 6c 6c 20 73 71 6c 69 74 65 33 50 61 67 call sqlite3Pag
30c60 65 72 47 65 74 28 29 20 75 6e 74 69 6c 20 61 66 erGet() until af
30c70 74 65 72 20 74 68 69 73 20 66 75 6e 63 74 69 6f ter this functio
30c80 6e 0a 2a 2a 20 68 61 73 20 62 65 65 6e 20 73 75 n.** has been su
30c90 63 63 65 73 73 66 75 6c 6c 79 20 63 61 6c 6c 65 ccessfully calle
30ca0 64 2e 20 49 66 20 61 20 73 68 61 72 65 64 2d 6c d. If a shared-l
30cb0 6f 63 6b 20 69 73 20 61 6c 72 65 61 64 79 20 68 ock is already h
30cc0 65 6c 64 20 77 68 65 6e 0a 2a 2a 20 74 68 69 73 eld when.** this
30cd0 20 66 75 6e 63 74 69 6f 6e 20 69 73 20 63 61 6c function is cal
30ce0 6c 65 64 2c 20 69 74 20 69 73 20 61 20 6e 6f 2d led, it is a no-
30cf0 6f 70 2e 0a 2a 2a 0a 2a 2a 20 54 68 65 20 66 6f op..**.** The fo
30d00 6c 6c 6f 77 69 6e 67 20 6f 70 65 72 61 74 69 6f llowing operatio
30d10 6e 73 20 61 72 65 20 61 6c 73 6f 20 70 65 72 66 ns are also perf
30d20 6f 72 6d 65 64 20 62 79 20 74 68 69 73 20 66 75 ormed by this fu
30d30 6e 63 74 69 6f 6e 2e 0a 2a 2a 0a 2a 2a 20 20 20 nction..**.**
30d40 31 29 20 49 66 20 74 68 65 20 70 61 67 65 72 20 1) If the pager
30d50 69 73 20 63 75 72 72 65 6e 74 6c 79 20 69 6e 20 is currently in
30d60 50 41 47 45 52 5f 4f 50 45 4e 20 73 74 61 74 65 PAGER_OPEN state
30d70 20 28 6e 6f 20 6c 6f 63 6b 20 68 65 6c 64 0a 2a (no lock held.*
30d80 2a 20 20 20 20 20 20 6f 6e 20 74 68 65 20 64 61 * on the da
30d90 74 61 62 61 73 65 20 66 69 6c 65 29 2c 20 74 68 tabase file), th
30da0 65 6e 20 61 6e 20 61 74 74 65 6d 70 74 20 69 73 en an attempt is
30db0 20 6d 61 64 65 20 74 6f 20 6f 62 74 61 69 6e 20 made to obtain
30dc0 61 0a 2a 2a 20 20 20 20 20 20 53 48 41 52 45 44 a.** SHARED
30dd0 20 6c 6f 63 6b 20 6f 6e 20 74 68 65 20 64 61 74 lock on the dat
30de0 61 62 61 73 65 20 66 69 6c 65 2e 20 49 6d 6d 65 abase file. Imme
30df0 64 69 61 74 65 6c 79 20 61 66 74 65 72 20 6f 62 diately after ob
30e00 74 61 69 6e 69 6e 67 0a 2a 2a 20 20 20 20 20 20 taining.**
30e10 74 68 65 20 53 48 41 52 45 44 20 6c 6f 63 6b 2c the SHARED lock,
30e20 20 74 68 65 20 66 69 6c 65 2d 73 79 73 74 65 6d the file-system
30e30 20 69 73 20 63 68 65 63 6b 65 64 20 66 6f 72 20 is checked for
30e40 61 20 68 6f 74 2d 6a 6f 75 72 6e 61 6c 2c 0a 2a a hot-journal,.*
30e50 2a 20 20 20 20 20 20 77 68 69 63 68 20 69 73 20 * which is
30e60 70 6c 61 79 65 64 20 62 61 63 6b 20 69 66 20 70 played back if p
30e70 72 65 73 65 6e 74 2e 20 46 6f 6c 6c 6f 77 69 6e resent. Followin
30e80 67 20 61 6e 79 20 68 6f 74 2d 6a 6f 75 72 6e 61 g any hot-journa
30e90 6c 20 0a 2a 2a 20 20 20 20 20 20 72 6f 6c 6c 62 l .** rollb
30ea0 61 63 6b 2c 20 74 68 65 20 63 6f 6e 74 65 6e 74 ack, the content
30eb0 73 20 6f 66 20 74 68 65 20 63 61 63 68 65 20 61 s of the cache a
30ec0 72 65 20 76 61 6c 69 64 61 74 65 64 20 62 79 20 re validated by
30ed0 63 68 65 63 6b 69 6e 67 0a 2a 2a 20 20 20 20 20 checking.**
30ee0 20 74 68 65 20 27 63 68 61 6e 67 65 2d 63 6f 75 the 'change-cou
30ef0 6e 74 65 72 27 20 66 69 65 6c 64 20 6f 66 20 74 nter' field of t
30f00 68 65 20 64 61 74 61 62 61 73 65 20 66 69 6c 65 he database file
30f10 20 68 65 61 64 65 72 20 61 6e 64 0a 2a 2a 20 20 header and.**
30f20 20 20 20 20 64 69 73 63 61 72 64 65 64 20 69 66 discarded if
30f30 20 74 68 65 79 20 61 72 65 20 66 6f 75 6e 64 20 they are found
30f40 74 6f 20 62 65 20 69 6e 76 61 6c 69 64 2e 0a 2a to be invalid..*
30f50 2a 0a 2a 2a 20 20 20 32 29 20 49 66 20 74 68 65 *.** 2) If the
30f60 20 70 61 67 65 72 20 69 73 20 72 75 6e 6e 69 6e pager is runnin
30f70 67 20 69 6e 20 65 78 63 6c 75 73 69 76 65 2d 6d g in exclusive-m
30f80 6f 64 65 2c 20 61 6e 64 20 74 68 65 72 65 20 61 ode, and there a
30f90 72 65 20 63 75 72 72 65 6e 74 6c 79 0a 2a 2a 20 re currently.**
30fa0 20 20 20 20 20 6e 6f 20 6f 75 74 73 74 61 6e 64 no outstand
30fb0 69 6e 67 20 72 65 66 65 72 65 6e 63 65 73 20 74 ing references t
30fc0 6f 20 61 6e 79 20 70 61 67 65 73 2c 20 61 6e 64 o any pages, and
30fd0 20 69 73 20 69 6e 20 74 68 65 20 65 72 72 6f 72 is in the error
30fe0 20 73 74 61 74 65 2c 0a 2a 2a 20 20 20 20 20 20 state,.**
30ff0 74 68 65 6e 20 61 6e 20 61 74 74 65 6d 70 74 20 then an attempt
31000 69 73 20 6d 61 64 65 20 74 6f 20 63 6c 65 61 72 is made to clear
31010 20 74 68 65 20 65 72 72 6f 72 20 73 74 61 74 65 the error state
31020 20 62 79 20 64 69 73 63 61 72 64 69 6e 67 0a 2a by discarding.*
31030 2a 20 20 20 20 20 20 74 68 65 20 63 6f 6e 74 65 * the conte
31040 6e 74 73 20 6f 66 20 74 68 65 20 70 61 67 65 20 nts of the page
31050 63 61 63 68 65 20 61 6e 64 20 72 6f 6c 6c 69 6e cache and rollin
31060 67 20 62 61 63 6b 20 61 6e 79 20 6f 70 65 6e 20 g back any open
31070 6a 6f 75 72 6e 61 6c 0a 2a 2a 20 20 20 20 20 20 journal.**
31080 66 69 6c 65 2e 0a 2a 2a 0a 2a 2a 20 49 66 20 65 file..**.** If e
31090 76 65 72 79 74 68 69 6e 67 20 69 73 20 73 75 63 verything is suc
310a0 63 65 73 73 66 75 6c 2c 20 53 51 4c 49 54 45 5f cessful, SQLITE_
310b0 4f 4b 20 69 73 20 72 65 74 75 72 6e 65 64 2e 20 OK is returned.
310c0 49 66 20 61 6e 20 49 4f 20 65 72 72 6f 72 20 0a If an IO error .
310d0 2a 2a 20 6f 63 63 75 72 73 20 77 68 69 6c 65 20 ** occurs while
310e0 6c 6f 63 6b 69 6e 67 20 74 68 65 20 64 61 74 61 locking the data
310f0 62 61 73 65 2c 20 63 68 65 63 6b 69 6e 67 20 66 base, checking f
31100 6f 72 20 61 20 68 6f 74 2d 6a 6f 75 72 6e 61 6c or a hot-journal
31110 20 66 69 6c 65 20 6f 72 20 0a 2a 2a 20 72 6f 6c file or .** rol
31120 6c 69 6e 67 20 62 61 63 6b 20 61 20 6a 6f 75 72 ling back a jour
31130 6e 61 6c 20 66 69 6c 65 2c 20 74 68 65 20 49 4f nal file, the IO
31140 20 65 72 72 6f 72 20 63 6f 64 65 20 69 73 20 72 error code is r
31150 65 74 75 72 6e 65 64 2e 0a 2a 2f 0a 69 6e 74 20 eturned..*/.int
31160 73 71 6c 69 74 65 33 50 61 67 65 72 53 68 61 72 sqlite3PagerShar
31170 65 64 4c 6f 63 6b 28 50 61 67 65 72 20 2a 70 50 edLock(Pager *pP
31180 61 67 65 72 29 7b 0a 20 20 69 6e 74 20 72 63 20 ager){. int rc
31190 3d 20 53 51 4c 49 54 45 5f 4f 4b 3b 20 20 20 20 = SQLITE_OK;
311a0 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 52 /* R
311b0 65 74 75 72 6e 20 63 6f 64 65 20 2a 2f 0a 0a 20 eturn code */..
311c0 20 2f 2a 20 54 68 69 73 20 72 6f 75 74 69 6e 65 /* This routine
311d0 20 69 73 20 6f 6e 6c 79 20 63 61 6c 6c 65 64 20 is only called
311e0 66 72 6f 6d 20 62 2d 74 72 65 65 20 61 6e 64 20 from b-tree and
311f0 6f 6e 6c 79 20 77 68 65 6e 20 74 68 65 72 65 20 only when there
31200 61 72 65 20 6e 6f 0a 20 20 2a 2a 20 6f 75 74 73 are no. ** outs
31210 74 61 6e 64 69 6e 67 20 70 61 67 65 73 2e 20 54 tanding pages. T
31220 68 69 73 20 69 6d 70 6c 69 65 73 20 74 68 61 74 his implies that
31230 20 74 68 65 20 70 61 67 65 72 20 73 74 61 74 65 the pager state
31240 20 73 68 6f 75 6c 64 20 65 69 74 68 65 72 0a 20 should either.
31250 20 2a 2a 20 62 65 20 4f 50 45 4e 20 6f 72 20 52 ** be OPEN or R
31260 45 41 44 45 52 2e 20 52 45 41 44 45 52 20 69 73 EADER. READER is
31270 20 6f 6e 6c 79 20 70 6f 73 73 69 62 6c 65 20 69 only possible i
31280 66 20 74 68 65 20 70 61 67 65 72 20 69 73 20 6f f the pager is o
31290 72 20 77 61 73 20 69 6e 20 0a 20 20 2a 2a 20 65 r was in . ** e
312a0 78 63 6c 75 73 69 76 65 20 61 63 63 65 73 73 20 xclusive access
312b0 6d 6f 64 65 2e 20 20 2a 2f 0a 20 20 61 73 73 65 mode. */. asse
312c0 72 74 28 20 73 71 6c 69 74 65 33 50 63 61 63 68 rt( sqlite3Pcach
312d0 65 52 65 66 43 6f 75 6e 74 28 70 50 61 67 65 72 eRefCount(pPager
312e0 2d 3e 70 50 43 61 63 68 65 29 3d 3d 30 20 29 3b ->pPCache)==0 );
312f0 0a 20 20 61 73 73 65 72 74 28 20 61 73 73 65 72 . assert( asser
31300 74 5f 70 61 67 65 72 5f 73 74 61 74 65 28 70 50 t_pager_state(pP
31310 61 67 65 72 29 20 29 3b 0a 20 20 61 73 73 65 72 ager) );. asser
31320 74 28 20 70 50 61 67 65 72 2d 3e 65 53 74 61 74 t( pPager->eStat
31330 65 3d 3d 50 41 47 45 52 5f 4f 50 45 4e 20 7c 7c e==PAGER_OPEN ||
31340 20 70 50 61 67 65 72 2d 3e 65 53 74 61 74 65 3d pPager->eState=
31350 3d 50 41 47 45 52 5f 52 45 41 44 45 52 20 29 3b =PAGER_READER );
31360 0a 20 20 61 73 73 65 72 74 28 20 70 50 61 67 65 . assert( pPage
31370 72 2d 3e 65 72 72 43 6f 64 65 3d 3d 53 51 4c 49 r->errCode==SQLI
31380 54 45 5f 4f 4b 20 29 3b 0a 0a 20 20 69 66 28 20 TE_OK );.. if(
31390 21 70 61 67 65 72 55 73 65 57 61 6c 28 70 50 61 !pagerUseWal(pPa
313a0 67 65 72 29 20 26 26 20 70 50 61 67 65 72 2d 3e ger) && pPager->
313b0 65 53 74 61 74 65 3d 3d 50 41 47 45 52 5f 4f 50 eState==PAGER_OP
313c0 45 4e 20 29 7b 0a 20 20 20 20 69 6e 74 20 62 48 EN ){. int bH
313d0 6f 74 4a 6f 75 72 6e 61 6c 20 3d 20 31 3b 20 20 otJournal = 1;
313e0 20 20 20 20 20 20 20 20 2f 2a 20 54 72 75 65 20 /* True
313f0 69 66 20 74 68 65 72 65 20 65 78 69 73 74 73 20 if there exists
31400 61 20 68 6f 74 20 6a 6f 75 72 6e 61 6c 2d 66 69 a hot journal-fi
31410 6c 65 20 2a 2f 0a 0a 20 20 20 20 61 73 73 65 72 le */.. asser
31420 74 28 20 21 4d 45 4d 44 42 20 29 3b 0a 20 20 20 t( !MEMDB );.
31430 20 61 73 73 65 72 74 28 20 70 50 61 67 65 72 2d assert( pPager-
31440 3e 74 65 6d 70 46 69 6c 65 3d 3d 30 20 7c 7c 20 >tempFile==0 ||
31450 70 50 61 67 65 72 2d 3e 65 4c 6f 63 6b 3d 3d 45 pPager->eLock==E
31460 58 43 4c 55 53 49 56 45 5f 4c 4f 43 4b 20 29 3b XCLUSIVE_LOCK );
31470 0a 0a 20 20 20 20 72 63 20 3d 20 70 61 67 65 72 .. rc = pager
31480 5f 77 61 69 74 5f 6f 6e 5f 6c 6f 63 6b 28 70 50 _wait_on_lock(pP
31490 61 67 65 72 2c 20 53 48 41 52 45 44 5f 4c 4f 43 ager, SHARED_LOC
314a0 4b 29 3b 0a 20 20 20 20 69 66 28 20 72 63 21 3d K);. if( rc!=
314b0 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 SQLITE_OK ){.
314c0 20 20 20 61 73 73 65 72 74 28 20 70 50 61 67 65 assert( pPage
314d0 72 2d 3e 65 4c 6f 63 6b 3d 3d 4e 4f 5f 4c 4f 43 r->eLock==NO_LOC
314e0 4b 20 7c 7c 20 70 50 61 67 65 72 2d 3e 65 4c 6f K || pPager->eLo
314f0 63 6b 3d 3d 55 4e 4b 4e 4f 57 4e 5f 4c 4f 43 4b ck==UNKNOWN_LOCK
31500 20 29 3b 0a 20 20 20 20 20 20 67 6f 74 6f 20 66 );. goto f
31510 61 69 6c 65 64 3b 0a 20 20 20 20 7d 0a 0a 20 20 ailed;. }..
31520 20 20 2f 2a 20 49 66 20 61 20 6a 6f 75 72 6e 61 /* If a journa
31530 6c 20 66 69 6c 65 20 65 78 69 73 74 73 2c 20 61 l file exists, a
31540 6e 64 20 74 68 65 72 65 20 69 73 20 6e 6f 20 52 nd there is no R
31550 45 53 45 52 56 45 44 20 6c 6f 63 6b 20 6f 6e 20 ESERVED lock on
31560 74 68 65 0a 20 20 20 20 2a 2a 20 64 61 74 61 62 the. ** datab
31570 61 73 65 20 66 69 6c 65 2c 20 74 68 65 6e 20 69 ase file, then i
31580 74 20 65 69 74 68 65 72 20 6e 65 65 64 73 20 74 t either needs t
31590 6f 20 62 65 20 70 6c 61 79 65 64 20 62 61 63 6b o be played back
315a0 20 6f 72 20 64 65 6c 65 74 65 64 2e 0a 20 20 20 or deleted..
315b0 20 2a 2f 0a 20 20 20 20 69 66 28 20 70 50 61 67 */. if( pPag
315c0 65 72 2d 3e 65 4c 6f 63 6b 3c 3d 53 48 41 52 45 er->eLock<=SHARE
315d0 44 5f 4c 4f 43 4b 20 29 7b 0a 20 20 20 20 20 20 D_LOCK ){.
315e0 72 63 20 3d 20 68 61 73 48 6f 74 4a 6f 75 72 6e rc = hasHotJourn
315f0 61 6c 28 70 50 61 67 65 72 2c 20 26 62 48 6f 74 al(pPager, &bHot
31600 4a 6f 75 72 6e 61 6c 29 3b 0a 20 20 20 20 7d 0a Journal);. }.
31610 20 20 20 20 69 66 28 20 72 63 21 3d 53 51 4c 49 if( rc!=SQLI
31620 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 20 20 67 TE_OK ){. g
31630 6f 74 6f 20 66 61 69 6c 65 64 3b 0a 20 20 20 20 oto failed;.
31640 7d 0a 20 20 20 20 69 66 28 20 62 48 6f 74 4a 6f }. if( bHotJo
31650 75 72 6e 61 6c 20 29 7b 0a 20 20 20 20 20 20 69 urnal ){. i
31660 66 28 20 70 50 61 67 65 72 2d 3e 72 65 61 64 4f f( pPager->readO
31670 6e 6c 79 20 29 7b 0a 20 20 20 20 20 20 20 20 72 nly ){. r
31680 63 20 3d 20 53 51 4c 49 54 45 5f 52 45 41 44 4f c = SQLITE_READO
31690 4e 4c 59 5f 52 4f 4c 4c 42 41 43 4b 3b 0a 20 20 NLY_ROLLBACK;.
316a0 20 20 20 20 20 20 67 6f 74 6f 20 66 61 69 6c 65 goto faile
316b0 64 3b 0a 20 20 20 20 20 20 7d 0a 0a 20 20 20 20 d;. }..
316c0 20 20 2f 2a 20 47 65 74 20 61 6e 20 45 58 43 4c /* Get an EXCL
316d0 55 53 49 56 45 20 6c 6f 63 6b 20 6f 6e 20 74 68 USIVE lock on th
316e0 65 20 64 61 74 61 62 61 73 65 20 66 69 6c 65 2e e database file.
316f0 20 41 74 20 74 68 69 73 20 70 6f 69 6e 74 20 69 At this point i
31700 74 20 69 73 0a 20 20 20 20 20 20 2a 2a 20 69 6d t is. ** im
31710 70 6f 72 74 61 6e 74 20 74 68 61 74 20 61 20 52 portant that a R
31720 45 53 45 52 56 45 44 20 6c 6f 63 6b 20 69 73 20 ESERVED lock is
31730 6e 6f 74 20 6f 62 74 61 69 6e 65 64 20 6f 6e 20 not obtained on
31740 74 68 65 20 77 61 79 20 74 6f 20 74 68 65 0a 20 the way to the.
31750 20 20 20 20 20 2a 2a 20 45 58 43 4c 55 53 49 56 ** EXCLUSIV
31760 45 20 6c 6f 63 6b 2e 20 49 66 20 69 74 20 77 65 E lock. If it we
31770 72 65 2c 20 61 6e 6f 74 68 65 72 20 70 72 6f 63 re, another proc
31780 65 73 73 20 6d 69 67 68 74 20 6f 70 65 6e 20 74 ess might open t
31790 68 65 0a 20 20 20 20 20 20 2a 2a 20 64 61 74 61 he. ** data
317a0 62 61 73 65 20 66 69 6c 65 2c 20 64 65 74 65 63 base file, detec
317b0 74 20 74 68 65 20 52 45 53 45 52 56 45 44 20 6c t the RESERVED l
317c0 6f 63 6b 2c 20 61 6e 64 20 63 6f 6e 63 6c 75 64 ock, and conclud
317d0 65 20 74 68 61 74 20 74 68 65 0a 20 20 20 20 20 e that the.
317e0 20 2a 2a 20 64 61 74 61 62 61 73 65 20 69 73 20 ** database is
317f0 73 61 66 65 20 74 6f 20 72 65 61 64 20 77 68 69 safe to read whi
31800 6c 65 20 74 68 69 73 20 70 72 6f 63 65 73 73 20 le this process
31810 69 73 20 73 74 69 6c 6c 20 72 6f 6c 6c 69 6e 67 is still rolling
31820 20 74 68 65 20 0a 20 20 20 20 20 20 2a 2a 20 68 the . ** h
31830 6f 74 2d 6a 6f 75 72 6e 61 6c 20 62 61 63 6b 2e ot-journal back.
31840 0a 20 20 20 20 20 20 2a 2a 20 0a 20 20 20 20 20 . ** .
31850 20 2a 2a 20 42 65 63 61 75 73 65 20 74 68 65 20 ** Because the
31860 69 6e 74 65 72 6d 65 64 69 61 74 65 20 52 45 53 intermediate RES
31870 45 52 56 45 44 20 6c 6f 63 6b 20 69 73 20 6e 6f ERVED lock is no
31880 74 20 72 65 71 75 65 73 74 65 64 2c 20 61 6e 79 t requested, any
31890 0a 20 20 20 20 20 20 2a 2a 20 6f 74 68 65 72 20 . ** other
318a0 70 72 6f 63 65 73 73 20 61 74 74 65 6d 70 74 69 process attempti
318b0 6e 67 20 74 6f 20 61 63 63 65 73 73 20 74 68 65 ng to access the
318c0 20 64 61 74 61 62 61 73 65 20 66 69 6c 65 20 77 database file w
318d0 69 6c 6c 20 67 65 74 20 74 6f 20 0a 20 20 20 20 ill get to .
318e0 20 20 2a 2a 20 74 68 69 73 20 70 6f 69 6e 74 20 ** this point
318f0 69 6e 20 74 68 65 20 63 6f 64 65 20 61 6e 64 20 in the code and
31900 66 61 69 6c 20 74 6f 20 6f 62 74 61 69 6e 20 69 fail to obtain i
31910 74 73 20 6f 77 6e 20 45 58 43 4c 55 53 49 56 45 ts own EXCLUSIVE
31920 20 6c 6f 63 6b 20 0a 20 20 20 20 20 20 2a 2a 20 lock . **
31930 6f 6e 20 74 68 65 20 64 61 74 61 62 61 73 65 20 on the database
31940 66 69 6c 65 2e 0a 20 20 20 20 20 20 2a 2a 0a 20 file.. **.
31950 20 20 20 20 20 2a 2a 20 55 6e 6c 65 73 73 20 74 ** Unless t
31960 68 65 20 70 61 67 65 72 20 69 73 20 69 6e 20 6c he pager is in l
31970 6f 63 6b 69 6e 67 5f 6d 6f 64 65 3d 65 78 63 6c ocking_mode=excl
31980 75 73 69 76 65 20 6d 6f 64 65 2c 20 74 68 65 20 usive mode, the
31990 6c 6f 63 6b 20 69 73 0a 20 20 20 20 20 20 2a 2a lock is. **
319a0 20 64 6f 77 6e 67 72 61 64 65 64 20 74 6f 20 53 downgraded to S
319b0 48 41 52 45 44 5f 4c 4f 43 4b 20 62 65 66 6f 72 HARED_LOCK befor
319c0 65 20 74 68 69 73 20 66 75 6e 63 74 69 6f 6e 20 e this function
319d0 72 65 74 75 72 6e 73 2e 0a 20 20 20 20 20 20 2a returns.. *
319e0 2f 0a 20 20 20 20 20 20 72 63 20 3d 20 70 61 67 /. rc = pag
319f0 65 72 4c 6f 63 6b 44 62 28 70 50 61 67 65 72 2c erLockDb(pPager,
31a00 20 45 58 43 4c 55 53 49 56 45 5f 4c 4f 43 4b 29 EXCLUSIVE_LOCK)
31a10 3b 0a 20 20 20 20 20 20 69 66 28 20 72 63 21 3d ;. if( rc!=
31a20 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 SQLITE_OK ){.
31a30 20 20 20 20 20 67 6f 74 6f 20 66 61 69 6c 65 64 goto failed
31a40 3b 0a 20 20 20 20 20 20 7d 0a 20 0a 20 20 20 20 ;. }. .
31a50 20 20 2f 2a 20 49 66 20 69 74 20 69 73 20 6e 6f /* If it is no
31a60 74 20 61 6c 72 65 61 64 79 20 6f 70 65 6e 20 61 t already open a
31a70 6e 64 20 74 68 65 20 66 69 6c 65 20 65 78 69 73 nd the file exis
31a80 74 73 20 6f 6e 20 64 69 73 6b 2c 20 6f 70 65 6e ts on disk, open
31a90 20 74 68 65 20 0a 20 20 20 20 20 20 2a 2a 20 6a the . ** j
31aa0 6f 75 72 6e 61 6c 20 66 6f 72 20 72 65 61 64 2f ournal for read/
31ab0 77 72 69 74 65 20 61 63 63 65 73 73 2e 20 57 72 write access. Wr
31ac0 69 74 65 20 61 63 63 65 73 73 20 69 73 20 72 65 ite access is re
31ad0 71 75 69 72 65 64 20 62 65 63 61 75 73 65 20 0a quired because .
31ae0 20 20 20 20 20 20 2a 2a 20 69 6e 20 65 78 63 6c ** in excl
31af0 75 73 69 76 65 2d 61 63 63 65 73 73 20 6d 6f 64 usive-access mod
31b00 65 20 74 68 65 20 66 69 6c 65 20 64 65 73 63 72 e the file descr
31b10 69 70 74 6f 72 20 77 69 6c 6c 20 62 65 20 6b 65 iptor will be ke
31b20 70 74 20 6f 70 65 6e 20 0a 20 20 20 20 20 20 2a pt open . *
31b30 2a 20 61 6e 64 20 70 6f 73 73 69 62 6c 79 20 75 * and possibly u
31b40 73 65 64 20 66 6f 72 20 61 20 74 72 61 6e 73 61 sed for a transa
31b50 63 74 69 6f 6e 20 6c 61 74 65 72 20 6f 6e 2e 20 ction later on.
31b60 41 6c 73 6f 2c 20 77 72 69 74 65 2d 61 63 63 65 Also, write-acce
31b70 73 73 20 0a 20 20 20 20 20 20 2a 2a 20 69 73 20 ss . ** is
31b80 75 73 75 61 6c 6c 79 20 72 65 71 75 69 72 65 64 usually required
31b90 20 74 6f 20 66 69 6e 61 6c 69 7a 65 20 74 68 65 to finalize the
31ba0 20 6a 6f 75 72 6e 61 6c 20 69 6e 20 6a 6f 75 72 journal in jour
31bb0 6e 61 6c 5f 6d 6f 64 65 3d 70 65 72 73 69 73 74 nal_mode=persist
31bc0 20 0a 20 20 20 20 20 20 2a 2a 20 6d 6f 64 65 20 . ** mode
31bd0 28 61 6e 64 20 61 6c 73 6f 20 66 6f 72 20 6a 6f (and also for jo
31be0 75 72 6e 61 6c 5f 6d 6f 64 65 3d 74 72 75 6e 63 urnal_mode=trunc
31bf0 61 74 65 20 6f 6e 20 73 6f 6d 65 20 73 79 73 74 ate on some syst
31c00 65 6d 73 29 2e 0a 20 20 20 20 20 20 2a 2a 0a 20 ems).. **.
31c10 20 20 20 20 20 2a 2a 20 49 66 20 74 68 65 20 6a ** If the j
31c20 6f 75 72 6e 61 6c 20 64 6f 65 73 20 6e 6f 74 20 ournal does not
31c30 65 78 69 73 74 2c 20 69 74 20 75 73 75 61 6c 6c exist, it usuall
31c40 79 20 6d 65 61 6e 73 20 74 68 61 74 20 73 6f 6d y means that som
31c50 65 20 0a 20 20 20 20 20 20 2a 2a 20 6f 74 68 65 e . ** othe
31c60 72 20 63 6f 6e 6e 65 63 74 69 6f 6e 20 6d 61 6e r connection man
31c70 61 67 65 64 20 74 6f 20 67 65 74 20 69 6e 20 61 aged to get in a
31c80 6e 64 20 72 6f 6c 6c 20 69 74 20 62 61 63 6b 20 nd roll it back
31c90 62 65 66 6f 72 65 20 0a 20 20 20 20 20 20 2a 2a before . **
31ca0 20 74 68 69 73 20 63 6f 6e 6e 65 63 74 69 6f 6e this connection
31cb0 20 6f 62 74 61 69 6e 65 64 20 74 68 65 20 65 78 obtained the ex
31cc0 63 6c 75 73 69 76 65 20 6c 6f 63 6b 20 61 62 6f clusive lock abo
31cd0 76 65 2e 20 4f 72 2c 20 69 74 20 0a 20 20 20 20 ve. Or, it .
31ce0 20 20 2a 2a 20 6d 61 79 20 6d 65 61 6e 20 74 68 ** may mean th
31cf0 61 74 20 74 68 65 20 70 61 67 65 72 20 77 61 73 at the pager was
31d00 20 69 6e 20 74 68 65 20 65 72 72 6f 72 2d 73 74 in the error-st
31d10 61 74 65 20 77 68 65 6e 20 74 68 69 73 0a 20 20 ate when this.
31d20 20 20 20 20 2a 2a 20 66 75 6e 63 74 69 6f 6e 20 ** function
31d30 77 61 73 20 63 61 6c 6c 65 64 20 61 6e 64 20 74 was called and t
31d40 68 65 20 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 20 he journal file
31d50 64 6f 65 73 20 6e 6f 74 20 65 78 69 73 74 2e 0a does not exist..
31d60 20 20 20 20 20 20 2a 2f 0a 20 20 20 20 20 20 69 */. i
31d70 66 28 20 21 69 73 4f 70 65 6e 28 70 50 61 67 65 f( !isOpen(pPage
31d80 72 2d 3e 6a 66 64 29 20 29 7b 0a 20 20 20 20 20 r->jfd) ){.
31d90 20 20 20 73 71 6c 69 74 65 33 5f 76 66 73 20 2a sqlite3_vfs *
31da0 20 63 6f 6e 73 74 20 70 56 66 73 20 3d 20 70 50 const pVfs = pP
31db0 61 67 65 72 2d 3e 70 56 66 73 3b 0a 20 20 20 20 ager->pVfs;.
31dc0 20 20 20 20 69 6e 74 20 62 45 78 69 73 74 73 3b int bExists;
31dd0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a /*
31de0 20 54 72 75 65 20 69 66 20 6a 6f 75 72 6e 61 6c True if journal
31df0 20 66 69 6c 65 20 65 78 69 73 74 73 20 2a 2f 0a file exists */.
31e00 20 20 20 20 20 20 20 20 72 63 20 3d 20 73 71 6c rc = sql
31e10 69 74 65 33 4f 73 41 63 63 65 73 73 28 0a 20 20 ite3OsAccess(.
31e20 20 20 20 20 20 20 20 20 20 20 70 56 66 73 2c 20 pVfs,
31e30 70 50 61 67 65 72 2d 3e 7a 4a 6f 75 72 6e 61 6c pPager->zJournal
31e40 2c 20 53 51 4c 49 54 45 5f 41 43 43 45 53 53 5f , SQLITE_ACCESS_
31e50 45 58 49 53 54 53 2c 20 26 62 45 78 69 73 74 73 EXISTS, &bExists
31e60 29 3b 0a 20 20 20 20 20 20 20 20 69 66 28 20 72 );. if( r
31e70 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 26 26 20 c==SQLITE_OK &&
31e80 62 45 78 69 73 74 73 20 29 7b 0a 20 20 20 20 20 bExists ){.
31e90 20 20 20 20 20 69 6e 74 20 66 6f 75 74 20 3d 20 int fout =
31ea0 30 3b 0a 20 20 20 20 20 20 20 20 20 20 69 6e 74 0;. int
31eb0 20 66 20 3d 20 53 51 4c 49 54 45 5f 4f 50 45 4e f = SQLITE_OPEN
31ec0 5f 52 45 41 44 57 52 49 54 45 7c 53 51 4c 49 54 _READWRITE|SQLIT
31ed0 45 5f 4f 50 45 4e 5f 4d 41 49 4e 5f 4a 4f 55 52 E_OPEN_MAIN_JOUR
31ee0 4e 41 4c 3b 0a 20 20 20 20 20 20 20 20 20 20 61 NAL;. a
31ef0 73 73 65 72 74 28 20 21 70 50 61 67 65 72 2d 3e ssert( !pPager->
31f00 74 65 6d 70 46 69 6c 65 20 29 3b 0a 20 20 20 20 tempFile );.
31f10 20 20 20 20 20 20 72 63 20 3d 20 73 71 6c 69 74 rc = sqlit
31f20 65 33 4f 73 4f 70 65 6e 28 70 56 66 73 2c 20 70 e3OsOpen(pVfs, p
31f30 50 61 67 65 72 2d 3e 7a 4a 6f 75 72 6e 61 6c 2c Pager->zJournal,
31f40 20 70 50 61 67 65 72 2d 3e 6a 66 64 2c 20 66 2c pPager->jfd, f,
31f50 20 26 66 6f 75 74 29 3b 0a 20 20 20 20 20 20 20 &fout);.
31f60 20 20 20 61 73 73 65 72 74 28 20 72 63 21 3d 53 assert( rc!=S
31f70 51 4c 49 54 45 5f 4f 4b 20 7c 7c 20 69 73 4f 70 QLITE_OK || isOp
31f80 65 6e 28 70 50 61 67 65 72 2d 3e 6a 66 64 29 20 en(pPager->jfd)
31f90 29 3b 0a 20 20 20 20 20 20 20 20 20 20 69 66 28 );. if(
31fa0 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 26 rc==SQLITE_OK &
31fb0 26 20 66 6f 75 74 26 53 51 4c 49 54 45 5f 4f 50 & fout&SQLITE_OP
31fc0 45 4e 5f 52 45 41 44 4f 4e 4c 59 20 29 7b 0a 20 EN_READONLY ){.
31fd0 20 20 20 20 20 20 20 20 20 20 20 72 63 20 3d 20 rc =
31fe0 53 51 4c 49 54 45 5f 43 41 4e 54 4f 50 45 4e 5f SQLITE_CANTOPEN_
31ff0 42 4b 50 54 3b 0a 20 20 20 20 20 20 20 20 20 20 BKPT;.
32000 20 20 73 71 6c 69 74 65 33 4f 73 43 6c 6f 73 65 sqlite3OsClose
32010 28 70 50 61 67 65 72 2d 3e 6a 66 64 29 3b 0a 20 (pPager->jfd);.
32020 20 20 20 20 20 20 20 20 20 7d 0a 20 20 20 20 20 }.
32030 20 20 20 7d 0a 20 20 20 20 20 20 7d 0a 20 0a 20 }. }. .
32040 20 20 20 20 20 2f 2a 20 50 6c 61 79 62 61 63 6b /* Playback
32050 20 61 6e 64 20 64 65 6c 65 74 65 20 74 68 65 20 and delete the
32060 6a 6f 75 72 6e 61 6c 2e 20 20 44 72 6f 70 20 74 journal. Drop t
32070 68 65 20 64 61 74 61 62 61 73 65 20 77 72 69 74 he database writ
32080 65 0a 20 20 20 20 20 20 2a 2a 20 6c 6f 63 6b 20 e. ** lock
32090 61 6e 64 20 72 65 61 63 71 75 69 72 65 20 74 68 and reacquire th
320a0 65 20 72 65 61 64 20 6c 6f 63 6b 2e 20 50 75 72 e read lock. Pur
320b0 67 65 20 74 68 65 20 63 61 63 68 65 20 62 65 66 ge the cache bef
320c0 6f 72 65 0a 20 20 20 20 20 20 2a 2a 20 70 6c 61 ore. ** pla
320d0 79 69 6e 67 20 62 61 63 6b 20 74 68 65 20 68 6f ying back the ho
320e0 74 2d 6a 6f 75 72 6e 61 6c 20 73 6f 20 74 68 61 t-journal so tha
320f0 74 20 77 65 20 64 6f 6e 27 74 20 65 6e 64 20 75 t we don't end u
32100 70 20 77 69 74 68 0a 20 20 20 20 20 20 2a 2a 20 p with. **
32110 61 6e 20 69 6e 63 6f 6e 73 69 73 74 65 6e 74 20 an inconsistent
32120 63 61 63 68 65 2e 20 20 53 79 6e 63 20 74 68 65 cache. Sync the
32130 20 68 6f 74 20 6a 6f 75 72 6e 61 6c 20 62 65 66 hot journal bef
32140 6f 72 65 20 70 6c 61 79 69 6e 67 0a 20 20 20 20 ore playing.
32150 20 20 2a 2a 20 69 74 20 62 61 63 6b 20 73 69 6e ** it back sin
32160 63 65 20 74 68 65 20 70 72 6f 63 65 73 73 20 74 ce the process t
32170 68 61 74 20 63 72 61 73 68 65 64 20 61 6e 64 20 hat crashed and
32180 6c 65 66 74 20 74 68 65 20 68 6f 74 20 6a 6f 75 left the hot jou
32190 72 6e 61 6c 0a 20 20 20 20 20 20 2a 2a 20 70 72 rnal. ** pr
321a0 6f 62 61 62 6c 79 20 64 69 64 20 6e 6f 74 20 73 obably did not s
321b0 79 6e 63 20 69 74 20 61 6e 64 20 77 65 20 61 72 ync it and we ar
321c0 65 20 72 65 71 75 69 72 65 64 20 74 6f 20 61 6c e required to al
321d0 77 61 79 73 20 73 79 6e 63 0a 20 20 20 20 20 20 ways sync.
321e0 2a 2a 20 74 68 65 20 6a 6f 75 72 6e 61 6c 20 62 ** the journal b
321f0 65 66 6f 72 65 20 70 6c 61 79 69 6e 67 20 69 74 efore playing it
32200 20 62 61 63 6b 2e 0a 20 20 20 20 20 20 2a 2f 0a back.. */.
32210 20 20 20 20 20 20 69 66 28 20 69 73 4f 70 65 6e if( isOpen
32220 28 70 50 61 67 65 72 2d 3e 6a 66 64 29 20 29 7b (pPager->jfd) ){
32230 0a 20 20 20 20 20 20 20 20 61 73 73 65 72 74 28 . assert(
32240 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 rc==SQLITE_OK )
32250 3b 0a 20 20 20 20 20 20 20 20 72 63 20 3d 20 70 ;. rc = p
32260 61 67 65 72 53 79 6e 63 48 6f 74 4a 6f 75 72 6e agerSyncHotJourn
32270 61 6c 28 70 50 61 67 65 72 29 3b 0a 20 20 20 20 al(pPager);.
32280 20 20 20 20 69 66 28 20 72 63 3d 3d 53 51 4c 49 if( rc==SQLI
32290 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 20 20 20 TE_OK ){.
322a0 20 20 20 72 63 20 3d 20 70 61 67 65 72 5f 70 6c rc = pager_pl
322b0 61 79 62 61 63 6b 28 70 50 61 67 65 72 2c 20 21 ayback(pPager, !
322c0 70 50 61 67 65 72 2d 3e 74 65 6d 70 46 69 6c 65 pPager->tempFile
322d0 29 3b 0a 20 20 20 20 20 20 20 20 20 20 70 50 61 );. pPa
322e0 67 65 72 2d 3e 65 53 74 61 74 65 20 3d 20 50 41 ger->eState = PA
322f0 47 45 52 5f 4f 50 45 4e 3b 0a 20 20 20 20 20 20 GER_OPEN;.
32300 20 20 7d 0a 20 20 20 20 20 20 7d 65 6c 73 65 20 }. }else
32310 69 66 28 20 21 70 50 61 67 65 72 2d 3e 65 78 63 if( !pPager->exc
32320 6c 75 73 69 76 65 4d 6f 64 65 20 29 7b 0a 20 20 lusiveMode ){.
32330 20 20 20 20 20 20 70 61 67 65 72 55 6e 6c 6f 63 pagerUnloc
32340 6b 44 62 28 70 50 61 67 65 72 2c 20 53 48 41 52 kDb(pPager, SHAR
32350 45 44 5f 4c 4f 43 4b 29 3b 0a 20 20 20 20 20 20 ED_LOCK);.
32360 7d 0a 0a 20 20 20 20 20 20 69 66 28 20 72 63 21 }.. if( rc!
32370 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 =SQLITE_OK ){.
32380 20 20 20 20 20 20 2f 2a 20 54 68 69 73 20 62 72 /* This br
32390 61 6e 63 68 20 69 73 20 74 61 6b 65 6e 20 69 66 anch is taken if
323a0 20 61 6e 20 65 72 72 6f 72 20 6f 63 63 75 72 73 an error occurs
323b0 20 77 68 69 6c 65 20 74 72 79 69 6e 67 20 74 6f while trying to
323c0 20 6f 70 65 6e 0a 20 20 20 20 20 20 20 20 2a 2a open. **
323d0 20 6f 72 20 72 6f 6c 6c 20 62 61 63 6b 20 61 20 or roll back a
323e0 68 6f 74 2d 6a 6f 75 72 6e 61 6c 20 77 68 69 6c hot-journal whil
323f0 65 20 68 6f 6c 64 69 6e 67 20 61 6e 20 45 58 43 e holding an EXC
32400 4c 55 53 49 56 45 20 6c 6f 63 6b 2e 20 54 68 65 LUSIVE lock. The
32410 0a 20 20 20 20 20 20 20 20 2a 2a 20 70 61 67 65 . ** page
32420 72 5f 75 6e 6c 6f 63 6b 28 29 20 72 6f 75 74 69 r_unlock() routi
32430 6e 65 20 77 69 6c 6c 20 62 65 20 63 61 6c 6c 65 ne will be calle
32440 64 20 62 65 66 6f 72 65 20 72 65 74 75 72 6e 69 d before returni
32450 6e 67 20 74 6f 20 75 6e 6c 6f 63 6b 0a 20 20 20 ng to unlock.
32460 20 20 20 20 20 2a 2a 20 74 68 65 20 66 69 6c 65 ** the file
32470 2e 20 49 66 20 74 68 65 20 75 6e 6c 6f 63 6b 20 . If the unlock
32480 61 74 74 65 6d 70 74 20 66 61 69 6c 73 2c 20 74 attempt fails, t
32490 68 65 6e 20 50 61 67 65 72 2e 65 4c 6f 63 6b 20 hen Pager.eLock
324a0 6d 75 73 74 20 62 65 0a 20 20 20 20 20 20 20 20 must be.
324b0 2a 2a 20 73 65 74 20 74 6f 20 55 4e 4b 4e 4f 57 ** set to UNKNOW
324c0 4e 5f 4c 4f 43 4b 20 28 73 65 65 20 74 68 65 20 N_LOCK (see the
324d0 63 6f 6d 6d 65 6e 74 20 61 62 6f 76 65 20 74 68 comment above th
324e0 65 20 23 64 65 66 69 6e 65 20 66 6f 72 20 0a 20 e #define for .
324f0 20 20 20 20 20 20 20 2a 2a 20 55 4e 4b 4e 4f 57 ** UNKNOW
32500 4e 5f 4c 4f 43 4b 20 61 62 6f 76 65 20 66 6f 72 N_LOCK above for
32510 20 61 6e 20 65 78 70 6c 61 6e 61 74 69 6f 6e 29 an explanation)
32520 2e 20 0a 20 20 20 20 20 20 20 20 2a 2a 0a 20 20 . . **.
32530 20 20 20 20 20 20 2a 2a 20 49 6e 20 6f 72 64 65 ** In orde
32540 72 20 74 6f 20 67 65 74 20 70 61 67 65 72 5f 75 r to get pager_u
32550 6e 6c 6f 63 6b 28 29 20 74 6f 20 64 6f 20 74 68 nlock() to do th
32560 69 73 2c 20 73 65 74 20 50 61 67 65 72 2e 65 53 is, set Pager.eS
32570 74 61 74 65 20 74 6f 0a 20 20 20 20 20 20 20 20 tate to.
32580 2a 2a 20 50 41 47 45 52 5f 45 52 52 4f 52 20 6e ** PAGER_ERROR n
32590 6f 77 2e 20 54 68 69 73 20 69 73 20 6e 6f 74 20 ow. This is not
325a0 61 63 74 75 61 6c 6c 79 20 63 6f 75 6e 74 65 64 actually counted
325b0 20 61 73 20 61 20 74 72 61 6e 73 69 74 69 6f 6e as a transition
325c0 0a 20 20 20 20 20 20 20 20 2a 2a 20 74 6f 20 45 . ** to E
325d0 52 52 4f 52 20 73 74 61 74 65 20 69 6e 20 74 68 RROR state in th
325e0 65 20 73 74 61 74 65 20 64 69 61 67 72 61 6d 20 e state diagram
325f0 61 74 20 74 68 65 20 74 6f 70 20 6f 66 20 74 68 at the top of th
32600 69 73 20 66 69 6c 65 2c 0a 20 20 20 20 20 20 20 is file,.
32610 20 2a 2a 20 73 69 6e 63 65 20 77 65 20 6b 6e 6f ** since we kno
32620 77 20 74 68 61 74 20 74 68 65 20 73 61 6d 65 20 w that the same
32630 63 61 6c 6c 20 74 6f 20 70 61 67 65 72 5f 75 6e call to pager_un
32640 6c 6f 63 6b 28 29 20 77 69 6c 6c 20 76 65 72 79 lock() will very
32650 0a 20 20 20 20 20 20 20 20 2a 2a 20 73 68 6f 72 . ** shor
32660 74 6c 79 20 74 72 61 6e 73 69 74 69 6f 6e 20 74 tly transition t
32670 68 65 20 70 61 67 65 72 20 6f 62 6a 65 63 74 20 he pager object
32680 74 6f 20 74 68 65 20 4f 50 45 4e 20 73 74 61 74 to the OPEN stat
32690 65 2e 20 43 61 6c 6c 69 6e 67 0a 20 20 20 20 20 e. Calling.
326a0 20 20 20 2a 2a 20 61 73 73 65 72 74 5f 70 61 67 ** assert_pag
326b0 65 72 5f 73 74 61 74 65 28 29 20 77 6f 75 6c 64 er_state() would
326c0 20 66 61 69 6c 20 6e 6f 77 2c 20 61 73 20 69 74 fail now, as it
326d0 20 73 68 6f 75 6c 64 20 6e 6f 74 20 62 65 20 70 should not be p
326e0 6f 73 73 69 62 6c 65 0a 20 20 20 20 20 20 20 20 ossible.
326f0 2a 2a 20 74 6f 20 62 65 20 69 6e 20 45 52 52 4f ** to be in ERRO
32700 52 20 73 74 61 74 65 20 77 68 65 6e 20 74 68 65 R state when the
32710 72 65 20 61 72 65 20 7a 65 72 6f 20 6f 75 74 73 re are zero outs
32720 74 61 6e 64 69 6e 67 20 70 61 67 65 20 0a 20 20 tanding page .
32730 20 20 20 20 20 20 2a 2a 20 72 65 66 65 72 65 6e ** referen
32740 63 65 73 2e 0a 20 20 20 20 20 20 20 20 2a 2f 0a ces.. */.
32750 20 20 20 20 20 20 20 20 70 61 67 65 72 5f 65 72 pager_er
32760 72 6f 72 28 70 50 61 67 65 72 2c 20 72 63 29 3b ror(pPager, rc);
32770 0a 20 20 20 20 20 20 20 20 67 6f 74 6f 20 66 61 . goto fa
32780 69 6c 65 64 3b 0a 20 20 20 20 20 20 7d 0a 0a 20 iled;. }..
32790 20 20 20 20 20 61 73 73 65 72 74 28 20 70 50 61 assert( pPa
327a0 67 65 72 2d 3e 65 53 74 61 74 65 3d 3d 50 41 47 ger->eState==PAG
327b0 45 52 5f 4f 50 45 4e 20 29 3b 0a 20 20 20 20 20 ER_OPEN );.
327c0 20 61 73 73 65 72 74 28 20 28 70 50 61 67 65 72 assert( (pPager
327d0 2d 3e 65 4c 6f 63 6b 3d 3d 53 48 41 52 45 44 5f ->eLock==SHARED_
327e0 4c 4f 43 4b 29 0a 20 20 20 20 20 20 20 20 20 20 LOCK).
327f0 20 7c 7c 20 28 70 50 61 67 65 72 2d 3e 65 78 63 || (pPager->exc
32800 6c 75 73 69 76 65 4d 6f 64 65 20 26 26 20 70 50 lusiveMode && pP
32810 61 67 65 72 2d 3e 65 4c 6f 63 6b 3e 53 48 41 52 ager->eLock>SHAR
32820 45 44 5f 4c 4f 43 4b 29 0a 20 20 20 20 20 20 29 ED_LOCK). )
32830 3b 0a 20 20 20 20 7d 0a 0a 20 20 20 20 69 66 28 ;. }.. if(
32840 20 21 70 50 61 67 65 72 2d 3e 74 65 6d 70 46 69 !pPager->tempFi
32850 6c 65 20 26 26 20 70 50 61 67 65 72 2d 3e 68 61 le && pPager->ha
32860 73 48 65 6c 64 53 68 61 72 65 64 4c 6f 63 6b 20 sHeldSharedLock
32870 29 7b 0a 20 20 20 20 20 20 2f 2a 20 54 68 65 20 ){. /* The
32880 73 68 61 72 65 64 2d 6c 6f 63 6b 20 68 61 73 20 shared-lock has
32890 6a 75 73 74 20 62 65 65 6e 20 61 63 71 75 69 72 just been acquir
328a0 65 64 20 74 68 65 6e 20 63 68 65 63 6b 20 74 6f ed then check to
328b0 0a 20 20 20 20 20 20 2a 2a 20 73 65 65 20 69 66 . ** see if
328c0 20 74 68 65 20 64 61 74 61 62 61 73 65 20 68 61 the database ha
328d0 73 20 62 65 65 6e 20 6d 6f 64 69 66 69 65 64 2e s been modified.
328e0 20 20 49 66 20 74 68 65 20 64 61 74 61 62 61 73 If the databas
328f0 65 20 68 61 73 20 63 68 61 6e 67 65 64 2c 0a 20 e has changed,.
32900 20 20 20 20 20 2a 2a 20 66 6c 75 73 68 20 74 68 ** flush th
32910 65 20 63 61 63 68 65 2e 20 20 54 68 65 20 68 61 e cache. The ha
32920 73 48 65 6c 64 53 68 61 72 65 64 4c 6f 63 6b 20 sHeldSharedLock
32930 66 6c 61 67 20 70 72 65 76 65 6e 74 73 20 74 68 flag prevents th
32940 69 73 20 66 72 6f 6d 0a 20 20 20 20 20 20 2a 2a is from. **
32950 20 6f 63 63 75 72 72 69 6e 67 20 6f 6e 20 74 68 occurring on th
32960 65 20 76 65 72 79 20 66 69 72 73 74 20 61 63 63 e very first acc
32970 65 73 73 20 74 6f 20 61 20 66 69 6c 65 2c 20 69 ess to a file, i
32980 6e 20 6f 72 64 65 72 20 74 6f 20 73 61 76 65 20 n order to save
32990 61 0a 20 20 20 20 20 20 2a 2a 20 73 69 6e 67 6c a. ** singl
329a0 65 20 75 6e 6e 65 63 65 73 73 61 72 79 20 73 71 e unnecessary sq
329b0 6c 69 74 65 33 4f 73 52 65 61 64 28 29 20 63 61 lite3OsRead() ca
329c0 6c 6c 20 61 74 20 74 68 65 20 73 74 61 72 74 2d ll at the start-
329d0 75 70 2e 0a 20 20 20 20 20 20 2a 2a 0a 20 20 20 up.. **.
329e0 20 20 20 2a 2a 20 44 61 74 61 62 61 73 65 20 63 ** Database c
329f0 68 61 6e 67 65 73 20 61 72 65 20 64 65 74 65 63 hanges are detec
32a00 74 65 64 20 62 79 20 6c 6f 6f 6b 69 6e 67 20 61 ted by looking a
32a10 74 20 31 35 20 62 79 74 65 73 20 62 65 67 69 6e t 15 bytes begin
32a20 6e 69 6e 67 0a 20 20 20 20 20 20 2a 2a 20 61 74 ning. ** at
32a30 20 6f 66 66 73 65 74 20 32 34 20 69 6e 74 6f 20 offset 24 into
32a40 74 68 65 20 66 69 6c 65 2e 20 20 54 68 65 20 66 the file. The f
32a50 69 72 73 74 20 34 20 6f 66 20 74 68 65 73 65 20 irst 4 of these
32a60 31 36 20 62 79 74 65 73 20 61 72 65 0a 20 20 20 16 bytes are.
32a70 20 20 20 2a 2a 20 61 20 33 32 2d 62 69 74 20 63 ** a 32-bit c
32a80 6f 75 6e 74 65 72 20 74 68 61 74 20 69 73 20 69 ounter that is i
32a90 6e 63 72 65 6d 65 6e 74 65 64 20 77 69 74 68 20 ncremented with
32aa0 65 61 63 68 20 63 68 61 6e 67 65 2e 20 20 54 68 each change. Th
32ab0 65 0a 20 20 20 20 20 20 2a 2a 20 6f 74 68 65 72 e. ** other
32ac0 20 62 79 74 65 73 20 63 68 61 6e 67 65 20 72 61 bytes change ra
32ad0 6e 64 6f 6d 6c 79 20 77 69 74 68 20 65 61 63 68 ndomly with each
32ae0 20 66 69 6c 65 20 63 68 61 6e 67 65 20 77 68 65 file change whe
32af0 6e 0a 20 20 20 20 20 20 2a 2a 20 61 20 63 6f 64 n. ** a cod
32b00 65 63 20 69 73 20 69 6e 20 75 73 65 2e 0a 20 20 ec is in use..
32b10 20 20 20 20 2a 2a 20 0a 20 20 20 20 20 20 2a 2a ** . **
32b20 20 54 68 65 72 65 20 69 73 20 61 20 76 61 6e 69 There is a vani
32b30 73 68 69 6e 67 6c 79 20 73 6d 61 6c 6c 20 63 68 shingly small ch
32b40 61 6e 63 65 20 74 68 61 74 20 61 20 63 68 61 6e ance that a chan
32b50 67 65 20 77 69 6c 6c 20 6e 6f 74 20 62 65 20 0a ge will not be .
32b60 20 20 20 20 20 20 2a 2a 20 64 65 74 65 63 74 65 ** detecte
32b70 64 2e 20 20 54 68 65 20 63 68 61 6e 63 65 20 6f d. The chance o
32b80 66 20 61 6e 20 75 6e 64 65 74 65 63 74 65 64 20 f an undetected
32b90 63 68 61 6e 67 65 20 69 73 20 73 6f 20 73 6d 61 change is so sma
32ba0 6c 6c 20 74 68 61 74 0a 20 20 20 20 20 20 2a 2a ll that. **
32bb0 20 69 74 20 63 61 6e 20 62 65 20 6e 65 67 6c 65 it can be negle
32bc0 63 74 65 64 2e 0a 20 20 20 20 20 20 2a 2f 0a 20 cted.. */.
32bd0 20 20 20 20 20 50 67 6e 6f 20 6e 50 61 67 65 20 Pgno nPage
32be0 3d 20 30 3b 0a 20 20 20 20 20 20 63 68 61 72 20 = 0;. char
32bf0 64 62 46 69 6c 65 56 65 72 73 5b 73 69 7a 65 6f dbFileVers[sizeo
32c00 66 28 70 50 61 67 65 72 2d 3e 64 62 46 69 6c 65 f(pPager->dbFile
32c10 56 65 72 73 29 5d 3b 0a 0a 20 20 20 20 20 20 72 Vers)];.. r
32c20 63 20 3d 20 70 61 67 65 72 50 61 67 65 63 6f 75 c = pagerPagecou
32c30 6e 74 28 70 50 61 67 65 72 2c 20 26 6e 50 61 67 nt(pPager, &nPag
32c40 65 29 3b 0a 20 20 20 20 20 20 69 66 28 20 72 63 e);. if( rc
32c50 20 29 20 67 6f 74 6f 20 66 61 69 6c 65 64 3b 0a ) goto failed;.
32c60 0a 20 20 20 20 20 20 69 66 28 20 6e 50 61 67 65 . if( nPage
32c70 3e 30 20 29 7b 0a 20 20 20 20 20 20 20 20 49 4f >0 ){. IO
32c80 54 52 41 43 45 28 28 22 43 4b 56 45 52 53 20 25 TRACE(("CKVERS %
32c90 70 20 25 64 5c 6e 22 2c 20 70 50 61 67 65 72 2c p %d\n", pPager,
32ca0 20 73 69 7a 65 6f 66 28 64 62 46 69 6c 65 56 65 sizeof(dbFileVe
32cb0 72 73 29 29 29 3b 0a 20 20 20 20 20 20 20 20 72 rs)));. r
32cc0 63 20 3d 20 73 71 6c 69 74 65 33 4f 73 52 65 61 c = sqlite3OsRea
32cd0 64 28 70 50 61 67 65 72 2d 3e 66 64 2c 20 26 64 d(pPager->fd, &d
32ce0 62 46 69 6c 65 56 65 72 73 2c 20 73 69 7a 65 6f bFileVers, sizeo
32cf0 66 28 64 62 46 69 6c 65 56 65 72 73 29 2c 20 32 f(dbFileVers), 2
32d00 34 29 3b 0a 20 20 20 20 20 20 20 20 69 66 28 20 4);. if(
32d10 72 63 21 3d 53 51 4c 49 54 45 5f 4f 4b 20 26 26 rc!=SQLITE_OK &&
32d20 20 72 63 21 3d 53 51 4c 49 54 45 5f 49 4f 45 52 rc!=SQLITE_IOER
32d30 52 5f 53 48 4f 52 54 5f 52 45 41 44 20 29 7b 0a R_SHORT_READ ){.
32d40 20 20 20 20 20 20 20 20 20 20 67 6f 74 6f 20 66 goto f
32d50 61 69 6c 65 64 3b 0a 20 20 20 20 20 20 20 20 7d ailed;. }
32d60 0a 20 20 20 20 20 20 7d 65 6c 73 65 7b 0a 20 20 . }else{.
32d70 20 20 20 20 20 20 6d 65 6d 73 65 74 28 64 62 46 memset(dbF
32d80 69 6c 65 56 65 72 73 2c 20 30 2c 20 73 69 7a 65 ileVers, 0, size
32d90 6f 66 28 64 62 46 69 6c 65 56 65 72 73 29 29 3b of(dbFileVers));
32da0 0a 20 20 20 20 20 20 7d 0a 0a 20 20 20 20 20 20 . }..
32db0 69 66 28 20 6d 65 6d 63 6d 70 28 70 50 61 67 65 if( memcmp(pPage
32dc0 72 2d 3e 64 62 46 69 6c 65 56 65 72 73 2c 20 64 r->dbFileVers, d
32dd0 62 46 69 6c 65 56 65 72 73 2c 20 73 69 7a 65 6f bFileVers, sizeo
32de0 66 28 64 62 46 69 6c 65 56 65 72 73 29 29 21 3d f(dbFileVers))!=
32df0 30 20 29 7b 0a 20 20 20 20 20 20 20 20 70 61 67 0 ){. pag
32e00 65 72 5f 72 65 73 65 74 28 70 50 61 67 65 72 29 er_reset(pPager)
32e10 3b 0a 0a 20 20 20 20 20 20 20 20 2f 2a 20 55 6e ;.. /* Un
32e20 6d 61 70 20 74 68 65 20 64 61 74 61 62 61 73 65 map the database
32e30 20 66 69 6c 65 2e 20 49 74 20 69 73 20 70 6f 73 file. It is pos
32e40 73 69 62 6c 65 20 74 68 61 74 20 65 78 74 65 72 sible that exter
32e50 6e 61 6c 20 70 72 6f 63 65 73 73 65 73 0a 20 20 nal processes.
32e60 20 20 20 20 20 20 2a 2a 20 6d 61 79 20 68 61 76 ** may hav
32e70 65 20 74 72 75 6e 63 61 74 65 64 20 74 68 65 20 e truncated the
32e80 64 61 74 61 62 61 73 65 20 66 69 6c 65 20 61 6e database file an
32e90 64 20 74 68 65 6e 20 65 78 74 65 6e 64 65 64 20 d then extended
32ea0 69 74 20 62 61 63 6b 0a 20 20 20 20 20 20 20 20 it back.
32eb0 2a 2a 20 74 6f 20 69 74 73 20 6f 72 69 67 69 6e ** to its origin
32ec0 61 6c 20 73 69 7a 65 20 77 68 69 6c 65 20 74 68 al size while th
32ed0 69 73 20 70 72 6f 63 65 73 73 20 77 61 73 20 6e is process was n
32ee0 6f 74 20 68 6f 6c 64 69 6e 67 20 61 20 6c 6f 63 ot holding a loc
32ef0 6b 2e 0a 20 20 20 20 20 20 20 20 2a 2a 20 49 6e k.. ** In
32f00 20 74 68 69 73 20 63 61 73 65 20 74 68 65 72 65 this case there
32f10 20 6d 61 79 20 65 78 69 73 74 20 61 20 50 61 67 may exist a Pag
32f20 65 72 2e 70 4d 61 70 20 6d 61 70 70 69 6e 67 20 er.pMap mapping
32f30 74 68 61 74 20 61 70 70 65 61 72 73 0a 20 20 20 that appears.
32f40 20 20 20 20 20 2a 2a 20 74 6f 20 62 65 20 74 68 ** to be th
32f50 65 20 72 69 67 68 74 20 73 69 7a 65 20 62 75 74 e right size but
32f60 20 69 73 20 6e 6f 74 20 61 63 74 75 61 6c 6c 79 is not actually
32f70 20 76 61 6c 69 64 2e 20 41 76 6f 69 64 20 74 68 valid. Avoid th
32f80 69 73 0a 20 20 20 20 20 20 20 20 2a 2a 20 70 6f is. ** po
32f90 73 73 69 62 69 6c 69 74 79 20 62 79 20 75 6e 6d ssibility by unm
32fa0 61 70 70 69 6e 67 20 74 68 65 20 64 62 20 68 65 apping the db he
32fb0 72 65 2e 20 2a 2f 0a 20 20 20 20 20 20 20 20 69 re. */. i
32fc0 66 28 20 55 53 45 46 45 54 43 48 28 70 50 61 67 f( USEFETCH(pPag
32fd0 65 72 29 20 29 7b 0a 20 20 20 20 20 20 20 20 20 er) ){.
32fe0 20 73 71 6c 69 74 65 33 4f 73 55 6e 66 65 74 63 sqlite3OsUnfetc
32ff0 68 28 70 50 61 67 65 72 2d 3e 66 64 2c 20 30 2c h(pPager->fd, 0,
33000 20 30 29 3b 0a 20 20 20 20 20 20 20 20 7d 0a 20 0);. }.
33010 20 20 20 20 20 7d 0a 20 20 20 20 7d 0a 0a 20 20 }. }..
33020 20 20 2f 2a 20 49 66 20 74 68 65 72 65 20 69 73 /* If there is
33030 20 61 20 57 41 4c 20 66 69 6c 65 20 69 6e 20 74 a WAL file in t
33040 68 65 20 66 69 6c 65 2d 73 79 73 74 65 6d 2c 20 he file-system,
33050 6f 70 65 6e 20 74 68 69 73 20 64 61 74 61 62 61 open this databa
33060 73 65 20 69 6e 20 57 41 4c 0a 20 20 20 20 2a 2a se in WAL. **
33070 20 6d 6f 64 65 2e 20 4f 74 68 65 72 77 69 73 65 mode. Otherwise
33080 2c 20 74 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 , the following
33090 66 75 6e 63 74 69 6f 6e 20 63 61 6c 6c 20 69 73 function call is
330a0 20 61 20 6e 6f 2d 6f 70 2e 0a 20 20 20 20 2a 2f a no-op.. */
330b0 0a 20 20 20 20 72 63 20 3d 20 70 61 67 65 72 4f . rc = pagerO
330c0 70 65 6e 57 61 6c 49 66 50 72 65 73 65 6e 74 28 penWalIfPresent(
330d0 70 50 61 67 65 72 29 3b 0a 23 69 66 6e 64 65 66 pPager);.#ifndef
330e0 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 57 41 4c SQLITE_OMIT_WAL
330f0 0a 20 20 20 20 61 73 73 65 72 74 28 20 70 50 61 . assert( pPa
33100 67 65 72 2d 3e 70 57 61 6c 3d 3d 30 20 7c 7c 20 ger->pWal==0 ||
33110 72 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 3b rc==SQLITE_OK );
33120 0a 23 65 6e 64 69 66 0a 20 20 7d 0a 0a 20 20 69 .#endif. }.. i
33130 66 28 20 70 61 67 65 72 55 73 65 57 61 6c 28 70 f( pagerUseWal(p
33140 50 61 67 65 72 29 20 29 7b 0a 20 20 20 20 61 73 Pager) ){. as
33150 73 65 72 74 28 20 72 63 3d 3d 53 51 4c 49 54 45 sert( rc==SQLITE
33160 5f 4f 4b 20 29 3b 0a 20 20 20 20 72 63 20 3d 20 _OK );. rc =
33170 70 61 67 65 72 42 65 67 69 6e 52 65 61 64 54 72 pagerBeginReadTr
33180 61 6e 73 61 63 74 69 6f 6e 28 70 50 61 67 65 72 ansaction(pPager
33190 29 3b 0a 20 20 7d 0a 0a 20 20 69 66 28 20 70 50 );. }.. if( pP
331a0 61 67 65 72 2d 3e 74 65 6d 70 46 69 6c 65 3d 3d ager->tempFile==
331b0 30 20 26 26 20 70 50 61 67 65 72 2d 3e 65 53 74 0 && pPager->eSt
331c0 61 74 65 3d 3d 50 41 47 45 52 5f 4f 50 45 4e 20 ate==PAGER_OPEN
331d0 26 26 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b && rc==SQLITE_OK
331e0 20 29 7b 0a 20 20 20 20 72 63 20 3d 20 70 61 67 ){. rc = pag
331f0 65 72 50 61 67 65 63 6f 75 6e 74 28 70 50 61 67 erPagecount(pPag
33200 65 72 2c 20 26 70 50 61 67 65 72 2d 3e 64 62 53 er, &pPager->dbS
33210 69 7a 65 29 3b 0a 20 20 7d 0a 0a 20 66 61 69 6c ize);. }.. fail
33220 65 64 3a 0a 20 20 69 66 28 20 72 63 21 3d 53 51 ed:. if( rc!=SQ
33230 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 61 LITE_OK ){. a
33240 73 73 65 72 74 28 20 21 4d 45 4d 44 42 20 29 3b ssert( !MEMDB );
33250 0a 20 20 20 20 70 61 67 65 72 5f 75 6e 6c 6f 63 . pager_unloc
33260 6b 28 70 50 61 67 65 72 29 3b 0a 20 20 20 20 61 k(pPager);. a
33270 73 73 65 72 74 28 20 70 50 61 67 65 72 2d 3e 65 ssert( pPager->e
33280 53 74 61 74 65 3d 3d 50 41 47 45 52 5f 4f 50 45 State==PAGER_OPE
33290 4e 20 29 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 N );. }else{.
332a0 20 20 70 50 61 67 65 72 2d 3e 65 53 74 61 74 65 pPager->eState
332b0 20 3d 20 50 41 47 45 52 5f 52 45 41 44 45 52 3b = PAGER_READER;
332c0 0a 20 20 20 20 70 50 61 67 65 72 2d 3e 68 61 73 . pPager->has
332d0 48 65 6c 64 53 68 61 72 65 64 4c 6f 63 6b 20 3d HeldSharedLock =
332e0 20 31 3b 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e 1;. }. return
332f0 20 72 63 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 49 66 rc;.}../*.** If
33300 20 74 68 65 20 72 65 66 65 72 65 6e 63 65 20 63 the reference c
33310 6f 75 6e 74 20 68 61 73 20 72 65 61 63 68 65 64 ount has reached
33320 20 7a 65 72 6f 2c 20 72 6f 6c 6c 62 61 63 6b 20 zero, rollback
33330 61 6e 79 20 61 63 74 69 76 65 0a 2a 2a 20 74 72 any active.** tr
33340 61 6e 73 61 63 74 69 6f 6e 20 61 6e 64 20 75 6e ansaction and un
33350 6c 6f 63 6b 20 74 68 65 20 70 61 67 65 72 2e 0a lock the pager..
33360 2a 2a 0a 2a 2a 20 45 78 63 65 70 74 2c 20 69 6e **.** Except, in
33370 20 6c 6f 63 6b 69 6e 67 5f 6d 6f 64 65 3d 45 58 locking_mode=EX
33380 43 4c 55 53 49 56 45 20 77 68 65 6e 20 74 68 65 CLUSIVE when the
33390 72 65 20 69 73 20 6e 6f 74 68 69 6e 67 20 74 6f re is nothing to
333a0 20 69 6e 0a 2a 2a 20 74 68 65 20 72 6f 6c 6c 62 in.** the rollb
333b0 61 63 6b 20 6a 6f 75 72 6e 61 6c 2c 20 74 68 65 ack journal, the
333c0 20 75 6e 6c 6f 63 6b 20 69 73 20 6e 6f 74 20 70 unlock is not p
333d0 65 72 66 6f 72 6d 65 64 20 61 6e 64 20 74 68 65 erformed and the
333e0 72 65 20 69 73 0a 2a 2a 20 6e 6f 74 68 69 6e 67 re is.** nothing
333f0 20 74 6f 20 72 6f 6c 6c 62 61 63 6b 2c 20 73 6f to rollback, so
33400 20 74 68 69 73 20 72 6f 75 74 69 6e 65 20 69 73 this routine is
33410 20 61 20 6e 6f 2d 6f 70 2e 0a 2a 2f 20 0a 73 74 a no-op..*/ .st
33420 61 74 69 63 20 76 6f 69 64 20 70 61 67 65 72 55 atic void pagerU
33430 6e 6c 6f 63 6b 49 66 55 6e 75 73 65 64 28 50 61 nlockIfUnused(Pa
33440 67 65 72 20 2a 70 50 61 67 65 72 29 7b 0a 20 20 ger *pPager){.
33450 69 66 28 20 70 50 61 67 65 72 2d 3e 6e 4d 6d 61 if( pPager->nMma
33460 70 4f 75 74 3d 3d 30 20 26 26 20 28 73 71 6c 69 pOut==0 && (sqli
33470 74 65 33 50 63 61 63 68 65 52 65 66 43 6f 75 6e te3PcacheRefCoun
33480 74 28 70 50 61 67 65 72 2d 3e 70 50 43 61 63 68 t(pPager->pPCach
33490 65 29 3d 3d 30 29 20 29 7b 0a 20 20 20 20 70 61 e)==0) ){. pa
334a0 67 65 72 55 6e 6c 6f 63 6b 41 6e 64 52 6f 6c 6c gerUnlockAndRoll
334b0 62 61 63 6b 28 70 50 61 67 65 72 29 3b 0a 20 20 back(pPager);.
334c0 7d 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 41 63 71 75 69 }.}../*.** Acqui
334d0 72 65 20 61 20 72 65 66 65 72 65 6e 63 65 20 74 re a reference t
334e0 6f 20 70 61 67 65 20 6e 75 6d 62 65 72 20 70 67 o page number pg
334f0 6e 6f 20 69 6e 20 70 61 67 65 72 20 70 50 61 67 no in pager pPag
33500 65 72 20 28 61 20 70 61 67 65 0a 2a 2a 20 72 65 er (a page.** re
33510 66 65 72 65 6e 63 65 20 68 61 73 20 74 79 70 65 ference has type
33520 20 44 62 50 61 67 65 2a 29 2e 20 49 66 20 74 68 DbPage*). If th
33530 65 20 72 65 71 75 65 73 74 65 64 20 72 65 66 65 e requested refe
33540 72 65 6e 63 65 20 69 73 20 0a 2a 2a 20 73 75 63 rence is .** suc
33550 63 65 73 73 66 75 6c 6c 79 20 6f 62 74 61 69 6e cessfully obtain
33560 65 64 2c 20 69 74 20 69 73 20 63 6f 70 69 65 64 ed, it is copied
33570 20 74 6f 20 2a 70 70 50 61 67 65 20 61 6e 64 20 to *ppPage and
33580 53 51 4c 49 54 45 5f 4f 4b 20 72 65 74 75 72 6e SQLITE_OK return
33590 65 64 2e 0a 2a 2a 0a 2a 2a 20 49 66 20 74 68 65 ed..**.** If the
335a0 20 72 65 71 75 65 73 74 65 64 20 70 61 67 65 20 requested page
335b0 69 73 20 61 6c 72 65 61 64 79 20 69 6e 20 74 68 is already in th
335c0 65 20 63 61 63 68 65 2c 20 69 74 20 69 73 20 72 e cache, it is r
335d0 65 74 75 72 6e 65 64 2e 20 0a 2a 2a 20 4f 74 68 eturned. .** Oth
335e0 65 72 77 69 73 65 2c 20 61 20 6e 65 77 20 70 61 erwise, a new pa
335f0 67 65 20 6f 62 6a 65 63 74 20 69 73 20 61 6c 6c ge object is all
33600 6f 63 61 74 65 64 20 61 6e 64 20 70 6f 70 75 6c ocated and popul
33610 61 74 65 64 20 77 69 74 68 20 64 61 74 61 0a 2a ated with data.*
33620 2a 20 72 65 61 64 20 66 72 6f 6d 20 74 68 65 20 * read from the
33630 64 61 74 61 62 61 73 65 20 66 69 6c 65 2e 20 49 database file. I
33640 6e 20 73 6f 6d 65 20 63 61 73 65 73 2c 20 74 68 n some cases, th
33650 65 20 70 63 61 63 68 65 20 6d 6f 64 75 6c 65 20 e pcache module
33660 6d 61 79 0a 2a 2a 20 63 68 6f 6f 73 65 20 6e 6f may.** choose no
33670 74 20 74 6f 20 61 6c 6c 6f 63 61 74 65 20 61 20 t to allocate a
33680 6e 65 77 20 70 61 67 65 20 6f 62 6a 65 63 74 20 new page object
33690 61 6e 64 20 6d 61 79 20 72 65 75 73 65 20 61 6e and may reuse an
336a0 20 65 78 69 73 74 69 6e 67 0a 2a 2a 20 6f 62 6a existing.** obj
336b0 65 63 74 20 77 69 74 68 20 6e 6f 20 6f 75 74 73 ect with no outs
336c0 74 61 6e 64 69 6e 67 20 72 65 66 65 72 65 6e 63 tanding referenc
336d0 65 73 2e 0a 2a 2a 0a 2a 2a 20 54 68 65 20 65 78 es..**.** The ex
336e0 74 72 61 20 64 61 74 61 20 61 70 70 65 6e 64 65 tra data appende
336f0 64 20 74 6f 20 61 20 70 61 67 65 20 69 73 20 61 d to a page is a
33700 6c 77 61 79 73 20 69 6e 69 74 69 61 6c 69 7a 65 lways initialize
33710 64 20 74 6f 20 7a 65 72 6f 73 20 74 68 65 20 0a d to zeros the .
33720 2a 2a 20 66 69 72 73 74 20 74 69 6d 65 20 61 20 ** first time a
33730 70 61 67 65 20 69 73 20 6c 6f 61 64 65 64 20 69 page is loaded i
33740 6e 74 6f 20 6d 65 6d 6f 72 79 2e 20 49 66 20 74 nto memory. If t
33750 68 65 20 70 61 67 65 20 72 65 71 75 65 73 74 65 he page requeste
33760 64 20 69 73 20 0a 2a 2a 20 61 6c 72 65 61 64 79 d is .** already
33770 20 69 6e 20 74 68 65 20 63 61 63 68 65 20 77 68 in the cache wh
33780 65 6e 20 74 68 69 73 20 66 75 6e 63 74 69 6f 6e en this function
33790 20 69 73 20 63 61 6c 6c 65 64 2c 20 74 68 65 6e is called, then
337a0 20 74 68 65 20 65 78 74 72 61 0a 2a 2a 20 64 61 the extra.** da
337b0 74 61 20 69 73 20 6c 65 66 74 20 61 73 20 69 74 ta is left as it
337c0 20 77 61 73 20 77 68 65 6e 20 74 68 65 20 70 61 was when the pa
337d0 67 65 20 6f 62 6a 65 63 74 20 77 61 73 20 6c 61 ge object was la
337e0 73 74 20 75 73 65 64 2e 0a 2a 2a 0a 2a 2a 20 49 st used..**.** I
337f0 66 20 74 68 65 20 64 61 74 61 62 61 73 65 20 69 f the database i
33800 6d 61 67 65 20 69 73 20 73 6d 61 6c 6c 65 72 20 mage is smaller
33810 74 68 61 6e 20 74 68 65 20 72 65 71 75 65 73 74 than the request
33820 65 64 20 70 61 67 65 20 6f 72 20 69 66 20 61 20 ed page or if a
33830 0a 2a 2a 20 6e 6f 6e 2d 7a 65 72 6f 20 76 61 6c .** non-zero val
33840 75 65 20 69 73 20 70 61 73 73 65 64 20 61 73 20 ue is passed as
33850 74 68 65 20 6e 6f 43 6f 6e 74 65 6e 74 20 70 61 the noContent pa
33860 72 61 6d 65 74 65 72 20 61 6e 64 20 74 68 65 20 rameter and the
33870 0a 2a 2a 20 72 65 71 75 65 73 74 65 64 20 70 61 .** requested pa
33880 67 65 20 69 73 20 6e 6f 74 20 61 6c 72 65 61 64 ge is not alread
33890 79 20 73 74 6f 72 65 64 20 69 6e 20 74 68 65 20 y stored in the
338a0 63 61 63 68 65 2c 20 74 68 65 6e 20 6e 6f 20 0a cache, then no .
338b0 2a 2a 20 61 63 74 75 61 6c 20 64 69 73 6b 20 72 ** actual disk r
338c0 65 61 64 20 6f 63 63 75 72 73 2e 20 49 6e 20 74 ead occurs. In t
338d0 68 69 73 20 63 61 73 65 20 74 68 65 20 6d 65 6d his case the mem
338e0 6f 72 79 20 69 6d 61 67 65 20 6f 66 20 74 68 65 ory image of the
338f0 20 0a 2a 2a 20 70 61 67 65 20 69 73 20 69 6e 69 .** page is ini
33900 74 69 61 6c 69 7a 65 64 20 74 6f 20 61 6c 6c 20 tialized to all
33910 7a 65 72 6f 73 2e 20 0a 2a 2a 0a 2a 2a 20 49 66 zeros. .**.** If
33920 20 6e 6f 43 6f 6e 74 65 6e 74 20 69 73 20 74 72 noContent is tr
33930 75 65 2c 20 69 74 20 6d 65 61 6e 73 20 74 68 61 ue, it means tha
33940 74 20 77 65 20 64 6f 20 6e 6f 74 20 63 61 72 65 t we do not care
33950 20 61 62 6f 75 74 20 74 68 65 20 63 6f 6e 74 65 about the conte
33960 6e 74 73 0a 2a 2a 20 6f 66 20 74 68 65 20 70 61 nts.** of the pa
33970 67 65 2e 20 54 68 69 73 20 6f 63 63 75 72 73 20 ge. This occurs
33980 69 6e 20 74 77 6f 20 73 63 65 6e 61 72 69 6f 73 in two scenarios
33990 3a 0a 2a 2a 0a 2a 2a 20 20 20 61 29 20 57 68 65 :.**.** a) Whe
339a0 6e 20 72 65 61 64 69 6e 67 20 61 20 66 72 65 65 n reading a free
339b0 2d 6c 69 73 74 20 6c 65 61 66 20 70 61 67 65 20 -list leaf page
339c0 66 72 6f 6d 20 74 68 65 20 64 61 74 61 62 61 73 from the databas
339d0 65 2c 20 61 6e 64 0a 2a 2a 0a 2a 2a 20 20 20 62 e, and.**.** b
339e0 29 20 57 68 65 6e 20 61 20 73 61 76 65 70 6f 69 ) When a savepoi
339f0 6e 74 20 69 73 20 62 65 69 6e 67 20 72 6f 6c 6c nt is being roll
33a00 65 64 20 62 61 63 6b 20 61 6e 64 20 77 65 20 6e ed back and we n
33a10 65 65 64 20 74 6f 20 6c 6f 61 64 0a 2a 2a 20 20 eed to load.**
33a20 20 20 20 20 61 20 6e 65 77 20 70 61 67 65 20 69 a new page i
33a30 6e 74 6f 20 74 68 65 20 63 61 63 68 65 20 74 6f nto the cache to
33a40 20 62 65 20 66 69 6c 6c 65 64 20 77 69 74 68 20 be filled with
33a50 74 68 65 20 64 61 74 61 20 72 65 61 64 0a 2a 2a the data read.**
33a60 20 20 20 20 20 20 66 72 6f 6d 20 74 68 65 20 73 from the s
33a70 61 76 65 70 6f 69 6e 74 20 6a 6f 75 72 6e 61 6c avepoint journal
33a80 2e 0a 2a 2a 0a 2a 2a 20 49 66 20 6e 6f 43 6f 6e ..**.** If noCon
33a90 74 65 6e 74 20 69 73 20 74 72 75 65 2c 20 74 68 tent is true, th
33aa0 65 6e 20 74 68 65 20 64 61 74 61 20 72 65 74 75 en the data retu
33ab0 72 6e 65 64 20 69 73 20 7a 65 72 6f 65 64 20 69 rned is zeroed i
33ac0 6e 73 74 65 61 64 20 6f 66 0a 2a 2a 20 62 65 69 nstead of.** bei
33ad0 6e 67 20 72 65 61 64 20 66 72 6f 6d 20 74 68 65 ng read from the
33ae0 20 64 61 74 61 62 61 73 65 2e 20 41 64 64 69 74 database. Addit
33af0 69 6f 6e 61 6c 6c 79 2c 20 74 68 65 20 62 69 74 ionally, the bit
33b00 73 20 63 6f 72 72 65 73 70 6f 6e 64 69 6e 67 0a s corresponding.
33b10 2a 2a 20 74 6f 20 70 67 6e 6f 20 69 6e 20 50 61 ** to pgno in Pa
33b20 67 65 72 2e 70 49 6e 4a 6f 75 72 6e 61 6c 20 28 ger.pInJournal (
33b30 62 69 74 76 65 63 20 6f 66 20 70 61 67 65 73 20 bitvec of pages
33b40 61 6c 72 65 61 64 79 20 77 72 69 74 74 65 6e 20 already written
33b50 74 6f 20 74 68 65 0a 2a 2a 20 6a 6f 75 72 6e 61 to the.** journa
33b60 6c 20 66 69 6c 65 29 20 61 6e 64 20 74 68 65 20 l file) and the
33b70 50 61 67 65 72 53 61 76 65 70 6f 69 6e 74 2e 70 PagerSavepoint.p
33b80 49 6e 53 61 76 65 70 6f 69 6e 74 20 62 69 74 76 InSavepoint bitv
33b90 65 63 73 20 6f 66 20 61 6e 79 20 6f 70 65 6e 0a ecs of any open.
33ba0 2a 2a 20 73 61 76 65 70 6f 69 6e 74 73 20 61 72 ** savepoints ar
33bb0 65 20 73 65 74 2e 20 54 68 69 73 20 6d 65 61 6e e set. This mean
33bc0 73 20 69 66 20 74 68 65 20 70 61 67 65 20 69 73 s if the page is
33bd0 20 6d 61 64 65 20 77 72 69 74 61 62 6c 65 20 61 made writable a
33be0 74 20 61 6e 79 0a 2a 2a 20 70 6f 69 6e 74 20 69 t any.** point i
33bf0 6e 20 74 68 65 20 66 75 74 75 72 65 2c 20 75 73 n the future, us
33c00 69 6e 67 20 61 20 63 61 6c 6c 20 74 6f 20 73 71 ing a call to sq
33c10 6c 69 74 65 33 50 61 67 65 72 57 72 69 74 65 28 lite3PagerWrite(
33c20 29 2c 20 69 74 73 20 63 6f 6e 74 65 6e 74 73 0a ), its contents.
33c30 2a 2a 20 77 69 6c 6c 20 6e 6f 74 20 62 65 20 6a ** will not be j
33c40 6f 75 72 6e 61 6c 65 64 2e 20 54 68 69 73 20 73 ournaled. This s
33c50 61 76 65 73 20 49 4f 2e 0a 2a 2a 0a 2a 2a 20 54 aves IO..**.** T
33c60 68 65 20 61 63 71 75 69 73 69 74 69 6f 6e 20 6d he acquisition m
33c70 69 67 68 74 20 66 61 69 6c 20 66 6f 72 20 73 65 ight fail for se
33c80 76 65 72 61 6c 20 72 65 61 73 6f 6e 73 2e 20 20 veral reasons.
33c90 49 6e 20 61 6c 6c 20 63 61 73 65 73 2c 0a 2a 2a In all cases,.**
33ca0 20 61 6e 20 61 70 70 72 6f 70 72 69 61 74 65 20 an appropriate
33cb0 65 72 72 6f 72 20 63 6f 64 65 20 69 73 20 72 65 error code is re
33cc0 74 75 72 6e 65 64 20 61 6e 64 20 2a 70 70 50 61 turned and *ppPa
33cd0 67 65 20 69 73 20 73 65 74 20 74 6f 20 4e 55 4c ge is set to NUL
33ce0 4c 2e 0a 2a 2a 0a 2a 2a 20 53 65 65 20 61 6c 73 L..**.** See als
33cf0 6f 20 73 71 6c 69 74 65 33 50 61 67 65 72 4c 6f o sqlite3PagerLo
33d00 6f 6b 75 70 28 29 2e 20 20 42 6f 74 68 20 74 68 okup(). Both th
33d10 69 73 20 72 6f 75 74 69 6e 65 20 61 6e 64 20 4c is routine and L
33d20 6f 6f 6b 75 70 28 29 20 61 74 74 65 6d 70 74 0a ookup() attempt.
33d30 2a 2a 20 74 6f 20 66 69 6e 64 20 61 20 70 61 67 ** to find a pag
33d40 65 20 69 6e 20 74 68 65 20 69 6e 2d 6d 65 6d 6f e in the in-memo
33d50 72 79 20 63 61 63 68 65 20 66 69 72 73 74 2e 20 ry cache first.
33d60 20 49 66 20 74 68 65 20 70 61 67 65 20 69 73 20 If the page is
33d70 6e 6f 74 20 61 6c 72 65 61 64 79 0a 2a 2a 20 69 not already.** i
33d80 6e 20 6d 65 6d 6f 72 79 2c 20 74 68 69 73 20 72 n memory, this r
33d90 6f 75 74 69 6e 65 20 67 6f 65 73 20 74 6f 20 64 outine goes to d
33da0 69 73 6b 20 74 6f 20 72 65 61 64 20 69 74 20 69 isk to read it i
33db0 6e 20 77 68 65 72 65 61 73 20 4c 6f 6f 6b 75 70 n whereas Lookup
33dc0 28 29 0a 2a 2a 20 6a 75 73 74 20 72 65 74 75 72 ().** just retur
33dd0 6e 73 20 30 2e 20 20 54 68 69 73 20 72 6f 75 74 ns 0. This rout
33de0 69 6e 65 20 61 63 71 75 69 72 65 73 20 61 20 72 ine acquires a r
33df0 65 61 64 2d 6c 6f 63 6b 20 74 68 65 20 66 69 72 ead-lock the fir
33e00 73 74 20 74 69 6d 65 20 69 74 0a 2a 2a 20 68 61 st time it.** ha
33e10 73 20 74 6f 20 67 6f 20 74 6f 20 64 69 73 6b 2c s to go to disk,
33e20 20 61 6e 64 20 63 6f 75 6c 64 20 61 6c 73 6f 20 and could also
33e30 70 6c 61 79 62 61 63 6b 20 61 6e 20 6f 6c 64 20 playback an old
33e40 6a 6f 75 72 6e 61 6c 20 69 66 20 6e 65 63 65 73 journal if neces
33e50 73 61 72 79 2e 0a 2a 2a 20 53 69 6e 63 65 20 4c sary..** Since L
33e60 6f 6f 6b 75 70 28 29 20 6e 65 76 65 72 20 67 6f ookup() never go
33e70 65 73 20 74 6f 20 64 69 73 6b 2c 20 69 74 20 6e es to disk, it n
33e80 65 76 65 72 20 68 61 73 20 74 6f 20 64 65 61 6c ever has to deal
33e90 20 77 69 74 68 20 6c 6f 63 6b 73 0a 2a 2a 20 6f with locks.** o
33ea0 72 20 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 73 2e r journal files.
33eb0 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 50 .*/.int sqlite3P
33ec0 61 67 65 72 47 65 74 28 0a 20 20 50 61 67 65 72 agerGet(. Pager
33ed0 20 2a 70 50 61 67 65 72 2c 20 20 20 20 20 20 2f *pPager, /
33ee0 2a 20 54 68 65 20 70 61 67 65 72 20 6f 70 65 6e * The pager open
33ef0 20 6f 6e 20 74 68 65 20 64 61 74 61 62 61 73 65 on the database
33f00 20 66 69 6c 65 20 2a 2f 0a 20 20 50 67 6e 6f 20 file */. Pgno
33f10 70 67 6e 6f 2c 20 20 20 20 20 20 20 20 20 20 2f pgno, /
33f20 2a 20 50 61 67 65 20 6e 75 6d 62 65 72 20 74 6f * Page number to
33f30 20 66 65 74 63 68 20 2a 2f 0a 20 20 44 62 50 61 fetch */. DbPa
33f40 67 65 20 2a 2a 70 70 50 61 67 65 2c 20 20 20 20 ge **ppPage,
33f50 2f 2a 20 57 72 69 74 65 20 61 20 70 6f 69 6e 74 /* Write a point
33f60 65 72 20 74 6f 20 74 68 65 20 70 61 67 65 20 68 er to the page h
33f70 65 72 65 20 2a 2f 0a 20 20 69 6e 74 20 66 6c 61 ere */. int fla
33f80 67 73 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 gs /*
33f90 50 41 47 45 52 5f 47 45 54 5f 58 58 58 20 66 6c PAGER_GET_XXX fl
33fa0 61 67 73 20 2a 2f 0a 29 7b 0a 20 20 69 6e 74 20 ags */.){. int
33fb0 72 63 20 3d 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a rc = SQLITE_OK;.
33fc0 20 20 50 67 48 64 72 20 2a 70 50 67 20 3d 20 30 PgHdr *pPg = 0
33fd0 3b 0a 20 20 75 33 32 20 69 46 72 61 6d 65 20 3d ;. u32 iFrame =
33fe0 20 30 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 0;
33ff0 20 20 20 20 2f 2a 20 46 72 61 6d 65 20 74 6f 20 /* Frame to
34000 72 65 61 64 20 66 72 6f 6d 20 57 41 4c 20 66 69 read from WAL fi
34010 6c 65 20 2a 2f 0a 20 20 63 6f 6e 73 74 20 69 6e le */. const in
34020 74 20 6e 6f 43 6f 6e 74 65 6e 74 20 3d 20 28 66 t noContent = (f
34030 6c 61 67 73 20 26 20 50 41 47 45 52 5f 47 45 54 lags & PAGER_GET
34040 5f 4e 4f 43 4f 4e 54 45 4e 54 29 3b 0a 0a 20 20 _NOCONTENT);..
34050 2f 2a 20 49 74 20 69 73 20 61 63 63 65 70 74 61 /* It is accepta
34060 62 6c 65 20 74 6f 20 75 73 65 20 61 20 72 65 61 ble to use a rea
34070 64 2d 6f 6e 6c 79 20 28 6d 6d 61 70 29 20 70 61 d-only (mmap) pa
34080 67 65 20 66 6f 72 20 61 6e 79 20 70 61 67 65 20 ge for any page
34090 65 78 63 65 70 74 0a 20 20 2a 2a 20 70 61 67 65 except. ** page
340a0 20 31 20 69 66 20 74 68 65 72 65 20 69 73 20 6e 1 if there is n
340b0 6f 20 77 72 69 74 65 2d 74 72 61 6e 73 61 63 74 o write-transact
340c0 69 6f 6e 20 6f 70 65 6e 20 6f 72 20 74 68 65 20 ion open or the
340d0 41 43 51 55 49 52 45 5f 52 45 41 44 4f 4e 4c 59 ACQUIRE_READONLY
340e0 0a 20 20 2a 2a 20 66 6c 61 67 20 77 61 73 20 73 . ** flag was s
340f0 70 65 63 69 66 69 65 64 20 62 79 20 74 68 65 20 pecified by the
34100 63 61 6c 6c 65 72 2e 20 41 6e 64 20 73 6f 20 6c caller. And so l
34110 6f 6e 67 20 61 73 20 74 68 65 20 64 62 20 69 73 ong as the db is
34120 20 6e 6f 74 20 61 20 0a 20 20 2a 2a 20 74 65 6d not a . ** tem
34130 70 6f 72 61 72 79 20 6f 72 20 69 6e 2d 6d 65 6d porary or in-mem
34140 6f 72 79 20 64 61 74 61 62 61 73 65 2e 20 20 2a ory database. *
34150 2f 0a 20 20 63 6f 6e 73 74 20 69 6e 74 20 62 4d /. const int bM
34160 6d 61 70 4f 6b 20 3d 20 28 70 67 6e 6f 3e 31 20 mapOk = (pgno>1
34170 26 26 20 55 53 45 46 45 54 43 48 28 70 50 61 67 && USEFETCH(pPag
34180 65 72 29 0a 20 20 20 26 26 20 28 70 50 61 67 65 er). && (pPage
34190 72 2d 3e 65 53 74 61 74 65 3d 3d 50 41 47 45 52 r->eState==PAGER
341a0 5f 52 45 41 44 45 52 20 7c 7c 20 28 66 6c 61 67 _READER || (flag
341b0 73 20 26 20 50 41 47 45 52 5f 47 45 54 5f 52 45 s & PAGER_GET_RE
341c0 41 44 4f 4e 4c 59 29 29 0a 23 69 66 64 65 66 20 ADONLY)).#ifdef
341d0 53 51 4c 49 54 45 5f 48 41 53 5f 43 4f 44 45 43 SQLITE_HAS_CODEC
341e0 0a 20 20 20 26 26 20 70 50 61 67 65 72 2d 3e 78 . && pPager->x
341f0 43 6f 64 65 63 3d 3d 30 0a 23 65 6e 64 69 66 0a Codec==0.#endif.
34200 20 20 29 3b 0a 0a 20 20 2f 2a 20 4f 70 74 69 6d );.. /* Optim
34210 69 7a 61 74 69 6f 6e 20 6e 6f 74 65 3a 20 20 41 ization note: A
34220 64 64 69 6e 67 20 74 68 65 20 22 70 67 6e 6f 3c dding the "pgno<
34230 3d 31 22 20 74 65 72 6d 20 62 65 66 6f 72 65 20 =1" term before
34240 22 70 67 6e 6f 3d 3d 30 22 20 68 65 72 65 0a 20 "pgno==0" here.
34250 20 2a 2a 20 61 6c 6c 6f 77 73 20 74 68 65 20 63 ** allows the c
34260 6f 6d 70 69 6c 65 72 20 6f 70 74 69 6d 69 7a 65 ompiler optimize
34270 72 20 74 6f 20 72 65 75 73 65 20 74 68 65 20 72 r to reuse the r
34280 65 73 75 6c 74 73 20 6f 66 20 74 68 65 20 22 70 esults of the "p
34290 67 6e 6f 3e 31 22 0a 20 20 2a 2a 20 74 65 73 74 gno>1". ** test
342a0 20 69 6e 20 74 68 65 20 70 72 65 76 69 6f 75 73 in the previous
342b0 20 73 74 61 74 65 6d 65 6e 74 2c 20 61 6e 64 20 statement, and
342c0 61 76 6f 69 64 20 74 65 73 74 69 6e 67 20 70 67 avoid testing pg
342d0 6e 6f 3d 3d 30 20 69 6e 20 74 68 65 0a 20 20 2a no==0 in the. *
342e0 2a 20 63 6f 6d 6d 6f 6e 20 63 61 73 65 20 77 68 * common case wh
342f0 65 72 65 20 70 67 6e 6f 20 69 73 20 6c 61 72 67 ere pgno is larg
34300 65 2e 20 2a 2f 0a 20 20 69 66 28 20 70 67 6e 6f e. */. if( pgno
34310 3c 3d 31 20 26 26 20 70 67 6e 6f 3d 3d 30 20 29 <=1 && pgno==0 )
34320 7b 0a 20 20 20 20 72 65 74 75 72 6e 20 53 51 4c {. return SQL
34330 49 54 45 5f 43 4f 52 52 55 50 54 5f 42 4b 50 54 ITE_CORRUPT_BKPT
34340 3b 0a 20 20 7d 0a 20 20 61 73 73 65 72 74 28 20 ;. }. assert(
34350 70 50 61 67 65 72 2d 3e 65 53 74 61 74 65 3e 3d pPager->eState>=
34360 50 41 47 45 52 5f 52 45 41 44 45 52 20 29 3b 0a PAGER_READER );.
34370 20 20 61 73 73 65 72 74 28 20 61 73 73 65 72 74 assert( assert
34380 5f 70 61 67 65 72 5f 73 74 61 74 65 28 70 50 61 _pager_state(pPa
34390 67 65 72 29 20 29 3b 0a 20 20 61 73 73 65 72 74 ger) );. assert
343a0 28 20 6e 6f 43 6f 6e 74 65 6e 74 3d 3d 30 20 7c ( noContent==0 |
343b0 7c 20 62 4d 6d 61 70 4f 6b 3d 3d 30 20 29 3b 0a | bMmapOk==0 );.
343c0 0a 20 20 61 73 73 65 72 74 28 20 70 50 61 67 65 . assert( pPage
343d0 72 2d 3e 68 61 73 48 65 6c 64 53 68 61 72 65 64 r->hasHeldShared
343e0 4c 6f 63 6b 3d 3d 31 20 29 3b 0a 0a 20 20 2f 2a Lock==1 );.. /*
343f0 20 49 66 20 74 68 65 20 70 61 67 65 72 20 69 73 If the pager is
34400 20 69 6e 20 74 68 65 20 65 72 72 6f 72 20 73 74 in the error st
34410 61 74 65 2c 20 72 65 74 75 72 6e 20 61 6e 20 65 ate, return an e
34420 72 72 6f 72 20 69 6d 6d 65 64 69 61 74 65 6c 79 rror immediately
34430 2e 20 0a 20 20 2a 2a 20 4f 74 68 65 72 77 69 73 . . ** Otherwis
34440 65 2c 20 72 65 71 75 65 73 74 20 74 68 65 20 70 e, request the p
34450 61 67 65 20 66 72 6f 6d 20 74 68 65 20 50 43 61 age from the PCa
34460 63 68 65 20 6c 61 79 65 72 2e 20 2a 2f 0a 20 20 che layer. */.
34470 69 66 28 20 70 50 61 67 65 72 2d 3e 65 72 72 43 if( pPager->errC
34480 6f 64 65 21 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 ode!=SQLITE_OK )
34490 7b 0a 20 20 20 20 72 63 20 3d 20 70 50 61 67 65 {. rc = pPage
344a0 72 2d 3e 65 72 72 43 6f 64 65 3b 0a 20 20 7d 65 r->errCode;. }e
344b0 6c 73 65 7b 0a 20 20 20 20 69 66 28 20 62 4d 6d lse{. if( bMm
344c0 61 70 4f 6b 20 26 26 20 70 61 67 65 72 55 73 65 apOk && pagerUse
344d0 57 61 6c 28 70 50 61 67 65 72 29 20 29 7b 0a 20 Wal(pPager) ){.
344e0 20 20 20 20 20 72 63 20 3d 20 73 71 6c 69 74 65 rc = sqlite
344f0 33 57 61 6c 46 69 6e 64 46 72 61 6d 65 28 70 50 3WalFindFrame(pP
34500 61 67 65 72 2d 3e 70 57 61 6c 2c 20 70 67 6e 6f ager->pWal, pgno
34510 2c 20 26 69 46 72 61 6d 65 29 3b 0a 20 20 20 20 , &iFrame);.
34520 20 20 69 66 28 20 72 63 21 3d 53 51 4c 49 54 45 if( rc!=SQLITE
34530 5f 4f 4b 20 29 20 67 6f 74 6f 20 70 61 67 65 72 _OK ) goto pager
34540 5f 61 63 71 75 69 72 65 5f 65 72 72 3b 0a 20 20 _acquire_err;.
34550 20 20 7d 0a 0a 20 20 20 20 69 66 28 20 62 4d 6d }.. if( bMm
34560 61 70 4f 6b 20 26 26 20 69 46 72 61 6d 65 3d 3d apOk && iFrame==
34570 30 20 29 7b 0a 20 20 20 20 20 20 76 6f 69 64 20 0 ){. void
34580 2a 70 44 61 74 61 20 3d 20 30 3b 0a 0a 20 20 20 *pData = 0;..
34590 20 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33 4f rc = sqlite3O
345a0 73 46 65 74 63 68 28 70 50 61 67 65 72 2d 3e 66 sFetch(pPager->f
345b0 64 2c 20 0a 20 20 20 20 20 20 20 20 20 20 28 69 d, . (i
345c0 36 34 29 28 70 67 6e 6f 2d 31 29 20 2a 20 70 50 64)(pgno-1) * pP
345d0 61 67 65 72 2d 3e 70 61 67 65 53 69 7a 65 2c 20 ager->pageSize,
345e0 70 50 61 67 65 72 2d 3e 70 61 67 65 53 69 7a 65 pPager->pageSize
345f0 2c 20 26 70 44 61 74 61 0a 20 20 20 20 20 20 29 , &pData. )
34600 3b 0a 0a 20 20 20 20 20 20 69 66 28 20 72 63 3d ;.. if( rc=
34610 3d 53 51 4c 49 54 45 5f 4f 4b 20 26 26 20 70 44 =SQLITE_OK && pD
34620 61 74 61 20 29 7b 0a 20 20 20 20 20 20 20 20 69 ata ){. i
34630 66 28 20 70 50 61 67 65 72 2d 3e 65 53 74 61 74 f( pPager->eStat
34640 65 3e 50 41 47 45 52 5f 52 45 41 44 45 52 20 7c e>PAGER_READER |
34650 7c 20 70 50 61 67 65 72 2d 3e 74 65 6d 70 46 69 | pPager->tempFi
34660 6c 65 20 29 7b 0a 20 20 20 20 20 20 20 20 20 20 le ){.
34670 70 50 67 20 3d 20 73 71 6c 69 74 65 33 50 61 67 pPg = sqlite3Pag
34680 65 72 4c 6f 6f 6b 75 70 28 70 50 61 67 65 72 2c erLookup(pPager,
34690 20 70 67 6e 6f 29 3b 0a 20 20 20 20 20 20 20 20 pgno);.
346a0 7d 0a 20 20 20 20 20 20 20 20 69 66 28 20 70 50 }. if( pP
346b0 67 3d 3d 30 20 29 7b 0a 20 20 20 20 20 20 20 20 g==0 ){.
346c0 20 20 72 63 20 3d 20 70 61 67 65 72 41 63 71 75 rc = pagerAcqu
346d0 69 72 65 4d 61 70 50 61 67 65 28 70 50 61 67 65 ireMapPage(pPage
346e0 72 2c 20 70 67 6e 6f 2c 20 70 44 61 74 61 2c 20 r, pgno, pData,
346f0 26 70 50 67 29 3b 0a 20 20 20 20 20 20 20 20 7d &pPg);. }
34700 65 6c 73 65 7b 0a 20 20 20 20 20 20 20 20 20 20 else{.
34710 73 71 6c 69 74 65 33 4f 73 55 6e 66 65 74 63 68 sqlite3OsUnfetch
34720 28 70 50 61 67 65 72 2d 3e 66 64 2c 20 28 69 36 (pPager->fd, (i6
34730 34 29 28 70 67 6e 6f 2d 31 29 2a 70 50 61 67 65 4)(pgno-1)*pPage
34740 72 2d 3e 70 61 67 65 53 69 7a 65 2c 20 70 44 61 r->pageSize, pDa
34750 74 61 29 3b 0a 20 20 20 20 20 20 20 20 7d 0a 20 ta);. }.
34760 20 20 20 20 20 20 20 69 66 28 20 70 50 67 20 29 if( pPg )
34770 7b 0a 20 20 20 20 20 20 20 20 20 20 61 73 73 65 {. asse
34780 72 74 28 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4f rt( rc==SQLITE_O
34790 4b 20 29 3b 0a 20 20 20 20 20 20 20 20 20 20 2a K );. *
347a0 70 70 50 61 67 65 20 3d 20 70 50 67 3b 0a 20 20 ppPage = pPg;.
347b0 20 20 20 20 20 20 20 20 72 65 74 75 72 6e 20 53 return S
347c0 51 4c 49 54 45 5f 4f 4b 3b 0a 20 20 20 20 20 20 QLITE_OK;.
347d0 20 20 7d 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 }. }.
347e0 20 20 69 66 28 20 72 63 21 3d 53 51 4c 49 54 45 if( rc!=SQLITE
347f0 5f 4f 4b 20 29 7b 0a 20 20 20 20 20 20 20 20 67 _OK ){. g
34800 6f 74 6f 20 70 61 67 65 72 5f 61 63 71 75 69 72 oto pager_acquir
34810 65 5f 65 72 72 3b 0a 20 20 20 20 20 20 7d 0a 20 e_err;. }.
34820 20 20 20 7d 0a 0a 20 20 20 20 7b 0a 20 20 20 20 }.. {.
34830 20 20 73 71 6c 69 74 65 33 5f 70 63 61 63 68 65 sqlite3_pcache
34840 5f 70 61 67 65 20 2a 70 42 61 73 65 3b 0a 20 20 _page *pBase;.
34850 20 20 20 20 70 42 61 73 65 20 3d 20 73 71 6c 69 pBase = sqli
34860 74 65 33 50 63 61 63 68 65 46 65 74 63 68 28 70 te3PcacheFetch(p
34870 50 61 67 65 72 2d 3e 70 50 43 61 63 68 65 2c 20 Pager->pPCache,
34880 70 67 6e 6f 2c 20 33 29 3b 0a 20 20 20 20 20 20 pgno, 3);.
34890 69 66 28 20 70 42 61 73 65 3d 3d 30 20 29 7b 0a if( pBase==0 ){.
348a0 20 20 20 20 20 20 20 20 72 63 20 3d 20 73 71 6c rc = sql
348b0 69 74 65 33 50 63 61 63 68 65 46 65 74 63 68 53 ite3PcacheFetchS
348c0 74 72 65 73 73 28 70 50 61 67 65 72 2d 3e 70 50 tress(pPager->pP
348d0 43 61 63 68 65 2c 20 70 67 6e 6f 2c 20 26 70 42 Cache, pgno, &pB
348e0 61 73 65 29 3b 0a 20 20 20 20 20 20 20 20 69 66 ase);. if
348f0 28 20 72 63 21 3d 53 51 4c 49 54 45 5f 4f 4b 20 ( rc!=SQLITE_OK
34900 29 20 67 6f 74 6f 20 70 61 67 65 72 5f 61 63 71 ) goto pager_acq
34910 75 69 72 65 5f 65 72 72 3b 0a 20 20 20 20 20 20 uire_err;.
34920 20 20 69 66 28 20 70 42 61 73 65 3d 3d 30 20 29 if( pBase==0 )
34930 7b 0a 20 20 20 20 20 20 20 20 20 20 70 50 67 20 {. pPg
34940 3d 20 2a 70 70 50 61 67 65 20 3d 20 30 3b 0a 20 = *ppPage = 0;.
34950 20 20 20 20 20 20 20 20 20 72 63 20 3d 20 53 51 rc = SQ
34960 4c 49 54 45 5f 4e 4f 4d 45 4d 5f 42 4b 50 54 3b LITE_NOMEM_BKPT;
34970 0a 20 20 20 20 20 20 20 20 20 20 67 6f 74 6f 20 . goto
34980 70 61 67 65 72 5f 61 63 71 75 69 72 65 5f 65 72 pager_acquire_er
34990 72 3b 0a 20 20 20 20 20 20 20 20 7d 0a 20 20 20 r;. }.
349a0 20 20 20 7d 0a 20 20 20 20 20 20 70 50 67 20 3d }. pPg =
349b0 20 2a 70 70 50 61 67 65 20 3d 20 73 71 6c 69 74 *ppPage = sqlit
349c0 65 33 50 63 61 63 68 65 46 65 74 63 68 46 69 6e e3PcacheFetchFin
349d0 69 73 68 28 70 50 61 67 65 72 2d 3e 70 50 43 61 ish(pPager->pPCa
349e0 63 68 65 2c 20 70 67 6e 6f 2c 20 70 42 61 73 65 che, pgno, pBase
349f0 29 3b 0a 20 20 20 20 20 20 61 73 73 65 72 74 28 );. assert(
34a00 20 70 50 67 21 3d 30 20 29 3b 0a 20 20 20 20 7d pPg!=0 );. }
34a10 0a 20 20 7d 0a 0a 20 20 69 66 28 20 72 63 21 3d . }.. if( rc!=
34a20 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 SQLITE_OK ){.
34a30 20 2f 2a 20 45 69 74 68 65 72 20 74 68 65 20 63 /* Either the c
34a40 61 6c 6c 20 74 6f 20 73 71 6c 69 74 65 33 50 63 all to sqlite3Pc
34a50 61 63 68 65 46 65 74 63 68 28 29 20 72 65 74 75 acheFetch() retu
34a60 72 6e 65 64 20 61 6e 20 65 72 72 6f 72 20 6f 72 rned an error or
34a70 20 74 68 65 0a 20 20 20 20 2a 2a 20 70 61 67 65 the. ** page
34a80 72 20 77 61 73 20 61 6c 72 65 61 64 79 20 69 6e r was already in
34a90 20 74 68 65 20 65 72 72 6f 72 2d 73 74 61 74 65 the error-state
34aa0 20 77 68 65 6e 20 74 68 69 73 20 66 75 6e 63 74 when this funct
34ab0 69 6f 6e 20 77 61 73 20 63 61 6c 6c 65 64 2e 0a ion was called..
34ac0 20 20 20 20 2a 2a 20 53 65 74 20 70 50 67 20 74 ** Set pPg t
34ad0 6f 20 30 20 61 6e 64 20 6a 75 6d 70 20 74 6f 20 o 0 and jump to
34ae0 74 68 65 20 65 78 63 65 70 74 69 6f 6e 20 68 61 the exception ha
34af0 6e 64 6c 65 72 2e 20 20 2a 2f 0a 20 20 20 20 70 ndler. */. p
34b00 50 67 20 3d 20 30 3b 0a 20 20 20 20 67 6f 74 6f Pg = 0;. goto
34b10 20 70 61 67 65 72 5f 61 63 71 75 69 72 65 5f 65 pager_acquire_e
34b20 72 72 3b 0a 20 20 7d 0a 20 20 61 73 73 65 72 74 rr;. }. assert
34b30 28 20 70 50 67 3d 3d 28 2a 70 70 50 61 67 65 29 ( pPg==(*ppPage)
34b40 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 70 50 );. assert( pP
34b50 67 2d 3e 70 67 6e 6f 3d 3d 70 67 6e 6f 20 29 3b g->pgno==pgno );
34b60 0a 20 20 61 73 73 65 72 74 28 20 70 50 67 2d 3e . assert( pPg->
34b70 70 50 61 67 65 72 3d 3d 70 50 61 67 65 72 20 7c pPager==pPager |
34b80 7c 20 70 50 67 2d 3e 70 50 61 67 65 72 3d 3d 30 | pPg->pPager==0
34b90 20 29 3b 0a 0a 20 20 69 66 28 20 70 50 67 2d 3e );.. if( pPg->
34ba0 70 50 61 67 65 72 20 26 26 20 21 6e 6f 43 6f 6e pPager && !noCon
34bb0 74 65 6e 74 20 29 7b 0a 20 20 20 20 2f 2a 20 49 tent ){. /* I
34bc0 6e 20 74 68 69 73 20 63 61 73 65 20 74 68 65 20 n this case the
34bd0 70 63 61 63 68 65 20 61 6c 72 65 61 64 79 20 63 pcache already c
34be0 6f 6e 74 61 69 6e 73 20 61 6e 20 69 6e 69 74 69 ontains an initi
34bf0 61 6c 69 7a 65 64 20 63 6f 70 79 20 6f 66 0a 20 alized copy of.
34c00 20 20 20 2a 2a 20 74 68 65 20 70 61 67 65 2e 20 ** the page.
34c10 52 65 74 75 72 6e 20 77 69 74 68 6f 75 74 20 66 Return without f
34c20 75 72 74 68 65 72 20 61 64 6f 2e 20 20 2a 2f 0a urther ado. */.
34c30 20 20 20 20 61 73 73 65 72 74 28 20 70 67 6e 6f assert( pgno
34c40 3c 3d 50 41 47 45 52 5f 4d 41 58 5f 50 47 4e 4f <=PAGER_MAX_PGNO
34c50 20 26 26 20 70 67 6e 6f 21 3d 50 41 47 45 52 5f && pgno!=PAGER_
34c60 4d 4a 5f 50 47 4e 4f 28 70 50 61 67 65 72 29 20 MJ_PGNO(pPager)
34c70 29 3b 0a 20 20 20 20 70 50 61 67 65 72 2d 3e 61 );. pPager->a
34c80 53 74 61 74 5b 50 41 47 45 52 5f 53 54 41 54 5f Stat[PAGER_STAT_
34c90 48 49 54 5d 2b 2b 3b 0a 20 20 20 20 72 65 74 75 HIT]++;. retu
34ca0 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 0a 20 rn SQLITE_OK;..
34cb0 20 7d 65 6c 73 65 7b 0a 20 20 20 20 2f 2a 20 54 }else{. /* T
34cc0 68 65 20 70 61 67 65 72 20 63 61 63 68 65 20 68 he pager cache h
34cd0 61 73 20 63 72 65 61 74 65 64 20 61 20 6e 65 77 as created a new
34ce0 20 70 61 67 65 2e 20 49 74 73 20 63 6f 6e 74 65 page. Its conte
34cf0 6e 74 20 6e 65 65 64 73 20 74 6f 20 0a 20 20 20 nt needs to .
34d00 20 2a 2a 20 62 65 20 69 6e 69 74 69 61 6c 69 7a ** be initializ
34d10 65 64 2e 20 20 2a 2f 0a 0a 20 20 20 20 70 50 67 ed. */.. pPg
34d20 2d 3e 70 50 61 67 65 72 20 3d 20 70 50 61 67 65 ->pPager = pPage
34d30 72 3b 0a 0a 20 20 20 20 2f 2a 20 54 68 65 20 6d r;.. /* The m
34d40 61 78 69 6d 75 6d 20 70 61 67 65 20 6e 75 6d 62 aximum page numb
34d50 65 72 20 69 73 20 32 5e 33 31 2e 20 52 65 74 75 er is 2^31. Retu
34d60 72 6e 20 53 51 4c 49 54 45 5f 43 4f 52 52 55 50 rn SQLITE_CORRUP
34d70 54 20 69 66 20 61 20 70 61 67 65 0a 20 20 20 20 T if a page.
34d80 2a 2a 20 6e 75 6d 62 65 72 20 67 72 65 61 74 65 ** number greate
34d90 72 20 74 68 61 6e 20 74 68 69 73 2c 20 6f 72 20 r than this, or
34da0 74 68 65 20 75 6e 75 73 65 64 20 6c 6f 63 6b 69 the unused locki
34db0 6e 67 2d 70 61 67 65 2c 20 69 73 20 72 65 71 75 ng-page, is requ
34dc0 65 73 74 65 64 2e 20 2a 2f 0a 20 20 20 20 69 66 ested. */. if
34dd0 28 20 70 67 6e 6f 3e 50 41 47 45 52 5f 4d 41 58 ( pgno>PAGER_MAX
34de0 5f 50 47 4e 4f 20 7c 7c 20 70 67 6e 6f 3d 3d 50 _PGNO || pgno==P
34df0 41 47 45 52 5f 4d 4a 5f 50 47 4e 4f 28 70 50 61 AGER_MJ_PGNO(pPa
34e00 67 65 72 29 20 29 7b 0a 20 20 20 20 20 20 72 63 ger) ){. rc
34e10 20 3d 20 53 51 4c 49 54 45 5f 43 4f 52 52 55 50 = SQLITE_CORRUP
34e20 54 5f 42 4b 50 54 3b 0a 20 20 20 20 20 20 67 6f T_BKPT;. go
34e30 74 6f 20 70 61 67 65 72 5f 61 63 71 75 69 72 65 to pager_acquire
34e40 5f 65 72 72 3b 0a 20 20 20 20 7d 0a 0a 20 20 20 _err;. }..
34e50 20 61 73 73 65 72 74 28 20 21 69 73 4f 70 65 6e assert( !isOpen
34e60 28 70 50 61 67 65 72 2d 3e 66 64 29 20 7c 7c 20 (pPager->fd) ||
34e70 21 4d 45 4d 44 42 20 29 3b 0a 20 20 20 20 69 66 !MEMDB );. if
34e80 28 20 21 69 73 4f 70 65 6e 28 70 50 61 67 65 72 ( !isOpen(pPager
34e90 2d 3e 66 64 29 20 7c 7c 20 70 50 61 67 65 72 2d ->fd) || pPager-
34ea0 3e 64 62 53 69 7a 65 3c 70 67 6e 6f 20 7c 7c 20 >dbSize<pgno ||
34eb0 6e 6f 43 6f 6e 74 65 6e 74 20 29 7b 0a 20 20 20 noContent ){.
34ec0 20 20 20 69 66 28 20 70 67 6e 6f 3e 70 50 61 67 if( pgno>pPag
34ed0 65 72 2d 3e 6d 78 50 67 6e 6f 20 29 7b 0a 20 20 er->mxPgno ){.
34ee0 20 20 20 20 20 20 72 63 20 3d 20 53 51 4c 49 54 rc = SQLIT
34ef0 45 5f 46 55 4c 4c 3b 0a 20 20 20 20 20 20 20 20 E_FULL;.
34f00 67 6f 74 6f 20 70 61 67 65 72 5f 61 63 71 75 69 goto pager_acqui
34f10 72 65 5f 65 72 72 3b 0a 20 20 20 20 20 20 7d 0a re_err;. }.
34f20 20 20 20 20 20 20 69 66 28 20 6e 6f 43 6f 6e 74 if( noCont
34f30 65 6e 74 20 29 7b 0a 20 20 20 20 20 20 20 20 2f ent ){. /
34f40 2a 20 46 61 69 6c 75 72 65 20 74 6f 20 73 65 74 * Failure to set
34f50 20 74 68 65 20 62 69 74 73 20 69 6e 20 74 68 65 the bits in the
34f60 20 49 6e 4a 6f 75 72 6e 61 6c 20 62 69 74 2d 76 InJournal bit-v
34f70 65 63 74 6f 72 73 20 69 73 20 62 65 6e 69 67 6e ectors is benign
34f80 2e 0a 20 20 20 20 20 20 20 20 2a 2a 20 49 74 20 .. ** It
34f90 6d 65 72 65 6c 79 20 6d 65 61 6e 73 20 74 68 61 merely means tha
34fa0 74 20 77 65 20 6d 69 67 68 74 20 64 6f 20 73 6f t we might do so
34fb0 6d 65 20 65 78 74 72 61 20 77 6f 72 6b 20 74 6f me extra work to
34fc0 20 6a 6f 75 72 6e 61 6c 20 61 20 0a 20 20 20 20 journal a .
34fd0 20 20 20 20 2a 2a 20 70 61 67 65 20 74 68 61 74 ** page that
34fe0 20 64 6f 65 73 20 6e 6f 74 20 6e 65 65 64 20 74 does not need t
34ff0 6f 20 62 65 20 6a 6f 75 72 6e 61 6c 65 64 2e 20 o be journaled.
35000 20 4e 65 76 65 72 74 68 65 6c 65 73 73 2c 20 62 Nevertheless, b
35010 65 20 73 75 72 65 20 0a 20 20 20 20 20 20 20 20 e sure .
35020 2a 2a 20 74 6f 20 74 65 73 74 20 74 68 65 20 63 ** to test the c
35030 61 73 65 20 77 68 65 72 65 20 61 20 6d 61 6c 6c ase where a mall
35040 6f 63 20 65 72 72 6f 72 20 6f 63 63 75 72 73 20 oc error occurs
35050 77 68 69 6c 65 20 74 72 79 69 6e 67 20 74 6f 20 while trying to
35060 73 65 74 20 0a 20 20 20 20 20 20 20 20 2a 2a 20 set . **
35070 61 20 62 69 74 20 69 6e 20 61 20 62 69 74 20 76 a bit in a bit v
35080 65 63 74 6f 72 2e 0a 20 20 20 20 20 20 20 20 2a ector.. *
35090 2f 0a 20 20 20 20 20 20 20 20 73 71 6c 69 74 65 /. sqlite
350a0 33 42 65 67 69 6e 42 65 6e 69 67 6e 4d 61 6c 6c 3BeginBenignMall
350b0 6f 63 28 29 3b 0a 20 20 20 20 20 20 20 20 69 66 oc();. if
350c0 28 20 70 67 6e 6f 3c 3d 70 50 61 67 65 72 2d 3e ( pgno<=pPager->
350d0 64 62 4f 72 69 67 53 69 7a 65 20 29 7b 0a 20 20 dbOrigSize ){.
350e0 20 20 20 20 20 20 20 20 54 45 53 54 4f 4e 4c 59 TESTONLY
350f0 28 20 72 63 20 3d 20 29 20 73 71 6c 69 74 65 33 ( rc = ) sqlite3
35100 42 69 74 76 65 63 53 65 74 28 70 50 61 67 65 72 BitvecSet(pPager
35110 2d 3e 70 49 6e 4a 6f 75 72 6e 61 6c 2c 20 70 67 ->pInJournal, pg
35120 6e 6f 29 3b 0a 20 20 20 20 20 20 20 20 20 20 74 no);. t
35130 65 73 74 63 61 73 65 28 20 72 63 3d 3d 53 51 4c estcase( rc==SQL
35140 49 54 45 5f 4e 4f 4d 45 4d 20 29 3b 0a 20 20 20 ITE_NOMEM );.
35150 20 20 20 20 20 7d 0a 20 20 20 20 20 20 20 20 54 }. T
35160 45 53 54 4f 4e 4c 59 28 20 72 63 20 3d 20 29 20 ESTONLY( rc = )
35170 61 64 64 54 6f 53 61 76 65 70 6f 69 6e 74 42 69 addToSavepointBi
35180 74 76 65 63 73 28 70 50 61 67 65 72 2c 20 70 67 tvecs(pPager, pg
35190 6e 6f 29 3b 0a 20 20 20 20 20 20 20 20 74 65 73 no);. tes
351a0 74 63 61 73 65 28 20 72 63 3d 3d 53 51 4c 49 54 tcase( rc==SQLIT
351b0 45 5f 4e 4f 4d 45 4d 20 29 3b 0a 20 20 20 20 20 E_NOMEM );.
351c0 20 20 20 73 71 6c 69 74 65 33 45 6e 64 42 65 6e sqlite3EndBen
351d0 69 67 6e 4d 61 6c 6c 6f 63 28 29 3b 0a 20 20 20 ignMalloc();.
351e0 20 20 20 7d 0a 20 20 20 20 20 20 6d 65 6d 73 65 }. memse
351f0 74 28 70 50 67 2d 3e 70 44 61 74 61 2c 20 30 2c t(pPg->pData, 0,
35200 20 70 50 61 67 65 72 2d 3e 70 61 67 65 53 69 7a pPager->pageSiz
35210 65 29 3b 0a 20 20 20 20 20 20 49 4f 54 52 41 43 e);. IOTRAC
35220 45 28 28 22 5a 45 52 4f 20 25 70 20 25 64 5c 6e E(("ZERO %p %d\n
35230 22 2c 20 70 50 61 67 65 72 2c 20 70 67 6e 6f 29 ", pPager, pgno)
35240 29 3b 0a 20 20 20 20 7d 65 6c 73 65 7b 0a 20 20 );. }else{.
35250 20 20 20 20 69 66 28 20 70 61 67 65 72 55 73 65 if( pagerUse
35260 57 61 6c 28 70 50 61 67 65 72 29 20 26 26 20 62 Wal(pPager) && b
35270 4d 6d 61 70 4f 6b 3d 3d 30 20 29 7b 0a 20 20 20 MmapOk==0 ){.
35280 20 20 20 20 20 72 63 20 3d 20 73 71 6c 69 74 65 rc = sqlite
35290 33 57 61 6c 46 69 6e 64 46 72 61 6d 65 28 70 50 3WalFindFrame(pP
352a0 61 67 65 72 2d 3e 70 57 61 6c 2c 20 70 67 6e 6f ager->pWal, pgno
352b0 2c 20 26 69 46 72 61 6d 65 29 3b 0a 20 20 20 20 , &iFrame);.
352c0 20 20 20 20 69 66 28 20 72 63 21 3d 53 51 4c 49 if( rc!=SQLI
352d0 54 45 5f 4f 4b 20 29 20 67 6f 74 6f 20 70 61 67 TE_OK ) goto pag
352e0 65 72 5f 61 63 71 75 69 72 65 5f 65 72 72 3b 0a er_acquire_err;.
352f0 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 61 73 }. as
35300 73 65 72 74 28 20 70 50 67 2d 3e 70 50 61 67 65 sert( pPg->pPage
35310 72 3d 3d 70 50 61 67 65 72 20 29 3b 0a 20 20 20 r==pPager );.
35320 20 20 20 70 50 61 67 65 72 2d 3e 61 53 74 61 74 pPager->aStat
35330 5b 50 41 47 45 52 5f 53 54 41 54 5f 4d 49 53 53 [PAGER_STAT_MISS
35340 5d 2b 2b 3b 0a 20 20 20 20 20 20 72 63 20 3d 20 ]++;. rc =
35350 72 65 61 64 44 62 50 61 67 65 28 70 50 67 2c 20 readDbPage(pPg,
35360 69 46 72 61 6d 65 29 3b 0a 20 20 20 20 20 20 69 iFrame);. i
35370 66 28 20 72 63 21 3d 53 51 4c 49 54 45 5f 4f 4b f( rc!=SQLITE_OK
35380 20 29 7b 0a 20 20 20 20 20 20 20 20 67 6f 74 6f ){. goto
35390 20 70 61 67 65 72 5f 61 63 71 75 69 72 65 5f 65 pager_acquire_e
353a0 72 72 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 rr;. }.
353b0 7d 0a 20 20 20 20 70 61 67 65 72 5f 73 65 74 5f }. pager_set_
353c0 70 61 67 65 68 61 73 68 28 70 50 67 29 3b 0a 20 pagehash(pPg);.
353d0 20 7d 0a 0a 20 20 72 65 74 75 72 6e 20 53 51 4c }.. return SQL
353e0 49 54 45 5f 4f 4b 3b 0a 0a 70 61 67 65 72 5f 61 ITE_OK;..pager_a
353f0 63 71 75 69 72 65 5f 65 72 72 3a 0a 20 20 61 73 cquire_err:. as
35400 73 65 72 74 28 20 72 63 21 3d 53 51 4c 49 54 45 sert( rc!=SQLITE
35410 5f 4f 4b 20 29 3b 0a 20 20 69 66 28 20 70 50 67 _OK );. if( pPg
35420 20 29 7b 0a 20 20 20 20 73 71 6c 69 74 65 33 50 ){. sqlite3P
35430 63 61 63 68 65 44 72 6f 70 28 70 50 67 29 3b 0a cacheDrop(pPg);.
35440 20 20 7d 0a 20 20 70 61 67 65 72 55 6e 6c 6f 63 }. pagerUnloc
35450 6b 49 66 55 6e 75 73 65 64 28 70 50 61 67 65 72 kIfUnused(pPager
35460 29 3b 0a 0a 20 20 2a 70 70 50 61 67 65 20 3d 20 );.. *ppPage =
35470 30 3b 0a 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 0;. return rc;.
35480 7d 0a 0a 2f 2a 0a 2a 2a 20 41 63 71 75 69 72 65 }../*.** Acquire
35490 20 61 20 70 61 67 65 20 69 66 20 69 74 20 69 73 a page if it is
354a0 20 61 6c 72 65 61 64 79 20 69 6e 20 74 68 65 20 already in the
354b0 69 6e 2d 6d 65 6d 6f 72 79 20 63 61 63 68 65 2e in-memory cache.
354c0 20 20 44 6f 0a 2a 2a 20 6e 6f 74 20 72 65 61 64 Do.** not read
354d0 20 74 68 65 20 70 61 67 65 20 66 72 6f 6d 20 64 the page from d
354e0 69 73 6b 2e 20 20 52 65 74 75 72 6e 20 61 20 70 isk. Return a p
354f0 6f 69 6e 74 65 72 20 74 6f 20 74 68 65 20 70 61 ointer to the pa
35500 67 65 2c 0a 2a 2a 20 6f 72 20 30 20 69 66 20 74 ge,.** or 0 if t
35510 68 65 20 70 61 67 65 20 69 73 20 6e 6f 74 20 69 he page is not i
35520 6e 20 63 61 63 68 65 2e 20 0a 2a 2a 0a 2a 2a 20 n cache. .**.**
35530 53 65 65 20 61 6c 73 6f 20 73 71 6c 69 74 65 33 See also sqlite3
35540 50 61 67 65 72 47 65 74 28 29 2e 20 20 54 68 65 PagerGet(). The
35550 20 64 69 66 66 65 72 65 6e 63 65 20 62 65 74 77 difference betw
35560 65 65 6e 20 74 68 69 73 20 72 6f 75 74 69 6e 65 een this routine
35570 0a 2a 2a 20 61 6e 64 20 73 71 6c 69 74 65 33 50 .** and sqlite3P
35580 61 67 65 72 47 65 74 28 29 20 69 73 20 74 68 61 agerGet() is tha
35590 74 20 5f 67 65 74 28 29 20 77 69 6c 6c 20 67 6f t _get() will go
355a0 20 74 6f 20 74 68 65 20 64 69 73 6b 20 61 6e 64 to the disk and
355b0 20 72 65 61 64 0a 2a 2a 20 69 6e 20 74 68 65 20 read.** in the
355c0 70 61 67 65 20 69 66 20 74 68 65 20 70 61 67 65 page if the page
355d0 20 69 73 20 6e 6f 74 20 61 6c 72 65 61 64 79 20 is not already
355e0 69 6e 20 63 61 63 68 65 2e 20 20 54 68 69 73 20 in cache. This
355f0 72 6f 75 74 69 6e 65 0a 2a 2a 20 72 65 74 75 72 routine.** retur
35600 6e 73 20 4e 55 4c 4c 20 69 66 20 74 68 65 20 70 ns NULL if the p
35610 61 67 65 20 69 73 20 6e 6f 74 20 69 6e 20 63 61 age is not in ca
35620 63 68 65 20 6f 72 20 69 66 20 61 20 64 69 73 6b che or if a disk
35630 20 49 2f 4f 20 65 72 72 6f 72 20 0a 2a 2a 20 68 I/O error .** h
35640 61 73 20 65 76 65 72 20 68 61 70 70 65 6e 65 64 as ever happened
35650 2e 0a 2a 2f 0a 44 62 50 61 67 65 20 2a 73 71 6c ..*/.DbPage *sql
35660 69 74 65 33 50 61 67 65 72 4c 6f 6f 6b 75 70 28 ite3PagerLookup(
35670 50 61 67 65 72 20 2a 70 50 61 67 65 72 2c 20 50 Pager *pPager, P
35680 67 6e 6f 20 70 67 6e 6f 29 7b 0a 20 20 73 71 6c gno pgno){. sql
35690 69 74 65 33 5f 70 63 61 63 68 65 5f 70 61 67 65 ite3_pcache_page
356a0 20 2a 70 50 61 67 65 3b 0a 20 20 61 73 73 65 72 *pPage;. asser
356b0 74 28 20 70 50 61 67 65 72 21 3d 30 20 29 3b 0a t( pPager!=0 );.
356c0 20 20 61 73 73 65 72 74 28 20 70 67 6e 6f 21 3d assert( pgno!=
356d0 30 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 70 0 );. assert( p
356e0 50 61 67 65 72 2d 3e 70 50 43 61 63 68 65 21 3d Pager->pPCache!=
356f0 30 20 29 3b 0a 20 20 70 50 61 67 65 20 3d 20 73 0 );. pPage = s
35700 71 6c 69 74 65 33 50 63 61 63 68 65 46 65 74 63 qlite3PcacheFetc
35710 68 28 70 50 61 67 65 72 2d 3e 70 50 43 61 63 68 h(pPager->pPCach
35720 65 2c 20 70 67 6e 6f 2c 20 30 29 3b 0a 20 20 61 e, pgno, 0);. a
35730 73 73 65 72 74 28 20 70 50 61 67 65 3d 3d 30 20 ssert( pPage==0
35740 7c 7c 20 70 50 61 67 65 72 2d 3e 68 61 73 48 65 || pPager->hasHe
35750 6c 64 53 68 61 72 65 64 4c 6f 63 6b 20 29 3b 0a ldSharedLock );.
35760 20 20 69 66 28 20 70 50 61 67 65 3d 3d 30 20 29 if( pPage==0 )
35770 20 72 65 74 75 72 6e 20 30 3b 0a 20 20 72 65 74 return 0;. ret
35780 75 72 6e 20 73 71 6c 69 74 65 33 50 63 61 63 68 urn sqlite3Pcach
35790 65 46 65 74 63 68 46 69 6e 69 73 68 28 70 50 61 eFetchFinish(pPa
357a0 67 65 72 2d 3e 70 50 43 61 63 68 65 2c 20 70 67 ger->pPCache, pg
357b0 6e 6f 2c 20 70 50 61 67 65 29 3b 0a 7d 0a 0a 2f no, pPage);.}../
357c0 2a 0a 2a 2a 20 52 65 6c 65 61 73 65 20 61 20 70 *.** Release a p
357d0 61 67 65 20 72 65 66 65 72 65 6e 63 65 2e 0a 2a age reference..*
357e0 2a 0a 2a 2a 20 49 66 20 74 68 65 20 6e 75 6d 62 *.** If the numb
357f0 65 72 20 6f 66 20 72 65 66 65 72 65 6e 63 65 73 er of references
35800 20 74 6f 20 74 68 65 20 70 61 67 65 20 64 72 6f to the page dro
35810 70 20 74 6f 20 7a 65 72 6f 2c 20 74 68 65 6e 20 p to zero, then
35820 74 68 65 0a 2a 2a 20 70 61 67 65 20 69 73 20 61 the.** page is a
35830 64 64 65 64 20 74 6f 20 74 68 65 20 4c 52 55 20 dded to the LRU
35840 6c 69 73 74 2e 20 20 57 68 65 6e 20 61 6c 6c 20 list. When all
35850 72 65 66 65 72 65 6e 63 65 73 20 74 6f 20 61 6c references to al
35860 6c 20 70 61 67 65 73 0a 2a 2a 20 61 72 65 20 72 l pages.** are r
35870 65 6c 65 61 73 65 64 2c 20 61 20 72 6f 6c 6c 62 eleased, a rollb
35880 61 63 6b 20 6f 63 63 75 72 73 20 61 6e 64 20 74 ack occurs and t
35890 68 65 20 6c 6f 63 6b 20 6f 6e 20 74 68 65 20 64 he lock on the d
358a0 61 74 61 62 61 73 65 20 69 73 0a 2a 2a 20 72 65 atabase is.** re
358b0 6d 6f 76 65 64 2e 0a 2a 2f 0a 76 6f 69 64 20 73 moved..*/.void s
358c0 71 6c 69 74 65 33 50 61 67 65 72 55 6e 72 65 66 qlite3PagerUnref
358d0 4e 6f 74 4e 75 6c 6c 28 44 62 50 61 67 65 20 2a NotNull(DbPage *
358e0 70 50 67 29 7b 0a 20 20 50 61 67 65 72 20 2a 70 pPg){. Pager *p
358f0 50 61 67 65 72 3b 0a 20 20 61 73 73 65 72 74 28 Pager;. assert(
35900 20 70 50 67 21 3d 30 20 29 3b 0a 20 20 70 50 61 pPg!=0 );. pPa
35910 67 65 72 20 3d 20 70 50 67 2d 3e 70 50 61 67 65 ger = pPg->pPage
35920 72 3b 0a 20 20 69 66 28 20 70 50 67 2d 3e 66 6c r;. if( pPg->fl
35930 61 67 73 20 26 20 50 47 48 44 52 5f 4d 4d 41 50 ags & PGHDR_MMAP
35940 20 29 7b 0a 20 20 20 20 70 61 67 65 72 52 65 6c ){. pagerRel
35950 65 61 73 65 4d 61 70 50 61 67 65 28 70 50 67 29 easeMapPage(pPg)
35960 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 73 ;. }else{. s
35970 71 6c 69 74 65 33 50 63 61 63 68 65 52 65 6c 65 qlite3PcacheRele
35980 61 73 65 28 70 50 67 29 3b 0a 20 20 7d 0a 20 20 ase(pPg);. }.
35990 70 61 67 65 72 55 6e 6c 6f 63 6b 49 66 55 6e 75 pagerUnlockIfUnu
359a0 73 65 64 28 70 50 61 67 65 72 29 3b 0a 7d 0a 76 sed(pPager);.}.v
359b0 6f 69 64 20 73 71 6c 69 74 65 33 50 61 67 65 72 oid sqlite3Pager
359c0 55 6e 72 65 66 28 44 62 50 61 67 65 20 2a 70 50 Unref(DbPage *pP
359d0 67 29 7b 0a 20 20 69 66 28 20 70 50 67 20 29 20 g){. if( pPg )
359e0 73 71 6c 69 74 65 33 50 61 67 65 72 55 6e 72 65 sqlite3PagerUnre
359f0 66 4e 6f 74 4e 75 6c 6c 28 70 50 67 29 3b 0a 7d fNotNull(pPg);.}
35a00 0a 0a 2f 2a 0a 2a 2a 20 54 68 69 73 20 66 75 6e ../*.** This fun
35a10 63 74 69 6f 6e 20 69 73 20 63 61 6c 6c 65 64 20 ction is called
35a20 61 74 20 74 68 65 20 73 74 61 72 74 20 6f 66 20 at the start of
35a30 65 76 65 72 79 20 77 72 69 74 65 20 74 72 61 6e every write tran
35a40 73 61 63 74 69 6f 6e 2e 0a 2a 2a 20 54 68 65 72 saction..** Ther
35a50 65 20 6d 75 73 74 20 61 6c 72 65 61 64 79 20 62 e must already b
35a60 65 20 61 20 52 45 53 45 52 56 45 44 20 6f 72 20 e a RESERVED or
35a70 45 58 43 4c 55 53 49 56 45 20 6c 6f 63 6b 20 6f EXCLUSIVE lock o
35a80 6e 20 74 68 65 20 64 61 74 61 62 61 73 65 20 0a n the database .
35a90 2a 2a 20 66 69 6c 65 20 77 68 65 6e 20 74 68 69 ** file when thi
35aa0 73 20 72 6f 75 74 69 6e 65 20 69 73 20 63 61 6c s routine is cal
35ab0 6c 65 64 2e 0a 2a 2a 0a 2a 2a 20 4f 70 65 6e 20 led..**.** Open
35ac0 74 68 65 20 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 the journal file
35ad0 20 66 6f 72 20 70 61 67 65 72 20 70 50 61 67 65 for pager pPage
35ae0 72 20 61 6e 64 20 77 72 69 74 65 20 61 20 6a 6f r and write a jo
35af0 75 72 6e 61 6c 20 68 65 61 64 65 72 0a 2a 2a 20 urnal header.**
35b00 74 6f 20 74 68 65 20 73 74 61 72 74 20 6f 66 20 to the start of
35b10 69 74 2e 20 49 66 20 74 68 65 72 65 20 61 72 65 it. If there are
35b20 20 61 63 74 69 76 65 20 73 61 76 65 70 6f 69 6e active savepoin
35b30 74 73 2c 20 6f 70 65 6e 20 74 68 65 20 73 75 62 ts, open the sub
35b40 2d 6a 6f 75 72 6e 61 6c 0a 2a 2a 20 61 73 20 77 -journal.** as w
35b50 65 6c 6c 2e 20 54 68 69 73 20 66 75 6e 63 74 69 ell. This functi
35b60 6f 6e 20 69 73 20 6f 6e 6c 79 20 75 73 65 64 20 on is only used
35b70 77 68 65 6e 20 74 68 65 20 6a 6f 75 72 6e 61 6c when the journal
35b80 20 66 69 6c 65 20 69 73 20 62 65 69 6e 67 20 0a file is being .
35b90 2a 2a 20 6f 70 65 6e 65 64 20 74 6f 20 77 72 69 ** opened to wri
35ba0 74 65 20 61 20 72 6f 6c 6c 62 61 63 6b 20 6c 6f te a rollback lo
35bb0 67 20 66 6f 72 20 61 20 74 72 61 6e 73 61 63 74 g for a transact
35bc0 69 6f 6e 2e 20 49 74 20 69 73 20 6e 6f 74 20 75 ion. It is not u
35bd0 73 65 64 20 0a 2a 2a 20 77 68 65 6e 20 6f 70 65 sed .** when ope
35be0 6e 69 6e 67 20 61 20 68 6f 74 20 6a 6f 75 72 6e ning a hot journ
35bf0 61 6c 20 66 69 6c 65 20 74 6f 20 72 6f 6c 6c 20 al file to roll
35c00 69 74 20 62 61 63 6b 2e 0a 2a 2a 0a 2a 2a 20 49 it back..**.** I
35c10 66 20 74 68 65 20 6a 6f 75 72 6e 61 6c 20 66 69 f the journal fi
35c20 6c 65 20 69 73 20 61 6c 72 65 61 64 79 20 6f 70 le is already op
35c30 65 6e 20 28 61 73 20 69 74 20 6d 61 79 20 62 65 en (as it may be
35c40 20 69 6e 20 65 78 63 6c 75 73 69 76 65 20 6d 6f in exclusive mo
35c50 64 65 29 2c 0a 2a 2a 20 74 68 65 6e 20 74 68 69 de),.** then thi
35c60 73 20 66 75 6e 63 74 69 6f 6e 20 6a 75 73 74 20 s function just
35c70 77 72 69 74 65 73 20 61 20 6a 6f 75 72 6e 61 6c writes a journal
35c80 20 68 65 61 64 65 72 20 74 6f 20 74 68 65 20 73 header to the s
35c90 74 61 72 74 20 6f 66 20 74 68 65 0a 2a 2a 20 61 tart of the.** a
35ca0 6c 72 65 61 64 79 20 6f 70 65 6e 20 66 69 6c 65 lready open file
35cb0 2e 20 0a 2a 2a 0a 2a 2a 20 57 68 65 74 68 65 72 . .**.** Whether
35cc0 20 6f 72 20 6e 6f 74 20 74 68 65 20 6a 6f 75 72 or not the jour
35cd0 6e 61 6c 20 66 69 6c 65 20 69 73 20 6f 70 65 6e nal file is open
35ce0 65 64 20 62 79 20 74 68 69 73 20 66 75 6e 63 74 ed by this funct
35cf0 69 6f 6e 2c 20 74 68 65 0a 2a 2a 20 50 61 67 65 ion, the.** Page
35d00 72 2e 70 49 6e 4a 6f 75 72 6e 61 6c 20 62 69 74 r.pInJournal bit
35d10 76 65 63 20 73 74 72 75 63 74 75 72 65 20 69 73 vec structure is
35d20 20 61 6c 6c 6f 63 61 74 65 64 2e 0a 2a 2a 0a 2a allocated..**.*
35d30 2a 20 52 65 74 75 72 6e 20 53 51 4c 49 54 45 5f * Return SQLITE_
35d40 4f 4b 20 69 66 20 65 76 65 72 79 74 68 69 6e 67 OK if everything
35d50 20 69 73 20 73 75 63 63 65 73 73 66 75 6c 2e 20 is successful.
35d60 4f 74 68 65 72 77 69 73 65 2c 20 72 65 74 75 72 Otherwise, retur
35d70 6e 20 0a 2a 2a 20 53 51 4c 49 54 45 5f 4e 4f 4d n .** SQLITE_NOM
35d80 45 4d 20 69 66 20 74 68 65 20 61 74 74 65 6d 70 EM if the attemp
35d90 74 20 74 6f 20 61 6c 6c 6f 63 61 74 65 20 50 61 t to allocate Pa
35da0 67 65 72 2e 70 49 6e 4a 6f 75 72 6e 61 6c 20 66 ger.pInJournal f
35db0 61 69 6c 73 2c 20 6f 72 20 0a 2a 2a 20 61 6e 20 ails, or .** an
35dc0 49 4f 20 65 72 72 6f 72 20 63 6f 64 65 20 69 66 IO error code if
35dd0 20 6f 70 65 6e 69 6e 67 20 6f 72 20 77 72 69 74 opening or writ
35de0 69 6e 67 20 74 68 65 20 6a 6f 75 72 6e 61 6c 20 ing the journal
35df0 66 69 6c 65 20 66 61 69 6c 73 2e 0a 2a 2f 0a 73 file fails..*/.s
35e00 74 61 74 69 63 20 69 6e 74 20 70 61 67 65 72 5f tatic int pager_
35e10 6f 70 65 6e 5f 6a 6f 75 72 6e 61 6c 28 50 61 67 open_journal(Pag
35e20 65 72 20 2a 70 50 61 67 65 72 29 7b 0a 20 20 69 er *pPager){. i
35e30 6e 74 20 72 63 20 3d 20 53 51 4c 49 54 45 5f 4f nt rc = SQLITE_O
35e40 4b 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 K;
35e50 20 20 20 20 20 20 20 20 20 20 2f 2a 20 52 65 74 /* Ret
35e60 75 72 6e 20 63 6f 64 65 20 2a 2f 0a 20 20 73 71 urn code */. sq
35e70 6c 69 74 65 33 5f 76 66 73 20 2a 20 63 6f 6e 73 lite3_vfs * cons
35e80 74 20 70 56 66 73 20 3d 20 70 50 61 67 65 72 2d t pVfs = pPager-
35e90 3e 70 56 66 73 3b 20 20 20 2f 2a 20 4c 6f 63 61 >pVfs; /* Loca
35ea0 6c 20 63 61 63 68 65 20 6f 66 20 76 66 73 20 70 l cache of vfs p
35eb0 6f 69 6e 74 65 72 20 2a 2f 0a 0a 20 20 61 73 73 ointer */.. ass
35ec0 65 72 74 28 20 70 50 61 67 65 72 2d 3e 65 53 74 ert( pPager->eSt
35ed0 61 74 65 3d 3d 50 41 47 45 52 5f 57 52 49 54 45 ate==PAGER_WRITE
35ee0 52 5f 4c 4f 43 4b 45 44 20 29 3b 0a 20 20 61 73 R_LOCKED );. as
35ef0 73 65 72 74 28 20 61 73 73 65 72 74 5f 70 61 67 sert( assert_pag
35f00 65 72 5f 73 74 61 74 65 28 70 50 61 67 65 72 29 er_state(pPager)
35f10 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 70 50 );. assert( pP
35f20 61 67 65 72 2d 3e 70 49 6e 4a 6f 75 72 6e 61 6c ager->pInJournal
35f30 3d 3d 30 20 29 3b 0a 20 20 0a 20 20 2f 2a 20 49 ==0 );. . /* I
35f40 66 20 61 6c 72 65 61 64 79 20 69 6e 20 74 68 65 f already in the
35f50 20 65 72 72 6f 72 20 73 74 61 74 65 2c 20 74 68 error state, th
35f60 69 73 20 66 75 6e 63 74 69 6f 6e 20 69 73 20 61 is function is a
35f70 20 6e 6f 2d 6f 70 2e 20 20 42 75 74 20 6f 6e 0a no-op. But on.
35f80 20 20 2a 2a 20 74 68 65 20 6f 74 68 65 72 20 68 ** the other h
35f90 61 6e 64 2c 20 74 68 69 73 20 72 6f 75 74 69 6e and, this routin
35fa0 65 20 69 73 20 6e 65 76 65 72 20 63 61 6c 6c 65 e is never calle
35fb0 64 20 69 66 20 77 65 20 61 72 65 20 61 6c 72 65 d if we are alre
35fc0 61 64 79 20 69 6e 0a 20 20 2a 2a 20 61 6e 20 65 ady in. ** an e
35fd0 72 72 6f 72 20 73 74 61 74 65 2e 20 2a 2f 0a 20 rror state. */.
35fe0 20 69 66 28 20 4e 45 56 45 52 28 70 50 61 67 65 if( NEVER(pPage
35ff0 72 2d 3e 65 72 72 43 6f 64 65 29 20 29 20 72 65 r->errCode) ) re
36000 74 75 72 6e 20 70 50 61 67 65 72 2d 3e 65 72 72 turn pPager->err
36010 43 6f 64 65 3b 0a 0a 20 20 69 66 28 20 21 70 61 Code;.. if( !pa
36020 67 65 72 55 73 65 57 61 6c 28 70 50 61 67 65 72 gerUseWal(pPager
36030 29 20 26 26 20 70 50 61 67 65 72 2d 3e 6a 6f 75 ) && pPager->jou
36040 72 6e 61 6c 4d 6f 64 65 21 3d 50 41 47 45 52 5f rnalMode!=PAGER_
36050 4a 4f 55 52 4e 41 4c 4d 4f 44 45 5f 4f 46 46 20 JOURNALMODE_OFF
36060 29 7b 0a 20 20 20 20 70 50 61 67 65 72 2d 3e 70 ){. pPager->p
36070 49 6e 4a 6f 75 72 6e 61 6c 20 3d 20 73 71 6c 69 InJournal = sqli
36080 74 65 33 42 69 74 76 65 63 43 72 65 61 74 65 28 te3BitvecCreate(
36090 70 50 61 67 65 72 2d 3e 64 62 53 69 7a 65 29 3b pPager->dbSize);
360a0 0a 20 20 20 20 69 66 28 20 70 50 61 67 65 72 2d . if( pPager-
360b0 3e 70 49 6e 4a 6f 75 72 6e 61 6c 3d 3d 30 20 29 >pInJournal==0 )
360c0 7b 0a 20 20 20 20 20 20 72 65 74 75 72 6e 20 53 {. return S
360d0 51 4c 49 54 45 5f 4e 4f 4d 45 4d 5f 42 4b 50 54 QLITE_NOMEM_BKPT
360e0 3b 0a 20 20 20 20 7d 0a 20 20 0a 20 20 20 20 2f ;. }. . /
360f0 2a 20 4f 70 65 6e 20 74 68 65 20 6a 6f 75 72 6e * Open the journ
36100 61 6c 20 66 69 6c 65 20 69 66 20 69 74 20 69 73 al file if it is
36110 20 6e 6f 74 20 61 6c 72 65 61 64 79 20 6f 70 65 not already ope
36120 6e 2e 20 2a 2f 0a 20 20 20 20 69 66 28 20 21 69 n. */. if( !i
36130 73 4f 70 65 6e 28 70 50 61 67 65 72 2d 3e 6a 66 sOpen(pPager->jf
36140 64 29 20 29 7b 0a 20 20 20 20 20 20 69 66 28 20 d) ){. if(
36150 70 50 61 67 65 72 2d 3e 6a 6f 75 72 6e 61 6c 4d pPager->journalM
36160 6f 64 65 3d 3d 50 41 47 45 52 5f 4a 4f 55 52 4e ode==PAGER_JOURN
36170 41 4c 4d 4f 44 45 5f 4d 45 4d 4f 52 59 20 29 7b ALMODE_MEMORY ){
36180 0a 20 20 20 20 20 20 20 20 73 71 6c 69 74 65 33 . sqlite3
36190 4d 65 6d 4a 6f 75 72 6e 61 6c 4f 70 65 6e 28 70 MemJournalOpen(p
361a0 50 61 67 65 72 2d 3e 6a 66 64 29 3b 0a 20 20 20 Pager->jfd);.
361b0 20 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 20 20 }else{.
361c0 20 20 69 6e 74 20 66 6c 61 67 73 20 3d 20 53 51 int flags = SQ
361d0 4c 49 54 45 5f 4f 50 45 4e 5f 52 45 41 44 57 52 LITE_OPEN_READWR
361e0 49 54 45 7c 53 51 4c 49 54 45 5f 4f 50 45 4e 5f ITE|SQLITE_OPEN_
361f0 43 52 45 41 54 45 3b 0a 20 20 20 20 20 20 20 20 CREATE;.
36200 69 6e 74 20 6e 53 70 69 6c 6c 3b 0a 0a 20 20 20 int nSpill;..
36210 20 20 20 20 20 69 66 28 20 70 50 61 67 65 72 2d if( pPager-
36220 3e 74 65 6d 70 46 69 6c 65 20 29 7b 0a 20 20 20 >tempFile ){.
36230 20 20 20 20 20 20 20 66 6c 61 67 73 20 7c 3d 20 flags |=
36240 28 53 51 4c 49 54 45 5f 4f 50 45 4e 5f 44 45 4c (SQLITE_OPEN_DEL
36250 45 54 45 4f 4e 43 4c 4f 53 45 7c 53 51 4c 49 54 ETEONCLOSE|SQLIT
36260 45 5f 4f 50 45 4e 5f 54 45 4d 50 5f 4a 4f 55 52 E_OPEN_TEMP_JOUR
36270 4e 41 4c 29 3b 0a 20 20 20 20 20 20 20 20 20 20 NAL);.
36280 6e 53 70 69 6c 6c 20 3d 20 73 71 6c 69 74 65 33 nSpill = sqlite3
36290 43 6f 6e 66 69 67 2e 6e 53 74 6d 74 53 70 69 6c Config.nStmtSpil
362a0 6c 3b 0a 20 20 20 20 20 20 20 20 7d 65 6c 73 65 l;. }else
362b0 7b 0a 20 20 20 20 20 20 20 20 20 20 66 6c 61 67 {. flag
362c0 73 20 7c 3d 20 53 51 4c 49 54 45 5f 4f 50 45 4e s |= SQLITE_OPEN
362d0 5f 4d 41 49 4e 5f 4a 4f 55 52 4e 41 4c 3b 0a 20 _MAIN_JOURNAL;.
362e0 20 20 20 20 20 20 20 20 20 6e 53 70 69 6c 6c 20 nSpill
362f0 3d 20 6a 72 6e 6c 42 75 66 66 65 72 53 69 7a 65 = jrnlBufferSize
36300 28 70 50 61 67 65 72 29 3b 0a 20 20 20 20 20 20 (pPager);.
36310 20 20 7d 0a 20 20 20 20 20 20 20 20 20 20 0a 20 }. .
36320 20 20 20 20 20 20 20 2f 2a 20 56 65 72 69 66 79 /* Verify
36330 20 74 68 61 74 20 74 68 65 20 64 61 74 61 62 61 that the databa
36340 73 65 20 73 74 69 6c 6c 20 68 61 73 20 74 68 65 se still has the
36350 20 73 61 6d 65 20 6e 61 6d 65 20 61 73 20 69 74 same name as it
36360 20 64 69 64 20 77 68 65 6e 0a 20 20 20 20 20 20 did when.
36370 20 20 2a 2a 20 69 74 20 77 61 73 20 6f 72 69 67 ** it was orig
36380 69 6e 61 6c 6c 79 20 6f 70 65 6e 65 64 2e 20 2a inally opened. *
36390 2f 0a 20 20 20 20 20 20 20 20 72 63 20 3d 20 64 /. rc = d
363a0 61 74 61 62 61 73 65 49 73 55 6e 6d 6f 76 65 64 atabaseIsUnmoved
363b0 28 70 50 61 67 65 72 29 3b 0a 20 20 20 20 20 20 (pPager);.
363c0 20 20 69 66 28 20 72 63 3d 3d 53 51 4c 49 54 45 if( rc==SQLITE
363d0 5f 4f 4b 20 29 7b 0a 20 20 20 20 20 20 20 20 20 _OK ){.
363e0 20 72 63 20 3d 20 73 71 6c 69 74 65 33 4a 6f 75 rc = sqlite3Jou
363f0 72 6e 61 6c 4f 70 65 6e 20 28 0a 20 20 20 20 20 rnalOpen (.
36400 20 20 20 20 20 20 20 20 20 70 56 66 73 2c 20 70 pVfs, p
36410 50 61 67 65 72 2d 3e 7a 4a 6f 75 72 6e 61 6c 2c Pager->zJournal,
36420 20 70 50 61 67 65 72 2d 3e 6a 66 64 2c 20 66 6c pPager->jfd, fl
36430 61 67 73 2c 20 6e 53 70 69 6c 6c 0a 20 20 20 20 ags, nSpill.
36440 20 20 20 20 20 20 29 3b 0a 20 20 20 20 20 20 20 );.
36450 20 7d 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 20 }. }.
36460 20 61 73 73 65 72 74 28 20 72 63 21 3d 53 51 4c assert( rc!=SQL
36470 49 54 45 5f 4f 4b 20 7c 7c 20 69 73 4f 70 65 6e ITE_OK || isOpen
36480 28 70 50 61 67 65 72 2d 3e 6a 66 64 29 20 29 3b (pPager->jfd) );
36490 0a 20 20 20 20 7d 0a 20 20 0a 20 20 0a 20 20 20 . }. . .
364a0 20 2f 2a 20 57 72 69 74 65 20 74 68 65 20 66 69 /* Write the fi
364b0 72 73 74 20 6a 6f 75 72 6e 61 6c 20 68 65 61 64 rst journal head
364c0 65 72 20 74 6f 20 74 68 65 20 6a 6f 75 72 6e 61 er to the journa
364d0 6c 20 66 69 6c 65 20 61 6e 64 20 6f 70 65 6e 20 l file and open
364e0 0a 20 20 20 20 2a 2a 20 74 68 65 20 73 75 62 2d . ** the sub-
364f0 6a 6f 75 72 6e 61 6c 20 69 66 20 6e 65 63 65 73 journal if neces
36500 73 61 72 79 2e 0a 20 20 20 20 2a 2f 0a 20 20 20 sary.. */.
36510 20 69 66 28 20 72 63 3d 3d 53 51 4c 49 54 45 5f if( rc==SQLITE_
36520 4f 4b 20 29 7b 0a 20 20 20 20 20 20 2f 2a 20 54 OK ){. /* T
36530 4f 44 4f 3a 20 43 68 65 63 6b 20 69 66 20 61 6c ODO: Check if al
36540 6c 20 6f 66 20 74 68 65 73 65 20 61 72 65 20 72 l of these are r
36550 65 61 6c 6c 79 20 72 65 71 75 69 72 65 64 2e 20 eally required.
36560 2a 2f 0a 20 20 20 20 20 20 70 50 61 67 65 72 2d */. pPager-
36570 3e 6e 52 65 63 20 3d 20 30 3b 0a 20 20 20 20 20 >nRec = 0;.
36580 20 70 50 61 67 65 72 2d 3e 6a 6f 75 72 6e 61 6c pPager->journal
36590 4f 66 66 20 3d 20 30 3b 0a 20 20 20 20 20 20 70 Off = 0;. p
365a0 50 61 67 65 72 2d 3e 73 65 74 4d 61 73 74 65 72 Pager->setMaster
365b0 20 3d 20 30 3b 0a 20 20 20 20 20 20 70 50 61 67 = 0;. pPag
365c0 65 72 2d 3e 6a 6f 75 72 6e 61 6c 48 64 72 20 3d er->journalHdr =
365d0 20 30 3b 0a 20 20 20 20 20 20 72 63 20 3d 20 77 0;. rc = w
365e0 72 69 74 65 4a 6f 75 72 6e 61 6c 48 64 72 28 70 riteJournalHdr(p
365f0 50 61 67 65 72 29 3b 0a 20 20 20 20 7d 0a 20 20 Pager);. }.
36600 7d 0a 0a 20 20 69 66 28 20 72 63 21 3d 53 51 4c }.. if( rc!=SQL
36610 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 73 71 ITE_OK ){. sq
36620 6c 69 74 65 33 42 69 74 76 65 63 44 65 73 74 72 lite3BitvecDestr
36630 6f 79 28 70 50 61 67 65 72 2d 3e 70 49 6e 4a 6f oy(pPager->pInJo
36640 75 72 6e 61 6c 29 3b 0a 20 20 20 20 70 50 61 67 urnal);. pPag
36650 65 72 2d 3e 70 49 6e 4a 6f 75 72 6e 61 6c 20 3d er->pInJournal =
36660 20 30 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 20 0;. }else{.
36670 20 61 73 73 65 72 74 28 20 70 50 61 67 65 72 2d assert( pPager-
36680 3e 65 53 74 61 74 65 3d 3d 50 41 47 45 52 5f 57 >eState==PAGER_W
36690 52 49 54 45 52 5f 4c 4f 43 4b 45 44 20 29 3b 0a RITER_LOCKED );.
366a0 20 20 20 20 70 50 61 67 65 72 2d 3e 65 53 74 61 pPager->eSta
366b0 74 65 20 3d 20 50 41 47 45 52 5f 57 52 49 54 45 te = PAGER_WRITE
366c0 52 5f 43 41 43 48 45 4d 4f 44 3b 0a 20 20 7d 0a R_CACHEMOD;. }.
366d0 0a 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 7d 0a . return rc;.}.
366e0 0a 2f 2a 0a 2a 2a 20 42 65 67 69 6e 20 61 20 77 ./*.** Begin a w
366f0 72 69 74 65 2d 74 72 61 6e 73 61 63 74 69 6f 6e rite-transaction
36700 20 6f 6e 20 74 68 65 20 73 70 65 63 69 66 69 65 on the specifie
36710 64 20 70 61 67 65 72 20 6f 62 6a 65 63 74 2e 20 d pager object.
36720 49 66 20 61 20 0a 2a 2a 20 77 72 69 74 65 2d 74 If a .** write-t
36730 72 61 6e 73 61 63 74 69 6f 6e 20 68 61 73 20 61 ransaction has a
36740 6c 72 65 61 64 79 20 62 65 65 6e 20 6f 70 65 6e lready been open
36750 65 64 2c 20 74 68 69 73 20 66 75 6e 63 74 69 6f ed, this functio
36760 6e 20 69 73 20 61 20 6e 6f 2d 6f 70 2e 0a 2a 2a n is a no-op..**
36770 0a 2a 2a 20 49 66 20 74 68 65 20 65 78 46 6c 61 .** If the exFla
36780 67 20 61 72 67 75 6d 65 6e 74 20 69 73 20 66 61 g argument is fa
36790 6c 73 65 2c 20 74 68 65 6e 20 61 63 71 75 69 72 lse, then acquir
367a0 65 20 61 74 20 6c 65 61 73 74 20 61 20 52 45 53 e at least a RES
367b0 45 52 56 45 44 0a 2a 2a 20 6c 6f 63 6b 20 6f 6e ERVED.** lock on
367c0 20 74 68 65 20 64 61 74 61 62 61 73 65 20 66 69 the database fi
367d0 6c 65 2e 20 49 66 20 65 78 46 6c 61 67 20 69 73 le. If exFlag is
367e0 20 74 72 75 65 2c 20 74 68 65 6e 20 61 63 71 75 true, then acqu
367f0 69 72 65 20 61 74 20 6c 65 61 73 74 0a 2a 2a 20 ire at least.**
36800 61 6e 20 45 58 43 4c 55 53 49 56 45 20 6c 6f 63 an EXCLUSIVE loc
36810 6b 2e 20 49 66 20 73 75 63 68 20 61 20 6c 6f 63 k. If such a loc
36820 6b 20 69 73 20 61 6c 72 65 61 64 79 20 68 65 6c k is already hel
36830 64 2c 20 6e 6f 20 6c 6f 63 6b 69 6e 67 20 0a 2a d, no locking .*
36840 2a 20 66 75 6e 63 74 69 6f 6e 73 20 6e 65 65 64 * functions need
36850 20 62 65 20 63 61 6c 6c 65 64 2e 0a 2a 2a 0a 2a be called..**.*
36860 2a 20 49 66 20 74 68 65 20 73 75 62 6a 49 6e 4d * If the subjInM
36870 65 6d 6f 72 79 20 61 72 67 75 6d 65 6e 74 20 69 emory argument i
36880 73 20 6e 6f 6e 2d 7a 65 72 6f 2c 20 74 68 65 6e s non-zero, then
36890 20 61 6e 79 20 73 75 62 2d 6a 6f 75 72 6e 61 6c any sub-journal
368a0 20 6f 70 65 6e 65 64 0a 2a 2a 20 77 69 74 68 69 opened.** withi
368b0 6e 20 74 68 69 73 20 74 72 61 6e 73 61 63 74 69 n this transacti
368c0 6f 6e 20 77 69 6c 6c 20 62 65 20 6f 70 65 6e 65 on will be opene
368d0 64 20 61 73 20 61 6e 20 69 6e 2d 6d 65 6d 6f 72 d as an in-memor
368e0 79 20 66 69 6c 65 2e 20 54 68 69 73 0a 2a 2a 20 y file. This.**
368f0 68 61 73 20 6e 6f 20 65 66 66 65 63 74 20 69 66 has no effect if
36900 20 74 68 65 20 73 75 62 2d 6a 6f 75 72 6e 61 6c the sub-journal
36910 20 69 73 20 61 6c 72 65 61 64 79 20 6f 70 65 6e is already open
36920 65 64 20 28 61 73 20 69 74 20 6d 61 79 20 62 65 ed (as it may be
36930 20 77 68 65 6e 0a 2a 2a 20 72 75 6e 6e 69 6e 67 when.** running
36940 20 69 6e 20 65 78 63 6c 75 73 69 76 65 20 6d 6f in exclusive mo
36950 64 65 29 20 6f 72 20 69 66 20 74 68 65 20 74 72 de) or if the tr
36960 61 6e 73 61 63 74 69 6f 6e 20 64 6f 65 73 20 6e ansaction does n
36970 6f 74 20 72 65 71 75 69 72 65 20 61 0a 2a 2a 20 ot require a.**
36980 73 75 62 2d 6a 6f 75 72 6e 61 6c 2e 20 49 66 20 sub-journal. If
36990 74 68 65 20 73 75 62 6a 49 6e 4d 65 6d 6f 72 79 the subjInMemory
369a0 20 61 72 67 75 6d 65 6e 74 20 69 73 20 7a 65 72 argument is zer
369b0 6f 2c 20 74 68 65 6e 20 61 6e 79 20 72 65 71 75 o, then any requ
369c0 69 72 65 64 0a 2a 2a 20 73 75 62 2d 6a 6f 75 72 ired.** sub-jour
369d0 6e 61 6c 20 69 73 20 69 6d 70 6c 65 6d 65 6e 74 nal is implement
369e0 65 64 20 69 6e 2d 6d 65 6d 6f 72 79 20 69 66 20 ed in-memory if
369f0 70 50 61 67 65 72 20 69 73 20 61 6e 20 69 6e 2d pPager is an in-
36a00 6d 65 6d 6f 72 79 20 64 61 74 61 62 61 73 65 2c memory database,
36a10 20 0a 2a 2a 20 6f 72 20 75 73 69 6e 67 20 61 20 .** or using a
36a20 74 65 6d 70 6f 72 61 72 79 20 66 69 6c 65 20 6f temporary file o
36a30 74 68 65 72 77 69 73 65 2e 0a 2a 2f 0a 69 6e 74 therwise..*/.int
36a40 20 73 71 6c 69 74 65 33 50 61 67 65 72 42 65 67 sqlite3PagerBeg
36a50 69 6e 28 50 61 67 65 72 20 2a 70 50 61 67 65 72 in(Pager *pPager
36a60 2c 20 69 6e 74 20 65 78 46 6c 61 67 2c 20 69 6e , int exFlag, in
36a70 74 20 73 75 62 6a 49 6e 4d 65 6d 6f 72 79 29 7b t subjInMemory){
36a80 0a 20 20 69 6e 74 20 72 63 20 3d 20 53 51 4c 49 . int rc = SQLI
36a90 54 45 5f 4f 4b 3b 0a 0a 20 20 69 66 28 20 70 50 TE_OK;.. if( pP
36aa0 61 67 65 72 2d 3e 65 72 72 43 6f 64 65 20 29 20 ager->errCode )
36ab0 72 65 74 75 72 6e 20 70 50 61 67 65 72 2d 3e 65 return pPager->e
36ac0 72 72 43 6f 64 65 3b 0a 20 20 61 73 73 65 72 74 rrCode;. assert
36ad0 28 20 70 50 61 67 65 72 2d 3e 65 53 74 61 74 65 ( pPager->eState
36ae0 3e 3d 50 41 47 45 52 5f 52 45 41 44 45 52 20 26 >=PAGER_READER &
36af0 26 20 70 50 61 67 65 72 2d 3e 65 53 74 61 74 65 & pPager->eState
36b00 3c 50 41 47 45 52 5f 45 52 52 4f 52 20 29 3b 0a <PAGER_ERROR );.
36b10 20 20 70 50 61 67 65 72 2d 3e 73 75 62 6a 49 6e pPager->subjIn
36b20 4d 65 6d 6f 72 79 20 3d 20 28 75 38 29 73 75 62 Memory = (u8)sub
36b30 6a 49 6e 4d 65 6d 6f 72 79 3b 0a 0a 20 20 69 66 jInMemory;.. if
36b40 28 20 41 4c 57 41 59 53 28 70 50 61 67 65 72 2d ( ALWAYS(pPager-
36b50 3e 65 53 74 61 74 65 3d 3d 50 41 47 45 52 5f 52 >eState==PAGER_R
36b60 45 41 44 45 52 29 20 29 7b 0a 20 20 20 20 61 73 EADER) ){. as
36b70 73 65 72 74 28 20 70 50 61 67 65 72 2d 3e 70 49 sert( pPager->pI
36b80 6e 4a 6f 75 72 6e 61 6c 3d 3d 30 20 29 3b 0a 0a nJournal==0 );..
36b90 20 20 20 20 69 66 28 20 70 61 67 65 72 55 73 65 if( pagerUse
36ba0 57 61 6c 28 70 50 61 67 65 72 29 20 29 7b 0a 20 Wal(pPager) ){.
36bb0 20 20 20 20 20 2f 2a 20 49 66 20 74 68 65 20 70 /* If the p
36bc0 61 67 65 72 20 69 73 20 63 6f 6e 66 69 67 75 72 ager is configur
36bd0 65 64 20 74 6f 20 75 73 65 20 6c 6f 63 6b 69 6e ed to use lockin
36be0 67 5f 6d 6f 64 65 3d 65 78 63 6c 75 73 69 76 65 g_mode=exclusive
36bf0 2c 20 61 6e 64 20 61 6e 0a 20 20 20 20 20 20 2a , and an. *
36c00 2a 20 65 78 63 6c 75 73 69 76 65 20 6c 6f 63 6b * exclusive lock
36c10 20 6f 6e 20 74 68 65 20 64 61 74 61 62 61 73 65 on the database
36c20 20 69 73 20 6e 6f 74 20 61 6c 72 65 61 64 79 20 is not already
36c30 68 65 6c 64 2c 20 6f 62 74 61 69 6e 20 69 74 20 held, obtain it
36c40 6e 6f 77 2e 0a 20 20 20 20 20 20 2a 2f 0a 20 20 now.. */.
36c50 20 20 20 20 69 66 28 20 70 50 61 67 65 72 2d 3e if( pPager->
36c60 65 78 63 6c 75 73 69 76 65 4d 6f 64 65 20 26 26 exclusiveMode &&
36c70 20 73 71 6c 69 74 65 33 57 61 6c 45 78 63 6c 75 sqlite3WalExclu
36c80 73 69 76 65 4d 6f 64 65 28 70 50 61 67 65 72 2d siveMode(pPager-
36c90 3e 70 57 61 6c 2c 20 2d 31 29 20 29 7b 0a 20 20 >pWal, -1) ){.
36ca0 20 20 20 20 20 20 72 63 20 3d 20 70 61 67 65 72 rc = pager
36cb0 4c 6f 63 6b 44 62 28 70 50 61 67 65 72 2c 20 45 LockDb(pPager, E
36cc0 58 43 4c 55 53 49 56 45 5f 4c 4f 43 4b 29 3b 0a XCLUSIVE_LOCK);.
36cd0 20 20 20 20 20 20 20 20 69 66 28 20 72 63 21 3d if( rc!=
36ce0 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 SQLITE_OK ){.
36cf0 20 20 20 20 20 20 20 72 65 74 75 72 6e 20 72 63 return rc
36d00 3b 0a 20 20 20 20 20 20 20 20 7d 0a 20 20 20 20 ;. }.
36d10 20 20 20 20 28 76 6f 69 64 29 73 71 6c 69 74 65 (void)sqlite
36d20 33 57 61 6c 45 78 63 6c 75 73 69 76 65 4d 6f 64 3WalExclusiveMod
36d30 65 28 70 50 61 67 65 72 2d 3e 70 57 61 6c 2c 20 e(pPager->pWal,
36d40 31 29 3b 0a 20 20 20 20 20 20 7d 0a 0a 20 20 20 1);. }..
36d50 20 20 20 2f 2a 20 47 72 61 62 20 74 68 65 20 77 /* Grab the w
36d60 72 69 74 65 20 6c 6f 63 6b 20 6f 6e 20 74 68 65 rite lock on the
36d70 20 6c 6f 67 20 66 69 6c 65 2e 20 49 66 20 73 75 log file. If su
36d80 63 63 65 73 73 66 75 6c 2c 20 75 70 67 72 61 64 ccessful, upgrad
36d90 65 20 74 6f 0a 20 20 20 20 20 20 2a 2a 20 50 41 e to. ** PA
36da0 47 45 52 5f 52 45 53 45 52 56 45 44 20 73 74 61 GER_RESERVED sta
36db0 74 65 2e 20 4f 74 68 65 72 77 69 73 65 2c 20 72 te. Otherwise, r
36dc0 65 74 75 72 6e 20 61 6e 20 65 72 72 6f 72 20 63 eturn an error c
36dd0 6f 64 65 20 74 6f 20 74 68 65 20 63 61 6c 6c 65 ode to the calle
36de0 72 2e 0a 20 20 20 20 20 20 2a 2a 20 54 68 65 20 r.. ** The
36df0 62 75 73 79 2d 68 61 6e 64 6c 65 72 20 69 73 20 busy-handler is
36e00 6e 6f 74 20 69 6e 76 6f 6b 65 64 20 69 66 20 61 not invoked if a
36e10 6e 6f 74 68 65 72 20 63 6f 6e 6e 65 63 74 69 6f nother connectio
36e20 6e 20 61 6c 72 65 61 64 79 0a 20 20 20 20 20 20 n already.
36e30 2a 2a 20 68 6f 6c 64 73 20 74 68 65 20 77 72 69 ** holds the wri
36e40 74 65 2d 6c 6f 63 6b 2e 20 49 66 20 70 6f 73 73 te-lock. If poss
36e50 69 62 6c 65 2c 20 74 68 65 20 75 70 70 65 72 20 ible, the upper
36e60 6c 61 79 65 72 20 77 69 6c 6c 20 63 61 6c 6c 20 layer will call
36e70 69 74 2e 0a 20 20 20 20 20 20 2a 2f 0a 20 20 20 it.. */.
36e80 20 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33 57 rc = sqlite3W
36e90 61 6c 42 65 67 69 6e 57 72 69 74 65 54 72 61 6e alBeginWriteTran
36ea0 73 61 63 74 69 6f 6e 28 70 50 61 67 65 72 2d 3e saction(pPager->
36eb0 70 57 61 6c 29 3b 0a 20 20 20 20 7d 65 6c 73 65 pWal);. }else
36ec0 7b 0a 20 20 20 20 20 20 2f 2a 20 4f 62 74 61 69 {. /* Obtai
36ed0 6e 20 61 20 52 45 53 45 52 56 45 44 20 6c 6f 63 n a RESERVED loc
36ee0 6b 20 6f 6e 20 74 68 65 20 64 61 74 61 62 61 73 k on the databas
36ef0 65 20 66 69 6c 65 2e 20 49 66 20 74 68 65 20 65 e file. If the e
36f00 78 46 6c 61 67 20 70 61 72 61 6d 65 74 65 72 0a xFlag parameter.
36f10 20 20 20 20 20 20 2a 2a 20 69 73 20 74 72 75 65 ** is true
36f20 2c 20 74 68 65 6e 20 69 6d 6d 65 64 69 61 74 65 , then immediate
36f30 6c 79 20 75 70 67 72 61 64 65 20 74 68 69 73 20 ly upgrade this
36f40 74 6f 20 61 6e 20 45 58 43 4c 55 53 49 56 45 20 to an EXCLUSIVE
36f50 6c 6f 63 6b 2e 20 54 68 65 0a 20 20 20 20 20 20 lock. The.
36f60 2a 2a 20 62 75 73 79 2d 68 61 6e 64 6c 65 72 20 ** busy-handler
36f70 63 61 6c 6c 62 61 63 6b 20 63 61 6e 20 62 65 20 callback can be
36f80 75 73 65 64 20 77 68 65 6e 20 75 70 67 72 61 64 used when upgrad
36f90 69 6e 67 20 74 6f 20 74 68 65 20 45 58 43 4c 55 ing to the EXCLU
36fa0 53 49 56 45 0a 20 20 20 20 20 20 2a 2a 20 6c 6f SIVE. ** lo
36fb0 63 6b 2c 20 62 75 74 20 6e 6f 74 20 77 68 65 6e ck, but not when
36fc0 20 6f 62 74 61 69 6e 69 6e 67 20 74 68 65 20 52 obtaining the R
36fd0 45 53 45 52 56 45 44 20 6c 6f 63 6b 2e 0a 20 20 ESERVED lock..
36fe0 20 20 20 20 2a 2f 0a 20 20 20 20 20 20 72 63 20 */. rc
36ff0 3d 20 70 61 67 65 72 4c 6f 63 6b 44 62 28 70 50 = pagerLockDb(pP
37000 61 67 65 72 2c 20 52 45 53 45 52 56 45 44 5f 4c ager, RESERVED_L
37010 4f 43 4b 29 3b 0a 20 20 20 20 20 20 69 66 28 20 OCK);. if(
37020 72 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 26 26 rc==SQLITE_OK &&
37030 20 65 78 46 6c 61 67 20 29 7b 0a 20 20 20 20 20 exFlag ){.
37040 20 20 20 72 63 20 3d 20 70 61 67 65 72 5f 77 61 rc = pager_wa
37050 69 74 5f 6f 6e 5f 6c 6f 63 6b 28 70 50 61 67 65 it_on_lock(pPage
37060 72 2c 20 45 58 43 4c 55 53 49 56 45 5f 4c 4f 43 r, EXCLUSIVE_LOC
37070 4b 29 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 K);. }.
37080 7d 0a 0a 20 20 20 20 69 66 28 20 72 63 3d 3d 53 }.. if( rc==S
37090 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 QLITE_OK ){.
370a0 20 20 2f 2a 20 43 68 61 6e 67 65 20 74 6f 20 57 /* Change to W
370b0 52 49 54 45 52 5f 4c 4f 43 4b 45 44 20 73 74 61 RITER_LOCKED sta
370c0 74 65 2e 0a 20 20 20 20 20 20 2a 2a 0a 20 20 20 te.. **.
370d0 20 20 20 2a 2a 20 57 41 4c 20 6d 6f 64 65 20 73 ** WAL mode s
370e0 65 74 73 20 50 61 67 65 72 2e 65 53 74 61 74 65 ets Pager.eState
370f0 20 74 6f 20 50 41 47 45 52 5f 57 52 49 54 45 52 to PAGER_WRITER
37100 5f 4c 4f 43 4b 45 44 20 6f 72 20 43 41 43 48 45 _LOCKED or CACHE
37110 4d 4f 44 0a 20 20 20 20 20 20 2a 2a 20 77 68 65 MOD. ** whe
37120 6e 20 69 74 20 68 61 73 20 61 6e 20 6f 70 65 6e n it has an open
37130 20 74 72 61 6e 73 61 63 74 69 6f 6e 2c 20 62 75 transaction, bu
37140 74 20 6e 65 76 65 72 20 74 6f 20 44 42 4d 4f 44 t never to DBMOD
37150 20 6f 72 20 46 49 4e 49 53 48 45 44 2e 0a 20 20 or FINISHED..
37160 20 20 20 20 2a 2a 20 54 68 69 73 20 69 73 20 62 ** This is b
37170 65 63 61 75 73 65 20 69 6e 20 74 68 6f 73 65 20 ecause in those
37180 73 74 61 74 65 73 20 74 68 65 20 63 6f 64 65 20 states the code
37190 74 6f 20 72 6f 6c 6c 20 62 61 63 6b 20 73 61 76 to roll back sav
371a0 65 70 6f 69 6e 74 20 0a 20 20 20 20 20 20 2a 2a epoint . **
371b0 20 74 72 61 6e 73 61 63 74 69 6f 6e 73 20 6d 61 transactions ma
371c0 79 20 63 6f 70 79 20 64 61 74 61 20 66 72 6f 6d y copy data from
371d0 20 74 68 65 20 73 75 62 2d 6a 6f 75 72 6e 61 6c the sub-journal
371e0 20 69 6e 74 6f 20 74 68 65 20 64 61 74 61 62 61 into the databa
371f0 73 65 20 0a 20 20 20 20 20 20 2a 2a 20 66 69 6c se . ** fil
37200 65 20 61 73 20 77 65 6c 6c 20 61 73 20 69 6e 74 e as well as int
37210 6f 20 74 68 65 20 70 61 67 65 20 63 61 63 68 65 o the page cache
37220 2e 20 57 68 69 63 68 20 77 6f 75 6c 64 20 62 65 . Which would be
37230 20 69 6e 63 6f 72 72 65 63 74 20 69 6e 20 0a 20 incorrect in .
37240 20 20 20 20 20 2a 2a 20 57 41 4c 20 6d 6f 64 65 ** WAL mode
37250 2e 0a 20 20 20 20 20 20 2a 2f 0a 20 20 20 20 20 .. */.
37260 20 70 50 61 67 65 72 2d 3e 65 53 74 61 74 65 20 pPager->eState
37270 3d 20 50 41 47 45 52 5f 57 52 49 54 45 52 5f 4c = PAGER_WRITER_L
37280 4f 43 4b 45 44 3b 0a 20 20 20 20 20 20 70 50 61 OCKED;. pPa
37290 67 65 72 2d 3e 64 62 48 69 6e 74 53 69 7a 65 20 ger->dbHintSize
372a0 3d 20 70 50 61 67 65 72 2d 3e 64 62 53 69 7a 65 = pPager->dbSize
372b0 3b 0a 20 20 20 20 20 20 70 50 61 67 65 72 2d 3e ;. pPager->
372c0 64 62 46 69 6c 65 53 69 7a 65 20 3d 20 70 50 61 dbFileSize = pPa
372d0 67 65 72 2d 3e 64 62 53 69 7a 65 3b 0a 20 20 20 ger->dbSize;.
372e0 20 20 20 70 50 61 67 65 72 2d 3e 64 62 4f 72 69 pPager->dbOri
372f0 67 53 69 7a 65 20 3d 20 70 50 61 67 65 72 2d 3e gSize = pPager->
37300 64 62 53 69 7a 65 3b 0a 20 20 20 20 20 20 70 50 dbSize;. pP
37310 61 67 65 72 2d 3e 6a 6f 75 72 6e 61 6c 4f 66 66 ager->journalOff
37320 20 3d 20 30 3b 0a 20 20 20 20 7d 0a 0a 20 20 20 = 0;. }..
37330 20 61 73 73 65 72 74 28 20 72 63 3d 3d 53 51 4c assert( rc==SQL
37340 49 54 45 5f 4f 4b 20 7c 7c 20 70 50 61 67 65 72 ITE_OK || pPager
37350 2d 3e 65 53 74 61 74 65 3d 3d 50 41 47 45 52 5f ->eState==PAGER_
37360 52 45 41 44 45 52 20 29 3b 0a 20 20 20 20 61 73 READER );. as
37370 73 65 72 74 28 20 72 63 21 3d 53 51 4c 49 54 45 sert( rc!=SQLITE
37380 5f 4f 4b 20 7c 7c 20 70 50 61 67 65 72 2d 3e 65 _OK || pPager->e
37390 53 74 61 74 65 3d 3d 50 41 47 45 52 5f 57 52 49 State==PAGER_WRI
373a0 54 45 52 5f 4c 4f 43 4b 45 44 20 29 3b 0a 20 20 TER_LOCKED );.
373b0 20 20 61 73 73 65 72 74 28 20 61 73 73 65 72 74 assert( assert
373c0 5f 70 61 67 65 72 5f 73 74 61 74 65 28 70 50 61 _pager_state(pPa
373d0 67 65 72 29 20 29 3b 0a 20 20 7d 0a 0a 20 20 50 ger) );. }.. P
373e0 41 47 45 52 54 52 41 43 45 28 28 22 54 52 41 4e AGERTRACE(("TRAN
373f0 53 41 43 54 49 4f 4e 20 25 64 5c 6e 22 2c 20 50 SACTION %d\n", P
37400 41 47 45 52 49 44 28 70 50 61 67 65 72 29 29 29 AGERID(pPager)))
37410 3b 0a 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 7d ;. return rc;.}
37420 0a 0a 2f 2a 0a 2a 2a 20 57 72 69 74 65 20 70 61 ../*.** Write pa
37430 67 65 20 70 50 67 20 6f 6e 74 6f 20 74 68 65 20 ge pPg onto the
37440 65 6e 64 20 6f 66 20 74 68 65 20 72 6f 6c 6c 62 end of the rollb
37450 61 63 6b 20 6a 6f 75 72 6e 61 6c 2e 0a 2a 2f 0a ack journal..*/.
37460 73 74 61 74 69 63 20 53 51 4c 49 54 45 5f 4e 4f static SQLITE_NO
37470 49 4e 4c 49 4e 45 20 69 6e 74 20 70 61 67 65 72 INLINE int pager
37480 41 64 64 50 61 67 65 54 6f 52 6f 6c 6c 62 61 63 AddPageToRollbac
37490 6b 4a 6f 75 72 6e 61 6c 28 50 67 48 64 72 20 2a kJournal(PgHdr *
374a0 70 50 67 29 7b 0a 20 20 50 61 67 65 72 20 2a 70 pPg){. Pager *p
374b0 50 61 67 65 72 20 3d 20 70 50 67 2d 3e 70 50 61 Pager = pPg->pPa
374c0 67 65 72 3b 0a 20 20 69 6e 74 20 72 63 3b 0a 20 ger;. int rc;.
374d0 20 75 33 32 20 63 6b 73 75 6d 3b 0a 20 20 63 68 u32 cksum;. ch
374e0 61 72 20 2a 70 44 61 74 61 32 3b 0a 20 20 69 36 ar *pData2;. i6
374f0 34 20 69 4f 66 66 20 3d 20 70 50 61 67 65 72 2d 4 iOff = pPager-
37500 3e 6a 6f 75 72 6e 61 6c 4f 66 66 3b 0a 0a 20 20 >journalOff;..
37510 2f 2a 20 57 65 20 73 68 6f 75 6c 64 20 6e 65 76 /* We should nev
37520 65 72 20 77 72 69 74 65 20 74 6f 20 74 68 65 20 er write to the
37530 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 20 74 68 65 journal file the
37540 20 70 61 67 65 20 74 68 61 74 0a 20 20 2a 2a 20 page that. **
37550 63 6f 6e 74 61 69 6e 73 20 74 68 65 20 64 61 74 contains the dat
37560 61 62 61 73 65 20 6c 6f 63 6b 73 2e 20 20 54 68 abase locks. Th
37570 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 61 73 73 65 e following asse
37580 72 74 20 76 65 72 69 66 69 65 73 0a 20 20 2a 2a rt verifies. **
37590 20 74 68 61 74 20 77 65 20 64 6f 20 6e 6f 74 2e that we do not.
375a0 20 2a 2f 0a 20 20 61 73 73 65 72 74 28 20 70 50 */. assert( pP
375b0 67 2d 3e 70 67 6e 6f 21 3d 50 41 47 45 52 5f 4d g->pgno!=PAGER_M
375c0 4a 5f 50 47 4e 4f 28 70 50 61 67 65 72 29 20 29 J_PGNO(pPager) )
375d0 3b 0a 0a 20 20 61 73 73 65 72 74 28 20 70 50 61 ;.. assert( pPa
375e0 67 65 72 2d 3e 6a 6f 75 72 6e 61 6c 48 64 72 3c ger->journalHdr<
375f0 3d 70 50 61 67 65 72 2d 3e 6a 6f 75 72 6e 61 6c =pPager->journal
37600 4f 66 66 20 29 3b 0a 20 20 43 4f 44 45 43 32 28 Off );. CODEC2(
37610 70 50 61 67 65 72 2c 20 70 50 67 2d 3e 70 44 61 pPager, pPg->pDa
37620 74 61 2c 20 70 50 67 2d 3e 70 67 6e 6f 2c 20 37 ta, pPg->pgno, 7
37630 2c 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f , return SQLITE_
37640 4e 4f 4d 45 4d 5f 42 4b 50 54 2c 20 70 44 61 74 NOMEM_BKPT, pDat
37650 61 32 29 3b 0a 20 20 63 6b 73 75 6d 20 3d 20 70 a2);. cksum = p
37660 61 67 65 72 5f 63 6b 73 75 6d 28 70 50 61 67 65 ager_cksum(pPage
37670 72 2c 20 28 75 38 2a 29 70 44 61 74 61 32 29 3b r, (u8*)pData2);
37680 0a 0a 20 20 2f 2a 20 45 76 65 6e 20 69 66 20 61 .. /* Even if a
37690 6e 20 49 4f 20 6f 72 20 64 69 73 6b 66 75 6c 6c n IO or diskfull
376a0 20 65 72 72 6f 72 20 6f 63 63 75 72 73 20 77 68 error occurs wh
376b0 69 6c 65 20 6a 6f 75 72 6e 61 6c 6c 69 6e 67 20 ile journalling
376c0 74 68 65 0a 20 20 2a 2a 20 70 61 67 65 20 69 6e the. ** page in
376d0 20 74 68 65 20 62 6c 6f 63 6b 20 61 62 6f 76 65 the block above
376e0 2c 20 73 65 74 20 74 68 65 20 6e 65 65 64 2d 73 , set the need-s
376f0 79 6e 63 20 66 6c 61 67 20 66 6f 72 20 74 68 65 ync flag for the
37700 20 70 61 67 65 2e 0a 20 20 2a 2a 20 4f 74 68 65 page.. ** Othe
37710 72 77 69 73 65 2c 20 77 68 65 6e 20 74 68 65 20 rwise, when the
37720 74 72 61 6e 73 61 63 74 69 6f 6e 20 69 73 20 72 transaction is r
37730 6f 6c 6c 65 64 20 62 61 63 6b 2c 20 74 68 65 20 olled back, the
37740 6c 6f 67 69 63 20 69 6e 0a 20 20 2a 2a 20 70 6c logic in. ** pl
37750 61 79 62 61 63 6b 5f 6f 6e 65 5f 70 61 67 65 28 ayback_one_page(
37760 29 20 77 69 6c 6c 20 74 68 69 6e 6b 20 74 68 61 ) will think tha
37770 74 20 74 68 65 20 70 61 67 65 20 6e 65 65 64 73 t the page needs
37780 20 74 6f 20 62 65 20 72 65 73 74 6f 72 65 64 0a to be restored.
37790 20 20 2a 2a 20 69 6e 20 74 68 65 20 64 61 74 61 ** in the data
377a0 62 61 73 65 20 66 69 6c 65 2e 20 41 6e 64 20 69 base file. And i
377b0 66 20 61 6e 20 49 4f 20 65 72 72 6f 72 20 6f 63 f an IO error oc
377c0 63 75 72 73 20 77 68 69 6c 65 20 64 6f 69 6e 67 curs while doing
377d0 20 73 6f 2c 0a 20 20 2a 2a 20 74 68 65 6e 20 63 so,. ** then c
377e0 6f 72 72 75 70 74 69 6f 6e 20 6d 61 79 20 66 6f orruption may fo
377f0 6c 6c 6f 77 2e 0a 20 20 2a 2f 0a 20 20 70 50 67 llow.. */. pPg
37800 2d 3e 66 6c 61 67 73 20 7c 3d 20 50 47 48 44 52 ->flags |= PGHDR
37810 5f 4e 45 45 44 5f 53 59 4e 43 3b 0a 0a 20 20 72 _NEED_SYNC;.. r
37820 63 20 3d 20 77 72 69 74 65 33 32 62 69 74 73 28 c = write32bits(
37830 70 50 61 67 65 72 2d 3e 6a 66 64 2c 20 69 4f 66 pPager->jfd, iOf
37840 66 2c 20 70 50 67 2d 3e 70 67 6e 6f 29 3b 0a 20 f, pPg->pgno);.
37850 20 69 66 28 20 72 63 21 3d 53 51 4c 49 54 45 5f if( rc!=SQLITE_
37860 4f 4b 20 29 20 72 65 74 75 72 6e 20 72 63 3b 0a OK ) return rc;.
37870 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33 4f 73 rc = sqlite3Os
37880 57 72 69 74 65 28 70 50 61 67 65 72 2d 3e 6a 66 Write(pPager->jf
37890 64 2c 20 70 44 61 74 61 32 2c 20 70 50 61 67 65 d, pData2, pPage
378a0 72 2d 3e 70 61 67 65 53 69 7a 65 2c 20 69 4f 66 r->pageSize, iOf
378b0 66 2b 34 29 3b 0a 20 20 69 66 28 20 72 63 21 3d f+4);. if( rc!=
378c0 53 51 4c 49 54 45 5f 4f 4b 20 29 20 72 65 74 75 SQLITE_OK ) retu
378d0 72 6e 20 72 63 3b 0a 20 20 72 63 20 3d 20 77 72 rn rc;. rc = wr
378e0 69 74 65 33 32 62 69 74 73 28 70 50 61 67 65 72 ite32bits(pPager
378f0 2d 3e 6a 66 64 2c 20 69 4f 66 66 2b 70 50 61 67 ->jfd, iOff+pPag
37900 65 72 2d 3e 70 61 67 65 53 69 7a 65 2b 34 2c 20 er->pageSize+4,
37910 63 6b 73 75 6d 29 3b 0a 20 20 69 66 28 20 72 63 cksum);. if( rc
37920 21 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 20 72 65 !=SQLITE_OK ) re
37930 74 75 72 6e 20 72 63 3b 0a 0a 20 20 49 4f 54 52 turn rc;.. IOTR
37940 41 43 45 28 28 22 4a 4f 55 54 20 25 70 20 25 64 ACE(("JOUT %p %d
37950 20 25 6c 6c 64 20 25 64 5c 6e 22 2c 20 70 50 61 %lld %d\n", pPa
37960 67 65 72 2c 20 70 50 67 2d 3e 70 67 6e 6f 2c 20 ger, pPg->pgno,
37970 0a 20 20 20 20 20 20 20 20 20 20 20 70 50 61 67 . pPag
37980 65 72 2d 3e 6a 6f 75 72 6e 61 6c 4f 66 66 2c 20 er->journalOff,
37990 70 50 61 67 65 72 2d 3e 70 61 67 65 53 69 7a 65 pPager->pageSize
379a0 29 29 3b 0a 20 20 50 41 47 45 52 5f 49 4e 43 52 ));. PAGER_INCR
379b0 28 73 71 6c 69 74 65 33 5f 70 61 67 65 72 5f 77 (sqlite3_pager_w
379c0 72 69 74 65 6a 5f 63 6f 75 6e 74 29 3b 0a 20 20 ritej_count);.
379d0 50 41 47 45 52 54 52 41 43 45 28 28 22 4a 4f 55 PAGERTRACE(("JOU
379e0 52 4e 41 4c 20 25 64 20 70 61 67 65 20 25 64 20 RNAL %d page %d
379f0 6e 65 65 64 53 79 6e 63 3d 25 64 20 68 61 73 68 needSync=%d hash
37a00 28 25 30 38 78 29 5c 6e 22 2c 0a 20 20 20 20 20 (%08x)\n",.
37a10 20 20 50 41 47 45 52 49 44 28 70 50 61 67 65 72 PAGERID(pPager
37a20 29 2c 20 70 50 67 2d 3e 70 67 6e 6f 2c 20 0a 20 ), pPg->pgno, .
37a30 20 20 20 20 20 20 28 28 70 50 67 2d 3e 66 6c 61 ((pPg->fla
37a40 67 73 26 50 47 48 44 52 5f 4e 45 45 44 5f 53 59 gs&PGHDR_NEED_SY
37a50 4e 43 29 3f 31 3a 30 29 2c 20 70 61 67 65 72 5f NC)?1:0), pager_
37a60 70 61 67 65 68 61 73 68 28 70 50 67 29 29 29 3b pagehash(pPg)));
37a70 0a 0a 20 20 70 50 61 67 65 72 2d 3e 6a 6f 75 72 .. pPager->jour
37a80 6e 61 6c 4f 66 66 20 2b 3d 20 38 20 2b 20 70 50 nalOff += 8 + pP
37a90 61 67 65 72 2d 3e 70 61 67 65 53 69 7a 65 3b 0a ager->pageSize;.
37aa0 20 20 70 50 61 67 65 72 2d 3e 6e 52 65 63 2b 2b pPager->nRec++
37ab0 3b 0a 20 20 61 73 73 65 72 74 28 20 70 50 61 67 ;. assert( pPag
37ac0 65 72 2d 3e 70 49 6e 4a 6f 75 72 6e 61 6c 21 3d er->pInJournal!=
37ad0 30 20 29 3b 0a 20 20 72 63 20 3d 20 73 71 6c 69 0 );. rc = sqli
37ae0 74 65 33 42 69 74 76 65 63 53 65 74 28 70 50 61 te3BitvecSet(pPa
37af0 67 65 72 2d 3e 70 49 6e 4a 6f 75 72 6e 61 6c 2c ger->pInJournal,
37b00 20 70 50 67 2d 3e 70 67 6e 6f 29 3b 0a 20 20 74 pPg->pgno);. t
37b10 65 73 74 63 61 73 65 28 20 72 63 3d 3d 53 51 4c estcase( rc==SQL
37b20 49 54 45 5f 4e 4f 4d 45 4d 20 29 3b 0a 20 20 61 ITE_NOMEM );. a
37b30 73 73 65 72 74 28 20 72 63 3d 3d 53 51 4c 49 54 ssert( rc==SQLIT
37b40 45 5f 4f 4b 20 7c 7c 20 72 63 3d 3d 53 51 4c 49 E_OK || rc==SQLI
37b50 54 45 5f 4e 4f 4d 45 4d 20 29 3b 0a 20 20 72 63 TE_NOMEM );. rc
37b60 20 7c 3d 20 61 64 64 54 6f 53 61 76 65 70 6f 69 |= addToSavepoi
37b70 6e 74 42 69 74 76 65 63 73 28 70 50 61 67 65 72 ntBitvecs(pPager
37b80 2c 20 70 50 67 2d 3e 70 67 6e 6f 29 3b 0a 20 20 , pPg->pgno);.
37b90 61 73 73 65 72 74 28 20 72 63 3d 3d 53 51 4c 49 assert( rc==SQLI
37ba0 54 45 5f 4f 4b 20 7c 7c 20 72 63 3d 3d 53 51 4c TE_OK || rc==SQL
37bb0 49 54 45 5f 4e 4f 4d 45 4d 20 29 3b 0a 20 20 72 ITE_NOMEM );. r
37bc0 65 74 75 72 6e 20 72 63 3b 0a 7d 0a 0a 2f 2a 0a eturn rc;.}../*.
37bd0 2a 2a 20 4d 61 72 6b 20 61 20 73 69 6e 67 6c 65 ** Mark a single
37be0 20 64 61 74 61 20 70 61 67 65 20 61 73 20 77 72 data page as wr
37bf0 69 74 65 61 62 6c 65 2e 20 54 68 65 20 70 61 67 iteable. The pag
37c00 65 20 69 73 20 77 72 69 74 74 65 6e 20 69 6e 74 e is written int
37c10 6f 20 74 68 65 20 0a 2a 2a 20 6d 61 69 6e 20 6a o the .** main j
37c20 6f 75 72 6e 61 6c 20 6f 72 20 73 75 62 2d 6a 6f ournal or sub-jo
37c30 75 72 6e 61 6c 20 61 73 20 72 65 71 75 69 72 65 urnal as require
37c40 64 2e 20 49 66 20 74 68 65 20 70 61 67 65 20 69 d. If the page i
37c50 73 20 77 72 69 74 74 65 6e 20 69 6e 74 6f 0a 2a s written into.*
37c60 2a 20 6f 6e 65 20 6f 66 20 74 68 65 20 6a 6f 75 * one of the jou
37c70 72 6e 61 6c 73 2c 20 74 68 65 20 63 6f 72 72 65 rnals, the corre
37c80 73 70 6f 6e 64 69 6e 67 20 62 69 74 20 69 73 20 sponding bit is
37c90 73 65 74 20 69 6e 20 74 68 65 20 0a 2a 2a 20 50 set in the .** P
37ca0 61 67 65 72 2e 70 49 6e 4a 6f 75 72 6e 61 6c 20 ager.pInJournal
37cb0 62 69 74 76 65 63 20 61 6e 64 20 74 68 65 20 50 bitvec and the P
37cc0 61 67 65 72 53 61 76 65 70 6f 69 6e 74 2e 70 49 agerSavepoint.pI
37cd0 6e 53 61 76 65 70 6f 69 6e 74 20 62 69 74 76 65 nSavepoint bitve
37ce0 63 73 0a 2a 2a 20 6f 66 20 61 6e 79 20 6f 70 65 cs.** of any ope
37cf0 6e 20 73 61 76 65 70 6f 69 6e 74 73 20 61 73 20 n savepoints as
37d00 61 70 70 72 6f 70 72 69 61 74 65 2e 0a 2a 2f 0a appropriate..*/.
37d10 73 74 61 74 69 63 20 69 6e 74 20 70 61 67 65 72 static int pager
37d20 5f 77 72 69 74 65 28 50 67 48 64 72 20 2a 70 50 _write(PgHdr *pP
37d30 67 29 7b 0a 20 20 50 61 67 65 72 20 2a 70 50 61 g){. Pager *pPa
37d40 67 65 72 20 3d 20 70 50 67 2d 3e 70 50 61 67 65 ger = pPg->pPage
37d50 72 3b 0a 20 20 69 6e 74 20 72 63 20 3d 20 53 51 r;. int rc = SQ
37d60 4c 49 54 45 5f 4f 4b 3b 0a 0a 20 20 2f 2a 20 54 LITE_OK;.. /* T
37d70 68 69 73 20 72 6f 75 74 69 6e 65 20 69 73 20 6e his routine is n
37d80 6f 74 20 63 61 6c 6c 65 64 20 75 6e 6c 65 73 73 ot called unless
37d90 20 61 20 77 72 69 74 65 2d 74 72 61 6e 73 61 63 a write-transac
37da0 74 69 6f 6e 20 68 61 73 20 61 6c 72 65 61 64 79 tion has already
37db0 20 0a 20 20 2a 2a 20 62 65 65 6e 20 73 74 61 72 . ** been star
37dc0 74 65 64 2e 20 54 68 65 20 6a 6f 75 72 6e 61 6c ted. The journal
37dd0 20 66 69 6c 65 20 6d 61 79 20 6f 72 20 6d 61 79 file may or may
37de0 20 6e 6f 74 20 62 65 20 6f 70 65 6e 20 61 74 20 not be open at
37df0 74 68 69 73 20 70 6f 69 6e 74 2e 0a 20 20 2a 2a this point.. **
37e00 20 49 74 20 69 73 20 6e 65 76 65 72 20 63 61 6c It is never cal
37e10 6c 65 64 20 69 6e 20 74 68 65 20 45 52 52 4f 52 led in the ERROR
37e20 20 73 74 61 74 65 2e 0a 20 20 2a 2f 0a 20 20 61 state.. */. a
37e30 73 73 65 72 74 28 20 70 50 61 67 65 72 2d 3e 65 ssert( pPager->e
37e40 53 74 61 74 65 3d 3d 50 41 47 45 52 5f 57 52 49 State==PAGER_WRI
37e50 54 45 52 5f 4c 4f 43 4b 45 44 0a 20 20 20 20 20 TER_LOCKED.
37e60 20 20 7c 7c 20 70 50 61 67 65 72 2d 3e 65 53 74 || pPager->eSt
37e70 61 74 65 3d 3d 50 41 47 45 52 5f 57 52 49 54 45 ate==PAGER_WRITE
37e80 52 5f 43 41 43 48 45 4d 4f 44 0a 20 20 20 20 20 R_CACHEMOD.
37e90 20 20 7c 7c 20 70 50 61 67 65 72 2d 3e 65 53 74 || pPager->eSt
37ea0 61 74 65 3d 3d 50 41 47 45 52 5f 57 52 49 54 45 ate==PAGER_WRITE
37eb0 52 5f 44 42 4d 4f 44 0a 20 20 29 3b 0a 20 20 61 R_DBMOD. );. a
37ec0 73 73 65 72 74 28 20 61 73 73 65 72 74 5f 70 61 ssert( assert_pa
37ed0 67 65 72 5f 73 74 61 74 65 28 70 50 61 67 65 72 ger_state(pPager
37ee0 29 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 70 ) );. assert( p
37ef0 50 61 67 65 72 2d 3e 65 72 72 43 6f 64 65 3d 3d Pager->errCode==
37f00 30 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 70 0 );. assert( p
37f10 50 61 67 65 72 2d 3e 72 65 61 64 4f 6e 6c 79 3d Pager->readOnly=
37f20 3d 30 20 29 3b 0a 20 20 43 48 45 43 4b 5f 50 41 =0 );. CHECK_PA
37f30 47 45 28 70 50 67 29 3b 0a 0a 20 20 2f 2a 20 54 GE(pPg);.. /* T
37f40 68 65 20 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 20 he journal file
37f50 6e 65 65 64 73 20 74 6f 20 62 65 20 6f 70 65 6e needs to be open
37f60 65 64 2e 20 48 69 67 68 65 72 20 6c 65 76 65 6c ed. Higher level
37f70 20 72 6f 75 74 69 6e 65 73 20 68 61 76 65 20 61 routines have a
37f80 6c 72 65 61 64 79 0a 20 20 2a 2a 20 6f 62 74 61 lready. ** obta
37f90 69 6e 65 64 20 74 68 65 20 6e 65 63 65 73 73 61 ined the necessa
37fa0 72 79 20 6c 6f 63 6b 73 20 74 6f 20 62 65 67 69 ry locks to begi
37fb0 6e 20 74 68 65 20 77 72 69 74 65 2d 74 72 61 6e n the write-tran
37fc0 73 61 63 74 69 6f 6e 2c 20 62 75 74 20 74 68 65 saction, but the
37fd0 0a 20 20 2a 2a 20 72 6f 6c 6c 62 61 63 6b 20 6a . ** rollback j
37fe0 6f 75 72 6e 61 6c 20 6d 69 67 68 74 20 6e 6f 74 ournal might not
37ff0 20 79 65 74 20 62 65 20 6f 70 65 6e 2e 20 4f 70 yet be open. Op
38000 65 6e 20 69 74 20 6e 6f 77 20 69 66 20 74 68 69 en it now if thi
38010 73 20 69 73 20 74 68 65 20 63 61 73 65 2e 0a 20 s is the case..
38020 20 2a 2a 0a 20 20 2a 2a 20 54 68 69 73 20 69 73 **. ** This is
38030 20 64 6f 6e 65 20 62 65 66 6f 72 65 20 63 61 6c done before cal
38040 6c 69 6e 67 20 73 71 6c 69 74 65 33 50 63 61 63 ling sqlite3Pcac
38050 68 65 4d 61 6b 65 44 69 72 74 79 28 29 20 6f 6e heMakeDirty() on
38060 20 74 68 65 20 70 61 67 65 2e 20 0a 20 20 2a 2a the page. . **
38070 20 4f 74 68 65 72 77 69 73 65 2c 20 69 66 20 69 Otherwise, if i
38080 74 20 77 65 72 65 20 64 6f 6e 65 20 61 66 74 65 t were done afte
38090 72 20 63 61 6c 6c 69 6e 67 20 73 71 6c 69 74 65 r calling sqlite
380a0 33 50 63 61 63 68 65 4d 61 6b 65 44 69 72 74 79 3PcacheMakeDirty
380b0 28 29 2c 20 74 68 65 6e 0a 20 20 2a 2a 20 61 6e (), then. ** an
380c0 20 65 72 72 6f 72 20 6d 69 67 68 74 20 6f 63 63 error might occ
380d0 75 72 20 61 6e 64 20 74 68 65 20 70 61 67 65 72 ur and the pager
380e0 20 77 6f 75 6c 64 20 65 6e 64 20 75 70 20 69 6e would end up in
380f0 20 57 52 49 54 45 52 5f 4c 4f 43 4b 45 44 20 73 WRITER_LOCKED s
38100 74 61 74 65 0a 20 20 2a 2a 20 77 69 74 68 20 70 tate. ** with p
38110 61 67 65 73 20 6d 61 72 6b 65 64 20 61 73 20 64 ages marked as d
38120 69 72 74 79 20 69 6e 20 74 68 65 20 63 61 63 68 irty in the cach
38130 65 2e 0a 20 20 2a 2f 0a 20 20 69 66 28 20 70 50 e.. */. if( pP
38140 61 67 65 72 2d 3e 65 53 74 61 74 65 3d 3d 50 41 ager->eState==PA
38150 47 45 52 5f 57 52 49 54 45 52 5f 4c 4f 43 4b 45 GER_WRITER_LOCKE
38160 44 20 29 7b 0a 20 20 20 20 72 63 20 3d 20 70 61 D ){. rc = pa
38170 67 65 72 5f 6f 70 65 6e 5f 6a 6f 75 72 6e 61 6c ger_open_journal
38180 28 70 50 61 67 65 72 29 3b 0a 20 20 20 20 69 66 (pPager);. if
38190 28 20 72 63 21 3d 53 51 4c 49 54 45 5f 4f 4b 20 ( rc!=SQLITE_OK
381a0 29 20 72 65 74 75 72 6e 20 72 63 3b 0a 20 20 7d ) return rc;. }
381b0 0a 20 20 61 73 73 65 72 74 28 20 70 50 61 67 65 . assert( pPage
381c0 72 2d 3e 65 53 74 61 74 65 3e 3d 50 41 47 45 52 r->eState>=PAGER
381d0 5f 57 52 49 54 45 52 5f 43 41 43 48 45 4d 4f 44 _WRITER_CACHEMOD
381e0 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 61 73 );. assert( as
381f0 73 65 72 74 5f 70 61 67 65 72 5f 73 74 61 74 65 sert_pager_state
38200 28 70 50 61 67 65 72 29 20 29 3b 0a 0a 20 20 2f (pPager) );.. /
38210 2a 20 4d 61 72 6b 20 74 68 65 20 70 61 67 65 20 * Mark the page
38220 74 68 61 74 20 69 73 20 61 62 6f 75 74 20 74 6f that is about to
38230 20 62 65 20 6d 6f 64 69 66 69 65 64 20 61 73 20 be modified as
38240 64 69 72 74 79 2e 20 2a 2f 0a 20 20 73 71 6c 69 dirty. */. sqli
38250 74 65 33 50 63 61 63 68 65 4d 61 6b 65 44 69 72 te3PcacheMakeDir
38260 74 79 28 70 50 67 29 3b 0a 0a 20 20 2f 2a 20 49 ty(pPg);.. /* I
38270 66 20 61 20 72 6f 6c 6c 62 61 63 6b 20 6a 6f 75 f a rollback jou
38280 72 6e 61 6c 20 69 73 20 69 6e 20 75 73 65 2c 20 rnal is in use,
38290 74 68 65 6d 20 6d 61 6b 65 20 73 75 72 65 20 74 them make sure t
382a0 68 65 20 70 61 67 65 20 74 68 61 74 20 69 73 20 he page that is
382b0 61 62 6f 75 74 0a 20 20 2a 2a 20 74 6f 20 63 68 about. ** to ch
382c0 61 6e 67 65 20 69 73 20 69 6e 20 74 68 65 20 72 ange is in the r
382d0 6f 6c 6c 62 61 63 6b 20 6a 6f 75 72 6e 61 6c 2c ollback journal,
382e0 20 6f 72 20 69 66 20 74 68 65 20 70 61 67 65 20 or if the page
382f0 69 73 20 61 20 6e 65 77 20 70 61 67 65 20 6f 66 is a new page of
38300 66 0a 20 20 2a 2a 20 74 68 65 6e 20 65 6e 64 20 f. ** then end
38310 6f 66 20 74 68 65 20 66 69 6c 65 2c 20 6d 61 6b of the file, mak
38320 65 20 73 75 72 65 20 69 74 20 69 73 20 6d 61 72 e sure it is mar
38330 6b 65 64 20 61 73 20 50 47 48 44 52 5f 4e 45 45 ked as PGHDR_NEE
38340 44 5f 53 59 4e 43 2e 0a 20 20 2a 2f 0a 20 20 61 D_SYNC.. */. a
38350 73 73 65 72 74 28 20 28 70 50 61 67 65 72 2d 3e ssert( (pPager->
38360 70 49 6e 4a 6f 75 72 6e 61 6c 21 3d 30 29 20 3d pInJournal!=0) =
38370 3d 20 69 73 4f 70 65 6e 28 70 50 61 67 65 72 2d = isOpen(pPager-
38380 3e 6a 66 64 29 20 29 3b 0a 20 20 69 66 28 20 70 >jfd) );. if( p
38390 50 61 67 65 72 2d 3e 70 49 6e 4a 6f 75 72 6e 61 Pager->pInJourna
383a0 6c 21 3d 30 0a 20 20 20 26 26 20 73 71 6c 69 74 l!=0. && sqlit
383b0 65 33 42 69 74 76 65 63 54 65 73 74 4e 6f 74 4e e3BitvecTestNotN
383c0 75 6c 6c 28 70 50 61 67 65 72 2d 3e 70 49 6e 4a ull(pPager->pInJ
383d0 6f 75 72 6e 61 6c 2c 20 70 50 67 2d 3e 70 67 6e ournal, pPg->pgn
383e0 6f 29 3d 3d 30 0a 20 20 29 7b 0a 20 20 20 20 61 o)==0. ){. a
383f0 73 73 65 72 74 28 20 70 61 67 65 72 55 73 65 57 ssert( pagerUseW
38400 61 6c 28 70 50 61 67 65 72 29 3d 3d 30 20 29 3b al(pPager)==0 );
38410 0a 20 20 20 20 69 66 28 20 70 50 67 2d 3e 70 67 . if( pPg->pg
38420 6e 6f 3c 3d 70 50 61 67 65 72 2d 3e 64 62 4f 72 no<=pPager->dbOr
38430 69 67 53 69 7a 65 20 29 7b 0a 20 20 20 20 20 20 igSize ){.
38440 72 63 20 3d 20 70 61 67 65 72 41 64 64 50 61 67 rc = pagerAddPag
38450 65 54 6f 52 6f 6c 6c 62 61 63 6b 4a 6f 75 72 6e eToRollbackJourn
38460 61 6c 28 70 50 67 29 3b 0a 20 20 20 20 20 20 69 al(pPg);. i
38470 66 28 20 72 63 21 3d 53 51 4c 49 54 45 5f 4f 4b f( rc!=SQLITE_OK
38480 20 29 7b 0a 20 20 20 20 20 20 20 20 72 65 74 75 ){. retu
38490 72 6e 20 72 63 3b 0a 20 20 20 20 20 20 7d 0a 20 rn rc;. }.
384a0 20 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 20 20 }else{.
384b0 69 66 28 20 70 50 61 67 65 72 2d 3e 65 53 74 61 if( pPager->eSta
384c0 74 65 21 3d 50 41 47 45 52 5f 57 52 49 54 45 52 te!=PAGER_WRITER
384d0 5f 44 42 4d 4f 44 20 29 7b 0a 20 20 20 20 20 20 _DBMOD ){.
384e0 20 20 70 50 67 2d 3e 66 6c 61 67 73 20 7c 3d 20 pPg->flags |=
384f0 50 47 48 44 52 5f 4e 45 45 44 5f 53 59 4e 43 3b PGHDR_NEED_SYNC;
38500 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 50 . }. P
38510 41 47 45 52 54 52 41 43 45 28 28 22 41 50 50 45 AGERTRACE(("APPE
38520 4e 44 20 25 64 20 70 61 67 65 20 25 64 20 6e 65 ND %d page %d ne
38530 65 64 53 79 6e 63 3d 25 64 5c 6e 22 2c 0a 20 20 edSync=%d\n",.
38540 20 20 20 20 20 20 20 20 20 20 20 20 50 41 47 45 PAGE
38550 52 49 44 28 70 50 61 67 65 72 29 2c 20 70 50 67 RID(pPager), pPg
38560 2d 3e 70 67 6e 6f 2c 0a 20 20 20 20 20 20 20 20 ->pgno,.
38570 20 20 20 20 20 28 28 70 50 67 2d 3e 66 6c 61 67 ((pPg->flag
38580 73 26 50 47 48 44 52 5f 4e 45 45 44 5f 53 59 4e s&PGHDR_NEED_SYN
38590 43 29 3f 31 3a 30 29 29 29 3b 0a 20 20 20 20 7d C)?1:0)));. }
385a0 0a 20 20 7d 0a 0a 20 20 2f 2a 20 54 68 65 20 50 . }.. /* The P
385b0 47 48 44 52 5f 44 49 52 54 59 20 62 69 74 20 69 GHDR_DIRTY bit i
385c0 73 20 73 65 74 20 61 62 6f 76 65 20 77 68 65 6e s set above when
385d0 20 74 68 65 20 70 61 67 65 20 77 61 73 20 61 64 the page was ad
385e0 64 65 64 20 74 6f 20 74 68 65 20 64 69 72 74 79 ded to the dirty
385f0 2d 6c 69 73 74 0a 20 20 2a 2a 20 61 6e 64 20 62 -list. ** and b
38600 65 66 6f 72 65 20 77 72 69 74 69 6e 67 20 74 68 efore writing th
38610 65 20 70 61 67 65 20 69 6e 74 6f 20 74 68 65 20 e page into the
38620 72 6f 6c 6c 62 61 63 6b 20 6a 6f 75 72 6e 61 6c rollback journal
38630 2e 20 20 57 61 69 74 20 75 6e 74 69 6c 20 6e 6f . Wait until no
38640 77 2c 0a 20 20 2a 2a 20 61 66 74 65 72 20 74 68 w,. ** after th
38650 65 20 70 61 67 65 20 68 61 73 20 62 65 65 6e 20 e page has been
38660 73 75 63 63 65 73 73 66 75 6c 6c 79 20 6a 6f 75 successfully jou
38670 72 6e 61 6c 6c 65 64 2c 20 62 65 66 6f 72 65 20 rna