/ Hex Artifact Content
Login

Artifact 21d426c65c9dcf5718423a967117e9450f238519:


0000: 2f 2a 0a 2a 2a 20 32 30 30 31 20 53 65 70 74 65  /*.** 2001 Septe
0010: 6d 62 65 72 20 31 35 0a 2a 2a 0a 2a 2a 20 54 68  mber 15.**.** Th
0020: 65 20 61 75 74 68 6f 72 20 64 69 73 63 6c 61 69  e author disclai
0030: 6d 73 20 63 6f 70 79 72 69 67 68 74 20 74 6f 20  ms copyright to 
0040: 74 68 69 73 20 73 6f 75 72 63 65 20 63 6f 64 65  this source code
0050: 2e 20 20 49 6e 20 70 6c 61 63 65 20 6f 66 0a 2a  .  In place of.*
0060: 2a 20 61 20 6c 65 67 61 6c 20 6e 6f 74 69 63 65  * a legal notice
0070: 2c 20 68 65 72 65 20 69 73 20 61 20 62 6c 65 73  , here is a bles
0080: 73 69 6e 67 3a 0a 2a 2a 0a 2a 2a 20 20 20 20 4d  sing:.**.**    M
0090: 61 79 20 79 6f 75 20 64 6f 20 67 6f 6f 64 20 61  ay you do good a
00a0: 6e 64 20 6e 6f 74 20 65 76 69 6c 2e 0a 2a 2a 20  nd not evil..** 
00b0: 20 20 20 4d 61 79 20 79 6f 75 20 66 69 6e 64 20     May you find 
00c0: 66 6f 72 67 69 76 65 6e 65 73 73 20 66 6f 72 20  forgiveness for 
00d0: 79 6f 75 72 73 65 6c 66 20 61 6e 64 20 66 6f 72  yourself and for
00e0: 67 69 76 65 20 6f 74 68 65 72 73 2e 0a 2a 2a 20  give others..** 
00f0: 20 20 20 4d 61 79 20 79 6f 75 20 73 68 61 72 65     May you share
0100: 20 66 72 65 65 6c 79 2c 20 6e 65 76 65 72 20 74   freely, never t
0110: 61 6b 69 6e 67 20 6d 6f 72 65 20 74 68 61 6e 20  aking more than 
0120: 79 6f 75 20 67 69 76 65 2e 0a 2a 2a 0a 2a 2a 2a  you give..**.***
0130: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
0140: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
0150: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
0160: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
0170: 2a 2a 2a 2a 2a 2a 0a 2a 2a 20 54 68 69 73 20 69  ******.** This i
0180: 73 20 74 68 65 20 69 6d 70 6c 65 6d 65 6e 74 61  s the implementa
0190: 74 69 6f 6e 20 6f 66 20 74 68 65 20 70 61 67 65  tion of the page
01a0: 20 63 61 63 68 65 20 73 75 62 73 79 73 74 65 6d   cache subsystem
01b0: 20 6f 72 20 22 70 61 67 65 72 22 2e 0a 2a 2a 20   or "pager"..** 
01c0: 0a 2a 2a 20 54 68 65 20 70 61 67 65 72 20 69 73  .** The pager is
01d0: 20 75 73 65 64 20 74 6f 20 61 63 63 65 73 73 20   used to access 
01e0: 61 20 64 61 74 61 62 61 73 65 20 64 69 73 6b 20  a database disk 
01f0: 66 69 6c 65 2e 20 20 49 74 20 69 6d 70 6c 65 6d  file.  It implem
0200: 65 6e 74 73 0a 2a 2a 20 61 74 6f 6d 69 63 20 63  ents.** atomic c
0210: 6f 6d 6d 69 74 20 61 6e 64 20 72 6f 6c 6c 62 61  ommit and rollba
0220: 63 6b 20 74 68 72 6f 75 67 68 20 74 68 65 20 75  ck through the u
0230: 73 65 20 6f 66 20 61 20 6a 6f 75 72 6e 61 6c 20  se of a journal 
0240: 66 69 6c 65 20 74 68 61 74 0a 2a 2a 20 69 73 20  file that.** is 
0250: 73 65 70 61 72 61 74 65 20 66 72 6f 6d 20 74 68  separate from th
0260: 65 20 64 61 74 61 62 61 73 65 20 66 69 6c 65 2e  e database file.
0270: 20 20 54 68 65 20 70 61 67 65 72 20 61 6c 73 6f    The pager also
0280: 20 69 6d 70 6c 65 6d 65 6e 74 73 20 66 69 6c 65   implements file
0290: 0a 2a 2a 20 6c 6f 63 6b 69 6e 67 20 74 6f 20 70  .** locking to p
02a0: 72 65 76 65 6e 74 20 74 77 6f 20 70 72 6f 63 65  revent two proce
02b0: 73 73 65 73 20 66 72 6f 6d 20 77 72 69 74 69 6e  sses from writin
02c0: 67 20 74 68 65 20 73 61 6d 65 20 64 61 74 61 62  g the same datab
02d0: 61 73 65 0a 2a 2a 20 66 69 6c 65 20 73 69 6d 75  ase.** file simu
02e0: 6c 74 61 6e 65 6f 75 73 6c 79 2c 20 6f 72 20 6f  ltaneously, or o
02f0: 6e 65 20 70 72 6f 63 65 73 73 20 66 72 6f 6d 20  ne process from 
0300: 72 65 61 64 69 6e 67 20 74 68 65 20 64 61 74 61  reading the data
0310: 62 61 73 65 20 77 68 69 6c 65 0a 2a 2a 20 61 6e  base while.** an
0320: 6f 74 68 65 72 20 69 73 20 77 72 69 74 69 6e 67  other is writing
0330: 2e 0a 2a 2a 0a 2a 2a 20 40 28 23 29 20 24 49 64  ..**.** @(#) $Id
0340: 3a 20 70 61 67 65 72 2e 63 2c 76 20 31 2e 34 33  : pager.c,v 1.43
0350: 33 20 32 30 30 38 2f 30 34 2f 32 32 20 31 37 3a  3 2008/04/22 17:
0360: 31 35 3a 31 38 20 64 72 68 20 45 78 70 20 24 0a  15:18 drh Exp $.
0370: 2a 2f 0a 23 69 66 6e 64 65 66 20 53 51 4c 49 54  */.#ifndef SQLIT
0380: 45 5f 4f 4d 49 54 5f 44 49 53 4b 49 4f 0a 23 69  E_OMIT_DISKIO.#i
0390: 6e 63 6c 75 64 65 20 22 73 71 6c 69 74 65 49 6e  nclude "sqliteIn
03a0: 74 2e 68 22 0a 23 69 6e 63 6c 75 64 65 20 3c 61  t.h".#include <a
03b0: 73 73 65 72 74 2e 68 3e 0a 23 69 6e 63 6c 75 64  ssert.h>.#includ
03c0: 65 20 3c 73 74 72 69 6e 67 2e 68 3e 0a 0a 2f 2a  e <string.h>../*
03d0: 0a 2a 2a 20 4d 61 63 72 6f 73 20 66 6f 72 20 74  .** Macros for t
03e0: 72 6f 75 62 6c 65 73 68 6f 6f 74 69 6e 67 2e 20  roubleshooting. 
03f0: 20 4e 6f 72 6d 61 6c 6c 79 20 74 75 72 6e 65 64   Normally turned
0400: 20 6f 66 66 0a 2a 2f 0a 23 69 66 20 30 0a 23 64   off.*/.#if 0.#d
0410: 65 66 69 6e 65 20 73 71 6c 69 74 65 33 44 65 62  efine sqlite3Deb
0420: 75 67 50 72 69 6e 74 66 20 70 72 69 6e 74 66 0a  ugPrintf printf.
0430: 23 64 65 66 69 6e 65 20 50 41 47 45 52 54 52 41  #define PAGERTRA
0440: 43 45 31 28 58 29 20 20 20 20 20 20 20 73 71 6c  CE1(X)       sql
0450: 69 74 65 33 44 65 62 75 67 50 72 69 6e 74 66 28  ite3DebugPrintf(
0460: 58 29 0a 23 64 65 66 69 6e 65 20 50 41 47 45 52  X).#define PAGER
0470: 54 52 41 43 45 32 28 58 2c 59 29 20 20 20 20 20  TRACE2(X,Y)     
0480: 73 71 6c 69 74 65 33 44 65 62 75 67 50 72 69 6e  sqlite3DebugPrin
0490: 74 66 28 58 2c 59 29 0a 23 64 65 66 69 6e 65 20  tf(X,Y).#define 
04a0: 50 41 47 45 52 54 52 41 43 45 33 28 58 2c 59 2c  PAGERTRACE3(X,Y,
04b0: 5a 29 20 20 20 73 71 6c 69 74 65 33 44 65 62 75  Z)   sqlite3Debu
04c0: 67 50 72 69 6e 74 66 28 58 2c 59 2c 5a 29 0a 23  gPrintf(X,Y,Z).#
04d0: 64 65 66 69 6e 65 20 50 41 47 45 52 54 52 41 43  define PAGERTRAC
04e0: 45 34 28 58 2c 59 2c 5a 2c 57 29 20 73 71 6c 69  E4(X,Y,Z,W) sqli
04f0: 74 65 33 44 65 62 75 67 50 72 69 6e 74 66 28 58  te3DebugPrintf(X
0500: 2c 59 2c 5a 2c 57 29 0a 23 64 65 66 69 6e 65 20  ,Y,Z,W).#define 
0510: 50 41 47 45 52 54 52 41 43 45 35 28 58 2c 59 2c  PAGERTRACE5(X,Y,
0520: 5a 2c 57 2c 56 29 20 73 71 6c 69 74 65 33 44 65  Z,W,V) sqlite3De
0530: 62 75 67 50 72 69 6e 74 66 28 58 2c 59 2c 5a 2c  bugPrintf(X,Y,Z,
0540: 57 2c 56 29 0a 23 65 6c 73 65 0a 23 64 65 66 69  W,V).#else.#defi
0550: 6e 65 20 50 41 47 45 52 54 52 41 43 45 31 28 58  ne PAGERTRACE1(X
0560: 29 0a 23 64 65 66 69 6e 65 20 50 41 47 45 52 54  ).#define PAGERT
0570: 52 41 43 45 32 28 58 2c 59 29 0a 23 64 65 66 69  RACE2(X,Y).#defi
0580: 6e 65 20 50 41 47 45 52 54 52 41 43 45 33 28 58  ne PAGERTRACE3(X
0590: 2c 59 2c 5a 29 0a 23 64 65 66 69 6e 65 20 50 41  ,Y,Z).#define PA
05a0: 47 45 52 54 52 41 43 45 34 28 58 2c 59 2c 5a 2c  GERTRACE4(X,Y,Z,
05b0: 57 29 0a 23 64 65 66 69 6e 65 20 50 41 47 45 52  W).#define PAGER
05c0: 54 52 41 43 45 35 28 58 2c 59 2c 5a 2c 57 2c 56  TRACE5(X,Y,Z,W,V
05d0: 29 0a 23 65 6e 64 69 66 0a 0a 2f 2a 0a 2a 2a 20  ).#endif../*.** 
05e0: 54 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 74 77  The following tw
05f0: 6f 20 6d 61 63 72 6f 73 20 61 72 65 20 75 73 65  o macros are use
0600: 64 20 77 69 74 68 69 6e 20 74 68 65 20 50 41 47  d within the PAG
0610: 45 52 54 52 41 43 45 58 28 29 20 6d 61 63 72 6f  ERTRACEX() macro
0620: 73 20 61 62 6f 76 65 0a 2a 2a 20 74 6f 20 70 72  s above.** to pr
0630: 69 6e 74 20 6f 75 74 20 66 69 6c 65 2d 64 65 73  int out file-des
0640: 63 72 69 70 74 6f 72 73 2e 20 0a 2a 2a 0a 2a 2a  criptors. .**.**
0650: 20 50 41 47 45 52 49 44 28 29 20 74 61 6b 65 73   PAGERID() takes
0660: 20 61 20 70 6f 69 6e 74 65 72 20 74 6f 20 61 20   a pointer to a 
0670: 50 61 67 65 72 20 73 74 72 75 63 74 20 61 73 20  Pager struct as 
0680: 69 74 73 20 61 72 67 75 6d 65 6e 74 2e 20 54 68  its argument. Th
0690: 65 0a 2a 2a 20 61 73 73 6f 63 69 61 74 65 64 20  e.** associated 
06a0: 66 69 6c 65 2d 64 65 73 63 72 69 70 74 6f 72 20  file-descriptor 
06b0: 69 73 20 72 65 74 75 72 6e 65 64 2e 20 46 49 4c  is returned. FIL
06c0: 45 48 41 4e 44 4c 45 49 44 28 29 20 74 61 6b 65  EHANDLEID() take
06d0: 73 20 61 6e 20 73 71 6c 69 74 65 33 5f 66 69 6c  s an sqlite3_fil
06e0: 65 0a 2a 2a 20 73 74 72 75 63 74 20 61 73 20 69  e.** struct as i
06f0: 74 73 20 61 72 67 75 6d 65 6e 74 2e 0a 2a 2f 0a  ts argument..*/.
0700: 23 64 65 66 69 6e 65 20 50 41 47 45 52 49 44 28  #define PAGERID(
0710: 70 29 20 28 28 69 6e 74 29 28 70 2d 3e 66 64 29  p) ((int)(p->fd)
0720: 29 0a 23 64 65 66 69 6e 65 20 46 49 4c 45 48 41  ).#define FILEHA
0730: 4e 44 4c 45 49 44 28 66 64 29 20 28 28 69 6e 74  NDLEID(fd) ((int
0740: 29 66 64 29 0a 0a 2f 2a 0a 2a 2a 20 54 68 65 20  )fd)../*.** The 
0750: 70 61 67 65 20 63 61 63 68 65 20 61 73 20 61 20  page cache as a 
0760: 77 68 6f 6c 65 20 69 73 20 61 6c 77 61 79 73 20  whole is always 
0770: 69 6e 20 6f 6e 65 20 6f 66 20 74 68 65 20 66 6f  in one of the fo
0780: 6c 6c 6f 77 69 6e 67 0a 2a 2a 20 73 74 61 74 65  llowing.** state
0790: 73 3a 0a 2a 2a 0a 2a 2a 20 20 20 50 41 47 45 52  s:.**.**   PAGER
07a0: 5f 55 4e 4c 4f 43 4b 20 20 20 20 20 20 20 20 54  _UNLOCK        T
07b0: 68 65 20 70 61 67 65 20 63 61 63 68 65 20 69 73  he page cache is
07c0: 20 6e 6f 74 20 63 75 72 72 65 6e 74 6c 79 20 72   not currently r
07d0: 65 61 64 69 6e 67 20 6f 72 20 0a 2a 2a 20 20 20  eading or .**   
07e0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
07f0: 20 20 20 20 77 72 69 74 69 6e 67 20 74 68 65 20      writing the 
0800: 64 61 74 61 62 61 73 65 20 66 69 6c 65 2e 20 20  database file.  
0810: 54 68 65 72 65 20 69 73 20 6e 6f 0a 2a 2a 20 20  There is no.**  
0820: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
0830: 20 20 20 20 20 64 61 74 61 20 68 65 6c 64 20 69       data held i
0840: 6e 20 6d 65 6d 6f 72 79 2e 20 20 54 68 69 73 20  n memory.  This 
0850: 69 73 20 74 68 65 20 69 6e 69 74 69 61 6c 0a 2a  is the initial.*
0860: 2a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20  *               
0870: 20 20 20 20 20 20 20 20 73 74 61 74 65 2e 0a 2a          state..*
0880: 2a 0a 2a 2a 20 20 20 50 41 47 45 52 5f 53 48 41  *.**   PAGER_SHA
0890: 52 45 44 20 20 20 20 20 20 20 20 54 68 65 20 70  RED        The p
08a0: 61 67 65 20 63 61 63 68 65 20 69 73 20 72 65 61  age cache is rea
08b0: 64 69 6e 67 20 74 68 65 20 64 61 74 61 62 61 73  ding the databas
08c0: 65 2e 0a 2a 2a 20 20 20 20 20 20 20 20 20 20 20  e..**           
08d0: 20 20 20 20 20 20 20 20 20 20 20 20 57 72 69 74              Writ
08e0: 69 6e 67 20 69 73 20 6e 6f 74 20 70 65 72 6d 69  ing is not permi
08f0: 74 74 65 64 2e 20 20 54 68 65 72 65 20 63 61 6e  tted.  There can
0900: 20 62 65 0a 2a 2a 20 20 20 20 20 20 20 20 20 20   be.**          
0910: 20 20 20 20 20 20 20 20 20 20 20 20 20 6d 75 6c               mul
0920: 74 69 70 6c 65 20 72 65 61 64 65 72 73 20 61 63  tiple readers ac
0930: 63 65 73 73 69 6e 67 20 74 68 65 20 73 61 6d 65  cessing the same
0940: 20 64 61 74 61 62 61 73 65 0a 2a 2a 20 20 20 20   database.**    
0950: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
0960: 20 20 20 66 69 6c 65 20 61 74 20 74 68 65 20 73     file at the s
0970: 61 6d 65 20 74 69 6d 65 2e 0a 2a 2a 0a 2a 2a 20  ame time..**.** 
0980: 20 20 50 41 47 45 52 5f 52 45 53 45 52 56 45 44    PAGER_RESERVED
0990: 20 20 20 20 20 20 54 68 69 73 20 70 72 6f 63 65        This proce
09a0: 73 73 20 68 61 73 20 72 65 73 65 72 76 65 64 20  ss has reserved 
09b0: 74 68 65 20 64 61 74 61 62 61 73 65 20 66 6f 72  the database for
09c0: 20 77 72 69 74 69 6e 67 0a 2a 2a 20 20 20 20 20   writing.**     
09d0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
09e0: 20 20 62 75 74 20 68 61 73 20 6e 6f 74 20 79 65    but has not ye
09f0: 74 20 6d 61 64 65 20 61 6e 79 20 63 68 61 6e 67  t made any chang
0a00: 65 73 2e 20 20 4f 6e 6c 79 20 6f 6e 65 20 70 72  es.  Only one pr
0a10: 6f 63 65 73 73 0a 2a 2a 20 20 20 20 20 20 20 20  ocess.**        
0a20: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 61                 a
0a30: 74 20 61 20 74 69 6d 65 20 63 61 6e 20 72 65 73  t a time can res
0a40: 65 72 76 65 20 74 68 65 20 64 61 74 61 62 61 73  erve the databas
0a50: 65 2e 20 20 54 68 65 20 6f 72 69 67 69 6e 61 6c  e.  The original
0a60: 0a 2a 2a 20 20 20 20 20 20 20 20 20 20 20 20 20  .**             
0a70: 20 20 20 20 20 20 20 20 20 20 64 61 74 61 62 61            databa
0a80: 73 65 20 66 69 6c 65 20 68 61 73 20 6e 6f 74 20  se file has not 
0a90: 62 65 65 6e 20 6d 6f 64 69 66 69 65 64 20 73 6f  been modified so
0aa0: 20 6f 74 68 65 72 0a 2a 2a 20 20 20 20 20 20 20   other.**       
0ab0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
0ac0: 70 72 6f 63 65 73 73 65 73 20 6d 61 79 20 73 74  processes may st
0ad0: 69 6c 6c 20 62 65 20 72 65 61 64 69 6e 67 20 74  ill be reading t
0ae0: 68 65 20 6f 6e 2d 64 69 73 6b 0a 2a 2a 20 20 20  he on-disk.**   
0af0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
0b00: 20 20 20 20 64 61 74 61 62 61 73 65 20 66 69 6c      database fil
0b10: 65 2e 0a 2a 2a 0a 2a 2a 20 20 20 50 41 47 45 52  e..**.**   PAGER
0b20: 5f 45 58 43 4c 55 53 49 56 45 20 20 20 20 20 54  _EXCLUSIVE     T
0b30: 68 65 20 70 61 67 65 20 63 61 63 68 65 20 69 73  he page cache is
0b40: 20 77 72 69 74 69 6e 67 20 74 68 65 20 64 61 74   writing the dat
0b50: 61 62 61 73 65 2e 0a 2a 2a 20 20 20 20 20 20 20  abase..**       
0b60: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
0b70: 41 63 63 65 73 73 20 69 73 20 65 78 63 6c 75 73  Access is exclus
0b80: 69 76 65 2e 20 20 4e 6f 20 6f 74 68 65 72 20 70  ive.  No other p
0b90: 72 6f 63 65 73 73 65 73 20 6f 72 0a 2a 2a 20 20  rocesses or.**  
0ba0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
0bb0: 20 20 20 20 20 74 68 72 65 61 64 73 20 63 61 6e       threads can
0bc0: 20 62 65 20 72 65 61 64 69 6e 67 20 6f 72 20 77   be reading or w
0bd0: 72 69 74 69 6e 67 20 77 68 69 6c 65 20 6f 6e 65  riting while one
0be0: 0a 2a 2a 20 20 20 20 20 20 20 20 20 20 20 20 20  .**             
0bf0: 20 20 20 20 20 20 20 20 20 20 70 72 6f 63 65 73            proces
0c00: 73 20 69 73 20 77 72 69 74 69 6e 67 2e 0a 2a 2a  s is writing..**
0c10: 0a 2a 2a 20 20 20 50 41 47 45 52 5f 53 59 4e 43  .**   PAGER_SYNC
0c20: 45 44 20 20 20 20 20 20 20 20 54 68 65 20 70 61  ED        The pa
0c30: 67 65 72 20 6d 6f 76 65 73 20 74 6f 20 74 68 69  ger moves to thi
0c40: 73 20 73 74 61 74 65 20 66 72 6f 6d 20 50 41 47  s state from PAG
0c50: 45 52 5f 45 58 43 4c 55 53 49 56 45 0a 2a 2a 20  ER_EXCLUSIVE.** 
0c60: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
0c70: 20 20 20 20 20 20 61 66 74 65 72 20 61 6c 6c 20        after all 
0c80: 64 69 72 74 79 20 70 61 67 65 73 20 68 61 76 65  dirty pages have
0c90: 20 62 65 65 6e 20 77 72 69 74 74 65 6e 20 74 6f   been written to
0ca0: 20 74 68 65 0a 2a 2a 20 20 20 20 20 20 20 20 20   the.**         
0cb0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 64 61                da
0cc0: 74 61 62 61 73 65 20 66 69 6c 65 20 61 6e 64 20  tabase file and 
0cd0: 74 68 65 20 66 69 6c 65 20 68 61 73 20 62 65 65  the file has bee
0ce0: 6e 20 73 79 6e 63 65 64 20 74 6f 0a 2a 2a 20 20  n synced to.**  
0cf0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
0d00: 20 20 20 20 20 64 69 73 6b 2e 20 41 6c 6c 20 74       disk. All t
0d10: 68 61 74 20 72 65 6d 61 69 6e 73 20 74 6f 20 64  hat remains to d
0d20: 6f 20 69 73 20 74 6f 20 72 65 6d 6f 76 65 20 6f  o is to remove o
0d30: 72 0a 2a 2a 20 20 20 20 20 20 20 20 20 20 20 20  r.**            
0d40: 20 20 20 20 20 20 20 20 20 20 20 74 72 75 6e 63             trunc
0d50: 61 74 65 20 74 68 65 20 6a 6f 75 72 6e 61 6c 20  ate the journal 
0d60: 66 69 6c 65 20 61 6e 64 20 74 68 65 20 74 72 61  file and the tra
0d70: 6e 73 61 63 74 69 6f 6e 20 0a 2a 2a 20 20 20 20  nsaction .**    
0d80: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
0d90: 20 20 20 77 69 6c 6c 20 62 65 20 63 6f 6d 6d 69     will be commi
0da0: 74 74 65 64 2e 0a 2a 2a 0a 2a 2a 20 54 68 65 20  tted..**.** The 
0db0: 70 61 67 65 20 63 61 63 68 65 20 63 6f 6d 65 73  page cache comes
0dc0: 20 75 70 20 69 6e 20 50 41 47 45 52 5f 55 4e 4c   up in PAGER_UNL
0dd0: 4f 43 4b 2e 20 20 54 68 65 20 66 69 72 73 74 20  OCK.  The first 
0de0: 74 69 6d 65 20 61 0a 2a 2a 20 73 71 6c 69 74 65  time a.** sqlite
0df0: 33 50 61 67 65 72 47 65 74 28 29 20 6f 63 63 75  3PagerGet() occu
0e00: 72 73 2c 20 74 68 65 20 73 74 61 74 65 20 74 72  rs, the state tr
0e10: 61 6e 73 69 74 69 6f 6e 73 20 74 6f 20 50 41 47  ansitions to PAG
0e20: 45 52 5f 53 48 41 52 45 44 2e 0a 2a 2a 20 41 66  ER_SHARED..** Af
0e30: 74 65 72 20 61 6c 6c 20 70 61 67 65 73 20 68 61  ter all pages ha
0e40: 76 65 20 62 65 65 6e 20 72 65 6c 65 61 73 65 64  ve been released
0e50: 20 75 73 69 6e 67 20 73 71 6c 69 74 65 5f 70 61   using sqlite_pa
0e60: 67 65 5f 75 6e 72 65 66 28 29 2c 0a 2a 2a 20 74  ge_unref(),.** t
0e70: 68 65 20 73 74 61 74 65 20 74 72 61 6e 73 69 74  he state transit
0e80: 69 6f 6e 73 20 62 61 63 6b 20 74 6f 20 50 41 47  ions back to PAG
0e90: 45 52 5f 55 4e 4c 4f 43 4b 2e 20 20 54 68 65 20  ER_UNLOCK.  The 
0ea0: 66 69 72 73 74 20 74 69 6d 65 0a 2a 2a 20 74 68  first time.** th
0eb0: 61 74 20 73 71 6c 69 74 65 33 50 61 67 65 72 57  at sqlite3PagerW
0ec0: 72 69 74 65 28 29 20 69 73 20 63 61 6c 6c 65 64  rite() is called
0ed0: 2c 20 74 68 65 20 73 74 61 74 65 20 74 72 61 6e  , the state tran
0ee0: 73 69 74 69 6f 6e 73 20 74 6f 0a 2a 2a 20 50 41  sitions to.** PA
0ef0: 47 45 52 5f 52 45 53 45 52 56 45 44 2e 20 20 28  GER_RESERVED.  (
0f00: 4e 6f 74 65 20 74 68 61 74 20 73 71 6c 69 74 65  Note that sqlite
0f10: 33 50 61 67 65 72 57 72 69 74 65 28 29 20 63 61  3PagerWrite() ca
0f20: 6e 20 6f 6e 6c 79 20 62 65 0a 2a 2a 20 63 61 6c  n only be.** cal
0f30: 6c 65 64 20 6f 6e 20 61 6e 20 6f 75 74 73 74 61  led on an outsta
0f40: 6e 64 69 6e 67 20 70 61 67 65 20 77 68 69 63 68  nding page which
0f50: 20 6d 65 61 6e 73 20 74 68 61 74 20 74 68 65 20   means that the 
0f60: 70 61 67 65 72 20 6d 75 73 74 0a 2a 2a 20 62 65  pager must.** be
0f70: 20 69 6e 20 50 41 47 45 52 5f 53 48 41 52 45 44   in PAGER_SHARED
0f80: 20 62 65 66 6f 72 65 20 69 74 20 74 72 61 6e 73   before it trans
0f90: 69 74 69 6f 6e 73 20 74 6f 20 50 41 47 45 52 5f  itions to PAGER_
0fa0: 52 45 53 45 52 56 45 44 2e 29 0a 2a 2a 20 50 41  RESERVED.).** PA
0fb0: 47 45 52 5f 52 45 53 45 52 56 45 44 20 6d 65 61  GER_RESERVED mea
0fc0: 6e 73 20 74 68 61 74 20 74 68 65 72 65 20 69 73  ns that there is
0fd0: 20 61 6e 20 6f 70 65 6e 20 72 6f 6c 6c 62 61 63   an open rollbac
0fe0: 6b 20 6a 6f 75 72 6e 61 6c 2e 0a 2a 2a 20 54 68  k journal..** Th
0ff0: 65 20 74 72 61 6e 73 69 74 69 6f 6e 20 74 6f 20  e transition to 
1000: 50 41 47 45 52 5f 45 58 43 4c 55 53 49 56 45 20  PAGER_EXCLUSIVE 
1010: 6f 63 63 75 72 73 20 62 65 66 6f 72 65 20 61 6e  occurs before an
1020: 79 20 63 68 61 6e 67 65 73 0a 2a 2a 20 61 72 65  y changes.** are
1030: 20 6d 61 64 65 20 74 6f 20 74 68 65 20 64 61 74   made to the dat
1040: 61 62 61 73 65 20 66 69 6c 65 2c 20 74 68 6f 75  abase file, thou
1050: 67 68 20 77 72 69 74 65 73 20 74 6f 20 74 68 65  gh writes to the
1060: 20 72 6f 6c 6c 62 61 63 6b 0a 2a 2a 20 6a 6f 75   rollback.** jou
1070: 72 6e 61 6c 20 6f 63 63 75 72 73 20 77 69 74 68  rnal occurs with
1080: 20 6a 75 73 74 20 50 41 47 45 52 5f 52 45 53 45   just PAGER_RESE
1090: 52 56 45 44 2e 20 20 41 66 74 65 72 20 61 6e 20  RVED.  After an 
10a0: 73 71 6c 69 74 65 33 50 61 67 65 72 52 6f 6c 6c  sqlite3PagerRoll
10b0: 62 61 63 6b 28 29 0a 2a 2a 20 6f 72 20 73 71 6c  back().** or sql
10c0: 69 74 65 33 50 61 67 65 72 43 6f 6d 6d 69 74 50  ite3PagerCommitP
10d0: 68 61 73 65 54 77 6f 28 29 2c 20 74 68 65 20 73  haseTwo(), the s
10e0: 74 61 74 65 20 63 61 6e 20 67 6f 20 62 61 63 6b  tate can go back
10f0: 20 74 6f 20 50 41 47 45 52 5f 53 48 41 52 45 44   to PAGER_SHARED
1100: 2c 0a 2a 2a 20 6f 72 20 69 74 20 63 61 6e 20 73  ,.** or it can s
1110: 74 61 79 20 61 74 20 50 41 47 45 52 5f 45 58 43  tay at PAGER_EXC
1120: 4c 55 53 49 56 45 20 69 66 20 77 65 20 61 72 65  LUSIVE if we are
1130: 20 69 6e 20 65 78 63 6c 75 73 69 76 65 20 61 63   in exclusive ac
1140: 63 65 73 73 20 6d 6f 64 65 2e 0a 2a 2f 0a 23 64  cess mode..*/.#d
1150: 65 66 69 6e 65 20 50 41 47 45 52 5f 55 4e 4c 4f  efine PAGER_UNLO
1160: 43 4b 20 20 20 20 20 20 30 0a 23 64 65 66 69 6e  CK      0.#defin
1170: 65 20 50 41 47 45 52 5f 53 48 41 52 45 44 20 20  e PAGER_SHARED  
1180: 20 20 20 20 31 20 20 20 2f 2a 20 73 61 6d 65 20      1   /* same 
1190: 61 73 20 53 48 41 52 45 44 5f 4c 4f 43 4b 20 2a  as SHARED_LOCK *
11a0: 2f 0a 23 64 65 66 69 6e 65 20 50 41 47 45 52 5f  /.#define PAGER_
11b0: 52 45 53 45 52 56 45 44 20 20 20 20 32 20 20 20  RESERVED    2   
11c0: 2f 2a 20 73 61 6d 65 20 61 73 20 52 45 53 45 52  /* same as RESER
11d0: 56 45 44 5f 4c 4f 43 4b 20 2a 2f 0a 23 64 65 66  VED_LOCK */.#def
11e0: 69 6e 65 20 50 41 47 45 52 5f 45 58 43 4c 55 53  ine PAGER_EXCLUS
11f0: 49 56 45 20 20 20 34 20 20 20 2f 2a 20 73 61 6d  IVE   4   /* sam
1200: 65 20 61 73 20 45 58 43 4c 55 53 49 56 45 5f 4c  e as EXCLUSIVE_L
1210: 4f 43 4b 20 2a 2f 0a 23 64 65 66 69 6e 65 20 50  OCK */.#define P
1220: 41 47 45 52 5f 53 59 4e 43 45 44 20 20 20 20 20  AGER_SYNCED     
1230: 20 35 0a 0a 2f 2a 0a 2a 2a 20 49 66 20 74 68 65   5../*.** If the
1240: 20 53 51 4c 49 54 45 5f 42 55 53 59 5f 52 45 53   SQLITE_BUSY_RES
1250: 45 52 56 45 44 5f 4c 4f 43 4b 20 6d 61 63 72 6f  ERVED_LOCK macro
1260: 20 69 73 20 73 65 74 20 74 6f 20 74 72 75 65 20   is set to true 
1270: 61 74 20 63 6f 6d 70 69 6c 65 2d 74 69 6d 65 2c  at compile-time,
1280: 0a 2a 2a 20 74 68 65 6e 20 66 61 69 6c 65 64 20  .** then failed 
1290: 61 74 74 65 6d 70 74 73 20 74 6f 20 67 65 74 20  attempts to get 
12a0: 61 20 72 65 73 65 72 76 65 64 20 6c 6f 63 6b 20  a reserved lock 
12b0: 77 69 6c 6c 20 69 6e 76 6f 6b 65 20 74 68 65 20  will invoke the 
12c0: 62 75 73 79 20 63 61 6c 6c 62 61 63 6b 2e 0a 2a  busy callback..*
12d0: 2a 20 54 68 69 73 20 69 73 20 6f 66 66 20 62 79  * This is off by
12e0: 20 64 65 66 61 75 6c 74 2e 20 20 54 6f 20 73 65   default.  To se
12f0: 65 20 77 68 79 2c 20 63 6f 6e 73 69 64 65 72 20  e why, consider 
1300: 74 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 73 63  the following sc
1310: 65 6e 61 72 69 6f 3a 0a 2a 2a 20 0a 2a 2a 20 53  enario:.** .** S
1320: 75 70 70 6f 73 65 20 74 68 72 65 61 64 20 41 20  uppose thread A 
1330: 61 6c 72 65 61 64 79 20 68 61 73 20 61 20 73 68  already has a sh
1340: 61 72 65 64 20 6c 6f 63 6b 20 61 6e 64 20 77 61  ared lock and wa
1350: 6e 74 73 20 61 20 72 65 73 65 72 76 65 64 20 6c  nts a reserved l
1360: 6f 63 6b 2e 0a 2a 2a 20 54 68 72 65 61 64 20 42  ock..** Thread B
1370: 20 61 6c 72 65 61 64 79 20 68 61 73 20 61 20 72   already has a r
1380: 65 73 65 72 76 65 64 20 6c 6f 63 6b 20 61 6e 64  eserved lock and
1390: 20 77 61 6e 74 73 20 61 6e 20 65 78 63 6c 75 73   wants an exclus
13a0: 69 76 65 20 6c 6f 63 6b 2e 20 20 49 66 0a 2a 2a  ive lock.  If.**
13b0: 20 62 6f 74 68 20 74 68 72 65 61 64 73 20 61 72   both threads ar
13c0: 65 20 75 73 69 6e 67 20 74 68 65 69 72 20 62 75  e using their bu
13d0: 73 79 20 63 61 6c 6c 62 61 63 6b 73 2c 20 69 74  sy callbacks, it
13e0: 20 6d 69 67 68 74 20 62 65 20 61 20 6c 6f 6e 67   might be a long
13f0: 20 74 69 6d 65 0a 2a 2a 20 62 65 20 66 6f 72 20   time.** be for 
1400: 6f 6e 65 20 6f 66 20 74 68 65 20 74 68 72 65 61  one of the threa
1410: 64 73 20 67 69 76 65 20 75 70 20 61 6e 64 20 61  ds give up and a
1420: 6c 6c 6f 77 73 20 74 68 65 20 6f 74 68 65 72 20  llows the other 
1430: 74 6f 20 70 72 6f 63 65 65 64 2e 0a 2a 2a 20 42  to proceed..** B
1440: 75 74 20 69 66 20 74 68 65 20 74 68 72 65 61 64  ut if the thread
1450: 20 74 72 79 69 6e 67 20 74 6f 20 67 65 74 20 74   trying to get t
1460: 68 65 20 72 65 73 65 72 76 65 64 20 6c 6f 63 6b  he reserved lock
1470: 20 67 69 76 65 73 20 75 70 20 71 75 69 63 6b 6c   gives up quickl
1480: 79 0a 2a 2a 20 28 69 66 20 69 74 20 6e 65 76 65  y.** (if it neve
1490: 72 20 69 6e 76 6f 6b 65 73 20 69 74 73 20 62 75  r invokes its bu
14a0: 73 79 20 63 61 6c 6c 62 61 63 6b 29 20 74 68 65  sy callback) the
14b0: 6e 20 74 68 65 20 63 6f 6e 74 65 6e 74 69 6f 6e  n the contention
14c0: 20 77 69 6c 6c 20 62 65 0a 2a 2a 20 72 65 73 6f   will be.** reso
14d0: 6c 76 65 64 20 71 75 69 63 6b 6c 79 2e 0a 2a 2f  lved quickly..*/
14e0: 0a 23 69 66 6e 64 65 66 20 53 51 4c 49 54 45 5f  .#ifndef SQLITE_
14f0: 42 55 53 59 5f 52 45 53 45 52 56 45 44 5f 4c 4f  BUSY_RESERVED_LO
1500: 43 4b 0a 23 20 64 65 66 69 6e 65 20 53 51 4c 49  CK.# define SQLI
1510: 54 45 5f 42 55 53 59 5f 52 45 53 45 52 56 45 44  TE_BUSY_RESERVED
1520: 5f 4c 4f 43 4b 20 30 0a 23 65 6e 64 69 66 0a 0a  _LOCK 0.#endif..
1530: 2f 2a 0a 2a 2a 20 54 68 69 73 20 6d 61 63 72 6f  /*.** This macro
1540: 20 72 6f 75 6e 64 73 20 76 61 6c 75 65 73 20 75   rounds values u
1550: 70 20 73 6f 20 74 68 61 74 20 69 66 20 74 68 65  p so that if the
1560: 20 76 61 6c 75 65 20 69 73 20 61 6e 20 61 64 64   value is an add
1570: 72 65 73 73 20 69 74 0a 2a 2a 20 69 73 20 67 75  ress it.** is gu
1580: 61 72 61 6e 74 65 65 64 20 74 6f 20 62 65 20 61  aranteed to be a
1590: 6e 20 61 64 64 72 65 73 73 20 74 68 61 74 20 69  n address that i
15a0: 73 20 61 6c 69 67 6e 65 64 20 74 6f 20 61 6e 20  s aligned to an 
15b0: 38 2d 62 79 74 65 20 62 6f 75 6e 64 61 72 79 2e  8-byte boundary.
15c0: 0a 2a 2f 0a 23 64 65 66 69 6e 65 20 46 4f 52 43  .*/.#define FORC
15d0: 45 5f 41 4c 49 47 4e 4d 45 4e 54 28 58 29 20 20  E_ALIGNMENT(X)  
15e0: 20 28 28 28 58 29 2b 37 29 26 7e 37 29 0a 0a 74   (((X)+7)&~7)..t
15f0: 79 70 65 64 65 66 20 73 74 72 75 63 74 20 50 67  ypedef struct Pg
1600: 48 64 72 20 50 67 48 64 72 3b 0a 0a 2f 2a 0a 2a  Hdr PgHdr;../*.*
1610: 2a 20 45 61 63 68 20 70 61 67 65 72 20 73 74 6f  * Each pager sto
1620: 72 65 73 20 61 6c 6c 20 63 75 72 72 65 6e 74 6c  res all currentl
1630: 79 20 75 6e 72 65 66 65 72 65 6e 63 65 64 20 70  y unreferenced p
1640: 61 67 65 73 20 69 6e 20 61 20 6c 69 73 74 20 73  ages in a list s
1650: 6f 72 74 65 64 0a 2a 2a 20 69 6e 20 6c 65 61 73  orted.** in leas
1660: 74 2d 72 65 63 65 6e 74 6c 79 2d 75 73 65 64 20  t-recently-used 
1670: 28 4c 52 55 29 20 6f 72 64 65 72 20 28 69 2e 65  (LRU) order (i.e
1680: 2e 20 74 68 65 20 66 69 72 73 74 20 69 74 65 6d  . the first item
1690: 20 6f 6e 20 74 68 65 20 6c 69 73 74 20 68 61 73   on the list has
16a0: 20 0a 2a 2a 20 6e 6f 74 20 62 65 65 6e 20 72 65   .** not been re
16b0: 66 65 72 65 6e 63 65 64 20 69 6e 20 61 20 6c 6f  ferenced in a lo
16c0: 6e 67 20 74 69 6d 65 2c 20 74 68 65 20 6c 61 73  ng time, the las
16d0: 74 20 69 74 65 6d 20 68 61 73 20 62 65 65 6e 20  t item has been 
16e0: 72 65 63 65 6e 74 6c 79 0a 2a 2a 20 75 73 65 64  recently.** used
16f0: 29 2e 20 41 6e 20 69 6e 73 74 61 6e 63 65 20 6f  ). An instance o
1700: 66 20 74 68 69 73 20 73 74 72 75 63 74 75 72 65  f this structure
1710: 20 69 73 20 69 6e 63 6c 75 64 65 64 20 61 73 20   is included as 
1720: 70 61 72 74 20 6f 66 20 65 61 63 68 0a 2a 2a 20  part of each.** 
1730: 70 61 67 65 72 20 73 74 72 75 63 74 75 72 65 20  pager structure 
1740: 66 6f 72 20 74 68 69 73 20 70 75 72 70 6f 73 65  for this purpose
1750: 20 28 76 61 72 69 61 62 6c 65 20 50 61 67 65 72   (variable Pager
1760: 2e 6c 72 75 29 2e 0a 2a 2a 0a 2a 2a 20 41 64 64  .lru)..**.** Add
1770: 69 74 69 6f 6e 61 6c 6c 79 2c 20 69 66 20 6d 65  itionally, if me
1780: 6d 6f 72 79 2d 6d 61 6e 61 67 65 6d 65 6e 74 20  mory-management 
1790: 69 73 20 65 6e 61 62 6c 65 64 2c 20 61 6c 6c 20  is enabled, all 
17a0: 75 6e 72 65 66 65 72 65 6e 63 65 64 20 70 61 67  unreferenced pag
17b0: 65 73 20 0a 2a 2a 20 61 72 65 20 73 74 6f 72 65  es .** are store
17c0: 64 20 69 6e 20 61 20 67 6c 6f 62 61 6c 20 4c 52  d in a global LR
17d0: 55 20 6c 69 73 74 20 28 67 6c 6f 62 61 6c 20 76  U list (global v
17e0: 61 72 69 61 62 6c 65 20 73 71 6c 69 74 65 33 4c  ariable sqlite3L
17f0: 72 75 50 61 67 65 4c 69 73 74 29 2e 0a 2a 2a 0a  ruPageList)..**.
1800: 2a 2a 20 49 6e 20 62 6f 74 68 20 63 61 73 65 73  ** In both cases
1810: 2c 20 74 68 65 20 50 61 67 65 72 4c 72 75 4c 69  , the PagerLruLi
1820: 73 74 2e 70 46 69 72 73 74 53 79 6e 63 65 64 20  st.pFirstSynced 
1830: 76 61 72 69 61 62 6c 65 20 70 6f 69 6e 74 73 20  variable points 
1840: 74 6f 0a 2a 2a 20 74 68 65 20 66 69 72 73 74 20  to.** the first 
1850: 70 61 67 65 20 69 6e 20 74 68 65 20 63 6f 72 72  page in the corr
1860: 65 73 70 6f 6e 64 69 6e 67 20 6c 69 73 74 20 74  esponding list t
1870: 68 61 74 20 64 6f 65 73 20 6e 6f 74 20 72 65 71  hat does not req
1880: 75 69 72 65 20 61 6e 0a 2a 2a 20 66 73 79 6e 63  uire an.** fsync
1890: 28 29 20 6f 70 65 72 61 74 69 6f 6e 20 62 65 66  () operation bef
18a0: 6f 72 65 20 69 74 73 20 6d 65 6d 6f 72 79 20 63  ore its memory c
18b0: 61 6e 20 62 65 20 72 65 63 6c 61 69 6d 65 64 2e  an be reclaimed.
18c0: 20 49 66 20 6e 6f 20 73 75 63 68 0a 2a 2a 20 70   If no such.** p
18d0: 61 67 65 20 65 78 69 73 74 73 2c 20 50 61 67 65  age exists, Page
18e0: 72 4c 72 75 4c 69 73 74 2e 70 46 69 72 73 74 53  rLruList.pFirstS
18f0: 79 6e 63 65 64 20 69 73 20 73 65 74 20 74 6f 20  ynced is set to 
1900: 4e 55 4c 4c 2e 0a 2a 2f 0a 74 79 70 65 64 65 66  NULL..*/.typedef
1910: 20 73 74 72 75 63 74 20 50 61 67 65 72 4c 72 75   struct PagerLru
1920: 4c 69 73 74 20 50 61 67 65 72 4c 72 75 4c 69 73  List PagerLruLis
1930: 74 3b 0a 73 74 72 75 63 74 20 50 61 67 65 72 4c  t;.struct PagerL
1940: 72 75 4c 69 73 74 20 7b 0a 20 20 50 67 48 64 72  ruList {.  PgHdr
1950: 20 2a 70 46 69 72 73 74 3b 20 20 20 20 20 20 20   *pFirst;       
1960: 20 20 2f 2a 20 46 69 72 73 74 20 70 61 67 65 20    /* First page 
1970: 69 6e 20 4c 52 55 20 6c 69 73 74 20 2a 2f 0a 20  in LRU list */. 
1980: 20 50 67 48 64 72 20 2a 70 4c 61 73 74 3b 20 20   PgHdr *pLast;  
1990: 20 20 20 20 20 20 20 20 2f 2a 20 4c 61 73 74 20          /* Last 
19a0: 70 61 67 65 20 69 6e 20 4c 52 55 20 6c 69 73 74  page in LRU list
19b0: 20 28 74 68 65 20 6d 6f 73 74 20 72 65 63 65 6e   (the most recen
19c0: 74 6c 79 20 75 73 65 64 29 20 2a 2f 0a 20 20 50  tly used) */.  P
19d0: 67 48 64 72 20 2a 70 46 69 72 73 74 53 79 6e 63  gHdr *pFirstSync
19e0: 65 64 3b 20 20 20 2f 2a 20 46 69 72 73 74 20 70  ed;   /* First p
19f0: 61 67 65 20 69 6e 20 6c 69 73 74 20 77 69 74 68  age in list with
1a00: 20 50 67 48 64 72 2e 6e 65 65 64 53 79 6e 63 3d   PgHdr.needSync=
1a10: 3d 30 20 2a 2f 0a 7d 3b 0a 0a 2f 2a 0a 2a 2a 20  =0 */.};../*.** 
1a20: 54 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 73 74  The following st
1a30: 72 75 63 74 75 72 65 20 63 6f 6e 74 61 69 6e 73  ructure contains
1a40: 20 74 68 65 20 6e 65 78 74 20 61 6e 64 20 70 72   the next and pr
1a50: 65 76 69 6f 75 73 20 70 6f 69 6e 74 65 72 73 20  evious pointers 
1a60: 75 73 65 64 0a 2a 2a 20 74 6f 20 6c 69 6e 6b 20  used.** to link 
1a70: 61 20 50 67 48 64 72 20 73 74 72 75 63 74 75 72  a PgHdr structur
1a80: 65 20 69 6e 74 6f 20 61 20 50 61 67 65 72 4c 72  e into a PagerLr
1a90: 75 4c 69 73 74 20 6c 69 6e 6b 65 64 20 6c 69 73  uList linked lis
1aa0: 74 2e 20 0a 2a 2f 0a 74 79 70 65 64 65 66 20 73  t. .*/.typedef s
1ab0: 74 72 75 63 74 20 50 61 67 65 72 4c 72 75 4c 69  truct PagerLruLi
1ac0: 6e 6b 20 50 61 67 65 72 4c 72 75 4c 69 6e 6b 3b  nk PagerLruLink;
1ad0: 0a 73 74 72 75 63 74 20 50 61 67 65 72 4c 72 75  .struct PagerLru
1ae0: 4c 69 6e 6b 20 7b 0a 20 20 50 67 48 64 72 20 2a  Link {.  PgHdr *
1af0: 70 4e 65 78 74 3b 0a 20 20 50 67 48 64 72 20 2a  pNext;.  PgHdr *
1b00: 70 50 72 65 76 3b 0a 7d 3b 0a 0a 2f 2a 0a 2a 2a  pPrev;.};../*.**
1b10: 20 45 61 63 68 20 69 6e 2d 6d 65 6d 6f 72 79 20   Each in-memory 
1b20: 69 6d 61 67 65 20 6f 66 20 61 20 70 61 67 65 20  image of a page 
1b30: 62 65 67 69 6e 73 20 77 69 74 68 20 74 68 65 20  begins with the 
1b40: 66 6f 6c 6c 6f 77 69 6e 67 20 68 65 61 64 65 72  following header
1b50: 2e 0a 2a 2a 20 54 68 69 73 20 68 65 61 64 65 72  ..** This header
1b60: 20 69 73 20 6f 6e 6c 79 20 76 69 73 69 62 6c 65   is only visible
1b70: 20 74 6f 20 74 68 69 73 20 70 61 67 65 72 20 6d   to this pager m
1b80: 6f 64 75 6c 65 2e 20 20 54 68 65 20 63 6c 69 65  odule.  The clie
1b90: 6e 74 0a 2a 2a 20 63 6f 64 65 20 74 68 61 74 20  nt.** code that 
1ba0: 63 61 6c 6c 73 20 70 61 67 65 72 20 73 65 65 73  calls pager sees
1bb0: 20 6f 6e 6c 79 20 74 68 65 20 64 61 74 61 20 74   only the data t
1bc0: 68 61 74 20 66 6f 6c 6c 6f 77 73 20 74 68 65 20  hat follows the 
1bd0: 68 65 61 64 65 72 2e 0a 2a 2a 0a 2a 2a 20 43 6c  header..**.** Cl
1be0: 69 65 6e 74 20 63 6f 64 65 20 73 68 6f 75 6c 64  ient code should
1bf0: 20 63 61 6c 6c 20 73 71 6c 69 74 65 33 50 61 67   call sqlite3Pag
1c00: 65 72 57 72 69 74 65 28 29 20 6f 6e 20 61 20 70  erWrite() on a p
1c10: 61 67 65 20 70 72 69 6f 72 20 74 6f 20 6d 61 6b  age prior to mak
1c20: 69 6e 67 0a 2a 2a 20 61 6e 79 20 6d 6f 64 69 66  ing.** any modif
1c30: 69 63 61 74 69 6f 6e 73 20 74 6f 20 74 68 61 74  ications to that
1c40: 20 70 61 67 65 2e 20 20 54 68 65 20 66 69 72 73   page.  The firs
1c50: 74 20 74 69 6d 65 20 73 71 6c 69 74 65 33 50 61  t time sqlite3Pa
1c60: 67 65 72 57 72 69 74 65 28 29 0a 2a 2a 20 69 73  gerWrite().** is
1c70: 20 63 61 6c 6c 65 64 2c 20 74 68 65 20 6f 72 69   called, the ori
1c80: 67 69 6e 61 6c 20 70 61 67 65 20 63 6f 6e 74 65  ginal page conte
1c90: 6e 74 73 20 61 72 65 20 77 72 69 74 74 65 6e 20  nts are written 
1ca0: 69 6e 74 6f 20 74 68 65 20 72 6f 6c 6c 62 61 63  into the rollbac
1cb0: 6b 0a 2a 2a 20 6a 6f 75 72 6e 61 6c 20 61 6e 64  k.** journal and
1cc0: 20 50 67 48 64 72 2e 69 6e 4a 6f 75 72 6e 61 6c   PgHdr.inJournal
1cd0: 20 61 6e 64 20 50 67 48 64 72 2e 6e 65 65 64 53   and PgHdr.needS
1ce0: 79 6e 63 20 61 72 65 20 73 65 74 2e 20 20 4c 61  ync are set.  La
1cf0: 74 65 72 2c 20 6f 6e 63 65 0a 2a 2a 20 74 68 65  ter, once.** the
1d00: 20 6a 6f 75 72 6e 61 6c 20 70 61 67 65 20 68 61   journal page ha
1d10: 73 20 6d 61 64 65 20 69 74 20 6f 6e 74 6f 20 74  s made it onto t
1d20: 68 65 20 64 69 73 6b 20 73 75 72 66 61 63 65 2c  he disk surface,
1d30: 20 50 67 48 64 72 2e 6e 65 65 64 53 79 6e 63 0a   PgHdr.needSync.
1d40: 2a 2a 20 69 73 20 63 6c 65 61 72 65 64 2e 20 20  ** is cleared.  
1d50: 54 68 65 20 6d 6f 64 69 66 69 65 64 20 70 61 67  The modified pag
1d60: 65 20 63 61 6e 6e 6f 74 20 62 65 20 77 72 69 74  e cannot be writ
1d70: 74 65 6e 20 62 61 63 6b 20 69 6e 74 6f 20 74 68  ten back into th
1d80: 65 20 6f 72 69 67 69 6e 61 6c 0a 2a 2a 20 64 61  e original.** da
1d90: 74 61 62 61 73 65 20 66 69 6c 65 20 75 6e 74 69  tabase file unti
1da0: 6c 20 74 68 65 20 6a 6f 75 72 6e 61 6c 20 70 61  l the journal pa
1db0: 67 65 73 20 68 61 73 20 62 65 65 6e 20 73 79 6e  ges has been syn
1dc0: 63 65 64 20 74 6f 20 64 69 73 6b 20 61 6e 64 20  ced to disk and 
1dd0: 74 68 65 0a 2a 2a 20 50 67 48 64 72 2e 6e 65 65  the.** PgHdr.nee
1de0: 64 53 79 6e 63 20 68 61 73 20 62 65 65 6e 20 63  dSync has been c
1df0: 6c 65 61 72 65 64 2e 0a 2a 2a 0a 2a 2a 20 54 68  leared..**.** Th
1e00: 65 20 50 67 48 64 72 2e 64 69 72 74 79 20 66 6c  e PgHdr.dirty fl
1e10: 61 67 20 69 73 20 73 65 74 20 77 68 65 6e 20 73  ag is set when s
1e20: 71 6c 69 74 65 33 50 61 67 65 72 57 72 69 74 65  qlite3PagerWrite
1e30: 28 29 20 69 73 20 63 61 6c 6c 65 64 20 61 6e 64  () is called and
1e40: 0a 2a 2a 20 69 73 20 63 6c 65 61 72 65 64 20 61  .** is cleared a
1e50: 67 61 69 6e 20 77 68 65 6e 20 74 68 65 20 70 61  gain when the pa
1e60: 67 65 20 63 6f 6e 74 65 6e 74 20 69 73 20 77 72  ge content is wr
1e70: 69 74 74 65 6e 20 62 61 63 6b 20 74 6f 20 74 68  itten back to th
1e80: 65 20 6f 72 69 67 69 6e 61 6c 0a 2a 2a 20 64 61  e original.** da
1e90: 74 61 62 61 73 65 20 66 69 6c 65 2e 0a 2a 2a 0a  tabase file..**.
1ea0: 2a 2a 20 44 65 74 61 69 6c 73 20 6f 66 20 69 6d  ** Details of im
1eb0: 70 6f 72 74 61 6e 74 20 73 74 72 75 63 74 75 72  portant structur
1ec0: 65 20 65 6c 65 6d 65 6e 74 73 3a 0a 2a 2a 0a 2a  e elements:.**.*
1ed0: 2a 20 6e 65 65 64 53 79 6e 63 0a 2a 2a 0a 2a 2a  * needSync.**.**
1ee0: 20 20 20 20 20 49 66 20 74 68 69 73 20 69 73 20       If this is 
1ef0: 74 72 75 65 2c 20 74 68 69 73 20 6d 65 61 6e 73  true, this means
1f00: 20 74 68 61 74 20 69 74 20 69 73 20 6e 6f 74 20   that it is not 
1f10: 73 61 66 65 20 74 6f 20 77 72 69 74 65 20 74 68  safe to write th
1f20: 65 20 70 61 67 65 0a 2a 2a 20 20 20 20 20 63 6f  e page.**     co
1f30: 6e 74 65 6e 74 20 74 6f 20 74 68 65 20 64 61 74  ntent to the dat
1f40: 61 62 61 73 65 20 62 65 63 61 75 73 65 20 74 68  abase because th
1f50: 65 20 6f 72 69 67 69 6e 61 6c 20 63 6f 6e 74 65  e original conte
1f60: 6e 74 20 6e 65 65 64 65 64 0a 2a 2a 20 20 20 20  nt needed.**    
1f70: 20 66 6f 72 20 72 6f 6c 6c 62 61 63 6b 20 68 61   for rollback ha
1f80: 73 20 6e 6f 74 20 62 79 20 73 79 6e 63 65 64 20  s not by synced 
1f90: 74 6f 20 74 68 65 20 6d 61 69 6e 20 72 6f 6c 6c  to the main roll
1fa0: 62 61 63 6b 20 6a 6f 75 72 6e 61 6c 2e 0a 2a 2a  back journal..**
1fb0: 20 20 20 20 20 54 68 65 20 6f 72 69 67 69 6e 61       The origina
1fc0: 6c 20 63 6f 6e 74 65 6e 74 20 6d 61 79 20 68 61  l content may ha
1fd0: 76 65 20 62 65 65 6e 20 77 72 69 74 74 65 6e 20  ve been written 
1fe0: 74 6f 20 74 68 65 20 72 6f 6c 6c 62 61 63 6b 20  to the rollback 
1ff0: 6a 6f 75 72 6e 61 6c 0a 2a 2a 20 20 20 20 20 62  journal.**     b
2000: 75 74 20 69 74 20 68 61 73 20 6e 6f 74 20 79 65  ut it has not ye
2010: 74 20 62 65 65 6e 20 73 79 6e 63 65 64 2e 20 20  t been synced.  
2020: 53 6f 20 77 65 20 63 61 6e 6e 6f 74 20 77 72 69  So we cannot wri
2030: 74 65 20 74 6f 20 74 68 65 20 64 61 74 61 62 61  te to the databa
2040: 73 65 0a 2a 2a 20 20 20 20 20 66 69 6c 65 20 62  se.**     file b
2050: 65 63 61 75 73 65 20 70 6f 77 65 72 20 66 61 69  ecause power fai
2060: 6c 75 72 65 20 6d 69 67 68 74 20 63 61 75 73 65  lure might cause
2070: 20 74 68 65 20 70 61 67 65 20 69 6e 20 74 68 65   the page in the
2080: 20 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 0a 2a 2a   journal file.**
2090: 20 20 20 20 20 74 6f 20 6e 65 76 65 72 20 72 65       to never re
20a0: 61 63 68 20 74 68 65 20 64 69 73 6b 2e 20 20 49  ach the disk.  I
20b0: 74 20 69 73 20 61 73 20 69 66 20 74 68 65 20 77  t is as if the w
20c0: 72 69 74 65 20 74 6f 20 74 68 65 20 6a 6f 75 72  rite to the jour
20d0: 6e 61 6c 20 66 69 6c 65 0a 2a 2a 20 20 20 20 20  nal file.**     
20e0: 64 6f 65 73 20 6e 6f 74 20 6f 63 63 75 72 20 75  does not occur u
20f0: 6e 74 69 6c 20 74 68 65 20 6a 6f 75 72 6e 61 6c  ntil the journal
2100: 20 66 69 6c 65 20 69 73 20 73 79 6e 63 65 64 2e   file is synced.
2110: 0a 2a 2a 20 20 20 20 20 0a 2a 2a 20 20 20 20 20  .**     .**     
2120: 54 68 69 73 20 66 6c 61 67 20 69 73 20 66 61 6c  This flag is fal
2130: 73 65 20 69 66 20 74 68 65 20 70 61 67 65 20 63  se if the page c
2140: 6f 6e 74 65 6e 74 20 65 78 61 63 74 6c 79 20 6d  ontent exactly m
2150: 61 74 63 68 65 73 20 77 68 61 74 0a 2a 2a 20 20  atches what.**  
2160: 20 20 20 63 75 72 72 65 6e 74 6c 79 20 65 78 69     currently exi
2170: 73 74 73 20 69 6e 20 74 68 65 20 64 61 74 61 62  sts in the datab
2180: 61 73 65 20 66 69 6c 65 2e 20 20 54 68 65 20 6e  ase file.  The n
2190: 65 65 64 53 79 6e 63 20 66 6c 61 67 20 69 73 20  eedSync flag is 
21a0: 61 6c 73 6f 0a 2a 2a 20 20 20 20 20 66 61 6c 73  also.**     fals
21b0: 65 20 69 66 20 74 68 65 20 6f 72 69 67 69 6e 61  e if the origina
21c0: 6c 20 63 6f 6e 74 65 6e 74 20 68 61 73 20 62 65  l content has be
21d0: 65 6e 20 77 72 69 74 74 65 6e 20 74 6f 20 74 68  en written to th
21e0: 65 20 6d 61 69 6e 20 72 6f 6c 6c 62 61 63 6b 0a  e main rollback.
21f0: 2a 2a 20 20 20 20 20 6a 6f 75 72 6e 61 6c 20 61  **     journal a
2200: 6e 64 20 73 79 6e 63 65 64 2e 20 20 49 66 20 74  nd synced.  If t
2210: 68 65 20 70 61 67 65 20 72 65 70 72 65 73 65 6e  he page represen
2220: 74 73 20 61 20 6e 65 77 20 70 61 67 65 20 74 68  ts a new page th
2230: 61 74 20 68 61 73 0a 2a 2a 20 20 20 20 20 62 65  at has.**     be
2240: 65 6e 20 61 64 64 65 64 20 6f 6e 74 6f 20 74 68  en added onto th
2250: 65 20 65 6e 64 20 6f 66 20 74 68 65 20 64 61 74  e end of the dat
2260: 61 62 61 73 65 20 64 75 72 69 6e 67 20 74 68 65  abase during the
2270: 20 63 75 72 72 65 6e 74 0a 2a 2a 20 20 20 20 20   current.**     
2280: 74 72 61 6e 73 61 63 74 69 6f 6e 2c 20 74 68 65  transaction, the
2290: 20 6e 65 65 64 53 79 6e 63 20 66 6c 61 67 20 69   needSync flag i
22a0: 73 20 74 72 75 65 20 75 6e 74 69 6c 20 74 68 65  s true until the
22b0: 20 6f 72 69 67 69 6e 61 6c 20 64 61 74 61 62 61   original databa
22c0: 73 65 0a 2a 2a 20 20 20 20 20 73 69 7a 65 20 69  se.**     size i
22d0: 6e 20 74 68 65 20 6a 6f 75 72 6e 61 6c 20 68 65  n the journal he
22e0: 61 64 65 72 20 68 61 73 20 62 65 65 6e 20 73 79  ader has been sy
22f0: 6e 63 65 64 20 74 6f 20 64 69 73 6b 2e 0a 2a 2a  nced to disk..**
2300: 0a 2a 2a 20 69 6e 4a 6f 75 72 6e 61 6c 0a 2a 2a  .** inJournal.**
2310: 0a 2a 2a 20 20 20 20 20 54 68 69 73 20 69 73 20  .**     This is 
2320: 74 72 75 65 20 69 66 20 74 68 65 20 6f 72 69 67  true if the orig
2330: 69 6e 61 6c 20 70 61 67 65 20 68 61 73 20 62 65  inal page has be
2340: 65 6e 20 77 72 69 74 74 65 6e 20 69 6e 74 6f 20  en written into 
2350: 74 68 65 20 6d 61 69 6e 0a 2a 2a 20 20 20 20 20  the main.**     
2360: 72 6f 6c 6c 62 61 63 6b 20 6a 6f 75 72 6e 61 6c  rollback journal
2370: 2e 20 20 54 68 69 73 20 69 73 20 61 6c 77 61 79  .  This is alway
2380: 73 20 66 61 6c 73 65 20 66 6f 72 20 6e 65 77 20  s false for new 
2390: 70 61 67 65 73 20 61 64 64 65 64 20 74 6f 0a 2a  pages added to.*
23a0: 2a 20 20 20 20 20 74 68 65 20 65 6e 64 20 6f 66  *     the end of
23b0: 20 74 68 65 20 64 61 74 61 62 61 73 65 20 66 69   the database fi
23c0: 6c 65 20 64 75 72 69 6e 67 20 74 68 65 20 63 75  le during the cu
23d0: 72 72 65 6e 74 20 74 72 61 6e 73 61 63 74 69 6f  rrent transactio
23e0: 6e 2e 0a 2a 2a 20 20 20 20 20 41 6e 64 20 74 68  n..**     And th
23f0: 69 73 20 66 6c 61 67 20 73 61 79 73 20 6e 6f 74  is flag says not
2400: 68 69 6e 67 20 61 62 6f 75 74 20 77 68 65 74 68  hing about wheth
2410: 65 72 20 6f 72 20 6e 6f 74 20 74 68 65 20 6a 6f  er or not the jo
2420: 75 72 6e 61 6c 0a 2a 2a 20 20 20 20 20 68 61 73  urnal.**     has
2430: 20 62 65 65 6e 20 73 79 6e 63 65 64 20 74 6f 20   been synced to 
2440: 64 69 73 6b 2e 20 20 46 6f 72 20 70 61 67 65 73  disk.  For pages
2450: 20 74 68 61 74 20 61 72 65 20 69 6e 20 74 68 65   that are in the
2460: 20 6f 72 69 67 69 6e 61 6c 0a 2a 2a 20 20 20 20   original.**    
2470: 20 64 61 74 61 62 61 73 65 20 66 69 6c 65 2c 20   database file, 
2480: 74 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 65 78  the following ex
2490: 70 72 65 73 73 69 6f 6e 20 73 68 6f 75 6c 64 20  pression should 
24a0: 61 6c 77 61 79 73 20 62 65 20 74 72 75 65 3a 0a  always be true:.
24b0: 2a 2a 0a 2a 2a 20 20 20 20 20 20 20 69 6e 4a 6f  **.**       inJo
24c0: 75 72 6e 61 6c 20 3d 20 73 71 6c 69 74 65 33 42  urnal = sqlite3B
24d0: 69 74 76 65 63 54 65 73 74 28 70 50 61 67 65 72  itvecTest(pPager
24e0: 2d 3e 70 49 6e 4a 6f 75 72 6e 61 6c 2c 20 70 67  ->pInJournal, pg
24f0: 6e 6f 29 0a 2a 2a 0a 2a 2a 20 20 20 20 20 54 68  no).**.**     Th
2500: 65 20 70 50 61 67 65 72 2d 3e 70 49 6e 4a 6f 75  e pPager->pInJou
2510: 72 6e 61 6c 20 6f 62 6a 65 63 74 20 69 73 20 6f  rnal object is o
2520: 6e 6c 79 20 76 61 6c 69 64 20 66 6f 72 20 74 68  nly valid for th
2530: 65 20 6f 72 69 67 69 6e 61 6c 0a 2a 2a 20 20 20  e original.**   
2540: 20 20 70 61 67 65 73 20 6f 66 20 74 68 65 20 64    pages of the d
2550: 61 74 61 62 61 73 65 2c 20 6e 6f 74 20 6e 65 77  atabase, not new
2560: 20 70 61 67 65 73 20 74 68 61 74 20 61 72 65 20   pages that are 
2570: 61 64 64 65 64 20 74 6f 20 74 68 65 20 65 6e 64  added to the end
2580: 0a 2a 2a 20 20 20 20 20 6f 66 20 74 68 65 20 64  .**     of the d
2590: 61 74 61 62 61 73 65 2c 20 73 6f 20 6f 62 76 69  atabase, so obvi
25a0: 6f 75 73 6c 79 20 74 68 65 20 61 62 6f 76 65 20  ously the above 
25b0: 65 78 70 72 65 73 73 69 6f 6e 20 63 61 6e 6e 6f  expression canno
25c0: 74 20 62 65 0a 2a 2a 20 20 20 20 20 76 61 6c 69  t be.**     vali
25d0: 64 20 66 6f 72 20 6e 65 77 20 70 61 67 65 73 2e  d for new pages.
25e0: 20 20 46 6f 72 20 6e 65 77 20 70 61 67 65 73 20    For new pages 
25f0: 69 6e 4a 6f 75 72 6e 61 6c 20 69 73 20 61 6c 77  inJournal is alw
2600: 61 79 73 20 30 2e 0a 2a 2a 0a 2a 2a 20 64 69 72  ays 0..**.** dir
2610: 74 79 0a 2a 2a 0a 2a 2a 20 20 20 20 20 57 68 65  ty.**.**     Whe
2620: 6e 20 74 72 75 65 2c 20 74 68 69 73 20 6d 65 61  n true, this mea
2630: 6e 73 20 74 68 61 74 20 74 68 65 20 63 6f 6e 74  ns that the cont
2640: 65 6e 74 20 6f 66 20 74 68 65 20 70 61 67 65 20  ent of the page 
2650: 68 61 73 20 62 65 65 6e 0a 2a 2a 20 20 20 20 20  has been.**     
2660: 6d 6f 64 69 66 69 65 64 20 61 6e 64 20 6e 65 65  modified and nee
2670: 64 73 20 74 6f 20 62 65 20 77 72 69 74 74 65 6e  ds to be written
2680: 20 62 61 63 6b 20 74 6f 20 74 68 65 20 64 61 74   back to the dat
2690: 61 62 61 73 65 20 66 69 6c 65 2e 0a 2a 2a 20 20  abase file..**  
26a0: 20 20 20 49 66 20 66 61 6c 73 65 2c 20 69 74 20     If false, it 
26b0: 6d 65 61 6e 73 20 74 68 61 74 20 65 69 74 68 65  means that eithe
26c0: 72 20 74 68 65 20 63 6f 6e 74 65 6e 74 20 6f 66  r the content of
26d0: 20 74 68 65 20 70 61 67 65 20 69 73 0a 2a 2a 20   the page is.** 
26e0: 20 20 20 20 75 6e 63 68 61 6e 67 65 64 20 6f 72      unchanged or
26f0: 20 65 6c 73 65 20 74 68 65 20 63 6f 6e 74 65 6e   else the conten
2700: 74 20 69 73 20 75 6e 69 6d 70 6f 72 74 61 6e 74  t is unimportant
2710: 20 61 6e 64 20 77 65 20 64 6f 20 6e 6f 74 0a 2a   and we do not.*
2720: 2a 20 20 20 20 20 63 61 72 65 20 77 68 65 74 68  *     care wheth
2730: 65 72 20 6f 72 20 6e 6f 74 20 69 74 20 69 73 20  er or not it is 
2740: 70 72 65 73 65 72 76 65 64 2e 0a 2a 2a 0a 2a 2a  preserved..**.**
2750: 20 61 6c 77 61 79 73 52 6f 6c 6c 62 61 63 6b 0a   alwaysRollback.
2760: 2a 2a 0a 2a 2a 20 20 20 20 20 54 68 69 73 20 6d  **.**     This m
2770: 65 61 6e 73 20 74 68 61 74 20 74 68 65 20 73 71  eans that the sq
2780: 6c 69 74 65 33 50 61 67 65 72 44 6f 6e 74 52 6f  lite3PagerDontRo
2790: 6c 6c 62 61 63 6b 28 29 20 41 50 49 20 73 68 6f  llback() API sho
27a0: 75 6c 64 20 62 65 0a 2a 2a 20 20 20 20 20 69 67  uld be.**     ig
27b0: 6e 6f 72 65 64 20 66 6f 72 20 74 68 69 73 20 70  nored for this p
27c0: 61 67 65 2e 20 20 54 68 65 20 44 6f 6e 74 52 6f  age.  The DontRo
27d0: 6c 6c 62 61 63 6b 28 29 20 41 50 49 20 61 74 74  llback() API att
27e0: 65 6d 70 74 73 20 74 6f 20 73 61 79 0a 2a 2a 20  empts to say.** 
27f0: 20 20 20 20 74 68 61 74 20 74 68 65 20 63 6f 6e      that the con
2800: 74 65 6e 74 20 6f 66 20 74 68 65 20 70 61 67 65  tent of the page
2810: 20 6f 6e 20 64 69 73 6b 20 69 73 20 75 6e 69 6d   on disk is unim
2820: 70 6f 72 74 61 6e 74 20 28 69 74 20 69 73 20 61  portant (it is a
2830: 6e 0a 2a 2a 20 20 20 20 20 75 6e 75 73 65 64 20  n.**     unused 
2840: 70 61 67 65 20 6f 6e 20 74 68 65 20 66 72 65 65  page on the free
2850: 6c 69 73 74 29 20 73 6f 20 74 68 61 74 20 69 74  list) so that it
2860: 20 69 73 20 75 6e 6e 65 63 65 73 73 61 72 79 20   is unnecessary 
2870: 74 6f 20 0a 2a 2a 20 20 20 20 20 72 6f 6c 6c 62  to .**     rollb
2880: 61 63 6b 20 63 68 61 6e 67 65 73 20 74 6f 20 74  ack changes to t
2890: 68 69 73 20 70 61 67 65 20 62 65 63 61 75 73 65  his page because
28a0: 20 74 68 65 20 63 6f 6e 74 65 6e 74 20 6f 66 20   the content of 
28b0: 74 68 65 20 70 61 67 65 0a 2a 2a 20 20 20 20 20  the page.**     
28c0: 63 61 6e 20 63 68 61 6e 67 65 20 77 69 74 68 6f  can change witho
28d0: 75 74 20 63 68 61 6e 67 69 6e 67 20 74 68 65 20  ut changing the 
28e0: 6d 65 61 6e 69 6e 67 20 6f 66 20 74 68 65 20 64  meaning of the d
28f0: 61 74 61 62 61 73 65 2e 20 20 54 68 69 73 0a 2a  atabase.  This.*
2900: 2a 20 20 20 20 20 66 6c 61 67 20 6f 76 65 72 72  *     flag overr
2910: 69 64 65 73 20 61 6e 79 20 44 6f 6e 74 52 6f 6c  ides any DontRol
2920: 6c 62 61 63 6b 28 29 20 61 74 74 65 6d 70 74 2e  lback() attempt.
2930: 20 20 54 68 69 73 20 66 6c 61 67 20 69 73 20 73    This flag is s
2940: 65 74 0a 2a 2a 20 20 20 20 20 77 68 65 6e 20 61  et.**     when a
2950: 20 70 61 67 65 20 74 68 61 74 20 6f 72 69 67 69   page that origi
2960: 6e 61 6c 6c 79 20 63 6f 6e 74 61 69 6e 65 64 20  nally contained 
2970: 76 61 6c 69 64 20 64 61 74 61 20 69 73 20 61 64  valid data is ad
2980: 64 65 64 20 74 6f 0a 2a 2a 20 20 20 20 20 74 68  ded to.**     th
2990: 65 20 66 72 65 65 6c 69 73 74 2e 20 20 4c 61 74  e freelist.  Lat
29a0: 65 72 20 69 6e 20 74 68 65 20 73 61 6d 65 20 74  er in the same t
29b0: 72 61 6e 73 61 63 74 69 6f 6e 2c 20 74 68 69 73  ransaction, this
29c0: 20 70 61 67 65 20 6d 69 67 68 74 0a 2a 2a 20 20   page might.**  
29d0: 20 20 20 62 65 20 70 75 6c 6c 65 64 20 66 72 6f     be pulled fro
29e0: 6d 20 74 68 65 20 66 72 65 65 6c 69 73 74 20 61  m the freelist a
29f0: 6e 64 20 72 65 75 73 65 64 20 66 6f 72 20 73 6f  nd reused for so
2a00: 6d 65 74 68 69 6e 67 20 64 69 66 66 65 72 65 6e  mething differen
2a10: 74 0a 2a 2a 20 20 20 20 20 61 6e 64 20 61 74 20  t.**     and at 
2a20: 74 68 61 74 20 70 6f 69 6e 74 20 74 68 65 20 44  that point the D
2a30: 6f 6e 74 52 6f 6c 6c 62 61 63 6b 28 29 20 41 50  ontRollback() AP
2a40: 49 20 77 69 6c 6c 20 62 65 20 63 61 6c 6c 65 64  I will be called
2a50: 20 62 65 63 61 75 73 65 0a 2a 2a 20 20 20 20 20   because.**     
2a60: 70 61 67 65 73 20 74 61 6b 65 6e 20 66 72 6f 6d  pages taken from
2a70: 20 74 68 65 20 66 72 65 65 6c 69 73 74 20 64 6f   the freelist do
2a80: 20 6e 6f 74 20 6e 65 65 64 20 74 6f 20 62 65 20   not need to be 
2a90: 70 72 6f 74 65 63 74 65 64 20 62 79 0a 2a 2a 20  protected by.** 
2aa0: 20 20 20 20 74 68 65 20 72 6f 6c 6c 62 61 63 6b      the rollback
2ab0: 20 6a 6f 75 72 6e 61 6c 2e 20 20 42 75 74 20 74   journal.  But t
2ac0: 68 69 73 20 66 6c 61 67 20 73 61 79 73 20 74 68  his flag says th
2ad0: 61 74 20 74 68 65 20 70 61 67 65 20 77 61 73 0a  at the page was.
2ae0: 2a 2a 20 20 20 20 20 6e 6f 74 20 6f 72 69 67 69  **     not origi
2af0: 6e 61 6c 6c 79 20 70 61 72 74 20 6f 66 20 74 68  nally part of th
2b00: 65 20 66 72 65 65 6c 69 73 74 20 73 6f 20 74 68  e freelist so th
2b10: 61 74 20 69 74 20 73 74 69 6c 6c 20 6e 65 65 64  at it still need
2b20: 73 20 74 6f 0a 2a 2a 20 20 20 20 20 62 65 20 72  s to.**     be r
2b30: 6f 6c 6c 65 64 20 62 61 63 6b 20 69 6e 20 73 70  olled back in sp
2b40: 69 74 65 20 6f 66 20 61 6e 79 20 73 75 62 73 65  ite of any subse
2b50: 71 75 65 6e 74 20 44 6f 6e 74 52 6f 6c 6c 62 61  quent DontRollba
2b60: 63 6b 28 29 20 63 61 6c 6c 73 2e 0a 2a 2a 0a 2a  ck() calls..**.*
2b70: 2a 20 6e 65 65 64 52 65 61 64 20 0a 2a 2a 0a 2a  * needRead .**.*
2b80: 2a 20 20 20 20 20 54 68 69 73 20 66 6c 61 67 20  *     This flag 
2b90: 6d 65 61 6e 73 20 28 77 68 65 6e 20 74 72 75 65  means (when true
2ba0: 29 20 74 68 61 74 20 74 68 65 20 63 6f 6e 74 65  ) that the conte
2bb0: 6e 74 20 6f 66 20 74 68 65 20 70 61 67 65 20 68  nt of the page h
2bc0: 61 73 0a 2a 2a 20 20 20 20 20 6e 6f 74 20 79 65  as.**     not ye
2bd0: 74 20 62 65 65 6e 20 6c 6f 61 64 65 64 20 66 72  t been loaded fr
2be0: 6f 6d 20 64 69 73 6b 2e 20 20 54 68 65 20 69 6e  om disk.  The in
2bf0: 2d 6d 65 6d 6f 72 79 20 63 6f 6e 74 65 6e 74 20  -memory content 
2c00: 69 73 20 6a 75 73 74 0a 2a 2a 20 20 20 20 20 67  is just.**     g
2c10: 61 72 62 61 67 65 2e 20 20 28 41 63 74 75 61 6c  arbage.  (Actual
2c20: 6c 79 2c 20 77 65 20 7a 65 72 6f 20 74 68 65 20  ly, we zero the 
2c30: 63 6f 6e 74 65 6e 74 2c 20 62 75 74 20 79 6f 75  content, but you
2c40: 20 73 68 6f 75 6c 64 20 6e 6f 74 0a 2a 2a 20 20   should not.**  
2c50: 20 20 20 6d 61 6b 65 20 61 6e 79 20 61 73 73 75     make any assu
2c60: 6d 70 74 69 6f 6e 73 20 61 62 6f 75 74 20 74 68  mptions about th
2c70: 65 20 63 6f 6e 74 65 6e 74 20 6e 65 76 65 72 74  e content nevert
2c80: 68 65 6c 65 73 73 2e 29 20 20 49 66 20 74 68 65  heless.)  If the
2c90: 0a 2a 2a 20 20 20 20 20 63 6f 6e 74 65 6e 74 20  .**     content 
2ca0: 69 73 20 6e 65 65 64 65 64 20 69 6e 20 74 68 65  is needed in the
2cb0: 20 66 75 74 75 72 65 2c 20 69 74 20 73 68 6f 75   future, it shou
2cc0: 6c 64 20 62 65 20 72 65 61 64 20 66 72 6f 6d 20  ld be read from 
2cd0: 74 68 65 0a 2a 2a 20 20 20 20 20 6f 72 69 67 69  the.**     origi
2ce0: 6e 61 6c 20 64 61 74 61 62 61 73 65 20 66 69 6c  nal database fil
2cf0: 65 2e 0a 2a 2f 0a 73 74 72 75 63 74 20 50 67 48  e..*/.struct PgH
2d00: 64 72 20 7b 0a 20 20 50 61 67 65 72 20 2a 70 50  dr {.  Pager *pP
2d10: 61 67 65 72 3b 20 20 20 20 20 20 20 20 20 20 20  ager;           
2d20: 20 20 20 20 20 20 2f 2a 20 54 68 65 20 70 61 67        /* The pag
2d30: 65 72 20 74 6f 20 77 68 69 63 68 20 74 68 69 73  er to which this
2d40: 20 70 61 67 65 20 62 65 6c 6f 6e 67 73 20 2a 2f   page belongs */
2d50: 0a 20 20 50 67 6e 6f 20 70 67 6e 6f 3b 20 20 20  .  Pgno pgno;   
2d60: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
2d70: 20 20 2f 2a 20 54 68 65 20 70 61 67 65 20 6e 75    /* The page nu
2d80: 6d 62 65 72 20 66 6f 72 20 74 68 69 73 20 70 61  mber for this pa
2d90: 67 65 20 2a 2f 0a 20 20 50 67 48 64 72 20 2a 70  ge */.  PgHdr *p
2da0: 4e 65 78 74 48 61 73 68 2c 20 2a 70 50 72 65 76  NextHash, *pPrev
2db0: 48 61 73 68 3b 20 20 2f 2a 20 48 61 73 68 20 63  Hash;  /* Hash c
2dc0: 6f 6c 6c 69 73 69 6f 6e 20 63 68 61 69 6e 20 66  ollision chain f
2dd0: 6f 72 20 50 67 48 64 72 2e 70 67 6e 6f 20 2a 2f  or PgHdr.pgno */
2de0: 0a 20 20 50 61 67 65 72 4c 72 75 4c 69 6e 6b 20  .  PagerLruLink 
2df0: 66 72 65 65 3b 20 20 20 20 20 20 20 20 20 20 20  free;           
2e00: 20 20 2f 2a 20 4e 65 78 74 20 61 6e 64 20 70 72    /* Next and pr
2e10: 65 76 69 6f 75 73 20 66 72 65 65 20 70 61 67 65  evious free page
2e20: 73 20 2a 2f 0a 20 20 50 67 48 64 72 20 2a 70 4e  s */.  PgHdr *pN
2e30: 65 78 74 41 6c 6c 3b 20 20 20 20 20 20 20 20 20  extAll;         
2e40: 20 20 20 20 20 20 2f 2a 20 41 20 6c 69 73 74 20        /* A list 
2e50: 6f 66 20 61 6c 6c 20 70 61 67 65 73 20 2a 2f 0a  of all pages */.
2e60: 20 20 75 38 20 69 6e 4a 6f 75 72 6e 61 6c 3b 20    u8 inJournal; 
2e70: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
2e80: 20 2f 2a 20 54 52 55 45 20 69 66 20 68 61 73 20   /* TRUE if has 
2e90: 62 65 65 6e 20 77 72 69 74 74 65 6e 20 74 6f 20  been written to 
2ea0: 6a 6f 75 72 6e 61 6c 20 2a 2f 0a 20 20 75 38 20  journal */.  u8 
2eb0: 64 69 72 74 79 3b 20 20 20 20 20 20 20 20 20 20  dirty;          
2ec0: 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 54              /* T
2ed0: 52 55 45 20 69 66 20 77 65 20 6e 65 65 64 20 74  RUE if we need t
2ee0: 6f 20 77 72 69 74 65 20 62 61 63 6b 20 63 68 61  o write back cha
2ef0: 6e 67 65 73 20 2a 2f 0a 20 20 75 38 20 6e 65 65  nges */.  u8 nee
2f00: 64 53 79 6e 63 3b 20 20 20 20 20 20 20 20 20 20  dSync;          
2f10: 20 20 20 20 20 20 20 20 20 2f 2a 20 53 79 6e 63           /* Sync
2f20: 20 6a 6f 75 72 6e 61 6c 20 62 65 66 6f 72 65 20   journal before 
2f30: 77 72 69 74 69 6e 67 20 74 68 69 73 20 70 61 67  writing this pag
2f40: 65 20 2a 2f 0a 20 20 75 38 20 61 6c 77 61 79 73  e */.  u8 always
2f50: 52 6f 6c 6c 62 61 63 6b 3b 20 20 20 20 20 20 20  Rollback;       
2f60: 20 20 20 20 20 20 2f 2a 20 44 69 73 61 62 6c 65        /* Disable
2f70: 20 44 6f 6e 74 52 6f 6c 6c 62 61 63 6b 28 29 20   DontRollback() 
2f80: 66 6f 72 20 74 68 69 73 20 70 61 67 65 20 2a 2f  for this page */
2f90: 0a 20 20 75 38 20 6e 65 65 64 52 65 61 64 3b 20  .  u8 needRead; 
2fa0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
2fb0: 20 20 2f 2a 20 52 65 61 64 20 63 6f 6e 74 65 6e    /* Read conten
2fc0: 74 20 69 66 20 50 61 67 65 72 57 72 69 74 65 28  t if PagerWrite(
2fd0: 29 20 69 73 20 63 61 6c 6c 65 64 20 2a 2f 0a 20  ) is called */. 
2fe0: 20 73 68 6f 72 74 20 69 6e 74 20 6e 52 65 66 3b   short int nRef;
2ff0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
3000: 2f 2a 20 4e 75 6d 62 65 72 20 6f 66 20 75 73 65  /* Number of use
3010: 72 73 20 6f 66 20 74 68 69 73 20 70 61 67 65 20  rs of this page 
3020: 2a 2f 0a 20 20 50 67 48 64 72 20 2a 70 44 69 72  */.  PgHdr *pDir
3030: 74 79 2c 20 2a 70 50 72 65 76 44 69 72 74 79 3b  ty, *pPrevDirty;
3040: 20 20 20 20 2f 2a 20 44 69 72 74 79 20 70 61 67      /* Dirty pag
3050: 65 73 20 2a 2f 0a 23 69 66 64 65 66 20 53 51 4c  es */.#ifdef SQL
3060: 49 54 45 5f 45 4e 41 42 4c 45 5f 4d 45 4d 4f 52  ITE_ENABLE_MEMOR
3070: 59 5f 4d 41 4e 41 47 45 4d 45 4e 54 0a 20 20 50  Y_MANAGEMENT.  P
3080: 61 67 65 72 4c 72 75 4c 69 6e 6b 20 67 66 72 65  agerLruLink gfre
3090: 65 3b 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a  e;            /*
30a0: 20 47 6c 6f 62 61 6c 20 6c 69 73 74 20 6f 66 20   Global list of 
30b0: 6e 52 65 66 3d 3d 30 20 70 61 67 65 73 20 2a 2f  nRef==0 pages */
30c0: 0a 23 65 6e 64 69 66 0a 23 69 66 64 65 66 20 53  .#endif.#ifdef S
30d0: 51 4c 49 54 45 5f 43 48 45 43 4b 5f 50 41 47 45  QLITE_CHECK_PAGE
30e0: 53 0a 20 20 75 33 32 20 70 61 67 65 48 61 73 68  S.  u32 pageHash
30f0: 3b 0a 23 65 6e 64 69 66 0a 20 20 76 6f 69 64 20  ;.#endif.  void 
3100: 2a 70 44 61 74 61 3b 20 20 20 20 20 20 20 20 20  *pData;         
3110: 20 20 20 20 20 20 20 20 20 20 2f 2a 20 50 61 67            /* Pag
3120: 65 20 64 61 74 61 20 2a 2f 0a 20 20 2f 2a 20 50  e data */.  /* P
3130: 61 67 65 72 2e 6e 45 78 74 72 61 20 62 79 74 65  ager.nExtra byte
3140: 73 20 6f 66 20 6c 6f 63 61 6c 20 64 61 74 61 20  s of local data 
3150: 61 70 70 65 6e 64 65 64 20 74 6f 20 74 68 69 73  appended to this
3160: 20 68 65 61 64 65 72 20 2a 2f 0a 7d 3b 0a 0a 2f   header */.};../
3170: 2a 0a 2a 2a 20 46 6f 72 20 61 6e 20 69 6e 2d 6d  *.** For an in-m
3180: 65 6d 6f 72 79 20 6f 6e 6c 79 20 64 61 74 61 62  emory only datab
3190: 61 73 65 2c 20 73 6f 6d 65 20 65 78 74 72 61 20  ase, some extra 
31a0: 69 6e 66 6f 72 6d 61 74 69 6f 6e 20 69 73 20 72  information is r
31b0: 65 63 6f 72 64 65 64 20 61 62 6f 75 74 0a 2a 2a  ecorded about.**
31c0: 20 65 61 63 68 20 70 61 67 65 20 73 6f 20 74 68   each page so th
31d0: 61 74 20 63 68 61 6e 67 65 73 20 63 61 6e 20 62  at changes can b
31e0: 65 20 72 6f 6c 6c 65 64 20 62 61 63 6b 2e 20 20  e rolled back.  
31f0: 28 4a 6f 75 72 6e 61 6c 20 66 69 6c 65 73 20 61  (Journal files a
3200: 72 65 20 6e 6f 74 0a 2a 2a 20 75 73 65 64 20 66  re not.** used f
3210: 6f 72 20 69 6e 2d 6d 65 6d 6f 72 79 20 64 61 74  or in-memory dat
3220: 61 62 61 73 65 73 2e 29 20 20 54 68 65 20 66 6f  abases.)  The fo
3230: 6c 6c 6f 77 69 6e 67 20 69 6e 66 6f 72 6d 61 74  llowing informat
3240: 69 6f 6e 20 69 73 20 61 64 64 65 64 20 74 6f 0a  ion is added to.
3250: 2a 2a 20 74 68 65 20 65 6e 64 20 6f 66 20 65 76  ** the end of ev
3260: 65 72 79 20 45 58 54 52 41 20 62 6c 6f 63 6b 20  ery EXTRA block 
3270: 66 6f 72 20 69 6e 2d 6d 65 6d 6f 72 79 20 64 61  for in-memory da
3280: 74 61 62 61 73 65 73 2e 0a 2a 2a 0a 2a 2a 20 54  tabases..**.** T
3290: 68 69 73 20 69 6e 66 6f 72 6d 61 74 69 6f 6e 20  his information 
32a0: 63 6f 75 6c 64 20 68 61 76 65 20 62 65 65 6e 20  could have been 
32b0: 61 64 64 65 64 20 64 69 72 65 63 74 6c 79 20 74  added directly t
32c0: 6f 20 74 68 65 20 50 67 48 64 72 20 73 74 72 75  o the PgHdr stru
32d0: 63 74 75 72 65 2e 0a 2a 2a 20 42 75 74 20 74 68  cture..** But th
32e0: 65 6e 20 69 74 20 77 6f 75 6c 64 20 74 61 6b 65  en it would take
32f0: 20 75 70 20 61 6e 20 65 78 74 72 61 20 38 20 62   up an extra 8 b
3300: 79 74 65 73 20 6f 66 20 73 74 6f 72 61 67 65 20  ytes of storage 
3310: 6f 6e 20 65 76 65 72 79 20 50 67 48 64 72 0a 2a  on every PgHdr.*
3320: 2a 20 65 76 65 6e 20 66 6f 72 20 64 69 73 6b 2d  * even for disk-
3330: 62 61 73 65 64 20 64 61 74 61 62 61 73 65 73 2e  based databases.
3340: 20 20 53 70 6c 69 74 74 69 6e 67 20 69 74 20 6f    Splitting it o
3350: 75 74 20 73 61 76 65 73 20 38 20 62 79 74 65 73  ut saves 8 bytes
3360: 2e 20 20 54 68 69 73 0a 2a 2a 20 69 73 20 6f 6e  .  This.** is on
3370: 6c 79 20 61 20 73 61 76 69 6e 67 73 20 6f 66 20  ly a savings of 
3380: 30 2e 38 25 20 62 75 74 20 74 68 6f 73 65 20 70  0.8% but those p
3390: 65 72 63 65 6e 74 61 67 65 73 20 61 64 64 20 75  ercentages add u
33a0: 70 2e 0a 2a 2f 0a 74 79 70 65 64 65 66 20 73 74  p..*/.typedef st
33b0: 72 75 63 74 20 50 67 48 69 73 74 6f 72 79 20 50  ruct PgHistory P
33c0: 67 48 69 73 74 6f 72 79 3b 0a 73 74 72 75 63 74  gHistory;.struct
33d0: 20 50 67 48 69 73 74 6f 72 79 20 7b 0a 20 20 75   PgHistory {.  u
33e0: 38 20 2a 70 4f 72 69 67 3b 20 20 20 20 20 2f 2a  8 *pOrig;     /*
33f0: 20 4f 72 69 67 69 6e 61 6c 20 70 61 67 65 20 74   Original page t
3400: 65 78 74 2e 20 20 52 65 73 74 6f 72 65 20 74 6f  ext.  Restore to
3410: 20 74 68 69 73 20 6f 6e 20 61 20 66 75 6c 6c 20   this on a full 
3420: 72 6f 6c 6c 62 61 63 6b 20 2a 2f 0a 20 20 75 38  rollback */.  u8
3430: 20 2a 70 53 74 6d 74 3b 20 20 20 20 20 2f 2a 20   *pStmt;     /* 
3440: 54 65 78 74 20 61 73 20 69 74 20 77 61 73 20 61  Text as it was a
3450: 74 20 74 68 65 20 62 65 67 69 6e 6e 69 6e 67 20  t the beginning 
3460: 6f 66 20 74 68 65 20 63 75 72 72 65 6e 74 20 73  of the current s
3470: 74 61 74 65 6d 65 6e 74 20 2a 2f 0a 20 20 50 67  tatement */.  Pg
3480: 48 64 72 20 2a 70 4e 65 78 74 53 74 6d 74 2c 20  Hdr *pNextStmt, 
3490: 2a 70 50 72 65 76 53 74 6d 74 3b 20 20 2f 2a 20  *pPrevStmt;  /* 
34a0: 4c 69 73 74 20 6f 66 20 70 61 67 65 73 20 69 6e  List of pages in
34b0: 20 74 68 65 20 73 74 61 74 65 6d 65 6e 74 20 6a   the statement j
34c0: 6f 75 72 6e 61 6c 20 2a 2f 0a 20 20 75 38 20 69  ournal */.  u8 i
34d0: 6e 53 74 6d 74 3b 20 20 20 20 20 20 20 20 20 20  nStmt;          
34e0: 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 54 52             /* TR
34f0: 55 45 20 69 66 20 69 6e 20 74 68 65 20 73 74 61  UE if in the sta
3500: 74 65 6d 65 6e 74 20 73 75 62 6a 6f 75 72 6e 61  tement subjourna
3510: 6c 20 2a 2f 0a 7d 3b 0a 0a 2f 2a 0a 2a 2a 20 41  l */.};../*.** A
3520: 20 6d 61 63 72 6f 20 75 73 65 64 20 66 6f 72 20   macro used for 
3530: 69 6e 76 6f 6b 69 6e 67 20 74 68 65 20 63 6f 64  invoking the cod
3540: 65 63 20 69 66 20 74 68 65 72 65 20 69 73 20 6f  ec if there is o
3550: 6e 65 0a 2a 2f 0a 23 69 66 64 65 66 20 53 51 4c  ne.*/.#ifdef SQL
3560: 49 54 45 5f 48 41 53 5f 43 4f 44 45 43 0a 23 20  ITE_HAS_CODEC.# 
3570: 64 65 66 69 6e 65 20 43 4f 44 45 43 31 28 50 2c  define CODEC1(P,
3580: 44 2c 4e 2c 58 29 20 69 66 28 20 50 2d 3e 78 43  D,N,X) if( P->xC
3590: 6f 64 65 63 21 3d 30 20 29 7b 20 50 2d 3e 78 43  odec!=0 ){ P->xC
35a0: 6f 64 65 63 28 50 2d 3e 70 43 6f 64 65 63 41 72  odec(P->pCodecAr
35b0: 67 2c 44 2c 4e 2c 58 29 3b 20 7d 0a 23 20 64 65  g,D,N,X); }.# de
35c0: 66 69 6e 65 20 43 4f 44 45 43 32 28 50 2c 44 2c  fine CODEC2(P,D,
35d0: 4e 2c 58 29 20 28 28 63 68 61 72 2a 29 28 50 2d  N,X) ((char*)(P-
35e0: 3e 78 43 6f 64 65 63 21 3d 30 3f 50 2d 3e 78 43  >xCodec!=0?P->xC
35f0: 6f 64 65 63 28 50 2d 3e 70 43 6f 64 65 63 41 72  odec(P->pCodecAr
3600: 67 2c 44 2c 4e 2c 58 29 3a 44 29 29 0a 23 65 6c  g,D,N,X):D)).#el
3610: 73 65 0a 23 20 64 65 66 69 6e 65 20 43 4f 44 45  se.# define CODE
3620: 43 31 28 50 2c 44 2c 4e 2c 58 29 20 2f 2a 20 4e  C1(P,D,N,X) /* N
3630: 4f 2d 4f 50 20 2a 2f 0a 23 20 64 65 66 69 6e 65  O-OP */.# define
3640: 20 43 4f 44 45 43 32 28 50 2c 44 2c 4e 2c 58 29   CODEC2(P,D,N,X)
3650: 20 28 28 63 68 61 72 2a 29 44 29 0a 23 65 6e 64   ((char*)D).#end
3660: 69 66 0a 0a 2f 2a 0a 2a 2a 20 43 6f 6e 76 65 72  if../*.** Conver
3670: 74 20 61 20 70 6f 69 6e 74 65 72 20 74 6f 20 61  t a pointer to a
3680: 20 50 67 48 64 72 20 69 6e 74 6f 20 61 20 70 6f   PgHdr into a po
3690: 69 6e 74 65 72 20 74 6f 20 69 74 73 20 64 61 74  inter to its dat
36a0: 61 0a 2a 2a 20 61 6e 64 20 62 61 63 6b 20 61 67  a.** and back ag
36b0: 61 69 6e 2e 0a 2a 2f 0a 23 64 65 66 69 6e 65 20  ain..*/.#define 
36c0: 50 47 48 44 52 5f 54 4f 5f 44 41 54 41 28 50 29  PGHDR_TO_DATA(P)
36d0: 20 20 20 20 28 28 50 29 2d 3e 70 44 61 74 61 29      ((P)->pData)
36e0: 0a 23 64 65 66 69 6e 65 20 50 47 48 44 52 5f 54  .#define PGHDR_T
36f0: 4f 5f 45 58 54 52 41 28 47 2c 50 29 20 28 28 76  O_EXTRA(G,P) ((v
3700: 6f 69 64 2a 29 26 28 28 47 29 5b 31 5d 29 29 0a  oid*)&((G)[1])).
3710: 23 64 65 66 69 6e 65 20 50 47 48 44 52 5f 54 4f  #define PGHDR_TO
3720: 5f 48 49 53 54 28 50 2c 50 47 52 29 20 20 5c 0a  _HIST(P,PGR)  \.
3730: 20 20 20 20 20 20 20 20 20 20 20 20 28 28 50 67              ((Pg
3740: 48 69 73 74 6f 72 79 2a 29 26 28 28 63 68 61 72  History*)&((char
3750: 2a 29 28 26 28 50 29 5b 31 5d 29 29 5b 28 50 47  *)(&(P)[1]))[(PG
3760: 52 29 2d 3e 6e 45 78 74 72 61 5d 29 0a 0a 2f 2a  R)->nExtra])../*
3770: 0a 2a 2a 20 41 20 6f 70 65 6e 20 70 61 67 65 20  .** A open page 
3780: 63 61 63 68 65 20 69 73 20 61 6e 20 69 6e 73 74  cache is an inst
3790: 61 6e 63 65 20 6f 66 20 74 68 65 20 66 6f 6c 6c  ance of the foll
37a0: 6f 77 69 6e 67 20 73 74 72 75 63 74 75 72 65 2e  owing structure.
37b0: 0a 2a 2a 0a 2a 2a 20 50 61 67 65 72 2e 65 72 72  .**.** Pager.err
37c0: 43 6f 64 65 20 6d 61 79 20 62 65 20 73 65 74 20  Code may be set 
37d0: 74 6f 20 53 51 4c 49 54 45 5f 49 4f 45 52 52 2c  to SQLITE_IOERR,
37e0: 20 53 51 4c 49 54 45 5f 43 4f 52 52 55 50 54 2c   SQLITE_CORRUPT,
37f0: 20 6f 72 0a 2a 2a 20 6f 72 20 53 51 4c 49 54 45   or.** or SQLITE
3800: 5f 46 55 4c 4c 2e 20 4f 6e 63 65 20 6f 6e 65 20  _FULL. Once one 
3810: 6f 66 20 74 68 65 20 66 69 72 73 74 20 74 68 72  of the first thr
3820: 65 65 20 65 72 72 6f 72 73 20 6f 63 63 75 72 73  ee errors occurs
3830: 2c 20 69 74 20 70 65 72 73 69 73 74 73 0a 2a 2a  , it persists.**
3840: 20 61 6e 64 20 69 73 20 72 65 74 75 72 6e 65 64   and is returned
3850: 20 61 73 20 74 68 65 20 72 65 73 75 6c 74 20 6f   as the result o
3860: 66 20 65 76 65 72 79 20 6d 61 6a 6f 72 20 70 61  f every major pa
3870: 67 65 72 20 41 50 49 20 63 61 6c 6c 2e 20 20 54  ger API call.  T
3880: 68 65 0a 2a 2a 20 53 51 4c 49 54 45 5f 46 55 4c  he.** SQLITE_FUL
3890: 4c 20 72 65 74 75 72 6e 20 63 6f 64 65 20 69 73  L return code is
38a0: 20 73 6c 69 67 68 74 6c 79 20 64 69 66 66 65 72   slightly differ
38b0: 65 6e 74 2e 20 49 74 20 70 65 72 73 69 73 74 73  ent. It persists
38c0: 20 6f 6e 6c 79 20 75 6e 74 69 6c 20 74 68 65 0a   only until the.
38d0: 2a 2a 20 6e 65 78 74 20 73 75 63 63 65 73 73 66  ** next successf
38e0: 75 6c 20 72 6f 6c 6c 62 61 63 6b 20 69 73 20 70  ul rollback is p
38f0: 65 72 66 6f 72 6d 65 64 20 6f 6e 20 74 68 65 20  erformed on the 
3900: 70 61 67 65 72 20 63 61 63 68 65 2e 20 41 6c 73  pager cache. Als
3910: 6f 2c 0a 2a 2a 20 53 51 4c 49 54 45 5f 46 55 4c  o,.** SQLITE_FUL
3920: 4c 20 64 6f 65 73 20 6e 6f 74 20 61 66 66 65 63  L does not affec
3930: 74 20 74 68 65 20 73 71 6c 69 74 65 33 50 61 67  t the sqlite3Pag
3940: 65 72 47 65 74 28 29 20 61 6e 64 20 73 71 6c 69  erGet() and sqli
3950: 74 65 33 50 61 67 65 72 4c 6f 6f 6b 75 70 28 29  te3PagerLookup()
3960: 0a 2a 2a 20 41 50 49 73 2c 20 74 68 65 79 20 6d  .** APIs, they m
3970: 61 79 20 73 74 69 6c 6c 20 62 65 20 75 73 65 64  ay still be used
3980: 20 73 75 63 63 65 73 73 66 75 6c 6c 79 2e 0a 2a   successfully..*
3990: 2f 0a 73 74 72 75 63 74 20 50 61 67 65 72 20 7b  /.struct Pager {
39a0: 0a 20 20 73 71 6c 69 74 65 33 5f 76 66 73 20 2a  .  sqlite3_vfs *
39b0: 70 56 66 73 3b 20 20 20 20 20 20 20 20 20 20 2f  pVfs;          /
39c0: 2a 20 4f 53 20 66 75 6e 63 74 69 6f 6e 73 20 74  * OS functions t
39d0: 6f 20 75 73 65 20 66 6f 72 20 49 4f 20 2a 2f 0a  o use for IO */.
39e0: 20 20 75 38 20 6a 6f 75 72 6e 61 6c 4f 70 65 6e    u8 journalOpen
39f0: 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a  ;             /*
3a00: 20 54 72 75 65 20 69 66 20 6a 6f 75 72 6e 61 6c   True if journal
3a10: 20 66 69 6c 65 20 64 65 73 63 72 69 70 74 6f 72   file descriptor
3a20: 73 20 69 73 20 76 61 6c 69 64 20 2a 2f 0a 20 20  s is valid */.  
3a30: 75 38 20 6a 6f 75 72 6e 61 6c 53 74 61 72 74 65  u8 journalStarte
3a40: 64 3b 20 20 20 20 20 20 20 20 20 20 2f 2a 20 54  d;          /* T
3a50: 72 75 65 20 69 66 20 68 65 61 64 65 72 20 6f 66  rue if header of
3a60: 20 6a 6f 75 72 6e 61 6c 20 69 73 20 73 79 6e 63   journal is sync
3a70: 65 64 20 2a 2f 0a 20 20 75 38 20 75 73 65 4a 6f  ed */.  u8 useJo
3a80: 75 72 6e 61 6c 3b 20 20 20 20 20 20 20 20 20 20  urnal;          
3a90: 20 20 20 20 2f 2a 20 55 73 65 20 61 20 72 6f 6c      /* Use a rol
3aa0: 6c 62 61 63 6b 20 6a 6f 75 72 6e 61 6c 20 6f 6e  lback journal on
3ab0: 20 74 68 69 73 20 66 69 6c 65 20 2a 2f 0a 20 20   this file */.  
3ac0: 75 38 20 6e 6f 52 65 61 64 6c 6f 63 6b 3b 20 20  u8 noReadlock;  
3ad0: 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 44              /* D
3ae0: 6f 20 6e 6f 74 20 62 6f 74 68 65 72 20 74 6f 20  o not bother to 
3af0: 6f 62 74 61 69 6e 20 72 65 61 64 6c 6f 63 6b 73  obtain readlocks
3b00: 20 2a 2f 0a 20 20 75 38 20 73 74 6d 74 4f 70 65   */.  u8 stmtOpe
3b10: 6e 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20  n;              
3b20: 20 20 2f 2a 20 54 72 75 65 20 69 66 20 74 68 65    /* True if the
3b30: 20 73 74 61 74 65 6d 65 6e 74 20 73 75 62 6a 6f   statement subjo
3b40: 75 72 6e 61 6c 20 69 73 20 6f 70 65 6e 20 2a 2f  urnal is open */
3b50: 0a 20 20 75 38 20 73 74 6d 74 49 6e 55 73 65 3b  .  u8 stmtInUse;
3b60: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f                 /
3b70: 2a 20 54 72 75 65 20 77 65 20 61 72 65 20 69 6e  * True we are in
3b80: 20 61 20 73 74 61 74 65 6d 65 6e 74 20 73 75 62   a statement sub
3b90: 74 72 61 6e 73 61 63 74 69 6f 6e 20 2a 2f 0a 20  transaction */. 
3ba0: 20 75 38 20 73 74 6d 74 41 75 74 6f 6f 70 65 6e   u8 stmtAutoopen
3bb0: 3b 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20  ;            /* 
3bc0: 4f 70 65 6e 20 73 74 6d 74 20 6a 6f 75 72 6e 61  Open stmt journa
3bd0: 6c 20 77 68 65 6e 20 6d 61 69 6e 20 6a 6f 75 72  l when main jour
3be0: 6e 61 6c 20 69 73 20 6f 70 65 6e 65 64 2a 2f 0a  nal is opened*/.
3bf0: 20 20 75 38 20 6e 6f 53 79 6e 63 3b 20 20 20 20    u8 noSync;    
3c00: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a                /*
3c10: 20 44 6f 20 6e 6f 74 20 73 79 6e 63 20 74 68 65   Do not sync the
3c20: 20 6a 6f 75 72 6e 61 6c 20 69 66 20 74 72 75 65   journal if true
3c30: 20 2a 2f 0a 20 20 75 38 20 66 75 6c 6c 53 79 6e   */.  u8 fullSyn
3c40: 63 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20  c;              
3c50: 20 20 2f 2a 20 44 6f 20 65 78 74 72 61 20 73 79    /* Do extra sy
3c60: 6e 63 73 20 6f 66 20 74 68 65 20 6a 6f 75 72 6e  ncs of the journ
3c70: 61 6c 20 66 6f 72 20 72 6f 62 75 73 74 6e 65 73  al for robustnes
3c80: 73 20 2a 2f 0a 20 20 75 38 20 73 79 6e 63 5f 66  s */.  u8 sync_f
3c90: 6c 61 67 73 3b 20 20 20 20 20 20 20 20 20 20 20  lags;           
3ca0: 20 20 20 2f 2a 20 4f 6e 65 20 6f 66 20 53 59 4e     /* One of SYN
3cb0: 43 5f 4e 4f 52 4d 41 4c 20 6f 72 20 53 59 4e 43  C_NORMAL or SYNC
3cc0: 5f 46 55 4c 4c 20 2a 2f 0a 20 20 75 38 20 73 74  _FULL */.  u8 st
3cd0: 61 74 65 3b 20 20 20 20 20 20 20 20 20 20 20 20  ate;            
3ce0: 20 20 20 20 20 20 20 2f 2a 20 50 41 47 45 52 5f         /* PAGER_
3cf0: 55 4e 4c 4f 43 4b 2c 20 5f 53 48 41 52 45 44 2c  UNLOCK, _SHARED,
3d00: 20 5f 52 45 53 45 52 56 45 44 2c 20 65 74 63 2e   _RESERVED, etc.
3d10: 20 2a 2f 0a 20 20 75 38 20 74 65 6d 70 46 69 6c   */.  u8 tempFil
3d20: 65 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20  e;              
3d30: 20 20 2f 2a 20 7a 46 69 6c 65 6e 61 6d 65 20 69    /* zFilename i
3d40: 73 20 61 20 74 65 6d 70 6f 72 61 72 79 20 66 69  s a temporary fi
3d50: 6c 65 20 2a 2f 0a 20 20 75 38 20 72 65 61 64 4f  le */.  u8 readO
3d60: 6e 6c 79 3b 20 20 20 20 20 20 20 20 20 20 20 20  nly;            
3d70: 20 20 20 20 2f 2a 20 54 72 75 65 20 66 6f 72 20      /* True for 
3d80: 61 20 72 65 61 64 2d 6f 6e 6c 79 20 64 61 74 61  a read-only data
3d90: 62 61 73 65 20 2a 2f 0a 20 20 75 38 20 6e 65 65  base */.  u8 nee
3da0: 64 53 79 6e 63 3b 20 20 20 20 20 20 20 20 20 20  dSync;          
3db0: 20 20 20 20 20 20 2f 2a 20 54 72 75 65 20 69 66        /* True if
3dc0: 20 61 6e 20 66 73 79 6e 63 28 29 20 69 73 20 6e   an fsync() is n
3dd0: 65 65 64 65 64 20 6f 6e 20 74 68 65 20 6a 6f 75  eeded on the jou
3de0: 72 6e 61 6c 20 2a 2f 0a 20 20 75 38 20 64 69 72  rnal */.  u8 dir
3df0: 74 79 43 61 63 68 65 3b 20 20 20 20 20 20 20 20  tyCache;        
3e00: 20 20 20 20 20 20 2f 2a 20 54 72 75 65 20 69 66        /* True if
3e10: 20 63 61 63 68 65 64 20 70 61 67 65 73 20 68 61   cached pages ha
3e20: 76 65 20 63 68 61 6e 67 65 64 20 2a 2f 0a 20 20  ve changed */.  
3e30: 75 38 20 61 6c 77 61 79 73 52 6f 6c 6c 62 61 63  u8 alwaysRollbac
3e40: 6b 3b 20 20 20 20 20 20 20 20 20 20 2f 2a 20 44  k;          /* D
3e50: 69 73 61 62 6c 65 20 44 6f 6e 74 52 6f 6c 6c 62  isable DontRollb
3e60: 61 63 6b 28 29 20 66 6f 72 20 61 6c 6c 20 70 61  ack() for all pa
3e70: 67 65 73 20 2a 2f 0a 20 20 75 38 20 6d 65 6d 44  ges */.  u8 memD
3e80: 62 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20  b;              
3e90: 20 20 20 20 20 2f 2a 20 54 72 75 65 20 74 6f 20       /* True to 
3ea0: 69 6e 68 69 62 69 74 20 61 6c 6c 20 66 69 6c 65  inhibit all file
3eb0: 20 49 2f 4f 20 2a 2f 0a 20 20 75 38 20 73 65 74   I/O */.  u8 set
3ec0: 4d 61 73 74 65 72 3b 20 20 20 20 20 20 20 20 20  Master;         
3ed0: 20 20 20 20 20 20 2f 2a 20 54 72 75 65 20 69 66        /* True if
3ee0: 20 61 20 6d 2d 6a 20 6e 61 6d 65 20 68 61 73 20   a m-j name has 
3ef0: 62 65 65 6e 20 77 72 69 74 74 65 6e 20 74 6f 20  been written to 
3f00: 6a 72 6e 6c 20 2a 2f 0a 20 20 75 38 20 64 6f 4e  jrnl */.  u8 doN
3f10: 6f 74 53 79 6e 63 3b 20 20 20 20 20 20 20 20 20  otSync;         
3f20: 20 20 20 20 20 20 2f 2a 20 42 6f 6f 6c 65 61 6e        /* Boolean
3f30: 2e 20 57 68 69 6c 65 20 74 72 75 65 2c 20 64 6f  . While true, do
3f40: 20 6e 6f 74 20 73 70 69 6c 6c 20 74 68 65 20 63   not spill the c
3f50: 61 63 68 65 20 2a 2f 0a 20 20 75 38 20 65 78 63  ache */.  u8 exc
3f60: 6c 75 73 69 76 65 4d 6f 64 65 3b 20 20 20 20 20  lusiveMode;     
3f70: 20 20 20 20 20 20 2f 2a 20 42 6f 6f 6c 65 61 6e        /* Boolean
3f80: 2e 20 54 72 75 65 20 69 66 20 6c 6f 63 6b 69 6e  . True if lockin
3f90: 67 5f 6d 6f 64 65 3d 3d 45 58 43 4c 55 53 49 56  g_mode==EXCLUSIV
3fa0: 45 20 2a 2f 0a 20 20 75 38 20 6a 6f 75 72 6e 61  E */.  u8 journa
3fb0: 6c 4d 6f 64 65 3b 20 20 20 20 20 20 20 20 20 20  lMode;          
3fc0: 20 20 20 2f 2a 20 4f 6e 20 6f 66 20 74 68 65 20     /* On of the 
3fd0: 50 41 47 45 52 5f 4a 4f 55 52 4e 41 4c 4d 4f 44  PAGER_JOURNALMOD
3fe0: 45 5f 2a 20 76 61 6c 75 65 73 20 2a 2f 0a 20 20  E_* values */.  
3ff0: 75 38 20 63 68 61 6e 67 65 43 6f 75 6e 74 44 6f  u8 changeCountDo
4000: 6e 65 3b 20 20 20 20 20 20 20 20 20 2f 2a 20 53  ne;         /* S
4010: 65 74 20 61 66 74 65 72 20 69 6e 63 72 65 6d 65  et after increme
4020: 6e 74 69 6e 67 20 74 68 65 20 63 68 61 6e 67 65  nting the change
4030: 2d 63 6f 75 6e 74 65 72 20 2a 2f 0a 20 20 75 33  -counter */.  u3
4040: 32 20 76 66 73 46 6c 61 67 73 3b 20 20 20 20 20  2 vfsFlags;     
4050: 20 20 20 20 20 20 20 20 20 20 2f 2a 20 46 6c 61            /* Fla
4060: 67 73 20 66 6f 72 20 73 71 6c 69 74 65 33 5f 76  gs for sqlite3_v
4070: 66 73 2e 78 4f 70 65 6e 28 29 20 2a 2f 0a 20 20  fs.xOpen() */.  
4080: 69 6e 74 20 65 72 72 43 6f 64 65 3b 20 20 20 20  int errCode;    
4090: 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4f              /* O
40a0: 6e 65 20 6f 66 20 73 65 76 65 72 61 6c 20 6b 69  ne of several ki
40b0: 6e 64 73 20 6f 66 20 65 72 72 6f 72 73 20 2a 2f  nds of errors */
40c0: 0a 20 20 69 6e 74 20 64 62 53 69 7a 65 3b 20 20  .  int dbSize;  
40d0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f                 /
40e0: 2a 20 4e 75 6d 62 65 72 20 6f 66 20 70 61 67 65  * Number of page
40f0: 73 20 69 6e 20 74 68 65 20 66 69 6c 65 20 2a 2f  s in the file */
4100: 0a 20 20 69 6e 74 20 6f 72 69 67 44 62 53 69 7a  .  int origDbSiz
4110: 65 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 2f  e;             /
4120: 2a 20 64 62 53 69 7a 65 20 62 65 66 6f 72 65 20  * dbSize before 
4130: 74 68 65 20 63 75 72 72 65 6e 74 20 63 68 61 6e  the current chan
4140: 67 65 20 2a 2f 0a 20 20 69 6e 74 20 73 74 6d 74  ge */.  int stmt
4150: 53 69 7a 65 3b 20 20 20 20 20 20 20 20 20 20 20  Size;           
4160: 20 20 20 20 2f 2a 20 53 69 7a 65 20 6f 66 20 64      /* Size of d
4170: 61 74 61 62 61 73 65 20 28 69 6e 20 70 61 67 65  atabase (in page
4180: 73 29 20 61 74 20 73 74 6d 74 5f 62 65 67 69 6e  s) at stmt_begin
4190: 28 29 20 2a 2f 0a 20 20 69 6e 74 20 6e 52 65 63  () */.  int nRec
41a0: 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20  ;               
41b0: 20 20 20 20 2f 2a 20 4e 75 6d 62 65 72 20 6f 66      /* Number of
41c0: 20 70 61 67 65 73 20 77 72 69 74 74 65 6e 20 74   pages written t
41d0: 6f 20 74 68 65 20 6a 6f 75 72 6e 61 6c 20 2a 2f  o the journal */
41e0: 0a 20 20 75 33 32 20 63 6b 73 75 6d 49 6e 69 74  .  u32 cksumInit
41f0: 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f  ;              /
4200: 2a 20 51 75 61 73 69 2d 72 61 6e 64 6f 6d 20 76  * Quasi-random v
4210: 61 6c 75 65 20 61 64 64 65 64 20 74 6f 20 65 76  alue added to ev
4220: 65 72 79 20 63 68 65 63 6b 73 75 6d 20 2a 2f 0a  ery checksum */.
4230: 20 20 69 6e 74 20 73 74 6d 74 4e 52 65 63 3b 20    int stmtNRec; 
4240: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a                /*
4250: 20 4e 75 6d 62 65 72 20 6f 66 20 72 65 63 6f 72   Number of recor
4260: 64 73 20 69 6e 20 73 74 6d 74 20 73 75 62 6a 6f  ds in stmt subjo
4270: 75 72 6e 61 6c 20 2a 2f 0a 20 20 69 6e 74 20 6e  urnal */.  int n
4280: 45 78 74 72 61 3b 20 20 20 20 20 20 20 20 20 20  Extra;          
4290: 20 20 20 20 20 20 20 2f 2a 20 41 64 64 20 74 68         /* Add th
42a0: 69 73 20 6d 61 6e 79 20 62 79 74 65 73 20 74 6f  is many bytes to
42b0: 20 65 61 63 68 20 69 6e 2d 6d 65 6d 6f 72 79 20   each in-memory 
42c0: 70 61 67 65 20 2a 2f 0a 20 20 69 6e 74 20 70 61  page */.  int pa
42d0: 67 65 53 69 7a 65 3b 20 20 20 20 20 20 20 20 20  geSize;         
42e0: 20 20 20 20 20 20 2f 2a 20 4e 75 6d 62 65 72 20        /* Number 
42f0: 6f 66 20 62 79 74 65 73 20 69 6e 20 61 20 70 61  of bytes in a pa
4300: 67 65 20 2a 2f 0a 20 20 69 6e 74 20 6e 50 61 67  ge */.  int nPag
4310: 65 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20  e;              
4320: 20 20 20 20 2f 2a 20 54 6f 74 61 6c 20 6e 75 6d      /* Total num
4330: 62 65 72 20 6f 66 20 69 6e 2d 6d 65 6d 6f 72 79  ber of in-memory
4340: 20 70 61 67 65 73 20 2a 2f 0a 20 20 69 6e 74 20   pages */.  int 
4350: 6e 52 65 66 3b 20 20 20 20 20 20 20 20 20 20 20  nRef;           
4360: 20 20 20 20 20 20 20 20 2f 2a 20 4e 75 6d 62 65          /* Numbe
4370: 72 20 6f 66 20 69 6e 2d 6d 65 6d 6f 72 79 20 70  r of in-memory p
4380: 61 67 65 73 20 77 69 74 68 20 50 67 48 64 72 2e  ages with PgHdr.
4390: 6e 52 65 66 3e 30 20 2a 2f 0a 20 20 69 6e 74 20  nRef>0 */.  int 
43a0: 6d 78 50 61 67 65 3b 20 20 20 20 20 20 20 20 20  mxPage;         
43b0: 20 20 20 20 20 20 20 20 2f 2a 20 4d 61 78 69 6d          /* Maxim
43c0: 75 6d 20 6e 75 6d 62 65 72 20 6f 66 20 70 61 67  um number of pag
43d0: 65 73 20 74 6f 20 68 6f 6c 64 20 69 6e 20 63 61  es to hold in ca
43e0: 63 68 65 20 2a 2f 0a 20 20 50 67 6e 6f 20 6d 78  che */.  Pgno mx
43f0: 50 67 6e 6f 3b 20 20 20 20 20 20 20 20 20 20 20  Pgno;           
4400: 20 20 20 20 20 2f 2a 20 4d 61 78 69 6d 75 6d 20       /* Maximum 
4410: 61 6c 6c 6f 77 65 64 20 73 69 7a 65 20 6f 66 20  allowed size of 
4420: 74 68 65 20 64 61 74 61 62 61 73 65 20 2a 2f 0a  the database */.
4430: 20 20 42 69 74 76 65 63 20 2a 70 49 6e 4a 6f 75    Bitvec *pInJou
4440: 72 6e 61 6c 3b 20 20 20 20 20 20 20 20 20 2f 2a  rnal;         /*
4450: 20 4f 6e 65 20 62 69 74 20 66 6f 72 20 65 61 63   One bit for eac
4460: 68 20 70 61 67 65 20 69 6e 20 74 68 65 20 64 61  h page in the da
4470: 74 61 62 61 73 65 20 66 69 6c 65 20 2a 2f 0a 20  tabase file */. 
4480: 20 42 69 74 76 65 63 20 2a 70 49 6e 53 74 6d 74   Bitvec *pInStmt
4490: 3b 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20  ;            /* 
44a0: 4f 6e 65 20 62 69 74 20 66 6f 72 20 65 61 63 68  One bit for each
44b0: 20 70 61 67 65 20 69 6e 20 74 68 65 20 64 61 74   page in the dat
44c0: 61 62 61 73 65 20 2a 2f 0a 20 20 63 68 61 72 20  abase */.  char 
44d0: 2a 7a 46 69 6c 65 6e 61 6d 65 3b 20 20 20 20 20  *zFilename;     
44e0: 20 20 20 20 20 20 20 2f 2a 20 4e 61 6d 65 20 6f         /* Name o
44f0: 66 20 74 68 65 20 64 61 74 61 62 61 73 65 20 66  f the database f
4500: 69 6c 65 20 2a 2f 0a 20 20 63 68 61 72 20 2a 7a  ile */.  char *z
4510: 4a 6f 75 72 6e 61 6c 3b 20 20 20 20 20 20 20 20  Journal;        
4520: 20 20 20 20 20 2f 2a 20 4e 61 6d 65 20 6f 66 20       /* Name of 
4530: 74 68 65 20 6a 6f 75 72 6e 61 6c 20 66 69 6c 65  the journal file
4540: 20 2a 2f 0a 20 20 63 68 61 72 20 2a 7a 44 69 72   */.  char *zDir
4550: 65 63 74 6f 72 79 3b 20 20 20 20 20 20 20 20 20  ectory;         
4560: 20 20 2f 2a 20 44 69 72 65 63 74 6f 72 79 20 68    /* Directory h
4570: 6f 6c 64 20 64 61 74 61 62 61 73 65 20 61 6e 64  old database and
4580: 20 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 73 20 2a   journal files *
4590: 2f 0a 20 20 63 68 61 72 20 2a 7a 53 74 6d 74 4a  /.  char *zStmtJ
45a0: 72 6e 6c 3b 20 20 20 20 20 20 20 20 20 20 20 20  rnl;            
45b0: 2f 2a 20 4e 61 6d 65 20 6f 66 20 74 68 65 20 73  /* Name of the s
45c0: 74 61 74 65 6d 65 6e 74 20 6a 6f 75 72 6e 61 6c  tatement journal
45d0: 20 66 69 6c 65 20 2a 2f 0a 20 20 73 71 6c 69 74   file */.  sqlit
45e0: 65 33 5f 66 69 6c 65 20 2a 66 64 2c 20 2a 6a 66  e3_file *fd, *jf
45f0: 64 3b 20 20 20 20 20 2f 2a 20 46 69 6c 65 20 64  d;     /* File d
4600: 65 73 63 72 69 70 74 6f 72 73 20 66 6f 72 20 64  escriptors for d
4610: 61 74 61 62 61 73 65 20 61 6e 64 20 6a 6f 75 72  atabase and jour
4620: 6e 61 6c 20 2a 2f 0a 20 20 73 71 6c 69 74 65 33  nal */.  sqlite3
4630: 5f 66 69 6c 65 20 2a 73 74 66 64 3b 20 20 20 20  _file *stfd;    
4640: 20 20 20 20 20 2f 2a 20 46 69 6c 65 20 64 65 73       /* File des
4650: 63 72 69 70 74 6f 72 20 66 6f 72 20 74 68 65 20  criptor for the 
4660: 73 74 61 74 65 6d 65 6e 74 20 73 75 62 6a 6f 75  statement subjou
4670: 72 6e 61 6c 2a 2f 0a 20 20 42 75 73 79 48 61 6e  rnal*/.  BusyHan
4680: 64 6c 65 72 20 2a 70 42 75 73 79 48 61 6e 64 6c  dler *pBusyHandl
4690: 65 72 3b 20 20 2f 2a 20 50 6f 69 6e 74 65 72 20  er;  /* Pointer 
46a0: 74 6f 20 73 71 6c 69 74 65 2e 62 75 73 79 48 61  to sqlite.busyHa
46b0: 6e 64 6c 65 72 20 2a 2f 0a 20 20 50 61 67 65 72  ndler */.  Pager
46c0: 4c 72 75 4c 69 73 74 20 6c 72 75 3b 20 20 20 20  LruList lru;    
46d0: 20 20 20 20 20 20 20 2f 2a 20 4c 52 55 20 6c 69         /* LRU li
46e0: 73 74 20 6f 66 20 66 72 65 65 20 70 61 67 65 73  st of free pages
46f0: 20 2a 2f 0a 20 20 50 67 48 64 72 20 2a 70 41 6c   */.  PgHdr *pAl
4700: 6c 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20  l;              
4710: 20 20 2f 2a 20 4c 69 73 74 20 6f 66 20 61 6c 6c    /* List of all
4720: 20 70 61 67 65 73 20 2a 2f 0a 20 20 50 67 48 64   pages */.  PgHd
4730: 72 20 2a 70 53 74 6d 74 3b 20 20 20 20 20 20 20  r *pStmt;       
4740: 20 20 20 20 20 20 20 20 2f 2a 20 4c 69 73 74 20          /* List 
4750: 6f 66 20 70 61 67 65 73 20 69 6e 20 74 68 65 20  of pages in the 
4760: 73 74 61 74 65 6d 65 6e 74 20 73 75 62 6a 6f 75  statement subjou
4770: 72 6e 61 6c 20 2a 2f 0a 20 20 50 67 48 64 72 20  rnal */.  PgHdr 
4780: 2a 70 44 69 72 74 79 3b 20 20 20 20 20 20 20 20  *pDirty;        
4790: 20 20 20 20 20 20 2f 2a 20 4c 69 73 74 20 6f 66        /* List of
47a0: 20 61 6c 6c 20 64 69 72 74 79 20 70 61 67 65 73   all dirty pages
47b0: 20 2a 2f 0a 20 20 69 36 34 20 6a 6f 75 72 6e 61   */.  i64 journa
47c0: 6c 4f 66 66 3b 20 20 20 20 20 20 20 20 20 20 20  lOff;           
47d0: 20 20 2f 2a 20 43 75 72 72 65 6e 74 20 62 79 74    /* Current byt
47e0: 65 20 6f 66 66 73 65 74 20 69 6e 20 74 68 65 20  e offset in the 
47f0: 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 20 2a 2f 0a  journal file */.
4800: 20 20 69 36 34 20 6a 6f 75 72 6e 61 6c 48 64 72    i64 journalHdr
4810: 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a  ;             /*
4820: 20 42 79 74 65 20 6f 66 66 73 65 74 20 74 6f 20   Byte offset to 
4830: 70 72 65 76 69 6f 75 73 20 6a 6f 75 72 6e 61 6c  previous journal
4840: 20 68 65 61 64 65 72 20 2a 2f 0a 20 20 69 36 34   header */.  i64
4850: 20 73 74 6d 74 48 64 72 4f 66 66 3b 20 20 20 20   stmtHdrOff;    
4860: 20 20 20 20 20 20 20 20 20 2f 2a 20 46 69 72 73           /* Firs
4870: 74 20 6a 6f 75 72 6e 61 6c 20 68 65 61 64 65 72  t journal header
4880: 20 77 72 69 74 74 65 6e 20 74 68 69 73 20 73 74   written this st
4890: 61 74 65 6d 65 6e 74 20 2a 2f 0a 20 20 69 36 34  atement */.  i64
48a0: 20 73 74 6d 74 43 6b 73 75 6d 3b 20 20 20 20 20   stmtCksum;     
48b0: 20 20 20 20 20 20 20 20 20 2f 2a 20 63 6b 73 75           /* cksu
48c0: 6d 49 6e 69 74 20 77 68 65 6e 20 73 74 61 74 65  mInit when state
48d0: 6d 65 6e 74 20 77 61 73 20 73 74 61 72 74 65 64  ment was started
48e0: 20 2a 2f 0a 20 20 69 36 34 20 73 74 6d 74 4a 53   */.  i64 stmtJS
48f0: 69 7a 65 3b 20 20 20 20 20 20 20 20 20 20 20 20  ize;            
4900: 20 20 2f 2a 20 53 69 7a 65 20 6f 66 20 6a 6f 75    /* Size of jou
4910: 72 6e 61 6c 20 61 74 20 73 74 6d 74 5f 62 65 67  rnal at stmt_beg
4920: 69 6e 28 29 20 2a 2f 0a 20 20 69 6e 74 20 73 65  in() */.  int se
4930: 63 74 6f 72 53 69 7a 65 3b 20 20 20 20 20 20 20  ctorSize;       
4940: 20 20 20 20 20 20 2f 2a 20 41 73 73 75 6d 65 64        /* Assumed
4950: 20 73 65 63 74 6f 72 20 73 69 7a 65 20 64 75 72   sector size dur
4960: 69 6e 67 20 72 6f 6c 6c 62 61 63 6b 20 2a 2f 0a  ing rollback */.
4970: 23 69 66 64 65 66 20 53 51 4c 49 54 45 5f 54 45  #ifdef SQLITE_TE
4980: 53 54 0a 20 20 69 6e 74 20 6e 48 69 74 2c 20 6e  ST.  int nHit, n
4990: 4d 69 73 73 3b 20 20 20 20 20 20 20 20 20 20 20  Miss;           
49a0: 20 2f 2a 20 43 61 63 68 65 20 68 69 74 73 20 61   /* Cache hits a
49b0: 6e 64 20 6d 69 73 73 69 6e 67 20 2a 2f 0a 20 20  nd missing */.  
49c0: 69 6e 74 20 6e 52 65 61 64 2c 20 6e 57 72 69 74  int nRead, nWrit
49d0: 65 3b 20 20 20 20 20 20 20 20 20 20 2f 2a 20 44  e;          /* D
49e0: 61 74 61 62 61 73 65 20 70 61 67 65 73 20 72 65  atabase pages re
49f0: 61 64 2f 77 72 69 74 74 65 6e 20 2a 2f 0a 23 65  ad/written */.#e
4a00: 6e 64 69 66 0a 20 20 76 6f 69 64 20 28 2a 78 44  ndif.  void (*xD
4a10: 65 73 74 72 75 63 74 6f 72 29 28 44 62 50 61 67  estructor)(DbPag
4a20: 65 2a 2c 69 6e 74 29 3b 20 2f 2a 20 43 61 6c 6c  e*,int); /* Call
4a30: 20 74 68 69 73 20 72 6f 75 74 69 6e 65 20 77 68   this routine wh
4a40: 65 6e 20 66 72 65 65 69 6e 67 20 70 61 67 65 73  en freeing pages
4a50: 20 2a 2f 0a 20 20 76 6f 69 64 20 28 2a 78 52 65   */.  void (*xRe
4a60: 69 6e 69 74 65 72 29 28 44 62 50 61 67 65 2a 2c  initer)(DbPage*,
4a70: 69 6e 74 29 3b 20 20 20 2f 2a 20 43 61 6c 6c 20  int);   /* Call 
4a80: 74 68 69 73 20 72 6f 75 74 69 6e 65 20 77 68 65  this routine whe
4a90: 6e 20 72 65 6c 6f 61 64 69 6e 67 20 70 61 67 65  n reloading page
4aa0: 73 20 2a 2f 0a 23 69 66 64 65 66 20 53 51 4c 49  s */.#ifdef SQLI
4ab0: 54 45 5f 48 41 53 5f 43 4f 44 45 43 0a 20 20 76  TE_HAS_CODEC.  v
4ac0: 6f 69 64 20 2a 28 2a 78 43 6f 64 65 63 29 28 76  oid *(*xCodec)(v
4ad0: 6f 69 64 2a 2c 76 6f 69 64 2a 2c 50 67 6e 6f 2c  oid*,void*,Pgno,
4ae0: 69 6e 74 29 3b 20 2f 2a 20 52 6f 75 74 69 6e 65  int); /* Routine
4af0: 20 66 6f 72 20 65 6e 2f 64 65 63 6f 64 69 6e 67   for en/decoding
4b00: 20 64 61 74 61 20 2a 2f 0a 20 20 76 6f 69 64 20   data */.  void 
4b10: 2a 70 43 6f 64 65 63 41 72 67 3b 20 20 20 20 20  *pCodecArg;     
4b20: 20 20 20 20 20 20 20 2f 2a 20 46 69 72 73 74 20         /* First 
4b30: 61 72 67 75 6d 65 6e 74 20 74 6f 20 78 43 6f 64  argument to xCod
4b40: 65 63 28 29 20 2a 2f 0a 23 65 6e 64 69 66 0a 20  ec() */.#endif. 
4b50: 20 69 6e 74 20 6e 48 61 73 68 3b 20 20 20 20 20   int nHash;     
4b60: 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20               /* 
4b70: 53 69 7a 65 20 6f 66 20 74 68 65 20 70 61 67 65  Size of the page
4b80: 72 20 68 61 73 68 20 74 61 62 6c 65 20 2a 2f 0a  r hash table */.
4b90: 20 20 50 67 48 64 72 20 2a 2a 61 48 61 73 68 3b    PgHdr **aHash;
4ba0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a                /*
4bb0: 20 48 61 73 68 20 74 61 62 6c 65 20 74 6f 20 6d   Hash table to m
4bc0: 61 70 20 70 61 67 65 20 6e 75 6d 62 65 72 20 74  ap page number t
4bd0: 6f 20 50 67 48 64 72 20 2a 2f 0a 23 69 66 64 65  o PgHdr */.#ifde
4be0: 66 20 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45 5f  f SQLITE_ENABLE_
4bf0: 4d 45 4d 4f 52 59 5f 4d 41 4e 41 47 45 4d 45 4e  MEMORY_MANAGEMEN
4c00: 54 0a 20 20 50 61 67 65 72 20 2a 70 4e 65 78 74  T.  Pager *pNext
4c10: 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20  ;               
4c20: 2f 2a 20 44 6f 75 62 6c 79 20 6c 69 6e 6b 65 64  /* Doubly linked
4c30: 20 6c 69 73 74 20 6f 66 20 70 61 67 65 72 73 20   list of pagers 
4c40: 6f 6e 20 77 68 69 63 68 20 2a 2f 0a 20 20 50 61  on which */.  Pa
4c50: 67 65 72 20 2a 70 50 72 65 76 3b 20 20 20 20 20  ger *pPrev;     
4c60: 20 20 20 20 20 20 20 20 20 20 2f 2a 20 73 71 6c            /* sql
4c70: 69 74 65 33 5f 72 65 6c 65 61 73 65 5f 6d 65 6d  ite3_release_mem
4c80: 6f 72 79 28 29 20 77 69 6c 6c 20 77 6f 72 6b 20  ory() will work 
4c90: 2a 2f 0a 20 20 69 6e 74 20 69 49 6e 55 73 65 4d  */.  int iInUseM
4ca0: 4d 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20  M;              
4cb0: 20 2f 2a 20 4e 6f 6e 2d 7a 65 72 6f 20 69 66 20   /* Non-zero if 
4cc0: 75 6e 61 76 61 69 6c 61 62 6c 65 20 74 6f 20 4d  unavailable to M
4cd0: 4d 20 2a 2f 0a 20 20 69 6e 74 20 69 49 6e 55 73  M */.  int iInUs
4ce0: 65 44 42 3b 20 20 20 20 20 20 20 20 20 20 20 20  eDB;            
4cf0: 20 20 20 2f 2a 20 4e 6f 6e 2d 7a 65 72 6f 20 69     /* Non-zero i
4d00: 66 20 69 6e 20 73 71 6c 69 74 65 33 5f 72 65 6c  f in sqlite3_rel
4d10: 65 61 73 65 5f 6d 65 6d 6f 72 79 28 29 20 2a 2f  ease_memory() */
4d20: 0a 23 65 6e 64 69 66 0a 20 20 63 68 61 72 20 2a  .#endif.  char *
4d30: 70 54 6d 70 53 70 61 63 65 3b 20 20 20 20 20 20  pTmpSpace;      
4d40: 20 20 20 20 20 20 2f 2a 20 50 61 67 65 72 2e 70        /* Pager.p
4d50: 61 67 65 53 69 7a 65 20 62 79 74 65 73 20 6f 66  ageSize bytes of
4d60: 20 73 70 61 63 65 20 66 6f 72 20 74 6d 70 20 75   space for tmp u
4d70: 73 65 20 2a 2f 0a 20 20 63 68 61 72 20 64 62 46  se */.  char dbF
4d80: 69 6c 65 56 65 72 73 5b 31 36 5d 3b 20 20 20 20  ileVers[16];    
4d90: 20 20 20 20 2f 2a 20 43 68 61 6e 67 65 73 20 77      /* Changes w
4da0: 68 65 6e 65 76 65 72 20 64 61 74 61 62 61 73 65  henever database
4db0: 20 66 69 6c 65 20 63 68 61 6e 67 65 73 20 2a 2f   file changes */
4dc0: 0a 7d 3b 0a 0a 2f 2a 0a 2a 2a 20 54 68 65 20 66  .};../*.** The f
4dd0: 6f 6c 6c 6f 77 69 6e 67 20 67 6c 6f 62 61 6c 20  ollowing global 
4de0: 76 61 72 69 61 62 6c 65 73 20 68 6f 6c 64 20 63  variables hold c
4df0: 6f 75 6e 74 65 72 73 20 75 73 65 64 20 66 6f 72  ounters used for
4e00: 0a 2a 2a 20 74 65 73 74 69 6e 67 20 70 75 72 70  .** testing purp
4e10: 6f 73 65 73 20 6f 6e 6c 79 2e 20 20 54 68 65 73  oses only.  Thes
4e20: 65 20 76 61 72 69 61 62 6c 65 73 20 64 6f 20 6e  e variables do n
4e30: 6f 74 20 65 78 69 73 74 20 69 6e 0a 2a 2a 20 61  ot exist in.** a
4e40: 20 6e 6f 6e 2d 74 65 73 74 69 6e 67 20 62 75 69   non-testing bui
4e50: 6c 64 2e 20 20 54 68 65 73 65 20 76 61 72 69 61  ld.  These varia
4e60: 62 6c 65 73 20 61 72 65 20 6e 6f 74 20 74 68 72  bles are not thr
4e70: 65 61 64 2d 73 61 66 65 2e 0a 2a 2f 0a 23 69 66  ead-safe..*/.#if
4e80: 64 65 66 20 53 51 4c 49 54 45 5f 54 45 53 54 0a  def SQLITE_TEST.
4e90: 69 6e 74 20 73 71 6c 69 74 65 33 5f 70 61 67 65  int sqlite3_page
4ea0: 72 5f 72 65 61 64 64 62 5f 63 6f 75 6e 74 20 3d  r_readdb_count =
4eb0: 20 30 3b 20 20 20 20 2f 2a 20 4e 75 6d 62 65 72   0;    /* Number
4ec0: 20 6f 66 20 66 75 6c 6c 20 70 61 67 65 73 20 72   of full pages r
4ed0: 65 61 64 20 66 72 6f 6d 20 44 42 20 2a 2f 0a 69  ead from DB */.i
4ee0: 6e 74 20 73 71 6c 69 74 65 33 5f 70 61 67 65 72  nt sqlite3_pager
4ef0: 5f 77 72 69 74 65 64 62 5f 63 6f 75 6e 74 20 3d  _writedb_count =
4f00: 20 30 3b 20 20 20 2f 2a 20 4e 75 6d 62 65 72 20   0;   /* Number 
4f10: 6f 66 20 66 75 6c 6c 20 70 61 67 65 73 20 77 72  of full pages wr
4f20: 69 74 74 65 6e 20 74 6f 20 44 42 20 2a 2f 0a 69  itten to DB */.i
4f30: 6e 74 20 73 71 6c 69 74 65 33 5f 70 61 67 65 72  nt sqlite3_pager
4f40: 5f 77 72 69 74 65 6a 5f 63 6f 75 6e 74 20 3d 20  _writej_count = 
4f50: 30 3b 20 20 20 20 2f 2a 20 4e 75 6d 62 65 72 20  0;    /* Number 
4f60: 6f 66 20 70 61 67 65 73 20 77 72 69 74 74 65 6e  of pages written
4f70: 20 74 6f 20 6a 6f 75 72 6e 61 6c 20 2a 2f 0a 69   to journal */.i
4f80: 6e 74 20 73 71 6c 69 74 65 33 5f 70 61 67 65 72  nt sqlite3_pager
4f90: 5f 70 67 66 72 65 65 5f 63 6f 75 6e 74 20 3d 20  _pgfree_count = 
4fa0: 30 3b 20 20 20 20 2f 2a 20 4e 75 6d 62 65 72 20  0;    /* Number 
4fb0: 6f 66 20 63 61 63 68 65 20 70 61 67 65 73 20 66  of cache pages f
4fc0: 72 65 65 64 20 2a 2f 0a 23 20 64 65 66 69 6e 65  reed */.# define
4fd0: 20 50 41 47 45 52 5f 49 4e 43 52 28 76 29 20 20   PAGER_INCR(v)  
4fe0: 76 2b 2b 0a 23 65 6c 73 65 0a 23 20 64 65 66 69  v++.#else.# defi
4ff0: 6e 65 20 50 41 47 45 52 5f 49 4e 43 52 28 76 29  ne PAGER_INCR(v)
5000: 0a 23 65 6e 64 69 66 0a 0a 2f 2a 0a 2a 2a 20 54  .#endif../*.** T
5010: 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 76 61 72  he following var
5020: 69 61 62 6c 65 20 70 6f 69 6e 74 73 20 74 6f 20  iable points to 
5030: 74 68 65 20 68 65 61 64 20 6f 66 20 61 20 64 6f  the head of a do
5040: 75 62 6c 65 2d 6c 69 6e 6b 65 64 20 6c 69 73 74  uble-linked list
5050: 0a 2a 2a 20 6f 66 20 61 6c 6c 20 70 61 67 65 72  .** of all pager
5060: 73 20 74 68 61 74 20 61 72 65 20 65 6c 69 67 69  s that are eligi
5070: 62 6c 65 20 66 6f 72 20 70 61 67 65 20 73 74 65  ble for page ste
5080: 61 6c 69 6e 67 20 62 79 20 74 68 65 0a 2a 2a 20  aling by the.** 
5090: 73 71 6c 69 74 65 33 5f 72 65 6c 65 61 73 65 5f  sqlite3_release_
50a0: 6d 65 6d 6f 72 79 28 29 20 69 6e 74 65 72 66 61  memory() interfa
50b0: 63 65 2e 20 20 41 63 63 65 73 73 20 74 6f 20 74  ce.  Access to t
50c0: 68 69 73 20 6c 69 73 74 20 69 73 0a 2a 2a 20 70  his list is.** p
50d0: 72 6f 74 65 63 74 65 64 20 62 79 20 74 68 65 20  rotected by the 
50e0: 53 51 4c 49 54 45 5f 4d 55 54 45 58 5f 53 54 41  SQLITE_MUTEX_STA
50f0: 54 49 43 5f 4d 45 4d 32 20 6d 75 74 65 78 2e 0a  TIC_MEM2 mutex..
5100: 2a 2f 0a 23 69 66 64 65 66 20 53 51 4c 49 54 45  */.#ifdef SQLITE
5110: 5f 45 4e 41 42 4c 45 5f 4d 45 4d 4f 52 59 5f 4d  _ENABLE_MEMORY_M
5120: 41 4e 41 47 45 4d 45 4e 54 0a 73 74 61 74 69 63  ANAGEMENT.static
5130: 20 50 61 67 65 72 20 2a 73 71 6c 69 74 65 33 50   Pager *sqlite3P
5140: 61 67 65 72 4c 69 73 74 20 3d 20 30 3b 0a 73 74  agerList = 0;.st
5150: 61 74 69 63 20 50 61 67 65 72 4c 72 75 4c 69 73  atic PagerLruLis
5160: 74 20 73 71 6c 69 74 65 33 4c 72 75 50 61 67 65  t sqlite3LruPage
5170: 4c 69 73 74 20 3d 20 7b 30 2c 20 30 2c 20 30 7d  List = {0, 0, 0}
5180: 3b 0a 23 65 6e 64 69 66 0a 0a 0a 2f 2a 0a 2a 2a  ;.#endif.../*.**
5190: 20 4a 6f 75 72 6e 61 6c 20 66 69 6c 65 73 20 62   Journal files b
51a0: 65 67 69 6e 20 77 69 74 68 20 74 68 65 20 66 6f  egin with the fo
51b0: 6c 6c 6f 77 69 6e 67 20 6d 61 67 69 63 20 73 74  llowing magic st
51c0: 72 69 6e 67 2e 20 20 54 68 65 20 64 61 74 61 0a  ring.  The data.
51d0: 2a 2a 20 77 61 73 20 6f 62 74 61 69 6e 65 64 20  ** was obtained 
51e0: 66 72 6f 6d 20 2f 64 65 76 2f 72 61 6e 64 6f 6d  from /dev/random
51f0: 2e 20 20 49 74 20 69 73 20 75 73 65 64 20 6f 6e  .  It is used on
5200: 6c 79 20 61 73 20 61 20 73 61 6e 69 74 79 20 63  ly as a sanity c
5210: 68 65 63 6b 2e 0a 2a 2a 0a 2a 2a 20 53 69 6e 63  heck..**.** Sinc
5220: 65 20 76 65 72 73 69 6f 6e 20 32 2e 38 2e 30 2c  e version 2.8.0,
5230: 20 74 68 65 20 6a 6f 75 72 6e 61 6c 20 66 6f 72   the journal for
5240: 6d 61 74 20 63 6f 6e 74 61 69 6e 73 20 61 64 64  mat contains add
5250: 69 74 69 6f 6e 61 6c 20 73 61 6e 69 74 79 0a 2a  itional sanity.*
5260: 2a 20 63 68 65 63 6b 69 6e 67 20 69 6e 66 6f 72  * checking infor
5270: 6d 61 74 69 6f 6e 2e 20 20 49 66 20 74 68 65 20  mation.  If the 
5280: 70 6f 77 65 72 20 66 61 69 6c 73 20 77 68 69 6c  power fails whil
5290: 65 20 74 68 65 20 6a 6f 75 72 6e 61 6c 20 69 73  e the journal is
52a0: 20 62 65 67 69 6e 0a 2a 2a 20 77 72 69 74 74 65   begin.** writte
52b0: 6e 2c 20 73 65 6d 69 2d 72 61 6e 64 6f 6d 20 67  n, semi-random g
52c0: 61 72 62 61 67 65 20 64 61 74 61 20 6d 69 67 68  arbage data migh
52d0: 74 20 61 70 70 65 61 72 20 69 6e 20 74 68 65 20  t appear in the 
52e0: 6a 6f 75 72 6e 61 6c 0a 2a 2a 20 66 69 6c 65 20  journal.** file 
52f0: 61 66 74 65 72 20 70 6f 77 65 72 20 69 73 20 72  after power is r
5300: 65 73 74 6f 72 65 64 2e 20 20 49 66 20 61 6e 20  estored.  If an 
5310: 61 74 74 65 6d 70 74 20 69 73 20 74 68 65 6e 20  attempt is then 
5320: 6d 61 64 65 0a 2a 2a 20 74 6f 20 72 6f 6c 6c 20  made.** to roll 
5330: 74 68 65 20 6a 6f 75 72 6e 61 6c 20 62 61 63 6b  the journal back
5340: 2c 20 74 68 65 20 64 61 74 61 62 61 73 65 20 63  , the database c
5350: 6f 75 6c 64 20 62 65 20 63 6f 72 72 75 70 74 65  ould be corrupte
5360: 64 2e 20 20 54 68 65 20 61 64 64 69 74 69 6f 6e  d.  The addition
5370: 61 6c 0a 2a 2a 20 73 61 6e 69 74 79 20 63 68 65  al.** sanity che
5380: 63 6b 69 6e 67 20 64 61 74 61 20 69 73 20 61 6e  cking data is an
5390: 20 61 74 74 65 6d 70 74 20 74 6f 20 64 69 73 63   attempt to disc
53a0: 6f 76 65 72 20 74 68 65 20 67 61 72 62 61 67 65  over the garbage
53b0: 20 69 6e 20 74 68 65 0a 2a 2a 20 6a 6f 75 72 6e   in the.** journ
53c0: 61 6c 20 61 6e 64 20 69 67 6e 6f 72 65 20 69 74  al and ignore it
53d0: 2e 0a 2a 2a 0a 2a 2a 20 54 68 65 20 73 61 6e 69  ..**.** The sani
53e0: 74 79 20 63 68 65 63 6b 69 6e 67 20 69 6e 66 6f  ty checking info
53f0: 72 6d 61 74 69 6f 6e 20 66 6f 72 20 74 68 65 20  rmation for the 
5400: 6e 65 77 20 6a 6f 75 72 6e 61 6c 20 66 6f 72 6d  new journal form
5410: 61 74 20 63 6f 6e 73 69 73 74 73 0a 2a 2a 20 6f  at consists.** o
5420: 66 20 61 20 33 32 2d 62 69 74 20 63 68 65 63 6b  f a 32-bit check
5430: 73 75 6d 20 6f 6e 20 65 61 63 68 20 70 61 67 65  sum on each page
5440: 20 6f 66 20 64 61 74 61 2e 20 20 54 68 65 20 63   of data.  The c
5450: 68 65 63 6b 73 75 6d 20 63 6f 76 65 72 73 20 62  hecksum covers b
5460: 6f 74 68 0a 2a 2a 20 74 68 65 20 70 61 67 65 20  oth.** the page 
5470: 6e 75 6d 62 65 72 20 61 6e 64 20 74 68 65 20 70  number and the p
5480: 50 61 67 65 72 2d 3e 70 61 67 65 53 69 7a 65 20  Pager->pageSize 
5490: 62 79 74 65 73 20 6f 66 20 64 61 74 61 20 66 6f  bytes of data fo
54a0: 72 20 74 68 65 20 70 61 67 65 2e 0a 2a 2a 20 54  r the page..** T
54b0: 68 69 73 20 63 6b 73 75 6d 20 69 73 20 69 6e 69  his cksum is ini
54c0: 74 69 61 6c 69 7a 65 64 20 74 6f 20 61 20 33 32  tialized to a 32
54d0: 2d 62 69 74 20 72 61 6e 64 6f 6d 20 76 61 6c 75  -bit random valu
54e0: 65 20 74 68 61 74 20 61 70 70 65 61 72 73 20 69  e that appears i
54f0: 6e 20 74 68 65 0a 2a 2a 20 6a 6f 75 72 6e 61 6c  n the.** journal
5500: 20 66 69 6c 65 20 72 69 67 68 74 20 61 66 74 65   file right afte
5510: 72 20 74 68 65 20 68 65 61 64 65 72 2e 20 20 54  r the header.  T
5520: 68 65 20 72 61 6e 64 6f 6d 20 69 6e 69 74 69 61  he random initia
5530: 6c 69 7a 65 72 20 69 73 20 69 6d 70 6f 72 74 61  lizer is importa
5540: 6e 74 2c 0a 2a 2a 20 62 65 63 61 75 73 65 20 67  nt,.** because g
5550: 61 72 62 61 67 65 20 64 61 74 61 20 74 68 61 74  arbage data that
5560: 20 61 70 70 65 61 72 73 20 61 74 20 74 68 65 20   appears at the 
5570: 65 6e 64 20 6f 66 20 61 20 6a 6f 75 72 6e 61 6c  end of a journal
5580: 20 69 73 20 6c 69 6b 65 6c 79 0a 2a 2a 20 64 61   is likely.** da
5590: 74 61 20 74 68 61 74 20 77 61 73 20 6f 6e 63 65  ta that was once
55a0: 20 69 6e 20 6f 74 68 65 72 20 66 69 6c 65 73 20   in other files 
55b0: 74 68 61 74 20 68 61 76 65 20 6e 6f 77 20 62 65  that have now be
55c0: 65 6e 20 64 65 6c 65 74 65 64 2e 20 20 49 66 20  en deleted.  If 
55d0: 74 68 65 0a 2a 2a 20 67 61 72 62 61 67 65 20 64  the.** garbage d
55e0: 61 74 61 20 63 61 6d 65 20 66 72 6f 6d 20 61 6e  ata came from an
55f0: 20 6f 62 73 6f 6c 65 74 65 20 6a 6f 75 72 6e 61   obsolete journa
5600: 6c 20 66 69 6c 65 2c 20 74 68 65 20 63 68 65 63  l file, the chec
5610: 6b 73 75 6d 73 20 6d 69 67 68 74 0a 2a 2a 20 62  ksums might.** b
5620: 65 20 63 6f 72 72 65 63 74 2e 20 20 42 75 74 20  e correct.  But 
5630: 62 79 20 69 6e 69 74 69 61 6c 69 7a 69 6e 67 20  by initializing 
5640: 74 68 65 20 63 68 65 63 6b 73 75 6d 20 74 6f 20  the checksum to 
5650: 72 61 6e 64 6f 6d 20 76 61 6c 75 65 20 77 68 69  random value whi
5660: 63 68 0a 2a 2a 20 69 73 20 64 69 66 66 65 72 65  ch.** is differe
5670: 6e 74 20 66 6f 72 20 65 76 65 72 79 20 6a 6f 75  nt for every jou
5680: 72 6e 61 6c 2c 20 77 65 20 6d 69 6e 69 6d 69 7a  rnal, we minimiz
5690: 65 20 74 68 61 74 20 72 69 73 6b 2e 0a 2a 2f 0a  e that risk..*/.
56a0: 73 74 61 74 69 63 20 63 6f 6e 73 74 20 75 6e 73  static const uns
56b0: 69 67 6e 65 64 20 63 68 61 72 20 61 4a 6f 75 72  igned char aJour
56c0: 6e 61 6c 4d 61 67 69 63 5b 5d 20 3d 20 7b 0a 20  nalMagic[] = {. 
56d0: 20 30 78 64 39 2c 20 30 78 64 35 2c 20 30 78 30   0xd9, 0xd5, 0x0
56e0: 35 2c 20 30 78 66 39 2c 20 30 78 32 30 2c 20 30  5, 0xf9, 0x20, 0
56f0: 78 61 31 2c 20 30 78 36 33 2c 20 30 78 64 37 2c  xa1, 0x63, 0xd7,
5700: 0a 7d 3b 0a 0a 2f 2a 0a 2a 2a 20 54 68 65 20 73  .};../*.** The s
5710: 69 7a 65 20 6f 66 20 74 68 65 20 68 65 61 64 65  ize of the heade
5720: 72 20 61 6e 64 20 6f 66 20 65 61 63 68 20 70 61  r and of each pa
5730: 67 65 20 69 6e 20 74 68 65 20 6a 6f 75 72 6e 61  ge in the journa
5740: 6c 20 69 73 20 64 65 74 65 72 6d 69 6e 65 64 0a  l is determined.
5750: 2a 2a 20 62 79 20 74 68 65 20 66 6f 6c 6c 6f 77  ** by the follow
5760: 69 6e 67 20 6d 61 63 72 6f 73 2e 0a 2a 2f 0a 23  ing macros..*/.#
5770: 64 65 66 69 6e 65 20 4a 4f 55 52 4e 41 4c 5f 50  define JOURNAL_P
5780: 47 5f 53 5a 28 70 50 61 67 65 72 29 20 20 28 28  G_SZ(pPager)  ((
5790: 70 50 61 67 65 72 2d 3e 70 61 67 65 53 69 7a 65  pPager->pageSize
57a0: 29 20 2b 20 38 29 0a 0a 2f 2a 0a 2a 2a 20 54 68  ) + 8)../*.** Th
57b0: 65 20 6a 6f 75 72 6e 61 6c 20 68 65 61 64 65 72  e journal header
57c0: 20 73 69 7a 65 20 66 6f 72 20 74 68 69 73 20 70   size for this p
57d0: 61 67 65 72 2e 20 49 6e 20 74 68 65 20 66 75 74  ager. In the fut
57e0: 75 72 65 2c 20 74 68 69 73 20 63 6f 75 6c 64 20  ure, this could 
57f0: 62 65 0a 2a 2a 20 73 65 74 20 74 6f 20 73 6f 6d  be.** set to som
5800: 65 20 76 61 6c 75 65 20 72 65 61 64 20 66 72 6f  e value read fro
5810: 6d 20 74 68 65 20 64 69 73 6b 20 63 6f 6e 74 72  m the disk contr
5820: 6f 6c 6c 65 72 2e 20 54 68 65 20 69 6d 70 6f 72  oller. The impor
5830: 74 61 6e 74 0a 2a 2a 20 63 68 61 72 61 63 74 65  tant.** characte
5840: 72 69 73 74 69 63 20 69 73 20 74 68 61 74 20 69  ristic is that i
5850: 74 20 69 73 20 74 68 65 20 73 61 6d 65 20 73 69  t is the same si
5860: 7a 65 20 61 73 20 61 20 64 69 73 6b 20 73 65 63  ze as a disk sec
5870: 74 6f 72 2e 0a 2a 2f 0a 23 64 65 66 69 6e 65 20  tor..*/.#define 
5880: 4a 4f 55 52 4e 41 4c 5f 48 44 52 5f 53 5a 28 70  JOURNAL_HDR_SZ(p
5890: 50 61 67 65 72 29 20 28 70 50 61 67 65 72 2d 3e  Pager) (pPager->
58a0: 73 65 63 74 6f 72 53 69 7a 65 29 0a 0a 2f 2a 0a  sectorSize)../*.
58b0: 2a 2a 20 54 68 65 20 6d 61 63 72 6f 20 4d 45 4d  ** The macro MEM
58c0: 44 42 20 69 73 20 74 72 75 65 20 69 66 20 77 65  DB is true if we
58d0: 20 61 72 65 20 64 65 61 6c 69 6e 67 20 77 69 74   are dealing wit
58e0: 68 20 61 6e 20 69 6e 2d 6d 65 6d 6f 72 79 20 64  h an in-memory d
58f0: 61 74 61 62 61 73 65 2e 0a 2a 2a 20 57 65 20 64  atabase..** We d
5900: 6f 20 74 68 69 73 20 61 73 20 61 20 6d 61 63 72  o this as a macr
5910: 6f 20 73 6f 20 74 68 61 74 20 69 66 20 74 68 65  o so that if the
5920: 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 4d 45 4d   SQLITE_OMIT_MEM
5930: 4f 52 59 44 42 20 6d 61 63 72 6f 20 69 73 20 73  ORYDB macro is s
5940: 65 74 2c 0a 2a 2a 20 74 68 65 20 76 61 6c 75 65  et,.** the value
5950: 20 6f 66 20 4d 45 4d 44 42 20 77 69 6c 6c 20 62   of MEMDB will b
5960: 65 20 61 20 63 6f 6e 73 74 61 6e 74 20 61 6e 64  e a constant and
5970: 20 74 68 65 20 63 6f 6d 70 69 6c 65 72 20 77 69   the compiler wi
5980: 6c 6c 20 6f 70 74 69 6d 69 7a 65 0a 2a 2a 20 6f  ll optimize.** o
5990: 75 74 20 63 6f 64 65 20 74 68 61 74 20 77 6f 75  ut code that wou
59a0: 6c 64 20 6e 65 76 65 72 20 65 78 65 63 75 74 65  ld never execute
59b0: 2e 0a 2a 2f 0a 23 69 66 64 65 66 20 53 51 4c 49  ..*/.#ifdef SQLI
59c0: 54 45 5f 4f 4d 49 54 5f 4d 45 4d 4f 52 59 44 42  TE_OMIT_MEMORYDB
59d0: 0a 23 20 64 65 66 69 6e 65 20 4d 45 4d 44 42 20  .# define MEMDB 
59e0: 30 0a 23 65 6c 73 65 0a 23 20 64 65 66 69 6e 65  0.#else.# define
59f0: 20 4d 45 4d 44 42 20 70 50 61 67 65 72 2d 3e 6d   MEMDB pPager->m
5a00: 65 6d 44 62 0a 23 65 6e 64 69 66 0a 0a 2f 2a 0a  emDb.#endif../*.
5a10: 2a 2a 20 50 61 67 65 20 6e 75 6d 62 65 72 20 50  ** Page number P
5a20: 41 47 45 52 5f 4d 4a 5f 50 47 4e 4f 20 69 73 20  AGER_MJ_PGNO is 
5a30: 6e 65 76 65 72 20 75 73 65 64 20 69 6e 20 61 6e  never used in an
5a40: 20 53 51 4c 69 74 65 20 64 61 74 61 62 61 73 65   SQLite database
5a50: 20 28 69 74 20 69 73 0a 2a 2a 20 72 65 73 65 72   (it is.** reser
5a60: 76 65 64 20 66 6f 72 20 77 6f 72 6b 69 6e 67 20  ved for working 
5a70: 61 72 6f 75 6e 64 20 61 20 77 69 6e 64 6f 77 73  around a windows
5a80: 2f 70 6f 73 69 78 20 69 6e 63 6f 6d 70 61 74 69  /posix incompati
5a90: 62 69 6c 69 74 79 29 2e 20 49 74 20 69 73 0a 2a  bility). It is.*
5aa0: 2a 20 75 73 65 64 20 69 6e 20 74 68 65 20 6a 6f  * used in the jo
5ab0: 75 72 6e 61 6c 20 74 6f 20 73 69 67 6e 69 66 79  urnal to signify
5ac0: 20 74 68 61 74 20 74 68 65 20 72 65 6d 61 69 6e   that the remain
5ad0: 64 65 72 20 6f 66 20 74 68 65 20 6a 6f 75 72 6e  der of the journ
5ae0: 61 6c 20 66 69 6c 65 20 0a 2a 2a 20 69 73 20 64  al file .** is d
5af0: 65 76 6f 74 65 64 20 74 6f 20 73 74 6f 72 69 6e  evoted to storin
5b00: 67 20 61 20 6d 61 73 74 65 72 20 6a 6f 75 72 6e  g a master journ
5b10: 61 6c 20 6e 61 6d 65 20 2d 20 74 68 65 72 65 20  al name - there 
5b20: 61 72 65 20 6e 6f 20 6d 6f 72 65 20 70 61 67 65  are no more page
5b30: 73 20 74 6f 0a 2a 2a 20 72 6f 6c 6c 20 62 61 63  s to.** roll bac
5b40: 6b 2e 20 53 65 65 20 63 6f 6d 6d 65 6e 74 73 20  k. See comments 
5b50: 66 6f 72 20 66 75 6e 63 74 69 6f 6e 20 77 72 69  for function wri
5b60: 74 65 4d 61 73 74 65 72 4a 6f 75 72 6e 61 6c 28  teMasterJournal(
5b70: 29 20 66 6f 72 20 64 65 74 61 69 6c 73 2e 0a 2a  ) for details..*
5b80: 2f 0a 2f 2a 20 23 64 65 66 69 6e 65 20 50 41 47  /./* #define PAG
5b90: 45 52 5f 4d 4a 5f 50 47 4e 4f 28 78 29 20 28 50  ER_MJ_PGNO(x) (P
5ba0: 45 4e 44 49 4e 47 5f 42 59 54 45 2f 28 28 78 29  ENDING_BYTE/((x)
5bb0: 2d 3e 70 61 67 65 53 69 7a 65 29 29 20 2a 2f 0a  ->pageSize)) */.
5bc0: 23 64 65 66 69 6e 65 20 50 41 47 45 52 5f 4d 4a  #define PAGER_MJ
5bd0: 5f 50 47 4e 4f 28 78 29 20 28 28 50 45 4e 44 49  _PGNO(x) ((PENDI
5be0: 4e 47 5f 42 59 54 45 2f 28 28 78 29 2d 3e 70 61  NG_BYTE/((x)->pa
5bf0: 67 65 53 69 7a 65 29 29 2b 31 29 0a 0a 2f 2a 0a  geSize))+1)../*.
5c00: 2a 2a 20 54 68 65 20 6d 61 78 69 6d 75 6d 20 6c  ** The maximum l
5c10: 65 67 61 6c 20 70 61 67 65 20 6e 75 6d 62 65 72  egal page number
5c20: 20 69 73 20 28 32 5e 33 31 20 2d 20 31 29 2e 0a   is (2^31 - 1)..
5c30: 2a 2f 0a 23 64 65 66 69 6e 65 20 50 41 47 45 52  */.#define PAGER
5c40: 5f 4d 41 58 5f 50 47 4e 4f 20 32 31 34 37 34 38  _MAX_PGNO 214748
5c50: 33 36 34 37 0a 0a 2f 2a 0a 2a 2a 20 54 68 65 20  3647../*.** The 
5c60: 70 61 67 65 72 45 6e 74 65 72 28 29 20 61 6e 64  pagerEnter() and
5c70: 20 70 61 67 65 72 4c 65 61 76 65 28 29 20 72 6f   pagerLeave() ro
5c80: 75 74 69 6e 65 73 20 61 63 71 75 69 72 65 20 61  utines acquire a
5c90: 6e 64 20 72 65 6c 65 61 73 65 0a 2a 2a 20 61 20  nd release.** a 
5ca0: 6d 75 74 65 78 20 6f 6e 20 65 61 63 68 20 70 61  mutex on each pa
5cb0: 67 65 72 2e 20 20 54 68 65 20 6d 75 74 65 78 20  ger.  The mutex 
5cc0: 69 73 20 72 65 63 75 72 73 69 76 65 2e 0a 2a 2a  is recursive..**
5cd0: 0a 2a 2a 20 54 68 69 73 20 69 73 20 61 20 73 70  .** This is a sp
5ce0: 65 63 69 61 6c 2d 70 75 72 70 6f 73 65 20 6d 75  ecial-purpose mu
5cf0: 74 65 78 2e 20 20 49 74 20 6f 6e 6c 79 20 70 72  tex.  It only pr
5d00: 6f 76 69 64 65 73 20 6d 75 74 75 61 6c 20 65 78  ovides mutual ex
5d10: 63 6c 75 73 69 6f 6e 0a 2a 2a 20 62 65 74 77 65  clusion.** betwe
5d20: 65 6e 20 74 68 65 20 42 74 72 65 65 20 61 6e 64  en the Btree and
5d30: 20 74 68 65 20 4d 65 6d 6f 72 79 20 4d 61 6e 61   the Memory Mana
5d40: 67 65 6d 65 6e 74 20 73 71 6c 69 74 65 33 5f 72  gement sqlite3_r
5d50: 65 6c 65 61 73 65 5f 6d 65 6d 6f 72 79 28 29 0a  elease_memory().
5d60: 2a 2a 20 66 75 6e 63 74 69 6f 6e 2e 20 20 49 74  ** function.  It
5d70: 20 64 6f 65 73 20 6e 6f 74 20 70 72 65 76 65 6e   does not preven
5d80: 74 2c 20 66 6f 72 20 65 78 61 6d 70 6c 65 2c 20  t, for example, 
5d90: 74 77 6f 20 42 74 72 65 65 73 20 66 72 6f 6d 20  two Btrees from 
5da0: 61 63 63 65 73 73 69 6e 67 0a 2a 2a 20 74 68 65  accessing.** the
5db0: 20 73 61 6d 65 20 70 61 67 65 72 20 61 74 20 74   same pager at t
5dc0: 68 65 20 73 61 6d 65 20 74 69 6d 65 2e 20 20 4f  he same time.  O
5dd0: 74 68 65 72 20 67 65 6e 65 72 61 6c 2d 70 75 72  ther general-pur
5de0: 70 6f 73 65 20 6d 75 74 65 78 65 73 20 69 6e 0a  pose mutexes in.
5df0: 2a 2a 20 74 68 65 20 62 74 72 65 65 20 6c 61 79  ** the btree lay
5e00: 65 72 20 68 61 6e 64 6c 65 20 74 68 61 74 20 63  er handle that c
5e10: 68 6f 72 65 2e 0a 2a 2f 0a 23 69 66 64 65 66 20  hore..*/.#ifdef 
5e20: 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45 5f 4d 45  SQLITE_ENABLE_ME
5e30: 4d 4f 52 59 5f 4d 41 4e 41 47 45 4d 45 4e 54 0a  MORY_MANAGEMENT.
5e40: 20 20 73 74 61 74 69 63 20 76 6f 69 64 20 70 61    static void pa
5e50: 67 65 72 45 6e 74 65 72 28 50 61 67 65 72 20 2a  gerEnter(Pager *
5e60: 70 29 7b 0a 20 20 20 20 70 2d 3e 69 49 6e 55 73  p){.    p->iInUs
5e70: 65 44 42 2b 2b 3b 0a 20 20 20 20 69 66 28 20 70  eDB++;.    if( p
5e80: 2d 3e 69 49 6e 55 73 65 4d 4d 20 26 26 20 70 2d  ->iInUseMM && p-
5e90: 3e 69 49 6e 55 73 65 44 42 3d 3d 31 20 29 7b 0a  >iInUseDB==1 ){.
5ea0: 20 20 20 20 20 20 73 71 6c 69 74 65 33 5f 6d 75        sqlite3_mu
5eb0: 74 65 78 20 2a 6d 75 74 65 78 3b 0a 20 20 20 20  tex *mutex;.    
5ec0: 20 20 6d 75 74 65 78 20 3d 20 73 71 6c 69 74 65    mutex = sqlite
5ed0: 33 5f 6d 75 74 65 78 5f 61 6c 6c 6f 63 28 53 51  3_mutex_alloc(SQ
5ee0: 4c 49 54 45 5f 4d 55 54 45 58 5f 53 54 41 54 49  LITE_MUTEX_STATI
5ef0: 43 5f 4d 45 4d 32 29 3b 0a 20 20 20 20 20 20 70  C_MEM2);.      p
5f00: 2d 3e 69 49 6e 55 73 65 44 42 20 3d 20 30 3b 0a  ->iInUseDB = 0;.
5f10: 20 20 20 20 20 20 73 71 6c 69 74 65 33 5f 6d 75        sqlite3_mu
5f20: 74 65 78 5f 65 6e 74 65 72 28 6d 75 74 65 78 29  tex_enter(mutex)
5f30: 3b 0a 20 20 20 20 20 20 70 2d 3e 69 49 6e 55 73  ;.      p->iInUs
5f40: 65 44 42 20 3d 20 31 3b 0a 20 20 20 20 20 20 73  eDB = 1;.      s
5f50: 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 6c 65 61  qlite3_mutex_lea
5f60: 76 65 28 6d 75 74 65 78 29 3b 0a 20 20 20 20 7d  ve(mutex);.    }
5f70: 0a 20 20 20 20 61 73 73 65 72 74 28 20 70 2d 3e  .    assert( p->
5f80: 69 49 6e 55 73 65 4d 4d 3d 3d 30 20 29 3b 0a 20  iInUseMM==0 );. 
5f90: 20 7d 0a 20 20 73 74 61 74 69 63 20 76 6f 69 64   }.  static void
5fa0: 20 70 61 67 65 72 4c 65 61 76 65 28 50 61 67 65   pagerLeave(Page
5fb0: 72 20 2a 70 29 7b 0a 20 20 20 20 70 2d 3e 69 49  r *p){.    p->iI
5fc0: 6e 55 73 65 44 42 2d 2d 3b 0a 20 20 20 20 61 73  nUseDB--;.    as
5fd0: 73 65 72 74 28 20 70 2d 3e 69 49 6e 55 73 65 44  sert( p->iInUseD
5fe0: 42 3e 3d 30 20 29 3b 0a 20 20 7d 0a 23 65 6c 73  B>=0 );.  }.#els
5ff0: 65 0a 23 20 64 65 66 69 6e 65 20 70 61 67 65 72  e.# define pager
6000: 45 6e 74 65 72 28 58 29 0a 23 20 64 65 66 69 6e  Enter(X).# defin
6010: 65 20 70 61 67 65 72 4c 65 61 76 65 28 58 29 0a  e pagerLeave(X).
6020: 23 65 6e 64 69 66 0a 0a 2f 2a 0a 2a 2a 20 41 64  #endif../*.** Ad
6030: 64 20 70 61 67 65 20 70 50 67 20 74 6f 20 74 68  d page pPg to th
6040: 65 20 65 6e 64 20 6f 66 20 74 68 65 20 6c 69 6e  e end of the lin
6050: 6b 65 64 20 6c 69 73 74 20 6d 61 6e 61 67 65 64  ked list managed
6060: 20 62 79 20 73 74 72 75 63 74 75 72 65 0a 2a 2a   by structure.**
6070: 20 70 4c 69 73 74 20 28 70 50 67 20 62 65 63 6f   pList (pPg beco
6080: 6d 65 73 20 74 68 65 20 6c 61 73 74 20 65 6e 74  mes the last ent
6090: 72 79 20 69 6e 20 74 68 65 20 6c 69 73 74 20 2d  ry in the list -
60a0: 20 74 68 65 20 6d 6f 73 74 20 72 65 63 65 6e 74   the most recent
60b0: 6c 79 20 0a 2a 2a 20 75 73 65 64 29 2e 20 41 72  ly .** used). Ar
60c0: 67 75 6d 65 6e 74 20 70 4c 69 6e 6b 20 73 68 6f  gument pLink sho
60d0: 75 6c 64 20 70 6f 69 6e 74 20 74 6f 20 65 69 74  uld point to eit
60e0: 68 65 72 20 70 50 67 2d 3e 66 72 65 65 20 6f 72  her pPg->free or
60f0: 20 70 50 67 2d 3e 67 66 72 65 65 2c 0a 2a 2a 20   pPg->gfree,.** 
6100: 64 65 70 65 6e 64 69 6e 67 20 6f 6e 20 77 68 65  depending on whe
6110: 74 68 65 72 20 70 50 67 20 69 73 20 62 65 69 6e  ther pPg is bein
6120: 67 20 61 64 64 65 64 20 74 6f 20 74 68 65 20 70  g added to the p
6130: 61 67 65 72 2d 73 70 65 63 69 66 69 63 20 6f 72  ager-specific or
6140: 0a 2a 2a 20 67 6c 6f 62 61 6c 20 4c 52 55 20 6c  .** global LRU l
6150: 69 73 74 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 76  ist..*/.static v
6160: 6f 69 64 20 6c 69 73 74 41 64 64 28 50 61 67 65  oid listAdd(Page
6170: 72 4c 72 75 4c 69 73 74 20 2a 70 4c 69 73 74 2c  rLruList *pList,
6180: 20 50 61 67 65 72 4c 72 75 4c 69 6e 6b 20 2a 70   PagerLruLink *p
6190: 4c 69 6e 6b 2c 20 50 67 48 64 72 20 2a 70 50 67  Link, PgHdr *pPg
61a0: 29 7b 0a 20 20 70 4c 69 6e 6b 2d 3e 70 4e 65 78  ){.  pLink->pNex
61b0: 74 20 3d 20 30 3b 0a 20 20 70 4c 69 6e 6b 2d 3e  t = 0;.  pLink->
61c0: 70 50 72 65 76 20 3d 20 70 4c 69 73 74 2d 3e 70  pPrev = pList->p
61d0: 4c 61 73 74 3b 0a 0a 23 69 66 64 65 66 20 53 51  Last;..#ifdef SQ
61e0: 4c 49 54 45 5f 45 4e 41 42 4c 45 5f 4d 45 4d 4f  LITE_ENABLE_MEMO
61f0: 52 59 5f 4d 41 4e 41 47 45 4d 45 4e 54 0a 20 20  RY_MANAGEMENT.  
6200: 61 73 73 65 72 74 28 70 4c 69 6e 6b 3d 3d 26 70  assert(pLink==&p
6210: 50 67 2d 3e 66 72 65 65 20 7c 7c 20 70 4c 69 6e  Pg->free || pLin
6220: 6b 3d 3d 26 70 50 67 2d 3e 67 66 72 65 65 29 3b  k==&pPg->gfree);
6230: 0a 20 20 61 73 73 65 72 74 28 70 4c 69 6e 6b 3d  .  assert(pLink=
6240: 3d 26 70 50 67 2d 3e 67 66 72 65 65 20 7c 7c 20  =&pPg->gfree || 
6250: 70 4c 69 73 74 21 3d 26 73 71 6c 69 74 65 33 4c  pList!=&sqlite3L
6260: 72 75 50 61 67 65 4c 69 73 74 29 3b 0a 23 65 6e  ruPageList);.#en
6270: 64 69 66 0a 0a 20 20 69 66 28 20 70 4c 69 73 74  dif..  if( pList
6280: 2d 3e 70 4c 61 73 74 20 29 7b 0a 20 20 20 20 69  ->pLast ){.    i
6290: 6e 74 20 69 4f 66 66 20 3d 20 28 63 68 61 72 20  nt iOff = (char 
62a0: 2a 29 70 4c 69 6e 6b 20 2d 20 28 63 68 61 72 20  *)pLink - (char 
62b0: 2a 29 70 50 67 3b 0a 20 20 20 20 50 61 67 65 72  *)pPg;.    Pager
62c0: 4c 72 75 4c 69 6e 6b 20 2a 70 4c 61 73 74 4c 69  LruLink *pLastLi
62d0: 6e 6b 20 3d 20 28 50 61 67 65 72 4c 72 75 4c 69  nk = (PagerLruLi
62e0: 6e 6b 20 2a 29 28 26 28 28 75 38 20 2a 29 70 4c  nk *)(&((u8 *)pL
62f0: 69 73 74 2d 3e 70 4c 61 73 74 29 5b 69 4f 66 66  ist->pLast)[iOff
6300: 5d 29 3b 0a 20 20 20 20 70 4c 61 73 74 4c 69 6e  ]);.    pLastLin
6310: 6b 2d 3e 70 4e 65 78 74 20 3d 20 70 50 67 3b 0a  k->pNext = pPg;.
6320: 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 61 73 73    }else{.    ass
6330: 65 72 74 28 21 70 4c 69 73 74 2d 3e 70 46 69 72  ert(!pList->pFir
6340: 73 74 29 3b 0a 20 20 20 20 70 4c 69 73 74 2d 3e  st);.    pList->
6350: 70 46 69 72 73 74 20 3d 20 70 50 67 3b 0a 20 20  pFirst = pPg;.  
6360: 7d 0a 0a 20 20 70 4c 69 73 74 2d 3e 70 4c 61 73  }..  pList->pLas
6370: 74 20 3d 20 70 50 67 3b 0a 20 20 69 66 28 20 21  t = pPg;.  if( !
6380: 70 4c 69 73 74 2d 3e 70 46 69 72 73 74 53 79 6e  pList->pFirstSyn
6390: 63 65 64 20 26 26 20 70 50 67 2d 3e 6e 65 65 64  ced && pPg->need
63a0: 53 79 6e 63 3d 3d 30 20 29 7b 0a 20 20 20 20 70  Sync==0 ){.    p
63b0: 4c 69 73 74 2d 3e 70 46 69 72 73 74 53 79 6e 63  List->pFirstSync
63c0: 65 64 20 3d 20 70 50 67 3b 0a 20 20 7d 0a 7d 0a  ed = pPg;.  }.}.
63d0: 0a 2f 2a 0a 2a 2a 20 52 65 6d 6f 76 65 20 70 50  ./*.** Remove pP
63e0: 67 20 66 72 6f 6d 20 74 68 65 20 6c 69 73 74 20  g from the list 
63f0: 6d 61 6e 61 67 65 64 20 62 79 20 74 68 65 20 73  managed by the s
6400: 74 72 75 63 74 75 72 65 20 70 6f 69 6e 74 65 64  tructure pointed
6410: 20 74 6f 20 62 79 20 70 4c 69 73 74 2e 0a 2a 2a   to by pList..**
6420: 0a 2a 2a 20 41 72 67 75 6d 65 6e 74 20 70 4c 69  .** Argument pLi
6430: 6e 6b 20 73 68 6f 75 6c 64 20 70 6f 69 6e 74 20  nk should point 
6440: 74 6f 20 65 69 74 68 65 72 20 70 50 67 2d 3e 66  to either pPg->f
6450: 72 65 65 20 6f 72 20 70 50 67 2d 3e 67 66 72 65  ree or pPg->gfre
6460: 65 2c 20 64 65 70 65 6e 64 69 6e 67 20 0a 2a 2a  e, depending .**
6470: 20 6f 6e 20 77 68 65 74 68 65 72 20 70 50 67 20   on whether pPg 
6480: 69 73 20 62 65 69 6e 67 20 61 64 64 65 64 20 74  is being added t
6490: 6f 20 74 68 65 20 70 61 67 65 72 2d 73 70 65 63  o the pager-spec
64a0: 69 66 69 63 20 6f 72 20 67 6c 6f 62 61 6c 20 4c  ific or global L
64b0: 52 55 20 6c 69 73 74 2e 0a 2a 2f 0a 73 74 61 74  RU list..*/.stat
64c0: 69 63 20 76 6f 69 64 20 6c 69 73 74 52 65 6d 6f  ic void listRemo
64d0: 76 65 28 50 61 67 65 72 4c 72 75 4c 69 73 74 20  ve(PagerLruList 
64e0: 2a 70 4c 69 73 74 2c 20 50 61 67 65 72 4c 72 75  *pList, PagerLru
64f0: 4c 69 6e 6b 20 2a 70 4c 69 6e 6b 2c 20 50 67 48  Link *pLink, PgH
6500: 64 72 20 2a 70 50 67 29 7b 0a 20 20 69 6e 74 20  dr *pPg){.  int 
6510: 69 4f 66 66 20 3d 20 28 63 68 61 72 20 2a 29 70  iOff = (char *)p
6520: 4c 69 6e 6b 20 2d 20 28 63 68 61 72 20 2a 29 70  Link - (char *)p
6530: 50 67 3b 0a 0a 23 69 66 64 65 66 20 53 51 4c 49  Pg;..#ifdef SQLI
6540: 54 45 5f 45 4e 41 42 4c 45 5f 4d 45 4d 4f 52 59  TE_ENABLE_MEMORY
6550: 5f 4d 41 4e 41 47 45 4d 45 4e 54 0a 20 20 61 73  _MANAGEMENT.  as
6560: 73 65 72 74 28 70 4c 69 6e 6b 3d 3d 26 70 50 67  sert(pLink==&pPg
6570: 2d 3e 66 72 65 65 20 7c 7c 20 70 4c 69 6e 6b 3d  ->free || pLink=
6580: 3d 26 70 50 67 2d 3e 67 66 72 65 65 29 3b 0a 20  =&pPg->gfree);. 
6590: 20 61 73 73 65 72 74 28 70 4c 69 6e 6b 3d 3d 26   assert(pLink==&
65a0: 70 50 67 2d 3e 67 66 72 65 65 20 7c 7c 20 70 4c  pPg->gfree || pL
65b0: 69 73 74 21 3d 26 73 71 6c 69 74 65 33 4c 72 75  ist!=&sqlite3Lru
65c0: 50 61 67 65 4c 69 73 74 29 3b 0a 23 65 6e 64 69  PageList);.#endi
65d0: 66 0a 0a 20 20 69 66 28 20 70 50 67 3d 3d 70 4c  f..  if( pPg==pL
65e0: 69 73 74 2d 3e 70 46 69 72 73 74 20 29 7b 0a 20  ist->pFirst ){. 
65f0: 20 20 20 70 4c 69 73 74 2d 3e 70 46 69 72 73 74     pList->pFirst
6600: 20 3d 20 70 4c 69 6e 6b 2d 3e 70 4e 65 78 74 3b   = pLink->pNext;
6610: 0a 20 20 7d 0a 20 20 69 66 28 20 70 50 67 3d 3d  .  }.  if( pPg==
6620: 70 4c 69 73 74 2d 3e 70 4c 61 73 74 20 29 7b 0a  pList->pLast ){.
6630: 20 20 20 20 70 4c 69 73 74 2d 3e 70 4c 61 73 74      pList->pLast
6640: 20 3d 20 70 4c 69 6e 6b 2d 3e 70 50 72 65 76 3b   = pLink->pPrev;
6650: 0a 20 20 7d 0a 20 20 69 66 28 20 70 4c 69 6e 6b  .  }.  if( pLink
6660: 2d 3e 70 50 72 65 76 20 29 7b 0a 20 20 20 20 50  ->pPrev ){.    P
6670: 61 67 65 72 4c 72 75 4c 69 6e 6b 20 2a 70 50 72  agerLruLink *pPr
6680: 65 76 4c 69 6e 6b 20 3d 20 28 50 61 67 65 72 4c  evLink = (PagerL
6690: 72 75 4c 69 6e 6b 20 2a 29 28 26 28 28 75 38 20  ruLink *)(&((u8 
66a0: 2a 29 70 4c 69 6e 6b 2d 3e 70 50 72 65 76 29 5b  *)pLink->pPrev)[
66b0: 69 4f 66 66 5d 29 3b 0a 20 20 20 20 70 50 72 65  iOff]);.    pPre
66c0: 76 4c 69 6e 6b 2d 3e 70 4e 65 78 74 20 3d 20 70  vLink->pNext = p
66d0: 4c 69 6e 6b 2d 3e 70 4e 65 78 74 3b 0a 20 20 7d  Link->pNext;.  }
66e0: 0a 20 20 69 66 28 20 70 4c 69 6e 6b 2d 3e 70 4e  .  if( pLink->pN
66f0: 65 78 74 20 29 7b 0a 20 20 20 20 50 61 67 65 72  ext ){.    Pager
6700: 4c 72 75 4c 69 6e 6b 20 2a 70 4e 65 78 74 4c 69  LruLink *pNextLi
6710: 6e 6b 20 3d 20 28 50 61 67 65 72 4c 72 75 4c 69  nk = (PagerLruLi
6720: 6e 6b 20 2a 29 28 26 28 28 75 38 20 2a 29 70 4c  nk *)(&((u8 *)pL
6730: 69 6e 6b 2d 3e 70 4e 65 78 74 29 5b 69 4f 66 66  ink->pNext)[iOff
6740: 5d 29 3b 0a 20 20 20 20 70 4e 65 78 74 4c 69 6e  ]);.    pNextLin
6750: 6b 2d 3e 70 50 72 65 76 20 3d 20 70 4c 69 6e 6b  k->pPrev = pLink
6760: 2d 3e 70 50 72 65 76 3b 0a 20 20 7d 0a 20 20 69  ->pPrev;.  }.  i
6770: 66 28 20 70 50 67 3d 3d 70 4c 69 73 74 2d 3e 70  f( pPg==pList->p
6780: 46 69 72 73 74 53 79 6e 63 65 64 20 29 7b 0a 20  FirstSynced ){. 
6790: 20 20 20 50 67 48 64 72 20 2a 70 20 3d 20 70 4c     PgHdr *p = pL
67a0: 69 6e 6b 2d 3e 70 4e 65 78 74 3b 0a 20 20 20 20  ink->pNext;.    
67b0: 77 68 69 6c 65 28 20 70 20 26 26 20 70 2d 3e 6e  while( p && p->n
67c0: 65 65 64 53 79 6e 63 20 29 7b 0a 20 20 20 20 20  eedSync ){.     
67d0: 20 50 61 67 65 72 4c 72 75 4c 69 6e 6b 20 2a 70   PagerLruLink *p
67e0: 4c 20 3d 20 28 50 61 67 65 72 4c 72 75 4c 69 6e  L = (PagerLruLin
67f0: 6b 20 2a 29 28 26 28 28 75 38 20 2a 29 70 29 5b  k *)(&((u8 *)p)[
6800: 69 4f 66 66 5d 29 3b 0a 20 20 20 20 20 20 70 20  iOff]);.      p 
6810: 3d 20 70 4c 2d 3e 70 4e 65 78 74 3b 0a 20 20 20  = pL->pNext;.   
6820: 20 7d 0a 20 20 20 20 70 4c 69 73 74 2d 3e 70 46   }.    pList->pF
6830: 69 72 73 74 53 79 6e 63 65 64 20 3d 20 70 3b 0a  irstSynced = p;.
6840: 20 20 7d 0a 0a 20 20 70 4c 69 6e 6b 2d 3e 70 4e    }..  pLink->pN
6850: 65 78 74 20 3d 20 70 4c 69 6e 6b 2d 3e 70 50 72  ext = pLink->pPr
6860: 65 76 20 3d 20 30 3b 0a 7d 0a 0a 2f 2a 20 0a 2a  ev = 0;.}../* .*
6870: 2a 20 41 64 64 20 70 61 67 65 20 70 50 67 20 74  * Add page pPg t
6880: 6f 20 74 68 65 20 6c 69 73 74 20 6f 66 20 66 72  o the list of fr
6890: 65 65 20 70 61 67 65 73 20 66 6f 72 20 74 68 65  ee pages for the
68a0: 20 70 61 67 65 72 2e 20 49 66 20 0a 2a 2a 20 6d   pager. If .** m
68b0: 65 6d 6f 72 79 2d 6d 61 6e 61 67 65 6d 65 6e 74  emory-management
68c0: 20 69 73 20 65 6e 61 62 6c 65 64 2c 20 61 6c 73   is enabled, als
68d0: 6f 20 61 64 64 20 74 68 65 20 70 61 67 65 20 74  o add the page t
68e0: 6f 20 74 68 65 20 67 6c 6f 62 61 6c 20 0a 2a 2a  o the global .**
68f0: 20 6c 69 73 74 20 6f 66 20 66 72 65 65 20 70 61   list of free pa
6900: 67 65 73 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 76  ges..*/.static v
6910: 6f 69 64 20 6c 72 75 4c 69 73 74 41 64 64 28 50  oid lruListAdd(P
6920: 67 48 64 72 20 2a 70 50 67 29 7b 0a 20 20 6c 69  gHdr *pPg){.  li
6930: 73 74 41 64 64 28 26 70 50 67 2d 3e 70 50 61 67  stAdd(&pPg->pPag
6940: 65 72 2d 3e 6c 72 75 2c 20 26 70 50 67 2d 3e 66  er->lru, &pPg->f
6950: 72 65 65 2c 20 70 50 67 29 3b 0a 23 69 66 64 65  ree, pPg);.#ifde
6960: 66 20 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45 5f  f SQLITE_ENABLE_
6970: 4d 45 4d 4f 52 59 5f 4d 41 4e 41 47 45 4d 45 4e  MEMORY_MANAGEMEN
6980: 54 0a 20 20 69 66 28 20 21 70 50 67 2d 3e 70 50  T.  if( !pPg->pP
6990: 61 67 65 72 2d 3e 6d 65 6d 44 62 20 29 7b 0a 20  ager->memDb ){. 
69a0: 20 20 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78     sqlite3_mutex
69b0: 5f 65 6e 74 65 72 28 73 71 6c 69 74 65 33 5f 6d  _enter(sqlite3_m
69c0: 75 74 65 78 5f 61 6c 6c 6f 63 28 53 51 4c 49 54  utex_alloc(SQLIT
69d0: 45 5f 4d 55 54 45 58 5f 53 54 41 54 49 43 5f 4c  E_MUTEX_STATIC_L
69e0: 52 55 29 29 3b 0a 20 20 20 20 6c 69 73 74 41 64  RU));.    listAd
69f0: 64 28 26 73 71 6c 69 74 65 33 4c 72 75 50 61 67  d(&sqlite3LruPag
6a00: 65 4c 69 73 74 2c 20 26 70 50 67 2d 3e 67 66 72  eList, &pPg->gfr
6a10: 65 65 2c 20 70 50 67 29 3b 0a 20 20 20 20 73 71  ee, pPg);.    sq
6a20: 6c 69 74 65 33 5f 6d 75 74 65 78 5f 6c 65 61 76  lite3_mutex_leav
6a30: 65 28 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f  e(sqlite3_mutex_
6a40: 61 6c 6c 6f 63 28 53 51 4c 49 54 45 5f 4d 55 54  alloc(SQLITE_MUT
6a50: 45 58 5f 53 54 41 54 49 43 5f 4c 52 55 29 29 3b  EX_STATIC_LRU));
6a60: 0a 20 20 7d 0a 23 65 6e 64 69 66 0a 7d 0a 0a 2f  .  }.#endif.}../
6a70: 2a 20 0a 2a 2a 20 52 65 6d 6f 76 65 20 70 61 67  * .** Remove pag
6a80: 65 20 70 50 67 20 66 72 6f 6d 20 74 68 65 20 6c  e pPg from the l
6a90: 69 73 74 20 6f 66 20 66 72 65 65 20 70 61 67 65  ist of free page
6aa0: 73 20 66 6f 72 20 74 68 65 20 61 73 73 6f 63 69  s for the associ
6ab0: 61 74 65 64 20 70 61 67 65 72 2e 0a 2a 2a 20 49  ated pager..** I
6ac0: 66 20 6d 65 6d 6f 72 79 2d 6d 61 6e 61 67 65 6d  f memory-managem
6ad0: 65 6e 74 20 69 73 20 65 6e 61 62 6c 65 64 2c 20  ent is enabled, 
6ae0: 61 6c 73 6f 20 72 65 6d 6f 76 65 20 70 50 67 20  also remove pPg 
6af0: 66 72 6f 6d 20 74 68 65 20 67 6c 6f 62 61 6c 20  from the global 
6b00: 6c 69 73 74 0a 2a 2a 20 6f 66 20 66 72 65 65 20  list.** of free 
6b10: 70 61 67 65 73 2e 0a 2a 2f 0a 73 74 61 74 69 63  pages..*/.static
6b20: 20 76 6f 69 64 20 6c 72 75 4c 69 73 74 52 65 6d   void lruListRem
6b30: 6f 76 65 28 50 67 48 64 72 20 2a 70 50 67 29 7b  ove(PgHdr *pPg){
6b40: 0a 20 20 6c 69 73 74 52 65 6d 6f 76 65 28 26 70  .  listRemove(&p
6b50: 50 67 2d 3e 70 50 61 67 65 72 2d 3e 6c 72 75 2c  Pg->pPager->lru,
6b60: 20 26 70 50 67 2d 3e 66 72 65 65 2c 20 70 50 67   &pPg->free, pPg
6b70: 29 3b 0a 23 69 66 64 65 66 20 53 51 4c 49 54 45  );.#ifdef SQLITE
6b80: 5f 45 4e 41 42 4c 45 5f 4d 45 4d 4f 52 59 5f 4d  _ENABLE_MEMORY_M
6b90: 41 4e 41 47 45 4d 45 4e 54 0a 20 20 69 66 28 20  ANAGEMENT.  if( 
6ba0: 21 70 50 67 2d 3e 70 50 61 67 65 72 2d 3e 6d 65  !pPg->pPager->me
6bb0: 6d 44 62 20 29 7b 0a 20 20 20 20 73 71 6c 69 74  mDb ){.    sqlit
6bc0: 65 33 5f 6d 75 74 65 78 5f 65 6e 74 65 72 28 73  e3_mutex_enter(s
6bd0: 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 61 6c 6c  qlite3_mutex_all
6be0: 6f 63 28 53 51 4c 49 54 45 5f 4d 55 54 45 58 5f  oc(SQLITE_MUTEX_
6bf0: 53 54 41 54 49 43 5f 4c 52 55 29 29 3b 0a 20 20  STATIC_LRU));.  
6c00: 20 20 6c 69 73 74 52 65 6d 6f 76 65 28 26 73 71    listRemove(&sq
6c10: 6c 69 74 65 33 4c 72 75 50 61 67 65 4c 69 73 74  lite3LruPageList
6c20: 2c 20 26 70 50 67 2d 3e 67 66 72 65 65 2c 20 70  , &pPg->gfree, p
6c30: 50 67 29 3b 0a 20 20 20 20 73 71 6c 69 74 65 33  Pg);.    sqlite3
6c40: 5f 6d 75 74 65 78 5f 6c 65 61 76 65 28 73 71 6c  _mutex_leave(sql
6c50: 69 74 65 33 5f 6d 75 74 65 78 5f 61 6c 6c 6f 63  ite3_mutex_alloc
6c60: 28 53 51 4c 49 54 45 5f 4d 55 54 45 58 5f 53 54  (SQLITE_MUTEX_ST
6c70: 41 54 49 43 5f 4c 52 55 29 29 3b 0a 20 20 7d 0a  ATIC_LRU));.  }.
6c80: 23 65 6e 64 69 66 0a 7d 0a 0a 2f 2a 20 0a 2a 2a  #endif.}../* .**
6c90: 20 54 68 69 73 20 66 75 6e 63 74 69 6f 6e 20 69   This function i
6ca0: 73 20 63 61 6c 6c 65 64 20 6a 75 73 74 20 61 66  s called just af
6cb0: 74 65 72 20 74 68 65 20 6e 65 65 64 53 79 6e 63  ter the needSync
6cc0: 20 66 6c 61 67 20 68 61 73 20 62 65 65 6e 20 63   flag has been c
6cd0: 6c 65 61 72 65 64 0a 2a 2a 20 66 72 6f 6d 20 61  leared.** from a
6ce0: 6c 6c 20 70 61 67 65 73 20 6d 61 6e 61 67 65 64  ll pages managed
6cf0: 20 62 79 20 70 50 61 67 65 72 20 28 75 73 75 61   by pPager (usua
6d00: 6c 6c 79 20 62 65 63 61 75 73 65 20 74 68 65 20  lly because the 
6d10: 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 0a 2a 2a 20  journal file.** 
6d20: 68 61 73 20 6a 75 73 74 20 62 65 65 6e 20 73 79  has just been sy
6d30: 6e 63 65 64 29 2e 20 49 74 20 75 70 64 61 74 65  nced). It update
6d40: 73 20 74 68 65 20 70 50 61 67 65 72 2d 3e 6c 72  s the pPager->lr
6d50: 75 2e 70 46 69 72 73 74 53 79 6e 63 65 64 20 76  u.pFirstSynced v
6d60: 61 72 69 61 62 6c 65 0a 2a 2a 20 61 6e 64 2c 20  ariable.** and, 
6d70: 69 66 20 6d 65 6d 6f 72 79 2d 6d 61 6e 61 67 65  if memory-manage
6d80: 6d 65 6e 74 20 69 73 20 65 6e 61 62 6c 65 64 2c  ment is enabled,
6d90: 20 74 68 65 20 73 71 6c 69 74 65 33 4c 72 75 50   the sqlite3LruP
6da0: 61 67 65 4c 69 73 74 2e 70 46 69 72 73 74 53 79  ageList.pFirstSy
6db0: 6e 63 65 64 0a 2a 2a 20 76 61 72 69 61 62 6c 65  nced.** variable
6dc0: 20 61 6c 73 6f 2e 0a 2a 2f 0a 73 74 61 74 69 63   also..*/.static
6dd0: 20 76 6f 69 64 20 6c 72 75 4c 69 73 74 53 65 74   void lruListSet
6de0: 46 69 72 73 74 53 79 6e 63 65 64 28 50 61 67 65  FirstSynced(Page
6df0: 72 20 2a 70 50 61 67 65 72 29 7b 0a 20 20 70 50  r *pPager){.  pP
6e00: 61 67 65 72 2d 3e 6c 72 75 2e 70 46 69 72 73 74  ager->lru.pFirst
6e10: 53 79 6e 63 65 64 20 3d 20 70 50 61 67 65 72 2d  Synced = pPager-
6e20: 3e 6c 72 75 2e 70 46 69 72 73 74 3b 0a 23 69 66  >lru.pFirst;.#if
6e30: 64 65 66 20 53 51 4c 49 54 45 5f 45 4e 41 42 4c  def SQLITE_ENABL
6e40: 45 5f 4d 45 4d 4f 52 59 5f 4d 41 4e 41 47 45 4d  E_MEMORY_MANAGEM
6e50: 45 4e 54 0a 20 20 69 66 28 20 21 70 50 61 67 65  ENT.  if( !pPage
6e60: 72 2d 3e 6d 65 6d 44 62 20 29 7b 0a 20 20 20 20  r->memDb ){.    
6e70: 50 67 48 64 72 20 2a 70 3b 0a 20 20 20 20 73 71  PgHdr *p;.    sq
6e80: 6c 69 74 65 33 5f 6d 75 74 65 78 5f 65 6e 74 65  lite3_mutex_ente
6e90: 72 28 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f  r(sqlite3_mutex_
6ea0: 61 6c 6c 6f 63 28 53 51 4c 49 54 45 5f 4d 55 54  alloc(SQLITE_MUT
6eb0: 45 58 5f 53 54 41 54 49 43 5f 4c 52 55 29 29 3b  EX_STATIC_LRU));
6ec0: 0a 20 20 20 20 66 6f 72 28 70 3d 73 71 6c 69 74  .    for(p=sqlit
6ed0: 65 33 4c 72 75 50 61 67 65 4c 69 73 74 2e 70 46  e3LruPageList.pF
6ee0: 69 72 73 74 3b 20 70 20 26 26 20 70 2d 3e 6e 65  irst; p && p->ne
6ef0: 65 64 53 79 6e 63 3b 20 70 3d 70 2d 3e 67 66 72  edSync; p=p->gfr
6f00: 65 65 2e 70 4e 65 78 74 29 3b 0a 20 20 20 20 61  ee.pNext);.    a
6f10: 73 73 65 72 74 28 70 3d 3d 70 50 61 67 65 72 2d  ssert(p==pPager-
6f20: 3e 6c 72 75 2e 70 46 69 72 73 74 53 79 6e 63 65  >lru.pFirstSynce
6f30: 64 20 7c 7c 20 70 3d 3d 73 71 6c 69 74 65 33 4c  d || p==sqlite3L
6f40: 72 75 50 61 67 65 4c 69 73 74 2e 70 46 69 72 73  ruPageList.pFirs
6f50: 74 53 79 6e 63 65 64 29 3b 0a 20 20 20 20 73 71  tSynced);.    sq
6f60: 6c 69 74 65 33 4c 72 75 50 61 67 65 4c 69 73 74  lite3LruPageList
6f70: 2e 70 46 69 72 73 74 53 79 6e 63 65 64 20 3d 20  .pFirstSynced = 
6f80: 70 3b 0a 20 20 20 20 73 71 6c 69 74 65 33 5f 6d  p;.    sqlite3_m
6f90: 75 74 65 78 5f 6c 65 61 76 65 28 73 71 6c 69 74  utex_leave(sqlit
6fa0: 65 33 5f 6d 75 74 65 78 5f 61 6c 6c 6f 63 28 53  e3_mutex_alloc(S
6fb0: 51 4c 49 54 45 5f 4d 55 54 45 58 5f 53 54 41 54  QLITE_MUTEX_STAT
6fc0: 49 43 5f 4c 52 55 29 29 3b 0a 20 20 7d 0a 23 65  IC_LRU));.  }.#e
6fd0: 6e 64 69 66 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 52 65  ndif.}../*.** Re
6fe0: 74 75 72 6e 20 74 72 75 65 20 69 66 20 70 61 67  turn true if pag
6ff0: 65 20 2a 70 50 67 20 68 61 73 20 61 6c 72 65 61  e *pPg has alrea
7000: 64 79 20 62 65 65 6e 20 77 72 69 74 74 65 6e 20  dy been written 
7010: 74 6f 20 74 68 65 20 73 74 61 74 65 6d 65 6e 74  to the statement
7020: 0a 2a 2a 20 6a 6f 75 72 6e 61 6c 20 28 6f 72 20  .** journal (or 
7030: 73 74 61 74 65 6d 65 6e 74 20 73 6e 61 70 73 68  statement snapsh
7040: 6f 74 20 68 61 73 20 62 65 65 6e 20 63 72 65 61  ot has been crea
7050: 74 65 64 2c 20 69 66 20 2a 70 50 67 20 69 73 20  ted, if *pPg is 
7060: 70 61 72 74 0a 2a 2a 20 6f 66 20 61 6e 20 69 6e  part.** of an in
7070: 2d 6d 65 6d 6f 72 79 20 64 61 74 61 62 61 73 65  -memory database
7080: 29 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74  )..*/.static int
7090: 20 70 61 67 65 49 6e 53 74 61 74 65 6d 65 6e 74   pageInStatement
70a0: 28 50 67 48 64 72 20 2a 70 50 67 29 7b 0a 20 20  (PgHdr *pPg){.  
70b0: 50 61 67 65 72 20 2a 70 50 61 67 65 72 20 3d 20  Pager *pPager = 
70c0: 70 50 67 2d 3e 70 50 61 67 65 72 3b 0a 20 20 69  pPg->pPager;.  i
70d0: 66 28 20 4d 45 4d 44 42 20 29 7b 0a 20 20 20 20  f( MEMDB ){.    
70e0: 72 65 74 75 72 6e 20 50 47 48 44 52 5f 54 4f 5f  return PGHDR_TO_
70f0: 48 49 53 54 28 70 50 67 2c 20 70 50 61 67 65 72  HIST(pPg, pPager
7100: 29 2d 3e 69 6e 53 74 6d 74 3b 0a 20 20 7d 65 6c  )->inStmt;.  }el
7110: 73 65 7b 0a 20 20 20 20 72 65 74 75 72 6e 20 73  se{.    return s
7120: 71 6c 69 74 65 33 42 69 74 76 65 63 54 65 73 74  qlite3BitvecTest
7130: 28 70 50 61 67 65 72 2d 3e 70 49 6e 53 74 6d 74  (pPager->pInStmt
7140: 2c 20 70 50 67 2d 3e 70 67 6e 6f 29 3b 0a 20 20  , pPg->pgno);.  
7150: 7d 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 43 68 61 6e 67  }.}../*.** Chang
7160: 65 20 74 68 65 20 73 69 7a 65 20 6f 66 20 74 68  e the size of th
7170: 65 20 70 61 67 65 72 20 68 61 73 68 20 74 61 62  e pager hash tab
7180: 6c 65 20 74 6f 20 4e 2e 20 20 4e 20 6d 75 73 74  le to N.  N must
7190: 20 62 65 20 61 20 70 6f 77 65 72 0a 2a 2a 20 6f   be a power.** o
71a0: 66 20 74 77 6f 2e 0a 2a 2f 0a 73 74 61 74 69 63  f two..*/.static
71b0: 20 76 6f 69 64 20 70 61 67 65 72 5f 72 65 73 69   void pager_resi
71c0: 7a 65 5f 68 61 73 68 5f 74 61 62 6c 65 28 50 61  ze_hash_table(Pa
71d0: 67 65 72 20 2a 70 50 61 67 65 72 2c 20 69 6e 74  ger *pPager, int
71e0: 20 4e 29 7b 0a 20 20 50 67 48 64 72 20 2a 2a 61   N){.  PgHdr **a
71f0: 48 61 73 68 2c 20 2a 70 50 67 3b 0a 20 20 61 73  Hash, *pPg;.  as
7200: 73 65 72 74 28 20 4e 3e 30 20 26 26 20 28 4e 26  sert( N>0 && (N&
7210: 28 4e 2d 31 29 29 3d 3d 30 20 29 3b 0a 23 69 66  (N-1))==0 );.#if
7220: 64 65 66 20 53 51 4c 49 54 45 5f 4d 41 4c 4c 4f  def SQLITE_MALLO
7230: 43 5f 53 4f 46 54 5f 4c 49 4d 49 54 0a 20 20 69  C_SOFT_LIMIT.  i
7240: 66 28 20 4e 2a 73 69 7a 65 6f 66 28 61 48 61 73  f( N*sizeof(aHas
7250: 68 5b 30 5d 29 3e 53 51 4c 49 54 45 5f 4d 41 4c  h[0])>SQLITE_MAL
7260: 4c 4f 43 5f 53 4f 46 54 5f 4c 49 4d 49 54 20 29  LOC_SOFT_LIMIT )
7270: 7b 0a 20 20 20 20 4e 20 3d 20 53 51 4c 49 54 45  {.    N = SQLITE
7280: 5f 4d 41 4c 4c 4f 43 5f 53 4f 46 54 5f 4c 49 4d  _MALLOC_SOFT_LIM
7290: 49 54 2f 73 69 7a 65 6f 66 28 61 48 61 73 68 5b  IT/sizeof(aHash[
72a0: 30 5d 29 3b 0a 20 20 7d 0a 20 20 69 66 28 20 4e  0]);.  }.  if( N
72b0: 3d 3d 70 50 61 67 65 72 2d 3e 6e 48 61 73 68 20  ==pPager->nHash 
72c0: 29 20 72 65 74 75 72 6e 3b 0a 23 65 6e 64 69 66  ) return;.#endif
72d0: 0a 20 20 70 61 67 65 72 4c 65 61 76 65 28 70 50  .  pagerLeave(pP
72e0: 61 67 65 72 29 3b 0a 20 20 73 71 6c 69 74 65 33  ager);.  sqlite3
72f0: 46 61 75 6c 74 42 65 6e 69 67 6e 28 53 51 4c 49  FaultBenign(SQLI
7300: 54 45 5f 46 41 55 4c 54 49 4e 4a 45 43 54 4f 52  TE_FAULTINJECTOR
7310: 5f 4d 41 4c 4c 4f 43 2c 20 70 50 61 67 65 72 2d  _MALLOC, pPager-
7320: 3e 61 48 61 73 68 21 3d 30 29 3b 0a 20 20 61 48  >aHash!=0);.  aH
7330: 61 73 68 20 3d 20 73 71 6c 69 74 65 33 4d 61 6c  ash = sqlite3Mal
7340: 6c 6f 63 5a 65 72 6f 28 20 73 69 7a 65 6f 66 28  locZero( sizeof(
7350: 61 48 61 73 68 5b 30 5d 29 2a 4e 20 29 3b 0a 20  aHash[0])*N );. 
7360: 20 73 71 6c 69 74 65 33 46 61 75 6c 74 42 65 6e   sqlite3FaultBen
7370: 69 67 6e 28 53 51 4c 49 54 45 5f 46 41 55 4c 54  ign(SQLITE_FAULT
7380: 49 4e 4a 45 43 54 4f 52 5f 4d 41 4c 4c 4f 43 2c  INJECTOR_MALLOC,
7390: 20 30 29 3b 0a 20 20 70 61 67 65 72 45 6e 74 65   0);.  pagerEnte
73a0: 72 28 70 50 61 67 65 72 29 3b 0a 20 20 69 66 28  r(pPager);.  if(
73b0: 20 61 48 61 73 68 3d 3d 30 20 29 7b 0a 20 20 20   aHash==0 ){.   
73c0: 20 2f 2a 20 46 61 69 6c 75 72 65 20 74 6f 20 72   /* Failure to r
73d0: 65 68 61 73 68 20 69 73 20 6e 6f 74 20 61 6e 20  ehash is not an 
73e0: 65 72 72 6f 72 2e 20 20 49 74 20 69 73 20 6f 6e  error.  It is on
73f0: 6c 79 20 61 20 70 65 72 66 6f 72 6d 61 6e 63 65  ly a performance
7400: 20 68 69 74 2e 20 2a 2f 0a 20 20 20 20 72 65 74   hit. */.    ret
7410: 75 72 6e 3b 0a 20 20 7d 0a 20 20 73 71 6c 69 74  urn;.  }.  sqlit
7420: 65 33 5f 66 72 65 65 28 70 50 61 67 65 72 2d 3e  e3_free(pPager->
7430: 61 48 61 73 68 29 3b 0a 20 20 70 50 61 67 65 72  aHash);.  pPager
7440: 2d 3e 6e 48 61 73 68 20 3d 20 4e 3b 0a 20 20 70  ->nHash = N;.  p
7450: 50 61 67 65 72 2d 3e 61 48 61 73 68 20 3d 20 61  Pager->aHash = a
7460: 48 61 73 68 3b 0a 20 20 66 6f 72 28 70 50 67 3d  Hash;.  for(pPg=
7470: 70 50 61 67 65 72 2d 3e 70 41 6c 6c 3b 20 70 50  pPager->pAll; pP
7480: 67 3b 20 70 50 67 3d 70 50 67 2d 3e 70 4e 65 78  g; pPg=pPg->pNex
7490: 74 41 6c 6c 29 7b 0a 20 20 20 20 69 6e 74 20 68  tAll){.    int h
74a0: 3b 0a 20 20 20 20 69 66 28 20 70 50 67 2d 3e 70  ;.    if( pPg->p
74b0: 67 6e 6f 3d 3d 30 20 29 7b 0a 20 20 20 20 20 20  gno==0 ){.      
74c0: 61 73 73 65 72 74 28 20 70 50 67 2d 3e 70 4e 65  assert( pPg->pNe
74d0: 78 74 48 61 73 68 3d 3d 30 20 26 26 20 70 50 67  xtHash==0 && pPg
74e0: 2d 3e 70 50 72 65 76 48 61 73 68 3d 3d 30 20 29  ->pPrevHash==0 )
74f0: 3b 0a 20 20 20 20 20 20 63 6f 6e 74 69 6e 75 65  ;.      continue
7500: 3b 0a 20 20 20 20 7d 0a 20 20 20 20 68 20 3d 20  ;.    }.    h = 
7510: 70 50 67 2d 3e 70 67 6e 6f 20 26 20 28 4e 2d 31  pPg->pgno & (N-1
7520: 29 3b 0a 20 20 20 20 70 50 67 2d 3e 70 4e 65 78  );.    pPg->pNex
7530: 74 48 61 73 68 20 3d 20 61 48 61 73 68 5b 68 5d  tHash = aHash[h]
7540: 3b 0a 20 20 20 20 69 66 28 20 61 48 61 73 68 5b  ;.    if( aHash[
7550: 68 5d 20 29 7b 0a 20 20 20 20 20 20 61 48 61 73  h] ){.      aHas
7560: 68 5b 68 5d 2d 3e 70 50 72 65 76 48 61 73 68 20  h[h]->pPrevHash 
7570: 3d 20 70 50 67 3b 0a 20 20 20 20 7d 0a 20 20 20  = pPg;.    }.   
7580: 20 61 48 61 73 68 5b 68 5d 20 3d 20 70 50 67 3b   aHash[h] = pPg;
7590: 0a 20 20 20 20 70 50 67 2d 3e 70 50 72 65 76 48  .    pPg->pPrevH
75a0: 61 73 68 20 3d 20 30 3b 0a 20 20 7d 0a 7d 0a 0a  ash = 0;.  }.}..
75b0: 2f 2a 0a 2a 2a 20 52 65 61 64 20 61 20 33 32 2d  /*.** Read a 32-
75c0: 62 69 74 20 69 6e 74 65 67 65 72 20 66 72 6f 6d  bit integer from
75d0: 20 74 68 65 20 67 69 76 65 6e 20 66 69 6c 65 20   the given file 
75e0: 64 65 73 63 72 69 70 74 6f 72 2e 20 20 53 74 6f  descriptor.  Sto
75f0: 72 65 20 74 68 65 20 69 6e 74 65 67 65 72 0a 2a  re the integer.*
7600: 2a 20 74 68 61 74 20 69 73 20 72 65 61 64 20 69  * that is read i
7610: 6e 20 2a 70 52 65 73 2e 20 20 52 65 74 75 72 6e  n *pRes.  Return
7620: 20 53 51 4c 49 54 45 5f 4f 4b 20 69 66 20 65 76   SQLITE_OK if ev
7630: 65 72 79 74 68 69 6e 67 20 77 6f 72 6b 65 64 2c  erything worked,
7640: 20 6f 72 20 61 6e 0a 2a 2a 20 65 72 72 6f 72 20   or an.** error 
7650: 63 6f 64 65 20 69 73 20 73 6f 6d 65 74 68 69 6e  code is somethin
7660: 67 20 67 6f 65 73 20 77 72 6f 6e 67 2e 0a 2a 2a  g goes wrong..**
7670: 0a 2a 2a 20 41 6c 6c 20 76 61 6c 75 65 73 20 61  .** All values a
7680: 72 65 20 73 74 6f 72 65 64 20 6f 6e 20 64 69 73  re stored on dis
7690: 6b 20 61 73 20 62 69 67 2d 65 6e 64 69 61 6e 2e  k as big-endian.
76a0: 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74 20 72  .*/.static int r
76b0: 65 61 64 33 32 62 69 74 73 28 73 71 6c 69 74 65  ead32bits(sqlite
76c0: 33 5f 66 69 6c 65 20 2a 66 64 2c 20 69 36 34 20  3_file *fd, i64 
76d0: 6f 66 66 73 65 74 2c 20 75 33 32 20 2a 70 52 65  offset, u32 *pRe
76e0: 73 29 7b 0a 20 20 75 6e 73 69 67 6e 65 64 20 63  s){.  unsigned c
76f0: 68 61 72 20 61 63 5b 34 5d 3b 0a 20 20 69 6e 74  har ac[4];.  int
7700: 20 72 63 20 3d 20 73 71 6c 69 74 65 33 4f 73 52   rc = sqlite3OsR
7710: 65 61 64 28 66 64 2c 20 61 63 2c 20 73 69 7a 65  ead(fd, ac, size
7720: 6f 66 28 61 63 29 2c 20 6f 66 66 73 65 74 29 3b  of(ac), offset);
7730: 0a 20 20 69 66 28 20 72 63 3d 3d 53 51 4c 49 54  .  if( rc==SQLIT
7740: 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 2a 70 52 65  E_OK ){.    *pRe
7750: 73 20 3d 20 73 71 6c 69 74 65 33 47 65 74 34 62  s = sqlite3Get4b
7760: 79 74 65 28 61 63 29 3b 0a 20 20 7d 0a 20 20 72  yte(ac);.  }.  r
7770: 65 74 75 72 6e 20 72 63 3b 0a 7d 0a 0a 2f 2a 0a  eturn rc;.}../*.
7780: 2a 2a 20 57 72 69 74 65 20 61 20 33 32 2d 62 69  ** Write a 32-bi
7790: 74 20 69 6e 74 65 67 65 72 20 69 6e 74 6f 20 61  t integer into a
77a0: 20 73 74 72 69 6e 67 20 62 75 66 66 65 72 20 69   string buffer i
77b0: 6e 20 62 69 67 2d 65 6e 64 69 61 6e 20 62 79 74  n big-endian byt
77c0: 65 20 6f 72 64 65 72 2e 0a 2a 2f 0a 23 64 65 66  e order..*/.#def
77d0: 69 6e 65 20 70 75 74 33 32 62 69 74 73 28 41 2c  ine put32bits(A,
77e0: 42 29 20 20 73 71 6c 69 74 65 33 50 75 74 34 62  B)  sqlite3Put4b
77f0: 79 74 65 28 28 75 38 2a 29 41 2c 42 29 0a 0a 2f  yte((u8*)A,B)../
7800: 2a 0a 2a 2a 20 57 72 69 74 65 20 61 20 33 32 2d  *.** Write a 32-
7810: 62 69 74 20 69 6e 74 65 67 65 72 20 69 6e 74 6f  bit integer into
7820: 20 74 68 65 20 67 69 76 65 6e 20 66 69 6c 65 20   the given file 
7830: 64 65 73 63 72 69 70 74 6f 72 2e 20 20 52 65 74  descriptor.  Ret
7840: 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 0a 2a 2a  urn SQLITE_OK.**
7850: 20 6f 6e 20 73 75 63 63 65 73 73 20 6f 72 20 61   on success or a
7860: 6e 20 65 72 72 6f 72 20 63 6f 64 65 20 69 73 20  n error code is 
7870: 73 6f 6d 65 74 68 69 6e 67 20 67 6f 65 73 20 77  something goes w
7880: 72 6f 6e 67 2e 0a 2a 2f 0a 73 74 61 74 69 63 20  rong..*/.static 
7890: 69 6e 74 20 77 72 69 74 65 33 32 62 69 74 73 28  int write32bits(
78a0: 73 71 6c 69 74 65 33 5f 66 69 6c 65 20 2a 66 64  sqlite3_file *fd
78b0: 2c 20 69 36 34 20 6f 66 66 73 65 74 2c 20 75 33  , i64 offset, u3
78c0: 32 20 76 61 6c 29 7b 0a 20 20 63 68 61 72 20 61  2 val){.  char a
78d0: 63 5b 34 5d 3b 0a 20 20 70 75 74 33 32 62 69 74  c[4];.  put32bit
78e0: 73 28 61 63 2c 20 76 61 6c 29 3b 0a 20 20 72 65  s(ac, val);.  re
78f0: 74 75 72 6e 20 73 71 6c 69 74 65 33 4f 73 57 72  turn sqlite3OsWr
7900: 69 74 65 28 66 64 2c 20 61 63 2c 20 34 2c 20 6f  ite(fd, ac, 4, o
7910: 66 66 73 65 74 29 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a  ffset);.}../*.**
7920: 20 49 66 20 66 69 6c 65 20 70 46 64 20 69 73 20   If file pFd is 
7930: 6f 70 65 6e 2c 20 63 61 6c 6c 20 73 71 6c 69 74  open, call sqlit
7940: 65 33 4f 73 55 6e 6c 6f 63 6b 28 29 20 6f 6e 20  e3OsUnlock() on 
7950: 69 74 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e  it..*/.static in
7960: 74 20 6f 73 55 6e 6c 6f 63 6b 28 73 71 6c 69 74  t osUnlock(sqlit
7970: 65 33 5f 66 69 6c 65 20 2a 70 46 64 2c 20 69 6e  e3_file *pFd, in
7980: 74 20 65 4c 6f 63 6b 29 7b 0a 20 20 69 66 28 20  t eLock){.  if( 
7990: 21 70 46 64 2d 3e 70 4d 65 74 68 6f 64 73 20 29  !pFd->pMethods )
79a0: 7b 0a 20 20 20 20 72 65 74 75 72 6e 20 53 51 4c  {.    return SQL
79b0: 49 54 45 5f 4f 4b 3b 0a 20 20 7d 0a 20 20 72 65  ITE_OK;.  }.  re
79c0: 74 75 72 6e 20 73 71 6c 69 74 65 33 4f 73 55 6e  turn sqlite3OsUn
79d0: 6c 6f 63 6b 28 70 46 64 2c 20 65 4c 6f 63 6b 29  lock(pFd, eLock)
79e0: 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 54 68 69 73 20  ;.}../*.** This 
79f0: 66 75 6e 63 74 69 6f 6e 20 64 65 74 65 72 6d 69  function determi
7a00: 6e 65 73 20 77 68 65 74 68 65 72 20 6f 72 20 6e  nes whether or n
7a10: 6f 74 20 74 68 65 20 61 74 6f 6d 69 63 2d 77 72  ot the atomic-wr
7a20: 69 74 65 20 6f 70 74 69 6d 69 7a 61 74 69 6f 6e  ite optimization
7a30: 0a 2a 2a 20 63 61 6e 20 62 65 20 75 73 65 64 20  .** can be used 
7a40: 77 69 74 68 20 74 68 69 73 20 70 61 67 65 72 2e  with this pager.
7a50: 20 54 68 65 20 6f 70 74 69 6d 69 7a 61 74 69 6f   The optimizatio
7a60: 6e 20 63 61 6e 20 62 65 20 75 73 65 64 20 69 66  n can be used if
7a70: 3a 0a 2a 2a 0a 2a 2a 20 20 28 61 29 20 74 68 65  :.**.**  (a) the
7a80: 20 76 61 6c 75 65 20 72 65 74 75 72 6e 65 64 20   value returned 
7a90: 62 79 20 4f 73 44 65 76 69 63 65 43 68 61 72 61  by OsDeviceChara
7aa0: 63 74 65 72 69 73 74 69 63 73 28 29 20 69 6e 64  cteristics() ind
7ab0: 69 63 61 74 65 73 20 74 68 61 74 0a 2a 2a 20 20  icates that.**  
7ac0: 20 20 20 20 61 20 64 61 74 61 62 61 73 65 20 70      a database p
7ad0: 61 67 65 20 6d 61 79 20 62 65 20 77 72 69 74 74  age may be writt
7ae0: 65 6e 20 61 74 6f 6d 69 63 61 6c 6c 79 2c 20 61  en atomically, a
7af0: 6e 64 0a 2a 2a 20 20 28 62 29 20 74 68 65 20 76  nd.**  (b) the v
7b00: 61 6c 75 65 20 72 65 74 75 72 6e 65 64 20 62 79  alue returned by
7b10: 20 4f 73 53 65 63 74 6f 72 53 69 7a 65 28 29 20   OsSectorSize() 
7b20: 69 73 20 6c 65 73 73 20 74 68 61 6e 20 6f 72 20  is less than or 
7b30: 65 71 75 61 6c 0a 2a 2a 20 20 20 20 20 20 74 6f  equal.**      to
7b40: 20 74 68 65 20 70 61 67 65 20 73 69 7a 65 2e 0a   the page size..
7b50: 2a 2a 0a 2a 2a 20 49 66 20 74 68 65 20 6f 70 74  **.** If the opt
7b60: 69 6d 69 7a 61 74 69 6f 6e 20 63 61 6e 6e 6f 74  imization cannot
7b70: 20 62 65 20 75 73 65 64 2c 20 30 20 69 73 20 72   be used, 0 is r
7b80: 65 74 75 72 6e 65 64 2e 20 49 66 20 69 74 20 63  eturned. If it c
7b90: 61 6e 20 62 65 20 75 73 65 64 2c 0a 2a 2a 20 74  an be used,.** t
7ba0: 68 65 6e 20 74 68 65 20 76 61 6c 75 65 20 72 65  hen the value re
7bb0: 74 75 72 6e 65 64 20 69 73 20 74 68 65 20 73 69  turned is the si
7bc0: 7a 65 20 6f 66 20 74 68 65 20 6a 6f 75 72 6e 61  ze of the journa
7bd0: 6c 20 66 69 6c 65 20 77 68 65 6e 20 69 74 0a 2a  l file when it.*
7be0: 2a 20 63 6f 6e 74 61 69 6e 73 20 72 6f 6c 6c 62  * contains rollb
7bf0: 61 63 6b 20 64 61 74 61 20 66 6f 72 20 65 78 61  ack data for exa
7c00: 63 74 6c 79 20 6f 6e 65 20 70 61 67 65 2e 0a 2a  ctly one page..*
7c10: 2f 0a 23 69 66 64 65 66 20 53 51 4c 49 54 45 5f  /.#ifdef SQLITE_
7c20: 45 4e 41 42 4c 45 5f 41 54 4f 4d 49 43 5f 57 52  ENABLE_ATOMIC_WR
7c30: 49 54 45 0a 73 74 61 74 69 63 20 69 6e 74 20 6a  ITE.static int j
7c40: 72 6e 6c 42 75 66 66 65 72 53 69 7a 65 28 50 61  rnlBufferSize(Pa
7c50: 67 65 72 20 2a 70 50 61 67 65 72 29 7b 0a 20 20  ger *pPager){.  
7c60: 69 6e 74 20 64 63 3b 20 20 20 20 20 20 20 20 20  int dc;         
7c70: 20 20 2f 2a 20 44 65 76 69 63 65 20 63 68 61 72    /* Device char
7c80: 61 63 74 65 72 69 73 74 69 63 73 20 2a 2f 0a 20  acteristics */. 
7c90: 20 69 6e 74 20 6e 53 65 63 74 6f 72 3b 20 20 20   int nSector;   
7ca0: 20 20 20 2f 2a 20 53 65 63 74 6f 72 20 73 69 7a     /* Sector siz
7cb0: 65 20 2a 2f 0a 20 20 69 6e 74 20 6e 50 61 67 65  e */.  int nPage
7cc0: 3b 20 20 20 20 20 20 20 20 2f 2a 20 50 61 67 65  ;        /* Page
7cd0: 20 73 69 7a 65 20 2a 2f 0a 20 20 73 71 6c 69 74   size */.  sqlit
7ce0: 65 33 5f 66 69 6c 65 20 2a 66 64 20 3d 20 70 50  e3_file *fd = pP
7cf0: 61 67 65 72 2d 3e 66 64 3b 0a 0a 20 20 69 66 28  ager->fd;..  if(
7d00: 20 66 64 2d 3e 70 4d 65 74 68 6f 64 73 20 29 7b   fd->pMethods ){
7d10: 0a 20 20 20 20 64 63 20 3d 20 73 71 6c 69 74 65  .    dc = sqlite
7d20: 33 4f 73 44 65 76 69 63 65 43 68 61 72 61 63 74  3OsDeviceCharact
7d30: 65 72 69 73 74 69 63 73 28 66 64 29 3b 0a 20 20  eristics(fd);.  
7d40: 20 20 6e 53 65 63 74 6f 72 20 3d 20 73 71 6c 69    nSector = sqli
7d50: 74 65 33 4f 73 53 65 63 74 6f 72 53 69 7a 65 28  te3OsSectorSize(
7d60: 66 64 29 3b 0a 20 20 20 20 6e 50 61 67 65 20 3d  fd);.    nPage =
7d70: 20 70 50 61 67 65 72 2d 3e 70 61 67 65 53 69 7a   pPager->pageSiz
7d80: 65 3b 0a 20 20 7d 0a 0a 20 20 61 73 73 65 72 74  e;.  }..  assert
7d90: 28 53 51 4c 49 54 45 5f 49 4f 43 41 50 5f 41 54  (SQLITE_IOCAP_AT
7da0: 4f 4d 49 43 35 31 32 3d 3d 28 35 31 32 3e 3e 38  OMIC512==(512>>8
7db0: 29 29 3b 0a 20 20 61 73 73 65 72 74 28 53 51 4c  ));.  assert(SQL
7dc0: 49 54 45 5f 49 4f 43 41 50 5f 41 54 4f 4d 49 43  ITE_IOCAP_ATOMIC
7dd0: 36 34 4b 3d 3d 28 36 35 35 33 36 3e 3e 38 29 29  64K==(65536>>8))
7de0: 3b 0a 0a 20 20 69 66 28 20 21 66 64 2d 3e 70 4d  ;..  if( !fd->pM
7df0: 65 74 68 6f 64 73 20 7c 7c 20 28 64 63 26 28 53  ethods || (dc&(S
7e00: 51 4c 49 54 45 5f 49 4f 43 41 50 5f 41 54 4f 4d  QLITE_IOCAP_ATOM
7e10: 49 43 7c 28 6e 50 61 67 65 3e 3e 38 29 29 26 26  IC|(nPage>>8))&&
7e20: 6e 53 65 63 74 6f 72 3c 3d 6e 50 61 67 65 29 20  nSector<=nPage) 
7e30: 29 7b 0a 20 20 20 20 72 65 74 75 72 6e 20 4a 4f  ){.    return JO
7e40: 55 52 4e 41 4c 5f 48 44 52 5f 53 5a 28 70 50 61  URNAL_HDR_SZ(pPa
7e50: 67 65 72 29 20 2b 20 4a 4f 55 52 4e 41 4c 5f 50  ger) + JOURNAL_P
7e60: 47 5f 53 5a 28 70 50 61 67 65 72 29 3b 0a 20 20  G_SZ(pPager);.  
7e70: 7d 0a 20 20 72 65 74 75 72 6e 20 30 3b 0a 7d 0a  }.  return 0;.}.
7e80: 23 65 6e 64 69 66 0a 0a 2f 2a 0a 2a 2a 20 54 68  #endif../*.** Th
7e90: 69 73 20 66 75 6e 63 74 69 6f 6e 20 73 68 6f 75  is function shou
7ea0: 6c 64 20 62 65 20 63 61 6c 6c 65 64 20 77 68 65  ld be called whe
7eb0: 6e 20 61 6e 20 65 72 72 6f 72 20 6f 63 63 75 72  n an error occur
7ec0: 73 20 77 69 74 68 69 6e 20 74 68 65 20 70 61 67  s within the pag
7ed0: 65 72 0a 2a 2a 20 63 6f 64 65 2e 20 54 68 65 20  er.** code. The 
7ee0: 66 69 72 73 74 20 61 72 67 75 6d 65 6e 74 20 69  first argument i
7ef0: 73 20 61 20 70 6f 69 6e 74 65 72 20 74 6f 20 74  s a pointer to t
7f00: 68 65 20 70 61 67 65 72 20 73 74 72 75 63 74 75  he pager structu
7f10: 72 65 2c 20 74 68 65 0a 2a 2a 20 73 65 63 6f 6e  re, the.** secon
7f20: 64 20 74 68 65 20 65 72 72 6f 72 2d 63 6f 64 65  d the error-code
7f30: 20 61 62 6f 75 74 20 74 6f 20 62 65 20 72 65 74   about to be ret
7f40: 75 72 6e 65 64 20 62 79 20 61 20 70 61 67 65 72  urned by a pager
7f50: 20 41 50 49 20 66 75 6e 63 74 69 6f 6e 2e 20 0a   API function. .
7f60: 2a 2a 20 54 68 65 20 76 61 6c 75 65 20 72 65 74  ** The value ret
7f70: 75 72 6e 65 64 20 69 73 20 61 20 63 6f 70 79 20  urned is a copy 
7f80: 6f 66 20 74 68 65 20 73 65 63 6f 6e 64 20 61 72  of the second ar
7f90: 67 75 6d 65 6e 74 20 74 6f 20 74 68 69 73 20 66  gument to this f
7fa0: 75 6e 63 74 69 6f 6e 2e 20 0a 2a 2a 0a 2a 2a 20  unction. .**.** 
7fb0: 49 66 20 74 68 65 20 73 65 63 6f 6e 64 20 61 72  If the second ar
7fc0: 67 75 6d 65 6e 74 20 69 73 20 53 51 4c 49 54 45  gument is SQLITE
7fd0: 5f 49 4f 45 52 52 2c 20 53 51 4c 49 54 45 5f 43  _IOERR, SQLITE_C
7fe0: 4f 52 52 55 50 54 2c 20 6f 72 20 53 51 4c 49 54  ORRUPT, or SQLIT
7ff0: 45 5f 46 55 4c 4c 0a 2a 2a 20 74 68 65 20 65 72  E_FULL.** the er
8000: 72 6f 72 20 62 65 63 6f 6d 65 73 20 70 65 72 73  ror becomes pers
8010: 69 73 74 65 6e 74 2e 20 55 6e 74 69 6c 20 74 68  istent. Until th
8020: 65 20 70 65 72 73 69 73 74 65 6e 20 65 72 72 6f  e persisten erro
8030: 72 20 69 73 20 63 6c 65 61 72 65 64 2c 0a 2a 2a  r is cleared,.**
8040: 20 73 75 62 73 65 71 75 65 6e 74 20 41 50 49 20   subsequent API 
8050: 63 61 6c 6c 73 20 6f 6e 20 74 68 69 73 20 50 61  calls on this Pa
8060: 67 65 72 20 77 69 6c 6c 20 69 6d 6d 65 64 69 61  ger will immedia
8070: 74 65 6c 79 20 72 65 74 75 72 6e 20 74 68 65 20  tely return the 
8080: 73 61 6d 65 20 0a 2a 2a 20 65 72 72 6f 72 20 63  same .** error c
8090: 6f 64 65 2e 0a 2a 2a 0a 2a 2a 20 41 20 70 65 72  ode..**.** A per
80a0: 73 69 73 74 65 6e 74 20 65 72 72 6f 72 20 69 6e  sistent error in
80b0: 64 69 63 61 74 65 73 20 74 68 61 74 20 74 68 65  dicates that the
80c0: 20 63 6f 6e 74 65 6e 74 73 20 6f 66 20 74 68 65   contents of the
80d0: 20 70 61 67 65 72 2d 63 61 63 68 65 20 0a 2a 2a   pager-cache .**
80e0: 20 63 61 6e 6e 6f 74 20 62 65 20 74 72 75 73 74   cannot be trust
80f0: 65 64 2e 20 54 68 69 73 20 73 74 61 74 65 20 63  ed. This state c
8100: 61 6e 20 62 65 20 63 6c 65 61 72 65 64 20 62 79  an be cleared by
8110: 20 63 6f 6d 70 6c 65 74 65 6c 79 20 64 69 73 63   completely disc
8120: 61 72 64 69 6e 67 20 0a 2a 2a 20 74 68 65 20 63  arding .** the c
8130: 6f 6e 74 65 6e 74 73 20 6f 66 20 74 68 65 20 70  ontents of the p
8140: 61 67 65 72 2d 63 61 63 68 65 2e 20 49 66 20 61  ager-cache. If a
8150: 20 74 72 61 6e 73 61 63 74 69 6f 6e 20 77 61 73   transaction was
8160: 20 61 63 74 69 76 65 20 77 68 65 6e 0a 2a 2a 20   active when.** 
8170: 74 68 65 20 70 65 72 73 69 73 74 65 6e 74 20 65  the persistent e
8180: 72 72 6f 72 20 6f 63 63 75 72 65 64 2c 20 74 68  rror occured, th
8190: 65 6e 20 74 68 65 20 72 6f 6c 6c 62 61 63 6b 20  en the rollback 
81a0: 6a 6f 75 72 6e 61 6c 20 6d 61 79 20 6e 65 65 64  journal may need
81b0: 0a 2a 2a 20 74 6f 20 62 65 20 72 65 70 6c 61 79  .** to be replay
81c0: 65 64 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 76 6f  ed..*/.static vo
81d0: 69 64 20 70 61 67 65 72 5f 75 6e 6c 6f 63 6b 28  id pager_unlock(
81e0: 50 61 67 65 72 20 2a 70 50 61 67 65 72 29 3b 0a  Pager *pPager);.
81f0: 73 74 61 74 69 63 20 69 6e 74 20 70 61 67 65 72  static int pager
8200: 5f 65 72 72 6f 72 28 50 61 67 65 72 20 2a 70 50  _error(Pager *pP
8210: 61 67 65 72 2c 20 69 6e 74 20 72 63 29 7b 0a 20  ager, int rc){. 
8220: 20 69 6e 74 20 72 63 32 20 3d 20 72 63 20 26 20   int rc2 = rc & 
8230: 30 78 66 66 3b 0a 20 20 61 73 73 65 72 74 28 0a  0xff;.  assert(.
8240: 20 20 20 20 20 20 20 70 50 61 67 65 72 2d 3e 65         pPager->e
8250: 72 72 43 6f 64 65 3d 3d 53 51 4c 49 54 45 5f 46  rrCode==SQLITE_F
8260: 55 4c 4c 20 7c 7c 0a 20 20 20 20 20 20 20 70 50  ULL ||.       pP
8270: 61 67 65 72 2d 3e 65 72 72 43 6f 64 65 3d 3d 53  ager->errCode==S
8280: 51 4c 49 54 45 5f 4f 4b 20 7c 7c 0a 20 20 20 20  QLITE_OK ||.    
8290: 20 20 20 28 70 50 61 67 65 72 2d 3e 65 72 72 43     (pPager->errC
82a0: 6f 64 65 20 26 20 30 78 66 66 29 3d 3d 53 51 4c  ode & 0xff)==SQL
82b0: 49 54 45 5f 49 4f 45 52 52 0a 20 20 29 3b 0a 20  ITE_IOERR.  );. 
82c0: 20 69 66 28 0a 20 20 20 20 72 63 32 3d 3d 53 51   if(.    rc2==SQ
82d0: 4c 49 54 45 5f 46 55 4c 4c 20 7c 7c 0a 20 20 20  LITE_FULL ||.   
82e0: 20 72 63 32 3d 3d 53 51 4c 49 54 45 5f 49 4f 45   rc2==SQLITE_IOE
82f0: 52 52 20 7c 7c 0a 20 20 20 20 72 63 32 3d 3d 53  RR ||.    rc2==S
8300: 51 4c 49 54 45 5f 43 4f 52 52 55 50 54 0a 20 20  QLITE_CORRUPT.  
8310: 29 7b 0a 20 20 20 20 70 50 61 67 65 72 2d 3e 65  ){.    pPager->e
8320: 72 72 43 6f 64 65 20 3d 20 72 63 3b 0a 20 20 20  rrCode = rc;.   
8330: 20 69 66 28 20 70 50 61 67 65 72 2d 3e 73 74 61   if( pPager->sta
8340: 74 65 3d 3d 50 41 47 45 52 5f 55 4e 4c 4f 43 4b  te==PAGER_UNLOCK
8350: 20 26 26 20 70 50 61 67 65 72 2d 3e 6e 52 65 66   && pPager->nRef
8360: 3d 3d 30 20 29 7b 0a 20 20 20 20 20 20 2f 2a 20  ==0 ){.      /* 
8370: 49 66 20 74 68 65 20 70 61 67 65 72 20 69 73 20  If the pager is 
8380: 61 6c 72 65 61 64 79 20 75 6e 6c 6f 63 6b 65 64  already unlocked
8390: 2c 20 63 61 6c 6c 20 70 61 67 65 72 5f 75 6e 6c  , call pager_unl
83a0: 6f 63 6b 28 29 20 6e 6f 77 20 74 6f 0a 20 20 20  ock() now to.   
83b0: 20 20 20 2a 2a 20 63 6c 65 61 72 20 74 68 65 20     ** clear the 
83c0: 65 72 72 6f 72 20 73 74 61 74 65 20 61 6e 64 20  error state and 
83d0: 65 6e 73 75 72 65 20 74 68 61 74 20 74 68 65 20  ensure that the 
83e0: 70 61 67 65 72 2d 63 61 63 68 65 20 69 73 20 0a  pager-cache is .
83f0: 20 20 20 20 20 20 2a 2a 20 63 6f 6d 70 6c 65 74        ** complet
8400: 65 6c 79 20 65 6d 70 74 79 2e 0a 20 20 20 20 20  ely empty..     
8410: 20 2a 2f 0a 20 20 20 20 20 20 70 61 67 65 72 5f   */.      pager_
8420: 75 6e 6c 6f 63 6b 28 70 50 61 67 65 72 29 3b 0a  unlock(pPager);.
8430: 20 20 20 20 7d 0a 20 20 7d 0a 20 20 72 65 74 75      }.  }.  retu
8440: 72 6e 20 72 63 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20  rn rc;.}../*.** 
8450: 49 66 20 53 51 4c 49 54 45 5f 43 48 45 43 4b 5f  If SQLITE_CHECK_
8460: 50 41 47 45 53 20 69 73 20 64 65 66 69 6e 65 64  PAGES is defined
8470: 20 74 68 65 6e 20 77 65 20 64 6f 20 73 6f 6d 65   then we do some
8480: 20 73 61 6e 69 74 79 20 63 68 65 63 6b 69 6e 67   sanity checking
8490: 0a 2a 2a 20 6f 6e 20 74 68 65 20 63 61 63 68 65  .** on the cache
84a0: 20 75 73 69 6e 67 20 61 20 68 61 73 68 20 66 75   using a hash fu
84b0: 6e 63 74 69 6f 6e 2e 20 20 54 68 69 73 20 69 73  nction.  This is
84c0: 20 75 73 65 64 20 66 6f 72 20 74 65 73 74 69 6e   used for testin
84d0: 67 0a 2a 2a 20 61 6e 64 20 64 65 62 75 67 67 69  g.** and debuggi
84e0: 6e 67 20 6f 6e 6c 79 2e 0a 2a 2f 0a 23 69 66 64  ng only..*/.#ifd
84f0: 65 66 20 53 51 4c 49 54 45 5f 43 48 45 43 4b 5f  ef SQLITE_CHECK_
8500: 50 41 47 45 53 0a 2f 2a 0a 2a 2a 20 52 65 74 75  PAGES./*.** Retu
8510: 72 6e 20 61 20 33 32 2d 62 69 74 20 68 61 73 68  rn a 32-bit hash
8520: 20 6f 66 20 74 68 65 20 70 61 67 65 20 64 61 74   of the page dat
8530: 61 20 66 6f 72 20 70 50 61 67 65 2e 0a 2a 2f 0a  a for pPage..*/.
8540: 73 74 61 74 69 63 20 75 33 32 20 70 61 67 65 72  static u32 pager
8550: 5f 64 61 74 61 68 61 73 68 28 69 6e 74 20 6e 42  _datahash(int nB
8560: 79 74 65 2c 20 75 6e 73 69 67 6e 65 64 20 63 68  yte, unsigned ch
8570: 61 72 20 2a 70 44 61 74 61 29 7b 0a 20 20 75 33  ar *pData){.  u3
8580: 32 20 68 61 73 68 20 3d 20 30 3b 0a 20 20 69 6e  2 hash = 0;.  in
8590: 74 20 69 3b 0a 20 20 66 6f 72 28 69 3d 30 3b 20  t i;.  for(i=0; 
85a0: 69 3c 6e 42 79 74 65 3b 20 69 2b 2b 29 7b 0a 20  i<nByte; i++){. 
85b0: 20 20 20 68 61 73 68 20 3d 20 28 68 61 73 68 2a     hash = (hash*
85c0: 31 30 33 39 29 20 2b 20 70 44 61 74 61 5b 69 5d  1039) + pData[i]
85d0: 3b 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e 20 68  ;.  }.  return h
85e0: 61 73 68 3b 0a 7d 0a 73 74 61 74 69 63 20 75 33  ash;.}.static u3
85f0: 32 20 70 61 67 65 72 5f 70 61 67 65 68 61 73 68  2 pager_pagehash
8600: 28 50 67 48 64 72 20 2a 70 50 61 67 65 29 7b 0a  (PgHdr *pPage){.
8610: 20 20 72 65 74 75 72 6e 20 70 61 67 65 72 5f 64    return pager_d
8620: 61 74 61 68 61 73 68 28 70 50 61 67 65 2d 3e 70  atahash(pPage->p
8630: 50 61 67 65 72 2d 3e 70 61 67 65 53 69 7a 65 2c  Pager->pageSize,
8640: 20 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20   .              
8650: 20 20 20 20 20 20 20 20 20 20 28 75 6e 73 69 67            (unsig
8660: 6e 65 64 20 63 68 61 72 20 2a 29 50 47 48 44 52  ned char *)PGHDR
8670: 5f 54 4f 5f 44 41 54 41 28 70 50 61 67 65 29 29  _TO_DATA(pPage))
8680: 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 54 68 65 20 43  ;.}../*.** The C
8690: 48 45 43 4b 5f 50 41 47 45 20 6d 61 63 72 6f 20  HECK_PAGE macro 
86a0: 74 61 6b 65 73 20 61 20 50 67 48 64 72 2a 20 61  takes a PgHdr* a
86b0: 73 20 61 6e 20 61 72 67 75 6d 65 6e 74 2e 20 49  s an argument. I
86c0: 66 20 53 51 4c 49 54 45 5f 43 48 45 43 4b 5f 50  f SQLITE_CHECK_P
86d0: 41 47 45 53 0a 2a 2a 20 69 73 20 64 65 66 69 6e  AGES.** is defin
86e0: 65 64 2c 20 61 6e 64 20 4e 44 45 42 55 47 20 69  ed, and NDEBUG i
86f0: 73 20 6e 6f 74 20 64 65 66 69 6e 65 64 2c 20 61  s not defined, a
8700: 6e 20 61 73 73 65 72 74 28 29 20 73 74 61 74 65  n assert() state
8710: 6d 65 6e 74 20 63 68 65 63 6b 73 0a 2a 2a 20 74  ment checks.** t
8720: 68 61 74 20 74 68 65 20 70 61 67 65 20 69 73 20  hat the page is 
8730: 65 69 74 68 65 72 20 64 69 72 74 79 20 6f 72 20  either dirty or 
8740: 73 74 69 6c 6c 20 6d 61 74 63 68 65 73 20 74 68  still matches th
8750: 65 20 63 61 6c 63 75 6c 61 74 65 64 20 70 61 67  e calculated pag
8760: 65 2d 68 61 73 68 2e 0a 2a 2f 0a 23 64 65 66 69  e-hash..*/.#defi
8770: 6e 65 20 43 48 45 43 4b 5f 50 41 47 45 28 78 29  ne CHECK_PAGE(x)
8780: 20 63 68 65 63 6b 50 61 67 65 28 78 29 0a 73 74   checkPage(x).st
8790: 61 74 69 63 20 76 6f 69 64 20 63 68 65 63 6b 50  atic void checkP
87a0: 61 67 65 28 50 67 48 64 72 20 2a 70 50 67 29 7b  age(PgHdr *pPg){
87b0: 0a 20 20 50 61 67 65 72 20 2a 70 50 61 67 65 72  .  Pager *pPager
87c0: 20 3d 20 70 50 67 2d 3e 70 50 61 67 65 72 3b 0a   = pPg->pPager;.
87d0: 20 20 61 73 73 65 72 74 28 20 21 70 50 67 2d 3e    assert( !pPg->
87e0: 70 61 67 65 48 61 73 68 20 7c 7c 20 70 50 61 67  pageHash || pPag
87f0: 65 72 2d 3e 65 72 72 43 6f 64 65 20 7c 7c 20 4d  er->errCode || M
8800: 45 4d 44 42 20 7c 7c 20 70 50 67 2d 3e 64 69 72  EMDB || pPg->dir
8810: 74 79 20 7c 7c 20 0a 20 20 20 20 20 20 70 50 67  ty || .      pPg
8820: 2d 3e 70 61 67 65 48 61 73 68 3d 3d 70 61 67 65  ->pageHash==page
8830: 72 5f 70 61 67 65 68 61 73 68 28 70 50 67 29 20  r_pagehash(pPg) 
8840: 29 3b 0a 7d 0a 0a 23 65 6c 73 65 0a 23 64 65 66  );.}..#else.#def
8850: 69 6e 65 20 70 61 67 65 72 5f 64 61 74 61 68 61  ine pager_dataha
8860: 73 68 28 58 2c 59 29 20 20 30 0a 23 64 65 66 69  sh(X,Y)  0.#defi
8870: 6e 65 20 70 61 67 65 72 5f 70 61 67 65 68 61 73  ne pager_pagehas
8880: 68 28 58 29 20 20 30 0a 23 64 65 66 69 6e 65 20  h(X)  0.#define 
8890: 43 48 45 43 4b 5f 50 41 47 45 28 78 29 0a 23 65  CHECK_PAGE(x).#e
88a0: 6e 64 69 66 0a 0a 2f 2a 0a 2a 2a 20 57 68 65 6e  ndif../*.** When
88b0: 20 74 68 69 73 20 69 73 20 63 61 6c 6c 65 64 20   this is called 
88c0: 74 68 65 20 6a 6f 75 72 6e 61 6c 20 66 69 6c 65  the journal file
88d0: 20 66 6f 72 20 70 61 67 65 72 20 70 50 61 67 65   for pager pPage
88e0: 72 20 6d 75 73 74 20 62 65 20 6f 70 65 6e 2e 0a  r must be open..
88f0: 2a 2a 20 54 68 65 20 6d 61 73 74 65 72 20 6a 6f  ** The master jo
8900: 75 72 6e 61 6c 20 66 69 6c 65 20 6e 61 6d 65 20  urnal file name 
8910: 69 73 20 72 65 61 64 20 66 72 6f 6d 20 74 68 65  is read from the
8920: 20 65 6e 64 20 6f 66 20 74 68 65 20 66 69 6c 65   end of the file
8930: 20 61 6e 64 20 0a 2a 2a 20 77 72 69 74 74 65 6e   and .** written
8940: 20 69 6e 74 6f 20 6d 65 6d 6f 72 79 20 73 75 70   into memory sup
8950: 70 6c 69 65 64 20 62 79 20 74 68 65 20 63 61 6c  plied by the cal
8960: 6c 65 72 2e 20 0a 2a 2a 0a 2a 2a 20 7a 4d 61 73  ler. .**.** zMas
8970: 74 65 72 20 6d 75 73 74 20 70 6f 69 6e 74 20 74  ter must point t
8980: 6f 20 61 20 62 75 66 66 65 72 20 6f 66 20 61 74  o a buffer of at
8990: 20 6c 65 61 73 74 20 6e 4d 61 73 74 65 72 20 62   least nMaster b
89a0: 79 74 65 73 20 61 6c 6c 6f 63 61 74 65 64 20 62  ytes allocated b
89b0: 79 0a 2a 2a 20 74 68 65 20 63 61 6c 6c 65 72 2e  y.** the caller.
89c0: 20 54 68 69 73 20 73 68 6f 75 6c 64 20 62 65 20   This should be 
89d0: 73 71 6c 69 74 65 33 5f 76 66 73 2e 6d 78 50 61  sqlite3_vfs.mxPa
89e0: 74 68 6e 61 6d 65 2b 31 20 28 74 6f 20 65 6e 73  thname+1 (to ens
89f0: 75 72 65 20 74 68 65 72 65 20 69 73 0a 2a 2a 20  ure there is.** 
8a00: 65 6e 6f 75 67 68 20 73 70 61 63 65 20 74 6f 20  enough space to 
8a10: 77 72 69 74 65 20 74 68 65 20 6d 61 73 74 65 72  write the master
8a20: 20 6a 6f 75 72 6e 61 6c 20 6e 61 6d 65 29 2e 20   journal name). 
8a30: 49 66 20 74 68 65 20 6d 61 73 74 65 72 20 6a 6f  If the master jo
8a40: 75 72 6e 61 6c 0a 2a 2a 20 6e 61 6d 65 20 69 6e  urnal.** name in
8a50: 20 74 68 65 20 6a 6f 75 72 6e 61 6c 20 69 73 20   the journal is 
8a60: 6c 6f 6e 67 65 72 20 74 68 61 6e 20 6e 4d 61 73  longer than nMas
8a70: 74 65 72 20 62 79 74 65 73 20 28 69 6e 63 6c 75  ter bytes (inclu
8a80: 64 69 6e 67 20 61 0a 2a 2a 20 6e 75 6c 2d 74 65  ding a.** nul-te
8a90: 72 6d 69 6e 61 74 6f 72 29 2c 20 74 68 65 6e 20  rminator), then 
8aa0: 74 68 69 73 20 69 73 20 68 61 6e 64 6c 65 64 20  this is handled 
8ab0: 61 73 20 69 66 20 6e 6f 20 6d 61 73 74 65 72 20  as if no master 
8ac0: 6a 6f 75 72 6e 61 6c 20 6e 61 6d 65 0a 2a 2a 20  journal name.** 
8ad0: 77 65 72 65 20 70 72 65 73 65 6e 74 20 69 6e 20  were present in 
8ae0: 74 68 65 20 6a 6f 75 72 6e 61 6c 2e 0a 2a 2a 0a  the journal..**.
8af0: 2a 2a 20 49 66 20 6e 6f 20 6d 61 73 74 65 72 20  ** If no master 
8b00: 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 20 6e 61 6d  journal file nam
8b10: 65 20 69 73 20 70 72 65 73 65 6e 74 20 7a 4d 61  e is present zMa
8b20: 73 74 65 72 5b 30 5d 20 69 73 20 73 65 74 20 74  ster[0] is set t
8b30: 6f 20 30 20 61 6e 64 0a 2a 2a 20 53 51 4c 49 54  o 0 and.** SQLIT
8b40: 45 5f 4f 4b 20 72 65 74 75 72 6e 65 64 2e 0a 2a  E_OK returned..*
8b50: 2f 0a 73 74 61 74 69 63 20 69 6e 74 20 72 65 61  /.static int rea
8b60: 64 4d 61 73 74 65 72 4a 6f 75 72 6e 61 6c 28 73  dMasterJournal(s
8b70: 71 6c 69 74 65 33 5f 66 69 6c 65 20 2a 70 4a 72  qlite3_file *pJr
8b80: 6e 6c 2c 20 63 68 61 72 20 2a 7a 4d 61 73 74 65  nl, char *zMaste
8b90: 72 2c 20 69 6e 74 20 6e 4d 61 73 74 65 72 29 7b  r, int nMaster){
8ba0: 0a 20 20 69 6e 74 20 72 63 3b 0a 20 20 75 33 32  .  int rc;.  u32
8bb0: 20 6c 65 6e 3b 0a 20 20 69 36 34 20 73 7a 4a 3b   len;.  i64 szJ;
8bc0: 0a 20 20 75 33 32 20 63 6b 73 75 6d 3b 0a 20 20  .  u32 cksum;.  
8bd0: 69 6e 74 20 69 3b 0a 20 20 75 6e 73 69 67 6e 65  int i;.  unsigne
8be0: 64 20 63 68 61 72 20 61 4d 61 67 69 63 5b 38 5d  d char aMagic[8]
8bf0: 3b 20 2f 2a 20 41 20 62 75 66 66 65 72 20 74 6f  ; /* A buffer to
8c00: 20 68 6f 6c 64 20 74 68 65 20 6d 61 67 69 63 20   hold the magic 
8c10: 68 65 61 64 65 72 20 2a 2f 0a 0a 20 20 7a 4d 61  header */..  zMa
8c20: 73 74 65 72 5b 30 5d 20 3d 20 27 5c 30 27 3b 0a  ster[0] = '\0';.
8c30: 0a 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33 4f  .  rc = sqlite3O
8c40: 73 46 69 6c 65 53 69 7a 65 28 70 4a 72 6e 6c 2c  sFileSize(pJrnl,
8c50: 20 26 73 7a 4a 29 3b 0a 20 20 69 66 28 20 72 63   &szJ);.  if( rc
8c60: 21 3d 53 51 4c 49 54 45 5f 4f 4b 20 7c 7c 20 73  !=SQLITE_OK || s
8c70: 7a 4a 3c 31 36 20 29 20 72 65 74 75 72 6e 20 72  zJ<16 ) return r
8c80: 63 3b 0a 0a 20 20 72 63 20 3d 20 72 65 61 64 33  c;..  rc = read3
8c90: 32 62 69 74 73 28 70 4a 72 6e 6c 2c 20 73 7a 4a  2bits(pJrnl, szJ
8ca0: 2d 31 36 2c 20 26 6c 65 6e 29 3b 0a 20 20 69 66  -16, &len);.  if
8cb0: 28 20 72 63 21 3d 53 51 4c 49 54 45 5f 4f 4b 20  ( rc!=SQLITE_OK 
8cc0: 29 20 72 65 74 75 72 6e 20 72 63 3b 0a 0a 20 20  ) return rc;..  
8cd0: 69 66 28 20 6c 65 6e 3e 3d 6e 4d 61 73 74 65 72  if( len>=nMaster
8ce0: 20 29 7b 0a 20 20 20 20 72 65 74 75 72 6e 20 53   ){.    return S
8cf0: 51 4c 49 54 45 5f 4f 4b 3b 0a 20 20 7d 0a 0a 20  QLITE_OK;.  }.. 
8d00: 20 72 63 20 3d 20 72 65 61 64 33 32 62 69 74 73   rc = read32bits
8d10: 28 70 4a 72 6e 6c 2c 20 73 7a 4a 2d 31 32 2c 20  (pJrnl, szJ-12, 
8d20: 26 63 6b 73 75 6d 29 3b 0a 20 20 69 66 28 20 72  &cksum);.  if( r
8d30: 63 21 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 20 72  c!=SQLITE_OK ) r
8d40: 65 74 75 72 6e 20 72 63 3b 0a 0a 20 20 72 63 20  eturn rc;..  rc 
8d50: 3d 20 73 71 6c 69 74 65 33 4f 73 52 65 61 64 28  = sqlite3OsRead(
8d60: 70 4a 72 6e 6c 2c 20 61 4d 61 67 69 63 2c 20 38  pJrnl, aMagic, 8
8d70: 2c 20 73 7a 4a 2d 38 29 3b 0a 20 20 69 66 28 20  , szJ-8);.  if( 
8d80: 72 63 21 3d 53 51 4c 49 54 45 5f 4f 4b 20 7c 7c  rc!=SQLITE_OK ||
8d90: 20 6d 65 6d 63 6d 70 28 61 4d 61 67 69 63 2c 20   memcmp(aMagic, 
8da0: 61 4a 6f 75 72 6e 61 6c 4d 61 67 69 63 2c 20 38  aJournalMagic, 8
8db0: 29 20 29 20 72 65 74 75 72 6e 20 72 63 3b 0a 0a  ) ) return rc;..
8dc0: 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33 4f 73    rc = sqlite3Os
8dd0: 52 65 61 64 28 70 4a 72 6e 6c 2c 20 7a 4d 61 73  Read(pJrnl, zMas
8de0: 74 65 72 2c 20 6c 65 6e 2c 20 73 7a 4a 2d 31 36  ter, len, szJ-16
8df0: 2d 6c 65 6e 29 3b 0a 20 20 69 66 28 20 72 63 21  -len);.  if( rc!
8e00: 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20  =SQLITE_OK ){.  
8e10: 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 20 20 7d    return rc;.  }
8e20: 0a 20 20 7a 4d 61 73 74 65 72 5b 6c 65 6e 5d 20  .  zMaster[len] 
8e30: 3d 20 27 5c 30 27 3b 0a 0a 20 20 2f 2a 20 53 65  = '\0';..  /* Se
8e40: 65 20 69 66 20 74 68 65 20 63 68 65 63 6b 73 75  e if the checksu
8e50: 6d 20 6d 61 74 63 68 65 73 20 74 68 65 20 6d 61  m matches the ma
8e60: 73 74 65 72 20 6a 6f 75 72 6e 61 6c 20 6e 61 6d  ster journal nam
8e70: 65 20 2a 2f 0a 20 20 66 6f 72 28 69 3d 30 3b 20  e */.  for(i=0; 
8e80: 69 3c 6c 65 6e 3b 20 69 2b 2b 29 7b 0a 20 20 20  i<len; i++){.   
8e90: 20 63 6b 73 75 6d 20 2d 3d 20 7a 4d 61 73 74 65   cksum -= zMaste
8ea0: 72 5b 69 5d 3b 0a 20 20 20 7d 0a 20 20 69 66 28  r[i];.   }.  if(
8eb0: 20 63 6b 73 75 6d 20 29 7b 0a 20 20 20 20 2f 2a   cksum ){.    /*
8ec0: 20 49 66 20 74 68 65 20 63 68 65 63 6b 73 75 6d   If the checksum
8ed0: 20 64 6f 65 73 6e 27 74 20 61 64 64 20 75 70 2c   doesn't add up,
8ee0: 20 74 68 65 6e 20 6f 6e 65 20 6f 72 20 6d 6f 72   then one or mor
8ef0: 65 20 6f 66 20 74 68 65 20 64 69 73 6b 20 73 65  e of the disk se
8f00: 63 74 6f 72 73 0a 20 20 20 20 2a 2a 20 63 6f 6e  ctors.    ** con
8f10: 74 61 69 6e 69 6e 67 20 74 68 65 20 6d 61 73 74  taining the mast
8f20: 65 72 20 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 6e  er journal filen
8f30: 61 6d 65 20 69 73 20 63 6f 72 72 75 70 74 65 64  ame is corrupted
8f40: 2e 20 54 68 69 73 20 6d 65 61 6e 73 0a 20 20 20  . This means.   
8f50: 20 2a 2a 20 64 65 66 69 6e 69 74 65 6c 79 20 72   ** definitely r
8f60: 6f 6c 6c 20 62 61 63 6b 2c 20 73 6f 20 6a 75 73  oll back, so jus
8f70: 74 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f  t return SQLITE_
8f80: 4f 4b 20 61 6e 64 20 72 65 70 6f 72 74 20 61 20  OK and report a 
8f90: 28 6e 75 6c 29 0a 20 20 20 20 2a 2a 20 6d 61 73  (nul).    ** mas
8fa0: 74 65 72 2d 6a 6f 75 72 6e 61 6c 20 66 69 6c 65  ter-journal file
8fb0: 6e 61 6d 65 2e 0a 20 20 20 20 2a 2f 0a 20 20 20  name..    */.   
8fc0: 20 7a 4d 61 73 74 65 72 5b 30 5d 20 3d 20 27 5c   zMaster[0] = '\
8fd0: 30 27 3b 0a 20 20 7d 0a 20 20 20 0a 20 20 72 65  0';.  }.   .  re
8fe0: 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a  turn SQLITE_OK;.
8ff0: 7d 0a 0a 2f 2a 0a 2a 2a 20 53 65 65 6b 20 74 68  }../*.** Seek th
9000: 65 20 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 20 64  e journal file d
9010: 65 73 63 72 69 70 74 6f 72 20 74 6f 20 74 68 65  escriptor to the
9020: 20 6e 65 78 74 20 73 65 63 74 6f 72 20 62 6f 75   next sector bou
9030: 6e 64 61 72 79 20 77 68 65 72 65 20 61 0a 2a 2a  ndary where a.**
9040: 20 6a 6f 75 72 6e 61 6c 20 68 65 61 64 65 72 20   journal header 
9050: 6d 61 79 20 62 65 20 72 65 61 64 20 6f 72 20 77  may be read or w
9060: 72 69 74 74 65 6e 2e 20 50 61 67 65 72 2e 6a 6f  ritten. Pager.jo
9070: 75 72 6e 61 6c 4f 66 66 20 69 73 20 75 70 64 61  urnalOff is upda
9080: 74 65 64 20 77 69 74 68 0a 2a 2a 20 74 68 65 20  ted with.** the 
9090: 6e 65 77 20 73 65 65 6b 20 6f 66 66 73 65 74 2e  new seek offset.
90a0: 0a 2a 2a 0a 2a 2a 20 69 2e 65 20 66 6f 72 20 61  .**.** i.e for a
90b0: 20 73 65 63 74 6f 72 20 73 69 7a 65 20 6f 66 20   sector size of 
90c0: 35 31 32 3a 0a 2a 2a 0a 2a 2a 20 49 6e 70 75 74  512:.**.** Input
90d0: 20 4f 66 66 73 65 74 20 20 20 20 20 20 20 20 20   Offset         
90e0: 20 20 20 20 20 4f 75 74 70 75 74 20 4f 66 66 73       Output Offs
90f0: 65 74 0a 2a 2a 20 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d  et.** ----------
9100: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d  ----------------
9110: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 2a 2a  -------------.**
9120: 20 30 20 20 20 20 20 20 20 20 20 20 20 20 20 20   0              
9130: 20 20 20 20 20 20 20 20 20 20 20 30 0a 2a 2a 20             0.** 
9140: 35 31 32 20 20 20 20 20 20 20 20 20 20 20 20 20  512             
9150: 20 20 20 20 20 20 20 20 20 20 35 31 32 0a 2a 2a            512.**
9160: 20 31 30 30 20 20 20 20 20 20 20 20 20 20 20 20   100            
9170: 20 20 20 20 20 20 20 20 20 20 20 35 31 32 0a 2a             512.*
9180: 2a 20 32 30 30 30 20 20 20 20 20 20 20 20 20 20  * 2000          
9190: 20 20 20 20 20 20 20 20 20 20 20 20 32 30 34 38              2048
91a0: 0a 2a 2a 20 0a 2a 2f 0a 73 74 61 74 69 63 20 76  .** .*/.static v
91b0: 6f 69 64 20 73 65 65 6b 4a 6f 75 72 6e 61 6c 48  oid seekJournalH
91c0: 64 72 28 50 61 67 65 72 20 2a 70 50 61 67 65 72  dr(Pager *pPager
91d0: 29 7b 0a 20 20 69 36 34 20 6f 66 66 73 65 74 20  ){.  i64 offset 
91e0: 3d 20 30 3b 0a 20 20 69 36 34 20 63 20 3d 20 70  = 0;.  i64 c = p
91f0: 50 61 67 65 72 2d 3e 6a 6f 75 72 6e 61 6c 4f 66  Pager->journalOf
9200: 66 3b 0a 20 20 69 66 28 20 63 20 29 7b 0a 20 20  f;.  if( c ){.  
9210: 20 20 6f 66 66 73 65 74 20 3d 20 28 28 63 2d 31    offset = ((c-1
9220: 29 2f 4a 4f 55 52 4e 41 4c 5f 48 44 52 5f 53 5a  )/JOURNAL_HDR_SZ
9230: 28 70 50 61 67 65 72 29 20 2b 20 31 29 20 2a 20  (pPager) + 1) * 
9240: 4a 4f 55 52 4e 41 4c 5f 48 44 52 5f 53 5a 28 70  JOURNAL_HDR_SZ(p
9250: 50 61 67 65 72 29 3b 0a 20 20 7d 0a 20 20 61 73  Pager);.  }.  as
9260: 73 65 72 74 28 20 6f 66 66 73 65 74 25 4a 4f 55  sert( offset%JOU
9270: 52 4e 41 4c 5f 48 44 52 5f 53 5a 28 70 50 61 67  RNAL_HDR_SZ(pPag
9280: 65 72 29 3d 3d 30 20 29 3b 0a 20 20 61 73 73 65  er)==0 );.  asse
9290: 72 74 28 20 6f 66 66 73 65 74 3e 3d 63 20 29 3b  rt( offset>=c );
92a0: 0a 20 20 61 73 73 65 72 74 28 20 28 6f 66 66 73  .  assert( (offs
92b0: 65 74 2d 63 29 3c 4a 4f 55 52 4e 41 4c 5f 48 44  et-c)<JOURNAL_HD
92c0: 52 5f 53 5a 28 70 50 61 67 65 72 29 20 29 3b 0a  R_SZ(pPager) );.
92d0: 20 20 70 50 61 67 65 72 2d 3e 6a 6f 75 72 6e 61    pPager->journa
92e0: 6c 4f 66 66 20 3d 20 6f 66 66 73 65 74 3b 0a 7d  lOff = offset;.}
92f0: 0a 0a 2f 2a 0a 2a 2a 20 57 72 69 74 65 20 7a 65  ../*.** Write ze
9300: 72 6f 73 20 6f 76 65 72 20 74 68 65 20 68 65 61  ros over the hea
9310: 64 65 72 20 6f 66 20 74 68 65 20 6a 6f 75 72 6e  der of the journ
9320: 61 6c 20 66 69 6c 65 2e 20 20 54 68 69 73 20 68  al file.  This h
9330: 61 73 20 74 68 65 0a 2a 2a 20 65 66 66 65 63 74  as the.** effect
9340: 20 6f 66 20 69 6e 76 61 6c 69 64 61 74 69 6e 67   of invalidating
9350: 20 74 68 65 20 6a 6f 75 72 6e 61 6c 20 66 69 6c   the journal fil
9360: 65 20 61 6e 64 20 63 6f 6d 6d 69 74 74 69 6e 67  e and committing
9370: 20 74 68 65 0a 2a 2a 20 74 72 61 6e 73 61 63 74   the.** transact
9380: 69 6f 6e 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 69  ion..*/.static i
9390: 6e 74 20 7a 65 72 6f 4a 6f 75 72 6e 61 6c 48 64  nt zeroJournalHd
93a0: 72 28 50 61 67 65 72 20 2a 70 50 61 67 65 72 29  r(Pager *pPager)
93b0: 7b 0a 20 20 69 6e 74 20 72 63 3b 0a 20 20 73 74  {.  int rc;.  st
93c0: 61 74 69 63 20 63 6f 6e 73 74 20 63 68 61 72 20  atic const char 
93d0: 7a 65 72 6f 48 64 72 5b 32 38 5d 3b 0a 0a 20 20  zeroHdr[28];..  
93e0: 49 4f 54 52 41 43 45 28 28 22 4a 5a 45 52 4f 48  IOTRACE(("JZEROH
93f0: 44 52 20 25 70 5c 6e 22 2c 20 70 50 61 67 65 72  DR %p\n", pPager
9400: 29 29 0a 20 20 72 63 20 3d 20 73 71 6c 69 74 65  )).  rc = sqlite
9410: 33 4f 73 57 72 69 74 65 28 70 50 61 67 65 72 2d  3OsWrite(pPager-
9420: 3e 6a 66 64 2c 20 7a 65 72 6f 48 64 72 2c 20 73  >jfd, zeroHdr, s
9430: 69 7a 65 6f 66 28 7a 65 72 6f 48 64 72 29 2c 20  izeof(zeroHdr), 
9440: 30 29 3b 0a 20 20 69 66 28 20 72 63 3d 3d 53 51  0);.  if( rc==SQ
9450: 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 72  LITE_OK ){.    r
9460: 63 20 3d 20 73 71 6c 69 74 65 33 4f 73 53 79 6e  c = sqlite3OsSyn
9470: 63 28 70 50 61 67 65 72 2d 3e 6a 66 64 2c 20 53  c(pPager->jfd, S
9480: 51 4c 49 54 45 5f 53 59 4e 43 5f 44 41 54 41 4f  QLITE_SYNC_DATAO
9490: 4e 4c 59 20 7c 20 70 50 61 67 65 72 2d 3e 73 79  NLY | pPager->sy
94a0: 6e 63 5f 66 6c 61 67 73 29 3b 0a 20 20 7d 0a 20  nc_flags);.  }. 
94b0: 20 72 65 74 75 72 6e 20 72 63 3b 0a 7d 0a 0a 2f   return rc;.}../
94c0: 2a 0a 2a 2a 20 54 68 65 20 6a 6f 75 72 6e 61 6c  *.** The journal
94d0: 20 66 69 6c 65 20 6d 75 73 74 20 62 65 20 6f 70   file must be op
94e0: 65 6e 20 77 68 65 6e 20 74 68 69 73 20 72 6f 75  en when this rou
94f0: 74 69 6e 65 20 69 73 20 63 61 6c 6c 65 64 2e 20  tine is called. 
9500: 41 20 6a 6f 75 72 6e 61 6c 0a 2a 2a 20 68 65 61  A journal.** hea
9510: 64 65 72 20 28 4a 4f 55 52 4e 41 4c 5f 48 44 52  der (JOURNAL_HDR
9520: 5f 53 5a 20 62 79 74 65 73 29 20 69 73 20 77 72  _SZ bytes) is wr
9530: 69 74 74 65 6e 20 69 6e 74 6f 20 74 68 65 20 6a  itten into the j
9540: 6f 75 72 6e 61 6c 20 66 69 6c 65 20 61 74 20 74  ournal file at t
9550: 68 65 0a 2a 2a 20 63 75 72 72 65 6e 74 20 6c 6f  he.** current lo
9560: 63 61 74 69 6f 6e 2e 0a 2a 2a 0a 2a 2a 20 54 68  cation..**.** Th
9570: 65 20 66 6f 72 6d 61 74 20 66 6f 72 20 74 68 65  e format for the
9580: 20 6a 6f 75 72 6e 61 6c 20 68 65 61 64 65 72 20   journal header 
9590: 69 73 20 61 73 20 66 6f 6c 6c 6f 77 73 3a 0a 2a  is as follows:.*
95a0: 2a 20 2d 20 38 20 62 79 74 65 73 3a 20 4d 61 67  * - 8 bytes: Mag
95b0: 69 63 20 69 64 65 6e 74 69 66 79 69 6e 67 20 6a  ic identifying j
95c0: 6f 75 72 6e 61 6c 20 66 6f 72 6d 61 74 2e 0a 2a  ournal format..*
95d0: 2a 20 2d 20 34 20 62 79 74 65 73 3a 20 4e 75 6d  * - 4 bytes: Num
95e0: 62 65 72 20 6f 66 20 72 65 63 6f 72 64 73 20 69  ber of records i
95f0: 6e 20 6a 6f 75 72 6e 61 6c 2c 20 6f 72 20 2d 31  n journal, or -1
9600: 20 6e 6f 2d 73 79 6e 63 20 6d 6f 64 65 20 69 73   no-sync mode is
9610: 20 6f 6e 2e 0a 2a 2a 20 2d 20 34 20 62 79 74 65   on..** - 4 byte
9620: 73 3a 20 52 61 6e 64 6f 6d 20 6e 75 6d 62 65 72  s: Random number
9630: 20 75 73 65 64 20 66 6f 72 20 70 61 67 65 20 68   used for page h
9640: 61 73 68 2e 0a 2a 2a 20 2d 20 34 20 62 79 74 65  ash..** - 4 byte
9650: 73 3a 20 49 6e 69 74 69 61 6c 20 64 61 74 61 62  s: Initial datab
9660: 61 73 65 20 70 61 67 65 20 63 6f 75 6e 74 2e 0a  ase page count..
9670: 2a 2a 20 2d 20 34 20 62 79 74 65 73 3a 20 53 65  ** - 4 bytes: Se
9680: 63 74 6f 72 20 73 69 7a 65 20 75 73 65 64 20 62  ctor size used b
9690: 79 20 74 68 65 20 70 72 6f 63 65 73 73 20 74 68  y the process th
96a0: 61 74 20 77 72 6f 74 65 20 74 68 69 73 20 6a 6f  at wrote this jo
96b0: 75 72 6e 61 6c 2e 0a 2a 2a 20 2d 20 34 20 62 79  urnal..** - 4 by
96c0: 74 65 73 3a 20 44 61 74 61 62 61 73 65 20 70 61  tes: Database pa
96d0: 67 65 20 73 69 7a 65 2e 0a 2a 2a 20 0a 2a 2a 20  ge size..** .** 
96e0: 46 6f 6c 6c 6f 77 65 64 20 62 79 20 28 4a 4f 55  Followed by (JOU
96f0: 52 4e 41 4c 5f 48 44 52 5f 53 5a 20 2d 20 32 38  RNAL_HDR_SZ - 28
9700: 29 20 62 79 74 65 73 20 6f 66 20 75 6e 75 73 65  ) bytes of unuse
9710: 64 20 73 70 61 63 65 2e 0a 2a 2f 0a 73 74 61 74  d space..*/.stat
9720: 69 63 20 69 6e 74 20 77 72 69 74 65 4a 6f 75 72  ic int writeJour
9730: 6e 61 6c 48 64 72 28 50 61 67 65 72 20 2a 70 50  nalHdr(Pager *pP
9740: 61 67 65 72 29 7b 0a 20 20 69 6e 74 20 72 63 20  ager){.  int rc 
9750: 3d 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20 20 63  = SQLITE_OK;.  c
9760: 68 61 72 20 2a 7a 48 65 61 64 65 72 20 3d 20 70  har *zHeader = p
9770: 50 61 67 65 72 2d 3e 70 54 6d 70 53 70 61 63 65  Pager->pTmpSpace
9780: 3b 0a 20 20 69 6e 74 20 6e 48 65 61 64 65 72 20  ;.  int nHeader 
9790: 3d 20 70 50 61 67 65 72 2d 3e 70 61 67 65 53 69  = pPager->pageSi
97a0: 7a 65 3b 0a 20 20 69 6e 74 20 6e 57 72 69 74 65  ze;.  int nWrite
97b0: 3b 0a 0a 20 20 69 66 28 20 6e 48 65 61 64 65 72  ;..  if( nHeader
97c0: 3e 4a 4f 55 52 4e 41 4c 5f 48 44 52 5f 53 5a 28  >JOURNAL_HDR_SZ(
97d0: 70 50 61 67 65 72 29 20 29 7b 0a 20 20 20 20 6e  pPager) ){.    n
97e0: 48 65 61 64 65 72 20 3d 20 4a 4f 55 52 4e 41 4c  Header = JOURNAL
97f0: 5f 48 44 52 5f 53 5a 28 70 50 61 67 65 72 29 3b  _HDR_SZ(pPager);
9800: 0a 20 20 7d 0a 0a 20 20 69 66 28 20 70 50 61 67  .  }..  if( pPag
9810: 65 72 2d 3e 73 74 6d 74 48 64 72 4f 66 66 3d 3d  er->stmtHdrOff==
9820: 30 20 29 7b 0a 20 20 20 20 70 50 61 67 65 72 2d  0 ){.    pPager-
9830: 3e 73 74 6d 74 48 64 72 4f 66 66 20 3d 20 70 50  >stmtHdrOff = pP
9840: 61 67 65 72 2d 3e 6a 6f 75 72 6e 61 6c 4f 66 66  ager->journalOff
9850: 3b 0a 20 20 7d 0a 0a 20 20 73 65 65 6b 4a 6f 75  ;.  }..  seekJou
9860: 72 6e 61 6c 48 64 72 28 70 50 61 67 65 72 29 3b  rnalHdr(pPager);
9870: 0a 20 20 70 50 61 67 65 72 2d 3e 6a 6f 75 72 6e  .  pPager->journ
9880: 61 6c 48 64 72 20 3d 20 70 50 61 67 65 72 2d 3e  alHdr = pPager->
9890: 6a 6f 75 72 6e 61 6c 4f 66 66 3b 0a 0a 20 20 6d  journalOff;..  m
98a0: 65 6d 63 70 79 28 7a 48 65 61 64 65 72 2c 20 61  emcpy(zHeader, a
98b0: 4a 6f 75 72 6e 61 6c 4d 61 67 69 63 2c 20 73 69  JournalMagic, si
98c0: 7a 65 6f 66 28 61 4a 6f 75 72 6e 61 6c 4d 61 67  zeof(aJournalMag
98d0: 69 63 29 29 3b 0a 0a 20 20 2f 2a 20 0a 20 20 2a  ic));..  /* .  *
98e0: 2a 20 57 72 69 74 65 20 74 68 65 20 6e 52 65 63  * Write the nRec
98f0: 20 46 69 65 6c 64 20 2d 20 74 68 65 20 6e 75 6d   Field - the num
9900: 62 65 72 20 6f 66 20 70 61 67 65 20 72 65 63 6f  ber of page reco
9910: 72 64 73 20 74 68 61 74 20 66 6f 6c 6c 6f 77 20  rds that follow 
9920: 74 68 69 73 0a 20 20 2a 2a 20 6a 6f 75 72 6e 61  this.  ** journa
9930: 6c 20 68 65 61 64 65 72 2e 20 4e 6f 72 6d 61 6c  l header. Normal
9940: 6c 79 2c 20 7a 65 72 6f 20 69 73 20 77 72 69 74  ly, zero is writ
9950: 74 65 6e 20 74 6f 20 74 68 69 73 20 76 61 6c 75  ten to this valu
9960: 65 20 61 74 20 74 68 69 73 20 74 69 6d 65 2e 0a  e at this time..
9970: 20 20 2a 2a 20 41 66 74 65 72 20 74 68 65 20 72    ** After the r
9980: 65 63 6f 72 64 73 20 61 72 65 20 61 64 64 65 64  ecords are added
9990: 20 74 6f 20 74 68 65 20 6a 6f 75 72 6e 61 6c 20   to the journal 
99a0: 28 61 6e 64 20 74 68 65 20 6a 6f 75 72 6e 61 6c  (and the journal
99b0: 20 73 79 6e 63 65 64 2c 20 0a 20 20 2a 2a 20 69   synced, .  ** i
99c0: 66 20 69 6e 20 66 75 6c 6c 2d 73 79 6e 63 20 6d  f in full-sync m
99d0: 6f 64 65 29 2c 20 74 68 65 20 7a 65 72 6f 20 69  ode), the zero i
99e0: 73 20 6f 76 65 72 77 72 69 74 74 65 6e 20 77 69  s overwritten wi
99f0: 74 68 20 74 68 65 20 74 72 75 65 20 6e 75 6d 62  th the true numb
9a00: 65 72 0a 20 20 2a 2a 20 6f 66 20 72 65 63 6f 72  er.  ** of recor
9a10: 64 73 20 28 73 65 65 20 73 79 6e 63 4a 6f 75 72  ds (see syncJour
9a20: 6e 61 6c 28 29 29 2e 0a 20 20 2a 2a 0a 20 20 2a  nal())..  **.  *
9a30: 2a 20 41 20 66 61 73 74 65 72 20 61 6c 74 65 72  * A faster alter
9a40: 6e 61 74 69 76 65 20 69 73 20 74 6f 20 77 72 69  native is to wri
9a50: 74 65 20 30 78 46 46 46 46 46 46 46 46 20 74 6f  te 0xFFFFFFFF to
9a60: 20 74 68 65 20 6e 52 65 63 20 66 69 65 6c 64 2e   the nRec field.
9a70: 20 57 68 65 6e 0a 20 20 2a 2a 20 72 65 61 64 69   When.  ** readi
9a80: 6e 67 20 74 68 65 20 6a 6f 75 72 6e 61 6c 20 74  ng the journal t
9a90: 68 69 73 20 76 61 6c 75 65 20 74 65 6c 6c 73 20  his value tells 
9aa0: 53 51 4c 69 74 65 20 74 6f 20 61 73 73 75 6d 65  SQLite to assume
9ab0: 20 74 68 61 74 20 74 68 65 0a 20 20 2a 2a 20 72   that the.  ** r
9ac0: 65 73 74 20 6f 66 20 74 68 65 20 6a 6f 75 72 6e  est of the journ
9ad0: 61 6c 20 66 69 6c 65 20 63 6f 6e 74 61 69 6e 73  al file contains
9ae0: 20 76 61 6c 69 64 20 70 61 67 65 20 72 65 63 6f   valid page reco
9af0: 72 64 73 2e 20 54 68 69 73 20 61 73 73 75 6d 70  rds. This assump
9b00: 74 69 6f 6e 0a 20 20 2a 2a 20 69 73 20 64 61 6e  tion.  ** is dan
9b10: 67 65 72 6f 75 73 2c 20 61 73 20 69 66 20 61 20  gerous, as if a 
9b20: 66 61 69 6c 75 72 65 20 6f 63 63 75 72 65 64 20  failure occured 
9b30: 77 68 69 6c 73 74 20 77 72 69 74 69 6e 67 20 74  whilst writing t
9b40: 6f 20 74 68 65 20 6a 6f 75 72 6e 61 6c 0a 20 20  o the journal.  
9b50: 2a 2a 20 66 69 6c 65 20 69 74 20 6d 61 79 20 63  ** file it may c
9b60: 6f 6e 74 61 69 6e 20 73 6f 6d 65 20 67 61 72 62  ontain some garb
9b70: 61 67 65 20 64 61 74 61 2e 20 54 68 65 72 65 20  age data. There 
9b80: 61 72 65 20 74 77 6f 20 73 63 65 6e 61 72 69 6f  are two scenario
9b90: 73 0a 20 20 2a 2a 20 77 68 65 72 65 20 74 68 69  s.  ** where thi
9ba0: 73 20 72 69 73 6b 20 63 61 6e 20 62 65 20 69 67  s risk can be ig
9bb0: 6e 6f 72 65 64 3a 0a 20 20 2a 2a 0a 20 20 2a 2a  nored:.  **.  **
9bc0: 20 20 20 2a 20 57 68 65 6e 20 74 68 65 20 70 61     * When the pa
9bd0: 67 65 72 20 69 73 20 69 6e 20 6e 6f 2d 73 79 6e  ger is in no-syn
9be0: 63 20 6d 6f 64 65 2e 20 43 6f 72 72 75 70 74 69  c mode. Corrupti
9bf0: 6f 6e 20 63 61 6e 20 66 6f 6c 6c 6f 77 20 61 0a  on can follow a.
9c00: 20 20 2a 2a 20 20 20 20 20 70 6f 77 65 72 20 66    **     power f
9c10: 61 69 6c 75 72 65 20 69 6e 20 74 68 69 73 20 63  ailure in this c
9c20: 61 73 65 20 61 6e 79 77 61 79 2e 0a 20 20 2a 2a  ase anyway..  **
9c30: 0a 20 20 2a 2a 20 20 20 2a 20 57 68 65 6e 20 74  .  **   * When t
9c40: 68 65 20 53 51 4c 49 54 45 5f 49 4f 43 41 50 5f  he SQLITE_IOCAP_
9c50: 53 41 46 45 5f 41 50 50 45 4e 44 20 66 6c 61 67  SAFE_APPEND flag
9c60: 20 69 73 20 73 65 74 2e 20 54 68 69 73 20 67 75   is set. This gu
9c70: 61 72 61 6e 74 65 65 73 0a 20 20 2a 2a 20 20 20  arantees.  **   
9c80: 20 20 74 68 61 74 20 67 61 72 62 61 67 65 20 64    that garbage d
9c90: 61 74 61 20 69 73 20 6e 65 76 65 72 20 61 70 70  ata is never app
9ca0: 65 6e 64 65 64 20 74 6f 20 74 68 65 20 6a 6f 75  ended to the jou
9cb0: 72 6e 61 6c 20 66 69 6c 65 2e 0a 20 20 2a 2f 0a  rnal file..  */.
9cc0: 20 20 61 73 73 65 72 74 28 70 50 61 67 65 72 2d    assert(pPager-
9cd0: 3e 66 64 2d 3e 70 4d 65 74 68 6f 64 73 7c 7c 70  >fd->pMethods||p
9ce0: 50 61 67 65 72 2d 3e 6e 6f 53 79 6e 63 29 3b 0a  Pager->noSync);.
9cf0: 20 20 69 66 28 20 28 70 50 61 67 65 72 2d 3e 6e    if( (pPager->n
9d00: 6f 53 79 6e 63 29 20 0a 20 20 20 7c 7c 20 28 73  oSync) .   || (s
9d10: 71 6c 69 74 65 33 4f 73 44 65 76 69 63 65 43 68  qlite3OsDeviceCh
9d20: 61 72 61 63 74 65 72 69 73 74 69 63 73 28 70 50  aracteristics(pP
9d30: 61 67 65 72 2d 3e 66 64 29 26 53 51 4c 49 54 45  ager->fd)&SQLITE
9d40: 5f 49 4f 43 41 50 5f 53 41 46 45 5f 41 50 50 45  _IOCAP_SAFE_APPE
9d50: 4e 44 29 20 0a 20 20 29 7b 0a 20 20 20 20 70 75  ND) .  ){.    pu
9d60: 74 33 32 62 69 74 73 28 26 7a 48 65 61 64 65 72  t32bits(&zHeader
9d70: 5b 73 69 7a 65 6f 66 28 61 4a 6f 75 72 6e 61 6c  [sizeof(aJournal
9d80: 4d 61 67 69 63 29 5d 2c 20 30 78 66 66 66 66 66  Magic)], 0xfffff
9d90: 66 66 66 29 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20  fff);.  }else{. 
9da0: 20 20 20 70 75 74 33 32 62 69 74 73 28 26 7a 48     put32bits(&zH
9db0: 65 61 64 65 72 5b 73 69 7a 65 6f 66 28 61 4a 6f  eader[sizeof(aJo
9dc0: 75 72 6e 61 6c 4d 61 67 69 63 29 5d 2c 20 30 29  urnalMagic)], 0)
9dd0: 3b 0a 20 20 7d 0a 0a 20 20 2f 2a 20 54 68 65 20  ;.  }..  /* The 
9de0: 72 61 6e 64 6f 6d 20 63 68 65 63 6b 2d 68 61 73  random check-has
9df0: 68 20 69 6e 69 74 69 61 6c 69 73 65 72 20 2a 2f  h initialiser */
9e00: 20 0a 20 20 73 71 6c 69 74 65 33 5f 72 61 6e 64   .  sqlite3_rand
9e10: 6f 6d 6e 65 73 73 28 73 69 7a 65 6f 66 28 70 50  omness(sizeof(pP
9e20: 61 67 65 72 2d 3e 63 6b 73 75 6d 49 6e 69 74 29  ager->cksumInit)
9e30: 2c 20 26 70 50 61 67 65 72 2d 3e 63 6b 73 75 6d  , &pPager->cksum
9e40: 49 6e 69 74 29 3b 0a 20 20 70 75 74 33 32 62 69  Init);.  put32bi
9e50: 74 73 28 26 7a 48 65 61 64 65 72 5b 73 69 7a 65  ts(&zHeader[size
9e60: 6f 66 28 61 4a 6f 75 72 6e 61 6c 4d 61 67 69 63  of(aJournalMagic
9e70: 29 2b 34 5d 2c 20 70 50 61 67 65 72 2d 3e 63 6b  )+4], pPager->ck
9e80: 73 75 6d 49 6e 69 74 29 3b 0a 20 20 2f 2a 20 54  sumInit);.  /* T
9e90: 68 65 20 69 6e 69 74 69 61 6c 20 64 61 74 61 62  he initial datab
9ea0: 61 73 65 20 73 69 7a 65 20 2a 2f 0a 20 20 70 75  ase size */.  pu
9eb0: 74 33 32 62 69 74 73 28 26 7a 48 65 61 64 65 72  t32bits(&zHeader
9ec0: 5b 73 69 7a 65 6f 66 28 61 4a 6f 75 72 6e 61 6c  [sizeof(aJournal
9ed0: 4d 61 67 69 63 29 2b 38 5d 2c 20 70 50 61 67 65  Magic)+8], pPage
9ee0: 72 2d 3e 64 62 53 69 7a 65 29 3b 0a 20 20 2f 2a  r->dbSize);.  /*
9ef0: 20 54 68 65 20 61 73 73 75 6d 65 64 20 73 65 63   The assumed sec
9f00: 74 6f 72 20 73 69 7a 65 20 66 6f 72 20 74 68 69  tor size for thi
9f10: 73 20 70 72 6f 63 65 73 73 20 2a 2f 0a 20 20 70  s process */.  p
9f20: 75 74 33 32 62 69 74 73 28 26 7a 48 65 61 64 65  ut32bits(&zHeade
9f30: 72 5b 73 69 7a 65 6f 66 28 61 4a 6f 75 72 6e 61  r[sizeof(aJourna
9f40: 6c 4d 61 67 69 63 29 2b 31 32 5d 2c 20 70 50 61  lMagic)+12], pPa
9f50: 67 65 72 2d 3e 73 65 63 74 6f 72 53 69 7a 65 29  ger->sectorSize)
9f60: 3b 0a 20 20 69 66 28 20 70 50 61 67 65 72 2d 3e  ;.  if( pPager->
9f70: 6a 6f 75 72 6e 61 6c 48 64 72 3d 3d 30 20 29 7b  journalHdr==0 ){
9f80: 0a 20 20 20 20 2f 2a 20 54 68 65 20 70 61 67 65  .    /* The page
9f90: 20 73 69 7a 65 20 2a 2f 0a 20 20 20 20 70 75 74   size */.    put
9fa0: 33 32 62 69 74 73 28 26 7a 48 65 61 64 65 72 5b  32bits(&zHeader[
9fb0: 73 69 7a 65 6f 66 28 61 4a 6f 75 72 6e 61 6c 4d  sizeof(aJournalM
9fc0: 61 67 69 63 29 2b 31 36 5d 2c 20 70 50 61 67 65  agic)+16], pPage
9fd0: 72 2d 3e 70 61 67 65 53 69 7a 65 29 3b 0a 20 20  r->pageSize);.  
9fe0: 7d 0a 0a 20 20 66 6f 72 28 6e 57 72 69 74 65 3d  }..  for(nWrite=
9ff0: 30 3b 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b  0; rc==SQLITE_OK
a000: 26 26 6e 57 72 69 74 65 3c 4a 4f 55 52 4e 41 4c  &&nWrite<JOURNAL
a010: 5f 48 44 52 5f 53 5a 28 70 50 61 67 65 72 29 3b  _HDR_SZ(pPager);
a020: 20 6e 57 72 69 74 65 2b 3d 6e 48 65 61 64 65 72   nWrite+=nHeader
a030: 29 7b 0a 20 20 20 20 49 4f 54 52 41 43 45 28 28  ){.    IOTRACE((
a040: 22 4a 48 44 52 20 25 70 20 25 6c 6c 64 20 25 64  "JHDR %p %lld %d
a050: 5c 6e 22 2c 20 70 50 61 67 65 72 2c 20 70 50 61  \n", pPager, pPa
a060: 67 65 72 2d 3e 6a 6f 75 72 6e 61 6c 48 64 72 2c  ger->journalHdr,
a070: 20 6e 48 65 61 64 65 72 29 29 0a 20 20 20 20 72   nHeader)).    r
a080: 63 20 3d 20 73 71 6c 69 74 65 33 4f 73 57 72 69  c = sqlite3OsWri
a090: 74 65 28 70 50 61 67 65 72 2d 3e 6a 66 64 2c 20  te(pPager->jfd, 
a0a0: 7a 48 65 61 64 65 72 2c 20 6e 48 65 61 64 65 72  zHeader, nHeader
a0b0: 2c 20 70 50 61 67 65 72 2d 3e 6a 6f 75 72 6e 61  , pPager->journa
a0c0: 6c 4f 66 66 29 3b 0a 20 20 20 20 70 50 61 67 65  lOff);.    pPage
a0d0: 72 2d 3e 6a 6f 75 72 6e 61 6c 4f 66 66 20 2b 3d  r->journalOff +=
a0e0: 20 6e 48 65 61 64 65 72 3b 0a 20 20 7d 0a 0a 20   nHeader;.  }.. 
a0f0: 20 72 65 74 75 72 6e 20 72 63 3b 0a 7d 0a 0a 2f   return rc;.}../
a100: 2a 0a 2a 2a 20 54 68 65 20 6a 6f 75 72 6e 61 6c  *.** The journal
a110: 20 66 69 6c 65 20 6d 75 73 74 20 62 65 20 6f 70   file must be op
a120: 65 6e 20 77 68 65 6e 20 74 68 69 73 20 69 73 20  en when this is 
a130: 63 61 6c 6c 65 64 2e 20 41 20 6a 6f 75 72 6e 61  called. A journa
a140: 6c 20 68 65 61 64 65 72 20 66 69 6c 65 0a 2a 2a  l header file.**
a150: 20 28 4a 4f 55 52 4e 41 4c 5f 48 44 52 5f 53 5a   (JOURNAL_HDR_SZ
a160: 20 62 79 74 65 73 29 20 69 73 20 72 65 61 64 20   bytes) is read 
a170: 66 72 6f 6d 20 74 68 65 20 63 75 72 72 65 6e 74  from the current
a180: 20 6c 6f 63 61 74 69 6f 6e 20 69 6e 20 74 68 65   location in the
a190: 20 6a 6f 75 72 6e 61 6c 0a 2a 2a 20 66 69 6c 65   journal.** file
a1a0: 2e 20 53 65 65 20 63 6f 6d 6d 65 6e 74 73 20 61  . See comments a
a1b0: 62 6f 76 65 20 66 75 6e 63 74 69 6f 6e 20 77 72  bove function wr
a1c0: 69 74 65 4a 6f 75 72 6e 61 6c 48 64 72 28 29 20  iteJournalHdr() 
a1d0: 66 6f 72 20 61 20 64 65 73 63 72 69 70 74 69 6f  for a descriptio
a1e0: 6e 20 6f 66 0a 2a 2a 20 74 68 65 20 6a 6f 75 72  n of.** the jour
a1f0: 6e 61 6c 20 68 65 61 64 65 72 20 66 6f 72 6d 61  nal header forma
a200: 74 2e 0a 2a 2a 0a 2a 2a 20 49 66 20 74 68 65 20  t..**.** If the 
a210: 68 65 61 64 65 72 20 69 73 20 72 65 61 64 20 73  header is read s
a220: 75 63 63 65 73 73 66 75 6c 6c 79 2c 20 2a 6e 52  uccessfully, *nR
a230: 65 63 20 69 73 20 73 65 74 20 74 6f 20 74 68 65  ec is set to the
a240: 20 6e 75 6d 62 65 72 20 6f 66 0a 2a 2a 20 70 61   number of.** pa
a250: 67 65 20 72 65 63 6f 72 64 73 20 66 6f 6c 6c 6f  ge records follo
a260: 77 69 6e 67 20 74 68 69 73 20 68 65 61 64 65 72  wing this header
a270: 20 61 6e 64 20 2a 64 62 53 69 7a 65 20 69 73 20   and *dbSize is 
a280: 73 65 74 20 74 6f 20 74 68 65 20 73 69 7a 65 20  set to the size 
a290: 6f 66 20 74 68 65 0a 2a 2a 20 64 61 74 61 62 61  of the.** databa
a2a0: 73 65 20 62 65 66 6f 72 65 20 74 68 65 20 74 72  se before the tr
a2b0: 61 6e 73 61 63 74 69 6f 6e 20 62 65 67 61 6e 2c  ansaction began,
a2c0: 20 69 6e 20 70 61 67 65 73 2e 20 41 6c 73 6f 2c   in pages. Also,
a2d0: 20 70 50 61 67 65 72 2d 3e 63 6b 73 75 6d 49 6e   pPager->cksumIn
a2e0: 69 74 0a 2a 2a 20 69 73 20 73 65 74 20 74 6f 20  it.** is set to 
a2f0: 74 68 65 20 76 61 6c 75 65 20 72 65 61 64 20 66  the value read f
a300: 72 6f 6d 20 74 68 65 20 6a 6f 75 72 6e 61 6c 20  rom the journal 
a310: 68 65 61 64 65 72 2e 20 53 51 4c 49 54 45 5f 4f  header. SQLITE_O
a320: 4b 20 69 73 20 72 65 74 75 72 6e 65 64 0a 2a 2a  K is returned.**
a330: 20 69 6e 20 74 68 69 73 20 63 61 73 65 2e 0a 2a   in this case..*
a340: 2a 0a 2a 2a 20 49 66 20 74 68 65 20 6a 6f 75 72  *.** If the jour
a350: 6e 61 6c 20 68 65 61 64 65 72 20 66 69 6c 65 20  nal header file 
a360: 61 70 70 65 61 72 73 20 74 6f 20 62 65 20 63 6f  appears to be co
a370: 72 72 75 70 74 65 64 2c 20 53 51 4c 49 54 45 5f  rrupted, SQLITE_
a380: 44 4f 4e 45 20 69 73 0a 2a 2a 20 72 65 74 75 72  DONE is.** retur
a390: 6e 65 64 20 61 6e 64 20 2a 6e 52 65 63 20 61 6e  ned and *nRec an
a3a0: 64 20 2a 64 62 53 69 7a 65 20 61 72 65 20 6e 6f  d *dbSize are no
a3b0: 74 20 73 65 74 2e 20 20 49 66 20 4a 4f 55 52 4e  t set.  If JOURN
a3c0: 41 4c 5f 48 44 52 5f 53 5a 20 62 79 74 65 73 0a  AL_HDR_SZ bytes.
a3d0: 2a 2a 20 63 61 6e 6e 6f 74 20 62 65 20 72 65 61  ** cannot be rea
a3e0: 64 20 66 72 6f 6d 20 74 68 65 20 6a 6f 75 72 6e  d from the journ
a3f0: 61 6c 20 66 69 6c 65 20 61 6e 20 65 72 72 6f 72  al file an error
a400: 20 63 6f 64 65 20 69 73 20 72 65 74 75 72 6e 65   code is returne
a410: 64 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74  d..*/.static int
a420: 20 72 65 61 64 4a 6f 75 72 6e 61 6c 48 64 72 28   readJournalHdr(
a430: 0a 20 20 50 61 67 65 72 20 2a 70 50 61 67 65 72  .  Pager *pPager
a440: 2c 20 0a 20 20 69 36 34 20 6a 6f 75 72 6e 61 6c  , .  i64 journal
a450: 53 69 7a 65 2c 0a 20 20 75 33 32 20 2a 70 4e 52  Size,.  u32 *pNR
a460: 65 63 2c 20 0a 20 20 75 33 32 20 2a 70 44 62 53  ec, .  u32 *pDbS
a470: 69 7a 65 0a 29 7b 0a 20 20 69 6e 74 20 72 63 3b  ize.){.  int rc;
a480: 0a 20 20 75 6e 73 69 67 6e 65 64 20 63 68 61 72  .  unsigned char
a490: 20 61 4d 61 67 69 63 5b 38 5d 3b 20 2f 2a 20 41   aMagic[8]; /* A
a4a0: 20 62 75 66 66 65 72 20 74 6f 20 68 6f 6c 64 20   buffer to hold 
a4b0: 74 68 65 20 6d 61 67 69 63 20 68 65 61 64 65 72  the magic header
a4c0: 20 2a 2f 0a 20 20 69 36 34 20 6a 72 6e 6c 4f 66   */.  i64 jrnlOf
a4d0: 66 3b 0a 20 20 69 6e 74 20 69 50 61 67 65 53 69  f;.  int iPageSi
a4e0: 7a 65 3b 0a 0a 20 20 73 65 65 6b 4a 6f 75 72 6e  ze;..  seekJourn
a4f0: 61 6c 48 64 72 28 70 50 61 67 65 72 29 3b 0a 20  alHdr(pPager);. 
a500: 20 69 66 28 20 70 50 61 67 65 72 2d 3e 6a 6f 75   if( pPager->jou
a510: 72 6e 61 6c 4f 66 66 2b 4a 4f 55 52 4e 41 4c 5f  rnalOff+JOURNAL_
a520: 48 44 52 5f 53 5a 28 70 50 61 67 65 72 29 20 3e  HDR_SZ(pPager) >
a530: 20 6a 6f 75 72 6e 61 6c 53 69 7a 65 20 29 7b 0a   journalSize ){.
a540: 20 20 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54      return SQLIT
a550: 45 5f 44 4f 4e 45 3b 0a 20 20 7d 0a 20 20 6a 72  E_DONE;.  }.  jr
a560: 6e 6c 4f 66 66 20 3d 20 70 50 61 67 65 72 2d 3e  nlOff = pPager->
a570: 6a 6f 75 72 6e 61 6c 4f 66 66 3b 0a 0a 20 20 72  journalOff;..  r
a580: 63 20 3d 20 73 71 6c 69 74 65 33 4f 73 52 65 61  c = sqlite3OsRea
a590: 64 28 70 50 61 67 65 72 2d 3e 6a 66 64 2c 20 61  d(pPager->jfd, a
a5a0: 4d 61 67 69 63 2c 20 73 69 7a 65 6f 66 28 61 4d  Magic, sizeof(aM
a5b0: 61 67 69 63 29 2c 20 6a 72 6e 6c 4f 66 66 29 3b  agic), jrnlOff);
a5c0: 0a 20 20 69 66 28 20 72 63 20 29 20 72 65 74 75  .  if( rc ) retu
a5d0: 72 6e 20 72 63 3b 0a 20 20 6a 72 6e 6c 4f 66 66  rn rc;.  jrnlOff
a5e0: 20 2b 3d 20 73 69 7a 65 6f 66 28 61 4d 61 67 69   += sizeof(aMagi
a5f0: 63 29 3b 0a 0a 20 20 69 66 28 20 6d 65 6d 63 6d  c);..  if( memcm
a600: 70 28 61 4d 61 67 69 63 2c 20 61 4a 6f 75 72 6e  p(aMagic, aJourn
a610: 61 6c 4d 61 67 69 63 2c 20 73 69 7a 65 6f 66 28  alMagic, sizeof(
a620: 61 4d 61 67 69 63 29 29 21 3d 30 20 29 7b 0a 20  aMagic))!=0 ){. 
a630: 20 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45     return SQLITE
a640: 5f 44 4f 4e 45 3b 0a 20 20 7d 0a 0a 20 20 72 63  _DONE;.  }..  rc
a650: 20 3d 20 72 65 61 64 33 32 62 69 74 73 28 70 50   = read32bits(pP
a660: 61 67 65 72 2d 3e 6a 66 64 2c 20 6a 72 6e 6c 4f  ager->jfd, jrnlO
a670: 66 66 2c 20 70 4e 52 65 63 29 3b 0a 20 20 69 66  ff, pNRec);.  if
a680: 28 20 72 63 20 29 20 72 65 74 75 72 6e 20 72 63  ( rc ) return rc
a690: 3b 0a 0a 20 20 72 63 20 3d 20 72 65 61 64 33 32  ;..  rc = read32
a6a0: 62 69 74 73 28 70 50 61 67 65 72 2d 3e 6a 66 64  bits(pPager->jfd
a6b0: 2c 20 6a 72 6e 6c 4f 66 66 2b 34 2c 20 26 70 50  , jrnlOff+4, &pP
a6c0: 61 67 65 72 2d 3e 63 6b 73 75 6d 49 6e 69 74 29  ager->cksumInit)
a6d0: 3b 0a 20 20 69 66 28 20 72 63 20 29 20 72 65 74  ;.  if( rc ) ret
a6e0: 75 72 6e 20 72 63 3b 0a 0a 20 20 72 63 20 3d 20  urn rc;..  rc = 
a6f0: 72 65 61 64 33 32 62 69 74 73 28 70 50 61 67 65  read32bits(pPage
a700: 72 2d 3e 6a 66 64 2c 20 6a 72 6e 6c 4f 66 66 2b  r->jfd, jrnlOff+
a710: 38 2c 20 70 44 62 53 69 7a 65 29 3b 0a 20 20 69  8, pDbSize);.  i
a720: 66 28 20 72 63 20 29 20 72 65 74 75 72 6e 20 72  f( rc ) return r
a730: 63 3b 0a 0a 20 20 72 63 20 3d 20 72 65 61 64 33  c;..  rc = read3
a740: 32 62 69 74 73 28 70 50 61 67 65 72 2d 3e 6a 66  2bits(pPager->jf
a750: 64 2c 20 6a 72 6e 6c 4f 66 66 2b 31 36 2c 20 28  d, jrnlOff+16, (
a760: 75 33 32 20 2a 29 26 69 50 61 67 65 53 69 7a 65  u32 *)&iPageSize
a770: 29 3b 0a 20 20 69 66 28 20 72 63 3d 3d 53 51 4c  );.  if( rc==SQL
a780: 49 54 45 5f 4f 4b 20 0a 20 20 20 26 26 20 69 50  ITE_OK .   && iP
a790: 61 67 65 53 69 7a 65 3e 3d 35 31 32 20 0a 20 20  ageSize>=512 .  
a7a0: 20 26 26 20 69 50 61 67 65 53 69 7a 65 3c 3d 53   && iPageSize<=S
a7b0: 51 4c 49 54 45 5f 4d 41 58 5f 50 41 47 45 5f 53  QLITE_MAX_PAGE_S
a7c0: 49 5a 45 20 0a 20 20 20 26 26 20 28 28 69 50 61  IZE .   && ((iPa
a7d0: 67 65 53 69 7a 65 2d 31 29 26 69 50 61 67 65 53  geSize-1)&iPageS
a7e0: 69 7a 65 29 3d 3d 30 20 0a 20 20 29 7b 0a 20 20  ize)==0 .  ){.  
a7f0: 20 20 75 31 36 20 70 61 67 65 73 69 7a 65 20 3d    u16 pagesize =
a800: 20 69 50 61 67 65 53 69 7a 65 3b 0a 20 20 20 20   iPageSize;.    
a810: 72 63 20 3d 20 73 71 6c 69 74 65 33 50 61 67 65  rc = sqlite3Page
a820: 72 53 65 74 50 61 67 65 73 69 7a 65 28 70 50 61  rSetPagesize(pPa
a830: 67 65 72 2c 20 26 70 61 67 65 73 69 7a 65 29 3b  ger, &pagesize);
a840: 0a 20 20 7d 0a 20 20 69 66 28 20 72 63 20 29 20  .  }.  if( rc ) 
a850: 72 65 74 75 72 6e 20 72 63 3b 0a 0a 20 20 2f 2a  return rc;..  /*
a860: 20 55 70 64 61 74 65 20 74 68 65 20 61 73 73 75   Update the assu
a870: 6d 65 64 20 73 65 63 74 6f 72 2d 73 69 7a 65 20  med sector-size 
a880: 74 6f 20 6d 61 74 63 68 20 74 68 65 20 76 61 6c  to match the val
a890: 75 65 20 75 73 65 64 20 62 79 20 0a 20 20 2a 2a  ue used by .  **
a8a0: 20 74 68 65 20 70 72 6f 63 65 73 73 20 74 68 61   the process tha
a8b0: 74 20 63 72 65 61 74 65 64 20 74 68 69 73 20 6a  t created this j
a8c0: 6f 75 72 6e 61 6c 2e 20 49 66 20 74 68 69 73 20  ournal. If this 
a8d0: 6a 6f 75 72 6e 61 6c 20 77 61 73 0a 20 20 2a 2a  journal was.  **
a8e0: 20 63 72 65 61 74 65 64 20 62 79 20 61 20 70 72   created by a pr
a8f0: 6f 63 65 73 73 20 6f 74 68 65 72 20 74 68 61 6e  ocess other than
a900: 20 74 68 69 73 20 6f 6e 65 2c 20 74 68 65 6e 20   this one, then 
a910: 74 68 69 73 20 72 6f 75 74 69 6e 65 0a 20 20 2a  this routine.  *
a920: 2a 20 69 73 20 62 65 69 6e 67 20 63 61 6c 6c 65  * is being calle
a930: 64 20 66 72 6f 6d 20 77 69 74 68 69 6e 20 70 61  d from within pa
a940: 67 65 72 5f 70 6c 61 79 62 61 63 6b 28 29 2e 20  ger_playback(). 
a950: 54 68 65 20 6c 6f 63 61 6c 20 76 61 6c 75 65 0a  The local value.
a960: 20 20 2a 2a 20 6f 66 20 50 61 67 65 72 2e 73 65    ** of Pager.se
a970: 63 74 6f 72 53 69 7a 65 20 69 73 20 72 65 73 74  ctorSize is rest
a980: 6f 72 65 64 20 61 74 20 74 68 65 20 65 6e 64 20  ored at the end 
a990: 6f 66 20 74 68 61 74 20 72 6f 75 74 69 6e 65 2e  of that routine.
a9a0: 0a 20 20 2a 2f 0a 20 20 72 63 20 3d 20 72 65 61  .  */.  rc = rea
a9b0: 64 33 32 62 69 74 73 28 70 50 61 67 65 72 2d 3e  d32bits(pPager->
a9c0: 6a 66 64 2c 20 6a 72 6e 6c 4f 66 66 2b 31 32 2c  jfd, jrnlOff+12,
a9d0: 20 28 75 33 32 20 2a 29 26 70 50 61 67 65 72 2d   (u32 *)&pPager-
a9e0: 3e 73 65 63 74 6f 72 53 69 7a 65 29 3b 0a 20 20  >sectorSize);.  
a9f0: 69 66 28 20 72 63 20 29 20 72 65 74 75 72 6e 20  if( rc ) return 
aa00: 72 63 3b 0a 0a 20 20 70 50 61 67 65 72 2d 3e 6a  rc;..  pPager->j
aa10: 6f 75 72 6e 61 6c 4f 66 66 20 2b 3d 20 4a 4f 55  ournalOff += JOU
aa20: 52 4e 41 4c 5f 48 44 52 5f 53 5a 28 70 50 61 67  RNAL_HDR_SZ(pPag
aa30: 65 72 29 3b 0a 20 20 72 65 74 75 72 6e 20 53 51  er);.  return SQ
aa40: 4c 49 54 45 5f 4f 4b 3b 0a 7d 0a 0a 0a 2f 2a 0a  LITE_OK;.}.../*.
aa50: 2a 2a 20 57 72 69 74 65 20 74 68 65 20 73 75 70  ** Write the sup
aa60: 70 6c 69 65 64 20 6d 61 73 74 65 72 20 6a 6f 75  plied master jou
aa70: 72 6e 61 6c 20 6e 61 6d 65 20 69 6e 74 6f 20 74  rnal name into t
aa80: 68 65 20 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 20  he journal file 
aa90: 66 6f 72 20 70 61 67 65 72 0a 2a 2a 20 70 50 61  for pager.** pPa
aaa0: 67 65 72 20 61 74 20 74 68 65 20 63 75 72 72 65  ger at the curre
aab0: 6e 74 20 6c 6f 63 61 74 69 6f 6e 2e 20 54 68 65  nt location. The
aac0: 20 6d 61 73 74 65 72 20 6a 6f 75 72 6e 61 6c 20   master journal 
aad0: 6e 61 6d 65 20 6d 75 73 74 20 62 65 20 74 68 65  name must be the
aae0: 20 6c 61 73 74 0a 2a 2a 20 74 68 69 6e 67 20 77   last.** thing w
aaf0: 72 69 74 74 65 6e 20 74 6f 20 61 20 6a 6f 75 72  ritten to a jour
ab00: 6e 61 6c 20 66 69 6c 65 2e 20 49 66 20 74 68 65  nal file. If the
ab10: 20 70 61 67 65 72 20 69 73 20 69 6e 20 66 75 6c   pager is in ful
ab20: 6c 2d 73 79 6e 63 20 6d 6f 64 65 2c 20 74 68 65  l-sync mode, the
ab30: 0a 2a 2a 20 6a 6f 75 72 6e 61 6c 20 66 69 6c 65  .** journal file
ab40: 20 64 65 73 63 72 69 70 74 6f 72 20 69 73 20 61   descriptor is a
ab50: 64 76 61 6e 63 65 64 20 74 6f 20 74 68 65 20 6e  dvanced to the n
ab60: 65 78 74 20 73 65 63 74 6f 72 20 62 6f 75 6e 64  ext sector bound
ab70: 61 72 79 20 62 65 66 6f 72 65 0a 2a 2a 20 61 6e  ary before.** an
ab80: 79 74 68 69 6e 67 20 69 73 20 77 72 69 74 74 65  ything is writte
ab90: 6e 2e 20 54 68 65 20 66 6f 72 6d 61 74 20 69 73  n. The format is
aba0: 3a 0a 2a 2a 0a 2a 2a 20 2b 20 34 20 62 79 74 65  :.**.** + 4 byte
abb0: 73 3a 20 50 41 47 45 52 5f 4d 4a 5f 50 47 4e 4f  s: PAGER_MJ_PGNO
abc0: 2e 0a 2a 2a 20 2b 20 4e 20 62 79 74 65 73 3a 20  ..** + N bytes: 
abd0: 6c 65 6e 67 74 68 20 6f 66 20 6d 61 73 74 65 72  length of master
abe0: 20 6a 6f 75 72 6e 61 6c 20 6e 61 6d 65 2e 0a 2a   journal name..*
abf0: 2a 20 2b 20 34 20 62 79 74 65 73 3a 20 4e 0a 2a  * + 4 bytes: N.*
ac00: 2a 20 2b 20 34 20 62 79 74 65 73 3a 20 4d 61 73  * + 4 bytes: Mas
ac10: 74 65 72 20 6a 6f 75 72 6e 61 6c 20 6e 61 6d 65  ter journal name
ac20: 20 63 68 65 63 6b 73 75 6d 2e 0a 2a 2a 20 2b 20   checksum..** + 
ac30: 38 20 62 79 74 65 73 3a 20 61 4a 6f 75 72 6e 61  8 bytes: aJourna
ac40: 6c 4d 61 67 69 63 5b 5d 2e 0a 2a 2a 0a 2a 2a 20  lMagic[]..**.** 
ac50: 54 68 65 20 6d 61 73 74 65 72 20 6a 6f 75 72 6e  The master journ
ac60: 61 6c 20 70 61 67 65 20 63 68 65 63 6b 73 75 6d  al page checksum
ac70: 20 69 73 20 74 68 65 20 73 75 6d 20 6f 66 20 74   is the sum of t
ac80: 68 65 20 62 79 74 65 73 20 69 6e 20 74 68 65 20  he bytes in the 
ac90: 6d 61 73 74 65 72 0a 2a 2a 20 6a 6f 75 72 6e 61  master.** journa
aca0: 6c 20 6e 61 6d 65 2e 0a 2a 2a 0a 2a 2a 20 49 66  l name..**.** If
acb0: 20 7a 4d 61 73 74 65 72 20 69 73 20 61 20 4e 55   zMaster is a NU
acc0: 4c 4c 20 70 6f 69 6e 74 65 72 20 28 6f 63 63 75  LL pointer (occu
acd0: 72 73 20 66 6f 72 20 61 20 73 69 6e 67 6c 65 20  rs for a single 
ace0: 64 61 74 61 62 61 73 65 20 74 72 61 6e 73 61 63  database transac
acf0: 74 69 6f 6e 29 2c 20 0a 2a 2a 20 74 68 69 73 20  tion), .** this 
ad00: 63 61 6c 6c 20 69 73 20 61 20 6e 6f 2d 6f 70 2e  call is a no-op.
ad10: 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74 20 77  .*/.static int w
ad20: 72 69 74 65 4d 61 73 74 65 72 4a 6f 75 72 6e 61  riteMasterJourna
ad30: 6c 28 50 61 67 65 72 20 2a 70 50 61 67 65 72 2c  l(Pager *pPager,
ad40: 20 63 6f 6e 73 74 20 63 68 61 72 20 2a 7a 4d 61   const char *zMa
ad50: 73 74 65 72 29 7b 0a 20 20 69 6e 74 20 72 63 3b  ster){.  int rc;
ad60: 0a 20 20 69 6e 74 20 6c 65 6e 3b 20 0a 20 20 69  .  int len; .  i
ad70: 6e 74 20 69 3b 20 0a 20 20 69 36 34 20 6a 72 6e  nt i; .  i64 jrn
ad80: 6c 4f 66 66 3b 0a 20 20 75 33 32 20 63 6b 73 75  lOff;.  u32 cksu
ad90: 6d 20 3d 20 30 3b 0a 20 20 63 68 61 72 20 7a 42  m = 0;.  char zB
ada0: 75 66 5b 73 69 7a 65 6f 66 28 61 4a 6f 75 72 6e  uf[sizeof(aJourn
adb0: 61 6c 4d 61 67 69 63 29 2b 32 2a 34 5d 3b 0a 0a  alMagic)+2*4];..
adc0: 20 20 69 66 28 20 21 7a 4d 61 73 74 65 72 20 7c    if( !zMaster |
add0: 7c 20 70 50 61 67 65 72 2d 3e 73 65 74 4d 61 73  | pPager->setMas
ade0: 74 65 72 29 20 72 65 74 75 72 6e 20 53 51 4c 49  ter) return SQLI
adf0: 54 45 5f 4f 4b 3b 0a 20 20 70 50 61 67 65 72 2d  TE_OK;.  pPager-
ae00: 3e 73 65 74 4d 61 73 74 65 72 20 3d 20 31 3b 0a  >setMaster = 1;.
ae10: 0a 20 20 6c 65 6e 20 3d 20 73 74 72 6c 65 6e 28  .  len = strlen(
ae20: 7a 4d 61 73 74 65 72 29 3b 0a 20 20 66 6f 72 28  zMaster);.  for(
ae30: 69 3d 30 3b 20 69 3c 6c 65 6e 3b 20 69 2b 2b 29  i=0; i<len; i++)
ae40: 7b 0a 20 20 20 20 63 6b 73 75 6d 20 2b 3d 20 7a  {.    cksum += z
ae50: 4d 61 73 74 65 72 5b 69 5d 3b 0a 20 20 7d 0a 0a  Master[i];.  }..
ae60: 20 20 2f 2a 20 49 66 20 69 6e 20 66 75 6c 6c 2d    /* If in full-
ae70: 73 79 6e 63 20 6d 6f 64 65 2c 20 61 64 76 61 6e  sync mode, advan
ae80: 63 65 20 74 6f 20 74 68 65 20 6e 65 78 74 20 64  ce to the next d
ae90: 69 73 6b 20 73 65 63 74 6f 72 20 62 65 66 6f 72  isk sector befor
aea0: 65 20 77 72 69 74 69 6e 67 0a 20 20 2a 2a 20 74  e writing.  ** t
aeb0: 68 65 20 6d 61 73 74 65 72 20 6a 6f 75 72 6e 61  he master journa
aec0: 6c 20 6e 61 6d 65 2e 20 54 68 69 73 20 69 73 20  l name. This is 
aed0: 69 6e 20 63 61 73 65 20 74 68 65 20 70 72 65 76  in case the prev
aee0: 69 6f 75 73 20 70 61 67 65 20 77 72 69 74 74 65  ious page writte
aef0: 6e 20 74 6f 0a 20 20 2a 2a 20 74 68 65 20 6a 6f  n to.  ** the jo
af00: 75 72 6e 61 6c 20 68 61 73 20 61 6c 72 65 61 64  urnal has alread
af10: 79 20 62 65 65 6e 20 73 79 6e 63 65 64 2e 0a 20  y been synced.. 
af20: 20 2a 2f 0a 20 20 69 66 28 20 70 50 61 67 65 72   */.  if( pPager
af30: 2d 3e 66 75 6c 6c 53 79 6e 63 20 29 7b 0a 20 20  ->fullSync ){.  
af40: 20 20 73 65 65 6b 4a 6f 75 72 6e 61 6c 48 64 72    seekJournalHdr
af50: 28 70 50 61 67 65 72 29 3b 0a 20 20 7d 0a 20 20  (pPager);.  }.  
af60: 6a 72 6e 6c 4f 66 66 20 3d 20 70 50 61 67 65 72  jrnlOff = pPager
af70: 2d 3e 6a 6f 75 72 6e 61 6c 4f 66 66 3b 0a 20 20  ->journalOff;.  
af80: 70 50 61 67 65 72 2d 3e 6a 6f 75 72 6e 61 6c 4f  pPager->journalO
af90: 66 66 20 2b 3d 20 28 6c 65 6e 2b 32 30 29 3b 0a  ff += (len+20);.
afa0: 0a 20 20 72 63 20 3d 20 77 72 69 74 65 33 32 62  .  rc = write32b
afb0: 69 74 73 28 70 50 61 67 65 72 2d 3e 6a 66 64 2c  its(pPager->jfd,
afc0: 20 6a 72 6e 6c 4f 66 66 2c 20 50 41 47 45 52 5f   jrnlOff, PAGER_
afd0: 4d 4a 5f 50 47 4e 4f 28 70 50 61 67 65 72 29 29  MJ_PGNO(pPager))
afe0: 3b 0a 20 20 69 66 28 20 72 63 21 3d 53 51 4c 49  ;.  if( rc!=SQLI
aff0: 54 45 5f 4f 4b 20 29 20 72 65 74 75 72 6e 20 72  TE_OK ) return r
b000: 63 3b 0a 20 20 6a 72 6e 6c 4f 66 66 20 2b 3d 20  c;.  jrnlOff += 
b010: 34 3b 0a 0a 20 20 72 63 20 3d 20 73 71 6c 69 74  4;..  rc = sqlit
b020: 65 33 4f 73 57 72 69 74 65 28 70 50 61 67 65 72  e3OsWrite(pPager
b030: 2d 3e 6a 66 64 2c 20 7a 4d 61 73 74 65 72 2c 20  ->jfd, zMaster, 
b040: 6c 65 6e 2c 20 6a 72 6e 6c 4f 66 66 29 3b 0a 20  len, jrnlOff);. 
b050: 20 69 66 28 20 72 63 21 3d 53 51 4c 49 54 45 5f   if( rc!=SQLITE_
b060: 4f 4b 20 29 20 72 65 74 75 72 6e 20 72 63 3b 0a  OK ) return rc;.
b070: 20 20 6a 72 6e 6c 4f 66 66 20 2b 3d 20 6c 65 6e    jrnlOff += len
b080: 3b 0a 0a 20 20 70 75 74 33 32 62 69 74 73 28 7a  ;..  put32bits(z
b090: 42 75 66 2c 20 6c 65 6e 29 3b 0a 20 20 70 75 74  Buf, len);.  put
b0a0: 33 32 62 69 74 73 28 26 7a 42 75 66 5b 34 5d 2c  32bits(&zBuf[4],
b0b0: 20 63 6b 73 75 6d 29 3b 0a 20 20 6d 65 6d 63 70   cksum);.  memcp
b0c0: 79 28 26 7a 42 75 66 5b 38 5d 2c 20 61 4a 6f 75  y(&zBuf[8], aJou
b0d0: 72 6e 61 6c 4d 61 67 69 63 2c 20 73 69 7a 65 6f  rnalMagic, sizeo
b0e0: 66 28 61 4a 6f 75 72 6e 61 6c 4d 61 67 69 63 29  f(aJournalMagic)
b0f0: 29 3b 0a 20 20 72 63 20 3d 20 73 71 6c 69 74 65  );.  rc = sqlite
b100: 33 4f 73 57 72 69 74 65 28 70 50 61 67 65 72 2d  3OsWrite(pPager-
b110: 3e 6a 66 64 2c 20 7a 42 75 66 2c 20 38 2b 73 69  >jfd, zBuf, 8+si
b120: 7a 65 6f 66 28 61 4a 6f 75 72 6e 61 6c 4d 61 67  zeof(aJournalMag
b130: 69 63 29 2c 20 6a 72 6e 6c 4f 66 66 29 3b 0a 20  ic), jrnlOff);. 
b140: 20 70 50 61 67 65 72 2d 3e 6e 65 65 64 53 79 6e   pPager->needSyn
b150: 63 20 3d 20 21 70 50 61 67 65 72 2d 3e 6e 6f 53  c = !pPager->noS
b160: 79 6e 63 3b 0a 20 20 72 65 74 75 72 6e 20 72 63  ync;.  return rc
b170: 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 41 64 64 20 6f  ;.}../*.** Add o
b180: 72 20 72 65 6d 6f 76 65 20 61 20 70 61 67 65 20  r remove a page 
b190: 66 72 6f 6d 20 74 68 65 20 6c 69 73 74 20 6f 66  from the list of
b1a0: 20 61 6c 6c 20 70 61 67 65 73 20 74 68 61 74 20   all pages that 
b1b0: 61 72 65 20 69 6e 20 74 68 65 0a 2a 2a 20 73 74  are in the.** st
b1c0: 61 74 65 6d 65 6e 74 20 6a 6f 75 72 6e 61 6c 2e  atement journal.
b1d0: 0a 2a 2a 0a 2a 2a 20 54 68 65 20 50 61 67 65 72  .**.** The Pager
b1e0: 20 6b 65 65 70 73 20 61 20 73 65 70 61 72 61 74   keeps a separat
b1f0: 65 20 6c 69 73 74 20 6f 66 20 70 61 67 65 73 20  e list of pages 
b200: 74 68 61 74 20 61 72 65 20 63 75 72 72 65 6e 74  that are current
b210: 6c 79 20 69 6e 0a 2a 2a 20 74 68 65 20 73 74 61  ly in.** the sta
b220: 74 65 6d 65 6e 74 20 6a 6f 75 72 6e 61 6c 2e 20  tement journal. 
b230: 20 54 68 69 73 20 68 65 6c 70 73 20 74 68 65 20   This helps the 
b240: 73 71 6c 69 74 65 33 50 61 67 65 72 53 74 6d 74  sqlite3PagerStmt
b250: 43 6f 6d 6d 69 74 28 29 0a 2a 2a 20 72 6f 75 74  Commit().** rout
b260: 69 6e 65 20 72 75 6e 20 4d 55 43 48 20 66 61 73  ine run MUCH fas
b270: 74 65 72 20 66 6f 72 20 74 68 65 20 63 6f 6d 6d  ter for the comm
b280: 6f 6e 20 63 61 73 65 20 77 68 65 72 65 20 74 68  on case where th
b290: 65 72 65 20 61 72 65 20 6d 61 6e 79 0a 2a 2a 20  ere are many.** 
b2a0: 70 61 67 65 73 20 69 6e 20 6d 65 6d 6f 72 79 20  pages in memory 
b2b0: 62 75 74 20 6f 6e 6c 79 20 61 20 66 65 77 20 61  but only a few a
b2c0: 72 65 20 69 6e 20 74 68 65 20 73 74 61 74 65 6d  re in the statem
b2d0: 65 6e 74 20 6a 6f 75 72 6e 61 6c 2e 0a 2a 2f 0a  ent journal..*/.
b2e0: 73 74 61 74 69 63 20 76 6f 69 64 20 70 61 67 65  static void page
b2f0: 5f 61 64 64 5f 74 6f 5f 73 74 6d 74 5f 6c 69 73  _add_to_stmt_lis
b300: 74 28 50 67 48 64 72 20 2a 70 50 67 29 7b 0a 20  t(PgHdr *pPg){. 
b310: 20 50 61 67 65 72 20 2a 70 50 61 67 65 72 20 3d   Pager *pPager =
b320: 20 70 50 67 2d 3e 70 50 61 67 65 72 3b 0a 20 20   pPg->pPager;.  
b330: 50 67 48 69 73 74 6f 72 79 20 2a 70 48 69 73 74  PgHistory *pHist
b340: 20 3d 20 50 47 48 44 52 5f 54 4f 5f 48 49 53 54   = PGHDR_TO_HIST
b350: 28 70 50 67 2c 20 70 50 61 67 65 72 29 3b 0a 20  (pPg, pPager);. 
b360: 20 61 73 73 65 72 74 28 20 4d 45 4d 44 42 20 29   assert( MEMDB )
b370: 3b 0a 20 20 69 66 28 20 21 70 48 69 73 74 2d 3e  ;.  if( !pHist->
b380: 69 6e 53 74 6d 74 20 29 7b 0a 20 20 20 20 61 73  inStmt ){.    as
b390: 73 65 72 74 28 20 70 48 69 73 74 2d 3e 70 50 72  sert( pHist->pPr
b3a0: 65 76 53 74 6d 74 3d 3d 30 20 26 26 20 70 48 69  evStmt==0 && pHi
b3b0: 73 74 2d 3e 70 4e 65 78 74 53 74 6d 74 3d 3d 30  st->pNextStmt==0
b3c0: 20 29 3b 0a 20 20 20 20 69 66 28 20 70 50 61 67   );.    if( pPag
b3d0: 65 72 2d 3e 70 53 74 6d 74 20 29 7b 0a 20 20 20  er->pStmt ){.   
b3e0: 20 20 20 50 47 48 44 52 5f 54 4f 5f 48 49 53 54     PGHDR_TO_HIST
b3f0: 28 70 50 61 67 65 72 2d 3e 70 53 74 6d 74 2c 20  (pPager->pStmt, 
b400: 70 50 61 67 65 72 29 2d 3e 70 50 72 65 76 53 74  pPager)->pPrevSt
b410: 6d 74 20 3d 20 70 50 67 3b 0a 20 20 20 20 7d 0a  mt = pPg;.    }.
b420: 20 20 20 20 70 48 69 73 74 2d 3e 70 4e 65 78 74      pHist->pNext
b430: 53 74 6d 74 20 3d 20 70 50 61 67 65 72 2d 3e 70  Stmt = pPager->p
b440: 53 74 6d 74 3b 0a 20 20 20 20 70 50 61 67 65 72  Stmt;.    pPager
b450: 2d 3e 70 53 74 6d 74 20 3d 20 70 50 67 3b 0a 20  ->pStmt = pPg;. 
b460: 20 20 20 70 48 69 73 74 2d 3e 69 6e 53 74 6d 74     pHist->inStmt
b470: 20 3d 20 31 3b 0a 20 20 7d 0a 7d 0a 0a 2f 2a 0a   = 1;.  }.}../*.
b480: 2a 2a 20 46 69 6e 64 20 61 20 70 61 67 65 20 69  ** Find a page i
b490: 6e 20 74 68 65 20 68 61 73 68 20 74 61 62 6c 65  n the hash table
b4a0: 20 67 69 76 65 6e 20 69 74 73 20 70 61 67 65 20   given its page 
b4b0: 6e 75 6d 62 65 72 2e 20 20 52 65 74 75 72 6e 0a  number.  Return.
b4c0: 2a 2a 20 61 20 70 6f 69 6e 74 65 72 20 74 6f 20  ** a pointer to 
b4d0: 74 68 65 20 70 61 67 65 20 6f 72 20 4e 55 4c 4c  the page or NULL
b4e0: 20 69 66 20 6e 6f 74 20 66 6f 75 6e 64 2e 0a 2a   if not found..*
b4f0: 2f 0a 73 74 61 74 69 63 20 50 67 48 64 72 20 2a  /.static PgHdr *
b500: 70 61 67 65 72 5f 6c 6f 6f 6b 75 70 28 50 61 67  pager_lookup(Pag
b510: 65 72 20 2a 70 50 61 67 65 72 2c 20 50 67 6e 6f  er *pPager, Pgno
b520: 20 70 67 6e 6f 29 7b 0a 20 20 50 67 48 64 72 20   pgno){.  PgHdr 
b530: 2a 70 3b 0a 20 20 69 66 28 20 70 50 61 67 65 72  *p;.  if( pPager
b540: 2d 3e 61 48 61 73 68 3d 3d 30 20 29 20 72 65 74  ->aHash==0 ) ret
b550: 75 72 6e 20 30 3b 0a 20 20 70 20 3d 20 70 50 61  urn 0;.  p = pPa
b560: 67 65 72 2d 3e 61 48 61 73 68 5b 70 67 6e 6f 20  ger->aHash[pgno 
b570: 26 20 28 70 50 61 67 65 72 2d 3e 6e 48 61 73 68  & (pPager->nHash
b580: 2d 31 29 5d 3b 0a 20 20 77 68 69 6c 65 28 20 70  -1)];.  while( p
b590: 20 26 26 20 70 2d 3e 70 67 6e 6f 21 3d 70 67 6e   && p->pgno!=pgn
b5a0: 6f 20 29 7b 0a 20 20 20 20 70 20 3d 20 70 2d 3e  o ){.    p = p->
b5b0: 70 4e 65 78 74 48 61 73 68 3b 0a 20 20 7d 0a 20  pNextHash;.  }. 
b5c0: 20 72 65 74 75 72 6e 20 70 3b 0a 7d 0a 0a 2f 2a   return p;.}../*
b5d0: 0a 2a 2a 20 43 6c 65 61 72 20 74 68 65 20 69 6e  .** Clear the in
b5e0: 2d 6d 65 6d 6f 72 79 20 63 61 63 68 65 2e 20 20  -memory cache.  
b5f0: 54 68 69 73 20 72 6f 75 74 69 6e 65 0a 2a 2a 20  This routine.** 
b600: 73 65 74 73 20 74 68 65 20 73 74 61 74 65 20 6f  sets the state o
b610: 66 20 74 68 65 20 70 61 67 65 72 20 62 61 63 6b  f the pager back
b620: 20 74 6f 20 77 68 61 74 20 69 74 20 77 61 73 20   to what it was 
b630: 77 68 65 6e 20 69 74 20 77 61 73 20 66 69 72 73  when it was firs
b640: 74 0a 2a 2a 20 6f 70 65 6e 65 64 2e 20 20 41 6e  t.** opened.  An
b650: 79 20 6f 75 74 73 74 61 6e 64 69 6e 67 20 70 61  y outstanding pa
b660: 67 65 73 20 61 72 65 20 69 6e 76 61 6c 69 64 61  ges are invalida
b670: 74 65 64 20 61 6e 64 20 73 75 62 73 65 71 75 65  ted and subseque
b680: 6e 74 20 61 74 74 65 6d 70 74 73 0a 2a 2a 20 74  nt attempts.** t
b690: 6f 20 61 63 63 65 73 73 20 74 68 6f 73 65 20 70  o access those p
b6a0: 61 67 65 73 20 77 69 6c 6c 20 6c 69 6b 65 6c 79  ages will likely
b6b0: 20 72 65 73 75 6c 74 20 69 6e 20 61 20 63 6f 72   result in a cor
b6c0: 65 64 75 6d 70 2e 0a 2a 2f 0a 73 74 61 74 69 63  edump..*/.static
b6d0: 20 76 6f 69 64 20 70 61 67 65 72 5f 72 65 73 65   void pager_rese
b6e0: 74 28 50 61 67 65 72 20 2a 70 50 61 67 65 72 29  t(Pager *pPager)
b6f0: 7b 0a 20 20 50 67 48 64 72 20 2a 70 50 67 2c 20  {.  PgHdr *pPg, 
b700: 2a 70 4e 65 78 74 3b 0a 20 20 69 66 28 20 70 50  *pNext;.  if( pP
b710: 61 67 65 72 2d 3e 65 72 72 43 6f 64 65 20 29 20  ager->errCode ) 
b720: 72 65 74 75 72 6e 3b 0a 20 20 66 6f 72 28 70 50  return;.  for(pP
b730: 67 3d 70 50 61 67 65 72 2d 3e 70 41 6c 6c 3b 20  g=pPager->pAll; 
b740: 70 50 67 3b 20 70 50 67 3d 70 4e 65 78 74 29 7b  pPg; pPg=pNext){
b750: 0a 20 20 20 20 49 4f 54 52 41 43 45 28 28 22 50  .    IOTRACE(("P
b760: 47 46 52 45 45 20 25 70 20 25 64 5c 6e 22 2c 20  GFREE %p %d\n", 
b770: 70 50 61 67 65 72 2c 20 70 50 67 2d 3e 70 67 6e  pPager, pPg->pgn
b780: 6f 29 29 3b 0a 20 20 20 20 50 41 47 45 52 5f 49  o));.    PAGER_I
b790: 4e 43 52 28 73 71 6c 69 74 65 33 5f 70 61 67 65  NCR(sqlite3_page
b7a0: 72 5f 70 67 66 72 65 65 5f 63 6f 75 6e 74 29 3b  r_pgfree_count);
b7b0: 0a 20 20 20 20 70 4e 65 78 74 20 3d 20 70 50 67  .    pNext = pPg
b7c0: 2d 3e 70 4e 65 78 74 41 6c 6c 3b 0a 20 20 20 20  ->pNextAll;.    
b7d0: 6c 72 75 4c 69 73 74 52 65 6d 6f 76 65 28 70 50  lruListRemove(pP
b7e0: 67 29 3b 0a 20 20 20 20 73 71 6c 69 74 65 33 5f  g);.    sqlite3_
b7f0: 66 72 65 65 28 70 50 67 2d 3e 70 44 61 74 61 29  free(pPg->pData)
b800: 3b 0a 20 20 20 20 73 71 6c 69 74 65 33 5f 66 72  ;.    sqlite3_fr
b810: 65 65 28 70 50 67 29 3b 0a 20 20 7d 0a 20 20 61  ee(pPg);.  }.  a
b820: 73 73 65 72 74 28 70 50 61 67 65 72 2d 3e 6c 72  ssert(pPager->lr
b830: 75 2e 70 46 69 72 73 74 3d 3d 30 29 3b 0a 20 20  u.pFirst==0);.  
b840: 61 73 73 65 72 74 28 70 50 61 67 65 72 2d 3e 6c  assert(pPager->l
b850: 72 75 2e 70 46 69 72 73 74 53 79 6e 63 65 64 3d  ru.pFirstSynced=
b860: 3d 30 29 3b 0a 20 20 61 73 73 65 72 74 28 70 50  =0);.  assert(pP
b870: 61 67 65 72 2d 3e 6c 72 75 2e 70 4c 61 73 74 3d  ager->lru.pLast=
b880: 3d 30 29 3b 0a 20 20 70 50 61 67 65 72 2d 3e 70  =0);.  pPager->p
b890: 53 74 6d 74 20 3d 20 30 3b 0a 20 20 70 50 61 67  Stmt = 0;.  pPag
b8a0: 65 72 2d 3e 70 41 6c 6c 20 3d 20 30 3b 0a 20 20  er->pAll = 0;.  
b8b0: 70 50 61 67 65 72 2d 3e 70 44 69 72 74 79 20 3d  pPager->pDirty =
b8c0: 20 30 3b 0a 20 20 70 50 61 67 65 72 2d 3e 6e 48   0;.  pPager->nH
b8d0: 61 73 68 20 3d 20 30 3b 0a 20 20 73 71 6c 69 74  ash = 0;.  sqlit
b8e0: 65 33 5f 66 72 65 65 28 70 50 61 67 65 72 2d 3e  e3_free(pPager->
b8f0: 61 48 61 73 68 29 3b 0a 20 20 70 50 61 67 65 72  aHash);.  pPager
b900: 2d 3e 6e 50 61 67 65 20 3d 20 30 3b 0a 20 20 70  ->nPage = 0;.  p
b910: 50 61 67 65 72 2d 3e 61 48 61 73 68 20 3d 20 30  Pager->aHash = 0
b920: 3b 0a 20 20 70 50 61 67 65 72 2d 3e 6e 52 65 66  ;.  pPager->nRef
b930: 20 3d 20 30 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 55   = 0;.}../*.** U
b940: 6e 6c 6f 63 6b 20 74 68 65 20 64 61 74 61 62 61  nlock the databa
b950: 73 65 20 66 69 6c 65 2e 20 0a 2a 2a 0a 2a 2a 20  se file. .**.** 
b960: 49 66 20 74 68 65 20 70 61 67 65 72 20 69 73 20  If the pager is 
b970: 63 75 72 72 65 6e 74 6c 79 20 69 6e 20 65 72 72  currently in err
b980: 6f 72 20 73 74 61 74 65 2c 20 64 69 73 63 61 72  or state, discar
b990: 64 20 74 68 65 20 63 6f 6e 74 65 6e 74 73 20 6f  d the contents o
b9a0: 66 20 0a 2a 2a 20 74 68 65 20 63 61 63 68 65 20  f .** the cache 
b9b0: 61 6e 64 20 72 65 73 65 74 20 74 68 65 20 50 61  and reset the Pa
b9c0: 67 65 72 20 73 74 72 75 63 74 75 72 65 20 69 6e  ger structure in
b9d0: 74 65 72 6e 61 6c 20 73 74 61 74 65 2e 20 49 66  ternal state. If
b9e0: 20 74 68 65 72 65 20 69 73 0a 2a 2a 20 61 6e 20   there is.** an 
b9f0: 6f 70 65 6e 20 6a 6f 75 72 6e 61 6c 2d 66 69 6c  open journal-fil
ba00: 65 2c 20 74 68 65 6e 20 74 68 65 20 6e 65 78 74  e, then the next
ba10: 20 74 69 6d 65 20 61 20 73 68 61 72 65 64 2d 6c   time a shared-l
ba20: 6f 63 6b 20 69 73 20 6f 62 74 61 69 6e 65 64 0a  ock is obtained.
ba30: 2a 2a 20 6f 6e 20 74 68 65 20 70 61 67 65 72 20  ** on the pager 
ba40: 66 69 6c 65 20 28 62 79 20 74 68 69 73 20 6f 72  file (by this or
ba50: 20 61 6e 79 20 6f 74 68 65 72 20 70 72 6f 63 65   any other proce
ba60: 73 73 29 2c 20 69 74 20 77 69 6c 6c 20 62 65 0a  ss), it will be.
ba70: 2a 2a 20 74 72 65 61 74 65 64 20 61 73 20 61 20  ** treated as a 
ba80: 68 6f 74 2d 6a 6f 75 72 6e 61 6c 20 61 6e 64 20  hot-journal and 
ba90: 72 6f 6c 6c 65 64 20 62 61 63 6b 2e 0a 2a 2f 0a  rolled back..*/.
baa0: 73 74 61 74 69 63 20 76 6f 69 64 20 70 61 67 65  static void page
bab0: 72 5f 75 6e 6c 6f 63 6b 28 50 61 67 65 72 20 2a  r_unlock(Pager *
bac0: 70 50 61 67 65 72 29 7b 0a 20 20 69 66 28 20 21  pPager){.  if( !
bad0: 70 50 61 67 65 72 2d 3e 65 78 63 6c 75 73 69 76  pPager->exclusiv
bae0: 65 4d 6f 64 65 20 29 7b 0a 20 20 20 20 69 66 28  eMode ){.    if(
baf0: 20 21 4d 45 4d 44 42 20 29 7b 0a 20 20 20 20 20   !MEMDB ){.     
bb00: 20 69 6e 74 20 72 63 20 3d 20 6f 73 55 6e 6c 6f   int rc = osUnlo
bb10: 63 6b 28 70 50 61 67 65 72 2d 3e 66 64 2c 20 4e  ck(pPager->fd, N
bb20: 4f 5f 4c 4f 43 4b 29 3b 0a 20 20 20 20 20 20 69  O_LOCK);.      i
bb30: 66 28 20 72 63 20 29 20 70 50 61 67 65 72 2d 3e  f( rc ) pPager->
bb40: 65 72 72 43 6f 64 65 20 3d 20 72 63 3b 0a 20 20  errCode = rc;.  
bb50: 20 20 20 20 70 50 61 67 65 72 2d 3e 64 62 53 69      pPager->dbSi
bb60: 7a 65 20 3d 20 2d 31 3b 0a 20 20 20 20 20 20 49  ze = -1;.      I
bb70: 4f 54 52 41 43 45 28 28 22 55 4e 4c 4f 43 4b 20  OTRACE(("UNLOCK 
bb80: 25 70 5c 6e 22 2c 20 70 50 61 67 65 72 29 29 0a  %p\n", pPager)).
bb90: 0a 20 20 20 20 20 20 2f 2a 20 41 6c 77 61 79 73  .      /* Always
bba0: 20 63 6c 6f 73 65 20 74 68 65 20 6a 6f 75 72 6e   close the journ
bbb0: 61 6c 20 66 69 6c 65 20 77 68 65 6e 20 64 72 6f  al file when dro
bbc0: 70 70 69 6e 67 20 74 68 65 20 64 61 74 61 62 61  pping the databa
bbd0: 73 65 20 6c 6f 63 6b 2e 0a 20 20 20 20 20 20 2a  se lock..      *
bbe0: 2a 20 4f 74 68 65 72 77 69 73 65 2c 20 61 6e 6f  * Otherwise, ano
bbf0: 74 68 65 72 20 63 6f 6e 6e 65 63 74 69 6f 6e 20  ther connection 
bc00: 77 69 74 68 20 6a 6f 75 72 6e 61 6c 5f 6d 6f 64  with journal_mod
bc10: 65 3d 64 65 6c 65 74 65 20 6d 69 67 68 74 0a 20  e=delete might. 
bc20: 20 20 20 20 20 2a 2a 20 64 65 6c 65 74 65 20 74       ** delete t
bc30: 68 65 20 66 69 6c 65 20 6f 75 74 20 66 72 6f 6d  he file out from
bc40: 20 75 6e 64 65 72 20 75 73 2e 0a 20 20 20 20 20   under us..     
bc50: 20 2a 2f 0a 20 20 20 20 20 20 69 66 28 20 70 50   */.      if( pP
bc60: 61 67 65 72 2d 3e 6a 6f 75 72 6e 61 6c 4f 70 65  ager->journalOpe
bc70: 6e 20 29 7b 0a 20 20 20 20 20 20 20 20 73 71 6c  n ){.        sql
bc80: 69 74 65 33 4f 73 43 6c 6f 73 65 28 70 50 61 67  ite3OsClose(pPag
bc90: 65 72 2d 3e 6a 66 64 29 3b 0a 20 20 20 20 20 20  er->jfd);.      
bca0: 20 20 70 50 61 67 65 72 2d 3e 6a 6f 75 72 6e 61    pPager->journa
bcb0: 6c 4f 70 65 6e 20 3d 20 30 3b 0a 20 20 20 20 20  lOpen = 0;.     
bcc0: 20 20 20 73 71 6c 69 74 65 33 42 69 74 76 65 63     sqlite3Bitvec
bcd0: 44 65 73 74 72 6f 79 28 70 50 61 67 65 72 2d 3e  Destroy(pPager->
bce0: 70 49 6e 4a 6f 75 72 6e 61 6c 29 3b 0a 20 20 20  pInJournal);.   
bcf0: 20 20 20 20 20 70 50 61 67 65 72 2d 3e 70 49 6e       pPager->pIn
bd00: 4a 6f 75 72 6e 61 6c 20 3d 20 30 3b 0a 20 20 20  Journal = 0;.   
bd10: 20 20 20 7d 0a 0a 20 20 20 20 20 20 2f 2a 20 49     }..      /* I
bd20: 66 20 50 61 67 65 72 2e 65 72 72 43 6f 64 65 20  f Pager.errCode 
bd30: 69 73 20 73 65 74 2c 20 74 68 65 20 63 6f 6e 74  is set, the cont
bd40: 65 6e 74 73 20 6f 66 20 74 68 65 20 70 61 67 65  ents of the page
bd50: 72 20 63 61 63 68 65 20 63 61 6e 6e 6f 74 20 62  r cache cannot b
bd60: 65 0a 20 20 20 20 20 20 2a 2a 20 74 72 75 73 74  e.      ** trust
bd70: 65 64 2e 20 4e 6f 77 20 74 68 61 74 20 74 68 65  ed. Now that the
bd80: 20 70 61 67 65 72 20 66 69 6c 65 20 69 73 20 75   pager file is u
bd90: 6e 6c 6f 63 6b 65 64 2c 20 74 68 65 20 63 6f 6e  nlocked, the con
bda0: 74 65 6e 74 73 20 6f 66 20 74 68 65 0a 20 20 20  tents of the.   
bdb0: 20 20 20 2a 2a 20 63 61 63 68 65 20 63 61 6e 20     ** cache can 
bdc0: 62 65 20 64 69 73 63 61 72 64 65 64 20 61 6e 64  be discarded and
bdd0: 20 74 68 65 20 65 72 72 6f 72 20 63 6f 64 65 20   the error code 
bde0: 73 61 66 65 6c 79 20 63 6c 65 61 72 65 64 2e 0a  safely cleared..
bdf0: 20 20 20 20 20 20 2a 2f 0a 20 20 20 20 20 20 69        */.      i
be00: 66 28 20 70 50 61 67 65 72 2d 3e 65 72 72 43 6f  f( pPager->errCo
be10: 64 65 20 29 7b 0a 20 20 20 20 20 20 20 20 69 66  de ){.        if
be20: 28 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20  ( rc==SQLITE_OK 
be30: 29 20 70 50 61 67 65 72 2d 3e 65 72 72 43 6f 64  ) pPager->errCod
be40: 65 20 3d 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20  e = SQLITE_OK;. 
be50: 20 20 20 20 20 20 20 70 61 67 65 72 5f 72 65 73         pager_res
be60: 65 74 28 70 50 61 67 65 72 29 3b 0a 20 20 20 20  et(pPager);.    
be70: 20 20 20 20 69 66 28 20 70 50 61 67 65 72 2d 3e      if( pPager->
be80: 73 74 6d 74 4f 70 65 6e 20 29 7b 0a 20 20 20 20  stmtOpen ){.    
be90: 20 20 20 20 20 20 73 71 6c 69 74 65 33 4f 73 43        sqlite3OsC
bea0: 6c 6f 73 65 28 70 50 61 67 65 72 2d 3e 73 74 66  lose(pPager->stf
beb0: 64 29 3b 0a 20 20 20 20 20 20 20 20 20 20 73 71  d);.          sq
bec0: 6c 69 74 65 33 42 69 74 76 65 63 44 65 73 74 72  lite3BitvecDestr
bed0: 6f 79 28 70 50 61 67 65 72 2d 3e 70 49 6e 53 74  oy(pPager->pInSt
bee0: 6d 74 29 3b 0a 20 20 20 20 20 20 20 20 20 20 70  mt);.          p
bef0: 50 61 67 65 72 2d 3e 70 49 6e 53 74 6d 74 20 3d  Pager->pInStmt =
bf00: 20 30 3b 0a 20 20 20 20 20 20 20 20 7d 0a 20 20   0;.        }.  
bf10: 20 20 20 20 20 20 70 50 61 67 65 72 2d 3e 73 74        pPager->st
bf20: 6d 74 4f 70 65 6e 20 3d 20 30 3b 0a 20 20 20 20  mtOpen = 0;.    
bf30: 20 20 20 20 70 50 61 67 65 72 2d 3e 73 74 6d 74      pPager->stmt
bf40: 49 6e 55 73 65 20 3d 20 30 3b 0a 20 20 20 20 20  InUse = 0;.     
bf50: 20 20 20 70 50 61 67 65 72 2d 3e 6a 6f 75 72 6e     pPager->journ
bf60: 61 6c 4f 66 66 20 3d 20 30 3b 0a 20 20 20 20 20  alOff = 0;.     
bf70: 20 20 20 70 50 61 67 65 72 2d 3e 6a 6f 75 72 6e     pPager->journ
bf80: 61 6c 53 74 61 72 74 65 64 20 3d 20 30 3b 0a 20  alStarted = 0;. 
bf90: 20 20 20 20 20 20 20 70 50 61 67 65 72 2d 3e 73         pPager->s
bfa0: 74 6d 74 41 75 74 6f 6f 70 65 6e 20 3d 20 30 3b  tmtAutoopen = 0;
bfb0: 0a 20 20 20 20 20 20 20 20 70 50 61 67 65 72 2d  .        pPager-
bfc0: 3e 6f 72 69 67 44 62 53 69 7a 65 20 3d 20 30 3b  >origDbSize = 0;
bfd0: 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 7d 0a 0a  .      }.    }..
bfe0: 20 20 20 20 69 66 28 20 21 4d 45 4d 44 42 20 7c      if( !MEMDB |
bff0: 7c 20 70 50 61 67 65 72 2d 3e 65 72 72 43 6f 64  | pPager->errCod
c000: 65 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a  e==SQLITE_OK ){.
c010: 20 20 20 20 20 20 70 50 61 67 65 72 2d 3e 73 74        pPager->st
c020: 61 74 65 20 3d 20 50 41 47 45 52 5f 55 4e 4c 4f  ate = PAGER_UNLO
c030: 43 4b 3b 0a 20 20 20 20 20 20 70 50 61 67 65 72  CK;.      pPager
c040: 2d 3e 63 68 61 6e 67 65 43 6f 75 6e 74 44 6f 6e  ->changeCountDon
c050: 65 20 3d 20 30 3b 0a 20 20 20 20 7d 0a 20 20 7d  e = 0;.    }.  }
c060: 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 45 78 65 63 75 74  .}../*.** Execut
c070: 65 20 61 20 72 6f 6c 6c 62 61 63 6b 20 69 66 20  e a rollback if 
c080: 61 20 74 72 61 6e 73 61 63 74 69 6f 6e 20 69 73  a transaction is
c090: 20 61 63 74 69 76 65 20 61 6e 64 20 75 6e 6c 6f   active and unlo
c0a0: 63 6b 20 74 68 65 20 0a 2a 2a 20 64 61 74 61 62  ck the .** datab
c0b0: 61 73 65 20 66 69 6c 65 2e 20 49 66 20 74 68 65  ase file. If the
c0c0: 20 70 61 67 65 72 20 68 61 73 20 61 6c 72 65 61   pager has alrea
c0d0: 64 79 20 65 6e 74 65 72 65 64 20 74 68 65 20 65  dy entered the e
c0e0: 72 72 6f 72 20 73 74 61 74 65 2c 20 0a 2a 2a 20  rror state, .** 
c0f0: 64 6f 20 6e 6f 74 20 61 74 74 65 6d 70 74 20 74  do not attempt t
c100: 68 65 20 72 6f 6c 6c 62 61 63 6b 2e 0a 2a 2f 0a  he rollback..*/.
c110: 73 74 61 74 69 63 20 76 6f 69 64 20 70 61 67 65  static void page
c120: 72 55 6e 6c 6f 63 6b 41 6e 64 52 6f 6c 6c 62 61  rUnlockAndRollba
c130: 63 6b 28 50 61 67 65 72 20 2a 70 29 7b 0a 20 20  ck(Pager *p){.  
c140: 2f 2a 20 61 73 73 65 72 74 28 20 70 2d 3e 73 74  /* assert( p->st
c150: 61 74 65 3e 3d 50 41 47 45 52 5f 52 45 53 45 52  ate>=PAGER_RESER
c160: 56 45 44 20 7c 7c 20 70 2d 3e 6a 6f 75 72 6e 61  VED || p->journa
c170: 6c 4f 70 65 6e 3d 3d 30 20 29 3b 20 2a 2f 0a 20  lOpen==0 ); */. 
c180: 20 69 66 28 20 70 2d 3e 65 72 72 43 6f 64 65 3d   if( p->errCode=
c190: 3d 53 51 4c 49 54 45 5f 4f 4b 20 26 26 20 70 2d  =SQLITE_OK && p-
c1a0: 3e 73 74 61 74 65 3e 3d 50 41 47 45 52 5f 52 45  >state>=PAGER_RE
c1b0: 53 45 52 56 45 44 20 29 7b 0a 20 20 20 20 73 71  SERVED ){.    sq
c1c0: 6c 69 74 65 33 50 61 67 65 72 52 6f 6c 6c 62 61  lite3PagerRollba
c1d0: 63 6b 28 70 29 3b 0a 20 20 7d 0a 20 20 70 61 67  ck(p);.  }.  pag
c1e0: 65 72 5f 75 6e 6c 6f 63 6b 28 70 29 3b 0a 23 69  er_unlock(p);.#i
c1f0: 66 20 30 0a 20 20 61 73 73 65 72 74 28 20 70 2d  f 0.  assert( p-
c200: 3e 65 72 72 43 6f 64 65 20 7c 7c 20 21 70 2d 3e  >errCode || !p->
c210: 6a 6f 75 72 6e 61 6c 4f 70 65 6e 20 7c 7c 20 28  journalOpen || (
c220: 70 2d 3e 65 78 63 6c 75 73 69 76 65 4d 6f 64 65  p->exclusiveMode
c230: 26 26 21 70 2d 3e 6a 6f 75 72 6e 61 6c 4f 66 66  &&!p->journalOff
c240: 29 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 70  ) );.  assert( p
c250: 2d 3e 65 72 72 43 6f 64 65 20 7c 7c 20 21 70 2d  ->errCode || !p-
c260: 3e 73 74 6d 74 4f 70 65 6e 20 7c 7c 20 70 2d 3e  >stmtOpen || p->
c270: 65 78 63 6c 75 73 69 76 65 4d 6f 64 65 20 29 3b  exclusiveMode );
c280: 0a 23 65 6e 64 69 66 0a 7d 0a 0a 2f 2a 0a 2a 2a  .#endif.}../*.**
c290: 20 54 68 69 73 20 72 6f 75 74 69 6e 65 20 65 6e   This routine en
c2a0: 64 73 20 61 20 74 72 61 6e 73 61 63 74 69 6f 6e  ds a transaction
c2b0: 2e 20 20 41 20 74 72 61 6e 73 61 63 74 69 6f 6e  .  A transaction
c2c0: 20 69 73 20 65 6e 64 65 64 20 62 79 20 65 69 74   is ended by eit
c2d0: 68 65 72 0a 2a 2a 20 61 20 43 4f 4d 4d 49 54 20  her.** a COMMIT 
c2e0: 6f 72 20 61 20 52 4f 4c 4c 42 41 43 4b 2e 0a 2a  or a ROLLBACK..*
c2f0: 2a 0a 2a 2a 20 57 68 65 6e 20 74 68 69 73 20 72  *.** When this r
c300: 6f 75 74 69 6e 65 20 69 73 20 63 61 6c 6c 65 64  outine is called
c310: 2c 20 74 68 65 20 70 61 67 65 72 20 68 61 73 20  , the pager has 
c320: 74 68 65 20 6a 6f 75 72 6e 61 6c 20 66 69 6c 65  the journal file
c330: 20 6f 70 65 6e 20 61 6e 64 0a 2a 2a 20 61 20 52   open and.** a R
c340: 45 53 45 52 56 45 44 20 6f 72 20 45 58 43 4c 55  ESERVED or EXCLU
c350: 53 49 56 45 20 6c 6f 63 6b 20 6f 6e 20 74 68 65  SIVE lock on the
c360: 20 64 61 74 61 62 61 73 65 2e 20 20 54 68 69 73   database.  This
c370: 20 72 6f 75 74 69 6e 65 20 77 69 6c 6c 20 72 65   routine will re
c380: 6c 65 61 73 65 0a 2a 2a 20 74 68 65 20 64 61 74  lease.** the dat
c390: 61 62 61 73 65 20 6c 6f 63 6b 20 61 6e 64 20 61  abase lock and a
c3a0: 63 71 75 69 72 65 73 20 61 20 53 48 41 52 45 44  cquires a SHARED
c3b0: 20 6c 6f 63 6b 20 69 6e 20 69 74 73 20 70 6c 61   lock in its pla
c3c0: 63 65 20 69 66 20 74 68 61 74 20 69 73 0a 2a 2a  ce if that is.**
c3d0: 20 74 68 65 20 61 70 70 72 6f 70 72 69 61 74 65   the appropriate
c3e0: 20 74 68 69 6e 67 20 74 6f 20 64 6f 2e 20 20 52   thing to do.  R
c3f0: 65 6c 65 61 73 65 20 6c 6f 63 6b 73 20 75 73 75  elease locks usu
c400: 61 6c 6c 79 20 69 73 20 61 70 70 72 6f 70 72 69  ally is appropri
c410: 61 74 65 2c 0a 2a 2a 20 75 6e 6c 65 73 73 20 77  ate,.** unless w
c420: 65 20 61 72 65 20 69 6e 20 65 78 63 6c 75 73 69  e are in exclusi
c430: 76 65 20 61 63 63 65 73 73 20 6d 6f 64 65 20 6f  ve access mode o
c440: 72 20 75 6e 6c 65 73 73 20 74 68 69 73 20 69 73  r unless this is
c450: 20 61 20 0a 2a 2a 20 43 4f 4d 4d 49 54 20 41 4e   a .** COMMIT AN
c460: 44 20 42 45 47 49 4e 20 6f 72 20 52 4f 4c 4c 42  D BEGIN or ROLLB
c470: 41 43 4b 20 41 4e 44 20 42 45 47 49 4e 20 6f 70  ACK AND BEGIN op
c480: 65 72 61 74 69 6f 6e 2e 0a 2a 2a 0a 2a 2a 20 54  eration..**.** T
c490: 68 65 20 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 20  he journal file 
c4a0: 69 73 20 65 69 74 68 65 72 20 64 65 6c 65 74 65  is either delete
c4b0: 64 20 6f 72 20 74 72 75 6e 63 61 74 65 64 2e 0a  d or truncated..
c4c0: 2a 2a 0a 2a 2a 20 54 4f 44 4f 3a 20 43 6f 6e 73  **.** TODO: Cons
c4d0: 69 64 65 72 20 6b 65 65 70 69 6e 67 20 74 68 65  ider keeping the
c4e0: 20 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 20 6f 70   journal file op
c4f0: 65 6e 20 66 6f 72 20 74 65 6d 70 6f 72 61 72 79  en for temporary
c500: 20 64 61 74 61 62 61 73 65 73 2e 0a 2a 2a 20 54   databases..** T
c510: 68 69 73 20 6d 69 67 68 74 20 67 69 76 65 20 61  his might give a
c520: 20 70 65 72 66 6f 72 6d 61 6e 63 65 20 69 6d 70   performance imp
c530: 72 6f 76 65 6d 65 6e 74 20 6f 6e 20 77 69 6e 64  rovement on wind
c540: 6f 77 73 20 77 68 65 72 65 20 6f 70 65 6e 69 6e  ows where openin
c550: 67 0a 2a 2a 20 61 20 66 69 6c 65 20 69 73 20 61  g.** a file is a
c560: 6e 20 65 78 70 65 6e 73 69 76 65 20 6f 70 65 72  n expensive oper
c570: 61 74 69 6f 6e 2e 0a 2a 2f 0a 73 74 61 74 69 63  ation..*/.static
c580: 20 69 6e 74 20 70 61 67 65 72 5f 65 6e 64 5f 74   int pager_end_t
c590: 72 61 6e 73 61 63 74 69 6f 6e 28 50 61 67 65 72  ransaction(Pager
c5a0: 20 2a 70 50 61 67 65 72 29 7b 0a 20 20 50 67 48   *pPager){.  PgH
c5b0: 64 72 20 2a 70 50 67 3b 0a 20 20 69 6e 74 20 72  dr *pPg;.  int r
c5c0: 63 20 3d 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20  c = SQLITE_OK;. 
c5d0: 20 69 6e 74 20 72 63 32 20 3d 20 53 51 4c 49 54   int rc2 = SQLIT
c5e0: 45 5f 4f 4b 3b 0a 20 20 61 73 73 65 72 74 28 20  E_OK;.  assert( 
c5f0: 21 4d 45 4d 44 42 20 29 3b 0a 20 20 69 66 28 20  !MEMDB );.  if( 
c600: 70 50 61 67 65 72 2d 3e 73 74 61 74 65 3c 50 41  pPager->state<PA
c610: 47 45 52 5f 52 45 53 45 52 56 45 44 20 29 7b 0a  GER_RESERVED ){.
c620: 20 20 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54      return SQLIT
c630: 45 5f 4f 4b 3b 0a 20 20 7d 0a 20 20 73 71 6c 69  E_OK;.  }.  sqli
c640: 74 65 33 50 61 67 65 72 53 74 6d 74 43 6f 6d 6d  te3PagerStmtComm
c650: 69 74 28 70 50 61 67 65 72 29 3b 0a 20 20 69 66  it(pPager);.  if
c660: 28 20 70 50 61 67 65 72 2d 3e 73 74 6d 74 4f 70  ( pPager->stmtOp
c670: 65 6e 20 26 26 20 21 70 50 61 67 65 72 2d 3e 65  en && !pPager->e
c680: 78 63 6c 75 73 69 76 65 4d 6f 64 65 20 29 7b 0a  xclusiveMode ){.
c690: 20 20 20 20 73 71 6c 69 74 65 33 4f 73 43 6c 6f      sqlite3OsClo
c6a0: 73 65 28 70 50 61 67 65 72 2d 3e 73 74 66 64 29  se(pPager->stfd)
c6b0: 3b 0a 20 20 20 20 70 50 61 67 65 72 2d 3e 73 74  ;.    pPager->st
c6c0: 6d 74 4f 70 65 6e 20 3d 20 30 3b 0a 20 20 7d 0a  mtOpen = 0;.  }.
c6d0: 20 20 69 66 28 20 70 50 61 67 65 72 2d 3e 6a 6f    if( pPager->jo
c6e0: 75 72 6e 61 6c 4f 70 65 6e 20 29 7b 0a 20 20 20  urnalOpen ){.   
c6f0: 20 69 66 28 20 28 70 50 61 67 65 72 2d 3e 65 78   if( (pPager->ex
c700: 63 6c 75 73 69 76 65 4d 6f 64 65 20 7c 7c 0a 20  clusiveMode ||. 
c710: 20 20 20 20 20 20 20 20 70 50 61 67 65 72 2d 3e          pPager->
c720: 6a 6f 75 72 6e 61 6c 4d 6f 64 65 3d 3d 50 41 47  journalMode==PAG
c730: 45 52 5f 4a 4f 55 52 4e 41 4c 4d 4f 44 45 5f 50  ER_JOURNALMODE_P
c740: 45 52 53 49 53 54 29 20 0a 20 20 20 20 20 20 20  ERSIST) .       
c750: 26 26 20 28 72 63 20 3d 20 7a 65 72 6f 4a 6f 75  && (rc = zeroJou
c760: 72 6e 61 6c 48 64 72 28 70 50 61 67 65 72 29 29  rnalHdr(pPager))
c770: 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20  ==SQLITE_OK ){. 
c780: 20 20 20 20 20 70 50 61 67 65 72 2d 3e 6a 6f 75       pPager->jou
c790: 72 6e 61 6c 4f 66 66 20 3d 20 30 3b 0a 20 20 20  rnalOff = 0;.   
c7a0: 20 20 20 70 50 61 67 65 72 2d 3e 6a 6f 75 72 6e     pPager->journ
c7b0: 61 6c 53 74 61 72 74 65 64 20 3d 20 30 3b 0a 20  alStarted = 0;. 
c7c0: 20 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 20 20     }else{.      
c7d0: 73 71 6c 69 74 65 33 4f 73 43 6c 6f 73 65 28 70  sqlite3OsClose(p
c7e0: 50 61 67 65 72 2d 3e 6a 66 64 29 3b 0a 20 20 20  Pager->jfd);.   
c7f0: 20 20 20 70 50 61 67 65 72 2d 3e 6a 6f 75 72 6e     pPager->journ
c800: 61 6c 4f 70 65 6e 20 3d 20 30 3b 0a 20 20 20 20  alOpen = 0;.    
c810: 20 20 69 66 28 20 72 63 3d 3d 53 51 4c 49 54 45    if( rc==SQLITE
c820: 5f 4f 4b 20 29 7b 0a 20 20 20 20 20 20 20 20 72  _OK ){.        r
c830: 63 20 3d 20 73 71 6c 69 74 65 33 4f 73 44 65 6c  c = sqlite3OsDel
c840: 65 74 65 28 70 50 61 67 65 72 2d 3e 70 56 66 73  ete(pPager->pVfs
c850: 2c 20 70 50 61 67 65 72 2d 3e 7a 4a 6f 75 72 6e  , pPager->zJourn
c860: 61 6c 2c 20 30 29 3b 0a 20 20 20 20 20 20 7d 0a  al, 0);.      }.
c870: 20 20 20 20 7d 0a 20 20 20 20 73 71 6c 69 74 65      }.    sqlite
c880: 33 42 69 74 76 65 63 44 65 73 74 72 6f 79 28 70  3BitvecDestroy(p
c890: 50 61 67 65 72 2d 3e 70 49 6e 4a 6f 75 72 6e 61  Pager->pInJourna
c8a0: 6c 29 3b 0a 20 20 20 20 70 50 61 67 65 72 2d 3e  l);.    pPager->
c8b0: 70 49 6e 4a 6f 75 72 6e 61 6c 20 3d 20 30 3b 0a  pInJournal = 0;.
c8c0: 20 20 20 20 66 6f 72 28 70 50 67 3d 70 50 61 67      for(pPg=pPag
c8d0: 65 72 2d 3e 70 41 6c 6c 3b 20 70 50 67 3b 20 70  er->pAll; pPg; p
c8e0: 50 67 3d 70 50 67 2d 3e 70 4e 65 78 74 41 6c 6c  Pg=pPg->pNextAll
c8f0: 29 7b 0a 20 20 20 20 20 20 70 50 67 2d 3e 69 6e  ){.      pPg->in
c900: 4a 6f 75 72 6e 61 6c 20 3d 20 30 3b 0a 20 20 20  Journal = 0;.   
c910: 20 20 20 70 50 67 2d 3e 64 69 72 74 79 20 3d 20     pPg->dirty = 
c920: 30 3b 0a 20 20 20 20 20 20 70 50 67 2d 3e 6e 65  0;.      pPg->ne
c930: 65 64 53 79 6e 63 20 3d 20 30 3b 0a 20 20 20 20  edSync = 0;.    
c940: 20 20 70 50 67 2d 3e 61 6c 77 61 79 73 52 6f 6c    pPg->alwaysRol
c950: 6c 62 61 63 6b 20 3d 20 30 3b 0a 23 69 66 64 65  lback = 0;.#ifde
c960: 66 20 53 51 4c 49 54 45 5f 43 48 45 43 4b 5f 50  f SQLITE_CHECK_P
c970: 41 47 45 53 0a 20 20 20 20 20 20 70 50 67 2d 3e  AGES.      pPg->
c980: 70 61 67 65 48 61 73 68 20 3d 20 70 61 67 65 72  pageHash = pager
c990: 5f 70 61 67 65 68 61 73 68 28 70 50 67 29 3b 0a  _pagehash(pPg);.
c9a0: 23 65 6e 64 69 66 0a 20 20 20 20 7d 0a 20 20 20  #endif.    }.   
c9b0: 20 70 50 61 67 65 72 2d 3e 70 44 69 72 74 79 20   pPager->pDirty 
c9c0: 3d 20 30 3b 0a 20 20 20 20 70 50 61 67 65 72 2d  = 0;.    pPager-
c9d0: 3e 64 69 72 74 79 43 61 63 68 65 20 3d 20 30 3b  >dirtyCache = 0;
c9e0: 0a 20 20 20 20 70 50 61 67 65 72 2d 3e 6e 52 65  .    pPager->nRe
c9f0: 63 20 3d 20 30 3b 0a 20 20 7d 65 6c 73 65 7b 0a  c = 0;.  }else{.
ca00: 20 20 20 20 61 73 73 65 72 74 28 20 70 50 61 67      assert( pPag
ca10: 65 72 2d 3e 70 49 6e 4a 6f 75 72 6e 61 6c 3d 3d  er->pInJournal==
ca20: 30 20 29 3b 0a 20 20 7d 0a 0a 20 20 69 66 28 20  0 );.  }..  if( 
ca30: 21 70 50 61 67 65 72 2d 3e 65 78 63 6c 75 73 69  !pPager->exclusi
ca40: 76 65 4d 6f 64 65 20 29 7b 0a 20 20 20 20 72 63  veMode ){.    rc
ca50: 32 20 3d 20 6f 73 55 6e 6c 6f 63 6b 28 70 50 61  2 = osUnlock(pPa
ca60: 67 65 72 2d 3e 66 64 2c 20 53 48 41 52 45 44 5f  ger->fd, SHARED_
ca70: 4c 4f 43 4b 29 3b 0a 20 20 20 20 70 50 61 67 65  LOCK);.    pPage
ca80: 72 2d 3e 73 74 61 74 65 20 3d 20 50 41 47 45 52  r->state = PAGER
ca90: 5f 53 48 41 52 45 44 3b 0a 20 20 7d 65 6c 73 65  _SHARED;.  }else
caa0: 20 69 66 28 20 70 50 61 67 65 72 2d 3e 73 74 61   if( pPager->sta
cab0: 74 65 3d 3d 50 41 47 45 52 5f 53 59 4e 43 45 44  te==PAGER_SYNCED
cac0: 20 29 7b 0a 20 20 20 20 70 50 61 67 65 72 2d 3e   ){.    pPager->
cad0: 73 74 61 74 65 20 3d 20 50 41 47 45 52 5f 45 58  state = PAGER_EX
cae0: 43 4c 55 53 49 56 45 3b 0a 20 20 7d 0a 20 20 70  CLUSIVE;.  }.  p
caf0: 50 61 67 65 72 2d 3e 6f 72 69 67 44 62 53 69 7a  Pager->origDbSiz
cb00: 65 20 3d 20 30 3b 0a 20 20 70 50 61 67 65 72 2d  e = 0;.  pPager-
cb10: 3e 73 65 74 4d 61 73 74 65 72 20 3d 20 30 3b 0a  >setMaster = 0;.
cb20: 20 20 70 50 61 67 65 72 2d 3e 6e 65 65 64 53 79    pPager->needSy
cb30: 6e 63 20 3d 20 30 3b 0a 20 20 6c 72 75 4c 69 73  nc = 0;.  lruLis
cb40: 74 53 65 74 46 69 72 73 74 53 79 6e 63 65 64 28  tSetFirstSynced(
cb50: 70 50 61 67 65 72 29 3b 0a 20 20 70 50 61 67 65  pPager);.  pPage
cb60: 72 2d 3e 64 62 53 69 7a 65 20 3d 20 2d 31 3b 0a  r->dbSize = -1;.
cb70: 0a 20 20 72 65 74 75 72 6e 20 28 72 63 3d 3d 53  .  return (rc==S
cb80: 51 4c 49 54 45 5f 4f 4b 3f 72 63 32 3a 72 63 29  QLITE_OK?rc2:rc)
cb90: 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 43 6f 6d 70 75  ;.}../*.** Compu
cba0: 74 65 20 61 6e 64 20 72 65 74 75 72 6e 20 61 20  te and return a 
cbb0: 63 68 65 63 6b 73 75 6d 20 66 6f 72 20 74 68 65  checksum for the
cbc0: 20 70 61 67 65 20 6f 66 20 64 61 74 61 2e 0a 2a   page of data..*
cbd0: 2a 0a 2a 2a 20 54 68 69 73 20 69 73 20 6e 6f 74  *.** This is not
cbe0: 20 61 20 72 65 61 6c 20 63 68 65 63 6b 73 75 6d   a real checksum
cbf0: 2e 20 20 49 74 20 69 73 20 72 65 61 6c 6c 79 20  .  It is really 
cc00: 6a 75 73 74 20 74 68 65 20 73 75 6d 20 6f 66 20  just the sum of 
cc10: 74 68 65 20 0a 2a 2a 20 72 61 6e 64 6f 6d 20 69  the .** random i
cc20: 6e 69 74 69 61 6c 20 76 61 6c 75 65 20 61 6e 64  nitial value and
cc30: 20 74 68 65 20 70 61 67 65 20 6e 75 6d 62 65 72   the page number
cc40: 2e 20 20 57 65 20 65 78 70 65 72 69 6d 65 6e 74  .  We experiment
cc50: 65 64 20 77 69 74 68 0a 2a 2a 20 61 20 63 68 65  ed with.** a che
cc60: 63 6b 73 75 6d 20 6f 66 20 74 68 65 20 65 6e 74  cksum of the ent
cc70: 69 72 65 20 64 61 74 61 2c 20 62 75 74 20 74 68  ire data, but th
cc80: 61 74 20 77 61 73 20 66 6f 75 6e 64 20 74 6f 20  at was found to 
cc90: 62 65 20 74 6f 6f 20 73 6c 6f 77 2e 0a 2a 2a 0a  be too slow..**.
cca0: 2a 2a 20 4e 6f 74 65 20 74 68 61 74 20 74 68 65  ** Note that the
ccb0: 20 70 61 67 65 20 6e 75 6d 62 65 72 20 69 73 20   page number is 
ccc0: 73 74 6f 72 65 64 20 61 74 20 74 68 65 20 62 65  stored at the be
ccd0: 67 69 6e 6e 69 6e 67 20 6f 66 20 64 61 74 61 20  ginning of data 
cce0: 61 6e 64 0a 2a 2a 20 74 68 65 20 63 68 65 63 6b  and.** the check
ccf0: 73 75 6d 20 69 73 20 73 74 6f 72 65 64 20 61 74  sum is stored at
cd00: 20 74 68 65 20 65 6e 64 2e 20 20 54 68 69 73 20   the end.  This 
cd10: 69 73 20 69 6d 70 6f 72 74 61 6e 74 2e 20 20 49  is important.  I
cd20: 66 20 6a 6f 75 72 6e 61 6c 0a 2a 2a 20 63 6f 72  f journal.** cor
cd30: 72 75 70 74 69 6f 6e 20 6f 63 63 75 72 73 20 64  ruption occurs d
cd40: 75 65 20 74 6f 20 61 20 70 6f 77 65 72 20 66 61  ue to a power fa
cd50: 69 6c 75 72 65 2c 20 74 68 65 20 6d 6f 73 74 20  ilure, the most 
cd60: 6c 69 6b 65 6c 79 20 73 63 65 6e 61 72 69 6f 0a  likely scenario.
cd70: 2a 2a 20 69 73 20 74 68 61 74 20 6f 6e 65 20 65  ** is that one e
cd80: 6e 64 20 6f 72 20 74 68 65 20 6f 74 68 65 72 20  nd or the other 
cd90: 6f 66 20 74 68 65 20 72 65 63 6f 72 64 20 77 69  of the record wi
cda0: 6c 6c 20 62 65 20 63 68 61 6e 67 65 64 2e 20 20  ll be changed.  
cdb0: 49 74 20 69 73 0a 2a 2a 20 6d 75 63 68 20 6c 65  It is.** much le
cdc0: 73 73 20 6c 69 6b 65 6c 79 20 74 68 61 74 20 74  ss likely that t
cdd0: 68 65 20 74 77 6f 20 65 6e 64 73 20 6f 66 20 74  he two ends of t
cde0: 68 65 20 6a 6f 75 72 6e 61 6c 20 72 65 63 6f 72  he journal recor
cdf0: 64 20 77 69 6c 6c 20 62 65 0a 2a 2a 20 63 6f 72  d will be.** cor
ce00: 72 65 63 74 20 61 6e 64 20 74 68 65 20 6d 69 64  rect and the mid
ce10: 64 6c 65 20 62 65 20 63 6f 72 72 75 70 74 2e 20  dle be corrupt. 
ce20: 20 54 68 75 73 2c 20 74 68 69 73 20 22 63 68 65   Thus, this "che
ce30: 63 6b 73 75 6d 22 20 73 63 68 65 6d 65 2c 0a 2a  cksum" scheme,.*
ce40: 2a 20 74 68 6f 75 67 68 20 66 61 73 74 20 61 6e  * though fast an
ce50: 64 20 73 69 6d 70 6c 65 2c 20 63 61 74 63 68 65  d simple, catche
ce60: 73 20 74 68 65 20 6d 6f 73 74 6c 79 20 6c 69 6b  s the mostly lik
ce70: 65 6c 79 20 6b 69 6e 64 20 6f 66 20 63 6f 72 72  ely kind of corr
ce80: 75 70 74 69 6f 6e 2e 0a 2a 2a 0a 2a 2a 20 46 49  uption..**.** FI
ce90: 58 20 4d 45 3a 20 20 43 6f 6e 73 69 64 65 72 20  X ME:  Consider 
cea0: 61 64 64 69 6e 67 20 65 76 65 72 79 20 32 30 30  adding every 200
ceb0: 74 68 20 28 6f 72 20 73 6f 29 20 62 79 74 65 20  th (or so) byte 
cec0: 6f 66 20 74 68 65 20 64 61 74 61 20 74 6f 20 74  of the data to t
ced0: 68 65 0a 2a 2a 20 63 68 65 63 6b 73 75 6d 2e 20  he.** checksum. 
cee0: 20 54 68 61 74 20 77 61 79 20 69 66 20 61 20 73   That way if a s
cef0: 69 6e 67 6c 65 20 70 61 67 65 20 73 70 61 6e 73  ingle page spans
cf00: 20 33 20 6f 72 20 6d 6f 72 65 20 64 69 73 6b 20   3 or more disk 
cf10: 73 65 63 74 6f 72 73 20 61 6e 64 0a 2a 2a 20 6f  sectors and.** o
cf20: 6e 6c 79 20 74 68 65 20 6d 69 64 64 6c 65 20 73  nly the middle s
cf30: 65 63 74 6f 72 20 69 73 20 63 6f 72 72 75 70 74  ector is corrupt
cf40: 2c 20 77 65 20 77 69 6c 6c 20 73 74 69 6c 6c 20  , we will still 
cf50: 68 61 76 65 20 61 20 72 65 61 73 6f 6e 61 62 6c  have a reasonabl
cf60: 65 0a 2a 2a 20 63 68 61 6e 63 65 20 6f 66 20 66  e.** chance of f
cf70: 61 69 6c 69 6e 67 20 74 68 65 20 63 68 65 63 6b  ailing the check
cf80: 73 75 6d 20 61 6e 64 20 74 68 75 73 20 64 65 74  sum and thus det
cf90: 65 63 74 69 6e 67 20 74 68 65 20 70 72 6f 62 6c  ecting the probl
cfa0: 65 6d 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 75 33  em..*/.static u3
cfb0: 32 20 70 61 67 65 72 5f 63 6b 73 75 6d 28 50 61  2 pager_cksum(Pa
cfc0: 67 65 72 20 2a 70 50 61 67 65 72 2c 20 63 6f 6e  ger *pPager, con
cfd0: 73 74 20 75 38 20 2a 61 44 61 74 61 29 7b 0a 20  st u8 *aData){. 
cfe0: 20 75 33 32 20 63 6b 73 75 6d 20 3d 20 70 50 61   u32 cksum = pPa
cff0: 67 65 72 2d 3e 63 6b 73 75 6d 49 6e 69 74 3b 0a  ger->cksumInit;.
d000: 20 20 69 6e 74 20 69 20 3d 20 70 50 61 67 65 72    int i = pPager
d010: 2d 3e 70 61 67 65 53 69 7a 65 2d 32 30 30 3b 0a  ->pageSize-200;.
d020: 20 20 77 68 69 6c 65 28 20 69 3e 30 20 29 7b 0a    while( i>0 ){.
d030: 20 20 20 20 63 6b 73 75 6d 20 2b 3d 20 61 44 61      cksum += aDa
d040: 74 61 5b 69 5d 3b 0a 20 20 20 20 69 20 2d 3d 20  ta[i];.    i -= 
d050: 32 30 30 3b 0a 20 20 7d 0a 20 20 72 65 74 75 72  200;.  }.  retur
d060: 6e 20 63 6b 73 75 6d 3b 0a 7d 0a 0a 2f 2a 20 46  n cksum;.}../* F
d070: 6f 72 77 61 72 64 20 64 65 63 6c 61 72 61 74 69  orward declarati
d080: 6f 6e 20 2a 2f 0a 73 74 61 74 69 63 20 76 6f 69  on */.static voi
d090: 64 20 6d 61 6b 65 43 6c 65 61 6e 28 50 67 48 64  d makeClean(PgHd
d0a0: 72 2a 29 3b 0a 0a 2f 2a 0a 2a 2a 20 52 65 61 64  r*);../*.** Read
d0b0: 20 61 20 73 69 6e 67 6c 65 20 70 61 67 65 20 66   a single page f
d0c0: 72 6f 6d 20 74 68 65 20 6a 6f 75 72 6e 61 6c 20  rom the journal 
d0d0: 66 69 6c 65 20 6f 70 65 6e 65 64 20 6f 6e 20 66  file opened on f
d0e0: 69 6c 65 20 64 65 73 63 72 69 70 74 6f 72 0a 2a  ile descriptor.*
d0f0: 2a 20 6a 66 64 2e 20 20 50 6c 61 79 62 61 63 6b  * jfd.  Playback
d100: 20 74 68 69 73 20 6f 6e 65 20 70 61 67 65 2e 0a   this one page..
d110: 2a 2a 0a 2a 2a 20 49 66 20 75 73 65 43 6b 73 75  **.** If useCksu
d120: 6d 3d 3d 30 20 69 74 20 6d 65 61 6e 73 20 74 68  m==0 it means th
d130: 69 73 20 6a 6f 75 72 6e 61 6c 20 64 6f 65 73 20  is journal does 
d140: 6e 6f 74 20 75 73 65 20 63 68 65 63 6b 73 75 6d  not use checksum
d150: 73 2e 20 20 43 68 65 63 6b 73 75 6d 73 0a 2a 2a  s.  Checksums.**
d160: 20 61 72 65 20 6e 6f 74 20 75 73 65 64 20 69 6e   are not used in
d170: 20 73 74 61 74 65 6d 65 6e 74 20 6a 6f 75 72 6e   statement journ
d180: 61 6c 73 20 62 65 63 61 75 73 65 20 73 74 61 74  als because stat
d190: 65 6d 65 6e 74 20 6a 6f 75 72 6e 61 6c 73 20 64  ement journals d
d1a0: 6f 20 6e 6f 74 0a 2a 2a 20 6e 65 65 64 20 74 6f  o not.** need to
d1b0: 20 73 75 72 76 69 76 65 20 70 6f 77 65 72 20 66   survive power f
d1c0: 61 69 6c 75 72 65 73 2e 0a 2a 2f 0a 73 74 61 74  ailures..*/.stat
d1d0: 69 63 20 69 6e 74 20 70 61 67 65 72 5f 70 6c 61  ic int pager_pla
d1e0: 79 62 61 63 6b 5f 6f 6e 65 5f 70 61 67 65 28 0a  yback_one_page(.
d1f0: 20 20 50 61 67 65 72 20 2a 70 50 61 67 65 72 2c    Pager *pPager,
d200: 20 0a 20 20 73 71 6c 69 74 65 33 5f 66 69 6c 65   .  sqlite3_file
d210: 20 2a 6a 66 64 2c 0a 20 20 69 36 34 20 6f 66 66   *jfd,.  i64 off
d220: 73 65 74 2c 0a 20 20 69 6e 74 20 75 73 65 43 6b  set,.  int useCk
d230: 73 75 6d 0a 29 7b 0a 20 20 69 6e 74 20 72 63 3b  sum.){.  int rc;
d240: 0a 20 20 50 67 48 64 72 20 2a 70 50 67 3b 20 20  .  PgHdr *pPg;  
d250: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
d260: 20 2f 2a 20 41 6e 20 65 78 69 73 74 69 6e 67 20   /* An existing 
d270: 70 61 67 65 20 69 6e 20 74 68 65 20 63 61 63 68  page in the cach
d280: 65 20 2a 2f 0a 20 20 50 67 6e 6f 20 70 67 6e 6f  e */.  Pgno pgno
d290: 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20  ;               
d2a0: 20 20 20 20 20 2f 2a 20 54 68 65 20 70 61 67 65       /* The page
d2b0: 20 6e 75 6d 62 65 72 20 6f 66 20 61 20 70 61 67   number of a pag
d2c0: 65 20 69 6e 20 6a 6f 75 72 6e 61 6c 20 2a 2f 0a  e in journal */.
d2d0: 20 20 75 33 32 20 63 6b 73 75 6d 3b 20 20 20 20    u32 cksum;    
d2e0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
d2f0: 2f 2a 20 43 68 65 63 6b 73 75 6d 20 75 73 65 64  /* Checksum used
d300: 20 66 6f 72 20 73 61 6e 69 74 79 20 63 68 65 63   for sanity chec
d310: 6b 69 6e 67 20 2a 2f 0a 20 20 75 38 20 2a 61 44  king */.  u8 *aD
d320: 61 74 61 20 3d 20 28 75 38 20 2a 29 70 50 61 67  ata = (u8 *)pPag
d330: 65 72 2d 3e 70 54 6d 70 53 70 61 63 65 3b 20 20  er->pTmpSpace;  
d340: 20 2f 2a 20 54 65 6d 70 20 73 74 6f 72 61 67 65   /* Temp storage
d350: 20 66 6f 72 20 61 20 70 61 67 65 20 2a 2f 0a 0a   for a page */..
d360: 20 20 2f 2a 20 75 73 65 43 6b 73 75 6d 20 73 68    /* useCksum sh
d370: 6f 75 6c 64 20 62 65 20 74 72 75 65 20 66 6f 72  ould be true for
d380: 20 74 68 65 20 6d 61 69 6e 20 6a 6f 75 72 6e 61   the main journa
d390: 6c 20 61 6e 64 20 66 61 6c 73 65 20 66 6f 72 0a  l and false for.
d3a0: 20 20 2a 2a 20 73 74 61 74 65 6d 65 6e 74 20 6a    ** statement j
d3b0: 6f 75 72 6e 61 6c 73 2e 20 20 56 65 72 69 66 79  ournals.  Verify
d3c0: 20 74 68 61 74 20 74 68 69 73 20 69 73 20 61 6c   that this is al
d3d0: 77 61 79 73 20 74 68 65 20 63 61 73 65 0a 20 20  ways the case.  
d3e0: 2a 2f 0a 20 20 61 73 73 65 72 74 28 20 6a 66 64  */.  assert( jfd
d3f0: 20 3d 3d 20 28 75 73 65 43 6b 73 75 6d 20 3f 20   == (useCksum ? 
d400: 70 50 61 67 65 72 2d 3e 6a 66 64 20 3a 20 70 50  pPager->jfd : pP
d410: 61 67 65 72 2d 3e 73 74 66 64 29 20 29 3b 0a 20  ager->stfd) );. 
d420: 20 61 73 73 65 72 74 28 20 61 44 61 74 61 20 29   assert( aData )
d430: 3b 0a 0a 20 20 72 63 20 3d 20 72 65 61 64 33 32  ;..  rc = read32
d440: 62 69 74 73 28 6a 66 64 2c 20 6f 66 66 73 65 74  bits(jfd, offset
d450: 2c 20 26 70 67 6e 6f 29 3b 0a 20 20 69 66 28 20  , &pgno);.  if( 
d460: 72 63 21 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 20  rc!=SQLITE_OK ) 
d470: 72 65 74 75 72 6e 20 72 63 3b 0a 20 20 72 63 20  return rc;.  rc 
d480: 3d 20 73 71 6c 69 74 65 33 4f 73 52 65 61 64 28  = sqlite3OsRead(
d490: 6a 66 64 2c 20 61 44 61 74 61 2c 20 70 50 61 67  jfd, aData, pPag
d4a0: 65 72 2d 3e 70 61 67 65 53 69 7a 65 2c 20 6f 66  er->pageSize, of
d4b0: 66 73 65 74 2b 34 29 3b 0a 20 20 69 66 28 20 72  fset+4);.  if( r
d4c0: 63 21 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 20 72  c!=SQLITE_OK ) r
d4d0: 65 74 75 72 6e 20 72 63 3b 0a 20 20 70 50 61 67  eturn rc;.  pPag
d4e0: 65 72 2d 3e 6a 6f 75 72 6e 61 6c 4f 66 66 20 2b  er->journalOff +
d4f0: 3d 20 70 50 61 67 65 72 2d 3e 70 61 67 65 53 69  = pPager->pageSi
d500: 7a 65 20 2b 20 34 3b 0a 0a 20 20 2f 2a 20 53 61  ze + 4;..  /* Sa
d510: 6e 69 74 79 20 63 68 65 63 6b 69 6e 67 20 6f 6e  nity checking on
d520: 20 74 68 65 20 70 61 67 65 2e 20 20 54 68 69 73   the page.  This
d530: 20 69 73 20 6d 6f 72 65 20 69 6d 70 6f 72 74 61   is more importa
d540: 6e 74 20 74 68 61 74 20 49 20 6f 72 69 67 69 6e  nt that I origin
d550: 61 6c 6c 79 0a 20 20 2a 2a 20 74 68 6f 75 67 68  ally.  ** though
d560: 74 2e 20 20 49 66 20 61 20 70 6f 77 65 72 20 66  t.  If a power f
d570: 61 69 6c 75 72 65 20 6f 63 63 75 72 73 20 77 68  ailure occurs wh
d580: 69 6c 65 20 74 68 65 20 6a 6f 75 72 6e 61 6c 20  ile the journal 
d590: 69 73 20 62 65 69 6e 67 20 77 72 69 74 74 65 6e  is being written
d5a0: 2c 0a 20 20 2a 2a 20 69 74 20 63 6f 75 6c 64 20  ,.  ** it could 
d5b0: 63 61 75 73 65 20 69 6e 76 61 6c 69 64 20 64 61  cause invalid da
d5c0: 74 61 20 74 6f 20 62 65 20 77 72 69 74 74 65 6e  ta to be written
d5d0: 20 69 6e 74 6f 20 74 68 65 20 6a 6f 75 72 6e 61   into the journa
d5e0: 6c 2e 20 20 57 65 20 6e 65 65 64 20 74 6f 0a 20  l.  We need to. 
d5f0: 20 2a 2a 20 64 65 74 65 63 74 20 74 68 69 73 20   ** detect this 
d600: 69 6e 76 61 6c 69 64 20 64 61 74 61 20 28 77 69  invalid data (wi
d610: 74 68 20 68 69 67 68 20 70 72 6f 62 61 62 69 6c  th high probabil
d620: 69 74 79 29 20 61 6e 64 20 69 67 6e 6f 72 65 20  ity) and ignore 
d630: 69 74 2e 0a 20 20 2a 2f 0a 20 20 69 66 28 20 70  it..  */.  if( p
d640: 67 6e 6f 3d 3d 30 20 7c 7c 20 70 67 6e 6f 3d 3d  gno==0 || pgno==
d650: 50 41 47 45 52 5f 4d 4a 5f 50 47 4e 4f 28 70 50  PAGER_MJ_PGNO(pP
d660: 61 67 65 72 29 20 29 7b 0a 20 20 20 20 72 65 74  ager) ){.    ret
d670: 75 72 6e 20 53 51 4c 49 54 45 5f 44 4f 4e 45 3b  urn SQLITE_DONE;
d680: 0a 20 20 7d 0a 20 20 69 66 28 20 70 67 6e 6f 3e  .  }.  if( pgno>
d690: 28 75 6e 73 69 67 6e 65 64 29 70 50 61 67 65 72  (unsigned)pPager
d6a0: 2d 3e 64 62 53 69 7a 65 20 29 7b 0a 20 20 20 20  ->dbSize ){.    
d6b0: 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b  return SQLITE_OK
d6c0: 3b 0a 20 20 7d 0a 20 20 69 66 28 20 75 73 65 43  ;.  }.  if( useC
d6d0: 6b 73 75 6d 20 29 7b 0a 20 20 20 20 72 63 20 3d  ksum ){.    rc =
d6e0: 20 72 65 61 64 33 32 62 69 74 73 28 6a 66 64 2c   read32bits(jfd,
d6f0: 20 6f 66 66 73 65 74 2b 70 50 61 67 65 72 2d 3e   offset+pPager->
d700: 70 61 67 65 53 69 7a 65 2b 34 2c 20 26 63 6b 73  pageSize+4, &cks
d710: 75 6d 29 3b 0a 20 20 20 20 69 66 28 20 72 63 20  um);.    if( rc 
d720: 29 20 72 65 74 75 72 6e 20 72 63 3b 0a 20 20 20  ) return rc;.   
d730: 20 70 50 61 67 65 72 2d 3e 6a 6f 75 72 6e 61 6c   pPager->journal
d740: 4f 66 66 20 2b 3d 20 34 3b 0a 20 20 20 20 69 66  Off += 4;.    if
d750: 28 20 70 61 67 65 72 5f 63 6b 73 75 6d 28 70 50  ( pager_cksum(pP
d760: 61 67 65 72 2c 20 61 44 61 74 61 29 21 3d 63 6b  ager, aData)!=ck
d770: 73 75 6d 20 29 7b 0a 20 20 20 20 20 20 72 65 74  sum ){.      ret
d780: 75 72 6e 20 53 51 4c 49 54 45 5f 44 4f 4e 45 3b  urn SQLITE_DONE;
d790: 0a 20 20 20 20 7d 0a 20 20 7d 0a 0a 20 20 61 73  .    }.  }..  as
d7a0: 73 65 72 74 28 20 70 50 61 67 65 72 2d 3e 73 74  sert( pPager->st
d7b0: 61 74 65 3d 3d 50 41 47 45 52 5f 52 45 53 45 52  ate==PAGER_RESER
d7c0: 56 45 44 20 7c 7c 20 70 50 61 67 65 72 2d 3e 73  VED || pPager->s
d7d0: 74 61 74 65 3e 3d 50 41 47 45 52 5f 45 58 43 4c  tate>=PAGER_EXCL
d7e0: 55 53 49 56 45 20 29 3b 0a 0a 20 20 2f 2a 20 49  USIVE );..  /* I
d7f0: 66 20 74 68 65 20 70 61 67 65 72 20 69 73 20 69  f the pager is i
d800: 6e 20 52 45 53 45 52 56 45 44 20 73 74 61 74 65  n RESERVED state
d810: 2c 20 74 68 65 6e 20 74 68 65 72 65 20 6d 75 73  , then there mus
d820: 74 20 62 65 20 61 20 63 6f 70 79 20 6f 66 20 74  t be a copy of t
d830: 68 69 73 0a 20 20 2a 2a 20 70 61 67 65 20 69 6e  his.  ** page in
d840: 20 74 68 65 20 70 61 67 65 72 20 63 61 63 68 65   the pager cache
d850: 2e 20 49 6e 20 74 68 69 73 20 63 61 73 65 20 6a  . In this case j
d860: 75 73 74 20 75 70 64 61 74 65 20 74 68 65 20 70  ust update the p
d870: 61 67 65 72 20 63 61 63 68 65 2c 0a 20 20 2a 2a  ager cache,.  **
d880: 20 6e 6f 74 20 74 68 65 20 64 61 74 61 62 61 73   not the databas
d890: 65 20 66 69 6c 65 2e 20 54 68 65 20 70 61 67 65  e file. The page
d8a0: 20 69 73 20 6c 65 66 74 20 6d 61 72 6b 65 64 20   is left marked 
d8b0: 64 69 72 74 79 20 69 6e 20 74 68 69 73 20 63 61  dirty in this ca
d8c0: 73 65 2e 0a 20 20 2a 2a 0a 20 20 2a 2a 20 41 6e  se..  **.  ** An
d8d0: 20 65 78 63 65 70 74 69 6f 6e 20 74 6f 20 74 68   exception to th
d8e0: 65 20 61 62 6f 76 65 20 72 75 6c 65 3a 20 49 66  e above rule: If
d8f0: 20 74 68 65 20 64 61 74 61 62 61 73 65 20 69 73   the database is
d900: 20 69 6e 20 6e 6f 2d 73 79 6e 63 20 6d 6f 64 65   in no-sync mode
d910: 0a 20 20 2a 2a 20 61 6e 64 20 61 20 70 61 67 65  .  ** and a page
d920: 20 69 73 20 6d 6f 76 65 64 20 64 75 72 69 6e 67   is moved during
d930: 20 61 6e 20 69 6e 63 72 65 6d 65 6e 74 61 6c 20   an incremental 
d940: 76 61 63 75 75 6d 20 74 68 65 6e 20 74 68 65 20  vacuum then the 
d950: 70 61 67 65 20 6d 61 79 0a 20 20 2a 2a 20 6e 6f  page may.  ** no
d960: 74 20 62 65 20 69 6e 20 74 68 65 20 70 61 67 65  t be in the page
d970: 72 20 63 61 63 68 65 2e 20 4c 61 74 65 72 3a 20  r cache. Later: 
d980: 69 66 20 61 20 6d 61 6c 6c 6f 63 28 29 20 6f 72  if a malloc() or
d990: 20 49 4f 20 65 72 72 6f 72 20 6f 63 63 75 72 73   IO error occurs
d9a0: 0a 20 20 2a 2a 20 64 75 72 69 6e 67 20 61 20 4d  .  ** during a M
d9b0: 6f 76 65 70 61 67 65 28 29 20 63 61 6c 6c 2c 20  ovepage() call, 
d9c0: 74 68 65 6e 20 74 68 65 20 70 61 67 65 20 6d 61  then the page ma
d9d0: 79 20 6e 6f 74 20 62 65 20 69 6e 20 74 68 65 20  y not be in the 
d9e0: 63 61 63 68 65 0a 20 20 2a 2a 20 65 69 74 68 65  cache.  ** eithe
d9f0: 72 2e 20 53 6f 20 74 68 65 20 63 6f 6e 64 69 74  r. So the condit
da00: 69 6f 6e 20 64 65 73 63 72 69 62 65 64 20 69 6e  ion described in
da10: 20 74 68 65 20 61 62 6f 76 65 20 70 61 72 61 67   the above parag
da20: 72 61 70 68 20 69 73 20 6e 6f 74 0a 20 20 2a 2a  raph is not.  **
da30: 20 61 73 73 65 72 74 28 29 61 62 6c 65 2e 0a 20   assert()able.. 
da40: 20 2a 2a 0a 20 20 2a 2a 20 49 66 20 69 6e 20 45   **.  ** If in E
da50: 58 43 4c 55 53 49 56 45 20 73 74 61 74 65 2c 20  XCLUSIVE state, 
da60: 74 68 65 6e 20 77 65 20 75 70 64 61 74 65 20 74  then we update t
da70: 68 65 20 70 61 67 65 72 20 63 61 63 68 65 20 69  he pager cache i
da80: 66 20 69 74 20 65 78 69 73 74 73 0a 20 20 2a 2a  f it exists.  **
da90: 20 61 6e 64 20 74 68 65 20 6d 61 69 6e 20 66 69   and the main fi
daa0: 6c 65 2e 20 54 68 65 20 70 61 67 65 20 69 73 20  le. The page is 
dab0: 74 68 65 6e 20 6d 61 72 6b 65 64 20 6e 6f 74 20  then marked not 
dac0: 64 69 72 74 79 2e 0a 20 20 2a 2a 0a 20 20 2a 2a  dirty..  **.  **
dad0: 20 54 69 63 6b 65 74 20 23 31 31 37 31 3a 20 20   Ticket #1171:  
dae0: 54 68 65 20 73 74 61 74 65 6d 65 6e 74 20 6a 6f  The statement jo
daf0: 75 72 6e 61 6c 20 6d 69 67 68 74 20 63 6f 6e 74  urnal might cont
db00: 61 69 6e 20 70 61 67 65 20 63 6f 6e 74 65 6e 74  ain page content
db10: 20 74 68 61 74 20 69 73 0a 20 20 2a 2a 20 64 69   that is.  ** di
db20: 66 66 65 72 65 6e 74 20 66 72 6f 6d 20 74 68 65  fferent from the
db30: 20 70 61 67 65 20 63 6f 6e 74 65 6e 74 20 61 74   page content at
db40: 20 74 68 65 20 73 74 61 72 74 20 6f 66 20 74 68   the start of th
db50: 65 20 74 72 61 6e 73 61 63 74 69 6f 6e 2e 0a 20  e transaction.. 
db60: 20 2a 2a 20 54 68 69 73 20 6f 63 63 75 72 73 20   ** This occurs 
db70: 77 68 65 6e 20 61 20 70 61 67 65 20 69 73 20 63  when a page is c
db80: 68 61 6e 67 65 64 20 70 72 69 6f 72 20 74 6f 20  hanged prior to 
db90: 74 68 65 20 73 74 61 72 74 20 6f 66 20 61 20 73  the start of a s
dba0: 74 61 74 65 6d 65 6e 74 0a 20 20 2a 2a 20 74 68  tatement.  ** th
dbb0: 65 6e 20 63 68 61 6e 67 65 64 20 61 67 61 69 6e  en changed again
dbc0: 20 77 69 74 68 69 6e 20 74 68 65 20 73 74 61 74   within the stat
dbd0: 65 6d 65 6e 74 2e 20 20 57 68 65 6e 20 72 6f 6c  ement.  When rol
dbe0: 6c 69 6e 67 20 62 61 63 6b 20 73 75 63 68 20 61  ling back such a
dbf0: 0a 20 20 2a 2a 20 73 74 61 74 65 6d 65 6e 74 20  .  ** statement 
dc00: 77 65 20 6d 75 73 74 20 6e 6f 74 20 77 72 69 74  we must not writ
dc10: 65 20 74 6f 20 74 68 65 20 6f 72 69 67 69 6e 61  e to the origina
dc20: 6c 20 64 61 74 61 62 61 73 65 20 75 6e 6c 65 73  l database unles
dc30: 73 20 77 65 20 6b 6e 6f 77 0a 20 20 2a 2a 20 66  s we know.  ** f
dc40: 6f 72 20 63 65 72 74 61 69 6e 20 74 68 61 74 20  or certain that 
dc50: 6f 72 69 67 69 6e 61 6c 20 70 61 67 65 20 63 6f  original page co
dc60: 6e 74 65 6e 74 73 20 61 72 65 20 73 79 6e 63 65  ntents are synce
dc70: 64 20 69 6e 74 6f 20 74 68 65 20 6d 61 69 6e 20  d into the main 
dc80: 72 6f 6c 6c 62 61 63 6b 0a 20 20 2a 2a 20 6a 6f  rollback.  ** jo
dc90: 75 72 6e 61 6c 2e 20 20 4f 74 68 65 72 77 69 73  urnal.  Otherwis
dca0: 65 2c 20 61 20 70 6f 77 65 72 20 6c 6f 73 73 20  e, a power loss 
dcb0: 6d 69 67 68 74 20 6c 65 61 76 65 20 6d 6f 64 69  might leave modi
dcc0: 66 69 65 64 20 64 61 74 61 20 69 6e 20 74 68 65  fied data in the
dcd0: 0a 20 20 2a 2a 20 64 61 74 61 62 61 73 65 20 66  .  ** database f
dce0: 69 6c 65 20 77 69 74 68 6f 75 74 20 61 6e 20 65  ile without an e
dcf0: 6e 74 72 79 20 69 6e 20 74 68 65 20 72 6f 6c 6c  ntry in the roll
dd00: 62 61 63 6b 20 6a 6f 75 72 6e 61 6c 20 74 68 61  back journal tha
dd10: 74 20 63 61 6e 0a 20 20 2a 2a 20 72 65 73 74 6f  t can.  ** resto
dd20: 72 65 20 74 68 65 20 64 61 74 61 62 61 73 65 20  re the database 
dd30: 74 6f 20 69 74 73 20 6f 72 69 67 69 6e 61 6c 20  to its original 
dd40: 66 6f 72 6d 2e 20 20 54 77 6f 20 63 6f 6e 64 69  form.  Two condi
dd50: 74 69 6f 6e 73 20 6d 75 73 74 20 62 65 0a 20 20  tions must be.  
dd60: 2a 2a 20 6d 65 74 20 62 65 66 6f 72 65 20 77 72  ** met before wr
dd70: 69 74 69 6e 67 20 74 6f 20 74 68 65 20 64 61 74  iting to the dat
dd80: 61 62 61 73 65 20 66 69 6c 65 73 2e 20 28 31 29  abase files. (1)
dd90: 20 74 68 65 20 64 61 74 61 62 61 73 65 20 6d 75   the database mu
dda0: 73 74 20 62 65 0a 20 20 2a 2a 20 6c 6f 63 6b 65  st be.  ** locke
ddb0: 64 2e 20 20 28 32 29 20 77 65 20 6b 6e 6f 77 20  d.  (2) we know 
ddc0: 74 68 61 74 20 74 68 65 20 6f 72 69 67 69 6e 61  that the origina
ddd0: 6c 20 70 61 67 65 20 63 6f 6e 74 65 6e 74 20 69  l page content i
dde0: 73 20 66 75 6c 6c 79 20 73 79 6e 63 65 64 0a 20  s fully synced. 
ddf0: 20 2a 2a 20 69 6e 20 74 68 65 20 6d 61 69 6e 20   ** in the main 
de00: 6a 6f 75 72 6e 61 6c 20 65 69 74 68 65 72 20 62  journal either b
de10: 65 63 61 75 73 65 20 74 68 65 20 70 61 67 65 20  ecause the page 
de20: 69 73 20 6e 6f 74 20 69 6e 20 63 61 63 68 65 20  is not in cache 
de30: 6f 72 20 65 6c 73 65 0a 20 20 2a 2a 20 74 68 65  or else.  ** the
de40: 20 70 61 67 65 20 69 73 20 6d 61 72 6b 65 64 20   page is marked 
de50: 61 73 20 6e 65 65 64 53 79 6e 63 3d 3d 30 2e 0a  as needSync==0..
de60: 20 20 2a 2a 0a 20 20 2a 2a 20 32 30 30 38 2d 30    **.  ** 2008-0
de70: 34 2d 31 34 3a 20 20 57 68 65 6e 20 61 74 74 65  4-14:  When atte
de80: 6d 70 74 69 6e 67 20 74 6f 20 76 61 63 75 75 6d  mpting to vacuum
de90: 20 61 20 63 6f 72 72 75 70 74 20 64 61 74 61 62   a corrupt datab
dea0: 61 73 65 20 66 69 6c 65 2c 20 69 74 0a 20 20 2a  ase file, it.  *
deb0: 2a 20 69 73 20 70 6f 73 73 69 62 6c 65 20 74 6f  * is possible to
dec0: 20 66 61 69 6c 20 61 20 73 74 61 74 65 6d 65 6e   fail a statemen
ded0: 74 20 6f 6e 20 61 20 64 61 74 61 62 61 73 65 20  t on a database 
dee0: 74 68 61 74 20 64 6f 65 73 20 6e 6f 74 20 79 65  that does not ye
def0: 74 20 65 78 69 73 74 2e 0a 20 20 2a 2a 20 44 6f  t exist..  ** Do
df00: 20 6e 6f 74 20 61 74 74 65 6d 70 74 20 74 6f 20   not attempt to 
df10: 77 72 69 74 65 20 69 66 20 64 61 74 61 62 61 73  write if databas
df20: 65 20 66 69 6c 65 20 68 61 73 20 6e 65 76 65 72  e file has never
df30: 20 62 65 65 6e 20 6f 70 65 6e 65 64 2e 0a 20 20   been opened..  
df40: 2a 2f 0a 20 20 70 50 67 20 3d 20 70 61 67 65 72  */.  pPg = pager
df50: 5f 6c 6f 6f 6b 75 70 28 70 50 61 67 65 72 2c 20  _lookup(pPager, 
df60: 70 67 6e 6f 29 3b 0a 20 20 50 41 47 45 52 54 52  pgno);.  PAGERTR
df70: 41 43 45 34 28 22 50 4c 41 59 42 41 43 4b 20 25  ACE4("PLAYBACK %
df80: 64 20 70 61 67 65 20 25 64 20 68 61 73 68 28 25  d page %d hash(%
df90: 30 38 78 29 5c 6e 22 2c 0a 20 20 20 20 20 20 20  08x)\n",.       
dfa0: 20 20 20 20 20 20 20 20 50 41 47 45 52 49 44 28          PAGERID(
dfb0: 70 50 61 67 65 72 29 2c 20 70 67 6e 6f 2c 20 70  pPager), pgno, p
dfc0: 61 67 65 72 5f 64 61 74 61 68 61 73 68 28 70 50  ager_datahash(pP
dfd0: 61 67 65 72 2d 3e 70 61 67 65 53 69 7a 65 2c 20  ager->pageSize, 
dfe0: 61 44 61 74 61 29 29 3b 0a 20 20 69 66 28 20 70  aData));.  if( p
dff0: 50 61 67 65 72 2d 3e 73 74 61 74 65 3e 3d 50 41  Pager->state>=PA
e000: 47 45 52 5f 45 58 43 4c 55 53 49 56 45 20 26 26  GER_EXCLUSIVE &&
e010: 20 28 70 50 67 3d 3d 30 20 7c 7c 20 70 50 67 2d   (pPg==0 || pPg-
e020: 3e 6e 65 65 64 53 79 6e 63 3d 3d 30 29 0a 20 20  >needSync==0).  
e030: 20 20 20 20 20 20 26 26 20 70 50 61 67 65 72 2d        && pPager-
e040: 3e 66 64 2d 3e 70 4d 65 74 68 6f 64 73 20 29 7b  >fd->pMethods ){
e050: 0a 20 20 20 20 69 36 34 20 6f 66 66 73 65 74 20  .    i64 offset 
e060: 3d 20 28 70 67 6e 6f 2d 31 29 2a 28 69 36 34 29  = (pgno-1)*(i64)
e070: 70 50 61 67 65 72 2d 3e 70 61 67 65 53 69 7a 65  pPager->pageSize
e080: 3b 0a 20 20 20 20 72 63 20 3d 20 73 71 6c 69 74  ;.    rc = sqlit
e090: 65 33 4f 73 57 72 69 74 65 28 70 50 61 67 65 72  e3OsWrite(pPager
e0a0: 2d 3e 66 64 2c 20 61 44 61 74 61 2c 20 70 50 61  ->fd, aData, pPa
e0b0: 67 65 72 2d 3e 70 61 67 65 53 69 7a 65 2c 20 6f  ger->pageSize, o
e0c0: 66 66 73 65 74 29 3b 0a 20 20 20 20 69 66 28 20  ffset);.    if( 
e0d0: 70 50 67 20 29 7b 0a 20 20 20 20 20 20 6d 61 6b  pPg ){.      mak
e0e0: 65 43 6c 65 61 6e 28 70 50 67 29 3b 0a 20 20 20  eClean(pPg);.   
e0f0: 20 7d 0a 20 20 7d 0a 20 20 69 66 28 20 70 50 67   }.  }.  if( pPg
e100: 20 29 7b 0a 20 20 20 20 2f 2a 20 4e 6f 20 70 61   ){.    /* No pa
e110: 67 65 20 73 68 6f 75 6c 64 20 65 76 65 72 20 62  ge should ever b
e120: 65 20 65 78 70 6c 69 63 69 74 6c 79 20 72 6f 6c  e explicitly rol
e130: 6c 65 64 20 62 61 63 6b 20 74 68 61 74 20 69 73  led back that is
e140: 20 69 6e 20 75 73 65 2c 20 65 78 63 65 70 74 0a   in use, except.
e150: 20 20 20 20 2a 2a 20 66 6f 72 20 70 61 67 65 20      ** for page 
e160: 31 20 77 68 69 63 68 20 69 73 20 68 65 6c 64 20  1 which is held 
e170: 69 6e 20 75 73 65 20 69 6e 20 6f 72 64 65 72 20  in use in order 
e180: 74 6f 20 6b 65 65 70 20 74 68 65 20 6c 6f 63 6b  to keep the lock
e190: 20 6f 6e 20 74 68 65 0a 20 20 20 20 2a 2a 20 64   on the.    ** d
e1a0: 61 74 61 62 61 73 65 20 61 63 74 69 76 65 2e 20  atabase active. 
e1b0: 48 6f 77 65 76 65 72 20 73 75 63 68 20 61 20 70  However such a p
e1c0: 61 67 65 20 6d 61 79 20 62 65 20 72 6f 6c 6c 65  age may be rolle
e1d0: 64 20 62 61 63 6b 20 61 73 20 61 20 72 65 73 75  d back as a resu
e1e0: 6c 74 0a 20 20 20 20 2a 2a 20 6f 66 20 61 6e 20  lt.    ** of an 
e1f0: 69 6e 74 65 72 6e 61 6c 20 65 72 72 6f 72 20 72  internal error r
e200: 65 73 75 6c 74 69 6e 67 20 69 6e 20 61 6e 20 61  esulting in an a
e210: 75 74 6f 6d 61 74 69 63 20 63 61 6c 6c 20 74 6f  utomatic call to
e220: 0a 20 20 20 20 2a 2a 20 73 71 6c 69 74 65 33 50  .    ** sqlite3P
e230: 61 67 65 72 52 6f 6c 6c 62 61 63 6b 28 29 2e 0a  agerRollback()..
e240: 20 20 20 20 2a 2f 0a 20 20 20 20 76 6f 69 64 20      */.    void 
e250: 2a 70 44 61 74 61 3b 0a 20 20 20 20 2f 2a 20 61  *pData;.    /* a
e260: 73 73 65 72 74 28 20 70 50 67 2d 3e 6e 52 65 66  ssert( pPg->nRef
e270: 3d 3d 30 20 7c 7c 20 70 50 67 2d 3e 70 67 6e 6f  ==0 || pPg->pgno
e280: 3d 3d 31 20 29 3b 20 2a 2f 0a 20 20 20 20 70 44  ==1 ); */.    pD
e290: 61 74 61 20 3d 20 50 47 48 44 52 5f 54 4f 5f 44  ata = PGHDR_TO_D
e2a0: 41 54 41 28 70 50 67 29 3b 0a 20 20 20 20 6d 65  ATA(pPg);.    me
e2b0: 6d 63 70 79 28 70 44 61 74 61 2c 20 61 44 61 74  mcpy(pData, aDat
e2c0: 61 2c 20 70 50 61 67 65 72 2d 3e 70 61 67 65 53  a, pPager->pageS
e2d0: 69 7a 65 29 3b 0a 20 20 20 20 69 66 28 20 70 50  ize);.    if( pP
e2e0: 61 67 65 72 2d 3e 78 52 65 69 6e 69 74 65 72 20  ager->xReiniter 
e2f0: 29 7b 0a 20 20 20 20 20 20 70 50 61 67 65 72 2d  ){.      pPager-
e300: 3e 78 52 65 69 6e 69 74 65 72 28 70 50 67 2c 20  >xReiniter(pPg, 
e310: 70 50 61 67 65 72 2d 3e 70 61 67 65 53 69 7a 65  pPager->pageSize
e320: 29 3b 0a 20 20 20 20 7d 0a 23 69 66 64 65 66 20  );.    }.#ifdef 
e330: 53 51 4c 49 54 45 5f 43 48 45 43 4b 5f 50 41 47  SQLITE_CHECK_PAG
e340: 45 53 0a 20 20 20 20 70 50 67 2d 3e 70 61 67 65  ES.    pPg->page
e350: 48 61 73 68 20 3d 20 70 61 67 65 72 5f 70 61 67  Hash = pager_pag
e360: 65 68 61 73 68 28 70 50 67 29 3b 0a 23 65 6e 64  ehash(pPg);.#end
e370: 69 66 0a 20 20 20 20 2f 2a 20 49 66 20 74 68 69  if.    /* If thi
e380: 73 20 77 61 73 20 70 61 67 65 20 31 2c 20 74 68  s was page 1, th
e390: 65 6e 20 72 65 73 74 6f 72 65 20 74 68 65 20 76  en restore the v
e3a0: 61 6c 75 65 20 6f 66 20 50 61 67 65 72 2e 64 62  alue of Pager.db
e3b0: 46 69 6c 65 56 65 72 73 2e 0a 20 20 20 20 2a 2a  FileVers..    **
e3c0: 20 44 6f 20 74 68 69 73 20 62 65 66 6f 72 65 20   Do this before 
e3d0: 61 6e 79 20 64 65 63 6f 64 69 6e 67 2e 20 2a 2f  any decoding. */
e3e0: 0a 20 20 20 20 69 66 28 20 70 67 6e 6f 3d 3d 31  .    if( pgno==1
e3f0: 20 29 7b 0a 20 20 20 20 20 20 6d 65 6d 63 70 79   ){.      memcpy
e400: 28 26 70 50 61 67 65 72 2d 3e 64 62 46 69 6c 65  (&pPager->dbFile
e410: 56 65 72 73 2c 20 26 28 28 75 38 2a 29 70 44 61  Vers, &((u8*)pDa
e420: 74 61 29 5b 32 34 5d 2c 73 69 7a 65 6f 66 28 70  ta)[24],sizeof(p
e430: 50 61 67 65 72 2d 3e 64 62 46 69 6c 65 56 65 72  Pager->dbFileVer
e440: 73 29 29 3b 0a 20 20 20 20 7d 0a 0a 20 20 20 20  s));.    }..    
e450: 2f 2a 20 44 65 63 6f 64 65 20 74 68 65 20 70 61  /* Decode the pa
e460: 67 65 20 6a 75 73 74 20 72 65 61 64 20 66 72 6f  ge just read fro
e470: 6d 20 64 69 73 6b 20 2a 2f 0a 20 20 20 20 43 4f  m disk */.    CO
e480: 44 45 43 31 28 70 50 61 67 65 72 2c 20 70 44 61  DEC1(pPager, pDa
e490: 74 61 2c 20 70 50 67 2d 3e 70 67 6e 6f 2c 20 33  ta, pPg->pgno, 3
e4a0: 29 3b 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e 20  );.  }.  return 
e4b0: 72 63 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 50 61 72  rc;.}../*.** Par
e4c0: 61 6d 65 74 65 72 20 7a 4d 61 73 74 65 72 20 69  ameter zMaster i
e4d0: 73 20 74 68 65 20 6e 61 6d 65 20 6f 66 20 61 20  s the name of a 
e4e0: 6d 61 73 74 65 72 20 6a 6f 75 72 6e 61 6c 20 66  master journal f
e4f0: 69 6c 65 2e 20 41 20 73 69 6e 67 6c 65 20 6a 6f  ile. A single jo
e500: 75 72 6e 61 6c 0a 2a 2a 20 66 69 6c 65 20 74 68  urnal.** file th
e510: 61 74 20 72 65 66 65 72 72 65 64 20 74 6f 20 74  at referred to t
e520: 68 65 20 6d 61 73 74 65 72 20 6a 6f 75 72 6e 61  he master journa
e530: 6c 20 66 69 6c 65 20 68 61 73 20 6a 75 73 74 20  l file has just 
e540: 62 65 65 6e 20 72 6f 6c 6c 65 64 20 62 61 63 6b  been rolled back
e550: 2e 0a 2a 2a 20 54 68 69 73 20 72 6f 75 74 69 6e  ..** This routin
e560: 65 20 63 68 65 63 6b 73 20 69 66 20 69 74 20 69  e checks if it i
e570: 73 20 70 6f 73 73 69 62 6c 65 20 74 6f 20 64 65  s possible to de
e580: 6c 65 74 65 20 74 68 65 20 6d 61 73 74 65 72 20  lete the master 
e590: 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 2c 0a 2a 2a  journal file,.**
e5a0: 20 61 6e 64 20 64 6f 65 73 20 73 6f 20 69 66 20   and does so if 
e5b0: 69 74 20 69 73 2e 0a 2a 2a 0a 2a 2a 20 41 72 67  it is..**.** Arg
e5c0: 75 6d 65 6e 74 20 7a 4d 61 73 74 65 72 20 6d 61  ument zMaster ma
e5d0: 79 20 70 6f 69 6e 74 20 74 6f 20 50 61 67 65 72  y point to Pager
e5e0: 2e 70 54 6d 70 53 70 61 63 65 2e 20 53 6f 20 74  .pTmpSpace. So t
e5f0: 68 61 74 20 62 75 66 66 65 72 20 69 73 20 6e 6f  hat buffer is no
e600: 74 20 0a 2a 2a 20 61 76 61 69 6c 61 62 6c 65 20  t .** available 
e610: 66 6f 72 20 75 73 65 20 77 69 74 68 69 6e 20 74  for use within t
e620: 68 69 73 20 66 75 6e 63 74 69 6f 6e 2e 0a 2a 2a  his function..**
e630: 0a 2a 2a 0a 2a 2a 20 54 68 65 20 6d 61 73 74 65  .**.** The maste
e640: 72 20 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 20 63  r journal file c
e650: 6f 6e 74 61 69 6e 73 20 74 68 65 20 6e 61 6d 65  ontains the name
e660: 73 20 6f 66 20 61 6c 6c 20 63 68 69 6c 64 20 6a  s of all child j
e670: 6f 75 72 6e 61 6c 73 2e 0a 2a 2a 20 54 6f 20 74  ournals..** To t
e680: 65 6c 6c 20 69 66 20 61 20 6d 61 73 74 65 72 20  ell if a master 
e690: 6a 6f 75 72 6e 61 6c 20 63 61 6e 20 62 65 20 64  journal can be d
e6a0: 65 6c 65 74 65 64 2c 20 63 68 65 63 6b 20 74 6f  eleted, check to
e6b0: 20 65 61 63 68 20 6f 66 20 74 68 65 0a 2a 2a 20   each of the.** 
e6c0: 63 68 69 6c 64 72 65 6e 2e 20 20 49 66 20 61 6c  children.  If al
e6d0: 6c 20 63 68 69 6c 64 72 65 6e 20 61 72 65 20 65  l children are e
e6e0: 69 74 68 65 72 20 6d 69 73 73 69 6e 67 20 6f 72  ither missing or
e6f0: 20 64 6f 20 6e 6f 74 20 72 65 66 65 72 20 74 6f   do not refer to
e700: 0a 2a 2a 20 61 20 64 69 66 66 65 72 65 6e 74 20  .** a different 
e710: 6d 61 73 74 65 72 20 6a 6f 75 72 6e 61 6c 2c 20  master journal, 
e720: 74 68 65 6e 20 74 68 69 73 20 6d 61 73 74 65 72  then this master
e730: 20 6a 6f 75 72 6e 61 6c 20 63 61 6e 20 62 65 20   journal can be 
e740: 64 65 6c 65 74 65 64 2e 0a 2a 2f 0a 73 74 61 74  deleted..*/.stat
e750: 69 63 20 69 6e 74 20 70 61 67 65 72 5f 64 65 6c  ic int pager_del
e760: 6d 61 73 74 65 72 28 50 61 67 65 72 20 2a 70 50  master(Pager *pP
e770: 61 67 65 72 2c 20 63 6f 6e 73 74 20 63 68 61 72  ager, const char
e780: 20 2a 7a 4d 61 73 74 65 72 29 7b 0a 20 20 73 71   *zMaster){.  sq
e790: 6c 69 74 65 33 5f 76 66 73 20 2a 70 56 66 73 20  lite3_vfs *pVfs 
e7a0: 3d 20 70 50 61 67 65 72 2d 3e 70 56 66 73 3b 0a  = pPager->pVfs;.
e7b0: 20 20 69 6e 74 20 72 63 3b 0a 20 20 69 6e 74 20    int rc;.  int 
e7c0: 6d 61 73 74 65 72 5f 6f 70 65 6e 20 3d 20 30 3b  master_open = 0;
e7d0: 0a 20 20 73 71 6c 69 74 65 33 5f 66 69 6c 65 20  .  sqlite3_file 
e7e0: 2a 70 4d 61 73 74 65 72 3b 0a 20 20 73 71 6c 69  *pMaster;.  sqli
e7f0: 74 65 33 5f 66 69 6c 65 20 2a 70 4a 6f 75 72 6e  te3_file *pJourn
e800: 61 6c 3b 0a 20 20 63 68 61 72 20 2a 7a 4d 61 73  al;.  char *zMas
e810: 74 65 72 4a 6f 75 72 6e 61 6c 20 3d 20 30 3b 20  terJournal = 0; 
e820: 2f 2a 20 43 6f 6e 74 65 6e 74 73 20 6f 66 20 6d  /* Contents of m
e830: 61 73 74 65 72 20 6a 6f 75 72 6e 61 6c 20 66 69  aster journal fi
e840: 6c 65 20 2a 2f 0a 20 20 69 36 34 20 6e 4d 61 73  le */.  i64 nMas
e850: 74 65 72 4a 6f 75 72 6e 61 6c 3b 20 20 20 20 20  terJournal;     
e860: 20 20 2f 2a 20 53 69 7a 65 20 6f 66 20 6d 61 73    /* Size of mas
e870: 74 65 72 20 6a 6f 75 72 6e 61 6c 20 66 69 6c 65  ter journal file
e880: 20 2a 2f 0a 0a 20 20 2f 2a 20 4f 70 65 6e 20 74   */..  /* Open t
e890: 68 65 20 6d 61 73 74 65 72 20 6a 6f 75 72 6e 61  he master journa
e8a0: 6c 20 66 69 6c 65 20 65 78 63 6c 75 73 69 76 65  l file exclusive
e8b0: 6c 79 20 69 6e 20 63 61 73 65 20 73 6f 6d 65 20  ly in case some 
e8c0: 6f 74 68 65 72 20 70 72 6f 63 65 73 73 0a 20 20  other process.  
e8d0: 2a 2a 20 69 73 20 72 75 6e 6e 69 6e 67 20 74 68  ** is running th
e8e0: 69 73 20 72 6f 75 74 69 6e 65 20 61 6c 73 6f 2e  is routine also.
e8f0: 20 4e 6f 74 20 74 68 61 74 20 69 74 20 6d 61 6b   Not that it mak
e900: 65 73 20 74 6f 6f 20 6d 75 63 68 20 64 69 66 66  es too much diff
e910: 65 72 65 6e 63 65 2e 0a 20 20 2a 2f 0a 20 20 70  erence..  */.  p
e920: 4d 61 73 74 65 72 20 3d 20 28 73 71 6c 69 74 65  Master = (sqlite
e930: 33 5f 66 69 6c 65 20 2a 29 73 71 6c 69 74 65 33  3_file *)sqlite3
e940: 5f 6d 61 6c 6c 6f 63 28 70 56 66 73 2d 3e 73 7a  _malloc(pVfs->sz
e950: 4f 73 46 69 6c 65 20 2a 20 32 29 3b 0a 20 20 70  OsFile * 2);.  p
e960: 4a 6f 75 72 6e 61 6c 20 3d 20 28 73 71 6c 69 74  Journal = (sqlit
e970: 65 33 5f 66 69 6c 65 20 2a 29 28 28 28 75 38 20  e3_file *)(((u8 
e980: 2a 29 70 4d 61 73 74 65 72 29 20 2b 20 70 56 66  *)pMaster) + pVf
e990: 73 2d 3e 73 7a 4f 73 46 69 6c 65 29 3b 0a 20 20  s->szOsFile);.  
e9a0: 69 66 28 20 21 70 4d 61 73 74 65 72 20 29 7b 0a  if( !pMaster ){.
e9b0: 20 20 20 20 72 63 20 3d 20 53 51 4c 49 54 45 5f      rc = SQLITE_
e9c0: 4e 4f 4d 45 4d 3b 0a 20 20 7d 65 6c 73 65 7b 0a  NOMEM;.  }else{.
e9d0: 20 20 20 20 69 6e 74 20 66 6c 61 67 73 20 3d 20      int flags = 
e9e0: 28 53 51 4c 49 54 45 5f 4f 50 45 4e 5f 52 45 41  (SQLITE_OPEN_REA
e9f0: 44 4f 4e 4c 59 7c 53 51 4c 49 54 45 5f 4f 50 45  DONLY|SQLITE_OPE
ea00: 4e 5f 4d 41 53 54 45 52 5f 4a 4f 55 52 4e 41 4c  N_MASTER_JOURNAL
ea10: 29 3b 0a 20 20 20 20 72 63 20 3d 20 73 71 6c 69  );.    rc = sqli
ea20: 74 65 33 4f 73 4f 70 65 6e 28 70 56 66 73 2c 20  te3OsOpen(pVfs, 
ea30: 7a 4d 61 73 74 65 72 2c 20 70 4d 61 73 74 65 72  zMaster, pMaster
ea40: 2c 20 66 6c 61 67 73 2c 20 30 29 3b 0a 20 20 7d  , flags, 0);.  }
ea50: 0a 20 20 69 66 28 20 72 63 21 3d 53 51 4c 49 54  .  if( rc!=SQLIT
ea60: 45 5f 4f 4b 20 29 20 67 6f 74 6f 20 64 65 6c 6d  E_OK ) goto delm
ea70: 61 73 74 65 72 5f 6f 75 74 3b 0a 20 20 6d 61 73  aster_out;.  mas
ea80: 74 65 72 5f 6f 70 65 6e 20 3d 20 31 3b 0a 0a 20  ter_open = 1;.. 
ea90: 20 72 63 20 3d 20 73 71 6c 69 74 65 33 4f 73 46   rc = sqlite3OsF
eaa0: 69 6c 65 53 69 7a 65 28 70 4d 61 73 74 65 72 2c  ileSize(pMaster,
eab0: 20 26 6e 4d 61 73 74 65 72 4a 6f 75 72 6e 61 6c   &nMasterJournal
eac0: 29 3b 0a 20 20 69 66 28 20 72 63 21 3d 53 51 4c  );.  if( rc!=SQL
ead0: 49 54 45 5f 4f 4b 20 29 20 67 6f 74 6f 20 64 65  ITE_OK ) goto de
eae0: 6c 6d 61 73 74 65 72 5f 6f 75 74 3b 0a 0a 20 20  lmaster_out;..  
eaf0: 69 66 28 20 6e 4d 61 73 74 65 72 4a 6f 75 72 6e  if( nMasterJourn
eb00: 61 6c 3e 30 20 29 7b 0a 20 20 20 20 63 68 61 72  al>0 ){.    char
eb10: 20 2a 7a 4a 6f 75 72 6e 61 6c 3b 0a 20 20 20 20   *zJournal;.    
eb20: 63 68 61 72 20 2a 7a 4d 61 73 74 65 72 50 74 72  char *zMasterPtr
eb30: 20 3d 20 30 3b 0a 20 20 20 20 69 6e 74 20 6e 4d   = 0;.    int nM
eb40: 61 73 74 65 72 50 74 72 20 3d 20 70 50 61 67 65  asterPtr = pPage
eb50: 72 2d 3e 70 56 66 73 2d 3e 6d 78 50 61 74 68 6e  r->pVfs->mxPathn
eb60: 61 6d 65 2b 31 3b 0a 0a 20 20 20 20 2f 2a 20 4c  ame+1;..    /* L
eb70: 6f 61 64 20 74 68 65 20 65 6e 74 69 72 65 20 6d  oad the entire m
eb80: 61 73 74 65 72 20 6a 6f 75 72 6e 61 6c 20 66 69  aster journal fi
eb90: 6c 65 20 69 6e 74 6f 20 73 70 61 63 65 20 6f 62  le into space ob
eba0: 74 61 69 6e 65 64 20 66 72 6f 6d 0a 20 20 20 20  tained from.    
ebb0: 2a 2a 20 73 71 6c 69 74 65 33 5f 6d 61 6c 6c 6f  ** sqlite3_mallo
ebc0: 63 28 29 20 61 6e 64 20 70 6f 69 6e 74 65 64 20  c() and pointed 
ebd0: 74 6f 20 62 79 20 7a 4d 61 73 74 65 72 4a 6f 75  to by zMasterJou
ebe0: 72 6e 61 6c 2e 20 0a 20 20 20 20 2a 2f 0a 20 20  rnal. .    */.  
ebf0: 20 20 7a 4d 61 73 74 65 72 4a 6f 75 72 6e 61 6c    zMasterJournal
ec00: 20 3d 20 28 63 68 61 72 20 2a 29 73 71 6c 69 74   = (char *)sqlit
ec10: 65 33 5f 6d 61 6c 6c 6f 63 28 6e 4d 61 73 74 65  e3_malloc(nMaste
ec20: 72 4a 6f 75 72 6e 61 6c 20 2b 20 6e 4d 61 73 74  rJournal + nMast
ec30: 65 72 50 74 72 29 3b 0a 20 20 20 20 69 66 28 20  erPtr);.    if( 
ec40: 21 7a 4d 61 73 74 65 72 4a 6f 75 72 6e 61 6c 20  !zMasterJournal 
ec50: 29 7b 0a 20 20 20 20 20 20 72 63 20 3d 20 53 51  ){.      rc = SQ
ec60: 4c 49 54 45 5f 4e 4f 4d 45 4d 3b 0a 20 20 20 20  LITE_NOMEM;.    
ec70: 20 20 67 6f 74 6f 20 64 65 6c 6d 61 73 74 65 72    goto delmaster
ec80: 5f 6f 75 74 3b 0a 20 20 20 20 7d 0a 20 20 20 20  _out;.    }.    
ec90: 7a 4d 61 73 74 65 72 50 74 72 20 3d 20 26 7a 4d  zMasterPtr = &zM
eca0: 61 73 74 65 72 4a 6f 75 72 6e 61 6c 5b 6e 4d 61  asterJournal[nMa
ecb0: 73 74 65 72 4a 6f 75 72 6e 61 6c 5d 3b 0a 20 20  sterJournal];.  
ecc0: 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33 4f 73    rc = sqlite3Os
ecd0: 52 65 61 64 28 70 4d 61 73 74 65 72 2c 20 7a 4d  Read(pMaster, zM
ece0: 61 73 74 65 72 4a 6f 75 72 6e 61 6c 2c 20 6e 4d  asterJournal, nM
ecf0: 61 73 74 65 72 4a 6f 75 72 6e 61 6c 2c 20 30 29  asterJournal, 0)
ed00: 3b 0a 20 20 20 20 69 66 28 20 72 63 21 3d 53 51  ;.    if( rc!=SQ
ed10: 4c 49 54 45 5f 4f 4b 20 29 20 67 6f 74 6f 20 64  LITE_OK ) goto d
ed20: 65 6c 6d 61 73 74 65 72 5f 6f 75 74 3b 0a 0a 20  elmaster_out;.. 
ed30: 20 20 20 7a 4a 6f 75 72 6e 61 6c 20 3d 20 7a 4d     zJournal = zM
ed40: 61 73 74 65 72 4a 6f 75 72 6e 61 6c 3b 0a 20 20  asterJournal;.  
ed50: 20 20 77 68 69 6c 65 28 20 28 7a 4a 6f 75 72 6e    while( (zJourn
ed60: 61 6c 2d 7a 4d 61 73 74 65 72 4a 6f 75 72 6e 61  al-zMasterJourna
ed70: 6c 29 3c 6e 4d 61 73 74 65 72 4a 6f 75 72 6e 61  l)<nMasterJourna
ed80: 6c 20 29 7b 0a 20 20 20 20 20 20 72 63 20 3d 20  l ){.      rc = 
ed90: 73 71 6c 69 74 65 33 4f 73 41 63 63 65 73 73 28  sqlite3OsAccess(
eda0: 70 56 66 73 2c 20 7a 4a 6f 75 72 6e 61 6c 2c 20  pVfs, zJournal, 
edb0: 53 51 4c 49 54 45 5f 41 43 43 45 53 53 5f 45 58  SQLITE_ACCESS_EX
edc0: 49 53 54 53 29 3b 0a 20 20 20 20 20 20 69 66 28  ISTS);.      if(
edd0: 20 72 63 21 3d 30 20 26 26 20 72 63 21 3d 31 20   rc!=0 && rc!=1 
ede0: 29 7b 0a 20 20 20 20 20 20 20 20 72 63 20 3d 20  ){.        rc = 
edf0: 53 51 4c 49 54 45 5f 49 4f 45 52 52 5f 4e 4f 4d  SQLITE_IOERR_NOM
ee00: 45 4d 3b 0a 20 20 20 20 20 20 20 20 67 6f 74 6f  EM;.        goto
ee10: 20 64 65 6c 6d 61 73 74 65 72 5f 6f 75 74 3b 0a   delmaster_out;.
ee20: 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 69 66        }.      if
ee30: 28 20 72 63 3d 3d 31 20 29 7b 0a 20 20 20 20 20  ( rc==1 ){.     
ee40: 20 20 20 2f 2a 20 4f 6e 65 20 6f 66 20 74 68 65     /* One of the
ee50: 20 6a 6f 75 72 6e 61 6c 73 20 70 6f 69 6e 74 65   journals pointe
ee60: 64 20 74 6f 20 62 79 20 74 68 65 20 6d 61 73 74  d to by the mast
ee70: 65 72 20 6a 6f 75 72 6e 61 6c 20 65 78 69 73 74  er journal exist
ee80: 73 2e 0a 20 20 20 20 20 20 20 20 2a 2a 20 4f 70  s..        ** Op
ee90: 65 6e 20 69 74 20 61 6e 64 20 63 68 65 63 6b 20  en it and check 
eea0: 69 66 20 69 74 20 70 6f 69 6e 74 73 20 61 74 20  if it points at 
eeb0: 74 68 65 20 6d 61 73 74 65 72 20 6a 6f 75 72 6e  the master journ
eec0: 61 6c 2e 20 49 66 0a 20 20 20 20 20 20 20 20 2a  al. If.        *
eed0: 2a 20 73 6f 2c 20 72 65 74 75 72 6e 20 77 69 74  * so, return wit
eee0: 68 6f 75 74 20 64 65 6c 65 74 69 6e 67 20 74 68  hout deleting th
eef0: 65 20 6d 61 73 74 65 72 20 6a 6f 75 72 6e 61 6c  e master journal
ef00: 20 66 69 6c 65 2e 0a 20 20 20 20 20 20 20 20 2a   file..        *
ef10: 2f 0a 20 20 20 20 20 20 20 20 69 6e 74 20 63 3b  /.        int c;
ef20: 0a 20 20 20 20 20 20 20 20 69 6e 74 20 66 6c 61  .        int fla
ef30: 67 73 20 3d 20 28 53 51 4c 49 54 45 5f 4f 50 45  gs = (SQLITE_OPE
ef40: 4e 5f 52 45 41 44 4f 4e 4c 59 7c 53 51 4c 49 54  N_READONLY|SQLIT
ef50: 45 5f 4f 50 45 4e 5f 4d 41 49 4e 5f 4a 4f 55 52  E_OPEN_MAIN_JOUR
ef60: 4e 41 4c 29 3b 0a 20 20 20 20 20 20 20 20 72 63  NAL);.        rc
ef70: 20 3d 20 73 71 6c 69 74 65 33 4f 73 4f 70 65 6e   = sqlite3OsOpen
ef80: 28 70 56 66 73 2c 20 7a 4a 6f 75 72 6e 61 6c 2c  (pVfs, zJournal,
ef90: 20 70 4a 6f 75 72 6e 61 6c 2c 20 66 6c 61 67 73   pJournal, flags
efa0: 2c 20 30 29 3b 0a 20 20 20 20 20 20 20 20 69 66  , 0);.        if
efb0: 28 20 72 63 21 3d 53 51 4c 49 54 45 5f 4f 4b 20  ( rc!=SQLITE_OK 
efc0: 29 7b 0a 20 20 20 20 20 20 20 20 20 20 67 6f 74  ){.          got
efd0: 6f 20 64 65 6c 6d 61 73 74 65 72 5f 6f 75 74 3b  o delmaster_out;
efe0: 0a 20 20 20 20 20 20 20 20 7d 0a 0a 20 20 20 20  .        }..    
eff0: 20 20 20 20 72 63 20 3d 20 72 65 61 64 4d 61 73      rc = readMas
f000: 74 65 72 4a 6f 75 72 6e 61 6c 28 70 4a 6f 75 72  terJournal(pJour
f010: 6e 61 6c 2c 20 7a 4d 61 73 74 65 72 50 74 72 2c  nal, zMasterPtr,
f020: 20 6e 4d 61 73 74 65 72 50 74 72 29 3b 0a 20 20   nMasterPtr);.  
f030: 20 20 20 20 20 20 73 71 6c 69 74 65 33 4f 73 43        sqlite3OsC
f040: 6c 6f 73 65 28 70 4a 6f 75 72 6e 61 6c 29 3b 0a  lose(pJournal);.
f050: 20 20 20 20 20 20 20 20 69 66 28 20 72 63 21 3d          if( rc!=
f060: 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20  SQLITE_OK ){.   
f070: 20 20 20 20 20 20 20 67 6f 74 6f 20 64 65 6c 6d         goto delm
f080: 61 73 74 65 72 5f 6f 75 74 3b 0a 20 20 20 20 20  aster_out;.     
f090: 20 20 20 7d 0a 0a 20 20 20 20 20 20 20 20 63 20     }..        c 
f0a0: 3d 20 7a 4d 61 73 74 65 72 50 74 72 5b 30 5d 21  = zMasterPtr[0]!
f0b0: 3d 30 20 26 26 20 73 74 72 63 6d 70 28 7a 4d 61  =0 && strcmp(zMa
f0c0: 73 74 65 72 50 74 72 2c 20 7a 4d 61 73 74 65 72  sterPtr, zMaster
f0d0: 29 3d 3d 30 3b 0a 20 20 20 20 20 20 20 20 69 66  )==0;.        if
f0e0: 28 20 63 20 29 7b 0a 20 20 20 20 20 20 20 20 20  ( c ){.         
f0f0: 20 2f 2a 20 57 65 20 68 61 76 65 20 61 20 6d 61   /* We have a ma
f100: 74 63 68 2e 20 44 6f 20 6e 6f 74 20 64 65 6c 65  tch. Do not dele
f110: 74 65 20 74 68 65 20 6d 61 73 74 65 72 20 6a 6f  te the master jo
f120: 75 72 6e 61 6c 20 66 69 6c 65 2e 20 2a 2f 0a 20  urnal file. */. 
f130: 20 20 20 20 20 20 20 20 20 67 6f 74 6f 20 64 65           goto de
f140: 6c 6d 61 73 74 65 72 5f 6f 75 74 3b 0a 20 20 20  lmaster_out;.   
f150: 20 20 20 20 20 7d 0a 20 20 20 20 20 20 7d 0a 20       }.      }. 
f160: 20 20 20 20 20 7a 4a 6f 75 72 6e 61 6c 20 2b 3d       zJournal +=
f170: 20 28 73 74 72 6c 65 6e 28 7a 4a 6f 75 72 6e 61   (strlen(zJourna
f180: 6c 29 2b 31 29 3b 0a 20 20 20 20 7d 0a 20 20 7d  l)+1);.    }.  }
f190: 0a 20 20 0a 20 20 72 63 20 3d 20 73 71 6c 69 74  .  .  rc = sqlit
f1a0: 65 33 4f 73 44 65 6c 65 74 65 28 70 56 66 73 2c  e3OsDelete(pVfs,
f1b0: 20 7a 4d 61 73 74 65 72 2c 20 30 29 3b 0a 0a 64   zMaster, 0);..d
f1c0: 65 6c 6d 61 73 74 65 72 5f 6f 75 74 3a 0a 20 20  elmaster_out:.  
f1d0: 69 66 28 20 7a 4d 61 73 74 65 72 4a 6f 75 72 6e  if( zMasterJourn
f1e0: 61 6c 20 29 7b 0a 20 20 20 20 73 71 6c 69 74 65  al ){.    sqlite
f1f0: 33 5f 66 72 65 65 28 7a 4d 61 73 74 65 72 4a 6f  3_free(zMasterJo
f200: 75 72 6e 61 6c 29 3b 0a 20 20 7d 20 20 0a 20 20  urnal);.  }  .  
f210: 69 66 28 20 6d 61 73 74 65 72 5f 6f 70 65 6e 20  if( master_open 
f220: 29 7b 0a 20 20 20 20 73 71 6c 69 74 65 33 4f 73  ){.    sqlite3Os
f230: 43 6c 6f 73 65 28 70 4d 61 73 74 65 72 29 3b 0a  Close(pMaster);.
f240: 20 20 7d 0a 20 20 73 71 6c 69 74 65 33 5f 66 72    }.  sqlite3_fr
f250: 65 65 28 70 4d 61 73 74 65 72 29 3b 0a 20 20 72  ee(pMaster);.  r
f260: 65 74 75 72 6e 20 72 63 3b 0a 7d 0a 0a 0a 73 74  eturn rc;.}...st
f270: 61 74 69 63 20 76 6f 69 64 20 70 61 67 65 72 5f  atic void pager_
f280: 74 72 75 6e 63 61 74 65 5f 63 61 63 68 65 28 50  truncate_cache(P
f290: 61 67 65 72 20 2a 70 50 61 67 65 72 29 3b 0a 0a  ager *pPager);..
f2a0: 2f 2a 0a 2a 2a 20 54 72 75 6e 63 61 74 65 20 74  /*.** Truncate t
f2b0: 68 65 20 6d 61 69 6e 20 66 69 6c 65 20 6f 66 20  he main file of 
f2c0: 74 68 65 20 67 69 76 65 6e 20 70 61 67 65 72 20  the given pager 
f2d0: 74 6f 20 74 68 65 20 6e 75 6d 62 65 72 20 6f 66  to the number of
f2e0: 20 70 61 67 65 73 0a 2a 2a 20 69 6e 64 69 63 61   pages.** indica
f2f0: 74 65 64 2e 20 41 6c 73 6f 20 74 72 75 6e 63 61  ted. Also trunca
f300: 74 65 20 74 68 65 20 63 61 63 68 65 64 20 72 65  te the cached re
f310: 70 72 65 73 65 6e 74 61 74 69 6f 6e 20 6f 66 20  presentation of 
f320: 74 68 65 20 66 69 6c 65 2e 0a 2a 2a 0a 2a 2a 20  the file..**.** 
f330: 4d 69 67 68 74 20 6d 69 67 68 74 20 62 65 20 74  Might might be t
f340: 68 65 20 63 61 73 65 20 74 68 61 74 20 74 68 65  he case that the
f350: 20 66 69 6c 65 20 6f 6e 20 64 69 73 6b 20 69 73   file on disk is
f360: 20 73 6d 61 6c 6c 65 72 20 74 68 61 6e 20 6e 50   smaller than nP
f370: 61 67 65 2e 0a 2a 2a 20 54 68 69 73 20 63 61 6e  age..** This can
f380: 20 68 61 70 70 65 6e 2c 20 66 6f 72 20 65 78 61   happen, for exa
f390: 6d 70 6c 65 2c 20 69 66 20 77 65 20 61 72 65 20  mple, if we are 
f3a0: 69 6e 20 74 68 65 20 6d 69 64 64 6c 65 20 6f 66  in the middle of
f3b0: 20 61 20 74 72 61 6e 73 61 63 74 69 6f 6e 0a 2a   a transaction.*
f3c0: 2a 20 77 68 69 63 68 20 68 61 73 20 65 78 74 65  * which has exte
f3d0: 6e 64 65 64 20 74 68 65 20 66 69 6c 65 20 73 69  nded the file si
f3e0: 7a 65 20 61 6e 64 20 74 68 65 20 6e 65 77 20 70  ze and the new p
f3f0: 61 67 65 73 20 61 72 65 20 73 74 69 6c 6c 20 61  ages are still a
f400: 6c 6c 20 68 65 6c 64 0a 2a 2a 20 69 6e 20 63 61  ll held.** in ca
f410: 63 68 65 2c 20 74 68 65 6e 20 61 6e 20 49 4e 53  che, then an INS
f420: 45 52 54 20 6f 72 20 55 50 44 41 54 45 20 64 6f  ERT or UPDATE do
f430: 65 73 20 61 20 73 74 61 74 65 6d 65 6e 74 20 72  es a statement r
f440: 6f 6c 6c 62 61 63 6b 2e 20 20 53 6f 6d 65 0a 2a  ollback.  Some.*
f450: 2a 20 6f 70 65 72 61 74 69 6e 67 20 73 79 73 74  * operating syst
f460: 65 6d 20 69 6d 70 6c 65 6d 65 6e 74 61 74 69 6f  em implementatio
f470: 6e 73 20 63 61 6e 20 67 65 74 20 63 6f 6e 66 75  ns can get confu
f480: 73 65 64 20 69 66 20 79 6f 75 20 74 72 79 20 74  sed if you try t
f490: 6f 0a 2a 2a 20 74 72 75 6e 63 61 74 65 20 61 20  o.** truncate a 
f4a0: 66 69 6c 65 20 74 6f 20 73 6f 6d 65 20 73 69 7a  file to some siz
f4b0: 65 20 74 68 61 74 20 69 73 20 6c 61 72 67 65 72  e that is larger
f4c0: 20 74 68 61 6e 20 69 74 20 63 75 72 72 65 6e 74   than it current
f4d0: 6c 79 20 69 73 2c 0a 2a 2a 20 73 6f 20 64 65 74  ly is,.** so det
f4e0: 65 63 74 20 74 68 69 73 20 63 61 73 65 20 61 6e  ect this case an
f4f0: 64 20 64 6f 20 6e 6f 74 20 64 6f 20 74 68 65 20  d do not do the 
f500: 74 72 75 6e 63 61 74 69 6f 6e 2e 0a 2a 2f 0a 73  truncation..*/.s
f510: 74 61 74 69 63 20 69 6e 74 20 70 61 67 65 72 5f  tatic int pager_
f520: 74 72 75 6e 63 61 74 65 28 50 61 67 65 72 20 2a  truncate(Pager *
f530: 70 50 61 67 65 72 2c 20 69 6e 74 20 6e 50 61 67  pPager, int nPag
f540: 65 29 7b 0a 20 20 69 6e 74 20 72 63 20 3d 20 53  e){.  int rc = S
f550: 51 4c 49 54 45 5f 4f 4b 3b 0a 20 20 69 66 28 20  QLITE_OK;.  if( 
f560: 70 50 61 67 65 72 2d 3e 73 74 61 74 65 3e 3d 50  pPager->state>=P
f570: 41 47 45 52 5f 45 58 43 4c 55 53 49 56 45 20 26  AGER_EXCLUSIVE &
f580: 26 20 70 50 61 67 65 72 2d 3e 66 64 2d 3e 70 4d  & pPager->fd->pM
f590: 65 74 68 6f 64 73 20 29 7b 0a 20 20 20 20 69 36  ethods ){.    i6
f5a0: 34 20 63 75 72 72 65 6e 74 53 69 7a 65 2c 20 6e  4 currentSize, n
f5b0: 65 77 53 69 7a 65 3b 0a 20 20 20 20 72 63 20 3d  ewSize;.    rc =
f5c0: 20 73 71 6c 69 74 65 33 4f 73 46 69 6c 65 53 69   sqlite3OsFileSi
f5d0: 7a 65 28 70 50 61 67 65 72 2d 3e 66 64 2c 20 26  ze(pPager->fd, &
f5e0: 63 75 72 72 65 6e 74 53 69 7a 65 29 3b 0a 20 20  currentSize);.  
f5f0: 20 20 6e 65 77 53 69 7a 65 20 3d 20 70 50 61 67    newSize = pPag
f600: 65 72 2d 3e 70 61 67 65 53 69 7a 65 2a 28 69 36  er->pageSize*(i6
f610: 34 29 6e 50 61 67 65 3b 0a 20 20 20 20 69 66 28  4)nPage;.    if(
f620: 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 26   rc==SQLITE_OK &
f630: 26 20 63 75 72 72 65 6e 74 53 69 7a 65 3e 6e 65  & currentSize>ne
f640: 77 53 69 7a 65 20 29 7b 0a 20 20 20 20 20 20 72  wSize ){.      r
f650: 63 20 3d 20 73 71 6c 69 74 65 33 4f 73 54 72 75  c = sqlite3OsTru
f660: 6e 63 61 74 65 28 70 50 61 67 65 72 2d 3e 66 64  ncate(pPager->fd
f670: 2c 20 6e 65 77 53 69 7a 65 29 3b 0a 20 20 20 20  , newSize);.    
f680: 7d 0a 20 20 7d 0a 20 20 69 66 28 20 72 63 3d 3d  }.  }.  if( rc==
f690: 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20  SQLITE_OK ){.   
f6a0: 20 70 50 61 67 65 72 2d 3e 64 62 53 69 7a 65 20   pPager->dbSize 
f6b0: 3d 20 6e 50 61 67 65 3b 0a 20 20 20 20 70 61 67  = nPage;.    pag
f6c0: 65 72 5f 74 72 75 6e 63 61 74 65 5f 63 61 63 68  er_truncate_cach
f6d0: 65 28 70 50 61 67 65 72 29 3b 0a 20 20 7d 0a 20  e(pPager);.  }. 
f6e0: 20 72 65 74 75 72 6e 20 72 63 3b 0a 7d 0a 0a 2f   return rc;.}../
f6f0: 2a 0a 2a 2a 20 53 65 74 20 74 68 65 20 73 65 63  *.** Set the sec
f700: 74 6f 72 53 69 7a 65 20 66 6f 72 20 74 68 65 20  torSize for the 
f710: 67 69 76 65 6e 20 70 61 67 65 72 2e 0a 2a 2a 0a  given pager..**.
f720: 2a 2a 20 54 68 65 20 73 65 63 74 6f 72 20 73 69  ** The sector si
f730: 7a 65 20 69 73 20 61 74 20 6c 65 61 73 74 20 61  ze is at least a
f740: 73 20 62 69 67 20 61 73 20 74 68 65 20 73 65 63  s big as the sec
f750: 74 6f 72 20 73 69 7a 65 20 72 65 70 6f 72 74 65  tor size reporte
f760: 64 0a 2a 2a 20 62 79 20 73 71 6c 69 74 65 33 4f  d.** by sqlite3O
f770: 73 53 65 63 74 6f 72 53 69 7a 65 28 29 2e 20 20  sSectorSize().  
f780: 54 68 65 20 6d 69 6e 69 6d 75 6d 20 73 65 63 74  The minimum sect
f790: 6f 72 20 73 69 7a 65 20 69 73 20 35 31 32 2e 0a  or size is 512..
f7a0: 2a 2f 0a 73 74 61 74 69 63 20 76 6f 69 64 20 73  */.static void s
f7b0: 65 74 53 65 63 74 6f 72 53 69 7a 65 28 50 61 67  etSectorSize(Pag
f7c0: 65 72 20 2a 70 50 61 67 65 72 29 7b 0a 20 20 61  er *pPager){.  a
f7d0: 73 73 65 72 74 28 70 50 61 67 65 72 2d 3e 66 64  ssert(pPager->fd
f7e0: 2d 3e 70 4d 65 74 68 6f 64 73 7c 7c 70 50 61 67  ->pMethods||pPag
f7f0: 65 72 2d 3e 74 65 6d 70 46 69 6c 65 29 3b 0a 20  er->tempFile);. 
f800: 20 69 66 28 20 21 70 50 61 67 65 72 2d 3e 74 65   if( !pPager->te
f810: 6d 70 46 69 6c 65 20 29 7b 0a 20 20 20 20 2f 2a  mpFile ){.    /*
f820: 20 53 65 63 74 6f 72 20 73 69 7a 65 20 64 6f 65   Sector size doe
f830: 73 6e 27 74 20 6d 61 74 74 65 72 20 66 6f 72 20  sn't matter for 
f840: 74 65 6d 70 6f 72 61 72 79 20 66 69 6c 65 73 2e  temporary files.
f850: 20 41 6c 73 6f 2c 20 74 68 65 20 66 69 6c 65 0a   Also, the file.
f860: 20 20 20 20 2a 2a 20 6d 61 79 20 6e 6f 74 20 68      ** may not h
f870: 61 76 65 20 62 65 65 6e 20 6f 70 65 6e 65 64 20  ave been opened 
f880: 79 65 74 2c 20 69 6e 20 77 68 63 69 68 20 63 61  yet, in whcih ca
f890: 73 65 20 74 68 65 20 4f 73 53 65 63 74 6f 72 53  se the OsSectorS
f8a0: 69 7a 65 28 29 0a 20 20 20 20 2a 2a 20 63 61 6c  ize().    ** cal
f8b0: 6c 20 77 69 6c 6c 20 73 65 67 66 61 75 6c 74 2e  l will segfault.
f8c0: 0a 20 20 20 20 2a 2f 0a 20 20 20 20 70 50 61 67  .    */.    pPag
f8d0: 65 72 2d 3e 73 65 63 74 6f 72 53 69 7a 65 20 3d  er->sectorSize =
f8e0: 20 73 71 6c 69 74 65 33 4f 73 53 65 63 74 6f 72   sqlite3OsSector
f8f0: 53 69 7a 65 28 70 50 61 67 65 72 2d 3e 66 64 29  Size(pPager->fd)
f900: 3b 0a 20 20 7d 0a 20 20 69 66 28 20 70 50 61 67  ;.  }.  if( pPag
f910: 65 72 2d 3e 73 65 63 74 6f 72 53 69 7a 65 3c 35  er->sectorSize<5
f920: 31 32 20 29 7b 0a 20 20 20 20 70 50 61 67 65 72  12 ){.    pPager
f930: 2d 3e 73 65 63 74 6f 72 53 69 7a 65 20 3d 20 35  ->sectorSize = 5
f940: 31 32 3b 0a 20 20 7d 0a 7d 0a 0a 2f 2a 0a 2a 2a  12;.  }.}../*.**
f950: 20 50 6c 61 79 62 61 63 6b 20 74 68 65 20 6a 6f   Playback the jo
f960: 75 72 6e 61 6c 20 61 6e 64 20 74 68 75 73 20 72  urnal and thus r
f970: 65 73 74 6f 72 65 20 74 68 65 20 64 61 74 61 62  estore the datab
f980: 61 73 65 20 66 69 6c 65 20 74 6f 0a 2a 2a 20 74  ase file to.** t
f990: 68 65 20 73 74 61 74 65 20 69 74 20 77 61 73 20  he state it was 
f9a0: 69 6e 20 62 65 66 6f 72 65 20 77 65 20 73 74 61  in before we sta
f9b0: 72 74 65 64 20 6d 61 6b 69 6e 67 20 63 68 61 6e  rted making chan
f9c0: 67 65 73 2e 20 20 0a 2a 2a 0a 2a 2a 20 54 68 65  ges.  .**.** The
f9d0: 20 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 20 66 6f   journal file fo
f9e0: 72 6d 61 74 20 69 73 20 61 73 20 66 6f 6c 6c 6f  rmat is as follo
f9f0: 77 73 3a 20 0a 2a 2a 0a 2a 2a 20 20 28 31 29 20  ws: .**.**  (1) 
fa00: 20 38 20 62 79 74 65 20 70 72 65 66 69 78 2e 20   8 byte prefix. 
fa10: 20 41 20 63 6f 70 79 20 6f 66 20 61 4a 6f 75 72   A copy of aJour
fa20: 6e 61 6c 4d 61 67 69 63 5b 5d 2e 0a 2a 2a 20 20  nalMagic[]..**  
fa30: 28 32 29 20 20 34 20 62 79 74 65 20 62 69 67 2d  (2)  4 byte big-
fa40: 65 6e 64 69 61 6e 20 69 6e 74 65 67 65 72 20 77  endian integer w
fa50: 68 69 63 68 20 69 73 20 74 68 65 20 6e 75 6d 62  hich is the numb
fa60: 65 72 20 6f 66 20 76 61 6c 69 64 20 70 61 67 65  er of valid page
fa70: 20 72 65 63 6f 72 64 73 0a 2a 2a 20 20 20 20 20   records.**     
fa80: 20 20 69 6e 20 74 68 65 20 6a 6f 75 72 6e 61 6c    in the journal
fa90: 2e 20 20 49 66 20 74 68 69 73 20 76 61 6c 75 65  .  If this value
faa0: 20 69 73 20 30 78 66 66 66 66 66 66 66 66 2c 20   is 0xffffffff, 
fab0: 74 68 65 6e 20 63 6f 6d 70 75 74 65 20 74 68 65  then compute the
fac0: 0a 2a 2a 20 20 20 20 20 20 20 6e 75 6d 62 65 72  .**       number
fad0: 20 6f 66 20 70 61 67 65 20 72 65 63 6f 72 64 73   of page records
fae0: 20 66 72 6f 6d 20 74 68 65 20 6a 6f 75 72 6e 61   from the journa
faf0: 6c 20 73 69 7a 65 2e 0a 2a 2a 20 20 28 33 29 20  l size..**  (3) 
fb00: 20 34 20 62 79 74 65 20 62 69 67 2d 65 6e 64 69   4 byte big-endi
fb10: 61 6e 20 69 6e 74 65 67 65 72 20 77 68 69 63 68  an integer which
fb20: 20 69 73 20 74 68 65 20 69 6e 69 74 69 61 6c 20   is the initial 
fb30: 76 61 6c 75 65 20 66 6f 72 20 74 68 65 20 0a 2a  value for the .*
fb40: 2a 20 20 20 20 20 20 20 73 61 6e 69 74 79 20 63  *       sanity c
fb50: 68 65 63 6b 73 75 6d 2e 0a 2a 2a 20 20 28 34 29  hecksum..**  (4)
fb60: 20 20 34 20 62 79 74 65 20 69 6e 74 65 67 65 72    4 byte integer
fb70: 20 77 68 69 63 68 20 69 73 20 74 68 65 20 6e 75   which is the nu
fb80: 6d 62 65 72 20 6f 66 20 70 61 67 65 73 20 74 6f  mber of pages to
fb90: 20 74 72 75 6e 63 61 74 65 20 74 68 65 0a 2a 2a   truncate the.**
fba0: 20 20 20 20 20 20 20 64 61 74 61 62 61 73 65 20         database 
fbb0: 74 6f 20 64 75 72 69 6e 67 20 61 20 72 6f 6c 6c  to during a roll
fbc0: 62 61 63 6b 2e 0a 2a 2a 20 20 28 35 29 20 20 34  back..**  (5)  4
fbd0: 20 62 79 74 65 20 62 69 67 2d 65 6e 64 69 61 6e   byte big-endian
fbe0: 20 69 6e 74 65 67 65 72 20 77 68 69 63 68 20 69   integer which i
fbf0: 73 20 74 68 65 20 73 65 63 74 6f 72 20 73 69 7a  s the sector siz
fc00: 65 2e 20 20 54 68 65 20 68 65 61 64 65 72 0a 2a  e.  The header.*
fc10: 2a 20 20 20 20 20 20 20 69 73 20 74 68 69 73 20  *       is this 
fc20: 6d 61 6e 79 20 62 79 74 65 73 20 69 6e 20 73 69  many bytes in si
fc30: 7a 65 2e 0a 2a 2a 20 20 28 36 29 20 20 34 20 62  ze..**  (6)  4 b
fc40: 79 74 65 20 62 69 67 2d 65 6e 64 69 61 6e 20 69  yte big-endian i
fc50: 6e 74 65 67 65 72 20 77 68 69 63 68 20 69 73 20  nteger which is 
fc60: 74 68 65 20 70 61 67 65 20 63 61 73 65 2e 0a 2a  the page case..*
fc70: 2a 20 20 28 37 29 20 20 34 20 62 79 74 65 20 69  *  (7)  4 byte i
fc80: 6e 74 65 67 65 72 20 77 68 69 63 68 20 69 73 20  nteger which is 
fc90: 74 68 65 20 6e 75 6d 62 65 72 20 6f 66 20 62 79  the number of by
fca0: 74 65 73 20 69 6e 20 74 68 65 20 6d 61 73 74 65  tes in the maste
fcb0: 72 20 6a 6f 75 72 6e 61 6c 0a 2a 2a 20 20 20 20  r journal.**    
fcc0: 20 20 20 6e 61 6d 65 2e 20 20 54 68 65 20 76 61     name.  The va
fcd0: 6c 75 65 20 6d 61 79 20 62 65 20 7a 65 72 6f 20  lue may be zero 
fce0: 28 69 6e 64 69 63 61 74 65 20 74 68 61 74 20 74  (indicate that t
fcf0: 68 65 72 65 20 69 73 20 6e 6f 20 6d 61 73 74 65  here is no maste
fd00: 72 0a 2a 2a 20 20 20 20 20 20 20 6a 6f 75 72 6e  r.**       journ
fd10: 61 6c 2e 29 0a 2a 2a 20 20 28 38 29 20 20 4e 20  al.).**  (8)  N 
fd20: 62 79 74 65 73 20 6f 66 20 74 68 65 20 6d 61 73  bytes of the mas
fd30: 74 65 72 20 6a 6f 75 72 6e 61 6c 20 6e 61 6d 65  ter journal name
fd40: 2e 20 20 54 68 65 20 6e 61 6d 65 20 77 69 6c 6c  .  The name will
fd50: 20 62 65 20 6e 75 6c 2d 74 65 72 6d 69 6e 61 74   be nul-terminat
fd60: 65 64 0a 2a 2a 20 20 20 20 20 20 20 61 6e 64 20  ed.**       and 
fd70: 6d 69 67 68 74 20 62 65 20 73 68 6f 72 74 65 72  might be shorter
fd80: 20 74 68 61 6e 20 74 68 65 20 76 61 6c 75 65 20   than the value 
fd90: 72 65 61 64 20 66 72 6f 6d 20 28 35 29 2e 20 20  read from (5).  
fda0: 49 66 20 74 68 65 20 66 69 72 73 74 20 62 79 74  If the first byt
fdb0: 65 0a 2a 2a 20 20 20 20 20 20 20 6f 66 20 74 68  e.**       of th
fdc0: 65 20 6e 61 6d 65 20 69 73 20 5c 30 30 30 20 74  e name is \000 t
fdd0: 68 65 6e 20 74 68 65 72 65 20 69 73 20 6e 6f 20  hen there is no 
fde0: 6d 61 73 74 65 72 20 6a 6f 75 72 6e 61 6c 2e 20  master journal. 
fdf0: 20 54 68 65 20 6d 61 73 74 65 72 0a 2a 2a 20 20   The master.**  
fe00: 20 20 20 20 20 6a 6f 75 72 6e 61 6c 20 6e 61 6d       journal nam
fe10: 65 20 69 73 20 73 74 6f 72 65 64 20 69 6e 20 55  e is stored in U
fe20: 54 46 2d 38 2e 0a 2a 2a 20 20 28 39 29 20 20 5a  TF-8..**  (9)  Z
fe30: 65 72 6f 20 6f 72 20 6d 6f 72 65 20 70 61 67 65  ero or more page
fe40: 73 20 69 6e 73 74 61 6e 63 65 73 2c 20 65 61 63  s instances, eac
fe50: 68 20 61 73 20 66 6f 6c 6c 6f 77 73 3a 0a 2a 2a  h as follows:.**
fe60: 20 20 20 20 20 20 20 20 2b 20 20 34 20 62 79 74          +  4 byt
fe70: 65 20 70 61 67 65 20 6e 75 6d 62 65 72 2e 0a 2a  e page number..*
fe80: 2a 20 20 20 20 20 20 20 20 2b 20 20 70 50 61 67  *        +  pPag
fe90: 65 72 2d 3e 70 61 67 65 53 69 7a 65 20 62 79 74  er->pageSize byt
fea0: 65 73 20 6f 66 20 64 61 74 61 2e 0a 2a 2a 20 20  es of data..**  
feb0: 20 20 20 20 20 20 2b 20 20 34 20 62 79 74 65 20        +  4 byte 
fec0: 63 68 65 63 6b 73 75 6d 0a 2a 2a 0a 2a 2a 20 57  checksum.**.** W
fed0: 68 65 6e 20 77 65 20 73 70 65 61 6b 20 6f 66 20  hen we speak of 
fee0: 74 68 65 20 6a 6f 75 72 6e 61 6c 20 68 65 61 64  the journal head
fef0: 65 72 2c 20 77 65 20 6d 65 61 6e 20 74 68 65 20  er, we mean the 
ff00: 66 69 72 73 74 20 38 20 69 74 65 6d 73 20 61 62  first 8 items ab
ff10: 6f 76 65 2e 0a 2a 2a 20 45 61 63 68 20 65 6e 74  ove..** Each ent
ff20: 72 79 20 69 6e 20 74 68 65 20 6a 6f 75 72 6e 61  ry in the journa
ff30: 6c 20 69 73 20 61 6e 20 69 6e 73 74 61 6e 63 65  l is an instance
ff40: 20 6f 66 20 74 68 65 20 39 74 68 20 69 74 65 6d   of the 9th item
ff50: 2e 0a 2a 2a 0a 2a 2a 20 43 61 6c 6c 20 74 68 65  ..**.** Call the
ff60: 20 76 61 6c 75 65 20 66 72 6f 6d 20 74 68 65 20   value from the 
ff70: 73 65 63 6f 6e 64 20 62 75 6c 6c 65 74 20 22 6e  second bullet "n
ff80: 52 65 63 22 2e 20 20 6e 52 65 63 20 69 73 20 74  Rec".  nRec is t
ff90: 68 65 20 6e 75 6d 62 65 72 20 6f 66 0a 2a 2a 20  he number of.** 
ffa0: 76 61 6c 69 64 20 70 61 67 65 20 65 6e 74 72 69  valid page entri
ffb0: 65 73 20 69 6e 20 74 68 65 20 6a 6f 75 72 6e 61  es in the journa
ffc0: 6c 2e 20 20 49 6e 20 6d 6f 73 74 20 63 61 73 65  l.  In most case
ffd0: 73 2c 20 79 6f 75 20 63 61 6e 20 63 6f 6d 70 75  s, you can compu
ffe0: 74 65 20 74 68 65 0a 2a 2a 20 76 61 6c 75 65 20  te the.** value 
fff0: 6f 66 20 6e 52 65 63 20 66 72 6f 6d 20 74 68 65  of nRec from the
10000 20 73 69 7a 65 20 6f 66 20 74 68 65 20 6a 6f 75   size of the jou
10010 72 6e 61 6c 20 66 69 6c 65 2e 20 20 42 75 74 20  rnal file.  But 
10020 69 66 20 61 20 70 6f 77 65 72 0a 2a 2a 20 66 61  if a power.** fa
10030 69 6c 75 72 65 20 6f 63 63 75 72 72 65 64 20 77  ilure occurred w
10040 68 69 6c 65 20 74 68 65 20 6a 6f 75 72 6e 61 6c  hile the journal
10050 20 77 61 73 20 62 65 69 6e 67 20 77 72 69 74 74   was being writt
10060 65 6e 2c 20 69 74 20 63 6f 75 6c 64 20 62 65 20  en, it could be 
10070 74 68 65 0a 2a 2a 20 63 61 73 65 20 74 68 61 74  the.** case that
10080 20 74 68 65 20 73 69 7a 65 20 6f 66 20 74 68 65   the size of the
10090 20 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 20 68 61   journal file ha
100a0 64 20 61 6c 72 65 61 64 79 20 62 65 65 6e 20 69  d already been i
100b0 6e 63 72 65 61 73 65 64 20 62 75 74 0a 2a 2a 20  ncreased but.** 
100c0 74 68 65 20 65 78 74 72 61 20 65 6e 74 72 69 65  the extra entrie
100d0 73 20 68 61 64 20 6e 6f 74 20 79 65 74 20 6d 61  s had not yet ma
100e0 64 65 20 69 74 20 73 61 66 65 6c 79 20 74 6f 20  de it safely to 
100f0 64 69 73 6b 2e 20 20 49 6e 20 73 75 63 68 20 61  disk.  In such a
10100 20 63 61 73 65 2c 0a 2a 2a 20 74 68 65 20 76 61   case,.** the va
10110 6c 75 65 20 6f 66 20 6e 52 65 63 20 63 6f 6d 70  lue of nRec comp
10120 75 74 65 64 20 66 72 6f 6d 20 74 68 65 20 66 69  uted from the fi
10130 6c 65 20 73 69 7a 65 20 77 6f 75 6c 64 20 62 65  le size would be
10140 20 74 6f 6f 20 6c 61 72 67 65 2e 20 20 46 6f 72   too large.  For
10150 0a 2a 2a 20 74 68 61 74 20 72 65 61 73 6f 6e 2c  .** that reason,
10160 20 77 65 20 61 6c 77 61 79 73 20 75 73 65 20 74   we always use t
10170 68 65 20 6e 52 65 63 20 76 61 6c 75 65 20 69 6e  he nRec value in
10180 20 74 68 65 20 68 65 61 64 65 72 2e 0a 2a 2a 0a   the header..**.
10190 2a 2a 20 49 66 20 74 68 65 20 6e 52 65 63 20 76  ** If the nRec v
101a0 61 6c 75 65 20 69 73 20 30 78 66 66 66 66 66 66  alue is 0xffffff
101b0 66 66 20 69 74 20 6d 65 61 6e 73 20 74 68 61 74  ff it means that
101c0 20 6e 52 65 63 20 73 68 6f 75 6c 64 20 62 65 20   nRec should be 
101d0 63 6f 6d 70 75 74 65 64 0a 2a 2a 20 66 72 6f 6d  computed.** from
101e0 20 74 68 65 20 66 69 6c 65 20 73 69 7a 65 2e 20   the file size. 
101f0 20 54 68 69 73 20 76 61 6c 75 65 20 69 73 20 75   This value is u
10200 73 65 64 20 77 68 65 6e 20 74 68 65 20 75 73 65  sed when the use
10210 72 20 73 65 6c 65 63 74 73 20 74 68 65 0a 2a 2a  r selects the.**
10220 20 6e 6f 2d 73 79 6e 63 20 6f 70 74 69 6f 6e 20   no-sync option 
10230 66 6f 72 20 74 68 65 20 6a 6f 75 72 6e 61 6c 2e  for the journal.
10240 20 20 41 20 70 6f 77 65 72 20 66 61 69 6c 75 72    A power failur
10250 65 20 63 6f 75 6c 64 20 6c 65 61 64 20 74 6f 20  e could lead to 
10260 63 6f 72 72 75 70 74 69 6f 6e 0a 2a 2a 20 69 6e  corruption.** in
10270 20 74 68 69 73 20 63 61 73 65 2e 20 20 42 75 74   this case.  But
10280 20 66 6f 72 20 74 68 69 6e 67 73 20 6c 69 6b 65   for things like
10290 20 74 65 6d 70 6f 72 61 72 79 20 74 61 62 6c 65   temporary table
102a0 20 28 77 68 69 63 68 20 77 69 6c 6c 20 62 65 0a   (which will be.
102b0 2a 2a 20 64 65 6c 65 74 65 64 20 77 68 65 6e 20  ** deleted when 
102c0 74 68 65 20 70 6f 77 65 72 20 69 73 20 72 65 73  the power is res
102d0 74 6f 72 65 64 29 20 77 65 20 64 6f 6e 27 74 20  tored) we don't 
102e0 63 61 72 65 2e 20 20 0a 2a 2a 0a 2a 2a 20 49 66  care.  .**.** If
102f0 20 74 68 65 20 66 69 6c 65 20 6f 70 65 6e 65 64   the file opened
10300 20 61 73 20 74 68 65 20 6a 6f 75 72 6e 61 6c 20   as the journal 
10310 66 69 6c 65 20 69 73 20 6e 6f 74 20 61 20 77 65  file is not a we
10320 6c 6c 2d 66 6f 72 6d 65 64 0a 2a 2a 20 6a 6f 75  ll-formed.** jou
10330 72 6e 61 6c 20 66 69 6c 65 20 74 68 65 6e 20 61  rnal file then a
10340 6c 6c 20 70 61 67 65 73 20 75 70 20 74 6f 20 74  ll pages up to t
10350 68 65 20 66 69 72 73 74 20 63 6f 72 72 75 70 74  he first corrupt
10360 65 64 20 70 61 67 65 20 61 72 65 20 72 6f 6c 6c  ed page are roll
10370 65 64 0a 2a 2a 20 62 61 63 6b 20 28 6f 72 20 6e  ed.** back (or n
10380 6f 20 70 61 67 65 73 20 69 66 20 74 68 65 20 6a  o pages if the j
10390 6f 75 72 6e 61 6c 20 68 65 61 64 65 72 20 69 73  ournal header is
103a0 20 63 6f 72 72 75 70 74 65 64 29 2e 20 54 68 65   corrupted). The
103b0 20 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 0a 2a 2a   journal file.**
103c0 20 69 73 20 74 68 65 6e 20 64 65 6c 65 74 65 64   is then deleted
103d0 20 61 6e 64 20 53 51 4c 49 54 45 5f 4f 4b 20 72   and SQLITE_OK r
103e0 65 74 75 72 6e 65 64 2c 20 6a 75 73 74 20 61 73  eturned, just as
103f0 20 69 66 20 6e 6f 20 63 6f 72 72 75 70 74 69 6f   if no corruptio
10400 6e 20 68 61 64 0a 2a 2a 20 62 65 65 6e 20 65 6e  n had.** been en
10410 63 6f 75 6e 74 65 72 65 64 2e 0a 2a 2a 0a 2a 2a  countered..**.**
10420 20 49 66 20 61 6e 20 49 2f 4f 20 6f 72 20 6d 61   If an I/O or ma
10430 6c 6c 6f 63 28 29 20 65 72 72 6f 72 20 6f 63 63  lloc() error occ
10440 75 72 73 2c 20 74 68 65 20 6a 6f 75 72 6e 61 6c  urs, the journal
10450 2d 66 69 6c 65 20 69 73 20 6e 6f 74 20 64 65 6c  -file is not del
10460 65 74 65 64 0a 2a 2a 20 61 6e 64 20 61 6e 20 65  eted.** and an e
10470 72 72 6f 72 20 63 6f 64 65 20 69 73 20 72 65 74  rror code is ret
10480 75 72 6e 65 64 2e 0a 2a 2f 0a 73 74 61 74 69 63  urned..*/.static
10490 20 69 6e 74 20 70 61 67 65 72 5f 70 6c 61 79 62   int pager_playb
104a0 61 63 6b 28 50 61 67 65 72 20 2a 70 50 61 67 65  ack(Pager *pPage
104b0 72 2c 20 69 6e 74 20 69 73 48 6f 74 29 7b 0a 20  r, int isHot){. 
104c0 20 73 71 6c 69 74 65 33 5f 76 66 73 20 2a 70 56   sqlite3_vfs *pV
104d0 66 73 20 3d 20 70 50 61 67 65 72 2d 3e 70 56 66  fs = pPager->pVf
104e0 73 3b 0a 20 20 69 36 34 20 73 7a 4a 3b 20 20 20  s;.  i64 szJ;   
104f0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a                /*
10500 20 53 69 7a 65 20 6f 66 20 74 68 65 20 6a 6f 75   Size of the jou
10510 72 6e 61 6c 20 66 69 6c 65 20 69 6e 20 62 79 74  rnal file in byt
10520 65 73 20 2a 2f 0a 20 20 75 33 32 20 6e 52 65 63  es */.  u32 nRec
10530 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20  ;               
10540 20 2f 2a 20 4e 75 6d 62 65 72 20 6f 66 20 52 65   /* Number of Re
10550 63 6f 72 64 73 20 69 6e 20 74 68 65 20 6a 6f 75  cords in the jou
10560 72 6e 61 6c 20 2a 2f 0a 20 20 69 6e 74 20 69 3b  rnal */.  int i;
10570 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
10580 20 20 20 2f 2a 20 4c 6f 6f 70 20 63 6f 75 6e 74     /* Loop count
10590 65 72 20 2a 2f 0a 20 20 50 67 6e 6f 20 6d 78 50  er */.  Pgno mxP
105a0 67 20 3d 20 30 3b 20 20 20 20 20 20 20 20 20 20  g = 0;          
105b0 20 2f 2a 20 53 69 7a 65 20 6f 66 20 74 68 65 20   /* Size of the 
105c0 6f 72 69 67 69 6e 61 6c 20 66 69 6c 65 20 69 6e  original file in
105d0 20 70 61 67 65 73 20 2a 2f 0a 20 20 69 6e 74 20   pages */.  int 
105e0 72 63 3b 20 20 20 20 20 20 20 20 20 20 20 20 20  rc;             
105f0 20 20 20 20 20 2f 2a 20 52 65 73 75 6c 74 20 63       /* Result c
10600 6f 64 65 20 6f 66 20 61 20 73 75 62 72 6f 75 74  ode of a subrout
10610 69 6e 65 20 2a 2f 0a 20 20 69 6e 74 20 72 65 73  ine */.  int res
10620 20 3d 20 30 3b 20 20 20 20 20 20 20 20 20 20 20   = 0;           
10630 20 20 2f 2a 20 56 61 6c 75 65 20 72 65 74 75 72    /* Value retur
10640 6e 65 64 20 62 79 20 73 71 6c 69 74 65 33 4f 73  ned by sqlite3Os
10650 41 63 63 65 73 73 28 29 20 2a 2f 0a 20 20 63 68  Access() */.  ch
10660 61 72 20 2a 7a 4d 61 73 74 65 72 20 3d 20 30 3b  ar *zMaster = 0;
10670 20 20 20 20 20 20 20 2f 2a 20 4e 61 6d 65 20 6f         /* Name o
10680 66 20 6d 61 73 74 65 72 20 6a 6f 75 72 6e 61 6c  f master journal
10690 20 66 69 6c 65 20 69 66 20 61 6e 79 20 2a 2f 0a   file if any */.
106a0 0a 20 20 2f 2a 20 46 69 67 75 72 65 20 6f 75 74  .  /* Figure out
106b0 20 68 6f 77 20 6d 61 6e 79 20 72 65 63 6f 72 64   how many record
106c0 73 20 61 72 65 20 69 6e 20 74 68 65 20 6a 6f 75  s are in the jou
106d0 72 6e 61 6c 2e 20 20 41 62 6f 72 74 20 65 61 72  rnal.  Abort ear
106e0 6c 79 20 69 66 0a 20 20 2a 2a 20 74 68 65 20 6a  ly if.  ** the j
106f0 6f 75 72 6e 61 6c 20 69 73 20 65 6d 70 74 79 2e  ournal is empty.
10700 0a 20 20 2a 2f 0a 20 20 61 73 73 65 72 74 28 20  .  */.  assert( 
10710 70 50 61 67 65 72 2d 3e 6a 6f 75 72 6e 61 6c 4f  pPager->journalO
10720 70 65 6e 20 29 3b 0a 20 20 72 63 20 3d 20 73 71  pen );.  rc = sq
10730 6c 69 74 65 33 4f 73 46 69 6c 65 53 69 7a 65 28  lite3OsFileSize(
10740 70 50 61 67 65 72 2d 3e 6a 66 64 2c 20 26 73 7a  pPager->jfd, &sz
10750 4a 29 3b 0a 20 20 69 66 28 20 72 63 21 3d 53 51  J);.  if( rc!=SQ
10760 4c 49 54 45 5f 4f 4b 20 7c 7c 20 73 7a 4a 3d 3d  LITE_OK || szJ==
10770 30 20 29 7b 0a 20 20 20 20 67 6f 74 6f 20 65 6e  0 ){.    goto en
10780 64 5f 70 6c 61 79 62 61 63 6b 3b 0a 20 20 7d 0a  d_playback;.  }.
10790 0a 20 20 2f 2a 20 52 65 61 64 20 74 68 65 20 6d  .  /* Read the m
107a0 61 73 74 65 72 20 6a 6f 75 72 6e 61 6c 20 6e 61  aster journal na
107b0 6d 65 20 66 72 6f 6d 20 74 68 65 20 6a 6f 75 72  me from the jour
107c0 6e 61 6c 2c 20 69 66 20 69 74 20 69 73 20 70 72  nal, if it is pr
107d0 65 73 65 6e 74 2e 0a 20 20 2a 2a 20 49 66 20 61  esent..  ** If a
107e0 20 6d 61 73 74 65 72 20 6a 6f 75 72 6e 61 6c 20   master journal 
107f0 66 69 6c 65 20 6e 61 6d 65 20 69 73 20 73 70 65  file name is spe
10800 63 69 66 69 65 64 2c 20 62 75 74 20 74 68 65 20  cified, but the 
10810 66 69 6c 65 20 69 73 20 6e 6f 74 0a 20 20 2a 2a  file is not.  **
10820 20 70 72 65 73 65 6e 74 20 6f 6e 20 64 69 73 6b   present on disk
10830 2c 20 74 68 65 6e 20 74 68 65 20 6a 6f 75 72 6e  , then the journ
10840 61 6c 20 69 73 20 6e 6f 74 20 68 6f 74 20 61 6e  al is not hot an
10850 64 20 64 6f 65 73 20 6e 6f 74 20 6e 65 65 64 20  d does not need 
10860 74 6f 20 62 65 0a 20 20 2a 2a 20 70 6c 61 79 65  to be.  ** playe
10870 64 20 62 61 63 6b 2e 0a 20 20 2a 2f 0a 20 20 7a  d back..  */.  z
10880 4d 61 73 74 65 72 20 3d 20 70 50 61 67 65 72 2d  Master = pPager-
10890 3e 70 54 6d 70 53 70 61 63 65 3b 0a 20 20 72 63  >pTmpSpace;.  rc
108a0 20 3d 20 72 65 61 64 4d 61 73 74 65 72 4a 6f 75   = readMasterJou
108b0 72 6e 61 6c 28 70 50 61 67 65 72 2d 3e 6a 66 64  rnal(pPager->jfd
108c0 2c 20 7a 4d 61 73 74 65 72 2c 20 70 50 61 67 65  , zMaster, pPage
108d0 72 2d 3e 70 56 66 73 2d 3e 6d 78 50 61 74 68 6e  r->pVfs->mxPathn
108e0 61 6d 65 2b 31 29 3b 0a 20 20 69 66 28 20 72 63  ame+1);.  if( rc
108f0 21 3d 53 51 4c 49 54 45 5f 4f 4b 20 7c 7c 20 28  !=SQLITE_OK || (
10900 7a 4d 61 73 74 65 72 5b 30 5d 20 0a 20 20 20 26  zMaster[0] .   &
10910 26 20 28 72 65 73 3d 73 71 6c 69 74 65 33 4f 73  & (res=sqlite3Os
10920 41 63 63 65 73 73 28 70 56 66 73 2c 20 7a 4d 61  Access(pVfs, zMa
10930 73 74 65 72 2c 20 53 51 4c 49 54 45 5f 41 43 43  ster, SQLITE_ACC
10940 45 53 53 5f 45 58 49 53 54 53 29 29 3d 3d 30 20  ESS_EXISTS))==0 
10950 29 20 0a 20 20 29 7b 0a 20 20 20 20 7a 4d 61 73  ) .  ){.    zMas
10960 74 65 72 20 3d 20 30 3b 0a 20 20 20 20 67 6f 74  ter = 0;.    got
10970 6f 20 65 6e 64 5f 70 6c 61 79 62 61 63 6b 3b 0a  o end_playback;.
10980 20 20 7d 0a 20 20 7a 4d 61 73 74 65 72 20 3d 20    }.  zMaster = 
10990 30 3b 0a 20 20 69 66 28 20 72 65 73 3c 30 20 29  0;.  if( res<0 )
109a0 7b 0a 20 20 20 20 72 63 20 3d 20 53 51 4c 49 54  {.    rc = SQLIT
109b0 45 5f 49 4f 45 52 52 5f 4e 4f 4d 45 4d 3b 0a 20  E_IOERR_NOMEM;. 
109c0 20 20 20 67 6f 74 6f 20 65 6e 64 5f 70 6c 61 79     goto end_play
109d0 62 61 63 6b 3b 0a 20 20 7d 0a 20 20 70 50 61 67  back;.  }.  pPag
109e0 65 72 2d 3e 6a 6f 75 72 6e 61 6c 4f 66 66 20 3d  er->journalOff =
109f0 20 30 3b 0a 0a 20 20 2f 2a 20 54 68 69 73 20 6c   0;..  /* This l
10a00 6f 6f 70 20 74 65 72 6d 69 6e 61 74 65 73 20 65  oop terminates e
10a10 69 74 68 65 72 20 77 68 65 6e 20 74 68 65 20 72  ither when the r
10a20 65 61 64 4a 6f 75 72 6e 61 6c 48 64 72 28 29 20  eadJournalHdr() 
10a30 63 61 6c 6c 20 72 65 74 75 72 6e 73 0a 20 20 2a  call returns.  *
10a40 2a 20 53 51 4c 49 54 45 5f 44 4f 4e 45 20 6f 72  * SQLITE_DONE or
10a50 20 61 6e 20 49 4f 20 65 72 72 6f 72 20 6f 63 63   an IO error occ
10a60 75 72 73 2e 20 2a 2f 0a 20 20 77 68 69 6c 65 28  urs. */.  while(
10a70 20 31 20 29 7b 0a 0a 20 20 20 20 2f 2a 20 52 65   1 ){..    /* Re
10a80 61 64 20 74 68 65 20 6e 65 78 74 20 6a 6f 75 72  ad the next jour
10a90 6e 61 6c 20 68 65 61 64 65 72 20 66 72 6f 6d 20  nal header from 
10aa0 74 68 65 20 6a 6f 75 72 6e 61 6c 20 66 69 6c 65  the journal file
10ab0 2e 20 20 49 66 20 74 68 65 72 65 20 61 72 65 0a  .  If there are.
10ac0 20 20 20 20 2a 2a 20 6e 6f 74 20 65 6e 6f 75 67      ** not enoug
10ad0 68 20 62 79 74 65 73 20 6c 65 66 74 20 69 6e 20  h bytes left in 
10ae0 74 68 65 20 6a 6f 75 72 6e 61 6c 20 66 69 6c 65  the journal file
10af0 20 66 6f 72 20 61 20 63 6f 6d 70 6c 65 74 65 20   for a complete 
10b00 68 65 61 64 65 72 2c 20 6f 72 0a 20 20 20 20 2a  header, or.    *
10b10 2a 20 69 74 20 69 73 20 63 6f 72 72 75 70 74 65  * it is corrupte
10b20 64 2c 20 74 68 65 6e 20 61 20 70 72 6f 63 65 73  d, then a proces
10b30 73 20 6d 75 73 74 20 6f 66 20 66 61 69 6c 65 64  s must of failed
10b40 20 77 68 69 6c 65 20 77 72 69 74 69 6e 67 20 69   while writing i
10b50 74 2e 0a 20 20 20 20 2a 2a 20 54 68 69 73 20 69  t..    ** This i
10b60 6e 64 69 63 61 74 65 73 20 6e 6f 74 68 69 6e 67  ndicates nothing
10b70 20 6d 6f 72 65 20 6e 65 65 64 73 20 74 6f 20 62   more needs to b
10b80 65 20 72 6f 6c 6c 65 64 20 62 61 63 6b 2e 0a 20  e rolled back.. 
10b90 20 20 20 2a 2f 0a 20 20 20 20 72 63 20 3d 20 72     */.    rc = r
10ba0 65 61 64 4a 6f 75 72 6e 61 6c 48 64 72 28 70 50  eadJournalHdr(pP
10bb0 61 67 65 72 2c 20 73 7a 4a 2c 20 26 6e 52 65 63  ager, szJ, &nRec
10bc0 2c 20 26 6d 78 50 67 29 3b 0a 20 20 20 20 69 66  , &mxPg);.    if
10bd0 28 20 72 63 21 3d 53 51 4c 49 54 45 5f 4f 4b 20  ( rc!=SQLITE_OK 
10be0 29 7b 20 0a 20 20 20 20 20 20 69 66 28 20 72 63  ){ .      if( rc
10bf0 3d 3d 53 51 4c 49 54 45 5f 44 4f 4e 45 20 29 7b  ==SQLITE_DONE ){
10c00 0a 20 20 20 20 20 20 20 20 72 63 20 3d 20 53 51  .        rc = SQ
10c10 4c 49 54 45 5f 4f 4b 3b 0a 20 20 20 20 20 20 7d  LITE_OK;.      }
10c20 0a 20 20 20 20 20 20 67 6f 74 6f 20 65 6e 64 5f  .      goto end_
10c30 70 6c 61 79 62 61 63 6b 3b 0a 20 20 20 20 7d 0a  playback;.    }.
10c40 0a 20 20 20 20 2f 2a 20 49 66 20 6e 52 65 63 20  .    /* If nRec 
10c50 69 73 20 30 78 66 66 66 66 66 66 66 66 2c 20 74  is 0xffffffff, t
10c60 68 65 6e 20 74 68 69 73 20 6a 6f 75 72 6e 61 6c  hen this journal
10c70 20 77 61 73 20 63 72 65 61 74 65 64 20 62 79 20   was created by 
10c80 61 20 70 72 6f 63 65 73 73 0a 20 20 20 20 2a 2a  a process.    **
10c90 20 77 6f 72 6b 69 6e 67 20 69 6e 20 6e 6f 2d 73   working in no-s
10ca0 79 6e 63 20 6d 6f 64 65 2e 20 54 68 69 73 20 6d  ync mode. This m
10cb0 65 61 6e 73 20 74 68 61 74 20 74 68 65 20 72 65  eans that the re
10cc0 73 74 20 6f 66 20 74 68 65 20 6a 6f 75 72 6e 61  st of the journa
10cd0 6c 0a 20 20 20 20 2a 2a 20 66 69 6c 65 20 63 6f  l.    ** file co
10ce0 6e 73 69 73 74 73 20 6f 66 20 70 61 67 65 73 2c  nsists of pages,
10cf0 20 74 68 65 72 65 20 61 72 65 20 6e 6f 20 6d 6f   there are no mo
10d00 72 65 20 6a 6f 75 72 6e 61 6c 20 68 65 61 64 65  re journal heade
10d10 72 73 2e 20 43 6f 6d 70 75 74 65 0a 20 20 20 20  rs. Compute.    
10d20 2a 2a 20 74 68 65 20 76 61 6c 75 65 20 6f 66 20  ** the value of 
10d30 6e 52 65 63 20 62 61 73 65 64 20 6f 6e 20 74 68  nRec based on th
10d40 69 73 20 61 73 73 75 6d 70 74 69 6f 6e 2e 0a 20  is assumption.. 
10d50 20 20 20 2a 2f 0a 20 20 20 20 69 66 28 20 6e 52     */.    if( nR
10d60 65 63 3d 3d 30 78 66 66 66 66 66 66 66 66 20 29  ec==0xffffffff )
10d70 7b 0a 20 20 20 20 20 20 61 73 73 65 72 74 28 20  {.      assert( 
10d80 70 50 61 67 65 72 2d 3e 6a 6f 75 72 6e 61 6c 4f  pPager->journalO
10d90 66 66 3d 3d 4a 4f 55 52 4e 41 4c 5f 48 44 52 5f  ff==JOURNAL_HDR_
10da0 53 5a 28 70 50 61 67 65 72 29 20 29 3b 0a 20 20  SZ(pPager) );.  
10db0 20 20 20 20 6e 52 65 63 20 3d 20 28 73 7a 4a 20      nRec = (szJ 
10dc0 2d 20 4a 4f 55 52 4e 41 4c 5f 48 44 52 5f 53 5a  - JOURNAL_HDR_SZ
10dd0 28 70 50 61 67 65 72 29 29 2f 4a 4f 55 52 4e 41  (pPager))/JOURNA
10de0 4c 5f 50 47 5f 53 5a 28 70 50 61 67 65 72 29 3b  L_PG_SZ(pPager);
10df0 0a 20 20 20 20 7d 0a 0a 20 20 20 20 2f 2a 20 49  .    }..    /* I
10e00 66 20 6e 52 65 63 20 69 73 20 30 20 61 6e 64 20  f nRec is 0 and 
10e10 74 68 69 73 20 72 6f 6c 6c 62 61 63 6b 20 69 73  this rollback is
10e20 20 6f 66 20 61 20 74 72 61 6e 73 61 63 74 69 6f   of a transactio
10e30 6e 20 63 72 65 61 74 65 64 20 62 79 20 74 68 69  n created by thi
10e40 73 0a 20 20 20 20 2a 2a 20 70 72 6f 63 65 73 73  s.    ** process
10e50 20 61 6e 64 20 69 66 20 74 68 69 73 20 69 73 20   and if this is 
10e60 74 68 65 20 66 69 6e 61 6c 20 68 65 61 64 65 72  the final header
10e70 20 69 6e 20 74 68 65 20 6a 6f 75 72 6e 61 6c 2c   in the journal,
10e80 20 74 68 65 6e 20 69 74 20 6d 65 61 6e 73 0a 20   then it means. 
10e90 20 20 20 2a 2a 20 74 68 61 74 20 74 68 69 73 20     ** that this 
10ea0 70 61 72 74 20 6f 66 20 74 68 65 20 6a 6f 75 72  part of the jour
10eb0 6e 61 6c 20 77 61 73 20 62 65 69 6e 67 20 66 69  nal was being fi
10ec0 6c 6c 65 64 20 62 75 74 20 68 61 73 20 6e 6f 74  lled but has not
10ed0 20 79 65 74 20 62 65 65 6e 0a 20 20 20 20 2a 2a   yet been.    **
10ee0 20 73 79 6e 63 65 64 20 74 6f 20 64 69 73 6b 2e   synced to disk.
10ef0 20 20 43 6f 6d 70 75 74 65 20 74 68 65 20 6e 75    Compute the nu
10f00 6d 62 65 72 20 6f 66 20 70 61 67 65 73 20 62 61  mber of pages ba
10f10 73 65 64 20 6f 6e 20 74 68 65 20 72 65 6d 61 69  sed on the remai
10f20 6e 69 6e 67 0a 20 20 20 20 2a 2a 20 73 69 7a 65  ning.    ** size
10f30 20 6f 66 20 74 68 65 20 66 69 6c 65 2e 0a 20 20   of the file..  
10f40 20 20 2a 2a 0a 20 20 20 20 2a 2a 20 54 68 65 20    **.    ** The 
10f50 74 68 69 72 64 20 74 65 72 6d 20 6f 66 20 74 68  third term of th
10f60 65 20 74 65 73 74 20 77 61 73 20 61 64 64 65 64  e test was added
10f70 20 74 6f 20 66 69 78 20 74 69 63 6b 65 74 20 23   to fix ticket #
10f80 32 35 36 35 2e 0a 20 20 20 20 2a 2f 0a 20 20 20  2565..    */.   
10f90 20 69 66 28 20 6e 52 65 63 3d 3d 30 20 26 26 20   if( nRec==0 && 
10fa0 21 69 73 48 6f 74 20 26 26 0a 20 20 20 20 20 20  !isHot &&.      
10fb0 20 20 70 50 61 67 65 72 2d 3e 6a 6f 75 72 6e 61    pPager->journa
10fc0 6c 48 64 72 2b 4a 4f 55 52 4e 41 4c 5f 48 44 52  lHdr+JOURNAL_HDR
10fd0 5f 53 5a 28 70 50 61 67 65 72 29 3d 3d 70 50 61  _SZ(pPager)==pPa
10fe0 67 65 72 2d 3e 6a 6f 75 72 6e 61 6c 4f 66 66 20  ger->journalOff 
10ff0 29 7b 0a 20 20 20 20 20 20 6e 52 65 63 20 3d 20  ){.      nRec = 
11000 28 73 7a 4a 20 2d 20 70 50 61 67 65 72 2d 3e 6a  (szJ - pPager->j
11010 6f 75 72 6e 61 6c 4f 66 66 29 20 2f 20 4a 4f 55  ournalOff) / JOU
11020 52 4e 41 4c 5f 50 47 5f 53 5a 28 70 50 61 67 65  RNAL_PG_SZ(pPage
11030 72 29 3b 0a 20 20 20 20 7d 0a 0a 20 20 20 20 2f  r);.    }..    /
11040 2a 20 49 66 20 74 68 69 73 20 69 73 20 74 68 65  * If this is the
11050 20 66 69 72 73 74 20 68 65 61 64 65 72 20 72 65   first header re
11060 61 64 20 66 72 6f 6d 20 74 68 65 20 6a 6f 75 72  ad from the jour
11070 6e 61 6c 2c 20 74 72 75 6e 63 61 74 65 20 74 68  nal, truncate th
11080 65 0a 20 20 20 20 2a 2a 20 64 61 74 61 62 61 73  e.    ** databas
11090 65 20 66 69 6c 65 20 62 61 63 6b 20 74 6f 20 69  e file back to i
110a0 74 73 20 6f 72 69 67 69 6e 61 6c 20 73 69 7a 65  ts original size
110b0 2e 0a 20 20 20 20 2a 2f 0a 20 20 20 20 69 66 28  ..    */.    if(
110c0 20 70 50 61 67 65 72 2d 3e 6a 6f 75 72 6e 61 6c   pPager->journal
110d0 4f 66 66 3d 3d 4a 4f 55 52 4e 41 4c 5f 48 44 52  Off==JOURNAL_HDR
110e0 5f 53 5a 28 70 50 61 67 65 72 29 20 29 7b 0a 20  _SZ(pPager) ){. 
110f0 20 20 20 20 20 72 63 20 3d 20 70 61 67 65 72 5f       rc = pager_
11100 74 72 75 6e 63 61 74 65 28 70 50 61 67 65 72 2c  truncate(pPager,
11110 20 6d 78 50 67 29 3b 0a 20 20 20 20 20 20 69 66   mxPg);.      if
11120 28 20 72 63 21 3d 53 51 4c 49 54 45 5f 4f 4b 20  ( rc!=SQLITE_OK 
11130 29 7b 0a 20 20 20 20 20 20 20 20 67 6f 74 6f 20  ){.        goto 
11140 65 6e 64 5f 70 6c 61 79 62 61 63 6b 3b 0a 20 20  end_playback;.  
11150 20 20 20 20 7d 0a 20 20 20 20 7d 0a 0a 20 20 20      }.    }..   
11160 20 2f 2a 20 43 6f 70 79 20 6f 72 69 67 69 6e 61   /* Copy origina
11170 6c 20 70 61 67 65 73 20 6f 75 74 20 6f 66 20 74  l pages out of t
11180 68 65 20 6a 6f 75 72 6e 61 6c 20 61 6e 64 20 62  he journal and b
11190 61 63 6b 20 69 6e 74 6f 20 74 68 65 20 64 61 74  ack into the dat
111a0 61 62 61 73 65 20 66 69 6c 65 2e 0a 20 20 20 20  abase file..    
111b0 2a 2f 0a 20 20 20 20 66 6f 72 28 69 3d 30 3b 20  */.    for(i=0; 
111c0 69 3c 6e 52 65 63 3b 20 69 2b 2b 29 7b 0a 20 20  i<nRec; i++){.  
111d0 20 20 20 20 72 63 20 3d 20 70 61 67 65 72 5f 70      rc = pager_p
111e0 6c 61 79 62 61 63 6b 5f 6f 6e 65 5f 70 61 67 65  layback_one_page
111f0 28 70 50 61 67 65 72 2c 20 70 50 61 67 65 72 2d  (pPager, pPager-
11200 3e 6a 66 64 2c 20 70 50 61 67 65 72 2d 3e 6a 6f  >jfd, pPager->jo
11210 75 72 6e 61 6c 4f 66 66 2c 20 31 29 3b 0a 20 20  urnalOff, 1);.  
11220 20 20 20 20 69 66 28 20 72 63 21 3d 53 51 4c 49      if( rc!=SQLI
11230 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 20 20 20  TE_OK ){.       
11240 20 69 66 28 20 72 63 3d 3d 53 51 4c 49 54 45 5f   if( rc==SQLITE_
11250 44 4f 4e 45 20 29 7b 0a 20 20 20 20 20 20 20 20  DONE ){.        
11260 20 20 72 63 20 3d 20 53 51 4c 49 54 45 5f 4f 4b    rc = SQLITE_OK
11270 3b 0a 20 20 20 20 20 20 20 20 20 20 70 50 61 67  ;.          pPag
11280 65 72 2d 3e 6a 6f 75 72 6e 61 6c 4f 66 66 20 3d  er->journalOff =
11290 20 73 7a 4a 3b 0a 20 20 20 20 20 20 20 20 20 20   szJ;.          
112a0 62 72 65 61 6b 3b 0a 20 20 20 20 20 20 20 20 7d  break;.        }
112b0 65 6c 73 65 7b 0a 20 20 20 20 20 20 20 20 20 20  else{.          
112c0 67 6f 74 6f 20 65 6e 64 5f 70 6c 61 79 62 61 63  goto end_playbac
112d0 6b 3b 0a 20 20 20 20 20 20 20 20 7d 0a 20 20 20  k;.        }.   
112e0 20 20 20 7d 0a 20 20 20 20 7d 0a 20 20 7d 0a 20     }.    }.  }. 
112f0 20 2f 2a 4e 4f 54 52 45 41 43 48 45 44 2a 2f 0a   /*NOTREACHED*/.
11300 20 20 61 73 73 65 72 74 28 20 30 20 29 3b 0a 0a    assert( 0 );..
11310 65 6e 64 5f 70 6c 61 79 62 61 63 6b 3a 0a 20 20  end_playback:.  
11320 69 66 28 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4f  if( rc==SQLITE_O
11330 4b 20 29 7b 0a 20 20 20 20 7a 4d 61 73 74 65 72  K ){.    zMaster
11340 20 3d 20 70 50 61 67 65 72 2d 3e 70 54 6d 70 53   = pPager->pTmpS
11350 70 61 63 65 3b 0a 20 20 20 20 72 63 20 3d 20 72  pace;.    rc = r
11360 65 61 64 4d 61 73 74 65 72 4a 6f 75 72 6e 61 6c  eadMasterJournal
11370 28 70 50 61 67 65 72 2d 3e 6a 66 64 2c 20 7a 4d  (pPager->jfd, zM
11380 61 73 74 65 72 2c 20 70 50 61 67 65 72 2d 3e 70  aster, pPager->p
11390 56 66 73 2d 3e 6d 78 50 61 74 68 6e 61 6d 65 2b  Vfs->mxPathname+
113a0 31 29 3b 0a 20 20 7d 0a 20 20 69 66 28 20 72 63  1);.  }.  if( rc
113b0 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20  ==SQLITE_OK ){. 
113c0 20 20 20 72 63 20 3d 20 70 61 67 65 72 5f 65 6e     rc = pager_en
113d0 64 5f 74 72 61 6e 73 61 63 74 69 6f 6e 28 70 50  d_transaction(pP
113e0 61 67 65 72 29 3b 0a 20 20 7d 0a 20 20 69 66 28  ager);.  }.  if(
113f0 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 26   rc==SQLITE_OK &
11400 26 20 7a 4d 61 73 74 65 72 5b 30 5d 20 29 7b 0a  & zMaster[0] ){.
11410 20 20 20 20 2f 2a 20 49 66 20 74 68 65 72 65 20      /* If there 
11420 77 61 73 20 61 20 6d 61 73 74 65 72 20 6a 6f 75  was a master jou
11430 72 6e 61 6c 20 61 6e 64 20 74 68 69 73 20 72 6f  rnal and this ro
11440 75 74 69 6e 65 20 77 69 6c 6c 20 72 65 74 75 72  utine will retur
11450 6e 20 73 75 63 63 65 73 73 2c 0a 20 20 20 20 2a  n success,.    *
11460 2a 20 73 65 65 20 69 66 20 69 74 20 69 73 20 70  * see if it is p
11470 6f 73 73 69 62 6c 65 20 74 6f 20 64 65 6c 65 74  ossible to delet
11480 65 20 74 68 65 20 6d 61 73 74 65 72 20 6a 6f 75  e the master jou
11490 72 6e 61 6c 2e 0a 20 20 20 20 2a 2f 0a 20 20 20  rnal..    */.   
114a0 20 72 63 20 3d 20 70 61 67 65 72 5f 64 65 6c 6d   rc = pager_delm
114b0 61 73 74 65 72 28 70 50 61 67 65 72 2c 20 7a 4d  aster(pPager, zM
114c0 61 73 74 65 72 29 3b 0a 20 20 7d 0a 0a 20 20 2f  aster);.  }..  /
114d0 2a 20 54 68 65 20 50 61 67 65 72 2e 73 65 63 74  * The Pager.sect
114e0 6f 72 53 69 7a 65 20 76 61 72 69 61 62 6c 65 20  orSize variable 
114f0 6d 61 79 20 68 61 76 65 20 62 65 65 6e 20 75 70  may have been up
11500 64 61 74 65 64 20 77 68 69 6c 65 20 72 6f 6c 6c  dated while roll
11510 69 6e 67 0a 20 20 2a 2a 20 62 61 63 6b 20 61 20  ing.  ** back a 
11520 6a 6f 75 72 6e 61 6c 20 63 72 65 61 74 65 64 20  journal created 
11530 62 79 20 61 20 70 72 6f 63 65 73 73 20 77 69 74  by a process wit
11540 68 20 61 20 64 69 66 66 65 72 65 6e 74 20 73 65  h a different se
11550 63 74 6f 72 20 73 69 7a 65 0a 20 20 2a 2a 20 76  ctor size.  ** v
11560 61 6c 75 65 2e 20 52 65 73 65 74 20 69 74 20 74  alue. Reset it t
11570 6f 20 74 68 65 20 63 6f 72 72 65 63 74 20 76 61  o the correct va
11580 6c 75 65 20 66 6f 72 20 74 68 69 73 20 70 72 6f  lue for this pro
11590 63 65 73 73 2e 0a 20 20 2a 2f 0a 20 20 73 65 74  cess..  */.  set
115a0 53 65 63 74 6f 72 53 69 7a 65 28 70 50 61 67 65  SectorSize(pPage
115b0 72 29 3b 0a 20 20 72 65 74 75 72 6e 20 72 63 3b  r);.  return rc;
115c0 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 50 6c 61 79 62 61  .}../*.** Playba
115d0 63 6b 20 74 68 65 20 73 74 61 74 65 6d 65 6e 74  ck the statement
115e0 20 6a 6f 75 72 6e 61 6c 2e 0a 2a 2a 0a 2a 2a 20   journal..**.** 
115f0 54 68 69 73 20 69 73 20 73 69 6d 69 6c 61 72 20  This is similar 
11600 74 6f 20 70 6c 61 79 69 6e 67 20 62 61 63 6b 20  to playing back 
11610 74 68 65 20 74 72 61 6e 73 61 63 74 69 6f 6e 20  the transaction 
11620 6a 6f 75 72 6e 61 6c 20 62 75 74 20 77 69 74 68  journal but with
11630 0a 2a 2a 20 61 20 66 65 77 20 65 78 74 72 61 20  .** a few extra 
11640 74 77 69 73 74 73 2e 0a 2a 2a 0a 2a 2a 20 20 20  twists..**.**   
11650 20 28 31 29 20 20 54 68 65 20 6e 75 6d 62 65 72   (1)  The number
11660 20 6f 66 20 70 61 67 65 73 20 69 6e 20 74 68 65   of pages in the
11670 20 64 61 74 61 62 61 73 65 20 66 69 6c 65 20 61   database file a
11680 74 20 74 68 65 20 73 74 61 72 74 20 6f 66 0a 2a  t the start of.*
11690 2a 20 20 20 20 20 20 20 20 20 74 68 65 20 73 74  *         the st
116a0 61 74 65 6d 65 6e 74 20 69 73 20 73 74 6f 72 65  atement is store
116b0 64 20 69 6e 20 70 50 61 67 65 72 2d 3e 73 74 6d  d in pPager->stm
116c0 74 53 69 7a 65 2c 20 6e 6f 74 20 69 6e 20 74 68  tSize, not in th
116d0 65 0a 2a 2a 20 20 20 20 20 20 20 20 20 6a 6f 75  e.**         jou
116e0 72 6e 61 6c 20 66 69 6c 65 20 69 74 73 65 6c 66  rnal file itself
116f0 2e 0a 2a 2a 0a 2a 2a 20 20 20 20 28 32 29 20 20  ..**.**    (2)  
11700 49 6e 20 61 64 64 69 74 69 6f 6e 20 74 6f 20 70  In addition to p
11710 6c 61 79 69 6e 67 20 62 61 63 6b 20 74 68 65 20  laying back the 
11720 73 74 61 74 65 6d 65 6e 74 20 6a 6f 75 72 6e 61  statement journa
11730 6c 2c 20 61 6c 73 6f 0a 2a 2a 20 20 20 20 20 20  l, also.**      
11740 20 20 20 70 6c 61 79 62 61 63 6b 20 61 6c 6c 20     playback all 
11750 70 61 67 65 73 20 6f 66 20 74 68 65 20 74 72 61  pages of the tra
11760 6e 73 61 63 74 69 6f 6e 20 6a 6f 75 72 6e 61 6c  nsaction journal
11770 20 62 65 67 69 6e 6e 69 6e 67 0a 2a 2a 20 20 20   beginning.**   
11780 20 20 20 20 20 20 61 74 20 6f 66 66 73 65 74 20        at offset 
11790 70 50 61 67 65 72 2d 3e 73 74 6d 74 4a 53 69 7a  pPager->stmtJSiz
117a0 65 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74  e..*/.static int
117b0 20 70 61 67 65 72 5f 73 74 6d 74 5f 70 6c 61 79   pager_stmt_play
117c0 62 61 63 6b 28 50 61 67 65 72 20 2a 70 50 61 67  back(Pager *pPag
117d0 65 72 29 7b 0a 20 20 69 36 34 20 73 7a 4a 3b 20  er){.  i64 szJ; 
117e0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
117f0 2f 2a 20 53 69 7a 65 20 6f 66 20 74 68 65 20 66  /* Size of the f
11800 75 6c 6c 20 6a 6f 75 72 6e 61 6c 20 2a 2f 0a 20  ull journal */. 
11810 20 69 36 34 20 68 64 72 4f 66 66 3b 0a 20 20 69   i64 hdrOff;.  i
11820 6e 74 20 6e 52 65 63 3b 20 20 20 20 20 20 20 20  nt nRec;        
11830 20 20 20 20 20 20 20 20 2f 2a 20 4e 75 6d 62 65          /* Numbe
11840 72 20 6f 66 20 52 65 63 6f 72 64 73 20 2a 2f 0a  r of Records */.
11850 20 20 69 6e 74 20 69 3b 20 20 20 20 20 20 20 20    int i;        
11860 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4c 6f             /* Lo
11870 6f 70 20 63 6f 75 6e 74 65 72 20 2a 2f 0a 20 20  op counter */.  
11880 69 6e 74 20 72 63 3b 0a 0a 20 20 73 7a 4a 20 3d  int rc;..  szJ =
11890 20 70 50 61 67 65 72 2d 3e 6a 6f 75 72 6e 61 6c   pPager->journal
118a0 4f 66 66 3b 0a 0a 20 20 2f 2a 20 53 65 74 20 68  Off;..  /* Set h
118b0 64 72 4f 66 66 20 74 6f 20 62 65 20 74 68 65 20  drOff to be the 
118c0 6f 66 66 73 65 74 20 6a 75 73 74 20 61 66 74 65  offset just afte
118d0 72 20 74 68 65 20 65 6e 64 20 6f 66 20 74 68 65  r the end of the
118e0 20 6c 61 73 74 20 6a 6f 75 72 6e 61 6c 0a 20 20   last journal.  
118f0 2a 2a 20 70 61 67 65 20 77 72 69 74 74 65 6e 20  ** page written 
11900 62 65 66 6f 72 65 20 74 68 65 20 66 69 72 73 74  before the first
11910 20 6a 6f 75 72 6e 61 6c 2d 68 65 61 64 65 72 20   journal-header 
11920 66 6f 72 20 74 68 69 73 20 73 74 61 74 65 6d 65  for this stateme
11930 6e 74 0a 20 20 2a 2a 20 74 72 61 6e 73 61 63 74  nt.  ** transact
11940 69 6f 6e 20 77 61 73 20 77 72 69 74 74 65 6e 2c  ion was written,
11950 20 6f 72 20 74 68 65 20 65 6e 64 20 6f 66 20 74   or the end of t
11960 68 65 20 66 69 6c 65 20 69 66 20 6e 6f 20 6a 6f  he file if no jo
11970 75 72 6e 61 6c 0a 20 20 2a 2a 20 68 65 61 64 65  urnal.  ** heade
11980 72 20 77 61 73 20 77 72 69 74 74 65 6e 2e 0a 20  r was written.. 
11990 20 2a 2f 0a 20 20 68 64 72 4f 66 66 20 3d 20 70   */.  hdrOff = p
119a0 50 61 67 65 72 2d 3e 73 74 6d 74 48 64 72 4f 66  Pager->stmtHdrOf
119b0 66 3b 0a 20 20 61 73 73 65 72 74 28 20 70 50 61  f;.  assert( pPa
119c0 67 65 72 2d 3e 66 75 6c 6c 53 79 6e 63 20 7c 7c  ger->fullSync ||
119d0 20 21 68 64 72 4f 66 66 20 29 3b 0a 20 20 69 66   !hdrOff );.  if
119e0 28 20 21 68 64 72 4f 66 66 20 29 7b 0a 20 20 20  ( !hdrOff ){.   
119f0 20 68 64 72 4f 66 66 20 3d 20 73 7a 4a 3b 0a 20   hdrOff = szJ;. 
11a00 20 7d 0a 20 20 0a 20 20 2f 2a 20 54 72 75 6e 63   }.  .  /* Trunc
11a10 61 74 65 20 74 68 65 20 64 61 74 61 62 61 73 65  ate the database
11a20 20 62 61 63 6b 20 74 6f 20 69 74 73 20 6f 72 69   back to its ori
11a30 67 69 6e 61 6c 20 73 69 7a 65 2e 0a 20 20 2a 2f  ginal size..  */
11a40 0a 20 20 72 63 20 3d 20 70 61 67 65 72 5f 74 72  .  rc = pager_tr
11a50 75 6e 63 61 74 65 28 70 50 61 67 65 72 2c 20 70  uncate(pPager, p
11a60 50 61 67 65 72 2d 3e 73 74 6d 74 53 69 7a 65 29  Pager->stmtSize)
11a70 3b 0a 20 20 61 73 73 65 72 74 28 20 70 50 61 67  ;.  assert( pPag
11a80 65 72 2d 3e 73 74 61 74 65 3e 3d 50 41 47 45 52  er->state>=PAGER
11a90 5f 53 48 41 52 45 44 20 29 3b 0a 0a 20 20 2f 2a  _SHARED );..  /*
11aa0 20 46 69 67 75 72 65 20 6f 75 74 20 68 6f 77 20   Figure out how 
11ab0 6d 61 6e 79 20 72 65 63 6f 72 64 73 20 61 72 65  many records are
11ac0 20 69 6e 20 74 68 65 20 73 74 61 74 65 6d 65 6e   in the statemen
11ad0 74 20 6a 6f 75 72 6e 61 6c 2e 0a 20 20 2a 2f 0a  t journal..  */.
11ae0 20 20 61 73 73 65 72 74 28 20 70 50 61 67 65 72    assert( pPager
11af0 2d 3e 73 74 6d 74 49 6e 55 73 65 20 26 26 20 70  ->stmtInUse && p
11b00 50 61 67 65 72 2d 3e 6a 6f 75 72 6e 61 6c 4f 70  Pager->journalOp
11b10 65 6e 20 29 3b 0a 20 20 6e 52 65 63 20 3d 20 70  en );.  nRec = p
11b20 50 61 67 65 72 2d 3e 73 74 6d 74 4e 52 65 63 3b  Pager->stmtNRec;
11b30 0a 20 20 0a 20 20 2f 2a 20 43 6f 70 79 20 6f 72  .  .  /* Copy or
11b40 69 67 69 6e 61 6c 20 70 61 67 65 73 20 6f 75 74  iginal pages out
11b50 20 6f 66 20 74 68 65 20 73 74 61 74 65 6d 65 6e   of the statemen
11b60 74 20 6a 6f 75 72 6e 61 6c 20 61 6e 64 20 62 61  t journal and ba
11b70 63 6b 20 69 6e 74 6f 20 74 68 65 0a 20 20 2a 2a  ck into the.  **
11b80 20 64 61 74 61 62 61 73 65 20 66 69 6c 65 2e 20   database file. 
11b90 20 4e 6f 74 65 20 74 68 61 74 20 74 68 65 20 73   Note that the s
11ba0 74 61 74 65 6d 65 6e 74 20 6a 6f 75 72 6e 61 6c  tatement journal
11bb0 20 6f 6d 69 74 73 20 63 68 65 63 6b 73 75 6d 73   omits checksums
11bc0 20 66 72 6f 6d 0a 20 20 2a 2a 20 65 61 63 68 20   from.  ** each 
11bd0 72 65 63 6f 72 64 20 73 69 6e 63 65 20 70 6f 77  record since pow
11be0 65 72 2d 66 61 69 6c 75 72 65 20 72 65 63 6f 76  er-failure recov
11bf0 65 72 79 20 69 73 20 6e 6f 74 20 69 6d 70 6f 72  ery is not impor
11c00 74 61 6e 74 20 74 6f 20 73 74 61 74 65 6d 65 6e  tant to statemen
11c10 74 0a 20 20 2a 2a 20 6a 6f 75 72 6e 61 6c 73 2e  t.  ** journals.
11c20 0a 20 20 2a 2f 0a 20 20 66 6f 72 28 69 3d 30 3b  .  */.  for(i=0;
11c30 20 69 3c 6e 52 65 63 3b 20 69 2b 2b 29 7b 0a 20   i<nRec; i++){. 
11c40 20 20 20 69 36 34 20 6f 66 66 73 65 74 20 3d 20     i64 offset = 
11c50 69 2a 28 34 2b 70 50 61 67 65 72 2d 3e 70 61 67  i*(4+pPager->pag
11c60 65 53 69 7a 65 29 3b 0a 20 20 20 20 72 63 20 3d  eSize);.    rc =
11c70 20 70 61 67 65 72 5f 70 6c 61 79 62 61 63 6b 5f   pager_playback_
11c80 6f 6e 65 5f 70 61 67 65 28 70 50 61 67 65 72 2c  one_page(pPager,
11c90 20 70 50 61 67 65 72 2d 3e 73 74 66 64 2c 20 6f   pPager->stfd, o
11ca0 66 66 73 65 74 2c 20 30 29 3b 0a 20 20 20 20 61  ffset, 0);.    a
11cb0 73 73 65 72 74 28 20 72 63 21 3d 53 51 4c 49 54  ssert( rc!=SQLIT
11cc0 45 5f 44 4f 4e 45 20 29 3b 0a 20 20 20 20 69 66  E_DONE );.    if
11cd0 28 20 72 63 21 3d 53 51 4c 49 54 45 5f 4f 4b 20  ( rc!=SQLITE_OK 
11ce0 29 20 67 6f 74 6f 20 65 6e 64 5f 73 74 6d 74 5f  ) goto end_stmt_
11cf0 70 6c 61 79 62 61 63 6b 3b 0a 20 20 7d 0a 0a 20  playback;.  }.. 
11d00 20 2f 2a 20 4e 6f 77 20 72 6f 6c 6c 20 73 6f 6d   /* Now roll som
11d10 65 20 70 61 67 65 73 20 62 61 63 6b 20 66 72 6f  e pages back fro
11d20 6d 20 74 68 65 20 74 72 61 6e 73 61 63 74 69 6f  m the transactio
11d30 6e 20 6a 6f 75 72 6e 61 6c 2e 20 50 61 67 65 72  n journal. Pager
11d40 2e 73 74 6d 74 4a 53 69 7a 65 0a 20 20 2a 2a 20  .stmtJSize.  ** 
11d50 77 61 73 20 74 68 65 20 73 69 7a 65 20 6f 66 20  was the size of 
11d60 74 68 65 20 6a 6f 75 72 6e 61 6c 20 66 69 6c 65  the journal file
11d70 20 77 68 65 6e 20 74 68 69 73 20 73 74 61 74 65   when this state
11d80 6d 65 6e 74 20 77 61 73 20 73 74 61 72 74 65 64  ment was started
11d90 2c 20 73 6f 0a 20 20 2a 2a 20 65 76 65 72 79 74  , so.  ** everyt
11da0 68 69 6e 67 20 61 66 74 65 72 20 74 68 61 74 20  hing after that 
11db0 6e 65 65 64 73 20 74 6f 20 62 65 20 72 6f 6c 6c  needs to be roll
11dc0 65 64 20 62 61 63 6b 2c 20 65 69 74 68 65 72 20  ed back, either 
11dd0 69 6e 74 6f 20 74 68 65 0a 20 20 2a 2a 20 64 61  into the.  ** da
11de0 74 61 62 61 73 65 2c 20 74 68 65 20 6d 65 6d 6f  tabase, the memo
11df0 72 79 20 63 61 63 68 65 2c 20 6f 72 20 62 6f 74  ry cache, or bot
11e00 68 2e 0a 20 20 2a 2a 0a 20 20 2a 2a 20 49 66 20  h..  **.  ** If 
11e10 69 74 20 69 73 20 6e 6f 74 20 7a 65 72 6f 2c 20  it is not zero, 
11e20 74 68 65 6e 20 50 61 67 65 72 2e 73 74 6d 74 48  then Pager.stmtH
11e30 64 72 4f 66 66 20 69 73 20 74 68 65 20 6f 66 66  drOff is the off
11e40 73 65 74 20 74 6f 20 74 68 65 20 73 74 61 72 74  set to the start
11e50 0a 20 20 2a 2a 20 6f 66 20 74 68 65 20 66 69 72  .  ** of the fir
11e60 73 74 20 6a 6f 75 72 6e 61 6c 20 68 65 61 64 65  st journal heade
11e70 72 20 77 72 69 74 74 65 6e 20 64 75 72 69 6e 67  r written during
11e80 20 74 68 69 73 20 73 74 61 74 65 6d 65 6e 74 20   this statement 
11e90 74 72 61 6e 73 61 63 74 69 6f 6e 2e 0a 20 20 2a  transaction..  *
11ea0 2f 0a 20 20 70 50 61 67 65 72 2d 3e 6a 6f 75 72  /.  pPager->jour
11eb0 6e 61 6c 4f 66 66 20 3d 20 70 50 61 67 65 72 2d  nalOff = pPager-
11ec0 3e 73 74 6d 74 4a 53 69 7a 65 3b 0a 20 20 70 50  >stmtJSize;.  pP
11ed0 61 67 65 72 2d 3e 63 6b 73 75 6d 49 6e 69 74 20  ager->cksumInit 
11ee0 3d 20 70 50 61 67 65 72 2d 3e 73 74 6d 74 43 6b  = pPager->stmtCk
11ef0 73 75 6d 3b 0a 20 20 77 68 69 6c 65 28 20 70 50  sum;.  while( pP
11f00 61 67 65 72 2d 3e 6a 6f 75 72 6e 61 6c 4f 66 66  ager->journalOff
11f10 20 3c 20 68 64 72 4f 66 66 20 29 7b 0a 20 20 20   < hdrOff ){.   
11f20 20 72 63 20 3d 20 70 61 67 65 72 5f 70 6c 61 79   rc = pager_play
11f30 62 61 63 6b 5f 6f 6e 65 5f 70 61 67 65 28 70 50  back_one_page(pP
11f40 61 67 65 72 2c 20 70 50 61 67 65 72 2d 3e 6a 66  ager, pPager->jf
11f50 64 2c 20 70 50 61 67 65 72 2d 3e 6a 6f 75 72 6e  d, pPager->journ
11f60 61 6c 4f 66 66 2c 20 31 29 3b 0a 20 20 20 20 61  alOff, 1);.    a
11f70 73 73 65 72 74 28 20 72 63 21 3d 53 51 4c 49 54  ssert( rc!=SQLIT
11f80 45 5f 44 4f 4e 45 20 29 3b 0a 20 20 20 20 69 66  E_DONE );.    if
11f90 28 20 72 63 21 3d 53 51 4c 49 54 45 5f 4f 4b 20  ( rc!=SQLITE_OK 
11fa0 29 20 67 6f 74 6f 20 65 6e 64 5f 73 74 6d 74 5f  ) goto end_stmt_
11fb0 70 6c 61 79 62 61 63 6b 3b 0a 20 20 7d 0a 0a 20  playback;.  }.. 
11fc0 20 77 68 69 6c 65 28 20 70 50 61 67 65 72 2d 3e   while( pPager->
11fd0 6a 6f 75 72 6e 61 6c 4f 66 66 20 3c 20 73 7a 4a  journalOff < szJ
11fe0 20 29 7b 0a 20 20 20 20 75 33 32 20 6e 4a 52 65   ){.    u32 nJRe
11ff0 63 3b 20 20 20 20 20 20 20 20 20 2f 2a 20 4e 75  c;         /* Nu
12000 6d 62 65 72 20 6f 66 20 4a 6f 75 72 6e 61 6c 20  mber of Journal 
12010 52 65 63 6f 72 64 73 20 2a 2f 0a 20 20 20 20 75  Records */.    u
12020 33 32 20 64 75 6d 6d 79 3b 0a 20 20 20 20 72 63  32 dummy;.    rc
12030 20 3d 20 72 65 61 64 4a 6f 75 72 6e 61 6c 48 64   = readJournalHd
12040 72 28 70 50 61 67 65 72 2c 20 73 7a 4a 2c 20 26  r(pPager, szJ, &
12050 6e 4a 52 65 63 2c 20 26 64 75 6d 6d 79 29 3b 0a  nJRec, &dummy);.
12060 20 20 20 20 69 66 28 20 72 63 21 3d 53 51 4c 49      if( rc!=SQLI
12070 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 20 20 61  TE_OK ){.      a
12080 73 73 65 72 74 28 20 72 63 21 3d 53 51 4c 49 54  ssert( rc!=SQLIT
12090 45 5f 44 4f 4e 45 20 29 3b 0a 20 20 20 20 20 20  E_DONE );.      
120a0 67 6f 74 6f 20 65 6e 64 5f 73 74 6d 74 5f 70 6c  goto end_stmt_pl
120b0 61 79 62 61 63 6b 3b 0a 20 20 20 20 7d 0a 20 20  ayback;.    }.  
120c0 20 20 69 66 28 20 6e 4a 52 65 63 3d 3d 30 20 29    if( nJRec==0 )
120d0 7b 0a 20 20 20 20 20 20 6e 4a 52 65 63 20 3d 20  {.      nJRec = 
120e0 28 73 7a 4a 20 2d 20 70 50 61 67 65 72 2d 3e 6a  (szJ - pPager->j
120f0 6f 75 72 6e 61 6c 4f 66 66 29 20 2f 20 28 70 50  ournalOff) / (pP
12100 61 67 65 72 2d 3e 70 61 67 65 53 69 7a 65 2b 38  ager->pageSize+8
12110 29 3b 0a 20 20 20 20 7d 0a 20 20 20 20 66 6f 72  );.    }.    for
12120 28 69 3d 6e 4a 52 65 63 2d 31 3b 20 69 3e 3d 30  (i=nJRec-1; i>=0
12130 20 26 26 20 70 50 61 67 65 72 2d 3e 6a 6f 75 72   && pPager->jour
12140 6e 61 6c 4f 66 66 20 3c 20 73 7a 4a 3b 20 69 2d  nalOff < szJ; i-
12150 2d 29 7b 0a 20 20 20 20 20 20 72 63 20 3d 20 70  -){.      rc = p
12160 61 67 65 72 5f 70 6c 61 79 62 61 63 6b 5f 6f 6e  ager_playback_on
12170 65 5f 70 61 67 65 28 70 50 61 67 65 72 2c 20 70  e_page(pPager, p
12180 50 61 67 65 72 2d 3e 6a 66 64 2c 20 70 50 61 67  Pager->jfd, pPag
12190 65 72 2d 3e 6a 6f 75 72 6e 61 6c 4f 66 66 2c 20  er->journalOff, 
121a0 31 29 3b 0a 20 20 20 20 20 20 61 73 73 65 72 74  1);.      assert
121b0 28 20 72 63 21 3d 53 51 4c 49 54 45 5f 44 4f 4e  ( rc!=SQLITE_DON
121c0 45 20 29 3b 0a 20 20 20 20 20 20 69 66 28 20 72  E );.      if( r
121d0 63 21 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 20 67  c!=SQLITE_OK ) g
121e0 6f 74 6f 20 65 6e 64 5f 73 74 6d 74 5f 70 6c 61  oto end_stmt_pla
121f0 79 62 61 63 6b 3b 0a 20 20 20 20 7d 0a 20 20 7d  yback;.    }.  }
12200 0a 0a 20 20 70 50 61 67 65 72 2d 3e 6a 6f 75 72  ..  pPager->jour
12210 6e 61 6c 4f 66 66 20 3d 20 73 7a 4a 3b 0a 20 20  nalOff = szJ;.  
12220 0a 65 6e 64 5f 73 74 6d 74 5f 70 6c 61 79 62 61  .end_stmt_playba
12230 63 6b 3a 0a 20 20 69 66 28 20 72 63 3d 3d 53 51  ck:.  if( rc==SQ
12240 4c 49 54 45 5f 4f 4b 29 20 7b 0a 20 20 20 20 70  LITE_OK) {.    p
12250 50 61 67 65 72 2d 3e 6a 6f 75 72 6e 61 6c 4f 66  Pager->journalOf
12260 66 20 3d 20 73 7a 4a 3b 0a 20 20 20 20 2f 2a 20  f = szJ;.    /* 
12270 70 61 67 65 72 5f 72 65 6c 6f 61 64 5f 63 61 63  pager_reload_cac
12280 68 65 28 70 50 61 67 65 72 29 3b 20 2a 2f 0a 20  he(pPager); */. 
12290 20 7d 0a 20 20 72 65 74 75 72 6e 20 72 63 3b 0a   }.  return rc;.
122a0 7d 0a 0a 2f 2a 0a 2a 2a 20 43 68 61 6e 67 65 20  }../*.** Change 
122b0 74 68 65 20 6d 61 78 69 6d 75 6d 20 6e 75 6d 62  the maximum numb
122c0 65 72 20 6f 66 20 69 6e 2d 6d 65 6d 6f 72 79 20  er of in-memory 
122d0 70 61 67 65 73 20 74 68 61 74 20 61 72 65 20 61  pages that are a
122e0 6c 6c 6f 77 65 64 2e 0a 2a 2f 0a 76 6f 69 64 20  llowed..*/.void 
122f0 73 71 6c 69 74 65 33 50 61 67 65 72 53 65 74 43  sqlite3PagerSetC
12300 61 63 68 65 73 69 7a 65 28 50 61 67 65 72 20 2a  achesize(Pager *
12310 70 50 61 67 65 72 2c 20 69 6e 74 20 6d 78 50 61  pPager, int mxPa
12320 67 65 29 7b 0a 20 20 69 66 28 20 6d 78 50 61 67  ge){.  if( mxPag
12330 65 3e 31 30 20 29 7b 0a 20 20 20 20 70 50 61 67  e>10 ){.    pPag
12340 65 72 2d 3e 6d 78 50 61 67 65 20 3d 20 6d 78 50  er->mxPage = mxP
12350 61 67 65 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20 20  age;.  }else{.  
12360 20 20 70 50 61 67 65 72 2d 3e 6d 78 50 61 67 65    pPager->mxPage
12370 20 3d 20 31 30 3b 0a 20 20 7d 0a 7d 0a 0a 2f 2a   = 10;.  }.}../*
12380 0a 2a 2a 20 41 64 6a 75 73 74 20 74 68 65 20 72  .** Adjust the r
12390 6f 62 75 73 74 6e 65 73 73 20 6f 66 20 74 68 65  obustness of the
123a0 20 64 61 74 61 62 61 73 65 20 74 6f 20 64 61 6d   database to dam
123b0 61 67 65 20 64 75 65 20 74 6f 20 4f 53 20 63 72  age due to OS cr
123c0 61 73 68 65 73 0a 2a 2a 20 6f 72 20 70 6f 77 65  ashes.** or powe
123d0 72 20 66 61 69 6c 75 72 65 73 20 62 79 20 63 68  r failures by ch
123e0 61 6e 67 69 6e 67 20 74 68 65 20 6e 75 6d 62 65  anging the numbe
123f0 72 20 6f 66 20 73 79 6e 63 73 28 29 73 20 77 68  r of syncs()s wh
12400 65 6e 20 77 72 69 74 69 6e 67 0a 2a 2a 20 74 68  en writing.** th
12410 65 20 72 6f 6c 6c 62 61 63 6b 20 6a 6f 75 72 6e  e rollback journ
12420 61 6c 2e 20 20 54 68 65 72 65 20 61 72 65 20 74  al.  There are t
12430 68 72 65 65 20 6c 65 76 65 6c 73 3a 0a 2a 2a 0a  hree levels:.**.
12440 2a 2a 20 20 20 20 4f 46 46 20 20 20 20 20 20 20  **    OFF       
12450 73 71 6c 69 74 65 33 4f 73 53 79 6e 63 28 29 20  sqlite3OsSync() 
12460 69 73 20 6e 65 76 65 72 20 63 61 6c 6c 65 64 2e  is never called.
12470 20 20 54 68 69 73 20 69 73 20 74 68 65 20 64 65    This is the de
12480 66 61 75 6c 74 0a 2a 2a 20 20 20 20 20 20 20 20  fault.**        
12490 20 20 20 20 20 20 66 6f 72 20 74 65 6d 70 6f 72        for tempor
124a0 61 72 79 20 61 6e 64 20 74 72 61 6e 73 69 65 6e  ary and transien
124b0 74 20 66 69 6c 65 73 2e 0a 2a 2a 0a 2a 2a 20 20  t files..**.**  
124c0 20 20 4e 4f 52 4d 41 4c 20 20 20 20 54 68 65 20    NORMAL    The 
124d0 6a 6f 75 72 6e 61 6c 20 69 73 20 73 79 6e 63 65  journal is synce
124e0 64 20 6f 6e 63 65 20 62 65 66 6f 72 65 20 77 72  d once before wr
124f0 69 74 65 73 20 62 65 67 69 6e 20 6f 6e 20 74 68  ites begin on th
12500 65 0a 2a 2a 20 20 20 20 20 20 20 20 20 20 20 20  e.**            
12510 20 20 64 61 74 61 62 61 73 65 2e 20 20 54 68 69    database.  Thi
12520 73 20 69 73 20 6e 6f 72 6d 61 6c 6c 79 20 61 64  s is normally ad
12530 65 71 75 61 74 65 20 70 72 6f 74 65 63 74 69 6f  equate protectio
12540 6e 2c 20 62 75 74 0a 2a 2a 20 20 20 20 20 20 20  n, but.**       
12550 20 20 20 20 20 20 20 69 74 20 69 73 20 74 68 65         it is the
12560 6f 72 65 74 69 63 61 6c 6c 79 20 70 6f 73 73 69  oretically possi
12570 62 6c 65 2c 20 74 68 6f 75 67 68 20 76 65 72 79  ble, though very
12580 20 75 6e 6c 69 6b 65 6c 79 2c 0a 2a 2a 20 20 20   unlikely,.**   
12590 20 20 20 20 20 20 20 20 20 20 20 74 68 61 74 20             that 
125a0 61 6e 20 69 6e 6f 70 65 72 74 75 6e 65 20 70 6f  an inopertune po
125b0 77 65 72 20 66 61 69 6c 75 72 65 20 63 6f 75 6c  wer failure coul
125c0 64 20 6c 65 61 76 65 20 74 68 65 20 6a 6f 75 72  d leave the jour
125d0 6e 61 6c 0a 2a 2a 20 20 20 20 20 20 20 20 20 20  nal.**          
125e0 20 20 20 20 69 6e 20 61 20 73 74 61 74 65 20 77      in a state w
125f0 68 69 63 68 20 77 6f 75 6c 64 20 63 61 75 73 65  hich would cause
12600 20 64 61 6d 61 67 65 20 74 6f 20 74 68 65 20 64   damage to the d
12610 61 74 61 62 61 73 65 0a 2a 2a 20 20 20 20 20 20  atabase.**      
12620 20 20 20 20 20 20 20 20 77 68 65 6e 20 69 74 20          when it 
12630 69 73 20 72 6f 6c 6c 65 64 20 62 61 63 6b 2e 0a  is rolled back..
12640 2a 2a 0a 2a 2a 20 20 20 20 46 55 4c 4c 20 20 20  **.**    FULL   
12650 20 20 20 54 68 65 20 6a 6f 75 72 6e 61 6c 20 69     The journal i
12660 73 20 73 79 6e 63 65 64 20 74 77 69 63 65 20 62  s synced twice b
12670 65 66 6f 72 65 20 77 72 69 74 65 73 20 62 65 67  efore writes beg
12680 69 6e 20 6f 6e 20 74 68 65 0a 2a 2a 20 20 20 20  in on the.**    
12690 20 20 20 20 20 20 20 20 20 20 64 61 74 61 62 61            databa
126a0 73 65 20 28 77 69 74 68 20 73 6f 6d 65 20 61 64  se (with some ad
126b0 64 69 74 69 6f 6e 61 6c 20 69 6e 66 6f 72 6d 61  ditional informa
126c0 74 69 6f 6e 20 2d 20 74 68 65 20 6e 52 65 63 20  tion - the nRec 
126d0 66 69 65 6c 64 0a 2a 2a 20 20 20 20 20 20 20 20  field.**        
126e0 20 20 20 20 20 20 6f 66 20 74 68 65 20 6a 6f 75        of the jou
126f0 72 6e 61 6c 20 68 65 61 64 65 72 20 2d 20 62 65  rnal header - be
12700 69 6e 67 20 77 72 69 74 74 65 6e 20 69 6e 20 62  ing written in b
12710 65 74 77 65 65 6e 20 74 68 65 20 74 77 6f 0a 2a  etween the two.*
12720 2a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 73  *              s
12730 79 6e 63 73 29 2e 20 20 49 66 20 77 65 20 61 73  yncs).  If we as
12740 73 75 6d 65 20 74 68 61 74 20 77 72 69 74 69 6e  sume that writin
12750 67 20 61 0a 2a 2a 20 20 20 20 20 20 20 20 20 20  g a.**          
12760 20 20 20 20 73 69 6e 67 6c 65 20 64 69 73 6b 20      single disk 
12770 73 65 63 74 6f 72 20 69 73 20 61 74 6f 6d 69 63  sector is atomic
12780 2c 20 74 68 65 6e 20 74 68 69 73 20 6d 6f 64 65  , then this mode
12790 20 70 72 6f 76 69 64 65 73 0a 2a 2a 20 20 20 20   provides.**    
127a0 20 20 20 20 20 20 20 20 20 20 61 73 73 75 72 61            assura
127b0 6e 63 65 20 74 68 61 74 20 74 68 65 20 6a 6f 75  nce that the jou
127c0 72 6e 61 6c 20 77 69 6c 6c 20 6e 6f 74 20 62 65  rnal will not be
127d0 20 63 6f 72 72 75 70 74 65 64 20 74 6f 20 74 68   corrupted to th
127e0 65 0a 2a 2a 20 20 20 20 20 20 20 20 20 20 20 20  e.**            
127f0 20 20 70 6f 69 6e 74 20 6f 66 20 63 61 75 73 69    point of causi
12800 6e 67 20 64 61 6d 61 67 65 20 74 6f 20 74 68 65  ng damage to the
12810 20 64 61 74 61 62 61 73 65 20 64 75 72 69 6e 67   database during
12820 20 72 6f 6c 6c 62 61 63 6b 2e 0a 2a 2a 0a 2a 2a   rollback..**.**
12830 20 4e 75 6d 65 72 69 63 20 76 61 6c 75 65 73 20   Numeric values 
12840 61 73 73 6f 63 69 61 74 65 64 20 77 69 74 68 20  associated with 
12850 74 68 65 73 65 20 73 74 61 74 65 73 20 61 72 65  these states are
12860 20 4f 46 46 3d 3d 31 2c 20 4e 4f 52 4d 41 4c 3d   OFF==1, NORMAL=
12870 32 2c 0a 2a 2a 20 61 6e 64 20 46 55 4c 4c 3d 33  2,.** and FULL=3
12880 2e 0a 2a 2f 0a 23 69 66 6e 64 65 66 20 53 51 4c  ..*/.#ifndef SQL
12890 49 54 45 5f 4f 4d 49 54 5f 50 41 47 45 52 5f 50  ITE_OMIT_PAGER_P
128a0 52 41 47 4d 41 53 0a 76 6f 69 64 20 73 71 6c 69  RAGMAS.void sqli
128b0 74 65 33 50 61 67 65 72 53 65 74 53 61 66 65 74  te3PagerSetSafet
128c0 79 4c 65 76 65 6c 28 50 61 67 65 72 20 2a 70 50  yLevel(Pager *pP
128d0 61 67 65 72 2c 20 69 6e 74 20 6c 65 76 65 6c 2c  ager, int level,
128e0 20 69 6e 74 20 66 75 6c 6c 5f 66 73 79 6e 63 29   int full_fsync)
128f0 7b 0a 20 20 70 50 61 67 65 72 2d 3e 6e 6f 53 79  {.  pPager->noSy
12900 6e 63 20 3d 20 20 6c 65 76 65 6c 3d 3d 31 20 7c  nc =  level==1 |
12910 7c 20 70 50 61 67 65 72 2d 3e 74 65 6d 70 46 69  | pPager->tempFi
12920 6c 65 3b 0a 20 20 70 50 61 67 65 72 2d 3e 66 75  le;.  pPager->fu
12930 6c 6c 53 79 6e 63 20 3d 20 6c 65 76 65 6c 3d 3d  llSync = level==
12940 33 20 26 26 20 21 70 50 61 67 65 72 2d 3e 74 65  3 && !pPager->te
12950 6d 70 46 69 6c 65 3b 0a 20 20 70 50 61 67 65 72  mpFile;.  pPager
12960 2d 3e 73 79 6e 63 5f 66 6c 61 67 73 20 3d 20 28  ->sync_flags = (
12970 66 75 6c 6c 5f 66 73 79 6e 63 3f 53 51 4c 49 54  full_fsync?SQLIT
12980 45 5f 53 59 4e 43 5f 46 55 4c 4c 3a 53 51 4c 49  E_SYNC_FULL:SQLI
12990 54 45 5f 53 59 4e 43 5f 4e 4f 52 4d 41 4c 29 3b  TE_SYNC_NORMAL);
129a0 0a 20 20 69 66 28 20 70 50 61 67 65 72 2d 3e 6e  .  if( pPager->n
129b0 6f 53 79 6e 63 20 29 20 70 50 61 67 65 72 2d 3e  oSync ) pPager->
129c0 6e 65 65 64 53 79 6e 63 20 3d 20 30 3b 0a 7d 0a  needSync = 0;.}.
129d0 23 65 6e 64 69 66 0a 0a 2f 2a 0a 2a 2a 20 54 68  #endif../*.** Th
129e0 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 67 6c 6f 62  e following glob
129f0 61 6c 20 76 61 72 69 61 62 6c 65 20 69 73 20 69  al variable is i
12a00 6e 63 72 65 6d 65 6e 74 65 64 20 77 68 65 6e 65  ncremented whene
12a10 76 65 72 20 74 68 65 20 6c 69 62 72 61 72 79 0a  ver the library.
12a20 2a 2a 20 61 74 74 65 6d 70 74 73 20 74 6f 20 6f  ** attempts to o
12a30 70 65 6e 20 61 20 74 65 6d 70 6f 72 61 72 79 20  pen a temporary 
12a40 66 69 6c 65 2e 20 20 54 68 69 73 20 69 6e 66 6f  file.  This info
12a50 72 6d 61 74 69 6f 6e 20 69 73 20 75 73 65 64 20  rmation is used 
12a60 66 6f 72 0a 2a 2a 20 74 65 73 74 69 6e 67 20 61  for.** testing a
12a70 6e 64 20 61 6e 61 6c 79 73 69 73 20 6f 6e 6c 79  nd analysis only
12a80 2e 20 20 0a 2a 2f 0a 23 69 66 64 65 66 20 53 51  .  .*/.#ifdef SQ
12a90 4c 49 54 45 5f 54 45 53 54 0a 69 6e 74 20 73 71  LITE_TEST.int sq
12aa0 6c 69 74 65 33 5f 6f 70 65 6e 74 65 6d 70 5f 63  lite3_opentemp_c
12ab0 6f 75 6e 74 20 3d 20 30 3b 0a 23 65 6e 64 69 66  ount = 0;.#endif
12ac0 0a 0a 2f 2a 0a 2a 2a 20 4f 70 65 6e 20 61 20 74  ../*.** Open a t
12ad0 65 6d 70 6f 72 61 72 79 20 66 69 6c 65 2e 20 0a  emporary file. .
12ae0 2a 2a 0a 2a 2a 20 57 72 69 74 65 20 74 68 65 20  **.** Write the 
12af0 66 69 6c 65 20 64 65 73 63 72 69 70 74 6f 72 20  file descriptor 
12b00 69 6e 74 6f 20 2a 66 64 2e 20 20 52 65 74 75 72  into *fd.  Retur
12b10 6e 20 53 51 4c 49 54 45 5f 4f 4b 20 6f 6e 20 73  n SQLITE_OK on s
12b20 75 63 63 65 73 73 20 6f 72 20 73 6f 6d 65 0a 2a  uccess or some.*
12b30 2a 20 6f 74 68 65 72 20 65 72 72 6f 72 20 63 6f  * other error co
12b40 64 65 20 69 66 20 77 65 20 66 61 69 6c 2e 20 54  de if we fail. T
12b50 68 65 20 4f 53 20 77 69 6c 6c 20 61 75 74 6f 6d  he OS will autom
12b60 61 74 69 63 61 6c 6c 79 20 64 65 6c 65 74 65 20  atically delete 
12b70 74 68 65 20 74 65 6d 70 6f 72 61 72 79 0a 2a 2a  the temporary.**
12b80 20 66 69 6c 65 20 77 68 65 6e 20 69 74 20 69 73   file when it is
12b90 20 63 6c 6f 73 65 64 2e 0a 2a 2f 0a 73 74 61 74   closed..*/.stat
12ba0 69 63 20 69 6e 74 20 73 71 6c 69 74 65 33 50 61  ic int sqlite3Pa
12bb0 67 65 72 4f 70 65 6e 74 65 6d 70 28 0a 20 20 73  gerOpentemp(.  s
12bc0 71 6c 69 74 65 33 5f 76 66 73 20 2a 70 56 66 73  qlite3_vfs *pVfs
12bd0 2c 20 20 20 20 2f 2a 20 54 68 65 20 76 69 72 74  ,    /* The virt
12be0 75 61 6c 20 66 69 6c 65 20 73 79 73 74 65 6d 20  ual file system 
12bf0 6c 61 79 65 72 20 2a 2f 0a 20 20 73 71 6c 69 74  layer */.  sqlit
12c00 65 33 5f 66 69 6c 65 20 2a 70 46 69 6c 65 2c 20  e3_file *pFile, 
12c10 20 2f 2a 20 57 72 69 74 65 20 74 68 65 20 66 69   /* Write the fi
12c20 6c 65 20 64 65 73 63 72 69 70 74 6f 72 20 68 65  le descriptor he
12c30 72 65 20 2a 2f 0a 20 20 63 68 61 72 20 2a 7a 46  re */.  char *zF
12c40 69 6c 65 6e 61 6d 65 2c 20 20 20 20 20 20 2f 2a  ilename,      /*
12c50 20 4e 61 6d 65 20 6f 66 20 74 68 65 20 66 69 6c   Name of the fil
12c60 65 2e 20 20 4d 69 67 68 74 20 62 65 20 4e 55 4c  e.  Might be NUL
12c70 4c 20 2a 2f 0a 20 20 69 6e 74 20 76 66 73 46 6c  L */.  int vfsFl
12c80 61 67 73 20 20 20 20 20 20 20 20 20 20 2f 2a 20  ags          /* 
12c90 46 6c 61 67 73 20 70 61 73 73 65 64 20 74 68 72  Flags passed thr
12ca0 6f 75 67 68 20 74 6f 20 74 68 65 20 56 46 53 20  ough to the VFS 
12cb0 2a 2f 0a 29 7b 0a 20 20 69 6e 74 20 72 63 3b 0a  */.){.  int rc;.
12cc0 20 20 61 73 73 65 72 74 28 20 7a 46 69 6c 65 6e    assert( zFilen
12cd0 61 6d 65 21 3d 30 20 29 3b 0a 0a 23 69 66 64 65  ame!=0 );..#ifde
12ce0 66 20 53 51 4c 49 54 45 5f 54 45 53 54 0a 20 20  f SQLITE_TEST.  
12cf0 73 71 6c 69 74 65 33 5f 6f 70 65 6e 74 65 6d 70  sqlite3_opentemp
12d00 5f 63 6f 75 6e 74 2b 2b 3b 20 20 2f 2a 20 55 73  _count++;  /* Us
12d10 65 64 20 66 6f 72 20 74 65 73 74 69 6e 67 20 61  ed for testing a
12d20 6e 64 20 61 6e 61 6c 79 73 69 73 20 6f 6e 6c 79  nd analysis only
12d30 20 2a 2f 0a 23 65 6e 64 69 66 0a 0a 20 20 76 66   */.#endif..  vf
12d40 73 46 6c 61 67 73 20 7c 3d 20 20 53 51 4c 49 54  sFlags |=  SQLIT
12d50 45 5f 4f 50 45 4e 5f 52 45 41 44 57 52 49 54 45  E_OPEN_READWRITE
12d60 20 7c 20 53 51 4c 49 54 45 5f 4f 50 45 4e 5f 43   | SQLITE_OPEN_C
12d70 52 45 41 54 45 20 7c 0a 20 20 20 20 20 20 20 20  REATE |.        
12d80 20 20 20 20 53 51 4c 49 54 45 5f 4f 50 45 4e 5f      SQLITE_OPEN_
12d90 45 58 43 4c 55 53 49 56 45 20 7c 20 53 51 4c 49  EXCLUSIVE | SQLI
12da0 54 45 5f 4f 50 45 4e 5f 44 45 4c 45 54 45 4f 4e  TE_OPEN_DELETEON
12db0 43 4c 4f 53 45 3b 0a 20 20 72 63 20 3d 20 73 71  CLOSE;.  rc = sq
12dc0 6c 69 74 65 33 4f 73 4f 70 65 6e 28 70 56 66 73  lite3OsOpen(pVfs
12dd0 2c 20 7a 46 69 6c 65 6e 61 6d 65 2c 20 70 46 69  , zFilename, pFi
12de0 6c 65 2c 20 76 66 73 46 6c 61 67 73 2c 20 30 29  le, vfsFlags, 0)
12df0 3b 0a 20 20 61 73 73 65 72 74 28 20 72 63 21 3d  ;.  assert( rc!=
12e00 53 51 4c 49 54 45 5f 4f 4b 20 7c 7c 20 70 46 69  SQLITE_OK || pFi
12e10 6c 65 2d 3e 70 4d 65 74 68 6f 64 73 20 29 3b 0a  le->pMethods );.
12e20 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 7d 0a 0a    return rc;.}..
12e30 2f 2a 0a 2a 2a 20 43 72 65 61 74 65 20 61 20 6e  /*.** Create a n
12e40 65 77 20 70 61 67 65 20 63 61 63 68 65 20 61 6e  ew page cache an
12e50 64 20 70 75 74 20 61 20 70 6f 69 6e 74 65 72 20  d put a pointer 
12e60 74 6f 20 74 68 65 20 70 61 67 65 20 63 61 63 68  to the page cach
12e70 65 20 69 6e 20 2a 70 70 50 61 67 65 72 2e 0a 2a  e in *ppPager..*
12e80 2a 20 54 68 65 20 66 69 6c 65 20 74 6f 20 62 65  * The file to be
12e90 20 63 61 63 68 65 64 20 6e 65 65 64 20 6e 6f 74   cached need not
12ea0 20 65 78 69 73 74 2e 20 20 54 68 65 20 66 69 6c   exist.  The fil
12eb0 65 20 69 73 20 6e 6f 74 20 6c 6f 63 6b 65 64 20  e is not locked 
12ec0 75 6e 74 69 6c 0a 2a 2a 20 74 68 65 20 66 69 72  until.** the fir
12ed0 73 74 20 63 61 6c 6c 20 74 6f 20 73 71 6c 69 74  st call to sqlit
12ee0 65 33 50 61 67 65 72 47 65 74 28 29 20 61 6e 64  e3PagerGet() and
12ef0 20 69 73 20 6f 6e 6c 79 20 68 65 6c 64 20 6f 70   is only held op
12f00 65 6e 20 75 6e 74 69 6c 20 74 68 65 0a 2a 2a 20  en until the.** 
12f10 6c 61 73 74 20 70 61 67 65 20 69 73 20 72 65 6c  last page is rel
12f20 65 61 73 65 64 20 75 73 69 6e 67 20 73 71 6c 69  eased using sqli
12f30 74 65 33 50 61 67 65 72 55 6e 72 65 66 28 29 2e  te3PagerUnref().
12f40 0a 2a 2a 0a 2a 2a 20 49 66 20 7a 46 69 6c 65 6e  .**.** If zFilen
12f50 61 6d 65 20 69 73 20 4e 55 4c 4c 20 74 68 65 6e  ame is NULL then
12f60 20 61 20 72 61 6e 64 6f 6d 6c 79 2d 6e 61 6d 65   a randomly-name
12f70 64 20 74 65 6d 70 6f 72 61 72 79 20 66 69 6c 65  d temporary file
12f80 20 69 73 20 63 72 65 61 74 65 64 0a 2a 2a 20 61   is created.** a
12f90 6e 64 20 75 73 65 64 20 61 73 20 74 68 65 20 66  nd used as the f
12fa0 69 6c 65 20 74 6f 20 62 65 20 63 61 63 68 65 64  ile to be cached
12fb0 2e 20 20 54 68 65 20 66 69 6c 65 20 77 69 6c 6c  .  The file will
12fc0 20 62 65 20 64 65 6c 65 74 65 64 0a 2a 2a 20 61   be deleted.** a
12fd0 75 74 6f 6d 61 74 69 63 61 6c 6c 79 20 77 68 65  utomatically whe
12fe0 6e 20 69 74 20 69 73 20 63 6c 6f 73 65 64 2e 0a  n it is closed..
12ff0 2a 2a 0a 2a 2a 20 49 66 20 7a 46 69 6c 65 6e 61  **.** If zFilena
13000 6d 65 20 69 73 20 22 3a 6d 65 6d 6f 72 79 3a 22  me is ":memory:"
13010 20 74 68 65 6e 20 61 6c 6c 20 69 6e 66 6f 72 6d   then all inform
13020 61 74 69 6f 6e 20 69 73 20 68 65 6c 64 20 69 6e  ation is held in
13030 20 63 61 63 68 65 2e 0a 2a 2a 20 49 74 20 69 73   cache..** It is
13040 20 6e 65 76 65 72 20 77 72 69 74 74 65 6e 20 74   never written t
13050 6f 20 64 69 73 6b 2e 20 20 54 68 69 73 20 63 61  o disk.  This ca
13060 6e 20 62 65 20 75 73 65 64 20 74 6f 20 69 6d 70  n be used to imp
13070 6c 65 6d 65 6e 74 20 61 6e 0a 2a 2a 20 69 6e 2d  lement an.** in-
13080 6d 65 6d 6f 72 79 20 64 61 74 61 62 61 73 65 2e  memory database.
13090 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 50  .*/.int sqlite3P
130a0 61 67 65 72 4f 70 65 6e 28 0a 20 20 73 71 6c 69  agerOpen(.  sqli
130b0 74 65 33 5f 76 66 73 20 2a 70 56 66 73 2c 20 20  te3_vfs *pVfs,  
130c0 20 20 20 20 20 2f 2a 20 54 68 65 20 76 69 72 74       /* The virt
130d0 75 61 6c 20 66 69 6c 65 20 73 79 73 74 65 6d 20  ual file system 
130e0 74 6f 20 75 73 65 20 2a 2f 0a 20 20 50 61 67 65  to use */.  Page
130f0 72 20 2a 2a 70 70 50 61 67 65 72 2c 20 20 20 20  r **ppPager,    
13100 20 20 20 20 20 2f 2a 20 52 65 74 75 72 6e 20 74       /* Return t
13110 68 65 20 50 61 67 65 72 20 73 74 72 75 63 74 75  he Pager structu
13120 72 65 20 68 65 72 65 20 2a 2f 0a 20 20 63 6f 6e  re here */.  con
13130 73 74 20 63 68 61 72 20 2a 7a 46 69 6c 65 6e 61  st char *zFilena
13140 6d 65 2c 20 20 20 2f 2a 20 4e 61 6d 65 20 6f 66  me,   /* Name of
13150 20 74 68 65 20 64 61 74 61 62 61 73 65 20 66 69   the database fi
13160 6c 65 20 74 6f 20 6f 70 65 6e 20 2a 2f 0a 20 20  le to open */.  
13170 69 6e 74 20 6e 45 78 74 72 61 2c 20 20 20 20 20  int nExtra,     
13180 20 20 20 20 20 20 20 20 20 2f 2a 20 45 78 74 72           /* Extr
13190 61 20 62 79 74 65 73 20 61 70 70 65 6e 64 20 74  a bytes append t
131a0 6f 20 65 61 63 68 20 69 6e 2d 6d 65 6d 6f 72 79  o each in-memory
131b0 20 70 61 67 65 20 2a 2f 0a 20 20 69 6e 74 20 66   page */.  int f
131c0 6c 61 67 73 2c 20 20 20 20 20 20 20 20 20 20 20  lags,           
131d0 20 20 20 20 2f 2a 20 66 6c 61 67 73 20 63 6f 6e      /* flags con
131e0 74 72 6f 6c 6c 69 6e 67 20 74 68 69 73 20 66 69  trolling this fi
131f0 6c 65 20 2a 2f 0a 20 20 69 6e 74 20 76 66 73 46  le */.  int vfsF
13200 6c 61 67 73 20 20 20 20 20 20 20 20 20 20 20 20  lags            
13210 20 2f 2a 20 66 6c 61 67 73 20 70 61 73 73 65 64   /* flags passed
13220 20 74 68 72 6f 75 67 68 20 74 6f 20 73 71 6c 69   through to sqli
13230 74 65 33 5f 76 66 73 2e 78 4f 70 65 6e 28 29 20  te3_vfs.xOpen() 
13240 2a 2f 0a 29 7b 0a 20 20 75 38 20 2a 70 50 74 72  */.){.  u8 *pPtr
13250 3b 0a 20 20 50 61 67 65 72 20 2a 70 50 61 67 65  ;.  Pager *pPage
13260 72 20 3d 20 30 3b 0a 20 20 69 6e 74 20 72 63 20  r = 0;.  int rc 
13270 3d 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20 20 69  = SQLITE_OK;.  i
13280 6e 74 20 69 3b 0a 20 20 69 6e 74 20 74 65 6d 70  nt i;.  int temp
13290 46 69 6c 65 20 3d 20 30 3b 0a 20 20 69 6e 74 20  File = 0;.  int 
132a0 6d 65 6d 44 62 20 3d 20 30 3b 0a 20 20 69 6e 74  memDb = 0;.  int
132b0 20 72 65 61 64 4f 6e 6c 79 20 3d 20 30 3b 0a 20   readOnly = 0;. 
132c0 20 69 6e 74 20 75 73 65 4a 6f 75 72 6e 61 6c 20   int useJournal 
132d0 3d 20 28 66 6c 61 67 73 20 26 20 50 41 47 45 52  = (flags & PAGER
132e0 5f 4f 4d 49 54 5f 4a 4f 55 52 4e 41 4c 29 3d 3d  _OMIT_JOURNAL)==
132f0 30 3b 0a 20 20 69 6e 74 20 6e 6f 52 65 61 64 6c  0;.  int noReadl
13300 6f 63 6b 20 3d 20 28 66 6c 61 67 73 20 26 20 50  ock = (flags & P
13310 41 47 45 52 5f 4e 4f 5f 52 45 41 44 4c 4f 43 4b  AGER_NO_READLOCK
13320 29 21 3d 30 3b 0a 20 20 69 6e 74 20 6a 6f 75 72  )!=0;.  int jour
13330 6e 61 6c 46 69 6c 65 53 69 7a 65 20 3d 20 73 71  nalFileSize = sq
13340 6c 69 74 65 33 4a 6f 75 72 6e 61 6c 53 69 7a 65  lite3JournalSize
13350 28 70 56 66 73 29 3b 0a 20 20 69 6e 74 20 6e 44  (pVfs);.  int nD
13360 65 66 61 75 6c 74 50 61 67 65 20 3d 20 53 51 4c  efaultPage = SQL
13370 49 54 45 5f 44 45 46 41 55 4c 54 5f 50 41 47 45  ITE_DEFAULT_PAGE
13380 5f 53 49 5a 45 3b 0a 20 20 63 68 61 72 20 2a 7a  _SIZE;.  char *z
13390 50 61 74 68 6e 61 6d 65 3b 0a 20 20 69 6e 74 20  Pathname;.  int 
133a0 6e 50 61 74 68 6e 61 6d 65 3b 0a 20 20 63 68 61  nPathname;.  cha
133b0 72 20 2a 7a 53 74 6d 74 4a 72 6e 6c 3b 0a 20 20  r *zStmtJrnl;.  
133c0 69 6e 74 20 6e 53 74 6d 74 4a 72 6e 6c 3b 0a 0a  int nStmtJrnl;..
133d0 20 20 2f 2a 20 54 68 65 20 64 65 66 61 75 6c 74    /* The default
133e0 20 72 65 74 75 72 6e 20 69 73 20 61 20 4e 55 4c   return is a NUL
133f0 4c 20 70 6f 69 6e 74 65 72 20 2a 2f 0a 20 20 2a  L pointer */.  *
13400 70 70 50 61 67 65 72 20 3d 20 30 3b 0a 0a 20 20  ppPager = 0;..  
13410 2f 2a 20 43 6f 6d 70 75 74 65 20 74 68 65 20 66  /* Compute the f
13420 75 6c 6c 20 70 61 74 68 6e 61 6d 65 20 2a 2f 0a  ull pathname */.
13430 20 20 6e 50 61 74 68 6e 61 6d 65 20 3d 20 70 56    nPathname = pV
13440 66 73 2d 3e 6d 78 50 61 74 68 6e 61 6d 65 2b 31  fs->mxPathname+1
13450 3b 0a 20 20 7a 50 61 74 68 6e 61 6d 65 20 3d 20  ;.  zPathname = 
13460 73 71 6c 69 74 65 33 5f 6d 61 6c 6c 6f 63 28 6e  sqlite3_malloc(n
13470 50 61 74 68 6e 61 6d 65 2a 32 29 3b 0a 20 20 69  Pathname*2);.  i
13480 66 28 20 7a 50 61 74 68 6e 61 6d 65 3d 3d 30 20  f( zPathname==0 
13490 29 7b 0a 20 20 20 20 72 65 74 75 72 6e 20 53 51  ){.    return SQ
134a0 4c 49 54 45 5f 4e 4f 4d 45 4d 3b 0a 20 20 7d 0a  LITE_NOMEM;.  }.
134b0 20 20 69 66 28 20 7a 46 69 6c 65 6e 61 6d 65 20    if( zFilename 
134c0 26 26 20 7a 46 69 6c 65 6e 61 6d 65 5b 30 5d 20  && zFilename[0] 
134d0 29 7b 0a 23 69 66 6e 64 65 66 20 53 51 4c 49 54  ){.#ifndef SQLIT
134e0 45 5f 4f 4d 49 54 5f 4d 45 4d 4f 52 59 44 42 0a  E_OMIT_MEMORYDB.
134f0 20 20 20 20 69 66 28 20 73 74 72 63 6d 70 28 7a      if( strcmp(z
13500 46 69 6c 65 6e 61 6d 65 2c 22 3a 6d 65 6d 6f 72  Filename,":memor
13510 79 3a 22 29 3d 3d 30 20 29 7b 0a 20 20 20 20 20  y:")==0 ){.     
13520 20 6d 65 6d 44 62 20 3d 20 31 3b 0a 20 20 20 20   memDb = 1;.    
13530 20 20 7a 50 61 74 68 6e 61 6d 65 5b 30 5d 20 3d    zPathname[0] =
13540 20 30 3b 0a 20 20 20 20 7d 65 6c 73 65 0a 23 65   0;.    }else.#e
13550 6e 64 69 66 0a 20 20 20 20 7b 0a 20 20 20 20 20  ndif.    {.     
13560 20 72 63 20 3d 20 73 71 6c 69 74 65 33 4f 73 46   rc = sqlite3OsF
13570 75 6c 6c 50 61 74 68 6e 61 6d 65 28 70 56 66 73  ullPathname(pVfs
13580 2c 20 7a 46 69 6c 65 6e 61 6d 65 2c 20 6e 50 61  , zFilename, nPa
13590 74 68 6e 61 6d 65 2c 20 7a 50 61 74 68 6e 61 6d  thname, zPathnam
135a0 65 29 3b 0a 20 20 20 20 7d 0a 20 20 7d 65 6c 73  e);.    }.  }els
135b0 65 7b 0a 20 20 20 20 72 63 20 3d 20 73 71 6c 69  e{.    rc = sqli
135c0 74 65 33 4f 73 47 65 74 54 65 6d 70 6e 61 6d 65  te3OsGetTempname
135d0 28 70 56 66 73 2c 20 6e 50 61 74 68 6e 61 6d 65  (pVfs, nPathname
135e0 2c 20 7a 50 61 74 68 6e 61 6d 65 29 3b 0a 20 20  , zPathname);.  
135f0 7d 0a 20 20 69 66 28 20 72 63 21 3d 53 51 4c 49  }.  if( rc!=SQLI
13600 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 73 71 6c  TE_OK ){.    sql
13610 69 74 65 33 5f 66 72 65 65 28 7a 50 61 74 68 6e  ite3_free(zPathn
13620 61 6d 65 29 3b 0a 20 20 20 20 72 65 74 75 72 6e  ame);.    return
13630 20 72 63 3b 0a 20 20 7d 0a 20 20 6e 50 61 74 68   rc;.  }.  nPath
13640 6e 61 6d 65 20 3d 20 73 74 72 6c 65 6e 28 7a 50  name = strlen(zP
13650 61 74 68 6e 61 6d 65 29 3b 0a 0a 20 20 2f 2a 20  athname);..  /* 
13660 50 75 74 20 74 68 65 20 73 74 61 74 65 6d 65 6e  Put the statemen
13670 74 20 6a 6f 75 72 6e 61 6c 20 69 6e 20 74 65 6d  t journal in tem
13680 70 6f 72 61 72 79 20 64 69 73 6b 20 73 70 61 63  porary disk spac
13690 65 20 73 69 6e 63 65 20 74 68 69 73 20 69 73 0a  e since this is.
136a0 20 20 2a 2a 20 73 6f 6d 65 74 69 6d 65 73 20 52    ** sometimes R
136b0 41 4d 20 64 69 73 6b 20 6f 72 20 6f 74 68 65 72  AM disk or other
136c0 20 6f 70 74 69 6d 69 7a 65 64 20 73 74 6f 72 61   optimized stora
136d0 67 65 2e 20 20 55 6e 6c 69 6b 65 6c 79 20 74 68  ge.  Unlikely th
136e0 65 20 6d 61 69 6e 0a 20 20 2a 2a 20 6d 61 69 6e  e main.  ** main
136f0 20 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 2c 20 74   journal file, t
13700 68 65 20 73 74 61 74 65 6d 65 6e 74 20 6a 6f 75  he statement jou
13710 72 6e 61 6c 20 64 6f 65 73 20 6e 6f 74 20 6e 65  rnal does not ne
13720 65 64 20 74 6f 20 62 65 20 0a 20 20 2a 2a 20 63  ed to be .  ** c
13730 6f 6c 6f 63 61 74 65 64 20 77 69 74 68 20 74 68  olocated with th
13740 65 20 64 61 74 61 62 61 73 65 20 6e 6f 72 20 64  e database nor d
13750 6f 65 73 20 69 74 20 6e 65 65 64 20 74 6f 20 62  oes it need to b
13760 65 20 70 65 72 73 69 73 74 65 6e 74 2e 0a 20 20  e persistent..  
13770 2a 2f 0a 20 20 7a 53 74 6d 74 4a 72 6e 6c 20 3d  */.  zStmtJrnl =
13780 20 26 7a 50 61 74 68 6e 61 6d 65 5b 6e 50 61 74   &zPathname[nPat
13790 68 6e 61 6d 65 2b 31 5d 3b 0a 20 20 72 63 20 3d  hname+1];.  rc =
137a0 20 73 71 6c 69 74 65 33 4f 73 47 65 74 54 65 6d   sqlite3OsGetTem
137b0 70 6e 61 6d 65 28 70 56 66 73 2c 20 70 56 66 73  pname(pVfs, pVfs
137c0 2d 3e 6d 78 50 61 74 68 6e 61 6d 65 2b 31 2c 20  ->mxPathname+1, 
137d0 7a 53 74 6d 74 4a 72 6e 6c 29 3b 0a 20 20 69 66  zStmtJrnl);.  if
137e0 28 20 72 63 21 3d 53 51 4c 49 54 45 5f 4f 4b 20  ( rc!=SQLITE_OK 
137f0 29 7b 0a 20 20 20 20 73 71 6c 69 74 65 33 5f 66  ){.    sqlite3_f
13800 72 65 65 28 7a 50 61 74 68 6e 61 6d 65 29 3b 0a  ree(zPathname);.
13810 20 20 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 20      return rc;. 
13820 20 7d 0a 20 20 6e 53 74 6d 74 4a 72 6e 6c 20 3d   }.  nStmtJrnl =
13830 20 73 74 72 6c 65 6e 28 7a 53 74 6d 74 4a 72 6e   strlen(zStmtJrn
13840 6c 29 3b 0a 0a 20 20 2f 2a 20 41 6c 6c 6f 63 61  l);..  /* Alloca
13850 74 65 20 6d 65 6d 6f 72 79 20 66 6f 72 20 74 68  te memory for th
13860 65 20 70 61 67 65 72 20 73 74 72 75 63 74 75 72  e pager structur
13870 65 20 2a 2f 0a 20 20 70 50 61 67 65 72 20 3d 20  e */.  pPager = 
13880 73 71 6c 69 74 65 33 4d 61 6c 6c 6f 63 5a 65 72  sqlite3MallocZer
13890 6f 28 0a 20 20 20 20 73 69 7a 65 6f 66 28 2a 70  o(.    sizeof(*p
138a0 50 61 67 65 72 29 20 2b 20 20 20 20 20 20 20 20  Pager) +        
138b0 20 20 20 2f 2a 20 50 61 67 65 72 20 73 74 72 75     /* Pager stru
138c0 63 74 75 72 65 20 2a 2f 0a 20 20 20 20 6a 6f 75  cture */.    jou
138d0 72 6e 61 6c 46 69 6c 65 53 69 7a 65 20 2b 20 20  rnalFileSize +  
138e0 20 20 20 20 20 20 20 20 20 2f 2a 20 54 68 65 20           /* The 
138f0 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 20 73 74 72  journal file str
13900 75 63 74 75 72 65 20 2a 2f 20 0a 20 20 20 20 70  ucture */ .    p
13910 56 66 73 2d 3e 73 7a 4f 73 46 69 6c 65 20 2a 20  Vfs->szOsFile * 
13920 33 20 2b 20 20 20 20 20 20 20 20 2f 2a 20 54 68  3 +        /* Th
13930 65 20 6d 61 69 6e 20 64 62 20 61 6e 64 20 74 77  e main db and tw
13940 6f 20 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 73 20  o journal files 
13950 2a 2f 20 0a 20 20 20 20 33 2a 6e 50 61 74 68 6e  */ .    3*nPathn
13960 61 6d 65 20 2b 20 34 30 20 2b 20 20 20 20 20 20  ame + 40 +      
13970 20 20 20 20 2f 2a 20 7a 46 69 6c 65 6e 61 6d 65      /* zFilename
13980 2c 20 7a 44 69 72 65 63 74 6f 72 79 2c 20 7a 4a  , zDirectory, zJ
13990 6f 75 72 6e 61 6c 20 2a 2f 0a 20 20 20 20 6e 53  ournal */.    nS
139a0 74 6d 74 4a 72 6e 6c 20 20 20 20 20 20 20 20 20  tmtJrnl         
139b0 20 20 20 20 20 20 20 20 20 20 2f 2a 20 7a 53 74            /* zSt
139c0 6d 74 4a 72 6e 6c 20 2a 2f 0a 20 20 29 3b 0a 20  mtJrnl */.  );. 
139d0 20 69 66 28 20 21 70 50 61 67 65 72 20 29 7b 0a   if( !pPager ){.
139e0 20 20 20 20 73 71 6c 69 74 65 33 5f 66 72 65 65      sqlite3_free
139f0 28 7a 50 61 74 68 6e 61 6d 65 29 3b 0a 20 20 20  (zPathname);.   
13a00 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4e   return SQLITE_N
13a10 4f 4d 45 4d 3b 0a 20 20 7d 0a 20 20 70 50 74 72  OMEM;.  }.  pPtr
13a20 20 3d 20 28 75 38 20 2a 29 26 70 50 61 67 65 72   = (u8 *)&pPager
13a30 5b 31 5d 3b 0a 20 20 70 50 61 67 65 72 2d 3e 76  [1];.  pPager->v
13a40 66 73 46 6c 61 67 73 20 3d 20 76 66 73 46 6c 61  fsFlags = vfsFla
13a50 67 73 3b 0a 20 20 70 50 61 67 65 72 2d 3e 66 64  gs;.  pPager->fd
13a60 20 3d 20 28 73 71 6c 69 74 65 33 5f 66 69 6c 65   = (sqlite3_file
13a70 2a 29 26 70 50 74 72 5b 70 56 66 73 2d 3e 73 7a  *)&pPtr[pVfs->sz
13a80 4f 73 46 69 6c 65 2a 30 5d 3b 0a 20 20 70 50 61  OsFile*0];.  pPa
13a90 67 65 72 2d 3e 73 74 66 64 20 3d 20 28 73 71 6c  ger->stfd = (sql
13aa0 69 74 65 33 5f 66 69 6c 65 2a 29 26 70 50 74 72  ite3_file*)&pPtr
13ab0 5b 70 56 66 73 2d 3e 73 7a 4f 73 46 69 6c 65 2a  [pVfs->szOsFile*
13ac0 31 5d 3b 0a 20 20 70 50 61 67 65 72 2d 3e 6a 66  1];.  pPager->jf
13ad0 64 20 3d 20 28 73 71 6c 69 74 65 33 5f 66 69 6c  d = (sqlite3_fil
13ae0 65 2a 29 26 70 50 74 72 5b 70 56 66 73 2d 3e 73  e*)&pPtr[pVfs->s
13af0 7a 4f 73 46 69 6c 65 2a 32 5d 3b 0a 20 20 70 50  zOsFile*2];.  pP
13b00 61 67 65 72 2d 3e 7a 46 69 6c 65 6e 61 6d 65 20  ager->zFilename 
13b10 3d 20 28 63 68 61 72 2a 29 26 70 50 74 72 5b 70  = (char*)&pPtr[p
13b20 56 66 73 2d 3e 73 7a 4f 73 46 69 6c 65 2a 32 2b  Vfs->szOsFile*2+
13b30 6a 6f 75 72 6e 61 6c 46 69 6c 65 53 69 7a 65 5d  journalFileSize]
13b40 3b 0a 20 20 70 50 61 67 65 72 2d 3e 7a 44 69 72  ;.  pPager->zDir
13b50 65 63 74 6f 72 79 20 3d 20 26 70 50 61 67 65 72  ectory = &pPager
13b60 2d 3e 7a 46 69 6c 65 6e 61 6d 65 5b 6e 50 61 74  ->zFilename[nPat
13b70 68 6e 61 6d 65 2b 31 5d 3b 0a 20 20 70 50 61 67  hname+1];.  pPag
13b80 65 72 2d 3e 7a 4a 6f 75 72 6e 61 6c 20 3d 20 26  er->zJournal = &
13b90 70 50 61 67 65 72 2d 3e 7a 44 69 72 65 63 74 6f  pPager->zDirecto
13ba0 72 79 5b 6e 50 61 74 68 6e 61 6d 65 2b 31 5d 3b  ry[nPathname+1];
13bb0 0a 20 20 70 50 61 67 65 72 2d 3e 7a 53 74 6d 74  .  pPager->zStmt
13bc0 4a 72 6e 6c 20 3d 20 26 70 50 61 67 65 72 2d 3e  Jrnl = &pPager->
13bd0 7a 4a 6f 75 72 6e 61 6c 5b 6e 50 61 74 68 6e 61  zJournal[nPathna
13be0 6d 65 2b 31 30 5d 3b 0a 20 20 70 50 61 67 65 72  me+10];.  pPager
13bf0 2d 3e 70 56 66 73 20 3d 20 70 56 66 73 3b 0a 20  ->pVfs = pVfs;. 
13c00 20 6d 65 6d 63 70 79 28 70 50 61 67 65 72 2d 3e   memcpy(pPager->
13c10 7a 46 69 6c 65 6e 61 6d 65 2c 20 7a 50 61 74 68  zFilename, zPath
13c20 6e 61 6d 65 2c 20 6e 50 61 74 68 6e 61 6d 65 2b  name, nPathname+
13c30 31 29 3b 0a 20 20 6d 65 6d 63 70 79 28 70 50 61  1);.  memcpy(pPa
13c40 67 65 72 2d 3e 7a 53 74 6d 74 4a 72 6e 6c 2c 20  ger->zStmtJrnl, 
13c50 7a 53 74 6d 74 4a 72 6e 6c 2c 20 6e 53 74 6d 74  zStmtJrnl, nStmt
13c60 4a 72 6e 6c 2b 31 29 3b 0a 20 20 73 71 6c 69 74  Jrnl+1);.  sqlit
13c70 65 33 5f 66 72 65 65 28 7a 50 61 74 68 6e 61 6d  e3_free(zPathnam
13c80 65 29 3b 0a 0a 20 20 2f 2a 20 4f 70 65 6e 20 74  e);..  /* Open t
13c90 68 65 20 70 61 67 65 72 20 66 69 6c 65 2e 0a 20  he pager file.. 
13ca0 20 2a 2f 0a 20 20 69 66 28 20 7a 46 69 6c 65 6e   */.  if( zFilen
13cb0 61 6d 65 20 26 26 20 7a 46 69 6c 65 6e 61 6d 65  ame && zFilename
13cc0 5b 30 5d 20 26 26 20 21 6d 65 6d 44 62 20 29 7b  [0] && !memDb ){
13cd0 0a 20 20 20 20 69 66 28 20 6e 50 61 74 68 6e 61  .    if( nPathna
13ce0 6d 65 3e 28 70 56 66 73 2d 3e 6d 78 50 61 74 68  me>(pVfs->mxPath
13cf0 6e 61 6d 65 20 2d 20 73 69 7a 65 6f 66 28 22 2d  name - sizeof("-
13d00 6a 6f 75 72 6e 61 6c 22 29 29 20 29 7b 0a 20 20  journal")) ){.  
13d10 20 20 20 20 72 63 20 3d 20 53 51 4c 49 54 45 5f      rc = SQLITE_
13d20 43 41 4e 54 4f 50 45 4e 3b 0a 20 20 20 20 7d 65  CANTOPEN;.    }e
13d30 6c 73 65 7b 0a 20 20 20 20 20 20 69 6e 74 20 66  lse{.      int f
13d40 6f 75 74 20 3d 20 30 3b 0a 20 20 20 20 20 20 72  out = 0;.      r
13d50 63 20 3d 20 73 71 6c 69 74 65 33 4f 73 4f 70 65  c = sqlite3OsOpe
13d60 6e 28 70 56 66 73 2c 20 70 50 61 67 65 72 2d 3e  n(pVfs, pPager->
13d70 7a 46 69 6c 65 6e 61 6d 65 2c 20 70 50 61 67 65  zFilename, pPage
13d80 72 2d 3e 66 64 2c 0a 20 20 20 20 20 20 20 20 20  r->fd,.         
13d90 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
13da0 70 50 61 67 65 72 2d 3e 76 66 73 46 6c 61 67 73  pPager->vfsFlags
13db0 2c 20 26 66 6f 75 74 29 3b 0a 20 20 20 20 20 20  , &fout);.      
13dc0 72 65 61 64 4f 6e 6c 79 20 3d 20 28 66 6f 75 74  readOnly = (fout
13dd0 26 53 51 4c 49 54 45 5f 4f 50 45 4e 5f 52 45 41  &SQLITE_OPEN_REA
13de0 44 4f 4e 4c 59 29 3b 0a 0a 20 20 20 20 20 20 2f  DONLY);..      /
13df0 2a 20 49 66 20 74 68 65 20 66 69 6c 65 20 77 61  * If the file wa
13e00 73 20 73 75 63 63 65 73 73 66 75 6c 6c 79 20 6f  s successfully o
13e10 70 65 6e 65 64 20 66 6f 72 20 72 65 61 64 2f 77  pened for read/w
13e20 72 69 74 65 20 61 63 63 65 73 73 2c 0a 20 20 20  rite access,.   
13e30 20 20 20 2a 2a 20 63 68 6f 6f 73 65 20 61 20 64     ** choose a d
13e40 65 66 61 75 6c 74 20 70 61 67 65 20 73 69 7a 65  efault page size
13e50 20 69 6e 20 63 61 73 65 20 77 65 20 68 61 76 65   in case we have
13e60 20 74 6f 20 63 72 65 61 74 65 20 74 68 65 0a 20   to create the. 
13e70 20 20 20 20 20 2a 2a 20 64 61 74 61 62 61 73 65       ** database
13e80 20 66 69 6c 65 2e 20 54 68 65 20 64 65 66 61 75   file. The defau
13e90 6c 74 20 70 61 67 65 20 73 69 7a 65 20 69 73 20  lt page size is 
13ea0 74 68 65 20 6d 61 78 69 6d 75 6d 20 6f 66 3a 0a  the maximum of:.
13eb0 20 20 20 20 20 20 2a 2a 0a 20 20 20 20 20 20 2a        **.      *
13ec0 2a 20 20 20 20 2b 20 53 51 4c 49 54 45 5f 44 45  *    + SQLITE_DE
13ed0 46 41 55 4c 54 5f 50 41 47 45 5f 53 49 5a 45 2c  FAULT_PAGE_SIZE,
13ee0 0a 20 20 20 20 20 20 2a 2a 20 20 20 20 2b 20 54  .      **    + T
13ef0 68 65 20 76 61 6c 75 65 20 72 65 74 75 72 6e 65  he value returne
13f00 64 20 62 79 20 73 71 6c 69 74 65 33 4f 73 53 65  d by sqlite3OsSe
13f10 63 74 6f 72 53 69 7a 65 28 29 0a 20 20 20 20 20  ctorSize().     
13f20 20 2a 2a 20 20 20 20 2b 20 54 68 65 20 6c 61 72   **    + The lar
13f30 67 65 73 74 20 70 61 67 65 20 73 69 7a 65 20 74  gest page size t
13f40 68 61 74 20 63 61 6e 20 62 65 20 77 72 69 74 74  hat can be writt
13f50 65 6e 20 61 74 6f 6d 69 63 61 6c 6c 79 2e 0a 20  en atomically.. 
13f60 20 20 20 20 20 2a 2f 0a 20 20 20 20 20 20 69 66       */.      if
13f70 28 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20  ( rc==SQLITE_OK 
13f80 26 26 20 21 72 65 61 64 4f 6e 6c 79 20 29 7b 0a  && !readOnly ){.
13f90 20 20 20 20 20 20 20 20 69 6e 74 20 69 53 65 63          int iSec
13fa0 74 6f 72 53 69 7a 65 20 3d 20 73 71 6c 69 74 65  torSize = sqlite
13fb0 33 4f 73 53 65 63 74 6f 72 53 69 7a 65 28 70 50  3OsSectorSize(pP
13fc0 61 67 65 72 2d 3e 66 64 29 3b 0a 20 20 20 20 20  ager->fd);.     
13fd0 20 20 20 69 66 28 20 6e 44 65 66 61 75 6c 74 50     if( nDefaultP
13fe0 61 67 65 3c 69 53 65 63 74 6f 72 53 69 7a 65 20  age<iSectorSize 
13ff0 29 7b 0a 20 20 20 20 20 20 20 20 20 20 6e 44 65  ){.          nDe
14000 66 61 75 6c 74 50 61 67 65 20 3d 20 69 53 65 63  faultPage = iSec
14010 74 6f 72 53 69 7a 65 3b 0a 20 20 20 20 20 20 20  torSize;.       
14020 20 7d 0a 23 69 66 64 65 66 20 53 51 4c 49 54 45   }.#ifdef SQLITE
14030 5f 45 4e 41 42 4c 45 5f 41 54 4f 4d 49 43 5f 57  _ENABLE_ATOMIC_W
14040 52 49 54 45 0a 20 20 20 20 20 20 20 20 7b 0a 20  RITE.        {. 
14050 20 20 20 20 20 20 20 20 20 69 6e 74 20 69 44 63           int iDc
14060 20 3d 20 73 71 6c 69 74 65 33 4f 73 44 65 76 69   = sqlite3OsDevi
14070 63 65 43 68 61 72 61 63 74 65 72 69 73 74 69 63  ceCharacteristic
14080 73 28 70 50 61 67 65 72 2d 3e 66 64 29 3b 0a 20  s(pPager->fd);. 
14090 20 20 20 20 20 20 20 20 20 69 6e 74 20 69 69 3b           int ii;
140a0 0a 20 20 20 20 20 20 20 20 20 20 61 73 73 65 72  .          asser
140b0 74 28 53 51 4c 49 54 45 5f 49 4f 43 41 50 5f 41  t(SQLITE_IOCAP_A
140c0 54 4f 4d 49 43 35 31 32 3d 3d 28 35 31 32 3e 3e  TOMIC512==(512>>
140d0 38 29 29 3b 0a 20 20 20 20 20 20 20 20 20 20 61  8));.          a
140e0 73 73 65 72 74 28 53 51 4c 49 54 45 5f 49 4f 43  ssert(SQLITE_IOC
140f0 41 50 5f 41 54 4f 4d 49 43 36 34 4b 3d 3d 28 36  AP_ATOMIC64K==(6
14100 35 35 33 36 3e 3e 38 29 29 3b 0a 20 20 20 20 20  5536>>8));.     
14110 20 20 20 20 20 61 73 73 65 72 74 28 53 51 4c 49       assert(SQLI
14120 54 45 5f 4d 41 58 5f 44 45 46 41 55 4c 54 5f 50  TE_MAX_DEFAULT_P
14130 41 47 45 5f 53 49 5a 45 3c 3d 36 35 35 33 36 29  AGE_SIZE<=65536)
14140 3b 0a 20 20 20 20 20 20 20 20 20 20 66 6f 72 28  ;.          for(
14150 69 69 3d 6e 44 65 66 61 75 6c 74 50 61 67 65 3b  ii=nDefaultPage;
14160 20 69 69 3c 3d 53 51 4c 49 54 45 5f 4d 41 58 5f   ii<=SQLITE_MAX_
14170 44 45 46 41 55 4c 54 5f 50 41 47 45 5f 53 49 5a  DEFAULT_PAGE_SIZ
14180 45 3b 20 69 69 3d 69 69 2a 32 29 7b 0a 20 20 20  E; ii=ii*2){.   
14190 20 20 20 20 20 20 20 20 20 69 66 28 20 69 44 63           if( iDc
141a0 26 28 53 51 4c 49 54 45 5f 49 4f 43 41 50 5f 41  &(SQLITE_IOCAP_A
141b0 54 4f 4d 49 43 7c 28 69 69 3e 3e 38 29 29 20 29  TOMIC|(ii>>8)) )
141c0 20 6e 44 65 66 61 75 6c 74 50 61 67 65 20 3d 20   nDefaultPage = 
141d0 69 69 3b 0a 20 20 20 20 20 20 20 20 20 20 7d 0a  ii;.          }.
141e0 20 20 20 20 20 20 20 20 7d 0a 23 65 6e 64 69 66          }.#endif
141f0 0a 20 20 20 20 20 20 20 20 69 66 28 20 6e 44 65  .        if( nDe
14200 66 61 75 6c 74 50 61 67 65 3e 53 51 4c 49 54 45  faultPage>SQLITE
14210 5f 4d 41 58 5f 44 45 46 41 55 4c 54 5f 50 41 47  _MAX_DEFAULT_PAG
14220 45 5f 53 49 5a 45 20 29 7b 0a 20 20 20 20 20 20  E_SIZE ){.      
14230 20 20 20 20 6e 44 65 66 61 75 6c 74 50 61 67 65      nDefaultPage
14240 20 3d 20 53 51 4c 49 54 45 5f 4d 41 58 5f 44 45   = SQLITE_MAX_DE
14250 46 41 55 4c 54 5f 50 41 47 45 5f 53 49 5a 45 3b  FAULT_PAGE_SIZE;
14260 0a 20 20 20 20 20 20 20 20 7d 0a 20 20 20 20 20  .        }.     
14270 20 7d 0a 20 20 20 20 7d 0a 20 20 7d 65 6c 73 65   }.    }.  }else
14280 20 69 66 28 20 21 6d 65 6d 44 62 20 29 7b 0a 20   if( !memDb ){. 
14290 20 20 20 2f 2a 20 49 66 20 61 20 74 65 6d 70 6f     /* If a tempo
142a0 72 61 72 79 20 66 69 6c 65 20 69 73 20 72 65 71  rary file is req
142b0 75 65 73 74 65 64 2c 20 69 74 20 69 73 20 6e 6f  uested, it is no
142c0 74 20 6f 70 65 6e 65 64 20 69 6d 6d 65 64 69 61  t opened immedia
142d0 74 65 6c 79 2e 0a 20 20 20 20 2a 2a 20 49 6e 20  tely..    ** In 
142e0 74 68 69 73 20 63 61 73 65 20 77 65 20 61 63 63  this case we acc
142f0 65 70 74 20 74 68 65 20 64 65 66 61 75 6c 74 20  ept the default 
14300 70 61 67 65 20 73 69 7a 65 20 61 6e 64 20 64 65  page size and de
14310 6c 61 79 20 61 63 74 75 61 6c 6c 79 0a 20 20 20  lay actually.   
14320 20 2a 2a 20 6f 70 65 6e 69 6e 67 20 74 68 65 20   ** opening the 
14330 66 69 6c 65 20 75 6e 74 69 6c 20 74 68 65 20 66  file until the f
14340 69 72 73 74 20 63 61 6c 6c 20 74 6f 20 4f 73 57  irst call to OsW
14350 72 69 74 65 28 29 2e 0a 20 20 20 20 2a 2f 20 0a  rite()..    */ .
14360 20 20 20 20 74 65 6d 70 46 69 6c 65 20 3d 20 31      tempFile = 1
14370 3b 0a 20 20 20 20 70 50 61 67 65 72 2d 3e 73 74  ;.    pPager->st
14380 61 74 65 20 3d 20 50 41 47 45 52 5f 45 58 43 4c  ate = PAGER_EXCL
14390 55 53 49 56 45 3b 0a 20 20 7d 0a 0a 20 20 69 66  USIVE;.  }..  if
143a0 28 20 70 50 61 67 65 72 20 26 26 20 72 63 3d 3d  ( pPager && rc==
143b0 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20  SQLITE_OK ){.   
143c0 20 70 50 61 67 65 72 2d 3e 70 54 6d 70 53 70 61   pPager->pTmpSpa
143d0 63 65 20 3d 20 28 63 68 61 72 20 2a 29 73 71 6c  ce = (char *)sql
143e0 69 74 65 33 5f 6d 61 6c 6c 6f 63 28 6e 44 65 66  ite3_malloc(nDef
143f0 61 75 6c 74 50 61 67 65 29 3b 0a 20 20 7d 0a 0a  aultPage);.  }..
14400 20 20 2f 2a 20 49 66 20 61 6e 20 65 72 72 6f 72    /* If an error
14410 20 6f 63 63 75 72 65 64 20 69 6e 20 65 69 74 68   occured in eith
14420 65 72 20 6f 66 20 74 68 65 20 62 6c 6f 63 6b 73  er of the blocks
14430 20 61 62 6f 76 65 2e 0a 20 20 2a 2a 20 46 72 65   above..  ** Fre
14440 65 20 74 68 65 20 50 61 67 65 72 20 73 74 72 75  e the Pager stru
14450 63 74 75 72 65 20 61 6e 64 20 63 6c 6f 73 65 20  cture and close 
14460 74 68 65 20 66 69 6c 65 2e 0a 20 20 2a 2a 20 53  the file..  ** S
14470 69 6e 63 65 20 74 68 65 20 70 61 67 65 72 20 69  ince the pager i
14480 73 20 6e 6f 74 20 61 6c 6c 6f 63 61 74 65 64 20  s not allocated 
14490 74 68 65 72 65 20 69 73 20 6e 6f 20 6e 65 65 64  there is no need
144a0 20 74 6f 20 73 65 74 20 0a 20 20 2a 2a 20 61 6e   to set .  ** an
144b0 79 20 50 61 67 65 72 2e 65 72 72 4d 61 73 6b 20  y Pager.errMask 
144c0 76 61 72 69 61 62 6c 65 73 2e 0a 20 20 2a 2f 0a  variables..  */.
144d0 20 20 69 66 28 20 21 70 50 61 67 65 72 20 7c 7c    if( !pPager ||
144e0 20 21 70 50 61 67 65 72 2d 3e 70 54 6d 70 53 70   !pPager->pTmpSp
144f0 61 63 65 20 29 7b 0a 20 20 20 20 73 71 6c 69 74  ace ){.    sqlit
14500 65 33 4f 73 43 6c 6f 73 65 28 70 50 61 67 65 72  e3OsClose(pPager
14510 2d 3e 66 64 29 3b 0a 20 20 20 20 73 71 6c 69 74  ->fd);.    sqlit
14520 65 33 5f 66 72 65 65 28 70 50 61 67 65 72 29 3b  e3_free(pPager);
14530 0a 20 20 20 20 72 65 74 75 72 6e 20 28 28 72 63  .    return ((rc
14540 3d 3d 53 51 4c 49 54 45 5f 4f 4b 29 3f 53 51 4c  ==SQLITE_OK)?SQL
14550 49 54 45 5f 4e 4f 4d 45 4d 3a 72 63 29 3b 0a 20  ITE_NOMEM:rc);. 
14560 20 7d 0a 0a 20 20 50 41 47 45 52 54 52 41 43 45   }..  PAGERTRACE
14570 33 28 22 4f 50 45 4e 20 25 64 20 25 73 5c 6e 22  3("OPEN %d %s\n"
14580 2c 20 46 49 4c 45 48 41 4e 44 4c 45 49 44 28 70  , FILEHANDLEID(p
14590 50 61 67 65 72 2d 3e 66 64 29 2c 20 70 50 61 67  Pager->fd), pPag
145a0 65 72 2d 3e 7a 46 69 6c 65 6e 61 6d 65 29 3b 0a  er->zFilename);.
145b0 20 20 49 4f 54 52 41 43 45 28 28 22 4f 50 45 4e    IOTRACE(("OPEN
145c0 20 25 70 20 25 73 5c 6e 22 2c 20 70 50 61 67 65   %p %s\n", pPage
145d0 72 2c 20 70 50 61 67 65 72 2d 3e 7a 46 69 6c 65  r, pPager->zFile
145e0 6e 61 6d 65 29 29 0a 0a 20 20 2f 2a 20 46 69 6c  name))..  /* Fil
145f0 6c 20 69 6e 20 50 61 67 65 72 2e 7a 44 69 72 65  l in Pager.zDire
14600 63 74 6f 72 79 5b 5d 20 2a 2f 0a 20 20 6d 65 6d  ctory[] */.  mem
14610 63 70 79 28 70 50 61 67 65 72 2d 3e 7a 44 69 72  cpy(pPager->zDir
14620 65 63 74 6f 72 79 2c 20 70 50 61 67 65 72 2d 3e  ectory, pPager->
14630 7a 46 69 6c 65 6e 61 6d 65 2c 20 6e 50 61 74 68  zFilename, nPath
14640 6e 61 6d 65 2b 31 29 3b 0a 20 20 66 6f 72 28 69  name+1);.  for(i
14650 3d 73 74 72 6c 65 6e 28 70 50 61 67 65 72 2d 3e  =strlen(pPager->
14660 7a 44 69 72 65 63 74 6f 72 79 29 3b 20 69 3e 30  zDirectory); i>0
14670 20 26 26 20 70 50 61 67 65 72 2d 3e 7a 44 69 72   && pPager->zDir
14680 65 63 74 6f 72 79 5b 69 2d 31 5d 21 3d 27 2f 27  ectory[i-1]!='/'
14690 3b 20 69 2d 2d 29 7b 7d 0a 20 20 69 66 28 20 69  ; i--){}.  if( i
146a0 3e 30 20 29 20 70 50 61 67 65 72 2d 3e 7a 44 69  >0 ) pPager->zDi
146b0 72 65 63 74 6f 72 79 5b 69 2d 31 5d 20 3d 20 30  rectory[i-1] = 0
146c0 3b 0a 0a 20 20 2f 2a 20 46 69 6c 6c 20 69 6e 20  ;..  /* Fill in 
146d0 50 61 67 65 72 2e 7a 4a 6f 75 72 6e 61 6c 5b 5d  Pager.zJournal[]
146e0 20 2a 2f 0a 20 20 6d 65 6d 63 70 79 28 70 50 61   */.  memcpy(pPa
146f0 67 65 72 2d 3e 7a 4a 6f 75 72 6e 61 6c 2c 20 70  ger->zJournal, p
14700 50 61 67 65 72 2d 3e 7a 46 69 6c 65 6e 61 6d 65  Pager->zFilename
14710 2c 20 6e 50 61 74 68 6e 61 6d 65 29 3b 0a 20 20  , nPathname);.  
14720 6d 65 6d 63 70 79 28 26 70 50 61 67 65 72 2d 3e  memcpy(&pPager->
14730 7a 4a 6f 75 72 6e 61 6c 5b 6e 50 61 74 68 6e 61  zJournal[nPathna
14740 6d 65 5d 2c 20 22 2d 6a 6f 75 72 6e 61 6c 22 2c  me], "-journal",
14750 20 39 29 3b 0a 0a 20 20 2f 2a 20 70 50 61 67 65   9);..  /* pPage
14760 72 2d 3e 6a 6f 75 72 6e 61 6c 4f 70 65 6e 20 3d  r->journalOpen =
14770 20 30 3b 20 2a 2f 0a 20 20 70 50 61 67 65 72 2d   0; */.  pPager-
14780 3e 75 73 65 4a 6f 75 72 6e 61 6c 20 3d 20 75 73  >useJournal = us
14790 65 4a 6f 75 72 6e 61 6c 20 26 26 20 21 6d 65 6d  eJournal && !mem
147a0 44 62 3b 0a 20 20 70 50 61 67 65 72 2d 3e 6e 6f  Db;.  pPager->no
147b0 52 65 61 64 6c 6f 63 6b 20 3d 20 6e 6f 52 65 61  Readlock = noRea
147c0 64 6c 6f 63 6b 20 26 26 20 72 65 61 64 4f 6e 6c  dlock && readOnl
147d0 79 3b 0a 20 20 2f 2a 20 70 50 61 67 65 72 2d 3e  y;.  /* pPager->
147e0 73 74 6d 74 4f 70 65 6e 20 3d 20 30 3b 20 2a 2f  stmtOpen = 0; */
147f0 0a 20 20 2f 2a 20 70 50 61 67 65 72 2d 3e 73 74  .  /* pPager->st
14800 6d 74 49 6e 55 73 65 20 3d 20 30 3b 20 2a 2f 0a  mtInUse = 0; */.
14810 20 20 2f 2a 20 70 50 61 67 65 72 2d 3e 6e 52 65    /* pPager->nRe
14820 66 20 3d 20 30 3b 20 2a 2f 0a 20 20 70 50 61 67  f = 0; */.  pPag
14830 65 72 2d 3e 64 62 53 69 7a 65 20 3d 20 6d 65 6d  er->dbSize = mem
14840 44 62 2d 31 3b 0a 20 20 70 50 61 67 65 72 2d 3e  Db-1;.  pPager->
14850 70 61 67 65 53 69 7a 65 20 3d 20 6e 44 65 66 61  pageSize = nDefa
14860 75 6c 74 50 61 67 65 3b 0a 20 20 2f 2a 20 70 50  ultPage;.  /* pP
14870 61 67 65 72 2d 3e 73 74 6d 74 53 69 7a 65 20 3d  ager->stmtSize =
14880 20 30 3b 20 2a 2f 0a 20 20 2f 2a 20 70 50 61 67   0; */.  /* pPag
14890 65 72 2d 3e 73 74 6d 74 4a 53 69 7a 65 20 3d 20  er->stmtJSize = 
148a0 30 3b 20 2a 2f 0a 20 20 2f 2a 20 70 50 61 67 65  0; */.  /* pPage
148b0 72 2d 3e 6e 50 61 67 65 20 3d 20 30 3b 20 2a 2f  r->nPage = 0; */
148c0 0a 20 20 70 50 61 67 65 72 2d 3e 6d 78 50 61 67  .  pPager->mxPag
148d0 65 20 3d 20 31 30 30 3b 0a 20 20 70 50 61 67 65  e = 100;.  pPage
148e0 72 2d 3e 6d 78 50 67 6e 6f 20 3d 20 53 51 4c 49  r->mxPgno = SQLI
148f0 54 45 5f 4d 41 58 5f 50 41 47 45 5f 43 4f 55 4e  TE_MAX_PAGE_COUN
14900 54 3b 0a 20 20 2f 2a 20 70 50 61 67 65 72 2d 3e  T;.  /* pPager->
14910 73 74 61 74 65 20 3d 20 50 41 47 45 52 5f 55 4e  state = PAGER_UN
14920 4c 4f 43 4b 3b 20 2a 2f 0a 20 20 61 73 73 65 72  LOCK; */.  asser
14930 74 28 20 70 50 61 67 65 72 2d 3e 73 74 61 74 65  t( pPager->state
14940 20 3d 3d 20 28 74 65 6d 70 46 69 6c 65 20 3f 20   == (tempFile ? 
14950 50 41 47 45 52 5f 45 58 43 4c 55 53 49 56 45 20  PAGER_EXCLUSIVE 
14960 3a 20 50 41 47 45 52 5f 55 4e 4c 4f 43 4b 29 20  : PAGER_UNLOCK) 
14970 29 3b 0a 20 20 2f 2a 20 70 50 61 67 65 72 2d 3e  );.  /* pPager->
14980 65 72 72 4d 61 73 6b 20 3d 20 30 3b 20 2a 2f 0a  errMask = 0; */.
14990 20 20 70 50 61 67 65 72 2d 3e 74 65 6d 70 46 69    pPager->tempFi
149a0 6c 65 20 3d 20 74 65 6d 70 46 69 6c 65 3b 0a 20  le = tempFile;. 
149b0 20 61 73 73 65 72 74 28 20 74 65 6d 70 46 69 6c   assert( tempFil
149c0 65 3d 3d 50 41 47 45 52 5f 4c 4f 43 4b 49 4e 47  e==PAGER_LOCKING
149d0 4d 4f 44 45 5f 4e 4f 52 4d 41 4c 20 0a 20 20 20  MODE_NORMAL .   
149e0 20 20 20 20 20 20 20 7c 7c 20 74 65 6d 70 46 69         || tempFi
149f0 6c 65 3d 3d 50 41 47 45 52 5f 4c 4f 43 4b 49 4e  le==PAGER_LOCKIN
14a00 47 4d 4f 44 45 5f 45 58 43 4c 55 53 49 56 45 20  GMODE_EXCLUSIVE 
14a10 29 3b 0a 20 20 61 73 73 65 72 74 28 20 50 41 47  );.  assert( PAG
14a20 45 52 5f 4c 4f 43 4b 49 4e 47 4d 4f 44 45 5f 45  ER_LOCKINGMODE_E
14a30 58 43 4c 55 53 49 56 45 3d 3d 31 20 29 3b 0a 20  XCLUSIVE==1 );. 
14a40 20 70 50 61 67 65 72 2d 3e 65 78 63 6c 75 73 69   pPager->exclusi
14a50 76 65 4d 6f 64 65 20 3d 20 74 65 6d 70 46 69 6c  veMode = tempFil
14a60 65 3b 20 0a 20 20 70 50 61 67 65 72 2d 3e 6d 65  e; .  pPager->me
14a70 6d 44 62 20 3d 20 6d 65 6d 44 62 3b 0a 20 20 70  mDb = memDb;.  p
14a80 50 61 67 65 72 2d 3e 72 65 61 64 4f 6e 6c 79 20  Pager->readOnly 
14a90 3d 20 72 65 61 64 4f 6e 6c 79 3b 0a 20 20 2f 2a  = readOnly;.  /*
14aa0 20 70 50 61 67 65 72 2d 3e 6e 65 65 64 53 79 6e   pPager->needSyn
14ab0 63 20 3d 20 30 3b 20 2a 2f 0a 20 20 70 50 61 67  c = 0; */.  pPag
14ac0 65 72 2d 3e 6e 6f 53 79 6e 63 20 3d 20 70 50 61  er->noSync = pPa
14ad0 67 65 72 2d 3e 74 65 6d 70 46 69 6c 65 20 7c 7c  ger->tempFile ||
14ae0 20 21 75 73 65 4a 6f 75 72 6e 61 6c 3b 0a 20 20   !useJournal;.  
14af0 70 50 61 67 65 72 2d 3e 66 75 6c 6c 53 79 6e 63  pPager->fullSync
14b00 20 3d 20 28 70 50 61 67 65 72 2d 3e 6e 6f 53 79   = (pPager->noSy
14b10 6e 63 3f 30 3a 31 29 3b 0a 20 20 70 50 61 67 65  nc?0:1);.  pPage
14b20 72 2d 3e 73 79 6e 63 5f 66 6c 61 67 73 20 3d 20  r->sync_flags = 
14b30 53 51 4c 49 54 45 5f 53 59 4e 43 5f 4e 4f 52 4d  SQLITE_SYNC_NORM
14b40 41 4c 3b 0a 20 20 2f 2a 20 70 50 61 67 65 72 2d  AL;.  /* pPager-
14b50 3e 70 46 69 72 73 74 20 3d 20 30 3b 20 2a 2f 0a  >pFirst = 0; */.
14b60 20 20 2f 2a 20 70 50 61 67 65 72 2d 3e 70 46 69    /* pPager->pFi
14b70 72 73 74 53 79 6e 63 65 64 20 3d 20 30 3b 20 2a  rstSynced = 0; *
14b80 2f 0a 20 20 2f 2a 20 70 50 61 67 65 72 2d 3e 70  /.  /* pPager->p
14b90 4c 61 73 74 20 3d 20 30 3b 20 2a 2f 0a 20 20 70  Last = 0; */.  p
14ba0 50 61 67 65 72 2d 3e 6e 45 78 74 72 61 20 3d 20  Pager->nExtra = 
14bb0 46 4f 52 43 45 5f 41 4c 49 47 4e 4d 45 4e 54 28  FORCE_ALIGNMENT(
14bc0 6e 45 78 74 72 61 29 3b 0a 20 20 61 73 73 65 72  nExtra);.  asser
14bd0 74 28 70 50 61 67 65 72 2d 3e 66 64 2d 3e 70 4d  t(pPager->fd->pM
14be0 65 74 68 6f 64 73 7c 7c 6d 65 6d 44 62 7c 7c 74  ethods||memDb||t
14bf0 65 6d 70 46 69 6c 65 29 3b 0a 20 20 69 66 28 20  empFile);.  if( 
14c00 21 6d 65 6d 44 62 20 29 7b 0a 20 20 20 20 73 65  !memDb ){.    se
14c10 74 53 65 63 74 6f 72 53 69 7a 65 28 70 50 61 67  tSectorSize(pPag
14c20 65 72 29 3b 0a 20 20 7d 0a 20 20 2f 2a 20 70 50  er);.  }.  /* pP
14c30 61 67 65 72 2d 3e 70 42 75 73 79 48 61 6e 64 6c  ager->pBusyHandl
14c40 65 72 20 3d 20 30 3b 20 2a 2f 0a 20 20 2f 2a 20  er = 0; */.  /* 
14c50 6d 65 6d 73 65 74 28 70 50 61 67 65 72 2d 3e 61  memset(pPager->a
14c60 48 61 73 68 2c 20 30 2c 20 73 69 7a 65 6f 66 28  Hash, 0, sizeof(
14c70 70 50 61 67 65 72 2d 3e 61 48 61 73 68 29 29 3b  pPager->aHash));
14c80 20 2a 2f 0a 20 20 2a 70 70 50 61 67 65 72 20 3d   */.  *ppPager =
14c90 20 70 50 61 67 65 72 3b 0a 23 69 66 64 65 66 20   pPager;.#ifdef 
14ca0 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45 5f 4d 45  SQLITE_ENABLE_ME
14cb0 4d 4f 52 59 5f 4d 41 4e 41 47 45 4d 45 4e 54 0a  MORY_MANAGEMENT.
14cc0 20 20 70 50 61 67 65 72 2d 3e 69 49 6e 55 73 65    pPager->iInUse
14cd0 4d 4d 20 3d 20 30 3b 0a 20 20 70 50 61 67 65 72  MM = 0;.  pPager
14ce0 2d 3e 69 49 6e 55 73 65 44 42 20 3d 20 30 3b 0a  ->iInUseDB = 0;.
14cf0 20 20 69 66 28 20 21 6d 65 6d 44 62 20 29 7b 0a    if( !memDb ){.
14d00 20 20 20 20 73 71 6c 69 74 65 33 5f 6d 75 74 65      sqlite3_mute
14d10 78 20 2a 6d 75 74 65 78 20 3d 20 73 71 6c 69 74  x *mutex = sqlit
14d20 65 33 5f 6d 75 74 65 78 5f 61 6c 6c 6f 63 28 53  e3_mutex_alloc(S
14d30 51 4c 49 54 45 5f 4d 55 54 45 58 5f 53 54 41 54  QLITE_MUTEX_STAT
14d40 49 43 5f 4d 45 4d 32 29 3b 0a 20 20 20 20 73 71  IC_MEM2);.    sq
14d50 6c 69 74 65 33 5f 6d 75 74 65 78 5f 65 6e 74 65  lite3_mutex_ente
14d60 72 28 6d 75 74 65 78 29 3b 0a 20 20 20 20 70 50  r(mutex);.    pP
14d70 61 67 65 72 2d 3e 70 4e 65 78 74 20 3d 20 73 71  ager->pNext = sq
14d80 6c 69 74 65 33 50 61 67 65 72 4c 69 73 74 3b 0a  lite3PagerList;.
14d90 20 20 20 20 69 66 28 20 73 71 6c 69 74 65 33 50      if( sqlite3P
14da0 61 67 65 72 4c 69 73 74 20 29 7b 0a 20 20 20 20  agerList ){.    
14db0 20 20 61 73 73 65 72 74 28 20 73 71 6c 69 74 65    assert( sqlite
14dc0 33 50 61 67 65 72 4c 69 73 74 2d 3e 70 50 72 65  3PagerList->pPre
14dd0 76 3d 3d 30 20 29 3b 0a 20 20 20 20 20 20 73 71  v==0 );.      sq
14de0 6c 69 74 65 33 50 61 67 65 72 4c 69 73 74 2d 3e  lite3PagerList->
14df0 70 50 72 65 76 20 3d 20 70 50 61 67 65 72 3b 0a  pPrev = pPager;.
14e00 20 20 20 20 7d 0a 20 20 20 20 70 50 61 67 65 72      }.    pPager
14e10 2d 3e 70 50 72 65 76 20 3d 20 30 3b 0a 20 20 20  ->pPrev = 0;.   
14e20 20 73 71 6c 69 74 65 33 50 61 67 65 72 4c 69 73   sqlite3PagerLis
14e30 74 20 3d 20 70 50 61 67 65 72 3b 0a 20 20 20 20  t = pPager;.    
14e40 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 6c 65  sqlite3_mutex_le
14e50 61 76 65 28 6d 75 74 65 78 29 3b 0a 20 20 7d 0a  ave(mutex);.  }.
14e60 23 65 6e 64 69 66 0a 20 20 72 65 74 75 72 6e 20  #endif.  return 
14e70 53 51 4c 49 54 45 5f 4f 4b 3b 0a 7d 0a 0a 2f 2a  SQLITE_OK;.}../*
14e80 0a 2a 2a 20 53 65 74 20 74 68 65 20 62 75 73 79  .** Set the busy
14e90 20 68 61 6e 64 6c 65 72 20 66 75 6e 63 74 69 6f   handler functio
14ea0 6e 2e 0a 2a 2f 0a 76 6f 69 64 20 73 71 6c 69 74  n..*/.void sqlit
14eb0 65 33 50 61 67 65 72 53 65 74 42 75 73 79 68 61  e3PagerSetBusyha
14ec0 6e 64 6c 65 72 28 50 61 67 65 72 20 2a 70 50 61  ndler(Pager *pPa
14ed0 67 65 72 2c 20 42 75 73 79 48 61 6e 64 6c 65 72  ger, BusyHandler
14ee0 20 2a 70 42 75 73 79 48 61 6e 64 6c 65 72 29 7b   *pBusyHandler){
14ef0 0a 20 20 70 50 61 67 65 72 2d 3e 70 42 75 73 79  .  pPager->pBusy
14f00 48 61 6e 64 6c 65 72 20 3d 20 70 42 75 73 79 48  Handler = pBusyH
14f10 61 6e 64 6c 65 72 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a  andler;.}../*.**
14f20 20 53 65 74 20 74 68 65 20 64 65 73 74 72 75 63   Set the destruc
14f30 74 6f 72 20 66 6f 72 20 74 68 69 73 20 70 61 67  tor for this pag
14f40 65 72 2e 20 20 49 66 20 6e 6f 74 20 4e 55 4c 4c  er.  If not NULL
14f50 2c 20 74 68 65 20 64 65 73 74 72 75 63 74 6f 72  , the destructor
14f60 20 69 73 20 63 61 6c 6c 65 64 0a 2a 2a 20 77 68   is called.** wh
14f70 65 6e 20 74 68 65 20 72 65 66 65 72 65 6e 63 65  en the reference
14f80 20 63 6f 75 6e 74 20 6f 6e 20 65 61 63 68 20 70   count on each p
14f90 61 67 65 20 72 65 61 63 68 65 73 20 7a 65 72 6f  age reaches zero
14fa0 2e 20 20 54 68 65 20 64 65 73 74 72 75 63 74 6f  .  The destructo
14fb0 72 20 63 61 6e 0a 2a 2a 20 62 65 20 75 73 65 64  r can.** be used
14fc0 20 74 6f 20 63 6c 65 61 6e 20 75 70 20 69 6e 66   to clean up inf
14fd0 6f 72 6d 61 74 69 6f 6e 20 69 6e 20 74 68 65 20  ormation in the 
14fe0 65 78 74 72 61 20 73 65 67 6d 65 6e 74 20 61 70  extra segment ap
14ff0 70 65 6e 64 65 64 20 74 6f 20 65 61 63 68 20 70  pended to each p
15000 61 67 65 2e 0a 2a 2a 0a 2a 2a 20 54 68 65 20 64  age..**.** The d
15010 65 73 74 72 75 63 74 6f 72 20 69 73 20 6e 6f 74  estructor is not
15020 20 63 61 6c 6c 65 64 20 61 73 20 61 20 72 65 73   called as a res
15030 75 6c 74 20 73 71 6c 69 74 65 33 50 61 67 65 72  ult sqlite3Pager
15040 43 6c 6f 73 65 28 29 2e 20 20 0a 2a 2a 20 44 65  Close().  .** De
15050 73 74 72 75 63 74 6f 72 73 20 61 72 65 20 6f 6e  structors are on
15060 6c 79 20 63 61 6c 6c 65 64 20 62 79 20 73 71 6c  ly called by sql
15070 69 74 65 33 50 61 67 65 72 55 6e 72 65 66 28 29  ite3PagerUnref()
15080 2e 0a 2a 2f 0a 76 6f 69 64 20 73 71 6c 69 74 65  ..*/.void sqlite
15090 33 50 61 67 65 72 53 65 74 44 65 73 74 72 75 63  3PagerSetDestruc
150a0 74 6f 72 28 50 61 67 65 72 20 2a 70 50 61 67 65  tor(Pager *pPage
150b0 72 2c 20 76 6f 69 64 20 28 2a 78 44 65 73 63 29  r, void (*xDesc)
150c0 28 44 62 50 61 67 65 2a 2c 69 6e 74 29 29 7b 0a  (DbPage*,int)){.
150d0 20 20 70 50 61 67 65 72 2d 3e 78 44 65 73 74 72    pPager->xDestr
150e0 75 63 74 6f 72 20 3d 20 78 44 65 73 63 3b 0a 7d  uctor = xDesc;.}
150f0 0a 0a 2f 2a 0a 2a 2a 20 53 65 74 20 74 68 65 20  ../*.** Set the 
15100 72 65 69 6e 69 74 69 61 6c 69 7a 65 72 20 66 6f  reinitializer fo
15110 72 20 74 68 69 73 20 70 61 67 65 72 2e 20 20 49  r this pager.  I
15120 66 20 6e 6f 74 20 4e 55 4c 4c 2c 20 74 68 65 20  f not NULL, the 
15130 72 65 69 6e 69 74 69 61 6c 69 7a 65 72 0a 2a 2a  reinitializer.**
15140 20 69 73 20 63 61 6c 6c 65 64 20 77 68 65 6e 20   is called when 
15150 74 68 65 20 63 6f 6e 74 65 6e 74 20 6f 66 20 61  the content of a
15160 20 70 61 67 65 20 69 6e 20 63 61 63 68 65 20 69   page in cache i
15170 73 20 72 65 73 74 6f 72 65 64 20 74 6f 20 69 74  s restored to it
15180 73 20 6f 72 69 67 69 6e 61 6c 0a 2a 2a 20 76 61  s original.** va
15190 6c 75 65 20 61 73 20 61 20 72 65 73 75 6c 74 20  lue as a result 
151a0 6f 66 20 61 20 72 6f 6c 6c 62 61 63 6b 2e 20 20  of a rollback.  
151b0 54 68 65 20 63 61 6c 6c 62 61 63 6b 20 67 69 76  The callback giv
151c0 65 73 20 68 69 67 68 65 72 2d 6c 65 76 65 6c 20  es higher-level 
151d0 63 6f 64 65 0a 2a 2a 20 61 6e 20 6f 70 70 6f 72  code.** an oppor
151e0 74 75 6e 69 74 79 20 74 6f 20 72 65 73 74 6f 72  tunity to restor
151f0 65 20 74 68 65 20 45 58 54 52 41 20 73 65 63 74  e the EXTRA sect
15200 69 6f 6e 20 74 6f 20 61 67 72 65 65 20 77 69 74  ion to agree wit
15210 68 20 74 68 65 20 72 65 73 74 6f 72 65 64 0a 2a  h the restored.*
15220 2a 20 70 61 67 65 20 64 61 74 61 2e 0a 2a 2f 0a  * page data..*/.
15230 76 6f 69 64 20 73 71 6c 69 74 65 33 50 61 67 65  void sqlite3Page
15240 72 53 65 74 52 65 69 6e 69 74 65 72 28 50 61 67  rSetReiniter(Pag
15250 65 72 20 2a 70 50 61 67 65 72 2c 20 76 6f 69 64  er *pPager, void
15260 20 28 2a 78 52 65 69 6e 69 74 29 28 44 62 50 61   (*xReinit)(DbPa
15270 67 65 2a 2c 69 6e 74 29 29 7b 0a 20 20 70 50 61  ge*,int)){.  pPa
15280 67 65 72 2d 3e 78 52 65 69 6e 69 74 65 72 20 3d  ger->xReiniter =
15290 20 78 52 65 69 6e 69 74 3b 0a 7d 0a 0a 2f 2a 0a   xReinit;.}../*.
152a0 2a 2a 20 53 65 74 20 74 68 65 20 70 61 67 65 20  ** Set the page 
152b0 73 69 7a 65 20 74 6f 20 2a 70 50 61 67 65 53 69  size to *pPageSi
152c0 7a 65 2e 20 49 66 20 74 68 65 20 73 75 67 67 65  ze. If the sugge
152d0 73 74 20 6e 65 77 20 70 61 67 65 20 73 69 7a 65  st new page size
152e0 20 69 73 0a 2a 2a 20 69 6e 61 70 70 72 6f 70 72   is.** inappropr
152f0 69 61 74 65 2c 20 74 68 65 6e 20 61 6e 20 61 6c  iate, then an al
15300 74 65 72 6e 61 74 69 76 65 20 70 61 67 65 20 73  ternative page s
15310 69 7a 65 20 69 73 20 73 65 74 20 74 6f 20 74 68  ize is set to th
15320 61 74 0a 2a 2a 20 76 61 6c 75 65 20 62 65 66 6f  at.** value befo
15330 72 65 20 72 65 74 75 72 6e 69 6e 67 2e 0a 2a 2f  re returning..*/
15340 0a 69 6e 74 20 73 71 6c 69 74 65 33 50 61 67 65  .int sqlite3Page
15350 72 53 65 74 50 61 67 65 73 69 7a 65 28 50 61 67  rSetPagesize(Pag
15360 65 72 20 2a 70 50 61 67 65 72 2c 20 75 31 36 20  er *pPager, u16 
15370 2a 70 50 61 67 65 53 69 7a 65 29 7b 0a 20 20 69  *pPageSize){.  i
15380 6e 74 20 72 63 20 3d 20 53 51 4c 49 54 45 5f 4f  nt rc = SQLITE_O
15390 4b 3b 0a 20 20 75 31 36 20 70 61 67 65 53 69 7a  K;.  u16 pageSiz
153a0 65 20 3d 20 2a 70 50 61 67 65 53 69 7a 65 3b 0a  e = *pPageSize;.
153b0 20 20 61 73 73 65 72 74 28 20 70 61 67 65 53 69    assert( pageSi
153c0 7a 65 3d 3d 30 20 7c 7c 20 28 70 61 67 65 53 69  ze==0 || (pageSi
153d0 7a 65 3e 3d 35 31 32 20 26 26 20 70 61 67 65 53  ze>=512 && pageS
153e0 69 7a 65 3c 3d 53 51 4c 49 54 45 5f 4d 41 58 5f  ize<=SQLITE_MAX_
153f0 50 41 47 45 5f 53 49 5a 45 29 20 29 3b 0a 20 20  PAGE_SIZE) );.  
15400 69 66 28 20 70 61 67 65 53 69 7a 65 20 26 26 20  if( pageSize && 
15410 70 61 67 65 53 69 7a 65 21 3d 70 50 61 67 65 72  pageSize!=pPager
15420 2d 3e 70 61 67 65 53 69 7a 65 20 0a 20 20 20 26  ->pageSize .   &
15430 26 20 21 70 50 61 67 65 72 2d 3e 6d 65 6d 44 62  & !pPager->memDb
15440 20 26 26 20 70 50 61 67 65 72 2d 3e 6e 52 65 66   && pPager->nRef
15450 3d 3d 30 20 0a 20 20 29 7b 0a 20 20 20 20 63 68  ==0 .  ){.    ch
15460 61 72 20 2a 70 4e 65 77 20 3d 20 28 63 68 61 72  ar *pNew = (char
15470 20 2a 29 73 71 6c 69 74 65 33 5f 6d 61 6c 6c 6f   *)sqlite3_mallo
15480 63 28 70 61 67 65 53 69 7a 65 29 3b 0a 20 20 20  c(pageSize);.   
15490 20 69 66 28 20 21 70 4e 65 77 20 29 7b 0a 20 20   if( !pNew ){.  
154a0 20 20 20 20 72 63 20 3d 20 53 51 4c 49 54 45 5f      rc = SQLITE_
154b0 4e 4f 4d 45 4d 3b 0a 20 20 20 20 7d 65 6c 73 65  NOMEM;.    }else
154c0 7b 0a 20 20 20 20 20 20 70 61 67 65 72 45 6e 74  {.      pagerEnt
154d0 65 72 28 70 50 61 67 65 72 29 3b 0a 20 20 20 20  er(pPager);.    
154e0 20 20 70 61 67 65 72 5f 72 65 73 65 74 28 70 50    pager_reset(pP
154f0 61 67 65 72 29 3b 0a 20 20 20 20 20 20 70 50 61  ager);.      pPa
15500 67 65 72 2d 3e 70 61 67 65 53 69 7a 65 20 3d 20  ger->pageSize = 
15510 70 61 67 65 53 69 7a 65 3b 0a 20 20 20 20 20 20  pageSize;.      
15520 73 65 74 53 65 63 74 6f 72 53 69 7a 65 28 70 50  setSectorSize(pP
15530 61 67 65 72 29 3b 0a 20 20 20 20 20 20 73 71 6c  ager);.      sql
15540 69 74 65 33 5f 66 72 65 65 28 70 50 61 67 65 72  ite3_free(pPager
15550 2d 3e 70 54 6d 70 53 70 61 63 65 29 3b 0a 20 20  ->pTmpSpace);.  
15560 20 20 20 20 70 50 61 67 65 72 2d 3e 70 54 6d 70      pPager->pTmp
15570 53 70 61 63 65 20 3d 20 70 4e 65 77 3b 0a 20 20  Space = pNew;.  
15580 20 20 20 20 70 61 67 65 72 4c 65 61 76 65 28 70      pagerLeave(p
15590 50 61 67 65 72 29 3b 0a 20 20 20 20 7d 0a 20 20  Pager);.    }.  
155a0 7d 0a 20 20 2a 70 50 61 67 65 53 69 7a 65 20 3d  }.  *pPageSize =
155b0 20 70 50 61 67 65 72 2d 3e 70 61 67 65 53 69 7a   pPager->pageSiz
155c0 65 3b 0a 20 20 72 65 74 75 72 6e 20 72 63 3b 0a  e;.  return rc;.
155d0 7d 0a 0a 2f 2a 0a 2a 2a 20 52 65 74 75 72 6e 20  }../*.** Return 
155e0 61 20 70 6f 69 6e 74 65 72 20 74 6f 20 74 68 65  a pointer to the
155f0 20 22 74 65 6d 70 6f 72 61 72 79 20 70 61 67 65   "temporary page
15600 22 20 62 75 66 66 65 72 20 68 65 6c 64 20 69 6e  " buffer held in
15610 74 65 72 6e 61 6c 6c 79 0a 2a 2a 20 62 79 20 74  ternally.** by t
15620 68 65 20 70 61 67 65 72 2e 20 20 54 68 69 73 20  he pager.  This 
15630 69 73 20 61 20 62 75 66 66 65 72 20 74 68 61 74  is a buffer that
15640 20 69 73 20 62 69 67 20 65 6e 6f 75 67 68 20 74   is big enough t
15650 6f 20 68 6f 6c 64 20 74 68 65 0a 2a 2a 20 65 6e  o hold the.** en
15660 74 69 72 65 20 63 6f 6e 74 65 6e 74 20 6f 66 20  tire content of 
15670 61 20 64 61 74 61 62 61 73 65 20 70 61 67 65 2e  a database page.
15680 20 20 54 68 69 73 20 62 75 66 66 65 72 20 69 73    This buffer is
15690 20 75 73 65 64 20 69 6e 74 65 72 6e 61 6c 6c 79   used internally
156a0 0a 2a 2a 20 64 75 72 69 6e 67 20 72 6f 6c 6c 62  .** during rollb
156b0 61 63 6b 20 61 6e 64 20 77 69 6c 6c 20 62 65 20  ack and will be 
156c0 6f 76 65 72 77 72 69 74 74 65 6e 20 77 68 65 6e  overwritten when
156d0 65 76 65 72 20 61 20 72 6f 6c 6c 62 61 63 6b 0a  ever a rollback.
156e0 2a 2a 20 6f 63 63 75 72 73 2e 20 20 42 75 74 20  ** occurs.  But 
156f0 6f 74 68 65 72 20 6d 6f 64 75 6c 65 73 20 61 72  other modules ar
15700 65 20 66 72 65 65 20 74 6f 20 75 73 65 20 69 74  e free to use it
15710 20 74 6f 6f 2c 20 61 73 20 6c 6f 6e 67 20 61 73   too, as long as
15720 0a 2a 2a 20 6e 6f 20 72 6f 6c 6c 62 61 63 6b 73  .** no rollbacks
15730 20 61 72 65 20 68 61 70 70 65 6e 69 6e 67 2e 0a   are happening..
15740 2a 2f 0a 76 6f 69 64 20 2a 73 71 6c 69 74 65 33  */.void *sqlite3
15750 50 61 67 65 72 54 65 6d 70 53 70 61 63 65 28 50  PagerTempSpace(P
15760 61 67 65 72 20 2a 70 50 61 67 65 72 29 7b 0a 20  ager *pPager){. 
15770 20 72 65 74 75 72 6e 20 70 50 61 67 65 72 2d 3e   return pPager->
15780 70 54 6d 70 53 70 61 63 65 3b 0a 7d 0a 0a 2f 2a  pTmpSpace;.}../*
15790 0a 2a 2a 20 41 74 74 65 6d 70 74 20 74 6f 20 73  .** Attempt to s
157a0 65 74 20 74 68 65 20 6d 61 78 69 6d 75 6d 20 64  et the maximum d
157b0 61 74 61 62 61 73 65 20 70 61 67 65 20 63 6f 75  atabase page cou
157c0 6e 74 20 69 66 20 6d 78 50 61 67 65 20 69 73 20  nt if mxPage is 
157d0 70 6f 73 69 74 69 76 65 2e 20 0a 2a 2a 20 4d 61  positive. .** Ma
157e0 6b 65 20 6e 6f 20 63 68 61 6e 67 65 73 20 69 66  ke no changes if
157f0 20 6d 78 50 61 67 65 20 69 73 20 7a 65 72 6f 20   mxPage is zero 
15800 6f 72 20 6e 65 67 61 74 69 76 65 2e 20 20 41 6e  or negative.  An
15810 64 20 6e 65 76 65 72 20 72 65 64 75 63 65 20 74  d never reduce t
15820 68 65 0a 2a 2a 20 6d 61 78 69 6d 75 6d 20 70 61  he.** maximum pa
15830 67 65 20 63 6f 75 6e 74 20 62 65 6c 6f 77 20 74  ge count below t
15840 68 65 20 63 75 72 72 65 6e 74 20 73 69 7a 65 20  he current size 
15850 6f 66 20 74 68 65 20 64 61 74 61 62 61 73 65 2e  of the database.
15860 0a 2a 2a 0a 2a 2a 20 52 65 67 61 72 64 6c 65 73  .**.** Regardles
15870 73 20 6f 66 20 6d 78 50 61 67 65 2c 20 72 65 74  s of mxPage, ret
15880 75 72 6e 20 74 68 65 20 63 75 72 72 65 6e 74 20  urn the current 
15890 6d 61 78 69 6d 75 6d 20 70 61 67 65 20 63 6f 75  maximum page cou
158a0 6e 74 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74  nt..*/.int sqlit
158b0 65 33 50 61 67 65 72 4d 61 78 50 61 67 65 43 6f  e3PagerMaxPageCo
158c0 75 6e 74 28 50 61 67 65 72 20 2a 70 50 61 67 65  unt(Pager *pPage
158d0 72 2c 20 69 6e 74 20 6d 78 50 61 67 65 29 7b 0a  r, int mxPage){.
158e0 20 20 69 66 28 20 6d 78 50 61 67 65 3e 30 20 29    if( mxPage>0 )
158f0 7b 0a 20 20 20 20 70 50 61 67 65 72 2d 3e 6d 78  {.    pPager->mx
15900 50 67 6e 6f 20 3d 20 6d 78 50 61 67 65 3b 0a 20  Pgno = mxPage;. 
15910 20 7d 0a 20 20 73 71 6c 69 74 65 33 50 61 67 65   }.  sqlite3Page
15920 72 50 61 67 65 63 6f 75 6e 74 28 70 50 61 67 65  rPagecount(pPage
15930 72 29 3b 0a 20 20 72 65 74 75 72 6e 20 70 50 61  r);.  return pPa
15940 67 65 72 2d 3e 6d 78 50 67 6e 6f 3b 0a 7d 0a 0a  ger->mxPgno;.}..
15950 2f 2a 0a 2a 2a 20 54 68 65 20 66 6f 6c 6c 6f 77  /*.** The follow
15960 69 6e 67 20 73 65 74 20 6f 66 20 72 6f 75 74 69  ing set of routi
15970 6e 65 73 20 61 72 65 20 75 73 65 64 20 74 6f 20  nes are used to 
15980 64 69 73 61 62 6c 65 20 74 68 65 20 73 69 6d 75  disable the simu
15990 6c 61 74 65 64 0a 2a 2a 20 49 2f 4f 20 65 72 72  lated.** I/O err
159a0 6f 72 20 6d 65 63 68 61 6e 69 73 6d 2e 20 20 54  or mechanism.  T
159b0 68 65 73 65 20 72 6f 75 74 69 6e 65 73 20 61 72  hese routines ar
159c0 65 20 75 73 65 64 20 74 6f 20 61 76 6f 69 64 20  e used to avoid 
159d0 73 69 6d 75 6c 61 74 65 64 0a 2a 2a 20 65 72 72  simulated.** err
159e0 6f 72 73 20 69 6e 20 70 6c 61 63 65 73 20 77 68  ors in places wh
159f0 65 72 65 20 77 65 20 64 6f 20 6e 6f 74 20 63 61  ere we do not ca
15a00 72 65 20 61 62 6f 75 74 20 65 72 72 6f 72 73 2e  re about errors.
15a10 0a 2a 2a 0a 2a 2a 20 55 6e 6c 65 73 73 20 2d 44  .**.** Unless -D
15a20 53 51 4c 49 54 45 5f 54 45 53 54 3d 31 20 69 73  SQLITE_TEST=1 is
15a30 20 75 73 65 64 2c 20 74 68 65 73 65 20 72 6f 75   used, these rou
15a40 74 69 6e 65 73 20 61 72 65 20 61 6c 6c 20 6e 6f  tines are all no
15a50 2d 6f 70 73 0a 2a 2a 20 61 6e 64 20 67 65 6e 65  -ops.** and gene
15a60 72 61 74 65 20 6e 6f 20 63 6f 64 65 2e 0a 2a 2f  rate no code..*/
15a70 0a 23 69 66 64 65 66 20 53 51 4c 49 54 45 5f 54  .#ifdef SQLITE_T
15a80 45 53 54 0a 65 78 74 65 72 6e 20 69 6e 74 20 73  EST.extern int s
15a90 71 6c 69 74 65 33 5f 69 6f 5f 65 72 72 6f 72 5f  qlite3_io_error_
15aa0 70 65 6e 64 69 6e 67 3b 0a 65 78 74 65 72 6e 20  pending;.extern 
15ab0 69 6e 74 20 73 71 6c 69 74 65 33 5f 69 6f 5f 65  int sqlite3_io_e
15ac0 72 72 6f 72 5f 68 69 74 3b 0a 73 74 61 74 69 63  rror_hit;.static
15ad0 20 69 6e 74 20 73 61 76 65 64 5f 63 6e 74 3b 0a   int saved_cnt;.
15ae0 76 6f 69 64 20 64 69 73 61 62 6c 65 5f 73 69 6d  void disable_sim
15af0 75 6c 61 74 65 64 5f 69 6f 5f 65 72 72 6f 72 73  ulated_io_errors
15b00 28 76 6f 69 64 29 7b 0a 20 20 73 61 76 65 64 5f  (void){.  saved_
15b10 63 6e 74 20 3d 20 73 71 6c 69 74 65 33 5f 69 6f  cnt = sqlite3_io
15b20 5f 65 72 72 6f 72 5f 70 65 6e 64 69 6e 67 3b 0a  _error_pending;.
15b30 20 20 73 71 6c 69 74 65 33 5f 69 6f 5f 65 72 72    sqlite3_io_err
15b40 6f 72 5f 70 65 6e 64 69 6e 67 20 3d 20 2d 31 3b  or_pending = -1;
15b50 0a 7d 0a 76 6f 69 64 20 65 6e 61 62 6c 65 5f 73  .}.void enable_s
15b60 69 6d 75 6c 61 74 65 64 5f 69 6f 5f 65 72 72 6f  imulated_io_erro
15b70 72 73 28 76 6f 69 64 29 7b 0a 20 20 73 71 6c 69  rs(void){.  sqli
15b80 74 65 33 5f 69 6f 5f 65 72 72 6f 72 5f 70 65 6e  te3_io_error_pen
15b90 64 69 6e 67 20 3d 20 73 61 76 65 64 5f 63 6e 74  ding = saved_cnt
15ba0 3b 0a 7d 0a 23 65 6c 73 65 0a 23 20 64 65 66 69  ;.}.#else.# defi
15bb0 6e 65 20 64 69 73 61 62 6c 65 5f 73 69 6d 75 6c  ne disable_simul
15bc0 61 74 65 64 5f 69 6f 5f 65 72 72 6f 72 73 28 29  ated_io_errors()
15bd0 0a 23 20 64 65 66 69 6e 65 20 65 6e 61 62 6c 65  .# define enable
15be0 5f 73 69 6d 75 6c 61 74 65 64 5f 69 6f 5f 65 72  _simulated_io_er
15bf0 72 6f 72 73 28 29 0a 23 65 6e 64 69 66 0a 0a 2f  rors().#endif../
15c00 2a 0a 2a 2a 20 52 65 61 64 20 74 68 65 20 66 69  *.** Read the fi
15c10 72 73 74 20 4e 20 62 79 74 65 73 20 66 72 6f 6d  rst N bytes from
15c20 20 74 68 65 20 62 65 67 69 6e 6e 69 6e 67 20 6f   the beginning o
15c30 66 20 74 68 65 20 66 69 6c 65 20 69 6e 74 6f 20  f the file into 
15c40 6d 65 6d 6f 72 79 0a 2a 2a 20 74 68 61 74 20 70  memory.** that p
15c50 44 65 73 74 20 70 6f 69 6e 74 73 20 74 6f 2e 20  Dest points to. 
15c60 0a 2a 2a 0a 2a 2a 20 4e 6f 20 65 72 72 6f 72 20  .**.** No error 
15c70 63 68 65 63 6b 69 6e 67 20 69 73 20 64 6f 6e 65  checking is done
15c80 2e 20 54 68 65 20 72 61 74 69 6f 6e 61 6c 20 66  . The rational f
15c90 6f 72 20 74 68 69 73 20 69 73 20 74 68 61 74 20  or this is that 
15ca0 74 68 69 73 20 66 75 6e 63 74 69 6f 6e 20 0a 2a  this function .*
15cb0 2a 20 6d 61 79 20 62 65 20 63 61 6c 6c 65 64 20  * may be called 
15cc0 65 76 65 6e 20 69 66 20 74 68 65 20 66 69 6c 65  even if the file
15cd0 20 64 6f 65 73 20 6e 6f 74 20 65 78 69 73 74 20   does not exist 
15ce0 6f 72 20 63 6f 6e 74 61 69 6e 20 61 20 68 65 61  or contain a hea
15cf0 64 65 72 2e 20 49 6e 20 0a 2a 2a 20 74 68 65 73  der. In .** thes
15d00 65 20 63 61 73 65 73 20 73 71 6c 69 74 65 33 4f  e cases sqlite3O
15d10 73 52 65 61 64 28 29 20 77 69 6c 6c 20 72 65 74  sRead() will ret
15d20 75 72 6e 20 61 6e 20 65 72 72 6f 72 2c 20 74 6f  urn an error, to
15d30 20 77 68 69 63 68 20 74 68 65 20 63 6f 72 72 65   which the corre
15d40 63 74 20 0a 2a 2a 20 72 65 73 70 6f 6e 73 65 20  ct .** response 
15d50 69 73 20 74 6f 20 7a 65 72 6f 20 74 68 65 20 6d  is to zero the m
15d60 65 6d 6f 72 79 20 61 74 20 70 44 65 73 74 20 61  emory at pDest a
15d70 6e 64 20 63 6f 6e 74 69 6e 75 65 2e 20 20 41 20  nd continue.  A 
15d80 72 65 61 6c 20 49 4f 20 65 72 72 6f 72 20 0a 2a  real IO error .*
15d90 2a 20 77 69 6c 6c 20 70 72 65 73 75 6d 61 62 6c  * will presumabl
15da0 79 20 72 65 63 75 72 20 61 6e 64 20 62 65 20 70  y recur and be p
15db0 69 63 6b 65 64 20 75 70 20 6c 61 74 65 72 20 28  icked up later (
15dc0 54 6f 64 6f 3a 20 54 68 69 6e 6b 20 61 62 6f 75  Todo: Think abou
15dd0 74 20 74 68 69 73 29 2e 0a 2a 2f 0a 69 6e 74 20  t this)..*/.int 
15de0 73 71 6c 69 74 65 33 50 61 67 65 72 52 65 61 64  sqlite3PagerRead
15df0 46 69 6c 65 68 65 61 64 65 72 28 50 61 67 65 72  Fileheader(Pager
15e00 20 2a 70 50 61 67 65 72 2c 20 69 6e 74 20 4e 2c   *pPager, int N,
15e10 20 75 6e 73 69 67 6e 65 64 20 63 68 61 72 20 2a   unsigned char *
15e20 70 44 65 73 74 29 7b 0a 20 20 69 6e 74 20 72 63  pDest){.  int rc
15e30 20 3d 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20 20   = SQLITE_OK;.  
15e40 6d 65 6d 73 65 74 28 70 44 65 73 74 2c 20 30 2c  memset(pDest, 0,
15e50 20 4e 29 3b 0a 20 20 61 73 73 65 72 74 28 4d 45   N);.  assert(ME
15e60 4d 44 42 7c 7c 70 50 61 67 65 72 2d 3e 66 64 2d  MDB||pPager->fd-
15e70 3e 70 4d 65 74 68 6f 64 73 7c 7c 70 50 61 67 65  >pMethods||pPage
15e80 72 2d 3e 74 65 6d 70 46 69 6c 65 29 3b 0a 20 20  r->tempFile);.  
15e90 69 66 28 20 70 50 61 67 65 72 2d 3e 66 64 2d 3e  if( pPager->fd->
15ea0 70 4d 65 74 68 6f 64 73 20 29 7b 0a 20 20 20 20  pMethods ){.    
15eb0 49 4f 54 52 41 43 45 28 28 22 44 42 48 44 52 20  IOTRACE(("DBHDR 
15ec0 25 70 20 30 20 25 64 5c 6e 22 2c 20 70 50 61 67  %p 0 %d\n", pPag
15ed0 65 72 2c 20 4e 29 29 0a 20 20 20 20 72 63 20 3d  er, N)).    rc =
15ee0 20 73 71 6c 69 74 65 33 4f 73 52 65 61 64 28 70   sqlite3OsRead(p
15ef0 50 61 67 65 72 2d 3e 66 64 2c 20 70 44 65 73 74  Pager->fd, pDest
15f00 2c 20 4e 2c 20 30 29 3b 0a 20 20 20 20 69 66 28  , N, 0);.    if(
15f10 20 72 63 3d 3d 53 51 4c 49 54 45 5f 49 4f 45 52   rc==SQLITE_IOER
15f20 52 5f 53 48 4f 52 54 5f 52 45 41 44 20 29 7b 0a  R_SHORT_READ ){.
15f30 20 20 20 20 20 20 72 63 20 3d 20 53 51 4c 49 54        rc = SQLIT
15f40 45 5f 4f 4b 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a  E_OK;.    }.  }.
15f50 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 7d 0a 0a    return rc;.}..
15f60 2f 2a 0a 2a 2a 20 52 65 74 75 72 6e 20 74 68 65  /*.** Return the
15f70 20 74 6f 74 61 6c 20 6e 75 6d 62 65 72 20 6f 66   total number of
15f80 20 70 61 67 65 73 20 69 6e 20 74 68 65 20 64 69   pages in the di
15f90 73 6b 20 66 69 6c 65 20 61 73 73 6f 63 69 61 74  sk file associat
15fa0 65 64 20 77 69 74 68 0a 2a 2a 20 70 50 61 67 65  ed with.** pPage
15fb0 72 2e 20 0a 2a 2a 0a 2a 2a 20 49 66 20 74 68 65  r. .**.** If the
15fc0 20 50 45 4e 44 49 4e 47 5f 42 59 54 45 20 6c 69   PENDING_BYTE li
15fd0 65 73 20 6f 6e 20 74 68 65 20 70 61 67 65 20 64  es on the page d
15fe0 69 72 65 63 74 6c 79 20 61 66 74 65 72 20 74 68  irectly after th
15ff0 65 20 65 6e 64 20 6f 66 20 74 68 65 0a 2a 2a 20  e end of the.** 
16000 66 69 6c 65 2c 20 74 68 65 6e 20 63 6f 6e 73 69  file, then consi
16010 64 65 72 20 74 68 69 73 20 70 61 67 65 20 70 61  der this page pa
16020 72 74 20 6f 66 20 74 68 65 20 66 69 6c 65 20 74  rt of the file t
16030 6f 6f 2e 20 46 6f 72 20 65 78 61 6d 70 6c 65 2c  oo. For example,
16040 20 69 66 0a 2a 2a 20 50 45 4e 44 49 4e 47 5f 42   if.** PENDING_B
16050 59 54 45 20 69 73 20 62 79 74 65 20 34 30 39 36  YTE is byte 4096
16060 20 28 74 68 65 20 66 69 72 73 74 20 62 79 74 65   (the first byte
16070 20 6f 66 20 70 61 67 65 20 35 29 20 61 6e 64 20   of page 5) and 
16080 74 68 65 20 73 69 7a 65 20 6f 66 20 74 68 65 0a  the size of the.
16090 2a 2a 20 66 69 6c 65 20 69 73 20 34 30 39 36 20  ** file is 4096 
160a0 62 79 74 65 73 2c 20 35 20 69 73 20 72 65 74 75  bytes, 5 is retu
160b0 72 6e 65 64 20 69 6e 73 74 65 61 64 20 6f 66 20  rned instead of 
160c0 34 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65  4..*/.int sqlite
160d0 33 50 61 67 65 72 50 61 67 65 63 6f 75 6e 74 28  3PagerPagecount(
160e0 50 61 67 65 72 20 2a 70 50 61 67 65 72 29 7b 0a  Pager *pPager){.
160f0 20 20 69 36 34 20 6e 20 3d 20 30 3b 0a 20 20 69    i64 n = 0;.  i
16100 6e 74 20 72 63 3b 0a 20 20 61 73 73 65 72 74 28  nt rc;.  assert(
16110 20 70 50 61 67 65 72 21 3d 30 20 29 3b 0a 20 20   pPager!=0 );.  
16120 69 66 28 20 70 50 61 67 65 72 2d 3e 65 72 72 43  if( pPager->errC
16130 6f 64 65 20 29 7b 0a 20 20 20 20 72 65 74 75 72  ode ){.    retur
16140 6e 20 2d 31 3b 0a 20 20 7d 0a 20 20 69 66 28 20  n -1;.  }.  if( 
16150 70 50 61 67 65 72 2d 3e 64 62 53 69 7a 65 3e 3d  pPager->dbSize>=
16160 30 20 29 7b 0a 20 20 20 20 6e 20 3d 20 70 50 61  0 ){.    n = pPa
16170 67 65 72 2d 3e 64 62 53 69 7a 65 3b 0a 20 20 7d  ger->dbSize;.  }
16180 20 65 6c 73 65 20 7b 0a 20 20 20 20 61 73 73 65   else {.    asse
16190 72 74 28 70 50 61 67 65 72 2d 3e 66 64 2d 3e 70  rt(pPager->fd->p
161a0 4d 65 74 68 6f 64 73 7c 7c 70 50 61 67 65 72 2d  Methods||pPager-
161b0 3e 74 65 6d 70 46 69 6c 65 29 3b 0a 20 20 20 20  >tempFile);.    
161c0 69 66 28 20 28 70 50 61 67 65 72 2d 3e 66 64 2d  if( (pPager->fd-
161d0 3e 70 4d 65 74 68 6f 64 73 29 0a 20 20 20 20 20  >pMethods).     
161e0 26 26 20 28 72 63 20 3d 20 73 71 6c 69 74 65 33  && (rc = sqlite3
161f0 4f 73 46 69 6c 65 53 69 7a 65 28 70 50 61 67 65  OsFileSize(pPage
16200 72 2d 3e 66 64 2c 20 26 6e 29 29 21 3d 53 51 4c  r->fd, &n))!=SQL
16210 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 20 20  ITE_OK ){.      
16220 70 50 61 67 65 72 2d 3e 6e 52 65 66 2b 2b 3b 0a  pPager->nRef++;.
16230 20 20 20 20 20 20 70 61 67 65 72 5f 65 72 72 6f        pager_erro
16240 72 28 70 50 61 67 65 72 2c 20 72 63 29 3b 0a 20  r(pPager, rc);. 
16250 20 20 20 20 20 70 50 61 67 65 72 2d 3e 6e 52 65       pPager->nRe
16260 66 2d 2d 3b 0a 20 20 20 20 20 20 72 65 74 75 72  f--;.      retur
16270 6e 20 2d 31 3b 0a 20 20 20 20 7d 0a 20 20 20 20  n -1;.    }.    
16280 69 66 28 20 6e 3e 30 20 26 26 20 6e 3c 70 50 61  if( n>0 && n<pPa
16290 67 65 72 2d 3e 70 61 67 65 53 69 7a 65 20 29 7b  ger->pageSize ){
162a0 0a 20 20 20 20 20 20 6e 20 3d 20 31 3b 0a 20 20  .      n = 1;.  
162b0 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 20 20 6e    }else{.      n
162c0 20 2f 3d 20 70 50 61 67 65 72 2d 3e 70 61 67 65   /= pPager->page
162d0 53 69 7a 65 3b 0a 20 20 20 20 7d 0a 20 20 20 20  Size;.    }.    
162e0 69 66 28 20 70 50 61 67 65 72 2d 3e 73 74 61 74  if( pPager->stat
162f0 65 21 3d 50 41 47 45 52 5f 55 4e 4c 4f 43 4b 20  e!=PAGER_UNLOCK 
16300 29 7b 0a 20 20 20 20 20 20 70 50 61 67 65 72 2d  ){.      pPager-
16310 3e 64 62 53 69 7a 65 20 3d 20 6e 3b 0a 20 20 20  >dbSize = n;.   
16320 20 7d 0a 20 20 7d 0a 20 20 69 66 28 20 6e 3d 3d   }.  }.  if( n==
16330 28 50 45 4e 44 49 4e 47 5f 42 59 54 45 2f 70 50  (PENDING_BYTE/pP
16340 61 67 65 72 2d 3e 70 61 67 65 53 69 7a 65 29 20  ager->pageSize) 
16350 29 7b 0a 20 20 20 20 6e 2b 2b 3b 0a 20 20 7d 0a  ){.    n++;.  }.
16360 20 20 69 66 28 20 6e 3e 70 50 61 67 65 72 2d 3e    if( n>pPager->
16370 6d 78 50 67 6e 6f 20 29 7b 0a 20 20 20 20 70 50  mxPgno ){.    pP
16380 61 67 65 72 2d 3e 6d 78 50 67 6e 6f 20 3d 20 6e  ager->mxPgno = n
16390 3b 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e 20 6e  ;.  }.  return n
163a0 3b 0a 7d 0a 0a 0a 23 69 66 6e 64 65 66 20 53 51  ;.}...#ifndef SQ
163b0 4c 49 54 45 5f 4f 4d 49 54 5f 4d 45 4d 4f 52 59  LITE_OMIT_MEMORY
163c0 44 42 0a 2f 2a 0a 2a 2a 20 43 6c 65 61 72 20 61  DB./*.** Clear a
163d0 20 50 67 48 69 73 74 6f 72 79 20 62 6c 6f 63 6b   PgHistory block
163e0 0a 2a 2f 0a 73 74 61 74 69 63 20 76 6f 69 64 20  .*/.static void 
163f0 63 6c 65 61 72 48 69 73 74 6f 72 79 28 50 67 48  clearHistory(PgH
16400 69 73 74 6f 72 79 20 2a 70 48 69 73 74 29 7b 0a  istory *pHist){.
16410 20 20 73 71 6c 69 74 65 33 5f 66 72 65 65 28 70    sqlite3_free(p
16420 48 69 73 74 2d 3e 70 4f 72 69 67 29 3b 0a 20 20  Hist->pOrig);.  
16430 73 71 6c 69 74 65 33 5f 66 72 65 65 28 70 48 69  sqlite3_free(pHi
16440 73 74 2d 3e 70 53 74 6d 74 29 3b 0a 20 20 70 48  st->pStmt);.  pH
16450 69 73 74 2d 3e 70 4f 72 69 67 20 3d 20 30 3b 0a  ist->pOrig = 0;.
16460 20 20 70 48 69 73 74 2d 3e 70 53 74 6d 74 20 3d    pHist->pStmt =
16470 20 30 3b 0a 7d 0a 23 65 6c 73 65 0a 23 64 65 66   0;.}.#else.#def
16480 69 6e 65 20 63 6c 65 61 72 48 69 73 74 6f 72 79  ine clearHistory
16490 28 78 29 0a 23 65 6e 64 69 66 0a 0a 2f 2a 0a 2a  (x).#endif../*.*
164a0 2a 20 46 6f 72 77 61 72 64 20 64 65 63 6c 61 72  * Forward declar
164b0 61 74 69 6f 6e 0a 2a 2f 0a 73 74 61 74 69 63 20  ation.*/.static 
164c0 69 6e 74 20 73 79 6e 63 4a 6f 75 72 6e 61 6c 28  int syncJournal(
164d0 50 61 67 65 72 2a 29 3b 0a 0a 2f 2a 0a 2a 2a 20  Pager*);../*.** 
164e0 55 6e 6c 69 6e 6b 20 70 50 67 20 66 72 6f 6d 20  Unlink pPg from 
164f0 69 74 73 20 68 61 73 68 20 63 68 61 69 6e 2e 20  its hash chain. 
16500 41 6c 73 6f 20 73 65 74 20 74 68 65 20 70 61 67  Also set the pag
16510 65 20 6e 75 6d 62 65 72 20 74 6f 20 30 20 74 6f  e number to 0 to
16520 20 69 6e 64 69 63 61 74 65 0a 2a 2a 20 74 68 61   indicate.** tha
16530 74 20 74 68 65 20 70 61 67 65 20 69 73 20 6e 6f  t the page is no
16540 74 20 70 61 72 74 20 6f 66 20 61 6e 79 20 68 61  t part of any ha
16550 73 68 20 63 68 61 69 6e 2e 20 54 68 69 73 20 69  sh chain. This i
16560 73 20 72 65 71 75 69 72 65 64 20 62 65 63 61 75  s required becau
16570 73 65 20 74 68 65 0a 2a 2a 20 73 71 6c 69 74 65  se the.** sqlite
16580 33 50 61 67 65 72 4d 6f 76 65 70 61 67 65 28 29  3PagerMovepage()
16590 20 72 6f 75 74 69 6e 65 20 63 61 6e 20 6c 65 61   routine can lea
165a0 76 65 20 61 20 70 61 67 65 20 69 6e 20 74 68 65  ve a page in the
165b0 20 0a 2a 2a 20 70 4e 65 78 74 46 72 65 65 2f 70   .** pNextFree/p
165c0 50 72 65 76 46 72 65 65 20 6c 69 73 74 20 74 68  PrevFree list th
165d0 61 74 20 69 73 20 6e 6f 74 20 61 20 70 61 72 74  at is not a part
165e0 20 6f 66 20 61 6e 79 20 68 61 73 68 2d 63 68 61   of any hash-cha
165f0 69 6e 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 76 6f  in..*/.static vo
16600 69 64 20 75 6e 6c 69 6e 6b 48 61 73 68 43 68 61  id unlinkHashCha
16610 69 6e 28 50 61 67 65 72 20 2a 70 50 61 67 65 72  in(Pager *pPager
16620 2c 20 50 67 48 64 72 20 2a 70 50 67 29 7b 0a 20  , PgHdr *pPg){. 
16630 20 69 66 28 20 70 50 67 2d 3e 70 67 6e 6f 3d 3d   if( pPg->pgno==
16640 30 20 29 7b 0a 20 20 20 20 61 73 73 65 72 74 28  0 ){.    assert(
16650 20 70 50 67 2d 3e 70 4e 65 78 74 48 61 73 68 3d   pPg->pNextHash=
16660 3d 30 20 26 26 20 70 50 67 2d 3e 70 50 72 65 76  =0 && pPg->pPrev
16670 48 61 73 68 3d 3d 30 20 29 3b 0a 20 20 20 20 72  Hash==0 );.    r
16680 65 74 75 72 6e 3b 0a 20 20 7d 0a 20 20 69 66 28  eturn;.  }.  if(
16690 20 70 50 67 2d 3e 70 4e 65 78 74 48 61 73 68 20   pPg->pNextHash 
166a0 29 7b 0a 20 20 20 20 70 50 67 2d 3e 70 4e 65 78  ){.    pPg->pNex
166b0 74 48 61 73 68 2d 3e 70 50 72 65 76 48 61 73 68  tHash->pPrevHash
166c0 20 3d 20 70 50 67 2d 3e 70 50 72 65 76 48 61 73   = pPg->pPrevHas
166d0 68 3b 0a 20 20 7d 0a 20 20 69 66 28 20 70 50 67  h;.  }.  if( pPg
166e0 2d 3e 70 50 72 65 76 48 61 73 68 20 29 7b 0a 20  ->pPrevHash ){. 
166f0 20 20 20 61 73 73 65 72 74 28 20 70 50 61 67 65     assert( pPage
16700 72 2d 3e 61 48 61 73 68 5b 70 50 67 2d 3e 70 67  r->aHash[pPg->pg
16710 6e 6f 20 26 20 28 70 50 61 67 65 72 2d 3e 6e 48  no & (pPager->nH
16720 61 73 68 2d 31 29 5d 21 3d 70 50 67 20 29 3b 0a  ash-1)]!=pPg );.
16730 20 20 20 20 70 50 67 2d 3e 70 50 72 65 76 48 61      pPg->pPrevHa
16740 73 68 2d 3e 70 4e 65 78 74 48 61 73 68 20 3d 20  sh->pNextHash = 
16750 70 50 67 2d 3e 70 4e 65 78 74 48 61 73 68 3b 0a  pPg->pNextHash;.
16760 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 69 6e 74    }else{.    int
16770 20 68 20 3d 20 70 50 67 2d 3e 70 67 6e 6f 20 26   h = pPg->pgno &
16780 20 28 70 50 61 67 65 72 2d 3e 6e 48 61 73 68 2d   (pPager->nHash-
16790 31 29 3b 0a 20 20 20 20 70 50 61 67 65 72 2d 3e  1);.    pPager->
167a0 61 48 61 73 68 5b 68 5d 20 3d 20 70 50 67 2d 3e  aHash[h] = pPg->
167b0 70 4e 65 78 74 48 61 73 68 3b 0a 20 20 7d 0a 20  pNextHash;.  }. 
167c0 20 69 66 28 20 4d 45 4d 44 42 20 29 7b 0a 20 20   if( MEMDB ){.  
167d0 20 20 63 6c 65 61 72 48 69 73 74 6f 72 79 28 50    clearHistory(P
167e0 47 48 44 52 5f 54 4f 5f 48 49 53 54 28 70 50 67  GHDR_TO_HIST(pPg
167f0 2c 20 70 50 61 67 65 72 29 29 3b 0a 20 20 7d 0a  , pPager));.  }.
16800 20 20 70 50 67 2d 3e 70 67 6e 6f 20 3d 20 30 3b    pPg->pgno = 0;
16810 0a 20 20 70 50 67 2d 3e 70 4e 65 78 74 48 61 73  .  pPg->pNextHas
16820 68 20 3d 20 70 50 67 2d 3e 70 50 72 65 76 48 61  h = pPg->pPrevHa
16830 73 68 20 3d 20 30 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a  sh = 0;.}../*.**
16840 20 55 6e 6c 69 6e 6b 20 61 20 70 61 67 65 20 66   Unlink a page f
16850 72 6f 6d 20 74 68 65 20 66 72 65 65 20 6c 69 73  rom the free lis
16860 74 20 28 74 68 65 20 6c 69 73 74 20 6f 66 20 61  t (the list of a
16870 6c 6c 20 70 61 67 65 73 20 77 68 65 72 65 20 6e  ll pages where n
16880 52 65 66 3d 3d 30 29 0a 2a 2a 20 61 6e 64 20 66  Ref==0).** and f
16890 72 6f 6d 20 69 74 73 20 68 61 73 68 20 63 6f 6c  rom its hash col
168a0 6c 69 73 69 6f 6e 20 63 68 61 69 6e 2e 0a 2a 2f  lision chain..*/
168b0 0a 73 74 61 74 69 63 20 76 6f 69 64 20 75 6e 6c  .static void unl
168c0 69 6e 6b 50 61 67 65 28 50 67 48 64 72 20 2a 70  inkPage(PgHdr *p
168d0 50 67 29 7b 0a 20 20 50 61 67 65 72 20 2a 70 50  Pg){.  Pager *pP
168e0 61 67 65 72 20 3d 20 70 50 67 2d 3e 70 50 61 67  ager = pPg->pPag
168f0 65 72 3b 0a 0a 20 20 2f 2a 20 55 6e 6c 69 6e 6b  er;..  /* Unlink
16900 20 66 72 6f 6d 20 66 72 65 65 20 70 61 67 65 20   from free page 
16910 6c 69 73 74 20 2a 2f 0a 20 20 6c 72 75 4c 69 73  list */.  lruLis
16920 74 52 65 6d 6f 76 65 28 70 50 67 29 3b 0a 0a 20  tRemove(pPg);.. 
16930 20 2f 2a 20 55 6e 6c 69 6e 6b 20 66 72 6f 6d 20   /* Unlink from 
16940 74 68 65 20 70 67 6e 6f 20 68 61 73 68 20 74 61  the pgno hash ta
16950 62 6c 65 20 2a 2f 0a 20 20 75 6e 6c 69 6e 6b 48  ble */.  unlinkH
16960 61 73 68 43 68 61 69 6e 28 70 50 61 67 65 72 2c  ashChain(pPager,
16970 20 70 50 67 29 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20   pPg);.}../*.** 
16980 54 68 69 73 20 72 6f 75 74 69 6e 65 20 69 73 20  This routine is 
16990 75 73 65 64 20 74 6f 20 74 72 75 6e 63 61 74 65  used to truncate
169a0 20 74 68 65 20 63 61 63 68 65 20 77 68 65 6e 20   the cache when 
169b0 61 20 64 61 74 61 62 61 73 65 0a 2a 2a 20 69 73  a database.** is
169c0 20 74 72 75 6e 63 61 74 65 64 2e 20 20 44 72 6f   truncated.  Dro
169d0 70 20 66 72 6f 6d 20 74 68 65 20 63 61 63 68 65  p from the cache
169e0 20 61 6c 6c 20 70 61 67 65 73 20 77 68 6f 73 65   all pages whose
169f0 20 70 67 6e 6f 20 69 73 0a 2a 2a 20 6c 61 72 67   pgno is.** larg
16a00 65 72 20 74 68 61 6e 20 70 50 61 67 65 72 2d 3e  er than pPager->
16a10 64 62 53 69 7a 65 20 61 6e 64 20 69 73 20 75 6e  dbSize and is un
16a20 72 65 66 65 72 65 6e 63 65 64 2e 0a 2a 2a 0a 2a  referenced..**.*
16a30 2a 20 52 65 66 65 72 65 6e 63 65 64 20 70 61 67  * Referenced pag
16a40 65 73 20 6c 61 72 67 65 72 20 74 68 61 6e 20 70  es larger than p
16a50 50 61 67 65 72 2d 3e 64 62 53 69 7a 65 20 61 72  Pager->dbSize ar
16a60 65 20 7a 65 72 6f 65 64 2e 0a 2a 2a 0a 2a 2a 20  e zeroed..**.** 
16a70 41 63 74 75 61 6c 6c 79 2c 20 61 74 20 74 68 65  Actually, at the
16a80 20 70 6f 69 6e 74 20 74 68 69 73 20 72 6f 75 74   point this rout
16a90 69 6e 65 20 69 73 20 63 61 6c 6c 65 64 2c 20 69  ine is called, i
16aa0 74 20 77 6f 75 6c 64 20 62 65 0a 2a 2a 20 61 6e  t would be.** an
16ab0 20 65 72 72 6f 72 20 74 6f 20 68 61 76 65 20 61   error to have a
16ac0 20 72 65 66 65 72 65 6e 63 65 64 20 70 61 67 65   referenced page
16ad0 2e 20 20 42 75 74 20 72 61 74 68 65 72 20 74 68  .  But rather th
16ae0 61 6e 20 64 65 6c 65 74 65 0a 2a 2a 20 74 68 61  an delete.** tha
16af0 74 20 70 61 67 65 20 61 6e 64 20 67 75 61 72 61  t page and guara
16b00 6e 74 65 65 20 61 20 73 75 62 73 65 71 75 65 6e  ntee a subsequen
16b10 74 20 73 65 67 66 61 75 6c 74 2c 20 69 74 20 73  t segfault, it s
16b20 65 65 6d 73 20 62 65 74 74 65 72 0a 2a 2a 20 74  eems better.** t
16b30 6f 20 7a 65 72 6f 20 69 74 20 61 6e 64 20 68 6f  o zero it and ho
16b40 70 65 20 74 68 61 74 20 77 65 20 65 72 72 6f 72  pe that we error
16b50 20 6f 75 74 20 73 61 6e 65 6c 79 2e 0a 2a 2f 0a   out sanely..*/.
16b60 73 74 61 74 69 63 20 76 6f 69 64 20 70 61 67 65  static void page
16b70 72 5f 74 72 75 6e 63 61 74 65 5f 63 61 63 68 65  r_truncate_cache
16b80 28 50 61 67 65 72 20 2a 70 50 61 67 65 72 29 7b  (Pager *pPager){
16b90 0a 20 20 50 67 48 64 72 20 2a 70 50 67 3b 0a 20  .  PgHdr *pPg;. 
16ba0 20 50 67 48 64 72 20 2a 2a 70 70 50 67 3b 0a 20   PgHdr **ppPg;. 
16bb0 20 69 6e 74 20 64 62 53 69 7a 65 20 3d 20 70 50   int dbSize = pP
16bc0 61 67 65 72 2d 3e 64 62 53 69 7a 65 3b 0a 0a 20  ager->dbSize;.. 
16bd0 20 70 70 50 67 20 3d 20 26 70 50 61 67 65 72 2d   ppPg = &pPager-
16be0 3e 70 41 6c 6c 3b 0a 20 20 77 68 69 6c 65 28 20  >pAll;.  while( 
16bf0 28 70 50 67 20 3d 20 2a 70 70 50 67 29 21 3d 30  (pPg = *ppPg)!=0
16c00 20 29 7b 0a 20 20 20 20 69 66 28 20 70 50 67 2d   ){.    if( pPg-
16c10 3e 70 67 6e 6f 3c 3d 64 62 53 69 7a 65 20 29 7b  >pgno<=dbSize ){
16c20 0a 20 20 20 20 20 20 70 70 50 67 20 3d 20 26 70  .      ppPg = &p
16c30 50 67 2d 3e 70 4e 65 78 74 41 6c 6c 3b 0a 20 20  Pg->pNextAll;.  
16c40 20 20 7d 65 6c 73 65 20 69 66 28 20 70 50 67 2d    }else if( pPg-
16c50 3e 6e 52 65 66 3e 30 20 29 7b 0a 20 20 20 20 20  >nRef>0 ){.     
16c60 20 6d 65 6d 73 65 74 28 50 47 48 44 52 5f 54 4f   memset(PGHDR_TO
16c70 5f 44 41 54 41 28 70 50 67 29 2c 20 30 2c 20 70  _DATA(pPg), 0, p
16c80 50 61 67 65 72 2d 3e 70 61 67 65 53 69 7a 65 29  Pager->pageSize)
16c90 3b 0a 20 20 20 20 20 20 70 70 50 67 20 3d 20 26  ;.      ppPg = &
16ca0 70 50 67 2d 3e 70 4e 65 78 74 41 6c 6c 3b 0a 20  pPg->pNextAll;. 
16cb0 20 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 20 20     }else{.      
16cc0 2a 70 70 50 67 20 3d 20 70 50 67 2d 3e 70 4e 65  *ppPg = pPg->pNe
16cd0 78 74 41 6c 6c 3b 0a 20 20 20 20 20 20 49 4f 54  xtAll;.      IOT
16ce0 52 41 43 45 28 28 22 50 47 46 52 45 45 20 25 70  RACE(("PGFREE %p
16cf0 20 25 64 5c 6e 22 2c 20 70 50 61 67 65 72 2c 20   %d\n", pPager, 
16d00 70 50 67 2d 3e 70 67 6e 6f 29 29 3b 0a 20 20 20  pPg->pgno));.   
16d10 20 20 20 50 41 47 45 52 5f 49 4e 43 52 28 73 71     PAGER_INCR(sq
16d20 6c 69 74 65 33 5f 70 61 67 65 72 5f 70 67 66 72  lite3_pager_pgfr
16d30 65 65 5f 63 6f 75 6e 74 29 3b 0a 20 20 20 20 20  ee_count);.     
16d40 20 75 6e 6c 69 6e 6b 50 61 67 65 28 70 50 67 29   unlinkPage(pPg)
16d50 3b 0a 20 20 20 20 20 20 6d 61 6b 65 43 6c 65 61  ;.      makeClea
16d60 6e 28 70 50 67 29 3b 0a 20 20 20 20 20 20 73 71  n(pPg);.      sq
16d70 6c 69 74 65 33 5f 66 72 65 65 28 70 50 67 2d 3e  lite3_free(pPg->
16d80 70 44 61 74 61 29 3b 0a 20 20 20 20 20 20 73 71  pData);.      sq
16d90 6c 69 74 65 33 5f 66 72 65 65 28 70 50 67 29 3b  lite3_free(pPg);
16da0 0a 20 20 20 20 20 20 70 50 61 67 65 72 2d 3e 6e  .      pPager->n
16db0 50 61 67 65 2d 2d 3b 0a 20 20 20 20 7d 0a 20 20  Page--;.    }.  
16dc0 7d 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 54 72 79 20 74  }.}../*.** Try t
16dd0 6f 20 6f 62 74 61 69 6e 20 61 20 6c 6f 63 6b 20  o obtain a lock 
16de0 6f 6e 20 61 20 66 69 6c 65 2e 20 20 49 6e 76 6f  on a file.  Invo
16df0 6b 65 20 74 68 65 20 62 75 73 79 20 63 61 6c 6c  ke the busy call
16e00 62 61 63 6b 20 69 66 20 74 68 65 20 6c 6f 63 6b  back if the lock
16e10 0a 2a 2a 20 69 73 20 63 75 72 72 65 6e 74 6c 79  .** is currently
16e20 20 6e 6f 74 20 61 76 61 69 6c 61 62 6c 65 2e 20   not available. 
16e30 20 52 65 70 65 61 74 20 75 6e 74 69 6c 20 74 68   Repeat until th
16e40 65 20 62 75 73 79 20 63 61 6c 6c 62 61 63 6b 20  e busy callback 
16e50 72 65 74 75 72 6e 73 0a 2a 2a 20 66 61 6c 73 65  returns.** false
16e60 20 6f 72 20 75 6e 74 69 6c 20 74 68 65 20 6c 6f   or until the lo
16e70 63 6b 20 73 75 63 63 65 65 64 73 2e 0a 2a 2a 0a  ck succeeds..**.
16e80 2a 2a 20 52 65 74 75 72 6e 20 53 51 4c 49 54 45  ** Return SQLITE
16e90 5f 4f 4b 20 6f 6e 20 73 75 63 63 65 73 73 20 61  _OK on success a
16ea0 6e 64 20 61 6e 20 65 72 72 6f 72 20 63 6f 64 65  nd an error code
16eb0 20 69 66 20 77 65 20 63 61 6e 6e 6f 74 20 6f 62   if we cannot ob
16ec0 74 61 69 6e 0a 2a 2a 20 74 68 65 20 6c 6f 63 6b  tain.** the lock
16ed0 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74 20  ..*/.static int 
16ee0 70 61 67 65 72 5f 77 61 69 74 5f 6f 6e 5f 6c 6f  pager_wait_on_lo
16ef0 63 6b 28 50 61 67 65 72 20 2a 70 50 61 67 65 72  ck(Pager *pPager
16f00 2c 20 69 6e 74 20 6c 6f 63 6b 74 79 70 65 29 7b  , int locktype){
16f10 0a 20 20 69 6e 74 20 72 63 3b 0a 0a 20 20 2f 2a  .  int rc;..  /*
16f20 20 54 68 65 20 4f 53 20 6c 6f 63 6b 20 76 61 6c   The OS lock val
16f30 75 65 73 20 6d 75 73 74 20 62 65 20 74 68 65 20  ues must be the 
16f40 73 61 6d 65 20 61 73 20 74 68 65 20 50 61 67 65  same as the Page
16f50 72 20 6c 6f 63 6b 20 76 61 6c 75 65 73 20 2a 2f  r lock values */
16f60 0a 20 20 61 73 73 65 72 74 28 20 50 41 47 45 52  .  assert( PAGER
16f70 5f 53 48 41 52 45 44 3d 3d 53 48 41 52 45 44 5f  _SHARED==SHARED_
16f80 4c 4f 43 4b 20 29 3b 0a 20 20 61 73 73 65 72 74  LOCK );.  assert
16f90 28 20 50 41 47 45 52 5f 52 45 53 45 52 56 45 44  ( PAGER_RESERVED
16fa0 3d 3d 52 45 53 45 52 56 45 44 5f 4c 4f 43 4b 20  ==RESERVED_LOCK 
16fb0 29 3b 0a 20 20 61 73 73 65 72 74 28 20 50 41 47  );.  assert( PAG
16fc0 45 52 5f 45 58 43 4c 55 53 49 56 45 3d 3d 45 58  ER_EXCLUSIVE==EX
16fd0 43 4c 55 53 49 56 45 5f 4c 4f 43 4b 20 29 3b 0a  CLUSIVE_LOCK );.
16fe0 0a 20 20 2f 2a 20 49 66 20 74 68 65 20 66 69 6c  .  /* If the fil
16ff0 65 20 69 73 20 63 75 72 72 65 6e 74 6c 79 20 75  e is currently u
17000 6e 6c 6f 63 6b 65 64 20 74 68 65 6e 20 74 68 65  nlocked then the
17010 20 73 69 7a 65 20 6d 75 73 74 20 62 65 20 75 6e   size must be un
17020 6b 6e 6f 77 6e 20 2a 2f 0a 20 20 61 73 73 65 72  known */.  asser
17030 74 28 20 70 50 61 67 65 72 2d 3e 73 74 61 74 65  t( pPager->state
17040 3e 3d 50 41 47 45 52 5f 53 48 41 52 45 44 20 7c  >=PAGER_SHARED |
17050 7c 20 70 50 61 67 65 72 2d 3e 64 62 53 69 7a 65  | pPager->dbSize
17060 3c 30 20 7c 7c 20 4d 45 4d 44 42 20 29 3b 0a 0a  <0 || MEMDB );..
17070 20 20 69 66 28 20 70 50 61 67 65 72 2d 3e 73 74    if( pPager->st
17080 61 74 65 3e 3d 6c 6f 63 6b 74 79 70 65 20 29 7b  ate>=locktype ){
17090 0a 20 20 20 20 72 63 20 3d 20 53 51 4c 49 54 45  .    rc = SQLITE
170a0 5f 4f 4b 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20 20  _OK;.  }else{.  
170b0 20 20 69 66 28 20 70 50 61 67 65 72 2d 3e 70 42    if( pPager->pB
170c0 75 73 79 48 61 6e 64 6c 65 72 20 29 20 70 50 61  usyHandler ) pPa
170d0 67 65 72 2d 3e 70 42 75 73 79 48 61 6e 64 6c 65  ger->pBusyHandle
170e0 72 2d 3e 6e 42 75 73 79 20 3d 20 30 3b 0a 20 20  r->nBusy = 0;.  
170f0 20 20 64 6f 20 7b 0a 20 20 20 20 20 20 72 63 20    do {.      rc 
17100 3d 20 73 71 6c 69 74 65 33 4f 73 4c 6f 63 6b 28  = sqlite3OsLock(
17110 70 50 61 67 65 72 2d 3e 66 64 2c 20 6c 6f 63 6b  pPager->fd, lock
17120 74 79 70 65 29 3b 0a 20 20 20 20 7d 77 68 69 6c  type);.    }whil
17130 65 28 20 72 63 3d 3d 53 51 4c 49 54 45 5f 42 55  e( rc==SQLITE_BU
17140 53 59 20 26 26 20 73 71 6c 69 74 65 33 49 6e 76  SY && sqlite3Inv
17150 6f 6b 65 42 75 73 79 48 61 6e 64 6c 65 72 28 70  okeBusyHandler(p
17160 50 61 67 65 72 2d 3e 70 42 75 73 79 48 61 6e 64  Pager->pBusyHand
17170 6c 65 72 29 20 29 3b 0a 20 20 20 20 69 66 28 20  ler) );.    if( 
17180 72 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b  rc==SQLITE_OK ){
17190 0a 20 20 20 20 20 20 70 50 61 67 65 72 2d 3e 73  .      pPager->s
171a0 74 61 74 65 20 3d 20 6c 6f 63 6b 74 79 70 65 3b  tate = locktype;
171b0 0a 20 20 20 20 20 20 49 4f 54 52 41 43 45 28 28  .      IOTRACE((
171c0 22 4c 4f 43 4b 20 25 70 20 25 64 5c 6e 22 2c 20  "LOCK %p %d\n", 
171d0 70 50 61 67 65 72 2c 20 6c 6f 63 6b 74 79 70 65  pPager, locktype
171e0 29 29 0a 20 20 20 20 7d 0a 20 20 7d 0a 20 20 72  )).    }.  }.  r
171f0 65 74 75 72 6e 20 72 63 3b 0a 7d 0a 0a 2f 2a 0a  eturn rc;.}../*.
17200 2a 2a 20 54 72 75 6e 63 61 74 65 20 74 68 65 20  ** Truncate the 
17210 66 69 6c 65 20 74 6f 20 74 68 65 20 6e 75 6d 62  file to the numb
17220 65 72 20 6f 66 20 70 61 67 65 73 20 73 70 65 63  er of pages spec
17230 69 66 69 65 64 2e 0a 2a 2f 0a 69 6e 74 20 73 71  ified..*/.int sq
17240 6c 69 74 65 33 50 61 67 65 72 54 72 75 6e 63 61  lite3PagerTrunca
17250 74 65 28 50 61 67 65 72 20 2a 70 50 61 67 65 72  te(Pager *pPager
17260 2c 20 50 67 6e 6f 20 6e 50 61 67 65 29 7b 0a 20  , Pgno nPage){. 
17270 20 69 6e 74 20 72 63 3b 0a 20 20 61 73 73 65 72   int rc;.  asser
17280 74 28 20 70 50 61 67 65 72 2d 3e 73 74 61 74 65  t( pPager->state
17290 3e 3d 50 41 47 45 52 5f 53 48 41 52 45 44 20 7c  >=PAGER_SHARED |
172a0 7c 20 4d 45 4d 44 42 20 29 3b 0a 20 20 73 71 6c  | MEMDB );.  sql
172b0 69 74 65 33 50 61 67 65 72 50 61 67 65 63 6f 75  ite3PagerPagecou
172c0 6e 74 28 70 50 61 67 65 72 29 3b 0a 20 20 69 66  nt(pPager);.  if
172d0 28 20 70 50 61 67 65 72 2d 3e 65 72 72 43 6f 64  ( pPager->errCod
172e0 65 20 29 7b 0a 20 20 20 20 72 63 20 3d 20 70 50  e ){.    rc = pP
172f0 61 67 65 72 2d 3e 65 72 72 43 6f 64 65 3b 0a 20  ager->errCode;. 
17300 20 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 20 20     return rc;.  
17310 7d 0a 20 20 69 66 28 20 6e 50 61 67 65 3e 3d 28  }.  if( nPage>=(
17320 75 6e 73 69 67 6e 65 64 29 70 50 61 67 65 72 2d  unsigned)pPager-
17330 3e 64 62 53 69 7a 65 20 29 7b 0a 20 20 20 20 72  >dbSize ){.    r
17340 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b  eturn SQLITE_OK;
17350 0a 20 20 7d 0a 20 20 69 66 28 20 4d 45 4d 44 42  .  }.  if( MEMDB
17360 20 29 7b 0a 20 20 20 20 70 50 61 67 65 72 2d 3e   ){.    pPager->
17370 64 62 53 69 7a 65 20 3d 20 6e 50 61 67 65 3b 0a  dbSize = nPage;.
17380 20 20 20 20 70 61 67 65 72 5f 74 72 75 6e 63 61      pager_trunca
17390 74 65 5f 63 61 63 68 65 28 70 50 61 67 65 72 29  te_cache(pPager)
173a0 3b 0a 20 20 20 20 72 65 74 75 72 6e 20 53 51 4c  ;.    return SQL
173b0 49 54 45 5f 4f 4b 3b 0a 20 20 7d 0a 20 20 70 61  ITE_OK;.  }.  pa
173c0 67 65 72 45 6e 74 65 72 28 70 50 61 67 65 72 29  gerEnter(pPager)
173d0 3b 0a 20 20 72 63 20 3d 20 73 79 6e 63 4a 6f 75  ;.  rc = syncJou
173e0 72 6e 61 6c 28 70 50 61 67 65 72 29 3b 0a 20 20  rnal(pPager);.  
173f0 70 61 67 65 72 4c 65 61 76 65 28 70 50 61 67 65  pagerLeave(pPage
17400 72 29 3b 0a 20 20 69 66 28 20 72 63 21 3d 53 51  r);.  if( rc!=SQ
17410 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 72  LITE_OK ){.    r
17420 65 74 75 72 6e 20 72 63 3b 0a 20 20 7d 0a 0a 20  eturn rc;.  }.. 
17430 20 2f 2a 20 47 65 74 20 61 6e 20 65 78 63 6c 75   /* Get an exclu
17440 73 69 76 65 20 6c 6f 63 6b 20 6f 6e 20 74 68 65  sive lock on the
17450 20 64 61 74 61 62 61 73 65 20 62 65 66 6f 72 65   database before
17460 20 74 72 75 6e 63 61 74 69 6e 67 2e 20 2a 2f 0a   truncating. */.
17470 20 20 70 61 67 65 72 45 6e 74 65 72 28 70 50 61    pagerEnter(pPa
17480 67 65 72 29 3b 0a 20 20 72 63 20 3d 20 70 61 67  ger);.  rc = pag
17490 65 72 5f 77 61 69 74 5f 6f 6e 5f 6c 6f 63 6b 28  er_wait_on_lock(
174a0 70 50 61 67 65 72 2c 20 45 58 43 4c 55 53 49 56  pPager, EXCLUSIV
174b0 45 5f 4c 4f 43 4b 29 3b 0a 20 20 70 61 67 65 72  E_LOCK);.  pager
174c0 4c 65 61 76 65 28 70 50 61 67 65 72 29 3b 0a 20  Leave(pPager);. 
174d0 20 69 66 28 20 72 63 21 3d 53 51 4c 49 54 45 5f   if( rc!=SQLITE_
174e0 4f 4b 20 29 7b 0a 20 20 20 20 72 65 74 75 72 6e  OK ){.    return
174f0 20 72 63 3b 0a 20 20 7d 0a 0a 20 20 72 63 20 3d   rc;.  }..  rc =
17500 20 70 61 67 65 72 5f 74 72 75 6e 63 61 74 65 28   pager_truncate(
17510 70 50 61 67 65 72 2c 20 6e 50 61 67 65 29 3b 0a  pPager, nPage);.
17520 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 7d 0a 0a    return rc;.}..
17530 2f 2a 0a 2a 2a 20 53 68 75 74 64 6f 77 6e 20 74  /*.** Shutdown t
17540 68 65 20 70 61 67 65 20 63 61 63 68 65 2e 20 20  he page cache.  
17550 46 72 65 65 20 61 6c 6c 20 6d 65 6d 6f 72 79 20  Free all memory 
17560 61 6e 64 20 63 6c 6f 73 65 20 61 6c 6c 20 66 69  and close all fi
17570 6c 65 73 2e 0a 2a 2a 0a 2a 2a 20 49 66 20 61 20  les..**.** If a 
17580 74 72 61 6e 73 61 63 74 69 6f 6e 20 77 61 73 20  transaction was 
17590 69 6e 20 70 72 6f 67 72 65 73 73 20 77 68 65 6e  in progress when
175a0 20 74 68 69 73 20 72 6f 75 74 69 6e 65 20 69 73   this routine is
175b0 20 63 61 6c 6c 65 64 2c 20 74 68 61 74 0a 2a 2a   called, that.**
175c0 20 74 72 61 6e 73 61 63 74 69 6f 6e 20 69 73 20   transaction is 
175d0 72 6f 6c 6c 65 64 20 62 61 63 6b 2e 20 20 41 6c  rolled back.  Al
175e0 6c 20 6f 75 74 73 74 61 6e 64 69 6e 67 20 70 61  l outstanding pa
175f0 67 65 73 20 61 72 65 20 69 6e 76 61 6c 69 64 61  ges are invalida
17600 74 65 64 0a 2a 2a 20 61 6e 64 20 74 68 65 69 72  ted.** and their
17610 20 6d 65 6d 6f 72 79 20 69 73 20 66 72 65 65 64   memory is freed
17620 2e 20 20 41 6e 79 20 61 74 74 65 6d 70 74 20 74  .  Any attempt t
17630 6f 20 75 73 65 20 61 20 70 61 67 65 20 61 73 73  o use a page ass
17640 6f 63 69 61 74 65 64 0a 2a 2a 20 77 69 74 68 20  ociated.** with 
17650 74 68 69 73 20 70 61 67 65 20 63 61 63 68 65 20  this page cache 
17660 61 66 74 65 72 20 74 68 69 73 20 66 75 6e 63 74  after this funct
17670 69 6f 6e 20 72 65 74 75 72 6e 73 20 77 69 6c 6c  ion returns will
17680 20 6c 69 6b 65 6c 79 0a 2a 2a 20 72 65 73 75 6c   likely.** resul
17690 74 20 69 6e 20 61 20 63 6f 72 65 64 75 6d 70 2e  t in a coredump.
176a0 0a 2a 2a 0a 2a 2a 20 54 68 69 73 20 66 75 6e 63  .**.** This func
176b0 74 69 6f 6e 20 61 6c 77 61 79 73 20 73 75 63 63  tion always succ
176c0 65 65 64 73 2e 20 49 66 20 61 20 74 72 61 6e 73  eeds. If a trans
176d0 61 63 74 69 6f 6e 20 69 73 20 61 63 74 69 76 65  action is active
176e0 20 61 6e 20 61 74 74 65 6d 70 74 0a 2a 2a 20 69   an attempt.** i
176f0 73 20 6d 61 64 65 20 74 6f 20 72 6f 6c 6c 20 69  s made to roll i
17700 74 20 62 61 63 6b 2e 20 49 66 20 61 6e 20 65 72  t back. If an er
17710 72 6f 72 20 6f 63 63 75 72 73 20 64 75 72 69 6e  ror occurs durin
17720 67 20 74 68 65 20 72 6f 6c 6c 62 61 63 6b 20 0a  g the rollback .
17730 2a 2a 20 61 20 68 6f 74 20 6a 6f 75 72 6e 61 6c  ** a hot journal
17740 20 6d 61 79 20 62 65 20 6c 65 66 74 20 69 6e 20   may be left in 
17750 74 68 65 20 66 69 6c 65 73 79 73 74 65 6d 20 62  the filesystem b
17760 75 74 20 6e 6f 20 65 72 72 6f 72 20 69 73 20 72  ut no error is r
17770 65 74 75 72 6e 65 64 0a 2a 2a 20 74 6f 20 74 68  eturned.** to th
17780 65 20 63 61 6c 6c 65 72 2e 0a 2a 2f 0a 69 6e 74  e caller..*/.int
17790 20 73 71 6c 69 74 65 33 50 61 67 65 72 43 6c 6f   sqlite3PagerClo
177a0 73 65 28 50 61 67 65 72 20 2a 70 50 61 67 65 72  se(Pager *pPager
177b0 29 7b 0a 23 69 66 64 65 66 20 53 51 4c 49 54 45  ){.#ifdef SQLITE
177c0 5f 45 4e 41 42 4c 45 5f 4d 45 4d 4f 52 59 5f 4d  _ENABLE_MEMORY_M
177d0 41 4e 41 47 45 4d 45 4e 54 0a 20 20 69 66 28 20  ANAGEMENT.  if( 
177e0 21 4d 45 4d 44 42 20 29 7b 0a 20 20 20 20 73 71  !MEMDB ){.    sq
177f0 6c 69 74 65 33 5f 6d 75 74 65 78 20 2a 6d 75 74  lite3_mutex *mut
17800 65 78 20 3d 20 73 71 6c 69 74 65 33 5f 6d 75 74  ex = sqlite3_mut
17810 65 78 5f 61 6c 6c 6f 63 28 53 51 4c 49 54 45 5f  ex_alloc(SQLITE_
17820 4d 55 54 45 58 5f 53 54 41 54 49 43 5f 4d 45 4d  MUTEX_STATIC_MEM
17830 32 29 3b 0a 20 20 20 20 73 71 6c 69 74 65 33 5f  2);.    sqlite3_
17840 6d 75 74 65 78 5f 65 6e 74 65 72 28 6d 75 74 65  mutex_enter(mute
17850 78 29 3b 0a 20 20 20 20 69 66 28 20 70 50 61 67  x);.    if( pPag
17860 65 72 2d 3e 70 50 72 65 76 20 29 7b 0a 20 20 20  er->pPrev ){.   
17870 20 20 20 70 50 61 67 65 72 2d 3e 70 50 72 65 76     pPager->pPrev
17880 2d 3e 70 4e 65 78 74 20 3d 20 70 50 61 67 65 72  ->pNext = pPager
17890 2d 3e 70 4e 65 78 74 3b 0a 20 20 20 20 7d 65 6c  ->pNext;.    }el
178a0 73 65 7b 0a 20 20 20 20 20 20 73 71 6c 69 74 65  se{.      sqlite
178b0 33 50 61 67 65 72 4c 69 73 74 20 3d 20 70 50 61  3PagerList = pPa
178c0 67 65 72 2d 3e 70 4e 65 78 74 3b 0a 20 20 20 20  ger->pNext;.    
178d0 7d 0a 20 20 20 20 69 66 28 20 70 50 61 67 65 72  }.    if( pPager
178e0 2d 3e 70 4e 65 78 74 20 29 7b 0a 20 20 20 20 20  ->pNext ){.     
178f0 20 70 50 61 67 65 72 2d 3e 70 4e 65 78 74 2d 3e   pPager->pNext->
17900 70 50 72 65 76 20 3d 20 70 50 61 67 65 72 2d 3e  pPrev = pPager->
17910 70 50 72 65 76 3b 0a 20 20 20 20 7d 0a 20 20 20  pPrev;.    }.   
17920 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 6c   sqlite3_mutex_l
17930 65 61 76 65 28 6d 75 74 65 78 29 3b 0a 20 20 7d  eave(mutex);.  }
17940 0a 23 65 6e 64 69 66 0a 0a 20 20 64 69 73 61 62  .#endif..  disab
17950 6c 65 5f 73 69 6d 75 6c 61 74 65 64 5f 69 6f 5f  le_simulated_io_
17960 65 72 72 6f 72 73 28 29 3b 0a 20 20 73 71 6c 69  errors();.  sqli
17970 74 65 33 46 61 75 6c 74 42 65 6e 69 67 6e 28 2d  te3FaultBenign(-
17980 31 2c 20 31 29 3b 0a 20 20 70 50 61 67 65 72 2d  1, 1);.  pPager-
17990 3e 65 72 72 43 6f 64 65 20 3d 20 30 3b 0a 20 20  >errCode = 0;.  
179a0 70 50 61 67 65 72 2d 3e 65 78 63 6c 75 73 69 76  pPager->exclusiv
179b0 65 4d 6f 64 65 20 3d 20 30 3b 0a 20 20 70 61 67  eMode = 0;.  pag
179c0 65 72 5f 72 65 73 65 74 28 70 50 61 67 65 72 29  er_reset(pPager)
179d0 3b 0a 20 20 70 61 67 65 72 55 6e 6c 6f 63 6b 41  ;.  pagerUnlockA
179e0 6e 64 52 6f 6c 6c 62 61 63 6b 28 70 50 61 67 65  ndRollback(pPage
179f0 72 29 3b 0a 20 20 65 6e 61 62 6c 65 5f 73 69 6d  r);.  enable_sim
17a00 75 6c 61 74 65 64 5f 69 6f 5f 65 72 72 6f 72 73  ulated_io_errors
17a10 28 29 3b 0a 20 20 73 71 6c 69 74 65 33 46 61 75  ();.  sqlite3Fau
17a20 6c 74 42 65 6e 69 67 6e 28 2d 31 2c 20 30 29 3b  ltBenign(-1, 0);
17a30 0a 20 20 50 41 47 45 52 54 52 41 43 45 32 28 22  .  PAGERTRACE2("
17a40 43 4c 4f 53 45 20 25 64 5c 6e 22 2c 20 50 41 47  CLOSE %d\n", PAG
17a50 45 52 49 44 28 70 50 61 67 65 72 29 29 3b 0a 20  ERID(pPager));. 
17a60 20 49 4f 54 52 41 43 45 28 28 22 43 4c 4f 53 45   IOTRACE(("CLOSE
17a70 20 25 70 5c 6e 22 2c 20 70 50 61 67 65 72 29 29   %p\n", pPager))
17a80 0a 20 20 69 66 28 20 70 50 61 67 65 72 2d 3e 6a  .  if( pPager->j
17a90 6f 75 72 6e 61 6c 4f 70 65 6e 20 29 7b 0a 20 20  ournalOpen ){.  
17aa0 20 20 73 71 6c 69 74 65 33 4f 73 43 6c 6f 73 65    sqlite3OsClose
17ab0 28 70 50 61 67 65 72 2d 3e 6a 66 64 29 3b 0a 20  (pPager->jfd);. 
17ac0 20 7d 0a 20 20 73 71 6c 69 74 65 33 42 69 74 76   }.  sqlite3Bitv
17ad0 65 63 44 65 73 74 72 6f 79 28 70 50 61 67 65 72  ecDestroy(pPager
17ae0 2d 3e 70 49 6e 4a 6f 75 72 6e 61 6c 29 3b 0a 20  ->pInJournal);. 
17af0 20 69 66 28 20 70 50 61 67 65 72 2d 3e 73 74 6d   if( pPager->stm
17b00 74 4f 70 65 6e 20 29 7b 0a 20 20 20 20 73 71 6c  tOpen ){.    sql
17b10 69 74 65 33 4f 73 43 6c 6f 73 65 28 70 50 61 67  ite3OsClose(pPag
17b20 65 72 2d 3e 73 74 66 64 29 3b 0a 20 20 7d 0a 20  er->stfd);.  }. 
17b30 20 73 71 6c 69 74 65 33 4f 73 43 6c 6f 73 65 28   sqlite3OsClose(
17b40 70 50 61 67 65 72 2d 3e 66 64 29 3b 0a 20 20 2f  pPager->fd);.  /
17b50 2a 20 54 65 6d 70 20 66 69 6c 65 73 20 61 72 65  * Temp files are
17b60 20 61 75 74 6f 6d 61 74 69 63 61 6c 6c 79 20 64   automatically d
17b70 65 6c 65 74 65 64 20 62 79 20 74 68 65 20 4f 53  eleted by the OS
17b80 0a 20 20 2a 2a 20 69 66 28 20 70 50 61 67 65 72  .  ** if( pPager
17b90 2d 3e 74 65 6d 70 46 69 6c 65 20 29 7b 0a 20 20  ->tempFile ){.  
17ba0 2a 2a 20 20 20 73 71 6c 69 74 65 33 4f 73 44 65  **   sqlite3OsDe
17bb0 6c 65 74 65 28 70 50 61 67 65 72 2d 3e 7a 46 69  lete(pPager->zFi
17bc0 6c 65 6e 61 6d 65 29 3b 0a 20 20 2a 2a 20 7d 0a  lename);.  ** }.
17bd0 20 20 2a 2f 0a 0a 20 20 73 71 6c 69 74 65 33 5f    */..  sqlite3_
17be0 66 72 65 65 28 70 50 61 67 65 72 2d 3e 61 48 61  free(pPager->aHa
17bf0 73 68 29 3b 0a 20 20 73 71 6c 69 74 65 33 5f 66  sh);.  sqlite3_f
17c00 72 65 65 28 70 50 61 67 65 72 2d 3e 70 54 6d 70  ree(pPager->pTmp
17c10 53 70 61 63 65 29 3b 0a 20 20 73 71 6c 69 74 65  Space);.  sqlite
17c20 33 5f 66 72 65 65 28 70 50 61 67 65 72 29 3b 0a  3_free(pPager);.
17c30 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f    return SQLITE_
17c40 4f 4b 3b 0a 7d 0a 0a 23 69 66 20 21 64 65 66 69  OK;.}..#if !defi
17c50 6e 65 64 28 4e 44 45 42 55 47 29 20 7c 7c 20 64  ned(NDEBUG) || d
17c60 65 66 69 6e 65 64 28 53 51 4c 49 54 45 5f 54 45  efined(SQLITE_TE
17c70 53 54 29 0a 2f 2a 0a 2a 2a 20 52 65 74 75 72 6e  ST)./*.** Return
17c80 20 74 68 65 20 70 61 67 65 20 6e 75 6d 62 65 72   the page number
17c90 20 66 6f 72 20 74 68 65 20 67 69 76 65 6e 20 70   for the given p
17ca0 61 67 65 20 64 61 74 61 2e 0a 2a 2f 0a 50 67 6e  age data..*/.Pgn
17cb0 6f 20 73 71 6c 69 74 65 33 50 61 67 65 72 50 61  o sqlite3PagerPa
17cc0 67 65 6e 75 6d 62 65 72 28 44 62 50 61 67 65 20  genumber(DbPage 
17cd0 2a 70 29 7b 0a 20 20 72 65 74 75 72 6e 20 70 2d  *p){.  return p-
17ce0 3e 70 67 6e 6f 3b 0a 7d 0a 23 65 6e 64 69 66 0a  >pgno;.}.#endif.
17cf0 0a 2f 2a 0a 2a 2a 20 54 68 65 20 70 61 67 65 5f  ./*.** The page_
17d00 72 65 66 28 29 20 66 75 6e 63 74 69 6f 6e 20 69  ref() function i
17d10 6e 63 72 65 6d 65 6e 74 73 20 74 68 65 20 72 65  ncrements the re
17d20 66 65 72 65 6e 63 65 20 63 6f 75 6e 74 20 66 6f  ference count fo
17d30 72 20 61 20 70 61 67 65 2e 0a 2a 2a 20 49 66 20  r a page..** If 
17d40 74 68 65 20 70 61 67 65 20 69 73 20 63 75 72 72  the page is curr
17d50 65 6e 74 6c 79 20 6f 6e 20 74 68 65 20 66 72 65  ently on the fre
17d60 65 6c 69 73 74 20 28 74 68 65 20 72 65 66 65 72  elist (the refer
17d70 65 6e 63 65 20 63 6f 75 6e 74 20 69 73 20 7a 65  ence count is ze
17d80 72 6f 29 20 74 68 65 6e 0a 2a 2a 20 72 65 6d 6f  ro) then.** remo
17d90 76 65 20 69 74 20 66 72 6f 6d 20 74 68 65 20 66  ve it from the f
17da0 72 65 65 6c 69 73 74 2e 0a 2a 2a 0a 2a 2a 20 46  reelist..**.** F
17db0 6f 72 20 6e 6f 6e 2d 74 65 73 74 20 73 79 73 74  or non-test syst
17dc0 65 6d 73 2c 20 70 61 67 65 5f 72 65 66 28 29 20  ems, page_ref() 
17dd0 69 73 20 61 20 6d 61 63 72 6f 20 74 68 61 74 20  is a macro that 
17de0 63 61 6c 6c 73 20 5f 70 61 67 65 5f 72 65 66 28  calls _page_ref(
17df0 29 0a 2a 2a 20 6f 6e 6c 69 6e 65 20 6f 66 20 74  ).** online of t
17e00 68 65 20 72 65 66 65 72 65 6e 63 65 20 63 6f 75  he reference cou
17e10 6e 74 20 69 73 20 7a 65 72 6f 2e 20 20 46 6f 72  nt is zero.  For
17e20 20 74 65 73 74 20 73 79 73 74 65 6d 73 2c 20 70   test systems, p
17e30 61 67 65 5f 72 65 66 28 29 0a 2a 2a 20 69 73 20  age_ref().** is 
17e40 61 20 72 65 61 6c 20 66 75 6e 63 74 69 6f 6e 20  a real function 
17e50 73 6f 20 74 68 61 74 20 77 65 20 63 61 6e 20 73  so that we can s
17e60 65 74 20 62 72 65 61 6b 70 6f 69 6e 74 73 20 61  et breakpoints a
17e70 6e 64 20 74 72 61 63 65 20 69 74 2e 0a 2a 2f 0a  nd trace it..*/.
17e80 73 74 61 74 69 63 20 76 6f 69 64 20 5f 70 61 67  static void _pag
17e90 65 5f 72 65 66 28 50 67 48 64 72 20 2a 70 50 67  e_ref(PgHdr *pPg
17ea0 29 7b 0a 20 20 69 66 28 20 70 50 67 2d 3e 6e 52  ){.  if( pPg->nR
17eb0 65 66 3d 3d 30 20 29 7b 0a 20 20 20 20 2f 2a 20  ef==0 ){.    /* 
17ec0 54 68 65 20 70 61 67 65 20 69 73 20 63 75 72 72  The page is curr
17ed0 65 6e 74 6c 79 20 6f 6e 20 74 68 65 20 66 72 65  ently on the fre
17ee0 65 6c 69 73 74 2e 20 20 52 65 6d 6f 76 65 20 69  elist.  Remove i
17ef0 74 2e 20 2a 2f 0a 20 20 20 20 6c 72 75 4c 69 73  t. */.    lruLis
17f00 74 52 65 6d 6f 76 65 28 70 50 67 29 3b 0a 20 20  tRemove(pPg);.  
17f10 20 20 70 50 67 2d 3e 70 50 61 67 65 72 2d 3e 6e    pPg->pPager->n
17f20 52 65 66 2b 2b 3b 0a 20 20 7d 0a 20 20 70 50 67  Ref++;.  }.  pPg
17f30 2d 3e 6e 52 65 66 2b 2b 3b 0a 7d 0a 23 69 66 64  ->nRef++;.}.#ifd
17f40 65 66 20 53 51 4c 49 54 45 5f 44 45 42 55 47 0a  ef SQLITE_DEBUG.
17f50 20 20 73 74 61 74 69 63 20 76 6f 69 64 20 70 61    static void pa
17f60 67 65 5f 72 65 66 28 50 67 48 64 72 20 2a 70 50  ge_ref(PgHdr *pP
17f70 67 29 7b 0a 20 20 20 20 69 66 28 20 70 50 67 2d  g){.    if( pPg-
17f80 3e 6e 52 65 66 3d 3d 30 20 29 7b 0a 20 20 20 20  >nRef==0 ){.    
17f90 20 20 5f 70 61 67 65 5f 72 65 66 28 70 50 67 29    _page_ref(pPg)
17fa0 3b 0a 20 20 20 20 7d 65 6c 73 65 7b 0a 20 20 20  ;.    }else{.   
17fb0 20 20 20 70 50 67 2d 3e 6e 52 65 66 2b 2b 3b 0a     pPg->nRef++;.
17fc0 20 20 20 20 7d 0a 20 20 7d 0a 23 65 6c 73 65 0a      }.  }.#else.
17fd0 23 20 64 65 66 69 6e 65 20 70 61 67 65 5f 72 65  # define page_re
17fe0 66 28 50 29 20 20 20 28 28 50 29 2d 3e 6e 52 65  f(P)   ((P)->nRe
17ff0 66 3d 3d 30 3f 5f 70 61 67 65 5f 72 65 66 28 50  f==0?_page_ref(P
18000 29 3a 28 76 6f 69 64 29 28 50 29 2d 3e 6e 52 65  ):(void)(P)->nRe
18010 66 2b 2b 29 0a 23 65 6e 64 69 66 0a 0a 2f 2a 0a  f++).#endif../*.
18020 2a 2a 20 49 6e 63 72 65 6d 65 6e 74 20 74 68 65  ** Increment the
18030 20 72 65 66 65 72 65 6e 63 65 20 63 6f 75 6e 74   reference count
18040 20 66 6f 72 20 61 20 70 61 67 65 2e 20 20 54 68   for a page.  Th
18050 65 20 69 6e 70 75 74 20 70 6f 69 6e 74 65 72 20  e input pointer 
18060 69 73 0a 2a 2a 20 61 20 72 65 66 65 72 65 6e 63  is.** a referenc
18070 65 20 74 6f 20 74 68 65 20 70 61 67 65 20 64 61  e to the page da
18080 74 61 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74  ta..*/.int sqlit
18090 65 33 50 61 67 65 72 52 65 66 28 44 62 50 61 67  e3PagerRef(DbPag
180a0 65 20 2a 70 50 67 29 7b 0a 20 20 70 61 67 65 72  e *pPg){.  pager
180b0 45 6e 74 65 72 28 70 50 67 2d 3e 70 50 61 67 65  Enter(pPg->pPage
180c0 72 29 3b 0a 20 20 70 61 67 65 5f 72 65 66 28 70  r);.  page_ref(p
180d0 50 67 29 3b 0a 20 20 70 61 67 65 72 4c 65 61 76  Pg);.  pagerLeav
180e0 65 28 70 50 67 2d 3e 70 50 61 67 65 72 29 3b 0a  e(pPg->pPager);.
180f0 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f    return SQLITE_
18100 4f 4b 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 53 79 6e  OK;.}../*.** Syn
18110 63 20 74 68 65 20 6a 6f 75 72 6e 61 6c 2e 20 20  c the journal.  
18120 49 6e 20 6f 74 68 65 72 20 77 6f 72 64 73 2c 20  In other words, 
18130 6d 61 6b 65 20 73 75 72 65 20 61 6c 6c 20 74 68  make sure all th
18140 65 20 70 61 67 65 73 20 74 68 61 74 20 68 61 76  e pages that hav
18150 65 0a 2a 2a 20 62 65 65 6e 20 77 72 69 74 74 65  e.** been writte
18160 6e 20 74 6f 20 74 68 65 20 6a 6f 75 72 6e 61 6c  n to the journal
18170 20 68 61 76 65 20 61 63 74 75 61 6c 6c 79 20 72   have actually r
18180 65 61 63 68 65 64 20 74 68 65 20 73 75 72 66 61  eached the surfa
18190 63 65 20 6f 66 20 74 68 65 0a 2a 2a 20 64 69 73  ce of the.** dis
181a0 6b 2e 20 20 49 74 20 69 73 20 6e 6f 74 20 73 61  k.  It is not sa
181b0 66 65 20 74 6f 20 6d 6f 64 69 66 79 20 74 68 65  fe to modify the
181c0 20 6f 72 69 67 69 6e 61 6c 20 64 61 74 61 62 61   original databa
181d0 73 65 20 66 69 6c 65 20 75 6e 74 69 6c 20 61 66  se file until af
181e0 74 65 72 0a 2a 2a 20 74 68 65 20 6a 6f 75 72 6e  ter.** the journ
181f0 61 6c 20 68 61 73 20 62 65 65 6e 20 73 79 6e 63  al has been sync
18200 65 64 2e 20 20 49 66 20 74 68 65 20 6f 72 69 67  ed.  If the orig
18210 69 6e 61 6c 20 64 61 74 61 62 61 73 65 20 69 73  inal database is
18220 20 6d 6f 64 69 66 69 65 64 20 62 65 66 6f 72 65   modified before
18230 0a 2a 2a 20 74 68 65 20 6a 6f 75 72 6e 61 6c 20  .** the journal 
18240 69 73 20 73 79 6e 63 65 64 20 61 6e 64 20 61 20  is synced and a 
18250 70 6f 77 65 72 20 66 61 69 6c 75 72 65 20 6f 63  power failure oc
18260 63 75 72 73 2c 20 74 68 65 20 75 6e 73 79 6e 63  curs, the unsync
18270 65 64 20 6a 6f 75 72 6e 61 6c 0a 2a 2a 20 64 61  ed journal.** da
18280 74 61 20 77 6f 75 6c 64 20 62 65 20 6c 6f 73 74  ta would be lost
18290 20 61 6e 64 20 77 65 20 77 6f 75 6c 64 20 62 65   and we would be
182a0 20 75 6e 61 62 6c 65 20 74 6f 20 63 6f 6d 70 6c   unable to compl
182b0 65 74 65 6c 79 20 72 6f 6c 6c 62 61 63 6b 20 74  etely rollback t
182c0 68 65 0a 2a 2a 20 64 61 74 61 62 61 73 65 20 63  he.** database c
182d0 68 61 6e 67 65 73 2e 20 20 44 61 74 61 62 61 73  hanges.  Databas
182e0 65 20 63 6f 72 72 75 70 74 69 6f 6e 20 77 6f 75  e corruption wou
182f0 6c 64 20 6f 63 63 75 72 2e 0a 2a 2a 20 0a 2a 2a  ld occur..** .**
18300 20 54 68 69 73 20 72 6f 75 74 69 6e 65 20 61 6c   This routine al
18310 73 6f 20 75 70 64 61 74 65 73 20 74 68 65 20 6e  so updates the n
18320 52 65 63 20 66 69 65 6c 64 20 69 6e 20 74 68 65  Rec field in the
18330 20 68 65 61 64 65 72 20 6f 66 20 74 68 65 20 6a   header of the j
18340 6f 75 72 6e 61 6c 2e 0a 2a 2a 20 28 53 65 65 20  ournal..** (See 
18350 63 6f 6d 6d 65 6e 74 73 20 6f 6e 20 74 68 65 20  comments on the 
18360 70 61 67 65 72 5f 70 6c 61 79 62 61 63 6b 28 29  pager_playback()
18370 20 72 6f 75 74 69 6e 65 20 66 6f 72 20 61 64 64   routine for add
18380 69 74 69 6f 6e 61 6c 20 69 6e 66 6f 72 6d 61 74  itional informat
18390 69 6f 6e 2e 29 0a 2a 2a 20 49 66 20 74 68 65 20  ion.).** If the 
183a0 73 79 6e 63 20 6d 6f 64 65 20 69 73 20 46 55 4c  sync mode is FUL
183b0 4c 2c 20 74 77 6f 20 73 79 6e 63 73 20 77 69 6c  L, two syncs wil
183c0 6c 20 6f 63 63 75 72 2e 20 20 46 69 72 73 74 20  l occur.  First 
183d0 74 68 65 20 77 68 6f 6c 65 20 6a 6f 75 72 6e 61  the whole journa
183e0 6c 0a 2a 2a 20 69 73 20 73 79 6e 63 65 64 2c 20  l.** is synced, 
183f0 74 68 65 6e 20 74 68 65 20 6e 52 65 63 20 66 69  then the nRec fi
18400 65 6c 64 20 69 73 20 75 70 64 61 74 65 64 2c 20  eld is updated, 
18410 74 68 65 6e 20 61 20 73 65 63 6f 6e 64 20 73 79  then a second sy
18420 6e 63 20 6f 63 63 75 72 73 2e 0a 2a 2a 0a 2a 2a  nc occurs..**.**
18430 20 46 6f 72 20 74 65 6d 70 6f 72 61 72 79 20 64   For temporary d
18440 61 74 61 62 61 73 65 73 2c 20 77 65 20 64 6f 20  atabases, we do 
18450 6e 6f 74 20 63 61 72 65 20 69 66 20 77 65 20 61  not care if we a
18460 72 65 20 61 62 6c 65 20 74 6f 20 72 6f 6c 6c 62  re able to rollb
18470 61 63 6b 0a 2a 2a 20 61 66 74 65 72 20 61 20 70  ack.** after a p
18480 6f 77 65 72 20 66 61 69 6c 75 72 65 2c 20 73 6f  ower failure, so
18490 20 6e 6f 20 73 79 6e 63 20 6f 63 63 75 72 73 2e   no sync occurs.
184a0 0a 2a 2a 0a 2a 2a 20 49 66 20 74 68 65 20 49 4f  .**.** If the IO
184b0 43 41 50 5f 53 45 51 55 45 4e 54 49 41 4c 20 66  CAP_SEQUENTIAL f
184c0 6c 61 67 20 69 73 20 73 65 74 20 66 6f 72 20 74  lag is set for t
184d0 68 65 20 70 65 72 73 69 73 74 65 6e 74 20 6d 65  he persistent me
184e0 64 69 61 20 6f 6e 20 77 68 69 63 68 0a 2a 2a 20  dia on which.** 
184f0 74 68 65 20 64 61 74 61 62 61 73 65 20 69 73 20  the database is 
18500 73 74 6f 72 65 64 2c 20 74 68 65 6e 20 4f 73 53  stored, then OsS
18510 79 6e 63 28 29 20 69 73 20 6e 65 76 65 72 20 63  ync() is never c
18520 61 6c 6c 65 64 20 6f 6e 20 74 68 65 20 6a 6f 75  alled on the jou
18530 72 6e 61 6c 0a 2a 2a 20 66 69 6c 65 2e 20 49 6e  rnal.** file. In
18540 20 74 68 69 73 20 63 61 73 65 20 61 6c 6c 20 74   this case all t
18550 68 61 74 20 69 73 20 72 65 71 75 69 72 65 64 20  hat is required 
18560 69 73 20 74 6f 20 75 70 64 61 74 65 20 74 68 65  is to update the
18570 20 6e 52 65 63 20 66 69 65 6c 64 20 69 6e 0a 2a   nRec field in.*
18580 2a 20 74 68 65 20 6a 6f 75 72 6e 61 6c 20 68 65  * the journal he
18590 61 64 65 72 2e 0a 2a 2a 0a 2a 2a 20 54 68 69 73  ader..**.** This
185a0 20 72 6f 75 74 69 6e 65 20 63 6c 65 61 72 73 20   routine clears 
185b0 74 68 65 20 6e 65 65 64 53 79 6e 63 20 66 69 65  the needSync fie
185c0 6c 64 20 6f 66 20 65 76 65 72 79 20 70 61 67 65  ld of every page
185d0 20 63 75 72 72 65 6e 74 20 68 65 6c 64 20 69 6e   current held in
185e0 0a 2a 2a 20 6d 65 6d 6f 72 79 2e 0a 2a 2f 0a 73  .** memory..*/.s
185f0 74 61 74 69 63 20 69 6e 74 20 73 79 6e 63 4a 6f  tatic int syncJo
18600 75 72 6e 61 6c 28 50 61 67 65 72 20 2a 70 50 61  urnal(Pager *pPa
18610 67 65 72 29 7b 0a 20 20 50 67 48 64 72 20 2a 70  ger){.  PgHdr *p
18620 50 67 3b 0a 20 20 69 6e 74 20 72 63 20 3d 20 53  Pg;.  int rc = S
18630 51 4c 49 54 45 5f 4f 4b 3b 0a 0a 0a 20 20 2f 2a  QLITE_OK;...  /*
18640 20 53 79 6e 63 20 74 68 65 20 6a 6f 75 72 6e 61   Sync the journa
18650 6c 20 62 65 66 6f 72 65 20 6d 6f 64 69 66 79 69  l before modifyi
18660 6e 67 20 74 68 65 20 6d 61 69 6e 20 64 61 74 61  ng the main data
18670 62 61 73 65 0a 20 20 2a 2a 20 28 61 73 73 75 6d  base.  ** (assum
18680 69 6e 67 20 74 68 65 72 65 20 69 73 20 61 20 6a  ing there is a j
18690 6f 75 72 6e 61 6c 20 61 6e 64 20 69 74 20 6e 65  ournal and it ne
186a0 65 64 73 20 74 6f 20 62 65 20 73 79 6e 63 65 64  eds to be synced
186b0 2e 29 0a 20 20 2a 2f 0a 20 20 69 66 28 20 70 50  .).  */.  if( pP
186c0 61 67 65 72 2d 3e 6e 65 65 64 53 79 6e 63 20 29  ager->needSync )
186d0 7b 0a 20 20 20 20 69 66 28 20 21 70 50 61 67 65  {.    if( !pPage
186e0 72 2d 3e 74 65 6d 70 46 69 6c 65 20 29 7b 0a 20  r->tempFile ){. 
186f0 20 20 20 20 20 69 6e 74 20 69 44 63 20 3d 20 73       int iDc = s
18700 71 6c 69 74 65 33 4f 73 44 65 76 69 63 65 43 68  qlite3OsDeviceCh
18710 61 72 61 63 74 65 72 69 73 74 69 63 73 28 70 50  aracteristics(pP
18720 61 67 65 72 2d 3e 66 64 29 3b 0a 20 20 20 20 20  ager->fd);.     
18730 20 61 73 73 65 72 74 28 20 70 50 61 67 65 72 2d   assert( pPager-
18740 3e 6a 6f 75 72 6e 61 6c 4f 70 65 6e 20 29 3b 0a  >journalOpen );.
18750 0a 20 20 20 20 20 20 69 66 28 20 30 3d 3d 28 69  .      if( 0==(i
18760 44 63 26 53 51 4c 49 54 45 5f 49 4f 43 41 50 5f  Dc&SQLITE_IOCAP_
18770 53 41 46 45 5f 41 50 50 45 4e 44 29 20 29 7b 0a  SAFE_APPEND) ){.
18780 20 20 20 20 20 20 20 20 2f 2a 20 57 72 69 74 65          /* Write
18790 20 74 68 65 20 6e 52 65 63 20 76 61 6c 75 65 20   the nRec value 
187a0 69 6e 74 6f 20 74 68 65 20 6a 6f 75 72 6e 61 6c  into the journal
187b0 20 66 69 6c 65 20 68 65 61 64 65 72 2e 20 49 66   file header. If
187c0 20 69 6e 0a 20 20 20 20 20 20 20 20 2a 2a 20 66   in.        ** f
187d0 75 6c 6c 2d 73 79 6e 63 68 72 6f 6e 6f 75 73 20  ull-synchronous 
187e0 6d 6f 64 65 2c 20 73 79 6e 63 20 74 68 65 20 6a  mode, sync the j
187f0 6f 75 72 6e 61 6c 20 66 69 72 73 74 2e 20 54 68  ournal first. Th
18800 69 73 20 65 6e 73 75 72 65 73 20 74 68 61 74 0a  is ensures that.
18810 20 20 20 20 20 20 20 20 2a 2a 20 61 6c 6c 20 64          ** all d
18820 61 74 61 20 68 61 73 20 72 65 61 6c 6c 79 20 68  ata has really h
18830 69 74 20 74 68 65 20 64 69 73 6b 20 62 65 66 6f  it the disk befo
18840 72 65 20 6e 52 65 63 20 69 73 20 75 70 64 61 74  re nRec is updat
18850 65 64 20 74 6f 20 6d 61 72 6b 0a 20 20 20 20 20  ed to mark.     
18860 20 20 20 2a 2a 20 69 74 20 61 73 20 61 20 63 61     ** it as a ca
18870 6e 64 69 64 61 74 65 20 66 6f 72 20 72 6f 6c 6c  ndidate for roll
18880 62 61 63 6b 2e 0a 20 20 20 20 20 20 20 20 2a 2a  back..        **
18890 0a 20 20 20 20 20 20 20 20 2a 2a 20 54 68 69 73  .        ** This
188a0 20 69 73 20 6e 6f 74 20 72 65 71 75 69 72 65 64   is not required
188b0 20 69 66 20 74 68 65 20 70 65 72 73 69 73 74 65   if the persiste
188c0 6e 74 20 6d 65 64 69 61 20 73 75 70 70 6f 72 74  nt media support
188d0 73 20 74 68 65 0a 20 20 20 20 20 20 20 20 2a 2a  s the.        **
188e0 20 53 41 46 45 5f 41 50 50 45 4e 44 20 70 72 6f   SAFE_APPEND pro
188f0 70 65 72 74 79 2e 20 42 65 63 61 75 73 65 20 69  perty. Because i
18900 6e 20 74 68 69 73 20 63 61 73 65 20 69 74 20 69  n this case it i
18910 73 20 6e 6f 74 20 70 6f 73 73 69 62 6c 65 20 0a  s not possible .
18920 20 20 20 20 20 20 20 20 2a 2a 20 66 6f 72 20 67          ** for g
18930 61 72 62 61 67 65 20 64 61 74 61 20 74 6f 20 62  arbage data to b
18940 65 20 61 70 70 65 6e 64 65 64 20 74 6f 20 74 68  e appended to th
18950 65 20 66 69 6c 65 2c 20 74 68 65 20 6e 52 65 63  e file, the nRec
18960 20 66 69 65 6c 64 0a 20 20 20 20 20 20 20 20 2a   field.        *
18970 2a 20 69 73 20 70 6f 70 75 6c 61 74 65 64 20 77  * is populated w
18980 69 74 68 20 30 78 46 46 46 46 46 46 46 46 20 77  ith 0xFFFFFFFF w
18990 68 65 6e 20 74 68 65 20 6a 6f 75 72 6e 61 6c 20  hen the journal 
189a0 68 65 61 64 65 72 20 69 73 20 77 72 69 74 74 65  header is writte
189b0 6e 0a 20 20 20 20 20 20 20 20 2a 2a 20 61 6e 64  n.        ** and
189c0 20 6e 65 76 65 72 20 6e 65 65 64 73 20 74 6f 20   never needs to 
189d0 62 65 20 75 70 64 61 74 65 64 2e 0a 20 20 20 20  be updated..    
189e0 20 20 20 20 2a 2f 0a 20 20 20 20 20 20 20 20 69      */.        i
189f0 36 34 20 6a 72 6e 6c 4f 66 66 3b 0a 20 20 20 20  64 jrnlOff;.    
18a00 20 20 20 20 69 66 28 20 70 50 61 67 65 72 2d 3e      if( pPager->
18a10 66 75 6c 6c 53 79 6e 63 20 26 26 20 30 3d 3d 28  fullSync && 0==(
18a20 69 44 63 26 53 51 4c 49 54 45 5f 49 4f 43 41 50  iDc&SQLITE_IOCAP
18a30 5f 53 45 51 55 45 4e 54 49 41 4c 29 20 29 7b 0a  _SEQUENTIAL) ){.
18a40 20 20 20 20 20 20 20 20 20 20 50 41 47 45 52 54            PAGERT
18a50 52 41 43 45 32 28 22 53 59 4e 43 20 6a 6f 75 72  RACE2("SYNC jour
18a60 6e 61 6c 20 6f 66 20 25 64 5c 6e 22 2c 20 50 41  nal of %d\n", PA
18a70 47 45 52 49 44 28 70 50 61 67 65 72 29 29 3b 0a  GERID(pPager));.
18a80 20 20 20 20 20 20 20 20 20 20 49 4f 54 52 41 43            IOTRAC
18a90 45 28 28 22 4a 53 59 4e 43 20 25 70 5c 6e 22 2c  E(("JSYNC %p\n",
18aa0 20 70 50 61 67 65 72 29 29 0a 20 20 20 20 20 20   pPager)).      
18ab0 20 20 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33      rc = sqlite3
18ac0 4f 73 53 79 6e 63 28 70 50 61 67 65 72 2d 3e 6a  OsSync(pPager->j
18ad0 66 64 2c 20 70 50 61 67 65 72 2d 3e 73 79 6e 63  fd, pPager->sync
18ae0 5f 66 6c 61 67 73 29 3b 0a 20 20 20 20 20 20 20  _flags);.       
18af0 20 20 20 69 66 28 20 72 63 21 3d 30 20 29 20 72     if( rc!=0 ) r
18b00 65 74 75 72 6e 20 72 63 3b 0a 20 20 20 20 20 20  eturn rc;.      
18b10 20 20 7d 0a 0a 20 20 20 20 20 20 20 20 6a 72 6e    }..        jrn
18b20 6c 4f 66 66 20 3d 20 70 50 61 67 65 72 2d 3e 6a  lOff = pPager->j
18b30 6f 75 72 6e 61 6c 48 64 72 20 2b 20 73 69 7a 65  ournalHdr + size
18b40 6f 66 28 61 4a 6f 75 72 6e 61 6c 4d 61 67 69 63  of(aJournalMagic
18b50 29 3b 0a 20 20 20 20 20 20 20 20 49 4f 54 52 41  );.        IOTRA
18b60 43 45 28 28 22 4a 48 44 52 20 25 70 20 25 6c 6c  CE(("JHDR %p %ll
18b70 64 20 25 64 5c 6e 22 2c 20 70 50 61 67 65 72 2c  d %d\n", pPager,
18b80 20 6a 72 6e 6c 4f 66 66 2c 20 34 29 29 3b 0a 20   jrnlOff, 4));. 
18b90 20 20 20 20 20 20 20 72 63 20 3d 20 77 72 69 74         rc = writ
18ba0 65 33 32 62 69 74 73 28 70 50 61 67 65 72 2d 3e  e32bits(pPager->
18bb0 6a 66 64 2c 20 6a 72 6e 6c 4f 66 66 2c 20 70 50  jfd, jrnlOff, pP
18bc0 61 67 65 72 2d 3e 6e 52 65 63 29 3b 0a 20 20 20  ager->nRec);.   
18bd0 20 20 20 20 20 69 66 28 20 72 63 20 29 20 72 65       if( rc ) re
18be0 74 75 72 6e 20 72 63 3b 0a 20 20 20 20 20 20 7d  turn rc;.      }
18bf0 0a 20 20 20 20 20 20 69 66 28 20 30 3d 3d 28 69  .      if( 0==(i
18c00 44 63 26 53 51 4c 49 54 45 5f 49 4f 43 41 50 5f  Dc&SQLITE_IOCAP_
18c10 53 45 51 55 45 4e 54 49 41 4c 29 20 29 7b 0a 20  SEQUENTIAL) ){. 
18c20 20 20 20 20 20 20 20 50 41 47 45 52 54 52 41 43         PAGERTRAC
18c30 45 32 28 22 53 59 4e 43 20 6a 6f 75 72 6e 61 6c  E2("SYNC journal
18c40 20 6f 66 20 25 64 5c 6e 22 2c 20 50 41 47 45 52   of %d\n", PAGER
18c50 49 44 28 70 50 61 67 65 72 29 29 3b 0a 20 20 20  ID(pPager));.   
18c60 20 20 20 20 20 49 4f 54 52 41 43 45 28 28 22 4a       IOTRACE(("J
18c70 53 59 4e 43 20 25 70 5c 6e 22 2c 20 70 50 61 67  SYNC %p\n", pPag
18c80 65 72 29 29 0a 20 20 20 20 20 20 20 20 72 63 20  er)).        rc 
18c90 3d 20 73 71 6c 69 74 65 33 4f 73 53 79 6e 63 28  = sqlite3OsSync(
18ca0 70 50 61 67 65 72 2d 3e 6a 66 64 2c 20 70 50 61  pPager->jfd, pPa
18cb0 67 65 72 2d 3e 73 79 6e 63 5f 66 6c 61 67 73 7c  ger->sync_flags|
18cc0 20 0a 20 20 20 20 20 20 20 20 20 20 28 70 50 61   .          (pPa
18cd0 67 65 72 2d 3e 73 79 6e 63 5f 66 6c 61 67 73 3d  ger->sync_flags=
18ce0 3d 53 51 4c 49 54 45 5f 53 59 4e 43 5f 46 55 4c  =SQLITE_SYNC_FUL
18cf0 4c 3f 53 51 4c 49 54 45 5f 53 59 4e 43 5f 44 41  L?SQLITE_SYNC_DA
18d00 54 41 4f 4e 4c 59 3a 30 29 0a 20 20 20 20 20 20  TAONLY:0).      
18d10 20 20 29 3b 0a 20 20 20 20 20 20 20 20 69 66 28    );.        if(
18d20 20 72 63 21 3d 30 20 29 20 72 65 74 75 72 6e 20   rc!=0 ) return 
18d30 72 63 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20 20  rc;.      }.    
18d40 20 20 70 50 61 67 65 72 2d 3e 6a 6f 75 72 6e 61    pPager->journa
18d50 6c 53 74 61 72 74 65 64 20 3d 20 31 3b 0a 20 20  lStarted = 1;.  
18d60 20 20 7d 0a 20 20 20 20 70 50 61 67 65 72 2d 3e    }.    pPager->
18d70 6e 65 65 64 53 79 6e 63 20 3d 20 30 3b 0a 0a 20  needSync = 0;.. 
18d80 20 20 20 2f 2a 20 45 72 61 73 65 20 74 68 65 20     /* Erase the 
18d90 6e 65 65 64 53 79 6e 63 20 66 6c 61 67 20 66 72  needSync flag fr
18da0 6f 6d 20 65 76 65 72 79 20 70 61 67 65 2e 0a 20  om every page.. 
18db0 20 20 20 2a 2f 0a 20 20 20 20 66 6f 72 28 70 50     */.    for(pP
18dc0 67 3d 70 50 61 67 65 72 2d 3e 70 41 6c 6c 3b 20  g=pPager->pAll; 
18dd0 70 50 67 3b 20 70 50 67 3d 70 50 67 2d 3e 70 4e  pPg; pPg=pPg->pN
18de0 65 78 74 41 6c 6c 29 7b 0a 20 20 20 20 20 20 70  extAll){.      p
18df0 50 67 2d 3e 6e 65 65 64 53 79 6e 63 20 3d 20 30  Pg->needSync = 0
18e00 3b 0a 20 20 20 20 7d 0a 20 20 20 20 6c 72 75 4c  ;.    }.    lruL
18e10 69 73 74 53 65 74 46 69 72 73 74 53 79 6e 63 65  istSetFirstSynce
18e20 64 28 70 50 61 67 65 72 29 3b 0a 20 20 7d 0a 0a  d(pPager);.  }..
18e30 23 69 66 6e 64 65 66 20 4e 44 45 42 55 47 0a 20  #ifndef NDEBUG. 
18e40 20 2f 2a 20 49 66 20 74 68 65 20 50 61 67 65 72   /* If the Pager
18e50 2e 6e 65 65 64 53 79 6e 63 20 66 6c 61 67 20 69  .needSync flag i
18e60 73 20 63 6c 65 61 72 20 74 68 65 6e 20 74 68 65  s clear then the
18e70 20 50 67 48 64 72 2e 6e 65 65 64 53 79 6e 63 0a   PgHdr.needSync.
18e80 20 20 2a 2a 20 66 6c 61 67 20 6d 75 73 74 20 61    ** flag must a
18e90 6c 73 6f 20 62 65 20 63 6c 65 61 72 20 66 6f 72  lso be clear for
18ea0 20 61 6c 6c 20 70 61 67 65 73 2e 20 20 56 65 72   all pages.  Ver
18eb0 69 66 79 20 74 68 61 74 20 74 68 69 73 0a 20 20  ify that this.  
18ec0 2a 2a 20 69 6e 76 61 72 69 61 6e 74 20 69 73 20  ** invariant is 
18ed0 74 72 75 65 2e 0a 20 20 2a 2f 0a 20 20 65 6c 73  true..  */.  els
18ee0 65 7b 0a 20 20 20 20 66 6f 72 28 70 50 67 3d 70  e{.    for(pPg=p
18ef0 50 61 67 65 72 2d 3e 70 41 6c 6c 3b 20 70 50 67  Pager->pAll; pPg
18f00 3b 20 70 50 67 3d 70 50 67 2d 3e 70 4e 65 78 74  ; pPg=pPg->pNext
18f10 41 6c 6c 29 7b 0a 20 20 20 20 20 20 61 73 73 65  All){.      asse
18f20 72 74 28 20 70 50 67 2d 3e 6e 65 65 64 53 79 6e  rt( pPg->needSyn
18f30 63 3d 3d 30 20 29 3b 0a 20 20 20 20 7d 0a 20 20  c==0 );.    }.  
18f40 20 20 61 73 73 65 72 74 28 20 70 50 61 67 65 72    assert( pPager
18f50 2d 3e 6c 72 75 2e 70 46 69 72 73 74 53 79 6e 63  ->lru.pFirstSync
18f60 65 64 3d 3d 70 50 61 67 65 72 2d 3e 6c 72 75 2e  ed==pPager->lru.
18f70 70 46 69 72 73 74 20 29 3b 0a 20 20 7d 0a 23 65  pFirst );.  }.#e
18f80 6e 64 69 66 0a 0a 20 20 72 65 74 75 72 6e 20 72  ndif..  return r
18f90 63 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 4d 65 72 67  c;.}../*.** Merg
18fa0 65 20 74 77 6f 20 6c 69 73 74 73 20 6f 66 20 70  e two lists of p
18fb0 61 67 65 73 20 63 6f 6e 6e 65 63 74 65 64 20 62  ages connected b
18fc0 79 20 70 44 69 72 74 79 20 61 6e 64 20 69 6e 20  y pDirty and in 
18fd0 70 67 6e 6f 20 6f 72 64 65 72 2e 0a 2a 2a 20 44  pgno order..** D
18fe0 6f 20 6e 6f 74 20 62 6f 74 68 20 66 69 78 69 6e  o not both fixin
18ff0 67 20 74 68 65 20 70 50 72 65 76 44 69 72 74 79  g the pPrevDirty
19000 20 70 6f 69 6e 74 65 72 73 2e 0a 2a 2f 0a 73 74   pointers..*/.st
19010 61 74 69 63 20 50 67 48 64 72 20 2a 6d 65 72 67  atic PgHdr *merg
19020 65 5f 70 61 67 65 6c 69 73 74 28 50 67 48 64 72  e_pagelist(PgHdr
19030 20 2a 70 41 2c 20 50 67 48 64 72 20 2a 70 42 29   *pA, PgHdr *pB)
19040 7b 0a 20 20 50 67 48 64 72 20 72 65 73 75 6c 74  {.  PgHdr result
19050 2c 20 2a 70 54 61 69 6c 3b 0a 20 20 70 54 61 69  , *pTail;.  pTai
19060 6c 20 3d 20 26 72 65 73 75 6c 74 3b 0a 20 20 77  l = &result;.  w
19070 68 69 6c 65 28 20 70 41 20 26 26 20 70 42 20 29  hile( pA && pB )
19080 7b 0a 20 20 20 20 69 66 28 20 70 41 2d 3e 70 67  {.    if( pA->pg
19090 6e 6f 3c 70 42 2d 3e 70 67 6e 6f 20 29 7b 0a 20  no<pB->pgno ){. 
190a0 20 20 20 20 20 70 54 61 69 6c 2d 3e 70 44 69 72       pTail->pDir
190b0 74 79 20 3d 20 70 41 3b 0a 20 20 20 20 20 20 70  ty = pA;.      p
190c0 54 61 69 6c 20 3d 20 70 41 3b 0a 20 20 20 20 20  Tail = pA;.     
190d0 20 70 41 20 3d 20 70 41 2d 3e 70 44 69 72 74 79   pA = pA->pDirty
190e0 3b 0a 20 20 20 20 7d 65 6c 73 65 7b 0a 20 20 20  ;.    }else{.   
190f0 20 20 20 70 54 61 69 6c 2d 3e 70 44 69 72 74 79     pTail->pDirty
19100 20 3d 20 70 42 3b 0a 20 20 20 20 20 20 70 54 61   = pB;.      pTa
19110 69 6c 20 3d 20 70 42 3b 0a 20 20 20 20 20 20 70  il = pB;.      p
19120 42 20 3d 20 70 42 2d 3e 70 44 69 72 74 79 3b 0a  B = pB->pDirty;.
19130 20 20 20 20 7d 0a 20 20 7d 0a 20 20 69 66 28 20      }.  }.  if( 
19140 70 41 20 29 7b 0a 20 20 20 20 70 54 61 69 6c 2d  pA ){.    pTail-
19150 3e 70 44 69 72 74 79 20 3d 20 70 41 3b 0a 20 20  >pDirty = pA;.  
19160 7d 65 6c 73 65 20 69 66 28 20 70 42 20 29 7b 0a  }else if( pB ){.
19170 20 20 20 20 70 54 61 69 6c 2d 3e 70 44 69 72 74      pTail->pDirt
19180 79 20 3d 20 70 42 3b 0a 20 20 7d 65 6c 73 65 7b  y = pB;.  }else{
19190 0a 20 20 20 20 70 54 61 69 6c 2d 3e 70 44 69 72  .    pTail->pDir
191a0 74 79 20 3d 20 30 3b 0a 20 20 7d 0a 20 20 72 65  ty = 0;.  }.  re
191b0 74 75 72 6e 20 72 65 73 75 6c 74 2e 70 44 69 72  turn result.pDir
191c0 74 79 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 53 6f 72  ty;.}../*.** Sor
191d0 74 20 74 68 65 20 6c 69 73 74 20 6f 66 20 70 61  t the list of pa
191e0 67 65 73 20 69 6e 20 61 63 63 65 6e 64 69 6e 67  ges in accending
191f0 20 6f 72 64 65 72 20 62 79 20 70 67 6e 6f 2e 20   order by pgno. 
19200 20 50 61 67 65 73 20 61 72 65 0a 2a 2a 20 63 6f   Pages are.** co
19210 6e 6e 65 63 74 65 64 20 62 79 20 70 44 69 72 74  nnected by pDirt
19220 79 20 70 6f 69 6e 74 65 72 73 2e 20 20 54 68 65  y pointers.  The
19230 20 70 50 72 65 76 44 69 72 74 79 20 70 6f 69 6e   pPrevDirty poin
19240 74 65 72 73 20 61 72 65 0a 2a 2a 20 63 6f 72 72  ters are.** corr
19250 75 70 74 65 64 20 62 79 20 74 68 69 73 20 73 6f  upted by this so
19260 72 74 2e 0a 2a 2f 0a 23 64 65 66 69 6e 65 20 4e  rt..*/.#define N
19270 5f 53 4f 52 54 5f 42 55 43 4b 45 54 5f 41 4c 4c  _SORT_BUCKET_ALL
19280 4f 43 20 32 35 0a 23 64 65 66 69 6e 65 20 4e 5f  OC 25.#define N_
19290 53 4f 52 54 5f 42 55 43 4b 45 54 20 20 20 20 20  SORT_BUCKET     
192a0 20 20 32 35 0a 23 69 66 64 65 66 20 53 51 4c 49    25.#ifdef SQLI
192b0 54 45 5f 54 45 53 54 0a 20 20 69 6e 74 20 73 71  TE_TEST.  int sq
192c0 6c 69 74 65 33 5f 70 61 67 65 72 5f 6e 5f 73 6f  lite3_pager_n_so
192d0 72 74 5f 62 75 63 6b 65 74 20 3d 20 30 3b 0a 20  rt_bucket = 0;. 
192e0 20 23 75 6e 64 65 66 20 4e 5f 53 4f 52 54 5f 42   #undef N_SORT_B
192f0 55 43 4b 45 54 0a 20 20 23 64 65 66 69 6e 65 20  UCKET.  #define 
19300 4e 5f 53 4f 52 54 5f 42 55 43 4b 45 54 20 5c 0a  N_SORT_BUCKET \.
19310 20 20 20 28 73 71 6c 69 74 65 33 5f 70 61 67 65     (sqlite3_page
19320 72 5f 6e 5f 73 6f 72 74 5f 62 75 63 6b 65 74 3f  r_n_sort_bucket?
19330 73 71 6c 69 74 65 33 5f 70 61 67 65 72 5f 6e 5f  sqlite3_pager_n_
19340 73 6f 72 74 5f 62 75 63 6b 65 74 3a 4e 5f 53 4f  sort_bucket:N_SO
19350 52 54 5f 42 55 43 4b 45 54 5f 41 4c 4c 4f 43 29  RT_BUCKET_ALLOC)
19360 0a 23 65 6e 64 69 66 0a 73 74 61 74 69 63 20 50  .#endif.static P
19370 67 48 64 72 20 2a 73 6f 72 74 5f 70 61 67 65 6c  gHdr *sort_pagel
19380 69 73 74 28 50 67 48 64 72 20 2a 70 49 6e 29 7b  ist(PgHdr *pIn){
19390 0a 20 20 50 67 48 64 72 20 2a 61 5b 4e 5f 53 4f  .  PgHdr *a[N_SO
193a0 52 54 5f 42 55 43 4b 45 54 5f 41 4c 4c 4f 43 5d  RT_BUCKET_ALLOC]
193b0 2c 20 2a 70 3b 0a 20 20 69 6e 74 20 69 3b 0a 20  , *p;.  int i;. 
193c0 20 6d 65 6d 73 65 74 28 61 2c 20 30 2c 20 73 69   memset(a, 0, si
193d0 7a 65 6f 66 28 61 29 29 3b 0a 20 20 77 68 69 6c  zeof(a));.  whil
193e0 65 28 20 70 49 6e 20 29 7b 0a 20 20 20 20 70 20  e( pIn ){.    p 
193f0 3d 20 70 49 6e 3b 0a 20 20 20 20 70 49 6e 20 3d  = pIn;.    pIn =
19400 20 70 2d 3e 70 44 69 72 74 79 3b 0a 20 20 20 20   p->pDirty;.    
19410 70 2d 3e 70 44 69 72 74 79 20 3d 20 30 3b 0a 20  p->pDirty = 0;. 
19420 20 20 20 66 6f 72 28 69 3d 30 3b 20 69 3c 4e 5f     for(i=0; i<N_
19430 53 4f 52 54 5f 42 55 43 4b 45 54 2d 31 3b 20 69  SORT_BUCKET-1; i
19440 2b 2b 29 7b 0a 20 20 20 20 20 20 69 66 28 20 61  ++){.      if( a
19450 5b 69 5d 3d 3d 30 20 29 7b 0a 20 20 20 20 20 20  [i]==0 ){.      
19460 20 20 61 5b 69 5d 20 3d 20 70 3b 0a 20 20 20 20    a[i] = p;.    
19470 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 20      break;.     
19480 20 7d 65 6c 73 65 7b 0a 20 20 20 20 20 20 20 20   }else{.        
19490 70 20 3d 20 6d 65 72 67 65 5f 70 61 67 65 6c 69  p = merge_pageli
194a0 73 74 28 61 5b 69 5d 2c 20 70 29 3b 0a 20 20 20  st(a[i], p);.   
194b0 20 20 20 20 20 61 5b 69 5d 20 3d 20 30 3b 0a 20       a[i] = 0;. 
194c0 20 20 20 20 20 7d 0a 20 20 20 20 7d 0a 20 20 20       }.    }.   
194d0 20 69 66 28 20 69 3d 3d 4e 5f 53 4f 52 54 5f 42   if( i==N_SORT_B
194e0 55 43 4b 45 54 2d 31 20 29 7b 0a 20 20 20 20 20  UCKET-1 ){.     
194f0 20 2f 2a 20 43 6f 76 65 72 61 67 65 3a 20 54 6f   /* Coverage: To
19500 20 67 65 74 20 68 65 72 65 2c 20 74 68 65 72 65   get here, there
19510 20 6e 65 65 64 20 74 6f 20 62 65 20 32 5e 28 4e   need to be 2^(N
19520 5f 53 4f 52 54 5f 42 55 43 4b 45 54 29 20 0a 20  _SORT_BUCKET) . 
19530 20 20 20 20 20 2a 2a 20 65 6c 65 6d 65 6e 74 73       ** elements
19540 20 69 6e 20 74 68 65 20 69 6e 70 75 74 20 6c 69   in the input li
19550 73 74 2e 20 54 68 69 73 20 69 73 20 70 6f 73 73  st. This is poss
19560 69 62 6c 65 2c 20 62 75 74 20 69 6d 70 72 61 63  ible, but imprac
19570 74 69 63 61 6c 2e 0a 20 20 20 20 20 20 2a 2a 20  tical..      ** 
19580 54 65 73 74 69 6e 67 20 74 68 69 73 20 6c 69 6e  Testing this lin
19590 65 20 69 73 20 74 68 65 20 70 6f 69 6e 74 20 6f  e is the point o
195a0 66 20 67 6c 6f 62 61 6c 20 76 61 72 69 61 62 6c  f global variabl
195b0 65 0a 20 20 20 20 20 20 2a 2a 20 73 71 6c 69 74  e.      ** sqlit
195c0 65 33 5f 70 61 67 65 72 5f 6e 5f 73 6f 72 74 5f  e3_pager_n_sort_
195d0 62 75 63 6b 65 74 2e 0a 20 20 20 20 20 20 2a 2f  bucket..      */
195e0 0a 20 20 20 20 20 20 61 5b 69 5d 20 3d 20 6d 65  .      a[i] = me
195f0 72 67 65 5f 70 61 67 65 6c 69 73 74 28 61 5b 69  rge_pagelist(a[i
19600 5d 2c 20 70 29 3b 0a 20 20 20 20 7d 0a 20 20 7d  ], p);.    }.  }
19610 0a 20 20 70 20 3d 20 61 5b 30 5d 3b 0a 20 20 66  .  p = a[0];.  f
19620 6f 72 28 69 3d 31 3b 20 69 3c 4e 5f 53 4f 52 54  or(i=1; i<N_SORT
19630 5f 42 55 43 4b 45 54 3b 20 69 2b 2b 29 7b 0a 20  _BUCKET; i++){. 
19640 20 20 20 70 20 3d 20 6d 65 72 67 65 5f 70 61 67     p = merge_pag
19650 65 6c 69 73 74 28 70 2c 20 61 5b 69 5d 29 3b 0a  elist(p, a[i]);.
19660 20 20 7d 0a 20 20 72 65 74 75 72 6e 20 70 3b 0a    }.  return p;.
19670 7d 0a 0a 2f 2a 0a 2a 2a 20 47 69 76 65 6e 20 61  }../*.** Given a
19680 20 6c 69 73 74 20 6f 66 20 70 61 67 65 73 20 28   list of pages (
19690 63 6f 6e 6e 65 63 74 65 64 20 62 79 20 74 68 65  connected by the
196a0 20 50 67 48 64 72 2e 70 44 69 72 74 79 20 70 6f   PgHdr.pDirty po
196b0 69 6e 74 65 72 29 20 77 72 69 74 65 0a 2a 2a 20  inter) write.** 
196c0 65 76 65 72 79 20 6f 6e 65 20 6f 66 20 74 68 6f  every one of tho
196d0 73 65 20 70 61 67 65 73 20 6f 75 74 20 74 6f 20  se pages out to 
196e0 74 68 65 20 64 61 74 61 62 61 73 65 20 66 69 6c  the database fil
196f0 65 20 61 6e 64 20 6d 61 72 6b 20 74 68 65 6d 20  e and mark them 
19700 61 6c 6c 0a 2a 2a 20 61 73 20 63 6c 65 61 6e 2e  all.** as clean.
19710 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74 20 70  .*/.static int p
19720 61 67 65 72 5f 77 72 69 74 65 5f 70 61 67 65 6c  ager_write_pagel
19730 69 73 74 28 50 67 48 64 72 20 2a 70 4c 69 73 74  ist(PgHdr *pList
19740 29 7b 0a 20 20 50 61 67 65 72 20 2a 70 50 61 67  ){.  Pager *pPag
19750 65 72 3b 0a 20 20 50 67 48 64 72 20 2a 70 3b 0a  er;.  PgHdr *p;.
19760 20 20 69 6e 74 20 72 63 3b 0a 0a 20 20 69 66 28    int rc;..  if(
19770 20 70 4c 69 73 74 3d 3d 30 20 29 20 72 65 74 75   pList==0 ) retu
19780 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20 20  rn SQLITE_OK;.  
19790 70 50 61 67 65 72 20 3d 20 70 4c 69 73 74 2d 3e  pPager = pList->
197a0 70 50 61 67 65 72 3b 0a 0a 20 20 2f 2a 20 41 74  pPager;..  /* At
197b0 20 74 68 69 73 20 70 6f 69 6e 74 20 74 68 65 72   this point ther
197c0 65 20 6d 61 79 20 62 65 20 65 69 74 68 65 72 20  e may be either 
197d0 61 20 52 45 53 45 52 56 45 44 20 6f 72 20 45 58  a RESERVED or EX
197e0 43 4c 55 53 49 56 45 20 6c 6f 63 6b 20 6f 6e 20  CLUSIVE lock on 
197f0 74 68 65 0a 20 20 2a 2a 20 64 61 74 61 62 61 73  the.  ** databas
19800 65 20 66 69 6c 65 2e 20 49 66 20 74 68 65 72 65  e file. If there
19810 20 69 73 20 61 6c 72 65 61 64 79 20 61 6e 20 45   is already an E
19820 58 43 4c 55 53 49 56 45 20 6c 6f 63 6b 2c 20 74  XCLUSIVE lock, t
19830 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 0a 20 20 2a  he following.  *
19840 2a 20 63 61 6c 6c 73 20 74 6f 20 73 71 6c 69 74  * calls to sqlit
19850 65 33 4f 73 4c 6f 63 6b 28 29 20 61 72 65 20 6e  e3OsLock() are n
19860 6f 2d 6f 70 73 2e 0a 20 20 2a 2a 0a 20 20 2a 2a  o-ops..  **.  **
19870 20 4d 6f 76 69 6e 67 20 74 68 65 20 6c 6f 63 6b   Moving the lock
19880 20 66 72 6f 6d 20 52 45 53 45 52 56 45 44 20 74   from RESERVED t
19890 6f 20 45 58 43 4c 55 53 49 56 45 20 61 63 74 75  o EXCLUSIVE actu
198a0 61 6c 6c 79 20 69 6e 76 6f 6c 76 65 73 20 67 6f  ally involves go
198b0 69 6e 67 0a 20 20 2a 2a 20 74 68 72 6f 75 67 68  ing.  ** through
198c0 20 61 6e 20 69 6e 74 65 72 6d 65 64 69 61 74 65   an intermediate
198d0 20 73 74 61 74 65 20 50 45 4e 44 49 4e 47 2e 20   state PENDING. 
198e0 20 20 41 20 50 45 4e 44 49 4e 47 20 6c 6f 63 6b    A PENDING lock
198f0 20 70 72 65 76 65 6e 74 73 20 6e 65 77 0a 20 20   prevents new.  
19900 2a 2a 20 72 65 61 64 65 72 73 20 66 72 6f 6d 20  ** readers from 
19910 61 74 74 61 63 68 69 6e 67 20 74 6f 20 74 68 65  attaching to the
19920 20 64 61 74 61 62 61 73 65 20 62 75 74 20 69 73   database but is
19930 20 75 6e 73 75 66 66 69 63 69 65 6e 74 20 66 6f   unsufficient fo
19940 72 20 75 73 20 74 6f 0a 20 20 2a 2a 20 77 72 69  r us to.  ** wri
19950 74 65 2e 20 20 54 68 65 20 69 64 65 61 20 6f 66  te.  The idea of
19960 20 61 20 50 45 4e 44 49 4e 47 20 6c 6f 63 6b 20   a PENDING lock 
19970 69 73 20 74 6f 20 70 72 65 76 65 6e 74 20 6e 65  is to prevent ne
19980 77 20 72 65 61 64 65 72 73 20 66 72 6f 6d 0a 20  w readers from. 
19990 20 2a 2a 20 63 6f 6d 69 6e 67 20 69 6e 20 77 68   ** coming in wh
199a0 69 6c 65 20 77 65 20 77 61 69 74 20 66 6f 72 20  ile we wait for 
199b0 65 78 69 73 74 69 6e 67 20 72 65 61 64 65 72 73  existing readers
199c0 20 74 6f 20 63 6c 65 61 72 2e 0a 20 20 2a 2a 0a   to clear..  **.
199d0 20 20 2a 2a 20 57 68 69 6c 65 20 74 68 65 20 70    ** While the p
199e0 61 67 65 72 20 69 73 20 69 6e 20 74 68 65 20 52  ager is in the R
199f0 45 53 45 52 56 45 44 20 73 74 61 74 65 2c 20 74  ESERVED state, t
19a00 68 65 20 6f 72 69 67 69 6e 61 6c 20 64 61 74 61  he original data
19a10 62 61 73 65 20 66 69 6c 65 0a 20 20 2a 2a 20 69  base file.  ** i
19a20 73 20 75 6e 63 68 61 6e 67 65 64 20 61 6e 64 20  s unchanged and 
19a30 77 65 20 63 61 6e 20 72 6f 6c 6c 62 61 63 6b 20  we can rollback 
19a40 77 69 74 68 6f 75 74 20 68 61 76 69 6e 67 20 74  without having t
19a50 6f 20 70 6c 61 79 62 61 63 6b 20 74 68 65 0a 20  o playback the. 
19a60 20 2a 2a 20 6a 6f 75 72 6e 61 6c 20 69 6e 74 6f   ** journal into
19a70 20 74 68 65 20 6f 72 69 67 69 6e 61 6c 20 64 61   the original da
19a80 74 61 62 61 73 65 20 66 69 6c 65 2e 20 20 4f 6e  tabase file.  On
19a90 63 65 20 77 65 20 74 72 61 6e 73 69 74 69 6f 6e  ce we transition
19aa0 20 74 6f 0a 20 20 2a 2a 20 45 58 43 4c 55 53 49   to.  ** EXCLUSI
19ab0 56 45 2c 20 69 74 20 6d 65 61 6e 73 20 74 68 65  VE, it means the
19ac0 20 64 61 74 61 62 61 73 65 20 66 69 6c 65 20 68   database file h
19ad0 61 73 20 62 65 65 6e 20 63 68 61 6e 67 65 64 20  as been changed 
19ae0 61 6e 64 20 61 6e 79 20 72 6f 6c 6c 62 61 63 6b  and any rollback
19af0 0a 20 20 2a 2a 20 77 69 6c 6c 20 72 65 71 75 69  .  ** will requi
19b00 72 65 20 61 20 6a 6f 75 72 6e 61 6c 20 70 6c 61  re a journal pla
19b10 79 62 61 63 6b 2e 0a 20 20 2a 2f 0a 20 20 72 63  yback..  */.  rc
19b20 20 3d 20 70 61 67 65 72 5f 77 61 69 74 5f 6f 6e   = pager_wait_on
19b30 5f 6c 6f 63 6b 28 70 50 61 67 65 72 2c 20 45 58  _lock(pPager, EX
19b40 43 4c 55 53 49 56 45 5f 4c 4f 43 4b 29 3b 0a 20  CLUSIVE_LOCK);. 
19b50 20 69 66 28 20 72 63 21 3d 53 51 4c 49 54 45 5f   if( rc!=SQLITE_
19b60 4f 4b 20 29 7b 0a 20 20 20 20 72 65 74 75 72 6e  OK ){.    return
19b70 20 72 63 3b 0a 20 20 7d 0a 0a 20 20 70 4c 69 73   rc;.  }..  pLis
19b80 74 20 3d 20 73 6f 72 74 5f 70 61 67 65 6c 69 73  t = sort_pagelis
19b90 74 28 70 4c 69 73 74 29 3b 0a 20 20 66 6f 72 28  t(pList);.  for(
19ba0 70 3d 70 4c 69 73 74 3b 20 70 3b 20 70 3d 70 2d  p=pList; p; p=p-
19bb0 3e 70 44 69 72 74 79 29 7b 0a 20 20 20 20 61 73  >pDirty){.    as
19bc0 73 65 72 74 28 20 70 2d 3e 64 69 72 74 79 20 29  sert( p->dirty )
19bd0 3b 0a 20 20 20 20 70 2d 3e 64 69 72 74 79 20 3d  ;.    p->dirty =
19be0 20 30 3b 0a 20 20 7d 0a 20 20 77 68 69 6c 65 28   0;.  }.  while(
19bf0 20 70 4c 69 73 74 20 29 7b 0a 0a 20 20 20 20 2f   pList ){..    /
19c00 2a 20 49 66 20 74 68 65 20 66 69 6c 65 20 68 61  * If the file ha
19c10 73 20 6e 6f 74 20 79 65 74 20 62 65 65 6e 20 6f  s not yet been o
19c20 70 65 6e 65 64 2c 20 6f 70 65 6e 20 69 74 20 6e  pened, open it n
19c30 6f 77 2e 20 2a 2f 0a 20 20 20 20 69 66 28 20 21  ow. */.    if( !
19c40 70 50 61 67 65 72 2d 3e 66 64 2d 3e 70 4d 65 74  pPager->fd->pMet
19c50 68 6f 64 73 20 29 7b 0a 20 20 20 20 20 20 61 73  hods ){.      as
19c60 73 65 72 74 28 70 50 61 67 65 72 2d 3e 74 65 6d  sert(pPager->tem
19c70 70 46 69 6c 65 29 3b 0a 20 20 20 20 20 20 72 63  pFile);.      rc
19c80 20 3d 20 73 71 6c 69 74 65 33 50 61 67 65 72 4f   = sqlite3PagerO
19c90 70 65 6e 74 65 6d 70 28 70 50 61 67 65 72 2d 3e  pentemp(pPager->
19ca0 70 56 66 73 2c 20 70 50 61 67 65 72 2d 3e 66 64  pVfs, pPager->fd
19cb0 2c 20 70 50 61 67 65 72 2d 3e 7a 46 69 6c 65 6e  , pPager->zFilen
19cc0 61 6d 65 2c 0a 20 20 20 20 20 20 20 20 20 20 20  ame,.           
19cd0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
19ce0 20 20 20 20 20 70 50 61 67 65 72 2d 3e 76 66 73       pPager->vfs
19cf0 46 6c 61 67 73 29 3b 0a 20 20 20 20 20 20 69 66  Flags);.      if
19d00 28 20 72 63 20 29 20 72 65 74 75 72 6e 20 72 63  ( rc ) return rc
19d10 3b 0a 20 20 20 20 7d 0a 0a 20 20 20 20 2f 2a 20  ;.    }..    /* 
19d20 49 66 20 74 68 65 72 65 20 61 72 65 20 64 69 72  If there are dir
19d30 74 79 20 70 61 67 65 73 20 69 6e 20 74 68 65 20  ty pages in the 
19d40 70 61 67 65 20 63 61 63 68 65 20 77 69 74 68 20  page cache with 
19d50 70 61 67 65 20 6e 75 6d 62 65 72 73 20 67 72 65  page numbers gre
19d60 61 74 65 72 0a 20 20 20 20 2a 2a 20 74 68 61 6e  ater.    ** than
19d70 20 50 61 67 65 72 2e 64 62 53 69 7a 65 2c 20 74   Pager.dbSize, t
19d80 68 69 73 20 6d 65 61 6e 73 20 73 71 6c 69 74 65  his means sqlite
19d90 33 50 61 67 65 72 54 72 75 6e 63 61 74 65 28 29  3PagerTruncate()
19da0 20 77 61 73 20 63 61 6c 6c 65 64 20 74 6f 0a 20   was called to. 
19db0 20 20 20 2a 2a 20 6d 61 6b 65 20 74 68 65 20 66     ** make the f
19dc0 69 6c 65 20 73 6d 61 6c 6c 65 72 20 28 70 72 65  ile smaller (pre
19dd0 73 75 6d 61 62 6c 79 20 62 79 20 61 75 74 6f 2d  sumably by auto-
19de0 76 61 63 75 75 6d 20 63 6f 64 65 29 2e 20 44 6f  vacuum code). Do
19df0 20 6e 6f 74 20 77 72 69 74 65 0a 20 20 20 20 2a   not write.    *
19e00 2a 20 61 6e 79 20 73 75 63 68 20 70 61 67 65 73  * any such pages
19e10 20 74 6f 20 74 68 65 20 66 69 6c 65 2e 0a 20 20   to the file..  
19e20 20 20 2a 2f 0a 20 20 20 20 69 66 28 20 70 4c 69    */.    if( pLi
19e30 73 74 2d 3e 70 67 6e 6f 3c 3d 70 50 61 67 65 72  st->pgno<=pPager
19e40 2d 3e 64 62 53 69 7a 65 20 29 7b 0a 20 20 20 20  ->dbSize ){.    
19e50 20 20 69 36 34 20 6f 66 66 73 65 74 20 3d 20 28    i64 offset = (
19e60 70 4c 69 73 74 2d 3e 70 67 6e 6f 2d 31 29 2a 28  pList->pgno-1)*(
19e70 69 36 34 29 70 50 61 67 65 72 2d 3e 70 61 67 65  i64)pPager->page
19e80 53 69 7a 65 3b 0a 20 20 20 20 20 20 63 68 61 72  Size;.      char
19e90 20 2a 70 44 61 74 61 20 3d 20 43 4f 44 45 43 32   *pData = CODEC2
19ea0 28 70 50 61 67 65 72 2c 20 50 47 48 44 52 5f 54  (pPager, PGHDR_T
19eb0 4f 5f 44 41 54 41 28 70 4c 69 73 74 29 2c 20 70  O_DATA(pList), p
19ec0 4c 69 73 74 2d 3e 70 67 6e 6f 2c 20 36 29 3b 0a  List->pgno, 6);.
19ed0 20 20 20 20 20 20 50 41 47 45 52 54 52 41 43 45        PAGERTRACE
19ee0 34 28 22 53 54 4f 52 45 20 25 64 20 70 61 67 65  4("STORE %d page
19ef0 20 25 64 20 68 61 73 68 28 25 30 38 78 29 5c 6e   %d hash(%08x)\n
19f00 22 2c 0a 20 20 20 20 20 20 20 20 20 20 20 20 20  ",.             
19f10 20 20 20 20 20 20 50 41 47 45 52 49 44 28 70 50        PAGERID(pP
19f20 61 67 65 72 29 2c 20 70 4c 69 73 74 2d 3e 70 67  ager), pList->pg
19f30 6e 6f 2c 20 70 61 67 65 72 5f 70 61 67 65 68 61  no, pager_pageha
19f40 73 68 28 70 4c 69 73 74 29 29 3b 0a 20 20 20 20  sh(pList));.    
19f50 20 20 49 4f 54 52 41 43 45 28 28 22 50 47 4f 55    IOTRACE(("PGOU
19f60 54 20 25 70 20 25 64 5c 6e 22 2c 20 70 50 61 67  T %p %d\n", pPag
19f70 65 72 2c 20 70 4c 69 73 74 2d 3e 70 67 6e 6f 29  er, pList->pgno)
19f80 29 3b 0a 20 20 20 20 20 20 72 63 20 3d 20 73 71  );.      rc = sq
19f90 6c 69 74 65 33 4f 73 57 72 69 74 65 28 70 50 61  lite3OsWrite(pPa
19fa0 67 65 72 2d 3e 66 64 2c 20 70 44 61 74 61 2c 20  ger->fd, pData, 
19fb0 70 50 61 67 65 72 2d 3e 70 61 67 65 53 69 7a 65  pPager->pageSize
19fc0 2c 20 6f 66 66 73 65 74 29 3b 0a 20 20 20 20 20  , offset);.     
19fd0 20 50 41 47 45 52 5f 49 4e 43 52 28 73 71 6c 69   PAGER_INCR(sqli
19fe0 74 65 33 5f 70 61 67 65 72 5f 77 72 69 74 65 64  te3_pager_writed
19ff0 62 5f 63 6f 75 6e 74 29 3b 0a 20 20 20 20 20 20  b_count);.      
1a000 50 41 47 45 52 5f 49 4e 43 52 28 70 50 61 67 65  PAGER_INCR(pPage
1a010 72 2d 3e 6e 57 72 69 74 65 29 3b 0a 20 20 20 20  r->nWrite);.    
1a020 20 20 69 66 28 20 70 4c 69 73 74 2d 3e 70 67 6e    if( pList->pgn
1a030 6f 3d 3d 31 20 29 7b 0a 20 20 20 20 20 20 20 20  o==1 ){.        
1a040 6d 65 6d 63 70 79 28 26 70 50 61 67 65 72 2d 3e  memcpy(&pPager->
1a050 64 62 46 69 6c 65 56 65 72 73 2c 20 26 70 44 61  dbFileVers, &pDa
1a060 74 61 5b 32 34 5d 2c 20 73 69 7a 65 6f 66 28 70  ta[24], sizeof(p
1a070 50 61 67 65 72 2d 3e 64 62 46 69 6c 65 56 65 72  Pager->dbFileVer
1a080 73 29 29 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20  s));.      }.   
1a090 20 7d 0a 23 69 66 6e 64 65 66 20 4e 44 45 42 55   }.#ifndef NDEBU
1a0a0 47 0a 20 20 20 20 65 6c 73 65 7b 0a 20 20 20 20  G.    else{.    
1a0b0 20 20 50 41 47 45 52 54 52 41 43 45 33 28 22 4e    PAGERTRACE3("N
1a0c0 4f 53 54 4f 52 45 20 25 64 20 70 61 67 65 20 25  OSTORE %d page %
1a0d0 64 5c 6e 22 2c 20 50 41 47 45 52 49 44 28 70 50  d\n", PAGERID(pP
1a0e0 61 67 65 72 29 2c 20 70 4c 69 73 74 2d 3e 70 67  ager), pList->pg
1a0f0 6e 6f 29 3b 0a 20 20 20 20 7d 0a 23 65 6e 64 69  no);.    }.#endi
1a100 66 0a 20 20 20 20 69 66 28 20 72 63 20 29 20 72  f.    if( rc ) r
1a110 65 74 75 72 6e 20 72 63 3b 0a 23 69 66 64 65 66  eturn rc;.#ifdef
1a120 20 53 51 4c 49 54 45 5f 43 48 45 43 4b 5f 50 41   SQLITE_CHECK_PA
1a130 47 45 53 0a 20 20 20 20 70 4c 69 73 74 2d 3e 70  GES.    pList->p
1a140 61 67 65 48 61 73 68 20 3d 20 70 61 67 65 72 5f  ageHash = pager_
1a150 70 61 67 65 68 61 73 68 28 70 4c 69 73 74 29 3b  pagehash(pList);
1a160 0a 23 65 6e 64 69 66 0a 20 20 20 20 70 4c 69 73  .#endif.    pLis
1a170 74 20 3d 20 70 4c 69 73 74 2d 3e 70 44 69 72 74  t = pList->pDirt
1a180 79 3b 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e 20  y;.  }.  return 
1a190 53 51 4c 49 54 45 5f 4f 4b 3b 0a 7d 0a 0a 2f 2a  SQLITE_OK;.}../*
1a1a0 0a 2a 2a 20 43 6f 6c 6c 65 63 74 20 65 76 65 72  .** Collect ever
1a1b0 79 20 64 69 72 74 79 20 70 61 67 65 20 69 6e 74  y dirty page int
1a1c0 6f 20 61 20 64 69 72 74 79 20 6c 69 73 74 20 61  o a dirty list a
1a1d0 6e 64 0a 2a 2a 20 72 65 74 75 72 6e 20 61 20 70  nd.** return a p
1a1e0 6f 69 6e 74 65 72 20 74 6f 20 74 68 65 20 68 65  ointer to the he
1a1f0 61 64 20 6f 66 20 74 68 61 74 20 6c 69 73 74 2e  ad of that list.
1a200 20 20 41 6c 6c 20 70 61 67 65 73 20 61 72 65 0a    All pages are.
1a210 2a 2a 20 63 6f 6c 6c 65 63 74 65 64 20 65 76 65  ** collected eve
1a220 6e 20 69 66 20 74 68 65 79 20 61 72 65 20 73 74  n if they are st
1a230 69 6c 6c 20 69 6e 20 75 73 65 2e 0a 2a 2f 0a 73  ill in use..*/.s
1a240 74 61 74 69 63 20 50 67 48 64 72 20 2a 70 61 67  tatic PgHdr *pag
1a250 65 72 5f 67 65 74 5f 61 6c 6c 5f 64 69 72 74 79  er_get_all_dirty
1a260 5f 70 61 67 65 73 28 50 61 67 65 72 20 2a 70 50  _pages(Pager *pP
1a270 61 67 65 72 29 7b 0a 0a 23 69 66 6e 64 65 66 20  ager){..#ifndef 
1a280 4e 44 45 42 55 47 0a 20 20 2f 2a 20 56 65 72 69  NDEBUG.  /* Veri
1a290 66 79 20 74 68 65 20 73 61 6e 69 74 79 20 6f 66  fy the sanity of
1a2a0 20 74 68 65 20 64 69 72 74 79 20 6c 69 73 74 20   the dirty list 
1a2b0 77 68 65 6e 20 77 65 20 61 72 65 20 72 75 6e 6e  when we are runn
1a2c0 69 6e 67 0a 20 20 2a 2a 20 69 6e 20 64 65 62 75  ing.  ** in debu
1a2d0 67 67 69 6e 67 20 6d 6f 64 65 2e 20 20 54 68 69  gging mode.  Thi
1a2e0 73 20 69 73 20 65 78 70 65 6e 73 69 76 65 2c 20  s is expensive, 
1a2f0 73 6f 20 64 6f 20 6e 6f 74 0a 20 20 2a 2a 20 64  so do not.  ** d
1a300 6f 20 74 68 69 73 20 6f 6e 20 61 20 6e 6f 72 6d  o this on a norm
1a310 61 6c 20 62 75 69 6c 64 2e 20 2a 2f 0a 20 20 69  al build. */.  i
1a320 6e 74 20 6e 31 20 3d 20 30 3b 0a 20 20 69 6e 74  nt n1 = 0;.  int
1a330 20 6e 32 20 3d 20 30 3b 0a 20 20 50 67 48 64 72   n2 = 0;.  PgHdr
1a340 20 2a 70 3b 0a 20 20 66 6f 72 28 70 3d 70 50 61   *p;.  for(p=pPa
1a350 67 65 72 2d 3e 70 41 6c 6c 3b 20 70 3b 20 70 3d  ger->pAll; p; p=
1a360 70 2d 3e 70 4e 65 78 74 41 6c 6c 29 7b 20 69 66  p->pNextAll){ if
1a370 28 20 70 2d 3e 64 69 72 74 79 20 29 20 6e 31 2b  ( p->dirty ) n1+
1a380 2b 3b 20 7d 0a 20 20 66 6f 72 28 70 3d 70 50 61  +; }.  for(p=pPa
1a390 67 65 72 2d 3e 70 44 69 72 74 79 3b 20 70 3b 20  ger->pDirty; p; 
1a3a0 70 3d 70 2d 3e 70 44 69 72 74 79 29 7b 20 6e 32  p=p->pDirty){ n2
1a3b0 2b 2b 3b 20 7d 0a 20 20 61 73 73 65 72 74 28 20  ++; }.  assert( 
1a3c0 6e 31 3d 3d 6e 32 20 29 3b 0a 23 65 6e 64 69 66  n1==n2 );.#endif
1a3d0 0a 0a 20 20 72 65 74 75 72 6e 20 70 50 61 67 65  ..  return pPage
1a3e0 72 2d 3e 70 44 69 72 74 79 3b 0a 7d 0a 0a 2f 2a  r->pDirty;.}../*
1a3f0 0a 2a 2a 20 52 65 74 75 72 6e 20 31 20 69 66 20  .** Return 1 if 
1a400 74 68 65 72 65 20 69 73 20 61 20 68 6f 74 20 6a  there is a hot j
1a410 6f 75 72 6e 61 6c 20 6f 6e 20 74 68 65 20 67 69  ournal on the gi
1a420 76 65 6e 20 70 61 67 65 72 2e 0a 2a 2a 20 41 20  ven pager..** A 
1a430 68 6f 74 20 6a 6f 75 72 6e 61 6c 20 69 73 20 6f  hot journal is o
1a440 6e 65 20 74 68 61 74 20 6e 65 65 64 73 20 74 6f  ne that needs to
1a450 20 62 65 20 70 6c 61 79 65 64 20 62 61 63 6b 2e   be played back.
1a460 0a 2a 2a 0a 2a 2a 20 49 66 20 74 68 65 20 63 75  .**.** If the cu
1a470 72 72 65 6e 74 20 73 69 7a 65 20 6f 66 20 74 68  rrent size of th
1a480 65 20 64 61 74 61 62 61 73 65 20 66 69 6c 65 20  e database file 
1a490 69 73 20 30 20 62 75 74 20 61 20 6a 6f 75 72 6e  is 0 but a journ
1a4a0 61 6c 20 66 69 6c 65 0a 2a 2a 20 65 78 69 73 74  al file.** exist
1a4b0 73 2c 20 74 68 61 74 20 69 73 20 70 72 6f 62 61  s, that is proba
1a4c0 62 6c 79 20 61 6e 20 6f 6c 64 20 6a 6f 75 72 6e  bly an old journ
1a4d0 61 6c 20 6c 65 66 74 20 6f 76 65 72 20 66 72 6f  al left over fro
1a4e0 6d 20 61 20 70 72 69 6f 72 0a 2a 2a 20 64 61 74  m a prior.** dat
1a4f0 61 62 61 73 65 20 77 69 74 68 20 74 68 65 20 73  abase with the s
1a500 61 6d 65 20 6e 61 6d 65 2e 20 20 4a 75 73 74 20  ame name.  Just 
1a510 64 65 6c 65 74 65 20 74 68 65 20 6a 6f 75 72 6e  delete the journ
1a520 61 6c 2e 0a 2a 2a 0a 2a 2a 20 52 65 74 75 72 6e  al..**.** Return
1a530 20 6e 65 67 61 74 69 76 65 20 69 66 20 75 6e 61   negative if una
1a540 62 6c 65 20 74 6f 20 64 65 74 65 72 6d 69 6e 65  ble to determine
1a550 20 74 68 65 20 73 74 61 74 75 73 20 6f 66 20 74   the status of t
1a560 68 65 20 6a 6f 75 72 6e 61 6c 2e 0a 2a 2f 0a 73  he journal..*/.s
1a570 74 61 74 69 63 20 69 6e 74 20 68 61 73 48 6f 74  tatic int hasHot
1a580 4a 6f 75 72 6e 61 6c 28 50 61 67 65 72 20 2a 70  Journal(Pager *p
1a590 50 61 67 65 72 29 7b 0a 20 20 73 71 6c 69 74 65  Pager){.  sqlite
1a5a0 33 5f 76 66 73 20 2a 70 56 66 73 20 3d 20 70 50  3_vfs *pVfs = pP
1a5b0 61 67 65 72 2d 3e 70 56 66 73 3b 0a 20 20 69 6e  ager->pVfs;.  in
1a5c0 74 20 72 63 3b 0a 20 20 69 66 28 20 21 70 50 61  t rc;.  if( !pPa
1a5d0 67 65 72 2d 3e 75 73 65 4a 6f 75 72 6e 61 6c 20  ger->useJournal 
1a5e0 29 20 72 65 74 75 72 6e 20 30 3b 0a 20 20 69 66  ) return 0;.  if
1a5f0 28 20 21 70 50 61 67 65 72 2d 3e 66 64 2d 3e 70  ( !pPager->fd->p
1a600 4d 65 74 68 6f 64 73 20 29 20 72 65 74 75 72 6e  Methods ) return
1a610 20 30 3b 0a 20 20 72 63 20 3d 20 73 71 6c 69 74   0;.  rc = sqlit
1a620 65 33 4f 73 41 63 63 65 73 73 28 70 56 66 73 2c  e3OsAccess(pVfs,
1a630 20 70 50 61 67 65 72 2d 3e 7a 4a 6f 75 72 6e 61   pPager->zJourna
1a640 6c 2c 20 53 51 4c 49 54 45 5f 41 43 43 45 53 53  l, SQLITE_ACCESS
1a650 5f 45 58 49 53 54 53 29 3b 0a 20 20 69 66 28 20  _EXISTS);.  if( 
1a660 72 63 3c 3d 30 20 29 7b 0a 20 20 20 20 72 65 74  rc<=0 ){.    ret
1a670 75 72 6e 20 72 63 3b 0a 20 20 7d 0a 20 20 69 66  urn rc;.  }.  if
1a680 28 20 73 71 6c 69 74 65 33 4f 73 43 68 65 63 6b  ( sqlite3OsCheck
1a690 52 65 73 65 72 76 65 64 4c 6f 63 6b 28 70 50 61  ReservedLock(pPa
1a6a0 67 65 72 2d 3e 66 64 29 20 29 7b 0a 20 20 20 20  ger->fd) ){.    
1a6b0 72 65 74 75 72 6e 20 30 3b 0a 20 20 7d 0a 20 20  return 0;.  }.  
1a6c0 69 66 28 20 73 71 6c 69 74 65 33 50 61 67 65 72  if( sqlite3Pager
1a6d0 50 61 67 65 63 6f 75 6e 74 28 70 50 61 67 65 72  Pagecount(pPager
1a6e0 29 3d 3d 30 20 29 7b 0a 20 20 20 20 73 71 6c 69  )==0 ){.    sqli
1a6f0 74 65 33 4f 73 44 65 6c 65 74 65 28 70 56 66 73  te3OsDelete(pVfs
1a700 2c 20 70 50 61 67 65 72 2d 3e 7a 4a 6f 75 72 6e  , pPager->zJourn
1a710 61 6c 2c 20 30 29 3b 0a 20 20 20 20 72 65 74 75  al, 0);.    retu
1a720 72 6e 20 30 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20  rn 0;.  }else{. 
1a730 20 20 20 72 65 74 75 72 6e 20 31 3b 0a 20 20 7d     return 1;.  }
1a740 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 54 72 79 20 74 6f  .}../*.** Try to
1a750 20 66 69 6e 64 20 61 20 70 61 67 65 20 69 6e 20   find a page in 
1a760 74 68 65 20 63 61 63 68 65 20 74 68 61 74 20 63  the cache that c
1a770 61 6e 20 62 65 20 72 65 63 79 63 6c 65 64 2e 20  an be recycled. 
1a780 0a 2a 2a 0a 2a 2a 20 54 68 69 73 20 72 6f 75 74  .**.** This rout
1a790 69 6e 65 20 6d 61 79 20 72 65 74 75 72 6e 20 53  ine may return S
1a7a0 51 4c 49 54 45 5f 49 4f 45 52 52 2c 20 53 51 4c  QLITE_IOERR, SQL
1a7b0 49 54 45 5f 46 55 4c 4c 20 6f 72 20 53 51 4c 49  ITE_FULL or SQLI
1a7c0 54 45 5f 4f 4b 2e 20 49 74 20 0a 2a 2a 20 64 6f  TE_OK. It .** do
1a7d0 65 73 20 6e 6f 74 20 73 65 74 20 74 68 65 20 70  es not set the p
1a7e0 50 61 67 65 72 2d 3e 65 72 72 43 6f 64 65 20 76  Pager->errCode v
1a7f0 61 72 69 61 62 6c 65 2e 0a 2a 2f 0a 73 74 61 74  ariable..*/.stat
1a800 69 63 20 69 6e 74 20 70 61 67 65 72 5f 72 65 63  ic int pager_rec
1a810 79 63 6c 65 28 50 61 67 65 72 20 2a 70 50 61 67  ycle(Pager *pPag
1a820 65 72 2c 20 50 67 48 64 72 20 2a 2a 70 70 50 67  er, PgHdr **ppPg
1a830 29 7b 0a 20 20 50 67 48 64 72 20 2a 70 50 67 3b  ){.  PgHdr *pPg;
1a840 0a 20 20 2a 70 70 50 67 20 3d 20 30 3b 0a 0a 20  .  *ppPg = 0;.. 
1a850 20 2f 2a 20 49 74 20 69 73 20 69 6c 6c 65 67 61   /* It is illega
1a860 6c 20 74 6f 20 63 61 6c 6c 20 74 68 69 73 20 66  l to call this f
1a870 75 6e 63 74 69 6f 6e 20 75 6e 6c 65 73 73 20 74  unction unless t
1a880 68 65 20 70 61 67 65 72 20 6f 62 6a 65 63 74 0a  he pager object.
1a890 20 20 2a 2a 20 70 6f 69 6e 74 65 64 20 74 6f 20    ** pointed to 
1a8a0 62 79 20 70 50 61 67 65 72 20 68 61 73 20 61 74  by pPager has at
1a8b0 20 6c 65 61 73 74 20 6f 6e 65 20 66 72 65 65 20   least one free 
1a8c0 70 61 67 65 20 28 70 61 67 65 20 77 69 74 68 20  page (page with 
1a8d0 6e 52 65 66 3d 3d 30 29 2e 0a 20 20 2a 2f 20 0a  nRef==0)..  */ .
1a8e0 20 20 61 73 73 65 72 74 28 21 4d 45 4d 44 42 29    assert(!MEMDB)
1a8f0 3b 0a 20 20 61 73 73 65 72 74 28 70 50 61 67 65  ;.  assert(pPage
1a900 72 2d 3e 6c 72 75 2e 70 46 69 72 73 74 29 3b 0a  r->lru.pFirst);.
1a910 0a 20 20 2f 2a 20 46 69 6e 64 20 61 20 70 61 67  .  /* Find a pag
1a920 65 20 74 6f 20 72 65 63 79 63 6c 65 2e 20 20 54  e to recycle.  T
1a930 72 79 20 74 6f 20 6c 6f 63 61 74 65 20 61 20 70  ry to locate a p
1a940 61 67 65 20 74 68 61 74 20 64 6f 65 73 20 6e 6f  age that does no
1a950 74 0a 20 20 2a 2a 20 72 65 71 75 69 72 65 20 75  t.  ** require u
1a960 73 20 74 6f 20 64 6f 20 61 6e 20 66 73 79 6e 63  s to do an fsync
1a970 28 29 20 6f 6e 20 74 68 65 20 6a 6f 75 72 6e 61  () on the journa
1a980 6c 2e 0a 20 20 2a 2f 0a 20 20 70 50 67 20 3d 20  l..  */.  pPg = 
1a990 70 50 61 67 65 72 2d 3e 6c 72 75 2e 70 46 69 72  pPager->lru.pFir
1a9a0 73 74 53 79 6e 63 65 64 3b 0a 0a 20 20 2f 2a 20  stSynced;..  /* 
1a9b0 49 66 20 77 65 20 63 6f 75 6c 64 20 6e 6f 74 20  If we could not 
1a9c0 66 69 6e 64 20 61 20 70 61 67 65 20 74 68 61 74  find a page that
1a9d0 20 64 6f 65 73 20 6e 6f 74 20 72 65 71 75 69 72   does not requir
1a9e0 65 20 61 6e 20 66 73 79 6e 63 28 29 0a 20 20 2a  e an fsync().  *
1a9f0 2a 20 6f 6e 20 74 68 65 20 6a 6f 75 72 6e 61 6c  * on the journal
1aa00 20 66 69 6c 65 20 74 68 65 6e 20 66 73 79 6e 63   file then fsync
1aa10 20 74 68 65 20 6a 6f 75 72 6e 61 6c 20 66 69 6c   the journal fil
1aa20 65 2e 20 20 54 68 69 73 20 69 73 20 61 0a 20 20  e.  This is a.  
1aa30 2a 2a 20 76 65 72 79 20 73 6c 6f 77 20 6f 70 65  ** very slow ope
1aa40 72 61 74 69 6f 6e 2c 20 73 6f 20 77 65 20 77 6f  ration, so we wo
1aa50 72 6b 20 68 61 72 64 20 74 6f 20 61 76 6f 69 64  rk hard to avoid
1aa60 20 69 74 2e 20 20 42 75 74 20 73 6f 6d 65 74 69   it.  But someti
1aa70 6d 65 73 0a 20 20 2a 2a 20 69 74 20 63 61 6e 27  mes.  ** it can'
1aa80 74 20 62 65 20 68 65 6c 70 65 64 2e 0a 20 20 2a  t be helped..  *
1aa90 2f 0a 20 20 69 66 28 20 70 50 67 3d 3d 30 20 26  /.  if( pPg==0 &
1aaa0 26 20 70 50 61 67 65 72 2d 3e 6c 72 75 2e 70 46  & pPager->lru.pF
1aab0 69 72 73 74 29 7b 0a 20 20 20 20 69 6e 74 20 69  irst){.    int i
1aac0 44 63 20 3d 20 73 71 6c 69 74 65 33 4f 73 44 65  Dc = sqlite3OsDe
1aad0 76 69 63 65 43 68 61 72 61 63 74 65 72 69 73 74  viceCharacterist
1aae0 69 63 73 28 70 50 61 67 65 72 2d 3e 66 64 29 3b  ics(pPager->fd);
1aaf0 0a 20 20 20 20 69 6e 74 20 72 63 20 3d 20 73 79  .    int rc = sy
1ab00 6e 63 4a 6f 75 72 6e 61 6c 28 70 50 61 67 65 72  ncJournal(pPager
1ab10 29 3b 0a 20 20 20 20 69 66 28 20 72 63 21 3d 30  );.    if( rc!=0
1ab20 20 29 7b 0a 20 20 20 20 20 20 72 65 74 75 72 6e   ){.      return
1ab30 20 72 63 3b 0a 20 20 20 20 7d 0a 20 20 20 20 69   rc;.    }.    i
1ab40 66 28 20 70 50 61 67 65 72 2d 3e 66 75 6c 6c 53  f( pPager->fullS
1ab50 79 6e 63 20 26 26 20 30 3d 3d 28 69 44 63 26 53  ync && 0==(iDc&S
1ab60 51 4c 49 54 45 5f 49 4f 43 41 50 5f 53 41 46 45  QLITE_IOCAP_SAFE
1ab70 5f 41 50 50 45 4e 44 29 20 29 7b 0a 20 20 20 20  _APPEND) ){.    
1ab80 20 20 2f 2a 20 49 66 20 69 6e 20 66 75 6c 6c 2d    /* If in full-
1ab90 73 79 6e 63 20 6d 6f 64 65 2c 20 77 72 69 74 65  sync mode, write
1aba0 20 61 20 6e 65 77 20 6a 6f 75 72 6e 61 6c 20 68   a new journal h
1abb0 65 61 64 65 72 20 69 6e 74 6f 20 74 68 65 0a 20  eader into the. 
1abc0 20 20 20 20 20 2a 2a 20 6a 6f 75 72 6e 61 6c 20       ** journal 
1abd0 66 69 6c 65 2e 20 54 68 69 73 20 69 73 20 64 6f  file. This is do
1abe0 6e 65 20 74 6f 20 61 76 6f 69 64 20 65 76 65 72  ne to avoid ever
1abf0 20 6d 6f 64 69 66 79 69 6e 67 20 61 20 6a 6f 75   modifying a jou
1ac00 72 6e 61 6c 0a 20 20 20 20 20 20 2a 2a 20 68 65  rnal.      ** he
1ac10 61 64 65 72 20 74 68 61 74 20 69 73 20 69 6e 76  ader that is inv
1ac20 6f 6c 76 65 64 20 69 6e 20 74 68 65 20 72 6f 6c  olved in the rol
1ac30 6c 62 61 63 6b 20 6f 66 20 70 61 67 65 73 20 74  lback of pages t
1ac40 68 61 74 20 68 61 76 65 0a 20 20 20 20 20 20 2a  hat have.      *
1ac50 2a 20 61 6c 72 65 61 64 79 20 62 65 65 6e 20 77  * already been w
1ac60 72 69 74 74 65 6e 20 74 6f 20 74 68 65 20 64 61  ritten to the da
1ac70 74 61 62 61 73 65 20 28 69 6e 20 63 61 73 65 20  tabase (in case 
1ac80 74 68 65 20 68 65 61 64 65 72 20 69 73 0a 20 20  the header is.  
1ac90 20 20 20 20 2a 2a 20 74 72 61 73 68 65 64 20 77      ** trashed w
1aca0 68 65 6e 20 74 68 65 20 6e 52 65 63 20 66 69 65  hen the nRec fie
1acb0 6c 64 20 69 73 20 75 70 64 61 74 65 64 29 2e 0a  ld is updated)..
1acc0 20 20 20 20 20 20 2a 2f 0a 20 20 20 20 20 20 70        */.      p
1acd0 50 61 67 65 72 2d 3e 6e 52 65 63 20 3d 20 30 3b  Pager->nRec = 0;
1ace0 0a 20 20 20 20 20 20 61 73 73 65 72 74 28 20 70  .      assert( p
1acf0 50 61 67 65 72 2d 3e 6a 6f 75 72 6e 61 6c 4f 66  Pager->journalOf
1ad00 66 20 3e 20 30 20 29 3b 0a 20 20 20 20 20 20 61  f > 0 );.      a
1ad10 73 73 65 72 74 28 20 70 50 61 67 65 72 2d 3e 64  ssert( pPager->d
1ad20 6f 4e 6f 74 53 79 6e 63 3d 3d 30 20 29 3b 0a 20  oNotSync==0 );. 
1ad30 20 20 20 20 20 72 63 20 3d 20 77 72 69 74 65 4a       rc = writeJ
1ad40 6f 75 72 6e 61 6c 48 64 72 28 70 50 61 67 65 72  ournalHdr(pPager
1ad50 29 3b 0a 20 20 20 20 20 20 69 66 28 20 72 63 21  );.      if( rc!
1ad60 3d 30 20 29 7b 0a 20 20 20 20 20 20 20 20 72 65  =0 ){.        re
1ad70 74 75 72 6e 20 72 63 3b 0a 20 20 20 20 20 20 7d  turn rc;.      }
1ad80 0a 20 20 20 20 7d 0a 20 20 20 20 70 50 67 20 3d  .    }.    pPg =
1ad90 20 70 50 61 67 65 72 2d 3e 6c 72 75 2e 70 46 69   pPager->lru.pFi
1ada0 72 73 74 3b 0a 20 20 7d 0a 0a 20 20 61 73 73 65  rst;.  }..  asse
1adb0 72 74 28 20 70 50 67 2d 3e 6e 52 65 66 3d 3d 30  rt( pPg->nRef==0
1adc0 20 29 3b 0a 0a 20 20 2f 2a 20 57 72 69 74 65 20   );..  /* Write 
1add0 74 68 65 20 70 61 67 65 20 74 6f 20 74 68 65 20  the page to the 
1ade0 64 61 74 61 62 61 73 65 20 66 69 6c 65 20 69 66  database file if
1adf0 20 69 74 20 69 73 20 64 69 72 74 79 2e 0a 20 20   it is dirty..  
1ae00 2a 2f 0a 20 20 69 66 28 20 70 50 67 2d 3e 64 69  */.  if( pPg->di
1ae10 72 74 79 20 29 7b 0a 20 20 20 20 69 6e 74 20 72  rty ){.    int r
1ae20 63 3b 0a 20 20 20 20 61 73 73 65 72 74 28 20 70  c;.    assert( p
1ae30 50 67 2d 3e 6e 65 65 64 53 79 6e 63 3d 3d 30 20  Pg->needSync==0 
1ae40 29 3b 0a 20 20 20 20 6d 61 6b 65 43 6c 65 61 6e  );.    makeClean
1ae50 28 70 50 67 29 3b 0a 20 20 20 20 70 50 67 2d 3e  (pPg);.    pPg->
1ae60 64 69 72 74 79 20 3d 20 31 3b 0a 20 20 20 20 70  dirty = 1;.    p
1ae70 50 67 2d 3e 70 44 69 72 74 79 20 3d 20 30 3b 0a  Pg->pDirty = 0;.
1ae80 20 20 20 20 72 63 20 3d 20 70 61 67 65 72 5f 77      rc = pager_w
1ae90 72 69 74 65 5f 70 61 67 65 6c 69 73 74 28 20 70  rite_pagelist( p
1aea0 50 67 20 29 3b 0a 20 20 20 20 70 50 67 2d 3e 64  Pg );.    pPg->d
1aeb0 69 72 74 79 20 3d 20 30 3b 0a 20 20 20 20 69 66  irty = 0;.    if
1aec0 28 20 72 63 21 3d 53 51 4c 49 54 45 5f 4f 4b 20  ( rc!=SQLITE_OK 
1aed0 29 7b 0a 20 20 20 20 20 20 72 65 74 75 72 6e 20  ){.      return 
1aee0 72 63 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a 20 20  rc;.    }.  }.  
1aef0 61 73 73 65 72 74 28 20 70 50 67 2d 3e 64 69 72  assert( pPg->dir
1af00 74 79 3d 3d 30 20 29 3b 0a 0a 20 20 2f 2a 20 49  ty==0 );..  /* I
1af10 66 20 74 68 65 20 70 61 67 65 20 77 65 20 61 72  f the page we ar
1af20 65 20 72 65 63 79 63 6c 69 6e 67 20 69 73 20 6d  e recycling is m
1af30 61 72 6b 65 64 20 61 73 20 61 6c 77 61 79 73 52  arked as alwaysR
1af40 6f 6c 6c 62 61 63 6b 2c 20 74 68 65 6e 0a 20 20  ollback, then.  
1af50 2a 2a 20 73 65 74 20 74 68 65 20 67 6c 6f 62 61  ** set the globa
1af60 6c 20 61 6c 77 61 79 73 52 6f 6c 6c 62 61 63 6b  l alwaysRollback
1af70 20 66 6c 61 67 2c 20 74 68 75 73 20 64 69 73 61   flag, thus disa
1af80 62 6c 69 6e 67 20 74 68 65 0a 20 20 2a 2a 20 73  bling the.  ** s
1af90 71 6c 69 74 65 33 50 61 67 65 72 44 6f 6e 74 52  qlite3PagerDontR
1afa0 6f 6c 6c 62 61 63 6b 28 29 20 6f 70 74 69 6d 69  ollback() optimi
1afb0 7a 61 74 69 6f 6e 20 66 6f 72 20 74 68 65 20 72  zation for the r
1afc0 65 73 74 20 6f 66 20 74 68 69 73 20 74 72 61 6e  est of this tran
1afd0 73 61 63 74 69 6f 6e 2e 0a 20 20 2a 2a 20 49 74  saction..  ** It
1afe0 20 69 73 20 6e 65 63 65 73 73 61 72 79 20 74 6f   is necessary to
1aff0 20 64 6f 20 74 68 69 73 20 62 65 63 61 75 73 65   do this because
1b000 20 74 68 65 20 70 61 67 65 20 6d 61 72 6b 65 64   the page marked
1b010 20 61 6c 77 61 79 73 52 6f 6c 6c 62 61 63 6b 0a   alwaysRollback.
1b020 20 20 2a 2a 20 6d 69 67 68 74 20 62 65 20 72 65    ** might be re
1b030 6c 6f 61 64 65 64 20 61 74 20 61 20 6c 61 74 65  loaded at a late
1b040 72 20 74 69 6d 65 20 62 75 74 20 61 74 20 74 68  r time but at th
1b050 61 74 20 70 6f 69 6e 74 20 77 65 20 77 6f 6e 27  at point we won'
1b060 74 20 72 65 6d 65 6d 62 65 72 0a 20 20 2a 2a 20  t remember.  ** 
1b070 74 68 61 74 20 69 73 20 77 61 73 20 6d 61 72 6b  that is was mark
1b080 65 64 20 61 6c 77 61 79 73 52 6f 6c 6c 62 61 63  ed alwaysRollbac
1b090 6b 2e 20 20 54 68 69 73 20 6d 65 61 6e 73 20 74  k.  This means t
1b0a0 68 61 74 20 61 6c 6c 20 70 61 67 65 73 20 6d 75  hat all pages mu
1b0b0 73 74 0a 20 20 2a 2a 20 62 65 20 6d 61 72 6b 65  st.  ** be marke
1b0c0 64 20 61 73 20 61 6c 77 61 79 73 52 6f 6c 6c 62  d as alwaysRollb
1b0d0 61 63 6b 20 66 72 6f 6d 20 68 65 72 65 20 6f 6e  ack from here on
1b0e0 20 6f 75 74 2e 0a 20 20 2a 2f 0a 20 20 69 66 28   out..  */.  if(
1b0f0 20 70 50 67 2d 3e 61 6c 77 61 79 73 52 6f 6c 6c   pPg->alwaysRoll
1b100 62 61 63 6b 20 29 7b 0a 20 20 20 20 49 4f 54 52  back ){.    IOTR
1b110 41 43 45 28 28 22 41 4c 57 41 59 53 5f 52 4f 4c  ACE(("ALWAYS_ROL
1b120 4c 42 41 43 4b 20 25 70 5c 6e 22 2c 20 70 50 61  LBACK %p\n", pPa
1b130 67 65 72 29 29 0a 20 20 20 20 70 50 61 67 65 72  ger)).    pPager
1b140 2d 3e 61 6c 77 61 79 73 52 6f 6c 6c 62 61 63 6b  ->alwaysRollback
1b150 20 3d 20 31 3b 0a 20 20 7d 0a 0a 20 20 2f 2a 20   = 1;.  }..  /* 
1b160 55 6e 6c 69 6e 6b 20 74 68 65 20 6f 6c 64 20 70  Unlink the old p
1b170 61 67 65 20 66 72 6f 6d 20 74 68 65 20 66 72 65  age from the fre
1b180 65 20 6c 69 73 74 20 61 6e 64 20 74 68 65 20 68  e list and the h
1b190 61 73 68 20 74 61 62 6c 65 0a 20 20 2a 2f 0a 20  ash table.  */. 
1b1a0 20 75 6e 6c 69 6e 6b 50 61 67 65 28 70 50 67 29   unlinkPage(pPg)
1b1b0 3b 0a 20 20 61 73 73 65 72 74 28 20 70 50 67 2d  ;.  assert( pPg-
1b1c0 3e 70 67 6e 6f 3d 3d 30 20 29 3b 0a 0a 20 20 2a  >pgno==0 );..  *
1b1d0 70 70 50 67 20 3d 20 70 50 67 3b 0a 20 20 72 65  ppPg = pPg;.  re
1b1e0 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a  turn SQLITE_OK;.
1b1f0 7d 0a 0a 23 69 66 64 65 66 20 53 51 4c 49 54 45  }..#ifdef SQLITE
1b200 5f 45 4e 41 42 4c 45 5f 4d 45 4d 4f 52 59 5f 4d  _ENABLE_MEMORY_M
1b210 41 4e 41 47 45 4d 45 4e 54 0a 2f 2a 0a 2a 2a 20  ANAGEMENT./*.** 
1b220 54 68 69 73 20 66 75 6e 63 74 69 6f 6e 20 69 73  This function is
1b230 20 63 61 6c 6c 65 64 20 74 6f 20 66 72 65 65 20   called to free 
1b240 73 75 70 65 72 66 6c 75 6f 75 73 20 64 79 6e 61  superfluous dyna
1b250 6d 69 63 61 6c 6c 79 20 61 6c 6c 6f 63 61 74 65  mically allocate
1b260 64 20 6d 65 6d 6f 72 79 0a 2a 2a 20 68 65 6c 64  d memory.** held
1b270 20 62 79 20 74 68 65 20 70 61 67 65 72 20 73 79   by the pager sy
1b280 73 74 65 6d 2e 20 4d 65 6d 6f 72 79 20 69 6e 20  stem. Memory in 
1b290 75 73 65 20 62 79 20 61 6e 79 20 53 51 4c 69 74  use by any SQLit
1b2a0 65 20 70 61 67 65 72 20 61 6c 6c 6f 63 61 74 65  e pager allocate
1b2b0 64 0a 2a 2a 20 62 79 20 74 68 65 20 63 75 72 72  d.** by the curr
1b2c0 65 6e 74 20 74 68 72 65 61 64 20 6d 61 79 20 62  ent thread may b
1b2d0 65 20 73 71 6c 69 74 65 33 5f 66 72 65 65 28 29  e sqlite3_free()
1b2e0 65 64 2e 0a 2a 2a 0a 2a 2a 20 6e 52 65 71 20 69  ed..**.** nReq i
1b2f0 73 20 74 68 65 20 6e 75 6d 62 65 72 20 6f 66 20  s the number of 
1b300 62 79 74 65 73 20 6f 66 20 6d 65 6d 6f 72 79 20  bytes of memory 
1b310 72 65 71 75 69 72 65 64 2e 20 4f 6e 63 65 20 74  required. Once t
1b320 68 69 73 20 6d 75 63 68 20 68 61 73 0a 2a 2a 20  his much has.** 
1b330 62 65 65 6e 20 72 65 6c 65 61 73 65 64 2c 20 74  been released, t
1b340 68 65 20 66 75 6e 63 74 69 6f 6e 20 72 65 74 75  he function retu
1b350 72 6e 73 2e 20 54 68 65 20 72 65 74 75 72 6e 20  rns. The return 
1b360 76 61 6c 75 65 20 69 73 20 74 68 65 20 74 6f 74  value is the tot
1b370 61 6c 20 6e 75 6d 62 65 72 20 0a 2a 2a 20 6f 66  al number .** of
1b380 20 62 79 74 65 73 20 6f 66 20 6d 65 6d 6f 72 79   bytes of memory
1b390 20 72 65 6c 65 61 73 65 64 2e 0a 2a 2f 0a 69 6e   released..*/.in
1b3a0 74 20 73 71 6c 69 74 65 33 50 61 67 65 72 52 65  t sqlite3PagerRe
1b3b0 6c 65 61 73 65 4d 65 6d 6f 72 79 28 69 6e 74 20  leaseMemory(int 
1b3c0 6e 52 65 71 29 7b 0a 20 20 69 6e 74 20 6e 52 65  nReq){.  int nRe
1b3d0 6c 65 61 73 65 64 20 3d 20 30 3b 20 20 20 20 20  leased = 0;     
1b3e0 20 20 20 20 20 2f 2a 20 42 79 74 65 73 20 6f 66       /* Bytes of
1b3f0 20 6d 65 6d 6f 72 79 20 72 65 6c 65 61 73 65 64   memory released
1b400 20 73 6f 20 66 61 72 20 2a 2f 0a 20 20 73 71 6c   so far */.  sql
1b410 69 74 65 33 5f 6d 75 74 65 78 20 2a 6d 75 74 65  ite3_mutex *mute
1b420 78 3b 20 20 20 20 20 20 20 2f 2a 20 54 68 65 20  x;       /* The 
1b430 4d 45 4d 32 20 6d 75 74 65 78 20 2a 2f 0a 20 20  MEM2 mutex */.  
1b440 50 61 67 65 72 20 2a 70 50 61 67 65 72 3b 20 20  Pager *pPager;  
1b450 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 46              /* F
1b460 6f 72 20 6c 6f 6f 70 69 6e 67 20 6f 76 65 72 20  or looping over 
1b470 70 61 67 65 72 73 20 2a 2f 0a 20 20 42 75 73 79  pagers */.  Busy
1b480 48 61 6e 64 6c 65 72 20 2a 73 61 76 65 64 42 75  Handler *savedBu
1b490 73 79 3b 20 20 20 20 20 2f 2a 20 53 61 76 65 64  sy;     /* Saved
1b4a0 20 63 6f 70 79 20 6f 66 20 74 68 65 20 62 75 73   copy of the bus
1b4b0 79 20 68 61 6e 64 6c 65 72 20 2a 2f 0a 20 20 69  y handler */.  i
1b4c0 6e 74 20 72 63 20 3d 20 53 51 4c 49 54 45 5f 4f  nt rc = SQLITE_O
1b4d0 4b 3b 0a 0a 20 20 2f 2a 20 41 63 71 75 69 72 65  K;..  /* Acquire
1b4e0 20 74 68 65 20 6d 65 6d 6f 72 79 2d 6d 61 6e 61   the memory-mana
1b4f0 67 65 6d 65 6e 74 20 6d 75 74 65 78 0a 20 20 2a  gement mutex.  *
1b500 2f 0a 20 20 6d 75 74 65 78 20 3d 20 73 71 6c 69  /.  mutex = sqli
1b510 74 65 33 5f 6d 75 74 65 78 5f 61 6c 6c 6f 63 28  te3_mutex_alloc(
1b520 53 51 4c 49 54 45 5f 4d 55 54 45 58 5f 53 54 41  SQLITE_MUTEX_STA
1b530 54 49 43 5f 4d 45 4d 32 29 3b 0a 20 20 73 71 6c  TIC_MEM2);.  sql
1b540 69 74 65 33 5f 6d 75 74 65 78 5f 65 6e 74 65 72  ite3_mutex_enter
1b550 28 6d 75 74 65 78 29 3b 0a 0a 20 20 2f 2a 20 53  (mutex);..  /* S
1b560 69 67 6e 61 6c 20 61 6c 6c 20 64 61 74 61 62 61  ignal all databa
1b570 73 65 20 63 6f 6e 6e 65 63 74 69 6f 6e 73 20 74  se connections t
1b580 68 61 74 20 6d 65 6d 6f 72 79 20 6d 61 6e 61 67  hat memory manag
1b590 65 6d 65 6e 74 20 77 61 6e 74 73 0a 20 20 2a 2a  ement wants.  **
1b5a0 20 74 6f 20 68 61 76 65 20 61 63 63 65 73 73 20   to have access 
1b5b0 74 6f 20 74 68 65 20 70 61 67 65 72 73 2e 0a 20  to the pagers.. 
1b5c0 20 2a 2f 0a 20 20 66 6f 72 28 70 50 61 67 65 72   */.  for(pPager
1b5d0 3d 73 71 6c 69 74 65 33 50 61 67 65 72 4c 69 73  =sqlite3PagerLis
1b5e0 74 3b 20 70 50 61 67 65 72 3b 20 70 50 61 67 65  t; pPager; pPage
1b5f0 72 3d 70 50 61 67 65 72 2d 3e 70 4e 65 78 74 29  r=pPager->pNext)
1b600 7b 0a 20 20 20 20 20 70 50 61 67 65 72 2d 3e 69  {.     pPager->i
1b610 49 6e 55 73 65 4d 4d 20 3d 20 31 3b 0a 20 20 7d  InUseMM = 1;.  }
1b620 0a 0a 20 20 77 68 69 6c 65 28 20 72 63 3d 3d 53  ..  while( rc==S
1b630 51 4c 49 54 45 5f 4f 4b 20 26 26 20 28 6e 52 65  QLITE_OK && (nRe
1b640 71 3c 30 20 7c 7c 20 6e 52 65 6c 65 61 73 65 64  q<0 || nReleased
1b650 3c 6e 52 65 71 29 20 29 7b 0a 20 20 20 20 50 67  <nReq) ){.    Pg
1b660 48 64 72 20 2a 70 50 67 3b 0a 20 20 20 20 50 67  Hdr *pPg;.    Pg
1b670 48 64 72 20 2a 70 52 65 63 79 63 6c 65 64 3b 0a  Hdr *pRecycled;.
1b680 20 0a 20 20 20 20 2f 2a 20 54 72 79 20 74 6f 20   .    /* Try to 
1b690 66 69 6e 64 20 61 20 70 61 67 65 20 74 6f 20 72  find a page to r
1b6a0 65 63 79 63 6c 65 20 74 68 61 74 20 64 6f 65 73  ecycle that does
1b6b0 20 6e 6f 74 20 72 65 71 75 69 72 65 20 61 20 73   not require a s
1b6c0 79 6e 63 28 29 2e 20 49 66 0a 20 20 20 20 2a 2a  ync(). If.    **
1b6d0 20 74 68 69 73 20 69 73 20 6e 6f 74 20 70 6f 73   this is not pos
1b6e0 73 69 62 6c 65 2c 20 66 69 6e 64 20 6f 6e 65 20  sible, find one 
1b6f0 74 68 61 74 20 64 6f 65 73 20 72 65 71 75 69 72  that does requir
1b700 65 20 61 20 73 79 6e 63 28 29 2e 0a 20 20 20 20  e a sync()..    
1b710 2a 2f 0a 20 20 20 20 73 71 6c 69 74 65 33 5f 6d  */.    sqlite3_m
1b720 75 74 65 78 5f 65 6e 74 65 72 28 73 71 6c 69 74  utex_enter(sqlit
1b730 65 33 5f 6d 75 74 65 78 5f 61 6c 6c 6f 63 28 53  e3_mutex_alloc(S
1b740 51 4c 49 54 45 5f 4d 55 54 45 58 5f 53 54 41 54  QLITE_MUTEX_STAT
1b750 49 43 5f 4c 52 55 29 29 3b 0a 20 20 20 20 70 50  IC_LRU));.    pP
1b760 67 20 3d 20 73 71 6c 69 74 65 33 4c 72 75 50 61  g = sqlite3LruPa
1b770 67 65 4c 69 73 74 2e 70 46 69 72 73 74 53 79 6e  geList.pFirstSyn
1b780 63 65 64 3b 0a 20 20 20 20 77 68 69 6c 65 28 20  ced;.    while( 
1b790 70 50 67 20 26 26 20 28 70 50 67 2d 3e 6e 65 65  pPg && (pPg->nee
1b7a0 64 53 79 6e 63 20 7c 7c 20 70 50 67 2d 3e 70 50  dSync || pPg->pP
1b7b0 61 67 65 72 2d 3e 69 49 6e 55 73 65 44 42 29 20  ager->iInUseDB) 
1b7c0 29 7b 0a 20 20 20 20 20 20 70 50 67 20 3d 20 70  ){.      pPg = p
1b7d0 50 67 2d 3e 67 66 72 65 65 2e 70 4e 65 78 74 3b  Pg->gfree.pNext;
1b7e0 0a 20 20 20 20 7d 0a 20 20 20 20 69 66 28 20 21  .    }.    if( !
1b7f0 70 50 67 20 29 7b 0a 20 20 20 20 20 20 70 50 67  pPg ){.      pPg
1b800 20 3d 20 73 71 6c 69 74 65 33 4c 72 75 50 61 67   = sqlite3LruPag
1b810 65 4c 69 73 74 2e 70 46 69 72 73 74 3b 0a 20 20  eList.pFirst;.  
1b820 20 20 20 20 77 68 69 6c 65 28 20 70 50 67 20 26      while( pPg &
1b830 26 20 70 50 67 2d 3e 70 50 61 67 65 72 2d 3e 69  & pPg->pPager->i
1b840 49 6e 55 73 65 44 42 20 29 7b 0a 20 20 20 20 20  InUseDB ){.     
1b850 20 20 20 70 50 67 20 3d 20 70 50 67 2d 3e 67 66     pPg = pPg->gf
1b860 72 65 65 2e 70 4e 65 78 74 3b 0a 20 20 20 20 20  ree.pNext;.     
1b870 20 7d 0a 20 20 20 20 7d 0a 20 20 20 20 73 71 6c   }.    }.    sql
1b880 69 74 65 33 5f 6d 75 74 65 78 5f 6c 65 61 76 65  ite3_mutex_leave
1b890 28 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 61  (sqlite3_mutex_a
1b8a0 6c 6c 6f 63 28 53 51 4c 49 54 45 5f 4d 55 54 45  lloc(SQLITE_MUTE
1b8b0 58 5f 53 54 41 54 49 43 5f 4c 52 55 29 29 3b 0a  X_STATIC_LRU));.
1b8c0 0a 20 20 20 20 2f 2a 20 49 66 20 70 50 67 3d 3d  .    /* If pPg==
1b8d0 30 2c 20 74 68 65 6e 20 74 68 65 20 62 6c 6f 63  0, then the bloc
1b8e0 6b 20 61 62 6f 76 65 20 68 61 73 20 66 61 69 6c  k above has fail
1b8f0 65 64 20 74 6f 20 66 69 6e 64 20 61 20 70 61 67  ed to find a pag
1b900 65 20 74 6f 0a 20 20 20 20 2a 2a 20 72 65 63 79  e to.    ** recy
1b910 63 6c 65 2e 20 49 6e 20 74 68 69 73 20 63 61 73  cle. In this cas
1b920 65 20 72 65 74 75 72 6e 20 65 61 72 6c 79 20 2d  e return early -
1b930 20 6e 6f 20 66 75 72 74 68 65 72 20 6d 65 6d 6f   no further memo
1b940 72 79 20 77 69 6c 6c 0a 20 20 20 20 2a 2a 20 62  ry will.    ** b
1b950 65 20 72 65 6c 65 61 73 65 64 2e 0a 20 20 20 20  e released..    
1b960 2a 2f 0a 20 20 20 20 69 66 28 20 21 70 50 67 20  */.    if( !pPg 
1b970 29 20 62 72 65 61 6b 3b 0a 0a 20 20 20 20 70 50  ) break;..    pP
1b980 61 67 65 72 20 3d 20 70 50 67 2d 3e 70 50 61 67  ager = pPg->pPag
1b990 65 72 3b 0a 20 20 20 20 61 73 73 65 72 74 28 21  er;.    assert(!
1b9a0 70 50 67 2d 3e 6e 65 65 64 53 79 6e 63 20 7c 7c  pPg->needSync ||
1b9b0 20 70 50 67 3d 3d 70 50 61 67 65 72 2d 3e 6c 72   pPg==pPager->lr
1b9c0 75 2e 70 46 69 72 73 74 29 3b 0a 20 20 20 20 61  u.pFirst);.    a
1b9d0 73 73 65 72 74 28 70 50 67 2d 3e 6e 65 65 64 53  ssert(pPg->needS
1b9e0 79 6e 63 20 7c 7c 20 70 50 67 3d 3d 70 50 61 67  ync || pPg==pPag
1b9f0 65 72 2d 3e 6c 72 75 2e 70 46 69 72 73 74 53 79  er->lru.pFirstSy
1ba00 6e 63 65 64 29 3b 0a 20 20 0a 20 20 20 20 73 61  nced);.  .    sa
1ba10 76 65 64 42 75 73 79 20 3d 20 70 50 61 67 65 72  vedBusy = pPager
1ba20 2d 3e 70 42 75 73 79 48 61 6e 64 6c 65 72 3b 0a  ->pBusyHandler;.
1ba30 20 20 20 20 70 50 61 67 65 72 2d 3e 70 42 75 73      pPager->pBus
1ba40 79 48 61 6e 64 6c 65 72 20 3d 20 30 3b 0a 20 20  yHandler = 0;.  
1ba50 20 20 72 63 20 3d 20 70 61 67 65 72 5f 72 65 63    rc = pager_rec
1ba60 79 63 6c 65 28 70 50 61 67 65 72 2c 20 26 70 52  ycle(pPager, &pR
1ba70 65 63 79 63 6c 65 64 29 3b 0a 20 20 20 20 70 50  ecycled);.    pP
1ba80 61 67 65 72 2d 3e 70 42 75 73 79 48 61 6e 64 6c  ager->pBusyHandl
1ba90 65 72 20 3d 20 73 61 76 65 64 42 75 73 79 3b 0a  er = savedBusy;.
1baa0 20 20 20 20 61 73 73 65 72 74 28 70 52 65 63 79      assert(pRecy
1bab0 63 6c 65 64 3d 3d 70 50 67 20 7c 7c 20 72 63 21  cled==pPg || rc!
1bac0 3d 53 51 4c 49 54 45 5f 4f 4b 29 3b 0a 20 20 20  =SQLITE_OK);.   
1bad0 20 69 66 28 20 72 63 3d 3d 53 51 4c 49 54 45 5f   if( rc==SQLITE_
1bae0 4f 4b 20 29 7b 0a 20 20 20 20 20 20 2f 2a 20 57  OK ){.      /* W
1baf0 65 27 76 65 20 66 6f 75 6e 64 20 61 20 70 61 67  e've found a pag
1bb00 65 20 74 6f 20 66 72 65 65 2e 20 41 74 20 74 68  e to free. At th
1bb10 69 73 20 70 6f 69 6e 74 20 74 68 65 20 70 61 67  is point the pag
1bb20 65 20 68 61 73 20 62 65 65 6e 20 0a 20 20 20 20  e has been .    
1bb30 20 20 2a 2a 20 72 65 6d 6f 76 65 64 20 66 72 6f    ** removed fro
1bb40 6d 20 74 68 65 20 70 61 67 65 20 68 61 73 68 2d  m the page hash-
1bb50 74 61 62 6c 65 2c 20 66 72 65 65 2d 6c 69 73 74  table, free-list
1bb60 20 61 6e 64 20 73 79 6e 63 65 64 2d 6c 69 73 74   and synced-list
1bb70 20 0a 20 20 20 20 20 20 2a 2a 20 28 70 46 69 72   .      ** (pFir
1bb80 73 74 53 79 6e 63 65 64 29 2e 20 49 74 20 69 73  stSynced). It is
1bb90 20 73 74 69 6c 6c 20 69 6e 20 74 68 65 20 61 6c   still in the al
1bba0 6c 20 70 61 67 65 73 20 28 70 41 6c 6c 29 20 6c  l pages (pAll) l
1bbb0 69 73 74 2e 20 0a 20 20 20 20 20 20 2a 2a 20 52  ist. .      ** R
1bbc0 65 6d 6f 76 65 20 69 74 20 66 72 6f 6d 20 74 68  emove it from th
1bbd0 69 73 20 6c 69 73 74 20 62 65 66 6f 72 65 20 66  is list before f
1bbe0 72 65 65 69 6e 67 2e 0a 20 20 20 20 20 20 2a 2a  reeing..      **
1bbf0 0a 20 20 20 20 20 20 2a 2a 20 54 6f 64 6f 3a 20  .      ** Todo: 
1bc00 43 68 65 63 6b 20 74 68 65 20 50 61 67 65 72 2e  Check the Pager.
1bc10 70 53 74 6d 74 20 6c 69 73 74 20 74 6f 20 6d 61  pStmt list to ma
1bc20 6b 65 20 73 75 72 65 20 74 68 69 73 20 69 73 20  ke sure this is 
1bc30 4f 6b 2e 20 49 74 20 0a 20 20 20 20 20 20 2a 2a  Ok. It .      **
1bc40 20 70 72 6f 62 61 62 6c 79 20 69 73 20 74 68 6f   probably is tho
1bc50 75 67 68 2e 0a 20 20 20 20 20 20 2a 2f 0a 20 20  ugh..      */.  
1bc60 20 20 20 20 50 67 48 64 72 20 2a 70 54 6d 70 3b      PgHdr *pTmp;
1bc70 0a 20 20 20 20 20 20 61 73 73 65 72 74 28 20 70  .      assert( p
1bc80 50 67 20 29 3b 0a 20 20 20 20 20 20 69 66 28 20  Pg );.      if( 
1bc90 70 50 67 3d 3d 70 50 61 67 65 72 2d 3e 70 41 6c  pPg==pPager->pAl
1bca0 6c 20 29 7b 0a 20 20 20 20 20 20 20 20 20 70 50  l ){.         pP
1bcb0 61 67 65 72 2d 3e 70 41 6c 6c 20 3d 20 70 50 67  ager->pAll = pPg
1bcc0 2d 3e 70 4e 65 78 74 41 6c 6c 3b 0a 20 20 20 20  ->pNextAll;.    
1bcd0 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 20 20 20    }else{.       
1bce0 20 66 6f 72 28 20 70 54 6d 70 3d 70 50 61 67 65   for( pTmp=pPage
1bcf0 72 2d 3e 70 41 6c 6c 3b 20 70 54 6d 70 2d 3e 70  r->pAll; pTmp->p
1bd00 4e 65 78 74 41 6c 6c 21 3d 70 50 67 3b 20 70 54  NextAll!=pPg; pT
1bd10 6d 70 3d 70 54 6d 70 2d 3e 70 4e 65 78 74 41 6c  mp=pTmp->pNextAl
1bd20 6c 20 29 7b 7d 0a 20 20 20 20 20 20 20 20 70 54  l ){}.        pT
1bd30 6d 70 2d 3e 70 4e 65 78 74 41 6c 6c 20 3d 20 70  mp->pNextAll = p
1bd40 50 67 2d 3e 70 4e 65 78 74 41 6c 6c 3b 0a 20 20  Pg->pNextAll;.  
1bd50 20 20 20 20 7d 0a 20 20 20 20 20 20 6e 52 65 6c      }.      nRel
1bd60 65 61 73 65 64 20 2b 3d 20 28 0a 20 20 20 20 20  eased += (.     
1bd70 20 20 20 20 20 73 69 7a 65 6f 66 28 2a 70 50 67       sizeof(*pPg
1bd80 29 20 2b 20 70 50 61 67 65 72 2d 3e 70 61 67 65  ) + pPager->page
1bd90 53 69 7a 65 0a 20 20 20 20 20 20 20 20 20 20 2b  Size.          +
1bda0 20 73 69 7a 65 6f 66 28 75 33 32 29 20 2b 20 70   sizeof(u32) + p
1bdb0 50 61 67 65 72 2d 3e 6e 45 78 74 72 61 0a 20 20  Pager->nExtra.  
1bdc0 20 20 20 20 20 20 20 20 2b 20 4d 45 4d 44 42 2a          + MEMDB*
1bdd0 73 69 7a 65 6f 66 28 50 67 48 69 73 74 6f 72 79  sizeof(PgHistory
1bde0 29 20 0a 20 20 20 20 20 20 29 3b 0a 20 20 20 20  ) .      );.    
1bdf0 20 20 49 4f 54 52 41 43 45 28 28 22 50 47 46 52    IOTRACE(("PGFR
1be00 45 45 20 25 70 20 25 64 20 2a 5c 6e 22 2c 20 70  EE %p %d *\n", p
1be10 50 61 67 65 72 2c 20 70 50 67 2d 3e 70 67 6e 6f  Pager, pPg->pgno
1be20 29 29 3b 0a 20 20 20 20 20 20 50 41 47 45 52 5f  ));.      PAGER_
1be30 49 4e 43 52 28 73 71 6c 69 74 65 33 5f 70 61 67  INCR(sqlite3_pag
1be40 65 72 5f 70 67 66 72 65 65 5f 63 6f 75 6e 74 29  er_pgfree_count)
1be50 3b 0a 20 20 20 20 20 20 73 71 6c 69 74 65 33 5f  ;.      sqlite3_
1be60 66 72 65 65 28 70 50 67 2d 3e 70 44 61 74 61 29  free(pPg->pData)
1be70 3b 0a 20 20 20 20 20 20 73 71 6c 69 74 65 33 5f  ;.      sqlite3_
1be80 66 72 65 65 28 70 50 67 29 3b 0a 20 20 20 20 20  free(pPg);.     
1be90 20 70 50 61 67 65 72 2d 3e 6e 50 61 67 65 2d 2d   pPager->nPage--
1bea0 3b 0a 20 20 20 20 7d 65 6c 73 65 7b 0a 20 20 20  ;.    }else{.   
1beb0 20 20 20 2f 2a 20 41 6e 20 65 72 72 6f 72 20 6f     /* An error o
1bec0 63 63 75 72 65 64 20 77 68 69 6c 73 74 20 77 72  ccured whilst wr
1bed0 69 74 69 6e 67 20 74 6f 20 74 68 65 20 64 61 74  iting to the dat
1bee0 61 62 61 73 65 20 66 69 6c 65 20 6f 72 20 0a 20  abase file or . 
1bef0 20 20 20 20 20 2a 2a 20 6a 6f 75 72 6e 61 6c 20       ** journal 
1bf00 69 6e 20 70 61 67 65 72 5f 72 65 63 79 63 6c 65  in pager_recycle
1bf10 28 29 2e 20 54 68 65 20 65 72 72 6f 72 20 69 73  (). The error is
1bf20 20 6e 6f 74 20 72 65 74 75 72 6e 65 64 20 74 6f   not returned to
1bf30 20 74 68 65 20 0a 20 20 20 20 20 20 2a 2a 20 63   the .      ** c
1bf40 61 6c 6c 65 72 20 6f 66 20 74 68 69 73 20 66 75  aller of this fu
1bf50 6e 63 74 69 6f 6e 2e 20 49 6e 73 74 65 61 64 2c  nction. Instead,
1bf60 20 73 65 74 20 74 68 65 20 50 61 67 65 72 2e 65   set the Pager.e
1bf70 72 72 43 6f 64 65 20 76 61 72 69 61 62 6c 65 2e  rrCode variable.
1bf80 0a 20 20 20 20 20 20 2a 2a 20 54 68 65 20 65 72  .      ** The er
1bf90 72 6f 72 20 77 69 6c 6c 20 62 65 20 72 65 74 75  ror will be retu
1bfa0 72 6e 65 64 20 74 6f 20 74 68 65 20 75 73 65 72  rned to the user
1bfb0 20 28 6f 72 20 75 73 65 72 73 2c 20 69 6e 20 74   (or users, in t
1bfc0 68 65 20 63 61 73 65 20 0a 20 20 20 20 20 20 2a  he case .      *
1bfd0 2a 20 6f 66 20 61 20 73 68 61 72 65 64 20 70 61  * of a shared pa
1bfe0 67 65 72 20 63 61 63 68 65 29 20 6f 66 20 74 68  ger cache) of th
1bff0 65 20 70 61 67 65 72 20 66 6f 72 20 77 68 69 63  e pager for whic
1c000 68 20 74 68 65 20 65 72 72 6f 72 20 6f 63 63 75  h the error occu
1c010 72 65 64 2e 0a 20 20 20 20 20 20 2a 2f 0a 20 20  red..      */.  
1c020 20 20 20 20 61 73 73 65 72 74 28 0a 20 20 20 20      assert(.    
1c030 20 20 20 20 20 20 28 72 63 26 30 78 66 66 29 3d        (rc&0xff)=
1c040 3d 53 51 4c 49 54 45 5f 49 4f 45 52 52 20 7c 7c  =SQLITE_IOERR ||
1c050 0a 20 20 20 20 20 20 20 20 20 20 72 63 3d 3d 53  .          rc==S
1c060 51 4c 49 54 45 5f 46 55 4c 4c 20 7c 7c 0a 20 20  QLITE_FULL ||.  
1c070 20 20 20 20 20 20 20 20 72 63 3d 3d 53 51 4c 49          rc==SQLI
1c080 54 45 5f 42 55 53 59 0a 20 20 20 20 20 20 29 3b  TE_BUSY.      );
1c090 0a 20 20 20 20 20 20 61 73 73 65 72 74 28 20 70  .      assert( p
1c0a0 50 61 67 65 72 2d 3e 73 74 61 74 65 3e 3d 50 41  Pager->state>=PA
1c0b0 47 45 52 5f 52 45 53 45 52 56 45 44 20 29 3b 0a  GER_RESERVED );.
1c0c0 20 20 20 20 20 20 70 61 67 65 72 5f 65 72 72 6f        pager_erro
1c0d0 72 28 70 50 61 67 65 72 2c 20 72 63 29 3b 0a 20  r(pPager, rc);. 
1c0e0 20 20 20 7d 0a 20 20 7d 0a 0a 20 20 2f 2a 20 43     }.  }..  /* C
1c0f0 6c 65 61 72 20 74 68 65 20 6d 65 6d 6f 72 79 20  lear the memory 
1c100 6d 61 6e 61 67 65 6d 65 6e 74 20 66 6c 61 67 73  management flags
1c110 20 61 6e 64 20 72 65 6c 65 61 73 65 20 74 68 65   and release the
1c120 20 6d 75 74 65 78 0a 20 20 2a 2f 0a 20 20 66 6f   mutex.  */.  fo
1c130 72 28 70 50 61 67 65 72 3d 73 71 6c 69 74 65 33  r(pPager=sqlite3
1c140 50 61 67 65 72 4c 69 73 74 3b 20 70 50 61 67 65  PagerList; pPage
1c150 72 3b 20 70 50 61 67 65 72 3d 70 50 61 67 65 72  r; pPager=pPager
1c160 2d 3e 70 4e 65 78 74 29 7b 0a 20 20 20 20 20 70  ->pNext){.     p
1c170 50 61 67 65 72 2d 3e 69 49 6e 55 73 65 4d 4d 20  Pager->iInUseMM 
1c180 3d 20 30 3b 0a 20 20 7d 0a 20 20 73 71 6c 69 74  = 0;.  }.  sqlit
1c190 65 33 5f 6d 75 74 65 78 5f 6c 65 61 76 65 28 6d  e3_mutex_leave(m
1c1a0 75 74 65 78 29 3b 0a 0a 20 20 2f 2a 20 52 65 74  utex);..  /* Ret
1c1b0 75 72 6e 20 74 68 65 20 6e 75 6d 62 65 72 20 6f  urn the number o
1c1c0 66 20 62 79 74 65 73 20 72 65 6c 65 61 73 65 64  f bytes released
1c1d0 0a 20 20 2a 2f 0a 20 20 72 65 74 75 72 6e 20 6e  .  */.  return n
1c1e0 52 65 6c 65 61 73 65 64 3b 0a 7d 0a 23 65 6e 64  Released;.}.#end
1c1f0 69 66 20 2f 2a 20 53 51 4c 49 54 45 5f 45 4e 41  if /* SQLITE_ENA
1c200 42 4c 45 5f 4d 45 4d 4f 52 59 5f 4d 41 4e 41 47  BLE_MEMORY_MANAG
1c210 45 4d 45 4e 54 20 2a 2f 0a 0a 2f 2a 0a 2a 2a 20  EMENT */../*.** 
1c220 52 65 61 64 20 74 68 65 20 63 6f 6e 74 65 6e 74  Read the content
1c230 20 6f 66 20 70 61 67 65 20 70 50 67 20 6f 75 74   of page pPg out
1c240 20 6f 66 20 74 68 65 20 64 61 74 61 62 61 73 65   of the database
1c250 20 66 69 6c 65 2e 0a 2a 2f 0a 73 74 61 74 69 63   file..*/.static
1c260 20 69 6e 74 20 72 65 61 64 44 62 50 61 67 65 28   int readDbPage(
1c270 50 61 67 65 72 20 2a 70 50 61 67 65 72 2c 20 50  Pager *pPager, P
1c280 67 48 64 72 20 2a 70 50 67 2c 20 50 67 6e 6f 20  gHdr *pPg, Pgno 
1c290 70 67 6e 6f 29 7b 0a 20 20 69 6e 74 20 72 63 3b  pgno){.  int rc;
1c2a0 0a 20 20 69 36 34 20 6f 66 66 73 65 74 3b 0a 20  .  i64 offset;. 
1c2b0 20 61 73 73 65 72 74 28 20 4d 45 4d 44 42 3d 3d   assert( MEMDB==
1c2c0 30 20 29 3b 0a 20 20 61 73 73 65 72 74 28 70 50  0 );.  assert(pP
1c2d0 61 67 65 72 2d 3e 66 64 2d 3e 70 4d 65 74 68 6f  ager->fd->pMetho
1c2e0 64 73 7c 7c 70 50 61 67 65 72 2d 3e 74 65 6d 70  ds||pPager->temp
1c2f0 46 69 6c 65 29 3b 0a 20 20 69 66 28 20 21 70 50  File);.  if( !pP
1c300 61 67 65 72 2d 3e 66 64 2d 3e 70 4d 65 74 68 6f  ager->fd->pMetho
1c310 64 73 20 29 7b 0a 20 20 20 20 72 65 74 75 72 6e  ds ){.    return
1c320 20 53 51 4c 49 54 45 5f 49 4f 45 52 52 5f 53 48   SQLITE_IOERR_SH
1c330 4f 52 54 5f 52 45 41 44 3b 0a 20 20 7d 0a 20 20  ORT_READ;.  }.  
1c340 6f 66 66 73 65 74 20 3d 20 28 70 67 6e 6f 2d 31  offset = (pgno-1
1c350 29 2a 28 69 36 34 29 70 50 61 67 65 72 2d 3e 70  )*(i64)pPager->p
1c360 61 67 65 53 69 7a 65 3b 0a 20 20 72 63 20 3d 20  ageSize;.  rc = 
1c370 73 71 6c 69 74 65 33 4f 73 52 65 61 64 28 70 50  sqlite3OsRead(pP
1c380 61 67 65 72 2d 3e 66 64 2c 20 50 47 48 44 52 5f  ager->fd, PGHDR_
1c390 54 4f 5f 44 41 54 41 28 70 50 67 29 2c 20 70 50  TO_DATA(pPg), pP
1c3a0 61 67 65 72 2d 3e 70 61 67 65 53 69 7a 65 2c 20  ager->pageSize, 
1c3b0 6f 66 66 73 65 74 29 3b 0a 20 20 50 41 47 45 52  offset);.  PAGER
1c3c0 5f 49 4e 43 52 28 73 71 6c 69 74 65 33 5f 70 61  _INCR(sqlite3_pa
1c3d0 67 65 72 5f 72 65 61 64 64 62 5f 63 6f 75 6e 74  ger_readdb_count
1c3e0 29 3b 0a 20 20 50 41 47 45 52 5f 49 4e 43 52 28  );.  PAGER_INCR(
1c3f0 70 50 61 67 65 72 2d 3e 6e 52 65 61 64 29 3b 0a  pPager->nRead);.
1c400 20 20 49 4f 54 52 41 43 45 28 28 22 50 47 49 4e    IOTRACE(("PGIN
1c410 20 25 70 20 25 64 5c 6e 22 2c 20 70 50 61 67 65   %p %d\n", pPage
1c420 72 2c 20 70 67 6e 6f 29 29 3b 0a 20 20 69 66 28  r, pgno));.  if(
1c430 20 70 67 6e 6f 3d 3d 31 20 29 7b 0a 20 20 20 20   pgno==1 ){.    
1c440 6d 65 6d 63 70 79 28 26 70 50 61 67 65 72 2d 3e  memcpy(&pPager->
1c450 64 62 46 69 6c 65 56 65 72 73 2c 20 26 28 28 75  dbFileVers, &((u
1c460 38 2a 29 50 47 48 44 52 5f 54 4f 5f 44 41 54 41  8*)PGHDR_TO_DATA
1c470 28 70 50 67 29 29 5b 32 34 5d 2c 0a 20 20 20 20  (pPg))[24],.    
1c480 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
1c490 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
1c4a0 20 20 20 20 20 20 20 20 20 20 73 69 7a 65 6f 66            sizeof
1c4b0 28 70 50 61 67 65 72 2d 3e 64 62 46 69 6c 65 56  (pPager->dbFileV
1c4c0 65 72 73 29 29 3b 0a 20 20 7d 0a 20 20 43 4f 44  ers));.  }.  COD
1c4d0 45 43 31 28 70 50 61 67 65 72 2c 20 50 47 48 44  EC1(pPager, PGHD
1c4e0 52 5f 54 4f 5f 44 41 54 41 28 70 50 67 29 2c 20  R_TO_DATA(pPg), 
1c4f0 70 50 67 2d 3e 70 67 6e 6f 2c 20 33 29 3b 0a 20  pPg->pgno, 3);. 
1c500 20 50 41 47 45 52 54 52 41 43 45 34 28 22 46 45   PAGERTRACE4("FE
1c510 54 43 48 20 25 64 20 70 61 67 65 20 25 64 20 68  TCH %d page %d h
1c520 61 73 68 28 25 30 38 78 29 5c 6e 22 2c 0a 20 20  ash(%08x)\n",.  
1c530 20 20 20 20 20 20 20 20 20 20 20 20 20 50 41 47               PAG
1c540 45 52 49 44 28 70 50 61 67 65 72 29 2c 20 70 50  ERID(pPager), pP
1c550 67 2d 3e 70 67 6e 6f 2c 20 70 61 67 65 72 5f 70  g->pgno, pager_p
1c560 61 67 65 68 61 73 68 28 70 50 67 29 29 3b 0a 20  agehash(pPg));. 
1c570 20 72 65 74 75 72 6e 20 72 63 3b 0a 7d 0a 0a 0a   return rc;.}...
1c580 2f 2a 0a 2a 2a 20 54 68 69 73 20 66 75 6e 63 74  /*.** This funct
1c590 69 6f 6e 20 69 73 20 63 61 6c 6c 65 64 20 74 6f  ion is called to
1c5a0 20 6f 62 74 61 69 6e 20 74 68 65 20 73 68 61 72   obtain the shar
1c5b0 65 64 20 6c 6f 63 6b 20 72 65 71 75 69 72 65 64  ed lock required
1c5c0 20 62 65 66 6f 72 65 0a 2a 2a 20 64 61 74 61 20   before.** data 
1c5d0 6d 61 79 20 62 65 20 72 65 61 64 20 66 72 6f 6d  may be read from
1c5e0 20 74 68 65 20 70 61 67 65 72 20 63 61 63 68 65   the pager cache
1c5f0 2e 20 49 66 20 74 68 65 20 73 68 61 72 65 64 20  . If the shared 
1c600 6c 6f 63 6b 20 68 61 73 20 61 6c 72 65 61 64 79  lock has already
1c610 0a 2a 2a 20 62 65 65 6e 20 6f 62 74 61 69 6e 65  .** been obtaine
1c620 64 2c 20 74 68 69 73 20 66 75 6e 63 74 69 6f 6e  d, this function
1c630 20 69 73 20 61 20 6e 6f 2d 6f 70 2e 0a 2a 2a 0a   is a no-op..**.
1c640 2a 2a 20 49 6d 6d 65 64 69 61 74 65 6c 79 20 61  ** Immediately a
1c650 66 74 65 72 20 6f 62 74 61 69 6e 69 6e 67 20 74  fter obtaining t
1c660 68 65 20 73 68 61 72 65 64 20 6c 6f 63 6b 20 28  he shared lock (
1c670 69 66 20 72 65 71 75 69 72 65 64 29 2c 20 74 68  if required), th
1c680 69 73 20 66 75 6e 63 74 69 6f 6e 0a 2a 2a 20 63  is function.** c
1c690 68 65 63 6b 73 20 66 6f 72 20 61 20 68 6f 74 2d  hecks for a hot-
1c6a0 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 2e 20 49 66  journal file. If
1c6b0 20 6f 6e 65 20 69 73 20 66 6f 75 6e 64 2c 20 61   one is found, a
1c6c0 6e 20 65 6d 65 72 67 65 6e 63 79 20 72 6f 6c 6c  n emergency roll
1c6d0 62 61 63 6b 0a 2a 2a 20 69 73 20 70 65 72 66 6f  back.** is perfo
1c6e0 72 6d 65 64 20 69 6d 6d 65 64 69 61 74 65 6c 79  rmed immediately
1c6f0 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74 20  ..*/.static int 
1c700 70 61 67 65 72 53 68 61 72 65 64 4c 6f 63 6b 28  pagerSharedLock(
1c710 50 61 67 65 72 20 2a 70 50 61 67 65 72 29 7b 0a  Pager *pPager){.
1c720 20 20 69 6e 74 20 72 63 20 3d 20 53 51 4c 49 54    int rc = SQLIT
1c730 45 5f 4f 4b 3b 0a 20 20 69 6e 74 20 69 73 48 6f  E_OK;.  int isHo
1c740 74 20 3d 20 30 3b 0a 0a 20 20 2f 2a 20 49 66 20  t = 0;..  /* If 
1c750 74 68 69 73 20 64 61 74 61 62 61 73 65 20 69 73  this database is
1c760 20 6f 70 65 6e 65 64 20 66 6f 72 20 65 78 63 6c   opened for excl
1c770 75 73 69 76 65 20 61 63 63 65 73 73 2c 20 68 61  usive access, ha
1c780 73 20 6e 6f 20 6f 75 74 73 74 61 6e 64 69 6e 67  s no outstanding
1c790 20 0a 20 20 2a 2a 20 70 61 67 65 20 72 65 66 65   .  ** page refe
1c7a0 72 65 6e 63 65 73 20 61 6e 64 20 69 73 20 69 6e  rences and is in
1c7b0 20 61 6e 20 65 72 72 6f 72 2d 73 74 61 74 65 2c   an error-state,
1c7c0 20 6e 6f 77 20 69 73 20 74 68 65 20 63 68 61 6e   now is the chan
1c7d0 63 65 20 74 6f 20 63 6c 65 61 72 0a 20 20 2a 2a  ce to clear.  **
1c7e0 20 74 68 65 20 65 72 72 6f 72 2e 20 44 69 73 63   the error. Disc
1c7f0 61 72 64 20 74 68 65 20 63 6f 6e 74 65 6e 74 73  ard the contents
1c800 20 6f 66 20 74 68 65 20 70 61 67 65 72 2d 63 61   of the pager-ca
1c810 63 68 65 20 61 6e 64 20 74 72 65 61 74 20 61 6e  che and treat an
1c820 79 0a 20 20 2a 2a 20 6f 70 65 6e 20 6a 6f 75 72  y.  ** open jour
1c830 6e 61 6c 20 66 69 6c 65 20 61 73 20 61 20 68 6f  nal file as a ho
1c840 74 2d 6a 6f 75 72 6e 61 6c 2e 0a 20 20 2a 2f 0a  t-journal..  */.
1c850 20 20 69 66 28 20 21 4d 45 4d 44 42 20 26 26 20    if( !MEMDB && 
1c860 70 50 61 67 65 72 2d 3e 65 78 63 6c 75 73 69 76  pPager->exclusiv
1c870 65 4d 6f 64 65 20 26 26 20 70 50 61 67 65 72 2d  eMode && pPager-
1c880 3e 6e 52 65 66 3d 3d 30 20 26 26 20 70 50 61 67  >nRef==0 && pPag
1c890 65 72 2d 3e 65 72 72 43 6f 64 65 20 29 7b 0a 20  er->errCode ){. 
1c8a0 20 20 20 69 66 28 20 70 50 61 67 65 72 2d 3e 6a     if( pPager->j
1c8b0 6f 75 72 6e 61 6c 4f 70 65 6e 20 29 7b 0a 20 20  ournalOpen ){.  
1c8c0 20 20 20 20 69 73 48 6f 74 20 3d 20 31 3b 0a 20      isHot = 1;. 
1c8d0 20 20 20 7d 0a 20 20 20 20 70 61 67 65 72 5f 72     }.    pager_r
1c8e0 65 73 65 74 28 70 50 61 67 65 72 29 3b 0a 20 20  eset(pPager);.  
1c8f0 20 20 70 50 61 67 65 72 2d 3e 65 72 72 43 6f 64    pPager->errCod
1c900 65 20 3d 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20  e = SQLITE_OK;. 
1c910 20 7d 0a 0a 20 20 2f 2a 20 49 66 20 74 68 65 20   }..  /* If the 
1c920 70 61 67 65 72 20 69 73 20 73 74 69 6c 6c 20 69  pager is still i
1c930 6e 20 61 6e 20 65 72 72 6f 72 20 73 74 61 74 65  n an error state
1c940 2c 20 64 6f 20 6e 6f 74 20 70 72 6f 63 65 65 64  , do not proceed
1c950 2e 20 54 68 65 20 65 72 72 6f 72 20 0a 20 20 2a  . The error .  *
1c960 2a 20 73 74 61 74 65 20 77 69 6c 6c 20 62 65 20  * state will be 
1c970 63 6c 65 61 72 65 64 20 61 74 20 73 6f 6d 65 20  cleared at some 
1c980 70 6f 69 6e 74 20 69 6e 20 74 68 65 20 66 75 74  point in the fut
1c990 75 72 65 20 77 68 65 6e 20 61 6c 6c 20 70 61 67  ure when all pag
1c9a0 65 20 0a 20 20 2a 2a 20 72 65 66 65 72 65 6e 63  e .  ** referenc
1c9b0 65 73 20 61 72 65 20 64 72 6f 70 70 65 64 20 61  es are dropped a
1c9c0 6e 64 20 74 68 65 20 63 61 63 68 65 20 63 61 6e  nd the cache can
1c9d0 20 62 65 20 64 69 73 63 61 72 64 65 64 2e 0a 20   be discarded.. 
1c9e0 20 2a 2f 0a 20 20 69 66 28 20 70 50 61 67 65 72   */.  if( pPager
1c9f0 2d 3e 65 72 72 43 6f 64 65 20 26 26 20 70 50 61  ->errCode && pPa
1ca00 67 65 72 2d 3e 65 72 72 43 6f 64 65 21 3d 53 51  ger->errCode!=SQ
1ca10 4c 49 54 45 5f 46 55 4c 4c 20 29 7b 0a 20 20 20  LITE_FULL ){.   
1ca20 20 72 65 74 75 72 6e 20 70 50 61 67 65 72 2d 3e   return pPager->
1ca30 65 72 72 43 6f 64 65 3b 0a 20 20 7d 0a 0a 20 20  errCode;.  }..  
1ca40 69 66 28 20 70 50 61 67 65 72 2d 3e 73 74 61 74  if( pPager->stat
1ca50 65 3d 3d 50 41 47 45 52 5f 55 4e 4c 4f 43 4b 20  e==PAGER_UNLOCK 
1ca60 7c 7c 20 69 73 48 6f 74 20 29 7b 0a 20 20 20 20  || isHot ){.    
1ca70 73 71 6c 69 74 65 33 5f 76 66 73 20 2a 70 56 66  sqlite3_vfs *pVf
1ca80 73 20 3d 20 70 50 61 67 65 72 2d 3e 70 56 66 73  s = pPager->pVfs
1ca90 3b 0a 20 20 20 20 69 66 28 20 21 4d 45 4d 44 42  ;.    if( !MEMDB
1caa0 20 29 7b 0a 20 20 20 20 20 20 61 73 73 65 72 74   ){.      assert
1cab0 28 20 70 50 61 67 65 72 2d 3e 6e 52 65 66 3d 3d  ( pPager->nRef==
1cac0 30 20 29 3b 0a 20 20 20 20 20 20 69 66 28 20 21  0 );.      if( !
1cad0 70 50 61 67 65 72 2d 3e 6e 6f 52 65 61 64 6c 6f  pPager->noReadlo
1cae0 63 6b 20 29 7b 0a 20 20 20 20 20 20 20 20 72 63  ck ){.        rc
1caf0 20 3d 20 70 61 67 65 72 5f 77 61 69 74 5f 6f 6e   = pager_wait_on
1cb00 5f 6c 6f 63 6b 28 70 50 61 67 65 72 2c 20 53 48  _lock(pPager, SH
1cb10 41 52 45 44 5f 4c 4f 43 4b 29 3b 0a 20 20 20 20  ARED_LOCK);.    
1cb20 20 20 20 20 69 66 28 20 72 63 21 3d 53 51 4c 49      if( rc!=SQLI
1cb30 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 20 20 20  TE_OK ){.       
1cb40 20 20 20 72 65 74 75 72 6e 20 70 61 67 65 72 5f     return pager_
1cb50 65 72 72 6f 72 28 70 50 61 67 65 72 2c 20 72 63  error(pPager, rc
1cb60 29 3b 0a 20 20 20 20 20 20 20 20 7d 0a 20 20 20  );.        }.   
1cb70 20 20 20 20 20 61 73 73 65 72 74 28 20 70 50 61       assert( pPa
1cb80 67 65 72 2d 3e 73 74 61 74 65 3e 3d 53 48 41 52  ger->state>=SHAR
1cb90 45 44 5f 4c 4f 43 4b 20 29 3b 0a 20 20 20 20 20  ED_LOCK );.     
1cba0 20 7d 0a 20 20 0a 20 20 20 20 20 20 2f 2a 20 49   }.  .      /* I
1cbb0 66 20 61 20 6a 6f 75 72 6e 61 6c 20 66 69 6c 65  f a journal file
1cbc0 20 65 78 69 73 74 73 2c 20 61 6e 64 20 74 68 65   exists, and the
1cbd0 72 65 20 69 73 20 6e 6f 20 52 45 53 45 52 56 45  re is no RESERVE
1cbe0 44 20 6c 6f 63 6b 20 6f 6e 20 74 68 65 0a 20 20  D lock on the.  
1cbf0 20 20 20 20 2a 2a 20 64 61 74 61 62 61 73 65 20      ** database 
1cc00 66 69 6c 65 2c 20 74 68 65 6e 20 69 74 20 65 69  file, then it ei
1cc10 74 68 65 72 20 6e 65 65 64 73 20 74 6f 20 62 65  ther needs to be
1cc20 20 70 6c 61 79 65 64 20 62 61 63 6b 20 6f 72 20   played back or 
1cc30 64 65 6c 65 74 65 64 2e 0a 20 20 20 20 20 20 2a  deleted..      *
1cc40 2f 0a 20 20 20 20 20 20 72 63 20 3d 20 68 61 73  /.      rc = has
1cc50 48 6f 74 4a 6f 75 72 6e 61 6c 28 70 50 61 67 65  HotJournal(pPage
1cc60 72 29 3b 0a 20 20 20 20 20 20 69 66 28 20 72 63  r);.      if( rc
1cc70 3c 30 20 29 7b 0a 20 20 20 20 20 20 20 20 72 65  <0 ){.        re
1cc80 74 75 72 6e 20 53 51 4c 49 54 45 5f 49 4f 45 52  turn SQLITE_IOER
1cc90 52 5f 4e 4f 4d 45 4d 3b 0a 20 20 20 20 20 20 7d  R_NOMEM;.      }
1cca0 0a 20 20 20 20 20 20 69 66 28 20 72 63 3d 3d 31  .      if( rc==1
1ccb0 20 7c 7c 20 69 73 48 6f 74 20 29 7b 0a 20 20 20   || isHot ){.   
1ccc0 20 20 20 20 20 2f 2a 20 47 65 74 20 61 6e 20 45       /* Get an E
1ccd0 58 43 4c 55 53 49 56 45 20 6c 6f 63 6b 20 6f 6e  XCLUSIVE lock on
1cce0 20 74 68 65 20 64 61 74 61 62 61 73 65 20 66 69   the database fi
1ccf0 6c 65 2e 20 41 74 20 74 68 69 73 20 70 6f 69 6e  le. At this poin
1cd00 74 20 69 74 20 69 73 0a 20 20 20 20 20 20 20 20  t it is.        
1cd10 2a 2a 20 69 6d 70 6f 72 74 61 6e 74 20 74 68 61  ** important tha
1cd20 74 20 61 20 52 45 53 45 52 56 45 44 20 6c 6f 63  t a RESERVED loc
1cd30 6b 20 69 73 20 6e 6f 74 20 6f 62 74 61 69 6e 65  k is not obtaine
1cd40 64 20 6f 6e 20 74 68 65 20 77 61 79 20 74 6f 20  d on the way to 
1cd50 74 68 65 0a 20 20 20 20 20 20 20 20 2a 2a 20 45  the.        ** E
1cd60 58 43 4c 55 53 49 56 45 20 6c 6f 63 6b 2e 20 49  XCLUSIVE lock. I
1cd70 66 20 69 74 20 77 65 72 65 2c 20 61 6e 6f 74 68  f it were, anoth
1cd80 65 72 20 70 72 6f 63 65 73 73 20 6d 69 67 68 74  er process might
1cd90 20 6f 70 65 6e 20 74 68 65 0a 20 20 20 20 20 20   open the.      
1cda0 20 20 2a 2a 20 64 61 74 61 62 61 73 65 20 66 69    ** database fi
1cdb0 6c 65 2c 20 64 65 74 65 63 74 20 74 68 65 20 52  le, detect the R
1cdc0 45 53 45 52 56 45 44 20 6c 6f 63 6b 2c 20 61 6e  ESERVED lock, an
1cdd0 64 20 63 6f 6e 63 6c 75 64 65 20 74 68 61 74 20  d conclude that 
1cde0 74 68 65 0a 20 20 20 20 20 20 20 20 2a 2a 20 64  the.        ** d
1cdf0 61 74 61 62 61 73 65 20 69 73 20 73 61 66 65 20  atabase is safe 
1ce00 74 6f 20 72 65 61 64 20 77 68 69 6c 65 20 74 68  to read while th
1ce10 69 73 20 70 72 6f 63 65 73 73 20 69 73 20 73 74  is process is st
1ce20 69 6c 6c 20 72 6f 6c 6c 69 6e 67 20 69 74 20 0a  ill rolling it .
1ce30 20 20 20 20 20 20 20 20 2a 2a 20 62 61 63 6b 2e          ** back.
1ce40 0a 20 20 20 20 20 20 20 20 2a 2a 20 0a 20 20 20  .        ** .   
1ce50 20 20 20 20 20 2a 2a 20 42 65 63 61 75 73 65 20       ** Because 
1ce60 74 68 65 20 69 6e 74 65 72 6d 65 64 69 61 74 65  the intermediate
1ce70 20 52 45 53 45 52 56 45 44 20 6c 6f 63 6b 20 69   RESERVED lock i
1ce80 73 20 6e 6f 74 20 72 65 71 75 65 73 74 65 64 2c  s not requested,
1ce90 20 74 68 65 0a 20 20 20 20 20 20 20 20 2a 2a 20   the.        ** 
1cea0 73 65 63 6f 6e 64 20 70 72 6f 63 65 73 73 20 77  second process w
1ceb0 69 6c 6c 20 67 65 74 20 74 6f 20 74 68 69 73 20  ill get to this 
1cec0 70 6f 69 6e 74 20 69 6e 20 74 68 65 20 63 6f 64  point in the cod
1ced0 65 20 61 6e 64 20 66 61 69 6c 20 74 6f 0a 20 20  e and fail to.  
1cee0 20 20 20 20 20 20 2a 2a 20 6f 62 74 61 69 6e 20        ** obtain 
1cef0 69 74 73 20 6f 77 6e 20 45 58 43 4c 55 53 49 56  its own EXCLUSIV
1cf00 45 20 6c 6f 63 6b 20 6f 6e 20 74 68 65 20 64 61  E lock on the da
1cf10 74 61 62 61 73 65 20 66 69 6c 65 2e 0a 20 20 20  tabase file..   
1cf20 20 20 20 20 20 2a 2f 0a 20 20 20 20 20 20 20 20       */.        
1cf30 69 66 28 20 70 50 61 67 65 72 2d 3e 73 74 61 74  if( pPager->stat
1cf40 65 3c 45 58 43 4c 55 53 49 56 45 5f 4c 4f 43 4b  e<EXCLUSIVE_LOCK
1cf50 20 29 7b 0a 20 20 20 20 20 20 20 20 20 20 72 63   ){.          rc
1cf60 20 3d 20 73 71 6c 69 74 65 33 4f 73 4c 6f 63 6b   = sqlite3OsLock
1cf70 28 70 50 61 67 65 72 2d 3e 66 64 2c 20 45 58 43  (pPager->fd, EXC
1cf80 4c 55 53 49 56 45 5f 4c 4f 43 4b 29 3b 0a 20 20  LUSIVE_LOCK);.  
1cf90 20 20 20 20 20 20 20 20 69 66 28 20 72 63 21 3d          if( rc!=
1cfa0 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20  SQLITE_OK ){.   
1cfb0 20 20 20 20 20 20 20 20 20 70 61 67 65 72 5f 75           pager_u
1cfc0 6e 6c 6f 63 6b 28 70 50 61 67 65 72 29 3b 0a 20  nlock(pPager);. 
1cfd0 20 20 20 20 20 20 20 20 20 20 20 72 65 74 75 72             retur
1cfe0 6e 20 70 61 67 65 72 5f 65 72 72 6f 72 28 70 50  n pager_error(pP
1cff0 61 67 65 72 2c 20 72 63 29 3b 0a 20 20 20 20 20  ager, rc);.     
1d000 20 20 20 20 20 7d 0a 20 20 20 20 20 20 20 20 20       }.         
1d010 20 70 50 61 67 65 72 2d 3e 73 74 61 74 65 20 3d   pPager->state =
1d020 20 50 41 47 45 52 5f 45 58 43 4c 55 53 49 56 45   PAGER_EXCLUSIVE
1d030 3b 0a 20 20 20 20 20 20 20 20 7d 0a 20 0a 20 20  ;.        }. .  
1d040 20 20 20 20 20 20 2f 2a 20 4f 70 65 6e 20 74 68        /* Open th
1d050 65 20 6a 6f 75 72 6e 61 6c 20 66 6f 72 20 72 65  e journal for re
1d060 61 64 2f 77 72 69 74 65 20 61 63 63 65 73 73 2e  ad/write access.
1d070 20 54 68 69 73 20 69 73 20 62 65 63 61 75 73 65   This is because
1d080 20 69 6e 20 0a 20 20 20 20 20 20 20 20 2a 2a 20   in .        ** 
1d090 65 78 63 6c 75 73 69 76 65 2d 61 63 63 65 73 73  exclusive-access
1d0a0 20 6d 6f 64 65 20 74 68 65 20 66 69 6c 65 20 64   mode the file d
1d0b0 65 73 63 72 69 70 74 6f 72 20 77 69 6c 6c 20 62  escriptor will b
1d0c0 65 20 6b 65 70 74 20 6f 70 65 6e 20 61 6e 64 0a  e kept open and.
1d0d0 20 20 20 20 20 20 20 20 2a 2a 20 70 6f 73 73 69          ** possi
1d0e0 62 6c 79 20 75 73 65 64 20 66 6f 72 20 61 20 74  bly used for a t
1d0f0 72 61 6e 73 61 63 74 69 6f 6e 20 6c 61 74 65 72  ransaction later
1d100 20 6f 6e 2e 20 4f 6e 20 73 6f 6d 65 20 73 79 73   on. On some sys
1d110 74 65 6d 73 2c 20 74 68 65 0a 20 20 20 20 20 20  tems, the.      
1d120 20 20 2a 2a 20 4f 73 54 72 75 6e 63 61 74 65 28    ** OsTruncate(
1d130 29 20 63 61 6c 6c 20 75 73 65 64 20 69 6e 20 65  ) call used in e
1d140 78 63 6c 75 73 69 76 65 2d 61 63 63 65 73 73 20  xclusive-access 
1d150 6d 6f 64 65 20 61 6c 73 6f 20 72 65 71 75 69 72  mode also requir
1d160 65 73 0a 20 20 20 20 20 20 20 20 2a 2a 20 61 20  es.        ** a 
1d170 72 65 61 64 2f 77 72 69 74 65 20 66 69 6c 65 20  read/write file 
1d180 68 61 6e 64 6c 65 2e 0a 20 20 20 20 20 20 20 20  handle..        
1d190 2a 2f 0a 20 20 20 20 20 20 20 20 69 66 28 20 21  */.        if( !
1d1a0 69 73 48 6f 74 20 26 26 20 70 50 61 67 65 72 2d  isHot && pPager-
1d1b0 3e 6a 6f 75 72 6e 61 6c 4f 70 65 6e 3d 3d 30 20  >journalOpen==0 
1d1c0 29 7b 0a 20 20 20 20 20 20 20 20 20 20 69 6e 74  ){.          int
1d1d0 20 72 65 73 20 3d 20 73 71 6c 69 74 65 33 4f 73   res = sqlite3Os
1d1e0 41 63 63 65 73 73 28 70 56 66 73 2c 70 50 61 67  Access(pVfs,pPag
1d1f0 65 72 2d 3e 7a 4a 6f 75 72 6e 61 6c 2c 53 51 4c  er->zJournal,SQL
1d200 49 54 45 5f 41 43 43 45 53 53 5f 45 58 49 53 54  ITE_ACCESS_EXIST
1d210 53 29 3b 0a 20 20 20 20 20 20 20 20 20 20 69 66  S);.          if
1d220 28 20 72 65 73 3d 3d 31 20 29 7b 0a 20 20 20 20  ( res==1 ){.    
1d230 20 20 20 20 20 20 20 20 69 6e 74 20 66 6f 75 74          int fout
1d240 20 3d 20 30 3b 0a 20 20 20 20 20 20 20 20 20 20   = 0;.          
1d250 20 20 69 6e 74 20 66 20 3d 20 53 51 4c 49 54 45    int f = SQLITE
1d260 5f 4f 50 45 4e 5f 52 45 41 44 57 52 49 54 45 7c  _OPEN_READWRITE|
1d270 53 51 4c 49 54 45 5f 4f 50 45 4e 5f 4d 41 49 4e  SQLITE_OPEN_MAIN
1d280 5f 4a 4f 55 52 4e 41 4c 3b 0a 20 20 20 20 20 20  _JOURNAL;.      
1d290 20 20 20 20 20 20 61 73 73 65 72 74 28 20 21 70        assert( !p
1d2a0 50 61 67 65 72 2d 3e 74 65 6d 70 46 69 6c 65 20  Pager->tempFile 
1d2b0 29 3b 0a 20 20 20 20 20 20 20 20 20 20 20 20 72  );.            r
1d2c0 63 20 3d 20 73 71 6c 69 74 65 33 4f 73 4f 70 65  c = sqlite3OsOpe
1d2d0 6e 28 70 56 66 73 2c 20 70 50 61 67 65 72 2d 3e  n(pVfs, pPager->
1d2e0 7a 4a 6f 75 72 6e 61 6c 2c 20 70 50 61 67 65 72  zJournal, pPager
1d2f0 2d 3e 6a 66 64 2c 20 66 2c 20 26 66 6f 75 74 29  ->jfd, f, &fout)
1d300 3b 0a 20 20 20 20 20 20 20 20 20 20 20 20 61 73  ;.            as
1d310 73 65 72 74 28 20 72 63 21 3d 53 51 4c 49 54 45  sert( rc!=SQLITE
1d320 5f 4f 4b 20 7c 7c 20 70 50 61 67 65 72 2d 3e 6a  _OK || pPager->j
1d330 66 64 2d 3e 70 4d 65 74 68 6f 64 73 20 29 3b 0a  fd->pMethods );.
1d340 20 20 20 20 20 20 20 20 20 20 20 20 69 66 28 20              if( 
1d350 66 6f 75 74 26 53 51 4c 49 54 45 5f 4f 50 45 4e  fout&SQLITE_OPEN
1d360 5f 52 45 41 44 4f 4e 4c 59 20 29 7b 0a 20 20 20  _READONLY ){.   
1d370 20 20 20 20 20 20 20 20 20 20 20 72 63 20 3d 20             rc = 
1d380 53 51 4c 49 54 45 5f 42 55 53 59 3b 0a 20 20 20  SQLITE_BUSY;.   
1d390 20 20 20 20 20 20 20 20 20 20 20 73 71 6c 69 74             sqlit
1d3a0 65 33 4f 73 43 6c 6f 73 65 28 70 50 61 67 65 72  e3OsClose(pPager
1d3b0 2d 3e 6a 66 64 29 3b 0a 20 20 20 20 20 20 20 20  ->jfd);.        
1d3c0 20 20 20 20 7d 0a 20 20 20 20 20 20 20 20 20 20      }.          
1d3d0 7d 65 6c 73 65 20 69 66 28 20 72 65 73 3d 3d 30  }else if( res==0
1d3e0 20 29 7b 0a 20 20 20 20 20 20 20 20 20 20 20 20   ){.            
1d3f0 2f 2a 20 49 66 20 74 68 65 20 6a 6f 75 72 6e 61  /* If the journa
1d400 6c 20 64 6f 65 73 20 6e 6f 74 20 65 78 69 73 74  l does not exist
1d410 2c 20 74 68 61 74 20 6d 65 61 6e 73 20 73 6f 6d  , that means som
1d420 65 20 6f 74 68 65 72 20 70 72 6f 63 65 73 73 0a  e other process.
1d430 20 20 20 20 20 20 20 20 20 20 20 20 2a 2a 20 68              ** h
1d440 61 73 20 61 6c 72 65 61 64 79 20 72 6f 6c 6c 65  as already rolle
1d450 64 20 69 74 20 62 61 63 6b 20 2a 2f 0a 20 20 20  d it back */.   
1d460 20 20 20 20 20 20 20 20 20 72 63 20 3d 20 53 51           rc = SQ
1d470 4c 49 54 45 5f 42 55 53 59 3b 0a 20 20 20 20 20  LITE_BUSY;.     
1d480 20 20 20 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20       }else{.    
1d490 20 20 20 20 20 20 20 20 2f 2a 20 49 66 20 73 71          /* If sq
1d4a0 6c 69 74 65 33 4f 73 41 63 63 65 73 73 28 29 20  lite3OsAccess() 
1d4b0 72 65 74 75 72 6e 73 20 61 20 6e 65 67 61 74 69  returns a negati
1d4c0 76 65 20 76 61 6c 75 65 2c 20 74 68 61 74 20 6d  ve value, that m
1d4d0 65 61 6e 73 20 69 74 0a 20 20 20 20 20 20 20 20  eans it.        
1d4e0 20 20 20 20 2a 2a 20 66 61 69 6c 65 64 20 61 20      ** failed a 
1d4f0 6d 65 6d 6f 72 79 20 61 6c 6c 6f 63 61 74 69 6f  memory allocatio
1d500 6e 20 2a 2f 0a 20 20 20 20 20 20 20 20 20 20 20  n */.           
1d510 20 72 63 20 3d 20 53 51 4c 49 54 45 5f 49 4f 45   rc = SQLITE_IOE
1d520 52 52 5f 4e 4f 4d 45 4d 3b 0a 20 20 20 20 20 20  RR_NOMEM;.      
1d530 20 20 20 20 7d 0a 20 20 20 20 20 20 20 20 7d 0a      }.        }.
1d540 20 20 20 20 20 20 20 20 69 66 28 20 72 63 21 3d          if( rc!=
1d550 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20  SQLITE_OK ){.   
1d560 20 20 20 20 20 20 20 70 61 67 65 72 5f 75 6e 6c         pager_unl
1d570 6f 63 6b 28 70 50 61 67 65 72 29 3b 0a 20 20 20  ock(pPager);.   
1d580 20 20 20 20 20 20 20 73 77 69 74 63 68 28 20 72         switch( r
1d590 63 20 29 7b 0a 20 20 20 20 20 20 20 20 20 20 20  c ){.           
1d5a0 20 63 61 73 65 20 53 51 4c 49 54 45 5f 4e 4f 4d   case SQLITE_NOM
1d5b0 45 4d 3a 0a 20 20 20 20 20 20 20 20 20 20 20 20  EM:.            
1d5c0 63 61 73 65 20 53 51 4c 49 54 45 5f 49 4f 45 52  case SQLITE_IOER
1d5d0 52 5f 55 4e 4c 4f 43 4b 3a 0a 20 20 20 20 20 20  R_UNLOCK:.      
1d5e0 20 20 20 20 20 20 63 61 73 65 20 53 51 4c 49 54        case SQLIT
1d5f0 45 5f 49 4f 45 52 52 5f 4e 4f 4d 45 4d 3a 0a 20  E_IOERR_NOMEM:. 
1d600 20 20 20 20 20 20 20 20 20 20 20 20 20 72 65 74               ret
1d610 75 72 6e 20 72 63 3b 0a 20 20 20 20 20 20 20 20  urn rc;.        
1d620 20 20 20 20 64 65 66 61 75 6c 74 3a 0a 20 20 20      default:.   
1d630 20 20 20 20 20 20 20 20 20 20 20 72 65 74 75 72             retur
1d640 6e 20 53 51 4c 49 54 45 5f 42 55 53 59 3b 0a 20  n SQLITE_BUSY;. 
1d650 20 20 20 20 20 20 20 20 20 7d 0a 20 20 20 20 20           }.     
1d660 20 20 20 7d 0a 20 20 20 20 20 20 20 20 70 50 61     }.        pPa
1d670 67 65 72 2d 3e 6a 6f 75 72 6e 61 6c 4f 70 65 6e  ger->journalOpen
1d680 20 3d 20 31 3b 0a 20 20 20 20 20 20 20 20 70 50   = 1;.        pP
1d690 61 67 65 72 2d 3e 6a 6f 75 72 6e 61 6c 53 74 61  ager->journalSta
1d6a0 72 74 65 64 20 3d 20 30 3b 0a 20 20 20 20 20 20  rted = 0;.      
1d6b0 20 20 70 50 61 67 65 72 2d 3e 6a 6f 75 72 6e 61    pPager->journa
1d6c0 6c 4f 66 66 20 3d 20 30 3b 0a 20 20 20 20 20 20  lOff = 0;.      
1d6d0 20 20 70 50 61 67 65 72 2d 3e 73 65 74 4d 61 73    pPager->setMas
1d6e0 74 65 72 20 3d 20 30 3b 0a 20 20 20 20 20 20 20  ter = 0;.       
1d6f0 20 70 50 61 67 65 72 2d 3e 6a 6f 75 72 6e 61 6c   pPager->journal
1d700 48 64 72 20 3d 20 30 3b 0a 20 0a 20 20 20 20 20  Hdr = 0;. .     
1d710 20 20 20 2f 2a 20 50 6c 61 79 62 61 63 6b 20 61     /* Playback a
1d720 6e 64 20 64 65 6c 65 74 65 20 74 68 65 20 6a 6f  nd delete the jo
1d730 75 72 6e 61 6c 2e 20 20 44 72 6f 70 20 74 68 65  urnal.  Drop the
1d740 20 64 61 74 61 62 61 73 65 20 77 72 69 74 65 0a   database write.
1d750 20 20 20 20 20 20 20 20 2a 2a 20 6c 6f 63 6b 20          ** lock 
1d760 61 6e 64 20 72 65 61 63 71 75 69 72 65 20 74 68  and reacquire th
1d770 65 20 72 65 61 64 20 6c 6f 63 6b 2e 0a 20 20 20  e read lock..   
1d780 20 20 20 20 20 2a 2f 0a 20 20 20 20 20 20 20 20       */.        
1d790 72 63 20 3d 20 70 61 67 65 72 5f 70 6c 61 79 62  rc = pager_playb
1d7a0 61 63 6b 28 70 50 61 67 65 72 2c 20 31 29 3b 0a  ack(pPager, 1);.
1d7b0 20 20 20 20 20 20 20 20 69 66 28 20 72 63 21 3d          if( rc!=
1d7c0 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20  SQLITE_OK ){.   
1d7d0 20 20 20 20 20 20 20 72 65 74 75 72 6e 20 70 61         return pa
1d7e0 67 65 72 5f 65 72 72 6f 72 28 70 50 61 67 65 72  ger_error(pPager
1d7f0 2c 20 72 63 29 3b 0a 20 20 20 20 20 20 20 20 7d  , rc);.        }
1d800 0a 20 20 20 20 20 20 20 20 61 73 73 65 72 74 28  .        assert(
1d810 70 50 61 67 65 72 2d 3e 73 74 61 74 65 3d 3d 50  pPager->state==P
1d820 41 47 45 52 5f 53 48 41 52 45 44 20 7c 7c 20 0a  AGER_SHARED || .
1d830 20 20 20 20 20 20 20 20 20 20 20 20 28 70 50 61              (pPa
1d840 67 65 72 2d 3e 65 78 63 6c 75 73 69 76 65 4d 6f  ger->exclusiveMo
1d850 64 65 20 26 26 20 70 50 61 67 65 72 2d 3e 73 74  de && pPager->st
1d860 61 74 65 3e 50 41 47 45 52 5f 53 48 41 52 45 44  ate>PAGER_SHARED
1d870 29 0a 20 20 20 20 20 20 20 20 29 3b 0a 20 20 20  ).        );.   
1d880 20 20 20 7d 0a 0a 20 20 20 20 20 20 69 66 28 20     }..      if( 
1d890 70 50 61 67 65 72 2d 3e 70 41 6c 6c 20 29 7b 0a  pPager->pAll ){.
1d8a0 20 20 20 20 20 20 20 20 2f 2a 20 54 68 65 20 73          /* The s
1d8b0 68 61 72 65 64 2d 6c 6f 63 6b 20 68 61 73 20 6a  hared-lock has j
1d8c0 75 73 74 20 62 65 65 6e 20 61 63 71 75 69 72 65  ust been acquire
1d8d0 64 20 6f 6e 20 74 68 65 20 64 61 74 61 62 61 73  d on the databas
1d8e0 65 20 66 69 6c 65 0a 20 20 20 20 20 20 20 20 2a  e file.        *
1d8f0 2a 20 61 6e 64 20 74 68 65 72 65 20 61 72 65 20  * and there are 
1d900 61 6c 72 65 61 64 79 20 70 61 67 65 73 20 69 6e  already pages in
1d910 20 74 68 65 20 63 61 63 68 65 20 28 66 72 6f 6d   the cache (from
1d920 20 61 20 70 72 65 76 69 6f 75 73 0a 20 20 20 20   a previous.    
1d930 20 20 20 20 2a 2a 20 72 65 61 64 20 6f 72 20 77      ** read or w
1d940 72 69 74 65 20 74 72 61 6e 73 61 63 74 69 6f 6e  rite transaction
1d950 29 2e 20 20 43 68 65 63 6b 20 74 6f 20 73 65 65  ).  Check to see
1d960 20 69 66 20 74 68 65 20 64 61 74 61 62 61 73 65   if the database
1d970 0a 20 20 20 20 20 20 20 20 2a 2a 20 68 61 73 20  .        ** has 
1d980 62 65 65 6e 20 6d 6f 64 69 66 69 65 64 2e 20 20  been modified.  
1d990 49 66 20 74 68 65 20 64 61 74 61 62 61 73 65 20  If the database 
1d9a0 68 61 73 20 63 68 61 6e 67 65 64 2c 20 66 6c 75  has changed, flu
1d9b0 73 68 20 74 68 65 0a 20 20 20 20 20 20 20 20 2a  sh the.        *
1d9c0 2a 20 63 61 63 68 65 2e 0a 20 20 20 20 20 20 20  * cache..       
1d9d0 20 2a 2a 0a 20 20 20 20 20 20 20 20 2a 2a 20 44   **.        ** D
1d9e0 61 74 61 62 61 73 65 20 63 68 61 6e 67 65 73 20  atabase changes 
1d9f0 69 73 20 64 65 74 65 63 74 65 64 20 62 79 20 6c  is detected by l
1da00 6f 6f 6b 69 6e 67 20 61 74 20 31 35 20 62 79 74  ooking at 15 byt
1da10 65 73 20 62 65 67 69 6e 6e 69 6e 67 0a 20 20 20  es beginning.   
1da20 20 20 20 20 20 2a 2a 20 61 74 20 6f 66 66 73 65       ** at offse
1da30 74 20 32 34 20 69 6e 74 6f 20 74 68 65 20 66 69  t 24 into the fi
1da40 6c 65 2e 20 20 54 68 65 20 66 69 72 73 74 20 34  le.  The first 4
1da50 20 6f 66 20 74 68 65 73 65 20 31 36 20 62 79 74   of these 16 byt
1da60 65 73 20 61 72 65 0a 20 20 20 20 20 20 20 20 2a  es are.        *
1da70 2a 20 61 20 33 32 2d 62 69 74 20 63 6f 75 6e 74  * a 32-bit count
1da80 65 72 20 74 68 61 74 20 69 73 20 69 6e 63 72 65  er that is incre
1da90 6d 65 6e 74 65 64 20 77 69 74 68 20 65 61 63 68  mented with each
1daa0 20 63 68 61 6e 67 65 2e 20 20 54 68 65 0a 20 20   change.  The.  
1dab0 20 20 20 20 20 20 2a 2a 20 6f 74 68 65 72 20 62        ** other b
1dac0 79 74 65 73 20 63 68 61 6e 67 65 20 72 61 6e 64  ytes change rand
1dad0 6f 6d 6c 79 20 77 69 74 68 20 65 61 63 68 20 66  omly with each f
1dae0 69 6c 65 20 63 68 61 6e 67 65 20 77 68 65 6e 0a  ile change when.
1daf0 20 20 20 20 20 20 20 20 2a 2a 20 61 20 63 6f 64          ** a cod
1db00 65 63 20 69 73 20 69 6e 20 75 73 65 2e 0a 20 20  ec is in use..  
1db10 20 20 20 20 20 20 2a 2a 20 0a 20 20 20 20 20 20        ** .      
1db20 20 20 2a 2a 20 54 68 65 72 65 20 69 73 20 61 20    ** There is a 
1db30 76 61 6e 69 73 68 69 6e 67 6c 79 20 73 6d 61 6c  vanishingly smal
1db40 6c 20 63 68 61 6e 63 65 20 74 68 61 74 20 61 20  l chance that a 
1db50 63 68 61 6e 67 65 20 77 69 6c 6c 20 6e 6f 74 20  change will not 
1db60 62 65 20 0a 20 20 20 20 20 20 20 20 2a 2a 20 64  be .        ** d
1db70 65 74 65 63 74 65 64 2e 20 20 54 68 65 20 63 68  etected.  The ch
1db80 61 6e 63 65 20 6f 66 20 61 6e 20 75 6e 64 65 74  ance of an undet
1db90 65 63 74 65 64 20 63 68 61 6e 67 65 20 69 73 20  ected change is 
1dba0 73 6f 20 73 6d 61 6c 6c 20 74 68 61 74 0a 20 20  so small that.  
1dbb0 20 20 20 20 20 20 2a 2a 20 69 74 20 63 61 6e 20        ** it can 
1dbc0 62 65 20 6e 65 67 6c 65 63 74 65 64 2e 0a 20 20  be neglected..  
1dbd0 20 20 20 20 20 20 2a 2f 0a 20 20 20 20 20 20 20        */.       
1dbe0 20 63 68 61 72 20 64 62 46 69 6c 65 56 65 72 73   char dbFileVers
1dbf0 5b 73 69 7a 65 6f 66 28 70 50 61 67 65 72 2d 3e  [sizeof(pPager->
1dc00 64 62 46 69 6c 65 56 65 72 73 29 5d 3b 0a 20 20  dbFileVers)];.  
1dc10 20 20 20 20 20 20 73 71 6c 69 74 65 33 50 61 67        sqlite3Pag
1dc20 65 72 50 61 67 65 63 6f 75 6e 74 28 70 50 61 67  erPagecount(pPag
1dc30 65 72 29 3b 0a 0a 20 20 20 20 20 20 20 20 69 66  er);..        if
1dc40 28 20 70 50 61 67 65 72 2d 3e 65 72 72 43 6f 64  ( pPager->errCod
1dc50 65 20 29 7b 0a 20 20 20 20 20 20 20 20 20 20 72  e ){.          r
1dc60 65 74 75 72 6e 20 70 50 61 67 65 72 2d 3e 65 72  eturn pPager->er
1dc70 72 43 6f 64 65 3b 0a 20 20 20 20 20 20 20 20 7d  rCode;.        }
1dc80 0a 0a 20 20 20 20 20 20 20 20 69 66 28 20 70 50  ..        if( pP
1dc90 61 67 65 72 2d 3e 64 62 53 69 7a 65 3e 30 20 29  ager->dbSize>0 )
1dca0 7b 0a 20 20 20 20 20 20 20 20 20 20 49 4f 54 52  {.          IOTR
1dcb0 41 43 45 28 28 22 43 4b 56 45 52 53 20 25 70 20  ACE(("CKVERS %p 
1dcc0 25 64 5c 6e 22 2c 20 70 50 61 67 65 72 2c 20 73  %d\n", pPager, s
1dcd0 69 7a 65 6f 66 28 64 62 46 69 6c 65 56 65 72 73  izeof(dbFileVers
1dce0 29 29 29 3b 0a 20 20 20 20 20 20 20 20 20 20 72  )));.          r
1dcf0 63 20 3d 20 73 71 6c 69 74 65 33 4f 73 52 65 61  c = sqlite3OsRea
1dd00 64 28 70 50 61 67 65 72 2d 3e 66 64 2c 20 26 64  d(pPager->fd, &d
1dd10 62 46 69 6c 65 56 65 72 73 2c 20 73 69 7a 65 6f  bFileVers, sizeo
1dd20 66 28 64 62 46 69 6c 65 56 65 72 73 29 2c 20 32  f(dbFileVers), 2
1dd30 34 29 3b 0a 20 20 20 20 20 20 20 20 20 20 69 66  4);.          if
1dd40 28 20 72 63 21 3d 53 51 4c 49 54 45 5f 4f 4b 20  ( rc!=SQLITE_OK 
1dd50 29 7b 0a 20 20 20 20 20 20 20 20 20 20 20 20 72  ){.            r
1dd60 65 74 75 72 6e 20 72 63 3b 0a 20 20 20 20 20 20  eturn rc;.      
1dd70 20 20 20 20 7d 0a 20 20 20 20 20 20 20 20 7d 65      }.        }e
1dd80 6c 73 65 7b 0a 20 20 20 20 20 20 20 20 20 20 6d  lse{.          m
1dd90 65 6d 73 65 74 28 64 62 46 69 6c 65 56 65 72 73  emset(dbFileVers
1dda0 2c 20 30 2c 20 73 69 7a 65 6f 66 28 64 62 46 69  , 0, sizeof(dbFi
1ddb0 6c 65 56 65 72 73 29 29 3b 0a 20 20 20 20 20 20  leVers));.      
1ddc0 20 20 7d 0a 0a 20 20 20 20 20 20 20 20 69 66 28    }..        if(
1ddd0 20 6d 65 6d 63 6d 70 28 70 50 61 67 65 72 2d 3e   memcmp(pPager->
1dde0 64 62 46 69 6c 65 56 65 72 73 2c 20 64 62 46 69  dbFileVers, dbFi
1ddf0 6c 65 56 65 72 73 2c 20 73 69 7a 65 6f 66 28 64  leVers, sizeof(d
1de00 62 46 69 6c 65 56 65 72 73 29 29 21 3d 30 20 29  bFileVers))!=0 )
1de10 7b 0a 20 20 20 20 20 20 20 20 20 20 70 61 67 65  {.          page
1de20 72 5f 72 65 73 65 74 28 70 50 61 67 65 72 29 3b  r_reset(pPager);
1de30 0a 20 20 20 20 20 20 20 20 7d 0a 20 20 20 20 20  .        }.     
1de40 20 7d 0a 20 20 20 20 7d 0a 20 20 20 20 61 73 73   }.    }.    ass
1de50 65 72 74 28 20 70 50 61 67 65 72 2d 3e 65 78 63  ert( pPager->exc
1de60 6c 75 73 69 76 65 4d 6f 64 65 20 7c 7c 20 70 50  lusiveMode || pP
1de70 61 67 65 72 2d 3e 73 74 61 74 65 3c 3d 50 41 47  ager->state<=PAG
1de80 45 52 5f 53 48 41 52 45 44 20 29 3b 0a 20 20 20  ER_SHARED );.   
1de90 20 69 66 28 20 70 50 61 67 65 72 2d 3e 73 74 61   if( pPager->sta
1dea0 74 65 3d 3d 50 41 47 45 52 5f 55 4e 4c 4f 43 4b  te==PAGER_UNLOCK
1deb0 20 29 7b 0a 20 20 20 20 20 20 70 50 61 67 65 72   ){.      pPager
1dec0 2d 3e 73 74 61 74 65 20 3d 20 50 41 47 45 52 5f  ->state = PAGER_
1ded0 53 48 41 52 45 44 3b 0a 20 20 20 20 7d 0a 20 20  SHARED;.    }.  
1dee0 7d 0a 0a 20 20 72 65 74 75 72 6e 20 72 63 3b 0a  }..  return rc;.
1def0 7d 0a 0a 2f 2a 0a 2a 2a 20 41 6c 6c 6f 63 61 74  }../*.** Allocat
1df00 65 20 61 20 50 67 48 64 72 20 6f 62 6a 65 63 74  e a PgHdr object
1df10 2e 20 20 20 45 69 74 68 65 72 20 63 72 65 61 74  .   Either creat
1df20 65 20 61 20 6e 65 77 20 6f 6e 65 20 6f 72 20 72  e a new one or r
1df30 65 75 73 65 0a 2a 2a 20 61 6e 20 65 78 69 73 74  euse.** an exist
1df40 69 6e 67 20 6f 6e 65 20 74 68 61 74 20 69 73 20  ing one that is 
1df50 6e 6f 74 20 6f 74 68 65 72 77 69 73 65 20 69 6e  not otherwise in
1df60 20 75 73 65 2e 0a 2a 2a 0a 2a 2a 20 41 20 6e 65   use..**.** A ne
1df70 77 20 50 67 48 64 72 20 73 74 72 75 63 74 75 72  w PgHdr structur
1df80 65 20 69 73 20 63 72 65 61 74 65 64 20 69 66 20  e is created if 
1df90 61 6e 79 20 6f 66 20 74 68 65 20 66 6f 6c 6c 6f  any of the follo
1dfa0 77 69 6e 67 20 61 72 65 0a 2a 2a 20 74 72 75 65  wing are.** true
1dfb0 3a 0a 2a 2a 0a 2a 2a 20 20 20 20 20 28 31 29 20  :.**.**     (1) 
1dfc0 20 57 65 20 68 61 76 65 20 6e 6f 74 20 65 78 63   We have not exc
1dfd0 65 65 64 65 64 20 6f 75 72 20 6d 61 78 69 6d 75  eeded our maximu
1dfe0 6d 20 61 6c 6c 6f 63 61 74 65 64 20 63 61 63 68  m allocated cach
1dff0 65 20 73 69 7a 65 0a 2a 2a 20 20 20 20 20 20 20  e size.**       
1e000 20 20 20 61 73 20 73 65 74 20 62 79 20 74 68 65     as set by the
1e010 20 22 50 52 41 47 4d 41 20 63 61 63 68 65 5f 73   "PRAGMA cache_s
1e020 69 7a 65 22 20 63 6f 6d 6d 61 6e 64 2e 0a 2a 2a  ize" command..**
1e030 0a 2a 2a 20 20 20 20 20 28 32 29 20 20 54 68 65  .**     (2)  The
1e040 72 65 20 61 72 65 20 6e 6f 20 75 6e 75 73 65 64  re are no unused
1e050 20 50 67 48 64 72 20 6f 62 6a 65 63 74 73 20 61   PgHdr objects a
1e060 76 61 69 6c 61 62 6c 65 20 61 74 20 74 68 69 73  vailable at this
1e070 20 74 69 6d 65 2e 0a 2a 2a 0a 2a 2a 20 20 20 20   time..**.**    
1e080 20 28 33 29 20 20 54 68 69 73 20 69 73 20 61 6e   (3)  This is an
1e090 20 69 6e 2d 6d 65 6d 6f 72 79 20 64 61 74 61 62   in-memory datab
1e0a0 61 73 65 2e 0a 2a 2a 0a 2a 2a 20 20 20 20 20 28  ase..**.**     (
1e0b0 34 29 20 20 54 68 65 72 65 20 61 72 65 20 6e 6f  4)  There are no
1e0c0 20 50 67 48 64 72 20 6f 62 6a 65 63 74 73 20 74   PgHdr objects t
1e0d0 68 61 74 20 64 6f 20 6e 6f 74 20 72 65 71 75 69  hat do not requi
1e0e0 72 65 20 61 20 6a 6f 75 72 6e 61 6c 0a 2a 2a 20  re a journal.** 
1e0f0 20 20 20 20 20 20 20 20 20 66 69 6c 65 20 73 79           file sy
1e100 6e 63 20 61 6e 64 20 61 20 73 79 6e 63 20 6f 66  nc and a sync of
1e110 20 74 68 65 20 6a 6f 75 72 6e 61 6c 20 66 69 6c   the journal fil
1e120 65 20 69 73 20 63 75 72 72 65 6e 74 6c 79 0a 2a  e is currently.*
1e130 2a 20 20 20 20 20 20 20 20 20 20 70 72 6f 68 69  *          prohi
1e140 62 69 74 65 64 2e 0a 2a 2a 0a 2a 2a 20 4f 74 68  bited..**.** Oth
1e150 65 72 77 69 73 65 2c 20 72 65 75 73 65 20 61 6e  erwise, reuse an
1e160 20 65 78 69 73 74 69 6e 67 20 50 67 48 64 72 2e   existing PgHdr.
1e170 20 20 49 6e 20 6f 74 68 65 72 20 77 6f 72 64 73    In other words
1e180 2c 20 72 65 75 73 65 20 61 6e 0a 2a 2a 20 65 78  , reuse an.** ex
1e190 69 73 74 69 6e 67 20 50 67 48 64 72 20 69 66 20  isting PgHdr if 
1e1a0 61 6c 6c 20 6f 66 20 74 68 65 20 66 6f 6c 6c 6f  all of the follo
1e1b0 77 69 6e 67 20 61 72 65 20 74 72 75 65 3a 0a 2a  wing are true:.*
1e1c0 2a 0a 2a 2a 20 20 20 20 20 28 31 29 20 20 57 65  *.**     (1)  We
1e1d0 20 68 61 76 65 20 72 65 61 63 68 65 64 20 6f 72   have reached or
1e1e0 20 65 78 63 65 65 64 65 64 20 74 68 65 20 6d 61   exceeded the ma
1e1f0 78 69 6d 75 6d 20 63 61 63 68 65 20 73 69 7a 65  ximum cache size
1e200 0a 2a 2a 20 20 20 20 20 20 20 20 20 20 61 6c 6c  .**          all
1e210 6f 77 65 64 20 62 79 20 22 50 52 41 47 4d 41 20  owed by "PRAGMA 
1e220 63 61 63 68 65 5f 73 69 7a 65 22 2e 0a 2a 2a 0a  cache_size"..**.
1e230 2a 2a 20 20 20 20 20 28 32 29 20 20 54 68 65 72  **     (2)  Ther
1e240 65 20 69 73 20 61 20 50 67 48 64 72 20 61 76 61  e is a PgHdr ava
1e250 69 6c 61 62 6c 65 20 77 69 74 68 20 50 67 48 64  ilable with PgHd
1e260 72 2d 3e 6e 52 65 66 3d 3d 30 0a 2a 2a 0a 2a 2a  r->nRef==0.**.**
1e270 20 20 20 20 20 28 33 29 20 20 57 65 20 61 72 65       (3)  We are
1e280 20 6e 6f 74 20 69 6e 20 61 6e 20 69 6e 2d 6d 65   not in an in-me
1e290 6d 6f 72 79 20 64 61 74 61 62 61 73 65 0a 2a 2a  mory database.**
1e2a0 0a 2a 2a 20 20 20 20 20 28 34 29 20 20 45 69 74  .**     (4)  Eit
1e2b0 68 65 72 20 74 68 65 72 65 20 69 73 20 61 6e 20  her there is an 
1e2c0 61 76 61 69 6c 61 62 6c 65 20 50 67 48 64 72 20  available PgHdr 
1e2d0 74 68 61 74 20 64 6f 65 73 20 6e 6f 74 20 6e 65  that does not ne
1e2e0 65 64 0a 2a 2a 20 20 20 20 20 20 20 20 20 20 74  ed.**          t
1e2f0 6f 20 62 65 20 73 79 6e 63 65 64 20 74 6f 20 64  o be synced to d
1e300 69 73 6b 20 6f 72 20 65 6c 73 65 20 64 69 73 6b  isk or else disk
1e310 20 73 79 6e 63 69 6e 67 20 69 73 20 63 75 72 72   syncing is curr
1e320 65 6e 74 6c 79 0a 2a 2a 20 20 20 20 20 20 20 20  ently.**        
1e330 20 20 61 6c 6c 6f 77 65 64 2e 0a 2a 2f 0a 73 74    allowed..*/.st
1e340 61 74 69 63 20 69 6e 74 20 70 61 67 65 72 41 6c  atic int pagerAl
1e350 6c 6f 63 61 74 65 50 61 67 65 28 50 61 67 65 72  locatePage(Pager
1e360 20 2a 70 50 61 67 65 72 2c 20 50 67 48 64 72 20   *pPager, PgHdr 
1e370 2a 2a 70 70 50 67 29 7b 0a 20 20 69 6e 74 20 72  **ppPg){.  int r
1e380 63 20 3d 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20  c = SQLITE_OK;. 
1e390 20 50 67 48 64 72 20 2a 70 50 67 3b 0a 20 20 69   PgHdr *pPg;.  i
1e3a0 6e 74 20 6e 42 79 74 65 48 64 72 3b 0a 0a 20 20  nt nByteHdr;..  
1e3b0 2f 2a 20 43 72 65 61 74 65 20 61 20 6e 65 77 20  /* Create a new 
1e3c0 50 67 48 64 72 20 69 66 20 61 6e 79 20 6f 66 20  PgHdr if any of 
1e3d0 74 68 65 20 66 6f 75 72 20 63 6f 6e 64 69 74 69  the four conditi
1e3e0 6f 6e 73 20 64 65 66 69 6e 65 64 20 0a 20 20 2a  ons defined .  *
1e3f0 2a 20 61 62 6f 76 65 20 61 72 65 20 6d 65 74 3a  * above are met:
1e400 20 2a 2f 0a 20 20 69 66 28 20 70 50 61 67 65 72   */.  if( pPager
1e410 2d 3e 6e 50 61 67 65 3c 70 50 61 67 65 72 2d 3e  ->nPage<pPager->
1e420 6d 78 50 61 67 65 0a 20 20 20 7c 7c 20 70 50 61  mxPage.   || pPa
1e430 67 65 72 2d 3e 6c 72 75 2e 70 46 69 72 73 74 3d  ger->lru.pFirst=
1e440 3d 30 20 0a 20 20 20 7c 7c 20 4d 45 4d 44 42 0a  =0 .   || MEMDB.
1e450 20 20 20 7c 7c 20 28 70 50 61 67 65 72 2d 3e 6c     || (pPager->l
1e460 72 75 2e 70 46 69 72 73 74 53 79 6e 63 65 64 3d  ru.pFirstSynced=
1e470 3d 30 20 26 26 20 70 50 61 67 65 72 2d 3e 64 6f  =0 && pPager->do
1e480 4e 6f 74 53 79 6e 63 29 0a 20 20 29 7b 0a 20 20  NotSync).  ){.  
1e490 20 20 76 6f 69 64 20 2a 70 44 61 74 61 3b 0a 20    void *pData;. 
1e4a0 20 20 20 69 66 28 20 70 50 61 67 65 72 2d 3e 6e     if( pPager->n
1e4b0 50 61 67 65 3e 3d 70 50 61 67 65 72 2d 3e 6e 48  Page>=pPager->nH
1e4c0 61 73 68 20 29 7b 0a 20 20 20 20 20 20 70 61 67  ash ){.      pag
1e4d0 65 72 5f 72 65 73 69 7a 65 5f 68 61 73 68 5f 74  er_resize_hash_t
1e4e0 61 62 6c 65 28 70 50 61 67 65 72 2c 0a 20 20 20  able(pPager,.   
1e4f0 20 20 20 20 20 20 70 50 61 67 65 72 2d 3e 6e 48        pPager->nH
1e500 61 73 68 3c 32 35 36 20 3f 20 32 35 36 20 3a 20  ash<256 ? 256 : 
1e510 70 50 61 67 65 72 2d 3e 6e 48 61 73 68 2a 32 29  pPager->nHash*2)
1e520 3b 0a 20 20 20 20 20 20 69 66 28 20 70 50 61 67  ;.      if( pPag
1e530 65 72 2d 3e 6e 48 61 73 68 3d 3d 30 20 29 7b 0a  er->nHash==0 ){.
1e540 20 20 20 20 20 20 20 20 72 63 20 3d 20 53 51 4c          rc = SQL
1e550 49 54 45 5f 4e 4f 4d 45 4d 3b 0a 20 20 20 20 20  ITE_NOMEM;.     
1e560 20 20 20 67 6f 74 6f 20 70 61 67 65 72 5f 61 6c     goto pager_al
1e570 6c 6f 63 61 74 65 5f 6f 75 74 3b 0a 20 20 20 20  locate_out;.    
1e580 20 20 7d 0a 20 20 20 20 7d 0a 20 20 20 20 70 61    }.    }.    pa
1e590 67 65 72 4c 65 61 76 65 28 70 50 61 67 65 72 29  gerLeave(pPager)
1e5a0 3b 0a 20 20 20 20 6e 42 79 74 65 48 64 72 20 3d  ;.    nByteHdr =
1e5b0 20 73 69 7a 65 6f 66 28 2a 70 50 67 29 20 2b 20   sizeof(*pPg) + 
1e5c0 73 69 7a 65 6f 66 28 75 33 32 29 20 2b 20 70 50  sizeof(u32) + pP
1e5d0 61 67 65 72 2d 3e 6e 45 78 74 72 61 0a 20 20 20  ager->nExtra.   
1e5e0 20 20 20 20 20 20 20 20 20 20 20 2b 20 4d 45 4d             + MEM
1e5f0 44 42 2a 73 69 7a 65 6f 66 28 50 67 48 69 73 74  DB*sizeof(PgHist
1e600 6f 72 79 29 3b 0a 20 20 20 20 70 50 67 20 3d 20  ory);.    pPg = 
1e610 73 71 6c 69 74 65 33 5f 6d 61 6c 6c 6f 63 28 20  sqlite3_malloc( 
1e620 6e 42 79 74 65 48 64 72 20 29 3b 0a 20 20 20 20  nByteHdr );.    
1e630 69 66 28 20 70 50 67 20 29 7b 0a 20 20 20 20 20  if( pPg ){.     
1e640 20 70 44 61 74 61 20 3d 20 73 71 6c 69 74 65 33   pData = sqlite3
1e650 5f 6d 61 6c 6c 6f 63 28 20 70 50 61 67 65 72 2d  _malloc( pPager-
1e660 3e 70 61 67 65 53 69 7a 65 20 29 3b 0a 20 20 20  >pageSize );.   
1e670 20 20 20 69 66 28 20 70 44 61 74 61 3d 3d 30 20     if( pData==0 
1e680 29 7b 0a 20 20 20 20 20 20 20 20 73 71 6c 69 74  ){.        sqlit
1e690 65 33 5f 66 72 65 65 28 70 50 67 29 3b 0a 20 20  e3_free(pPg);.  
1e6a0 20 20 20 20 20 20 70 50 67 20 3d 20 30 3b 0a 20        pPg = 0;. 
1e6b0 20 20 20 20 20 7d 0a 20 20 20 20 7d 0a 20 20 20       }.    }.   
1e6c0 20 70 61 67 65 72 45 6e 74 65 72 28 70 50 61 67   pagerEnter(pPag
1e6d0 65 72 29 3b 0a 20 20 20 20 69 66 28 20 70 50 67  er);.    if( pPg
1e6e0 3d 3d 30 20 29 7b 0a 20 20 20 20 20 20 72 63 20  ==0 ){.      rc 
1e6f0 3d 20 53 51 4c 49 54 45 5f 4e 4f 4d 45 4d 3b 0a  = SQLITE_NOMEM;.
1e700 20 20 20 20 20 20 67 6f 74 6f 20 70 61 67 65 72        goto pager
1e710 5f 61 6c 6c 6f 63 61 74 65 5f 6f 75 74 3b 0a 20  _allocate_out;. 
1e720 20 20 20 7d 0a 20 20 20 20 6d 65 6d 73 65 74 28     }.    memset(
1e730 70 50 67 2c 20 30 2c 20 6e 42 79 74 65 48 64 72  pPg, 0, nByteHdr
1e740 29 3b 0a 20 20 20 20 70 50 67 2d 3e 70 44 61 74  );.    pPg->pDat
1e750 61 20 3d 20 70 44 61 74 61 3b 0a 20 20 20 20 70  a = pData;.    p
1e760 50 67 2d 3e 70 50 61 67 65 72 20 3d 20 70 50 61  Pg->pPager = pPa
1e770 67 65 72 3b 0a 20 20 20 20 70 50 67 2d 3e 70 4e  ger;.    pPg->pN
1e780 65 78 74 41 6c 6c 20 3d 20 70 50 61 67 65 72 2d  extAll = pPager-
1e790 3e 70 41 6c 6c 3b 0a 20 20 20 20 70 50 61 67 65  >pAll;.    pPage
1e7a0 72 2d 3e 70 41 6c 6c 20 3d 20 70 50 67 3b 0a 20  r->pAll = pPg;. 
1e7b0 20 20 20 70 50 61 67 65 72 2d 3e 6e 50 61 67 65     pPager->nPage
1e7c0 2b 2b 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 20  ++;.  }else{.   
1e7d0 20 2f 2a 20 52 65 63 79 63 6c 65 20 61 6e 20 65   /* Recycle an e
1e7e0 78 69 73 74 69 6e 67 20 70 61 67 65 20 77 69 74  xisting page wit
1e7f0 68 20 61 20 7a 65 72 6f 20 72 65 66 2d 63 6f 75  h a zero ref-cou
1e800 6e 74 2e 20 2a 2f 0a 20 20 20 20 72 63 20 3d 20  nt. */.    rc = 
1e810 70 61 67 65 72 5f 72 65 63 79 63 6c 65 28 70 50  pager_recycle(pP
1e820 61 67 65 72 2c 20 26 70 50 67 29 3b 0a 20 20 20  ager, &pPg);.   
1e830 20 69 66 28 20 72 63 3d 3d 53 51 4c 49 54 45 5f   if( rc==SQLITE_
1e840 42 55 53 59 20 29 7b 0a 20 20 20 20 20 20 72 63  BUSY ){.      rc
1e850 20 3d 20 53 51 4c 49 54 45 5f 49 4f 45 52 52 5f   = SQLITE_IOERR_
1e860 42 4c 4f 43 4b 45 44 3b 0a 20 20 20 20 7d 0a 20  BLOCKED;.    }. 
1e870 20 20 20 69 66 28 20 72 63 21 3d 53 51 4c 49 54     if( rc!=SQLIT
1e880 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 20 20 67 6f  E_OK ){.      go
1e890 74 6f 20 70 61 67 65 72 5f 61 6c 6c 6f 63 61 74  to pager_allocat
1e8a0 65 5f 6f 75 74 3b 0a 20 20 20 20 7d 0a 20 20 20  e_out;.    }.   
1e8b0 20 61 73 73 65 72 74 28 20 70 50 61 67 65 72 2d   assert( pPager-
1e8c0 3e 73 74 61 74 65 3e 3d 53 48 41 52 45 44 5f 4c  >state>=SHARED_L
1e8d0 4f 43 4b 20 29 3b 0a 20 20 20 20 61 73 73 65 72  OCK );.    asser
1e8e0 74 28 70 50 67 29 3b 0a 20 20 7d 0a 20 20 2a 70  t(pPg);.  }.  *p
1e8f0 70 50 67 20 3d 20 70 50 67 3b 0a 0a 70 61 67 65  pPg = pPg;..page
1e900 72 5f 61 6c 6c 6f 63 61 74 65 5f 6f 75 74 3a 0a  r_allocate_out:.
1e910 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 7d 0a 0a    return rc;.}..
1e920 2f 2a 0a 2a 2a 20 4d 61 6b 65 20 73 75 72 65 20  /*.** Make sure 
1e930 77 65 20 68 61 76 65 20 74 68 65 20 63 6f 6e 74  we have the cont
1e940 65 6e 74 20 66 6f 72 20 61 20 70 61 67 65 2e 20  ent for a page. 
1e950 20 49 66 20 74 68 65 20 70 61 67 65 20 77 61 73   If the page was
1e960 0a 2a 2a 20 70 72 65 76 69 6f 75 73 6c 79 20 61  .** previously a
1e970 63 71 75 69 72 65 64 20 77 69 74 68 20 6e 6f 43  cquired with noC
1e980 6f 6e 74 65 6e 74 3d 3d 31 2c 20 74 68 65 6e 20  ontent==1, then 
1e990 74 68 65 20 63 6f 6e 74 65 6e 74 20 77 61 73 0a  the content was.
1e9a0 2a 2a 20 6a 75 73 74 20 69 6e 69 74 69 61 6c 69  ** just initiali
1e9b0 7a 65 64 20 74 6f 20 7a 65 72 6f 73 20 69 6e 73  zed to zeros ins
1e9c0 74 65 61 64 20 6f 66 20 62 65 69 6e 67 20 72 65  tead of being re
1e9d0 61 64 20 66 72 6f 6d 20 64 69 73 6b 2e 0a 2a 2a  ad from disk..**
1e9e0 20 42 75 74 20 6e 6f 77 20 77 65 20 6e 65 65 64   But now we need
1e9f0 20 74 68 65 20 72 65 61 6c 20 64 61 74 61 20 6f   the real data o
1ea00 66 66 20 6f 66 20 64 69 73 6b 2e 20 20 53 6f 20  ff of disk.  So 
1ea10 6d 61 6b 65 20 73 75 72 65 20 77 65 0a 2a 2a 20  make sure we.** 
1ea20 68 61 76 65 20 69 74 2e 20 20 52 65 61 64 20 69  have it.  Read i
1ea30 74 20 69 6e 20 69 66 20 77 65 20 64 6f 20 6e 6f  t in if we do no
1ea40 74 20 68 61 76 65 20 69 74 20 61 6c 72 65 61 64  t have it alread
1ea50 79 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74  y..*/.static int
1ea60 20 70 61 67 65 72 5f 67 65 74 5f 63 6f 6e 74 65   pager_get_conte
1ea70 6e 74 28 50 67 48 64 72 20 2a 70 50 67 29 7b 0a  nt(PgHdr *pPg){.
1ea80 20 20 69 66 28 20 70 50 67 2d 3e 6e 65 65 64 52    if( pPg->needR
1ea90 65 61 64 20 29 7b 0a 20 20 20 20 69 6e 74 20 72  ead ){.    int r
1eaa0 63 20 3d 20 72 65 61 64 44 62 50 61 67 65 28 70  c = readDbPage(p
1eab0 50 67 2d 3e 70 50 61 67 65 72 2c 20 70 50 67 2c  Pg->pPager, pPg,
1eac0 20 70 50 67 2d 3e 70 67 6e 6f 29 3b 0a 20 20 20   pPg->pgno);.   
1ead0 20 69 66 28 20 72 63 3d 3d 53 51 4c 49 54 45 5f   if( rc==SQLITE_
1eae0 4f 4b 20 29 7b 0a 20 20 20 20 20 20 70 50 67 2d  OK ){.      pPg-
1eaf0 3e 6e 65 65 64 52 65 61 64 20 3d 20 30 3b 0a 20  >needRead = 0;. 
1eb00 20 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 20 20     }else{.      
1eb10 72 65 74 75 72 6e 20 72 63 3b 0a 20 20 20 20 7d  return rc;.    }
1eb20 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e 20 53 51  .  }.  return SQ
1eb30 4c 49 54 45 5f 4f 4b 3b 0a 7d 0a 0a 2f 2a 0a 2a  LITE_OK;.}../*.*
1eb40 2a 20 41 63 71 75 69 72 65 20 61 20 70 61 67 65  * Acquire a page
1eb50 2e 0a 2a 2a 0a 2a 2a 20 41 20 72 65 61 64 20 6c  ..**.** A read l
1eb60 6f 63 6b 20 6f 6e 20 74 68 65 20 64 69 73 6b 20  ock on the disk 
1eb70 66 69 6c 65 20 69 73 20 6f 62 74 61 69 6e 65 64  file is obtained
1eb80 20 77 68 65 6e 20 74 68 65 20 66 69 72 73 74 20   when the first 
1eb90 70 61 67 65 20 69 73 20 61 63 71 75 69 72 65 64  page is acquired
1eba0 2e 20 0a 2a 2a 20 54 68 69 73 20 72 65 61 64 20  . .** This read 
1ebb0 6c 6f 63 6b 20 69 73 20 64 72 6f 70 70 65 64 20  lock is dropped 
1ebc0 77 68 65 6e 20 74 68 65 20 6c 61 73 74 20 70 61  when the last pa
1ebd0 67 65 20 69 73 20 72 65 6c 65 61 73 65 64 2e 0a  ge is released..
1ebe0 2a 2a 0a 2a 2a 20 54 68 69 73 20 72 6f 75 74 69  **.** This routi
1ebf0 6e 65 20 77 6f 72 6b 73 20 66 6f 72 20 61 6e 79  ne works for any
1ec00 20 70 61 67 65 20 6e 75 6d 62 65 72 20 67 72 65   page number gre
1ec10 61 74 65 72 20 74 68 61 6e 20 30 2e 20 20 49 66  ater than 0.  If
1ec20 20 74 68 65 20 64 61 74 61 62 61 73 65 0a 2a 2a   the database.**
1ec30 20 66 69 6c 65 20 69 73 20 73 6d 61 6c 6c 65 72   file is smaller
1ec40 20 74 68 61 6e 20 74 68 65 20 72 65 71 75 65 73   than the reques
1ec50 74 65 64 20 70 61 67 65 2c 20 74 68 65 6e 20 6e  ted page, then n
1ec60 6f 20 61 63 74 75 61 6c 20 64 69 73 6b 0a 2a 2a  o actual disk.**
1ec70 20 72 65 61 64 20 6f 63 63 75 72 73 20 61 6e 64   read occurs and
1ec80 20 74 68 65 20 6d 65 6d 6f 72 79 20 69 6d 61 67   the memory imag
1ec90 65 20 6f 66 20 74 68 65 20 70 61 67 65 20 69 73  e of the page is
1eca0 20 69 6e 69 74 69 61 6c 69 7a 65 64 20 74 6f 0a   initialized to.
1ecb0 2a 2a 20 61 6c 6c 20 7a 65 72 6f 73 2e 20 20 54  ** all zeros.  T
1ecc0 68 65 20 65 78 74 72 61 20 64 61 74 61 20 61 70  he extra data ap
1ecd0 70 65 6e 64 65 64 20 74 6f 20 61 20 70 61 67 65  pended to a page
1ece0 20 69 73 20 61 6c 77 61 79 73 20 69 6e 69 74 69   is always initi
1ecf0 61 6c 69 7a 65 64 0a 2a 2a 20 74 6f 20 7a 65 72  alized.** to zer
1ed00 6f 73 20 74 68 65 20 66 69 72 73 74 20 74 69 6d  os the first tim
1ed10 65 20 61 20 70 61 67 65 20 69 73 20 6c 6f 61 64  e a page is load
1ed20 65 64 20 69 6e 74 6f 20 6d 65 6d 6f 72 79 2e 0a  ed into memory..
1ed30 2a 2a 0a 2a 2a 20 54 68 65 20 61 63 71 75 69 73  **.** The acquis
1ed40 69 74 69 6f 6e 20 6d 69 67 68 74 20 66 61 69 6c  ition might fail
1ed50 20 66 6f 72 20 73 65 76 65 72 61 6c 20 72 65 61   for several rea
1ed60 73 6f 6e 73 2e 20 20 49 6e 20 61 6c 6c 20 63 61  sons.  In all ca
1ed70 73 65 73 2c 0a 2a 2a 20 61 6e 20 61 70 70 72 6f  ses,.** an appro
1ed80 70 72 69 61 74 65 20 65 72 72 6f 72 20 63 6f 64  priate error cod
1ed90 65 20 69 73 20 72 65 74 75 72 6e 65 64 20 61 6e  e is returned an
1eda0 64 20 2a 70 70 50 61 67 65 20 69 73 20 73 65 74  d *ppPage is set
1edb0 20 74 6f 20 4e 55 4c 4c 2e 0a 2a 2a 0a 2a 2a 20   to NULL..**.** 
1edc0 53 65 65 20 61 6c 73 6f 20 73 71 6c 69 74 65 33  See also sqlite3
1edd0 50 61 67 65 72 4c 6f 6f 6b 75 70 28 29 2e 20 20  PagerLookup().  
1ede0 42 6f 74 68 20 74 68 69 73 20 72 6f 75 74 69 6e  Both this routin
1edf0 65 20 61 6e 64 20 4c 6f 6f 6b 75 70 28 29 20 61  e and Lookup() a
1ee00 74 74 65 6d 70 74 0a 2a 2a 20 74 6f 20 66 69 6e  ttempt.** to fin
1ee10 64 20 61 20 70 61 67 65 20 69 6e 20 74 68 65 20  d a page in the 
1ee20 69 6e 2d 6d 65 6d 6f 72 79 20 63 61 63 68 65 20  in-memory cache 
1ee30 66 69 72 73 74 2e 20 20 49 66 20 74 68 65 20 70  first.  If the p
1ee40 61 67 65 20 69 73 20 6e 6f 74 20 61 6c 72 65 61  age is not alrea
1ee50 64 79 0a 2a 2a 20 69 6e 20 6d 65 6d 6f 72 79 2c  dy.** in memory,
1ee60 20 74 68 69 73 20 72 6f 75 74 69 6e 65 20 67 6f   this routine go
1ee70 65 73 20 74 6f 20 64 69 73 6b 20 74 6f 20 72 65  es to disk to re
1ee80 61 64 20 69 74 20 69 6e 20 77 68 65 72 65 61 73  ad it in whereas
1ee90 20 4c 6f 6f 6b 75 70 28 29 0a 2a 2a 20 6a 75 73   Lookup().** jus
1eea0 74 20 72 65 74 75 72 6e 73 20 30 2e 20 20 54 68  t returns 0.  Th
1eeb0 69 73 20 72 6f 75 74 69 6e 65 20 61 63 71 75 69  is routine acqui
1eec0 72 65 73 20 61 20 72 65 61 64 2d 6c 6f 63 6b 20  res a read-lock 
1eed0 74 68 65 20 66 69 72 73 74 20 74 69 6d 65 20 69  the first time i
1eee0 74 0a 2a 2a 20 68 61 73 20 74 6f 20 67 6f 20 74  t.** has to go t
1eef0 6f 20 64 69 73 6b 2c 20 61 6e 64 20 63 6f 75 6c  o disk, and coul
1ef00 64 20 61 6c 73 6f 20 70 6c 61 79 62 61 63 6b 20  d also playback 
1ef10 61 6e 20 6f 6c 64 20 6a 6f 75 72 6e 61 6c 20 69  an old journal i
1ef20 66 20 6e 65 63 65 73 73 61 72 79 2e 0a 2a 2a 20  f necessary..** 
1ef30 53 69 6e 63 65 20 4c 6f 6f 6b 75 70 28 29 20 6e  Since Lookup() n
1ef40 65 76 65 72 20 67 6f 65 73 20 74 6f 20 64 69 73  ever goes to dis
1ef50 6b 2c 20 69 74 20 6e 65 76 65 72 20 68 61 73 20  k, it never has 
1ef60 74 6f 20 64 65 61 6c 20 77 69 74 68 20 6c 6f 63  to deal with loc
1ef70 6b 73 0a 2a 2a 20 6f 72 20 6a 6f 75 72 6e 61 6c  ks.** or journal
1ef80 20 66 69 6c 65 73 2e 0a 2a 2a 0a 2a 2a 20 49 66   files..**.** If
1ef90 20 6e 6f 43 6f 6e 74 65 6e 74 20 69 73 20 66 61   noContent is fa
1efa0 6c 73 65 2c 20 74 68 65 20 70 61 67 65 20 63 6f  lse, the page co
1efb0 6e 74 65 6e 74 73 20 61 72 65 20 61 63 74 75 61  ntents are actua
1efc0 6c 6c 79 20 72 65 61 64 20 66 72 6f 6d 20 64 69  lly read from di
1efd0 73 6b 2e 0a 2a 2a 20 49 66 20 6e 6f 43 6f 6e 74  sk..** If noCont
1efe0 65 6e 74 20 69 73 20 74 72 75 65 2c 20 69 74 20  ent is true, it 
1eff0 6d 65 61 6e 73 20 74 68 61 74 20 77 65 20 64 6f  means that we do
1f000 20 6e 6f 74 20 63 61 72 65 20 61 62 6f 75 74 20   not care about 
1f010 74 68 65 20 63 6f 6e 74 65 6e 74 73 0a 2a 2a 20  the contents.** 
1f020 6f 66 20 74 68 65 20 70 61 67 65 20 61 74 20 74  of the page at t
1f030 68 69 73 20 74 69 6d 65 2c 20 73 6f 20 64 6f 20  his time, so do 
1f040 6e 6f 74 20 64 6f 20 61 20 64 69 73 6b 20 72 65  not do a disk re
1f050 61 64 2e 20 20 4a 75 73 74 20 66 69 6c 6c 20 69  ad.  Just fill i
1f060 6e 20 74 68 65 0a 2a 2a 20 70 61 67 65 20 63 6f  n the.** page co
1f070 6e 74 65 6e 74 20 77 69 74 68 20 7a 65 72 6f 73  ntent with zeros
1f080 2e 20 20 42 75 74 20 6d 61 72 6b 20 74 68 65 20  .  But mark the 
1f090 66 61 63 74 20 74 68 61 74 20 77 65 20 68 61 76  fact that we hav
1f0a0 65 20 6e 6f 74 20 72 65 61 64 20 74 68 65 0a 2a  e not read the.*
1f0b0 2a 20 63 6f 6e 74 65 6e 74 20 62 79 20 73 65 74  * content by set
1f0c0 74 69 6e 67 20 74 68 65 20 50 67 48 64 72 2e 6e  ting the PgHdr.n
1f0d0 65 65 64 52 65 61 64 20 66 6c 61 67 2e 20 20 4c  eedRead flag.  L
1f0e0 61 74 65 72 20 6f 6e 2c 20 69 66 20 0a 2a 2a 20  ater on, if .** 
1f0f0 73 71 6c 69 74 65 33 50 61 67 65 72 57 72 69 74  sqlite3PagerWrit
1f100 65 28 29 20 69 73 20 63 61 6c 6c 65 64 20 6f 6e  e() is called on
1f110 20 74 68 69 73 20 70 61 67 65 20 6f 72 20 69 66   this page or if
1f120 20 74 68 69 73 20 72 6f 75 74 69 6e 65 20 69 73   this routine is
1f130 0a 2a 2a 20 63 61 6c 6c 65 64 20 61 67 61 69 6e  .** called again
1f140 20 77 69 74 68 20 6e 6f 43 6f 6e 74 65 6e 74 3d   with noContent=
1f150 3d 30 2c 20 74 68 61 74 20 6d 65 61 6e 73 20 74  =0, that means t
1f160 68 61 74 20 74 68 65 20 63 6f 6e 74 65 6e 74 20  hat the content 
1f170 69 73 20 6e 65 65 64 65 64 0a 2a 2a 20 61 6e 64  is needed.** and
1f180 20 74 68 65 20 64 69 73 6b 20 72 65 61 64 20 73   the disk read s
1f190 68 6f 75 6c 64 20 6f 63 63 75 72 20 61 74 20 74  hould occur at t
1f1a0 68 61 74 20 70 6f 69 6e 74 2e 0a 2a 2f 0a 73 74  hat point..*/.st
1f1b0 61 74 69 63 20 69 6e 74 20 70 61 67 65 72 41 63  atic int pagerAc
1f1c0 71 75 69 72 65 28 0a 20 20 50 61 67 65 72 20 2a  quire(.  Pager *
1f1d0 70 50 61 67 65 72 2c 20 20 20 20 20 20 2f 2a 20  pPager,      /* 
1f1e0 54 68 65 20 70 61 67 65 72 20 6f 70 65 6e 20 6f  The pager open o
1f1f0 6e 20 74 68 65 20 64 61 74 61 62 61 73 65 20 66  n the database f
1f200 69 6c 65 20 2a 2f 0a 20 20 50 67 6e 6f 20 70 67  ile */.  Pgno pg
1f210 6e 6f 2c 20 20 20 20 20 20 20 20 20 20 2f 2a 20  no,          /* 
1f220 50 61 67 65 20 6e 75 6d 62 65 72 20 74 6f 20 66  Page number to f
1f230 65 74 63 68 20 2a 2f 0a 20 20 44 62 50 61 67 65  etch */.  DbPage
1f240 20 2a 2a 70 70 50 61 67 65 2c 20 20 20 20 2f 2a   **ppPage,    /*
1f250 20 57 72 69 74 65 20 61 20 70 6f 69 6e 74 65 72   Write a pointer
1f260 20 74 6f 20 74 68 65 20 70 61 67 65 20 68 65 72   to the page her
1f270 65 20 2a 2f 0a 20 20 69 6e 74 20 6e 6f 43 6f 6e  e */.  int noCon
1f280 74 65 6e 74 20 20 20 20 20 20 20 2f 2a 20 44 6f  tent       /* Do
1f290 20 6e 6f 74 20 62 6f 74 68 65 72 20 72 65 61 64   not bother read
1f2a0 69 6e 67 20 63 6f 6e 74 65 6e 74 20 66 72 6f 6d  ing content from
1f2b0 20 64 69 73 6b 20 69 66 20 74 72 75 65 20 2a 2f   disk if true */
1f2c0 0a 29 7b 0a 20 20 50 67 48 64 72 20 2a 70 50 67  .){.  PgHdr *pPg
1f2d0 3b 0a 20 20 69 6e 74 20 72 63 3b 0a 0a 20 20 61  ;.  int rc;..  a
1f2e0 73 73 65 72 74 28 20 70 50 61 67 65 72 2d 3e 73  ssert( pPager->s
1f2f0 74 61 74 65 3d 3d 50 41 47 45 52 5f 55 4e 4c 4f  tate==PAGER_UNLO
1f300 43 4b 20 7c 7c 20 70 50 61 67 65 72 2d 3e 6e 52  CK || pPager->nR
1f310 65 66 3e 30 20 7c 7c 20 70 67 6e 6f 3d 3d 31 20  ef>0 || pgno==1 
1f320 29 3b 0a 0a 20 20 2f 2a 20 54 68 65 20 6d 61 78  );..  /* The max
1f330 69 6d 75 6d 20 70 61 67 65 20 6e 75 6d 62 65 72  imum page number
1f340 20 69 73 20 32 5e 33 31 2e 20 52 65 74 75 72 6e   is 2^31. Return
1f350 20 53 51 4c 49 54 45 5f 43 4f 52 52 55 50 54 20   SQLITE_CORRUPT 
1f360 69 66 20 61 20 70 61 67 65 0a 20 20 2a 2a 20 6e  if a page.  ** n
1f370 75 6d 62 65 72 20 67 72 65 61 74 65 72 20 74 68  umber greater th
1f380 61 6e 20 74 68 69 73 2c 20 6f 72 20 7a 65 72 6f  an this, or zero
1f390 2c 20 69 73 20 72 65 71 75 65 73 74 65 64 2e 0a  , is requested..
1f3a0 20 20 2a 2f 0a 20 20 69 66 28 20 70 67 6e 6f 3e    */.  if( pgno>
1f3b0 50 41 47 45 52 5f 4d 41 58 5f 50 47 4e 4f 20 7c  PAGER_MAX_PGNO |
1f3c0 7c 20 70 67 6e 6f 3d 3d 30 20 7c 7c 20 70 67 6e  | pgno==0 || pgn
1f3d0 6f 3d 3d 50 41 47 45 52 5f 4d 4a 5f 50 47 4e 4f  o==PAGER_MJ_PGNO
1f3e0 28 70 50 61 67 65 72 29 20 29 7b 0a 20 20 20 20  (pPager) ){.    
1f3f0 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 43 4f  return SQLITE_CO
1f400 52 52 55 50 54 5f 42 4b 50 54 3b 0a 20 20 7d 0a  RRUPT_BKPT;.  }.
1f410 0a 20 20 2f 2a 20 4d 61 6b 65 20 73 75 72 65 20  .  /* Make sure 
1f420 77 65 20 68 61 76 65 20 6e 6f 74 20 68 69 74 20  we have not hit 
1f430 61 6e 79 20 63 72 69 74 69 63 61 6c 20 65 72 72  any critical err
1f440 6f 72 73 2e 0a 20 20 2a 2f 20 0a 20 20 61 73 73  ors..  */ .  ass
1f450 65 72 74 28 20 70 50 61 67 65 72 21 3d 30 20 29  ert( pPager!=0 )
1f460 3b 0a 20 20 2a 70 70 50 61 67 65 20 3d 20 30 3b  ;.  *ppPage = 0;
1f470 0a 0a 20 20 2f 2a 20 49 66 20 74 68 69 73 20 69  ..  /* If this i
1f480 73 20 74 68 65 20 66 69 72 73 74 20 70 61 67 65  s the first page
1f490 20 61 63 63 65 73 73 65 64 2c 20 74 68 65 6e 20   accessed, then 
1f4a0 67 65 74 20 61 20 53 48 41 52 45 44 20 6c 6f 63  get a SHARED loc
1f4b0 6b 0a 20 20 2a 2a 20 6f 6e 20 74 68 65 20 64 61  k.  ** on the da
1f4c0 74 61 62 61 73 65 20 66 69 6c 65 2e 20 70 61 67  tabase file. pag
1f4d0 65 72 53 68 61 72 65 64 4c 6f 63 6b 28 29 20 69  erSharedLock() i
1f4e0 73 20 61 20 6e 6f 2d 6f 70 20 69 66 20 0a 20 20  s a no-op if .  
1f4f0 2a 2a 20 61 20 64 61 74 61 62 61 73 65 20 6c 6f  ** a database lo
1f500 63 6b 20 69 73 20 61 6c 72 65 61 64 79 20 68 65  ck is already he
1f510 6c 64 2e 0a 20 20 2a 2f 0a 20 20 72 63 20 3d 20  ld..  */.  rc = 
1f520 70 61 67 65 72 53 68 61 72 65 64 4c 6f 63 6b 28  pagerSharedLock(
1f530 70 50 61 67 65 72 29 3b 0a 20 20 69 66 28 20 72  pPager);.  if( r
1f540 63 21 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a  c!=SQLITE_OK ){.
1f550 20 20 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 20      return rc;. 
1f560 20 7d 0a 20 20 61 73 73 65 72 74 28 20 70 50 61   }.  assert( pPa
1f570 67 65 72 2d 3e 73 74 61 74 65 21 3d 50 41 47 45  ger->state!=PAGE
1f580 52 5f 55 4e 4c 4f 43 4b 20 29 3b 0a 0a 20 20 70  R_UNLOCK );..  p
1f590 50 67 20 3d 20 70 61 67 65 72 5f 6c 6f 6f 6b 75  Pg = pager_looku
1f5a0 70 28 70 50 61 67 65 72 2c 20 70 67 6e 6f 29 3b  p(pPager, pgno);
1f5b0 0a 20 20 69 66 28 20 70 50 67 3d 3d 30 20 29 7b  .  if( pPg==0 ){
1f5c0 0a 20 20 20 20 2f 2a 20 54 68 65 20 72 65 71 75  .    /* The requ
1f5d0 65 73 74 65 64 20 70 61 67 65 20 69 73 20 6e 6f  ested page is no
1f5e0 74 20 69 6e 20 74 68 65 20 70 61 67 65 20 63 61  t in the page ca
1f5f0 63 68 65 2e 20 2a 2f 0a 20 20 20 20 69 6e 74 20  che. */.    int 
1f600 6e 4d 61 78 3b 0a 20 20 20 20 69 6e 74 20 68 3b  nMax;.    int h;
1f610 0a 20 20 20 20 50 41 47 45 52 5f 49 4e 43 52 28  .    PAGER_INCR(
1f620 70 50 61 67 65 72 2d 3e 6e 4d 69 73 73 29 3b 0a  pPager->nMiss);.
1f630 20 20 20 20 72 63 20 3d 20 70 61 67 65 72 41 6c      rc = pagerAl
1f640 6c 6f 63 61 74 65 50 61 67 65 28 70 50 61 67 65  locatePage(pPage
1f650 72 2c 20 26 70 50 67 29 3b 0a 20 20 20 20 69 66  r, &pPg);.    if
1f660 28 20 72 63 21 3d 53 51 4c 49 54 45 5f 4f 4b 20  ( rc!=SQLITE_OK 
1f670 29 7b 0a 20 20 20 20 20 20 72 65 74 75 72 6e 20  ){.      return 
1f680 72 63 3b 0a 20 20 20 20 7d 0a 0a 20 20 20 20 70  rc;.    }..    p
1f690 50 67 2d 3e 70 67 6e 6f 20 3d 20 70 67 6e 6f 3b  Pg->pgno = pgno;
1f6a0 0a 20 20 20 20 61 73 73 65 72 74 28 20 21 4d 45  .    assert( !ME
1f6b0 4d 44 42 20 7c 7c 20 70 67 6e 6f 3e 70 50 61 67  MDB || pgno>pPag
1f6c0 65 72 2d 3e 73 74 6d 74 53 69 7a 65 20 29 3b 0a  er->stmtSize );.
1f6d0 20 20 20 20 70 50 67 2d 3e 69 6e 4a 6f 75 72 6e      pPg->inJourn
1f6e0 61 6c 20 3d 20 73 71 6c 69 74 65 33 42 69 74 76  al = sqlite3Bitv
1f6f0 65 63 54 65 73 74 28 70 50 61 67 65 72 2d 3e 70  ecTest(pPager->p
1f700 49 6e 4a 6f 75 72 6e 61 6c 2c 20 70 67 6e 6f 29  InJournal, pgno)
1f710 3b 0a 20 20 20 20 70 50 67 2d 3e 6e 65 65 64 53  ;.    pPg->needS
1f720 79 6e 63 20 3d 20 30 3b 0a 0a 20 20 20 20 6d 61  ync = 0;..    ma
1f730 6b 65 43 6c 65 61 6e 28 70 50 67 29 3b 0a 20 20  keClean(pPg);.  
1f740 20 20 70 50 67 2d 3e 6e 52 65 66 20 3d 20 31 3b    pPg->nRef = 1;
1f750 0a 0a 20 20 20 20 70 50 61 67 65 72 2d 3e 6e 52  ..    pPager->nR
1f760 65 66 2b 2b 3b 0a 20 20 20 20 69 66 28 20 70 50  ef++;.    if( pP
1f770 61 67 65 72 2d 3e 6e 45 78 74 72 61 3e 30 20 29  ager->nExtra>0 )
1f780 7b 0a 20 20 20 20 20 20 6d 65 6d 73 65 74 28 50  {.      memset(P
1f790 47 48 44 52 5f 54 4f 5f 45 58 54 52 41 28 70 50  GHDR_TO_EXTRA(pP
1f7a0 67 2c 20 70 50 61 67 65 72 29 2c 20 30 2c 20 70  g, pPager), 0, p
1f7b0 50 61 67 65 72 2d 3e 6e 45 78 74 72 61 29 3b 0a  Pager->nExtra);.
1f7c0 20 20 20 20 7d 0a 20 20 20 20 6e 4d 61 78 20 3d      }.    nMax =
1f7d0 20 73 71 6c 69 74 65 33 50 61 67 65 72 50 61 67   sqlite3PagerPag
1f7e0 65 63 6f 75 6e 74 28 70 50 61 67 65 72 29 3b 0a  ecount(pPager);.
1f7f0 20 20 20 20 69 66 28 20 70 50 61 67 65 72 2d 3e      if( pPager->
1f800 65 72 72 43 6f 64 65 20 29 7b 0a 20 20 20 20 20  errCode ){.     
1f810 20 72 63 20 3d 20 70 50 61 67 65 72 2d 3e 65 72   rc = pPager->er
1f820 72 43 6f 64 65 3b 0a 20 20 20 20 20 20 73 71 6c  rCode;.      sql
1f830 69 74 65 33 50 61 67 65 72 55 6e 72 65 66 28 70  ite3PagerUnref(p
1f840 50 67 29 3b 0a 20 20 20 20 20 20 72 65 74 75 72  Pg);.      retur
1f850 6e 20 72 63 3b 0a 20 20 20 20 7d 0a 0a 20 20 20  n rc;.    }..   
1f860 20 2f 2a 20 50 6f 70 75 6c 61 74 65 20 74 68 65   /* Populate the
1f870 20 70 61 67 65 20 77 69 74 68 20 64 61 74 61 2c   page with data,
1f880 20 65 69 74 68 65 72 20 62 79 20 72 65 61 64 69   either by readi
1f890 6e 67 20 66 72 6f 6d 20 74 68 65 20 64 61 74 61  ng from the data
1f8a0 62 61 73 65 0a 20 20 20 20 2a 2a 20 66 69 6c 65  base.    ** file
1f8b0 2c 20 6f 72 20 62 79 20 73 65 74 74 69 6e 67 20  , or by setting 
1f8c0 74 68 65 20 65 6e 74 69 72 65 20 70 61 67 65 20  the entire page 
1f8d0 74 6f 20 7a 65 72 6f 2e 0a 20 20 20 20 2a 2f 0a  to zero..    */.
1f8e0 20 20 20 20 69 66 28 20 6e 4d 61 78 3c 28 69 6e      if( nMax<(in
1f8f0 74 29 70 67 6e 6f 20 7c 7c 20 4d 45 4d 44 42 20  t)pgno || MEMDB 
1f900 7c 7c 20 28 6e 6f 43 6f 6e 74 65 6e 74 20 26 26  || (noContent &&
1f910 20 21 70 50 61 67 65 72 2d 3e 61 6c 77 61 79 73   !pPager->always
1f920 52 6f 6c 6c 62 61 63 6b 29 20 29 7b 0a 20 20 20  Rollback) ){.   
1f930 20 20 20 69 66 28 20 70 67 6e 6f 3e 70 50 61 67     if( pgno>pPag
1f940 65 72 2d 3e 6d 78 50 67 6e 6f 20 29 7b 0a 20 20  er->mxPgno ){.  
1f950 20 20 20 20 20 20 73 71 6c 69 74 65 33 50 61 67        sqlite3Pag
1f960 65 72 55 6e 72 65 66 28 70 50 67 29 3b 0a 20 20  erUnref(pPg);.  
1f970 20 20 20 20 20 20 72 65 74 75 72 6e 20 53 51 4c        return SQL
1f980 49 54 45 5f 46 55 4c 4c 3b 0a 20 20 20 20 20 20  ITE_FULL;.      
1f990 7d 0a 20 20 20 20 20 20 6d 65 6d 73 65 74 28 50  }.      memset(P
1f9a0 47 48 44 52 5f 54 4f 5f 44 41 54 41 28 70 50 67  GHDR_TO_DATA(pPg
1f9b0 29 2c 20 30 2c 20 70 50 61 67 65 72 2d 3e 70 61  ), 0, pPager->pa
1f9c0 67 65 53 69 7a 65 29 3b 0a 20 20 20 20 20 20 70  geSize);.      p
1f9d0 50 67 2d 3e 6e 65 65 64 52 65 61 64 20 3d 20 6e  Pg->needRead = n
1f9e0 6f 43 6f 6e 74 65 6e 74 20 26 26 20 21 70 50 61  oContent && !pPa
1f9f0 67 65 72 2d 3e 61 6c 77 61 79 73 52 6f 6c 6c 62  ger->alwaysRollb
1fa00 61 63 6b 3b 0a 20 20 20 20 20 20 49 4f 54 52 41  ack;.      IOTRA
1fa10 43 45 28 28 22 5a 45 52 4f 20 25 70 20 25 64 5c  CE(("ZERO %p %d\
1fa20 6e 22 2c 20 70 50 61 67 65 72 2c 20 70 67 6e 6f  n", pPager, pgno
1fa30 29 29 3b 0a 20 20 20 20 7d 65 6c 73 65 7b 0a 20  ));.    }else{. 
1fa40 20 20 20 20 20 72 63 20 3d 20 72 65 61 64 44 62       rc = readDb
1fa50 50 61 67 65 28 70 50 61 67 65 72 2c 20 70 50 67  Page(pPager, pPg
1fa60 2c 20 70 67 6e 6f 29 3b 0a 20 20 20 20 20 20 69  , pgno);.      i
1fa70 66 28 20 72 63 21 3d 53 51 4c 49 54 45 5f 4f 4b  f( rc!=SQLITE_OK
1fa80 20 26 26 20 72 63 21 3d 53 51 4c 49 54 45 5f 49   && rc!=SQLITE_I
1fa90 4f 45 52 52 5f 53 48 4f 52 54 5f 52 45 41 44 20  OERR_SHORT_READ 
1faa0 29 7b 0a 20 20 20 20 20 20 20 20 70 50 67 2d 3e  ){.        pPg->
1fab0 70 67 6e 6f 20 3d 20 30 3b 0a 20 20 20 20 20 20  pgno = 0;.      
1fac0 20 20 73 71 6c 69 74 65 33 50 61 67 65 72 55 6e    sqlite3PagerUn
1fad0 72 65 66 28 70 50 67 29 3b 0a 20 20 20 20 20 20  ref(pPg);.      
1fae0 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 20 20 20    return rc;.   
1faf0 20 20 20 7d 0a 20 20 20 20 20 20 70 50 67 2d 3e     }.      pPg->
1fb00 6e 65 65 64 52 65 61 64 20 3d 20 30 3b 0a 20 20  needRead = 0;.  
1fb10 20 20 7d 0a 0a 20 20 20 20 2f 2a 20 4c 69 6e 6b    }..    /* Link
1fb20 20 74 68 65 20 70 61 67 65 20 69 6e 74 6f 20 74   the page into t
1fb30 68 65 20 70 61 67 65 20 68 61 73 68 20 74 61 62  he page hash tab
1fb40 6c 65 20 2a 2f 0a 20 20 20 20 68 20 3d 20 70 67  le */.    h = pg
1fb50 6e 6f 20 26 20 28 70 50 61 67 65 72 2d 3e 6e 48  no & (pPager->nH
1fb60 61 73 68 2d 31 29 3b 0a 20 20 20 20 61 73 73 65  ash-1);.    asse
1fb70 72 74 28 20 70 67 6e 6f 21 3d 30 20 29 3b 0a 20  rt( pgno!=0 );. 
1fb80 20 20 20 70 50 67 2d 3e 70 4e 65 78 74 48 61 73     pPg->pNextHas
1fb90 68 20 3d 20 70 50 61 67 65 72 2d 3e 61 48 61 73  h = pPager->aHas
1fba0 68 5b 68 5d 3b 0a 20 20 20 20 70 50 61 67 65 72  h[h];.    pPager
1fbb0 2d 3e 61 48 61 73 68 5b 68 5d 20 3d 20 70 50 67  ->aHash[h] = pPg
1fbc0 3b 0a 20 20 20 20 69 66 28 20 70 50 67 2d 3e 70  ;.    if( pPg->p
1fbd0 4e 65 78 74 48 61 73 68 20 29 7b 0a 20 20 20 20  NextHash ){.    
1fbe0 20 20 61 73 73 65 72 74 28 20 70 50 67 2d 3e 70    assert( pPg->p
1fbf0 4e 65 78 74 48 61 73 68 2d 3e 70 50 72 65 76 48  NextHash->pPrevH
1fc00 61 73 68 3d 3d 30 20 29 3b 0a 20 20 20 20 20 20  ash==0 );.      
1fc10 70 50 67 2d 3e 70 4e 65 78 74 48 61 73 68 2d 3e  pPg->pNextHash->
1fc20 70 50 72 65 76 48 61 73 68 20 3d 20 70 50 67 3b  pPrevHash = pPg;
1fc30 0a 20 20 20 20 7d 0a 0a 23 69 66 64 65 66 20 53  .    }..#ifdef S
1fc40 51 4c 49 54 45 5f 43 48 45 43 4b 5f 50 41 47 45  QLITE_CHECK_PAGE
1fc50 53 0a 20 20 20 20 70 50 67 2d 3e 70 61 67 65 48  S.    pPg->pageH
1fc60 61 73 68 20 3d 20 70 61 67 65 72 5f 70 61 67 65  ash = pager_page
1fc70 68 61 73 68 28 70 50 67 29 3b 0a 23 65 6e 64 69  hash(pPg);.#endi
1fc80 66 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 2f  f.  }else{.    /
1fc90 2a 20 54 68 65 20 72 65 71 75 65 73 74 65 64 20  * The requested 
1fca0 70 61 67 65 20 69 73 20 69 6e 20 74 68 65 20 70  page is in the p
1fcb0 61 67 65 20 63 61 63 68 65 2e 20 2a 2f 0a 20 20  age cache. */.  
1fcc0 20 20 61 73 73 65 72 74 28 70 50 61 67 65 72 2d    assert(pPager-
1fcd0 3e 6e 52 65 66 3e 30 20 7c 7c 20 70 67 6e 6f 3d  >nRef>0 || pgno=
1fce0 3d 31 29 3b 0a 20 20 20 20 50 41 47 45 52 5f 49  =1);.    PAGER_I
1fcf0 4e 43 52 28 70 50 61 67 65 72 2d 3e 6e 48 69 74  NCR(pPager->nHit
1fd00 29 3b 0a 20 20 20 20 69 66 28 20 21 6e 6f 43 6f  );.    if( !noCo
1fd10 6e 74 65 6e 74 20 29 7b 0a 20 20 20 20 20 20 72  ntent ){.      r
1fd20 63 20 3d 20 70 61 67 65 72 5f 67 65 74 5f 63 6f  c = pager_get_co
1fd30 6e 74 65 6e 74 28 70 50 67 29 3b 0a 20 20 20 20  ntent(pPg);.    
1fd40 20 20 69 66 28 20 72 63 20 29 7b 0a 20 20 20 20    if( rc ){.    
1fd50 20 20 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 20      return rc;. 
1fd60 20 20 20 20 20 7d 0a 20 20 20 20 7d 0a 20 20 20       }.    }.   
1fd70 20 70 61 67 65 5f 72 65 66 28 70 50 67 29 3b 0a   page_ref(pPg);.
1fd80 20 20 7d 0a 20 20 2a 70 70 50 61 67 65 20 3d 20    }.  *ppPage = 
1fd90 70 50 67 3b 0a 20 20 72 65 74 75 72 6e 20 53 51  pPg;.  return SQ
1fda0 4c 49 54 45 5f 4f 4b 3b 0a 7d 0a 69 6e 74 20 73  LITE_OK;.}.int s
1fdb0 71 6c 69 74 65 33 50 61 67 65 72 41 63 71 75 69  qlite3PagerAcqui
1fdc0 72 65 28 0a 20 20 50 61 67 65 72 20 2a 70 50 61  re(.  Pager *pPa
1fdd0 67 65 72 2c 20 20 20 20 20 20 2f 2a 20 54 68 65  ger,      /* The
1fde0 20 70 61 67 65 72 20 6f 70 65 6e 20 6f 6e 20 74   pager open on t
1fdf0 68 65 20 64 61 74 61 62 61 73 65 20 66 69 6c 65  he database file
1fe00 20 2a 2f 0a 20 20 50 67 6e 6f 20 70 67 6e 6f 2c   */.  Pgno pgno,
1fe10 20 20 20 20 20 20 20 20 20 20 2f 2a 20 50 61 67            /* Pag
1fe20 65 20 6e 75 6d 62 65 72 20 74 6f 20 66 65 74 63  e number to fetc
1fe30 68 20 2a 2f 0a 20 20 44 62 50 61 67 65 20 2a 2a  h */.  DbPage **
1fe40 70 70 50 61 67 65 2c 20 20 20 20 2f 2a 20 57 72  ppPage,    /* Wr
1fe50 69 74 65 20 61 20 70 6f 69 6e 74 65 72 20 74 6f  ite a pointer to
1fe60 20 74 68 65 20 70 61 67 65 20 68 65 72 65 20 2a   the page here *
1fe70 2f 0a 20 20 69 6e 74 20 6e 6f 43 6f 6e 74 65 6e  /.  int noConten
1fe80 74 20 20 20 20 20 20 20 2f 2a 20 44 6f 20 6e 6f  t       /* Do no
1fe90 74 20 62 6f 74 68 65 72 20 72 65 61 64 69 6e 67  t bother reading
1fea0 20 63 6f 6e 74 65 6e 74 20 66 72 6f 6d 20 64 69   content from di
1feb0 73 6b 20 69 66 20 74 72 75 65 20 2a 2f 0a 29 7b  sk if true */.){
1fec0 0a 20 20 69 6e 74 20 72 63 3b 0a 20 20 70 61 67  .  int rc;.  pag
1fed0 65 72 45 6e 74 65 72 28 70 50 61 67 65 72 29 3b  erEnter(pPager);
1fee0 0a 20 20 72 63 20 3d 20 70 61 67 65 72 41 63 71  .  rc = pagerAcq
1fef0 75 69 72 65 28 70 50 61 67 65 72 2c 20 70 67 6e  uire(pPager, pgn
1ff00 6f 2c 20 70 70 50 61 67 65 2c 20 6e 6f 43 6f 6e  o, ppPage, noCon
1ff10 74 65 6e 74 29 3b 0a 20 20 70 61 67 65 72 4c 65  tent);.  pagerLe
1ff20 61 76 65 28 70 50 61 67 65 72 29 3b 0a 20 20 72  ave(pPager);.  r
1ff30 65 74 75 72 6e 20 72 63 3b 0a 7d 0a 0a 0a 2f 2a  eturn rc;.}.../*
1ff40 0a 2a 2a 20 41 63 71 75 69 72 65 20 61 20 70 61  .** Acquire a pa
1ff50 67 65 20 69 66 20 69 74 20 69 73 20 61 6c 72 65  ge if it is alre
1ff60 61 64 79 20 69 6e 20 74 68 65 20 69 6e 2d 6d 65  ady in the in-me
1ff70 6d 6f 72 79 20 63 61 63 68 65 2e 20 20 44 6f 0a  mory cache.  Do.
1ff80 2a 2a 20 6e 6f 74 20 72 65 61 64 20 74 68 65 20  ** not read the 
1ff90 70 61 67 65 20 66 72 6f 6d 20 64 69 73 6b 2e 20  page from disk. 
1ffa0 20 52 65 74 75 72 6e 20 61 20 70 6f 69 6e 74 65   Return a pointe
1ffb0 72 20 74 6f 20 74 68 65 20 70 61 67 65 2c 0a 2a  r to the page,.*
1ffc0 2a 20 6f 72 20 30 20 69 66 20 74 68 65 20 70 61  * or 0 if the pa
1ffd0 67 65 20 69 73 20 6e 6f 74 20 69 6e 20 63 61 63  ge is not in cac
1ffe0 68 65 2e 0a 2a 2a 0a 2a 2a 20 53 65 65 20 61 6c  he..**.** See al
1fff0 73 6f 20 73 71 6c 69 74 65 33 50 61 67 65 72 47  so sqlite3PagerG
20000 65 74 28 29 2e 20 20 54 68 65 20 64 69 66 66 65  et().  The diffe
20010 72 65 6e 63 65 20 62 65 74 77 65 65 6e 20 74 68  rence between th
20020 69 73 20 72 6f 75 74 69 6e 65 0a 2a 2a 20 61 6e  is routine.** an
20030 64 20 73 71 6c 69 74 65 33 50 61 67 65 72 47 65  d sqlite3PagerGe
20040 74 28 29 20 69 73 20 74 68 61 74 20 5f 67 65 74  t() is that _get
20050 28 29 20 77 69 6c 6c 20 67 6f 20 74 6f 20 74 68  () will go to th
20060 65 20 64 69 73 6b 20 61 6e 64 20 72 65 61 64 0a  e disk and read.
20070 2a 2a 20 69 6e 20 74 68 65 20 70 61 67 65 20 69  ** in the page i
20080 66 20 74 68 65 20 70 61 67 65 20 69 73 20 6e 6f  f the page is no
20090 74 20 61 6c 72 65 61 64 79 20 69 6e 20 63 61 63  t already in cac
200a0 68 65 2e 20 20 54 68 69 73 20 72 6f 75 74 69 6e  he.  This routin
200b0 65 0a 2a 2a 20 72 65 74 75 72 6e 73 20 4e 55 4c  e.** returns NUL
200c0 4c 20 69 66 20 74 68 65 20 70 61 67 65 20 69 73  L if the page is
200d0 20 6e 6f 74 20 69 6e 20 63 61 63 68 65 20 6f 72   not in cache or
200e0 20 69 66 20 61 20 64 69 73 6b 20 49 2f 4f 20 65   if a disk I/O e
200f0 72 72 6f 72 20 0a 2a 2a 20 68 61 73 20 65 76 65  rror .** has eve
20100 72 20 68 61 70 70 65 6e 65 64 2e 0a 2a 2f 0a 44  r happened..*/.D
20110 62 50 61 67 65 20 2a 73 71 6c 69 74 65 33 50 61  bPage *sqlite3Pa
20120 67 65 72 4c 6f 6f 6b 75 70 28 50 61 67 65 72 20  gerLookup(Pager 
20130 2a 70 50 61 67 65 72 2c 20 50 67 6e 6f 20 70 67  *pPager, Pgno pg
20140 6e 6f 29 7b 0a 20 20 50 67 48 64 72 20 2a 70 50  no){.  PgHdr *pP
20150 67 20 3d 20 30 3b 0a 0a 20 20 61 73 73 65 72 74  g = 0;..  assert
20160 28 20 70 50 61 67 65 72 21 3d 30 20 29 3b 0a 20  ( pPager!=0 );. 
20170 20 61 73 73 65 72 74 28 20 70 67 6e 6f 21 3d 30   assert( pgno!=0
20180 20 29 3b 0a 0a 20 20 70 61 67 65 72 45 6e 74 65   );..  pagerEnte
20190 72 28 70 50 61 67 65 72 29 3b 0a 20 20 69 66 28  r(pPager);.  if(
201a0 20 70 50 61 67 65 72 2d 3e 73 74 61 74 65 3d 3d   pPager->state==
201b0 50 41 47 45 52 5f 55 4e 4c 4f 43 4b 20 29 7b 0a  PAGER_UNLOCK ){.
201c0 20 20 20 20 61 73 73 65 72 74 28 20 21 70 50 61      assert( !pPa
201d0 67 65 72 2d 3e 70 41 6c 6c 20 7c 7c 20 70 50 61  ger->pAll || pPa
201e0 67 65 72 2d 3e 65 78 63 6c 75 73 69 76 65 4d 6f  ger->exclusiveMo
201f0 64 65 20 29 3b 0a 20 20 7d 65 6c 73 65 20 69 66  de );.  }else if
20200 28 20 70 50 61 67 65 72 2d 3e 65 72 72 43 6f 64  ( pPager->errCod
20210 65 20 26 26 20 70 50 61 67 65 72 2d 3e 65 72 72  e && pPager->err
20220 43 6f 64 65 21 3d 53 51 4c 49 54 45 5f 46 55 4c  Code!=SQLITE_FUL
20230 4c 20 29 7b 0a 20 20 20 20 2f 2a 20 44 6f 20 6e  L ){.    /* Do n
20240 6f 74 68 69 6e 67 20 2a 2f 0a 20 20 7d 65 6c 73  othing */.  }els
20250 65 20 69 66 28 20 28 70 50 67 20 3d 20 70 61 67  e if( (pPg = pag
20260 65 72 5f 6c 6f 6f 6b 75 70 28 70 50 61 67 65 72  er_lookup(pPager
20270 2c 20 70 67 6e 6f 29 29 21 3d 30 20 29 7b 0a 20  , pgno))!=0 ){. 
20280 20 20 20 70 61 67 65 5f 72 65 66 28 70 50 67 29     page_ref(pPg)
20290 3b 0a 20 20 7d 0a 20 20 70 61 67 65 72 4c 65 61  ;.  }.  pagerLea
202a0 76 65 28 70 50 61 67 65 72 29 3b 0a 20 20 72 65  ve(pPager);.  re
202b0 74 75 72 6e 20 70 50 67 3b 0a 7d 0a 0a 2f 2a 0a  turn pPg;.}../*.
202c0 2a 2a 20 52 65 6c 65 61 73 65 20 61 20 70 61 67  ** Release a pag
202d0 65 2e 0a 2a 2a 0a 2a 2a 20 49 66 20 74 68 65 20  e..**.** If the 
202e0 6e 75 6d 62 65 72 20 6f 66 20 72 65 66 65 72 65  number of refere
202f0 6e 63 65 73 20 74 6f 20 74 68 65 20 70 61 67 65  nces to the page
20300 20 64 72 6f 70 20 74 6f 20 7a 65 72 6f 2c 20 74   drop to zero, t
20310 68 65 6e 20 74 68 65 0a 2a 2a 20 70 61 67 65 20  hen the.** page 
20320 69 73 20 61 64 64 65 64 20 74 6f 20 74 68 65 20  is added to the 
20330 4c 52 55 20 6c 69 73 74 2e 20 20 57 68 65 6e 20  LRU list.  When 
20340 61 6c 6c 20 72 65 66 65 72 65 6e 63 65 73 20 74  all references t
20350 6f 20 61 6c 6c 20 70 61 67 65 73 0a 2a 2a 20 61  o all pages.** a
20360 72 65 20 72 65 6c 65 61 73 65 64 2c 20 61 20 72  re released, a r
20370 6f 6c 6c 62 61 63 6b 20 6f 63 63 75 72 73 20 61  ollback occurs a
20380 6e 64 20 74 68 65 20 6c 6f 63 6b 20 6f 6e 20 74  nd the lock on t
20390 68 65 20 64 61 74 61 62 61 73 65 20 69 73 0a 2a  he database is.*
203a0 2a 20 72 65 6d 6f 76 65 64 2e 0a 2a 2f 0a 69 6e  * removed..*/.in
203b0 74 20 73 71 6c 69 74 65 33 50 61 67 65 72 55 6e  t sqlite3PagerUn
203c0 72 65 66 28 44 62 50 61 67 65 20 2a 70 50 67 29  ref(DbPage *pPg)
203d0 7b 0a 20 20 50 61 67 65 72 20 2a 70 50 61 67 65  {.  Pager *pPage
203e0 72 20 3d 20 70 50 67 2d 3e 70 50 61 67 65 72 3b  r = pPg->pPager;
203f0 0a 0a 20 20 2f 2a 20 44 65 63 72 65 6d 65 6e 74  ..  /* Decrement
20400 20 74 68 65 20 72 65 66 65 72 65 6e 63 65 20 63   the reference c
20410 6f 75 6e 74 20 66 6f 72 20 74 68 69 73 20 70 61  ount for this pa
20420 67 65 0a 20 20 2a 2f 0a 20 20 61 73 73 65 72 74  ge.  */.  assert
20430 28 20 70 50 67 2d 3e 6e 52 65 66 3e 30 20 29 3b  ( pPg->nRef>0 );
20440 0a 20 20 70 61 67 65 72 45 6e 74 65 72 28 70 50  .  pagerEnter(pP
20450 67 2d 3e 70 50 61 67 65 72 29 3b 0a 20 20 70 50  g->pPager);.  pP
20460 67 2d 3e 6e 52 65 66 2d 2d 3b 0a 0a 20 20 43 48  g->nRef--;..  CH
20470 45 43 4b 5f 50 41 47 45 28 70 50 67 29 3b 0a 0a  ECK_PAGE(pPg);..
20480 20 20 2f 2a 20 57 68 65 6e 20 74 68 65 20 6e 75    /* When the nu
20490 6d 62 65 72 20 6f 66 20 72 65 66 65 72 65 6e 63  mber of referenc
204a0 65 73 20 74 6f 20 61 20 70 61 67 65 20 72 65 61  es to a page rea
204b0 63 68 20 30 2c 20 63 61 6c 6c 20 74 68 65 0a 20  ch 0, call the. 
204c0 20 2a 2a 20 64 65 73 74 72 75 63 74 6f 72 20 61   ** destructor a
204d0 6e 64 20 61 64 64 20 74 68 65 20 70 61 67 65 20  nd add the page 
204e0 74 6f 20 74 68 65 20 66 72 65 65 6c 69 73 74 2e  to the freelist.
204f0 0a 20 20 2a 2f 0a 20 20 69 66 28 20 70 50 67 2d  .  */.  if( pPg-
20500 3e 6e 52 65 66 3d 3d 30 20 29 7b 0a 0a 20 20 20  >nRef==0 ){..   
20510 20 6c 72 75 4c 69 73 74 41 64 64 28 70 50 67 29   lruListAdd(pPg)
20520 3b 0a 20 20 20 20 69 66 28 20 70 50 61 67 65 72  ;.    if( pPager
20530 2d 3e 78 44 65 73 74 72 75 63 74 6f 72 20 29 7b  ->xDestructor ){
20540 0a 20 20 20 20 20 20 70 50 61 67 65 72 2d 3e 78  .      pPager->x
20550 44 65 73 74 72 75 63 74 6f 72 28 70 50 67 2c 20  Destructor(pPg, 
20560 70 50 61 67 65 72 2d 3e 70 61 67 65 53 69 7a 65  pPager->pageSize
20570 29 3b 0a 20 20 20 20 7d 0a 20 20 0a 20 20 20 20  );.    }.  .    
20580 2f 2a 20 57 68 65 6e 20 61 6c 6c 20 70 61 67 65  /* When all page
20590 73 20 72 65 61 63 68 20 74 68 65 20 66 72 65 65  s reach the free
205a0 6c 69 73 74 2c 20 64 72 6f 70 20 74 68 65 20 72  list, drop the r
205b0 65 61 64 20 6c 6f 63 6b 20 66 72 6f 6d 0a 20 20  ead lock from.  
205c0 20 20 2a 2a 20 74 68 65 20 64 61 74 61 62 61 73    ** the databas
205d0 65 20 66 69 6c 65 2e 0a 20 20 20 20 2a 2f 0a 20  e file..    */. 
205e0 20 20 20 70 50 61 67 65 72 2d 3e 6e 52 65 66 2d     pPager->nRef-
205f0 2d 3b 0a 20 20 20 20 61 73 73 65 72 74 28 20 70  -;.    assert( p
20600 50 61 67 65 72 2d 3e 6e 52 65 66 3e 3d 30 20 29  Pager->nRef>=0 )
20610 3b 0a 20 20 20 20 69 66 28 20 70 50 61 67 65 72  ;.    if( pPager
20620 2d 3e 6e 52 65 66 3d 3d 30 20 26 26 20 28 21 70  ->nRef==0 && (!p
20630 50 61 67 65 72 2d 3e 65 78 63 6c 75 73 69 76 65  Pager->exclusive
20640 4d 6f 64 65 20 7c 7c 20 70 50 61 67 65 72 2d 3e  Mode || pPager->
20650 6a 6f 75 72 6e 61 6c 4f 66 66 3e 30 29 20 29 7b  journalOff>0) ){
20660 0a 20 20 20 20 20 20 70 61 67 65 72 55 6e 6c 6f  .      pagerUnlo
20670 63 6b 41 6e 64 52 6f 6c 6c 62 61 63 6b 28 70 50  ckAndRollback(pP
20680 61 67 65 72 29 3b 0a 20 20 20 20 7d 0a 20 20 7d  ager);.    }.  }
20690 0a 20 20 70 61 67 65 72 4c 65 61 76 65 28 70 50  .  pagerLeave(pP
206a0 61 67 65 72 29 3b 0a 20 20 72 65 74 75 72 6e 20  ager);.  return 
206b0 53 51 4c 49 54 45 5f 4f 4b 3b 0a 7d 0a 0a 2f 2a  SQLITE_OK;.}../*
206c0 0a 2a 2a 20 43 72 65 61 74 65 20 61 20 6a 6f 75  .** Create a jou
206d0 72 6e 61 6c 20 66 69 6c 65 20 66 6f 72 20 70 50  rnal file for pP
206e0 61 67 65 72 2e 20 20 54 68 65 72 65 20 73 68 6f  ager.  There sho
206f0 75 6c 64 20 61 6c 72 65 61 64 79 20 62 65 20 61  uld already be a
20700 20 52 45 53 45 52 56 45 44 0a 2a 2a 20 6f 72 20   RESERVED.** or 
20710 45 58 43 4c 55 53 49 56 45 20 6c 6f 63 6b 20 6f  EXCLUSIVE lock o
20720 6e 20 74 68 65 20 64 61 74 61 62 61 73 65 20 66  n the database f
20730 69 6c 65 20 77 68 65 6e 20 74 68 69 73 20 72 6f  ile when this ro
20740 75 74 69 6e 65 20 69 73 20 63 61 6c 6c 65 64 2e  utine is called.
20750 0a 2a 2a 0a 2a 2a 20 52 65 74 75 72 6e 20 53 51  .**.** Return SQ
20760 4c 49 54 45 5f 4f 4b 20 69 66 20 65 76 65 72 79  LITE_OK if every
20770 74 68 69 6e 67 2e 20 20 52 65 74 75 72 6e 20 61  thing.  Return a
20780 6e 20 65 72 72 6f 72 20 63 6f 64 65 20 61 6e 64  n error code and
20790 20 72 65 6c 65 61 73 65 20 74 68 65 0a 2a 2a 20   release the.** 
207a0 77 72 69 74 65 20 6c 6f 63 6b 20 69 66 20 61 6e  write lock if an
207b0 79 74 68 69 6e 67 20 67 6f 65 73 20 77 72 6f 6e  ything goes wron
207c0 67 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74  g..*/.static int
207d0 20 70 61 67 65 72 5f 6f 70 65 6e 5f 6a 6f 75 72   pager_open_jour
207e0 6e 61 6c 28 50 61 67 65 72 20 2a 70 50 61 67 65  nal(Pager *pPage
207f0 72 29 7b 0a 20 20 73 71 6c 69 74 65 33 5f 76 66  r){.  sqlite3_vf
20800 73 20 2a 70 56 66 73 20 3d 20 70 50 61 67 65 72  s *pVfs = pPager
20810 2d 3e 70 56 66 73 3b 0a 20 20 69 6e 74 20 66 6c  ->pVfs;.  int fl
20820 61 67 73 20 3d 20 28 53 51 4c 49 54 45 5f 4f 50  ags = (SQLITE_OP
20830 45 4e 5f 52 45 41 44 57 52 49 54 45 7c 53 51 4c  EN_READWRITE|SQL
20840 49 54 45 5f 4f 50 45 4e 5f 45 58 43 4c 55 53 49  ITE_OPEN_EXCLUSI
20850 56 45 7c 53 51 4c 49 54 45 5f 4f 50 45 4e 5f 43  VE|SQLITE_OPEN_C
20860 52 45 41 54 45 29 3b 0a 0a 20 20 69 6e 74 20 72  REATE);..  int r
20870 63 3b 0a 20 20 61 73 73 65 72 74 28 20 21 4d 45  c;.  assert( !ME
20880 4d 44 42 20 29 3b 0a 20 20 61 73 73 65 72 74 28  MDB );.  assert(
20890 20 70 50 61 67 65 72 2d 3e 73 74 61 74 65 3e 3d   pPager->state>=
208a0 50 41 47 45 52 5f 52 45 53 45 52 56 45 44 20 29  PAGER_RESERVED )
208b0 3b 0a 20 20 61 73 73 65 72 74 28 20 70 50 61 67  ;.  assert( pPag
208c0 65 72 2d 3e 75 73 65 4a 6f 75 72 6e 61 6c 20 29  er->useJournal )
208d0 3b 0a 20 20 61 73 73 65 72 74 28 20 70 50 61 67  ;.  assert( pPag
208e0 65 72 2d 3e 70 49 6e 4a 6f 75 72 6e 61 6c 3d 3d  er->pInJournal==
208f0 30 20 29 3b 0a 20 20 73 71 6c 69 74 65 33 50 61  0 );.  sqlite3Pa
20900 67 65 72 50 61 67 65 63 6f 75 6e 74 28 70 50 61  gerPagecount(pPa
20910 67 65 72 29 3b 0a 20 20 70 61 67 65 72 4c 65 61  ger);.  pagerLea
20920 76 65 28 70 50 61 67 65 72 29 3b 0a 20 20 70 50  ve(pPager);.  pP
20930 61 67 65 72 2d 3e 70 49 6e 4a 6f 75 72 6e 61 6c  ager->pInJournal
20940 20 3d 20 73 71 6c 69 74 65 33 42 69 74 76 65 63   = sqlite3Bitvec
20950 43 72 65 61 74 65 28 70 50 61 67 65 72 2d 3e 64  Create(pPager->d
20960 62 53 69 7a 65 29 3b 0a 20 20 70 61 67 65 72 45  bSize);.  pagerE
20970 6e 74 65 72 28 70 50 61 67 65 72 29 3b 0a 20 20  nter(pPager);.  
20980 69 66 28 20 70 50 61 67 65 72 2d 3e 70 49 6e 4a  if( pPager->pInJ
20990 6f 75 72 6e 61 6c 3d 3d 30 20 29 7b 0a 20 20 20  ournal==0 ){.   
209a0 20 72 63 20 3d 20 53 51 4c 49 54 45 5f 4e 4f 4d   rc = SQLITE_NOM
209b0 45 4d 3b 0a 20 20 20 20 67 6f 74 6f 20 66 61 69  EM;.    goto fai
209c0 6c 65 64 5f 74 6f 5f 6f 70 65 6e 5f 6a 6f 75 72  led_to_open_jour
209d0 6e 61 6c 3b 0a 20 20 7d 0a 0a 20 20 69 66 28 20  nal;.  }..  if( 
209e0 70 50 61 67 65 72 2d 3e 6a 6f 75 72 6e 61 6c 4f  pPager->journalO
209f0 70 65 6e 3d 3d 30 20 29 7b 0a 20 20 20 20 69 66  pen==0 ){.    if
20a00 28 20 70 50 61 67 65 72 2d 3e 74 65 6d 70 46 69  ( pPager->tempFi
20a10 6c 65 20 29 7b 0a 20 20 20 20 20 20 66 6c 61 67  le ){.      flag
20a20 73 20 7c 3d 20 28 53 51 4c 49 54 45 5f 4f 50 45  s |= (SQLITE_OPE
20a30 4e 5f 44 45 4c 45 54 45 4f 4e 43 4c 4f 53 45 7c  N_DELETEONCLOSE|
20a40 53 51 4c 49 54 45 5f 4f 50 45 4e 5f 54 45 4d 50  SQLITE_OPEN_TEMP
20a50 5f 4a 4f 55 52 4e 41 4c 29 3b 0a 20 20 20 20 7d  _JOURNAL);.    }
20a60 65 6c 73 65 7b 0a 20 20 20 20 20 20 66 6c 61 67  else{.      flag
20a70 73 20 7c 3d 20 28 53 51 4c 49 54 45 5f 4f 50 45  s |= (SQLITE_OPE
20a80 4e 5f 4d 41 49 4e 5f 4a 4f 55 52 4e 41 4c 29 3b  N_MAIN_JOURNAL);
20a90 0a 20 20 20 20 7d 0a 23 69 66 64 65 66 20 53 51  .    }.#ifdef SQ
20aa0 4c 49 54 45 5f 45 4e 41 42 4c 45 5f 41 54 4f 4d  LITE_ENABLE_ATOM
20ab0 49 43 5f 57 52 49 54 45 0a 20 20 20 20 72 63 20  IC_WRITE.    rc 
20ac0 3d 20 73 71 6c 69 74 65 33 4a 6f 75 72 6e 61 6c  = sqlite3Journal
20ad0 4f 70 65 6e 28 0a 20 20 20 20 20 20 20 20 70 56  Open(.        pV
20ae0 66 73 2c 20 70 50 61 67 65 72 2d 3e 7a 4a 6f 75  fs, pPager->zJou
20af0 72 6e 61 6c 2c 20 70 50 61 67 65 72 2d 3e 6a 66  rnal, pPager->jf
20b00 64 2c 20 66 6c 61 67 73 2c 20 6a 72 6e 6c 42 75  d, flags, jrnlBu
20b10 66 66 65 72 53 69 7a 65 28 70 50 61 67 65 72 29  fferSize(pPager)
20b20 0a 20 20 20 20 29 3b 0a 23 65 6c 73 65 0a 20 20  .    );.#else.  
20b30 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33 4f 73    rc = sqlite3Os
20b40 4f 70 65 6e 28 70 56 66 73 2c 20 70 50 61 67 65  Open(pVfs, pPage
20b50 72 2d 3e 7a 4a 6f 75 72 6e 61 6c 2c 20 70 50 61  r->zJournal, pPa
20b60 67 65 72 2d 3e 6a 66 64 2c 20 66 6c 61 67 73 2c  ger->jfd, flags,
20b70 20 30 29 3b 0a 23 65 6e 64 69 66 0a 20 20 20 20   0);.#endif.    
20b80 61 73 73 65 72 74 28 20 72 63 21 3d 53 51 4c 49  assert( rc!=SQLI
20b90 54 45 5f 4f 4b 20 7c 7c 20 70 50 61 67 65 72 2d  TE_OK || pPager-
20ba0 3e 6a 66 64 2d 3e 70 4d 65 74 68 6f 64 73 20 29  >jfd->pMethods )
20bb0 3b 0a 20 20 20 20 70 50 61 67 65 72 2d 3e 6a 6f  ;.    pPager->jo
20bc0 75 72 6e 61 6c 4f 66 66 20 3d 20 30 3b 0a 20 20  urnalOff = 0;.  
20bd0 20 20 70 50 61 67 65 72 2d 3e 73 65 74 4d 61 73    pPager->setMas
20be0 74 65 72 20 3d 20 30 3b 0a 20 20 20 20 70 50 61  ter = 0;.    pPa
20bf0 67 65 72 2d 3e 6a 6f 75 72 6e 61 6c 48 64 72 20  ger->journalHdr 
20c00 3d 20 30 3b 0a 20 20 20 20 69 66 28 20 72 63 21  = 0;.    if( rc!
20c10 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20  =SQLITE_OK ){.  
20c20 20 20 20 20 69 66 28 20 72 63 3d 3d 53 51 4c 49      if( rc==SQLI
20c30 54 45 5f 4e 4f 4d 45 4d 20 29 7b 0a 20 20 20 20  TE_NOMEM ){.    
20c40 20 20 20 20 73 71 6c 69 74 65 33 4f 73 44 65 6c      sqlite3OsDel
20c50 65 74 65 28 70 56 66 73 2c 20 70 50 61 67 65 72  ete(pVfs, pPager
20c60 2d 3e 7a 4a 6f 75 72 6e 61 6c 2c 20 30 29 3b 0a  ->zJournal, 0);.
20c70 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 67 6f        }.      go
20c80 74 6f 20 66 61 69 6c 65 64 5f 74 6f 5f 6f 70 65  to failed_to_ope
20c90 6e 5f 6a 6f 75 72 6e 61 6c 3b 0a 20 20 20 20 7d  n_journal;.    }
20ca0 0a 20 20 7d 0a 20 20 70 50 61 67 65 72 2d 3e 6a  .  }.  pPager->j
20cb0 6f 75 72 6e 61 6c 4f 70 65 6e 20 3d 20 31 3b 0a  ournalOpen = 1;.
20cc0 20 20 70 50 61 67 65 72 2d 3e 6a 6f 75 72 6e 61    pPager->journa
20cd0 6c 53 74 61 72 74 65 64 20 3d 20 30 3b 0a 20 20  lStarted = 0;.  
20ce0 70 50 61 67 65 72 2d 3e 6e 65 65 64 53 79 6e 63  pPager->needSync
20cf0 20 3d 20 30 3b 0a 20 20 70 50 61 67 65 72 2d 3e   = 0;.  pPager->
20d00 61 6c 77 61 79 73 52 6f 6c 6c 62 61 63 6b 20 3d  alwaysRollback =
20d10 20 30 3b 0a 20 20 70 50 61 67 65 72 2d 3e 6e 52   0;.  pPager->nR
20d20 65 63 20 3d 20 30 3b 0a 20 20 69 66 28 20 70 50  ec = 0;.  if( pP
20d30 61 67 65 72 2d 3e 65 72 72 43 6f 64 65 20 29 7b  ager->errCode ){
20d40 0a 20 20 20 20 72 63 20 3d 20 70 50 61 67 65 72  .    rc = pPager
20d50 2d 3e 65 72 72 43 6f 64 65 3b 0a 20 20 20 20 67  ->errCode;.    g
20d60 6f 74 6f 20 66 61 69 6c 65 64 5f 74 6f 5f 6f 70  oto failed_to_op
20d70 65 6e 5f 6a 6f 75 72 6e 61 6c 3b 0a 20 20 7d 0a  en_journal;.  }.
20d80 20 20 70 50 61 67 65 72 2d 3e 6f 72 69 67 44 62    pPager->origDb
20d90 53 69 7a 65 20 3d 20 70 50 61 67 65 72 2d 3e 64  Size = pPager->d
20da0 62 53 69 7a 65 3b 0a 0a 20 20 72 63 20 3d 20 77  bSize;..  rc = w
20db0 72 69 74 65 4a 6f 75 72 6e 61 6c 48 64 72 28 70  riteJournalHdr(p
20dc0 50 61 67 65 72 29 3b 0a 0a 20 20 69 66 28 20 70  Pager);..  if( p
20dd0 50 61 67 65 72 2d 3e 73 74 6d 74 41 75 74 6f 6f  Pager->stmtAutoo
20de0 70 65 6e 20 26 26 20 72 63 3d 3d 53 51 4c 49 54  pen && rc==SQLIT
20df0 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 72 63 20 3d  E_OK ){.    rc =
20e00 20 73 71 6c 69 74 65 33 50 61 67 65 72 53 74 6d   sqlite3PagerStm
20e10 74 42 65 67 69 6e 28 70 50 61 67 65 72 29 3b 0a  tBegin(pPager);.
20e20 20 20 7d 0a 20 20 69 66 28 20 72 63 21 3d 53 51    }.  if( rc!=SQ
20e30 4c 49 54 45 5f 4f 4b 20 26 26 20 72 63 21 3d 53  LITE_OK && rc!=S
20e40 51 4c 49 54 45 5f 4e 4f 4d 45 4d 20 26 26 20 72  QLITE_NOMEM && r
20e50 63 21 3d 53 51 4c 49 54 45 5f 49 4f 45 52 52 5f  c!=SQLITE_IOERR_
20e60 4e 4f 4d 45 4d 20 29 7b 0a 20 20 20 20 72 63 20  NOMEM ){.    rc 
20e70 3d 20 70 61 67 65 72 5f 65 6e 64 5f 74 72 61 6e  = pager_end_tran
20e80 73 61 63 74 69 6f 6e 28 70 50 61 67 65 72 29 3b  saction(pPager);
20e90 0a 20 20 20 20 69 66 28 20 72 63 3d 3d 53 51 4c  .    if( rc==SQL
20ea0 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 20 20  ITE_OK ){.      
20eb0 72 63 20 3d 20 53 51 4c 49 54 45 5f 46 55 4c 4c  rc = SQLITE_FULL
20ec0 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a 20 20 72 65  ;.    }.  }.  re
20ed0 74 75 72 6e 20 72 63 3b 0a 0a 66 61 69 6c 65 64  turn rc;..failed
20ee0 5f 74 6f 5f 6f 70 65 6e 5f 6a 6f 75 72 6e 61 6c  _to_open_journal
20ef0 3a 0a 20 20 73 71 6c 69 74 65 33 42 69 74 76 65  :.  sqlite3Bitve
20f00 63 44 65 73 74 72 6f 79 28 70 50 61 67 65 72 2d  cDestroy(pPager-
20f10 3e 70 49 6e 4a 6f 75 72 6e 61 6c 29 3b 0a 20 20  >pInJournal);.  
20f20 70 50 61 67 65 72 2d 3e 70 49 6e 4a 6f 75 72 6e  pPager->pInJourn
20f30 61 6c 20 3d 20 30 3b 0a 20 20 72 65 74 75 72 6e  al = 0;.  return
20f40 20 72 63 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 41 63   rc;.}../*.** Ac
20f50 71 75 69 72 65 20 61 20 77 72 69 74 65 2d 6c 6f  quire a write-lo
20f60 63 6b 20 6f 6e 20 74 68 65 20 64 61 74 61 62 61  ck on the databa
20f70 73 65 2e 20 20 54 68 65 20 6c 6f 63 6b 20 69 73  se.  The lock is
20f80 20 72 65 6d 6f 76 65 64 20 77 68 65 6e 0a 2a 2a   removed when.**
20f90 20 74 68 65 20 61 6e 79 20 6f 66 20 74 68 65 20   the any of the 
20fa0 66 6f 6c 6c 6f 77 69 6e 67 20 68 61 70 70 65 6e  following happen
20fb0 3a 0a 2a 2a 0a 2a 2a 20 20 20 2a 20 20 73 71 6c  :.**.**   *  sql
20fc0 69 74 65 33 50 61 67 65 72 43 6f 6d 6d 69 74 50  ite3PagerCommitP
20fd0 68 61 73 65 54 77 6f 28 29 20 69 73 20 63 61 6c  haseTwo() is cal
20fe0 6c 65 64 2e 0a 2a 2a 20 20 20 2a 20 20 73 71 6c  led..**   *  sql
20ff0 69 74 65 33 50 61 67 65 72 52 6f 6c 6c 62 61 63  ite3PagerRollbac
21000 6b 28 29 20 69 73 20 63 61 6c 6c 65 64 2e 0a 2a  k() is called..*
21010 2a 20 20 20 2a 20 20 73 71 6c 69 74 65 33 50 61  *   *  sqlite3Pa
21020 67 65 72 43 6c 6f 73 65 28 29 20 69 73 20 63 61  gerClose() is ca
21030 6c 6c 65 64 2e 0a 2a 2a 20 20 20 2a 20 20 73 71  lled..**   *  sq
21040 6c 69 74 65 33 50 61 67 65 72 55 6e 72 65 66 28  lite3PagerUnref(
21050 29 20 69 73 20 63 61 6c 6c 65 64 20 74 6f 20 6f  ) is called to o
21060 6e 20 65 76 65 72 79 20 6f 75 74 73 74 61 6e 64  n every outstand
21070 69 6e 67 20 70 61 67 65 2e 0a 2a 2a 0a 2a 2a 20  ing page..**.** 
21080 54 68 65 20 66 69 72 73 74 20 70 61 72 61 6d 65  The first parame
21090 74 65 72 20 74 6f 20 74 68 69 73 20 72 6f 75 74  ter to this rout
210a0 69 6e 65 20 69 73 20 61 20 70 6f 69 6e 74 65 72  ine is a pointer
210b0 20 74 6f 20 61 6e 79 20 6f 70 65 6e 20 70 61 67   to any open pag
210c0 65 20 6f 66 20 74 68 65 0a 2a 2a 20 64 61 74 61  e of the.** data
210d0 62 61 73 65 20 66 69 6c 65 2e 20 20 4e 6f 74 68  base file.  Noth
210e0 69 6e 67 20 63 68 61 6e 67 65 73 20 61 62 6f 75  ing changes abou
210f0 74 20 74 68 65 20 70 61 67 65 20 2d 20 69 74 20  t the page - it 
21100 69 73 20 75 73 65 64 20 6d 65 72 65 6c 79 20 74  is used merely t
21110 6f 0a 2a 2a 20 61 63 71 75 69 72 65 20 61 20 70  o.** acquire a p
21120 6f 69 6e 74 65 72 20 74 6f 20 74 68 65 20 50 61  ointer to the Pa
21130 67 65 72 20 73 74 72 75 63 74 75 72 65 20 61 6e  ger structure an
21140 64 20 61 73 20 70 72 6f 6f 66 20 74 68 61 74 20  d as proof that 
21150 74 68 65 72 65 20 69 73 0a 2a 2a 20 61 6c 72 65  there is.** alre
21160 61 64 79 20 61 20 72 65 61 64 2d 6c 6f 63 6b 20  ady a read-lock 
21170 6f 6e 20 74 68 65 20 64 61 74 61 62 61 73 65 2e  on the database.
21180 0a 2a 2a 0a 2a 2a 20 54 68 65 20 73 65 63 6f 6e  .**.** The secon
21190 64 20 70 61 72 61 6d 65 74 65 72 20 69 6e 64 69  d parameter indi
211a0 63 61 74 65 73 20 68 6f 77 20 6d 75 63 68 20 73  cates how much s
211b0 70 61 63 65 20 69 6e 20 62 79 74 65 73 20 74 6f  pace in bytes to
211c0 20 72 65 73 65 72 76 65 20 66 6f 72 20 61 0a 2a   reserve for a.*
211d0 2a 20 6d 61 73 74 65 72 20 6a 6f 75 72 6e 61 6c  * master journal
211e0 20 66 69 6c 65 2d 6e 61 6d 65 20 61 74 20 74 68   file-name at th
211f0 65 20 73 74 61 72 74 20 6f 66 20 74 68 65 20 6a  e start of the j
21200 6f 75 72 6e 61 6c 20 77 68 65 6e 20 69 74 20 69  ournal when it i
21210 73 20 63 72 65 61 74 65 64 2e 0a 2a 2a 0a 2a 2a  s created..**.**
21220 20 41 20 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 20   A journal file 
21230 69 73 20 6f 70 65 6e 65 64 20 69 66 20 74 68 69  is opened if thi
21240 73 20 69 73 20 6e 6f 74 20 61 20 74 65 6d 70 6f  s is not a tempo
21250 72 61 72 79 20 66 69 6c 65 2e 20 20 46 6f 72 20  rary file.  For 
21260 74 65 6d 70 6f 72 61 72 79 0a 2a 2a 20 66 69 6c  temporary.** fil
21270 65 73 2c 20 74 68 65 20 6f 70 65 6e 69 6e 67 20  es, the opening 
21280 6f 66 20 74 68 65 20 6a 6f 75 72 6e 61 6c 20 66  of the journal f
21290 69 6c 65 20 69 73 20 64 65 66 65 72 72 65 64 20  ile is deferred 
212a0 75 6e 74 69 6c 20 74 68 65 72 65 20 69 73 20 61  until there is a
212b0 6e 0a 2a 2a 20 61 63 74 75 61 6c 20 6e 65 65 64  n.** actual need
212c0 20 74 6f 20 77 72 69 74 65 20 74 6f 20 74 68 65   to write to the
212d0 20 6a 6f 75 72 6e 61 6c 2e 0a 2a 2a 0a 2a 2a 20   journal..**.** 
212e0 49 66 20 74 68 65 20 64 61 74 61 62 61 73 65 20  If the database 
212f0 69 73 20 61 6c 72 65 61 64 79 20 72 65 73 65 72  is already reser
21300 76 65 64 20 66 6f 72 20 77 72 69 74 69 6e 67 2c  ved for writing,
21310 20 74 68 69 73 20 72 6f 75 74 69 6e 65 20 69 73   this routine is
21320 20 61 20 6e 6f 2d 6f 70 2e 0a 2a 2a 0a 2a 2a 20   a no-op..**.** 
21330 49 66 20 65 78 46 6c 61 67 20 69 73 20 74 72 75  If exFlag is tru
21340 65 2c 20 67 6f 20 61 68 65 61 64 20 61 6e 64 20  e, go ahead and 
21350 67 65 74 20 61 6e 20 45 58 43 4c 55 53 49 56 45  get an EXCLUSIVE
21360 20 6c 6f 63 6b 20 6f 6e 20 74 68 65 20 66 69 6c   lock on the fil
21370 65 0a 2a 2a 20 69 6d 6d 65 64 69 61 74 65 6c 79  e.** immediately
21380 20 69 6e 73 74 65 61 64 20 6f 66 20 77 61 69 74   instead of wait
21390 69 6e 67 20 75 6e 74 69 6c 20 77 65 20 74 72 79  ing until we try
213a0 20 74 6f 20 66 6c 75 73 68 20 74 68 65 20 63 61   to flush the ca
213b0 63 68 65 2e 20 20 54 68 65 0a 2a 2a 20 65 78 46  che.  The.** exF
213c0 6c 61 67 20 69 73 20 69 67 6e 6f 72 65 64 20 69  lag is ignored i
213d0 66 20 61 20 74 72 61 6e 73 61 63 74 69 6f 6e 20  f a transaction 
213e0 69 73 20 61 6c 72 65 61 64 79 20 61 63 74 69 76  is already activ
213f0 65 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65  e..*/.int sqlite
21400 33 50 61 67 65 72 42 65 67 69 6e 28 44 62 50 61  3PagerBegin(DbPa
21410 67 65 20 2a 70 50 67 2c 20 69 6e 74 20 65 78 46  ge *pPg, int exF
21420 6c 61 67 29 7b 0a 20 20 50 61 67 65 72 20 2a 70  lag){.  Pager *p
21430 50 61 67 65 72 20 3d 20 70 50 67 2d 3e 70 50 61  Pager = pPg->pPa
21440 67 65 72 3b 0a 20 20 69 6e 74 20 72 63 20 3d 20  ger;.  int rc = 
21450 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20 20 70 61 67  SQLITE_OK;.  pag
21460 65 72 45 6e 74 65 72 28 70 50 61 67 65 72 29 3b  erEnter(pPager);
21470 0a 20 20 61 73 73 65 72 74 28 20 70 50 67 2d 3e  .  assert( pPg->
21480 6e 52 65 66 3e 30 20 29 3b 0a 20 20 61 73 73 65  nRef>0 );.  asse
21490 72 74 28 20 70 50 61 67 65 72 2d 3e 73 74 61 74  rt( pPager->stat
214a0 65 21 3d 50 41 47 45 52 5f 55 4e 4c 4f 43 4b 20  e!=PAGER_UNLOCK 
214b0 29 3b 0a 20 20 69 66 28 20 70 50 61 67 65 72 2d  );.  if( pPager-
214c0 3e 73 74 61 74 65 3d 3d 50 41 47 45 52 5f 53 48  >state==PAGER_SH
214d0 41 52 45 44 20 29 7b 0a 20 20 20 20 61 73 73 65  ARED ){.    asse
214e0 72 74 28 20 70 50 61 67 65 72 2d 3e 70 49 6e 4a  rt( pPager->pInJ
214f0 6f 75 72 6e 61 6c 3d 3d 30 20 29 3b 0a 20 20 20  ournal==0 );.   
21500 20 69 66 28 20 4d 45 4d 44 42 20 29 7b 0a 20 20   if( MEMDB ){.  
21510 20 20 20 20 70 50 61 67 65 72 2d 3e 73 74 61 74      pPager->stat
21520 65 20 3d 20 50 41 47 45 52 5f 45 58 43 4c 55 53  e = PAGER_EXCLUS
21530 49 56 45 3b 0a 20 20 20 20 20 20 70 50 61 67 65  IVE;.      pPage
21540 72 2d 3e 6f 72 69 67 44 62 53 69 7a 65 20 3d 20  r->origDbSize = 
21550 70 50 61 67 65 72 2d 3e 64 62 53 69 7a 65 3b 0a  pPager->dbSize;.
21560 20 20 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 20      }else{.     
21570 20 72 63 20 3d 20 73 71 6c 69 74 65 33 4f 73 4c   rc = sqlite3OsL
21580 6f 63 6b 28 70 50 61 67 65 72 2d 3e 66 64 2c 20  ock(pPager->fd, 
21590 52 45 53 45 52 56 45 44 5f 4c 4f 43 4b 29 3b 0a  RESERVED_LOCK);.
215a0 20 20 20 20 20 20 69 66 28 20 72 63 3d 3d 53 51        if( rc==SQ
215b0 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 20  LITE_OK ){.     
215c0 20 20 20 70 50 61 67 65 72 2d 3e 73 74 61 74 65     pPager->state
215d0 20 3d 20 50 41 47 45 52 5f 52 45 53 45 52 56 45   = PAGER_RESERVE
215e0 44 3b 0a 20 20 20 20 20 20 20 20 69 66 28 20 65  D;.        if( e
215f0 78 46 6c 61 67 20 29 7b 0a 20 20 20 20 20 20 20  xFlag ){.       
21600 20 20 20 72 63 20 3d 20 70 61 67 65 72 5f 77 61     rc = pager_wa
21610 69 74 5f 6f 6e 5f 6c 6f 63 6b 28 70 50 61 67 65  it_on_lock(pPage
21620 72 2c 20 45 58 43 4c 55 53 49 56 45 5f 4c 4f 43  r, EXCLUSIVE_LOC
21630 4b 29 3b 0a 20 20 20 20 20 20 20 20 7d 0a 20 20  K);.        }.  
21640 20 20 20 20 7d 0a 20 20 20 20 20 20 69 66 28 20      }.      if( 
21650 72 63 21 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b  rc!=SQLITE_OK ){
21660 0a 20 20 20 20 20 20 20 20 70 61 67 65 72 4c 65  .        pagerLe
21670 61 76 65 28 70 50 61 67 65 72 29 3b 0a 20 20 20  ave(pPager);.   
21680 20 20 20 20 20 72 65 74 75 72 6e 20 72 63 3b 0a       return rc;.
21690 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 70 50        }.      pP
216a0 61 67 65 72 2d 3e 64 69 72 74 79 43 61 63 68 65  ager->dirtyCache
216b0 20 3d 20 30 3b 0a 20 20 20 20 20 20 50 41 47 45   = 0;.      PAGE
216c0 52 54 52 41 43 45 32 28 22 54 52 41 4e 53 41 43  RTRACE2("TRANSAC
216d0 54 49 4f 4e 20 25 64 5c 6e 22 2c 20 50 41 47 45  TION %d\n", PAGE
216e0 52 49 44 28 70 50 61 67 65 72 29 29 3b 0a 20 20  RID(pPager));.  
216f0 20 20 20 20 69 66 28 20 70 50 61 67 65 72 2d 3e      if( pPager->
21700 75 73 65 4a 6f 75 72 6e 61 6c 20 26 26 20 21 70  useJournal && !p
21710 50 61 67 65 72 2d 3e 74 65 6d 70 46 69 6c 65 0a  Pager->tempFile.
21720 20 20 20 20 20 20 20 20 20 20 20 20 20 26 26 20               && 
21730 70 50 61 67 65 72 2d 3e 6a 6f 75 72 6e 61 6c 4d  pPager->journalM
21740 6f 64 65 21 3d 50 41 47 45 52 5f 4a 4f 55 52 4e  ode!=PAGER_JOURN
21750 41 4c 4d 4f 44 45 5f 4f 46 46 20 29 7b 0a 20 20  ALMODE_OFF ){.  
21760 20 20 20 20 20 20 72 63 20 3d 20 70 61 67 65 72        rc = pager
21770 5f 6f 70 65 6e 5f 6a 6f 75 72 6e 61 6c 28 70 50  _open_journal(pP
21780 61 67 65 72 29 3b 0a 20 20 20 20 20 20 7d 0a 20  ager);.      }. 
21790 20 20 20 7d 0a 20 20 7d 65 6c 73 65 20 69 66 28     }.  }else if(
217a0 20 70 50 61 67 65 72 2d 3e 6a 6f 75 72 6e 61 6c   pPager->journal
217b0 4f 70 65 6e 20 26 26 20 70 50 61 67 65 72 2d 3e  Open && pPager->
217c0 6a 6f 75 72 6e 61 6c 4f 66 66 3d 3d 30 20 29 7b  journalOff==0 ){
217d0 0a 20 20 20 20 2f 2a 20 54 68 69 73 20 68 61 70  .    /* This hap
217e0 70 65 6e 73 20 77 68 65 6e 20 74 68 65 20 70 61  pens when the pa
217f0 67 65 72 20 77 61 73 20 69 6e 20 65 78 63 6c 75  ger was in exclu
21800 73 69 76 65 2d 61 63 63 65 73 73 20 6d 6f 64 65  sive-access mode
21810 20 6c 61 73 74 0a 20 20 20 20 2a 2a 20 74 69 6d   last.    ** tim
21820 65 20 61 20 28 72 65 61 64 20 6f 72 20 77 72 69  e a (read or wri
21830 74 65 29 20 74 72 61 6e 73 61 63 74 69 6f 6e 20  te) transaction 
21840 77 61 73 20 73 75 63 63 65 73 73 66 75 6c 6c 79  was successfully
21850 20 63 6f 6e 63 6c 75 64 65 64 0a 20 20 20 20 2a   concluded.    *
21860 2a 20 62 79 20 74 68 69 73 20 63 6f 6e 6e 65 63  * by this connec
21870 74 69 6f 6e 2e 20 49 6e 73 74 65 61 64 20 6f 66  tion. Instead of
21880 20 64 65 6c 65 74 69 6e 67 20 74 68 65 20 6a 6f   deleting the jo
21890 75 72 6e 61 6c 20 66 69 6c 65 20 69 74 20 77 61  urnal file it wa
218a0 73 20 0a 20 20 20 20 2a 2a 20 6b 65 70 74 20 6f  s .    ** kept o
218b0 70 65 6e 20 61 6e 64 20 74 72 75 6e 63 61 74 65  pen and truncate
218c0 64 20 74 6f 20 30 20 62 79 74 65 73 2e 0a 20 20  d to 0 bytes..  
218d0 20 20 2a 2f 0a 20 20 20 20 61 73 73 65 72 74 28    */.    assert(
218e0 20 70 50 61 67 65 72 2d 3e 6e 52 65 63 3d 3d 30   pPager->nRec==0
218f0 20 29 3b 0a 20 20 20 20 61 73 73 65 72 74 28 20   );.    assert( 
21900 70 50 61 67 65 72 2d 3e 6f 72 69 67 44 62 53 69  pPager->origDbSi
21910 7a 65 3d 3d 30 20 29 3b 0a 20 20 20 20 61 73 73  ze==0 );.    ass
21920 65 72 74 28 20 70 50 61 67 65 72 2d 3e 70 49 6e  ert( pPager->pIn
21930 4a 6f 75 72 6e 61 6c 3d 3d 30 20 29 3b 0a 20 20  Journal==0 );.  
21940 20 20 73 71 6c 69 74 65 33 50 61 67 65 72 50 61    sqlite3PagerPa
21950 67 65 63 6f 75 6e 74 28 70 50 61 67 65 72 29 3b  gecount(pPager);
21960 0a 20 20 20 20 70 61 67 65 72 4c 65 61 76 65 28  .    pagerLeave(
21970 70 50 61 67 65 72 29 3b 0a 20 20 20 20 70 50 61  pPager);.    pPa
21980 67 65 72 2d 3e 70 49 6e 4a 6f 75 72 6e 61 6c 20  ger->pInJournal 
21990 3d 20 73 71 6c 69 74 65 33 42 69 74 76 65 63 43  = sqlite3BitvecC
219a0 72 65 61 74 65 28 20 70 50 61 67 65 72 2d 3e 64  reate( pPager->d
219b0 62 53 69 7a 65 20 29 3b 0a 20 20 20 20 70 61 67  bSize );.    pag
219c0 65 72 45 6e 74 65 72 28 70 50 61 67 65 72 29 3b  erEnter(pPager);
219d0 0a 20 20 20 20 69 66 28 20 21 70 50 61 67 65 72  .    if( !pPager
219e0 2d 3e 70 49 6e 4a 6f 75 72 6e 61 6c 20 29 7b 0a  ->pInJournal ){.
219f0 20 20 20 20 20 20 72 63 20 3d 20 53 51 4c 49 54        rc = SQLIT
21a00 45 5f 4e 4f 4d 45 4d 3b 0a 20 20 20 20 7d 65 6c  E_NOMEM;.    }el
21a10 73 65 7b 0a 20 20 20 20 20 20 70 50 61 67 65 72  se{.      pPager
21a20 2d 3e 6f 72 69 67 44 62 53 69 7a 65 20 3d 20 70  ->origDbSize = p
21a30 50 61 67 65 72 2d 3e 64 62 53 69 7a 65 3b 0a 20  Pager->dbSize;. 
21a40 20 20 20 20 20 72 63 20 3d 20 77 72 69 74 65 4a       rc = writeJ
21a50 6f 75 72 6e 61 6c 48 64 72 28 70 50 61 67 65 72  ournalHdr(pPager
21a60 29 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a 20 20 61  );.    }.  }.  a
21a70 73 73 65 72 74 28 20 21 70 50 61 67 65 72 2d 3e  ssert( !pPager->
21a80 6a 6f 75 72 6e 61 6c 4f 70 65 6e 20 7c 7c 20 70  journalOpen || p
21a90 50 61 67 65 72 2d 3e 6a 6f 75 72 6e 61 6c 4f 66  Pager->journalOf
21aa0 66 3e 30 20 7c 7c 20 72 63 21 3d 53 51 4c 49 54  f>0 || rc!=SQLIT
21ab0 45 5f 4f 4b 20 29 3b 0a 20 20 70 61 67 65 72 4c  E_OK );.  pagerL
21ac0 65 61 76 65 28 70 50 61 67 65 72 29 3b 0a 20 20  eave(pPager);.  
21ad0 72 65 74 75 72 6e 20 72 63 3b 0a 7d 0a 0a 2f 2a  return rc;.}../*
21ae0 0a 2a 2a 20 4d 61 6b 65 20 61 20 70 61 67 65 20  .** Make a page 
21af0 64 69 72 74 79 2e 20 20 53 65 74 20 69 74 73 20  dirty.  Set its 
21b00 64 69 72 74 79 20 66 6c 61 67 20 61 6e 64 20 61  dirty flag and a
21b10 64 64 20 69 74 20 74 6f 20 74 68 65 20 64 69 72  dd it to the dir
21b20 74 79 0a 2a 2a 20 70 61 67 65 20 6c 69 73 74 2e  ty.** page list.
21b30 0a 2a 2f 0a 73 74 61 74 69 63 20 76 6f 69 64 20  .*/.static void 
21b40 6d 61 6b 65 44 69 72 74 79 28 50 67 48 64 72 20  makeDirty(PgHdr 
21b50 2a 70 50 67 29 7b 0a 20 20 69 66 28 20 70 50 67  *pPg){.  if( pPg
21b60 2d 3e 64 69 72 74 79 3d 3d 30 20 29 7b 0a 20 20  ->dirty==0 ){.  
21b70 20 20 50 61 67 65 72 20 2a 70 50 61 67 65 72 20    Pager *pPager 
21b80 3d 20 70 50 67 2d 3e 70 50 61 67 65 72 3b 0a 20  = pPg->pPager;. 
21b90 20 20 20 70 50 67 2d 3e 64 69 72 74 79 20 3d 20     pPg->dirty = 
21ba0 31 3b 0a 20 20 20 20 70 50 67 2d 3e 70 44 69 72  1;.    pPg->pDir
21bb0 74 79 20 3d 20 70 50 61 67 65 72 2d 3e 70 44 69  ty = pPager->pDi
21bc0 72 74 79 3b 0a 20 20 20 20 69 66 28 20 70 50 61  rty;.    if( pPa
21bd0 67 65 72 2d 3e 70 44 69 72 74 79 20 29 7b 0a 20  ger->pDirty ){. 
21be0 20 20 20 20 20 70 50 61 67 65 72 2d 3e 70 44 69       pPager->pDi
21bf0 72 74 79 2d 3e 70 50 72 65 76 44 69 72 74 79 20  rty->pPrevDirty 
21c00 3d 20 70 50 67 3b 0a 20 20 20 20 7d 0a 20 20 20  = pPg;.    }.   
21c10 20 70 50 67 2d 3e 70 50 72 65 76 44 69 72 74 79   pPg->pPrevDirty
21c20 20 3d 20 30 3b 0a 20 20 20 20 70 50 61 67 65 72   = 0;.    pPager
21c30 2d 3e 70 44 69 72 74 79 20 3d 20 70 50 67 3b 0a  ->pDirty = pPg;.
21c40 20 20 7d 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 4d 61 6b    }.}../*.** Mak
21c50 65 20 61 20 70 61 67 65 20 63 6c 65 61 6e 2e 20  e a page clean. 
21c60 20 43 6c 65 61 72 20 69 74 73 20 64 69 72 74 79   Clear its dirty
21c70 20 62 69 74 20 61 6e 64 20 72 65 6d 6f 76 65 20   bit and remove 
21c80 69 74 20 66 72 6f 6d 20 74 68 65 0a 2a 2a 20 64  it from the.** d
21c90 69 72 74 79 20 70 61 67 65 20 6c 69 73 74 2e 0a  irty page list..
21ca0 2a 2f 0a 73 74 61 74 69 63 20 76 6f 69 64 20 6d  */.static void m
21cb0 61 6b 65 43 6c 65 61 6e 28 50 67 48 64 72 20 2a  akeClean(PgHdr *
21cc0 70 50 67 29 7b 0a 20 20 69 66 28 20 70 50 67 2d  pPg){.  if( pPg-
21cd0 3e 64 69 72 74 79 20 29 7b 0a 20 20 20 20 70 50  >dirty ){.    pP
21ce0 67 2d 3e 64 69 72 74 79 20 3d 20 30 3b 0a 20 20  g->dirty = 0;.  
21cf0 20 20 69 66 28 20 70 50 67 2d 3e 70 44 69 72 74    if( pPg->pDirt
21d00 79 20 29 7b 0a 20 20 20 20 20 20 61 73 73 65 72  y ){.      asser
21d10 74 28 20 70 50 67 2d 3e 70 44 69 72 74 79 2d 3e  t( pPg->pDirty->
21d20 70 50 72 65 76 44 69 72 74 79 3d 3d 70 50 67 20  pPrevDirty==pPg 
21d30 29 3b 0a 20 20 20 20 20 20 70 50 67 2d 3e 70 44  );.      pPg->pD
21d40 69 72 74 79 2d 3e 70 50 72 65 76 44 69 72 74 79  irty->pPrevDirty
21d50 20 3d 20 70 50 67 2d 3e 70 50 72 65 76 44 69 72   = pPg->pPrevDir
21d60 74 79 3b 0a 20 20 20 20 7d 0a 20 20 20 20 69 66  ty;.    }.    if
21d70 28 20 70 50 67 2d 3e 70 50 72 65 76 44 69 72 74  ( pPg->pPrevDirt
21d80 79 20 29 7b 0a 20 20 20 20 20 20 61 73 73 65 72  y ){.      asser
21d90 74 28 20 70 50 67 2d 3e 70 50 72 65 76 44 69 72  t( pPg->pPrevDir
21da0 74 79 2d 3e 70 44 69 72 74 79 3d 3d 70 50 67 20  ty->pDirty==pPg 
21db0 29 3b 0a 20 20 20 20 20 20 70 50 67 2d 3e 70 50  );.      pPg->pP
21dc0 72 65 76 44 69 72 74 79 2d 3e 70 44 69 72 74 79  revDirty->pDirty
21dd0 20 3d 20 70 50 67 2d 3e 70 44 69 72 74 79 3b 0a   = pPg->pDirty;.
21de0 20 20 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 20      }else{.     
21df0 20 61 73 73 65 72 74 28 20 70 50 67 2d 3e 70 50   assert( pPg->pP
21e00 61 67 65 72 2d 3e 70 44 69 72 74 79 3d 3d 70 50  ager->pDirty==pP
21e10 67 20 29 3b 0a 20 20 20 20 20 20 70 50 67 2d 3e  g );.      pPg->
21e20 70 50 61 67 65 72 2d 3e 70 44 69 72 74 79 20 3d  pPager->pDirty =
21e30 20 70 50 67 2d 3e 70 44 69 72 74 79 3b 0a 20 20   pPg->pDirty;.  
21e40 20 20 7d 0a 20 20 7d 0a 7d 0a 0a 0a 2f 2a 0a 2a    }.  }.}.../*.*
21e50 2a 20 4d 61 72 6b 20 61 20 64 61 74 61 20 70 61  * Mark a data pa
21e60 67 65 20 61 73 20 77 72 69 74 65 61 62 6c 65 2e  ge as writeable.
21e70 20 20 54 68 65 20 70 61 67 65 20 69 73 20 77 72    The page is wr
21e80 69 74 74 65 6e 20 69 6e 74 6f 20 74 68 65 20 6a  itten into the j
21e90 6f 75 72 6e 61 6c 20 0a 2a 2a 20 69 66 20 69 74  ournal .** if it
21ea0 20 69 73 20 6e 6f 74 20 74 68 65 72 65 20 61 6c   is not there al
21eb0 72 65 61 64 79 2e 20 20 54 68 69 73 20 72 6f 75  ready.  This rou
21ec0 74 69 6e 65 20 6d 75 73 74 20 62 65 20 63 61 6c  tine must be cal
21ed0 6c 65 64 20 62 65 66 6f 72 65 20 6d 61 6b 69 6e  led before makin
21ee0 67 0a 2a 2a 20 63 68 61 6e 67 65 73 20 74 6f 20  g.** changes to 
21ef0 61 20 70 61 67 65 2e 0a 2a 2a 0a 2a 2a 20 54 68  a page..**.** Th
21f00 65 20 66 69 72 73 74 20 74 69 6d 65 20 74 68 69  e first time thi
21f10 73 20 72 6f 75 74 69 6e 65 20 69 73 20 63 61 6c  s routine is cal
21f20 6c 65 64 2c 20 74 68 65 20 70 61 67 65 72 20 63  led, the pager c
21f30 72 65 61 74 65 73 20 61 20 6e 65 77 0a 2a 2a 20  reates a new.** 
21f40 6a 6f 75 72 6e 61 6c 20 61 6e 64 20 61 63 71 75  journal and acqu
21f50 69 72 65 73 20 61 20 52 45 53 45 52 56 45 44 20  ires a RESERVED 
21f60 6c 6f 63 6b 20 6f 6e 20 74 68 65 20 64 61 74 61  lock on the data
21f70 62 61 73 65 2e 20 20 49 66 20 74 68 65 20 52 45  base.  If the RE
21f80 53 45 52 56 45 44 0a 2a 2a 20 6c 6f 63 6b 20 63  SERVED.** lock c
21f90 6f 75 6c 64 20 6e 6f 74 20 62 65 20 61 63 71 75  ould not be acqu
21fa0 69 72 65 64 2c 20 74 68 69 73 20 72 6f 75 74 69  ired, this routi
21fb0 6e 65 20 72 65 74 75 72 6e 73 20 53 51 4c 49 54  ne returns SQLIT
21fc0 45 5f 42 55 53 59 2e 20 20 54 68 65 0a 2a 2a 20  E_BUSY.  The.** 
21fd0 63 61 6c 6c 69 6e 67 20 72 6f 75 74 69 6e 65 20  calling routine 
21fe0 6d 75 73 74 20 63 68 65 63 6b 20 66 6f 72 20 74  must check for t
21ff0 68 61 74 20 72 65 74 75 72 6e 20 76 61 6c 75 65  hat return value
22000 20 61 6e 64 20 62 65 20 63 61 72 65 66 75 6c 20   and be careful 
22010 6e 6f 74 20 74 6f 0a 2a 2a 20 63 68 61 6e 67 65  not to.** change
22020 20 61 6e 79 20 70 61 67 65 20 64 61 74 61 20 75   any page data u
22030 6e 74 69 6c 20 74 68 69 73 20 72 6f 75 74 69 6e  ntil this routin
22040 65 20 72 65 74 75 72 6e 73 20 53 51 4c 49 54 45  e returns SQLITE
22050 5f 4f 4b 2e 0a 2a 2a 0a 2a 2a 20 49 66 20 74 68  _OK..**.** If th
22060 65 20 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 20 63  e journal file c
22070 6f 75 6c 64 20 6e 6f 74 20 62 65 20 77 72 69 74  ould not be writ
22080 74 65 6e 20 62 65 63 61 75 73 65 20 74 68 65 20  ten because the 
22090 64 69 73 6b 20 69 73 20 66 75 6c 6c 2c 0a 2a 2a  disk is full,.**
220a0 20 74 68 65 6e 20 74 68 69 73 20 72 6f 75 74 69   then this routi
220b0 6e 65 20 72 65 74 75 72 6e 73 20 53 51 4c 49 54  ne returns SQLIT
220c0 45 5f 46 55 4c 4c 20 61 6e 64 20 64 6f 65 73 20  E_FULL and does 
220d0 61 6e 20 69 6d 6d 65 64 69 61 74 65 20 72 6f 6c  an immediate rol
220e0 6c 62 61 63 6b 2e 0a 2a 2a 20 41 6c 6c 20 73 75  lback..** All su
220f0 62 73 65 71 75 65 6e 74 20 77 72 69 74 65 20 61  bsequent write a
22100 74 74 65 6d 70 74 73 20 61 6c 73 6f 20 72 65 74  ttempts also ret
22110 75 72 6e 20 53 51 4c 49 54 45 5f 46 55 4c 4c 20  urn SQLITE_FULL 
22120 75 6e 74 69 6c 20 74 68 65 72 65 0a 2a 2a 20 69  until there.** i
22130 73 20 61 20 63 61 6c 6c 20 74 6f 20 73 71 6c 69  s a call to sqli
22140 74 65 33 50 61 67 65 72 43 6f 6d 6d 69 74 28 29  te3PagerCommit()
22150 20 6f 72 20 73 71 6c 69 74 65 33 50 61 67 65 72   or sqlite3Pager
22160 52 6f 6c 6c 62 61 63 6b 28 29 20 74 6f 0a 2a 2a  Rollback() to.**
22170 20 72 65 73 65 74 2e 0a 2a 2f 0a 73 74 61 74 69   reset..*/.stati
22180 63 20 69 6e 74 20 70 61 67 65 72 5f 77 72 69 74  c int pager_writ
22190 65 28 50 67 48 64 72 20 2a 70 50 67 29 7b 0a 20  e(PgHdr *pPg){. 
221a0 20 76 6f 69 64 20 2a 70 44 61 74 61 20 3d 20 50   void *pData = P
221b0 47 48 44 52 5f 54 4f 5f 44 41 54 41 28 70 50 67  GHDR_TO_DATA(pPg
221c0 29 3b 0a 20 20 50 61 67 65 72 20 2a 70 50 61 67  );.  Pager *pPag
221d0 65 72 20 3d 20 70 50 67 2d 3e 70 50 61 67 65 72  er = pPg->pPager
221e0 3b 0a 20 20 69 6e 74 20 72 63 20 3d 20 53 51 4c  ;.  int rc = SQL
221f0 49 54 45 5f 4f 4b 3b 0a 0a 20 20 2f 2a 20 43 68  ITE_OK;..  /* Ch
22200 65 63 6b 20 66 6f 72 20 65 72 72 6f 72 73 0a 20  eck for errors. 
22210 20 2a 2f 0a 20 20 69 66 28 20 70 50 61 67 65 72   */.  if( pPager
22220 2d 3e 65 72 72 43 6f 64 65 20 29 7b 20 0a 20 20  ->errCode ){ .  
22230 20 20 72 65 74 75 72 6e 20 70 50 61 67 65 72 2d    return pPager-
22240 3e 65 72 72 43 6f 64 65 3b 0a 20 20 7d 0a 20 20  >errCode;.  }.  
22250 69 66 28 20 70 50 61 67 65 72 2d 3e 72 65 61 64  if( pPager->read
22260 4f 6e 6c 79 20 29 7b 0a 20 20 20 20 72 65 74 75  Only ){.    retu
22270 72 6e 20 53 51 4c 49 54 45 5f 50 45 52 4d 3b 0a  rn SQLITE_PERM;.
22280 20 20 7d 0a 0a 20 20 61 73 73 65 72 74 28 20 21    }..  assert( !
22290 70 50 61 67 65 72 2d 3e 73 65 74 4d 61 73 74 65  pPager->setMaste
222a0 72 20 29 3b 0a 0a 20 20 43 48 45 43 4b 5f 50 41  r );..  CHECK_PA
222b0 47 45 28 70 50 67 29 3b 0a 0a 20 20 2f 2a 20 49  GE(pPg);..  /* I
222c0 66 20 74 68 69 73 20 70 61 67 65 20 77 61 73 20  f this page was 
222d0 70 72 65 76 69 6f 75 73 6c 79 20 61 63 71 75 69  previously acqui
222e0 72 65 64 20 77 69 74 68 20 6e 6f 43 6f 6e 74 65  red with noConte
222f0 6e 74 3d 3d 31 2c 20 74 68 61 74 20 6d 65 61 6e  nt==1, that mean
22300 73 0a 20 20 2a 2a 20 77 65 20 64 69 64 6e 27 74  s.  ** we didn't
22310 20 72 65 61 6c 6c 79 20 72 65 61 64 20 69 6e 20   really read in 
22320 74 68 65 20 63 6f 6e 74 65 6e 74 20 6f 66 20 74  the content of t
22330 68 65 20 70 61 67 65 2e 20 20 54 68 69 73 20 63  he page.  This c
22340 61 6e 20 68 61 70 70 65 6e 0a 20 20 2a 2a 20 28  an happen.  ** (
22350 66 6f 72 20 65 78 61 6d 70 6c 65 29 20 77 68 65  for example) whe
22360 6e 20 74 68 65 20 70 61 67 65 20 69 73 20 62 65  n the page is be
22370 69 6e 67 20 6d 6f 76 65 64 20 74 6f 20 74 68 65  ing moved to the
22380 20 66 72 65 65 6c 69 73 74 2e 20 20 42 75 74 0a   freelist.  But.
22390 20 20 2a 2a 20 6e 6f 77 20 77 65 20 61 72 65 20    ** now we are 
223a0 28 70 65 72 68 61 70 73 29 20 6d 6f 76 69 6e 67  (perhaps) moving
223b0 20 74 68 65 20 70 61 67 65 20 6f 66 66 20 6f 66   the page off of
223c0 20 74 68 65 20 66 72 65 65 6c 69 73 74 20 66 6f   the freelist fo
223d0 72 0a 20 20 2a 2a 20 72 65 75 73 65 20 61 6e 64  r.  ** reuse and
223e0 20 77 65 20 6e 65 65 64 20 74 6f 20 6b 6e 6f 77   we need to know
223f0 20 69 74 73 20 6f 72 69 67 69 6e 61 6c 20 63 6f   its original co
22400 6e 74 65 6e 74 20 73 6f 20 74 68 61 74 20 63 6f  ntent so that co
22410 6e 74 65 6e 74 0a 20 20 2a 2a 20 63 61 6e 20 62  ntent.  ** can b
22420 65 20 73 74 6f 72 65 64 20 69 6e 20 74 68 65 20  e stored in the 
22430 72 6f 6c 6c 62 61 63 6b 20 6a 6f 75 72 6e 61 6c  rollback journal
22440 2e 20 20 53 6f 20 64 6f 20 74 68 65 20 72 65 61  .  So do the rea
22450 64 20 61 74 20 74 68 69 73 0a 20 20 2a 2a 20 74  d at this.  ** t
22460 69 6d 65 2e 0a 20 20 2a 2f 0a 20 20 72 63 20 3d  ime..  */.  rc =
22470 20 70 61 67 65 72 5f 67 65 74 5f 63 6f 6e 74 65   pager_get_conte
22480 6e 74 28 70 50 67 29 3b 0a 20 20 69 66 28 20 72  nt(pPg);.  if( r
22490 63 20 29 7b 0a 20 20 20 20 72 65 74 75 72 6e 20  c ){.    return 
224a0 72 63 3b 0a 20 20 7d 0a 0a 20 20 2f 2a 20 4d 61  rc;.  }..  /* Ma
224b0 72 6b 20 74 68 65 20 70 61 67 65 20 61 73 20 64  rk the page as d
224c0 69 72 74 79 2e 20 20 49 66 20 74 68 65 20 70 61  irty.  If the pa
224d0 67 65 20 68 61 73 20 61 6c 72 65 61 64 79 20 62  ge has already b
224e0 65 65 6e 20 77 72 69 74 74 65 6e 0a 20 20 2a 2a  een written.  **
224f0 20 74 6f 20 74 68 65 20 6a 6f 75 72 6e 61 6c 20   to the journal 
22500 74 68 65 6e 20 77 65 20 63 61 6e 20 72 65 74 75  then we can retu
22510 72 6e 20 72 69 67 68 74 20 61 77 61 79 2e 0a 20  rn right away.. 
22520 20 2a 2f 0a 20 20 6d 61 6b 65 44 69 72 74 79 28   */.  makeDirty(
22530 70 50 67 29 3b 0a 20 20 69 66 28 20 70 50 67 2d  pPg);.  if( pPg-
22540 3e 69 6e 4a 6f 75 72 6e 61 6c 20 26 26 20 28 70  >inJournal && (p
22550 61 67 65 49 6e 53 74 61 74 65 6d 65 6e 74 28 70  ageInStatement(p
22560 50 67 29 20 7c 7c 20 70 50 61 67 65 72 2d 3e 73  Pg) || pPager->s
22570 74 6d 74 49 6e 55 73 65 3d 3d 30 29 20 29 7b 0a  tmtInUse==0) ){.
22580 20 20 20 20 70 50 61 67 65 72 2d 3e 64 69 72 74      pPager->dirt
22590 79 43 61 63 68 65 20 3d 20 31 3b 0a 20 20 7d 65  yCache = 1;.  }e
225a0 6c 73 65 7b 0a 0a 20 20 20 20 2f 2a 20 49 66 20  lse{..    /* If 
225b0 77 65 20 67 65 74 20 74 68 69 73 20 66 61 72 2c  we get this far,
225c0 20 69 74 20 6d 65 61 6e 73 20 74 68 61 74 20 74   it means that t
225d0 68 65 20 70 61 67 65 20 6e 65 65 64 73 20 74 6f  he page needs to
225e0 20 62 65 0a 20 20 20 20 2a 2a 20 77 72 69 74 74   be.    ** writt
225f0 65 6e 20 74 6f 20 74 68 65 20 74 72 61 6e 73 61  en to the transa
22600 63 74 69 6f 6e 20 6a 6f 75 72 6e 61 6c 20 6f 72  ction journal or
22610 20 74 68 65 20 63 6b 65 63 6b 70 6f 69 6e 74 20   the ckeckpoint 
22620 6a 6f 75 72 6e 61 6c 0a 20 20 20 20 2a 2a 20 6f  journal.    ** o
22630 72 20 62 6f 74 68 2e 0a 20 20 20 20 2a 2a 0a 20  r both..    **. 
22640 20 20 20 2a 2a 20 46 69 72 73 74 20 63 68 65 63     ** First chec
22650 6b 20 74 6f 20 73 65 65 20 74 68 61 74 20 74 68  k to see that th
22660 65 20 74 72 61 6e 73 61 63 74 69 6f 6e 20 6a 6f  e transaction jo
22670 75 72 6e 61 6c 20 65 78 69 73 74 73 20 61 6e 64  urnal exists and
22680 0a 20 20 20 20 2a 2a 20 63 72 65 61 74 65 20 69  .    ** create i
22690 74 20 69 66 20 69 74 20 64 6f 65 73 20 6e 6f 74  t if it does not
226a0 2e 0a 20 20 20 20 2a 2f 0a 20 20 20 20 61 73 73  ..    */.    ass
226b0 65 72 74 28 20 70 50 61 67 65 72 2d 3e 73 74 61  ert( pPager->sta
226c0 74 65 21 3d 50 41 47 45 52 5f 55 4e 4c 4f 43 4b  te!=PAGER_UNLOCK
226d0 20 29 3b 0a 20 20 20 20 72 63 20 3d 20 73 71 6c   );.    rc = sql
226e0 69 74 65 33 50 61 67 65 72 42 65 67 69 6e 28 70  ite3PagerBegin(p
226f0 50 67 2c 20 30 29 3b 0a 20 20 20 20 69 66 28 20  Pg, 0);.    if( 
22700 72 63 21 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b  rc!=SQLITE_OK ){
22710 0a 20 20 20 20 20 20 72 65 74 75 72 6e 20 72 63  .      return rc
22720 3b 0a 20 20 20 20 7d 0a 20 20 20 20 61 73 73 65  ;.    }.    asse
22730 72 74 28 20 70 50 61 67 65 72 2d 3e 73 74 61 74  rt( pPager->stat
22740 65 3e 3d 50 41 47 45 52 5f 52 45 53 45 52 56 45  e>=PAGER_RESERVE
22750 44 20 29 3b 0a 20 20 20 20 69 66 28 20 21 70 50  D );.    if( !pP
22760 61 67 65 72 2d 3e 6a 6f 75 72 6e 61 6c 4f 70 65  ager->journalOpe
22770 6e 20 26 26 20 70 50 61 67 65 72 2d 3e 75 73 65  n && pPager->use
22780 4a 6f 75 72 6e 61 6c 0a 20 20 20 20 20 20 20 20  Journal.        
22790 20 20 26 26 20 70 50 61 67 65 72 2d 3e 6a 6f 75    && pPager->jou
227a0 72 6e 61 6c 4d 6f 64 65 21 3d 50 41 47 45 52 5f  rnalMode!=PAGER_
227b0 4a 4f 55 52 4e 41 4c 4d 4f 44 45 5f 4f 46 46 20  JOURNALMODE_OFF 
227c0 29 7b 0a 20 20 20 20 20 20 72 63 20 3d 20 70 61  ){.      rc = pa
227d0 67 65 72 5f 6f 70 65 6e 5f 6a 6f 75 72 6e 61 6c  ger_open_journal
227e0 28 70 50 61 67 65 72 29 3b 0a 20 20 20 20 20 20  (pPager);.      
227f0 69 66 28 20 72 63 21 3d 53 51 4c 49 54 45 5f 4f  if( rc!=SQLITE_O
22800 4b 20 29 20 72 65 74 75 72 6e 20 72 63 3b 0a 20  K ) return rc;. 
22810 20 20 20 7d 0a 20 20 20 20 70 50 61 67 65 72 2d     }.    pPager-
22820 3e 64 69 72 74 79 43 61 63 68 65 20 3d 20 31 3b  >dirtyCache = 1;
22830 0a 20 20 0a 20 20 20 20 2f 2a 20 54 68 65 20 74  .  .    /* The t
22840 72 61 6e 73 61 63 74 69 6f 6e 20 6a 6f 75 72 6e  ransaction journ
22850 61 6c 20 6e 6f 77 20 65 78 69 73 74 73 20 61 6e  al now exists an
22860 64 20 77 65 20 68 61 76 65 20 61 20 52 45 53 45  d we have a RESE
22870 52 56 45 44 20 6f 72 20 61 6e 0a 20 20 20 20 2a  RVED or an.    *
22880 2a 20 45 58 43 4c 55 53 49 56 45 20 6c 6f 63 6b  * EXCLUSIVE lock
22890 20 6f 6e 20 74 68 65 20 6d 61 69 6e 20 64 61 74   on the main dat
228a0 61 62 61 73 65 20 66 69 6c 65 2e 20 20 57 72 69  abase file.  Wri
228b0 74 65 20 74 68 65 20 63 75 72 72 65 6e 74 20 70  te the current p
228c0 61 67 65 20 74 6f 0a 20 20 20 20 2a 2a 20 74 68  age to.    ** th
228d0 65 20 74 72 61 6e 73 61 63 74 69 6f 6e 20 6a 6f  e transaction jo
228e0 75 72 6e 61 6c 20 69 66 20 69 74 20 69 73 20 6e  urnal if it is n
228f0 6f 74 20 74 68 65 72 65 20 61 6c 72 65 61 64 79  ot there already
22900 2e 0a 20 20 20 20 2a 2f 0a 20 20 20 20 69 66 28  ..    */.    if(
22910 20 21 70 50 67 2d 3e 69 6e 4a 6f 75 72 6e 61 6c   !pPg->inJournal
22920 20 26 26 20 28 70 50 61 67 65 72 2d 3e 6a 6f 75   && (pPager->jou
22930 72 6e 61 6c 4f 70 65 6e 20 7c 7c 20 4d 45 4d 44  rnalOpen || MEMD
22940 42 29 20 29 7b 0a 20 20 20 20 20 20 69 66 28 20  B) ){.      if( 
22950 28 69 6e 74 29 70 50 67 2d 3e 70 67 6e 6f 20 3c  (int)pPg->pgno <
22960 3d 20 70 50 61 67 65 72 2d 3e 6f 72 69 67 44 62  = pPager->origDb
22970 53 69 7a 65 20 29 7b 0a 20 20 20 20 20 20 20 20  Size ){.        
22980 69 66 28 20 4d 45 4d 44 42 20 29 7b 0a 20 20 20  if( MEMDB ){.   
22990 20 20 20 20 20 20 20 50 67 48 69 73 74 6f 72 79         PgHistory
229a0 20 2a 70 48 69 73 74 20 3d 20 50 47 48 44 52 5f   *pHist = PGHDR_
229b0 54 4f 5f 48 49 53 54 28 70 50 67 2c 20 70 50 61  TO_HIST(pPg, pPa
229c0 67 65 72 29 3b 0a 20 20 20 20 20 20 20 20 20 20  ger);.          
229d0 50 41 47 45 52 54 52 41 43 45 33 28 22 4a 4f 55  PAGERTRACE3("JOU
229e0 52 4e 41 4c 20 25 64 20 70 61 67 65 20 25 64 5c  RNAL %d page %d\
229f0 6e 22 2c 20 50 41 47 45 52 49 44 28 70 50 61 67  n", PAGERID(pPag
22a00 65 72 29 2c 20 70 50 67 2d 3e 70 67 6e 6f 29 3b  er), pPg->pgno);
22a10 0a 20 20 20 20 20 20 20 20 20 20 61 73 73 65 72  .          asser
22a20 74 28 20 70 48 69 73 74 2d 3e 70 4f 72 69 67 3d  t( pHist->pOrig=
22a30 3d 30 20 29 3b 0a 20 20 20 20 20 20 20 20 20 20  =0 );.          
22a40 70 48 69 73 74 2d 3e 70 4f 72 69 67 20 3d 20 73  pHist->pOrig = s
22a50 71 6c 69 74 65 33 5f 6d 61 6c 6c 6f 63 28 20 70  qlite3_malloc( p
22a60 50 61 67 65 72 2d 3e 70 61 67 65 53 69 7a 65 20  Pager->pageSize 
22a70 29 3b 0a 20 20 20 20 20 20 20 20 20 20 69 66 28  );.          if(
22a80 20 21 70 48 69 73 74 2d 3e 70 4f 72 69 67 20 29   !pHist->pOrig )
22a90 7b 0a 20 20 20 20 20 20 20 20 20 20 20 20 72 65  {.            re
22aa0 74 75 72 6e 20 53 51 4c 49 54 45 5f 4e 4f 4d 45  turn SQLITE_NOME
22ab0 4d 3b 0a 20 20 20 20 20 20 20 20 20 20 7d 0a 20  M;.          }. 
22ac0 20 20 20 20 20 20 20 20 20 6d 65 6d 63 70 79 28           memcpy(
22ad0 70 48 69 73 74 2d 3e 70 4f 72 69 67 2c 20 50 47  pHist->pOrig, PG
22ae0 48 44 52 5f 54 4f 5f 44 41 54 41 28 70 50 67 29  HDR_TO_DATA(pPg)
22af0 2c 20 70 50 61 67 65 72 2d 3e 70 61 67 65 53 69  , pPager->pageSi
22b00 7a 65 29 3b 0a 20 20 20 20 20 20 20 20 7d 65 6c  ze);.        }el
22b10 73 65 7b 0a 20 20 20 20 20 20 20 20 20 20 75 33  se{.          u3
22b20 32 20 63 6b 73 75 6d 3b 0a 20 20 20 20 20 20 20  2 cksum;.       
22b30 20 20 20 63 68 61 72 20 2a 70 44 61 74 61 32 3b     char *pData2;
22b40 0a 0a 20 20 20 20 20 20 20 20 20 20 2f 2a 20 57  ..          /* W
22b50 65 20 73 68 6f 75 6c 64 20 6e 65 76 65 72 20 77  e should never w
22b60 72 69 74 65 20 74 6f 20 74 68 65 20 6a 6f 75 72  rite to the jour
22b70 6e 61 6c 20 66 69 6c 65 20 74 68 65 20 70 61 67  nal file the pag
22b80 65 20 74 68 61 74 0a 20 20 20 20 20 20 20 20 20  e that.         
22b90 20 2a 2a 20 63 6f 6e 74 61 69 6e 73 20 74 68 65   ** contains the
22ba0 20 64 61 74 61 62 61 73 65 20 6c 6f 63 6b 73 2e   database locks.
22bb0 20 20 54 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20    The following 
22bc0 61 73 73 65 72 74 20 76 65 72 69 66 69 65 73 0a  assert verifies.
22bd0 20 20 20 20 20 20 20 20 20 20 2a 2a 20 74 68 61            ** tha
22be0 74 20 77 65 20 64 6f 20 6e 6f 74 2e 20 2a 2f 0a  t we do not. */.
22bf0 20 20 20 20 20 20 20 20 20 20 61 73 73 65 72 74            assert
22c00 28 20 70 50 67 2d 3e 70 67 6e 6f 21 3d 50 41 47  ( pPg->pgno!=PAG
22c10 45 52 5f 4d 4a 5f 50 47 4e 4f 28 70 50 61 67 65  ER_MJ_PGNO(pPage
22c20 72 29 20 29 3b 0a 20 20 20 20 20 20 20 20 20 20  r) );.          
22c30 70 44 61 74 61 32 20 3d 20 43 4f 44 45 43 32 28  pData2 = CODEC2(
22c40 70 50 61 67 65 72 2c 20 70 44 61 74 61 2c 20 70  pPager, pData, p
22c50 50 67 2d 3e 70 67 6e 6f 2c 20 37 29 3b 0a 20 20  Pg->pgno, 7);.  
22c60 20 20 20 20 20 20 20 20 63 6b 73 75 6d 20 3d 20          cksum = 
22c70 70 61 67 65 72 5f 63 6b 73 75 6d 28 70 50 61 67  pager_cksum(pPag
22c80 65 72 2c 20 28 75 38 2a 29 70 44 61 74 61 32 29  er, (u8*)pData2)
22c90 3b 0a 20 20 20 20 20 20 20 20 20 20 72 63 20 3d  ;.          rc =
22ca0 20 77 72 69 74 65 33 32 62 69 74 73 28 70 50 61   write32bits(pPa
22cb0 67 65 72 2d 3e 6a 66 64 2c 20 70 50 61 67 65 72  ger->jfd, pPager
22cc0 2d 3e 6a 6f 75 72 6e 61 6c 4f 66 66 2c 20 70 50  ->journalOff, pP
22cd0 67 2d 3e 70 67 6e 6f 29 3b 0a 20 20 20 20 20 20  g->pgno);.      
22ce0 20 20 20 20 69 66 28 20 72 63 3d 3d 53 51 4c 49      if( rc==SQLI
22cf0 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 20 20 20  TE_OK ){.       
22d00 20 20 20 20 20 72 63 20 3d 20 73 71 6c 69 74 65       rc = sqlite
22d10 33 4f 73 57 72 69 74 65 28 70 50 61 67 65 72 2d  3OsWrite(pPager-
22d20 3e 6a 66 64 2c 20 70 44 61 74 61 32 2c 20 70 50  >jfd, pData2, pP
22d30 61 67 65 72 2d 3e 70 61 67 65 53 69 7a 65 2c 0a  ager->pageSize,.
22d40 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
22d50 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
22d60 70 50 61 67 65 72 2d 3e 6a 6f 75 72 6e 61 6c 4f  pPager->journalO
22d70 66 66 20 2b 20 34 29 3b 0a 20 20 20 20 20 20 20  ff + 4);.       
22d80 20 20 20 20 20 70 50 61 67 65 72 2d 3e 6a 6f 75       pPager->jou
22d90 72 6e 61 6c 4f 66 66 20 2b 3d 20 70 50 61 67 65  rnalOff += pPage
22da0 72 2d 3e 70 61 67 65 53 69 7a 65 2b 34 3b 0a 20  r->pageSize+4;. 
22db0 20 20 20 20 20 20 20 20 20 7d 0a 20 20 20 20 20           }.     
22dc0 20 20 20 20 20 69 66 28 20 72 63 3d 3d 53 51 4c       if( rc==SQL
22dd0 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 20 20  ITE_OK ){.      
22de0 20 20 20 20 20 20 72 63 20 3d 20 77 72 69 74 65        rc = write
22df0 33 32 62 69 74 73 28 70 50 61 67 65 72 2d 3e 6a  32bits(pPager->j
22e00 66 64 2c 20 70 50 61 67 65 72 2d 3e 6a 6f 75 72  fd, pPager->jour
22e10 6e 61 6c 4f 66 66 2c 20 63 6b 73 75 6d 29 3b 0a  nalOff, cksum);.
22e20 20 20 20 20 20 20 20 20 20 20 20 20 70 50 61 67              pPag
22e30 65 72 2d 3e 6a 6f 75 72 6e 61 6c 4f 66 66 20 2b  er->journalOff +
22e40 3d 20 34 3b 0a 20 20 20 20 20 20 20 20 20 20 7d  = 4;.          }
22e50 0a 20 20 20 20 20 20 20 20 20 20 49 4f 54 52 41  .          IOTRA
22e60 43 45 28 28 22 4a 4f 55 54 20 25 70 20 25 64 20  CE(("JOUT %p %d 
22e70 25 6c 6c 64 20 25 64 5c 6e 22 2c 20 70 50 61 67  %lld %d\n", pPag
22e80 65 72 2c 20 70 50 67 2d 3e 70 67 6e 6f 2c 20 0a  er, pPg->pgno, .
22e90 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
22ea0 20 20 20 70 50 61 67 65 72 2d 3e 6a 6f 75 72 6e     pPager->journ
22eb0 61 6c 4f 66 66 2c 20 70 50 61 67 65 72 2d 3e 70  alOff, pPager->p
22ec0 61 67 65 53 69 7a 65 29 29 3b 0a 20 20 20 20 20  ageSize));.     
22ed0 20 20 20 20 20 50 41 47 45 52 5f 49 4e 43 52 28       PAGER_INCR(
22ee0 73 71 6c 69 74 65 33 5f 70 61 67 65 72 5f 77 72  sqlite3_pager_wr
22ef0 69 74 65 6a 5f 63 6f 75 6e 74 29 3b 0a 20 20 20  itej_count);.   
22f00 20 20 20 20 20 20 20 50 41 47 45 52 54 52 41 43         PAGERTRAC
22f10 45 35 28 22 4a 4f 55 52 4e 41 4c 20 25 64 20 70  E5("JOURNAL %d p
22f20 61 67 65 20 25 64 20 6e 65 65 64 53 79 6e 63 3d  age %d needSync=
22f30 25 64 20 68 61 73 68 28 25 30 38 78 29 5c 6e 22  %d hash(%08x)\n"
22f40 2c 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20  ,.              
22f50 20 50 41 47 45 52 49 44 28 70 50 61 67 65 72 29   PAGERID(pPager)
22f60 2c 20 70 50 67 2d 3e 70 67 6e 6f 2c 20 70 50 67  , pPg->pgno, pPg
22f70 2d 3e 6e 65 65 64 53 79 6e 63 2c 20 70 61 67 65  ->needSync, page
22f80 72 5f 70 61 67 65 68 61 73 68 28 70 50 67 29 29  r_pagehash(pPg))
22f90 3b 0a 0a 20 20 20 20 20 20 20 20 20 20 2f 2a 20  ;..          /* 
22fa0 41 6e 20 65 72 72 6f 72 20 68 61 73 20 6f 63 63  An error has occ
22fb0 75 72 65 64 20 77 72 69 74 69 6e 67 20 74 6f 20  ured writing to 
22fc0 74 68 65 20 6a 6f 75 72 6e 61 6c 20 66 69 6c 65  the journal file
22fd0 2e 20 54 68 65 20 0a 20 20 20 20 20 20 20 20 20  . The .         
22fe0 20 2a 2a 20 74 72 61 6e 73 61 63 74 69 6f 6e 20   ** transaction 
22ff0 77 69 6c 6c 20 62 65 20 72 6f 6c 6c 65 64 20 62  will be rolled b
23000 61 63 6b 20 62 79 20 74 68 65 20 6c 61 79 65 72  ack by the layer
23010 20 61 62 6f 76 65 2e 0a 20 20 20 20 20 20 20 20   above..        
23020 20 20 2a 2f 0a 20 20 20 20 20 20 20 20 20 20 69    */.          i
23030 66 28 20 72 63 21 3d 53 51 4c 49 54 45 5f 4f 4b  f( rc!=SQLITE_OK
23040 20 29 7b 0a 20 20 20 20 20 20 20 20 20 20 20 20   ){.            
23050 72 65 74 75 72 6e 20 72 63 3b 0a 20 20 20 20 20  return rc;.     
23060 20 20 20 20 20 7d 0a 0a 20 20 20 20 20 20 20 20       }..        
23070 20 20 70 50 61 67 65 72 2d 3e 6e 52 65 63 2b 2b    pPager->nRec++
23080 3b 0a 20 20 20 20 20 20 20 20 20 20 61 73 73 65  ;.          asse
23090 72 74 28 20 70 50 61 67 65 72 2d 3e 70 49 6e 4a  rt( pPager->pInJ
230a0 6f 75 72 6e 61 6c 21 3d 30 20 29 3b 0a 20 20 20  ournal!=0 );.   
230b0 20 20 20 20 20 20 20 73 71 6c 69 74 65 33 42 69         sqlite3Bi
230c0 74 76 65 63 53 65 74 28 70 50 61 67 65 72 2d 3e  tvecSet(pPager->
230d0 70 49 6e 4a 6f 75 72 6e 61 6c 2c 20 70 50 67 2d  pInJournal, pPg-
230e0 3e 70 67 6e 6f 29 3b 0a 20 20 20 20 20 20 20 20  >pgno);.        
230f0 20 20 70 50 67 2d 3e 6e 65 65 64 53 79 6e 63 20    pPg->needSync 
23100 3d 20 21 70 50 61 67 65 72 2d 3e 6e 6f 53 79 6e  = !pPager->noSyn
23110 63 3b 0a 20 20 20 20 20 20 20 20 20 20 69 66 28  c;.          if(
23120 20 70 50 61 67 65 72 2d 3e 73 74 6d 74 49 6e 55   pPager->stmtInU
23130 73 65 20 29 7b 0a 20 20 20 20 20 20 20 20 20 20  se ){.          
23140 20 20 73 71 6c 69 74 65 33 42 69 74 76 65 63 53    sqlite3BitvecS
23150 65 74 28 70 50 61 67 65 72 2d 3e 70 49 6e 53 74  et(pPager->pInSt
23160 6d 74 2c 20 70 50 67 2d 3e 70 67 6e 6f 29 3b 0a  mt, pPg->pgno);.
23170 20 20 20 20 20 20 20 20 20 20 7d 0a 20 20 20 20            }.    
23180 20 20 20 20 7d 0a 20 20 20 20 20 20 7d 65 6c 73      }.      }els
23190 65 7b 0a 20 20 20 20 20 20 20 20 70 50 67 2d 3e  e{.        pPg->
231a0 6e 65 65 64 53 79 6e 63 20 3d 20 21 70 50 61 67  needSync = !pPag
231b0 65 72 2d 3e 6a 6f 75 72 6e 61 6c 53 74 61 72 74  er->journalStart
231c0 65 64 20 26 26 20 21 70 50 61 67 65 72 2d 3e 6e  ed && !pPager->n
231d0 6f 53 79 6e 63 3b 0a 20 20 20 20 20 20 20 20 50  oSync;.        P
231e0 41 47 45 52 54 52 41 43 45 34 28 22 41 50 50 45  AGERTRACE4("APPE
231f0 4e 44 20 25 64 20 70 61 67 65 20 25 64 20 6e 65  ND %d page %d ne
23200 65 64 53 79 6e 63 3d 25 64 5c 6e 22 2c 0a 20 20  edSync=%d\n",.  
23210 20 20 20 20 20 20 20 20 20 20 20 20 20 20 50 41                PA
23220 47 45 52 49 44 28 70 50 61 67 65 72 29 2c 20 70  GERID(pPager), p
23230 50 67 2d 3e 70 67 6e 6f 2c 20 70 50 67 2d 3e 6e  Pg->pgno, pPg->n
23240 65 65 64 53 79 6e 63 29 3b 0a 20 20 20 20 20 20  eedSync);.      
23250 7d 0a 20 20 20 20 20 20 69 66 28 20 70 50 67 2d  }.      if( pPg-
23260 3e 6e 65 65 64 53 79 6e 63 20 29 7b 0a 20 20 20  >needSync ){.   
23270 20 20 20 20 20 70 50 61 67 65 72 2d 3e 6e 65 65       pPager->nee
23280 64 53 79 6e 63 20 3d 20 31 3b 0a 20 20 20 20 20  dSync = 1;.     
23290 20 7d 0a 20 20 20 20 20 20 70 50 67 2d 3e 69 6e   }.      pPg->in
232a0 4a 6f 75 72 6e 61 6c 20 3d 20 31 3b 0a 20 20 20  Journal = 1;.   
232b0 20 7d 0a 20 20 0a 20 20 20 20 2f 2a 20 49 66 20   }.  .    /* If 
232c0 74 68 65 20 73 74 61 74 65 6d 65 6e 74 20 6a 6f  the statement jo
232d0 75 72 6e 61 6c 20 69 73 20 6f 70 65 6e 20 61 6e  urnal is open an
232e0 64 20 74 68 65 20 70 61 67 65 20 69 73 20 6e 6f  d the page is no
232f0 74 20 69 6e 20 69 74 2c 0a 20 20 20 20 2a 2a 20  t in it,.    ** 
23300 74 68 65 6e 20 77 72 69 74 65 20 74 68 65 20 63  then write the c
23310 75 72 72 65 6e 74 20 70 61 67 65 20 74 6f 20 74  urrent page to t
23320 68 65 20 73 74 61 74 65 6d 65 6e 74 20 6a 6f 75  he statement jou
23330 72 6e 61 6c 2e 20 20 4e 6f 74 65 20 74 68 61 74  rnal.  Note that
23340 0a 20 20 20 20 2a 2a 20 74 68 65 20 73 74 61 74  .    ** the stat
23350 65 6d 65 6e 74 20 6a 6f 75 72 6e 61 6c 20 66 6f  ement journal fo
23360 72 6d 61 74 20 64 69 66 66 65 72 73 20 66 72 6f  rmat differs fro
23370 6d 20 74 68 65 20 73 74 61 6e 64 61 72 64 20 6a  m the standard j
23380 6f 75 72 6e 61 6c 20 66 6f 72 6d 61 74 0a 20 20  ournal format.  
23390 20 20 2a 2a 20 69 6e 20 74 68 61 74 20 69 74 20    ** in that it 
233a0 6f 6d 69 74 73 20 74 68 65 20 63 68 65 63 6b 73  omits the checks
233b0 75 6d 73 20 61 6e 64 20 74 68 65 20 68 65 61 64  ums and the head
233c0 65 72 2e 0a 20 20 20 20 2a 2f 0a 20 20 20 20 69  er..    */.    i
233d0 66 28 20 70 50 61 67 65 72 2d 3e 73 74 6d 74 49  f( pPager->stmtI
233e0 6e 55 73 65 20 0a 20 20 20 20 20 26 26 20 21 70  nUse .     && !p
233f0 61 67 65 49 6e 53 74 61 74 65 6d 65 6e 74 28 70  ageInStatement(p
23400 50 67 29 20 0a 20 20 20 20 20 26 26 20 28 69 6e  Pg) .     && (in
23410 74 29 70 50 67 2d 3e 70 67 6e 6f 3c 3d 70 50 61  t)pPg->pgno<=pPa
23420 67 65 72 2d 3e 73 74 6d 74 53 69 7a 65 20 0a 20  ger->stmtSize . 
23430 20 20 20 29 7b 0a 20 20 20 20 20 20 61 73 73 65     ){.      asse
23440 72 74 28 20 70 50 67 2d 3e 69 6e 4a 6f 75 72 6e  rt( pPg->inJourn
23450 61 6c 20 7c 7c 20 28 69 6e 74 29 70 50 67 2d 3e  al || (int)pPg->
23460 70 67 6e 6f 3e 70 50 61 67 65 72 2d 3e 6f 72 69  pgno>pPager->ori
23470 67 44 62 53 69 7a 65 20 29 3b 0a 20 20 20 20 20  gDbSize );.     
23480 20 69 66 28 20 4d 45 4d 44 42 20 29 7b 0a 20 20   if( MEMDB ){.  
23490 20 20 20 20 20 20 50 67 48 69 73 74 6f 72 79 20        PgHistory 
234a0 2a 70 48 69 73 74 20 3d 20 50 47 48 44 52 5f 54  *pHist = PGHDR_T
234b0 4f 5f 48 49 53 54 28 70 50 67 2c 20 70 50 61 67  O_HIST(pPg, pPag
234c0 65 72 29 3b 0a 20 20 20 20 20 20 20 20 61 73 73  er);.        ass
234d0 65 72 74 28 20 70 48 69 73 74 2d 3e 70 53 74 6d  ert( pHist->pStm
234e0 74 3d 3d 30 20 29 3b 0a 20 20 20 20 20 20 20 20  t==0 );.        
234f0 70 48 69 73 74 2d 3e 70 53 74 6d 74 20 3d 20 73  pHist->pStmt = s
23500 71 6c 69 74 65 33 5f 6d 61 6c 6c 6f 63 28 20 70  qlite3_malloc( p
23510 50 61 67 65 72 2d 3e 70 61 67 65 53 69 7a 65 20  Pager->pageSize 
23520 29 3b 0a 20 20 20 20 20 20 20 20 69 66 28 20 70  );.        if( p
23530 48 69 73 74 2d 3e 70 53 74 6d 74 20 29 7b 0a 20  Hist->pStmt ){. 
23540 20 20 20 20 20 20 20 20 20 6d 65 6d 63 70 79 28           memcpy(
23550 70 48 69 73 74 2d 3e 70 53 74 6d 74 2c 20 50 47  pHist->pStmt, PG
23560 48 44 52 5f 54 4f 5f 44 41 54 41 28 70 50 67 29  HDR_TO_DATA(pPg)
23570 2c 20 70 50 61 67 65 72 2d 3e 70 61 67 65 53 69  , pPager->pageSi
23580 7a 65 29 3b 0a 20 20 20 20 20 20 20 20 7d 0a 20  ze);.        }. 
23590 20 20 20 20 20 20 20 50 41 47 45 52 54 52 41 43         PAGERTRAC
235a0 45 33 28 22 53 54 4d 54 2d 4a 4f 55 52 4e 41 4c  E3("STMT-JOURNAL
235b0 20 25 64 20 70 61 67 65 20 25 64 5c 6e 22 2c 20   %d page %d\n", 
235c0 50 41 47 45 52 49 44 28 70 50 61 67 65 72 29 2c  PAGERID(pPager),
235d0 20 70 50 67 2d 3e 70 67 6e 6f 29 3b 0a 20 20 20   pPg->pgno);.   
235e0 20 20 20 20 20 70 61 67 65 5f 61 64 64 5f 74 6f       page_add_to
235f0 5f 73 74 6d 74 5f 6c 69 73 74 28 70 50 67 29 3b  _stmt_list(pPg);
23600 0a 20 20 20 20 20 20 7d 65 6c 73 65 7b 0a 20 20  .      }else{.  
23610 20 20 20 20 20 20 69 36 34 20 6f 66 66 73 65 74        i64 offset
23620 20 3d 20 70 50 61 67 65 72 2d 3e 73 74 6d 74 4e   = pPager->stmtN
23630 52 65 63 2a 28 34 2b 70 50 61 67 65 72 2d 3e 70  Rec*(4+pPager->p
23640 61 67 65 53 69 7a 65 29 3b 0a 20 20 20 20 20 20  ageSize);.      
23650 20 20 63 68 61 72 20 2a 70 44 61 74 61 32 20 3d    char *pData2 =
23660 20 43 4f 44 45 43 32 28 70 50 61 67 65 72 2c 20   CODEC2(pPager, 
23670 70 44 61 74 61 2c 20 70 50 67 2d 3e 70 67 6e 6f  pData, pPg->pgno
23680 2c 20 37 29 3b 0a 20 20 20 20 20 20 20 20 72 63  , 7);.        rc
23690 20 3d 20 77 72 69 74 65 33 32 62 69 74 73 28 70   = write32bits(p
236a0 50 61 67 65 72 2d 3e 73 74 66 64 2c 20 6f 66 66  Pager->stfd, off
236b0 73 65 74 2c 20 70 50 67 2d 3e 70 67 6e 6f 29 3b  set, pPg->pgno);
236c0 0a 20 20 20 20 20 20 20 20 69 66 28 20 72 63 3d  .        if( rc=
236d0 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20  =SQLITE_OK ){.  
236e0 20 20 20 20 20 20 20 20 72 63 20 3d 20 73 71 6c          rc = sql
236f0 69 74 65 33 4f 73 57 72 69 74 65 28 70 50 61 67  ite3OsWrite(pPag
23700 65 72 2d 3e 73 74 66 64 2c 20 70 44 61 74 61 32  er->stfd, pData2
23710 2c 20 70 50 61 67 65 72 2d 3e 70 61 67 65 53 69  , pPager->pageSi
23720 7a 65 2c 20 6f 66 66 73 65 74 2b 34 29 3b 0a 20  ze, offset+4);. 
23730 20 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 20         }.       
23740 20 50 41 47 45 52 54 52 41 43 45 33 28 22 53 54   PAGERTRACE3("ST
23750 4d 54 2d 4a 4f 55 52 4e 41 4c 20 25 64 20 70 61  MT-JOURNAL %d pa
23760 67 65 20 25 64 5c 6e 22 2c 20 50 41 47 45 52 49  ge %d\n", PAGERI
23770 44 28 70 50 61 67 65 72 29 2c 20 70 50 67 2d 3e  D(pPager), pPg->
23780 70 67 6e 6f 29 3b 0a 20 20 20 20 20 20 20 20 69  pgno);.        i
23790 66 28 20 72 63 21 3d 53 51 4c 49 54 45 5f 4f 4b  f( rc!=SQLITE_OK
237a0 20 29 7b 0a 20 20 20 20 20 20 20 20 20 20 72 65   ){.          re
237b0 74 75 72 6e 20 72 63 3b 0a 20 20 20 20 20 20 20  turn rc;.       
237c0 20 7d 0a 20 20 20 20 20 20 20 20 70 50 61 67 65   }.        pPage
237d0 72 2d 3e 73 74 6d 74 4e 52 65 63 2b 2b 3b 0a 20  r->stmtNRec++;. 
237e0 20 20 20 20 20 20 20 61 73 73 65 72 74 28 20 70         assert( p
237f0 50 61 67 65 72 2d 3e 70 49 6e 53 74 6d 74 21 3d  Pager->pInStmt!=
23800 30 20 29 3b 0a 20 20 20 20 20 20 20 20 73 71 6c  0 );.        sql
23810 69 74 65 33 42 69 74 76 65 63 53 65 74 28 70 50  ite3BitvecSet(pP
23820 61 67 65 72 2d 3e 70 49 6e 53 74 6d 74 2c 20 70  ager->pInStmt, p
23830 50 67 2d 3e 70 67 6e 6f 29 3b 0a 20 20 20 20 20  Pg->pgno);.     
23840 20 7d 0a 20 20 20 20 7d 0a 20 20 7d 0a 0a 20 20   }.    }.  }..  
23850 2f 2a 20 55 70 64 61 74 65 20 74 68 65 20 64 61  /* Update the da
23860 74 61 62 61 73 65 20 73 69 7a 65 20 61 6e 64 20  tabase size and 
23870 72 65 74 75 72 6e 2e 0a 20 20 2a 2f 0a 20 20 61  return..  */.  a
23880 73 73 65 72 74 28 20 70 50 61 67 65 72 2d 3e 73  ssert( pPager->s
23890 74 61 74 65 3e 3d 50 41 47 45 52 5f 53 48 41 52  tate>=PAGER_SHAR
238a0 45 44 20 29 3b 0a 20 20 69 66 28 20 70 50 61 67  ED );.  if( pPag
238b0 65 72 2d 3e 64 62 53 69 7a 65 3c 28 69 6e 74 29  er->dbSize<(int)
238c0 70 50 67 2d 3e 70 67 6e 6f 20 29 7b 0a 20 20 20  pPg->pgno ){.   
238d0 20 70 50 61 67 65 72 2d 3e 64 62 53 69 7a 65 20   pPager->dbSize 
238e0 3d 20 70 50 67 2d 3e 70 67 6e 6f 3b 0a 20 20 20  = pPg->pgno;.   
238f0 20 69 66 28 20 21 4d 45 4d 44 42 20 26 26 20 70   if( !MEMDB && p
23900 50 61 67 65 72 2d 3e 64 62 53 69 7a 65 3d 3d 50  Pager->dbSize==P
23910 45 4e 44 49 4e 47 5f 42 59 54 45 2f 70 50 61 67  ENDING_BYTE/pPag
23920 65 72 2d 3e 70 61 67 65 53 69 7a 65 20 29 7b 0a  er->pageSize ){.
23930 20 20 20 20 20 20 70 50 61 67 65 72 2d 3e 64 62        pPager->db
23940 53 69 7a 65 2b 2b 3b 0a 20 20 20 20 7d 0a 20 20  Size++;.    }.  
23950 7d 0a 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 7d  }.  return rc;.}
23960 0a 0a 2f 2a 0a 2a 2a 20 54 68 69 73 20 66 75 6e  ../*.** This fun
23970 63 74 69 6f 6e 20 69 73 20 75 73 65 64 20 74 6f  ction is used to
23980 20 6d 61 72 6b 20 61 20 64 61 74 61 2d 70 61 67   mark a data-pag
23990 65 20 61 73 20 77 72 69 74 61 62 6c 65 2e 20 49  e as writable. I
239a0 74 20 75 73 65 73 20 0a 2a 2a 20 70 61 67 65 72  t uses .** pager
239b0 5f 77 72 69 74 65 28 29 20 74 6f 20 6f 70 65 6e  _write() to open
239c0 20 61 20 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 20   a journal file 
239d0 28 69 66 20 69 74 20 69 73 20 6e 6f 74 20 61 6c  (if it is not al
239e0 72 65 61 64 79 20 6f 70 65 6e 29 0a 2a 2a 20 61  ready open).** a
239f0 6e 64 20 77 72 69 74 65 20 74 68 65 20 70 61 67  nd write the pag
23a00 65 20 2a 70 44 61 74 61 20 74 6f 20 74 68 65 20  e *pData to the 
23a10 6a 6f 75 72 6e 61 6c 2e 0a 2a 2a 0a 2a 2a 20 54  journal..**.** T
23a20 68 65 20 64 69 66 66 65 72 65 6e 63 65 20 62 65  he difference be
23a30 74 77 65 65 6e 20 74 68 69 73 20 66 75 6e 63 74  tween this funct
23a40 69 6f 6e 20 61 6e 64 20 70 61 67 65 72 5f 77 72  ion and pager_wr
23a50 69 74 65 28 29 20 69 73 20 74 68 61 74 20 74 68  ite() is that th
23a60 69 73 0a 2a 2a 20 66 75 6e 63 74 69 6f 6e 20 61  is.** function a
23a70 6c 73 6f 20 64 65 61 6c 73 20 77 69 74 68 20 74  lso deals with t
23a80 68 65 20 73 70 65 63 69 61 6c 20 63 61 73 65 20  he special case 
23a90 77 68 65 72 65 20 32 20 6f 72 20 6d 6f 72 65 20  where 2 or more 
23aa0 70 61 67 65 73 0a 2a 2a 20 66 69 74 20 6f 6e 20  pages.** fit on 
23ab0 61 20 73 69 6e 67 6c 65 20 64 69 73 6b 20 73 65  a single disk se
23ac0 63 74 6f 72 2e 20 49 6e 20 74 68 69 73 20 63 61  ctor. In this ca
23ad0 73 65 20 61 6c 6c 20 63 6f 2d 72 65 73 69 64 65  se all co-reside
23ae0 6e 74 20 70 61 67 65 73 0a 2a 2a 20 6d 75 73 74  nt pages.** must
23af0 20 68 61 76 65 20 62 65 65 6e 20 77 72 69 74 74   have been writt
23b00 65 6e 20 74 6f 20 74 68 65 20 6a 6f 75 72 6e 61  en to the journa
23b10 6c 20 66 69 6c 65 20 62 65 66 6f 72 65 20 72 65  l file before re
23b20 74 75 72 6e 69 6e 67 2e 0a 2a 2f 0a 69 6e 74 20  turning..*/.int 
23b30 73 71 6c 69 74 65 33 50 61 67 65 72 57 72 69 74  sqlite3PagerWrit
23b40 65 28 44 62 50 61 67 65 20 2a 70 44 62 50 61 67  e(DbPage *pDbPag
23b50 65 29 7b 0a 20 20 69 6e 74 20 72 63 20 3d 20 53  e){.  int rc = S
23b60 51 4c 49 54 45 5f 4f 4b 3b 0a 0a 20 20 50 67 48  QLITE_OK;..  PgH
23b70 64 72 20 2a 70 50 67 20 3d 20 70 44 62 50 61 67  dr *pPg = pDbPag
23b80 65 3b 0a 20 20 50 61 67 65 72 20 2a 70 50 61 67  e;.  Pager *pPag
23b90 65 72 20 3d 20 70 50 67 2d 3e 70 50 61 67 65 72  er = pPg->pPager
23ba0 3b 0a 20 20 50 67 6e 6f 20 6e 50 61 67 65 50 65  ;.  Pgno nPagePe
23bb0 72 53 65 63 74 6f 72 20 3d 20 28 70 50 61 67 65  rSector = (pPage
23bc0 72 2d 3e 73 65 63 74 6f 72 53 69 7a 65 2f 70 50  r->sectorSize/pP
23bd0 61 67 65 72 2d 3e 70 61 67 65 53 69 7a 65 29 3b  ager->pageSize);
23be0 0a 0a 20 20 70 61 67 65 72 45 6e 74 65 72 28 70  ..  pagerEnter(p
23bf0 50 61 67 65 72 29 3b 0a 20 20 69 66 28 20 21 4d  Pager);.  if( !M
23c00 45 4d 44 42 20 26 26 20 6e 50 61 67 65 50 65 72  EMDB && nPagePer
23c10 53 65 63 74 6f 72 3e 31 20 29 7b 0a 20 20 20 20  Sector>1 ){.    
23c20 50 67 6e 6f 20 6e 50 61 67 65 43 6f 75 6e 74 3b  Pgno nPageCount;
23c30 20 20 20 20 20 20 20 20 20 20 2f 2a 20 54 6f 74            /* Tot
23c40 61 6c 20 6e 75 6d 62 65 72 20 6f 66 20 70 61 67  al number of pag
23c50 65 73 20 69 6e 20 64 61 74 61 62 61 73 65 20 66  es in database f
23c60 69 6c 65 20 2a 2f 0a 20 20 20 20 50 67 6e 6f 20  ile */.    Pgno 
23c70 70 67 31 3b 20 20 20 20 20 20 20 20 20 20 20 20  pg1;            
23c80 20 20 20 20 20 2f 2a 20 46 69 72 73 74 20 70 61       /* First pa
23c90 67 65 20 6f 66 20 74 68 65 20 73 65 63 74 6f 72  ge of the sector
23ca0 20 70 50 67 20 69 73 20 6c 6f 63 61 74 65 64 20   pPg is located 
23cb0 6f 6e 2e 20 2a 2f 0a 20 20 20 20 69 6e 74 20 6e  on. */.    int n
23cc0 50 61 67 65 3b 20 20 20 20 20 20 20 20 20 20 20  Page;           
23cd0 20 20 20 20 20 2f 2a 20 4e 75 6d 62 65 72 20 6f       /* Number o
23ce0 66 20 70 61 67 65 73 20 73 74 61 72 74 69 6e 67  f pages starting
23cf0 20 61 74 20 70 67 31 20 74 6f 20 6a 6f 75 72 6e   at pg1 to journ
23d00 61 6c 20 2a 2f 0a 20 20 20 20 69 6e 74 20 69 69  al */.    int ii
23d10 3b 0a 20 20 20 20 69 6e 74 20 6e 65 65 64 53 79  ;.    int needSy
23d20 6e 63 20 3d 20 30 3b 0a 0a 20 20 20 20 2f 2a 20  nc = 0;..    /* 
23d30 53 65 74 20 74 68 65 20 64 6f 4e 6f 74 53 79 6e  Set the doNotSyn
23d40 63 20 66 6c 61 67 20 74 6f 20 31 2e 20 54 68 69  c flag to 1. Thi
23d50 73 20 69 73 20 62 65 63 61 75 73 65 20 77 65 20  s is because we 
23d60 63 61 6e 6e 6f 74 20 61 6c 6c 6f 77 20 61 20 6a  cannot allow a j
23d70 6f 75 72 6e 61 6c 0a 20 20 20 20 2a 2a 20 68 65  ournal.    ** he
23d80 61 64 65 72 20 74 6f 20 62 65 20 77 72 69 74 74  ader to be writt
23d90 65 6e 20 62 65 74 77 65 65 6e 20 74 68 65 20 70  en between the p
23da0 61 67 65 73 20 6a 6f 75 72 6e 61 6c 65 64 20 62  ages journaled b
23db0 79 20 74 68 69 73 20 66 75 6e 63 74 69 6f 6e 2e  y this function.
23dc0 0a 20 20 20 20 2a 2f 0a 20 20 20 20 61 73 73 65  .    */.    asse
23dd0 72 74 28 20 70 50 61 67 65 72 2d 3e 64 6f 4e 6f  rt( pPager->doNo
23de0 74 53 79 6e 63 3d 3d 30 20 29 3b 0a 20 20 20 20  tSync==0 );.    
23df0 70 50 61 67 65 72 2d 3e 64 6f 4e 6f 74 53 79 6e  pPager->doNotSyn
23e00 63 20 3d 20 31 3b 0a 0a 20 20 20 20 2f 2a 20 54  c = 1;..    /* T
23e10 68 69 73 20 74 72 69 63 6b 20 61 73 73 75 6d 65  his trick assume
23e20 73 20 74 68 61 74 20 62 6f 74 68 20 74 68 65 20  s that both the 
23e30 70 61 67 65 2d 73 69 7a 65 20 61 6e 64 20 73 65  page-size and se
23e40 63 74 6f 72 2d 73 69 7a 65 20 61 72 65 0a 20 20  ctor-size are.  
23e50 20 20 2a 2a 20 61 6e 20 69 6e 74 65 67 65 72 20    ** an integer 
23e60 70 6f 77 65 72 20 6f 66 20 32 2e 20 49 74 20 73  power of 2. It s
23e70 65 74 73 20 76 61 72 69 61 62 6c 65 20 70 67 31  ets variable pg1
23e80 20 74 6f 20 74 68 65 20 69 64 65 6e 74 69 66 69   to the identifi
23e90 65 72 0a 20 20 20 20 2a 2a 20 6f 66 20 74 68 65  er.    ** of the
23ea0 20 66 69 72 73 74 20 70 61 67 65 20 6f 66 20 74   first page of t
23eb0 68 65 20 73 65 63 74 6f 72 20 70 50 67 20 69 73  he sector pPg is
23ec0 20 6c 6f 63 61 74 65 64 20 6f 6e 2e 0a 20 20 20   located on..   
23ed0 20 2a 2f 0a 20 20 20 20 70 67 31 20 3d 20 28 28   */.    pg1 = ((
23ee0 70 50 67 2d 3e 70 67 6e 6f 2d 31 29 20 26 20 7e  pPg->pgno-1) & ~
23ef0 28 6e 50 61 67 65 50 65 72 53 65 63 74 6f 72 2d  (nPagePerSector-
23f00 31 29 29 20 2b 20 31 3b 0a 0a 20 20 20 20 6e 50  1)) + 1;..    nP
23f10 61 67 65 43 6f 75 6e 74 20 3d 20 73 71 6c 69 74  ageCount = sqlit
23f20 65 33 50 61 67 65 72 50 61 67 65 63 6f 75 6e 74  e3PagerPagecount
23f30 28 70 50 61 67 65 72 29 3b 0a 20 20 20 20 69 66  (pPager);.    if
23f40 28 20 70 50 67 2d 3e 70 67 6e 6f 3e 6e 50 61 67  ( pPg->pgno>nPag
23f50 65 43 6f 75 6e 74 20 29 7b 0a 20 20 20 20 20 20  eCount ){.      
23f60 6e 50 61 67 65 20 3d 20 28 70 50 67 2d 3e 70 67  nPage = (pPg->pg
23f70 6e 6f 20 2d 20 70 67 31 29 2b 31 3b 0a 20 20 20  no - pg1)+1;.   
23f80 20 7d 65 6c 73 65 20 69 66 28 20 28 70 67 31 2b   }else if( (pg1+
23f90 6e 50 61 67 65 50 65 72 53 65 63 74 6f 72 2d 31  nPagePerSector-1
23fa0 29 3e 6e 50 61 67 65 43 6f 75 6e 74 20 29 7b 0a  )>nPageCount ){.
23fb0 20 20 20 20 20 20 6e 50 61 67 65 20 3d 20 6e 50        nPage = nP
23fc0 61 67 65 43 6f 75 6e 74 2b 31 2d 70 67 31 3b 0a  ageCount+1-pg1;.
23fd0 20 20 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 20      }else{.     
23fe0 20 6e 50 61 67 65 20 3d 20 6e 50 61 67 65 50 65   nPage = nPagePe
23ff0 72 53 65 63 74 6f 72 3b 0a 20 20 20 20 7d 0a 20  rSector;.    }. 
24000 20 20 20 61 73 73 65 72 74 28 6e 50 61 67 65 3e     assert(nPage>
24010 30 29 3b 0a 20 20 20 20 61 73 73 65 72 74 28 70  0);.    assert(p
24020 67 31 3c 3d 70 50 67 2d 3e 70 67 6e 6f 29 3b 0a  g1<=pPg->pgno);.
24030 20 20 20 20 61 73 73 65 72 74 28 28 70 67 31 2b      assert((pg1+
24040 6e 50 61 67 65 29 3e 70 50 67 2d 3e 70 67 6e 6f  nPage)>pPg->pgno
24050 29 3b 0a 0a 20 20 20 20 66 6f 72 28 69 69 3d 30  );..    for(ii=0
24060 3b 20 69 69 3c 6e 50 61 67 65 20 26 26 20 72 63  ; ii<nPage && rc
24070 3d 3d 53 51 4c 49 54 45 5f 4f 4b 3b 20 69 69 2b  ==SQLITE_OK; ii+
24080 2b 29 7b 0a 20 20 20 20 20 20 50 67 6e 6f 20 70  +){.      Pgno p
24090 67 20 3d 20 70 67 31 2b 69 69 3b 0a 20 20 20 20  g = pg1+ii;.    
240a0 20 20 50 67 48 64 72 20 2a 70 50 61 67 65 3b 0a    PgHdr *pPage;.
240b0 20 20 20 20 20 20 69 66 28 20 70 67 3d 3d 70 50        if( pg==pP
240c0 67 2d 3e 70 67 6e 6f 20 7c 7c 20 21 73 71 6c 69  g->pgno || !sqli
240d0 74 65 33 42 69 74 76 65 63 54 65 73 74 28 70 50  te3BitvecTest(pP
240e0 61 67 65 72 2d 3e 70 49 6e 4a 6f 75 72 6e 61 6c  ager->pInJournal
240f0 2c 20 70 67 29 20 29 7b 0a 20 20 20 20 20 20 20  , pg) ){.       
24100 20 69 66 28 20 70 67 21 3d 50 41 47 45 52 5f 4d   if( pg!=PAGER_M
24110 4a 5f 50 47 4e 4f 28 70 50 61 67 65 72 29 20 29  J_PGNO(pPager) )
24120 7b 0a 20 20 20 20 20 20 20 20 20 20 72 63 20 3d  {.          rc =
24130 20 73 71 6c 69 74 65 33 50 61 67 65 72 47 65 74   sqlite3PagerGet
24140 28 70 50 61 67 65 72 2c 20 70 67 2c 20 26 70 50  (pPager, pg, &pP
24150 61 67 65 29 3b 0a 20 20 20 20 20 20 20 20 20 20  age);.          
24160 69 66 28 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4f  if( rc==SQLITE_O
24170 4b 20 29 7b 0a 20 20 20 20 20 20 20 20 20 20 20  K ){.           
24180 20 72 63 20 3d 20 70 61 67 65 72 5f 77 72 69 74   rc = pager_writ
24190 65 28 70 50 61 67 65 29 3b 0a 20 20 20 20 20 20  e(pPage);.      
241a0 20 20 20 20 20 20 69 66 28 20 70 50 61 67 65 2d        if( pPage-
241b0 3e 6e 65 65 64 53 79 6e 63 20 29 7b 0a 20 20 20  >needSync ){.   
241c0 20 20 20 20 20 20 20 20 20 20 20 6e 65 65 64 53             needS
241d0 79 6e 63 20 3d 20 31 3b 0a 20 20 20 20 20 20 20  ync = 1;.       
241e0 20 20 20 20 20 7d 0a 20 20 20 20 20 20 20 20 20       }.         
241f0 20 20 20 73 71 6c 69 74 65 33 50 61 67 65 72 55     sqlite3PagerU
24200 6e 72 65 66 28 70 50 61 67 65 29 3b 0a 20 20 20  nref(pPage);.   
24210 20 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 20         }.       
24220 20 7d 0a 20 20 20 20 20 20 7d 65 6c 73 65 20 69   }.      }else i
24230 66 28 20 28 70 50 61 67 65 20 3d 20 70 61 67 65  f( (pPage = page
24240 72 5f 6c 6f 6f 6b 75 70 28 70 50 61 67 65 72 2c  r_lookup(pPager,
24250 20 70 67 29 29 21 3d 30 20 29 7b 0a 20 20 20 20   pg))!=0 ){.    
24260 20 20 20 20 69 66 28 20 70 50 61 67 65 2d 3e 6e      if( pPage->n
24270 65 65 64 53 79 6e 63 20 29 7b 0a 20 20 20 20 20  eedSync ){.     
24280 20 20 20 20 20 6e 65 65 64 53 79 6e 63 20 3d 20       needSync = 
24290 31 3b 0a 20 20 20 20 20 20 20 20 7d 0a 20 20 20  1;.        }.   
242a0 20 20 20 7d 0a 20 20 20 20 7d 0a 0a 20 20 20 20     }.    }..    
242b0 2f 2a 20 49 66 20 74 68 65 20 50 67 48 64 72 2e  /* If the PgHdr.
242c0 6e 65 65 64 53 79 6e 63 20 66 6c 61 67 20 69 73  needSync flag is
242d0 20 73 65 74 20 66 6f 72 20 61 6e 79 20 6f 66 20   set for any of 
242e0 74 68 65 20 6e 50 61 67 65 20 70 61 67 65 73 20  the nPage pages 
242f0 0a 20 20 20 20 2a 2a 20 73 74 61 72 74 69 6e 67  .    ** starting
24300 20 61 74 20 70 67 31 2c 20 74 68 65 6e 20 69 74   at pg1, then it
24310 20 6e 65 65 64 73 20 74 6f 20 62 65 20 73 65 74   needs to be set
24320 20 66 6f 72 20 61 6c 6c 20 6f 66 20 74 68 65 6d   for all of them
24330 2e 20 42 65 63 61 75 73 65 0a 20 20 20 20 2a 2a  . Because.    **
24340 20 77 72 69 74 69 6e 67 20 74 6f 20 61 6e 79 20   writing to any 
24350 6f 66 20 74 68 65 73 65 20 6e 50 61 67 65 20 70  of these nPage p
24360 61 67 65 73 20 6d 61 79 20 64 61 6d 61 67 65 20  ages may damage 
24370 74 68 65 20 6f 74 68 65 72 73 2c 20 74 68 65 0a  the others, the.
24380 20 20 20 20 2a 2a 20 6a 6f 75 72 6e 61 6c 20 66      ** journal f
24390 69 6c 65 20 6d 75 73 74 20 63 6f 6e 74 61 69 6e  ile must contain
243a0 20 73 79 6e 63 28 29 65 64 20 63 6f 70 69 65 73   sync()ed copies
243b0 20 6f 66 20 61 6c 6c 20 6f 66 20 74 68 65 6d 0a   of all of them.
243c0 20 20 20 20 2a 2a 20 62 65 66 6f 72 65 20 61 6e      ** before an
243d0 79 20 6f 66 20 74 68 65 6d 20 63 61 6e 20 62 65  y of them can be
243e0 20 77 72 69 74 74 65 6e 20 6f 75 74 20 74 6f 20   written out to 
243f0 74 68 65 20 64 61 74 61 62 61 73 65 20 66 69 6c  the database fil
24400 65 2e 0a 20 20 20 20 2a 2f 0a 20 20 20 20 69 66  e..    */.    if
24410 28 20 6e 65 65 64 53 79 6e 63 20 29 7b 0a 20 20  ( needSync ){.  
24420 20 20 20 20 66 6f 72 28 69 69 3d 30 3b 20 69 69      for(ii=0; ii
24430 3c 6e 50 61 67 65 20 26 26 20 6e 65 65 64 53 79  <nPage && needSy
24440 6e 63 3b 20 69 69 2b 2b 29 7b 0a 20 20 20 20 20  nc; ii++){.     
24450 20 20 20 50 67 48 64 72 20 2a 70 50 61 67 65 20     PgHdr *pPage 
24460 3d 20 70 61 67 65 72 5f 6c 6f 6f 6b 75 70 28 70  = pager_lookup(p
24470 50 61 67 65 72 2c 20 70 67 31 2b 69 69 29 3b 0a  Pager, pg1+ii);.
24480 20 20 20 20 20 20 20 20 69 66 28 20 70 50 61 67          if( pPag
24490 65 20 29 20 70 50 61 67 65 2d 3e 6e 65 65 64 53  e ) pPage->needS
244a0 79 6e 63 20 3d 20 31 3b 0a 20 20 20 20 20 20 7d  ync = 1;.      }
244b0 0a 20 20 20 20 20 20 61 73 73 65 72 74 28 70 50  .      assert(pP
244c0 61 67 65 72 2d 3e 6e 65 65 64 53 79 6e 63 29 3b  ager->needSync);
244d0 0a 20 20 20 20 7d 0a 0a 20 20 20 20 61 73 73 65  .    }..    asse
244e0 72 74 28 20 70 50 61 67 65 72 2d 3e 64 6f 4e 6f  rt( pPager->doNo
244f0 74 53 79 6e 63 3d 3d 31 20 29 3b 0a 20 20 20 20  tSync==1 );.    
24500 70 50 61 67 65 72 2d 3e 64 6f 4e 6f 74 53 79 6e  pPager->doNotSyn
24510 63 20 3d 20 30 3b 0a 20 20 7d 65 6c 73 65 7b 0a  c = 0;.  }else{.
24520 20 20 20 20 72 63 20 3d 20 70 61 67 65 72 5f 77      rc = pager_w
24530 72 69 74 65 28 70 44 62 50 61 67 65 29 3b 0a 20  rite(pDbPage);. 
24540 20 7d 0a 20 20 70 61 67 65 72 4c 65 61 76 65 28   }.  pagerLeave(
24550 70 50 61 67 65 72 29 3b 0a 20 20 72 65 74 75 72  pPager);.  retur
24560 6e 20 72 63 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 52  n rc;.}../*.** R
24570 65 74 75 72 6e 20 54 52 55 45 20 69 66 20 74 68  eturn TRUE if th
24580 65 20 70 61 67 65 20 67 69 76 65 6e 20 69 6e 20  e page given in 
24590 74 68 65 20 61 72 67 75 6d 65 6e 74 20 77 61 73  the argument was
245a0 20 70 72 65 76 69 6f 75 73 6c 79 20 70 61 73 73   previously pass
245b0 65 64 0a 2a 2a 20 74 6f 20 73 71 6c 69 74 65 33  ed.** to sqlite3
245c0 50 61 67 65 72 57 72 69 74 65 28 29 2e 20 20 49  PagerWrite().  I
245d0 6e 20 6f 74 68 65 72 20 77 6f 72 64 73 2c 20 72  n other words, r
245e0 65 74 75 72 6e 20 54 52 55 45 20 69 66 20 69 74  eturn TRUE if it
245f0 20 69 73 20 6f 6b 0a 2a 2a 20 74 6f 20 63 68 61   is ok.** to cha
24600 6e 67 65 20 74 68 65 20 63 6f 6e 74 65 6e 74 20  nge the content 
24610 6f 66 20 74 68 65 20 70 61 67 65 2e 0a 2a 2f 0a  of the page..*/.
24620 23 69 66 6e 64 65 66 20 4e 44 45 42 55 47 0a 69  #ifndef NDEBUG.i
24630 6e 74 20 73 71 6c 69 74 65 33 50 61 67 65 72 49  nt sqlite3PagerI
24640 73 77 72 69 74 65 61 62 6c 65 28 44 62 50 61 67  swriteable(DbPag
24650 65 20 2a 70 50 67 29 7b 0a 20 20 72 65 74 75 72  e *pPg){.  retur
24660 6e 20 70 50 67 2d 3e 64 69 72 74 79 3b 0a 7d 0a  n pPg->dirty;.}.
24670 23 65 6e 64 69 66 0a 0a 23 69 66 6e 64 65 66 20  #endif..#ifndef 
24680 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 56 41 43 55  SQLITE_OMIT_VACU
24690 55 4d 0a 2f 2a 0a 2a 2a 20 52 65 70 6c 61 63 65  UM./*.** Replace
246a0 20 74 68 65 20 63 6f 6e 74 65 6e 74 20 6f 66 20   the content of 
246b0 61 20 73 69 6e 67 6c 65 20 70 61 67 65 20 77 69  a single page wi
246c0 74 68 20 74 68 65 20 69 6e 66 6f 72 6d 61 74 69  th the informati
246d0 6f 6e 20 69 6e 20 74 68 65 20 74 68 69 72 64 0a  on in the third.
246e0 2a 2a 20 61 72 67 75 6d 65 6e 74 2e 0a 2a 2f 0a  ** argument..*/.
246f0 69 6e 74 20 73 71 6c 69 74 65 33 50 61 67 65 72  int sqlite3Pager
24700 4f 76 65 72 77 72 69 74 65 28 50 61 67 65 72 20  Overwrite(Pager 
24710 2a 70 50 61 67 65 72 2c 20 50 67 6e 6f 20 70 67  *pPager, Pgno pg
24720 6e 6f 2c 20 76 6f 69 64 20 2a 70 44 61 74 61 29  no, void *pData)
24730 7b 0a 20 20 50 67 48 64 72 20 2a 70 50 67 3b 0a  {.  PgHdr *pPg;.
24740 20 20 69 6e 74 20 72 63 3b 0a 0a 20 20 70 61 67    int rc;..  pag
24750 65 72 45 6e 74 65 72 28 70 50 61 67 65 72 29 3b  erEnter(pPager);
24760 0a 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33 50  .  rc = sqlite3P
24770 61 67 65 72 47 65 74 28 70 50 61 67 65 72 2c 20  agerGet(pPager, 
24780 70 67 6e 6f 2c 20 26 70 50 67 29 3b 0a 20 20 69  pgno, &pPg);.  i
24790 66 28 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b  f( rc==SQLITE_OK
247a0 20 29 7b 0a 20 20 20 20 72 63 20 3d 20 73 71 6c   ){.    rc = sql
247b0 69 74 65 33 50 61 67 65 72 57 72 69 74 65 28 70  ite3PagerWrite(p
247c0 50 67 29 3b 0a 20 20 20 20 69 66 28 20 72 63 3d  Pg);.    if( rc=
247d0 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20  =SQLITE_OK ){.  
247e0 20 20 20 20 6d 65 6d 63 70 79 28 73 71 6c 69 74      memcpy(sqlit
247f0 65 33 50 61 67 65 72 47 65 74 44 61 74 61 28 70  e3PagerGetData(p
24800 50 67 29 2c 20 70 44 61 74 61 2c 20 70 50 61 67  Pg), pData, pPag
24810 65 72 2d 3e 70 61 67 65 53 69 7a 65 29 3b 0a 20  er->pageSize);. 
24820 20 20 20 7d 0a 20 20 20 20 73 71 6c 69 74 65 33     }.    sqlite3
24830 50 61 67 65 72 55 6e 72 65 66 28 70 50 67 29 3b  PagerUnref(pPg);
24840 0a 20 20 7d 0a 20 20 70 61 67 65 72 4c 65 61 76  .  }.  pagerLeav
24850 65 28 70 50 61 67 65 72 29 3b 0a 20 20 72 65 74  e(pPager);.  ret
24860 75 72 6e 20 72 63 3b 0a 7d 0a 23 65 6e 64 69 66  urn rc;.}.#endif
24870 0a 0a 2f 2a 0a 2a 2a 20 41 20 63 61 6c 6c 20 74  ../*.** A call t
24880 6f 20 74 68 69 73 20 72 6f 75 74 69 6e 65 20 74  o this routine t
24890 65 6c 6c 73 20 74 68 65 20 70 61 67 65 72 20 74  ells the pager t
248a0 68 61 74 20 69 74 20 69 73 20 6e 6f 74 20 6e 65  hat it is not ne
248b0 63 65 73 73 61 72 79 20 74 6f 0a 2a 2a 20 77 72  cessary to.** wr
248c0 69 74 65 20 74 68 65 20 69 6e 66 6f 72 6d 61 74  ite the informat
248d0 69 6f 6e 20 6f 6e 20 70 61 67 65 20 70 50 67 20  ion on page pPg 
248e0 62 61 63 6b 20 74 6f 20 74 68 65 20 64 69 73 6b  back to the disk
248f0 2c 20 65 76 65 6e 20 74 68 6f 75 67 68 0a 2a 2a  , even though.**
24900 20 74 68 61 74 20 70 61 67 65 20 6d 69 67 68 74   that page might
24910 20 62 65 20 6d 61 72 6b 65 64 20 61 73 20 64 69   be marked as di
24920 72 74 79 2e 0a 2a 2a 0a 2a 2a 20 54 68 65 20 6f  rty..**.** The o
24930 76 65 72 6c 79 69 6e 67 20 73 6f 66 74 77 61 72  verlying softwar
24940 65 20 6c 61 79 65 72 20 63 61 6c 6c 73 20 74 68  e layer calls th
24950 69 73 20 72 6f 75 74 69 6e 65 20 77 68 65 6e 20  is routine when 
24960 61 6c 6c 20 6f 66 20 74 68 65 20 64 61 74 61 0a  all of the data.
24970 2a 2a 20 6f 6e 20 74 68 65 20 67 69 76 65 6e 20  ** on the given 
24980 70 61 67 65 20 69 73 20 75 6e 75 73 65 64 2e 20  page is unused. 
24990 20 54 68 65 20 70 61 67 65 72 20 6d 61 72 6b 73   The pager marks
249a0 20 74 68 65 20 70 61 67 65 20 61 73 20 63 6c 65   the page as cle
249b0 61 6e 20 73 6f 0a 2a 2a 20 74 68 61 74 20 69 74  an so.** that it
249c0 20 64 6f 65 73 20 6e 6f 74 20 67 65 74 20 77 72   does not get wr
249d0 69 74 74 65 6e 20 74 6f 20 64 69 73 6b 2e 0a 2a  itten to disk..*
249e0 2a 0a 2a 2a 20 54 65 73 74 73 20 73 68 6f 77 20  *.** Tests show 
249f0 74 68 61 74 20 74 68 69 73 20 6f 70 74 69 6d 69  that this optimi
24a00 7a 61 74 69 6f 6e 2c 20 74 6f 67 65 74 68 65 72  zation, together
24a10 20 77 69 74 68 20 74 68 65 0a 2a 2a 20 73 71 6c   with the.** sql
24a20 69 74 65 33 50 61 67 65 72 44 6f 6e 74 52 6f 6c  ite3PagerDontRol
24a30 6c 62 61 63 6b 28 29 20 62 65 6c 6f 77 2c 20 6d  lback() below, m
24a40 6f 72 65 20 74 68 61 6e 20 64 6f 75 62 6c 65 20  ore than double 
24a50 74 68 65 20 73 70 65 65 64 0a 2a 2a 20 6f 66 20  the speed.** of 
24a60 6c 61 72 67 65 20 49 4e 53 45 52 54 20 6f 70 65  large INSERT ope
24a70 72 61 74 69 6f 6e 73 20 61 6e 64 20 71 75 61 64  rations and quad
24a80 72 75 70 6c 65 20 74 68 65 20 73 70 65 65 64 20  ruple the speed 
24a90 6f 66 20 6c 61 72 67 65 20 44 45 4c 45 54 45 73  of large DELETEs
24aa0 2e 0a 2a 2a 0a 2a 2a 20 57 68 65 6e 20 74 68 69  ..**.** When thi
24ab0 73 20 72 6f 75 74 69 6e 65 20 69 73 20 63 61 6c  s routine is cal
24ac0 6c 65 64 2c 20 73 65 74 20 74 68 65 20 61 6c 77  led, set the alw
24ad0 61 79 73 52 6f 6c 6c 62 61 63 6b 20 66 6c 61 67  aysRollback flag
24ae0 20 74 6f 20 74 72 75 65 2e 0a 2a 2a 20 53 75 62   to true..** Sub
24af0 73 65 71 75 65 6e 74 20 63 61 6c 6c 73 20 74 6f  sequent calls to
24b00 20 73 71 6c 69 74 65 33 50 61 67 65 72 44 6f 6e   sqlite3PagerDon
24b10 74 52 6f 6c 6c 62 61 63 6b 28 29 20 66 6f 72 20  tRollback() for 
24b20 74 68 65 20 73 61 6d 65 20 70 61 67 65 0a 2a 2a  the same page.**
24b30 20 77 69 6c 6c 20 74 68 65 72 65 61 66 74 65 72   will thereafter
24b40 20 62 65 20 69 67 6e 6f 72 65 64 2e 20 20 54 68   be ignored.  Th
24b50 69 73 20 69 73 20 6e 65 63 65 73 73 61 72 79 20  is is necessary 
24b60 74 6f 20 61 76 6f 69 64 20 61 20 70 72 6f 62 6c  to avoid a probl
24b70 65 6d 0a 2a 2a 20 77 68 65 72 65 20 61 20 70 61  em.** where a pa
24b80 67 65 20 77 69 74 68 20 64 61 74 61 20 69 73 20  ge with data is 
24b90 61 64 64 65 64 20 74 6f 20 74 68 65 20 66 72 65  added to the fre
24ba0 65 6c 69 73 74 20 64 75 72 69 6e 67 20 6f 6e 65  elist during one
24bb0 20 70 61 72 74 20 6f 66 0a 2a 2a 20 61 20 74 72   part of.** a tr
24bc0 61 6e 73 61 63 74 69 6f 6e 20 74 68 65 6e 20 72  ansaction then r
24bd0 65 6d 6f 76 65 64 20 66 72 6f 6d 20 74 68 65 20  emoved from the 
24be0 66 72 65 65 6c 69 73 74 20 64 75 72 69 6e 67 20  freelist during 
24bf0 61 20 6c 61 74 65 72 20 70 61 72 74 0a 2a 2a 20  a later part.** 
24c00 6f 66 20 74 68 65 20 73 61 6d 65 20 74 72 61 6e  of the same tran
24c10 73 61 63 74 69 6f 6e 20 61 6e 64 20 72 65 75 73  saction and reus
24c20 65 64 20 66 6f 72 20 73 6f 6d 65 20 6f 74 68 65  ed for some othe
24c30 72 20 70 75 72 70 6f 73 65 2e 20 20 57 68 65 6e  r purpose.  When
24c40 20 69 74 0a 2a 2a 20 69 73 20 66 69 72 73 74 20   it.** is first 
24c50 61 64 64 65 64 20 74 6f 20 74 68 65 20 66 72 65  added to the fre
24c60 65 6c 69 73 74 2c 20 74 68 69 73 20 72 6f 75 74  elist, this rout
24c70 69 6e 65 20 69 73 20 63 61 6c 6c 65 64 2e 20 20  ine is called.  
24c80 57 68 65 6e 20 72 65 75 73 65 64 2c 0a 2a 2a 20  When reused,.** 
24c90 74 68 65 20 73 71 6c 69 74 65 33 50 61 67 65 72  the sqlite3Pager
24ca0 44 6f 6e 74 52 6f 6c 6c 62 61 63 6b 28 29 20 72  DontRollback() r
24cb0 6f 75 74 69 6e 65 20 69 73 20 63 61 6c 6c 65 64  outine is called
24cc0 2e 20 20 42 75 74 20 62 65 63 61 75 73 65 20 74  .  But because t
24cd0 68 65 0a 2a 2a 20 70 61 67 65 20 63 6f 6e 74 61  he.** page conta
24ce0 69 6e 73 20 63 72 69 74 69 63 61 6c 20 64 61 74  ins critical dat
24cf0 61 2c 20 77 65 20 73 74 69 6c 6c 20 6e 65 65 64  a, we still need
24d00 20 74 6f 20 62 65 20 73 75 72 65 20 69 74 20 67   to be sure it g
24d10 65 74 73 0a 2a 2a 20 72 6f 6c 6c 65 64 20 62 61  ets.** rolled ba
24d20 63 6b 20 69 6e 20 73 70 69 74 65 20 6f 66 20 74  ck in spite of t
24d30 68 65 20 73 71 6c 69 74 65 33 50 61 67 65 72 44  he sqlite3PagerD
24d40 6f 6e 74 52 6f 6c 6c 62 61 63 6b 28 29 20 63 61  ontRollback() ca
24d50 6c 6c 2e 0a 2a 2f 0a 76 6f 69 64 20 73 71 6c 69  ll..*/.void sqli
24d60 74 65 33 50 61 67 65 72 44 6f 6e 74 57 72 69 74  te3PagerDontWrit
24d70 65 28 44 62 50 61 67 65 20 2a 70 44 62 50 61 67  e(DbPage *pDbPag
24d80 65 29 7b 0a 20 20 50 67 48 64 72 20 2a 70 50 67  e){.  PgHdr *pPg
24d90 20 3d 20 70 44 62 50 61 67 65 3b 0a 20 20 50 61   = pDbPage;.  Pa
24da0 67 65 72 20 2a 70 50 61 67 65 72 20 3d 20 70 50  ger *pPager = pP
24db0 67 2d 3e 70 50 61 67 65 72 3b 0a 0a 20 20 69 66  g->pPager;..  if
24dc0 28 20 4d 45 4d 44 42 20 29 20 72 65 74 75 72 6e  ( MEMDB ) return
24dd0 3b 0a 20 20 70 61 67 65 72 45 6e 74 65 72 28 70  ;.  pagerEnter(p
24de0 50 61 67 65 72 29 3b 0a 20 20 70 50 67 2d 3e 61  Pager);.  pPg->a
24df0 6c 77 61 79 73 52 6f 6c 6c 62 61 63 6b 20 3d 20  lwaysRollback = 
24e00 31 3b 0a 20 20 69 66 28 20 70 50 67 2d 3e 64 69  1;.  if( pPg->di
24e10 72 74 79 20 26 26 20 21 70 50 61 67 65 72 2d 3e  rty && !pPager->
24e20 73 74 6d 74 49 6e 55 73 65 20 29 7b 0a 20 20 20  stmtInUse ){.   
24e30 20 61 73 73 65 72 74 28 20 70 50 61 67 65 72 2d   assert( pPager-
24e40 3e 73 74 61 74 65 3e 3d 50 41 47 45 52 5f 53 48  >state>=PAGER_SH
24e50 41 52 45 44 20 29 3b 0a 20 20 20 20 69 66 28 20  ARED );.    if( 
24e60 70 50 61 67 65 72 2d 3e 64 62 53 69 7a 65 3d 3d  pPager->dbSize==
24e70 28 69 6e 74 29 70 50 67 2d 3e 70 67 6e 6f 20 26  (int)pPg->pgno &
24e80 26 20 70 50 61 67 65 72 2d 3e 6f 72 69 67 44 62  & pPager->origDb
24e90 53 69 7a 65 3c 70 50 61 67 65 72 2d 3e 64 62 53  Size<pPager->dbS
24ea0 69 7a 65 20 29 7b 0a 20 20 20 20 20 20 2f 2a 20  ize ){.      /* 
24eb0 49 66 20 74 68 69 73 20 70 61 67 65 73 20 69 73  If this pages is
24ec0 20 74 68 65 20 6c 61 73 74 20 70 61 67 65 20 69   the last page i
24ed0 6e 20 74 68 65 20 66 69 6c 65 20 61 6e 64 20 74  n the file and t
24ee0 68 65 20 66 69 6c 65 20 68 61 73 20 67 72 6f 77  he file has grow
24ef0 6e 0a 20 20 20 20 20 20 2a 2a 20 64 75 72 69 6e  n.      ** durin
24f00 67 20 74 68 65 20 63 75 72 72 65 6e 74 20 74 72  g the current tr
24f10 61 6e 73 61 63 74 69 6f 6e 2c 20 74 68 65 6e 20  ansaction, then 
24f20 64 6f 20 4e 4f 54 20 6d 61 72 6b 20 74 68 65 20  do NOT mark the 
24f30 70 61 67 65 20 61 73 20 63 6c 65 61 6e 2e 0a 20  page as clean.. 
24f40 20 20 20 20 20 2a 2a 20 57 68 65 6e 20 74 68 65       ** When the
24f50 20 64 61 74 61 62 61 73 65 20 66 69 6c 65 20 67   database file g
24f60 72 6f 77 73 2c 20 77 65 20 6d 75 73 74 20 6d 61  rows, we must ma
24f70 6b 65 20 73 75 72 65 20 74 68 61 74 20 74 68 65  ke sure that the
24f80 20 6c 61 73 74 20 70 61 67 65 0a 20 20 20 20 20   last page.     
24f90 20 2a 2a 20 67 65 74 73 20 77 72 69 74 74 65 6e   ** gets written
24fa0 20 61 74 20 6c 65 61 73 74 20 6f 6e 63 65 20 73   at least once s
24fb0 6f 20 74 68 61 74 20 74 68 65 20 64 69 73 6b 20  o that the disk 
24fc0 66 69 6c 65 20 77 69 6c 6c 20 62 65 20 74 68 65  file will be the
24fd0 20 63 6f 72 72 65 63 74 0a 20 20 20 20 20 20 2a   correct.      *
24fe0 2a 20 73 69 7a 65 2e 20 49 66 20 79 6f 75 20 64  * size. If you d
24ff0 6f 20 6e 6f 74 20 77 72 69 74 65 20 74 68 69 73  o not write this
25000 20 70 61 67 65 20 61 6e 64 20 74 68 65 20 73 69   page and the si
25010 7a 65 20 6f 66 20 74 68 65 20 66 69 6c 65 0a 20  ze of the file. 
25020 20 20 20 20 20 2a 2a 20 6f 6e 20 74 68 65 20 64       ** on the d
25030 69 73 6b 20 65 6e 64 73 20 75 70 20 62 65 69 6e  isk ends up bein
25040 67 20 74 6f 6f 20 73 6d 61 6c 6c 2c 20 74 68 61  g too small, tha
25050 74 20 63 61 6e 20 6c 65 61 64 20 74 6f 20 64 61  t can lead to da
25060 74 61 62 61 73 65 0a 20 20 20 20 20 20 2a 2a 20  tabase.      ** 
25070 63 6f 72 72 75 70 74 69 6f 6e 20 64 75 72 69 6e  corruption durin
25080 67 20 74 68 65 20 6e 65 78 74 20 74 72 61 6e 73  g the next trans
25090 61 63 74 69 6f 6e 2e 0a 20 20 20 20 20 20 2a 2f  action..      */
250a0 0a 20 20 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20  .    }else{.    
250b0 20 20 50 41 47 45 52 54 52 41 43 45 33 28 22 44    PAGERTRACE3("D
250c0 4f 4e 54 5f 57 52 49 54 45 20 70 61 67 65 20 25  ONT_WRITE page %
250d0 64 20 6f 66 20 25 64 5c 6e 22 2c 20 70 50 67 2d  d of %d\n", pPg-
250e0 3e 70 67 6e 6f 2c 20 50 41 47 45 52 49 44 28 70  >pgno, PAGERID(p
250f0 50 61 67 65 72 29 29 3b 0a 20 20 20 20 20 20 49  Pager));.      I
25100 4f 54 52 41 43 45 28 28 22 43 4c 45 41 4e 20 25  OTRACE(("CLEAN %
25110 70 20 25 64 5c 6e 22 2c 20 70 50 61 67 65 72 2c  p %d\n", pPager,
25120 20 70 50 67 2d 3e 70 67 6e 6f 29 29 0a 20 20 20   pPg->pgno)).   
25130 20 20 20 6d 61 6b 65 43 6c 65 61 6e 28 70 50 67     makeClean(pPg
25140 29 3b 0a 23 69 66 64 65 66 20 53 51 4c 49 54 45  );.#ifdef SQLITE
25150 5f 43 48 45 43 4b 5f 50 41 47 45 53 0a 20 20 20  _CHECK_PAGES.   
25160 20 20 20 70 50 67 2d 3e 70 61 67 65 48 61 73 68     pPg->pageHash
25170 20 3d 20 70 61 67 65 72 5f 70 61 67 65 68 61 73   = pager_pagehas
25180 68 28 70 50 67 29 3b 0a 23 65 6e 64 69 66 0a 20  h(pPg);.#endif. 
25190 20 20 20 7d 0a 20 20 7d 0a 20 20 70 61 67 65 72     }.  }.  pager
251a0 4c 65 61 76 65 28 70 50 61 67 65 72 29 3b 0a 7d  Leave(pPager);.}
251b0 0a 0a 2f 2a 0a 2a 2a 20 41 20 63 61 6c 6c 20 74  ../*.** A call t
251c0 6f 20 74 68 69 73 20 72 6f 75 74 69 6e 65 20 74  o this routine t
251d0 65 6c 6c 73 20 74 68 65 20 70 61 67 65 72 20 74  ells the pager t
251e0 68 61 74 20 69 66 20 61 20 72 6f 6c 6c 62 61 63  hat if a rollbac
251f0 6b 20 6f 63 63 75 72 73 2c 0a 2a 2a 20 69 74 20  k occurs,.** it 
25200 69 73 20 6e 6f 74 20 6e 65 63 65 73 73 61 72 79  is not necessary
25210 20 74 6f 20 72 65 73 74 6f 72 65 20 74 68 65 20   to restore the 
25220 64 61 74 61 20 6f 6e 20 74 68 65 20 67 69 76 65  data on the give
25230 6e 20 70 61 67 65 2e 20 20 54 68 69 73 0a 2a 2a  n page.  This.**
25240 20 6d 65 61 6e 73 20 74 68 61 74 20 74 68 65 20   means that the 
25250 70 61 67 65 72 20 64 6f 65 73 20 6e 6f 74 20 68  pager does not h
25260 61 76 65 20 74 6f 20 72 65 63 6f 72 64 20 74 68  ave to record th
25270 65 20 67 69 76 65 6e 20 70 61 67 65 20 69 6e 20  e given page in 
25280 74 68 65 0a 2a 2a 20 72 6f 6c 6c 62 61 63 6b 20  the.** rollback 
25290 6a 6f 75 72 6e 61 6c 2e 0a 2a 2a 0a 2a 2a 20 49  journal..**.** I
252a0 66 20 77 65 20 68 61 76 65 20 6e 6f 74 20 79 65  f we have not ye
252b0 74 20 61 63 74 75 61 6c 6c 79 20 72 65 61 64 20  t actually read 
252c0 74 68 65 20 63 6f 6e 74 65 6e 74 20 6f 66 20 74  the content of t
252d0 68 69 73 20 70 61 67 65 20 28 69 66 0a 2a 2a 20  his page (if.** 
252e0 74 68 65 20 50 67 48 64 72 2e 6e 65 65 64 52 65  the PgHdr.needRe
252f0 61 64 20 66 6c 61 67 20 69 73 20 73 65 74 29 20  ad flag is set) 
25300 74 68 65 6e 20 74 68 69 73 20 72 6f 75 74 69 6e  then this routin
25310 65 20 61 63 74 73 20 61 73 20 61 20 70 72 6f 6d  e acts as a prom
25320 69 73 65 0a 2a 2a 20 74 68 61 74 20 77 65 20 77  ise.** that we w
25330 69 6c 6c 20 6e 65 76 65 72 20 6e 65 65 64 20 74  ill never need t
25340 6f 20 72 65 61 64 20 74 68 65 20 70 61 67 65 20  o read the page 
25350 63 6f 6e 74 65 6e 74 20 69 6e 20 74 68 65 20 66  content in the f
25360 75 74 75 72 65 2e 0a 2a 2a 20 73 6f 20 74 68 65  uture..** so the
25370 20 6e 65 65 64 52 65 61 64 20 66 6c 61 67 20 63   needRead flag c
25380 61 6e 20 62 65 20 63 6c 65 61 72 65 64 20 61 74  an be cleared at
25390 20 74 68 69 73 20 70 6f 69 6e 74 2e 0a 2a 2f 0a   this point..*/.
253a0 76 6f 69 64 20 73 71 6c 69 74 65 33 50 61 67 65  void sqlite3Page
253b0 72 44 6f 6e 74 52 6f 6c 6c 62 61 63 6b 28 44 62  rDontRollback(Db
253c0 50 61 67 65 20 2a 70 50 67 29 7b 0a 20 20 50 61  Page *pPg){.  Pa
253d0 67 65 72 20 2a 70 50 61 67 65 72 20 3d 20 70 50  ger *pPager = pP
253e0 67 2d 3e 70 50 61 67 65 72 3b 0a 0a 20 20 70 61  g->pPager;..  pa
253f0 67 65 72 45 6e 74 65 72 28 70 50 61 67 65 72 29  gerEnter(pPager)
25400 3b 0a 20 20 61 73 73 65 72 74 28 20 70 50 61 67  ;.  assert( pPag
25410 65 72 2d 3e 73 74 61 74 65 3e 3d 50 41 47 45 52  er->state>=PAGER
25420 5f 52 45 53 45 52 56 45 44 20 29 3b 0a 0a 20 20  _RESERVED );..  
25430 2f 2a 20 49 66 20 74 68 65 20 6a 6f 75 72 6e 61  /* If the journa
25440 6c 20 66 69 6c 65 20 69 73 20 6e 6f 74 20 6f 70  l file is not op
25450 65 6e 2c 20 6f 72 20 44 6f 6e 74 57 72 69 74 65  en, or DontWrite
25460 28 29 20 68 61 73 20 62 65 65 6e 20 63 61 6c 6c  () has been call
25470 65 64 20 6f 6e 0a 20 20 2a 2a 20 74 68 69 73 20  ed on.  ** this 
25480 70 61 67 65 20 28 44 6f 6e 74 57 72 69 74 65 28  page (DontWrite(
25490 29 20 73 65 74 73 20 74 68 65 20 61 6c 77 61 79  ) sets the alway
254a0 73 52 6f 6c 6c 62 61 63 6b 20 66 6c 61 67 29 2c  sRollback flag),
254b0 20 74 68 65 6e 20 74 68 69 73 0a 20 20 2a 2a 20   then this.  ** 
254c0 66 75 6e 63 74 69 6f 6e 20 69 73 20 61 20 6e 6f  function is a no
254d0 2d 6f 70 2e 0a 20 20 2a 2f 0a 20 20 69 66 28 20  -op..  */.  if( 
254e0 70 50 61 67 65 72 2d 3e 6a 6f 75 72 6e 61 6c 4f  pPager->journalO
254f0 70 65 6e 3d 3d 30 20 7c 7c 20 70 50 67 2d 3e 61  pen==0 || pPg->a
25500 6c 77 61 79 73 52 6f 6c 6c 62 61 63 6b 20 7c 7c  lwaysRollback ||
25510 20 70 50 61 67 65 72 2d 3e 61 6c 77 61 79 73 52   pPager->alwaysR
25520 6f 6c 6c 62 61 63 6b 20 29 7b 0a 20 20 20 20 70  ollback ){.    p
25530 61 67 65 72 4c 65 61 76 65 28 70 50 61 67 65 72  agerLeave(pPager
25540 29 3b 0a 20 20 20 20 72 65 74 75 72 6e 3b 0a 20  );.    return;. 
25550 20 7d 0a 20 20 61 73 73 65 72 74 28 20 21 4d 45   }.  assert( !ME
25560 4d 44 42 20 29 3b 20 20 20 20 2f 2a 20 46 6f 72  MDB );    /* For
25570 20 61 20 6d 65 6d 64 62 2c 20 70 50 61 67 65 72   a memdb, pPager
25580 2d 3e 6a 6f 75 72 6e 61 6c 4f 70 65 6e 20 69 73  ->journalOpen is
25590 20 61 6c 77 61 79 73 20 30 20 2a 2f 0a 0a 23 69   always 0 */..#i
255a0 66 64 65 66 20 53 51 4c 49 54 45 5f 53 45 43 55  fdef SQLITE_SECU
255b0 52 45 5f 44 45 4c 45 54 45 0a 20 20 69 66 28 20  RE_DELETE.  if( 
255c0 70 50 67 2d 3e 69 6e 4a 6f 75 72 6e 61 6c 20 7c  pPg->inJournal |
255d0 7c 20 28 69 6e 74 29 70 50 67 2d 3e 70 67 6e 6f  | (int)pPg->pgno
255e0 20 3e 20 70 50 61 67 65 72 2d 3e 6f 72 69 67 44   > pPager->origD
255f0 62 53 69 7a 65 20 29 7b 0a 20 20 20 20 72 65 74  bSize ){.    ret
25600 75 72 6e 3b 0a 20 20 7d 0a 23 65 6e 64 69 66 0a  urn;.  }.#endif.
25610 0a 20 20 2f 2a 20 49 66 20 53 45 43 55 52 45 5f  .  /* If SECURE_
25620 44 45 4c 45 54 45 20 69 73 20 64 69 73 61 62 6c  DELETE is disabl
25630 65 64 2c 20 74 68 65 6e 20 74 68 65 72 65 20 69  ed, then there i
25640 73 20 6e 6f 20 77 61 79 20 74 68 61 74 20 74 68  s no way that th
25650 69 73 0a 20 20 2a 2a 20 72 6f 75 74 69 6e 65 20  is.  ** routine 
25660 63 61 6e 20 62 65 20 63 61 6c 6c 65 64 20 6f 6e  can be called on
25670 20 61 20 70 61 67 65 20 66 6f 72 20 77 68 69 63   a page for whic
25680 68 20 73 71 6c 69 74 65 33 50 61 67 65 72 44 6f  h sqlite3PagerDo
25690 6e 74 57 72 69 74 65 28 29 0a 20 20 2a 2a 20 68  ntWrite().  ** h
256a0 61 73 20 6e 6f 74 20 62 65 65 6e 20 70 72 65 76  as not been prev
256b0 69 6f 75 73 6c 79 20 63 61 6c 6c 65 64 20 64 75  iously called du
256c0 72 69 6e 67 20 74 68 65 20 73 61 6d 65 20 74 72  ring the same tr
256d0 61 6e 73 61 63 74 69 6f 6e 2e 0a 20 20 2a 2a 20  ansaction..  ** 
256e0 41 6e 64 20 69 66 20 44 6f 6e 74 57 72 69 74 65  And if DontWrite
256f0 28 29 20 68 61 73 20 70 72 65 76 69 6f 75 73 6c  () has previousl
25700 79 20 62 65 65 6e 20 63 61 6c 6c 65 64 2c 20 74  y been called, t
25710 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 0a 20 20 2a  he following.  *
25720 2a 20 63 6f 6e 64 69 74 69 6f 6e 73 20 6d 75 73  * conditions mus
25730 74 20 62 65 20 6d 65 74 2e 0a 20 20 2a 2f 0a 20  t be met..  */. 
25740 20 61 73 73 65 72 74 28 20 21 70 50 67 2d 3e 69   assert( !pPg->i
25750 6e 4a 6f 75 72 6e 61 6c 20 26 26 20 28 69 6e 74  nJournal && (int
25760 29 70 50 67 2d 3e 70 67 6e 6f 20 3c 3d 20 70 50  )pPg->pgno <= pP
25770 61 67 65 72 2d 3e 6f 72 69 67 44 62 53 69 7a 65  ager->origDbSize
25780 20 29 3b 0a 0a 20 20 61 73 73 65 72 74 28 20 70   );..  assert( p
25790 50 61 67 65 72 2d 3e 70 49 6e 4a 6f 75 72 6e 61  Pager->pInJourna
257a0 6c 21 3d 30 20 29 3b 0a 20 20 73 71 6c 69 74 65  l!=0 );.  sqlite
257b0 33 42 69 74 76 65 63 53 65 74 28 70 50 61 67 65  3BitvecSet(pPage
257c0 72 2d 3e 70 49 6e 4a 6f 75 72 6e 61 6c 2c 20 70  r->pInJournal, p
257d0 50 67 2d 3e 70 67 6e 6f 29 3b 0a 20 20 70 50 67  Pg->pgno);.  pPg
257e0 2d 3e 69 6e 4a 6f 75 72 6e 61 6c 20 3d 20 31 3b  ->inJournal = 1;
257f0 0a 20 20 70 50 67 2d 3e 6e 65 65 64 52 65 61 64  .  pPg->needRead
25800 20 3d 20 30 3b 0a 20 20 69 66 28 20 70 50 61 67   = 0;.  if( pPag
25810 65 72 2d 3e 73 74 6d 74 49 6e 55 73 65 20 29 7b  er->stmtInUse ){
25820 0a 20 20 20 20 61 73 73 65 72 74 28 20 70 50 61  .    assert( pPa
25830 67 65 72 2d 3e 73 74 6d 74 53 69 7a 65 20 3e 3d  ger->stmtSize >=
25840 20 70 50 61 67 65 72 2d 3e 6f 72 69 67 44 62 53   pPager->origDbS
25850 69 7a 65 20 29 3b 0a 20 20 20 20 73 71 6c 69 74  ize );.    sqlit
25860 65 33 42 69 74 76 65 63 53 65 74 28 70 50 61 67  e3BitvecSet(pPag
25870 65 72 2d 3e 70 49 6e 53 74 6d 74 2c 20 70 50 67  er->pInStmt, pPg
25880 2d 3e 70 67 6e 6f 29 3b 0a 20 20 7d 0a 20 20 50  ->pgno);.  }.  P
25890 41 47 45 52 54 52 41 43 45 33 28 22 44 4f 4e 54  AGERTRACE3("DONT
258a0 5f 52 4f 4c 4c 42 41 43 4b 20 70 61 67 65 20 25  _ROLLBACK page %
258b0 64 20 6f 66 20 25 64 5c 6e 22 2c 20 70 50 67 2d  d of %d\n", pPg-
258c0 3e 70 67 6e 6f 2c 20 50 41 47 45 52 49 44 28 70  >pgno, PAGERID(p
258d0 50 61 67 65 72 29 29 3b 0a 20 20 49 4f 54 52 41  Pager));.  IOTRA
258e0 43 45 28 28 22 47 41 52 42 41 47 45 20 25 70 20  CE(("GARBAGE %p 
258f0 25 64 5c 6e 22 2c 20 70 50 61 67 65 72 2c 20 70  %d\n", pPager, p
25900 50 67 2d 3e 70 67 6e 6f 29 29 0a 20 20 70 61 67  Pg->pgno)).  pag
25910 65 72 4c 65 61 76 65 28 70 50 61 67 65 72 29 3b  erLeave(pPager);
25920 0a 7d 0a 0a 0a 2f 2a 0a 2a 2a 20 54 68 69 73 20  .}.../*.** This 
25930 72 6f 75 74 69 6e 65 20 69 73 20 63 61 6c 6c 65  routine is calle
25940 64 20 74 6f 20 69 6e 63 72 65 6d 65 6e 74 20 74  d to increment t
25950 68 65 20 64 61 74 61 62 61 73 65 20 66 69 6c 65  he database file
25960 20 63 68 61 6e 67 65 2d 63 6f 75 6e 74 65 72 2c   change-counter,
25970 0a 2a 2a 20 73 74 6f 72 65 64 20 61 74 20 62 79  .** stored at by
25980 74 65 20 32 34 20 6f 66 20 74 68 65 20 70 61 67  te 24 of the pag
25990 65 72 20 66 69 6c 65 2e 0a 2a 2f 0a 73 74 61 74  er file..*/.stat
259a0 69 63 20 69 6e 74 20 70 61 67 65 72 5f 69 6e 63  ic int pager_inc
259b0 72 5f 63 68 61 6e 67 65 63 6f 75 6e 74 65 72 28  r_changecounter(
259c0 50 61 67 65 72 20 2a 70 50 61 67 65 72 2c 20 69  Pager *pPager, i
259d0 6e 74 20 69 73 44 69 72 65 63 74 29 7b 0a 20 20  nt isDirect){.  
259e0 50 67 48 64 72 20 2a 70 50 67 48 64 72 3b 0a 20  PgHdr *pPgHdr;. 
259f0 20 75 33 32 20 63 68 61 6e 67 65 5f 63 6f 75 6e   u32 change_coun
25a00 74 65 72 3b 0a 20 20 69 6e 74 20 72 63 20 3d 20  ter;.  int rc = 
25a10 53 51 4c 49 54 45 5f 4f 4b 3b 0a 0a 20 20 69 66  SQLITE_OK;..  if
25a20 28 20 21 70 50 61 67 65 72 2d 3e 63 68 61 6e 67  ( !pPager->chang
25a30 65 43 6f 75 6e 74 44 6f 6e 65 20 29 7b 0a 20 20  eCountDone ){.  
25a40 20 20 2f 2a 20 4f 70 65 6e 20 70 61 67 65 20 31    /* Open page 1
25a50 20 6f 66 20 74 68 65 20 66 69 6c 65 20 66 6f 72   of the file for
25a60 20 77 72 69 74 69 6e 67 2e 20 2a 2f 0a 20 20 20   writing. */.   
25a70 20 72 63 20 3d 20 73 71 6c 69 74 65 33 50 61 67   rc = sqlite3Pag
25a80 65 72 47 65 74 28 70 50 61 67 65 72 2c 20 31 2c  erGet(pPager, 1,
25a90 20 26 70 50 67 48 64 72 29 3b 0a 20 20 20 20 69   &pPgHdr);.    i
25aa0 66 28 20 72 63 21 3d 53 51 4c 49 54 45 5f 4f 4b  f( rc!=SQLITE_OK
25ab0 20 29 20 72 65 74 75 72 6e 20 72 63 3b 0a 0a 20   ) return rc;.. 
25ac0 20 20 20 69 66 28 20 21 69 73 44 69 72 65 63 74     if( !isDirect
25ad0 20 29 7b 0a 20 20 20 20 20 20 72 63 20 3d 20 73   ){.      rc = s
25ae0 71 6c 69 74 65 33 50 61 67 65 72 57 72 69 74 65  qlite3PagerWrite
25af0 28 70 50 67 48 64 72 29 3b 0a 20 20 20 20 20 20  (pPgHdr);.      
25b00 69 66 28 20 72 63 21 3d 53 51 4c 49 54 45 5f 4f  if( rc!=SQLITE_O
25b10 4b 20 29 7b 0a 20 20 20 20 20 20 20 20 73 71 6c  K ){.        sql
25b20 69 74 65 33 50 61 67 65 72 55 6e 72 65 66 28 70  ite3PagerUnref(p
25b30 50 67 48 64 72 29 3b 0a 20 20 20 20 20 20 20 20  PgHdr);.        
25b40 72 65 74 75 72 6e 20 72 63 3b 0a 20 20 20 20 20  return rc;.     
25b50 20 7d 0a 20 20 20 20 7d 0a 0a 20 20 20 20 2f 2a   }.    }..    /*
25b60 20 49 6e 63 72 65 6d 65 6e 74 20 74 68 65 20 76   Increment the v
25b70 61 6c 75 65 20 6a 75 73 74 20 72 65 61 64 20 61  alue just read a
25b80 6e 64 20 77 72 69 74 65 20 69 74 20 62 61 63 6b  nd write it back
25b90 20 74 6f 20 62 79 74 65 20 32 34 2e 20 2a 2f 0a   to byte 24. */.
25ba0 20 20 20 20 63 68 61 6e 67 65 5f 63 6f 75 6e 74      change_count
25bb0 65 72 20 3d 20 73 71 6c 69 74 65 33 47 65 74 34  er = sqlite3Get4
25bc0 62 79 74 65 28 28 75 38 2a 29 70 50 61 67 65 72  byte((u8*)pPager
25bd0 2d 3e 64 62 46 69 6c 65 56 65 72 73 29 3b 0a 20  ->dbFileVers);. 
25be0 20 20 20 63 68 61 6e 67 65 5f 63 6f 75 6e 74 65     change_counte
25bf0 72 2b 2b 3b 0a 20 20 20 20 70 75 74 33 32 62 69  r++;.    put32bi
25c00 74 73 28 28 28 63 68 61 72 2a 29 50 47 48 44 52  ts(((char*)PGHDR
25c10 5f 54 4f 5f 44 41 54 41 28 70 50 67 48 64 72 29  _TO_DATA(pPgHdr)
25c20 29 2b 32 34 2c 20 63 68 61 6e 67 65 5f 63 6f 75  )+24, change_cou
25c30 6e 74 65 72 29 3b 0a 0a 20 20 20 20 69 66 28 20  nter);..    if( 
25c40 69 73 44 69 72 65 63 74 20 26 26 20 70 50 61 67  isDirect && pPag
25c50 65 72 2d 3e 66 64 2d 3e 70 4d 65 74 68 6f 64 73  er->fd->pMethods
25c60 20 29 7b 0a 20 20 20 20 20 20 63 6f 6e 73 74 20   ){.      const 
25c70 76 6f 69 64 20 2a 7a 42 75 66 20 3d 20 50 47 48  void *zBuf = PGH
25c80 44 52 5f 54 4f 5f 44 41 54 41 28 70 50 67 48 64  DR_TO_DATA(pPgHd
25c90 72 29 3b 0a 20 20 20 20 20 20 72 63 20 3d 20 73  r);.      rc = s
25ca0 71 6c 69 74 65 33 4f 73 57 72 69 74 65 28 70 50  qlite3OsWrite(pP
25cb0 61 67 65 72 2d 3e 66 64 2c 20 7a 42 75 66 2c 20  ager->fd, zBuf, 
25cc0 70 50 61 67 65 72 2d 3e 70 61 67 65 53 69 7a 65  pPager->pageSize
25cd0 2c 20 30 29 3b 0a 20 20 20 20 7d 0a 0a 20 20 20  , 0);.    }..   
25ce0 20 2f 2a 20 52 65 6c 65 61 73 65 20 74 68 65 20   /* Release the 
25cf0 70 61 67 65 20 72 65 66 65 72 65 6e 63 65 2e 20  page reference. 
25d00 2a 2f 0a 20 20 20 20 73 71 6c 69 74 65 33 50 61  */.    sqlite3Pa
25d10 67 65 72 55 6e 72 65 66 28 70 50 67 48 64 72 29  gerUnref(pPgHdr)
25d20 3b 0a 20 20 20 20 70 50 61 67 65 72 2d 3e 63 68  ;.    pPager->ch
25d30 61 6e 67 65 43 6f 75 6e 74 44 6f 6e 65 20 3d 20  angeCountDone = 
25d40 31 3b 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e 20  1;.  }.  return 
25d50 72 63 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 53 79 6e  rc;.}../*.** Syn
25d60 63 20 74 68 65 20 70 61 67 65 72 20 66 69 6c 65  c the pager file
25d70 20 74 6f 20 64 69 73 6b 2e 0a 2a 2f 0a 69 6e 74   to disk..*/.int
25d80 20 73 71 6c 69 74 65 33 50 61 67 65 72 53 79 6e   sqlite3PagerSyn
25d90 63 28 50 61 67 65 72 20 2a 70 50 61 67 65 72 29  c(Pager *pPager)
25da0 7b 0a 20 20 69 6e 74 20 72 63 3b 0a 20 20 70 61  {.  int rc;.  pa
25db0 67 65 72 45 6e 74 65 72 28 70 50 61 67 65 72 29  gerEnter(pPager)
25dc0 3b 0a 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33  ;.  rc = sqlite3
25dd0 4f 73 53 79 6e 63 28 70 50 61 67 65 72 2d 3e 66  OsSync(pPager->f
25de0 64 2c 20 70 50 61 67 65 72 2d 3e 73 79 6e 63 5f  d, pPager->sync_
25df0 66 6c 61 67 73 29 3b 0a 20 20 70 61 67 65 72 4c  flags);.  pagerL
25e00 65 61 76 65 28 70 50 61 67 65 72 29 3b 0a 20 20  eave(pPager);.  
25e10 72 65 74 75 72 6e 20 72 63 3b 0a 7d 0a 0a 2f 2a  return rc;.}../*
25e20 0a 2a 2a 20 53 79 6e 63 20 74 68 65 20 64 61 74  .** Sync the dat
25e30 61 62 61 73 65 20 66 69 6c 65 20 66 6f 72 20 74  abase file for t
25e40 68 65 20 70 61 67 65 72 20 70 50 61 67 65 72 2e  he pager pPager.
25e50 20 7a 4d 61 73 74 65 72 20 70 6f 69 6e 74 73 20   zMaster points 
25e60 74 6f 20 74 68 65 20 6e 61 6d 65 0a 2a 2a 20 6f  to the name.** o
25e70 66 20 61 20 6d 61 73 74 65 72 20 6a 6f 75 72 6e  f a master journ
25e80 61 6c 20 66 69 6c 65 20 74 68 61 74 20 73 68 6f  al file that sho
25e90 75 6c 64 20 62 65 20 77 72 69 74 74 65 6e 20 69  uld be written i
25ea0 6e 74 6f 20 74 68 65 20 69 6e 64 69 76 69 64 75  nto the individu
25eb0 61 6c 0a 2a 2a 20 6a 6f 75 72 6e 61 6c 20 66 69  al.** journal fi
25ec0 6c 65 2e 20 7a 4d 61 73 74 65 72 20 6d 61 79 20  le. zMaster may 
25ed0 62 65 20 4e 55 4c 4c 2c 20 77 68 69 63 68 20 69  be NULL, which i
25ee0 73 20 69 6e 74 65 72 70 72 65 74 65 64 20 61 73  s interpreted as
25ef0 20 6e 6f 20 6d 61 73 74 65 72 0a 2a 2a 20 6a 6f   no master.** jo
25f00 75 72 6e 61 6c 20 28 61 20 73 69 6e 67 6c 65 20  urnal (a single 
25f10 64 61 74 61 62 61 73 65 20 74 72 61 6e 73 61 63  database transac
25f20 74 69 6f 6e 29 2e 0a 2a 2a 0a 2a 2a 20 54 68 69  tion)..**.** Thi
25f30 73 20 72 6f 75 74 69 6e 65 20 65 6e 73 75 72 65  s routine ensure
25f40 73 20 74 68 61 74 20 74 68 65 20 6a 6f 75 72 6e  s that the journ
25f50 61 6c 20 69 73 20 73 79 6e 63 65 64 2c 20 61 6c  al is synced, al
25f60 6c 20 64 69 72 74 79 20 70 61 67 65 73 20 77 72  l dirty pages wr
25f70 69 74 74 65 6e 0a 2a 2a 20 74 6f 20 74 68 65 20  itten.** to the 
25f80 64 61 74 61 62 61 73 65 20 66 69 6c 65 20 61 6e  database file an
25f90 64 20 74 68 65 20 64 61 74 61 62 61 73 65 20 66  d the database f
25fa0 69 6c 65 20 73 79 6e 63 65 64 2e 20 54 68 65 20  ile synced. The 
25fb0 6f 6e 6c 79 20 74 68 69 6e 67 20 74 68 61 74 0a  only thing that.
25fc0 2a 2a 20 72 65 6d 61 69 6e 73 20 74 6f 20 63 6f  ** remains to co
25fd0 6d 6d 69 74 20 74 68 65 20 74 72 61 6e 73 61 63  mmit the transac
25fe0 74 69 6f 6e 20 69 73 20 74 6f 20 64 65 6c 65 74  tion is to delet
25ff0 65 20 74 68 65 20 6a 6f 75 72 6e 61 6c 20 66 69  e the journal fi
26000 6c 65 20 28 6f 72 0a 2a 2a 20 6d 61 73 74 65 72  le (or.** master
26010 20 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 20 69 66   journal file if
26020 20 73 70 65 63 69 66 69 65 64 29 2e 0a 2a 2a 0a   specified)..**.
26030 2a 2a 20 4e 6f 74 65 20 74 68 61 74 20 69 66 20  ** Note that if 
26040 7a 4d 61 73 74 65 72 3d 3d 4e 55 4c 4c 2c 20 74  zMaster==NULL, t
26050 68 69 73 20 64 6f 65 73 20 6e 6f 74 20 6f 76 65  his does not ove
26060 72 77 72 69 74 65 20 61 20 70 72 65 76 69 6f 75  rwrite a previou
26070 73 20 76 61 6c 75 65 0a 2a 2a 20 70 61 73 73 65  s value.** passe
26080 64 20 74 6f 20 61 6e 20 73 71 6c 69 74 65 33 50  d to an sqlite3P
26090 61 67 65 72 43 6f 6d 6d 69 74 50 68 61 73 65 4f  agerCommitPhaseO
260a0 6e 65 28 29 20 63 61 6c 6c 2e 0a 2a 2a 0a 2a 2a  ne() call..**.**
260b0 20 49 66 20 70 61 72 61 6d 65 74 65 72 20 6e 54   If parameter nT
260c0 72 75 6e 63 20 69 73 20 6e 6f 6e 2d 7a 65 72 6f  runc is non-zero
260d0 2c 20 74 68 65 6e 20 74 68 65 20 70 61 67 65 72  , then the pager
260e0 20 66 69 6c 65 20 69 73 20 74 72 75 6e 63 61 74   file is truncat
260f0 65 64 20 74 6f 0a 2a 2a 20 6e 54 72 75 6e 63 20  ed to.** nTrunc 
26100 70 61 67 65 73 20 28 74 68 69 73 20 69 73 20 75  pages (this is u
26110 73 65 64 20 62 79 20 61 75 74 6f 2d 76 61 63 75  sed by auto-vacu
26120 75 6d 20 64 61 74 61 62 61 73 65 73 29 2e 0a 2a  um databases)..*
26130 2a 0a 2a 2a 20 49 66 20 74 68 65 20 66 69 6e 61  *.** If the fina
26140 6c 20 70 61 72 61 6d 65 74 65 72 20 2d 20 6e 6f  l parameter - no
26150 53 79 6e 63 20 2d 20 69 73 20 74 72 75 65 2c 20  Sync - is true, 
26160 74 68 65 6e 20 74 68 65 20 64 61 74 61 62 61 73  then the databas
26170 65 20 66 69 6c 65 20 69 74 73 65 6c 66 0a 2a 2a  e file itself.**
26180 20 69 73 20 6e 6f 74 20 73 79 6e 63 65 64 2e 20   is not synced. 
26190 54 68 65 20 63 61 6c 6c 65 72 20 6d 75 73 74 20  The caller must 
261a0 63 61 6c 6c 20 73 71 6c 69 74 65 33 50 61 67 65  call sqlite3Page
261b0 72 53 79 6e 63 28 29 20 64 69 72 65 63 74 6c 79  rSync() directly
261c0 20 74 6f 0a 2a 2a 20 73 79 6e 63 20 74 68 65 20   to.** sync the 
261d0 64 61 74 61 62 61 73 65 20 66 69 6c 65 20 62 65  database file be
261e0 66 6f 72 65 20 63 61 6c 6c 69 6e 67 20 43 6f 6d  fore calling Com
261f0 6d 69 74 50 68 61 73 65 54 77 6f 28 29 20 74 6f  mitPhaseTwo() to
26200 20 64 65 6c 65 74 65 20 74 68 65 0a 2a 2a 20 6a   delete the.** j
26210 6f 75 72 6e 61 6c 20 66 69 6c 65 20 69 6e 20 74  ournal file in t
26220 68 69 73 20 63 61 73 65 2e 0a 2a 2f 0a 69 6e 74  his case..*/.int
26230 20 73 71 6c 69 74 65 33 50 61 67 65 72 43 6f 6d   sqlite3PagerCom
26240 6d 69 74 50 68 61 73 65 4f 6e 65 28 0a 20 20 50  mitPhaseOne(.  P
26250 61 67 65 72 20 2a 70 50 61 67 65 72 2c 20 0a 20  ager *pPager, . 
26260 20 63 6f 6e 73 74 20 63 68 61 72 20 2a 7a 4d 61   const char *zMa
26270 73 74 65 72 2c 20 0a 20 20 50 67 6e 6f 20 6e 54  ster, .  Pgno nT
26280 72 75 6e 63 2c 0a 20 20 69 6e 74 20 6e 6f 53 79  runc,.  int noSy
26290 6e 63 0a 29 7b 0a 20 20 69 6e 74 20 72 63 20 3d  nc.){.  int rc =
262a0 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 0a 20 20 50   SQLITE_OK;..  P
262b0 41 47 45 52 54 52 41 43 45 34 28 22 44 41 54 41  AGERTRACE4("DATA
262c0 42 41 53 45 20 53 59 4e 43 3a 20 46 69 6c 65 3d  BASE SYNC: File=
262d0 25 73 20 7a 4d 61 73 74 65 72 3d 25 73 20 6e 54  %s zMaster=%s nT
262e0 72 75 6e 63 3d 25 64 5c 6e 22 2c 20 0a 20 20 20  runc=%d\n", .   
262f0 20 20 20 70 50 61 67 65 72 2d 3e 7a 46 69 6c 65     pPager->zFile
26300 6e 61 6d 65 2c 20 7a 4d 61 73 74 65 72 2c 20 6e  name, zMaster, n
26310 54 72 75 6e 63 29 3b 0a 20 20 70 61 67 65 72 45  Trunc);.  pagerE
26320 6e 74 65 72 28 70 50 61 67 65 72 29 3b 0a 0a 20  nter(pPager);.. 
26330 20 2f 2a 20 49 66 20 74 68 69 73 20 69 73 20 61   /* If this is a
26340 6e 20 69 6e 2d 6d 65 6d 6f 72 79 20 64 62 2c 20  n in-memory db, 
26350 6f 72 20 6e 6f 20 70 61 67 65 73 20 68 61 76 65  or no pages have
26360 20 62 65 65 6e 20 77 72 69 74 74 65 6e 20 74 6f   been written to
26370 2c 20 6f 72 20 74 68 69 73 0a 20 20 2a 2a 20 66  , or this.  ** f
26380 75 6e 63 74 69 6f 6e 20 68 61 73 20 61 6c 72 65  unction has alre
26390 61 64 79 20 62 65 65 6e 20 63 61 6c 6c 65 64 2c  ady been called,
263a0 20 69 74 20 69 73 20 61 20 6e 6f 2d 6f 70 2e 0a   it is a no-op..
263b0 20 20 2a 2f 0a 20 20 69 66 28 20 70 50 61 67 65    */.  if( pPage
263c0 72 2d 3e 73 74 61 74 65 21 3d 50 41 47 45 52 5f  r->state!=PAGER_
263d0 53 59 4e 43 45 44 20 26 26 20 21 4d 45 4d 44 42  SYNCED && !MEMDB
263e0 20 26 26 20 70 50 61 67 65 72 2d 3e 64 69 72 74   && pPager->dirt
263f0 79 43 61 63 68 65 20 29 7b 0a 20 20 20 20 50 67  yCache ){.    Pg
26400 48 64 72 20 2a 70 50 67 3b 0a 0a 23 69 66 64 65  Hdr *pPg;..#ifde
26410 66 20 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45 5f  f SQLITE_ENABLE_
26420 41 54 4f 4d 49 43 5f 57 52 49 54 45 0a 20 20 20  ATOMIC_WRITE.   
26430 20 2f 2a 20 54 68 65 20 61 74 6f 6d 69 63 2d 77   /* The atomic-w
26440 72 69 74 65 20 6f 70 74 69 6d 69 7a 61 74 69 6f  rite optimizatio
26450 6e 20 63 61 6e 20 62 65 20 75 73 65 64 20 69 66  n can be used if
26460 20 61 6c 6c 20 6f 66 20 74 68 65 0a 20 20 20 20   all of the.    
26470 2a 2a 20 66 6f 6c 6c 6f 77 69 6e 67 20 61 72 65  ** following are
26480 20 74 72 75 65 3a 0a 20 20 20 20 2a 2a 0a 20 20   true:.    **.  
26490 20 20 2a 2a 20 20 20 20 2b 20 54 68 65 20 66 69    **    + The fi
264a0 6c 65 2d 73 79 73 74 65 6d 20 73 75 70 70 6f 72  le-system suppor
264b0 74 73 20 74 68 65 20 61 74 6f 6d 69 63 2d 77 72  ts the atomic-wr
264c0 69 74 65 20 70 72 6f 70 65 72 74 79 20 66 6f 72  ite property for
264d0 0a 20 20 20 20 2a 2a 20 20 20 20 20 20 62 6c 6f  .    **      blo
264e0 63 6b 73 20 6f 66 20 73 69 7a 65 20 70 61 67 65  cks of size page
264f0 2d 73 69 7a 65 2c 20 61 6e 64 0a 20 20 20 20 2a  -size, and.    *
26500 2a 20 20 20 20 2b 20 54 68 69 73 20 63 6f 6d 6d  *    + This comm
26510 69 74 20 69 73 20 6e 6f 74 20 70 61 72 74 20 6f  it is not part o
26520 66 20 61 20 6d 75 6c 74 69 2d 66 69 6c 65 20 74  f a multi-file t
26530 72 61 6e 73 61 63 74 69 6f 6e 2c 20 61 6e 64 0a  ransaction, and.
26540 20 20 20 20 2a 2a 20 20 20 20 2b 20 45 78 61 63      **    + Exac
26550 74 6c 79 20 6f 6e 65 20 70 61 67 65 20 68 61 73  tly one page has
26560 20 62 65 65 6e 20 6d 6f 64 69 66 69 65 64 20 61   been modified a
26570 6e 64 20 73 74 6f 72 65 20 69 6e 20 74 68 65 20  nd store in the 
26580 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 2e 0a 20 20  journal file..  
26590 20 20 2a 2a 0a 20 20 20 20 2a 2a 20 49 66 20 74    **.    ** If t
265a0 68 65 20 6f 70 74 69 6d 69 7a 61 74 69 6f 6e 20  he optimization 
265b0 63 61 6e 20 62 65 20 75 73 65 64 2c 20 74 68 65  can be used, the
265c0 6e 20 74 68 65 20 6a 6f 75 72 6e 61 6c 20 66 69  n the journal fi
265d0 6c 65 20 77 69 6c 6c 20 6e 65 76 65 72 0a 20 20  le will never.  
265e0 20 20 2a 2a 20 62 65 20 63 72 65 61 74 65 64 20    ** be created 
265f0 66 6f 72 20 74 68 69 73 20 74 72 61 6e 73 61 63  for this transac
26600 74 69 6f 6e 2e 0a 20 20 20 20 2a 2f 0a 20 20 20  tion..    */.   
26610 20 69 6e 74 20 75 73 65 41 74 6f 6d 69 63 57 72   int useAtomicWr
26620 69 74 65 20 3d 20 28 0a 20 20 20 20 20 20 20 20  ite = (.        
26630 21 7a 4d 61 73 74 65 72 20 26 26 20 0a 20 20 20  !zMaster && .   
26640 20 20 20 20 20 70 50 61 67 65 72 2d 3e 6a 6f 75       pPager->jou
26650 72 6e 61 6c 4f 66 66 3d 3d 6a 72 6e 6c 42 75 66  rnalOff==jrnlBuf
26660 66 65 72 53 69 7a 65 28 70 50 61 67 65 72 29 20  ferSize(pPager) 
26670 26 26 20 0a 20 20 20 20 20 20 20 20 6e 54 72 75  && .        nTru
26680 6e 63 3d 3d 30 20 26 26 20 0a 20 20 20 20 20 20  nc==0 && .      
26690 20 20 28 30 3d 3d 70 50 61 67 65 72 2d 3e 70 44    (0==pPager->pD
266a0 69 72 74 79 20 7c 7c 20 30 3d 3d 70 50 61 67 65  irty || 0==pPage
266b0 72 2d 3e 70 44 69 72 74 79 2d 3e 70 44 69 72 74  r->pDirty->pDirt
266c0 79 29 0a 20 20 20 20 29 3b 0a 20 20 20 20 69 66  y).    );.    if
266d0 28 20 75 73 65 41 74 6f 6d 69 63 57 72 69 74 65  ( useAtomicWrite
266e0 20 29 7b 0a 20 20 20 20 20 20 2f 2a 20 55 70 64   ){.      /* Upd
266f0 61 74 65 20 74 68 65 20 6e 52 65 63 20 66 69 65  ate the nRec fie
26700 6c 64 20 69 6e 20 74 68 65 20 6a 6f 75 72 6e 61  ld in the journa
26710 6c 20 66 69 6c 65 2e 20 2a 2f 0a 20 20 20 20 20  l file. */.     
26720 20 69 6e 74 20 6f 66 66 73 65 74 20 3d 20 70 50   int offset = pP
26730 61 67 65 72 2d 3e 6a 6f 75 72 6e 61 6c 48 64 72  ager->journalHdr
26740 20 2b 20 73 69 7a 65 6f 66 28 61 4a 6f 75 72 6e   + sizeof(aJourn
26750 61 6c 4d 61 67 69 63 29 3b 0a 20 20 20 20 20 20  alMagic);.      
26760 61 73 73 65 72 74 28 70 50 61 67 65 72 2d 3e 6e  assert(pPager->n
26770 52 65 63 3d 3d 31 29 3b 0a 20 20 20 20 20 20 72  Rec==1);.      r
26780 63 20 3d 20 77 72 69 74 65 33 32 62 69 74 73 28  c = write32bits(
26790 70 50 61 67 65 72 2d 3e 6a 66 64 2c 20 6f 66 66  pPager->jfd, off
267a0 73 65 74 2c 20 70 50 61 67 65 72 2d 3e 6e 52 65  set, pPager->nRe
267b0 63 29 3b 0a 0a 20 20 20 20 20 20 2f 2a 20 55 70  c);..      /* Up
267c0 64 61 74 65 20 74 68 65 20 64 62 20 66 69 6c 65  date the db file
267d0 20 63 68 61 6e 67 65 20 63 6f 75 6e 74 65 72 2e   change counter.
267e0 20 54 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 63   The following c
267f0 61 6c 6c 20 77 69 6c 6c 20 6d 6f 64 69 66 79 0a  all will modify.
26800 20 20 20 20 20 20 2a 2a 20 74 68 65 20 69 6e 2d        ** the in-
26810 6d 65 6d 6f 72 79 20 72 65 70 72 65 73 65 6e 74  memory represent
26820 61 74 69 6f 6e 20 6f 66 20 70 61 67 65 20 31 20  ation of page 1 
26830 74 6f 20 69 6e 63 6c 75 64 65 20 74 68 65 20 75  to include the u
26840 70 64 61 74 65 64 0a 20 20 20 20 20 20 2a 2a 20  pdated.      ** 
26850 63 68 61 6e 67 65 20 63 6f 75 6e 74 65 72 20 61  change counter a
26860 6e 64 20 74 68 65 6e 20 77 72 69 74 65 20 70 61  nd then write pa
26870 67 65 20 31 20 64 69 72 65 63 74 6c 79 20 74 6f  ge 1 directly to
26880 20 74 68 65 20 64 61 74 61 62 61 73 65 0a 20 20   the database.  
26890 20 20 20 20 2a 2a 20 66 69 6c 65 2e 20 42 65 63      ** file. Bec
268a0 61 75 73 65 20 6f 66 20 74 68 65 20 61 74 6f 6d  ause of the atom
268b0 69 63 2d 77 72 69 74 65 20 70 72 6f 70 65 72 74  ic-write propert
268c0 79 20 6f 66 20 74 68 65 20 68 6f 73 74 20 66 69  y of the host fi
268d0 6c 65 2d 73 79 73 74 65 6d 2c 20 0a 20 20 20 20  le-system, .    
268e0 20 20 2a 2a 20 74 68 69 73 20 69 73 20 73 61 66    ** this is saf
268f0 65 2e 0a 20 20 20 20 20 20 2a 2f 0a 20 20 20 20  e..      */.    
26900 20 20 69 66 28 20 72 63 3d 3d 53 51 4c 49 54 45    if( rc==SQLITE
26910 5f 4f 4b 20 29 7b 0a 20 20 20 20 20 20 20 20 72  _OK ){.        r
26920 63 20 3d 20 70 61 67 65 72 5f 69 6e 63 72 5f 63  c = pager_incr_c
26930 68 61 6e 67 65 63 6f 75 6e 74 65 72 28 70 50 61  hangecounter(pPa
26940 67 65 72 2c 20 31 29 3b 0a 20 20 20 20 20 20 7d  ger, 1);.      }
26950 0a 20 20 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20  .    }else{.    
26960 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33 4a 6f    rc = sqlite3Jo
26970 75 72 6e 61 6c 43 72 65 61 74 65 28 70 50 61 67  urnalCreate(pPag
26980 65 72 2d 3e 6a 66 64 29 3b 0a 20 20 20 20 7d 0a  er->jfd);.    }.
26990 0a 20 20 20 20 69 66 28 20 21 75 73 65 41 74 6f  .    if( !useAto
269a0 6d 69 63 57 72 69 74 65 20 26 26 20 72 63 3d 3d  micWrite && rc==
269b0 53 51 4c 49 54 45 5f 4f 4b 20 29 0a 23 65 6e 64  SQLITE_OK ).#end
269c0 69 66 0a 0a 20 20 20 20 2f 2a 20 49 66 20 61 20  if..    /* If a 
269d0 6d 61 73 74 65 72 20 6a 6f 75 72 6e 61 6c 20 66  master journal f
269e0 69 6c 65 20 6e 61 6d 65 20 68 61 73 20 61 6c 72  ile name has alr
269f0 65 61 64 79 20 62 65 65 6e 20 77 72 69 74 74 65  eady been writte
26a00 6e 20 74 6f 20 74 68 65 0a 20 20 20 20 2a 2a 20  n to the.    ** 
26a10 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 2c 20 74 68  journal file, th
26a20 65 6e 20 6e 6f 20 73 79 6e 63 20 69 73 20 72 65  en no sync is re
26a30 71 75 69 72 65 64 2e 20 54 68 69 73 20 68 61 70  quired. This hap
26a40 70 65 6e 73 20 77 68 65 6e 20 69 74 20 69 73 0a  pens when it is.
26a50 20 20 20 20 2a 2a 20 77 72 69 74 74 65 6e 2c 20      ** written, 
26a60 74 68 65 6e 20 74 68 65 20 70 72 6f 63 65 73 73  then the process
26a70 20 66 61 69 6c 73 20 74 6f 20 75 70 67 72 61 64   fails to upgrad
26a80 65 20 66 72 6f 6d 20 61 20 52 45 53 45 52 56 45  e from a RESERVE
26a90 44 20 74 6f 20 61 6e 0a 20 20 20 20 2a 2a 20 45  D to an.    ** E
26aa0 58 43 4c 55 53 49 56 45 20 6c 6f 63 6b 2e 20 54  XCLUSIVE lock. T
26ab0 68 65 20 6e 65 78 74 20 74 69 6d 65 20 74 68 65  he next time the
26ac0 20 70 72 6f 63 65 73 73 20 74 72 69 65 73 20 74   process tries t
26ad0 6f 20 63 6f 6d 6d 69 74 20 74 68 65 0a 20 20 20  o commit the.   
26ae0 20 2a 2a 20 74 72 61 6e 73 61 63 74 69 6f 6e 20   ** transaction 
26af0 74 68 65 20 6d 2d 6a 20 6e 61 6d 65 20 77 69 6c  the m-j name wil
26b00 6c 20 68 61 76 65 20 61 6c 72 65 61 64 79 20 62  l have already b
26b10 65 65 6e 20 77 72 69 74 74 65 6e 2e 0a 20 20 20  een written..   
26b20 20 2a 2f 0a 20 20 20 20 69 66 28 20 21 70 50 61   */.    if( !pPa
26b30 67 65 72 2d 3e 73 65 74 4d 61 73 74 65 72 20 29  ger->setMaster )
26b40 7b 0a 20 20 20 20 20 20 72 63 20 3d 20 70 61 67  {.      rc = pag
26b50 65 72 5f 69 6e 63 72 5f 63 68 61 6e 67 65 63 6f  er_incr_changeco
26b60 75 6e 74 65 72 28 70 50 61 67 65 72 2c 20 30 29  unter(pPager, 0)
26b70 3b 0a 20 20 20 20 20 20 69 66 28 20 72 63 21 3d  ;.      if( rc!=
26b80 53 51 4c 49 54 45 5f 4f 4b 20 29 20 67 6f 74 6f  SQLITE_OK ) goto
26b90 20 73 79 6e 63 5f 65 78 69 74 3b 0a 23 69 66 6e   sync_exit;.#ifn
26ba0 64 65 66 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f  def SQLITE_OMIT_
26bb0 41 55 54 4f 56 41 43 55 55 4d 0a 20 20 20 20 20  AUTOVACUUM.     
26bc0 20 69 66 28 20 6e 54 72 75 6e 63 21 3d 30 20 29   if( nTrunc!=0 )
26bd0 7b 0a 20 20 20 20 20 20 20 20 2f 2a 20 49 66 20  {.        /* If 
26be0 74 68 69 73 20 74 72 61 6e 73 61 63 74 69 6f 6e  this transaction
26bf0 20 68 61 73 20 6d 61 64 65 20 74 68 65 20 64 61   has made the da
26c00 74 61 62 61 73 65 20 73 6d 61 6c 6c 65 72 2c 20  tabase smaller, 
26c10 74 68 65 6e 20 61 6c 6c 20 70 61 67 65 73 0a 20  then all pages. 
26c20 20 20 20 20 20 20 20 2a 2a 20 62 65 69 6e 67 20         ** being 
26c30 64 69 73 63 61 72 64 65 64 20 62 79 20 74 68 65  discarded by the
26c40 20 74 72 75 6e 63 61 74 69 6f 6e 20 6d 75 73 74   truncation must
26c50 20 62 65 20 77 72 69 74 74 65 6e 20 74 6f 20 74   be written to t
26c60 68 65 20 6a 6f 75 72 6e 61 6c 0a 20 20 20 20 20  he journal.     
26c70 20 20 20 2a 2a 20 66 69 6c 65 2e 0a 20 20 20 20     ** file..    
26c80 20 20 20 20 2a 2f 0a 20 20 20 20 20 20 20 20 50      */.        P
26c90 67 6e 6f 20 69 3b 0a 20 20 20 20 20 20 20 20 69  gno i;.        i
26ca0 6e 74 20 69 53 6b 69 70 20 3d 20 50 41 47 45 52  nt iSkip = PAGER
26cb0 5f 4d 4a 5f 50 47 4e 4f 28 70 50 61 67 65 72 29  _MJ_PGNO(pPager)
26cc0 3b 0a 20 20 20 20 20 20 20 20 66 6f 72 28 20 69  ;.        for( i
26cd0 3d 6e 54 72 75 6e 63 2b 31 3b 20 69 3c 3d 70 50  =nTrunc+1; i<=pP
26ce0 61 67 65 72 2d 3e 6f 72 69 67 44 62 53 69 7a 65  ager->origDbSize
26cf0 3b 20 69 2b 2b 20 29 7b 0a 20 20 20 20 20 20 20  ; i++ ){.       
26d00 20 20 20 69 66 28 20 21 73 71 6c 69 74 65 33 42     if( !sqlite3B
26d10 69 74 76 65 63 54 65 73 74 28 70 50 61 67 65 72  itvecTest(pPager
26d20 2d 3e 70 49 6e 4a 6f 75 72 6e 61 6c 2c 20 69 29  ->pInJournal, i)
26d30 20 26 26 20 69 21 3d 69 53 6b 69 70 20 29 7b 0a   && i!=iSkip ){.
26d40 20 20 20 20 20 20 20 20 20 20 20 20 72 63 20 3d              rc =
26d50 20 73 71 6c 69 74 65 33 50 61 67 65 72 47 65 74   sqlite3PagerGet
26d60 28 70 50 61 67 65 72 2c 20 69 2c 20 26 70 50 67  (pPager, i, &pPg
26d70 29 3b 0a 20 20 20 20 20 20 20 20 20 20 20 20 69  );.            i
26d80 66 28 20 72 63 21 3d 53 51 4c 49 54 45 5f 4f 4b  f( rc!=SQLITE_OK
26d90 20 29 20 67 6f 74 6f 20 73 79 6e 63 5f 65 78 69   ) goto sync_exi
26da0 74 3b 0a 20 20 20 20 20 20 20 20 20 20 20 20 72  t;.            r
26db0 63 20 3d 20 73 71 6c 69 74 65 33 50 61 67 65 72  c = sqlite3Pager
26dc0 57 72 69 74 65 28 70 50 67 29 3b 0a 20 20 20 20  Write(pPg);.    
26dd0 20 20 20 20 20 20 20 20 73 71 6c 69 74 65 33 50          sqlite3P
26de0 61 67 65 72 55 6e 72 65 66 28 70 50 67 29 3b 0a  agerUnref(pPg);.
26df0 20 20 20 20 20 20 20 20 20 20 20 20 69 66 28 20              if( 
26e00 72 63 21 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 20  rc!=SQLITE_OK ) 
26e10 67 6f 74 6f 20 73 79 6e 63 5f 65 78 69 74 3b 0a  goto sync_exit;.
26e20 20 20 20 20 20 20 20 20 20 20 7d 0a 20 20 20 20            }.    
26e30 20 20 20 20 7d 20 0a 20 20 20 20 20 20 7d 0a 23      } .      }.#
26e40 65 6e 64 69 66 0a 20 20 20 20 20 20 72 63 20 3d  endif.      rc =
26e50 20 77 72 69 74 65 4d 61 73 74 65 72 4a 6f 75 72   writeMasterJour
26e60 6e 61 6c 28 70 50 61 67 65 72 2c 20 7a 4d 61 73  nal(pPager, zMas
26e70 74 65 72 29 3b 0a 20 20 20 20 20 20 69 66 28 20  ter);.      if( 
26e80 72 63 21 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 20  rc!=SQLITE_OK ) 
26e90 67 6f 74 6f 20 73 79 6e 63 5f 65 78 69 74 3b 0a  goto sync_exit;.
26ea0 20 20 20 20 20 20 72 63 20 3d 20 73 79 6e 63 4a        rc = syncJ
26eb0 6f 75 72 6e 61 6c 28 70 50 61 67 65 72 29 3b 0a  ournal(pPager);.
26ec0 20 20 20 20 7d 0a 20 20 20 20 69 66 28 20 72 63      }.    if( rc
26ed0 21 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 20 67 6f  !=SQLITE_OK ) go
26ee0 74 6f 20 73 79 6e 63 5f 65 78 69 74 3b 0a 0a 23  to sync_exit;..#
26ef0 69 66 6e 64 65 66 20 53 51 4c 49 54 45 5f 4f 4d  ifndef SQLITE_OM
26f00 49 54 5f 41 55 54 4f 56 41 43 55 55 4d 0a 20 20  IT_AUTOVACUUM.  
26f10 20 20 69 66 28 20 6e 54 72 75 6e 63 21 3d 30 20    if( nTrunc!=0 
26f20 29 7b 0a 20 20 20 20 20 20 72 63 20 3d 20 73 71  ){.      rc = sq
26f30 6c 69 74 65 33 50 61 67 65 72 54 72 75 6e 63 61  lite3PagerTrunca
26f40 74 65 28 70 50 61 67 65 72 2c 20 6e 54 72 75 6e  te(pPager, nTrun
26f50 63 29 3b 0a 20 20 20 20 20 20 69 66 28 20 72 63  c);.      if( rc
26f60 21 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 20 67 6f  !=SQLITE_OK ) go
26f70 74 6f 20 73 79 6e 63 5f 65 78 69 74 3b 0a 20 20  to sync_exit;.  
26f80 20 20 7d 0a 23 65 6e 64 69 66 0a 0a 20 20 20 20    }.#endif..    
26f90 2f 2a 20 57 72 69 74 65 20 61 6c 6c 20 64 69 72  /* Write all dir
26fa0 74 79 20 70 61 67 65 73 20 74 6f 20 74 68 65 20  ty pages to the 
26fb0 64 61 74 61 62 61 73 65 20 66 69 6c 65 20 2a 2f  database file */
26fc0 0a 20 20 20 20 70 50 67 20 3d 20 70 61 67 65 72  .    pPg = pager
26fd0 5f 67 65 74 5f 61 6c 6c 5f 64 69 72 74 79 5f 70  _get_all_dirty_p
26fe0 61 67 65 73 28 70 50 61 67 65 72 29 3b 0a 20 20  ages(pPager);.  
26ff0 20 20 72 63 20 3d 20 70 61 67 65 72 5f 77 72 69    rc = pager_wri
27000 74 65 5f 70 61 67 65 6c 69 73 74 28 70 50 67 29  te_pagelist(pPg)
27010 3b 0a 20 20 20 20 69 66 28 20 72 63 21 3d 53 51  ;.    if( rc!=SQ
27020 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 20  LITE_OK ){.     
27030 20 61 73 73 65 72 74 28 20 72 63 21 3d 53 51 4c   assert( rc!=SQL
27040 49 54 45 5f 49 4f 45 52 52 5f 42 4c 4f 43 4b 45  ITE_IOERR_BLOCKE
27050 44 20 29 3b 0a 20 20 20 20 20 20 2f 2a 20 54 68  D );.      /* Th
27060 65 20 65 72 72 6f 72 20 6d 69 67 68 74 20 68 61  e error might ha
27070 76 65 20 6c 65 66 74 20 74 68 65 20 64 69 72 74  ve left the dirt
27080 79 20 6c 69 73 74 20 61 6c 6c 20 66 6f 75 6c 65  y list all foule
27090 64 20 75 70 20 68 65 72 65 2c 0a 20 20 20 20 20  d up here,.     
270a0 20 2a 2a 20 62 75 74 20 74 68 61 74 20 64 6f 65   ** but that doe
270b0 73 20 6e 6f 74 20 6d 61 74 74 65 72 20 62 65 63  s not matter bec
270c0 61 75 73 65 20 69 66 20 74 68 65 20 69 66 20 74  ause if the if t
270d0 68 65 20 64 69 72 74 79 20 6c 69 73 74 20 64 69  he dirty list di
270e0 64 0a 20 20 20 20 20 20 2a 2a 20 67 65 74 20 63  d.      ** get c
270f0 6f 72 72 75 70 74 65 64 2c 20 74 68 65 6e 20 74  orrupted, then t
27100 68 65 20 74 72 61 6e 73 61 63 74 69 6f 6e 20 77  he transaction w
27110 69 6c 6c 20 72 6f 6c 6c 20 62 61 63 6b 20 61 6e  ill roll back an
27120 64 0a 20 20 20 20 20 20 2a 2a 20 64 69 73 63 61  d.      ** disca
27130 72 64 20 74 68 65 20 64 69 72 74 79 20 6c 69 73  rd the dirty lis
27140 74 2e 20 20 54 68 65 72 65 20 69 73 20 61 6e 20  t.  There is an 
27150 61 73 73 65 72 74 20 69 6e 0a 20 20 20 20 20 20  assert in.      
27160 2a 2a 20 70 61 67 65 72 5f 67 65 74 5f 61 6c 6c  ** pager_get_all
27170 5f 64 69 72 74 79 5f 70 61 67 65 73 28 29 20 74  _dirty_pages() t
27180 68 61 74 20 76 65 72 69 66 69 65 73 20 74 68 61  hat verifies tha
27190 74 20 6e 6f 20 61 74 74 65 6d 70 74 0a 20 20 20  t no attempt.   
271a0 20 20 20 2a 2a 20 69 73 20 6d 61 64 65 20 74 6f     ** is made to
271b0 20 75 73 65 20 61 6e 20 69 6e 76 61 6c 69 64 20   use an invalid 
271c0 64 69 72 74 79 20 6c 69 73 74 2e 0a 20 20 20 20  dirty list..    
271d0 20 20 2a 2f 0a 20 20 20 20 20 20 67 6f 74 6f 20    */.      goto 
271e0 73 79 6e 63 5f 65 78 69 74 3b 0a 20 20 20 20 7d  sync_exit;.    }
271f0 0a 20 20 20 20 70 50 61 67 65 72 2d 3e 70 44 69  .    pPager->pDi
27200 72 74 79 20 3d 20 30 3b 0a 0a 20 20 20 20 2f 2a  rty = 0;..    /*
27210 20 53 79 6e 63 20 74 68 65 20 64 61 74 61 62 61   Sync the databa
27220 73 65 20 66 69 6c 65 2e 20 2a 2f 0a 20 20 20 20  se file. */.    
27230 69 66 28 20 21 70 50 61 67 65 72 2d 3e 6e 6f 53  if( !pPager->noS
27240 79 6e 63 20 26 26 20 21 6e 6f 53 79 6e 63 20 29  ync && !noSync )
27250 7b 0a 20 20 20 20 20 20 72 63 20 3d 20 73 71 6c  {.      rc = sql
27260 69 74 65 33 4f 73 53 79 6e 63 28 70 50 61 67 65  ite3OsSync(pPage
27270 72 2d 3e 66 64 2c 20 70 50 61 67 65 72 2d 3e 73  r->fd, pPager->s
27280 79 6e 63 5f 66 6c 61 67 73 29 3b 0a 20 20 20 20  ync_flags);.    
27290 7d 0a 20 20 20 20 49 4f 54 52 41 43 45 28 28 22  }.    IOTRACE(("
272a0 44 42 53 59 4e 43 20 25 70 5c 6e 22 2c 20 70 50  DBSYNC %p\n", pP
272b0 61 67 65 72 29 29 0a 0a 20 20 20 20 70 50 61 67  ager))..    pPag
272c0 65 72 2d 3e 73 74 61 74 65 20 3d 20 50 41 47 45  er->state = PAGE
272d0 52 5f 53 59 4e 43 45 44 3b 0a 20 20 7d 65 6c 73  R_SYNCED;.  }els
272e0 65 20 69 66 28 20 4d 45 4d 44 42 20 26 26 20 6e  e if( MEMDB && n
272f0 54 72 75 6e 63 21 3d 30 20 29 7b 0a 20 20 20 20  Trunc!=0 ){.    
27300 72 63 20 3d 20 73 71 6c 69 74 65 33 50 61 67 65  rc = sqlite3Page
27310 72 54 72 75 6e 63 61 74 65 28 70 50 61 67 65 72  rTruncate(pPager
27320 2c 20 6e 54 72 75 6e 63 29 3b 0a 20 20 7d 0a 0a  , nTrunc);.  }..
27330 73 79 6e 63 5f 65 78 69 74 3a 0a 20 20 69 66 28  sync_exit:.  if(
27340 20 72 63 3d 3d 53 51 4c 49 54 45 5f 49 4f 45 52   rc==SQLITE_IOER
27350 52 5f 42 4c 4f 43 4b 45 44 20 29 7b 0a 20 20 20  R_BLOCKED ){.   
27360 20 2f 2a 20 70 61 67 65 72 5f 69 6e 63 72 5f 63   /* pager_incr_c
27370 68 61 6e 67 65 63 6f 75 6e 74 65 72 28 29 20 6d  hangecounter() m
27380 61 79 20 61 74 74 65 6d 70 74 20 74 6f 20 6f 62  ay attempt to ob
27390 74 61 69 6e 20 61 6e 20 65 78 63 6c 75 73 69 76  tain an exclusiv
273a0 65 0a 20 20 20 20 20 2a 20 6c 6f 63 6b 20 74 6f  e.     * lock to
273b0 20 73 70 69 6c 6c 20 74 68 65 20 63 61 63 68 65   spill the cache
273c0 20 61 6e 64 20 72 65 74 75 72 6e 20 49 4f 45 52   and return IOER
273d0 52 5f 42 4c 4f 43 4b 45 44 2e 20 42 75 74 20 73  R_BLOCKED. But s
273e0 69 6e 63 65 20 0a 20 20 20 20 20 2a 20 74 68 65  ince .     * the
273f0 72 65 20 69 73 20 6e 6f 20 63 68 61 6e 63 65 20  re is no chance 
27400 74 68 65 20 63 61 63 68 65 20 69 73 20 69 6e 63  the cache is inc
27410 6f 6e 73 69 73 74 65 6e 74 2c 20 69 74 20 69 73  onsistent, it is
27420 0a 20 20 20 20 20 2a 20 62 65 74 74 65 72 20 74  .     * better t
27430 6f 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f  o return SQLITE_
27440 42 55 53 59 2e 0a 20 20 20 20 20 2a 2f 0a 20 20  BUSY..     */.  
27450 20 20 72 63 20 3d 20 53 51 4c 49 54 45 5f 42 55    rc = SQLITE_BU
27460 53 59 3b 0a 20 20 7d 0a 20 20 70 61 67 65 72 4c  SY;.  }.  pagerL
27470 65 61 76 65 28 70 50 61 67 65 72 29 3b 0a 20 20  eave(pPager);.  
27480 72 65 74 75 72 6e 20 72 63 3b 0a 7d 0a 0a 0a 2f  return rc;.}.../
27490 2a 0a 2a 2a 20 43 6f 6d 6d 69 74 20 61 6c 6c 20  *.** Commit all 
274a0 63 68 61 6e 67 65 73 20 74 6f 20 74 68 65 20 64  changes to the d
274b0 61 74 61 62 61 73 65 20 61 6e 64 20 72 65 6c 65  atabase and rele
274c0 61 73 65 20 74 68 65 20 77 72 69 74 65 20 6c 6f  ase the write lo
274d0 63 6b 2e 0a 2a 2a 0a 2a 2a 20 49 66 20 74 68 65  ck..**.** If the
274e0 20 63 6f 6d 6d 69 74 20 66 61 69 6c 73 20 66 6f   commit fails fo
274f0 72 20 61 6e 79 20 72 65 61 73 6f 6e 2c 20 61 20  r any reason, a 
27500 72 6f 6c 6c 62 61 63 6b 20 61 74 74 65 6d 70 74  rollback attempt
27510 20 69 73 20 6d 61 64 65 0a 2a 2a 20 61 6e 64 20   is made.** and 
27520 61 6e 20 65 72 72 6f 72 20 63 6f 64 65 20 69 73  an error code is
27530 20 72 65 74 75 72 6e 65 64 2e 20 20 49 66 20 74   returned.  If t
27540 68 65 20 63 6f 6d 6d 69 74 20 77 6f 72 6b 65 64  he commit worked
27550 2c 20 53 51 4c 49 54 45 5f 4f 4b 0a 2a 2a 20 69  , SQLITE_OK.** i
27560 73 20 72 65 74 75 72 6e 65 64 2e 0a 2a 2f 0a 69  s returned..*/.i
27570 6e 74 20 73 71 6c 69 74 65 33 50 61 67 65 72 43  nt sqlite3PagerC
27580 6f 6d 6d 69 74 50 68 61 73 65 54 77 6f 28 50 61  ommitPhaseTwo(Pa
27590 67 65 72 20 2a 70 50 61 67 65 72 29 7b 0a 20 20  ger *pPager){.  
275a0 69 6e 74 20 72 63 3b 0a 20 20 50 67 48 64 72 20  int rc;.  PgHdr 
275b0 2a 70 50 67 3b 0a 0a 20 20 69 66 28 20 70 50 61  *pPg;..  if( pPa
275c0 67 65 72 2d 3e 65 72 72 43 6f 64 65 20 29 7b 0a  ger->errCode ){.
275d0 20 20 20 20 72 65 74 75 72 6e 20 70 50 61 67 65      return pPage
275e0 72 2d 3e 65 72 72 43 6f 64 65 3b 0a 20 20 7d 0a  r->errCode;.  }.
275f0 20 20 69 66 28 20 70 50 61 67 65 72 2d 3e 73 74    if( pPager->st
27600 61 74 65 3c 50 41 47 45 52 5f 52 45 53 45 52 56  ate<PAGER_RESERV
27610 45 44 20 29 7b 0a 20 20 20 20 72 65 74 75 72 6e  ED ){.    return
27620 20 53 51 4c 49 54 45 5f 45 52 52 4f 52 3b 0a 20   SQLITE_ERROR;. 
27630 20 7d 0a 20 20 70 61 67 65 72 45 6e 74 65 72 28   }.  pagerEnter(
27640 70 50 61 67 65 72 29 3b 0a 20 20 50 41 47 45 52  pPager);.  PAGER
27650 54 52 41 43 45 32 28 22 43 4f 4d 4d 49 54 20 25  TRACE2("COMMIT %
27660 64 5c 6e 22 2c 20 50 41 47 45 52 49 44 28 70 50  d\n", PAGERID(pP
27670 61 67 65 72 29 29 3b 0a 20 20 69 66 28 20 4d 45  ager));.  if( ME
27680 4d 44 42 20 29 7b 0a 20 20 20 20 70 50 67 20 3d  MDB ){.    pPg =
27690 20 70 61 67 65 72 5f 67 65 74 5f 61 6c 6c 5f 64   pager_get_all_d
276a0 69 72 74 79 5f 70 61 67 65 73 28 70 50 61 67 65  irty_pages(pPage
276b0 72 29 3b 0a 20 20 20 20 77 68 69 6c 65 28 20 70  r);.    while( p
276c0 50 67 20 29 7b 0a 20 20 20 20 20 20 50 67 48 69  Pg ){.      PgHi
276d0 73 74 6f 72 79 20 2a 70 48 69 73 74 20 3d 20 50  story *pHist = P
276e0 47 48 44 52 5f 54 4f 5f 48 49 53 54 28 70 50 67  GHDR_TO_HIST(pPg
276f0 2c 20 70 50 61 67 65 72 29 3b 0a 20 20 20 20 20  , pPager);.     
27700 20 63 6c 65 61 72 48 69 73 74 6f 72 79 28 70 48   clearHistory(pH
27710 69 73 74 29 3b 0a 20 20 20 20 20 20 70 50 67 2d  ist);.      pPg-
27720 3e 64 69 72 74 79 20 3d 20 30 3b 0a 20 20 20 20  >dirty = 0;.    
27730 20 20 70 50 67 2d 3e 69 6e 4a 6f 75 72 6e 61 6c    pPg->inJournal
27740 20 3d 20 30 3b 0a 20 20 20 20 20 20 70 48 69 73   = 0;.      pHis
27750 74 2d 3e 69 6e 53 74 6d 74 20 3d 20 30 3b 0a 20  t->inStmt = 0;. 
27760 20 20 20 20 20 70 50 67 2d 3e 6e 65 65 64 53 79       pPg->needSy
27770 6e 63 20 3d 20 30 3b 0a 20 20 20 20 20 20 70 48  nc = 0;.      pH
27780 69 73 74 2d 3e 70 50 72 65 76 53 74 6d 74 20 3d  ist->pPrevStmt =
27790 20 70 48 69 73 74 2d 3e 70 4e 65 78 74 53 74 6d   pHist->pNextStm
277a0 74 20 3d 20 30 3b 0a 20 20 20 20 20 20 70 50 67  t = 0;.      pPg
277b0 20 3d 20 70 50 67 2d 3e 70 44 69 72 74 79 3b 0a   = pPg->pDirty;.
277c0 20 20 20 20 7d 0a 20 20 20 20 70 50 61 67 65 72      }.    pPager
277d0 2d 3e 70 44 69 72 74 79 20 3d 20 30 3b 0a 23 69  ->pDirty = 0;.#i
277e0 66 6e 64 65 66 20 4e 44 45 42 55 47 0a 20 20 20  fndef NDEBUG.   
277f0 20 66 6f 72 28 70 50 67 3d 70 50 61 67 65 72 2d   for(pPg=pPager-
27800 3e 70 41 6c 6c 3b 20 70 50 67 3b 20 70 50 67 3d  >pAll; pPg; pPg=
27810 70 50 67 2d 3e 70 4e 65 78 74 41 6c 6c 29 7b 0a  pPg->pNextAll){.
27820 20 20 20 20 20 20 50 67 48 69 73 74 6f 72 79 20        PgHistory 
27830 2a 70 48 69 73 74 20 3d 20 50 47 48 44 52 5f 54  *pHist = PGHDR_T
27840 4f 5f 48 49 53 54 28 70 50 67 2c 20 70 50 61 67  O_HIST(pPg, pPag
27850 65 72 29 3b 0a 20 20 20 20 20 20 61 73 73 65 72  er);.      asser
27860 74 28 20 21 70 50 67 2d 3e 61 6c 77 61 79 73 52  t( !pPg->alwaysR
27870 6f 6c 6c 62 61 63 6b 20 29 3b 0a 20 20 20 20 20  ollback );.     
27880 20 61 73 73 65 72 74 28 20 21 70 48 69 73 74 2d   assert( !pHist-
27890 3e 70 4f 72 69 67 20 29 3b 0a 20 20 20 20 20 20  >pOrig );.      
278a0 61 73 73 65 72 74 28 20 21 70 48 69 73 74 2d 3e  assert( !pHist->
278b0 70 53 74 6d 74 20 29 3b 0a 20 20 20 20 7d 0a 23  pStmt );.    }.#
278c0 65 6e 64 69 66 0a 20 20 20 20 70 50 61 67 65 72  endif.    pPager
278d0 2d 3e 70 53 74 6d 74 20 3d 20 30 3b 0a 20 20 20  ->pStmt = 0;.   
278e0 20 70 50 61 67 65 72 2d 3e 73 74 61 74 65 20 3d   pPager->state =
278f0 20 50 41 47 45 52 5f 53 48 41 52 45 44 3b 0a 20   PAGER_SHARED;. 
27900 20 20 20 70 61 67 65 72 4c 65 61 76 65 28 70 50     pagerLeave(pP
27910 61 67 65 72 29 3b 0a 20 20 20 20 72 65 74 75 72  ager);.    retur
27920 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20 20 7d  n SQLITE_OK;.  }
27930 0a 20 20 61 73 73 65 72 74 28 20 70 50 61 67 65  .  assert( pPage
27940 72 2d 3e 73 74 61 74 65 3d 3d 50 41 47 45 52 5f  r->state==PAGER_
27950 53 59 4e 43 45 44 20 7c 7c 20 21 70 50 61 67 65  SYNCED || !pPage
27960 72 2d 3e 64 69 72 74 79 43 61 63 68 65 20 29 3b  r->dirtyCache );
27970 0a 20 20 72 63 20 3d 20 70 61 67 65 72 5f 65 6e  .  rc = pager_en
27980 64 5f 74 72 61 6e 73 61 63 74 69 6f 6e 28 70 50  d_transaction(pP
27990 61 67 65 72 29 3b 0a 20 20 72 63 20 3d 20 70 61  ager);.  rc = pa
279a0 67 65 72 5f 65 72 72 6f 72 28 70 50 61 67 65 72  ger_error(pPager
279b0 2c 20 72 63 29 3b 0a 20 20 70 61 67 65 72 4c 65  , rc);.  pagerLe
279c0 61 76 65 28 70 50 61 67 65 72 29 3b 0a 20 20 72  ave(pPager);.  r
279d0 65 74 75 72 6e 20 72 63 3b 0a 7d 0a 0a 2f 2a 0a  eturn rc;.}../*.
279e0 2a 2a 20 52 6f 6c 6c 62 61 63 6b 20 61 6c 6c 20  ** Rollback all 
279f0 63 68 61 6e 67 65 73 2e 20 20 54 68 65 20 64 61  changes.  The da
27a00 74 61 62 61 73 65 20 66 61 6c 6c 73 20 62 61 63  tabase falls bac
27a10 6b 20 74 6f 20 50 41 47 45 52 5f 53 48 41 52 45  k to PAGER_SHARE
27a20 44 20 6d 6f 64 65 2e 0a 2a 2a 20 41 6c 6c 20 69  D mode..** All i
27a30 6e 2d 6d 65 6d 6f 72 79 20 63 61 63 68 65 20 70  n-memory cache p
27a40 61 67 65 73 20 72 65 76 65 72 74 20 74 6f 20 74  ages revert to t
27a50 68 65 69 72 20 6f 72 69 67 69 6e 61 6c 20 64 61  heir original da
27a60 74 61 20 63 6f 6e 74 65 6e 74 73 2e 0a 2a 2a 20  ta contents..** 
27a70 54 68 65 20 6a 6f 75 72 6e 61 6c 20 69 73 20 64  The journal is d
27a80 65 6c 65 74 65 64 2e 0a 2a 2a 0a 2a 2a 20 54 68  eleted..**.** Th
27a90 69 73 20 72 6f 75 74 69 6e 65 20 63 61 6e 6e 6f  is routine canno
27aa0 74 20 66 61 69 6c 20 75 6e 6c 65 73 73 20 73 6f  t fail unless so
27ab0 6d 65 20 6f 74 68 65 72 20 70 72 6f 63 65 73 73  me other process
27ac0 20 69 73 20 6e 6f 74 20 66 6f 6c 6c 6f 77 69 6e   is not followin
27ad0 67 0a 2a 2a 20 74 68 65 20 63 6f 72 72 65 63 74  g.** the correct
27ae0 20 6c 6f 63 6b 69 6e 67 20 70 72 6f 74 6f 63 6f   locking protoco
27af0 6c 20 6f 72 20 75 6e 6c 65 73 73 20 73 6f 6d 65  l or unless some
27b00 20 6f 74 68 65 72 0a 2a 2a 20 70 72 6f 63 65 73   other.** proces
27b10 73 20 69 73 20 77 72 69 74 69 6e 67 20 74 72 61  s is writing tra
27b20 73 68 20 69 6e 74 6f 20 74 68 65 20 6a 6f 75 72  sh into the jour
27b30 6e 61 6c 20 66 69 6c 65 20 28 53 51 4c 49 54 45  nal file (SQLITE
27b40 5f 43 4f 52 52 55 50 54 29 20 6f 72 0a 2a 2a 20  _CORRUPT) or.** 
27b50 75 6e 6c 65 73 73 20 61 20 70 72 69 6f 72 20 6d  unless a prior m
27b60 61 6c 6c 6f 63 28 29 20 66 61 69 6c 65 64 20 28  alloc() failed (
27b70 53 51 4c 49 54 45 5f 4e 4f 4d 45 4d 29 2e 20 20  SQLITE_NOMEM).  
27b80 41 70 70 72 6f 70 72 69 61 74 65 20 65 72 72 6f  Appropriate erro
27b90 72 0a 2a 2a 20 63 6f 64 65 73 20 61 72 65 20 72  r.** codes are r
27ba0 65 74 75 72 6e 65 64 20 66 6f 72 20 61 6c 6c 20  eturned for all 
27bb0 74 68 65 73 65 20 6f 63 63 61 73 69 6f 6e 73 2e  these occasions.
27bc0 20 20 4f 74 68 65 72 77 69 73 65 2c 0a 2a 2a 20    Otherwise,.** 
27bd0 53 51 4c 49 54 45 5f 4f 4b 20 69 73 20 72 65 74  SQLITE_OK is ret
27be0 75 72 6e 65 64 2e 0a 2a 2f 0a 69 6e 74 20 73 71  urned..*/.int sq
27bf0 6c 69 74 65 33 50 61 67 65 72 52 6f 6c 6c 62 61  lite3PagerRollba
27c00 63 6b 28 50 61 67 65 72 20 2a 70 50 61 67 65 72  ck(Pager *pPager
27c10 29 7b 0a 20 20 69 6e 74 20 72 63 3b 0a 20 20 50  ){.  int rc;.  P
27c20 41 47 45 52 54 52 41 43 45 32 28 22 52 4f 4c 4c  AGERTRACE2("ROLL
27c30 42 41 43 4b 20 25 64 5c 6e 22 2c 20 50 41 47 45  BACK %d\n", PAGE
27c40 52 49 44 28 70 50 61 67 65 72 29 29 3b 0a 20 20  RID(pPager));.  
27c50 69 66 28 20 4d 45 4d 44 42 20 29 7b 0a 20 20 20  if( MEMDB ){.   
27c60 20 50 67 48 64 72 20 2a 70 3b 0a 20 20 20 20 66   PgHdr *p;.    f
27c70 6f 72 28 70 3d 70 50 61 67 65 72 2d 3e 70 41 6c  or(p=pPager->pAl
27c80 6c 3b 20 70 3b 20 70 3d 70 2d 3e 70 4e 65 78 74  l; p; p=p->pNext
27c90 41 6c 6c 29 7b 0a 20 20 20 20 20 20 50 67 48 69  All){.      PgHi
27ca0 73 74 6f 72 79 20 2a 70 48 69 73 74 3b 0a 20 20  story *pHist;.  
27cb0 20 20 20 20 61 73 73 65 72 74 28 20 21 70 2d 3e      assert( !p->
27cc0 61 6c 77 61 79 73 52 6f 6c 6c 62 61 63 6b 20 29  alwaysRollback )
27cd0 3b 0a 20 20 20 20 20 20 69 66 28 20 21 70 2d 3e  ;.      if( !p->
27ce0 64 69 72 74 79 20 29 7b 0a 20 20 20 20 20 20 20  dirty ){.       
27cf0 20 61 73 73 65 72 74 28 20 21 28 28 50 67 48 69   assert( !((PgHi
27d00 73 74 6f 72 79 20 2a 29 50 47 48 44 52 5f 54 4f  story *)PGHDR_TO
27d10 5f 48 49 53 54 28 70 2c 20 70 50 61 67 65 72 29  _HIST(p, pPager)
27d20 29 2d 3e 70 4f 72 69 67 20 29 3b 0a 20 20 20 20  )->pOrig );.    
27d30 20 20 20 20 61 73 73 65 72 74 28 20 21 28 28 50      assert( !((P
27d40 67 48 69 73 74 6f 72 79 20 2a 29 50 47 48 44 52  gHistory *)PGHDR
27d50 5f 54 4f 5f 48 49 53 54 28 70 2c 20 70 50 61 67  _TO_HIST(p, pPag
27d60 65 72 29 29 2d 3e 70 53 74 6d 74 20 29 3b 0a 20  er))->pStmt );. 
27d70 20 20 20 20 20 20 20 63 6f 6e 74 69 6e 75 65 3b         continue;
27d80 0a 20 20 20 20 20 20 7d 0a 0a 20 20 20 20 20 20  .      }..      
27d90 70 48 69 73 74 20 3d 20 50 47 48 44 52 5f 54 4f  pHist = PGHDR_TO
27da0 5f 48 49 53 54 28 70 2c 20 70 50 61 67 65 72 29  _HIST(p, pPager)
27db0 3b 0a 20 20 20 20 20 20 69 66 28 20 70 48 69 73  ;.      if( pHis
27dc0 74 2d 3e 70 4f 72 69 67 20 29 7b 0a 20 20 20 20  t->pOrig ){.    
27dd0 20 20 20 20 6d 65 6d 63 70 79 28 50 47 48 44 52      memcpy(PGHDR
27de0 5f 54 4f 5f 44 41 54 41 28 70 29 2c 20 70 48 69  _TO_DATA(p), pHi
27df0 73 74 2d 3e 70 4f 72 69 67 2c 20 70 50 61 67 65  st->pOrig, pPage
27e00 72 2d 3e 70 61 67 65 53 69 7a 65 29 3b 0a 20 20  r->pageSize);.  
27e10 20 20 20 20 20 20 50 41 47 45 52 54 52 41 43 45        PAGERTRACE
27e20 33 28 22 52 4f 4c 4c 42 41 43 4b 2d 50 41 47 45  3("ROLLBACK-PAGE
27e30 20 25 64 20 6f 66 20 25 64 5c 6e 22 2c 20 70 2d   %d of %d\n", p-
27e40 3e 70 67 6e 6f 2c 20 50 41 47 45 52 49 44 28 70  >pgno, PAGERID(p
27e50 50 61 67 65 72 29 29 3b 0a 20 20 20 20 20 20 7d  Pager));.      }
27e60 65 6c 73 65 7b 0a 20 20 20 20 20 20 20 20 50 41  else{.        PA
27e70 47 45 52 54 52 41 43 45 33 28 22 50 41 47 45 20  GERTRACE3("PAGE 
27e80 25 64 20 69 73 20 63 6c 65 61 6e 20 6f 6e 20 25  %d is clean on %
27e90 64 5c 6e 22 2c 20 70 2d 3e 70 67 6e 6f 2c 20 50  d\n", p->pgno, P
27ea0 41 47 45 52 49 44 28 70 50 61 67 65 72 29 29 3b  AGERID(pPager));
27eb0 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 63  .      }.      c
27ec0 6c 65 61 72 48 69 73 74 6f 72 79 28 70 48 69 73  learHistory(pHis
27ed0 74 29 3b 0a 20 20 20 20 20 20 70 2d 3e 64 69 72  t);.      p->dir
27ee0 74 79 20 3d 20 30 3b 0a 20 20 20 20 20 20 70 2d  ty = 0;.      p-
27ef0 3e 69 6e 4a 6f 75 72 6e 61 6c 20 3d 20 30 3b 0a  >inJournal = 0;.
27f00 20 20 20 20 20 20 70 48 69 73 74 2d 3e 69 6e 53        pHist->inS
27f10 74 6d 74 20 3d 20 30 3b 0a 20 20 20 20 20 20 70  tmt = 0;.      p
27f20 48 69 73 74 2d 3e 70 50 72 65 76 53 74 6d 74 20  Hist->pPrevStmt 
27f30 3d 20 70 48 69 73 74 2d 3e 70 4e 65 78 74 53 74  = pHist->pNextSt
27f40 6d 74 20 3d 20 30 3b 0a 20 20 20 20 20 20 69 66  mt = 0;.      if
27f50 28 20 70 50 61 67 65 72 2d 3e 78 52 65 69 6e 69  ( pPager->xReini
27f60 74 65 72 20 29 7b 0a 20 20 20 20 20 20 20 20 70  ter ){.        p
27f70 50 61 67 65 72 2d 3e 78 52 65 69 6e 69 74 65 72  Pager->xReiniter
27f80 28 70 2c 20 70 50 61 67 65 72 2d 3e 70 61 67 65  (p, pPager->page
27f90 53 69 7a 65 29 3b 0a 20 20 20 20 20 20 7d 0a 20  Size);.      }. 
27fa0 20 20 20 7d 0a 20 20 20 20 70 50 61 67 65 72 2d     }.    pPager-
27fb0 3e 70 44 69 72 74 79 20 3d 20 30 3b 0a 20 20 20  >pDirty = 0;.   
27fc0 20 70 50 61 67 65 72 2d 3e 70 53 74 6d 74 20 3d   pPager->pStmt =
27fd0 20 30 3b 0a 20 20 20 20 70 50 61 67 65 72 2d 3e   0;.    pPager->
27fe0 64 62 53 69 7a 65 20 3d 20 70 50 61 67 65 72 2d  dbSize = pPager-
27ff0 3e 6f 72 69 67 44 62 53 69 7a 65 3b 0a 20 20 20  >origDbSize;.   
28000 20 70 61 67 65 72 5f 74 72 75 6e 63 61 74 65 5f   pager_truncate_
28010 63 61 63 68 65 28 70 50 61 67 65 72 29 3b 0a 20  cache(pPager);. 
28020 20 20 20 70 50 61 67 65 72 2d 3e 73 74 6d 74 49     pPager->stmtI
28030 6e 55 73 65 20 3d 20 30 3b 0a 20 20 20 20 70 50  nUse = 0;.    pP
28040 61 67 65 72 2d 3e 73 74 61 74 65 20 3d 20 50 41  ager->state = PA
28050 47 45 52 5f 53 48 41 52 45 44 3b 0a 20 20 20 20  GER_SHARED;.    
28060 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b  return SQLITE_OK
28070 3b 0a 20 20 7d 0a 0a 20 20 70 61 67 65 72 45 6e  ;.  }..  pagerEn
28080 74 65 72 28 70 50 61 67 65 72 29 3b 0a 20 20 69  ter(pPager);.  i
28090 66 28 20 21 70 50 61 67 65 72 2d 3e 64 69 72 74  f( !pPager->dirt
280a0 79 43 61 63 68 65 20 7c 7c 20 21 70 50 61 67 65  yCache || !pPage
280b0 72 2d 3e 6a 6f 75 72 6e 61 6c 4f 70 65 6e 20 29  r->journalOpen )
280c0 7b 0a 20 20 20 20 72 63 20 3d 20 70 61 67 65 72  {.    rc = pager
280d0 5f 65 6e 64 5f 74 72 61 6e 73 61 63 74 69 6f 6e  _end_transaction
280e0 28 70 50 61 67 65 72 29 3b 0a 20 20 20 20 70 61  (pPager);.    pa
280f0 67 65 72 4c 65 61 76 65 28 70 50 61 67 65 72 29  gerLeave(pPager)
28100 3b 0a 20 20 20 20 72 65 74 75 72 6e 20 72 63 3b  ;.    return rc;
28110 0a 20 20 7d 0a 0a 20 20 69 66 28 20 70 50 61 67  .  }..  if( pPag
28120 65 72 2d 3e 65 72 72 43 6f 64 65 20 26 26 20 70  er->errCode && p
28130 50 61 67 65 72 2d 3e 65 72 72 43 6f 64 65 21 3d  Pager->errCode!=
28140 53 51 4c 49 54 45 5f 46 55 4c 4c 20 29 7b 0a 20  SQLITE_FULL ){. 
28150 20 20 20 69 66 28 20 70 50 61 67 65 72 2d 3e 73     if( pPager->s
28160 74 61 74 65 3e 3d 50 41 47 45 52 5f 45 58 43 4c  tate>=PAGER_EXCL
28170 55 53 49 56 45 20 29 7b 0a 20 20 20 20 20 20 70  USIVE ){.      p
28180 61 67 65 72 5f 70 6c 61 79 62 61 63 6b 28 70 50  ager_playback(pP
28190 61 67 65 72 2c 20 30 29 3b 0a 20 20 20 20 7d 0a  ager, 0);.    }.
281a0 20 20 20 20 70 61 67 65 72 4c 65 61 76 65 28 70      pagerLeave(p
281b0 50 61 67 65 72 29 3b 0a 20 20 20 20 72 65 74 75  Pager);.    retu
281c0 72 6e 20 70 50 61 67 65 72 2d 3e 65 72 72 43 6f  rn pPager->errCo
281d0 64 65 3b 0a 20 20 7d 0a 20 20 69 66 28 20 70 50  de;.  }.  if( pP
281e0 61 67 65 72 2d 3e 73 74 61 74 65 3d 3d 50 41 47  ager->state==PAG
281f0 45 52 5f 52 45 53 45 52 56 45 44 20 29 7b 0a 20  ER_RESERVED ){. 
28200 20 20 20 69 6e 74 20 72 63 32 3b 0a 20 20 20 20     int rc2;.    
28210 72 63 20 3d 20 70 61 67 65 72 5f 70 6c 61 79 62  rc = pager_playb
28220 61 63 6b 28 70 50 61 67 65 72 2c 20 30 29 3b 0a  ack(pPager, 0);.
28230 20 20 20 20 72 63 32 20 3d 20 70 61 67 65 72 5f      rc2 = pager_
28240 65 6e 64 5f 74 72 61 6e 73 61 63 74 69 6f 6e 28  end_transaction(
28250 70 50 61 67 65 72 29 3b 0a 20 20 20 20 69 66 28  pPager);.    if(
28260 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 29   rc==SQLITE_OK )
28270 7b 0a 20 20 20 20 20 20 72 63 20 3d 20 72 63 32  {.      rc = rc2
28280 3b 0a 20 20 20 20 7d 0a 20 20 7d 65 6c 73 65 7b  ;.    }.  }else{
28290 0a 20 20 20 20 72 63 20 3d 20 70 61 67 65 72 5f  .    rc = pager_
282a0 70 6c 61 79 62 61 63 6b 28 70 50 61 67 65 72 2c  playback(pPager,
282b0 20 30 29 3b 0a 20 20 7d 0a 20 20 2f 2a 20 70 61   0);.  }.  /* pa
282c0 67 65 72 5f 72 65 73 65 74 28 70 50 61 67 65 72  ger_reset(pPager
282d0 29 3b 20 2a 2f 0a 20 20 70 50 61 67 65 72 2d 3e  ); */.  pPager->
282e0 64 62 53 69 7a 65 20 3d 20 2d 31 3b 0a 0a 20 20  dbSize = -1;..  
282f0 2f 2a 20 49 66 20 61 6e 20 65 72 72 6f 72 20 6f  /* If an error o
28300 63 63 75 72 73 20 64 75 72 69 6e 67 20 61 20 52  ccurs during a R
28310 4f 4c 4c 42 41 43 4b 2c 20 77 65 20 63 61 6e 20  OLLBACK, we can 
28320 6e 6f 20 6c 6f 6e 67 65 72 20 74 72 75 73 74 20  no longer trust 
28330 74 68 65 20 70 61 67 65 72 0a 20 20 2a 2a 20 63  the pager.  ** c
28340 61 63 68 65 2e 20 53 6f 20 63 61 6c 6c 20 70 61  ache. So call pa
28350 67 65 72 5f 65 72 72 6f 72 28 29 20 6f 6e 20 74  ger_error() on t
28360 68 65 20 77 61 79 20 6f 75 74 20 74 6f 20 6d 61  he way out to ma
28370 6b 65 20 61 6e 79 20 65 72 72 6f 72 20 0a 20 20  ke any error .  
28380 2a 2a 20 70 65 72 73 69 73 74 65 6e 74 2e 0a 20  ** persistent.. 
28390 20 2a 2f 0a 20 20 72 63 20 3d 20 70 61 67 65 72   */.  rc = pager
283a0 5f 65 72 72 6f 72 28 70 50 61 67 65 72 2c 20 72  _error(pPager, r
283b0 63 29 3b 0a 20 20 70 61 67 65 72 4c 65 61 76 65  c);.  pagerLeave
283c0 28 70 50 61 67 65 72 29 3b 0a 20 20 72 65 74 75  (pPager);.  retu
283d0 72 6e 20 72 63 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20  rn rc;.}../*.** 
283e0 52 65 74 75 72 6e 20 54 52 55 45 20 69 66 20 74  Return TRUE if t
283f0 68 65 20 64 61 74 61 62 61 73 65 20 66 69 6c 65  he database file
28400 20 69 73 20 6f 70 65 6e 65 64 20 72 65 61 64 2d   is opened read-
28410 6f 6e 6c 79 2e 20 20 52 65 74 75 72 6e 20 46 41  only.  Return FA
28420 4c 53 45 0a 2a 2a 20 69 66 20 74 68 65 20 64 61  LSE.** if the da
28430 74 61 62 61 73 65 20 69 73 20 28 69 6e 20 74 68  tabase is (in th
28440 65 6f 72 79 29 20 77 72 69 74 61 62 6c 65 2e 0a  eory) writable..
28450 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 50 61  */.int sqlite3Pa
28460 67 65 72 49 73 72 65 61 64 6f 6e 6c 79 28 50 61  gerIsreadonly(Pa
28470 67 65 72 20 2a 70 50 61 67 65 72 29 7b 0a 20 20  ger *pPager){.  
28480 72 65 74 75 72 6e 20 70 50 61 67 65 72 2d 3e 72  return pPager->r
28490 65 61 64 4f 6e 6c 79 3b 0a 7d 0a 0a 2f 2a 0a 2a  eadOnly;.}../*.*
284a0 2a 20 52 65 74 75 72 6e 20 74 68 65 20 6e 75 6d  * Return the num
284b0 62 65 72 20 6f 66 20 72 65 66 65 72 65 6e 63 65  ber of reference
284c0 73 20 74 6f 20 74 68 65 20 70 61 67 65 72 2e 0a  s to the pager..
284d0 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 50 61  */.int sqlite3Pa
284e0 67 65 72 52 65 66 63 6f 75 6e 74 28 50 61 67 65  gerRefcount(Page
284f0 72 20 2a 70 50 61 67 65 72 29 7b 0a 20 20 72 65  r *pPager){.  re
28500 74 75 72 6e 20 70 50 61 67 65 72 2d 3e 6e 52 65  turn pPager->nRe
28510 66 3b 0a 7d 0a 0a 23 69 66 64 65 66 20 53 51 4c  f;.}..#ifdef SQL
28520 49 54 45 5f 54 45 53 54 0a 2f 2a 0a 2a 2a 20 54  ITE_TEST./*.** T
28530 68 69 73 20 72 6f 75 74 69 6e 65 20 69 73 20 75  his routine is u
28540 73 65 64 20 66 6f 72 20 74 65 73 74 69 6e 67 20  sed for testing 
28550 61 6e 64 20 61 6e 61 6c 79 73 69 73 20 6f 6e 6c  and analysis onl
28560 79 2e 0a 2a 2f 0a 69 6e 74 20 2a 73 71 6c 69 74  y..*/.int *sqlit
28570 65 33 50 61 67 65 72 53 74 61 74 73 28 50 61 67  e3PagerStats(Pag
28580 65 72 20 2a 70 50 61 67 65 72 29 7b 0a 20 20 73  er *pPager){.  s
28590 74 61 74 69 63 20 69 6e 74 20 61 5b 31 31 5d 3b  tatic int a[11];
285a0 0a 20 20 61 5b 30 5d 20 3d 20 70 50 61 67 65 72  .  a[0] = pPager
285b0 2d 3e 6e 52 65 66 3b 0a 20 20 61 5b 31 5d 20 3d  ->nRef;.  a[1] =
285c0 20 70 50 61 67 65 72 2d 3e 6e 50 61 67 65 3b 0a   pPager->nPage;.
285d0 20 20 61 5b 32 5d 20 3d 20 70 50 61 67 65 72 2d    a[2] = pPager-
285e0 3e 6d 78 50 61 67 65 3b 0a 20 20 61 5b 33 5d 20  >mxPage;.  a[3] 
285f0 3d 20 70 50 61 67 65 72 2d 3e 64 62 53 69 7a 65  = pPager->dbSize
28600 3b 0a 20 20 61 5b 34 5d 20 3d 20 70 50 61 67 65  ;.  a[4] = pPage
28610 72 2d 3e 73 74 61 74 65 3b 0a 20 20 61 5b 35 5d  r->state;.  a[5]
28620 20 3d 20 70 50 61 67 65 72 2d 3e 65 72 72 43 6f   = pPager->errCo
28630 64 65 3b 0a 20 20 61 5b 36 5d 20 3d 20 70 50 61  de;.  a[6] = pPa
28640 67 65 72 2d 3e 6e 48 69 74 3b 0a 20 20 61 5b 37  ger->nHit;.  a[7
28650 5d 20 3d 20 70 50 61 67 65 72 2d 3e 6e 4d 69 73  ] = pPager->nMis
28660 73 3b 0a 20 20 61 5b 38 5d 20 3d 20 30 3b 20 20  s;.  a[8] = 0;  
28670 2f 2a 20 55 73 65 64 20 74 6f 20 62 65 20 70 50  /* Used to be pP
28680 61 67 65 72 2d 3e 6e 4f 76 66 6c 20 2a 2f 0a 20  ager->nOvfl */. 
28690 20 61 5b 39 5d 20 3d 20 70 50 61 67 65 72 2d 3e   a[9] = pPager->
286a0 6e 52 65 61 64 3b 0a 20 20 61 5b 31 30 5d 20 3d  nRead;.  a[10] =
286b0 20 70 50 61 67 65 72 2d 3e 6e 57 72 69 74 65 3b   pPager->nWrite;
286c0 0a 20 20 72 65 74 75 72 6e 20 61 3b 0a 7d 0a 23  .  return a;.}.#
286d0 65 6e 64 69 66 0a 0a 2f 2a 0a 2a 2a 20 53 65 74  endif../*.** Set
286e0 20 74 68 65 20 73 74 61 74 65 6d 65 6e 74 20 72   the statement r
286f0 6f 6c 6c 62 61 63 6b 20 70 6f 69 6e 74 2e 0a 2a  ollback point..*
28700 2a 0a 2a 2a 20 54 68 69 73 20 72 6f 75 74 69 6e  *.** This routin
28710 65 20 73 68 6f 75 6c 64 20 62 65 20 63 61 6c 6c  e should be call
28720 65 64 20 77 69 74 68 20 74 68 65 20 74 72 61 6e  ed with the tran
28730 73 61 63 74 69 6f 6e 20 6a 6f 75 72 6e 61 6c 20  saction journal 
28740 61 6c 72 65 61 64 79 0a 2a 2a 20 6f 70 65 6e 2e  already.** open.
28750 20 20 41 20 6e 65 77 20 73 74 61 74 65 6d 65 6e    A new statemen
28760 74 20 6a 6f 75 72 6e 61 6c 20 69 73 20 63 72 65  t journal is cre
28770 61 74 65 64 20 74 68 61 74 20 63 61 6e 20 62 65  ated that can be
28780 20 75 73 65 64 20 74 6f 20 72 6f 6c 6c 62 61 63   used to rollbac
28790 6b 0a 2a 2a 20 63 68 61 6e 67 65 73 20 6f 66 20  k.** changes of 
287a0 61 20 73 69 6e 67 6c 65 20 53 51 4c 20 63 6f 6d  a single SQL com
287b0 6d 61 6e 64 20 77 69 74 68 69 6e 20 61 20 6c 61  mand within a la
287c0 72 67 65 72 20 74 72 61 6e 73 61 63 74 69 6f 6e  rger transaction
287d0 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74 20  ..*/.static int 
287e0 70 61 67 65 72 53 74 6d 74 42 65 67 69 6e 28 50  pagerStmtBegin(P
287f0 61 67 65 72 20 2a 70 50 61 67 65 72 29 7b 0a 20  ager *pPager){. 
28800 20 69 6e 74 20 72 63 3b 0a 20 20 61 73 73 65 72   int rc;.  asser
28810 74 28 20 21 70 50 61 67 65 72 2d 3e 73 74 6d 74  t( !pPager->stmt
28820 49 6e 55 73 65 20 29 3b 0a 20 20 61 73 73 65 72  InUse );.  asser
28830 74 28 20 70 50 61 67 65 72 2d 3e 73 74 61 74 65  t( pPager->state
28840 3e 3d 50 41 47 45 52 5f 53 48 41 52 45 44 20 29  >=PAGER_SHARED )
28850 3b 0a 20 20 61 73 73 65 72 74 28 20 70 50 61 67  ;.  assert( pPag
28860 65 72 2d 3e 64 62 53 69 7a 65 3e 3d 30 20 29 3b  er->dbSize>=0 );
28870 0a 20 20 50 41 47 45 52 54 52 41 43 45 32 28 22  .  PAGERTRACE2("
28880 53 54 4d 54 2d 42 45 47 49 4e 20 25 64 5c 6e 22  STMT-BEGIN %d\n"
28890 2c 20 50 41 47 45 52 49 44 28 70 50 61 67 65 72  , PAGERID(pPager
288a0 29 29 3b 0a 20 20 69 66 28 20 4d 45 4d 44 42 20  ));.  if( MEMDB 
288b0 29 7b 0a 20 20 20 20 70 50 61 67 65 72 2d 3e 73  ){.    pPager->s
288c0 74 6d 74 49 6e 55 73 65 20 3d 20 31 3b 0a 20 20  tmtInUse = 1;.  
288d0 20 20 70 50 61 67 65 72 2d 3e 73 74 6d 74 53 69    pPager->stmtSi
288e0 7a 65 20 3d 20 70 50 61 67 65 72 2d 3e 64 62 53  ze = pPager->dbS
288f0 69 7a 65 3b 0a 20 20 20 20 72 65 74 75 72 6e 20  ize;.    return 
28900 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20 20 7d 0a 20  SQLITE_OK;.  }. 
28910 20 69 66 28 20 21 70 50 61 67 65 72 2d 3e 6a 6f   if( !pPager->jo
28920 75 72 6e 61 6c 4f 70 65 6e 20 29 7b 0a 20 20 20  urnalOpen ){.   
28930 20 70 50 61 67 65 72 2d 3e 73 74 6d 74 41 75 74   pPager->stmtAut
28940 6f 6f 70 65 6e 20 3d 20 31 3b 0a 20 20 20 20 72  oopen = 1;.    r
28950 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b  eturn SQLITE_OK;
28960 0a 20 20 7d 0a 20 20 61 73 73 65 72 74 28 20 70  .  }.  assert( p
28970 50 61 67 65 72 2d 3e 6a 6f 75 72 6e 61 6c 4f 70  Pager->journalOp
28980 65 6e 20 29 3b 0a 20 20 70 61 67 65 72 4c 65 61  en );.  pagerLea
28990 76 65 28 70 50 61 67 65 72 29 3b 0a 20 20 61 73  ve(pPager);.  as
289a0 73 65 72 74 28 20 70 50 61 67 65 72 2d 3e 70 49  sert( pPager->pI
289b0 6e 53 74 6d 74 3d 3d 30 20 29 3b 0a 20 20 70 50  nStmt==0 );.  pP
289c0 61 67 65 72 2d 3e 70 49 6e 53 74 6d 74 20 3d 20  ager->pInStmt = 
289d0 73 71 6c 69 74 65 33 42 69 74 76 65 63 43 72 65  sqlite3BitvecCre
289e0 61 74 65 28 70 50 61 67 65 72 2d 3e 64 62 53 69  ate(pPager->dbSi
289f0 7a 65 29 3b 0a 20 20 70 61 67 65 72 45 6e 74 65  ze);.  pagerEnte
28a00 72 28 70 50 61 67 65 72 29 3b 0a 20 20 69 66 28  r(pPager);.  if(
28a10 20 70 50 61 67 65 72 2d 3e 70 49 6e 53 74 6d 74   pPager->pInStmt
28a20 3d 3d 30 20 29 7b 0a 20 20 20 20 2f 2a 20 73 71  ==0 ){.    /* sq
28a30 6c 69 74 65 33 4f 73 4c 6f 63 6b 28 70 50 61 67  lite3OsLock(pPag
28a40 65 72 2d 3e 66 64 2c 20 53 48 41 52 45 44 5f 4c  er->fd, SHARED_L
28a50 4f 43 4b 29 3b 20 2a 2f 0a 20 20 20 20 72 65 74  OCK); */.    ret
28a60 75 72 6e 20 53 51 4c 49 54 45 5f 4e 4f 4d 45 4d  urn SQLITE_NOMEM
28a70 3b 0a 20 20 7d 0a 20 20 70 50 61 67 65 72 2d 3e  ;.  }.  pPager->
28a80 73 74 6d 74 4a 53 69 7a 65 20 3d 20 70 50 61 67  stmtJSize = pPag
28a90 65 72 2d 3e 6a 6f 75 72 6e 61 6c 4f 66 66 3b 0a  er->journalOff;.
28aa0 20 20 70 50 61 67 65 72 2d 3e 73 74 6d 74 53 69    pPager->stmtSi
28ab0 7a 65 20 3d 20 70 50 61 67 65 72 2d 3e 64 62 53  ze = pPager->dbS
28ac0 69 7a 65 3b 0a 20 20 70 50 61 67 65 72 2d 3e 73  ize;.  pPager->s
28ad0 74 6d 74 48 64 72 4f 66 66 20 3d 20 30 3b 0a 20  tmtHdrOff = 0;. 
28ae0 20 70 50 61 67 65 72 2d 3e 73 74 6d 74 43 6b 73   pPager->stmtCks
28af0 75 6d 20 3d 20 70 50 61 67 65 72 2d 3e 63 6b 73  um = pPager->cks
28b00 75 6d 49 6e 69 74 3b 0a 20 20 69 66 28 20 21 70  umInit;.  if( !p
28b10 50 61 67 65 72 2d 3e 73 74 6d 74 4f 70 65 6e 20  Pager->stmtOpen 
28b20 29 7b 0a 20 20 20 20 72 63 20 3d 20 73 71 6c 69  ){.    rc = sqli
28b30 74 65 33 50 61 67 65 72 4f 70 65 6e 74 65 6d 70  te3PagerOpentemp
28b40 28 70 50 61 67 65 72 2d 3e 70 56 66 73 2c 20 70  (pPager->pVfs, p
28b50 50 61 67 65 72 2d 3e 73 74 66 64 2c 20 70 50 61  Pager->stfd, pPa
28b60 67 65 72 2d 3e 7a 53 74 6d 74 4a 72 6e 6c 2c 0a  ger->zStmtJrnl,.
28b70 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
28b80 20 20 20 20 20 20 20 20 20 20 20 20 20 20 53 51                SQ
28b90 4c 49 54 45 5f 4f 50 45 4e 5f 53 55 42 4a 4f 55  LITE_OPEN_SUBJOU
28ba0 52 4e 41 4c 29 3b 0a 20 20 20 20 69 66 28 20 72  RNAL);.    if( r
28bb0 63 20 29 7b 0a 20 20 20 20 20 20 67 6f 74 6f 20  c ){.      goto 
28bc0 73 74 6d 74 5f 62 65 67 69 6e 5f 66 61 69 6c 65  stmt_begin_faile
28bd0 64 3b 0a 20 20 20 20 7d 0a 20 20 20 20 70 50 61  d;.    }.    pPa
28be0 67 65 72 2d 3e 73 74 6d 74 4f 70 65 6e 20 3d 20  ger->stmtOpen = 
28bf0 31 3b 0a 20 20 20 20 70 50 61 67 65 72 2d 3e 73  1;.    pPager->s
28c00 74 6d 74 4e 52 65 63 20 3d 20 30 3b 0a 20 20 7d  tmtNRec = 0;.  }
28c10 0a 20 20 70 50 61 67 65 72 2d 3e 73 74 6d 74 49  .  pPager->stmtI
28c20 6e 55 73 65 20 3d 20 31 3b 0a 20 20 72 65 74 75  nUse = 1;.  retu
28c30 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20 0a  rn SQLITE_OK;. .
28c40 73 74 6d 74 5f 62 65 67 69 6e 5f 66 61 69 6c 65  stmt_begin_faile
28c50 64 3a 0a 20 20 69 66 28 20 70 50 61 67 65 72 2d  d:.  if( pPager-
28c60 3e 70 49 6e 53 74 6d 74 20 29 7b 0a 20 20 20 20  >pInStmt ){.    
28c70 73 71 6c 69 74 65 33 42 69 74 76 65 63 44 65 73  sqlite3BitvecDes
28c80 74 72 6f 79 28 70 50 61 67 65 72 2d 3e 70 49 6e  troy(pPager->pIn
28c90 53 74 6d 74 29 3b 0a 20 20 20 20 70 50 61 67 65  Stmt);.    pPage
28ca0 72 2d 3e 70 49 6e 53 74 6d 74 20 3d 20 30 3b 0a  r->pInStmt = 0;.
28cb0 20 20 7d 0a 20 20 72 65 74 75 72 6e 20 72 63 3b    }.  return rc;
28cc0 0a 7d 0a 69 6e 74 20 73 71 6c 69 74 65 33 50 61  .}.int sqlite3Pa
28cd0 67 65 72 53 74 6d 74 42 65 67 69 6e 28 50 61 67  gerStmtBegin(Pag
28ce0 65 72 20 2a 70 50 61 67 65 72 29 7b 0a 20 20 69  er *pPager){.  i
28cf0 6e 74 20 72 63 3b 0a 20 20 70 61 67 65 72 45 6e  nt rc;.  pagerEn
28d00 74 65 72 28 70 50 61 67 65 72 29 3b 0a 20 20 72  ter(pPager);.  r
28d10 63 20 3d 20 70 61 67 65 72 53 74 6d 74 42 65 67  c = pagerStmtBeg
28d20 69 6e 28 70 50 61 67 65 72 29 3b 0a 20 20 70 61  in(pPager);.  pa
28d30 67 65 72 4c 65 61 76 65 28 70 50 61 67 65 72 29  gerLeave(pPager)
28d40 3b 0a 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 7d  ;.  return rc;.}
28d50 0a 0a 2f 2a 0a 2a 2a 20 43 6f 6d 6d 69 74 20 61  ../*.** Commit a
28d60 20 73 74 61 74 65 6d 65 6e 74 2e 0a 2a 2f 0a 69   statement..*/.i
28d70 6e 74 20 73 71 6c 69 74 65 33 50 61 67 65 72 53  nt sqlite3PagerS
28d80 74 6d 74 43 6f 6d 6d 69 74 28 50 61 67 65 72 20  tmtCommit(Pager 
28d90 2a 70 50 61 67 65 72 29 7b 0a 20 20 70 61 67 65  *pPager){.  page
28da0 72 45 6e 74 65 72 28 70 50 61 67 65 72 29 3b 0a  rEnter(pPager);.
28db0 20 20 69 66 28 20 70 50 61 67 65 72 2d 3e 73 74    if( pPager->st
28dc0 6d 74 49 6e 55 73 65 20 29 7b 0a 20 20 20 20 50  mtInUse ){.    P
28dd0 67 48 64 72 20 2a 70 50 67 2c 20 2a 70 4e 65 78  gHdr *pPg, *pNex
28de0 74 3b 0a 20 20 20 20 50 41 47 45 52 54 52 41 43  t;.    PAGERTRAC
28df0 45 32 28 22 53 54 4d 54 2d 43 4f 4d 4d 49 54 20  E2("STMT-COMMIT 
28e00 25 64 5c 6e 22 2c 20 50 41 47 45 52 49 44 28 70  %d\n", PAGERID(p
28e10 50 61 67 65 72 29 29 3b 0a 20 20 20 20 69 66 28  Pager));.    if(
28e20 20 21 4d 45 4d 44 42 20 29 7b 0a 20 20 20 20 20   !MEMDB ){.     
28e30 20 2f 2a 20 73 71 6c 69 74 65 33 4f 73 54 72 75   /* sqlite3OsTru
28e40 6e 63 61 74 65 28 70 50 61 67 65 72 2d 3e 73 74  ncate(pPager->st
28e50 66 64 2c 20 30 29 3b 20 2a 2f 0a 20 20 20 20 20  fd, 0); */.     
28e60 20 73 71 6c 69 74 65 33 42 69 74 76 65 63 44 65   sqlite3BitvecDe
28e70 73 74 72 6f 79 28 70 50 61 67 65 72 2d 3e 70 49  stroy(pPager->pI
28e80 6e 53 74 6d 74 29 3b 0a 20 20 20 20 20 20 70 50  nStmt);.      pP
28e90 61 67 65 72 2d 3e 70 49 6e 53 74 6d 74 20 3d 20  ager->pInStmt = 
28ea0 30 3b 0a 20 20 20 20 7d 65 6c 73 65 7b 0a 20 20  0;.    }else{.  
28eb0 20 20 20 20 66 6f 72 28 70 50 67 3d 70 50 61 67      for(pPg=pPag
28ec0 65 72 2d 3e 70 53 74 6d 74 3b 20 70 50 67 3b 20  er->pStmt; pPg; 
28ed0 70 50 67 3d 70 4e 65 78 74 29 7b 0a 20 20 20 20  pPg=pNext){.    
28ee0 20 20 20 20 50 67 48 69 73 74 6f 72 79 20 2a 70      PgHistory *p
28ef0 48 69 73 74 20 3d 20 50 47 48 44 52 5f 54 4f 5f  Hist = PGHDR_TO_
28f00 48 49 53 54 28 70 50 67 2c 20 70 50 61 67 65 72  HIST(pPg, pPager
28f10 29 3b 0a 20 20 20 20 20 20 20 20 70 4e 65 78 74  );.        pNext
28f20 20 3d 20 70 48 69 73 74 2d 3e 70 4e 65 78 74 53   = pHist->pNextS
28f30 74 6d 74 3b 0a 20 20 20 20 20 20 20 20 61 73 73  tmt;.        ass
28f40 65 72 74 28 20 70 48 69 73 74 2d 3e 69 6e 53 74  ert( pHist->inSt
28f50 6d 74 20 29 3b 0a 20 20 20 20 20 20 20 20 70 48  mt );.        pH
28f60 69 73 74 2d 3e 69 6e 53 74 6d 74 20 3d 20 30 3b  ist->inStmt = 0;
28f70 0a 20 20 20 20 20 20 20 20 70 48 69 73 74 2d 3e  .        pHist->
28f80 70 50 72 65 76 53 74 6d 74 20 3d 20 70 48 69 73  pPrevStmt = pHis
28f90 74 2d 3e 70 4e 65 78 74 53 74 6d 74 20 3d 20 30  t->pNextStmt = 0
28fa0 3b 0a 20 20 20 20 20 20 20 20 73 71 6c 69 74 65  ;.        sqlite
28fb0 33 5f 66 72 65 65 28 70 48 69 73 74 2d 3e 70 53  3_free(pHist->pS
28fc0 74 6d 74 29 3b 0a 20 20 20 20 20 20 20 20 70 48  tmt);.        pH
28fd0 69 73 74 2d 3e 70 53 74 6d 74 20 3d 20 30 3b 0a  ist->pStmt = 0;.
28fe0 20 20 20 20 20 20 7d 0a 20 20 20 20 7d 0a 20 20        }.    }.  
28ff0 20 20 70 50 61 67 65 72 2d 3e 73 74 6d 74 4e 52    pPager->stmtNR
29000 65 63 20 3d 20 30 3b 0a 20 20 20 20 70 50 61 67  ec = 0;.    pPag
29010 65 72 2d 3e 73 74 6d 74 49 6e 55 73 65 20 3d 20  er->stmtInUse = 
29020 30 3b 0a 20 20 20 20 70 50 61 67 65 72 2d 3e 70  0;.    pPager->p
29030 53 74 6d 74 20 3d 20 30 3b 0a 20 20 7d 0a 20 20  Stmt = 0;.  }.  
29040 70 50 61 67 65 72 2d 3e 73 74 6d 74 41 75 74 6f  pPager->stmtAuto
29050 6f 70 65 6e 20 3d 20 30 3b 0a 20 20 70 61 67 65  open = 0;.  page
29060 72 4c 65 61 76 65 28 70 50 61 67 65 72 29 3b 0a  rLeave(pPager);.
29070 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f    return SQLITE_
29080 4f 4b 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 52 6f 6c  OK;.}../*.** Rol
29090 6c 62 61 63 6b 20 61 20 73 74 61 74 65 6d 65 6e  lback a statemen
290a0 74 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65  t..*/.int sqlite
290b0 33 50 61 67 65 72 53 74 6d 74 52 6f 6c 6c 62 61  3PagerStmtRollba
290c0 63 6b 28 50 61 67 65 72 20 2a 70 50 61 67 65 72  ck(Pager *pPager
290d0 29 7b 0a 20 20 69 6e 74 20 72 63 3b 0a 20 20 70  ){.  int rc;.  p
290e0 61 67 65 72 45 6e 74 65 72 28 70 50 61 67 65 72  agerEnter(pPager
290f0 29 3b 0a 20 20 69 66 28 20 70 50 61 67 65 72 2d  );.  if( pPager-
29100 3e 73 74 6d 74 49 6e 55 73 65 20 29 7b 0a 20 20  >stmtInUse ){.  
29110 20 20 50 41 47 45 52 54 52 41 43 45 32 28 22 53    PAGERTRACE2("S
29120 54 4d 54 2d 52 4f 4c 4c 42 41 43 4b 20 25 64 5c  TMT-ROLLBACK %d\
29130 6e 22 2c 20 50 41 47 45 52 49 44 28 70 50 61 67  n", PAGERID(pPag
29140 65 72 29 29 3b 0a 20 20 20 20 69 66 28 20 4d 45  er));.    if( ME
29150 4d 44 42 20 29 7b 0a 20 20 20 20 20 20 50 67 48  MDB ){.      PgH
29160 64 72 20 2a 70 50 67 3b 0a 20 20 20 20 20 20 50  dr *pPg;.      P
29170 67 48 69 73 74 6f 72 79 20 2a 70 48 69 73 74 3b  gHistory *pHist;
29180 0a 20 20 20 20 20 20 66 6f 72 28 70 50 67 3d 70  .      for(pPg=p
29190 50 61 67 65 72 2d 3e 70 53 74 6d 74 3b 20 70 50  Pager->pStmt; pP
291a0 67 3b 20 70 50 67 3d 70 48 69 73 74 2d 3e 70 4e  g; pPg=pHist->pN
291b0 65 78 74 53 74 6d 74 29 7b 0a 20 20 20 20 20 20  extStmt){.      
291c0 20 20 70 48 69 73 74 20 3d 20 50 47 48 44 52 5f    pHist = PGHDR_
291d0 54 4f 5f 48 49 53 54 28 70 50 67 2c 20 70 50 61  TO_HIST(pPg, pPa
291e0 67 65 72 29 3b 0a 20 20 20 20 20 20 20 20 69 66  ger);.        if
291f0 28 20 70 48 69 73 74 2d 3e 70 53 74 6d 74 20 29  ( pHist->pStmt )
29200 7b 0a 20 20 20 20 20 20 20 20 20 20 6d 65 6d 63  {.          memc
29210 70 79 28 50 47 48 44 52 5f 54 4f 5f 44 41 54 41  py(PGHDR_TO_DATA
29220 28 70 50 67 29 2c 20 70 48 69 73 74 2d 3e 70 53  (pPg), pHist->pS
29230 74 6d 74 2c 20 70 50 61 67 65 72 2d 3e 70 61 67  tmt, pPager->pag
29240 65 53 69 7a 65 29 3b 0a 20 20 20 20 20 20 20 20  eSize);.        
29250 20 20 73 71 6c 69 74 65 33 5f 66 72 65 65 28 70    sqlite3_free(p
29260 48 69 73 74 2d 3e 70 53 74 6d 74 29 3b 0a 20 20  Hist->pStmt);.  
29270 20 20 20 20 20 20 20 20 70 48 69 73 74 2d 3e 70          pHist->p
29280 53 74 6d 74 20 3d 20 30 3b 0a 20 20 20 20 20 20  Stmt = 0;.      
29290 20 20 7d 0a 20 20 20 20 20 20 7d 0a 20 20 20 20    }.      }.    
292a0 20 20 70 50 61 67 65 72 2d 3e 64 62 53 69 7a 65    pPager->dbSize
292b0 20 3d 20 70 50 61 67 65 72 2d 3e 73 74 6d 74 53   = pPager->stmtS
292c0 69 7a 65 3b 0a 20 20 20 20 20 20 70 61 67 65 72  ize;.      pager
292d0 5f 74 72 75 6e 63 61 74 65 5f 63 61 63 68 65 28  _truncate_cache(
292e0 70 50 61 67 65 72 29 3b 0a 20 20 20 20 20 20 72  pPager);.      r
292f0 63 20 3d 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20  c = SQLITE_OK;. 
29300 20 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 20 20     }else{.      
29310 72 63 20 3d 20 70 61 67 65 72 5f 73 74 6d 74 5f  rc = pager_stmt_
29320 70 6c 61 79 62 61 63 6b 28 70 50 61 67 65 72 29  playback(pPager)
29330 3b 0a 20 20 20 20 7d 0a 20 20 20 20 73 71 6c 69  ;.    }.    sqli
29340 74 65 33 50 61 67 65 72 53 74 6d 74 43 6f 6d 6d  te3PagerStmtComm
29350 69 74 28 70 50 61 67 65 72 29 3b 0a 20 20 7d 65  it(pPager);.  }e
29360 6c 73 65 7b 0a 20 20 20 20 72 63 20 3d 20 53 51  lse{.    rc = SQ
29370 4c 49 54 45 5f 4f 4b 3b 0a 20 20 7d 0a 20 20 70  LITE_OK;.  }.  p
29380 50 61 67 65 72 2d 3e 73 74 6d 74 41 75 74 6f 6f  Pager->stmtAutoo
29390 70 65 6e 20 3d 20 30 3b 0a 20 20 70 61 67 65 72  pen = 0;.  pager
293a0 4c 65 61 76 65 28 70 50 61 67 65 72 29 3b 0a 20  Leave(pPager);. 
293b0 20 72 65 74 75 72 6e 20 72 63 3b 0a 7d 0a 0a 2f   return rc;.}../
293c0 2a 0a 2a 2a 20 52 65 74 75 72 6e 20 74 68 65 20  *.** Return the 
293d0 66 75 6c 6c 20 70 61 74 68 6e 61 6d 65 20 6f 66  full pathname of
293e0 20 74 68 65 20 64 61 74 61 62 61 73 65 20 66 69   the database fi
293f0 6c 65 2e 0a 2a 2f 0a 63 6f 6e 73 74 20 63 68 61  le..*/.const cha
29400 72 20 2a 73 71 6c 69 74 65 33 50 61 67 65 72 46  r *sqlite3PagerF
29410 69 6c 65 6e 61 6d 65 28 50 61 67 65 72 20 2a 70  ilename(Pager *p
29420 50 61 67 65 72 29 7b 0a 20 20 72 65 74 75 72 6e  Pager){.  return
29430 20 70 50 61 67 65 72 2d 3e 7a 46 69 6c 65 6e 61   pPager->zFilena
29440 6d 65 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 52 65 74  me;.}../*.** Ret
29450 75 72 6e 20 74 68 65 20 56 46 53 20 73 74 72 75  urn the VFS stru
29460 63 74 75 72 65 20 66 6f 72 20 74 68 65 20 70 61  cture for the pa
29470 67 65 72 2e 0a 2a 2f 0a 63 6f 6e 73 74 20 73 71  ger..*/.const sq
29480 6c 69 74 65 33 5f 76 66 73 20 2a 73 71 6c 69 74  lite3_vfs *sqlit
29490 65 33 50 61 67 65 72 56 66 73 28 50 61 67 65 72  e3PagerVfs(Pager
294a0 20 2a 70 50 61 67 65 72 29 7b 0a 20 20 72 65 74   *pPager){.  ret
294b0 75 72 6e 20 70 50 61 67 65 72 2d 3e 70 56 66 73  urn pPager->pVfs
294c0 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 52 65 74 75 72  ;.}../*.** Retur
294d0 6e 20 74 68 65 20 66 69 6c 65 20 68 61 6e 64 6c  n the file handl
294e0 65 20 66 6f 72 20 74 68 65 20 64 61 74 61 62 61  e for the databa
294f0 73 65 20 66 69 6c 65 20 61 73 73 6f 63 69 61 74  se file associat
29500 65 64 0a 2a 2a 20 77 69 74 68 20 74 68 65 20 70  ed.** with the p
29510 61 67 65 72 2e 20 20 54 68 69 73 20 6d 69 67 68  ager.  This migh
29520 74 20 72 65 74 75 72 6e 20 4e 55 4c 4c 20 69 66  t return NULL if
29530 20 74 68 65 20 66 69 6c 65 20 68 61 73 0a 2a 2a   the file has.**
29540 20 6e 6f 74 20 79 65 74 20 62 65 65 6e 20 6f 70   not yet been op
29550 65 6e 65 64 2e 0a 2a 2f 0a 73 71 6c 69 74 65 33  ened..*/.sqlite3
29560 5f 66 69 6c 65 20 2a 73 71 6c 69 74 65 33 50 61  _file *sqlite3Pa
29570 67 65 72 46 69 6c 65 28 50 61 67 65 72 20 2a 70  gerFile(Pager *p
29580 50 61 67 65 72 29 7b 0a 20 20 72 65 74 75 72 6e  Pager){.  return
29590 20 70 50 61 67 65 72 2d 3e 66 64 3b 0a 7d 0a 0a   pPager->fd;.}..
295a0 2f 2a 0a 2a 2a 20 52 65 74 75 72 6e 20 74 68 65  /*.** Return the
295b0 20 64 69 72 65 63 74 6f 72 79 20 6f 66 20 74 68   directory of th
295c0 65 20 64 61 74 61 62 61 73 65 20 66 69 6c 65 2e  e database file.
295d0 0a 2a 2f 0a 63 6f 6e 73 74 20 63 68 61 72 20 2a  .*/.const char *
295e0 73 71 6c 69 74 65 33 50 61 67 65 72 44 69 72 6e  sqlite3PagerDirn
295f0 61 6d 65 28 50 61 67 65 72 20 2a 70 50 61 67 65  ame(Pager *pPage
29600 72 29 7b 0a 20 20 72 65 74 75 72 6e 20 70 50 61  r){.  return pPa
29610 67 65 72 2d 3e 7a 44 69 72 65 63 74 6f 72 79 3b  ger->zDirectory;
29620 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 52 65 74 75 72 6e  .}../*.** Return
29630 20 74 68 65 20 66 75 6c 6c 20 70 61 74 68 6e 61   the full pathna
29640 6d 65 20 6f 66 20 74 68 65 20 6a 6f 75 72 6e 61  me of the journa
29650 6c 20 66 69 6c 65 2e 0a 2a 2f 0a 63 6f 6e 73 74  l file..*/.const
29660 20 63 68 61 72 20 2a 73 71 6c 69 74 65 33 50 61   char *sqlite3Pa
29670 67 65 72 4a 6f 75 72 6e 61 6c 6e 61 6d 65 28 50  gerJournalname(P
29680 61 67 65 72 20 2a 70 50 61 67 65 72 29 7b 0a 20  ager *pPager){. 
29690 20 72 65 74 75 72 6e 20 70 50 61 67 65 72 2d 3e   return pPager->
296a0 7a 4a 6f 75 72 6e 61 6c 3b 0a 7d 0a 0a 2f 2a 0a  zJournal;.}../*.
296b0 2a 2a 20 52 65 74 75 72 6e 20 74 72 75 65 20 69  ** Return true i
296c0 66 20 66 73 79 6e 63 28 29 20 63 61 6c 6c 73 20  f fsync() calls 
296d0 61 72 65 20 64 69 73 61 62 6c 65 64 20 66 6f 72  are disabled for
296e0 20 74 68 69 73 20 70 61 67 65 72 2e 20 20 52 65   this pager.  Re
296f0 74 75 72 6e 20 46 41 4c 53 45 0a 2a 2a 20 69 66  turn FALSE.** if
29700 20 66 73 79 6e 63 28 29 73 20 61 72 65 20 65 78   fsync()s are ex
29710 65 63 75 74 65 64 20 6e 6f 72 6d 61 6c 6c 79 2e  ecuted normally.
29720 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 50  .*/.int sqlite3P
29730 61 67 65 72 4e 6f 73 79 6e 63 28 50 61 67 65 72  agerNosync(Pager
29740 20 2a 70 50 61 67 65 72 29 7b 0a 20 20 72 65 74   *pPager){.  ret
29750 75 72 6e 20 70 50 61 67 65 72 2d 3e 6e 6f 53 79  urn pPager->noSy
29760 6e 63 3b 0a 7d 0a 0a 23 69 66 64 65 66 20 53 51  nc;.}..#ifdef SQ
29770 4c 49 54 45 5f 48 41 53 5f 43 4f 44 45 43 0a 2f  LITE_HAS_CODEC./
29780 2a 0a 2a 2a 20 53 65 74 20 74 68 65 20 63 6f 64  *.** Set the cod
29790 65 63 20 66 6f 72 20 74 68 69 73 20 70 61 67 65  ec for this page
297a0 72 0a 2a 2f 0a 76 6f 69 64 20 73 71 6c 69 74 65  r.*/.void sqlite
297b0 33 50 61 67 65 72 53 65 74 43 6f 64 65 63 28 0a  3PagerSetCodec(.
297c0 20 20 50 61 67 65 72 20 2a 70 50 61 67 65 72 2c    Pager *pPager,
297d0 0a 20 20 76 6f 69 64 20 2a 28 2a 78 43 6f 64 65  .  void *(*xCode
297e0 63 29 28 76 6f 69 64 2a 2c 76 6f 69 64 2a 2c 50  c)(void*,void*,P
297f0 67 6e 6f 2c 69 6e 74 29 2c 0a 20 20 76 6f 69 64  gno,int),.  void
29800 20 2a 70 43 6f 64 65 63 41 72 67 0a 29 7b 0a 20   *pCodecArg.){. 
29810 20 70 50 61 67 65 72 2d 3e 78 43 6f 64 65 63 20   pPager->xCodec 
29820 3d 20 78 43 6f 64 65 63 3b 0a 20 20 70 50 61 67  = xCodec;.  pPag
29830 65 72 2d 3e 70 43 6f 64 65 63 41 72 67 20 3d 20  er->pCodecArg = 
29840 70 43 6f 64 65 63 41 72 67 3b 0a 7d 0a 23 65 6e  pCodecArg;.}.#en
29850 64 69 66 0a 0a 23 69 66 6e 64 65 66 20 53 51 4c  dif..#ifndef SQL
29860 49 54 45 5f 4f 4d 49 54 5f 41 55 54 4f 56 41 43  ITE_OMIT_AUTOVAC
29870 55 55 4d 0a 2f 2a 0a 2a 2a 20 4d 6f 76 65 20 74  UUM./*.** Move t
29880 68 65 20 70 61 67 65 20 70 50 67 20 74 6f 20 6c  he page pPg to l
29890 6f 63 61 74 69 6f 6e 20 70 67 6e 6f 20 69 6e 20  ocation pgno in 
298a0 74 68 65 20 66 69 6c 65 2e 0a 2a 2a 0a 2a 2a 20  the file..**.** 
298b0 54 68 65 72 65 20 6d 75 73 74 20 62 65 20 6e 6f  There must be no
298c0 20 72 65 66 65 72 65 6e 63 65 73 20 74 6f 20 74   references to t
298d0 68 65 20 70 61 67 65 20 70 72 65 76 69 6f 75 73  he page previous
298e0 6c 79 20 6c 6f 63 61 74 65 64 20 61 74 0a 2a 2a  ly located at.**
298f0 20 70 67 6e 6f 20 28 77 68 69 63 68 20 77 65 20   pgno (which we 
29900 63 61 6c 6c 20 70 50 67 4f 6c 64 29 20 74 68 6f  call pPgOld) tho
29910 75 67 68 20 74 68 61 74 20 70 61 67 65 20 69 73  ugh that page is
29920 20 61 6c 6c 6f 77 65 64 20 74 6f 20 62 65 0a 2a   allowed to be.*
29930 2a 20 69 6e 20 63 61 63 68 65 2e 20 20 49 66 20  * in cache.  If 
29940 74 68 65 20 70 61 67 65 20 70 72 65 76 69 6f 75  the page previou
29950 73 20 6c 6f 63 61 74 65 64 20 61 74 20 70 67 6e  s located at pgn
29960 6f 20 69 73 20 6e 6f 74 20 61 6c 72 65 61 64 79  o is not already
29970 0a 2a 2a 20 69 6e 20 74 68 65 20 72 6f 6c 6c 62  .** in the rollb
29980 61 63 6b 20 6a 6f 75 72 6e 61 6c 2c 20 69 74 20  ack journal, it 
29990 69 73 20 6e 6f 74 20 70 75 74 20 74 68 65 72 65  is not put there
299a0 20 62 79 20 62 79 20 74 68 69 73 20 72 6f 75 74   by by this rout
299b0 69 6e 65 2e 0a 2a 2a 0a 2a 2a 20 52 65 66 65 72  ine..**.** Refer
299c0 65 6e 63 65 73 20 74 6f 20 74 68 65 20 70 61 67  ences to the pag
299d0 65 20 70 50 67 20 72 65 6d 61 69 6e 20 76 61 6c  e pPg remain val
299e0 69 64 2e 20 55 70 64 61 74 69 6e 67 20 61 6e 79  id. Updating any
299f0 0a 2a 2a 20 6d 65 74 61 2d 64 61 74 61 20 61 73  .** meta-data as
29a00 73 6f 63 69 61 74 65 64 20 77 69 74 68 20 70 50  sociated with pP
29a10 67 20 28 69 2e 65 2e 20 64 61 74 61 20 73 74 6f  g (i.e. data sto
29a20 72 65 64 20 69 6e 20 74 68 65 20 6e 45 78 74 72  red in the nExtr
29a30 61 20 62 79 74 65 73 0a 2a 2a 20 61 6c 6c 6f 63  a bytes.** alloc
29a40 61 74 65 64 20 61 6c 6f 6e 67 20 77 69 74 68 20  ated along with 
29a50 74 68 65 20 70 61 67 65 29 20 69 73 20 74 68 65  the page) is the
29a60 20 72 65 73 70 6f 6e 73 69 62 69 6c 69 74 79 20   responsibility 
29a70 6f 66 20 74 68 65 20 63 61 6c 6c 65 72 2e 0a 2a  of the caller..*
29a80 2a 0a 2a 2a 20 41 20 74 72 61 6e 73 61 63 74 69  *.** A transacti
29a90 6f 6e 20 6d 75 73 74 20 62 65 20 61 63 74 69 76  on must be activ
29aa0 65 20 77 68 65 6e 20 74 68 69 73 20 72 6f 75 74  e when this rout
29ab0 69 6e 65 20 69 73 20 63 61 6c 6c 65 64 2e 20 49  ine is called. I
29ac0 74 20 75 73 65 64 20 74 6f 20 62 65 0a 2a 2a 20  t used to be.** 
29ad0 72 65 71 75 69 72 65 64 20 74 68 61 74 20 61 20  required that a 
29ae0 73 74 61 74 65 6d 65 6e 74 20 74 72 61 6e 73 61  statement transa
29af0 63 74 69 6f 6e 20 77 61 73 20 6e 6f 74 20 61 63  ction was not ac
29b00 74 69 76 65 2c 20 62 75 74 20 74 68 69 73 20 72  tive, but this r
29b10 65 73 74 72 69 63 74 69 6f 6e 0a 2a 2a 20 68 61  estriction.** ha
29b20 73 20 62 65 65 6e 20 72 65 6d 6f 76 65 64 20 28  s been removed (
29b30 43 52 45 41 54 45 20 49 4e 44 45 58 20 6e 65 65  CREATE INDEX nee
29b40 64 73 20 74 6f 20 6d 6f 76 65 20 61 20 70 61 67  ds to move a pag
29b50 65 20 77 68 65 6e 20 61 20 73 74 61 74 65 6d 65  e when a stateme
29b60 6e 74 0a 2a 2a 20 74 72 61 6e 73 61 63 74 69 6f  nt.** transactio
29b70 6e 20 69 73 20 61 63 74 69 76 65 29 2e 0a 2a 2f  n is active)..*/
29b80 0a 69 6e 74 20 73 71 6c 69 74 65 33 50 61 67 65  .int sqlite3Page
29b90 72 4d 6f 76 65 70 61 67 65 28 50 61 67 65 72 20  rMovepage(Pager 
29ba0 2a 70 50 61 67 65 72 2c 20 44 62 50 61 67 65 20  *pPager, DbPage 
29bb0 2a 70 50 67 2c 20 50 67 6e 6f 20 70 67 6e 6f 29  *pPg, Pgno pgno)
29bc0 7b 0a 20 20 50 67 48 64 72 20 2a 70 50 67 4f 6c  {.  PgHdr *pPgOl
29bd0 64 3b 20 20 2f 2a 20 54 68 65 20 70 61 67 65 20  d;  /* The page 
29be0 62 65 69 6e 67 20 6f 76 65 72 77 72 69 74 74 65  being overwritte
29bf0 6e 2e 20 2a 2f 0a 20 20 69 6e 74 20 68 3b 0a 20  n. */.  int h;. 
29c00 20 50 67 6e 6f 20 6e 65 65 64 53 79 6e 63 50 67   Pgno needSyncPg
29c10 6e 6f 20 3d 20 30 3b 0a 0a 20 20 70 61 67 65 72  no = 0;..  pager
29c20 45 6e 74 65 72 28 70 50 61 67 65 72 29 3b 0a 20  Enter(pPager);. 
29c30 20 61 73 73 65 72 74 28 20 70 50 67 2d 3e 6e 52   assert( pPg->nR
29c40 65 66 3e 30 20 29 3b 0a 0a 20 20 50 41 47 45 52  ef>0 );..  PAGER
29c50 54 52 41 43 45 35 28 22 4d 4f 56 45 20 25 64 20  TRACE5("MOVE %d 
29c60 70 61 67 65 20 25 64 20 28 6e 65 65 64 53 79 6e  page %d (needSyn
29c70 63 3d 25 64 29 20 6d 6f 76 65 73 20 74 6f 20 25  c=%d) moves to %
29c80 64 5c 6e 22 2c 20 0a 20 20 20 20 20 20 50 41 47  d\n", .      PAG
29c90 45 52 49 44 28 70 50 61 67 65 72 29 2c 20 70 50  ERID(pPager), pP
29ca0 67 2d 3e 70 67 6e 6f 2c 20 70 50 67 2d 3e 6e 65  g->pgno, pPg->ne
29cb0 65 64 53 79 6e 63 2c 20 70 67 6e 6f 29 3b 0a 20  edSync, pgno);. 
29cc0 20 49 4f 54 52 41 43 45 28 28 22 4d 4f 56 45 20   IOTRACE(("MOVE 
29cd0 25 70 20 25 64 20 25 64 5c 6e 22 2c 20 70 50 61  %p %d %d\n", pPa
29ce0 67 65 72 2c 20 70 50 67 2d 3e 70 67 6e 6f 2c 20  ger, pPg->pgno, 
29cf0 70 67 6e 6f 29 29 0a 0a 20 20 70 61 67 65 72 5f  pgno))..  pager_
29d00 67 65 74 5f 63 6f 6e 74 65 6e 74 28 70 50 67 29  get_content(pPg)
29d10 3b 0a 20 20 69 66 28 20 70 50 67 2d 3e 6e 65 65  ;.  if( pPg->nee
29d20 64 53 79 6e 63 20 29 7b 0a 20 20 20 20 6e 65 65  dSync ){.    nee
29d30 64 53 79 6e 63 50 67 6e 6f 20 3d 20 70 50 67 2d  dSyncPgno = pPg-
29d40 3e 70 67 6e 6f 3b 0a 20 20 20 20 61 73 73 65 72  >pgno;.    asser
29d50 74 28 20 70 50 67 2d 3e 69 6e 4a 6f 75 72 6e 61  t( pPg->inJourna
29d60 6c 20 7c 7c 20 28 69 6e 74 29 70 67 6e 6f 3e 70  l || (int)pgno>p
29d70 50 61 67 65 72 2d 3e 6f 72 69 67 44 62 53 69 7a  Pager->origDbSiz
29d80 65 20 29 3b 0a 20 20 20 20 61 73 73 65 72 74 28  e );.    assert(
29d90 20 70 50 67 2d 3e 64 69 72 74 79 20 29 3b 0a 20   pPg->dirty );. 
29da0 20 20 20 61 73 73 65 72 74 28 20 70 50 61 67 65     assert( pPage
29db0 72 2d 3e 6e 65 65 64 53 79 6e 63 20 29 3b 0a 20  r->needSync );. 
29dc0 20 7d 0a 0a 20 20 2f 2a 20 55 6e 6c 69 6e 6b 20   }..  /* Unlink 
29dd0 70 50 67 20 66 72 6f 6d 20 69 74 73 20 68 61 73  pPg from its has
29de0 68 2d 63 68 61 69 6e 20 2a 2f 0a 20 20 75 6e 6c  h-chain */.  unl
29df0 69 6e 6b 48 61 73 68 43 68 61 69 6e 28 70 50 61  inkHashChain(pPa
29e00 67 65 72 2c 20 70 50 67 29 3b 0a 0a 20 20 2f 2a  ger, pPg);..  /*
29e10 20 49 66 20 74 68 65 20 63 61 63 68 65 20 63 6f   If the cache co
29e20 6e 74 61 69 6e 73 20 61 20 70 61 67 65 20 77 69  ntains a page wi
29e30 74 68 20 70 61 67 65 2d 6e 75 6d 62 65 72 20 70  th page-number p
29e40 67 6e 6f 2c 20 72 65 6d 6f 76 65 20 69 74 0a 20  gno, remove it. 
29e50 20 2a 2a 20 66 72 6f 6d 20 69 74 73 20 68 61 73   ** from its has
29e60 68 20 63 68 61 69 6e 2e 20 41 6c 73 6f 2c 20 69  h chain. Also, i
29e70 66 20 74 68 65 20 50 67 48 64 72 2e 6e 65 65 64  f the PgHdr.need
29e80 53 79 6e 63 20 77 61 73 20 73 65 74 20 66 6f 72  Sync was set for
29e90 20 0a 20 20 2a 2a 20 70 61 67 65 20 70 67 6e 6f   .  ** page pgno
29ea0 20 62 65 66 6f 72 65 20 74 68 65 20 27 6d 6f 76   before the 'mov
29eb0 65 27 20 6f 70 65 72 61 74 69 6f 6e 2c 20 69 74  e' operation, it
29ec0 20 6e 65 65 64 73 20 74 6f 20 62 65 20 72 65 74   needs to be ret
29ed0 61 69 6e 65 64 20 0a 20 20 2a 2a 20 66 6f 72 20  ained .  ** for 
29ee0 74 68 65 20 70 61 67 65 20 6d 6f 76 65 64 20 74  the page moved t
29ef0 68 65 72 65 2e 0a 20 20 2a 2f 0a 20 20 70 50 67  here..  */.  pPg
29f00 2d 3e 6e 65 65 64 53 79 6e 63 20 3d 20 30 3b 0a  ->needSync = 0;.
29f10 20 20 70 50 67 4f 6c 64 20 3d 20 70 61 67 65 72    pPgOld = pager
29f20 5f 6c 6f 6f 6b 75 70 28 70 50 61 67 65 72 2c 20  _lookup(pPager, 
29f30 70 67 6e 6f 29 3b 0a 20 20 69 66 28 20 70 50 67  pgno);.  if( pPg
29f40 4f 6c 64 20 29 7b 0a 20 20 20 20 61 73 73 65 72  Old ){.    asser
29f50 74 28 20 70 50 67 4f 6c 64 2d 3e 6e 52 65 66 3d  t( pPgOld->nRef=
29f60 3d 30 20 29 3b 0a 20 20 20 20 75 6e 6c 69 6e 6b  =0 );.    unlink
29f70 48 61 73 68 43 68 61 69 6e 28 70 50 61 67 65 72  HashChain(pPager
29f80 2c 20 70 50 67 4f 6c 64 29 3b 0a 20 20 20 20 6d  , pPgOld);.    m
29f90 61 6b 65 43 6c 65 61 6e 28 70 50 67 4f 6c 64 29  akeClean(pPgOld)
29fa0 3b 0a 20 20 20 20 70 50 67 2d 3e 6e 65 65 64 53  ;.    pPg->needS
29fb0 79 6e 63 20 3d 20 70 50 67 4f 6c 64 2d 3e 6e 65  ync = pPgOld->ne
29fc0 65 64 53 79 6e 63 3b 0a 20 20 7d 65 6c 73 65 7b  edSync;.  }else{
29fd0 0a 20 20 20 20 70 50 67 2d 3e 6e 65 65 64 53 79  .    pPg->needSy
29fe0 6e 63 20 3d 20 30 3b 0a 20 20 7d 0a 20 20 70 50  nc = 0;.  }.  pP
29ff0 67 2d 3e 69 6e 4a 6f 75 72 6e 61 6c 20 3d 20 73  g->inJournal = s
2a000 71 6c 69 74 65 33 42 69 74 76 65 63 54 65 73 74  qlite3BitvecTest
2a010 28 70 50 61 67 65 72 2d 3e 70 49 6e 4a 6f 75 72  (pPager->pInJour
2a020 6e 61 6c 2c 20 70 67 6e 6f 29 3b 0a 0a 20 20 2f  nal, pgno);..  /
2a030 2a 20 43 68 61 6e 67 65 20 74 68 65 20 70 61 67  * Change the pag
2a040 65 20 6e 75 6d 62 65 72 20 66 6f 72 20 70 50 67  e number for pPg
2a050 20 61 6e 64 20 69 6e 73 65 72 74 20 69 74 20 69   and insert it i
2a060 6e 74 6f 20 74 68 65 20 6e 65 77 20 68 61 73 68  nto the new hash
2a070 2d 63 68 61 69 6e 2e 20 2a 2f 0a 20 20 61 73 73  -chain. */.  ass
2a080 65 72 74 28 20 70 67 6e 6f 21 3d 30 20 29 3b 0a  ert( pgno!=0 );.
2a090 20 20 70 50 67 2d 3e 70 67 6e 6f 20 3d 20 70 67    pPg->pgno = pg
2a0a0 6e 6f 3b 0a 20 20 68 20 3d 20 70 67 6e 6f 20 26  no;.  h = pgno &
2a0b0 20 28 70 50 61 67 65 72 2d 3e 6e 48 61 73 68 2d   (pPager->nHash-
2a0c0 31 29 3b 0a 20 20 69 66 28 20 70 50 61 67 65 72  1);.  if( pPager
2a0d0 2d 3e 61 48 61 73 68 5b 68 5d 20 29 7b 0a 20 20  ->aHash[h] ){.  
2a0e0 20 20 61 73 73 65 72 74 28 20 70 50 61 67 65 72    assert( pPager
2a0f0 2d 3e 61 48 61 73 68 5b 68 5d 2d 3e 70 50 72 65  ->aHash[h]->pPre
2a100 76 48 61 73 68 3d 3d 30 20 29 3b 0a 20 20 20 20  vHash==0 );.    
2a110 70 50 61 67 65 72 2d 3e 61 48 61 73 68 5b 68 5d  pPager->aHash[h]
2a120 2d 3e 70 50 72 65 76 48 61 73 68 20 3d 20 70 50  ->pPrevHash = pP
2a130 67 3b 0a 20 20 7d 0a 20 20 70 50 67 2d 3e 70 4e  g;.  }.  pPg->pN
2a140 65 78 74 48 61 73 68 20 3d 20 70 50 61 67 65 72  extHash = pPager
2a150 2d 3e 61 48 61 73 68 5b 68 5d 3b 0a 20 20 70 50  ->aHash[h];.  pP
2a160 61 67 65 72 2d 3e 61 48 61 73 68 5b 68 5d 20 3d  ager->aHash[h] =
2a170 20 70 50 67 3b 0a 20 20 70 50 67 2d 3e 70 50 72   pPg;.  pPg->pPr
2a180 65 76 48 61 73 68 20 3d 20 30 3b 0a 0a 20 20 6d  evHash = 0;..  m
2a190 61 6b 65 44 69 72 74 79 28 70 50 67 29 3b 0a 20  akeDirty(pPg);. 
2a1a0 20 70 50 61 67 65 72 2d 3e 64 69 72 74 79 43 61   pPager->dirtyCa
2a1b0 63 68 65 20 3d 20 31 3b 0a 0a 20 20 69 66 28 20  che = 1;..  if( 
2a1c0 6e 65 65 64 53 79 6e 63 50 67 6e 6f 20 29 7b 0a  needSyncPgno ){.
2a1d0 20 20 20 20 2f 2a 20 49 66 20 6e 65 65 64 53 79      /* If needSy
2a1e0 6e 63 50 67 6e 6f 20 69 73 20 6e 6f 6e 2d 7a 65  ncPgno is non-ze
2a1f0 72 6f 2c 20 74 68 65 6e 20 74 68 65 20 6a 6f 75  ro, then the jou
2a200 72 6e 61 6c 20 66 69 6c 65 20 6e 65 65 64 73 20  rnal file needs 
2a210 74 6f 20 62 65 20 0a 20 20 20 20 2a 2a 20 73 79  to be .    ** sy
2a220 6e 63 28 29 65 64 20 62 65 66 6f 72 65 20 61 6e  nc()ed before an
2a230 79 20 64 61 74 61 20 69 73 20 77 72 69 74 74 65  y data is writte
2a240 6e 20 74 6f 20 64 61 74 61 62 61 73 65 20 66 69  n to database fi
2a250 6c 65 20 70 61 67 65 20 6e 65 65 64 53 79 6e 63  le page needSync
2a260 50 67 6e 6f 2e 0a 20 20 20 20 2a 2a 20 43 75 72  Pgno..    ** Cur
2a270 72 65 6e 74 6c 79 2c 20 6e 6f 20 73 75 63 68 20  rently, no such 
2a280 70 61 67 65 20 65 78 69 73 74 73 20 69 6e 20 74  page exists in t
2a290 68 65 20 70 61 67 65 2d 63 61 63 68 65 20 61 6e  he page-cache an
2a2a0 64 20 74 68 65 20 0a 20 20 20 20 2a 2a 20 50 61  d the .    ** Pa
2a2b0 67 65 72 2e 70 49 6e 4a 6f 75 72 6e 61 6c 20 62  ger.pInJournal b
2a2c0 69 74 20 68 61 73 20 62 65 65 6e 20 73 65 74 2e  it has been set.
2a2d0 20 54 68 69 73 20 6e 65 65 64 73 20 74 6f 20 62   This needs to b
2a2e0 65 20 72 65 6d 65 64 69 65 64 20 62 79 20 6c 6f  e remedied by lo
2a2f0 61 64 69 6e 67 0a 20 20 20 20 2a 2a 20 74 68 65  ading.    ** the
2a300 20 70 61 67 65 20 69 6e 74 6f 20 74 68 65 20 70   page into the p
2a310 61 67 65 72 2d 63 61 63 68 65 20 61 6e 64 20 73  ager-cache and s
2a320 65 74 74 69 6e 67 20 74 68 65 20 50 67 48 64 72  etting the PgHdr
2a330 2e 6e 65 65 64 53 79 6e 63 20 66 6c 61 67 2e 0a  .needSync flag..
2a340 20 20 20 20 2a 2a 0a 20 20 20 20 2a 2a 20 49 66      **.    ** If
2a350 20 74 68 65 20 61 74 74 65 6d 70 74 20 74 6f 20   the attempt to 
2a360 6c 6f 61 64 20 74 68 65 20 70 61 67 65 20 69 6e  load the page in
2a370 74 6f 20 74 68 65 20 70 61 67 65 2d 63 61 63 68  to the page-cach
2a380 65 20 66 61 69 6c 73 2c 20 28 64 75 65 0a 20 20  e fails, (due.  
2a390 20 20 2a 2a 20 74 6f 20 61 20 6d 61 6c 6c 6f 63    ** to a malloc
2a3a0 28 29 20 6f 72 20 49 4f 20 66 61 69 6c 75 72 65  () or IO failure
2a3b0 29 2c 20 63 6c 65 61 72 20 74 68 65 20 62 69 74  ), clear the bit
2a3c0 20 69 6e 20 74 68 65 20 70 49 6e 4a 6f 75 72 6e   in the pInJourn
2a3d0 61 6c 5b 5d 0a 20 20 20 20 2a 2a 20 61 72 72 61  al[].    ** arra
2a3e0 79 2e 20 4f 74 68 65 72 77 69 73 65 2c 20 69 66  y. Otherwise, if
2a3f0 20 74 68 65 20 70 61 67 65 20 69 73 20 6c 6f 61   the page is loa
2a400 64 65 64 20 61 6e 64 20 77 72 69 74 74 65 6e 20  ded and written 
2a410 61 67 61 69 6e 20 69 6e 0a 20 20 20 20 2a 2a 20  again in.    ** 
2a420 74 68 69 73 20 74 72 61 6e 73 61 63 74 69 6f 6e  this transaction
2a430 2c 20 69 74 20 6d 61 79 20 62 65 20 77 72 69 74  , it may be writ
2a440 74 65 6e 20 74 6f 20 74 68 65 20 64 61 74 61 62  ten to the datab
2a450 61 73 65 20 66 69 6c 65 20 62 65 66 6f 72 65 0a  ase file before.
2a460 20 20 20 20 2a 2a 20 69 74 20 69 73 20 73 79 6e      ** it is syn
2a470 63 65 64 20 69 6e 74 6f 20 74 68 65 20 6a 6f 75  ced into the jou
2a480 72 6e 61 6c 20 66 69 6c 65 2e 20 54 68 69 73 20  rnal file. This 
2a490 77 61 79 2c 20 69 74 20 6d 61 79 20 65 6e 64 20  way, it may end 
2a4a0 75 70 20 69 6e 0a 20 20 20 20 2a 2a 20 74 68 65  up in.    ** the
2a4b0 20 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 20 74 77   journal file tw
2a4c0 69 63 65 2c 20 62 75 74 20 74 68 61 74 20 69 73  ice, but that is
2a4d0 20 6e 6f 74 20 61 20 70 72 6f 62 6c 65 6d 2e 0a   not a problem..
2a4e0 20 20 20 20 2a 2a 0a 20 20 20 20 2a 2a 20 54 68      **.    ** Th
2a4f0 65 20 73 71 6c 69 74 65 33 50 61 67 65 72 47 65  e sqlite3PagerGe
2a500 74 28 29 20 63 61 6c 6c 20 6d 61 79 20 63 61 75  t() call may cau
2a510 73 65 20 74 68 65 20 6a 6f 75 72 6e 61 6c 20 74  se the journal t
2a520 6f 20 73 79 6e 63 2e 20 53 6f 20 6d 61 6b 65 0a  o sync. So make.
2a530 20 20 20 20 2a 2a 20 73 75 72 65 20 74 68 65 20      ** sure the 
2a540 50 61 67 65 72 2e 6e 65 65 64 53 79 6e 63 20 66  Pager.needSync f
2a550 6c 61 67 20 69 73 20 73 65 74 20 74 6f 6f 2e 0a  lag is set too..
2a560 20 20 20 20 2a 2f 0a 20 20 20 20 69 6e 74 20 72      */.    int r
2a570 63 3b 0a 20 20 20 20 50 67 48 64 72 20 2a 70 50  c;.    PgHdr *pP
2a580 67 48 64 72 3b 0a 20 20 20 20 61 73 73 65 72 74  gHdr;.    assert
2a590 28 20 70 50 61 67 65 72 2d 3e 6e 65 65 64 53 79  ( pPager->needSy
2a5a0 6e 63 20 29 3b 0a 20 20 20 20 72 63 20 3d 20 73  nc );.    rc = s
2a5b0 71 6c 69 74 65 33 50 61 67 65 72 47 65 74 28 70  qlite3PagerGet(p
2a5c0 50 61 67 65 72 2c 20 6e 65 65 64 53 79 6e 63 50  Pager, needSyncP
2a5d0 67 6e 6f 2c 20 26 70 50 67 48 64 72 29 3b 0a 20  gno, &pPgHdr);. 
2a5e0 20 20 20 69 66 28 20 72 63 21 3d 53 51 4c 49 54     if( rc!=SQLIT
2a5f0 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 20 20 69 66  E_OK ){.      if
2a600 28 20 70 50 61 67 65 72 2d 3e 70 49 6e 4a 6f 75  ( pPager->pInJou
2a610 72 6e 61 6c 20 26 26 20 28 69 6e 74 29 6e 65 65  rnal && (int)nee
2a620 64 53 79 6e 63 50 67 6e 6f 3c 3d 70 50 61 67 65  dSyncPgno<=pPage
2a630 72 2d 3e 6f 72 69 67 44 62 53 69 7a 65 20 29 7b  r->origDbSize ){
2a640 0a 20 20 20 20 20 20 20 20 73 71 6c 69 74 65 33  .        sqlite3
2a650 42 69 74 76 65 63 43 6c 65 61 72 28 70 50 61 67  BitvecClear(pPag
2a660 65 72 2d 3e 70 49 6e 4a 6f 75 72 6e 61 6c 2c 20  er->pInJournal, 
2a670 6e 65 65 64 53 79 6e 63 50 67 6e 6f 29 3b 0a 20  needSyncPgno);. 
2a680 20 20 20 20 20 7d 0a 20 20 20 20 20 20 70 61 67       }.      pag
2a690 65 72 4c 65 61 76 65 28 70 50 61 67 65 72 29 3b  erLeave(pPager);
2a6a0 0a 20 20 20 20 20 20 72 65 74 75 72 6e 20 72 63  .      return rc
2a6b0 3b 0a 20 20 20 20 7d 0a 20 20 20 20 70 50 61 67  ;.    }.    pPag
2a6c0 65 72 2d 3e 6e 65 65 64 53 79 6e 63 20 3d 20 31  er->needSync = 1
2a6d0 3b 0a 20 20 20 20 70 50 67 48 64 72 2d 3e 6e 65  ;.    pPgHdr->ne
2a6e0 65 64 53 79 6e 63 20 3d 20 31 3b 0a 20 20 20 20  edSync = 1;.    
2a6f0 70 50 67 48 64 72 2d 3e 69 6e 4a 6f 75 72 6e 61  pPgHdr->inJourna
2a700 6c 20 3d 20 31 3b 0a 20 20 20 20 6d 61 6b 65 44  l = 1;.    makeD
2a710 69 72 74 79 28 70 50 67 48 64 72 29 3b 0a 20 20  irty(pPgHdr);.  
2a720 20 20 73 71 6c 69 74 65 33 50 61 67 65 72 55 6e    sqlite3PagerUn
2a730 72 65 66 28 70 50 67 48 64 72 29 3b 0a 20 20 7d  ref(pPgHdr);.  }
2a740 0a 0a 20 20 70 61 67 65 72 4c 65 61 76 65 28 70  ..  pagerLeave(p
2a750 50 61 67 65 72 29 3b 0a 20 20 72 65 74 75 72 6e  Pager);.  return
2a760 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 7d 0a 23 65   SQLITE_OK;.}.#e
2a770 6e 64 69 66 0a 0a 2f 2a 0a 2a 2a 20 52 65 74 75  ndif../*.** Retu
2a780 72 6e 20 61 20 70 6f 69 6e 74 65 72 20 74 6f 20  rn a pointer to 
2a790 74 68 65 20 64 61 74 61 20 66 6f 72 20 74 68 65  the data for the
2a7a0 20 73 70 65 63 69 66 69 65 64 20 70 61 67 65 2e   specified page.
2a7b0 0a 2a 2f 0a 76 6f 69 64 20 2a 73 71 6c 69 74 65  .*/.void *sqlite
2a7c0 33 50 61 67 65 72 47 65 74 44 61 74 61 28 44 62  3PagerGetData(Db
2a7d0 50 61 67 65 20 2a 70 50 67 29 7b 0a 20 20 72 65  Page *pPg){.  re
2a7e0 74 75 72 6e 20 50 47 48 44 52 5f 54 4f 5f 44 41  turn PGHDR_TO_DA
2a7f0 54 41 28 70 50 67 29 3b 0a 7d 0a 0a 2f 2a 0a 2a  TA(pPg);.}../*.*
2a800 2a 20 52 65 74 75 72 6e 20 61 20 70 6f 69 6e 74  * Return a point
2a810 65 72 20 74 6f 20 74 68 65 20 50 61 67 65 72 2e  er to the Pager.
2a820 6e 45 78 74 72 61 20 62 79 74 65 73 20 6f 66 20  nExtra bytes of 
2a830 22 65 78 74 72 61 22 20 73 70 61 63 65 20 0a 2a  "extra" space .*
2a840 2a 20 61 6c 6c 6f 63 61 74 65 64 20 61 6c 6f 6e  * allocated alon
2a850 67 20 77 69 74 68 20 74 68 65 20 73 70 65 63 69  g with the speci
2a860 66 69 65 64 20 70 61 67 65 2e 0a 2a 2f 0a 76 6f  fied page..*/.vo
2a870 69 64 20 2a 73 71 6c 69 74 65 33 50 61 67 65 72  id *sqlite3Pager
2a880 47 65 74 45 78 74 72 61 28 44 62 50 61 67 65 20  GetExtra(DbPage 
2a890 2a 70 50 67 29 7b 0a 20 20 50 61 67 65 72 20 2a  *pPg){.  Pager *
2a8a0 70 50 61 67 65 72 20 3d 20 70 50 67 2d 3e 70 50  pPager = pPg->pP
2a8b0 61 67 65 72 3b 0a 20 20 72 65 74 75 72 6e 20 28  ager;.  return (
2a8c0 70 50 61 67 65 72 3f 50 47 48 44 52 5f 54 4f 5f  pPager?PGHDR_TO_
2a8d0 45 58 54 52 41 28 70 50 67 2c 20 70 50 61 67 65  EXTRA(pPg, pPage
2a8e0 72 29 3a 30 29 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20  r):0);.}../*.** 
2a8f0 47 65 74 2f 73 65 74 20 74 68 65 20 6c 6f 63 6b  Get/set the lock
2a900 69 6e 67 2d 6d 6f 64 65 20 66 6f 72 20 74 68 69  ing-mode for thi
2a910 73 20 70 61 67 65 72 2e 20 50 61 72 61 6d 65 74  s pager. Paramet
2a920 65 72 20 65 4d 6f 64 65 20 6d 75 73 74 20 62 65  er eMode must be
2a930 20 6f 6e 65 0a 2a 2a 20 6f 66 20 50 41 47 45 52   one.** of PAGER
2a940 5f 4c 4f 43 4b 49 4e 47 4d 4f 44 45 5f 51 55 45  _LOCKINGMODE_QUE
2a950 52 59 2c 20 50 41 47 45 52 5f 4c 4f 43 4b 49 4e  RY, PAGER_LOCKIN
2a960 47 4d 4f 44 45 5f 4e 4f 52 4d 41 4c 20 6f 72 20  GMODE_NORMAL or 
2a970 0a 2a 2a 20 50 41 47 45 52 5f 4c 4f 43 4b 49 4e  .** PAGER_LOCKIN
2a980 47 4d 4f 44 45 5f 45 58 43 4c 55 53 49 56 45 2e  GMODE_EXCLUSIVE.
2a990 20 49 66 20 74 68 65 20 70 61 72 61 6d 65 74 65   If the paramete
2a9a0 72 20 69 73 20 6e 6f 74 20 5f 51 55 45 52 59 2c  r is not _QUERY,
2a9b0 20 74 68 65 6e 0a 2a 2a 20 74 68 65 20 6c 6f 63   then.** the loc
2a9c0 6b 69 6e 67 2d 6d 6f 64 65 20 69 73 20 73 65 74  king-mode is set
2a9d0 20 74 6f 20 74 68 65 20 76 61 6c 75 65 20 73 70   to the value sp
2a9e0 65 63 69 66 69 65 64 2e 0a 2a 2a 0a 2a 2a 20 54  ecified..**.** T
2a9f0 68 65 20 72 65 74 75 72 6e 65 64 20 76 61 6c 75  he returned valu
2aa00 65 20 69 73 20 65 69 74 68 65 72 20 50 41 47 45  e is either PAGE
2aa10 52 5f 4c 4f 43 4b 49 4e 47 4d 4f 44 45 5f 4e 4f  R_LOCKINGMODE_NO
2aa20 52 4d 41 4c 20 6f 72 0a 2a 2a 20 50 41 47 45 52  RMAL or.** PAGER
2aa30 5f 4c 4f 43 4b 49 4e 47 4d 4f 44 45 5f 45 58 43  _LOCKINGMODE_EXC
2aa40 4c 55 53 49 56 45 2c 20 69 6e 64 69 63 61 74 69  LUSIVE, indicati
2aa50 6e 67 20 74 68 65 20 63 75 72 72 65 6e 74 20 28  ng the current (
2aa60 70 6f 73 73 69 62 6c 79 20 75 70 64 61 74 65 64  possibly updated
2aa70 29 0a 2a 2a 20 6c 6f 63 6b 69 6e 67 2d 6d 6f 64  ).** locking-mod
2aa80 65 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65  e..*/.int sqlite
2aa90 33 50 61 67 65 72 4c 6f 63 6b 69 6e 67 4d 6f 64  3PagerLockingMod
2aaa0 65 28 50 61 67 65 72 20 2a 70 50 61 67 65 72 2c  e(Pager *pPager,
2aab0 20 69 6e 74 20 65 4d 6f 64 65 29 7b 0a 20 20 61   int eMode){.  a
2aac0 73 73 65 72 74 28 20 65 4d 6f 64 65 3d 3d 50 41  ssert( eMode==PA
2aad0 47 45 52 5f 4c 4f 43 4b 49 4e 47 4d 4f 44 45 5f  GER_LOCKINGMODE_
2aae0 51 55 45 52 59 0a 20 20 20 20 20 20 20 20 20 20  QUERY.          
2aaf0 20 20 7c 7c 20 65 4d 6f 64 65 3d 3d 50 41 47 45    || eMode==PAGE
2ab00 52 5f 4c 4f 43 4b 49 4e 47 4d 4f 44 45 5f 4e 4f  R_LOCKINGMODE_NO
2ab10 52 4d 41 4c 0a 20 20 20 20 20 20 20 20 20 20 20  RMAL.           
2ab20 20 7c 7c 20 65 4d 6f 64 65 3d 3d 50 41 47 45 52   || eMode==PAGER
2ab30 5f 4c 4f 43 4b 49 4e 47 4d 4f 44 45 5f 45 58 43  _LOCKINGMODE_EXC
2ab40 4c 55 53 49 56 45 20 29 3b 0a 20 20 61 73 73 65  LUSIVE );.  asse
2ab50 72 74 28 20 50 41 47 45 52 5f 4c 4f 43 4b 49 4e  rt( PAGER_LOCKIN
2ab60 47 4d 4f 44 45 5f 51 55 45 52 59 3c 30 20 29 3b  GMODE_QUERY<0 );
2ab70 0a 20 20 61 73 73 65 72 74 28 20 50 41 47 45 52  .  assert( PAGER
2ab80 5f 4c 4f 43 4b 49 4e 47 4d 4f 44 45 5f 4e 4f 52  _LOCKINGMODE_NOR
2ab90 4d 41 4c 3e 3d 30 20 26 26 20 50 41 47 45 52 5f  MAL>=0 && PAGER_
2aba0 4c 4f 43 4b 49 4e 47 4d 4f 44 45 5f 45 58 43 4c  LOCKINGMODE_EXCL
2abb0 55 53 49 56 45 3e 3d 30 20 29 3b 0a 20 20 69 66  USIVE>=0 );.  if
2abc0 28 20 65 4d 6f 64 65 3e 3d 30 20 26 26 20 21 70  ( eMode>=0 && !p
2abd0 50 61 67 65 72 2d 3e 74 65 6d 70 46 69 6c 65 20  Pager->tempFile 
2abe0 29 7b 0a 20 20 20 20 70 50 61 67 65 72 2d 3e 65  ){.    pPager->e
2abf0 78 63 6c 75 73 69 76 65 4d 6f 64 65 20 3d 20 65  xclusiveMode = e
2ac00 4d 6f 64 65 3b 0a 20 20 7d 0a 20 20 72 65 74 75  Mode;.  }.  retu
2ac10 72 6e 20 28 69 6e 74 29 70 50 61 67 65 72 2d 3e  rn (int)pPager->
2ac20 65 78 63 6c 75 73 69 76 65 4d 6f 64 65 3b 0a 7d  exclusiveMode;.}
2ac30 0a 0a 2f 2a 0a 2a 2a 20 47 65 74 2f 73 65 74 20  ../*.** Get/set 
2ac40 74 68 65 20 6a 6f 75 72 6e 61 6c 2d 6d 6f 64 65  the journal-mode
2ac50 20 66 6f 72 20 74 68 69 73 20 70 61 67 65 72 2e   for this pager.
2ac60 20 50 61 72 61 6d 65 74 65 72 20 65 4d 6f 64 65   Parameter eMode
2ac70 20 6d 75 73 74 20 62 65 20 6f 6e 65 0a 2a 2a 20   must be one.** 
2ac80 6f 66 20 50 41 47 45 52 5f 4a 4f 55 52 4e 41 4c  of PAGER_JOURNAL
2ac90 4d 4f 44 45 5f 51 55 45 52 59 2c 20 50 41 47 45  MODE_QUERY, PAGE
2aca0 52 5f 4a 4f 55 52 4e 41 4c 4d 4f 44 45 5f 44 45  R_JOURNALMODE_DE
2acb0 4c 45 54 45 20 6f 72 20 0a 2a 2a 20 50 41 47 45  LETE or .** PAGE
2acc0 52 5f 4a 4f 55 52 4e 41 4c 4d 4f 44 45 5f 50 45  R_JOURNALMODE_PE
2acd0 52 53 49 53 54 2e 20 49 66 20 74 68 65 20 70 61  RSIST. If the pa
2ace0 72 61 6d 65 74 65 72 20 69 73 20 6e 6f 74 20 5f  rameter is not _
2acf0 51 55 45 52 59 2c 20 74 68 65 6e 0a 2a 2a 20 74  QUERY, then.** t
2ad00 68 65 20 6a 6f 75 72 6e 61 6c 2d 6d 6f 64 65 20  he journal-mode 
2ad10 69 73 20 73 65 74 20 74 6f 20 74 68 65 20 76 61  is set to the va
2ad20 6c 75 65 20 73 70 65 63 69 66 69 65 64 2e 0a 2a  lue specified..*
2ad30 2a 0a 2a 2a 20 54 68 65 20 72 65 74 75 72 6e 65  *.** The returne
2ad40 64 20 76 61 6c 75 65 20 69 73 20 65 69 74 68 65  d value is eithe
2ad50 72 20 50 41 47 45 52 5f 4a 4f 55 52 4e 41 4c 4d  r PAGER_JOURNALM
2ad60 4f 44 45 5f 44 45 4c 45 54 45 20 6f 72 0a 2a 2a  ODE_DELETE or.**
2ad70 20 50 41 47 45 52 5f 4a 4f 55 52 4e 41 4c 4d 4f   PAGER_JOURNALMO
2ad80 44 45 5f 50 45 52 53 49 53 54 2c 20 69 6e 64 69  DE_PERSIST, indi
2ad90 63 61 74 69 6e 67 20 74 68 65 20 63 75 72 72 65  cating the curre
2ada0 6e 74 20 28 70 6f 73 73 69 62 6c 79 20 75 70 64  nt (possibly upd
2adb0 61 74 65 64 29 0a 2a 2a 20 6a 6f 75 72 6e 61 6c  ated).** journal
2adc0 2d 6d 6f 64 65 2e 0a 2a 2f 0a 69 6e 74 20 73 71  -mode..*/.int sq
2add0 6c 69 74 65 33 50 61 67 65 72 4a 6f 75 72 6e 61  lite3PagerJourna
2ade0 6c 4d 6f 64 65 28 50 61 67 65 72 20 2a 70 50 61  lMode(Pager *pPa
2adf0 67 65 72 2c 20 69 6e 74 20 65 4d 6f 64 65 29 7b  ger, int eMode){
2ae00 0a 20 20 61 73 73 65 72 74 28 20 65 4d 6f 64 65  .  assert( eMode
2ae10 3d 3d 50 41 47 45 52 5f 4a 4f 55 52 4e 41 4c 4d  ==PAGER_JOURNALM
2ae20 4f 44 45 5f 51 55 45 52 59 0a 20 20 20 20 20 20  ODE_QUERY.      
2ae30 20 20 20 20 20 20 7c 7c 20 65 4d 6f 64 65 3d 3d        || eMode==
2ae40 50 41 47 45 52 5f 4a 4f 55 52 4e 41 4c 4d 4f 44  PAGER_JOURNALMOD
2ae50 45 5f 44 45 4c 45 54 45 0a 20 20 20 20 20 20 20  E_DELETE.       
2ae60 20 20 20 20 20 7c 7c 20 65 4d 6f 64 65 3d 3d 50       || eMode==P
2ae70 41 47 45 52 5f 4a 4f 55 52 4e 41 4c 4d 4f 44 45  AGER_JOURNALMODE
2ae80 5f 50 45 52 53 49 53 54 0a 20 20 20 20 20 20 20  _PERSIST.       
2ae90 20 20 20 20 20 7c 7c 20 65 4d 6f 64 65 3d 3d 50       || eMode==P
2aea0 41 47 45 52 5f 4a 4f 55 52 4e 41 4c 4d 4f 44 45  AGER_JOURNALMODE
2aeb0 5f 4f 46 46 20 29 3b 0a 20 20 61 73 73 65 72 74  _OFF );.  assert
2aec0 28 20 50 41 47 45 52 5f 4a 4f 55 52 4e 41 4c 4d  ( PAGER_JOURNALM
2aed0 4f 44 45 5f 51 55 45 52 59 3c 30 20 29 3b 0a 20  ODE_QUERY<0 );. 
2aee0 20 61 73 73 65 72 74 28 20 50 41 47 45 52 5f 4a   assert( PAGER_J
2aef0 4f 55 52 4e 41 4c 4d 4f 44 45 5f 44 45 4c 45 54  OURNALMODE_DELET
2af00 45 3e 3d 30 20 26 26 20 50 41 47 45 52 5f 4a 4f  E>=0 && PAGER_JO
2af10 55 52 4e 41 4c 4d 4f 44 45 5f 50 45 52 53 49 53  URNALMODE_PERSIS
2af20 54 3e 3d 30 20 29 3b 0a 20 20 69 66 28 20 65 4d  T>=0 );.  if( eM
2af30 6f 64 65 3e 3d 30 20 29 7b 0a 20 20 20 20 70 50  ode>=0 ){.    pP
2af40 61 67 65 72 2d 3e 6a 6f 75 72 6e 61 6c 4d 6f 64  ager->journalMod
2af50 65 20 3d 20 65 4d 6f 64 65 3b 0a 20 20 7d 0a 20  e = eMode;.  }. 
2af60 20 72 65 74 75 72 6e 20 28 69 6e 74 29 70 50 61   return (int)pPa
2af70 67 65 72 2d 3e 6a 6f 75 72 6e 61 6c 4d 6f 64 65  ger->journalMode
2af80 3b 0a 7d 0a 0a 23 69 66 64 65 66 20 53 51 4c 49  ;.}..#ifdef SQLI
2af90 54 45 5f 54 45 53 54 0a 2f 2a 0a 2a 2a 20 50 72  TE_TEST./*.** Pr
2afa0 69 6e 74 20 61 20 6c 69 73 74 69 6e 67 20 6f 66  int a listing of
2afb0 20 61 6c 6c 20 72 65 66 65 72 65 6e 63 65 64 20   all referenced 
2afc0 70 61 67 65 73 20 61 6e 64 20 74 68 65 69 72 20  pages and their 
2afd0 72 65 66 20 63 6f 75 6e 74 2e 0a 2a 2f 0a 76 6f  ref count..*/.vo
2afe0 69 64 20 73 71 6c 69 74 65 33 50 61 67 65 72 52  id sqlite3PagerR
2aff0 65 66 64 75 6d 70 28 50 61 67 65 72 20 2a 70 50  efdump(Pager *pP
2b000 61 67 65 72 29 7b 0a 20 20 50 67 48 64 72 20 2a  ager){.  PgHdr *
2b010 70 50 67 3b 0a 20 20 66 6f 72 28 70 50 67 3d 70  pPg;.  for(pPg=p
2b020 50 61 67 65 72 2d 3e 70 41 6c 6c 3b 20 70 50 67  Pager->pAll; pPg
2b030 3b 20 70 50 67 3d 70 50 67 2d 3e 70 4e 65 78 74  ; pPg=pPg->pNext
2b040 41 6c 6c 29 7b 0a 20 20 20 20 69 66 28 20 70 50  All){.    if( pP
2b050 67 2d 3e 6e 52 65 66 3c 3d 30 20 29 20 63 6f 6e  g->nRef<=0 ) con
2b060 74 69 6e 75 65 3b 0a 20 20 20 20 73 71 6c 69 74  tinue;.    sqlit
2b070 65 33 44 65 62 75 67 50 72 69 6e 74 66 28 22 50  e3DebugPrintf("P
2b080 41 47 45 20 25 33 64 20 61 64 64 72 3d 25 70 20  AGE %3d addr=%p 
2b090 6e 52 65 66 3d 25 64 5c 6e 22 2c 20 0a 20 20 20  nRef=%d\n", .   
2b0a0 20 20 20 20 70 50 67 2d 3e 70 67 6e 6f 2c 20 50      pPg->pgno, P
2b0b0 47 48 44 52 5f 54 4f 5f 44 41 54 41 28 70 50 67  GHDR_TO_DATA(pPg
2b0c0 29 2c 20 70 50 67 2d 3e 6e 52 65 66 29 3b 0a 20  ), pPg->nRef);. 
2b0d0 20 7d 0a 7d 0a 23 65 6e 64 69 66 0a 0a 23 65 6e   }.}.#endif..#en
2b0e0 64 69 66 20 2f 2a 20 53 51 4c 49 54 45 5f 4f 4d  dif /* SQLITE_OM
2b0f0 49 54 5f 44 49 53 4b 49 4f 20 2a 2f 0a           IT_DISKIO */.