/ Hex Artifact Content
Login

Artifact fc0d51b73e74fe7e8aec98c146fa2e714c7a8d52:


0000: 2f 2a 0a 2a 2a 20 43 6f 70 79 72 69 67 68 74 20  /*.** Copyright 
0010: 28 63 29 20 32 30 30 31 20 44 2e 20 52 69 63 68  (c) 2001 D. Rich
0020: 61 72 64 20 48 69 70 70 0a 2a 2a 0a 2a 2a 20 54  ard Hipp.**.** T
0030: 68 69 73 20 70 72 6f 67 72 61 6d 20 69 73 20 66  his program is f
0040: 72 65 65 20 73 6f 66 74 77 61 72 65 3b 20 79 6f  ree software; yo
0050: 75 20 63 61 6e 20 72 65 64 69 73 74 72 69 62 75  u can redistribu
0060: 74 65 20 69 74 20 61 6e 64 2f 6f 72 0a 2a 2a 20  te it and/or.** 
0070: 6d 6f 64 69 66 79 20 69 74 20 75 6e 64 65 72 20  modify it under 
0080: 74 68 65 20 74 65 72 6d 73 20 6f 66 20 74 68 65  the terms of the
0090: 20 47 4e 55 20 47 65 6e 65 72 61 6c 20 50 75 62   GNU General Pub
00a0: 6c 69 63 0a 2a 2a 20 4c 69 63 65 6e 73 65 20 61  lic.** License a
00b0: 73 20 70 75 62 6c 69 73 68 65 64 20 62 79 20 74  s published by t
00c0: 68 65 20 46 72 65 65 20 53 6f 66 74 77 61 72 65  he Free Software
00d0: 20 46 6f 75 6e 64 61 74 69 6f 6e 3b 20 65 69 74   Foundation; eit
00e0: 68 65 72 0a 2a 2a 20 76 65 72 73 69 6f 6e 20 32  her.** version 2
00f0: 20 6f 66 20 74 68 65 20 4c 69 63 65 6e 73 65 2c   of the License,
0100: 20 6f 72 20 28 61 74 20 79 6f 75 72 20 6f 70 74   or (at your opt
0110: 69 6f 6e 29 20 61 6e 79 20 6c 61 74 65 72 20 76  ion) any later v
0120: 65 72 73 69 6f 6e 2e 0a 2a 2a 0a 2a 2a 20 54 68  ersion..**.** Th
0130: 69 73 20 70 72 6f 67 72 61 6d 20 69 73 20 64 69  is program is di
0140: 73 74 72 69 62 75 74 65 64 20 69 6e 20 74 68 65  stributed in the
0150: 20 68 6f 70 65 20 74 68 61 74 20 69 74 20 77 69   hope that it wi
0160: 6c 6c 20 62 65 20 75 73 65 66 75 6c 2c 0a 2a 2a  ll be useful,.**
0170: 20 62 75 74 20 57 49 54 48 4f 55 54 20 41 4e 59   but WITHOUT ANY
0180: 20 57 41 52 52 41 4e 54 59 3b 20 77 69 74 68 6f   WARRANTY; witho
0190: 75 74 20 65 76 65 6e 20 74 68 65 20 69 6d 70 6c  ut even the impl
01a0: 69 65 64 20 77 61 72 72 61 6e 74 79 20 6f 66 0a  ied warranty of.
01b0: 2a 2a 20 4d 45 52 43 48 41 4e 54 41 42 49 4c 49  ** MERCHANTABILI
01c0: 54 59 20 6f 72 20 46 49 54 4e 45 53 53 20 46 4f  TY or FITNESS FO
01d0: 52 20 41 20 50 41 52 54 49 43 55 4c 41 52 20 50  R A PARTICULAR P
01e0: 55 52 50 4f 53 45 2e 20 20 53 65 65 20 74 68 65  URPOSE.  See the
01f0: 20 47 4e 55 0a 2a 2a 20 47 65 6e 65 72 61 6c 20   GNU.** General 
0200: 50 75 62 6c 69 63 20 4c 69 63 65 6e 73 65 20 66  Public License f
0210: 6f 72 20 6d 6f 72 65 20 64 65 74 61 69 6c 73 2e  or more details.
0220: 0a 2a 2a 20 0a 2a 2a 20 59 6f 75 20 73 68 6f 75  .** .** You shou
0230: 6c 64 20 68 61 76 65 20 72 65 63 65 69 76 65 64  ld have received
0240: 20 61 20 63 6f 70 79 20 6f 66 20 74 68 65 20 47   a copy of the G
0250: 4e 55 20 47 65 6e 65 72 61 6c 20 50 75 62 6c 69  NU General Publi
0260: 63 0a 2a 2a 20 4c 69 63 65 6e 73 65 20 61 6c 6f  c.** License alo
0270: 6e 67 20 77 69 74 68 20 74 68 69 73 20 6c 69 62  ng with this lib
0280: 72 61 72 79 3b 20 69 66 20 6e 6f 74 2c 20 77 72  rary; if not, wr
0290: 69 74 65 20 74 6f 20 74 68 65 0a 2a 2a 20 46 72  ite to the.** Fr
02a0: 65 65 20 53 6f 66 74 77 61 72 65 20 46 6f 75 6e  ee Software Foun
02b0: 64 61 74 69 6f 6e 2c 20 49 6e 63 2e 2c 20 35 39  dation, Inc., 59
02c0: 20 54 65 6d 70 6c 65 20 50 6c 61 63 65 20 2d 20   Temple Place - 
02d0: 53 75 69 74 65 20 33 33 30 2c 0a 2a 2a 20 42 6f  Suite 330,.** Bo
02e0: 73 74 6f 6e 2c 20 4d 41 20 20 30 32 31 31 31 2d  ston, MA  02111-
02f0: 31 33 30 37 2c 20 55 53 41 2e 0a 2a 2a 0a 2a 2a  1307, USA..**.**
0300: 20 41 75 74 68 6f 72 20 63 6f 6e 74 61 63 74 20   Author contact 
0310: 69 6e 66 6f 72 6d 61 74 69 6f 6e 3a 0a 2a 2a 20  information:.** 
0320: 20 20 64 72 68 40 68 77 61 63 69 2e 63 6f 6d 0a    drh@hwaci.com.
0330: 2a 2a 20 20 20 68 74 74 70 3a 2f 2f 77 77 77 2e  **   http://www.
0340: 68 77 61 63 69 2e 63 6f 6d 2f 64 72 68 2f 0a 2a  hwaci.com/drh/.*
0350: 2a 0a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  *.**************
0360: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
0370: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
0380: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
0390: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 0a 2a 2a 20 54  ***********.** T
03a0: 68 69 73 20 69 73 20 74 68 65 20 69 6d 70 6c 65  his is the imple
03b0: 6d 65 6e 74 61 74 69 6f 6e 20 6f 66 20 74 68 65  mentation of the
03c0: 20 70 61 67 65 20 63 61 63 68 65 20 73 75 62 73   page cache subs
03d0: 79 73 74 65 6d 2e 0a 2a 2a 20 0a 2a 2a 20 54 68  ystem..** .** Th
03e0: 65 20 70 61 67 65 20 63 61 63 68 65 20 69 73 20  e page cache is 
03f0: 75 73 65 64 20 74 6f 20 61 63 63 65 73 73 20 61  used to access a
0400: 20 64 61 74 61 62 61 73 65 20 66 69 6c 65 2e 20   database file. 
0410: 20 54 68 65 20 70 61 67 65 72 20 6a 6f 75 72 6e   The pager journ
0420: 61 6c 73 0a 2a 2a 20 61 6c 6c 20 77 72 69 74 65  als.** all write
0430: 73 20 69 6e 20 6f 72 64 65 72 20 74 6f 20 73 75  s in order to su
0440: 70 70 6f 72 74 20 72 6f 6c 6c 62 61 63 6b 2e 20  pport rollback. 
0450: 20 4c 6f 63 6b 69 6e 67 20 69 73 20 75 73 65 64   Locking is used
0460: 20 74 6f 20 6c 69 6d 69 74 0a 2a 2a 20 61 63 63   to limit.** acc
0470: 65 73 73 20 74 6f 20 6f 6e 65 20 6f 72 20 6d 6f  ess to one or mo
0480: 72 65 20 72 65 61 64 65 72 20 6f 72 20 74 6f 20  re reader or to 
0490: 6f 6e 65 20 77 72 69 74 65 72 2e 0a 2a 2a 0a 2a  one writer..**.*
04a0: 2a 20 40 28 23 29 20 24 49 64 3a 20 70 61 67 65  * @(#) $Id: page
04b0: 72 2e 63 2c 76 20 31 2e 31 37 20 32 30 30 31 2f  r.c,v 1.17 2001/
04c0: 30 39 2f 31 34 20 31 36 3a 34 32 3a 31 32 20 64  09/14 16:42:12 d
04d0: 72 68 20 45 78 70 20 24 0a 2a 2f 0a 23 69 6e 63  rh Exp $.*/.#inc
04e0: 6c 75 64 65 20 22 73 71 6c 69 74 65 49 6e 74 2e  lude "sqliteInt.
04f0: 68 22 0a 23 69 6e 63 6c 75 64 65 20 22 70 61 67  h".#include "pag
0500: 65 72 2e 68 22 0a 23 69 6e 63 6c 75 64 65 20 3c  er.h".#include <
0510: 66 63 6e 74 6c 2e 68 3e 0a 23 69 6e 63 6c 75 64  fcntl.h>.#includ
0520: 65 20 3c 73 79 73 2f 73 74 61 74 2e 68 3e 0a 23  e <sys/stat.h>.#
0530: 69 6e 63 6c 75 64 65 20 3c 75 6e 69 73 74 64 2e  include <unistd.
0540: 68 3e 0a 23 69 6e 63 6c 75 64 65 20 3c 61 73 73  h>.#include <ass
0550: 65 72 74 2e 68 3e 0a 23 69 6e 63 6c 75 64 65 20  ert.h>.#include 
0560: 3c 73 74 72 69 6e 67 2e 68 3e 0a 0a 2f 2a 0a 2a  <string.h>../*.*
0570: 2a 20 54 68 65 20 70 61 67 65 20 63 61 63 68 65  * The page cache
0580: 20 61 73 20 61 20 77 68 6f 6c 65 20 69 73 20 61   as a whole is a
0590: 6c 77 61 79 73 20 69 6e 20 6f 6e 65 20 6f 66 20  lways in one of 
05a0: 74 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 0a 2a 2a  the following.**
05b0: 20 73 74 61 74 65 73 3a 0a 2a 2a 0a 2a 2a 20 20   states:.**.**  
05c0: 20 53 51 4c 49 54 45 5f 55 4e 4c 4f 43 4b 20 20   SQLITE_UNLOCK  
05d0: 20 20 20 20 20 54 68 65 20 70 61 67 65 20 63 61       The page ca
05e0: 63 68 65 20 69 73 20 6e 6f 74 20 63 75 72 72 65  che is not curre
05f0: 6e 74 6c 79 20 72 65 61 64 69 6e 67 20 6f 72 20  ntly reading or 
0600: 0a 2a 2a 20 20 20 20 20 20 20 20 20 20 20 20 20  .**             
0610: 20 20 20 20 20 20 20 20 20 20 77 72 69 74 69 6e            writin
0620: 67 20 74 68 65 20 64 61 74 61 62 61 73 65 20 66  g the database f
0630: 69 6c 65 2e 20 20 54 68 65 72 65 20 69 73 20 6e  ile.  There is n
0640: 6f 0a 2a 2a 20 20 20 20 20 20 20 20 20 20 20 20  o.**            
0650: 20 20 20 20 20 20 20 20 20 20 20 64 61 74 61 20             data 
0660: 68 65 6c 64 20 69 6e 20 6d 65 6d 6f 72 79 2e 20  held in memory. 
0670: 20 54 68 69 73 20 69 73 20 74 68 65 20 69 6e 69   This is the ini
0680: 74 69 61 6c 0a 2a 2a 20 20 20 20 20 20 20 20 20  tial.**         
0690: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 73 74                st
06a0: 61 74 65 2e 0a 2a 2a 0a 2a 2a 20 20 20 53 51 4c  ate..**.**   SQL
06b0: 49 54 45 5f 52 45 41 44 4c 4f 43 4b 20 20 20 20  ITE_READLOCK    
06c0: 20 54 68 65 20 70 61 67 65 20 63 61 63 68 65 20   The page cache 
06d0: 69 73 20 72 65 61 64 69 6e 67 20 74 68 65 20 64  is reading the d
06e0: 61 74 61 62 61 73 65 2e 0a 2a 2a 20 20 20 20 20  atabase..**     
06f0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
0700: 20 20 57 72 69 74 69 6e 67 20 69 73 20 6e 6f 74    Writing is not
0710: 20 70 65 72 6d 69 74 74 65 64 2e 20 20 54 68 65   permitted.  The
0720: 72 65 20 63 61 6e 20 62 65 0a 2a 2a 20 20 20 20  re can be.**    
0730: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
0740: 20 20 20 6d 75 6c 74 69 70 6c 65 20 72 65 61 64     multiple read
0750: 65 72 73 20 61 63 63 65 73 73 69 6e 67 20 74 68  ers accessing th
0760: 65 20 73 61 6d 65 20 64 61 74 61 62 61 73 65 0a  e same database.
0770: 2a 2a 20 20 20 20 20 20 20 20 20 20 20 20 20 20  **              
0780: 20 20 20 20 20 20 20 20 20 66 69 6c 65 20 61 74           file at
0790: 20 74 68 65 20 73 61 6d 65 20 74 69 6d 65 2e 0a   the same time..
07a0: 2a 2a 0a 2a 2a 20 20 20 53 51 4c 49 54 45 5f 57  **.**   SQLITE_W
07b0: 52 49 54 45 4c 4f 43 4b 20 20 20 20 54 68 65 20  RITELOCK    The 
07c0: 70 61 67 65 20 63 61 63 68 65 20 69 73 20 77 72  page cache is wr
07d0: 69 74 69 6e 67 20 74 68 65 20 64 61 74 61 62 61  iting the databa
07e0: 73 65 2e 0a 2a 2a 20 20 20 20 20 20 20 20 20 20  se..**          
07f0: 20 20 20 20 20 20 20 20 20 20 20 20 20 41 63 63               Acc
0800: 65 73 73 20 69 73 20 65 78 63 6c 75 73 69 76 65  ess is exclusive
0810: 2e 20 20 4e 6f 20 6f 74 68 65 72 20 70 72 6f 63  .  No other proc
0820: 65 73 73 65 73 20 6f 72 0a 2a 2a 20 20 20 20 20  esses or.**     
0830: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
0840: 20 20 74 68 72 65 61 64 73 20 63 61 6e 20 62 65    threads can be
0850: 20 72 65 61 64 69 6e 67 20 6f 72 20 77 72 69 74   reading or writ
0860: 69 6e 67 20 77 68 69 6c 65 20 6f 6e 65 0a 2a 2a  ing while one.**
0870: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
0880: 20 20 20 20 20 20 20 70 72 6f 63 65 73 73 20 69         process i
0890: 73 20 77 72 69 74 69 6e 67 2e 0a 2a 2a 0a 2a 2a  s writing..**.**
08a0: 20 54 68 65 20 70 61 67 65 20 63 61 63 68 65 20   The page cache 
08b0: 63 6f 6d 65 73 20 75 70 20 69 6e 20 53 51 4c 49  comes up in SQLI
08c0: 54 45 5f 55 4e 4c 4f 43 4b 2e 20 20 54 68 65 20  TE_UNLOCK.  The 
08d0: 66 69 72 73 74 20 74 69 6d 65 20 61 0a 2a 2a 20  first time a.** 
08e0: 73 71 6c 69 74 65 5f 70 61 67 65 5f 67 65 74 28  sqlite_page_get(
08f0: 29 20 6f 63 63 75 72 73 2c 20 74 68 65 20 73 74  ) occurs, the st
0900: 61 74 65 20 74 72 61 6e 73 69 74 69 6f 6e 73 20  ate transitions 
0910: 74 6f 20 53 51 4c 49 54 45 5f 52 45 41 44 4c 4f  to SQLITE_READLO
0920: 43 4b 2e 0a 2a 2a 20 41 66 74 65 72 20 61 6c 6c  CK..** After all
0930: 20 70 61 67 65 73 20 68 61 76 65 20 62 65 65 6e   pages have been
0940: 20 72 65 6c 65 61 73 65 64 20 75 73 69 6e 67 20   released using 
0950: 73 71 6c 69 74 65 5f 70 61 67 65 5f 75 6e 72 65  sqlite_page_unre
0960: 66 28 29 2c 0a 2a 2a 20 74 68 65 20 73 74 61 74  f(),.** the stat
0970: 65 20 74 72 61 6e 73 69 74 69 6f 6e 73 20 62 61  e transitions ba
0980: 63 6b 20 74 6f 20 53 51 4c 49 54 45 5f 55 4e 4c  ck to SQLITE_UNL
0990: 4f 43 4b 2e 20 20 54 68 65 20 66 69 72 73 74 20  OCK.  The first 
09a0: 74 69 6d 65 0a 2a 2a 20 74 68 61 74 20 73 71 6c  time.** that sql
09b0: 69 74 65 5f 70 61 67 65 5f 77 72 69 74 65 28 29  ite_page_write()
09c0: 20 69 73 20 63 61 6c 6c 65 64 2c 20 74 68 65 20   is called, the 
09d0: 73 74 61 74 65 20 74 72 61 6e 73 69 74 69 6f 6e  state transition
09e0: 73 20 74 6f 0a 2a 2a 20 53 51 4c 49 54 45 5f 57  s to.** SQLITE_W
09f0: 52 49 54 45 4c 4f 43 4b 2e 20 20 28 4e 6f 74 65  RITELOCK.  (Note
0a00: 20 74 68 61 74 20 73 71 6c 69 74 65 5f 70 61 67   that sqlite_pag
0a10: 65 5f 77 72 69 74 65 28 29 20 63 61 6e 20 6f 6e  e_write() can on
0a20: 6c 79 20 62 65 0a 2a 2a 20 63 61 6c 6c 65 64 20  ly be.** called 
0a30: 6f 6e 20 61 6e 20 6f 75 74 73 74 61 6e 64 69 6e  on an outstandin
0a40: 67 20 70 61 67 65 20 77 68 69 63 68 20 6d 65 61  g page which mea
0a50: 6e 73 20 74 68 61 74 20 74 68 65 20 70 61 67 65  ns that the page
0a60: 72 20 6d 75 73 74 0a 2a 2a 20 62 65 20 69 6e 20  r must.** be in 
0a70: 53 51 4c 49 54 45 5f 52 45 41 44 4c 4f 43 4b 20  SQLITE_READLOCK 
0a80: 62 65 66 6f 72 65 20 69 74 20 74 72 61 6e 73 69  before it transi
0a90: 74 69 6f 6e 73 20 74 6f 20 53 51 4c 49 54 45 5f  tions to SQLITE_
0aa0: 57 52 49 54 45 4c 4f 43 4b 2e 29 0a 2a 2a 20 54  WRITELOCK.).** T
0ab0: 68 65 20 73 71 6c 69 74 65 5f 70 61 67 65 5f 72  he sqlite_page_r
0ac0: 6f 6c 6c 62 61 63 6b 28 29 20 61 6e 64 20 73 71  ollback() and sq
0ad0: 6c 69 74 65 5f 70 61 67 65 5f 63 6f 6d 6d 69 74  lite_page_commit
0ae0: 28 29 20 66 75 6e 63 74 69 6f 6e 73 20 0a 2a 2a  () functions .**
0af0: 20 74 72 61 6e 73 69 74 69 6f 6e 20 74 68 65 20   transition the 
0b00: 73 74 61 74 65 20 66 72 6f 6d 20 53 51 4c 49 54  state from SQLIT
0b10: 45 5f 57 52 49 54 45 4c 4f 43 4b 20 62 61 63 6b  E_WRITELOCK back
0b20: 20 74 6f 20 53 51 4c 49 54 45 5f 52 45 41 44 4c   to SQLITE_READL
0b30: 4f 43 4b 2e 0a 2a 2f 0a 23 64 65 66 69 6e 65 20  OCK..*/.#define 
0b40: 53 51 4c 49 54 45 5f 55 4e 4c 4f 43 4b 20 20 20  SQLITE_UNLOCK   
0b50: 20 20 20 30 0a 23 64 65 66 69 6e 65 20 53 51 4c     0.#define SQL
0b60: 49 54 45 5f 52 45 41 44 4c 4f 43 4b 20 20 20 20  ITE_READLOCK    
0b70: 31 0a 23 64 65 66 69 6e 65 20 53 51 4c 49 54 45  1.#define SQLITE
0b80: 5f 57 52 49 54 45 4c 4f 43 4b 20 20 20 32 0a 0a  _WRITELOCK   2..
0b90: 0a 2f 2a 0a 2a 2a 20 45 61 63 68 20 69 6e 2d 6d  ./*.** Each in-m
0ba0: 65 6d 6f 72 79 20 69 6d 61 67 65 20 6f 66 20 61  emory image of a
0bb0: 20 70 61 67 65 20 62 65 67 69 6e 73 20 77 69 74   page begins wit
0bc0: 68 20 74 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20  h the following 
0bd0: 68 65 61 64 65 72 2e 0a 2a 2a 20 54 68 69 73 20  header..** This 
0be0: 68 65 61 64 65 72 20 69 73 20 6f 6e 6c 79 20 76  header is only v
0bf0: 69 73 69 62 6c 65 20 74 6f 20 74 68 69 73 20 70  isible to this p
0c00: 61 67 65 72 20 6d 6f 64 75 6c 65 2e 20 20 54 68  ager module.  Th
0c10: 65 20 63 6c 69 65 6e 74 0a 2a 2a 20 63 6f 64 65  e client.** code
0c20: 20 74 68 61 74 20 63 61 6c 6c 73 20 70 61 67 65   that calls page
0c30: 72 20 73 65 65 73 20 6f 6e 6c 79 20 74 68 65 20  r sees only the 
0c40: 64 61 74 61 20 74 68 61 74 20 66 6f 6c 6c 6f 77  data that follow
0c50: 73 20 74 68 65 20 68 65 61 64 65 72 2e 0a 2a 2f  s the header..*/
0c60: 0a 74 79 70 65 64 65 66 20 73 74 72 75 63 74 20  .typedef struct 
0c70: 50 67 48 64 72 20 50 67 48 64 72 3b 0a 73 74 72  PgHdr PgHdr;.str
0c80: 75 63 74 20 50 67 48 64 72 20 7b 0a 20 20 50 61  uct PgHdr {.  Pa
0c90: 67 65 72 20 2a 70 50 61 67 65 72 3b 20 20 20 20  ger *pPager;    
0ca0: 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20               /* 
0cb0: 54 68 65 20 70 61 67 65 72 20 74 6f 20 77 68 69  The pager to whi
0cc0: 63 68 20 74 68 69 73 20 70 61 67 65 20 62 65 6c  ch this page bel
0cd0: 6f 6e 67 73 20 2a 2f 0a 20 20 50 67 6e 6f 20 70  ongs */.  Pgno p
0ce0: 67 6e 6f 3b 20 20 20 20 20 20 20 20 20 20 20 20  gno;            
0cf0: 20 20 20 20 20 20 20 20 20 2f 2a 20 54 68 65 20           /* The 
0d00: 70 61 67 65 20 6e 75 6d 62 65 72 20 66 6f 72 20  page number for 
0d10: 74 68 69 73 20 70 61 67 65 20 2a 2f 0a 20 20 50  this page */.  P
0d20: 67 48 64 72 20 2a 70 4e 65 78 74 48 61 73 68 2c  gHdr *pNextHash,
0d30: 20 2a 70 50 72 65 76 48 61 73 68 3b 20 20 2f 2a   *pPrevHash;  /*
0d40: 20 48 61 73 68 20 63 6f 6c 6c 69 73 69 6f 6e 20   Hash collision 
0d50: 63 68 61 69 6e 20 66 6f 72 20 50 67 48 64 72 2e  chain for PgHdr.
0d60: 70 67 6e 6f 20 2a 2f 0a 20 20 69 6e 74 20 6e 52  pgno */.  int nR
0d70: 65 66 3b 20 20 20 20 20 20 20 20 20 20 20 20 20  ef;             
0d80: 20 20 20 20 20 20 20 20 20 2f 2a 20 4e 75 6d 62           /* Numb
0d90: 65 72 20 6f 66 20 75 73 65 72 73 20 6f 66 20 74  er of users of t
0da0: 68 69 73 20 70 61 67 65 20 2a 2f 0a 20 20 50 67  his page */.  Pg
0db0: 48 64 72 20 2a 70 4e 65 78 74 46 72 65 65 2c 20  Hdr *pNextFree, 
0dc0: 2a 70 50 72 65 76 46 72 65 65 3b 20 20 2f 2a 20  *pPrevFree;  /* 
0dd0: 46 72 65 65 6c 69 73 74 20 6f 66 20 70 61 67 65  Freelist of page
0de0: 73 20 77 68 65 72 65 20 6e 52 65 66 3d 3d 30 20  s where nRef==0 
0df0: 2a 2f 0a 20 20 50 67 48 64 72 20 2a 70 4e 65 78  */.  PgHdr *pNex
0e00: 74 41 6c 6c 2c 20 2a 70 50 72 65 76 41 6c 6c 3b  tAll, *pPrevAll;
0e10: 20 20 20 20 2f 2a 20 41 20 6c 69 73 74 20 6f 66      /* A list of
0e20: 20 61 6c 6c 20 70 61 67 65 73 20 2a 2f 0a 20 20   all pages */.  
0e30: 63 68 61 72 20 69 6e 4a 6f 75 72 6e 61 6c 3b 20  char inJournal; 
0e40: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f                 /
0e50: 2a 20 54 52 55 45 20 69 66 20 68 61 73 20 62 65  * TRUE if has be
0e60: 65 6e 20 77 72 69 74 74 65 6e 20 74 6f 20 6a 6f  en written to jo
0e70: 75 72 6e 61 6c 20 2a 2f 0a 20 20 63 68 61 72 20  urnal */.  char 
0e80: 64 69 72 74 79 3b 20 20 20 20 20 20 20 20 20 20  dirty;          
0e90: 20 20 20 20 20 20 20 20 20 20 2f 2a 20 54 52 55            /* TRU
0ea0: 45 20 69 66 20 77 65 20 6e 65 65 64 20 74 6f 20  E if we need to 
0eb0: 77 72 69 74 65 20 62 61 63 6b 20 63 68 61 6e 67  write back chang
0ec0: 65 73 20 2a 2f 0a 20 20 2f 2a 20 53 51 4c 49 54  es */.  /* SQLIT
0ed0: 45 5f 50 41 47 45 5f 53 49 5a 45 20 62 79 74 65  E_PAGE_SIZE byte
0ee0: 73 20 6f 66 20 70 61 67 65 20 64 61 74 61 20 66  s of page data f
0ef0: 6f 6c 6c 6f 77 20 74 68 69 73 20 68 65 61 64 65  ollow this heade
0f00: 72 20 2a 2f 0a 20 20 2f 2a 20 50 61 67 65 72 2e  r */.  /* Pager.
0f10: 6e 45 78 74 72 61 20 62 79 74 65 73 20 6f 66 20  nExtra bytes of 
0f20: 6c 6f 63 61 6c 20 64 61 74 61 20 66 6f 6c 6c 6f  local data follo
0f30: 77 20 74 68 65 20 70 61 67 65 20 64 61 74 61 20  w the page data 
0f40: 2a 2f 0a 7d 3b 0a 0a 2f 2a 0a 2a 2a 20 43 6f 6e  */.};../*.** Con
0f50: 76 65 72 74 20 61 20 70 6f 69 6e 74 65 72 20 74  vert a pointer t
0f60: 6f 20 61 20 50 67 48 64 72 20 69 6e 74 6f 20 61  o a PgHdr into a
0f70: 20 70 6f 69 6e 74 65 72 20 74 6f 20 69 74 73 20   pointer to its 
0f80: 64 61 74 61 0a 2a 2a 20 61 6e 64 20 62 61 63 6b  data.** and back
0f90: 20 61 67 61 69 6e 2e 0a 2a 2f 0a 23 64 65 66 69   again..*/.#defi
0fa0: 6e 65 20 50 47 48 44 52 5f 54 4f 5f 44 41 54 41  ne PGHDR_TO_DATA
0fb0: 28 50 29 20 20 28 28 76 6f 69 64 2a 29 28 26 28  (P)  ((void*)(&(
0fc0: 50 29 5b 31 5d 29 29 0a 23 64 65 66 69 6e 65 20  P)[1])).#define 
0fd0: 44 41 54 41 5f 54 4f 5f 50 47 48 44 52 28 44 29  DATA_TO_PGHDR(D)
0fe0: 20 20 28 26 28 28 50 67 48 64 72 2a 29 28 44 29    (&((PgHdr*)(D)
0ff0: 29 5b 2d 31 5d 29 0a 23 64 65 66 69 6e 65 20 50  )[-1]).#define P
1000: 47 48 44 52 5f 54 4f 5f 45 58 54 52 41 28 50 29  GHDR_TO_EXTRA(P)
1010: 20 28 28 76 6f 69 64 2a 29 26 28 28 63 68 61 72   ((void*)&((char
1020: 2a 29 28 26 28 50 29 5b 31 5d 29 29 5b 53 51 4c  *)(&(P)[1]))[SQL
1030: 49 54 45 5f 50 41 47 45 5f 53 49 5a 45 5d 29 0a  ITE_PAGE_SIZE]).
1040: 0a 2f 2a 0a 2a 2a 20 48 6f 77 20 62 69 67 20 74  ./*.** How big t
1050: 6f 20 6d 61 6b 65 20 74 68 65 20 68 61 73 68 20  o make the hash 
1060: 74 61 62 6c 65 20 75 73 65 64 20 66 6f 72 20 6c  table used for l
1070: 6f 63 61 74 69 6e 67 20 69 6e 2d 6d 65 6d 6f 72  ocating in-memor
1080: 79 20 70 61 67 65 73 0a 2a 2a 20 62 79 20 70 61  y pages.** by pa
1090: 67 65 20 6e 75 6d 62 65 72 2e 20 20 4b 6e 75 74  ge number.  Knut
10a0: 68 20 73 61 79 73 20 74 68 69 73 20 73 68 6f 75  h says this shou
10b0: 6c 64 20 62 65 20 61 20 70 72 69 6d 65 20 6e 75  ld be a prime nu
10c0: 6d 62 65 72 2e 0a 2a 2f 0a 23 64 65 66 69 6e 65  mber..*/.#define
10d0: 20 4e 5f 50 47 5f 48 41 53 48 20 39 30 37 0a 0a   N_PG_HASH 907..
10e0: 2f 2a 0a 2a 2a 20 41 20 6f 70 65 6e 20 70 61 67  /*.** A open pag
10f0: 65 20 63 61 63 68 65 20 69 73 20 61 6e 20 69 6e  e cache is an in
1100: 73 74 61 6e 63 65 20 6f 66 20 74 68 65 20 66 6f  stance of the fo
1110: 6c 6c 6f 77 69 6e 67 20 73 74 72 75 63 74 75 72  llowing structur
1120: 65 2e 0a 2a 2f 0a 73 74 72 75 63 74 20 50 61 67  e..*/.struct Pag
1130: 65 72 20 7b 0a 20 20 63 68 61 72 20 2a 7a 46 69  er {.  char *zFi
1140: 6c 65 6e 61 6d 65 3b 20 20 20 20 20 20 20 20 20  lename;         
1150: 20 20 20 2f 2a 20 4e 61 6d 65 20 6f 66 20 74 68     /* Name of th
1160: 65 20 64 61 74 61 62 61 73 65 20 66 69 6c 65 20  e database file 
1170: 2a 2f 0a 20 20 63 68 61 72 20 2a 7a 4a 6f 75 72  */.  char *zJour
1180: 6e 61 6c 3b 20 20 20 20 20 20 20 20 20 20 20 20  nal;            
1190: 20 2f 2a 20 4e 61 6d 65 20 6f 66 20 74 68 65 20   /* Name of the 
11a0: 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 20 2a 2f 0a  journal file */.
11b0: 20 20 69 6e 74 20 66 64 2c 20 6a 66 64 3b 20 20    int fd, jfd;  
11c0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a                /*
11d0: 20 46 69 6c 65 20 64 65 73 63 72 69 70 74 6f 72   File descriptor
11e0: 73 20 66 6f 72 20 64 61 74 61 62 61 73 65 20 61  s for database a
11f0: 6e 64 20 6a 6f 75 72 6e 61 6c 20 2a 2f 0a 20 20  nd journal */.  
1200: 69 6e 74 20 64 62 53 69 7a 65 3b 20 20 20 20 20  int dbSize;     
1210: 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4e              /* N
1220: 75 6d 62 65 72 20 6f 66 20 70 61 67 65 73 20 69  umber of pages i
1230: 6e 20 74 68 65 20 66 69 6c 65 20 2a 2f 0a 20 20  n the file */.  
1240: 69 6e 74 20 6f 72 69 67 44 62 53 69 7a 65 3b 20  int origDbSize; 
1250: 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 64              /* d
1260: 62 53 69 7a 65 20 62 65 66 6f 72 65 20 74 68 65  bSize before the
1270: 20 63 75 72 72 65 6e 74 20 63 68 61 6e 67 65 20   current change 
1280: 2a 2f 0a 20 20 69 6e 74 20 6e 45 78 74 72 61 3b  */.  int nExtra;
1290: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
12a0: 20 2f 2a 20 41 64 64 20 74 68 69 73 20 6d 61 6e   /* Add this man
12b0: 79 20 62 79 74 65 73 20 74 6f 20 65 61 63 68 20  y bytes to each 
12c0: 69 6e 2d 6d 65 6d 6f 72 79 20 70 61 67 65 20 2a  in-memory page *
12d0: 2f 0a 20 20 76 6f 69 64 20 28 2a 78 44 65 73 74  /.  void (*xDest
12e0: 72 75 63 74 6f 72 29 28 76 6f 69 64 2a 29 3b 20  ructor)(void*); 
12f0: 2f 2a 20 43 61 6c 6c 20 74 68 69 73 20 72 6f 75  /* Call this rou
1300: 74 69 6e 65 20 77 68 65 6e 20 66 72 65 65 69 6e  tine when freein
1310: 67 20 70 61 67 65 73 20 2a 2f 0a 20 20 69 6e 74  g pages */.  int
1320: 20 6e 50 61 67 65 3b 20 20 20 20 20 20 20 20 20   nPage;         
1330: 20 20 20 20 20 20 20 20 20 2f 2a 20 54 6f 74 61           /* Tota
1340: 6c 20 6e 75 6d 62 65 72 20 6f 66 20 69 6e 2d 6d  l number of in-m
1350: 65 6d 6f 72 79 20 70 61 67 65 73 20 2a 2f 0a 20  emory pages */. 
1360: 20 69 6e 74 20 6e 52 65 66 3b 20 20 20 20 20 20   int nRef;      
1370: 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20               /* 
1380: 4e 75 6d 62 65 72 20 6f 66 20 69 6e 2d 6d 65 6d  Number of in-mem
1390: 6f 72 79 20 70 61 67 65 73 20 77 69 74 68 20 50  ory pages with P
13a0: 67 48 64 72 2e 6e 52 65 66 3e 30 20 2a 2f 0a 20  gHdr.nRef>0 */. 
13b0: 20 69 6e 74 20 6d 78 50 61 67 65 3b 20 20 20 20   int mxPage;    
13c0: 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20               /* 
13d0: 4d 61 78 69 6d 75 6d 20 6e 75 6d 62 65 72 20 6f  Maximum number o
13e0: 66 20 70 61 67 65 73 20 74 6f 20 68 6f 6c 64 20  f pages to hold 
13f0: 69 6e 20 63 61 63 68 65 20 2a 2f 0a 20 20 69 6e  in cache */.  in
1400: 74 20 6e 48 69 74 2c 20 6e 4d 69 73 73 2c 20 6e  t nHit, nMiss, n
1410: 4f 76 66 6c 3b 20 20 20 20 20 2f 2a 20 43 61 63  Ovfl;     /* Cac
1420: 68 65 20 68 69 74 73 2c 20 6d 69 73 73 69 6e 67  he hits, missing
1430: 2c 20 61 6e 64 20 4c 52 55 20 6f 76 65 72 66 6c  , and LRU overfl
1440: 6f 77 73 20 2a 2f 0a 20 20 75 6e 73 69 67 6e 65  ows */.  unsigne
1450: 64 20 63 68 61 72 20 73 74 61 74 65 3b 20 20 20  d char state;   
1460: 20 20 20 20 20 2f 2a 20 53 51 4c 49 54 45 5f 55       /* SQLITE_U
1470: 4e 4c 4f 43 4b 2c 20 5f 52 45 41 44 4c 4f 43 4b  NLOCK, _READLOCK
1480: 20 6f 72 20 5f 57 52 49 54 45 4c 4f 43 4b 20 2a   or _WRITELOCK *
1490: 2f 0a 20 20 75 6e 73 69 67 6e 65 64 20 63 68 61  /.  unsigned cha
14a0: 72 20 65 72 72 4d 61 73 6b 3b 20 20 20 20 20 20  r errMask;      
14b0: 2f 2a 20 4f 6e 65 20 6f 66 20 73 65 76 65 72 61  /* One of severa
14c0: 6c 20 6b 69 6e 64 73 20 6f 66 20 65 72 72 6f 72  l kinds of error
14d0: 73 20 2a 2f 0a 20 20 75 6e 73 69 67 6e 65 64 20  s */.  unsigned 
14e0: 63 68 61 72 20 74 65 6d 70 46 69 6c 65 3b 20 20  char tempFile;  
14f0: 20 20 20 2f 2a 20 7a 46 69 6c 65 6e 61 6d 65 20     /* zFilename 
1500: 69 73 20 61 20 74 65 6d 70 6f 72 61 72 79 20 66  is a temporary f
1510: 69 6c 65 20 2a 2f 0a 20 20 75 6e 73 69 67 6e 65  ile */.  unsigne
1520: 64 20 63 68 61 72 20 72 65 61 64 4f 6e 6c 79 3b  d char readOnly;
1530: 20 20 20 20 20 2f 2a 20 54 72 75 65 20 66 6f 72       /* True for
1540: 20 61 20 72 65 61 64 2d 6f 6e 6c 79 20 64 61 74   a read-only dat
1550: 61 62 61 73 65 20 2a 2f 0a 20 20 75 6e 73 69 67  abase */.  unsig
1560: 6e 65 64 20 63 68 61 72 20 2a 61 49 6e 4a 6f 75  ned char *aInJou
1570: 72 6e 61 6c 3b 20 20 2f 2a 20 4f 6e 65 20 62 69  rnal;  /* One bi
1580: 74 20 66 6f 72 20 65 61 63 68 20 70 61 67 65 20  t for each page 
1590: 69 6e 20 74 68 65 20 64 61 74 61 62 61 73 65 20  in the database 
15a0: 66 69 6c 65 20 2a 2f 0a 20 20 50 67 48 64 72 20  file */.  PgHdr 
15b0: 2a 70 46 69 72 73 74 2c 20 2a 70 4c 61 73 74 3b  *pFirst, *pLast;
15c0: 20 20 20 20 20 20 2f 2a 20 4c 69 73 74 20 6f 66        /* List of
15d0: 20 66 72 65 65 20 70 61 67 65 73 20 2a 2f 0a 20   free pages */. 
15e0: 20 50 67 48 64 72 20 2a 70 41 6c 6c 3b 20 20 20   PgHdr *pAll;   
15f0: 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20               /* 
1600: 4c 69 73 74 20 6f 66 20 61 6c 6c 20 70 61 67 65  List of all page
1610: 73 20 2a 2f 0a 20 20 50 67 48 64 72 20 2a 61 48  s */.  PgHdr *aH
1620: 61 73 68 5b 4e 5f 50 47 5f 48 41 53 48 5d 3b 20  ash[N_PG_HASH]; 
1630: 20 20 20 2f 2a 20 48 61 73 68 20 74 61 62 6c 65     /* Hash table
1640: 20 74 6f 20 6d 61 70 20 70 61 67 65 20 6e 75 6d   to map page num
1650: 62 65 72 20 6f 66 20 50 67 48 64 72 20 2a 2f 0a  ber of PgHdr */.
1660: 7d 3b 0a 0a 2f 2a 0a 2a 2a 20 54 68 65 73 65 20  };../*.** These 
1670: 61 72 65 20 62 69 74 73 20 74 68 61 74 20 63 61  are bits that ca
1680: 6e 20 62 65 20 73 65 74 20 69 6e 20 50 61 67 65  n be set in Page
1690: 72 2e 65 72 72 4d 61 73 6b 2e 0a 2a 2f 0a 23 64  r.errMask..*/.#d
16a0: 65 66 69 6e 65 20 50 41 47 45 52 5f 45 52 52 5f  efine PAGER_ERR_
16b0: 46 55 4c 4c 20 20 20 20 20 30 78 30 31 20 20 2f  FULL     0x01  /
16c0: 2a 20 61 20 77 72 69 74 65 28 29 20 66 61 69 6c  * a write() fail
16d0: 65 64 20 2a 2f 0a 23 64 65 66 69 6e 65 20 50 41  ed */.#define PA
16e0: 47 45 52 5f 45 52 52 5f 4d 45 4d 20 20 20 20 20  GER_ERR_MEM     
16f0: 20 30 78 30 32 20 20 2f 2a 20 6d 61 6c 6c 6f 63   0x02  /* malloc
1700: 28 29 20 66 61 69 6c 65 64 20 2a 2f 0a 23 64 65  () failed */.#de
1710: 66 69 6e 65 20 50 41 47 45 52 5f 45 52 52 5f 4c  fine PAGER_ERR_L
1720: 4f 43 4b 20 20 20 20 20 30 78 30 34 20 20 2f 2a  OCK     0x04  /*
1730: 20 65 72 72 6f 72 20 69 6e 20 74 68 65 20 6c 6f   error in the lo
1740: 63 6b 69 6e 67 20 70 72 6f 74 6f 63 6f 6c 20 2a  cking protocol *
1750: 2f 0a 23 64 65 66 69 6e 65 20 50 41 47 45 52 5f  /.#define PAGER_
1760: 45 52 52 5f 43 4f 52 52 55 50 54 20 20 30 78 30  ERR_CORRUPT  0x0
1770: 38 20 20 2f 2a 20 64 61 74 61 62 61 73 65 20 6f  8  /* database o
1780: 72 20 6a 6f 75 72 6e 61 6c 20 63 6f 72 72 75 70  r journal corrup
1790: 74 69 6f 6e 20 2a 2f 0a 0a 2f 2a 0a 2a 2a 20 54  tion */../*.** T
17a0: 68 65 20 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 20  he journal file 
17b0: 63 6f 6e 74 61 69 6e 73 20 70 61 67 65 20 72 65  contains page re
17c0: 63 6f 72 64 73 20 69 6e 20 74 68 65 20 66 6f 6c  cords in the fol
17d0: 6c 6f 77 69 6e 67 0a 2a 2a 20 66 6f 72 6d 61 74  lowing.** format
17e0: 2e 0a 2a 2f 0a 74 79 70 65 64 65 66 20 73 74 72  ..*/.typedef str
17f0: 75 63 74 20 50 61 67 65 52 65 63 6f 72 64 20 50  uct PageRecord P
1800: 61 67 65 52 65 63 6f 72 64 3b 0a 73 74 72 75 63  ageRecord;.struc
1810: 74 20 50 61 67 65 52 65 63 6f 72 64 20 7b 0a 20  t PageRecord {. 
1820: 20 50 67 6e 6f 20 70 67 6e 6f 3b 20 20 20 20 20   Pgno pgno;     
1830: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
1840: 2f 2a 20 54 68 65 20 70 61 67 65 20 6e 75 6d 62  /* The page numb
1850: 65 72 20 2a 2f 0a 20 20 63 68 61 72 20 61 44 61  er */.  char aDa
1860: 74 61 5b 53 51 4c 49 54 45 5f 50 41 47 45 5f 53  ta[SQLITE_PAGE_S
1870: 49 5a 45 5d 3b 20 20 2f 2a 20 4f 72 69 67 69 6e  IZE];  /* Origin
1880: 61 6c 20 64 61 74 61 20 66 6f 72 20 70 61 67 65  al data for page
1890: 20 70 67 6e 6f 20 2a 2f 0a 7d 3b 0a 0a 2f 2a 0a   pgno */.};../*.
18a0: 2a 2a 20 4a 6f 75 72 6e 61 6c 20 66 69 6c 65 73  ** Journal files
18b0: 20 62 65 67 69 6e 20 77 69 74 68 20 74 68 65 20   begin with the 
18c0: 66 6f 6c 6c 6f 77 69 6e 67 20 6d 61 67 69 63 20  following magic 
18d0: 73 74 72 69 6e 67 2e 20 20 54 68 65 20 64 61 74  string.  The dat
18e0: 61 0a 2a 2a 20 77 61 73 20 6f 62 74 61 69 6e 65  a.** was obtaine
18f0: 64 20 66 72 6f 6d 20 2f 64 65 76 2f 72 61 6e 64  d from /dev/rand
1900: 6f 6d 2e 20 20 49 74 20 69 73 20 75 73 65 64 20  om.  It is used 
1910: 6f 6e 6c 79 20 61 73 20 61 20 73 61 6e 69 74 79  only as a sanity
1920: 20 63 68 65 63 6b 2e 0a 2a 2f 0a 73 74 61 74 69   check..*/.stati
1930: 63 20 63 6f 6e 73 74 20 75 6e 73 69 67 6e 65 64  c const unsigned
1940: 20 63 68 61 72 20 61 4a 6f 75 72 6e 61 6c 4d 61   char aJournalMa
1950: 67 69 63 5b 5d 20 3d 20 7b 0a 20 20 30 78 64 39  gic[] = {.  0xd9
1960: 2c 20 30 78 64 35 2c 20 30 78 30 35 2c 20 30 78  , 0xd5, 0x05, 0x
1970: 66 39 2c 20 30 78 32 30 2c 20 30 78 61 31 2c 20  f9, 0x20, 0xa1, 
1980: 30 78 36 33 2c 20 30 78 64 34 2c 0a 7d 3b 0a 0a  0x63, 0xd4,.};..
1990: 2f 2a 0a 2a 2a 20 48 61 73 68 20 61 20 70 61 67  /*.** Hash a pag
19a0: 65 20 6e 75 6d 62 65 72 0a 2a 2f 0a 23 64 65 66  e number.*/.#def
19b0: 69 6e 65 20 70 61 67 65 72 5f 68 61 73 68 28 50  ine pager_hash(P
19c0: 4e 29 20 20 28 28 50 4e 29 25 4e 5f 50 47 5f 48  N)  ((PN)%N_PG_H
19d0: 41 53 48 29 0a 0a 2f 2a 0a 2a 2a 20 45 6e 61 62  ASH)../*.** Enab
19e0: 6c 65 20 72 65 66 65 72 65 6e 63 65 20 63 6f 75  le reference cou
19f0: 6e 74 20 74 72 61 63 6b 69 6e 67 20 68 65 72 65  nt tracking here
1a00: 3a 0a 2a 2f 0a 23 69 66 20 53 51 4c 49 54 45 5f  :.*/.#if SQLITE_
1a10: 54 45 53 54 0a 20 20 69 6e 74 20 70 61 67 65 72  TEST.  int pager
1a20: 5f 72 65 66 69 6e 66 6f 5f 65 6e 61 62 6c 65 20  _refinfo_enable 
1a30: 3d 20 30 3b 0a 20 20 73 74 61 74 69 63 20 76 6f  = 0;.  static vo
1a40: 69 64 20 70 61 67 65 72 5f 72 65 66 69 6e 66 6f  id pager_refinfo
1a50: 28 50 67 48 64 72 20 2a 70 29 7b 0a 20 20 20 20  (PgHdr *p){.    
1a60: 73 74 61 74 69 63 20 69 6e 74 20 63 6e 74 20 3d  static int cnt =
1a70: 20 30 3b 0a 20 20 20 20 69 66 28 20 21 70 61 67   0;.    if( !pag
1a80: 65 72 5f 72 65 66 69 6e 66 6f 5f 65 6e 61 62 6c  er_refinfo_enabl
1a90: 65 20 29 20 72 65 74 75 72 6e 3b 0a 20 20 20 20  e ) return;.    
1aa0: 70 72 69 6e 74 66 28 0a 20 20 20 20 20 20 20 22  printf(.       "
1ab0: 52 45 46 43 4e 54 3a 20 25 34 64 20 61 64 64 72  REFCNT: %4d addr
1ac0: 3d 30 78 25 30 38 78 20 6e 52 65 66 3d 25 64 5c  =0x%08x nRef=%d\
1ad0: 6e 22 2c 0a 20 20 20 20 20 20 20 70 2d 3e 70 67  n",.       p->pg
1ae0: 6e 6f 2c 20 28 69 6e 74 29 50 47 48 44 52 5f 54  no, (int)PGHDR_T
1af0: 4f 5f 44 41 54 41 28 70 29 2c 20 70 2d 3e 6e 52  O_DATA(p), p->nR
1b00: 65 66 0a 20 20 20 20 29 3b 0a 20 20 20 20 63 6e  ef.    );.    cn
1b10: 74 2b 2b 3b 20 20 20 2f 2a 20 53 6f 6d 65 74 68  t++;   /* Someth
1b20: 69 6e 67 20 74 6f 20 73 65 74 20 61 20 62 72 65  ing to set a bre
1b30: 61 6b 70 6f 69 6e 74 20 6f 6e 20 2a 2f 0a 20 20  akpoint on */.  
1b40: 7d 0a 23 20 64 65 66 69 6e 65 20 52 45 46 49 4e  }.# define REFIN
1b50: 46 4f 28 58 29 20 20 70 61 67 65 72 5f 72 65 66  FO(X)  pager_ref
1b60: 69 6e 66 6f 28 58 29 0a 23 65 6c 73 65 0a 23 20  info(X).#else.# 
1b70: 64 65 66 69 6e 65 20 52 45 46 49 4e 46 4f 28 58  define REFINFO(X
1b80: 29 0a 23 65 6e 64 69 66 0a 0a 2f 2a 0a 2a 2a 20  ).#endif../*.** 
1b90: 41 74 74 65 6d 70 74 20 74 6f 20 61 63 71 75 69  Attempt to acqui
1ba0: 72 65 20 61 20 72 65 61 64 20 6c 6f 63 6b 20 28  re a read lock (
1bb0: 69 66 20 77 72 6c 6f 63 6b 3d 3d 30 29 20 6f 72  if wrlock==0) or
1bc0: 20 61 20 77 72 69 74 65 20 6c 6f 63 6b 20 28 69   a write lock (i
1bd0: 66 20 77 72 6c 6f 63 6b 3d 3d 31 29 0a 2a 2a 20  f wrlock==1).** 
1be0: 6f 6e 20 74 68 65 20 64 61 74 61 62 61 73 65 20  on the database 
1bf0: 66 69 6c 65 2e 20 20 52 65 74 75 72 6e 20 30 20  file.  Return 0 
1c00: 6f 6e 20 73 75 63 63 65 73 73 20 61 6e 64 20 6e  on success and n
1c10: 6f 6e 2d 7a 65 72 6f 20 69 66 20 74 68 65 20 6c  on-zero if the l
1c20: 6f 63 6b 20 0a 2a 2a 20 63 6f 75 6c 64 20 6e 6f  ock .** could no
1c30: 74 20 62 65 20 61 63 71 75 69 72 65 64 2e 0a 2a  t be acquired..*
1c40: 2f 0a 73 74 61 74 69 63 20 69 6e 74 20 70 61 67  /.static int pag
1c50: 65 72 5f 6c 6f 63 6b 28 69 6e 74 20 66 64 2c 20  er_lock(int fd, 
1c60: 69 6e 74 20 77 72 6c 6f 63 6b 29 7b 0a 20 20 69  int wrlock){.  i
1c70: 6e 74 20 72 63 3b 0a 20 20 73 74 72 75 63 74 20  nt rc;.  struct 
1c80: 66 6c 6f 63 6b 20 6c 6f 63 6b 3b 0a 20 20 6c 6f  flock lock;.  lo
1c90: 63 6b 2e 6c 5f 74 79 70 65 20 3d 20 77 72 6c 6f  ck.l_type = wrlo
1ca0: 63 6b 20 3f 20 46 5f 57 52 4c 43 4b 20 3a 20 46  ck ? F_WRLCK : F
1cb0: 5f 52 44 4c 43 4b 3b 0a 20 20 6c 6f 63 6b 2e 6c  _RDLCK;.  lock.l
1cc0: 5f 77 68 65 6e 63 65 20 3d 20 53 45 45 4b 5f 53  _whence = SEEK_S
1cd0: 45 54 3b 0a 20 20 6c 6f 63 6b 2e 6c 5f 73 74 61  ET;.  lock.l_sta
1ce0: 72 74 20 3d 20 6c 6f 63 6b 2e 6c 5f 6c 65 6e 20  rt = lock.l_len 
1cf0: 3d 20 30 4c 3b 0a 20 20 72 63 20 3d 20 66 63 6e  = 0L;.  rc = fcn
1d00: 74 6c 28 66 64 2c 20 46 5f 53 45 54 4c 4b 2c 20  tl(fd, F_SETLK, 
1d10: 26 6c 6f 63 6b 29 3b 0a 20 20 72 65 74 75 72 6e  &lock);.  return
1d20: 20 72 63 21 3d 30 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a   rc!=0;.}../*.**
1d30: 20 55 6e 6c 6f 63 6b 20 74 68 65 20 64 61 74 61   Unlock the data
1d40: 62 61 73 65 20 66 69 6c 65 2e 0a 2a 2f 0a 73 74  base file..*/.st
1d50: 61 74 69 63 20 69 6e 74 20 70 61 67 65 72 5f 75  atic int pager_u
1d60: 6e 6c 6f 63 6b 28 66 64 29 7b 0a 20 20 69 6e 74  nlock(fd){.  int
1d70: 20 72 63 3b 0a 20 20 73 74 72 75 63 74 20 66 6c   rc;.  struct fl
1d80: 6f 63 6b 20 6c 6f 63 6b 3b 0a 20 20 6c 6f 63 6b  ock lock;.  lock
1d90: 2e 6c 5f 74 79 70 65 20 3d 20 46 5f 55 4e 4c 43  .l_type = F_UNLC
1da0: 4b 3b 0a 20 20 6c 6f 63 6b 2e 6c 5f 77 68 65 6e  K;.  lock.l_when
1db0: 63 65 20 3d 20 53 45 45 4b 5f 53 45 54 3b 0a 20  ce = SEEK_SET;. 
1dc0: 20 6c 6f 63 6b 2e 6c 5f 73 74 61 72 74 20 3d 20   lock.l_start = 
1dd0: 6c 6f 63 6b 2e 6c 5f 6c 65 6e 20 3d 20 30 4c 3b  lock.l_len = 0L;
1de0: 0a 20 20 72 63 20 3d 20 66 63 6e 74 6c 28 66 64  .  rc = fcntl(fd
1df0: 2c 20 46 5f 53 45 54 4c 4b 2c 20 26 6c 6f 63 6b  , F_SETLK, &lock
1e00: 29 3b 0a 20 20 72 65 74 75 72 6e 20 72 63 21 3d  );.  return rc!=
1e10: 30 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 4d 6f 76 65  0;.}../*.** Move
1e20: 20 74 68 65 20 63 75 72 73 6f 72 20 66 6f 72 20   the cursor for 
1e30: 66 69 6c 65 20 64 65 73 63 72 69 70 74 6f 72 20  file descriptor 
1e40: 66 64 20 74 6f 20 74 68 65 20 70 6f 69 6e 74 20  fd to the point 
1e50: 77 68 65 72 65 74 6f 20 66 72 6f 6d 0a 2a 2a 20  whereto from.** 
1e60: 74 68 65 20 62 65 67 69 6e 6e 69 6e 67 20 6f 66  the beginning of
1e70: 20 74 68 65 20 66 69 6c 65 2e 0a 2a 2f 0a 73 74   the file..*/.st
1e80: 61 74 69 63 20 69 6e 74 20 70 61 67 65 72 5f 73  atic int pager_s
1e90: 65 65 6b 28 69 6e 74 20 66 64 2c 20 6f 66 66 5f  eek(int fd, off_
1ea0: 74 20 77 68 65 72 65 74 6f 29 7b 0a 20 20 2f 2a  t whereto){.  /*
1eb0: 70 72 69 6e 74 66 28 22 53 45 45 4b 20 74 6f 20  printf("SEEK to 
1ec0: 70 61 67 65 20 25 64 5c 6e 22 2c 20 77 68 65 72  page %d\n", wher
1ed0: 65 74 6f 2f 53 51 4c 49 54 45 5f 50 41 47 45 5f  eto/SQLITE_PAGE_
1ee0: 53 49 5a 45 20 2b 20 31 29 3b 2a 2f 0a 20 20 6c  SIZE + 1);*/.  l
1ef0: 73 65 65 6b 28 66 64 2c 20 77 68 65 72 65 74 6f  seek(fd, whereto
1f00: 2c 20 53 45 45 4b 5f 53 45 54 29 3b 0a 20 20 72  , SEEK_SET);.  r
1f10: 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b  eturn SQLITE_OK;
1f20: 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 54 72 75 6e 63 61  .}../*.** Trunca
1f30: 74 65 20 74 68 65 20 67 69 76 65 6e 20 66 69 6c  te the given fil
1f40: 65 20 73 6f 20 74 68 61 74 20 69 74 20 63 6f 6e  e so that it con
1f50: 74 61 69 6e 73 20 65 78 61 63 74 6c 79 20 6d 78  tains exactly mx
1f60: 50 67 20 70 61 67 65 73 0a 2a 2a 20 6f 66 20 64  Pg pages.** of d
1f70: 61 74 61 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 69  ata..*/.static i
1f80: 6e 74 20 70 61 67 65 72 5f 74 72 75 6e 63 61 74  nt pager_truncat
1f90: 65 28 69 6e 74 20 66 64 2c 20 50 67 6e 6f 20 6d  e(int fd, Pgno m
1fa0: 78 50 67 29 7b 0a 20 20 69 6e 74 20 72 63 3b 0a  xPg){.  int rc;.
1fb0: 20 20 72 63 20 3d 20 66 74 72 75 6e 63 61 74 65    rc = ftruncate
1fc0: 28 66 64 2c 20 6d 78 50 67 2a 53 51 4c 49 54 45  (fd, mxPg*SQLITE
1fd0: 5f 50 41 47 45 5f 53 49 5a 45 29 3b 0a 20 20 72  _PAGE_SIZE);.  r
1fe0: 65 74 75 72 6e 20 72 63 21 3d 30 20 3f 20 53 51  eturn rc!=0 ? SQ
1ff0: 4c 49 54 45 5f 49 4f 45 52 52 20 3a 20 53 51 4c  LITE_IOERR : SQL
2000: 49 54 45 5f 4f 4b 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a  ITE_OK;.}../*.**
2010: 20 52 65 61 64 20 6e 42 79 74 65 73 20 6f 66 20   Read nBytes of 
2020: 64 61 74 61 20 66 72 6f 6d 20 66 64 20 69 6e 74  data from fd int
2030: 6f 20 70 42 75 66 2e 20 20 49 66 20 74 68 65 20  o pBuf.  If the 
2040: 64 61 74 61 20 63 61 6e 6e 6f 74 20 62 65 0a 2a  data cannot be.*
2050: 2a 20 72 65 61 64 20 6f 72 20 6f 6e 6c 79 20 61  * read or only a
2060: 20 70 61 72 74 69 61 6c 20 72 65 61 64 20 6f 63   partial read oc
2070: 63 75 72 73 2c 20 74 68 65 6e 20 74 68 65 20 75  curs, then the u
2080: 6e 72 65 61 64 20 70 61 72 74 73 20 6f 66 0a 2a  nread parts of.*
2090: 2a 20 70 42 75 66 20 61 72 65 20 66 69 6c 6c 65  * pBuf are fille
20a0: 64 20 77 69 74 68 20 7a 65 72 6f 73 20 61 6e 64  d with zeros and
20b0: 20 74 68 69 73 20 72 6f 75 74 69 6e 65 20 72 65   this routine re
20c0: 74 75 72 6e 73 20 53 51 4c 49 54 45 5f 49 4f 45  turns SQLITE_IOE
20d0: 52 52 2e 0a 2a 2a 20 49 66 20 74 68 65 20 72 65  RR..** If the re
20e0: 61 64 20 69 73 20 63 6f 6d 70 6c 65 74 65 6c 79  ad is completely
20f0: 20 73 75 63 63 65 73 73 66 75 6c 2c 20 72 65 74   successful, ret
2100: 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 2e 0a 2a  urn SQLITE_OK..*
2110: 2f 0a 73 74 61 74 69 63 20 69 6e 74 20 70 61 67  /.static int pag
2120: 65 72 5f 72 65 61 64 28 69 6e 74 20 66 64 2c 20  er_read(int fd, 
2130: 76 6f 69 64 20 2a 70 42 75 66 2c 20 69 6e 74 20  void *pBuf, int 
2140: 6e 42 79 74 65 29 7b 0a 20 20 69 6e 74 20 72 63  nByte){.  int rc
2150: 3b 0a 20 20 2f 2a 20 70 72 69 6e 74 66 28 22 52  ;.  /* printf("R
2160: 45 41 44 5c 6e 22 29 3b 2a 2f 0a 20 20 72 63 20  EAD\n");*/.  rc 
2170: 3d 20 72 65 61 64 28 66 64 2c 20 70 42 75 66 2c  = read(fd, pBuf,
2180: 20 6e 42 79 74 65 29 3b 0a 20 20 69 66 28 20 72   nByte);.  if( r
2190: 63 3c 30 20 29 7b 0a 20 20 20 20 6d 65 6d 73 65  c<0 ){.    memse
21a0: 74 28 70 42 75 66 2c 20 30 2c 20 6e 42 79 74 65  t(pBuf, 0, nByte
21b0: 29 3b 0a 20 20 20 20 72 65 74 75 72 6e 20 53 51  );.    return SQ
21c0: 4c 49 54 45 5f 49 4f 45 52 52 3b 0a 20 20 7d 0a  LITE_IOERR;.  }.
21d0: 20 20 69 66 28 20 72 63 3c 6e 42 79 74 65 20 29    if( rc<nByte )
21e0: 7b 0a 20 20 20 20 6d 65 6d 73 65 74 28 26 28 28  {.    memset(&((
21f0: 63 68 61 72 2a 29 70 42 75 66 29 5b 72 63 5d 2c  char*)pBuf)[rc],
2200: 20 30 2c 20 6e 42 79 74 65 20 2d 20 72 63 29 3b   0, nByte - rc);
2210: 0a 20 20 20 20 72 63 20 3d 20 53 51 4c 49 54 45  .    rc = SQLITE
2220: 5f 49 4f 45 52 52 3b 0a 20 20 7d 65 6c 73 65 7b  _IOERR;.  }else{
2230: 0a 20 20 20 20 72 63 20 3d 20 53 51 4c 49 54 45  .    rc = SQLITE
2240: 5f 4f 4b 3b 0a 20 20 7d 0a 20 20 72 65 74 75 72  _OK;.  }.  retur
2250: 6e 20 72 63 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 57  n rc;.}../*.** W
2260: 72 69 74 65 20 6e 42 79 74 65 73 20 6f 66 20 64  rite nBytes of d
2270: 61 74 61 20 69 6e 74 6f 20 66 64 2e 20 20 49 66  ata into fd.  If
2280: 20 61 6e 79 20 70 72 6f 62 6c 65 6d 20 6f 63 63   any problem occ
2290: 75 72 73 20 6f 72 20 69 66 20 74 68 65 0a 2a 2a  urs or if the.**
22a0: 20 77 72 69 74 65 20 69 73 20 69 6e 63 6f 6d 70   write is incomp
22b0: 6c 65 74 65 2c 20 53 51 4c 49 54 45 5f 49 4f 45  lete, SQLITE_IOE
22c0: 52 52 20 69 73 20 72 65 74 75 72 6e 65 64 2e 20  RR is returned. 
22d0: 20 53 51 4c 49 54 45 5f 4f 4b 20 69 73 0a 2a 2a   SQLITE_OK is.**
22e0: 20 72 65 74 75 72 6e 65 64 20 75 70 6f 6e 20 63   returned upon c
22f0: 6f 6d 70 6c 65 74 65 20 73 75 63 63 65 73 73 2e  omplete success.
2300: 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74 20 70  .*/.static int p
2310: 61 67 65 72 5f 77 72 69 74 65 28 69 6e 74 20 66  ager_write(int f
2320: 64 2c 20 63 6f 6e 73 74 20 76 6f 69 64 20 2a 70  d, const void *p
2330: 42 75 66 2c 20 69 6e 74 20 6e 42 79 74 65 29 7b  Buf, int nByte){
2340: 0a 20 20 69 6e 74 20 72 63 3b 0a 20 20 2f 2a 70  .  int rc;.  /*p
2350: 72 69 6e 74 66 28 22 57 52 49 54 45 5c 6e 22 29  rintf("WRITE\n")
2360: 3b 2a 2f 0a 20 20 72 63 20 3d 20 77 72 69 74 65  ;*/.  rc = write
2370: 28 66 64 2c 20 70 42 75 66 2c 20 6e 42 79 74 65  (fd, pBuf, nByte
2380: 29 3b 0a 20 20 69 66 28 20 72 63 3c 6e 42 79 74  );.  if( rc<nByt
2390: 65 20 29 7b 0a 20 20 20 20 72 65 74 75 72 6e 20  e ){.    return 
23a0: 53 51 4c 49 54 45 5f 46 55 4c 4c 3b 0a 20 20 7d  SQLITE_FULL;.  }
23b0: 65 6c 73 65 7b 0a 20 20 20 20 72 65 74 75 72 6e  else{.    return
23c0: 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20 20 7d 0a   SQLITE_OK;.  }.
23d0: 7d 0a 0a 2f 2a 0a 2a 2a 20 43 6f 6e 76 65 72 74  }../*.** Convert
23e0: 20 74 68 65 20 62 69 74 73 20 69 6e 20 74 68 65   the bits in the
23f0: 20 70 50 61 67 65 72 2d 3e 65 72 72 4d 61 73 6b   pPager->errMask
2400: 20 69 6e 74 6f 20 61 6e 20 61 70 70 72 6f 70 72   into an appropr
2410: 61 74 65 0a 2a 2a 20 72 65 74 75 72 6e 20 63 6f  ate.** return co
2420: 64 65 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e  de..*/.static in
2430: 74 20 70 61 67 65 72 5f 65 72 72 63 6f 64 65 28  t pager_errcode(
2440: 50 61 67 65 72 20 2a 70 50 61 67 65 72 29 7b 0a  Pager *pPager){.
2450: 20 20 69 6e 74 20 72 63 20 3d 20 53 51 4c 49 54    int rc = SQLIT
2460: 45 5f 4f 4b 3b 0a 20 20 69 66 28 20 70 50 61 67  E_OK;.  if( pPag
2470: 65 72 2d 3e 65 72 72 4d 61 73 6b 20 26 20 50 41  er->errMask & PA
2480: 47 45 52 5f 45 52 52 5f 4c 4f 43 4b 20 29 20 20  GER_ERR_LOCK )  
2490: 20 20 72 63 20 3d 20 53 51 4c 49 54 45 5f 50 52    rc = SQLITE_PR
24a0: 4f 54 4f 43 4f 4c 3b 0a 20 20 69 66 28 20 70 50  OTOCOL;.  if( pP
24b0: 61 67 65 72 2d 3e 65 72 72 4d 61 73 6b 20 26 20  ager->errMask & 
24c0: 50 41 47 45 52 5f 45 52 52 5f 46 55 4c 4c 20 29  PAGER_ERR_FULL )
24d0: 20 20 20 20 72 63 20 3d 20 53 51 4c 49 54 45 5f      rc = SQLITE_
24e0: 46 55 4c 4c 3b 0a 20 20 69 66 28 20 70 50 61 67  FULL;.  if( pPag
24f0: 65 72 2d 3e 65 72 72 4d 61 73 6b 20 26 20 50 41  er->errMask & PA
2500: 47 45 52 5f 45 52 52 5f 4d 45 4d 20 29 20 20 20  GER_ERR_MEM )   
2510: 20 20 72 63 20 3d 20 53 51 4c 49 54 45 5f 4e 4f    rc = SQLITE_NO
2520: 4d 45 4d 3b 0a 20 20 69 66 28 20 70 50 61 67 65  MEM;.  if( pPage
2530: 72 2d 3e 65 72 72 4d 61 73 6b 20 26 20 50 41 47  r->errMask & PAG
2540: 45 52 5f 45 52 52 5f 43 4f 52 52 55 50 54 20 29  ER_ERR_CORRUPT )
2550: 20 72 63 20 3d 20 53 51 4c 49 54 45 5f 43 4f 52   rc = SQLITE_COR
2560: 52 55 50 54 3b 0a 20 20 72 65 74 75 72 6e 20 72  RUPT;.  return r
2570: 63 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 46 69 6e 64  c;.}../*.** Find
2580: 20 61 20 70 61 67 65 20 69 6e 20 74 68 65 20 68   a page in the h
2590: 61 73 68 20 74 61 62 6c 65 20 67 69 76 65 6e 20  ash table given 
25a0: 69 74 73 20 70 61 67 65 20 6e 75 6d 62 65 72 2e  its page number.
25b0: 20 20 52 65 74 75 72 6e 0a 2a 2a 20 61 20 70 6f    Return.** a po
25c0: 69 6e 74 65 72 20 74 6f 20 74 68 65 20 70 61 67  inter to the pag
25d0: 65 20 6f 72 20 4e 55 4c 4c 20 69 66 20 6e 6f 74  e or NULL if not
25e0: 20 66 6f 75 6e 64 2e 0a 2a 2f 0a 73 74 61 74 69   found..*/.stati
25f0: 63 20 50 67 48 64 72 20 2a 70 61 67 65 72 5f 6c  c PgHdr *pager_l
2600: 6f 6f 6b 75 70 28 50 61 67 65 72 20 2a 70 50 61  ookup(Pager *pPa
2610: 67 65 72 2c 20 50 67 6e 6f 20 70 67 6e 6f 29 7b  ger, Pgno pgno){
2620: 0a 20 20 50 67 48 64 72 20 2a 70 20 3d 20 70 50  .  PgHdr *p = pP
2630: 61 67 65 72 2d 3e 61 48 61 73 68 5b 70 67 6e 6f  ager->aHash[pgno
2640: 20 25 20 4e 5f 50 47 5f 48 41 53 48 5d 3b 0a 20   % N_PG_HASH];. 
2650: 20 77 68 69 6c 65 28 20 70 20 26 26 20 70 2d 3e   while( p && p->
2660: 70 67 6e 6f 21 3d 70 67 6e 6f 20 29 7b 0a 20 20  pgno!=pgno ){.  
2670: 20 20 70 20 3d 20 70 2d 3e 70 4e 65 78 74 48 61    p = p->pNextHa
2680: 73 68 3b 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e  sh;.  }.  return
2690: 20 70 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 55 6e 6c   p;.}../*.** Unl
26a0: 6f 63 6b 20 74 68 65 20 64 61 74 61 62 61 73 65  ock the database
26b0: 20 61 6e 64 20 63 6c 65 61 72 20 74 68 65 20 69   and clear the i
26c0: 6e 2d 6d 65 6d 6f 72 79 20 63 61 63 68 65 2e 20  n-memory cache. 
26d0: 20 54 68 69 73 20 72 6f 75 74 69 6e 65 0a 2a 2a   This routine.**
26e0: 20 73 65 74 73 20 74 68 65 20 73 74 61 74 65 20   sets the state 
26f0: 6f 66 20 74 68 65 20 70 61 67 65 72 20 62 61 63  of the pager bac
2700: 6b 20 74 6f 20 77 68 61 74 20 69 74 20 77 61 73  k to what it was
2710: 20 77 68 65 6e 20 69 74 20 77 61 73 20 66 69 72   when it was fir
2720: 73 74 0a 2a 2a 20 6f 70 65 6e 65 64 2e 20 20 41  st.** opened.  A
2730: 6e 79 20 6f 75 74 73 74 61 6e 64 69 6e 67 20 70  ny outstanding p
2740: 61 67 65 73 20 61 72 65 20 69 6e 76 61 6c 69 64  ages are invalid
2750: 61 74 65 64 20 61 6e 64 20 73 75 62 73 65 71 75  ated and subsequ
2760: 65 6e 74 20 61 74 74 65 6d 70 74 73 0a 2a 2a 20  ent attempts.** 
2770: 74 6f 20 61 63 63 65 73 73 20 74 68 6f 73 65 20  to access those 
2780: 70 61 67 65 73 20 77 69 6c 6c 20 6c 69 6b 65 6c  pages will likel
2790: 79 20 72 65 73 75 6c 74 20 69 6e 20 61 20 63 6f  y result in a co
27a0: 72 65 64 75 6d 70 2e 0a 2a 2f 0a 73 74 61 74 69  redump..*/.stati
27b0: 63 20 76 6f 69 64 20 70 61 67 65 72 5f 72 65 73  c void pager_res
27c0: 65 74 28 50 61 67 65 72 20 2a 70 50 61 67 65 72  et(Pager *pPager
27d0: 29 7b 0a 20 20 50 67 48 64 72 20 2a 70 50 67 2c  ){.  PgHdr *pPg,
27e0: 20 2a 70 4e 65 78 74 3b 0a 20 20 66 6f 72 28 70   *pNext;.  for(p
27f0: 50 67 3d 70 50 61 67 65 72 2d 3e 70 41 6c 6c 3b  Pg=pPager->pAll;
2800: 20 70 50 67 3b 20 70 50 67 3d 70 4e 65 78 74 29   pPg; pPg=pNext)
2810: 7b 0a 20 20 20 20 70 4e 65 78 74 20 3d 20 70 50  {.    pNext = pP
2820: 67 2d 3e 70 4e 65 78 74 41 6c 6c 3b 0a 20 20 20  g->pNextAll;.   
2830: 20 73 71 6c 69 74 65 46 72 65 65 28 70 50 67 29   sqliteFree(pPg)
2840: 3b 0a 20 20 7d 0a 20 20 70 50 61 67 65 72 2d 3e  ;.  }.  pPager->
2850: 70 46 69 72 73 74 20 3d 20 30 3b 0a 20 20 70 50  pFirst = 0;.  pP
2860: 61 67 65 72 2d 3e 70 4c 61 73 74 20 3d 20 30 3b  ager->pLast = 0;
2870: 0a 20 20 70 50 61 67 65 72 2d 3e 70 41 6c 6c 20  .  pPager->pAll 
2880: 3d 20 30 3b 0a 20 20 6d 65 6d 73 65 74 28 70 50  = 0;.  memset(pP
2890: 61 67 65 72 2d 3e 61 48 61 73 68 2c 20 30 2c 20  ager->aHash, 0, 
28a0: 73 69 7a 65 6f 66 28 70 50 61 67 65 72 2d 3e 61  sizeof(pPager->a
28b0: 48 61 73 68 29 29 3b 0a 20 20 70 50 61 67 65 72  Hash));.  pPager
28c0: 2d 3e 6e 50 61 67 65 20 3d 20 30 3b 0a 20 20 69  ->nPage = 0;.  i
28d0: 66 28 20 70 50 61 67 65 72 2d 3e 73 74 61 74 65  f( pPager->state
28e0: 3d 3d 53 51 4c 49 54 45 5f 57 52 49 54 45 4c 4f  ==SQLITE_WRITELO
28f0: 43 4b 20 29 7b 0a 20 20 20 20 73 71 6c 69 74 65  CK ){.    sqlite
2900: 70 61 67 65 72 5f 72 6f 6c 6c 62 61 63 6b 28 70  pager_rollback(p
2910: 50 61 67 65 72 29 3b 0a 20 20 7d 0a 20 20 70 61  Pager);.  }.  pa
2920: 67 65 72 5f 75 6e 6c 6f 63 6b 28 70 50 61 67 65  ger_unlock(pPage
2930: 72 2d 3e 66 64 29 3b 0a 20 20 70 50 61 67 65 72  r->fd);.  pPager
2940: 2d 3e 73 74 61 74 65 20 3d 20 53 51 4c 49 54 45  ->state = SQLITE
2950: 5f 55 4e 4c 4f 43 4b 3b 0a 20 20 70 50 61 67 65  _UNLOCK;.  pPage
2960: 72 2d 3e 64 62 53 69 7a 65 20 3d 20 2d 31 3b 0a  r->dbSize = -1;.
2970: 20 20 70 50 61 67 65 72 2d 3e 6e 52 65 66 20 3d    pPager->nRef =
2980: 20 30 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 57 68 65   0;.}../*.** Whe
2990: 6e 20 74 68 69 73 20 72 6f 75 74 69 6e 65 20 69  n this routine i
29a0: 73 20 63 61 6c 6c 65 64 2c 20 74 68 65 20 70 61  s called, the pa
29b0: 67 65 72 20 68 61 73 20 74 68 65 20 6a 6f 75 72  ger has the jour
29c0: 6e 61 6c 20 66 69 6c 65 20 6f 70 65 6e 20 61 6e  nal file open an
29d0: 64 0a 2a 2a 20 61 20 77 72 69 74 65 20 6c 6f 63  d.** a write loc
29e0: 6b 20 6f 6e 20 74 68 65 20 64 61 74 61 62 61 73  k on the databas
29f0: 65 2e 20 20 54 68 69 73 20 72 6f 75 74 69 6e 65  e.  This routine
2a00: 20 72 65 6c 65 61 73 65 73 20 74 68 65 20 64 61   releases the da
2a10: 74 61 62 61 73 65 0a 2a 2a 20 77 72 69 74 65 20  tabase.** write 
2a20: 6c 6f 63 6b 20 61 6e 64 20 61 63 71 75 69 72 65  lock and acquire
2a30: 73 20 61 20 72 65 61 64 20 6c 6f 63 6b 20 69 6e  s a read lock in
2a40: 20 69 74 73 20 70 6c 61 63 65 2e 20 20 54 68 65   its place.  The
2a50: 20 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 0a 2a 2a   journal file.**
2a60: 20 69 73 20 64 65 6c 65 74 65 64 20 61 6e 64 20   is deleted and 
2a70: 63 6c 6f 73 65 64 2e 0a 2a 2a 0a 2a 2a 20 57 65  closed..**.** We
2a80: 20 68 61 76 65 20 74 6f 20 72 65 6c 65 61 73 65   have to release
2a90: 20 74 68 65 20 77 72 69 74 65 20 6c 6f 63 6b 20   the write lock 
2aa0: 62 65 66 6f 72 65 20 61 63 71 75 69 72 69 6e 67  before acquiring
2ab0: 20 74 68 65 20 72 65 61 64 20 6c 6f 63 6b 2c 0a   the read lock,.
2ac0: 2a 2a 20 73 6f 20 74 68 65 72 65 20 69 73 20 61  ** so there is a
2ad0: 20 72 61 63 65 20 63 6f 6e 64 69 74 69 6f 6e 20   race condition 
2ae0: 77 68 65 72 65 20 61 6e 6f 74 68 65 72 20 70 72  where another pr
2af0: 6f 63 65 73 73 20 63 61 6e 20 67 65 74 20 74 68  ocess can get th
2b00: 65 20 6c 6f 63 6b 0a 2a 2a 20 77 68 69 6c 65 20  e lock.** while 
2b10: 77 65 20 61 72 65 20 6e 6f 74 20 68 6f 6c 64 69  we are not holdi
2b20: 6e 67 20 69 74 2e 20 20 42 75 74 2c 20 6e 6f 20  ng it.  But, no 
2b30: 6f 74 68 65 72 20 70 72 6f 63 65 73 73 20 73 68  other process sh
2b40: 6f 75 6c 64 20 64 6f 20 74 68 69 73 0a 2a 2a 20  ould do this.** 
2b50: 62 65 63 61 75 73 65 20 77 65 20 61 72 65 20 61  because we are a
2b60: 6c 73 6f 20 68 6f 6c 64 69 6e 67 20 61 20 6c 6f  lso holding a lo
2b70: 63 6b 20 6f 6e 20 74 68 65 20 6a 6f 75 72 6e 61  ck on the journa
2b80: 6c 2c 20 61 6e 64 20 6e 6f 20 70 72 6f 63 65 73  l, and no proces
2b90: 73 0a 2a 2a 20 73 68 6f 75 6c 64 20 67 65 74 20  s.** should get 
2ba0: 61 20 77 72 69 74 65 20 6c 6f 63 6b 20 6f 6e 20  a write lock on 
2bb0: 74 68 65 20 64 61 74 61 62 61 73 65 20 77 69 74  the database wit
2bc0: 68 6f 75 74 20 66 69 72 73 74 20 67 65 74 74 69  hout first getti
2bd0: 6e 67 20 61 20 6c 6f 63 6b 0a 2a 2a 20 6f 6e 20  ng a lock.** on 
2be0: 74 68 65 20 6a 6f 75 72 6e 61 6c 2e 20 20 53 6f  the journal.  So
2bf0: 20 74 68 69 73 20 72 6f 75 74 69 6e 65 20 73 68   this routine sh
2c00: 6f 75 6c 64 20 6e 65 76 65 72 20 66 61 69 6c 2e  ould never fail.
2c10: 20 20 42 75 74 20 69 74 20 63 61 6e 20 66 61 69    But it can fai
2c20: 6c 0a 2a 2a 20 69 66 20 61 6e 6f 74 68 65 72 20  l.** if another 
2c30: 70 72 6f 63 65 73 73 20 69 73 20 6e 6f 74 20 70  process is not p
2c40: 6c 61 79 69 6e 67 20 62 79 20 74 68 65 20 72 75  laying by the ru
2c50: 6c 65 73 2e 20 20 49 66 20 69 74 20 64 6f 65 73  les.  If it does
2c60: 20 66 61 69 6c 2c 0a 2a 2a 20 61 6c 6c 20 69 6e   fail,.** all in
2c70: 2d 6d 65 6d 6f 72 79 20 63 61 63 68 65 20 70 61  -memory cache pa
2c80: 67 65 73 20 61 72 65 20 69 6e 76 61 6c 69 64 61  ges are invalida
2c90: 74 65 64 2c 20 74 68 65 20 50 41 47 45 52 5f 45  ted, the PAGER_E
2ca0: 52 52 5f 4c 4f 43 4b 20 62 69 74 0a 2a 2a 20 69  RR_LOCK bit.** i
2cb0: 73 20 73 65 74 20 69 6e 20 70 50 61 67 65 72 2d  s set in pPager-
2cc0: 3e 65 72 72 4d 61 73 6b 2c 20 61 6e 64 20 74 68  >errMask, and th
2cd0: 69 73 20 72 6f 75 74 69 6e 65 20 72 65 74 75 72  is routine retur
2ce0: 6e 73 20 53 51 4c 49 54 45 5f 50 52 4f 54 4f 43  ns SQLITE_PROTOC
2cf0: 4f 4c 2e 0a 2a 2a 20 53 51 4c 49 54 45 5f 4f 4b  OL..** SQLITE_OK
2d00: 20 69 73 20 72 65 74 75 72 6e 65 64 20 6f 6e 20   is returned on 
2d10: 73 75 63 63 65 73 73 2e 0a 2a 2f 0a 73 74 61 74  success..*/.stat
2d20: 69 63 20 69 6e 74 20 70 61 67 65 72 5f 75 6e 77  ic int pager_unw
2d30: 72 69 74 65 6c 6f 63 6b 28 50 61 67 65 72 20 2a  ritelock(Pager *
2d40: 70 50 61 67 65 72 29 7b 0a 20 20 69 6e 74 20 72  pPager){.  int r
2d50: 63 3b 0a 20 20 50 67 48 64 72 20 2a 70 50 67 3b  c;.  PgHdr *pPg;
2d60: 0a 20 20 69 66 28 20 70 50 61 67 65 72 2d 3e 73  .  if( pPager->s
2d70: 74 61 74 65 21 3d 53 51 4c 49 54 45 5f 57 52 49  tate!=SQLITE_WRI
2d80: 54 45 4c 4f 43 4b 20 29 20 72 65 74 75 72 6e 20  TELOCK ) return 
2d90: 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20 20 70 61 67  SQLITE_OK;.  pag
2da0: 65 72 5f 75 6e 6c 6f 63 6b 28 70 50 61 67 65 72  er_unlock(pPager
2db0: 2d 3e 66 64 29 3b 0a 20 20 72 63 20 3d 20 70 61  ->fd);.  rc = pa
2dc0: 67 65 72 5f 6c 6f 63 6b 28 70 50 61 67 65 72 2d  ger_lock(pPager-
2dd0: 3e 66 64 2c 20 30 29 3b 0a 20 20 75 6e 6c 69 6e  >fd, 0);.  unlin
2de0: 6b 28 70 50 61 67 65 72 2d 3e 7a 4a 6f 75 72 6e  k(pPager->zJourn
2df0: 61 6c 29 3b 0a 20 20 63 6c 6f 73 65 28 70 50 61  al);.  close(pPa
2e00: 67 65 72 2d 3e 6a 66 64 29 3b 0a 20 20 70 50 61  ger->jfd);.  pPa
2e10: 67 65 72 2d 3e 6a 66 64 20 3d 20 2d 31 3b 0a 20  ger->jfd = -1;. 
2e20: 20 73 71 6c 69 74 65 46 72 65 65 28 20 70 50 61   sqliteFree( pPa
2e30: 67 65 72 2d 3e 61 49 6e 4a 6f 75 72 6e 61 6c 20  ger->aInJournal 
2e40: 29 3b 0a 20 20 70 50 61 67 65 72 2d 3e 61 49 6e  );.  pPager->aIn
2e50: 4a 6f 75 72 6e 61 6c 20 3d 20 30 3b 0a 20 20 66  Journal = 0;.  f
2e60: 6f 72 28 70 50 67 3d 70 50 61 67 65 72 2d 3e 70  or(pPg=pPager->p
2e70: 41 6c 6c 3b 20 70 50 67 3b 20 70 50 67 3d 70 50  All; pPg; pPg=pP
2e80: 67 2d 3e 70 4e 65 78 74 41 6c 6c 29 7b 0a 20 20  g->pNextAll){.  
2e90: 20 20 70 50 67 2d 3e 69 6e 4a 6f 75 72 6e 61 6c    pPg->inJournal
2ea0: 20 3d 20 30 3b 0a 20 20 20 20 70 50 67 2d 3e 64   = 0;.    pPg->d
2eb0: 69 72 74 79 20 3d 20 30 3b 0a 20 20 7d 0a 20 20  irty = 0;.  }.  
2ec0: 69 66 28 20 72 63 21 3d 53 51 4c 49 54 45 5f 4f  if( rc!=SQLITE_O
2ed0: 4b 20 29 7b 0a 20 20 20 20 70 50 61 67 65 72 2d  K ){.    pPager-
2ee0: 3e 73 74 61 74 65 20 3d 20 53 51 4c 49 54 45 5f  >state = SQLITE_
2ef0: 55 4e 4c 4f 43 4b 3b 0a 20 20 20 20 72 63 20 3d  UNLOCK;.    rc =
2f00: 20 53 51 4c 49 54 45 5f 50 52 4f 54 4f 43 4f 4c   SQLITE_PROTOCOL
2f10: 3b 0a 20 20 20 20 70 50 61 67 65 72 2d 3e 65 72  ;.    pPager->er
2f20: 72 4d 61 73 6b 20 7c 3d 20 50 41 47 45 52 5f 45  rMask |= PAGER_E
2f30: 52 52 5f 4c 4f 43 4b 3b 0a 20 20 7d 65 6c 73 65  RR_LOCK;.  }else
2f40: 7b 0a 20 20 20 20 72 63 20 3d 20 53 51 4c 49 54  {.    rc = SQLIT
2f50: 45 5f 4f 4b 3b 0a 20 20 20 20 70 50 61 67 65 72  E_OK;.    pPager
2f60: 2d 3e 73 74 61 74 65 20 3d 20 53 51 4c 49 54 45  ->state = SQLITE
2f70: 5f 52 45 41 44 4c 4f 43 4b 3b 0a 20 20 7d 0a 20  _READLOCK;.  }. 
2f80: 20 72 65 74 75 72 6e 20 72 63 3b 0a 7d 0a 0a 2f   return rc;.}../
2f90: 2a 0a 2a 2a 20 50 6c 61 79 62 61 63 6b 20 74 68  *.** Playback th
2fa0: 65 20 6a 6f 75 72 6e 61 6c 20 61 6e 64 20 74 68  e journal and th
2fb0: 75 73 20 72 65 73 74 6f 72 65 20 74 68 65 20 64  us restore the d
2fc0: 61 74 61 62 61 73 65 20 66 69 6c 65 20 74 6f 0a  atabase file to.
2fd0: 2a 2a 20 74 68 65 20 73 74 61 74 65 20 69 74 20  ** the state it 
2fe0: 77 61 73 20 69 6e 20 62 65 66 6f 72 65 20 77 65  was in before we
2ff0: 20 73 74 61 72 74 65 64 20 6d 61 6b 69 6e 67 20   started making 
3000: 63 68 61 6e 67 65 73 2e 20 20 0a 2a 2a 0a 2a 2a  changes.  .**.**
3010: 20 54 68 65 20 6a 6f 75 72 6e 61 6c 20 66 69 6c   The journal fil
3020: 65 20 66 6f 72 6d 61 74 20 69 73 20 61 73 20 66  e format is as f
3030: 6f 6c 6c 6f 77 73 3a 20 20 54 68 65 72 65 20 69  ollows:  There i
3040: 73 20 61 6e 20 69 6e 69 74 69 61 6c 0a 2a 2a 20  s an initial.** 
3050: 66 69 6c 65 2d 74 79 70 65 20 73 74 72 69 6e 67  file-type string
3060: 20 66 6f 72 20 73 61 6e 69 74 79 20 63 68 65 63   for sanity chec
3070: 6b 69 6e 67 2e 20 20 54 68 65 6e 20 74 68 65 72  king.  Then ther
3080: 65 20 69 73 20 61 20 73 69 6e 67 6c 65 0a 2a 2a  e is a single.**
3090: 20 50 67 6e 6f 20 6e 75 6d 62 65 72 20 77 68 69   Pgno number whi
30a0: 63 68 20 69 73 20 74 68 65 20 6e 75 6d 62 65 72  ch is the number
30b0: 20 6f 66 20 70 61 67 65 73 20 69 6e 20 74 68 65   of pages in the
30c0: 20 64 61 74 61 62 61 73 65 20 62 65 66 6f 72 65   database before
30d0: 0a 2a 2a 20 63 68 61 6e 67 65 73 20 77 65 72 65  .** changes were
30e0: 20 6d 61 64 65 2e 20 20 54 68 65 20 64 61 74 61   made.  The data
30f0: 62 61 73 65 20 69 73 20 74 72 75 6e 63 61 74 65  base is truncate
3100: 64 20 74 6f 20 74 68 69 73 20 73 69 7a 65 2e 0a  d to this size..
3110: 2a 2a 20 4e 65 78 74 20 63 6f 6d 65 20 7a 65 72  ** Next come zer
3120: 6f 20 6f 72 20 6d 6f 72 65 20 70 61 67 65 20 72  o or more page r
3130: 65 63 6f 72 64 73 20 77 68 65 72 65 20 65 61 63  ecords where eac
3140: 68 20 70 61 67 65 20 72 65 63 6f 72 64 0a 2a 2a  h page record.**
3150: 20 63 6f 6e 73 69 73 74 73 20 6f 66 20 61 20 50   consists of a P
3160: 67 6e 6f 20 61 6e 64 20 53 51 4c 49 54 45 5f 50  gno and SQLITE_P
3170: 41 47 45 5f 53 49 5a 45 20 62 79 74 65 73 20 6f  AGE_SIZE bytes o
3180: 66 20 64 61 74 61 2e 20 20 53 65 65 0a 2a 2a 20  f data.  See.** 
3190: 74 68 65 20 50 61 67 65 52 65 63 6f 72 64 20 73  the PageRecord s
31a0: 74 72 75 63 74 75 72 65 20 66 6f 72 20 64 65 74  tructure for det
31b0: 61 69 6c 73 2e 0a 2a 2a 0a 2a 2a 20 46 6f 72 20  ails..**.** For 
31c0: 70 6c 61 79 62 61 63 6b 2c 20 74 68 65 20 70 61  playback, the pa
31d0: 67 65 73 20 68 61 76 65 20 74 6f 20 62 65 20 72  ges have to be r
31e0: 65 61 64 20 66 72 6f 6d 20 74 68 65 20 6a 6f 75  ead from the jou
31f0: 72 6e 61 6c 20 69 6e 0a 2a 2a 20 72 65 76 65 72  rnal in.** rever
3200: 73 65 20 6f 72 64 65 72 20 61 6e 64 20 70 75 74  se order and put
3210: 20 62 61 63 6b 20 69 6e 74 6f 20 74 68 65 20 6f   back into the o
3220: 72 69 67 69 6e 61 6c 20 64 61 74 61 62 61 73 65  riginal database
3230: 20 66 69 6c 65 2e 0a 2a 2a 0a 2a 2a 20 49 66 20   file..**.** If 
3240: 74 68 65 20 66 69 6c 65 20 6f 70 65 6e 65 64 20  the file opened 
3250: 61 73 20 74 68 65 20 6a 6f 75 72 6e 61 6c 20 66  as the journal f
3260: 69 6c 65 20 69 73 20 6e 6f 74 20 61 20 77 65 6c  ile is not a wel
3270: 6c 2d 66 6f 72 6d 65 64 0a 2a 2a 20 6a 6f 75 72  l-formed.** jour
3280: 6e 61 6c 20 66 69 6c 65 20 28 61 73 20 64 65 74  nal file (as det
3290: 65 72 6d 69 6e 65 64 20 62 79 20 6c 6f 6f 6b 69  ermined by looki
32a0: 6e 67 20 61 74 20 74 68 65 20 6d 61 67 69 63 20  ng at the magic 
32b0: 6e 75 6d 62 65 72 0a 2a 2a 20 61 74 20 74 68 65  number.** at the
32c0: 20 62 65 67 69 6e 6e 69 6e 67 29 20 74 68 65 6e   beginning) then
32d0: 20 74 68 69 73 20 72 6f 75 74 69 6e 65 20 72 65   this routine re
32e0: 74 75 72 6e 73 20 53 51 4c 49 54 45 5f 50 52 4f  turns SQLITE_PRO
32f0: 54 4f 43 4f 4c 2e 0a 2a 2a 20 49 66 20 61 6e 79  TOCOL..** If any
3300: 20 6f 74 68 65 72 20 65 72 72 6f 72 73 20 6f 63   other errors oc
3310: 63 75 72 20 64 75 72 69 6e 67 20 70 6c 61 79 62  cur during playb
3320: 61 63 6b 2c 20 74 68 65 20 64 61 74 61 62 61 73  ack, the databas
3330: 65 20 77 69 6c 6c 0a 2a 2a 20 6c 69 6b 65 6c 79  e will.** likely
3340: 20 62 65 20 63 6f 72 72 75 70 74 65 64 2c 20 73   be corrupted, s
3350: 6f 20 74 68 65 20 50 41 47 45 52 5f 45 52 52 5f  o the PAGER_ERR_
3360: 43 4f 52 52 55 50 54 20 62 69 74 20 69 73 20 73  CORRUPT bit is s
3370: 65 74 20 69 6e 0a 2a 2a 20 70 50 61 67 65 72 2d  et in.** pPager-
3380: 3e 65 72 72 4d 61 73 6b 20 61 6e 64 20 53 51 4c  >errMask and SQL
3390: 49 54 45 5f 43 4f 52 52 55 50 54 20 69 73 20 72  ITE_CORRUPT is r
33a0: 65 74 75 72 6e 65 64 2e 20 20 49 66 20 69 74 20  eturned.  If it 
33b0: 61 6c 6c 0a 2a 2a 20 77 6f 72 6b 73 2c 20 74 68  all.** works, th
33c0: 65 6e 20 74 68 69 73 20 72 6f 75 74 69 6e 65 20  en this routine 
33d0: 72 65 74 75 72 6e 73 20 53 51 4c 49 54 45 5f 4f  returns SQLITE_O
33e0: 4b 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74  K..*/.static int
33f0: 20 70 61 67 65 72 5f 70 6c 61 79 62 61 63 6b 28   pager_playback(
3400: 50 61 67 65 72 20 2a 70 50 61 67 65 72 29 7b 0a  Pager *pPager){.
3410: 20 20 69 6e 74 20 6e 52 65 63 3b 20 20 20 20 20    int nRec;     
3420: 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4e 75             /* Nu
3430: 6d 62 65 72 20 6f 66 20 52 65 63 6f 72 64 73 20  mber of Records 
3440: 2a 2f 0a 20 20 69 6e 74 20 69 3b 20 20 20 20 20  */.  int i;     
3450: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a                /*
3460: 20 4c 6f 6f 70 20 63 6f 75 6e 74 65 72 20 2a 2f   Loop counter */
3470: 0a 20 20 50 67 6e 6f 20 6d 78 50 67 20 3d 20 30  .  Pgno mxPg = 0
3480: 3b 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 53  ;           /* S
3490: 69 7a 65 20 6f 66 20 74 68 65 20 6f 72 69 67 69  ize of the origi
34a0: 6e 61 6c 20 66 69 6c 65 20 69 6e 20 70 61 67 65  nal file in page
34b0: 73 20 2a 2f 0a 20 20 73 74 72 75 63 74 20 73 74  s */.  struct st
34c0: 61 74 20 73 74 61 74 62 75 66 3b 20 20 20 20 20  at statbuf;     
34d0: 2f 2a 20 55 73 65 64 20 74 6f 20 73 69 7a 65 20  /* Used to size 
34e0: 74 68 65 20 6a 6f 75 72 6e 61 6c 20 2a 2f 0a 20  the journal */. 
34f0: 20 50 67 48 64 72 20 2a 70 50 67 3b 20 20 20 20   PgHdr *pPg;    
3500: 20 20 20 20 20 20 20 20 20 20 2f 2a 20 41 6e 20            /* An 
3510: 65 78 69 73 74 69 6e 67 20 70 61 67 65 20 69 6e  existing page in
3520: 20 74 68 65 20 63 61 63 68 65 20 2a 2f 0a 20 20   the cache */.  
3530: 50 61 67 65 52 65 63 6f 72 64 20 70 67 52 65 63  PageRecord pgRec
3540: 3b 0a 20 20 75 6e 73 69 67 6e 65 64 20 63 68 61  ;.  unsigned cha
3550: 72 20 61 4d 61 67 69 63 5b 73 69 7a 65 6f 66 28  r aMagic[sizeof(
3560: 61 4a 6f 75 72 6e 61 6c 4d 61 67 69 63 29 5d 3b  aJournalMagic)];
3570: 0a 20 20 69 6e 74 20 72 63 3b 0a 0a 20 20 2f 2a  .  int rc;..  /*
3580: 20 52 65 61 64 20 74 68 65 20 62 65 67 69 6e 6e   Read the beginn
3590: 69 6e 67 20 6f 66 20 74 68 65 20 6a 6f 75 72 6e  ing of the journ
35a0: 61 6c 20 61 6e 64 20 74 72 75 6e 63 61 74 65 20  al and truncate 
35b0: 74 68 65 0a 20 20 2a 2a 20 64 61 74 61 62 61 73  the.  ** databas
35c0: 65 20 66 69 6c 65 20 62 61 63 6b 20 74 6f 20 69  e file back to i
35d0: 74 73 20 6f 72 69 67 69 6e 61 6c 20 73 69 7a 65  ts original size
35e0: 2e 0a 20 20 2a 2f 0a 20 20 61 73 73 65 72 74 28  ..  */.  assert(
35f0: 20 70 50 61 67 65 72 2d 3e 6a 66 64 3e 3d 30 20   pPager->jfd>=0 
3600: 29 3b 0a 20 20 70 61 67 65 72 5f 73 65 65 6b 28  );.  pager_seek(
3610: 70 50 61 67 65 72 2d 3e 6a 66 64 2c 20 30 29 3b  pPager->jfd, 0);
3620: 0a 20 20 72 63 20 3d 20 70 61 67 65 72 5f 72 65  .  rc = pager_re
3630: 61 64 28 70 50 61 67 65 72 2d 3e 6a 66 64 2c 20  ad(pPager->jfd, 
3640: 61 4d 61 67 69 63 2c 20 73 69 7a 65 6f 66 28 61  aMagic, sizeof(a
3650: 4d 61 67 69 63 29 29 3b 0a 20 20 69 66 28 20 72  Magic));.  if( r
3660: 63 21 3d 53 51 4c 49 54 45 5f 4f 4b 20 7c 7c 20  c!=SQLITE_OK || 
3670: 6d 65 6d 63 6d 70 28 61 4d 61 67 69 63 2c 61 4a  memcmp(aMagic,aJ
3680: 6f 75 72 6e 61 6c 4d 61 67 69 63 2c 73 69 7a 65  ournalMagic,size
3690: 6f 66 28 61 4d 61 67 69 63 29 29 21 3d 30 20 29  of(aMagic))!=0 )
36a0: 7b 0a 20 20 20 20 72 65 74 75 72 6e 20 53 51 4c  {.    return SQL
36b0: 49 54 45 5f 50 52 4f 54 4f 43 4f 4c 3b 0a 20 20  ITE_PROTOCOL;.  
36c0: 7d 0a 20 20 72 63 20 3d 20 70 61 67 65 72 5f 72  }.  rc = pager_r
36d0: 65 61 64 28 70 50 61 67 65 72 2d 3e 6a 66 64 2c  ead(pPager->jfd,
36e0: 20 26 6d 78 50 67 2c 20 73 69 7a 65 6f 66 28 6d   &mxPg, sizeof(m
36f0: 78 50 67 29 29 3b 0a 20 20 69 66 28 20 72 63 21  xPg));.  if( rc!
3700: 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20  =SQLITE_OK ){.  
3710: 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f    return SQLITE_
3720: 50 52 4f 54 4f 43 4f 4c 3b 0a 20 20 7d 0a 20 20  PROTOCOL;.  }.  
3730: 70 61 67 65 72 5f 74 72 75 6e 63 61 74 65 28 70  pager_truncate(p
3740: 50 61 67 65 72 2d 3e 66 64 2c 20 6d 78 50 67 29  Pager->fd, mxPg)
3750: 3b 0a 20 20 70 50 61 67 65 72 2d 3e 64 62 53 69  ;.  pPager->dbSi
3760: 7a 65 20 3d 20 6d 78 50 67 3b 0a 20 20 0a 20 20  ze = mxPg;.  .  
3770: 2f 2a 20 42 65 67 69 6e 20 72 65 61 64 69 6e 67  /* Begin reading
3780: 20 74 68 65 20 6a 6f 75 72 6e 61 6c 20 62 65 67   the journal beg
3790: 69 6e 6e 69 6e 67 20 61 74 20 74 68 65 20 65 6e  inning at the en
37a0: 64 20 61 6e 64 20 6d 6f 76 69 6e 67 0a 20 20 2a  d and moving.  *
37b0: 2a 20 74 6f 77 61 72 64 20 74 68 65 20 62 65 67  * toward the beg
37c0: 69 6e 6e 69 6e 67 2e 0a 20 20 2a 2f 0a 20 20 69  inning..  */.  i
37d0: 66 28 20 66 73 74 61 74 28 70 50 61 67 65 72 2d  f( fstat(pPager-
37e0: 3e 6a 66 64 2c 20 26 73 74 61 74 62 75 66 29 21  >jfd, &statbuf)!
37f0: 3d 30 20 29 7b 0a 20 20 20 20 72 65 74 75 72 6e  =0 ){.    return
3800: 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20 20 7d 0a   SQLITE_OK;.  }.
3810: 20 20 6e 52 65 63 20 3d 20 28 73 74 61 74 62 75    nRec = (statbu
3820: 66 2e 73 74 5f 73 69 7a 65 20 2d 20 28 73 69 7a  f.st_size - (siz
3830: 65 6f 66 28 61 4d 61 67 69 63 29 2b 73 69 7a 65  eof(aMagic)+size
3840: 6f 66 28 50 67 6e 6f 29 29 29 20 2f 20 73 69 7a  of(Pgno))) / siz
3850: 65 6f 66 28 50 61 67 65 52 65 63 6f 72 64 29 3b  eof(PageRecord);
3860: 0a 0a 20 20 2f 2a 20 50 72 6f 63 65 73 73 20 73  ..  /* Process s
3870: 65 67 6d 65 6e 74 73 20 62 65 67 69 6e 6e 69 6e  egments beginnin
3880: 67 20 77 69 74 68 20 74 68 65 20 6c 61 73 74 20  g with the last 
3890: 61 6e 64 20 77 6f 72 6b 69 6e 67 20 62 61 63 6b  and working back
38a0: 77 61 72 64 73 0a 20 20 2a 2a 20 74 6f 20 74 68  wards.  ** to th
38b0: 65 20 66 69 72 73 74 2e 0a 20 20 2a 2f 0a 20 20  e first..  */.  
38c0: 66 6f 72 28 69 3d 6e 52 65 63 2d 31 3b 20 69 3e  for(i=nRec-1; i>
38d0: 3d 30 3b 20 69 2d 2d 29 7b 0a 20 20 20 20 2f 2a  =0; i--){.    /*
38e0: 20 53 65 65 6b 20 74 6f 20 74 68 65 20 62 65 67   Seek to the beg
38f0: 69 6e 6e 69 6e 67 20 6f 66 20 74 68 65 20 73 65  inning of the se
3900: 67 6d 65 6e 74 20 2a 2f 0a 20 20 20 20 6f 66 66  gment */.    off
3910: 5f 74 20 6f 66 73 74 3b 0a 20 20 20 20 6f 66 73  _t ofst;.    ofs
3920: 74 20 3d 20 69 2a 73 69 7a 65 6f 66 28 50 61 67  t = i*sizeof(Pag
3930: 65 52 65 63 6f 72 64 29 20 2b 20 73 69 7a 65 6f  eRecord) + sizeo
3940: 66 28 61 4d 61 67 69 63 29 20 2b 20 73 69 7a 65  f(aMagic) + size
3950: 6f 66 28 50 67 6e 6f 29 3b 0a 20 20 20 20 72 63  of(Pgno);.    rc
3960: 20 3d 20 70 61 67 65 72 5f 73 65 65 6b 28 70 50   = pager_seek(pP
3970: 61 67 65 72 2d 3e 6a 66 64 2c 20 6f 66 73 74 29  ager->jfd, ofst)
3980: 3b 0a 20 20 20 20 69 66 28 20 72 63 21 3d 53 51  ;.    if( rc!=SQ
3990: 4c 49 54 45 5f 4f 4b 20 29 20 62 72 65 61 6b 3b  LITE_OK ) break;
39a0: 0a 20 20 20 20 72 63 20 3d 20 70 61 67 65 72 5f  .    rc = pager_
39b0: 72 65 61 64 28 70 50 61 67 65 72 2d 3e 6a 66 64  read(pPager->jfd
39c0: 2c 20 26 70 67 52 65 63 2c 20 73 69 7a 65 6f 66  , &pgRec, sizeof
39d0: 28 70 67 52 65 63 29 29 3b 0a 20 20 20 20 69 66  (pgRec));.    if
39e0: 28 20 72 63 21 3d 53 51 4c 49 54 45 5f 4f 4b 20  ( rc!=SQLITE_OK 
39f0: 29 20 62 72 65 61 6b 3b 0a 0a 20 20 20 20 2f 2a  ) break;..    /*
3a00: 20 53 61 6e 69 74 79 20 63 68 65 63 6b 69 6e 67   Sanity checking
3a10: 20 6f 6e 20 74 68 65 20 70 61 67 65 20 2a 2f 0a   on the page */.
3a20: 20 20 20 20 69 66 28 20 70 67 52 65 63 2e 70 67      if( pgRec.pg
3a30: 6e 6f 3e 6d 78 50 67 20 7c 7c 20 70 67 52 65 63  no>mxPg || pgRec
3a40: 2e 70 67 6e 6f 3d 3d 30 20 29 7b 0a 20 20 20 20  .pgno==0 ){.    
3a50: 20 20 72 63 20 3d 20 53 51 4c 49 54 45 5f 43 4f    rc = SQLITE_CO
3a60: 52 52 55 50 54 3b 0a 20 20 20 20 20 20 62 72 65  RRUPT;.      bre
3a70: 61 6b 3b 0a 20 20 20 20 7d 0a 0a 20 20 20 20 2f  ak;.    }..    /
3a80: 2a 20 50 6c 61 79 62 61 63 6b 20 74 68 65 20 70  * Playback the p
3a90: 61 67 65 2e 20 20 55 70 64 61 74 65 20 74 68 65  age.  Update the
3aa0: 20 69 6e 2d 6d 65 6d 6f 72 79 20 63 6f 70 79 20   in-memory copy 
3ab0: 6f 66 20 74 68 65 20 70 61 67 65 0a 20 20 20 20  of the page.    
3ac0: 2a 2a 20 61 74 20 74 68 65 20 73 61 6d 65 20 74  ** at the same t
3ad0: 69 6d 65 2c 20 69 66 20 74 68 65 72 65 20 69 73  ime, if there is
3ae0: 20 6f 6e 65 2e 0a 20 20 20 20 2a 2f 0a 20 20 20   one..    */.   
3af0: 20 70 50 67 20 3d 20 70 61 67 65 72 5f 6c 6f 6f   pPg = pager_loo
3b00: 6b 75 70 28 70 50 61 67 65 72 2c 20 70 67 52 65  kup(pPager, pgRe
3b10: 63 2e 70 67 6e 6f 29 3b 0a 20 20 20 20 69 66 28  c.pgno);.    if(
3b20: 20 70 50 67 20 29 7b 0a 20 20 20 20 20 20 6d 65   pPg ){.      me
3b30: 6d 63 70 79 28 50 47 48 44 52 5f 54 4f 5f 44 41  mcpy(PGHDR_TO_DA
3b40: 54 41 28 70 50 67 29 2c 20 70 67 52 65 63 2e 61  TA(pPg), pgRec.a
3b50: 44 61 74 61 2c 20 53 51 4c 49 54 45 5f 50 41 47  Data, SQLITE_PAG
3b60: 45 5f 53 49 5a 45 29 3b 0a 20 20 20 20 20 20 6d  E_SIZE);.      m
3b70: 65 6d 73 65 74 28 50 47 48 44 52 5f 54 4f 5f 45  emset(PGHDR_TO_E
3b80: 58 54 52 41 28 70 50 67 29 2c 20 30 2c 20 70 50  XTRA(pPg), 0, pP
3b90: 61 67 65 72 2d 3e 6e 45 78 74 72 61 29 3b 0a 20  ager->nExtra);. 
3ba0: 20 20 20 7d 0a 20 20 20 20 72 63 20 3d 20 70 61     }.    rc = pa
3bb0: 67 65 72 5f 73 65 65 6b 28 70 50 61 67 65 72 2d  ger_seek(pPager-
3bc0: 3e 66 64 2c 20 28 70 67 52 65 63 2e 70 67 6e 6f  >fd, (pgRec.pgno
3bd0: 2d 31 29 2a 53 51 4c 49 54 45 5f 50 41 47 45 5f  -1)*SQLITE_PAGE_
3be0: 53 49 5a 45 29 3b 0a 20 20 20 20 69 66 28 20 72  SIZE);.    if( r
3bf0: 63 21 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 20 62  c!=SQLITE_OK ) b
3c00: 72 65 61 6b 3b 0a 20 20 20 20 72 63 20 3d 20 70  reak;.    rc = p
3c10: 61 67 65 72 5f 77 72 69 74 65 28 70 50 61 67 65  ager_write(pPage
3c20: 72 2d 3e 66 64 2c 20 70 67 52 65 63 2e 61 44 61  r->fd, pgRec.aDa
3c30: 74 61 2c 20 53 51 4c 49 54 45 5f 50 41 47 45 5f  ta, SQLITE_PAGE_
3c40: 53 49 5a 45 29 3b 0a 20 20 20 20 69 66 28 20 72  SIZE);.    if( r
3c50: 63 21 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 20 62  c!=SQLITE_OK ) b
3c60: 72 65 61 6b 3b 0a 20 20 7d 0a 20 20 69 66 28 20  reak;.  }.  if( 
3c70: 72 63 21 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b  rc!=SQLITE_OK ){
3c80: 0a 20 20 20 20 70 61 67 65 72 5f 75 6e 77 72 69  .    pager_unwri
3c90: 74 65 6c 6f 63 6b 28 70 50 61 67 65 72 29 3b 0a  telock(pPager);.
3ca0: 20 20 20 20 70 50 61 67 65 72 2d 3e 65 72 72 4d      pPager->errM
3cb0: 61 73 6b 20 7c 3d 20 50 41 47 45 52 5f 45 52 52  ask |= PAGER_ERR
3cc0: 5f 43 4f 52 52 55 50 54 3b 0a 20 20 20 20 72 63  _CORRUPT;.    rc
3cd0: 20 3d 20 53 51 4c 49 54 45 5f 43 4f 52 52 55 50   = SQLITE_CORRUP
3ce0: 54 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20  T;.  }else{.    
3cf0: 72 63 20 3d 20 70 61 67 65 72 5f 75 6e 77 72 69  rc = pager_unwri
3d00: 74 65 6c 6f 63 6b 28 70 50 61 67 65 72 29 3b 0a  telock(pPager);.
3d10: 20 20 7d 0a 20 20 72 65 74 75 72 6e 20 72 63 3b    }.  return rc;
3d20: 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 4c 6f 63 61 74 65  .}../*.** Locate
3d30: 20 61 20 64 69 72 65 63 74 6f 72 79 20 77 68 65   a directory whe
3d40: 72 65 20 77 65 20 63 61 6e 20 70 6f 74 65 6e 74  re we can potent
3d50: 69 61 6c 6c 79 20 63 72 65 61 74 65 20 61 20 74  ially create a t
3d60: 65 6d 70 6f 72 61 72 79 0a 2a 2a 20 66 69 6c 65  emporary.** file
3d70: 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 63 6f 6e 73  ..*/.static cons
3d80: 74 20 63 68 61 72 20 2a 66 69 6e 64 54 65 6d 70  t char *findTemp
3d90: 44 69 72 28 76 6f 69 64 29 7b 0a 20 20 73 74 61  Dir(void){.  sta
3da0: 74 69 63 20 63 6f 6e 73 74 20 63 68 61 72 20 2a  tic const char *
3db0: 61 7a 44 69 72 73 5b 5d 20 3d 20 7b 0a 20 20 20  azDirs[] = {.   
3dc0: 20 20 22 2e 22 2c 0a 20 20 20 20 20 22 2f 76 61    ".",.     "/va
3dd0: 72 2f 74 6d 70 22 2c 0a 20 20 20 20 20 22 2f 75  r/tmp",.     "/u
3de0: 73 72 2f 74 6d 70 22 2c 0a 20 20 20 20 20 22 2f  sr/tmp",.     "/
3df0: 74 6d 70 22 2c 0a 20 20 20 20 20 22 2f 74 65 6d  tmp",.     "/tem
3e00: 70 22 2c 0a 20 20 20 20 20 22 2e 2f 74 65 6d 70  p",.     "./temp
3e10: 22 2c 0a 20 20 7d 3b 0a 20 20 69 6e 74 20 69 3b  ",.  };.  int i;
3e20: 0a 20 20 73 74 72 75 63 74 20 73 74 61 74 20 62  .  struct stat b
3e30: 75 66 3b 0a 20 20 66 6f 72 28 69 3d 30 3b 20 69  uf;.  for(i=0; i
3e40: 3c 73 69 7a 65 6f 66 28 61 7a 44 69 72 73 29 2f  <sizeof(azDirs)/
3e50: 73 69 7a 65 6f 66 28 61 7a 44 69 72 73 5b 30 5d  sizeof(azDirs[0]
3e60: 29 3b 20 69 2b 2b 29 7b 0a 20 20 20 20 69 66 28  ); i++){.    if(
3e70: 20 73 74 61 74 28 61 7a 44 69 72 73 5b 69 5d 2c   stat(azDirs[i],
3e80: 20 26 62 75 66 29 20 29 20 63 6f 6e 74 69 6e 75   &buf) ) continu
3e90: 65 3b 0a 20 20 20 20 69 66 28 20 21 53 5f 49 53  e;.    if( !S_IS
3ea0: 44 49 52 28 62 75 66 2e 73 74 5f 6d 6f 64 65 29  DIR(buf.st_mode)
3eb0: 20 29 20 63 6f 6e 74 69 6e 75 65 3b 0a 20 20 20   ) continue;.   
3ec0: 20 69 66 28 20 61 63 63 65 73 73 28 61 7a 44 69   if( access(azDi
3ed0: 72 73 5b 69 5d 2c 20 30 37 29 20 29 20 63 6f 6e  rs[i], 07) ) con
3ee0: 74 69 6e 75 65 3b 0a 20 20 20 20 72 65 74 75 72  tinue;.    retur
3ef0: 6e 20 61 7a 44 69 72 73 5b 69 5d 3b 0a 20 20 7d  n azDirs[i];.  }
3f00: 0a 20 20 72 65 74 75 72 6e 20 30 3b 0a 7d 0a 0a  .  return 0;.}..
3f10: 2f 2a 0a 2a 2a 20 43 72 65 61 74 65 20 61 20 6e  /*.** Create a n
3f20: 65 77 20 70 61 67 65 20 63 61 63 68 65 20 61 6e  ew page cache an
3f30: 64 20 70 75 74 20 61 20 70 6f 69 6e 74 65 72 20  d put a pointer 
3f40: 74 6f 20 74 68 65 20 70 61 67 65 20 63 61 63 68  to the page cach
3f50: 65 20 69 6e 20 2a 70 70 50 61 67 65 72 2e 0a 2a  e in *ppPager..*
3f60: 2a 20 54 68 65 20 66 69 6c 65 20 74 6f 20 62 65  * The file to be
3f70: 20 63 61 63 68 65 64 20 6e 65 65 64 20 6e 6f 74   cached need not
3f80: 20 65 78 69 73 74 2e 20 20 54 68 65 20 66 69 6c   exist.  The fil
3f90: 65 20 69 73 20 6e 6f 74 20 6c 6f 63 6b 65 64 20  e is not locked 
3fa0: 75 6e 74 69 6c 0a 2a 2a 20 74 68 65 20 66 69 72  until.** the fir
3fb0: 73 74 20 63 61 6c 6c 20 74 6f 20 73 71 6c 69 74  st call to sqlit
3fc0: 65 70 61 67 65 72 5f 67 65 74 28 29 20 61 6e 64  epager_get() and
3fd0: 20 69 73 20 6f 6e 6c 79 20 68 65 6c 64 20 6f 70   is only held op
3fe0: 65 6e 20 75 6e 74 69 6c 20 74 68 65 0a 2a 2a 20  en until the.** 
3ff0: 6c 61 73 74 20 70 61 67 65 20 69 73 20 72 65 6c  last page is rel
4000: 65 61 73 65 64 20 75 73 69 6e 67 20 73 71 6c 69  eased using sqli
4010: 74 65 70 61 67 65 72 5f 75 6e 72 65 66 28 29 2e  tepager_unref().
4020: 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 70 61  .*/.int sqlitepa
4030: 67 65 72 5f 6f 70 65 6e 28 0a 20 20 50 61 67 65  ger_open(.  Page
4040: 72 20 2a 2a 70 70 50 61 67 65 72 2c 20 20 20 20  r **ppPager,    
4050: 20 20 20 20 20 2f 2a 20 52 65 74 75 72 6e 20 74       /* Return t
4060: 68 65 20 50 61 67 65 72 20 73 74 72 75 63 74 75  he Pager structu
4070: 72 65 20 68 65 72 65 20 2a 2f 0a 20 20 63 6f 6e  re here */.  con
4080: 73 74 20 63 68 61 72 20 2a 7a 46 69 6c 65 6e 61  st char *zFilena
4090: 6d 65 2c 20 20 20 2f 2a 20 4e 61 6d 65 20 6f 66  me,   /* Name of
40a0: 20 74 68 65 20 64 61 74 61 62 61 73 65 20 66 69   the database fi
40b0: 6c 65 20 74 6f 20 6f 70 65 6e 20 2a 2f 0a 20 20  le to open */.  
40c0: 69 6e 74 20 6d 78 50 61 67 65 2c 20 20 20 20 20  int mxPage,     
40d0: 20 20 20 20 20 20 20 20 20 2f 2a 20 4d 61 78 20           /* Max 
40e0: 6e 75 6d 62 65 72 20 6f 66 20 69 6e 2d 6d 65 6d  number of in-mem
40f0: 6f 72 79 20 63 61 63 68 65 20 70 61 67 65 73 20  ory cache pages 
4100: 2a 2f 0a 20 20 69 6e 74 20 6e 45 78 74 72 61 20  */.  int nExtra 
4110: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a                /*
4120: 20 45 78 74 72 61 20 62 79 74 65 73 20 61 70 70   Extra bytes app
4130: 65 6e 64 20 74 6f 20 65 61 63 68 20 69 6e 2d 6d  end to each in-m
4140: 65 6d 6f 72 79 20 70 61 67 65 20 2a 2f 0a 29 7b  emory page */.){
4150: 0a 20 20 50 61 67 65 72 20 2a 70 50 61 67 65 72  .  Pager *pPager
4160: 3b 0a 20 20 69 6e 74 20 6e 61 6d 65 4c 65 6e 3b  ;.  int nameLen;
4170: 0a 20 20 69 6e 74 20 66 64 3b 0a 20 20 69 6e 74  .  int fd;.  int
4180: 20 74 65 6d 70 46 69 6c 65 3b 0a 20 20 69 6e 74   tempFile;.  int
4190: 20 72 65 61 64 4f 6e 6c 79 20 3d 20 30 3b 0a 20   readOnly = 0;. 
41a0: 20 63 68 61 72 20 7a 54 65 6d 70 5b 33 30 30 5d   char zTemp[300]
41b0: 3b 0a 0a 20 20 2a 70 70 50 61 67 65 72 20 3d 20  ;..  *ppPager = 
41c0: 30 3b 0a 20 20 69 66 28 20 73 71 6c 69 74 65 5f  0;.  if( sqlite_
41d0: 6d 61 6c 6c 6f 63 5f 66 61 69 6c 65 64 20 29 7b  malloc_failed ){
41e0: 0a 20 20 20 20 72 65 74 75 72 6e 20 53 51 4c 49  .    return SQLI
41f0: 54 45 5f 4e 4f 4d 45 4d 3b 0a 20 20 7d 0a 20 20  TE_NOMEM;.  }.  
4200: 69 66 28 20 7a 46 69 6c 65 6e 61 6d 65 20 29 7b  if( zFilename ){
4210: 0a 20 20 20 20 66 64 20 3d 20 6f 70 65 6e 28 7a  .    fd = open(z
4220: 46 69 6c 65 6e 61 6d 65 2c 20 4f 5f 52 44 57 52  Filename, O_RDWR
4230: 7c 4f 5f 43 52 45 41 54 2c 20 30 36 34 34 29 3b  |O_CREAT, 0644);
4240: 0a 20 20 20 20 69 66 28 20 66 64 3c 30 20 29 7b  .    if( fd<0 ){
4250: 0a 20 20 20 20 20 20 66 64 20 3d 20 6f 70 65 6e  .      fd = open
4260: 28 7a 46 69 6c 65 6e 61 6d 65 2c 20 4f 5f 52 44  (zFilename, O_RD
4270: 4f 4e 4c 59 2c 20 30 29 3b 0a 20 20 20 20 20 20  ONLY, 0);.      
4280: 72 65 61 64 4f 6e 6c 79 20 3d 20 31 3b 0a 20 20  readOnly = 1;.  
4290: 20 20 7d 0a 20 20 20 20 74 65 6d 70 46 69 6c 65    }.    tempFile
42a0: 20 3d 20 30 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20   = 0;.  }else{. 
42b0: 20 20 20 69 6e 74 20 63 6e 74 20 3d 20 38 3b 0a     int cnt = 8;.
42c0: 20 20 20 20 63 6f 6e 73 74 20 63 68 61 72 20 2a      const char *
42d0: 7a 44 69 72 20 3d 20 66 69 6e 64 54 65 6d 70 44  zDir = findTempD
42e0: 69 72 28 29 3b 0a 20 20 20 20 69 66 28 20 7a 44  ir();.    if( zD
42f0: 69 72 3d 3d 30 20 29 20 72 65 74 75 72 6e 20 53  ir==0 ) return S
4300: 51 4c 49 54 45 5f 43 41 4e 54 4f 50 45 4e 3b 0a  QLITE_CANTOPEN;.
4310: 20 20 20 20 64 6f 7b 0a 20 20 20 20 20 20 63 6e      do{.      cn
4320: 74 2d 2d 3b 0a 20 20 20 20 20 20 73 70 72 69 6e  t--;.      sprin
4330: 74 66 28 7a 54 65 6d 70 2c 22 25 73 2f 5f 73 71  tf(zTemp,"%s/_sq
4340: 6c 69 74 65 5f 25 75 22 2c 20 7a 44 69 72 2c 20  lite_%u", zDir, 
4350: 28 75 6e 73 69 67 6e 65 64 29 73 71 6c 69 74 65  (unsigned)sqlite
4360: 52 61 6e 64 6f 6d 49 6e 74 65 67 65 72 28 29 29  RandomInteger())
4370: 3b 0a 20 20 20 20 20 20 66 64 20 3d 20 6f 70 65  ;.      fd = ope
4380: 6e 28 7a 54 65 6d 70 2c 20 4f 5f 52 44 57 52 7c  n(zTemp, O_RDWR|
4390: 4f 5f 43 52 45 41 54 7c 4f 5f 45 58 43 4c 2c 20  O_CREAT|O_EXCL, 
43a0: 30 36 30 30 29 3b 0a 20 20 20 20 7d 77 68 69 6c  0600);.    }whil
43b0: 65 28 20 63 6e 74 3e 30 20 26 26 20 66 64 3c 30  e( cnt>0 && fd<0
43c0: 20 29 3b 0a 20 20 20 20 7a 46 69 6c 65 6e 61 6d   );.    zFilenam
43d0: 65 20 3d 20 7a 54 65 6d 70 3b 0a 20 20 20 20 74  e = zTemp;.    t
43e0: 65 6d 70 46 69 6c 65 20 3d 20 31 3b 0a 20 20 7d  empFile = 1;.  }
43f0: 0a 20 20 69 66 28 20 66 64 3c 30 20 29 7b 0a 20  .  if( fd<0 ){. 
4400: 20 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45     return SQLITE
4410: 5f 43 41 4e 54 4f 50 45 4e 3b 0a 20 20 7d 0a 20  _CANTOPEN;.  }. 
4420: 20 6e 61 6d 65 4c 65 6e 20 3d 20 73 74 72 6c 65   nameLen = strle
4430: 6e 28 7a 46 69 6c 65 6e 61 6d 65 29 3b 0a 20 20  n(zFilename);.  
4440: 70 50 61 67 65 72 20 3d 20 73 71 6c 69 74 65 4d  pPager = sqliteM
4450: 61 6c 6c 6f 63 28 20 73 69 7a 65 6f 66 28 2a 70  alloc( sizeof(*p
4460: 50 61 67 65 72 29 20 2b 20 6e 61 6d 65 4c 65 6e  Pager) + nameLen
4470: 2a 32 20 2b 20 33 30 20 29 3b 0a 20 20 69 66 28  *2 + 30 );.  if(
4480: 20 70 50 61 67 65 72 3d 3d 30 20 29 7b 0a 20 20   pPager==0 ){.  
4490: 20 20 63 6c 6f 73 65 28 66 64 29 3b 0a 20 20 20    close(fd);.   
44a0: 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4e   return SQLITE_N
44b0: 4f 4d 45 4d 3b 0a 20 20 7d 0a 20 20 70 50 61 67  OMEM;.  }.  pPag
44c0: 65 72 2d 3e 7a 46 69 6c 65 6e 61 6d 65 20 3d 20  er->zFilename = 
44d0: 28 63 68 61 72 2a 29 26 70 50 61 67 65 72 5b 31  (char*)&pPager[1
44e0: 5d 3b 0a 20 20 70 50 61 67 65 72 2d 3e 7a 4a 6f  ];.  pPager->zJo
44f0: 75 72 6e 61 6c 20 3d 20 26 70 50 61 67 65 72 2d  urnal = &pPager-
4500: 3e 7a 46 69 6c 65 6e 61 6d 65 5b 6e 61 6d 65 4c  >zFilename[nameL
4510: 65 6e 2b 31 5d 3b 0a 20 20 73 74 72 63 70 79 28  en+1];.  strcpy(
4520: 70 50 61 67 65 72 2d 3e 7a 46 69 6c 65 6e 61 6d  pPager->zFilenam
4530: 65 2c 20 7a 46 69 6c 65 6e 61 6d 65 29 3b 0a 20  e, zFilename);. 
4540: 20 73 74 72 63 70 79 28 70 50 61 67 65 72 2d 3e   strcpy(pPager->
4550: 7a 4a 6f 75 72 6e 61 6c 2c 20 7a 46 69 6c 65 6e  zJournal, zFilen
4560: 61 6d 65 29 3b 0a 20 20 73 74 72 63 70 79 28 26  ame);.  strcpy(&
4570: 70 50 61 67 65 72 2d 3e 7a 4a 6f 75 72 6e 61 6c  pPager->zJournal
4580: 5b 6e 61 6d 65 4c 65 6e 5d 2c 20 22 2d 6a 6f 75  [nameLen], "-jou
4590: 72 6e 61 6c 22 29 3b 0a 20 20 70 50 61 67 65 72  rnal");.  pPager
45a0: 2d 3e 66 64 20 3d 20 66 64 3b 0a 20 20 70 50 61  ->fd = fd;.  pPa
45b0: 67 65 72 2d 3e 6a 66 64 20 3d 20 2d 31 3b 0a 20  ger->jfd = -1;. 
45c0: 20 70 50 61 67 65 72 2d 3e 6e 52 65 66 20 3d 20   pPager->nRef = 
45d0: 30 3b 0a 20 20 70 50 61 67 65 72 2d 3e 64 62 53  0;.  pPager->dbS
45e0: 69 7a 65 20 3d 20 2d 31 3b 0a 20 20 70 50 61 67  ize = -1;.  pPag
45f0: 65 72 2d 3e 6e 50 61 67 65 20 3d 20 30 3b 0a 20  er->nPage = 0;. 
4600: 20 70 50 61 67 65 72 2d 3e 6d 78 50 61 67 65 20   pPager->mxPage 
4610: 3d 20 6d 78 50 61 67 65 3e 35 20 3f 20 6d 78 50  = mxPage>5 ? mxP
4620: 61 67 65 20 3a 20 31 30 3b 0a 20 20 70 50 61 67  age : 10;.  pPag
4630: 65 72 2d 3e 73 74 61 74 65 20 3d 20 53 51 4c 49  er->state = SQLI
4640: 54 45 5f 55 4e 4c 4f 43 4b 3b 0a 20 20 70 50 61  TE_UNLOCK;.  pPa
4650: 67 65 72 2d 3e 65 72 72 4d 61 73 6b 20 3d 20 30  ger->errMask = 0
4660: 3b 0a 20 20 70 50 61 67 65 72 2d 3e 74 65 6d 70  ;.  pPager->temp
4670: 46 69 6c 65 20 3d 20 74 65 6d 70 46 69 6c 65 3b  File = tempFile;
4680: 0a 20 20 70 50 61 67 65 72 2d 3e 72 65 61 64 4f  .  pPager->readO
4690: 6e 6c 79 20 3d 20 72 65 61 64 4f 6e 6c 79 3b 0a  nly = readOnly;.
46a0: 20 20 70 50 61 67 65 72 2d 3e 70 46 69 72 73 74    pPager->pFirst
46b0: 20 3d 20 30 3b 0a 20 20 70 50 61 67 65 72 2d 3e   = 0;.  pPager->
46c0: 70 4c 61 73 74 20 3d 20 30 3b 0a 20 20 70 50 61  pLast = 0;.  pPa
46d0: 67 65 72 2d 3e 6e 45 78 74 72 61 20 3d 20 6e 45  ger->nExtra = nE
46e0: 78 74 72 61 3b 0a 20 20 6d 65 6d 73 65 74 28 70  xtra;.  memset(p
46f0: 50 61 67 65 72 2d 3e 61 48 61 73 68 2c 20 30 2c  Pager->aHash, 0,
4700: 20 73 69 7a 65 6f 66 28 70 50 61 67 65 72 2d 3e   sizeof(pPager->
4710: 61 48 61 73 68 29 29 3b 0a 20 20 2a 70 70 50 61  aHash));.  *ppPa
4720: 67 65 72 20 3d 20 70 50 61 67 65 72 3b 0a 20 20  ger = pPager;.  
4730: 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b  return SQLITE_OK
4740: 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 53 65 74 20 74  ;.}../*.** Set t
4750: 68 65 20 64 65 73 74 72 75 63 74 6f 72 20 66 6f  he destructor fo
4760: 72 20 74 68 69 73 20 70 61 67 65 72 2e 20 20 49  r this pager.  I
4770: 66 20 6e 6f 74 20 4e 55 4c 4c 2c 20 74 68 65 20  f not NULL, the 
4780: 64 65 73 74 72 75 63 74 6f 72 20 69 73 20 63 61  destructor is ca
4790: 6c 6c 65 64 0a 2a 2a 20 77 68 65 6e 20 74 68 65  lled.** when the
47a0: 20 72 65 66 65 72 65 6e 63 65 20 63 6f 75 6e 74   reference count
47b0: 20 6f 6e 20 65 61 63 68 20 70 61 67 65 20 72 65   on each page re
47c0: 61 63 68 65 73 20 7a 65 72 6f 2e 20 20 54 68 65  aches zero.  The
47d0: 20 64 65 73 74 72 75 63 74 6f 72 20 63 61 6e 0a   destructor can.
47e0: 2a 2a 20 62 65 20 75 73 65 64 20 74 6f 20 63 6c  ** be used to cl
47f0: 65 61 6e 20 75 70 20 69 6e 66 6f 72 6d 61 74 69  ean up informati
4800: 6f 6e 20 69 6e 20 74 68 65 20 65 78 74 72 61 20  on in the extra 
4810: 73 65 67 6d 65 6e 74 20 61 70 70 65 6e 64 65 64  segment appended
4820: 20 74 6f 20 65 61 63 68 20 70 61 67 65 2e 0a 2a   to each page..*
4830: 2a 0a 2a 2a 20 54 68 65 20 64 65 73 74 72 75 63  *.** The destruc
4840: 74 6f 72 20 69 73 20 6e 6f 74 20 63 61 6c 6c 65  tor is not calle
4850: 64 20 61 73 20 61 20 72 65 73 75 6c 74 20 73 71  d as a result sq
4860: 6c 69 74 65 70 61 67 65 72 5f 63 6c 6f 73 65 28  litepager_close(
4870: 29 2e 20 20 0a 2a 2a 20 44 65 73 74 72 75 63 74  ).  .** Destruct
4880: 6f 72 73 20 61 72 65 20 6f 6e 6c 79 20 63 61 6c  ors are only cal
4890: 6c 65 64 20 62 79 20 73 71 6c 69 74 65 70 61 67  led by sqlitepag
48a0: 65 72 5f 75 6e 72 65 66 28 29 2e 0a 2a 2f 0a 76  er_unref()..*/.v
48b0: 6f 69 64 20 73 71 6c 69 74 65 70 61 67 65 72 5f  oid sqlitepager_
48c0: 73 65 74 5f 64 65 73 74 72 75 63 74 6f 72 28 50  set_destructor(P
48d0: 61 67 65 72 20 2a 70 50 61 67 65 72 2c 20 76 6f  ager *pPager, vo
48e0: 69 64 20 28 2a 78 44 65 73 63 29 28 76 6f 69 64  id (*xDesc)(void
48f0: 2a 29 29 7b 0a 20 20 70 50 61 67 65 72 2d 3e 78  *)){.  pPager->x
4900: 44 65 73 74 72 75 63 74 6f 72 20 3d 20 78 44 65  Destructor = xDe
4910: 73 63 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 52 65 74  sc;.}../*.** Ret
4920: 75 72 6e 20 74 68 65 20 74 6f 74 61 6c 20 6e 75  urn the total nu
4930: 6d 62 65 72 20 6f 66 20 70 61 67 65 73 20 69 6e  mber of pages in
4940: 20 74 68 65 20 64 69 73 6b 20 66 69 6c 65 20 61   the disk file a
4950: 73 73 6f 63 69 61 74 65 64 20 77 69 74 68 0a 2a  ssociated with.*
4960: 2a 20 70 50 61 67 65 72 2e 0a 2a 2f 0a 69 6e 74  * pPager..*/.int
4970: 20 73 71 6c 69 74 65 70 61 67 65 72 5f 70 61 67   sqlitepager_pag
4980: 65 63 6f 75 6e 74 28 50 61 67 65 72 20 2a 70 50  ecount(Pager *pP
4990: 61 67 65 72 29 7b 0a 20 20 69 6e 74 20 6e 3b 0a  ager){.  int n;.
49a0: 20 20 73 74 72 75 63 74 20 73 74 61 74 20 73 74    struct stat st
49b0: 61 74 62 75 66 3b 0a 20 20 61 73 73 65 72 74 28  atbuf;.  assert(
49c0: 20 70 50 61 67 65 72 21 3d 30 20 29 3b 0a 20 20   pPager!=0 );.  
49d0: 69 66 28 20 70 50 61 67 65 72 2d 3e 64 62 53 69  if( pPager->dbSi
49e0: 7a 65 3e 3d 30 20 29 7b 0a 20 20 20 20 72 65 74  ze>=0 ){.    ret
49f0: 75 72 6e 20 70 50 61 67 65 72 2d 3e 64 62 53 69  urn pPager->dbSi
4a00: 7a 65 3b 0a 20 20 7d 0a 20 20 69 66 28 20 66 73  ze;.  }.  if( fs
4a10: 74 61 74 28 70 50 61 67 65 72 2d 3e 66 64 2c 20  tat(pPager->fd, 
4a20: 26 73 74 61 74 62 75 66 29 21 3d 30 20 29 7b 0a  &statbuf)!=0 ){.
4a30: 20 20 20 20 6e 20 3d 20 30 3b 0a 20 20 7d 65 6c      n = 0;.  }el
4a40: 73 65 7b 0a 20 20 20 20 6e 20 3d 20 73 74 61 74  se{.    n = stat
4a50: 62 75 66 2e 73 74 5f 73 69 7a 65 2f 53 51 4c 49  buf.st_size/SQLI
4a60: 54 45 5f 50 41 47 45 5f 53 49 5a 45 3b 0a 20 20  TE_PAGE_SIZE;.  
4a70: 7d 0a 20 20 69 66 28 20 70 50 61 67 65 72 2d 3e  }.  if( pPager->
4a80: 73 74 61 74 65 21 3d 53 51 4c 49 54 45 5f 55 4e  state!=SQLITE_UN
4a90: 4c 4f 43 4b 20 29 7b 0a 20 20 20 20 70 50 61 67  LOCK ){.    pPag
4aa0: 65 72 2d 3e 64 62 53 69 7a 65 20 3d 20 6e 3b 0a  er->dbSize = n;.
4ab0: 20 20 7d 0a 20 20 72 65 74 75 72 6e 20 6e 3b 0a    }.  return n;.
4ac0: 7d 0a 0a 2f 2a 0a 2a 2a 20 53 68 75 74 64 6f 77  }../*.** Shutdow
4ad0: 6e 20 74 68 65 20 70 61 67 65 20 63 61 63 68 65  n the page cache
4ae0: 2e 20 20 46 72 65 65 20 61 6c 6c 20 6d 65 6d 6f  .  Free all memo
4af0: 72 79 20 61 6e 64 20 63 6c 6f 73 65 20 61 6c 6c  ry and close all
4b00: 20 66 69 6c 65 73 2e 0a 2a 2a 0a 2a 2a 20 49 66   files..**.** If
4b10: 20 61 20 74 72 61 6e 73 61 63 74 69 6f 6e 20 77   a transaction w
4b20: 61 73 20 69 6e 20 70 72 6f 67 72 65 73 73 20 77  as in progress w
4b30: 68 65 6e 20 74 68 69 73 20 72 6f 75 74 69 6e 65  hen this routine
4b40: 20 69 73 20 63 61 6c 6c 65 64 2c 20 74 68 61 74   is called, that
4b50: 0a 2a 2a 20 74 72 61 6e 73 61 63 74 69 6f 6e 20  .** transaction 
4b60: 69 73 20 72 6f 6c 6c 65 64 20 62 61 63 6b 2e 20  is rolled back. 
4b70: 20 41 6c 6c 20 6f 75 74 73 74 61 6e 64 69 6e 67   All outstanding
4b80: 20 70 61 67 65 73 20 61 72 65 20 69 6e 76 61 6c   pages are inval
4b90: 69 64 61 74 65 64 0a 2a 2a 20 61 6e 64 20 74 68  idated.** and th
4ba0: 65 69 72 20 6d 65 6d 6f 72 79 20 69 73 20 66 72  eir memory is fr
4bb0: 65 65 64 2e 20 20 41 6e 79 20 61 74 74 65 6d 70  eed.  Any attemp
4bc0: 74 20 74 6f 20 75 73 65 20 61 20 70 61 67 65 20  t to use a page 
4bd0: 61 73 73 6f 63 69 61 74 65 64 0a 2a 2a 20 77 69  associated.** wi
4be0: 74 68 20 74 68 69 73 20 70 61 67 65 20 63 61 63  th this page cac
4bf0: 68 65 20 61 66 74 65 72 20 74 68 69 73 20 66 75  he after this fu
4c00: 6e 63 74 69 6f 6e 20 72 65 74 75 72 6e 73 20 77  nction returns w
4c10: 69 6c 6c 20 6c 69 6b 65 6c 79 0a 2a 2a 20 72 65  ill likely.** re
4c20: 73 75 6c 74 20 69 6e 20 61 20 63 6f 72 65 64 75  sult in a coredu
4c30: 6d 70 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74  mp..*/.int sqlit
4c40: 65 70 61 67 65 72 5f 63 6c 6f 73 65 28 50 61 67  epager_close(Pag
4c50: 65 72 20 2a 70 50 61 67 65 72 29 7b 0a 20 20 50  er *pPager){.  P
4c60: 67 48 64 72 20 2a 70 50 67 2c 20 2a 70 4e 65 78  gHdr *pPg, *pNex
4c70: 74 3b 0a 20 20 73 77 69 74 63 68 28 20 70 50 61  t;.  switch( pPa
4c80: 67 65 72 2d 3e 73 74 61 74 65 20 29 7b 0a 20 20  ger->state ){.  
4c90: 20 20 63 61 73 65 20 53 51 4c 49 54 45 5f 57 52    case SQLITE_WR
4ca0: 49 54 45 4c 4f 43 4b 3a 20 7b 0a 20 20 20 20 20  ITELOCK: {.     
4cb0: 20 73 71 6c 69 74 65 70 61 67 65 72 5f 72 6f 6c   sqlitepager_rol
4cc0: 6c 62 61 63 6b 28 70 50 61 67 65 72 29 3b 0a 20  lback(pPager);. 
4cd0: 20 20 20 20 20 70 61 67 65 72 5f 75 6e 6c 6f 63       pager_unloc
4ce0: 6b 28 70 50 61 67 65 72 2d 3e 66 64 29 3b 0a 20  k(pPager->fd);. 
4cf0: 20 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 20       break;.    
4d00: 7d 0a 20 20 20 20 63 61 73 65 20 53 51 4c 49 54  }.    case SQLIT
4d10: 45 5f 52 45 41 44 4c 4f 43 4b 3a 20 7b 0a 20 20  E_READLOCK: {.  
4d20: 20 20 20 20 70 61 67 65 72 5f 75 6e 6c 6f 63 6b      pager_unlock
4d30: 28 70 50 61 67 65 72 2d 3e 66 64 29 3b 0a 20 20  (pPager->fd);.  
4d40: 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 7d      break;.    }
4d50: 0a 20 20 20 20 64 65 66 61 75 6c 74 3a 20 7b 0a  .    default: {.
4d60: 20 20 20 20 20 20 2f 2a 20 44 6f 20 6e 6f 74 68        /* Do noth
4d70: 69 6e 67 20 2a 2f 0a 20 20 20 20 20 20 62 72 65  ing */.      bre
4d80: 61 6b 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a 20 20  ak;.    }.  }.  
4d90: 66 6f 72 28 70 50 67 3d 70 50 61 67 65 72 2d 3e  for(pPg=pPager->
4da0: 70 41 6c 6c 3b 20 70 50 67 3b 20 70 50 67 3d 70  pAll; pPg; pPg=p
4db0: 4e 65 78 74 29 7b 0a 20 20 20 20 70 4e 65 78 74  Next){.    pNext
4dc0: 20 3d 20 70 50 67 2d 3e 70 4e 65 78 74 41 6c 6c   = pPg->pNextAll
4dd0: 3b 0a 20 20 20 20 73 71 6c 69 74 65 46 72 65 65  ;.    sqliteFree
4de0: 28 70 50 67 29 3b 0a 20 20 7d 0a 20 20 69 66 28  (pPg);.  }.  if(
4df0: 20 70 50 61 67 65 72 2d 3e 66 64 3e 3d 30 20 29   pPager->fd>=0 )
4e00: 20 63 6c 6f 73 65 28 70 50 61 67 65 72 2d 3e 66   close(pPager->f
4e10: 64 29 3b 0a 20 20 61 73 73 65 72 74 28 20 70 50  d);.  assert( pP
4e20: 61 67 65 72 2d 3e 6a 66 64 3c 30 20 29 3b 0a 20  ager->jfd<0 );. 
4e30: 20 69 66 28 20 70 50 61 67 65 72 2d 3e 74 65 6d   if( pPager->tem
4e40: 70 46 69 6c 65 20 29 7b 0a 20 20 20 20 75 6e 6c  pFile ){.    unl
4e50: 69 6e 6b 28 70 50 61 67 65 72 2d 3e 7a 46 69 6c  ink(pPager->zFil
4e60: 65 6e 61 6d 65 29 3b 0a 20 20 7d 0a 20 20 73 71  ename);.  }.  sq
4e70: 6c 69 74 65 46 72 65 65 28 70 50 61 67 65 72 29  liteFree(pPager)
4e80: 3b 0a 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54  ;.  return SQLIT
4e90: 45 5f 4f 4b 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 52  E_OK;.}../*.** R
4ea0: 65 74 75 72 6e 20 74 68 65 20 70 61 67 65 20 6e  eturn the page n
4eb0: 75 6d 62 65 72 20 66 6f 72 20 74 68 65 20 67 69  umber for the gi
4ec0: 76 65 6e 20 70 61 67 65 20 64 61 74 61 2e 0a 2a  ven page data..*
4ed0: 2f 0a 50 67 6e 6f 20 73 71 6c 69 74 65 70 61 67  /.Pgno sqlitepag
4ee0: 65 72 5f 70 61 67 65 6e 75 6d 62 65 72 28 76 6f  er_pagenumber(vo
4ef0: 69 64 20 2a 70 44 61 74 61 29 7b 0a 20 20 50 67  id *pData){.  Pg
4f00: 48 64 72 20 2a 70 20 3d 20 44 41 54 41 5f 54 4f  Hdr *p = DATA_TO
4f10: 5f 50 47 48 44 52 28 70 44 61 74 61 29 3b 0a 20  _PGHDR(pData);. 
4f20: 20 72 65 74 75 72 6e 20 70 2d 3e 70 67 6e 6f 3b   return p->pgno;
4f30: 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 49 6e 63 72 65 6d  .}../*.** Increm
4f40: 65 6e 74 20 74 68 65 20 72 65 66 65 72 65 6e 63  ent the referenc
4f50: 65 20 63 6f 75 6e 74 20 66 6f 72 20 61 20 70 61  e count for a pa
4f60: 67 65 2e 20 20 49 66 20 74 68 65 20 70 61 67 65  ge.  If the page
4f70: 20 69 73 0a 2a 2a 20 63 75 72 72 65 6e 74 6c 79   is.** currently
4f80: 20 6f 6e 20 74 68 65 20 66 72 65 65 6c 69 73 74   on the freelist
4f90: 20 28 74 68 65 20 72 65 66 65 72 65 6e 63 65 20   (the reference 
4fa0: 63 6f 75 6e 74 20 69 73 20 7a 65 72 6f 29 20 74  count is zero) t
4fb0: 68 65 6e 0a 2a 2a 20 72 65 6d 6f 76 65 20 69 74  hen.** remove it
4fc0: 20 66 72 6f 6d 20 74 68 65 20 66 72 65 65 6c 69   from the freeli
4fd0: 73 74 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 76 6f  st..*/.static vo
4fe0: 69 64 20 70 61 67 65 5f 72 65 66 28 50 67 48 64  id page_ref(PgHd
4ff0: 72 20 2a 70 50 67 29 7b 0a 20 20 69 66 28 20 70  r *pPg){.  if( p
5000: 50 67 2d 3e 6e 52 65 66 3d 3d 30 20 29 7b 0a 20  Pg->nRef==0 ){. 
5010: 20 20 20 2f 2a 20 54 68 65 20 70 61 67 65 20 69     /* The page i
5020: 73 20 63 75 72 72 65 6e 74 6c 79 20 6f 6e 20 74  s currently on t
5030: 68 65 20 66 72 65 65 6c 69 73 74 2e 20 20 52 65  he freelist.  Re
5040: 6d 6f 76 65 20 69 74 2e 20 2a 2f 0a 20 20 20 20  move it. */.    
5050: 69 66 28 20 70 50 67 2d 3e 70 50 72 65 76 46 72  if( pPg->pPrevFr
5060: 65 65 20 29 7b 0a 20 20 20 20 20 20 70 50 67 2d  ee ){.      pPg-
5070: 3e 70 50 72 65 76 46 72 65 65 2d 3e 70 4e 65 78  >pPrevFree->pNex
5080: 74 46 72 65 65 20 3d 20 70 50 67 2d 3e 70 4e 65  tFree = pPg->pNe
5090: 78 74 46 72 65 65 3b 0a 20 20 20 20 7d 65 6c 73  xtFree;.    }els
50a0: 65 7b 0a 20 20 20 20 20 20 70 50 67 2d 3e 70 50  e{.      pPg->pP
50b0: 61 67 65 72 2d 3e 70 46 69 72 73 74 20 3d 20 70  ager->pFirst = p
50c0: 50 67 2d 3e 70 4e 65 78 74 46 72 65 65 3b 0a 20  Pg->pNextFree;. 
50d0: 20 20 20 7d 0a 20 20 20 20 69 66 28 20 70 50 67     }.    if( pPg
50e0: 2d 3e 70 4e 65 78 74 46 72 65 65 20 29 7b 0a 20  ->pNextFree ){. 
50f0: 20 20 20 20 20 70 50 67 2d 3e 70 4e 65 78 74 46       pPg->pNextF
5100: 72 65 65 2d 3e 70 50 72 65 76 46 72 65 65 20 3d  ree->pPrevFree =
5110: 20 70 50 67 2d 3e 70 50 72 65 76 46 72 65 65 3b   pPg->pPrevFree;
5120: 0a 20 20 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20  .    }else{.    
5130: 20 20 70 50 67 2d 3e 70 50 61 67 65 72 2d 3e 70    pPg->pPager->p
5140: 4c 61 73 74 20 3d 20 70 50 67 2d 3e 70 50 72 65  Last = pPg->pPre
5150: 76 46 72 65 65 3b 0a 20 20 20 20 7d 0a 20 20 20  vFree;.    }.   
5160: 20 70 50 67 2d 3e 70 50 61 67 65 72 2d 3e 6e 52   pPg->pPager->nR
5170: 65 66 2b 2b 3b 0a 20 20 7d 0a 20 20 70 50 67 2d  ef++;.  }.  pPg-
5180: 3e 6e 52 65 66 2b 2b 3b 0a 20 20 52 45 46 49 4e  >nRef++;.  REFIN
5190: 46 4f 28 70 50 67 29 3b 0a 7d 0a 0a 2f 2a 0a 2a  FO(pPg);.}../*.*
51a0: 2a 20 49 6e 63 72 65 6d 65 6e 74 20 74 68 65 20  * Increment the 
51b0: 72 65 66 65 72 65 6e 63 65 20 63 6f 75 6e 74 20  reference count 
51c0: 66 6f 72 20 61 20 70 61 67 65 2e 20 20 54 68 65  for a page.  The
51d0: 20 69 6e 70 75 74 20 70 6f 69 6e 74 65 72 20 69   input pointer i
51e0: 73 0a 2a 2a 20 61 20 72 65 66 65 72 65 6e 63 65  s.** a reference
51f0: 20 74 6f 20 74 68 65 20 70 61 67 65 20 64 61 74   to the page dat
5200: 61 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65  a..*/.int sqlite
5210: 70 61 67 65 72 5f 72 65 66 28 76 6f 69 64 20 2a  pager_ref(void *
5220: 70 44 61 74 61 29 7b 0a 20 20 50 67 48 64 72 20  pData){.  PgHdr 
5230: 2a 70 50 67 20 3d 20 44 41 54 41 5f 54 4f 5f 50  *pPg = DATA_TO_P
5240: 47 48 44 52 28 70 44 61 74 61 29 3b 0a 20 20 70  GHDR(pData);.  p
5250: 61 67 65 5f 72 65 66 28 70 50 67 29 3b 0a 20 20  age_ref(pPg);.  
5260: 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b  return SQLITE_OK
5270: 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 41 63 71 75 69  ;.}../*.** Acqui
5280: 72 65 20 61 20 70 61 67 65 2e 0a 2a 2a 0a 2a 2a  re a page..**.**
5290: 20 41 20 72 65 61 64 20 6c 6f 63 6b 20 6f 6e 20   A read lock on 
52a0: 74 68 65 20 64 69 73 6b 20 66 69 6c 65 20 69 73  the disk file is
52b0: 20 6f 62 74 61 69 6e 65 64 20 77 68 65 6e 20 74   obtained when t
52c0: 68 65 20 66 69 72 73 74 20 70 61 67 65 20 61 63  he first page ac
52d0: 71 75 69 72 65 64 2e 20 0a 2a 2a 20 54 68 69 73  quired. .** This
52e0: 20 72 65 61 64 20 6c 6f 63 6b 20 69 73 20 64 72   read lock is dr
52f0: 6f 70 70 65 64 20 77 68 65 6e 20 74 68 65 20 6c  opped when the l
5300: 61 73 74 20 70 61 67 65 20 69 73 20 72 65 6c 65  ast page is rele
5310: 61 73 65 64 2e 0a 2a 2a 0a 2a 2a 20 41 20 5f 67  ased..**.** A _g
5320: 65 74 20 77 6f 72 6b 73 20 66 6f 72 20 61 6e 79  et works for any
5330: 20 70 61 67 65 20 6e 75 6d 62 65 72 20 67 72 65   page number gre
5340: 61 74 65 72 20 74 68 61 6e 20 30 2e 20 20 49 66  ater than 0.  If
5350: 20 74 68 65 20 64 61 74 61 62 61 73 65 0a 2a 2a   the database.**
5360: 20 66 69 6c 65 20 69 73 20 73 6d 61 6c 6c 65 72   file is smaller
5370: 20 74 68 61 6e 20 74 68 65 20 72 65 71 75 65 73   than the reques
5380: 74 65 64 20 70 61 67 65 2c 20 74 68 65 6e 20 6e  ted page, then n
5390: 6f 20 61 63 74 75 61 6c 20 64 69 73 6b 0a 2a 2a  o actual disk.**
53a0: 20 72 65 61 64 20 6f 63 63 75 72 73 20 61 6e 64   read occurs and
53b0: 20 74 68 65 20 6d 65 6d 6f 72 79 20 69 6d 61 67   the memory imag
53c0: 65 20 6f 66 20 74 68 65 20 70 61 67 65 20 69 73  e of the page is
53d0: 20 69 6e 69 74 69 61 6c 69 7a 65 64 20 74 6f 0a   initialized to.
53e0: 2a 2a 20 61 6c 6c 20 7a 65 72 6f 73 2e 20 20 54  ** all zeros.  T
53f0: 68 65 20 65 78 74 72 61 20 64 61 74 61 20 61 70  he extra data ap
5400: 70 65 6e 64 65 64 20 74 6f 20 61 20 70 61 67 65  pended to a page
5410: 20 69 73 20 61 6c 77 61 79 73 20 69 6e 69 74 69   is always initi
5420: 61 6c 69 7a 65 64 0a 2a 2a 20 74 6f 20 7a 65 72  alized.** to zer
5430: 6f 73 20 74 68 65 20 66 69 72 73 74 20 74 69 6d  os the first tim
5440: 65 20 61 20 70 61 67 65 20 69 73 20 6c 6f 61 64  e a page is load
5450: 65 64 20 69 6e 74 6f 20 6d 65 6d 6f 72 79 2e 0a  ed into memory..
5460: 2a 2a 0a 2a 2a 20 54 68 65 20 61 63 71 75 69 73  **.** The acquis
5470: 69 74 69 6f 6e 20 6d 69 67 68 74 20 66 61 69 6c  ition might fail
5480: 20 66 6f 72 20 73 65 76 65 72 61 6c 20 72 65 61   for several rea
5490: 73 6f 6e 73 2e 20 20 49 6e 20 61 6c 6c 20 63 61  sons.  In all ca
54a0: 73 65 73 2c 0a 2a 2a 20 61 6e 20 61 70 70 72 6f  ses,.** an appro
54b0: 70 72 69 61 74 65 20 65 72 72 6f 72 20 63 6f 64  priate error cod
54c0: 65 20 69 73 20 72 65 74 75 72 6e 65 64 20 61 6e  e is returned an
54d0: 64 20 2a 70 70 50 61 67 65 20 69 73 20 73 65 74  d *ppPage is set
54e0: 20 74 6f 20 4e 55 4c 4c 2e 0a 2a 2a 0a 2a 2a 20   to NULL..**.** 
54f0: 53 65 65 20 61 6c 73 6f 20 73 71 6c 69 74 65 70  See also sqlitep
5500: 61 67 65 72 5f 6c 6f 6f 6b 75 70 28 29 2e 20 20  ager_lookup().  
5510: 42 6f 74 68 20 74 68 69 73 20 72 6f 75 74 69 6e  Both this routin
5520: 65 20 61 6e 64 20 5f 6c 6f 6f 6b 75 70 28 29 20  e and _lookup() 
5530: 61 74 74 65 6d 70 74 0a 2a 2a 20 74 6f 20 66 69  attempt.** to fi
5540: 6e 64 20 61 20 70 61 67 65 20 69 6e 20 74 68 65  nd a page in the
5550: 20 69 6e 2d 6d 65 6d 6f 72 79 20 63 61 63 68 65   in-memory cache
5560: 20 66 69 72 73 74 2e 20 20 49 66 20 74 68 65 20   first.  If the 
5570: 70 61 67 65 20 69 73 20 6e 6f 74 20 61 6c 72 65  page is not alre
5580: 61 64 79 0a 2a 2a 20 69 6e 20 6d 65 6d 6f 72 79  ady.** in memory
5590: 2c 20 74 68 69 73 20 72 6f 75 74 69 6e 65 20 67  , this routine g
55a0: 6f 65 73 20 74 6f 20 64 69 73 6b 20 74 6f 20 72  oes to disk to r
55b0: 65 61 64 20 69 74 20 69 6e 20 77 68 65 72 65 61  ead it in wherea
55c0: 73 20 5f 6c 6f 6f 6b 75 70 28 29 0a 2a 2a 20 6a  s _lookup().** j
55d0: 75 73 74 20 72 65 74 75 72 6e 73 20 30 2e 20 20  ust returns 0.  
55e0: 54 68 69 73 20 72 6f 75 74 69 6e 65 20 61 63 71  This routine acq
55f0: 75 69 72 65 73 20 61 20 72 65 61 64 2d 6c 6f 63  uires a read-loc
5600: 6b 20 74 68 65 20 66 69 72 73 74 20 74 69 6d 65  k the first time
5610: 20 69 74 0a 2a 2a 20 68 61 73 20 74 6f 20 67 6f   it.** has to go
5620: 20 74 6f 20 64 69 73 6b 2c 20 61 6e 64 20 63 6f   to disk, and co
5630: 75 6c 64 20 61 6c 73 6f 20 70 6c 61 79 62 61 63  uld also playbac
5640: 6b 20 61 6e 20 6f 6c 64 20 6a 6f 75 72 6e 61 6c  k an old journal
5650: 20 69 66 20 6e 65 63 65 73 73 61 72 79 2e 0a 2a   if necessary..*
5660: 2a 20 53 69 6e 63 65 20 5f 6c 6f 6f 6b 75 70 28  * Since _lookup(
5670: 29 20 6e 65 76 65 72 20 67 6f 65 73 20 74 6f 20  ) never goes to 
5680: 64 69 73 6b 2c 20 69 74 20 6e 65 76 65 72 20 68  disk, it never h
5690: 61 73 20 74 6f 20 64 65 61 6c 20 77 69 74 68 20  as to deal with 
56a0: 6c 6f 63 6b 73 0a 2a 2a 20 6f 72 20 6a 6f 75 72  locks.** or jour
56b0: 6e 61 6c 20 66 69 6c 65 73 2e 0a 2a 2f 0a 69 6e  nal files..*/.in
56c0: 74 20 73 71 6c 69 74 65 70 61 67 65 72 5f 67 65  t sqlitepager_ge
56d0: 74 28 50 61 67 65 72 20 2a 70 50 61 67 65 72 2c  t(Pager *pPager,
56e0: 20 50 67 6e 6f 20 70 67 6e 6f 2c 20 76 6f 69 64   Pgno pgno, void
56f0: 20 2a 2a 70 70 50 61 67 65 29 7b 0a 20 20 50 67   **ppPage){.  Pg
5700: 48 64 72 20 2a 70 50 67 3b 0a 0a 20 20 2f 2a 20  Hdr *pPg;..  /* 
5710: 4d 61 6b 65 20 73 75 72 65 20 77 65 20 68 61 76  Make sure we hav
5720: 65 20 6e 6f 74 20 68 69 74 20 61 6e 79 20 63 72  e not hit any cr
5730: 69 74 69 63 61 6c 20 65 72 72 6f 72 73 2e 0a 20  itical errors.. 
5740: 20 2a 2f 20 0a 20 20 69 66 28 20 70 50 61 67 65   */ .  if( pPage
5750: 72 3d 3d 30 20 7c 7c 20 70 67 6e 6f 3d 3d 30 20  r==0 || pgno==0 
5760: 29 7b 0a 20 20 20 20 72 65 74 75 72 6e 20 53 51  ){.    return SQ
5770: 4c 49 54 45 5f 45 52 52 4f 52 3b 0a 20 20 7d 0a  LITE_ERROR;.  }.
5780: 20 20 69 66 28 20 70 50 61 67 65 72 2d 3e 65 72    if( pPager->er
5790: 72 4d 61 73 6b 20 26 20 7e 28 50 41 47 45 52 5f  rMask & ~(PAGER_
57a0: 45 52 52 5f 46 55 4c 4c 29 20 29 7b 0a 20 20 20  ERR_FULL) ){.   
57b0: 20 72 65 74 75 72 6e 20 70 61 67 65 72 5f 65 72   return pager_er
57c0: 72 63 6f 64 65 28 70 50 61 67 65 72 29 3b 0a 20  rcode(pPager);. 
57d0: 20 7d 0a 0a 20 20 2f 2a 20 49 66 20 74 68 69 73   }..  /* If this
57e0: 20 69 73 20 74 68 65 20 66 69 72 73 74 20 70 61   is the first pa
57f0: 67 65 20 61 63 63 65 73 73 65 64 2c 20 74 68 65  ge accessed, the
5800: 6e 20 67 65 74 20 61 20 72 65 61 64 20 6c 6f 63  n get a read loc
5810: 6b 0a 20 20 2a 2a 20 6f 6e 20 74 68 65 20 64 61  k.  ** on the da
5820: 74 61 62 61 73 65 20 66 69 6c 65 2e 0a 20 20 2a  tabase file..  *
5830: 2f 0a 20 20 69 66 28 20 70 50 61 67 65 72 2d 3e  /.  if( pPager->
5840: 6e 52 65 66 3d 3d 30 20 29 7b 0a 20 20 20 20 69  nRef==0 ){.    i
5850: 66 28 20 70 61 67 65 72 5f 6c 6f 63 6b 28 70 50  f( pager_lock(pP
5860: 61 67 65 72 2d 3e 66 64 2c 20 30 29 21 3d 30 20  ager->fd, 0)!=0 
5870: 29 7b 0a 20 20 20 20 20 20 2a 70 70 50 61 67 65  ){.      *ppPage
5880: 20 3d 20 30 3b 0a 20 20 20 20 20 20 72 65 74 75   = 0;.      retu
5890: 72 6e 20 53 51 4c 49 54 45 5f 42 55 53 59 3b 0a  rn SQLITE_BUSY;.
58a0: 20 20 20 20 7d 0a 20 20 20 20 70 50 61 67 65 72      }.    pPager
58b0: 2d 3e 73 74 61 74 65 20 3d 20 53 51 4c 49 54 45  ->state = SQLITE
58c0: 5f 52 45 41 44 4c 4f 43 4b 3b 0a 0a 20 20 20 20  _READLOCK;..    
58d0: 2f 2a 20 49 66 20 61 20 6a 6f 75 72 6e 61 6c 20  /* If a journal 
58e0: 66 69 6c 65 20 65 78 69 73 74 73 2c 20 74 72 79  file exists, try
58f0: 20 74 6f 20 70 6c 61 79 20 69 74 20 62 61 63 6b   to play it back
5900: 2e 0a 20 20 20 20 2a 2f 0a 20 20 20 20 69 66 28  ..    */.    if(
5910: 20 61 63 63 65 73 73 28 70 50 61 67 65 72 2d 3e   access(pPager->
5920: 7a 4a 6f 75 72 6e 61 6c 2c 30 29 3d 3d 30 20 29  zJournal,0)==0 )
5930: 7b 0a 20 20 20 20 20 20 20 69 6e 74 20 72 63 3b  {.       int rc;
5940: 0a 0a 20 20 20 20 20 20 20 2f 2a 20 4f 70 65 6e  ..       /* Open
5950: 20 74 68 65 20 6a 6f 75 72 6e 61 6c 20 66 6f 72   the journal for
5960: 20 65 78 63 6c 75 73 69 76 65 20 61 63 63 65 73   exclusive acces
5970: 73 2e 20 20 52 65 74 75 72 6e 20 53 51 4c 49 54  s.  Return SQLIT
5980: 45 5f 42 55 53 59 20 69 66 0a 20 20 20 20 20 20  E_BUSY if.      
5990: 20 2a 2a 20 77 65 20 63 61 6e 6e 6f 74 20 67 65   ** we cannot ge
59a0: 74 20 65 78 63 6c 75 73 69 76 65 20 61 63 63 65  t exclusive acce
59b0: 73 73 20 74 6f 20 74 68 65 20 6a 6f 75 72 6e 61  ss to the journa
59c0: 6c 20 66 69 6c 65 0a 20 20 20 20 20 20 20 2a 2f  l file.       */
59d0: 0a 20 20 20 20 20 20 20 70 50 61 67 65 72 2d 3e  .       pPager->
59e0: 6a 66 64 20 3d 20 6f 70 65 6e 28 70 50 61 67 65  jfd = open(pPage
59f0: 72 2d 3e 7a 4a 6f 75 72 6e 61 6c 2c 20 4f 5f 52  r->zJournal, O_R
5a00: 44 4f 4e 4c 59 2c 20 30 29 3b 0a 20 20 20 20 20  DONLY, 0);.     
5a10: 20 20 69 66 28 20 70 50 61 67 65 72 2d 3e 6a 66    if( pPager->jf
5a20: 64 3c 30 20 7c 7c 20 70 61 67 65 72 5f 6c 6f 63  d<0 || pager_loc
5a30: 6b 28 70 50 61 67 65 72 2d 3e 6a 66 64 2c 20 31  k(pPager->jfd, 1
5a40: 29 21 3d 30 20 29 7b 0a 20 20 20 20 20 20 20 20  )!=0 ){.        
5a50: 20 69 66 28 20 70 50 61 67 65 72 2d 3e 6a 66 64   if( pPager->jfd
5a60: 3e 3d 30 20 29 7b 20 63 6c 6f 73 65 28 70 50 61  >=0 ){ close(pPa
5a70: 67 65 72 2d 3e 6a 66 64 29 3b 20 70 50 61 67 65  ger->jfd); pPage
5a80: 72 2d 3e 6a 66 64 20 3d 20 2d 31 3b 20 7d 0a 20  r->jfd = -1; }. 
5a90: 20 20 20 20 20 20 20 20 70 61 67 65 72 5f 75 6e          pager_un
5aa0: 6c 6f 63 6b 28 70 50 61 67 65 72 2d 3e 66 64 29  lock(pPager->fd)
5ab0: 3b 0a 20 20 20 20 20 20 20 20 20 2a 70 70 50 61  ;.         *ppPa
5ac0: 67 65 20 3d 20 30 3b 0a 20 20 20 20 20 20 20 20  ge = 0;.        
5ad0: 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 42   return SQLITE_B
5ae0: 55 53 59 3b 0a 20 20 20 20 20 20 20 7d 0a 0a 20  USY;.       }.. 
5af0: 20 20 20 20 20 20 2f 2a 20 47 65 74 20 61 20 77        /* Get a w
5b00: 72 69 74 65 20 6c 6f 63 6b 20 6f 6e 20 74 68 65  rite lock on the
5b10: 20 64 61 74 61 62 61 73 65 20 2a 2f 0a 20 20 20   database */.   
5b20: 20 20 20 20 70 61 67 65 72 5f 75 6e 6c 6f 63 6b      pager_unlock
5b30: 28 70 50 61 67 65 72 2d 3e 66 64 29 3b 0a 20 20  (pPager->fd);.  
5b40: 20 20 20 20 20 69 66 28 20 70 61 67 65 72 5f 6c       if( pager_l
5b50: 6f 63 6b 28 70 50 61 67 65 72 2d 3e 66 64 2c 20  ock(pPager->fd, 
5b60: 31 29 21 3d 30 20 29 7b 0a 20 20 20 20 20 20 20  1)!=0 ){.       
5b70: 20 20 63 6c 6f 73 65 28 70 50 61 67 65 72 2d 3e    close(pPager->
5b80: 6a 66 64 29 3b 0a 20 20 20 20 20 20 20 20 20 70  jfd);.         p
5b90: 50 61 67 65 72 2d 3e 6a 66 64 20 3d 20 2d 31 3b  Pager->jfd = -1;
5ba0: 0a 20 20 20 20 20 20 20 20 20 2a 70 70 50 61 67  .         *ppPag
5bb0: 65 20 3d 20 30 3b 0a 20 20 20 20 20 20 20 20 20  e = 0;.         
5bc0: 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 50 52  return SQLITE_PR
5bd0: 4f 54 4f 43 4f 4c 3b 0a 20 20 20 20 20 20 20 7d  OTOCOL;.       }
5be0: 0a 0a 20 20 20 20 20 20 20 2f 2a 20 50 6c 61 79  ..       /* Play
5bf0: 62 61 63 6b 20 61 6e 64 20 64 65 6c 65 74 65 20  back and delete 
5c00: 74 68 65 20 6a 6f 75 72 6e 61 6c 2e 20 20 44 72  the journal.  Dr
5c10: 6f 70 20 74 68 65 20 64 61 74 61 62 61 73 65 20  op the database 
5c20: 77 72 69 74 65 0a 20 20 20 20 20 20 20 2a 2a 20  write.       ** 
5c30: 6c 6f 63 6b 20 61 6e 64 20 72 65 61 63 71 75 69  lock and reacqui
5c40: 72 65 20 74 68 65 20 72 65 61 64 20 6c 6f 63 6b  re the read lock
5c50: 2e 0a 20 20 20 20 20 20 20 2a 2f 0a 20 20 20 20  ..       */.    
5c60: 20 20 20 72 63 20 3d 20 70 61 67 65 72 5f 70 6c     rc = pager_pl
5c70: 61 79 62 61 63 6b 28 70 50 61 67 65 72 29 3b 0a  ayback(pPager);.
5c80: 20 20 20 20 20 20 20 69 66 28 20 72 63 21 3d 53         if( rc!=S
5c90: 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20  QLITE_OK ){.    
5ca0: 20 20 20 20 20 72 65 74 75 72 6e 20 72 63 3b 0a       return rc;.
5cb0: 20 20 20 20 20 20 20 7d 0a 20 20 20 20 7d 0a 20         }.    }. 
5cc0: 20 20 20 70 50 67 20 3d 20 30 3b 0a 20 20 7d 65     pPg = 0;.  }e
5cd0: 6c 73 65 7b 0a 20 20 20 20 2f 2a 20 53 65 61 72  lse{.    /* Sear
5ce0: 63 68 20 66 6f 72 20 70 61 67 65 20 69 6e 20 63  ch for page in c
5cf0: 61 63 68 65 20 2a 2f 0a 20 20 20 20 70 50 67 20  ache */.    pPg 
5d00: 3d 20 70 61 67 65 72 5f 6c 6f 6f 6b 75 70 28 70  = pager_lookup(p
5d10: 50 61 67 65 72 2c 20 70 67 6e 6f 29 3b 0a 20 20  Pager, pgno);.  
5d20: 7d 0a 20 20 69 66 28 20 70 50 67 3d 3d 30 20 29  }.  if( pPg==0 )
5d30: 7b 0a 20 20 20 20 2f 2a 20 54 68 65 20 72 65 71  {.    /* The req
5d40: 75 65 73 74 65 64 20 70 61 67 65 20 69 73 20 6e  uested page is n
5d50: 6f 74 20 69 6e 20 74 68 65 20 70 61 67 65 20 63  ot in the page c
5d60: 61 63 68 65 2e 20 2a 2f 0a 20 20 20 20 69 6e 74  ache. */.    int
5d70: 20 68 3b 0a 20 20 20 20 70 50 61 67 65 72 2d 3e   h;.    pPager->
5d80: 6e 4d 69 73 73 2b 2b 3b 0a 20 20 20 20 69 66 28  nMiss++;.    if(
5d90: 20 70 50 61 67 65 72 2d 3e 6e 50 61 67 65 3c 70   pPager->nPage<p
5da0: 50 61 67 65 72 2d 3e 6d 78 50 61 67 65 20 7c 7c  Pager->mxPage ||
5db0: 20 70 50 61 67 65 72 2d 3e 70 46 69 72 73 74 3d   pPager->pFirst=
5dc0: 3d 30 20 29 7b 0a 20 20 20 20 20 20 2f 2a 20 43  =0 ){.      /* C
5dd0: 72 65 61 74 65 20 61 20 6e 65 77 20 70 61 67 65  reate a new page
5de0: 20 2a 2f 0a 20 20 20 20 20 20 70 50 67 20 3d 20   */.      pPg = 
5df0: 73 71 6c 69 74 65 4d 61 6c 6c 6f 63 28 20 73 69  sqliteMalloc( si
5e00: 7a 65 6f 66 28 2a 70 50 67 29 20 2b 20 53 51 4c  zeof(*pPg) + SQL
5e10: 49 54 45 5f 50 41 47 45 5f 53 49 5a 45 20 2b 20  ITE_PAGE_SIZE + 
5e20: 70 50 61 67 65 72 2d 3e 6e 45 78 74 72 61 20 29  pPager->nExtra )
5e30: 3b 0a 20 20 20 20 20 20 69 66 28 20 70 50 67 3d  ;.      if( pPg=
5e40: 3d 30 20 29 7b 0a 20 20 20 20 20 20 20 20 2a 70  =0 ){.        *p
5e50: 70 50 61 67 65 20 3d 20 30 3b 0a 20 20 20 20 20  pPage = 0;.     
5e60: 20 20 20 70 61 67 65 72 5f 75 6e 77 72 69 74 65     pager_unwrite
5e70: 6c 6f 63 6b 28 70 50 61 67 65 72 29 3b 0a 20 20  lock(pPager);.  
5e80: 20 20 20 20 20 20 70 50 61 67 65 72 2d 3e 65 72        pPager->er
5e90: 72 4d 61 73 6b 20 7c 3d 20 50 41 47 45 52 5f 45  rMask |= PAGER_E
5ea0: 52 52 5f 4d 45 4d 3b 0a 20 20 20 20 20 20 20 20  RR_MEM;.        
5eb0: 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4e 4f  return SQLITE_NO
5ec0: 4d 45 4d 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20  MEM;.      }.   
5ed0: 20 20 20 70 50 67 2d 3e 70 50 61 67 65 72 20 3d     pPg->pPager =
5ee0: 20 70 50 61 67 65 72 3b 0a 20 20 20 20 20 20 70   pPager;.      p
5ef0: 50 67 2d 3e 70 4e 65 78 74 41 6c 6c 20 3d 20 70  Pg->pNextAll = p
5f00: 50 61 67 65 72 2d 3e 70 41 6c 6c 3b 0a 20 20 20  Pager->pAll;.   
5f10: 20 20 20 69 66 28 20 70 50 61 67 65 72 2d 3e 70     if( pPager->p
5f20: 41 6c 6c 20 29 7b 0a 20 20 20 20 20 20 20 20 70  All ){.        p
5f30: 50 61 67 65 72 2d 3e 70 41 6c 6c 2d 3e 70 50 72  Pager->pAll->pPr
5f40: 65 76 41 6c 6c 20 3d 20 70 50 67 3b 0a 20 20 20  evAll = pPg;.   
5f50: 20 20 20 7d 0a 20 20 20 20 20 20 70 50 67 2d 3e     }.      pPg->
5f60: 70 50 72 65 76 41 6c 6c 20 3d 20 30 3b 0a 20 20  pPrevAll = 0;.  
5f70: 20 20 20 20 70 50 61 67 65 72 2d 3e 70 41 6c 6c      pPager->pAll
5f80: 20 3d 20 70 50 67 3b 0a 20 20 20 20 20 20 70 50   = pPg;.      pP
5f90: 61 67 65 72 2d 3e 6e 50 61 67 65 2b 2b 3b 0a 20  ager->nPage++;. 
5fa0: 20 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 20 20     }else{.      
5fb0: 2f 2a 20 52 65 63 79 63 6c 65 20 61 6e 20 6f 6c  /* Recycle an ol
5fc0: 64 65 72 20 70 61 67 65 2e 20 20 46 69 72 73 74  der page.  First
5fd0: 20 6c 6f 63 61 74 65 20 74 68 65 20 70 61 67 65   locate the page
5fe0: 20 74 6f 20 62 65 20 72 65 63 79 63 6c 65 64 2e   to be recycled.
5ff0: 0a 20 20 20 20 20 20 2a 2a 20 54 72 79 20 74 6f  .      ** Try to
6000: 20 66 69 6e 64 20 6f 6e 65 20 74 68 61 74 20 69   find one that i
6010: 73 20 6e 6f 74 20 64 69 72 74 79 20 61 6e 64 20  s not dirty and 
6020: 69 73 20 6e 65 61 72 20 74 68 65 20 68 65 61 64  is near the head
6030: 20 6f 66 0a 20 20 20 20 20 20 2a 2a 20 6f 66 20   of.      ** of 
6040: 74 68 65 20 66 72 65 65 20 6c 69 73 74 20 2a 2f  the free list */
6050: 0a 20 20 20 20 20 20 69 6e 74 20 63 6e 74 20 3d  .      int cnt =
6060: 20 70 50 61 67 65 72 2d 3e 6d 78 50 61 67 65 2f   pPager->mxPage/
6070: 32 3b 0a 20 20 20 20 20 20 70 50 67 20 3d 20 70  2;.      pPg = p
6080: 50 61 67 65 72 2d 3e 70 46 69 72 73 74 3b 0a 20  Pager->pFirst;. 
6090: 20 20 20 20 20 77 68 69 6c 65 28 20 70 50 67 2d       while( pPg-
60a0: 3e 64 69 72 74 79 20 26 26 20 30 3c 63 6e 74 2d  >dirty && 0<cnt-
60b0: 2d 20 26 26 20 70 50 67 2d 3e 70 4e 65 78 74 46  - && pPg->pNextF
60c0: 72 65 65 20 29 7b 0a 20 20 20 20 20 20 20 20 70  ree ){.        p
60d0: 50 67 20 3d 20 70 50 67 2d 3e 70 4e 65 78 74 46  Pg = pPg->pNextF
60e0: 72 65 65 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20  ree;.      }.   
60f0: 20 20 20 69 66 28 20 70 50 67 3d 3d 30 20 7c 7c     if( pPg==0 ||
6100: 20 70 50 67 2d 3e 64 69 72 74 79 20 29 20 70 50   pPg->dirty ) pP
6110: 67 20 3d 20 70 50 61 67 65 72 2d 3e 70 46 69 72  g = pPager->pFir
6120: 73 74 3b 0a 20 20 20 20 20 20 61 73 73 65 72 74  st;.      assert
6130: 28 20 70 50 67 2d 3e 6e 52 65 66 3d 3d 30 20 29  ( pPg->nRef==0 )
6140: 3b 0a 0a 20 20 20 20 20 20 2f 2a 20 49 66 20 74  ;..      /* If t
6150: 68 65 20 70 61 67 65 20 74 6f 20 62 65 20 72 65  he page to be re
6160: 63 79 63 6c 65 64 20 69 73 20 64 69 72 74 79 2c  cycled is dirty,
6170: 20 73 79 6e 63 20 74 68 65 20 6a 6f 75 72 6e 61   sync the journa
6180: 6c 20 61 6e 64 20 77 72 69 74 65 20 0a 20 20 20  l and write .   
6190: 20 20 20 2a 2a 20 74 68 65 20 6f 6c 64 20 70 61     ** the old pa
61a0: 67 65 20 69 6e 74 6f 20 74 68 65 20 64 61 74 61  ge into the data
61b0: 62 61 73 65 2e 20 2a 2f 0a 20 20 20 20 20 20 69  base. */.      i
61c0: 66 28 20 70 50 67 2d 3e 64 69 72 74 79 20 29 7b  f( pPg->dirty ){
61d0: 0a 20 20 20 20 20 20 20 20 69 6e 74 20 72 63 3b  .        int rc;
61e0: 0a 20 20 20 20 20 20 20 20 61 73 73 65 72 74 28  .        assert(
61f0: 20 70 50 67 2d 3e 69 6e 4a 6f 75 72 6e 61 6c 3d   pPg->inJournal=
6200: 3d 31 20 29 3b 0a 20 20 20 20 20 20 20 20 61 73  =1 );.        as
6210: 73 65 72 74 28 20 70 50 61 67 65 72 2d 3e 73 74  sert( pPager->st
6220: 61 74 65 3d 3d 53 51 4c 49 54 45 5f 57 52 49 54  ate==SQLITE_WRIT
6230: 45 4c 4f 43 4b 20 29 3b 0a 20 20 20 20 20 20 20  ELOCK );.       
6240: 20 72 63 20 3d 20 66 73 79 6e 63 28 70 50 61 67   rc = fsync(pPag
6250: 65 72 2d 3e 6a 66 64 29 3b 0a 20 20 20 20 20 20  er->jfd);.      
6260: 20 20 69 66 28 20 72 63 21 3d 30 20 29 7b 0a 20    if( rc!=0 ){. 
6270: 20 20 20 20 20 20 20 20 20 72 63 20 3d 20 73 71           rc = sq
6280: 6c 69 74 65 70 61 67 65 72 5f 72 6f 6c 6c 62 61  litepager_rollba
6290: 63 6b 28 70 50 61 67 65 72 29 3b 0a 20 20 20 20  ck(pPager);.    
62a0: 20 20 20 20 20 20 2a 70 70 50 61 67 65 20 3d 20        *ppPage = 
62b0: 30 3b 0a 20 20 20 20 20 20 20 20 20 20 69 66 28  0;.          if(
62c0: 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 29   rc==SQLITE_OK )
62d0: 20 72 63 20 3d 20 53 51 4c 49 54 45 5f 49 4f 45   rc = SQLITE_IOE
62e0: 52 52 3b 0a 20 20 20 20 20 20 20 20 20 20 72 65  RR;.          re
62f0: 74 75 72 6e 20 72 63 3b 0a 20 20 20 20 20 20 20  turn rc;.       
6300: 20 7d 0a 20 20 20 20 20 20 20 20 70 61 67 65 72   }.        pager
6310: 5f 73 65 65 6b 28 70 50 61 67 65 72 2d 3e 66 64  _seek(pPager->fd
6320: 2c 20 28 70 50 67 2d 3e 70 67 6e 6f 2d 31 29 2a  , (pPg->pgno-1)*
6330: 53 51 4c 49 54 45 5f 50 41 47 45 5f 53 49 5a 45  SQLITE_PAGE_SIZE
6340: 29 3b 0a 20 20 20 20 20 20 20 20 72 63 20 3d 20  );.        rc = 
6350: 70 61 67 65 72 5f 77 72 69 74 65 28 70 50 61 67  pager_write(pPag
6360: 65 72 2d 3e 66 64 2c 20 50 47 48 44 52 5f 54 4f  er->fd, PGHDR_TO
6370: 5f 44 41 54 41 28 70 50 67 29 2c 20 53 51 4c 49  _DATA(pPg), SQLI
6380: 54 45 5f 50 41 47 45 5f 53 49 5a 45 29 3b 0a 20  TE_PAGE_SIZE);. 
6390: 20 20 20 20 20 20 20 69 66 28 20 72 63 21 3d 53         if( rc!=S
63a0: 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20  QLITE_OK ){.    
63b0: 20 20 20 20 20 20 72 63 20 3d 20 73 71 6c 69 74        rc = sqlit
63c0: 65 70 61 67 65 72 5f 72 6f 6c 6c 62 61 63 6b 28  epager_rollback(
63d0: 70 50 61 67 65 72 29 3b 0a 20 20 20 20 20 20 20  pPager);.       
63e0: 20 20 20 2a 70 70 50 61 67 65 20 3d 20 30 3b 0a     *ppPage = 0;.
63f0: 20 20 20 20 20 20 20 20 20 20 69 66 28 20 72 63            if( rc
6400: 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 20 72 63  ==SQLITE_OK ) rc
6410: 20 3d 20 53 51 4c 49 54 45 5f 46 55 4c 4c 3b 0a   = SQLITE_FULL;.
6420: 20 20 20 20 20 20 20 20 20 20 72 65 74 75 72 6e            return
6430: 20 72 63 3b 0a 20 20 20 20 20 20 20 20 7d 0a 20   rc;.        }. 
6440: 20 20 20 20 20 7d 0a 0a 20 20 20 20 20 20 2f 2a       }..      /*
6450: 20 55 6e 6c 69 6e 6b 20 74 68 65 20 6f 6c 64 20   Unlink the old 
6460: 70 61 67 65 20 66 72 6f 6d 20 74 68 65 20 66 72  page from the fr
6470: 65 65 20 6c 69 73 74 20 61 6e 64 20 74 68 65 20  ee list and the 
6480: 68 61 73 68 20 74 61 62 6c 65 0a 20 20 20 20 20  hash table.     
6490: 20 2a 2f 0a 20 20 20 20 20 20 69 66 28 20 70 50   */.      if( pP
64a0: 67 2d 3e 70 50 72 65 76 46 72 65 65 20 29 7b 0a  g->pPrevFree ){.
64b0: 20 20 20 20 20 20 20 20 70 50 67 2d 3e 70 50 72          pPg->pPr
64c0: 65 76 46 72 65 65 2d 3e 70 4e 65 78 74 46 72 65  evFree->pNextFre
64d0: 65 20 3d 20 70 50 67 2d 3e 70 4e 65 78 74 46 72  e = pPg->pNextFr
64e0: 65 65 3b 0a 20 20 20 20 20 20 7d 65 6c 73 65 7b  ee;.      }else{
64f0: 0a 20 20 20 20 20 20 20 20 61 73 73 65 72 74 28  .        assert(
6500: 20 70 50 61 67 65 72 2d 3e 70 46 69 72 73 74 3d   pPager->pFirst=
6510: 3d 70 50 67 20 29 3b 0a 20 20 20 20 20 20 20 20  =pPg );.        
6520: 70 50 61 67 65 72 2d 3e 70 46 69 72 73 74 20 3d  pPager->pFirst =
6530: 20 70 50 67 2d 3e 70 4e 65 78 74 46 72 65 65 3b   pPg->pNextFree;
6540: 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 69  .      }.      i
6550: 66 28 20 70 50 67 2d 3e 70 4e 65 78 74 46 72 65  f( pPg->pNextFre
6560: 65 20 29 7b 0a 20 20 20 20 20 20 20 20 70 50 67  e ){.        pPg
6570: 2d 3e 70 4e 65 78 74 46 72 65 65 2d 3e 70 50 72  ->pNextFree->pPr
6580: 65 76 46 72 65 65 20 3d 20 70 50 67 2d 3e 70 50  evFree = pPg->pP
6590: 72 65 76 46 72 65 65 3b 0a 20 20 20 20 20 20 7d  revFree;.      }
65a0: 65 6c 73 65 7b 0a 20 20 20 20 20 20 20 20 61 73  else{.        as
65b0: 73 65 72 74 28 20 70 50 61 67 65 72 2d 3e 70 4c  sert( pPager->pL
65c0: 61 73 74 3d 3d 70 50 67 20 29 3b 0a 20 20 20 20  ast==pPg );.    
65d0: 20 20 20 20 70 50 61 67 65 72 2d 3e 70 4c 61 73      pPager->pLas
65e0: 74 20 3d 20 70 50 67 2d 3e 70 50 72 65 76 46 72  t = pPg->pPrevFr
65f0: 65 65 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20 20  ee;.      }.    
6600: 20 20 70 50 67 2d 3e 70 4e 65 78 74 46 72 65 65    pPg->pNextFree
6610: 20 3d 20 70 50 67 2d 3e 70 50 72 65 76 46 72 65   = pPg->pPrevFre
6620: 65 20 3d 20 30 3b 0a 20 20 20 20 20 20 69 66 28  e = 0;.      if(
6630: 20 70 50 67 2d 3e 70 4e 65 78 74 48 61 73 68 20   pPg->pNextHash 
6640: 29 7b 0a 20 20 20 20 20 20 20 20 70 50 67 2d 3e  ){.        pPg->
6650: 70 4e 65 78 74 48 61 73 68 2d 3e 70 50 72 65 76  pNextHash->pPrev
6660: 48 61 73 68 20 3d 20 70 50 67 2d 3e 70 50 72 65  Hash = pPg->pPre
6670: 76 48 61 73 68 3b 0a 20 20 20 20 20 20 7d 0a 20  vHash;.      }. 
6680: 20 20 20 20 20 69 66 28 20 70 50 67 2d 3e 70 50       if( pPg->pP
6690: 72 65 76 48 61 73 68 20 29 7b 0a 20 20 20 20 20  revHash ){.     
66a0: 20 20 20 70 50 67 2d 3e 70 50 72 65 76 48 61 73     pPg->pPrevHas
66b0: 68 2d 3e 70 4e 65 78 74 48 61 73 68 20 3d 20 70  h->pNextHash = p
66c0: 50 67 2d 3e 70 4e 65 78 74 48 61 73 68 3b 0a 20  Pg->pNextHash;. 
66d0: 20 20 20 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20       }else{.    
66e0: 20 20 20 20 68 20 3d 20 70 61 67 65 72 5f 68 61      h = pager_ha
66f0: 73 68 28 70 50 67 2d 3e 70 67 6e 6f 29 3b 0a 20  sh(pPg->pgno);. 
6700: 20 20 20 20 20 20 20 61 73 73 65 72 74 28 20 70         assert( p
6710: 50 61 67 65 72 2d 3e 61 48 61 73 68 5b 68 5d 3d  Pager->aHash[h]=
6720: 3d 70 50 67 20 29 3b 0a 20 20 20 20 20 20 20 20  =pPg );.        
6730: 70 50 61 67 65 72 2d 3e 61 48 61 73 68 5b 68 5d  pPager->aHash[h]
6740: 20 3d 20 70 50 67 2d 3e 70 4e 65 78 74 48 61 73   = pPg->pNextHas
6750: 68 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 20  h;.      }.     
6760: 20 70 50 67 2d 3e 70 4e 65 78 74 48 61 73 68 20   pPg->pNextHash 
6770: 3d 20 70 50 67 2d 3e 70 50 72 65 76 48 61 73 68  = pPg->pPrevHash
6780: 20 3d 20 30 3b 0a 20 20 20 20 20 20 70 50 61 67   = 0;.      pPag
6790: 65 72 2d 3e 6e 4f 76 66 6c 2b 2b 3b 0a 20 20 20  er->nOvfl++;.   
67a0: 20 7d 0a 20 20 20 20 70 50 67 2d 3e 70 67 6e 6f   }.    pPg->pgno
67b0: 20 3d 20 70 67 6e 6f 3b 0a 20 20 20 20 69 66 28   = pgno;.    if(
67c0: 20 70 50 61 67 65 72 2d 3e 61 49 6e 4a 6f 75 72   pPager->aInJour
67d0: 6e 61 6c 20 26 26 20 70 67 6e 6f 3c 3d 70 50 61  nal && pgno<=pPa
67e0: 67 65 72 2d 3e 6f 72 69 67 44 62 53 69 7a 65 20  ger->origDbSize 
67f0: 29 7b 0a 20 20 20 20 20 20 70 50 67 2d 3e 69 6e  ){.      pPg->in
6800: 4a 6f 75 72 6e 61 6c 20 3d 20 28 70 50 61 67 65  Journal = (pPage
6810: 72 2d 3e 61 49 6e 4a 6f 75 72 6e 61 6c 5b 70 67  r->aInJournal[pg
6820: 6e 6f 2f 38 5d 20 26 20 28 31 3c 3c 28 70 67 6e  no/8] & (1<<(pgn
6830: 6f 26 37 29 29 29 21 3d 30 3b 0a 20 20 20 20 7d  o&7)))!=0;.    }
6840: 65 6c 73 65 7b 0a 20 20 20 20 20 20 70 50 67 2d  else{.      pPg-
6850: 3e 69 6e 4a 6f 75 72 6e 61 6c 20 3d 20 30 3b 0a  >inJournal = 0;.
6860: 20 20 20 20 7d 0a 20 20 20 20 70 50 67 2d 3e 64      }.    pPg->d
6870: 69 72 74 79 20 3d 20 30 3b 0a 20 20 20 20 70 50  irty = 0;.    pP
6880: 67 2d 3e 6e 52 65 66 20 3d 20 31 3b 0a 20 20 20  g->nRef = 1;.   
6890: 20 52 45 46 49 4e 46 4f 28 70 50 67 29 3b 0a 20   REFINFO(pPg);. 
68a0: 20 20 20 70 50 61 67 65 72 2d 3e 6e 52 65 66 2b     pPager->nRef+
68b0: 2b 3b 0a 20 20 20 20 68 20 3d 20 70 61 67 65 72  +;.    h = pager
68c0: 5f 68 61 73 68 28 70 67 6e 6f 29 3b 0a 20 20 20  _hash(pgno);.   
68d0: 20 70 50 67 2d 3e 70 4e 65 78 74 48 61 73 68 20   pPg->pNextHash 
68e0: 3d 20 70 50 61 67 65 72 2d 3e 61 48 61 73 68 5b  = pPager->aHash[
68f0: 68 5d 3b 0a 20 20 20 20 70 50 61 67 65 72 2d 3e  h];.    pPager->
6900: 61 48 61 73 68 5b 68 5d 20 3d 20 70 50 67 3b 0a  aHash[h] = pPg;.
6910: 20 20 20 20 69 66 28 20 70 50 67 2d 3e 70 4e 65      if( pPg->pNe
6920: 78 74 48 61 73 68 20 29 7b 0a 20 20 20 20 20 20  xtHash ){.      
6930: 61 73 73 65 72 74 28 20 70 50 67 2d 3e 70 4e 65  assert( pPg->pNe
6940: 78 74 48 61 73 68 2d 3e 70 50 72 65 76 48 61 73  xtHash->pPrevHas
6950: 68 3d 3d 30 20 29 3b 0a 20 20 20 20 20 20 70 50  h==0 );.      pP
6960: 67 2d 3e 70 4e 65 78 74 48 61 73 68 2d 3e 70 50  g->pNextHash->pP
6970: 72 65 76 48 61 73 68 20 3d 20 70 50 67 3b 0a 20  revHash = pPg;. 
6980: 20 20 20 7d 0a 20 20 20 20 69 66 28 20 70 50 61     }.    if( pPa
6990: 67 65 72 2d 3e 64 62 53 69 7a 65 3c 30 20 29 20  ger->dbSize<0 ) 
69a0: 73 71 6c 69 74 65 70 61 67 65 72 5f 70 61 67 65  sqlitepager_page
69b0: 63 6f 75 6e 74 28 70 50 61 67 65 72 29 3b 0a 20  count(pPager);. 
69c0: 20 20 20 69 66 28 20 70 50 61 67 65 72 2d 3e 64     if( pPager->d
69d0: 62 53 69 7a 65 3c 70 67 6e 6f 20 29 7b 0a 20 20  bSize<pgno ){.  
69e0: 20 20 20 20 6d 65 6d 73 65 74 28 50 47 48 44 52      memset(PGHDR
69f0: 5f 54 4f 5f 44 41 54 41 28 70 50 67 29 2c 20 30  _TO_DATA(pPg), 0
6a00: 2c 20 53 51 4c 49 54 45 5f 50 41 47 45 5f 53 49  , SQLITE_PAGE_SI
6a10: 5a 45 29 3b 0a 20 20 20 20 7d 65 6c 73 65 7b 0a  ZE);.    }else{.
6a20: 20 20 20 20 20 20 70 61 67 65 72 5f 73 65 65 6b        pager_seek
6a30: 28 70 50 61 67 65 72 2d 3e 66 64 2c 20 28 70 67  (pPager->fd, (pg
6a40: 6e 6f 2d 31 29 2a 53 51 4c 49 54 45 5f 50 41 47  no-1)*SQLITE_PAG
6a50: 45 5f 53 49 5a 45 29 3b 0a 20 20 20 20 20 20 70  E_SIZE);.      p
6a60: 61 67 65 72 5f 72 65 61 64 28 70 50 61 67 65 72  ager_read(pPager
6a70: 2d 3e 66 64 2c 20 50 47 48 44 52 5f 54 4f 5f 44  ->fd, PGHDR_TO_D
6a80: 41 54 41 28 70 50 67 29 2c 20 53 51 4c 49 54 45  ATA(pPg), SQLITE
6a90: 5f 50 41 47 45 5f 53 49 5a 45 29 3b 0a 20 20 20  _PAGE_SIZE);.   
6aa0: 20 7d 0a 20 20 20 20 69 66 28 20 70 50 61 67 65   }.    if( pPage
6ab0: 72 2d 3e 6e 45 78 74 72 61 3e 30 20 29 7b 0a 20  r->nExtra>0 ){. 
6ac0: 20 20 20 20 20 6d 65 6d 73 65 74 28 50 47 48 44       memset(PGHD
6ad0: 52 5f 54 4f 5f 45 58 54 52 41 28 70 50 67 29 2c  R_TO_EXTRA(pPg),
6ae0: 20 30 2c 20 70 50 61 67 65 72 2d 3e 6e 45 78 74   0, pPager->nExt
6af0: 72 61 29 3b 0a 20 20 20 20 7d 0a 20 20 7d 65 6c  ra);.    }.  }el
6b00: 73 65 7b 0a 20 20 20 20 2f 2a 20 54 68 65 20 72  se{.    /* The r
6b10: 65 71 75 65 73 74 65 64 20 70 61 67 65 20 69 73  equested page is
6b20: 20 69 6e 20 74 68 65 20 70 61 67 65 20 63 61 63   in the page cac
6b30: 68 65 2e 20 2a 2f 0a 20 20 20 20 70 50 61 67 65  he. */.    pPage
6b40: 72 2d 3e 6e 48 69 74 2b 2b 3b 0a 20 20 20 20 70  r->nHit++;.    p
6b50: 61 67 65 5f 72 65 66 28 70 50 67 29 3b 0a 20 20  age_ref(pPg);.  
6b60: 7d 0a 20 20 2a 70 70 50 61 67 65 20 3d 20 50 47  }.  *ppPage = PG
6b70: 48 44 52 5f 54 4f 5f 44 41 54 41 28 70 50 67 29  HDR_TO_DATA(pPg)
6b80: 3b 0a 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54  ;.  return SQLIT
6b90: 45 5f 4f 4b 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 41  E_OK;.}../*.** A
6ba0: 63 71 75 69 72 65 20 61 20 70 61 67 65 20 69 66  cquire a page if
6bb0: 20 69 74 20 69 73 20 61 6c 72 65 61 64 79 20 69   it is already i
6bc0: 6e 20 74 68 65 20 69 6e 2d 6d 65 6d 6f 72 79 20  n the in-memory 
6bd0: 63 61 63 68 65 2e 20 20 44 6f 0a 2a 2a 20 6e 6f  cache.  Do.** no
6be0: 74 20 72 65 61 64 20 74 68 65 20 70 61 67 65 20  t read the page 
6bf0: 66 72 6f 6d 20 64 69 73 6b 2e 20 20 52 65 74 75  from disk.  Retu
6c00: 72 6e 20 61 20 70 6f 69 6e 74 65 72 20 74 6f 20  rn a pointer to 
6c10: 74 68 65 20 70 61 67 65 2c 0a 2a 2a 20 6f 72 20  the page,.** or 
6c20: 30 20 69 66 20 74 68 65 20 70 61 67 65 20 69 73  0 if the page is
6c30: 20 6e 6f 74 20 69 6e 20 63 61 63 68 65 2e 0a 2a   not in cache..*
6c40: 2a 0a 2a 2a 20 53 65 65 20 61 6c 73 6f 20 73 71  *.** See also sq
6c50: 6c 69 74 65 70 61 67 65 72 5f 67 65 74 28 29 2e  litepager_get().
6c60: 20 20 54 68 65 20 64 69 66 66 65 72 65 6e 63 65    The difference
6c70: 20 62 65 74 77 65 65 6e 20 74 68 69 73 20 72 6f   between this ro
6c80: 75 74 69 6e 65 0a 2a 2a 20 61 6e 64 20 73 71 6c  utine.** and sql
6c90: 69 74 65 70 61 67 65 72 5f 67 65 74 28 29 20 69  itepager_get() i
6ca0: 73 20 74 68 61 74 20 5f 67 65 74 28 29 20 77 69  s that _get() wi
6cb0: 6c 6c 20 67 6f 20 74 6f 20 74 68 65 20 64 69 73  ll go to the dis
6cc0: 6b 20 61 6e 64 20 72 65 61 64 0a 2a 2a 20 69 6e  k and read.** in
6cd0: 20 74 68 65 20 70 61 67 65 20 69 66 20 74 68 65   the page if the
6ce0: 20 70 61 67 65 20 69 73 20 6e 6f 74 20 61 6c 72   page is not alr
6cf0: 65 61 64 79 20 69 6e 20 63 61 63 68 65 2e 20 20  eady in cache.  
6d00: 54 68 69 73 20 72 6f 75 74 69 6e 65 0a 2a 2a 20  This routine.** 
6d10: 72 65 74 75 72 6e 73 20 4e 55 4c 4c 20 69 66 20  returns NULL if 
6d20: 74 68 65 20 70 61 67 65 20 69 73 20 6e 6f 74 20  the page is not 
6d30: 69 6e 20 63 61 63 68 65 20 6f 72 20 69 66 20 61  in cache or if a
6d40: 20 64 69 73 6b 20 49 2f 4f 20 65 72 72 6f 72 20   disk I/O error 
6d50: 0a 2a 2a 20 68 61 73 20 65 76 65 72 20 68 61 70  .** has ever hap
6d60: 70 65 6e 65 64 2e 0a 2a 2f 0a 76 6f 69 64 20 2a  pened..*/.void *
6d70: 73 71 6c 69 74 65 70 61 67 65 72 5f 6c 6f 6f 6b  sqlitepager_look
6d80: 75 70 28 50 61 67 65 72 20 2a 70 50 61 67 65 72  up(Pager *pPager
6d90: 2c 20 50 67 6e 6f 20 70 67 6e 6f 29 7b 0a 20 20  , Pgno pgno){.  
6da0: 50 67 48 64 72 20 2a 70 50 67 3b 0a 0a 20 20 2f  PgHdr *pPg;..  /
6db0: 2a 20 4d 61 6b 65 20 73 75 72 65 20 77 65 20 68  * Make sure we h
6dc0: 61 76 65 20 6e 6f 74 20 68 69 74 20 61 6e 79 20  ave not hit any 
6dd0: 63 72 69 74 69 63 61 6c 20 65 72 72 6f 72 73 2e  critical errors.
6de0: 0a 20 20 2a 2f 20 0a 20 20 69 66 28 20 70 50 61  .  */ .  if( pPa
6df0: 67 65 72 3d 3d 30 20 7c 7c 20 70 67 6e 6f 3d 3d  ger==0 || pgno==
6e00: 30 20 29 7b 0a 20 20 20 20 72 65 74 75 72 6e 20  0 ){.    return 
6e10: 30 3b 0a 20 20 7d 0a 20 20 69 66 28 20 70 50 61  0;.  }.  if( pPa
6e20: 67 65 72 2d 3e 65 72 72 4d 61 73 6b 20 26 20 7e  ger->errMask & ~
6e30: 28 50 41 47 45 52 5f 45 52 52 5f 46 55 4c 4c 29  (PAGER_ERR_FULL)
6e40: 20 29 7b 0a 20 20 20 20 72 65 74 75 72 6e 20 30   ){.    return 0
6e50: 3b 0a 20 20 7d 0a 20 20 69 66 28 20 70 50 61 67  ;.  }.  if( pPag
6e60: 65 72 2d 3e 6e 52 65 66 3d 3d 30 20 29 7b 0a 20  er->nRef==0 ){. 
6e70: 20 20 20 72 65 74 75 72 6e 20 30 3b 0a 20 20 7d     return 0;.  }
6e80: 0a 20 20 70 50 67 20 3d 20 70 61 67 65 72 5f 6c  .  pPg = pager_l
6e90: 6f 6f 6b 75 70 28 70 50 61 67 65 72 2c 20 70 67  ookup(pPager, pg
6ea0: 6e 6f 29 3b 0a 20 20 69 66 28 20 70 50 67 3d 3d  no);.  if( pPg==
6eb0: 30 20 29 20 72 65 74 75 72 6e 20 30 3b 0a 20 20  0 ) return 0;.  
6ec0: 70 61 67 65 5f 72 65 66 28 70 50 67 29 3b 0a 20  page_ref(pPg);. 
6ed0: 20 72 65 74 75 72 6e 20 50 47 48 44 52 5f 54 4f   return PGHDR_TO
6ee0: 5f 44 41 54 41 28 70 50 67 29 3b 0a 7d 0a 0a 2f  _DATA(pPg);.}../
6ef0: 2a 0a 2a 2a 20 52 65 6c 65 61 73 65 20 61 20 70  *.** Release a p
6f00: 61 67 65 2e 0a 2a 2a 0a 2a 2a 20 49 66 20 74 68  age..**.** If th
6f10: 65 20 6e 75 6d 62 65 72 20 6f 66 20 72 65 66 65  e number of refe
6f20: 72 65 6e 63 65 73 20 74 6f 20 74 68 65 20 70 61  rences to the pa
6f30: 67 65 20 64 72 6f 70 20 74 6f 20 7a 65 72 6f 2c  ge drop to zero,
6f40: 20 74 68 65 6e 20 74 68 65 0a 2a 2a 20 70 61 67   then the.** pag
6f50: 65 20 69 73 20 61 64 64 65 64 20 74 6f 20 74 68  e is added to th
6f60: 65 20 4c 52 55 20 6c 69 73 74 2e 20 20 57 68 65  e LRU list.  Whe
6f70: 6e 20 61 6c 6c 20 72 65 66 65 72 65 6e 63 65 73  n all references
6f80: 20 74 6f 20 61 6c 6c 20 70 61 67 65 73 0a 2a 2a   to all pages.**
6f90: 20 61 72 65 20 72 65 6c 65 61 73 65 64 2c 20 61   are released, a
6fa0: 20 72 6f 6c 6c 62 61 63 6b 20 6f 63 63 75 72 73   rollback occurs
6fb0: 20 61 6e 64 20 74 68 65 20 6c 6f 63 6b 20 6f 6e   and the lock on
6fc0: 20 74 68 65 20 64 61 74 61 62 61 73 65 20 69 73   the database is
6fd0: 0a 2a 2a 20 72 65 6d 6f 76 65 64 2e 0a 2a 2f 0a  .** removed..*/.
6fe0: 69 6e 74 20 73 71 6c 69 74 65 70 61 67 65 72 5f  int sqlitepager_
6ff0: 75 6e 72 65 66 28 76 6f 69 64 20 2a 70 44 61 74  unref(void *pDat
7000: 61 29 7b 0a 20 20 50 61 67 65 72 20 2a 70 50 61  a){.  Pager *pPa
7010: 67 65 72 3b 0a 20 20 50 67 48 64 72 20 2a 70 50  ger;.  PgHdr *pP
7020: 67 3b 0a 0a 20 20 2f 2a 20 44 65 63 72 65 6d 65  g;..  /* Decreme
7030: 6e 74 20 74 68 65 20 72 65 66 65 72 65 6e 63 65  nt the reference
7040: 20 63 6f 75 6e 74 20 66 6f 72 20 74 68 69 73 20   count for this 
7050: 70 61 67 65 0a 20 20 2a 2f 0a 20 20 70 50 67 20  page.  */.  pPg 
7060: 3d 20 44 41 54 41 5f 54 4f 5f 50 47 48 44 52 28  = DATA_TO_PGHDR(
7070: 70 44 61 74 61 29 3b 0a 20 20 61 73 73 65 72 74  pData);.  assert
7080: 28 20 70 50 67 2d 3e 6e 52 65 66 3e 30 20 29 3b  ( pPg->nRef>0 );
7090: 0a 20 20 70 50 61 67 65 72 20 3d 20 70 50 67 2d  .  pPager = pPg-
70a0: 3e 70 50 61 67 65 72 3b 0a 20 20 70 50 67 2d 3e  >pPager;.  pPg->
70b0: 6e 52 65 66 2d 2d 3b 0a 20 20 52 45 46 49 4e 46  nRef--;.  REFINF
70c0: 4f 28 70 50 67 29 3b 0a 0a 20 20 2f 2a 20 57 68  O(pPg);..  /* Wh
70d0: 65 6e 20 74 68 65 20 6e 75 6d 62 65 72 20 6f 66  en the number of
70e0: 20 72 65 66 65 72 65 6e 63 65 73 20 74 6f 20 61   references to a
70f0: 20 70 61 67 65 20 72 65 61 63 68 20 30 2c 20 63   page reach 0, c
7100: 61 6c 6c 20 74 68 65 0a 20 20 2a 2a 20 64 65 73  all the.  ** des
7110: 74 72 75 63 74 6f 72 20 61 6e 64 20 61 64 64 20  tructor and add 
7120: 74 68 65 20 70 61 67 65 20 74 6f 20 74 68 65 20  the page to the 
7130: 66 72 65 65 6c 69 73 74 2e 0a 20 20 2a 2f 0a 20  freelist..  */. 
7140: 20 69 66 28 20 70 50 67 2d 3e 6e 52 65 66 3d 3d   if( pPg->nRef==
7150: 30 20 29 7b 0a 20 20 20 20 70 50 67 2d 3e 70 4e  0 ){.    pPg->pN
7160: 65 78 74 46 72 65 65 20 3d 20 30 3b 0a 20 20 20  extFree = 0;.   
7170: 20 70 50 67 2d 3e 70 50 72 65 76 46 72 65 65 20   pPg->pPrevFree 
7180: 3d 20 70 50 61 67 65 72 2d 3e 70 4c 61 73 74 3b  = pPager->pLast;
7190: 0a 20 20 20 20 70 50 61 67 65 72 2d 3e 70 4c 61  .    pPager->pLa
71a0: 73 74 20 3d 20 70 50 67 3b 0a 20 20 20 20 69 66  st = pPg;.    if
71b0: 28 20 70 50 67 2d 3e 70 50 72 65 76 46 72 65 65  ( pPg->pPrevFree
71c0: 20 29 7b 0a 20 20 20 20 20 20 70 50 67 2d 3e 70   ){.      pPg->p
71d0: 50 72 65 76 46 72 65 65 2d 3e 70 4e 65 78 74 46  PrevFree->pNextF
71e0: 72 65 65 20 3d 20 70 50 67 3b 0a 20 20 20 20 7d  ree = pPg;.    }
71f0: 65 6c 73 65 7b 0a 20 20 20 20 20 20 70 50 61 67  else{.      pPag
7200: 65 72 2d 3e 70 46 69 72 73 74 20 3d 20 70 50 67  er->pFirst = pPg
7210: 3b 0a 20 20 20 20 7d 0a 20 20 20 20 69 66 28 20  ;.    }.    if( 
7220: 70 50 61 67 65 72 2d 3e 78 44 65 73 74 72 75 63  pPager->xDestruc
7230: 74 6f 72 20 29 7b 0a 20 20 20 20 20 20 70 50 61  tor ){.      pPa
7240: 67 65 72 2d 3e 78 44 65 73 74 72 75 63 74 6f 72  ger->xDestructor
7250: 28 70 44 61 74 61 29 3b 0a 20 20 20 20 7d 0a 20  (pData);.    }. 
7260: 20 0a 20 20 20 20 2f 2a 20 57 68 65 6e 20 61 6c   .    /* When al
7270: 6c 20 70 61 67 65 73 20 72 65 61 63 68 20 74 68  l pages reach th
7280: 65 20 66 72 65 65 6c 69 73 74 2c 20 64 72 6f 70  e freelist, drop
7290: 20 74 68 65 20 72 65 61 64 20 6c 6f 63 6b 20 66   the read lock f
72a0: 72 6f 6d 0a 20 20 20 20 2a 2a 20 74 68 65 20 64  rom.    ** the d
72b0: 61 74 61 62 61 73 65 20 66 69 6c 65 2e 0a 20 20  atabase file..  
72c0: 20 20 2a 2f 0a 20 20 20 20 70 50 61 67 65 72 2d    */.    pPager-
72d0: 3e 6e 52 65 66 2d 2d 3b 0a 20 20 20 20 61 73 73  >nRef--;.    ass
72e0: 65 72 74 28 20 70 50 61 67 65 72 2d 3e 6e 52 65  ert( pPager->nRe
72f0: 66 3e 3d 30 20 29 3b 0a 20 20 20 20 69 66 28 20  f>=0 );.    if( 
7300: 70 50 61 67 65 72 2d 3e 6e 52 65 66 3d 3d 30 20  pPager->nRef==0 
7310: 29 7b 0a 20 20 20 20 20 20 70 61 67 65 72 5f 72  ){.      pager_r
7320: 65 73 65 74 28 70 50 61 67 65 72 29 3b 0a 20 20  eset(pPager);.  
7330: 20 20 7d 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e    }.  }.  return
7340: 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 7d 0a 0a 2f   SQLITE_OK;.}../
7350: 2a 0a 2a 2a 20 4d 61 72 6b 20 61 20 64 61 74 61  *.** Mark a data
7360: 20 70 61 67 65 20 61 73 20 77 72 69 74 65 61 62   page as writeab
7370: 6c 65 2e 20 20 54 68 65 20 70 61 67 65 20 69 73  le.  The page is
7380: 20 77 72 69 74 74 65 6e 20 69 6e 74 6f 20 74 68   written into th
7390: 65 20 6a 6f 75 72 6e 61 6c 20 0a 2a 2a 20 69 66  e journal .** if
73a0: 20 69 74 20 69 73 20 6e 6f 74 20 74 68 65 72 65   it is not there
73b0: 20 61 6c 72 65 61 64 79 2e 20 20 54 68 69 73 20   already.  This 
73c0: 72 6f 75 74 69 6e 65 20 6d 75 73 74 20 62 65 20  routine must be 
73d0: 63 61 6c 6c 65 64 20 62 65 66 6f 72 65 20 6d 61  called before ma
73e0: 6b 69 6e 67 0a 2a 2a 20 63 68 61 6e 67 65 73 20  king.** changes 
73f0: 74 6f 20 61 20 70 61 67 65 2e 0a 2a 2a 0a 2a 2a  to a page..**.**
7400: 20 54 68 65 20 66 69 72 73 74 20 74 69 6d 65 20   The first time 
7410: 74 68 69 73 20 72 6f 75 74 69 6e 65 20 69 73 20  this routine is 
7420: 63 61 6c 6c 65 64 2c 20 74 68 65 20 70 61 67 65  called, the page
7430: 72 20 63 72 65 61 74 65 73 20 61 20 6e 65 77 0a  r creates a new.
7440: 2a 2a 20 6a 6f 75 72 6e 61 6c 20 61 6e 64 20 61  ** journal and a
7450: 63 71 75 69 72 65 73 20 61 20 77 72 69 74 65 20  cquires a write 
7460: 6c 6f 63 6b 20 6f 6e 20 74 68 65 20 64 61 74 61  lock on the data
7470: 62 61 73 65 2e 20 20 49 66 20 74 68 65 20 77 72  base.  If the wr
7480: 69 74 65 0a 2a 2a 20 6c 6f 63 6b 20 63 6f 75 6c  ite.** lock coul
7490: 64 20 6e 6f 74 20 62 65 20 61 63 71 75 69 72 65  d not be acquire
74a0: 64 2c 20 74 68 69 73 20 72 6f 75 74 69 6e 65 20  d, this routine 
74b0: 72 65 74 75 72 6e 73 20 53 51 4c 49 54 45 5f 42  returns SQLITE_B
74c0: 55 53 59 2e 20 20 54 68 65 0a 2a 2a 20 63 61 6c  USY.  The.** cal
74d0: 6c 69 6e 67 20 72 6f 75 74 69 6e 65 20 6d 75 73  ling routine mus
74e0: 74 20 63 68 65 63 6b 20 66 6f 72 20 74 68 61 74  t check for that
74f0: 20 72 65 74 75 72 6e 20 76 61 6c 75 65 20 61 6e   return value an
7500: 64 20 62 65 20 63 61 72 65 66 75 6c 20 6e 6f 74  d be careful not
7510: 20 74 6f 0a 2a 2a 20 63 68 61 6e 67 65 20 61 6e   to.** change an
7520: 79 20 70 61 67 65 20 64 61 74 61 20 75 6e 74 69  y page data unti
7530: 6c 20 74 68 69 73 20 72 6f 75 74 69 6e 65 20 72  l this routine r
7540: 65 74 75 72 6e 73 20 53 51 4c 49 54 45 5f 4f 4b  eturns SQLITE_OK
7550: 2e 0a 2a 2a 0a 2a 2a 20 49 66 20 74 68 65 20 6a  ..**.** If the j
7560: 6f 75 72 6e 61 6c 20 66 69 6c 65 20 63 6f 75 6c  ournal file coul
7570: 64 20 6e 6f 74 20 62 65 20 77 72 69 74 74 65 6e  d not be written
7580: 20 62 65 63 61 75 73 65 20 74 68 65 20 64 69 73   because the dis
7590: 6b 20 69 73 20 66 75 6c 6c 2c 0a 2a 2a 20 74 68  k is full,.** th
75a0: 65 6e 20 74 68 69 73 20 72 6f 75 74 69 6e 65 20  en this routine 
75b0: 72 65 74 75 72 6e 73 20 53 51 4c 49 54 45 5f 46  returns SQLITE_F
75c0: 55 4c 4c 20 61 6e 64 20 64 6f 65 73 20 61 6e 20  ULL and does an 
75d0: 69 6d 6d 65 64 69 61 74 65 20 72 6f 6c 6c 62 61  immediate rollba
75e0: 63 6b 2e 0a 2a 2a 20 41 6c 6c 20 73 75 62 73 65  ck..** All subse
75f0: 71 75 65 6e 74 20 77 72 69 74 65 20 61 74 74 65  quent write atte
7600: 6d 70 74 73 20 61 6c 73 6f 20 72 65 74 75 72 6e  mpts also return
7610: 20 53 51 4c 49 54 45 5f 46 55 4c 4c 20 75 6e 74   SQLITE_FULL unt
7620: 69 6c 20 74 68 65 72 65 0a 2a 2a 20 69 73 20 61  il there.** is a
7630: 20 63 61 6c 6c 20 74 6f 20 73 71 6c 69 74 65 70   call to sqlitep
7640: 61 67 65 72 5f 63 6f 6d 6d 69 74 28 29 20 6f 72  ager_commit() or
7650: 20 73 71 6c 69 74 65 70 61 67 65 72 5f 72 6f 6c   sqlitepager_rol
7660: 6c 62 61 63 6b 28 29 20 74 6f 0a 2a 2a 20 72 65  lback() to.** re
7670: 73 65 74 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69  set..*/.int sqli
7680: 74 65 70 61 67 65 72 5f 77 72 69 74 65 28 76 6f  tepager_write(vo
7690: 69 64 20 2a 70 44 61 74 61 29 7b 0a 20 20 50 67  id *pData){.  Pg
76a0: 48 64 72 20 2a 70 50 67 20 3d 20 44 41 54 41 5f  Hdr *pPg = DATA_
76b0: 54 4f 5f 50 47 48 44 52 28 70 44 61 74 61 29 3b  TO_PGHDR(pData);
76c0: 0a 20 20 50 61 67 65 72 20 2a 70 50 61 67 65 72  .  Pager *pPager
76d0: 20 3d 20 70 50 67 2d 3e 70 50 61 67 65 72 3b 0a   = pPg->pPager;.
76e0: 20 20 69 6e 74 20 72 63 20 3d 20 53 51 4c 49 54    int rc = SQLIT
76f0: 45 5f 4f 4b 3b 0a 0a 20 20 69 66 28 20 70 50 61  E_OK;..  if( pPa
7700: 67 65 72 2d 3e 65 72 72 4d 61 73 6b 20 29 7b 20  ger->errMask ){ 
7710: 0a 20 20 20 20 72 65 74 75 72 6e 20 70 61 67 65  .    return page
7720: 72 5f 65 72 72 63 6f 64 65 28 70 50 61 67 65 72  r_errcode(pPager
7730: 29 3b 0a 20 20 7d 0a 20 20 69 66 28 20 70 50 61  );.  }.  if( pPa
7740: 67 65 72 2d 3e 72 65 61 64 4f 6e 6c 79 20 29 7b  ger->readOnly ){
7750: 0a 20 20 20 20 72 65 74 75 72 6e 20 53 51 4c 49  .    return SQLI
7760: 54 45 5f 50 45 52 4d 3b 0a 20 20 7d 0a 20 20 70  TE_PERM;.  }.  p
7770: 50 67 2d 3e 64 69 72 74 79 20 3d 20 31 3b 0a 20  Pg->dirty = 1;. 
7780: 20 69 66 28 20 70 50 67 2d 3e 69 6e 4a 6f 75 72   if( pPg->inJour
7790: 6e 61 6c 20 29 7b 20 72 65 74 75 72 6e 20 53 51  nal ){ return SQ
77a0: 4c 49 54 45 5f 4f 4b 3b 20 7d 0a 20 20 61 73 73  LITE_OK; }.  ass
77b0: 65 72 74 28 20 70 50 61 67 65 72 2d 3e 73 74 61  ert( pPager->sta
77c0: 74 65 21 3d 53 51 4c 49 54 45 5f 55 4e 4c 4f 43  te!=SQLITE_UNLOC
77d0: 4b 20 29 3b 0a 20 20 69 66 28 20 70 50 61 67 65  K );.  if( pPage
77e0: 72 2d 3e 73 74 61 74 65 3d 3d 53 51 4c 49 54 45  r->state==SQLITE
77f0: 5f 52 45 41 44 4c 4f 43 4b 20 29 7b 0a 20 20 20  _READLOCK ){.   
7800: 20 61 73 73 65 72 74 28 20 70 50 61 67 65 72 2d   assert( pPager-
7810: 3e 61 49 6e 4a 6f 75 72 6e 61 6c 3d 3d 30 20 29  >aInJournal==0 )
7820: 3b 0a 20 20 20 20 70 50 61 67 65 72 2d 3e 61 49  ;.    pPager->aI
7830: 6e 4a 6f 75 72 6e 61 6c 20 3d 20 73 71 6c 69 74  nJournal = sqlit
7840: 65 4d 61 6c 6c 6f 63 28 20 70 50 61 67 65 72 2d  eMalloc( pPager-
7850: 3e 64 62 53 69 7a 65 2f 38 20 2b 20 31 20 29 3b  >dbSize/8 + 1 );
7860: 0a 20 20 20 20 69 66 28 20 70 50 61 67 65 72 2d  .    if( pPager-
7870: 3e 61 49 6e 4a 6f 75 72 6e 61 6c 3d 3d 30 20 29  >aInJournal==0 )
7880: 7b 0a 20 20 20 20 20 20 72 65 74 75 72 6e 20 53  {.      return S
7890: 51 4c 49 54 45 5f 4e 4f 4d 45 4d 3b 0a 20 20 20  QLITE_NOMEM;.   
78a0: 20 7d 0a 20 20 20 20 70 50 61 67 65 72 2d 3e 6a   }.    pPager->j
78b0: 66 64 20 3d 20 6f 70 65 6e 28 70 50 61 67 65 72  fd = open(pPager
78c0: 2d 3e 7a 4a 6f 75 72 6e 61 6c 2c 20 4f 5f 52 44  ->zJournal, O_RD
78d0: 57 52 7c 4f 5f 43 52 45 41 54 2c 20 30 36 34 34  WR|O_CREAT, 0644
78e0: 29 3b 0a 20 20 20 20 69 66 28 20 70 50 61 67 65  );.    if( pPage
78f0: 72 2d 3e 6a 66 64 3c 30 20 29 7b 0a 20 20 20 20  r->jfd<0 ){.    
7900: 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f    return SQLITE_
7910: 43 41 4e 54 4f 50 45 4e 3b 0a 20 20 20 20 7d 0a  CANTOPEN;.    }.
7920: 20 20 20 20 69 66 28 20 70 61 67 65 72 5f 6c 6f      if( pager_lo
7930: 63 6b 28 70 50 61 67 65 72 2d 3e 6a 66 64 2c 20  ck(pPager->jfd, 
7940: 31 29 20 29 7b 0a 20 20 20 20 20 20 63 6c 6f 73  1) ){.      clos
7950: 65 28 70 50 61 67 65 72 2d 3e 6a 66 64 29 3b 0a  e(pPager->jfd);.
7960: 20 20 20 20 20 20 70 50 61 67 65 72 2d 3e 6a 66        pPager->jf
7970: 64 20 3d 20 2d 31 3b 0a 20 20 20 20 20 20 72 65  d = -1;.      re
7980: 74 75 72 6e 20 53 51 4c 49 54 45 5f 42 55 53 59  turn SQLITE_BUSY
7990: 3b 0a 20 20 20 20 7d 0a 20 20 20 20 70 61 67 65  ;.    }.    page
79a0: 72 5f 75 6e 6c 6f 63 6b 28 70 50 61 67 65 72 2d  r_unlock(pPager-
79b0: 3e 66 64 29 3b 0a 20 20 20 20 69 66 28 20 70 61  >fd);.    if( pa
79c0: 67 65 72 5f 6c 6f 63 6b 28 70 50 61 67 65 72 2d  ger_lock(pPager-
79d0: 3e 66 64 2c 20 31 29 20 29 7b 0a 20 20 20 20 20  >fd, 1) ){.     
79e0: 20 63 6c 6f 73 65 28 70 50 61 67 65 72 2d 3e 6a   close(pPager->j
79f0: 66 64 29 3b 0a 20 20 20 20 20 20 70 50 61 67 65  fd);.      pPage
7a00: 72 2d 3e 6a 66 64 20 3d 20 2d 31 3b 0a 20 20 20  r->jfd = -1;.   
7a10: 20 20 20 70 50 61 67 65 72 2d 3e 73 74 61 74 65     pPager->state
7a20: 20 3d 20 53 51 4c 49 54 45 5f 55 4e 4c 4f 43 4b   = SQLITE_UNLOCK
7a30: 3b 0a 20 20 20 20 20 20 70 50 61 67 65 72 2d 3e  ;.      pPager->
7a40: 65 72 72 4d 61 73 6b 20 7c 3d 20 50 41 47 45 52  errMask |= PAGER
7a50: 5f 45 52 52 5f 4c 4f 43 4b 3b 0a 20 20 20 20 20  _ERR_LOCK;.     
7a60: 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 50   return SQLITE_P
7a70: 52 4f 54 4f 43 4f 4c 3b 0a 20 20 20 20 7d 0a 20  ROTOCOL;.    }. 
7a80: 20 20 20 70 50 61 67 65 72 2d 3e 73 74 61 74 65     pPager->state
7a90: 20 3d 20 53 51 4c 49 54 45 5f 57 52 49 54 45 4c   = SQLITE_WRITEL
7aa0: 4f 43 4b 3b 0a 20 20 20 20 73 71 6c 69 74 65 70  OCK;.    sqlitep
7ab0: 61 67 65 72 5f 70 61 67 65 63 6f 75 6e 74 28 70  ager_pagecount(p
7ac0: 50 61 67 65 72 29 3b 0a 20 20 20 20 70 50 61 67  Pager);.    pPag
7ad0: 65 72 2d 3e 6f 72 69 67 44 62 53 69 7a 65 20 3d  er->origDbSize =
7ae0: 20 70 50 61 67 65 72 2d 3e 64 62 53 69 7a 65 3b   pPager->dbSize;
7af0: 0a 20 20 20 20 72 63 20 3d 20 70 61 67 65 72 5f  .    rc = pager_
7b00: 77 72 69 74 65 28 70 50 61 67 65 72 2d 3e 6a 66  write(pPager->jf
7b10: 64 2c 20 61 4a 6f 75 72 6e 61 6c 4d 61 67 69 63  d, aJournalMagic
7b20: 2c 20 73 69 7a 65 6f 66 28 61 4a 6f 75 72 6e 61  , sizeof(aJourna
7b30: 6c 4d 61 67 69 63 29 29 3b 0a 20 20 20 20 69 66  lMagic));.    if
7b40: 28 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20  ( rc==SQLITE_OK 
7b50: 29 7b 0a 20 20 20 20 20 20 72 63 20 3d 20 70 61  ){.      rc = pa
7b60: 67 65 72 5f 77 72 69 74 65 28 70 50 61 67 65 72  ger_write(pPager
7b70: 2d 3e 6a 66 64 2c 20 26 70 50 61 67 65 72 2d 3e  ->jfd, &pPager->
7b80: 64 62 53 69 7a 65 2c 20 73 69 7a 65 6f 66 28 50  dbSize, sizeof(P
7b90: 67 6e 6f 29 29 3b 0a 20 20 20 20 7d 0a 20 20 20  gno));.    }.   
7ba0: 20 69 66 28 20 72 63 21 3d 53 51 4c 49 54 45 5f   if( rc!=SQLITE_
7bb0: 4f 4b 20 29 7b 0a 20 20 20 20 20 20 72 63 20 3d  OK ){.      rc =
7bc0: 20 70 61 67 65 72 5f 75 6e 77 72 69 74 65 6c 6f   pager_unwritelo
7bd0: 63 6b 28 70 50 61 67 65 72 29 3b 0a 20 20 20 20  ck(pPager);.    
7be0: 20 20 69 66 28 20 72 63 3d 3d 53 51 4c 49 54 45    if( rc==SQLITE
7bf0: 5f 4f 4b 20 29 20 72 63 20 3d 20 53 51 4c 49 54  _OK ) rc = SQLIT
7c00: 45 5f 46 55 4c 4c 3b 0a 20 20 20 20 20 20 72 65  E_FULL;.      re
7c10: 74 75 72 6e 20 72 63 3b 0a 20 20 20 20 7d 0a 20  turn rc;.    }. 
7c20: 20 7d 0a 20 20 61 73 73 65 72 74 28 20 70 50 61   }.  assert( pPa
7c30: 67 65 72 2d 3e 73 74 61 74 65 3d 3d 53 51 4c 49  ger->state==SQLI
7c40: 54 45 5f 57 52 49 54 45 4c 4f 43 4b 20 29 3b 0a  TE_WRITELOCK );.
7c50: 20 20 61 73 73 65 72 74 28 20 70 50 61 67 65 72    assert( pPager
7c60: 2d 3e 6a 66 64 3e 3d 30 20 29 3b 0a 20 20 69 66  ->jfd>=0 );.  if
7c70: 28 20 70 50 67 2d 3e 70 67 6e 6f 20 3c 3d 20 70  ( pPg->pgno <= p
7c80: 50 61 67 65 72 2d 3e 6f 72 69 67 44 62 53 69 7a  Pager->origDbSiz
7c90: 65 20 29 7b 0a 20 20 20 20 72 63 20 3d 20 70 61  e ){.    rc = pa
7ca0: 67 65 72 5f 77 72 69 74 65 28 70 50 61 67 65 72  ger_write(pPager
7cb0: 2d 3e 6a 66 64 2c 20 26 70 50 67 2d 3e 70 67 6e  ->jfd, &pPg->pgn
7cc0: 6f 2c 20 73 69 7a 65 6f 66 28 50 67 6e 6f 29 29  o, sizeof(Pgno))
7cd0: 3b 0a 20 20 20 20 69 66 28 20 72 63 3d 3d 53 51  ;.    if( rc==SQ
7ce0: 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 20  LITE_OK ){.     
7cf0: 20 72 63 20 3d 20 70 61 67 65 72 5f 77 72 69 74   rc = pager_writ
7d00: 65 28 70 50 61 67 65 72 2d 3e 6a 66 64 2c 20 70  e(pPager->jfd, p
7d10: 44 61 74 61 2c 20 53 51 4c 49 54 45 5f 50 41 47  Data, SQLITE_PAG
7d20: 45 5f 53 49 5a 45 29 3b 0a 20 20 20 20 7d 0a 20  E_SIZE);.    }. 
7d30: 20 20 20 69 66 28 20 72 63 21 3d 53 51 4c 49 54     if( rc!=SQLIT
7d40: 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 20 20 73 71  E_OK ){.      sq
7d50: 6c 69 74 65 70 61 67 65 72 5f 72 6f 6c 6c 62 61  litepager_rollba
7d60: 63 6b 28 70 50 61 67 65 72 29 3b 0a 20 20 20 20  ck(pPager);.    
7d70: 20 20 70 50 61 67 65 72 2d 3e 65 72 72 4d 61 73    pPager->errMas
7d80: 6b 20 7c 3d 20 50 41 47 45 52 5f 45 52 52 5f 46  k |= PAGER_ERR_F
7d90: 55 4c 4c 3b 0a 20 20 20 20 20 20 72 65 74 75 72  ULL;.      retur
7da0: 6e 20 72 63 3b 0a 20 20 20 20 7d 0a 20 20 20 20  n rc;.    }.    
7db0: 61 73 73 65 72 74 28 20 70 50 61 67 65 72 2d 3e  assert( pPager->
7dc0: 61 49 6e 4a 6f 75 72 6e 61 6c 21 3d 30 20 29 3b  aInJournal!=0 );
7dd0: 0a 20 20 20 20 70 50 61 67 65 72 2d 3e 61 49 6e  .    pPager->aIn
7de0: 4a 6f 75 72 6e 61 6c 5b 70 50 67 2d 3e 70 67 6e  Journal[pPg->pgn
7df0: 6f 2f 38 5d 20 7c 3d 20 31 3c 3c 28 70 50 67 2d  o/8] |= 1<<(pPg-
7e00: 3e 70 67 6e 6f 26 37 29 3b 0a 20 20 7d 0a 20 20  >pgno&7);.  }.  
7e10: 70 50 67 2d 3e 69 6e 4a 6f 75 72 6e 61 6c 20 3d  pPg->inJournal =
7e20: 20 31 3b 0a 20 20 69 66 28 20 70 50 61 67 65 72   1;.  if( pPager
7e30: 2d 3e 64 62 53 69 7a 65 3c 70 50 67 2d 3e 70 67  ->dbSize<pPg->pg
7e40: 6e 6f 20 29 7b 0a 20 20 20 20 70 50 61 67 65 72  no ){.    pPager
7e50: 2d 3e 64 62 53 69 7a 65 20 3d 20 70 50 67 2d 3e  ->dbSize = pPg->
7e60: 70 67 6e 6f 3b 0a 20 20 7d 0a 20 20 72 65 74 75  pgno;.  }.  retu
7e70: 72 6e 20 72 63 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20  rn rc;.}../*.** 
7e80: 52 65 74 75 72 6e 20 54 52 55 45 20 69 66 20 74  Return TRUE if t
7e90: 68 65 20 70 61 67 65 20 67 69 76 65 6e 20 69 6e  he page given in
7ea0: 20 74 68 65 20 61 72 67 75 6d 65 6e 74 20 77 61   the argument wa
7eb0: 73 20 70 72 65 76 69 6f 75 73 20 70 61 73 73 65  s previous passe
7ec0: 64 0a 2a 2a 20 74 6f 20 73 71 6c 69 74 65 70 61  d.** to sqlitepa
7ed0: 67 65 72 5f 77 72 69 74 65 28 29 2e 20 20 49 6e  ger_write().  In
7ee0: 20 6f 74 68 65 72 20 77 6f 72 64 73 2c 20 72 65   other words, re
7ef0: 74 75 72 6e 20 54 52 55 45 20 69 66 20 69 74 20  turn TRUE if it 
7f00: 69 73 20 6f 6b 0a 2a 2a 20 74 6f 20 63 68 61 6e  is ok.** to chan
7f10: 67 65 20 74 68 65 20 63 6f 6e 74 65 6e 74 20 6f  ge the content o
7f20: 66 20 74 68 65 20 70 61 67 65 2e 0a 2a 2f 0a 69  f the page..*/.i
7f30: 6e 74 20 73 71 6c 69 74 65 70 61 67 65 72 5f 69  nt sqlitepager_i
7f40: 73 77 72 69 74 65 61 62 6c 65 28 76 6f 69 64 20  swriteable(void 
7f50: 2a 70 44 61 74 61 29 7b 0a 20 20 50 67 48 64 72  *pData){.  PgHdr
7f60: 20 2a 70 50 67 20 3d 20 44 41 54 41 5f 54 4f 5f   *pPg = DATA_TO_
7f70: 50 47 48 44 52 28 70 44 61 74 61 29 3b 0a 20 20  PGHDR(pData);.  
7f80: 72 65 74 75 72 6e 20 70 50 67 2d 3e 64 69 72 74  return pPg->dirt
7f90: 79 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 43 6f 6d 6d  y;.}../*.** Comm
7fa0: 69 74 20 61 6c 6c 20 63 68 61 6e 67 65 73 20 74  it all changes t
7fb0: 6f 20 74 68 65 20 64 61 74 61 62 61 73 65 20 61  o the database a
7fc0: 6e 64 20 72 65 6c 65 61 73 65 20 74 68 65 20 77  nd release the w
7fd0: 72 69 74 65 20 6c 6f 63 6b 2e 0a 2a 2a 0a 2a 2a  rite lock..**.**
7fe0: 20 49 66 20 74 68 65 20 63 6f 6d 6d 69 74 20 66   If the commit f
7ff0: 61 69 6c 73 20 66 6f 72 20 61 6e 79 20 72 65 61  ails for any rea
8000: 73 6f 6e 2c 20 61 20 72 6f 6c 6c 62 61 63 6b 20  son, a rollback 
8010: 61 74 74 65 6d 70 74 20 69 73 20 6d 61 64 65 0a  attempt is made.
8020: 2a 2a 20 61 6e 64 20 61 6e 20 65 72 72 6f 72 20  ** and an error 
8030: 63 6f 64 65 20 69 73 20 72 65 74 75 72 6e 65 64  code is returned
8040: 2e 20 20 49 66 20 74 68 65 20 63 6f 6d 6d 69 74  .  If the commit
8050: 20 77 6f 72 6b 65 64 2c 20 53 51 4c 49 54 45 5f   worked, SQLITE_
8060: 4f 4b 0a 2a 2a 20 69 73 20 72 65 74 75 72 6e 65  OK.** is returne
8070: 64 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65  d..*/.int sqlite
8080: 70 61 67 65 72 5f 63 6f 6d 6d 69 74 28 50 61 67  pager_commit(Pag
8090: 65 72 20 2a 70 50 61 67 65 72 29 7b 0a 20 20 69  er *pPager){.  i
80a0: 6e 74 20 72 63 3b 0a 20 20 50 67 48 64 72 20 2a  nt rc;.  PgHdr *
80b0: 70 50 67 3b 0a 0a 20 20 69 66 28 20 70 50 61 67  pPg;..  if( pPag
80c0: 65 72 2d 3e 65 72 72 4d 61 73 6b 3d 3d 50 41 47  er->errMask==PAG
80d0: 45 52 5f 45 52 52 5f 46 55 4c 4c 20 29 7b 0a 20  ER_ERR_FULL ){. 
80e0: 20 20 20 72 63 20 3d 20 73 71 6c 69 74 65 70 61     rc = sqlitepa
80f0: 67 65 72 5f 72 6f 6c 6c 62 61 63 6b 28 70 50 61  ger_rollback(pPa
8100: 67 65 72 29 3b 0a 20 20 20 20 69 66 28 20 72 63  ger);.    if( rc
8110: 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 20 72 63  ==SQLITE_OK ) rc
8120: 20 3d 20 53 51 4c 49 54 45 5f 46 55 4c 4c 3b 0a   = SQLITE_FULL;.
8130: 20 20 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 20      return rc;. 
8140: 20 7d 0a 20 20 69 66 28 20 70 50 61 67 65 72 2d   }.  if( pPager-
8150: 3e 65 72 72 4d 61 73 6b 21 3d 30 20 29 7b 0a 20  >errMask!=0 ){. 
8160: 20 20 20 72 63 20 3d 20 70 61 67 65 72 5f 65 72     rc = pager_er
8170: 72 63 6f 64 65 28 70 50 61 67 65 72 29 3b 0a 20  rcode(pPager);. 
8180: 20 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 20 20     return rc;.  
8190: 7d 0a 20 20 69 66 28 20 70 50 61 67 65 72 2d 3e  }.  if( pPager->
81a0: 73 74 61 74 65 21 3d 53 51 4c 49 54 45 5f 57 52  state!=SQLITE_WR
81b0: 49 54 45 4c 4f 43 4b 20 29 7b 0a 20 20 20 20 72  ITELOCK ){.    r
81c0: 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 45 52 52  eturn SQLITE_ERR
81d0: 4f 52 3b 0a 20 20 7d 0a 20 20 61 73 73 65 72 74  OR;.  }.  assert
81e0: 28 20 70 50 61 67 65 72 2d 3e 6a 66 64 3e 3d 30  ( pPager->jfd>=0
81f0: 20 29 3b 0a 20 20 69 66 28 20 66 73 79 6e 63 28   );.  if( fsync(
8200: 70 50 61 67 65 72 2d 3e 6a 66 64 29 20 29 7b 0a  pPager->jfd) ){.
8210: 20 20 20 20 67 6f 74 6f 20 63 6f 6d 6d 69 74 5f      goto commit_
8220: 61 62 6f 72 74 3b 0a 20 20 7d 0a 20 20 66 6f 72  abort;.  }.  for
8230: 28 70 50 67 3d 70 50 61 67 65 72 2d 3e 70 41 6c  (pPg=pPager->pAl
8240: 6c 3b 20 70 50 67 3b 20 70 50 67 3d 70 50 67 2d  l; pPg; pPg=pPg-
8250: 3e 70 4e 65 78 74 41 6c 6c 29 7b 0a 20 20 20 20  >pNextAll){.    
8260: 69 66 28 20 70 50 67 2d 3e 64 69 72 74 79 3d 3d  if( pPg->dirty==
8270: 30 20 29 20 63 6f 6e 74 69 6e 75 65 3b 0a 20 20  0 ) continue;.  
8280: 20 20 72 63 20 3d 20 70 61 67 65 72 5f 73 65 65    rc = pager_see
8290: 6b 28 70 50 61 67 65 72 2d 3e 66 64 2c 20 28 70  k(pPager->fd, (p
82a0: 50 67 2d 3e 70 67 6e 6f 2d 31 29 2a 53 51 4c 49  Pg->pgno-1)*SQLI
82b0: 54 45 5f 50 41 47 45 5f 53 49 5a 45 29 3b 0a 20  TE_PAGE_SIZE);. 
82c0: 20 20 20 69 66 28 20 72 63 21 3d 53 51 4c 49 54     if( rc!=SQLIT
82d0: 45 5f 4f 4b 20 29 20 67 6f 74 6f 20 63 6f 6d 6d  E_OK ) goto comm
82e0: 69 74 5f 61 62 6f 72 74 3b 0a 20 20 20 20 72 63  it_abort;.    rc
82f0: 20 3d 20 70 61 67 65 72 5f 77 72 69 74 65 28 70   = pager_write(p
8300: 50 61 67 65 72 2d 3e 66 64 2c 20 50 47 48 44 52  Pager->fd, PGHDR
8310: 5f 54 4f 5f 44 41 54 41 28 70 50 67 29 2c 20 53  _TO_DATA(pPg), S
8320: 51 4c 49 54 45 5f 50 41 47 45 5f 53 49 5a 45 29  QLITE_PAGE_SIZE)
8330: 3b 0a 20 20 20 20 69 66 28 20 72 63 21 3d 53 51  ;.    if( rc!=SQ
8340: 4c 49 54 45 5f 4f 4b 20 29 20 67 6f 74 6f 20 63  LITE_OK ) goto c
8350: 6f 6d 6d 69 74 5f 61 62 6f 72 74 3b 0a 20 20 7d  ommit_abort;.  }
8360: 0a 20 20 69 66 28 20 66 73 79 6e 63 28 70 50 61  .  if( fsync(pPa
8370: 67 65 72 2d 3e 66 64 29 20 29 20 67 6f 74 6f 20  ger->fd) ) goto 
8380: 63 6f 6d 6d 69 74 5f 61 62 6f 72 74 3b 0a 20 20  commit_abort;.  
8390: 72 63 20 3d 20 70 61 67 65 72 5f 75 6e 77 72 69  rc = pager_unwri
83a0: 74 65 6c 6f 63 6b 28 70 50 61 67 65 72 29 3b 0a  telock(pPager);.
83b0: 20 20 70 50 61 67 65 72 2d 3e 64 62 53 69 7a 65    pPager->dbSize
83c0: 20 3d 20 2d 31 3b 0a 20 20 72 65 74 75 72 6e 20   = -1;.  return 
83d0: 72 63 3b 0a 0a 20 20 2f 2a 20 4a 75 6d 70 20 68  rc;..  /* Jump h
83e0: 65 72 65 20 69 66 20 61 6e 79 74 68 69 6e 67 20  ere if anything 
83f0: 67 6f 65 73 20 77 72 6f 6e 67 20 64 75 72 69 6e  goes wrong durin
8400: 67 20 74 68 65 20 63 6f 6d 6d 69 74 20 70 72 6f  g the commit pro
8410: 63 65 73 73 2e 0a 20 20 2a 2f 0a 63 6f 6d 6d 69  cess..  */.commi
8420: 74 5f 61 62 6f 72 74 3a 0a 20 20 72 63 20 3d 20  t_abort:.  rc = 
8430: 73 71 6c 69 74 65 70 61 67 65 72 5f 72 6f 6c 6c  sqlitepager_roll
8440: 62 61 63 6b 28 70 50 61 67 65 72 29 3b 0a 20 20  back(pPager);.  
8450: 69 66 28 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4f  if( rc==SQLITE_O
8460: 4b 20 29 7b 0a 20 20 20 20 72 63 20 3d 20 53 51  K ){.    rc = SQ
8470: 4c 49 54 45 5f 46 55 4c 4c 3b 0a 20 20 7d 0a 20  LITE_FULL;.  }. 
8480: 20 72 65 74 75 72 6e 20 72 63 3b 0a 7d 0a 0a 2f   return rc;.}../
8490: 2a 0a 2a 2a 20 52 6f 6c 6c 62 61 63 6b 20 61 6c  *.** Rollback al
84a0: 6c 20 63 68 61 6e 67 65 73 2e 20 20 54 68 65 20  l changes.  The 
84b0: 64 61 74 61 62 61 73 65 20 66 61 6c 6c 73 20 62  database falls b
84c0: 61 63 6b 20 74 6f 20 72 65 61 64 2d 6f 6e 6c 79  ack to read-only
84d0: 20 6d 6f 64 65 2e 0a 2a 2a 20 41 6c 6c 20 69 6e   mode..** All in
84e0: 2d 6d 65 6d 6f 72 79 20 63 61 63 68 65 20 70 61  -memory cache pa
84f0: 67 65 73 20 72 65 76 65 72 74 20 74 6f 20 74 68  ges revert to th
8500: 65 69 72 20 6f 72 69 67 69 6e 61 6c 20 64 61 74  eir original dat
8510: 61 20 63 6f 6e 74 65 6e 74 73 2e 0a 2a 2a 20 54  a contents..** T
8520: 68 65 20 6a 6f 75 72 6e 61 6c 20 69 73 20 64 65  he journal is de
8530: 6c 65 74 65 64 2e 0a 2a 2a 0a 2a 2a 20 54 68 69  leted..**.** Thi
8540: 73 20 72 6f 75 74 69 6e 65 20 63 61 6e 6e 6f 74  s routine cannot
8550: 20 66 61 69 6c 20 75 6e 6c 65 73 73 20 73 6f 6d   fail unless som
8560: 65 20 6f 74 68 65 72 20 70 72 6f 63 65 73 73 20  e other process 
8570: 69 73 20 6e 6f 74 20 66 6f 6c 6c 6f 77 69 6e 67  is not following
8580: 0a 2a 2a 20 74 68 65 20 63 6f 72 72 65 63 74 20  .** the correct 
8590: 6c 6f 63 6b 69 6e 67 20 70 72 6f 74 6f 63 6f 6c  locking protocol
85a0: 20 28 53 51 4c 49 54 45 5f 50 52 4f 54 4f 43 4f   (SQLITE_PROTOCO
85b0: 4c 29 20 6f 72 20 75 6e 6c 65 73 73 20 73 6f 6d  L) or unless som
85c0: 65 20 6f 74 68 65 72 0a 2a 2a 20 70 72 6f 63 65  e other.** proce
85d0: 73 73 20 69 73 20 77 72 69 74 69 6e 67 20 74 72  ss is writing tr
85e0: 61 73 68 20 69 6e 74 6f 20 74 68 65 20 6a 6f 75  ash into the jou
85f0: 72 6e 61 6c 20 66 69 6c 65 20 28 53 51 4c 49 54  rnal file (SQLIT
8600: 45 5f 43 4f 52 52 55 50 54 29 20 6f 72 0a 2a 2a  E_CORRUPT) or.**
8610: 20 75 6e 6c 65 73 73 20 61 20 70 72 69 6f 72 20   unless a prior 
8620: 6d 61 6c 6c 6f 63 28 29 20 66 61 69 6c 65 64 20  malloc() failed 
8630: 28 53 51 4c 49 54 45 5f 4e 4f 4d 45 4d 29 2e 20  (SQLITE_NOMEM). 
8640: 20 41 70 70 72 6f 70 72 69 61 74 65 20 65 72 72   Appropriate err
8650: 6f 72 0a 2a 2a 20 63 6f 64 65 73 20 61 72 65 20  or.** codes are 
8660: 72 65 74 75 72 6e 65 64 20 66 6f 72 20 61 6c 6c  returned for all
8670: 20 74 68 65 73 65 20 6f 63 63 61 73 69 6f 6e 73   these occasions
8680: 2e 20 20 4f 74 68 65 72 77 69 73 65 2c 0a 2a 2a  .  Otherwise,.**
8690: 20 53 51 4c 49 54 45 5f 4f 4b 20 69 73 20 72 65   SQLITE_OK is re
86a0: 74 75 72 6e 65 64 2e 0a 2a 2f 0a 69 6e 74 20 73  turned..*/.int s
86b0: 71 6c 69 74 65 70 61 67 65 72 5f 72 6f 6c 6c 62  qlitepager_rollb
86c0: 61 63 6b 28 50 61 67 65 72 20 2a 70 50 61 67 65  ack(Pager *pPage
86d0: 72 29 7b 0a 20 20 69 6e 74 20 72 63 3b 0a 20 20  r){.  int rc;.  
86e0: 69 66 28 20 70 50 61 67 65 72 2d 3e 65 72 72 4d  if( pPager->errM
86f0: 61 73 6b 21 3d 30 20 26 26 20 70 50 61 67 65 72  ask!=0 && pPager
8700: 2d 3e 65 72 72 4d 61 73 6b 21 3d 50 41 47 45 52  ->errMask!=PAGER
8710: 5f 45 52 52 5f 46 55 4c 4c 20 29 7b 0a 20 20 20  _ERR_FULL ){.   
8720: 20 72 65 74 75 72 6e 20 70 61 67 65 72 5f 65 72   return pager_er
8730: 72 63 6f 64 65 28 70 50 61 67 65 72 29 3b 0a 20  rcode(pPager);. 
8740: 20 7d 0a 20 20 69 66 28 20 70 50 61 67 65 72 2d   }.  if( pPager-
8750: 3e 73 74 61 74 65 21 3d 53 51 4c 49 54 45 5f 57  >state!=SQLITE_W
8760: 52 49 54 45 4c 4f 43 4b 20 29 7b 0a 20 20 20 20  RITELOCK ){.    
8770: 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b  return SQLITE_OK
8780: 3b 0a 20 20 7d 0a 20 20 72 63 20 3d 20 70 61 67  ;.  }.  rc = pag
8790: 65 72 5f 70 6c 61 79 62 61 63 6b 28 70 50 61 67  er_playback(pPag
87a0: 65 72 29 3b 0a 20 20 69 66 28 20 72 63 21 3d 53  er);.  if( rc!=S
87b0: 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20  QLITE_OK ){.    
87c0: 72 63 20 3d 20 53 51 4c 49 54 45 5f 43 4f 52 52  rc = SQLITE_CORR
87d0: 55 50 54 3b 0a 20 20 20 20 70 50 61 67 65 72 2d  UPT;.    pPager-
87e0: 3e 65 72 72 4d 61 73 6b 20 7c 3d 20 50 41 47 45  >errMask |= PAGE
87f0: 52 5f 45 52 52 5f 43 4f 52 52 55 50 54 3b 0a 20  R_ERR_CORRUPT;. 
8800: 20 7d 0a 20 20 70 50 61 67 65 72 2d 3e 64 62 53   }.  pPager->dbS
8810: 69 7a 65 20 3d 20 2d 31 3b 0a 20 20 72 65 74 75  ize = -1;.  retu
8820: 72 6e 20 72 63 3b 0a 7d 3b 0a 0a 2f 2a 0a 2a 2a  rn rc;.};../*.**
8830: 20 52 65 74 75 72 6e 20 54 52 55 45 20 69 66 20   Return TRUE if 
8840: 74 68 65 20 64 61 74 61 62 61 73 65 20 66 69 6c  the database fil
8850: 65 20 69 73 20 6f 70 65 6e 65 64 20 72 65 61 64  e is opened read
8860: 2d 6f 6e 6c 79 2e 20 20 52 65 74 75 72 6e 20 46  -only.  Return F
8870: 41 4c 53 45 0a 2a 2a 20 69 66 20 74 68 65 20 64  ALSE.** if the d
8880: 61 74 61 62 61 73 65 20 69 73 20 28 69 6e 20 74  atabase is (in t
8890: 68 65 6f 72 79 29 20 77 72 69 74 61 62 6c 65 2e  heory) writable.
88a0: 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 70 61  .*/.int sqlitepa
88b0: 67 65 72 5f 69 73 72 65 61 64 6f 6e 6c 79 28 50  ger_isreadonly(P
88c0: 61 67 65 72 20 2a 70 50 61 67 65 72 29 7b 0a 20  ager *pPager){. 
88d0: 20 72 65 74 75 72 6e 20 70 50 61 67 65 72 2d 3e   return pPager->
88e0: 72 65 61 64 4f 6e 6c 79 3b 0a 7d 0a 0a 2f 2a 0a  readOnly;.}../*.
88f0: 2a 2a 20 54 68 69 73 20 72 6f 75 74 69 6e 65 20  ** This routine 
8900: 69 73 20 75 73 65 64 20 66 6f 72 20 74 65 73 74  is used for test
8910: 69 6e 67 20 61 6e 64 20 61 6e 61 6c 79 73 69 73  ing and analysis
8920: 20 6f 6e 6c 79 2e 0a 2a 2f 0a 69 6e 74 20 2a 73   only..*/.int *s
8930: 71 6c 69 74 65 70 61 67 65 72 5f 73 74 61 74 73  qlitepager_stats
8940: 28 50 61 67 65 72 20 2a 70 50 61 67 65 72 29 7b  (Pager *pPager){
8950: 0a 20 20 73 74 61 74 69 63 20 69 6e 74 20 61 5b  .  static int a[
8960: 39 5d 3b 0a 20 20 61 5b 30 5d 20 3d 20 70 50 61  9];.  a[0] = pPa
8970: 67 65 72 2d 3e 6e 52 65 66 3b 0a 20 20 61 5b 31  ger->nRef;.  a[1
8980: 5d 20 3d 20 70 50 61 67 65 72 2d 3e 6e 50 61 67  ] = pPager->nPag
8990: 65 3b 0a 20 20 61 5b 32 5d 20 3d 20 70 50 61 67  e;.  a[2] = pPag
89a0: 65 72 2d 3e 6d 78 50 61 67 65 3b 0a 20 20 61 5b  er->mxPage;.  a[
89b0: 33 5d 20 3d 20 70 50 61 67 65 72 2d 3e 64 62 53  3] = pPager->dbS
89c0: 69 7a 65 3b 0a 20 20 61 5b 34 5d 20 3d 20 70 50  ize;.  a[4] = pP
89d0: 61 67 65 72 2d 3e 73 74 61 74 65 3b 0a 20 20 61  ager->state;.  a
89e0: 5b 35 5d 20 3d 20 70 50 61 67 65 72 2d 3e 65 72  [5] = pPager->er
89f0: 72 4d 61 73 6b 3b 0a 20 20 61 5b 36 5d 20 3d 20  rMask;.  a[6] = 
8a00: 70 50 61 67 65 72 2d 3e 6e 48 69 74 3b 0a 20 20  pPager->nHit;.  
8a10: 61 5b 37 5d 20 3d 20 70 50 61 67 65 72 2d 3e 6e  a[7] = pPager->n
8a20: 4d 69 73 73 3b 0a 20 20 61 5b 38 5d 20 3d 20 70  Miss;.  a[8] = p
8a30: 50 61 67 65 72 2d 3e 6e 4f 76 66 6c 3b 0a 20 20  Pager->nOvfl;.  
8a40: 72 65 74 75 72 6e 20 61 3b 0a 7d 0a 0a 23 69 66  return a;.}..#if
8a50: 20 53 51 4c 49 54 45 5f 54 45 53 54 0a 2f 2a 0a   SQLITE_TEST./*.
8a60: 2a 2a 20 50 72 69 6e 74 20 61 20 6c 69 73 74 69  ** Print a listi
8a70: 6e 67 20 6f 66 20 61 6c 6c 20 72 65 66 65 72 65  ng of all refere
8a80: 6e 63 65 64 20 70 61 67 65 73 20 61 6e 64 20 74  nced pages and t
8a90: 68 65 69 72 20 72 65 66 20 63 6f 75 6e 74 2e 0a  heir ref count..
8aa0: 2a 2f 0a 76 6f 69 64 20 73 71 6c 69 74 65 70 61  */.void sqlitepa
8ab0: 67 65 72 5f 72 65 66 64 75 6d 70 28 50 61 67 65  ger_refdump(Page
8ac0: 72 20 2a 70 50 61 67 65 72 29 7b 0a 20 20 50 67  r *pPager){.  Pg
8ad0: 48 64 72 20 2a 70 50 67 3b 0a 20 20 66 6f 72 28  Hdr *pPg;.  for(
8ae0: 70 50 67 3d 70 50 61 67 65 72 2d 3e 70 41 6c 6c  pPg=pPager->pAll
8af0: 3b 20 70 50 67 3b 20 70 50 67 3d 70 50 67 2d 3e  ; pPg; pPg=pPg->
8b00: 70 4e 65 78 74 41 6c 6c 29 7b 0a 20 20 20 20 69  pNextAll){.    i
8b10: 66 28 20 70 50 67 2d 3e 6e 52 65 66 3c 3d 30 20  f( pPg->nRef<=0 
8b20: 29 20 63 6f 6e 74 69 6e 75 65 3b 0a 20 20 20 20  ) continue;.    
8b30: 70 72 69 6e 74 66 28 22 50 41 47 45 20 25 33 64  printf("PAGE %3d
8b40: 20 61 64 64 72 3d 30 78 25 30 38 78 20 6e 52 65   addr=0x%08x nRe
8b50: 66 3d 25 64 5c 6e 22 2c 20 0a 20 20 20 20 20 20  f=%d\n", .      
8b60: 20 70 50 67 2d 3e 70 67 6e 6f 2c 20 28 69 6e 74   pPg->pgno, (int
8b70: 29 50 47 48 44 52 5f 54 4f 5f 44 41 54 41 28 70  )PGHDR_TO_DATA(p
8b80: 50 67 29 2c 20 70 50 67 2d 3e 6e 52 65 66 29 3b  Pg), pPg->nRef);
8b90: 0a 20 20 7d 0a 7d 0a 23 65 6e 64 69 66 0a        .  }.}.#endif.