/ Hex Artifact Content
Login

Artifact a77c7fd3f33c0c6834a042b9b0d4a8128553532e:


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 32 33  : pager.c,v 1.23
0350: 20 32 30 30 31 2f 30 39 2f 31 39 20 31 33 3a 35   2001/09/19 13:5
0360: 38 3a 34 34 20 64 72 68 20 45 78 70 20 24 0a 2a  8:44 drh Exp $.*
0370: 2f 0a 23 69 6e 63 6c 75 64 65 20 22 73 71 6c 69  /.#include "sqli
0380: 74 65 49 6e 74 2e 68 22 0a 23 69 6e 63 6c 75 64  teInt.h".#includ
0390: 65 20 22 70 61 67 65 72 2e 68 22 0a 23 69 6e 63  e "pager.h".#inc
03a0: 6c 75 64 65 20 22 6f 73 2e 68 22 0a 23 69 6e 63  lude "os.h".#inc
03b0: 6c 75 64 65 20 3c 61 73 73 65 72 74 2e 68 3e 0a  lude <assert.h>.
03c0: 23 69 6e 63 6c 75 64 65 20 3c 73 74 72 69 6e 67  #include <string
03d0: 2e 68 3e 0a 0a 2f 2a 0a 2a 2a 20 54 68 65 20 70  .h>../*.** The p
03e0: 61 67 65 20 63 61 63 68 65 20 61 73 20 61 20 77  age cache as a w
03f0: 68 6f 6c 65 20 69 73 20 61 6c 77 61 79 73 20 69  hole is always i
0400: 6e 20 6f 6e 65 20 6f 66 20 74 68 65 20 66 6f 6c  n one of the fol
0410: 6c 6f 77 69 6e 67 0a 2a 2a 20 73 74 61 74 65 73  lowing.** states
0420: 3a 0a 2a 2a 0a 2a 2a 20 20 20 53 51 4c 49 54 45  :.**.**   SQLITE
0430: 5f 55 4e 4c 4f 43 4b 20 20 20 20 20 20 20 54 68  _UNLOCK       Th
0440: 65 20 70 61 67 65 20 63 61 63 68 65 20 69 73 20  e page cache is 
0450: 6e 6f 74 20 63 75 72 72 65 6e 74 6c 79 20 72 65  not currently re
0460: 61 64 69 6e 67 20 6f 72 20 0a 2a 2a 20 20 20 20  ading or .**    
0470: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
0480: 20 20 20 77 72 69 74 69 6e 67 20 74 68 65 20 64     writing the d
0490: 61 74 61 62 61 73 65 20 66 69 6c 65 2e 20 20 54  atabase file.  T
04a0: 68 65 72 65 20 69 73 20 6e 6f 0a 2a 2a 20 20 20  here is no.**   
04b0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
04c0: 20 20 20 20 64 61 74 61 20 68 65 6c 64 20 69 6e      data held in
04d0: 20 6d 65 6d 6f 72 79 2e 20 20 54 68 69 73 20 69   memory.  This i
04e0: 73 20 74 68 65 20 69 6e 69 74 69 61 6c 0a 2a 2a  s the initial.**
04f0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
0500: 20 20 20 20 20 20 20 73 74 61 74 65 2e 0a 2a 2a         state..**
0510: 0a 2a 2a 20 20 20 53 51 4c 49 54 45 5f 52 45 41  .**   SQLITE_REA
0520: 44 4c 4f 43 4b 20 20 20 20 20 54 68 65 20 70 61  DLOCK     The pa
0530: 67 65 20 63 61 63 68 65 20 69 73 20 72 65 61 64  ge cache is read
0540: 69 6e 67 20 74 68 65 20 64 61 74 61 62 61 73 65  ing the database
0550: 2e 0a 2a 2a 20 20 20 20 20 20 20 20 20 20 20 20  ..**            
0560: 20 20 20 20 20 20 20 20 20 20 20 57 72 69 74 69             Writi
0570: 6e 67 20 69 73 20 6e 6f 74 20 70 65 72 6d 69 74  ng is not permit
0580: 74 65 64 2e 20 20 54 68 65 72 65 20 63 61 6e 20  ted.  There can 
0590: 62 65 0a 2a 2a 20 20 20 20 20 20 20 20 20 20 20  be.**           
05a0: 20 20 20 20 20 20 20 20 20 20 20 20 6d 75 6c 74              mult
05b0: 69 70 6c 65 20 72 65 61 64 65 72 73 20 61 63 63  iple readers acc
05c0: 65 73 73 69 6e 67 20 74 68 65 20 73 61 6d 65 20  essing the same 
05d0: 64 61 74 61 62 61 73 65 0a 2a 2a 20 20 20 20 20  database.**     
05e0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
05f0: 20 20 66 69 6c 65 20 61 74 20 74 68 65 20 73 61    file at the sa
0600: 6d 65 20 74 69 6d 65 2e 0a 2a 2a 0a 2a 2a 20 20  me time..**.**  
0610: 20 53 51 4c 49 54 45 5f 57 52 49 54 45 4c 4f 43   SQLITE_WRITELOC
0620: 4b 20 20 20 20 54 68 65 20 70 61 67 65 20 63 61  K    The page ca
0630: 63 68 65 20 69 73 20 77 72 69 74 69 6e 67 20 74  che is writing t
0640: 68 65 20 64 61 74 61 62 61 73 65 2e 0a 2a 2a 20  he database..** 
0650: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
0660: 20 20 20 20 20 20 41 63 63 65 73 73 20 69 73 20        Access is 
0670: 65 78 63 6c 75 73 69 76 65 2e 20 20 4e 6f 20 6f  exclusive.  No o
0680: 74 68 65 72 20 70 72 6f 63 65 73 73 65 73 20 6f  ther processes o
0690: 72 0a 2a 2a 20 20 20 20 20 20 20 20 20 20 20 20  r.**            
06a0: 20 20 20 20 20 20 20 20 20 20 20 74 68 72 65 61             threa
06b0: 64 73 20 63 61 6e 20 62 65 20 72 65 61 64 69 6e  ds can be readin
06c0: 67 20 6f 72 20 77 72 69 74 69 6e 67 20 77 68 69  g or writing whi
06d0: 6c 65 20 6f 6e 65 0a 2a 2a 20 20 20 20 20 20 20  le one.**       
06e0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
06f0: 70 72 6f 63 65 73 73 20 69 73 20 77 72 69 74 69  process is writi
0700: 6e 67 2e 0a 2a 2a 0a 2a 2a 20 54 68 65 20 70 61  ng..**.** The pa
0710: 67 65 20 63 61 63 68 65 20 63 6f 6d 65 73 20 75  ge cache comes u
0720: 70 20 69 6e 20 53 51 4c 49 54 45 5f 55 4e 4c 4f  p in SQLITE_UNLO
0730: 43 4b 2e 20 20 54 68 65 20 66 69 72 73 74 20 74  CK.  The first t
0740: 69 6d 65 20 61 0a 2a 2a 20 73 71 6c 69 74 65 5f  ime a.** sqlite_
0750: 70 61 67 65 5f 67 65 74 28 29 20 6f 63 63 75 72  page_get() occur
0760: 73 2c 20 74 68 65 20 73 74 61 74 65 20 74 72 61  s, the state tra
0770: 6e 73 69 74 69 6f 6e 73 20 74 6f 20 53 51 4c 49  nsitions to SQLI
0780: 54 45 5f 52 45 41 44 4c 4f 43 4b 2e 0a 2a 2a 20  TE_READLOCK..** 
0790: 41 66 74 65 72 20 61 6c 6c 20 70 61 67 65 73 20  After all pages 
07a0: 68 61 76 65 20 62 65 65 6e 20 72 65 6c 65 61 73  have been releas
07b0: 65 64 20 75 73 69 6e 67 20 73 71 6c 69 74 65 5f  ed using sqlite_
07c0: 70 61 67 65 5f 75 6e 72 65 66 28 29 2c 0a 2a 2a  page_unref(),.**
07d0: 20 74 68 65 20 73 74 61 74 65 20 74 72 61 6e 73   the state trans
07e0: 69 74 69 6f 6e 73 20 62 61 63 6b 20 74 6f 20 53  itions back to S
07f0: 51 4c 49 54 45 5f 55 4e 4c 4f 43 4b 2e 20 20 54  QLITE_UNLOCK.  T
0800: 68 65 20 66 69 72 73 74 20 74 69 6d 65 0a 2a 2a  he first time.**
0810: 20 74 68 61 74 20 73 71 6c 69 74 65 5f 70 61 67   that sqlite_pag
0820: 65 5f 77 72 69 74 65 28 29 20 69 73 20 63 61 6c  e_write() is cal
0830: 6c 65 64 2c 20 74 68 65 20 73 74 61 74 65 20 74  led, the state t
0840: 72 61 6e 73 69 74 69 6f 6e 73 20 74 6f 0a 2a 2a  ransitions to.**
0850: 20 53 51 4c 49 54 45 5f 57 52 49 54 45 4c 4f 43   SQLITE_WRITELOC
0860: 4b 2e 20 20 28 4e 6f 74 65 20 74 68 61 74 20 73  K.  (Note that s
0870: 71 6c 69 74 65 5f 70 61 67 65 5f 77 72 69 74 65  qlite_page_write
0880: 28 29 20 63 61 6e 20 6f 6e 6c 79 20 62 65 0a 2a  () can only be.*
0890: 2a 20 63 61 6c 6c 65 64 20 6f 6e 20 61 6e 20 6f  * called on an o
08a0: 75 74 73 74 61 6e 64 69 6e 67 20 70 61 67 65 20  utstanding page 
08b0: 77 68 69 63 68 20 6d 65 61 6e 73 20 74 68 61 74  which means that
08c0: 20 74 68 65 20 70 61 67 65 72 20 6d 75 73 74 0a   the pager must.
08d0: 2a 2a 20 62 65 20 69 6e 20 53 51 4c 49 54 45 5f  ** be in SQLITE_
08e0: 52 45 41 44 4c 4f 43 4b 20 62 65 66 6f 72 65 20  READLOCK before 
08f0: 69 74 20 74 72 61 6e 73 69 74 69 6f 6e 73 20 74  it transitions t
0900: 6f 20 53 51 4c 49 54 45 5f 57 52 49 54 45 4c 4f  o SQLITE_WRITELO
0910: 43 4b 2e 29 0a 2a 2a 20 54 68 65 20 73 71 6c 69  CK.).** The sqli
0920: 74 65 5f 70 61 67 65 5f 72 6f 6c 6c 62 61 63 6b  te_page_rollback
0930: 28 29 20 61 6e 64 20 73 71 6c 69 74 65 5f 70 61  () and sqlite_pa
0940: 67 65 5f 63 6f 6d 6d 69 74 28 29 20 66 75 6e 63  ge_commit() func
0950: 74 69 6f 6e 73 20 0a 2a 2a 20 74 72 61 6e 73 69  tions .** transi
0960: 74 69 6f 6e 20 74 68 65 20 73 74 61 74 65 20 66  tion the state f
0970: 72 6f 6d 20 53 51 4c 49 54 45 5f 57 52 49 54 45  rom SQLITE_WRITE
0980: 4c 4f 43 4b 20 62 61 63 6b 20 74 6f 20 53 51 4c  LOCK back to SQL
0990: 49 54 45 5f 52 45 41 44 4c 4f 43 4b 2e 0a 2a 2f  ITE_READLOCK..*/
09a0: 0a 23 64 65 66 69 6e 65 20 53 51 4c 49 54 45 5f  .#define SQLITE_
09b0: 55 4e 4c 4f 43 4b 20 20 20 20 20 20 30 0a 23 64  UNLOCK      0.#d
09c0: 65 66 69 6e 65 20 53 51 4c 49 54 45 5f 52 45 41  efine SQLITE_REA
09d0: 44 4c 4f 43 4b 20 20 20 20 31 0a 23 64 65 66 69  DLOCK    1.#defi
09e0: 6e 65 20 53 51 4c 49 54 45 5f 57 52 49 54 45 4c  ne SQLITE_WRITEL
09f0: 4f 43 4b 20 20 20 32 0a 0a 0a 2f 2a 0a 2a 2a 20  OCK   2.../*.** 
0a00: 45 61 63 68 20 69 6e 2d 6d 65 6d 6f 72 79 20 69  Each in-memory i
0a10: 6d 61 67 65 20 6f 66 20 61 20 70 61 67 65 20 62  mage of a page b
0a20: 65 67 69 6e 73 20 77 69 74 68 20 74 68 65 20 66  egins with the f
0a30: 6f 6c 6c 6f 77 69 6e 67 20 68 65 61 64 65 72 2e  ollowing header.
0a40: 0a 2a 2a 20 54 68 69 73 20 68 65 61 64 65 72 20  .** This header 
0a50: 69 73 20 6f 6e 6c 79 20 76 69 73 69 62 6c 65 20  is only visible 
0a60: 74 6f 20 74 68 69 73 20 70 61 67 65 72 20 6d 6f  to this pager mo
0a70: 64 75 6c 65 2e 20 20 54 68 65 20 63 6c 69 65 6e  dule.  The clien
0a80: 74 0a 2a 2a 20 63 6f 64 65 20 74 68 61 74 20 63  t.** code that c
0a90: 61 6c 6c 73 20 70 61 67 65 72 20 73 65 65 73 20  alls pager sees 
0aa0: 6f 6e 6c 79 20 74 68 65 20 64 61 74 61 20 74 68  only the data th
0ab0: 61 74 20 66 6f 6c 6c 6f 77 73 20 74 68 65 20 68  at follows the h
0ac0: 65 61 64 65 72 2e 0a 2a 2f 0a 74 79 70 65 64 65  eader..*/.typede
0ad0: 66 20 73 74 72 75 63 74 20 50 67 48 64 72 20 50  f struct PgHdr P
0ae0: 67 48 64 72 3b 0a 73 74 72 75 63 74 20 50 67 48  gHdr;.struct PgH
0af0: 64 72 20 7b 0a 20 20 50 61 67 65 72 20 2a 70 50  dr {.  Pager *pP
0b00: 61 67 65 72 3b 20 20 20 20 20 20 20 20 20 20 20  ager;           
0b10: 20 20 20 20 20 20 2f 2a 20 54 68 65 20 70 61 67        /* The pag
0b20: 65 72 20 74 6f 20 77 68 69 63 68 20 74 68 69 73  er to which this
0b30: 20 70 61 67 65 20 62 65 6c 6f 6e 67 73 20 2a 2f   page belongs */
0b40: 0a 20 20 50 67 6e 6f 20 70 67 6e 6f 3b 20 20 20  .  Pgno pgno;   
0b50: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
0b60: 20 20 2f 2a 20 54 68 65 20 70 61 67 65 20 6e 75    /* The page nu
0b70: 6d 62 65 72 20 66 6f 72 20 74 68 69 73 20 70 61  mber for this pa
0b80: 67 65 20 2a 2f 0a 20 20 50 67 48 64 72 20 2a 70  ge */.  PgHdr *p
0b90: 4e 65 78 74 48 61 73 68 2c 20 2a 70 50 72 65 76  NextHash, *pPrev
0ba0: 48 61 73 68 3b 20 20 2f 2a 20 48 61 73 68 20 63  Hash;  /* Hash c
0bb0: 6f 6c 6c 69 73 69 6f 6e 20 63 68 61 69 6e 20 66  ollision chain f
0bc0: 6f 72 20 50 67 48 64 72 2e 70 67 6e 6f 20 2a 2f  or PgHdr.pgno */
0bd0: 0a 20 20 69 6e 74 20 6e 52 65 66 3b 20 20 20 20  .  int nRef;    
0be0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
0bf0: 20 20 2f 2a 20 4e 75 6d 62 65 72 20 6f 66 20 75    /* Number of u
0c00: 73 65 72 73 20 6f 66 20 74 68 69 73 20 70 61 67  sers of this pag
0c10: 65 20 2a 2f 0a 20 20 50 67 48 64 72 20 2a 70 4e  e */.  PgHdr *pN
0c20: 65 78 74 46 72 65 65 2c 20 2a 70 50 72 65 76 46  extFree, *pPrevF
0c30: 72 65 65 3b 20 20 2f 2a 20 46 72 65 65 6c 69 73  ree;  /* Freelis
0c40: 74 20 6f 66 20 70 61 67 65 73 20 77 68 65 72 65  t of pages where
0c50: 20 6e 52 65 66 3d 3d 30 20 2a 2f 0a 20 20 50 67   nRef==0 */.  Pg
0c60: 48 64 72 20 2a 70 4e 65 78 74 41 6c 6c 2c 20 2a  Hdr *pNextAll, *
0c70: 70 50 72 65 76 41 6c 6c 3b 20 20 20 20 2f 2a 20  pPrevAll;    /* 
0c80: 41 20 6c 69 73 74 20 6f 66 20 61 6c 6c 20 70 61  A list of all pa
0c90: 67 65 73 20 2a 2f 0a 20 20 63 68 61 72 20 69 6e  ges */.  char in
0ca0: 4a 6f 75 72 6e 61 6c 3b 20 20 20 20 20 20 20 20  Journal;        
0cb0: 20 20 20 20 20 20 20 20 2f 2a 20 54 52 55 45 20          /* TRUE 
0cc0: 69 66 20 68 61 73 20 62 65 65 6e 20 77 72 69 74  if has been writ
0cd0: 74 65 6e 20 74 6f 20 6a 6f 75 72 6e 61 6c 20 2a  ten to journal *
0ce0: 2f 0a 20 20 63 68 61 72 20 64 69 72 74 79 3b 20  /.  char dirty; 
0cf0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
0d00: 20 20 20 2f 2a 20 54 52 55 45 20 69 66 20 77 65     /* TRUE if we
0d10: 20 6e 65 65 64 20 74 6f 20 77 72 69 74 65 20 62   need to write b
0d20: 61 63 6b 20 63 68 61 6e 67 65 73 20 2a 2f 0a 20  ack changes */. 
0d30: 20 2f 2a 20 53 51 4c 49 54 45 5f 50 41 47 45 5f   /* SQLITE_PAGE_
0d40: 53 49 5a 45 20 62 79 74 65 73 20 6f 66 20 70 61  SIZE bytes of pa
0d50: 67 65 20 64 61 74 61 20 66 6f 6c 6c 6f 77 20 74  ge data follow t
0d60: 68 69 73 20 68 65 61 64 65 72 20 2a 2f 0a 20 20  his header */.  
0d70: 2f 2a 20 50 61 67 65 72 2e 6e 45 78 74 72 61 20  /* Pager.nExtra 
0d80: 62 79 74 65 73 20 6f 66 20 6c 6f 63 61 6c 20 64  bytes of local d
0d90: 61 74 61 20 66 6f 6c 6c 6f 77 20 74 68 65 20 70  ata follow the p
0da0: 61 67 65 20 64 61 74 61 20 2a 2f 0a 7d 3b 0a 0a  age data */.};..
0db0: 2f 2a 0a 2a 2a 20 43 6f 6e 76 65 72 74 20 61 20  /*.** Convert a 
0dc0: 70 6f 69 6e 74 65 72 20 74 6f 20 61 20 50 67 48  pointer to a PgH
0dd0: 64 72 20 69 6e 74 6f 20 61 20 70 6f 69 6e 74 65  dr into a pointe
0de0: 72 20 74 6f 20 69 74 73 20 64 61 74 61 0a 2a 2a  r to its data.**
0df0: 20 61 6e 64 20 62 61 63 6b 20 61 67 61 69 6e 2e   and back again.
0e00: 0a 2a 2f 0a 23 64 65 66 69 6e 65 20 50 47 48 44  .*/.#define PGHD
0e10: 52 5f 54 4f 5f 44 41 54 41 28 50 29 20 20 28 28  R_TO_DATA(P)  ((
0e20: 76 6f 69 64 2a 29 28 26 28 50 29 5b 31 5d 29 29  void*)(&(P)[1]))
0e30: 0a 23 64 65 66 69 6e 65 20 44 41 54 41 5f 54 4f  .#define DATA_TO
0e40: 5f 50 47 48 44 52 28 44 29 20 20 28 26 28 28 50  _PGHDR(D)  (&((P
0e50: 67 48 64 72 2a 29 28 44 29 29 5b 2d 31 5d 29 0a  gHdr*)(D))[-1]).
0e60: 23 64 65 66 69 6e 65 20 50 47 48 44 52 5f 54 4f  #define PGHDR_TO
0e70: 5f 45 58 54 52 41 28 50 29 20 28 28 76 6f 69 64  _EXTRA(P) ((void
0e80: 2a 29 26 28 28 63 68 61 72 2a 29 28 26 28 50 29  *)&((char*)(&(P)
0e90: 5b 31 5d 29 29 5b 53 51 4c 49 54 45 5f 50 41 47  [1]))[SQLITE_PAG
0ea0: 45 5f 53 49 5a 45 5d 29 0a 0a 2f 2a 0a 2a 2a 20  E_SIZE])../*.** 
0eb0: 48 6f 77 20 62 69 67 20 74 6f 20 6d 61 6b 65 20  How big to make 
0ec0: 74 68 65 20 68 61 73 68 20 74 61 62 6c 65 20 75  the hash table u
0ed0: 73 65 64 20 66 6f 72 20 6c 6f 63 61 74 69 6e 67  sed for locating
0ee0: 20 69 6e 2d 6d 65 6d 6f 72 79 20 70 61 67 65 73   in-memory pages
0ef0: 0a 2a 2a 20 62 79 20 70 61 67 65 20 6e 75 6d 62  .** by page numb
0f00: 65 72 2e 20 20 4b 6e 75 74 68 20 73 61 79 73 20  er.  Knuth says 
0f10: 74 68 69 73 20 73 68 6f 75 6c 64 20 62 65 20 61  this should be a
0f20: 20 70 72 69 6d 65 20 6e 75 6d 62 65 72 2e 0a 2a   prime number..*
0f30: 2f 0a 23 64 65 66 69 6e 65 20 4e 5f 50 47 5f 48  /.#define N_PG_H
0f40: 41 53 48 20 33 37 33 0a 0a 2f 2a 0a 2a 2a 20 41  ASH 373../*.** A
0f50: 20 6f 70 65 6e 20 70 61 67 65 20 63 61 63 68 65   open page cache
0f60: 20 69 73 20 61 6e 20 69 6e 73 74 61 6e 63 65 20   is an instance 
0f70: 6f 66 20 74 68 65 20 66 6f 6c 6c 6f 77 69 6e 67  of the following
0f80: 20 73 74 72 75 63 74 75 72 65 2e 0a 2a 2f 0a 73   structure..*/.s
0f90: 74 72 75 63 74 20 50 61 67 65 72 20 7b 0a 20 20  truct Pager {.  
0fa0: 63 68 61 72 20 2a 7a 46 69 6c 65 6e 61 6d 65 3b  char *zFilename;
0fb0: 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4e              /* N
0fc0: 61 6d 65 20 6f 66 20 74 68 65 20 64 61 74 61 62  ame of the datab
0fd0: 61 73 65 20 66 69 6c 65 20 2a 2f 0a 20 20 63 68  ase file */.  ch
0fe0: 61 72 20 2a 7a 4a 6f 75 72 6e 61 6c 3b 20 20 20  ar *zJournal;   
0ff0: 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4e 61 6d            /* Nam
1000: 65 20 6f 66 20 74 68 65 20 6a 6f 75 72 6e 61 6c  e of the journal
1010: 20 66 69 6c 65 20 2a 2f 0a 20 20 4f 73 46 69 6c   file */.  OsFil
1020: 65 20 66 64 2c 20 6a 66 64 3b 20 20 20 20 20 20  e fd, jfd;      
1030: 20 20 20 20 20 20 20 2f 2a 20 46 69 6c 65 20 64         /* File d
1040: 65 73 63 72 69 70 74 6f 72 73 20 66 6f 72 20 64  escriptors for d
1050: 61 74 61 62 61 73 65 20 61 6e 64 20 6a 6f 75 72  atabase and jour
1060: 6e 61 6c 20 2a 2f 0a 20 20 69 6e 74 20 6a 6f 75  nal */.  int jou
1070: 72 6e 61 6c 4f 70 65 6e 3b 20 20 20 20 20 20 20  rnalOpen;       
1080: 20 20 20 20 20 2f 2a 20 54 72 75 65 20 69 66 20       /* True if 
1090: 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 20 64 65 73  journal file des
10a0: 63 72 69 70 74 6f 72 73 20 69 73 20 76 61 6c 69  criptors is vali
10b0: 64 20 2a 2f 0a 20 20 69 6e 74 20 64 62 53 69 7a  d */.  int dbSiz
10c0: 65 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20  e;              
10d0: 20 20 20 2f 2a 20 4e 75 6d 62 65 72 20 6f 66 20     /* Number of 
10e0: 70 61 67 65 73 20 69 6e 20 74 68 65 20 66 69 6c  pages in the fil
10f0: 65 20 2a 2f 0a 20 20 69 6e 74 20 6f 72 69 67 44  e */.  int origD
1100: 62 53 69 7a 65 3b 20 20 20 20 20 20 20 20 20 20  bSize;          
1110: 20 20 20 2f 2a 20 64 62 53 69 7a 65 20 62 65 66     /* dbSize bef
1120: 6f 72 65 20 74 68 65 20 63 75 72 72 65 6e 74 20  ore the current 
1130: 63 68 61 6e 67 65 20 2a 2f 0a 20 20 69 6e 74 20  change */.  int 
1140: 6e 45 78 74 72 61 3b 20 20 20 20 20 20 20 20 20  nExtra;         
1150: 20 20 20 20 20 20 20 20 2f 2a 20 41 64 64 20 74          /* Add t
1160: 68 69 73 20 6d 61 6e 79 20 62 79 74 65 73 20 74  his many bytes t
1170: 6f 20 65 61 63 68 20 69 6e 2d 6d 65 6d 6f 72 79  o each in-memory
1180: 20 70 61 67 65 20 2a 2f 0a 20 20 76 6f 69 64 20   page */.  void 
1190: 28 2a 78 44 65 73 74 72 75 63 74 6f 72 29 28 76  (*xDestructor)(v
11a0: 6f 69 64 2a 29 3b 20 2f 2a 20 43 61 6c 6c 20 74  oid*); /* Call t
11b0: 68 69 73 20 72 6f 75 74 69 6e 65 20 77 68 65 6e  his routine when
11c0: 20 66 72 65 65 69 6e 67 20 70 61 67 65 73 20 2a   freeing pages *
11d0: 2f 0a 20 20 69 6e 74 20 6e 50 61 67 65 3b 20 20  /.  int nPage;  
11e0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
11f0: 2f 2a 20 54 6f 74 61 6c 20 6e 75 6d 62 65 72 20  /* Total number 
1200: 6f 66 20 69 6e 2d 6d 65 6d 6f 72 79 20 70 61 67  of in-memory pag
1210: 65 73 20 2a 2f 0a 20 20 69 6e 74 20 6e 52 65 66  es */.  int nRef
1220: 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20  ;               
1230: 20 20 20 20 2f 2a 20 4e 75 6d 62 65 72 20 6f 66      /* Number of
1240: 20 69 6e 2d 6d 65 6d 6f 72 79 20 70 61 67 65 73   in-memory pages
1250: 20 77 69 74 68 20 50 67 48 64 72 2e 6e 52 65 66   with PgHdr.nRef
1260: 3e 30 20 2a 2f 0a 20 20 69 6e 74 20 6d 78 50 61  >0 */.  int mxPa
1270: 67 65 3b 20 20 20 20 20 20 20 20 20 20 20 20 20  ge;             
1280: 20 20 20 20 2f 2a 20 4d 61 78 69 6d 75 6d 20 6e      /* Maximum n
1290: 75 6d 62 65 72 20 6f 66 20 70 61 67 65 73 20 74  umber of pages t
12a0: 6f 20 68 6f 6c 64 20 69 6e 20 63 61 63 68 65 20  o hold in cache 
12b0: 2a 2f 0a 20 20 69 6e 74 20 6e 48 69 74 2c 20 6e  */.  int nHit, n
12c0: 4d 69 73 73 2c 20 6e 4f 76 66 6c 3b 20 20 20 20  Miss, nOvfl;    
12d0: 20 2f 2a 20 43 61 63 68 65 20 68 69 74 73 2c 20   /* Cache hits, 
12e0: 6d 69 73 73 69 6e 67 2c 20 61 6e 64 20 4c 52 55  missing, and LRU
12f0: 20 6f 76 65 72 66 6c 6f 77 73 20 2a 2f 0a 20 20   overflows */.  
1300: 75 6e 73 69 67 6e 65 64 20 63 68 61 72 20 73 74  unsigned char st
1310: 61 74 65 3b 20 20 20 20 20 20 20 20 2f 2a 20 53  ate;        /* S
1320: 51 4c 49 54 45 5f 55 4e 4c 4f 43 4b 2c 20 5f 52  QLITE_UNLOCK, _R
1330: 45 41 44 4c 4f 43 4b 20 6f 72 20 5f 57 52 49 54  EADLOCK or _WRIT
1340: 45 4c 4f 43 4b 20 2a 2f 0a 20 20 75 6e 73 69 67  ELOCK */.  unsig
1350: 6e 65 64 20 63 68 61 72 20 65 72 72 4d 61 73 6b  ned char errMask
1360: 3b 20 20 20 20 20 20 2f 2a 20 4f 6e 65 20 6f 66  ;      /* One of
1370: 20 73 65 76 65 72 61 6c 20 6b 69 6e 64 73 20 6f   several kinds o
1380: 66 20 65 72 72 6f 72 73 20 2a 2f 0a 20 20 75 6e  f errors */.  un
1390: 73 69 67 6e 65 64 20 63 68 61 72 20 74 65 6d 70  signed char temp
13a0: 46 69 6c 65 3b 20 20 20 20 20 2f 2a 20 7a 46 69  File;     /* zFi
13b0: 6c 65 6e 61 6d 65 20 69 73 20 61 20 74 65 6d 70  lename is a temp
13c0: 6f 72 61 72 79 20 66 69 6c 65 20 2a 2f 0a 20 20  orary file */.  
13d0: 75 6e 73 69 67 6e 65 64 20 63 68 61 72 20 72 65  unsigned char re
13e0: 61 64 4f 6e 6c 79 3b 20 20 20 20 20 2f 2a 20 54  adOnly;     /* T
13f0: 72 75 65 20 66 6f 72 20 61 20 72 65 61 64 2d 6f  rue for a read-o
1400: 6e 6c 79 20 64 61 74 61 62 61 73 65 20 2a 2f 0a  nly database */.
1410: 20 20 75 6e 73 69 67 6e 65 64 20 63 68 61 72 20    unsigned char 
1420: 6e 65 65 64 53 79 6e 63 3b 20 20 20 20 20 2f 2a  needSync;     /*
1430: 20 54 72 75 65 20 69 66 20 61 6e 20 66 73 79 6e   True if an fsyn
1440: 63 28 29 20 69 73 20 6e 65 65 64 65 64 20 6f 6e  c() is needed on
1450: 20 74 68 65 20 6a 6f 75 72 6e 61 6c 20 2a 2f 0a   the journal */.
1460: 20 20 75 6e 73 69 67 6e 65 64 20 63 68 61 72 20    unsigned char 
1470: 2a 61 49 6e 4a 6f 75 72 6e 61 6c 3b 20 20 2f 2a  *aInJournal;  /*
1480: 20 4f 6e 65 20 62 69 74 20 66 6f 72 20 65 61 63   One bit for eac
1490: 68 20 70 61 67 65 20 69 6e 20 74 68 65 20 64 61  h page in the da
14a0: 74 61 62 61 73 65 20 66 69 6c 65 20 2a 2f 0a 20  tabase file */. 
14b0: 20 50 67 48 64 72 20 2a 70 46 69 72 73 74 2c 20   PgHdr *pFirst, 
14c0: 2a 70 4c 61 73 74 3b 20 20 20 20 20 20 2f 2a 20  *pLast;      /* 
14d0: 4c 69 73 74 20 6f 66 20 66 72 65 65 20 70 61 67  List of free pag
14e0: 65 73 20 2a 2f 0a 20 20 50 67 48 64 72 20 2a 70  es */.  PgHdr *p
14f0: 41 6c 6c 3b 20 20 20 20 20 20 20 20 20 20 20 20  All;            
1500: 20 20 20 20 2f 2a 20 4c 69 73 74 20 6f 66 20 61      /* List of a
1510: 6c 6c 20 70 61 67 65 73 20 2a 2f 0a 20 20 50 67  ll pages */.  Pg
1520: 48 64 72 20 2a 61 48 61 73 68 5b 4e 5f 50 47 5f  Hdr *aHash[N_PG_
1530: 48 41 53 48 5d 3b 20 20 20 20 2f 2a 20 48 61 73  HASH];    /* Has
1540: 68 20 74 61 62 6c 65 20 74 6f 20 6d 61 70 20 70  h table to map p
1550: 61 67 65 20 6e 75 6d 62 65 72 20 6f 66 20 50 67  age number of Pg
1560: 48 64 72 20 2a 2f 0a 7d 3b 0a 0a 2f 2a 0a 2a 2a  Hdr */.};../*.**
1570: 20 54 68 65 73 65 20 61 72 65 20 62 69 74 73 20   These are bits 
1580: 74 68 61 74 20 63 61 6e 20 62 65 20 73 65 74 20  that can be set 
1590: 69 6e 20 50 61 67 65 72 2e 65 72 72 4d 61 73 6b  in Pager.errMask
15a0: 2e 0a 2a 2f 0a 23 64 65 66 69 6e 65 20 50 41 47  ..*/.#define PAG
15b0: 45 52 5f 45 52 52 5f 46 55 4c 4c 20 20 20 20 20  ER_ERR_FULL     
15c0: 30 78 30 31 20 20 2f 2a 20 61 20 77 72 69 74 65  0x01  /* a write
15d0: 28 29 20 66 61 69 6c 65 64 20 2a 2f 0a 23 64 65  () failed */.#de
15e0: 66 69 6e 65 20 50 41 47 45 52 5f 45 52 52 5f 4d  fine PAGER_ERR_M
15f0: 45 4d 20 20 20 20 20 20 30 78 30 32 20 20 2f 2a  EM      0x02  /*
1600: 20 6d 61 6c 6c 6f 63 28 29 20 66 61 69 6c 65 64   malloc() failed
1610: 20 2a 2f 0a 23 64 65 66 69 6e 65 20 50 41 47 45   */.#define PAGE
1620: 52 5f 45 52 52 5f 4c 4f 43 4b 20 20 20 20 20 30  R_ERR_LOCK     0
1630: 78 30 34 20 20 2f 2a 20 65 72 72 6f 72 20 69 6e  x04  /* error in
1640: 20 74 68 65 20 6c 6f 63 6b 69 6e 67 20 70 72 6f   the locking pro
1650: 74 6f 63 6f 6c 20 2a 2f 0a 23 64 65 66 69 6e 65  tocol */.#define
1660: 20 50 41 47 45 52 5f 45 52 52 5f 43 4f 52 52 55   PAGER_ERR_CORRU
1670: 50 54 20 20 30 78 30 38 20 20 2f 2a 20 64 61 74  PT  0x08  /* dat
1680: 61 62 61 73 65 20 6f 72 20 6a 6f 75 72 6e 61 6c  abase or journal
1690: 20 63 6f 72 72 75 70 74 69 6f 6e 20 2a 2f 0a 0a   corruption */..
16a0: 2f 2a 0a 2a 2a 20 54 68 65 20 6a 6f 75 72 6e 61  /*.** The journa
16b0: 6c 20 66 69 6c 65 20 63 6f 6e 74 61 69 6e 73 20  l file contains 
16c0: 70 61 67 65 20 72 65 63 6f 72 64 73 20 69 6e 20  page records in 
16d0: 74 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 0a 2a 2a  the following.**
16e0: 20 66 6f 72 6d 61 74 2e 0a 2a 2f 0a 74 79 70 65   format..*/.type
16f0: 64 65 66 20 73 74 72 75 63 74 20 50 61 67 65 52  def struct PageR
1700: 65 63 6f 72 64 20 50 61 67 65 52 65 63 6f 72 64  ecord PageRecord
1710: 3b 0a 73 74 72 75 63 74 20 50 61 67 65 52 65 63  ;.struct PageRec
1720: 6f 72 64 20 7b 0a 20 20 50 67 6e 6f 20 70 67 6e  ord {.  Pgno pgn
1730: 6f 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20  o;              
1740: 20 20 20 20 20 20 20 2f 2a 20 54 68 65 20 70 61         /* The pa
1750: 67 65 20 6e 75 6d 62 65 72 20 2a 2f 0a 20 20 63  ge number */.  c
1760: 68 61 72 20 61 44 61 74 61 5b 53 51 4c 49 54 45  har aData[SQLITE
1770: 5f 50 41 47 45 5f 53 49 5a 45 5d 3b 20 20 2f 2a  _PAGE_SIZE];  /*
1780: 20 4f 72 69 67 69 6e 61 6c 20 64 61 74 61 20 66   Original data f
1790: 6f 72 20 70 61 67 65 20 70 67 6e 6f 20 2a 2f 0a  or page pgno */.
17a0: 7d 3b 0a 0a 2f 2a 0a 2a 2a 20 4a 6f 75 72 6e 61  };../*.** Journa
17b0: 6c 20 66 69 6c 65 73 20 62 65 67 69 6e 20 77 69  l files begin wi
17c0: 74 68 20 74 68 65 20 66 6f 6c 6c 6f 77 69 6e 67  th the following
17d0: 20 6d 61 67 69 63 20 73 74 72 69 6e 67 2e 20 20   magic string.  
17e0: 54 68 65 20 64 61 74 61 0a 2a 2a 20 77 61 73 20  The data.** was 
17f0: 6f 62 74 61 69 6e 65 64 20 66 72 6f 6d 20 2f 64  obtained from /d
1800: 65 76 2f 72 61 6e 64 6f 6d 2e 20 20 49 74 20 69  ev/random.  It i
1810: 73 20 75 73 65 64 20 6f 6e 6c 79 20 61 73 20 61  s used only as a
1820: 20 73 61 6e 69 74 79 20 63 68 65 63 6b 2e 0a 2a   sanity check..*
1830: 2f 0a 73 74 61 74 69 63 20 63 6f 6e 73 74 20 75  /.static const u
1840: 6e 73 69 67 6e 65 64 20 63 68 61 72 20 61 4a 6f  nsigned char aJo
1850: 75 72 6e 61 6c 4d 61 67 69 63 5b 5d 20 3d 20 7b  urnalMagic[] = {
1860: 0a 20 20 30 78 64 39 2c 20 30 78 64 35 2c 20 30  .  0xd9, 0xd5, 0
1870: 78 30 35 2c 20 30 78 66 39 2c 20 30 78 32 30 2c  x05, 0xf9, 0x20,
1880: 20 30 78 61 31 2c 20 30 78 36 33 2c 20 30 78 64   0xa1, 0x63, 0xd
1890: 34 2c 0a 7d 3b 0a 0a 2f 2a 0a 2a 2a 20 48 61 73  4,.};../*.** Has
18a0: 68 20 61 20 70 61 67 65 20 6e 75 6d 62 65 72 0a  h a page number.
18b0: 2a 2f 0a 23 64 65 66 69 6e 65 20 70 61 67 65 72  */.#define pager
18c0: 5f 68 61 73 68 28 50 4e 29 20 20 28 28 50 4e 29  _hash(PN)  ((PN)
18d0: 25 4e 5f 50 47 5f 48 41 53 48 29 0a 0a 2f 2a 0a  %N_PG_HASH)../*.
18e0: 2a 2a 20 45 6e 61 62 6c 65 20 72 65 66 65 72 65  ** Enable refere
18f0: 6e 63 65 20 63 6f 75 6e 74 20 74 72 61 63 6b 69  nce count tracki
1900: 6e 67 20 68 65 72 65 3a 0a 2a 2f 0a 23 69 66 20  ng here:.*/.#if 
1910: 53 51 4c 49 54 45 5f 54 45 53 54 0a 20 20 69 6e  SQLITE_TEST.  in
1920: 74 20 70 61 67 65 72 5f 72 65 66 69 6e 66 6f 5f  t pager_refinfo_
1930: 65 6e 61 62 6c 65 20 3d 20 30 3b 0a 20 20 73 74  enable = 0;.  st
1940: 61 74 69 63 20 76 6f 69 64 20 70 61 67 65 72 5f  atic void pager_
1950: 72 65 66 69 6e 66 6f 28 50 67 48 64 72 20 2a 70  refinfo(PgHdr *p
1960: 29 7b 0a 20 20 20 20 73 74 61 74 69 63 20 69 6e  ){.    static in
1970: 74 20 63 6e 74 20 3d 20 30 3b 0a 20 20 20 20 69  t cnt = 0;.    i
1980: 66 28 20 21 70 61 67 65 72 5f 72 65 66 69 6e 66  f( !pager_refinf
1990: 6f 5f 65 6e 61 62 6c 65 20 29 20 72 65 74 75 72  o_enable ) retur
19a0: 6e 3b 0a 20 20 20 20 70 72 69 6e 74 66 28 0a 20  n;.    printf(. 
19b0: 20 20 20 20 20 20 22 52 45 46 43 4e 54 3a 20 25        "REFCNT: %
19c0: 34 64 20 61 64 64 72 3d 30 78 25 30 38 78 20 6e  4d addr=0x%08x n
19d0: 52 65 66 3d 25 64 5c 6e 22 2c 0a 20 20 20 20 20  Ref=%d\n",.     
19e0: 20 20 70 2d 3e 70 67 6e 6f 2c 20 28 69 6e 74 29    p->pgno, (int)
19f0: 50 47 48 44 52 5f 54 4f 5f 44 41 54 41 28 70 29  PGHDR_TO_DATA(p)
1a00: 2c 20 70 2d 3e 6e 52 65 66 0a 20 20 20 20 29 3b  , p->nRef.    );
1a10: 0a 20 20 20 20 63 6e 74 2b 2b 3b 20 20 20 2f 2a  .    cnt++;   /*
1a20: 20 53 6f 6d 65 74 68 69 6e 67 20 74 6f 20 73 65   Something to se
1a30: 74 20 61 20 62 72 65 61 6b 70 6f 69 6e 74 20 6f  t a breakpoint o
1a40: 6e 20 2a 2f 0a 20 20 7d 0a 23 20 64 65 66 69 6e  n */.  }.# defin
1a50: 65 20 52 45 46 49 4e 46 4f 28 58 29 20 20 70 61  e REFINFO(X)  pa
1a60: 67 65 72 5f 72 65 66 69 6e 66 6f 28 58 29 0a 23  ger_refinfo(X).#
1a70: 65 6c 73 65 0a 23 20 64 65 66 69 6e 65 20 52 45  else.# define RE
1a80: 46 49 4e 46 4f 28 58 29 0a 23 65 6e 64 69 66 0a  FINFO(X).#endif.
1a90: 0a 2f 2a 0a 2a 2a 20 43 6f 6e 76 65 72 74 20 74  ./*.** Convert t
1aa0: 68 65 20 62 69 74 73 20 69 6e 20 74 68 65 20 70  he bits in the p
1ab0: 50 61 67 65 72 2d 3e 65 72 72 4d 61 73 6b 20 69  Pager->errMask i
1ac0: 6e 74 6f 20 61 6e 20 61 70 70 72 6f 70 72 61 74  nto an approprat
1ad0: 65 0a 2a 2a 20 72 65 74 75 72 6e 20 63 6f 64 65  e.** return code
1ae0: 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74 20  ..*/.static int 
1af0: 70 61 67 65 72 5f 65 72 72 63 6f 64 65 28 50 61  pager_errcode(Pa
1b00: 67 65 72 20 2a 70 50 61 67 65 72 29 7b 0a 20 20  ger *pPager){.  
1b10: 69 6e 74 20 72 63 20 3d 20 53 51 4c 49 54 45 5f  int rc = SQLITE_
1b20: 4f 4b 3b 0a 20 20 69 66 28 20 70 50 61 67 65 72  OK;.  if( pPager
1b30: 2d 3e 65 72 72 4d 61 73 6b 20 26 20 50 41 47 45  ->errMask & PAGE
1b40: 52 5f 45 52 52 5f 4c 4f 43 4b 20 29 20 20 20 20  R_ERR_LOCK )    
1b50: 72 63 20 3d 20 53 51 4c 49 54 45 5f 50 52 4f 54  rc = SQLITE_PROT
1b60: 4f 43 4f 4c 3b 0a 20 20 69 66 28 20 70 50 61 67  OCOL;.  if( pPag
1b70: 65 72 2d 3e 65 72 72 4d 61 73 6b 20 26 20 50 41  er->errMask & PA
1b80: 47 45 52 5f 45 52 52 5f 46 55 4c 4c 20 29 20 20  GER_ERR_FULL )  
1b90: 20 20 72 63 20 3d 20 53 51 4c 49 54 45 5f 46 55    rc = SQLITE_FU
1ba0: 4c 4c 3b 0a 20 20 69 66 28 20 70 50 61 67 65 72  LL;.  if( pPager
1bb0: 2d 3e 65 72 72 4d 61 73 6b 20 26 20 50 41 47 45  ->errMask & PAGE
1bc0: 52 5f 45 52 52 5f 4d 45 4d 20 29 20 20 20 20 20  R_ERR_MEM )     
1bd0: 72 63 20 3d 20 53 51 4c 49 54 45 5f 4e 4f 4d 45  rc = SQLITE_NOME
1be0: 4d 3b 0a 20 20 69 66 28 20 70 50 61 67 65 72 2d  M;.  if( pPager-
1bf0: 3e 65 72 72 4d 61 73 6b 20 26 20 50 41 47 45 52  >errMask & PAGER
1c00: 5f 45 52 52 5f 43 4f 52 52 55 50 54 20 29 20 72  _ERR_CORRUPT ) r
1c10: 63 20 3d 20 53 51 4c 49 54 45 5f 43 4f 52 52 55  c = SQLITE_CORRU
1c20: 50 54 3b 0a 20 20 72 65 74 75 72 6e 20 72 63 3b  PT;.  return rc;
1c30: 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 46 69 6e 64 20 61  .}../*.** Find a
1c40: 20 70 61 67 65 20 69 6e 20 74 68 65 20 68 61 73   page in the has
1c50: 68 20 74 61 62 6c 65 20 67 69 76 65 6e 20 69 74  h table given it
1c60: 73 20 70 61 67 65 20 6e 75 6d 62 65 72 2e 20 20  s page number.  
1c70: 52 65 74 75 72 6e 0a 2a 2a 20 61 20 70 6f 69 6e  Return.** a poin
1c80: 74 65 72 20 74 6f 20 74 68 65 20 70 61 67 65 20  ter to the page 
1c90: 6f 72 20 4e 55 4c 4c 20 69 66 20 6e 6f 74 20 66  or NULL if not f
1ca0: 6f 75 6e 64 2e 0a 2a 2f 0a 73 74 61 74 69 63 20  ound..*/.static 
1cb0: 50 67 48 64 72 20 2a 70 61 67 65 72 5f 6c 6f 6f  PgHdr *pager_loo
1cc0: 6b 75 70 28 50 61 67 65 72 20 2a 70 50 61 67 65  kup(Pager *pPage
1cd0: 72 2c 20 50 67 6e 6f 20 70 67 6e 6f 29 7b 0a 20  r, Pgno pgno){. 
1ce0: 20 50 67 48 64 72 20 2a 70 20 3d 20 70 50 61 67   PgHdr *p = pPag
1cf0: 65 72 2d 3e 61 48 61 73 68 5b 70 67 6e 6f 20 25  er->aHash[pgno %
1d00: 20 4e 5f 50 47 5f 48 41 53 48 5d 3b 0a 20 20 77   N_PG_HASH];.  w
1d10: 68 69 6c 65 28 20 70 20 26 26 20 70 2d 3e 70 67  hile( p && p->pg
1d20: 6e 6f 21 3d 70 67 6e 6f 20 29 7b 0a 20 20 20 20  no!=pgno ){.    
1d30: 70 20 3d 20 70 2d 3e 70 4e 65 78 74 48 61 73 68  p = p->pNextHash
1d40: 3b 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e 20 70  ;.  }.  return p
1d50: 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 55 6e 6c 6f 63  ;.}../*.** Unloc
1d60: 6b 20 74 68 65 20 64 61 74 61 62 61 73 65 20 61  k the database a
1d70: 6e 64 20 63 6c 65 61 72 20 74 68 65 20 69 6e 2d  nd clear the in-
1d80: 6d 65 6d 6f 72 79 20 63 61 63 68 65 2e 20 20 54  memory cache.  T
1d90: 68 69 73 20 72 6f 75 74 69 6e 65 0a 2a 2a 20 73  his routine.** s
1da0: 65 74 73 20 74 68 65 20 73 74 61 74 65 20 6f 66  ets the state of
1db0: 20 74 68 65 20 70 61 67 65 72 20 62 61 63 6b 20   the pager back 
1dc0: 74 6f 20 77 68 61 74 20 69 74 20 77 61 73 20 77  to what it was w
1dd0: 68 65 6e 20 69 74 20 77 61 73 20 66 69 72 73 74  hen it was first
1de0: 0a 2a 2a 20 6f 70 65 6e 65 64 2e 20 20 41 6e 79  .** opened.  Any
1df0: 20 6f 75 74 73 74 61 6e 64 69 6e 67 20 70 61 67   outstanding pag
1e00: 65 73 20 61 72 65 20 69 6e 76 61 6c 69 64 61 74  es are invalidat
1e10: 65 64 20 61 6e 64 20 73 75 62 73 65 71 75 65 6e  ed and subsequen
1e20: 74 20 61 74 74 65 6d 70 74 73 0a 2a 2a 20 74 6f  t attempts.** to
1e30: 20 61 63 63 65 73 73 20 74 68 6f 73 65 20 70 61   access those pa
1e40: 67 65 73 20 77 69 6c 6c 20 6c 69 6b 65 6c 79 20  ges will likely 
1e50: 72 65 73 75 6c 74 20 69 6e 20 61 20 63 6f 72 65  result in a core
1e60: 64 75 6d 70 2e 0a 2a 2f 0a 73 74 61 74 69 63 20  dump..*/.static 
1e70: 76 6f 69 64 20 70 61 67 65 72 5f 72 65 73 65 74  void pager_reset
1e80: 28 50 61 67 65 72 20 2a 70 50 61 67 65 72 29 7b  (Pager *pPager){
1e90: 0a 20 20 50 67 48 64 72 20 2a 70 50 67 2c 20 2a  .  PgHdr *pPg, *
1ea0: 70 4e 65 78 74 3b 0a 20 20 66 6f 72 28 70 50 67  pNext;.  for(pPg
1eb0: 3d 70 50 61 67 65 72 2d 3e 70 41 6c 6c 3b 20 70  =pPager->pAll; p
1ec0: 50 67 3b 20 70 50 67 3d 70 4e 65 78 74 29 7b 0a  Pg; pPg=pNext){.
1ed0: 20 20 20 20 70 4e 65 78 74 20 3d 20 70 50 67 2d      pNext = pPg-
1ee0: 3e 70 4e 65 78 74 41 6c 6c 3b 0a 20 20 20 20 73  >pNextAll;.    s
1ef0: 71 6c 69 74 65 46 72 65 65 28 70 50 67 29 3b 0a  qliteFree(pPg);.
1f00: 20 20 7d 0a 20 20 70 50 61 67 65 72 2d 3e 70 46    }.  pPager->pF
1f10: 69 72 73 74 20 3d 20 30 3b 0a 20 20 70 50 61 67  irst = 0;.  pPag
1f20: 65 72 2d 3e 70 4c 61 73 74 20 3d 20 30 3b 0a 20  er->pLast = 0;. 
1f30: 20 70 50 61 67 65 72 2d 3e 70 41 6c 6c 20 3d 20   pPager->pAll = 
1f40: 30 3b 0a 20 20 6d 65 6d 73 65 74 28 70 50 61 67  0;.  memset(pPag
1f50: 65 72 2d 3e 61 48 61 73 68 2c 20 30 2c 20 73 69  er->aHash, 0, si
1f60: 7a 65 6f 66 28 70 50 61 67 65 72 2d 3e 61 48 61  zeof(pPager->aHa
1f70: 73 68 29 29 3b 0a 20 20 70 50 61 67 65 72 2d 3e  sh));.  pPager->
1f80: 6e 50 61 67 65 20 3d 20 30 3b 0a 20 20 69 66 28  nPage = 0;.  if(
1f90: 20 70 50 61 67 65 72 2d 3e 73 74 61 74 65 3d 3d   pPager->state==
1fa0: 53 51 4c 49 54 45 5f 57 52 49 54 45 4c 4f 43 4b  SQLITE_WRITELOCK
1fb0: 20 29 7b 0a 20 20 20 20 73 71 6c 69 74 65 70 61   ){.    sqlitepa
1fc0: 67 65 72 5f 72 6f 6c 6c 62 61 63 6b 28 70 50 61  ger_rollback(pPa
1fd0: 67 65 72 29 3b 0a 20 20 7d 0a 20 20 73 71 6c 69  ger);.  }.  sqli
1fe0: 74 65 4f 73 55 6e 6c 6f 63 6b 28 70 50 61 67 65  teOsUnlock(pPage
1ff0: 72 2d 3e 66 64 29 3b 0a 20 20 70 50 61 67 65 72  r->fd);.  pPager
2000: 2d 3e 73 74 61 74 65 20 3d 20 53 51 4c 49 54 45  ->state = SQLITE
2010: 5f 55 4e 4c 4f 43 4b 3b 0a 20 20 70 50 61 67 65  _UNLOCK;.  pPage
2020: 72 2d 3e 64 62 53 69 7a 65 20 3d 20 2d 31 3b 0a  r->dbSize = -1;.
2030: 20 20 70 50 61 67 65 72 2d 3e 6e 52 65 66 20 3d    pPager->nRef =
2040: 20 30 3b 0a 20 20 61 73 73 65 72 74 28 20 70 50   0;.  assert( pP
2050: 61 67 65 72 2d 3e 6a 6f 75 72 6e 61 6c 4f 70 65  ager->journalOpe
2060: 6e 3d 3d 30 20 29 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a  n==0 );.}../*.**
2070: 20 57 68 65 6e 20 74 68 69 73 20 72 6f 75 74 69   When this routi
2080: 6e 65 20 69 73 20 63 61 6c 6c 65 64 2c 20 74 68  ne is called, th
2090: 65 20 70 61 67 65 72 20 68 61 73 20 74 68 65 20  e pager has the 
20a0: 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 20 6f 70 65  journal file ope
20b0: 6e 20 61 6e 64 0a 2a 2a 20 61 20 77 72 69 74 65  n and.** a write
20c0: 20 6c 6f 63 6b 20 6f 6e 20 74 68 65 20 64 61 74   lock on the dat
20d0: 61 62 61 73 65 2e 20 20 54 68 69 73 20 72 6f 75  abase.  This rou
20e0: 74 69 6e 65 20 72 65 6c 65 61 73 65 73 20 74 68  tine releases th
20f0: 65 20 64 61 74 61 62 61 73 65 0a 2a 2a 20 77 72  e database.** wr
2100: 69 74 65 20 6c 6f 63 6b 20 61 6e 64 20 61 63 71  ite lock and acq
2110: 75 69 72 65 73 20 61 20 72 65 61 64 20 6c 6f 63  uires a read loc
2120: 6b 20 69 6e 20 69 74 73 20 70 6c 61 63 65 2e 20  k in its place. 
2130: 20 54 68 65 20 6a 6f 75 72 6e 61 6c 20 66 69 6c   The journal fil
2140: 65 0a 2a 2a 20 69 73 20 64 65 6c 65 74 65 64 20  e.** is deleted 
2150: 61 6e 64 20 63 6c 6f 73 65 64 2e 0a 2a 2a 0a 2a  and closed..**.*
2160: 2a 20 57 65 20 68 61 76 65 20 74 6f 20 72 65 6c  * We have to rel
2170: 65 61 73 65 20 74 68 65 20 77 72 69 74 65 20 6c  ease the write l
2180: 6f 63 6b 20 62 65 66 6f 72 65 20 61 63 71 75 69  ock before acqui
2190: 72 69 6e 67 20 74 68 65 20 72 65 61 64 20 6c 6f  ring the read lo
21a0: 63 6b 2c 0a 2a 2a 20 73 6f 20 74 68 65 72 65 20  ck,.** so there 
21b0: 69 73 20 61 20 72 61 63 65 20 63 6f 6e 64 69 74  is a race condit
21c0: 69 6f 6e 20 77 68 65 72 65 20 61 6e 6f 74 68 65  ion where anothe
21d0: 72 20 70 72 6f 63 65 73 73 20 63 61 6e 20 67 65  r process can ge
21e0: 74 20 74 68 65 20 6c 6f 63 6b 0a 2a 2a 20 77 68  t the lock.** wh
21f0: 69 6c 65 20 77 65 20 61 72 65 20 6e 6f 74 20 68  ile we are not h
2200: 6f 6c 64 69 6e 67 20 69 74 2e 20 20 42 75 74 2c  olding it.  But,
2210: 20 6e 6f 20 6f 74 68 65 72 20 70 72 6f 63 65 73   no other proces
2220: 73 20 73 68 6f 75 6c 64 20 64 6f 20 74 68 69 73  s should do this
2230: 0a 2a 2a 20 62 65 63 61 75 73 65 20 77 65 20 61  .** because we a
2240: 72 65 20 61 6c 73 6f 20 68 6f 6c 64 69 6e 67 20  re also holding 
2250: 61 20 6c 6f 63 6b 20 6f 6e 20 74 68 65 20 6a 6f  a lock on the jo
2260: 75 72 6e 61 6c 2c 20 61 6e 64 20 6e 6f 20 70 72  urnal, and no pr
2270: 6f 63 65 73 73 0a 2a 2a 20 73 68 6f 75 6c 64 20  ocess.** should 
2280: 67 65 74 20 61 20 77 72 69 74 65 20 6c 6f 63 6b  get a write lock
2290: 20 6f 6e 20 74 68 65 20 64 61 74 61 62 61 73 65   on the database
22a0: 20 77 69 74 68 6f 75 74 20 66 69 72 73 74 20 67   without first g
22b0: 65 74 74 69 6e 67 20 61 20 6c 6f 63 6b 0a 2a 2a  etting a lock.**
22c0: 20 6f 6e 20 74 68 65 20 6a 6f 75 72 6e 61 6c 2e   on the journal.
22d0: 20 20 53 6f 20 74 68 69 73 20 72 6f 75 74 69 6e    So this routin
22e0: 65 20 73 68 6f 75 6c 64 20 6e 65 76 65 72 20 66  e should never f
22f0: 61 69 6c 2e 20 20 42 75 74 20 69 74 20 63 61 6e  ail.  But it can
2300: 20 66 61 69 6c 0a 2a 2a 20 69 66 20 61 6e 6f 74   fail.** if anot
2310: 68 65 72 20 70 72 6f 63 65 73 73 20 69 73 20 6e  her process is n
2320: 6f 74 20 70 6c 61 79 69 6e 67 20 62 79 20 74 68  ot playing by th
2330: 65 20 72 75 6c 65 73 2e 20 20 49 66 20 69 74 20  e rules.  If it 
2340: 64 6f 65 73 20 66 61 69 6c 2c 0a 2a 2a 20 61 6c  does fail,.** al
2350: 6c 20 69 6e 2d 6d 65 6d 6f 72 79 20 63 61 63 68  l in-memory cach
2360: 65 20 70 61 67 65 73 20 61 72 65 20 69 6e 76 61  e pages are inva
2370: 6c 69 64 61 74 65 64 2c 20 74 68 65 20 50 41 47  lidated, the PAG
2380: 45 52 5f 45 52 52 5f 4c 4f 43 4b 20 62 69 74 0a  ER_ERR_LOCK bit.
2390: 2a 2a 20 69 73 20 73 65 74 20 69 6e 20 70 50 61  ** is set in pPa
23a0: 67 65 72 2d 3e 65 72 72 4d 61 73 6b 2c 20 61 6e  ger->errMask, an
23b0: 64 20 74 68 69 73 20 72 6f 75 74 69 6e 65 20 72  d this routine r
23c0: 65 74 75 72 6e 73 20 53 51 4c 49 54 45 5f 50 52  eturns SQLITE_PR
23d0: 4f 54 4f 43 4f 4c 2e 0a 2a 2a 20 53 51 4c 49 54  OTOCOL..** SQLIT
23e0: 45 5f 4f 4b 20 69 73 20 72 65 74 75 72 6e 65 64  E_OK is returned
23f0: 20 6f 6e 20 73 75 63 63 65 73 73 2e 0a 2a 2f 0a   on success..*/.
2400: 73 74 61 74 69 63 20 69 6e 74 20 70 61 67 65 72  static int pager
2410: 5f 75 6e 77 72 69 74 65 6c 6f 63 6b 28 50 61 67  _unwritelock(Pag
2420: 65 72 20 2a 70 50 61 67 65 72 29 7b 0a 20 20 69  er *pPager){.  i
2430: 6e 74 20 72 63 3b 0a 20 20 50 67 48 64 72 20 2a  nt rc;.  PgHdr *
2440: 70 50 67 3b 0a 20 20 69 66 28 20 70 50 61 67 65  pPg;.  if( pPage
2450: 72 2d 3e 73 74 61 74 65 21 3d 53 51 4c 49 54 45  r->state!=SQLITE
2460: 5f 57 52 49 54 45 4c 4f 43 4b 20 29 20 72 65 74  _WRITELOCK ) ret
2470: 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20  urn SQLITE_OK;. 
2480: 20 73 71 6c 69 74 65 4f 73 55 6e 6c 6f 63 6b 28   sqliteOsUnlock(
2490: 70 50 61 67 65 72 2d 3e 66 64 29 3b 0a 20 20 72  pPager->fd);.  r
24a0: 63 20 3d 20 73 71 6c 69 74 65 4f 73 4c 6f 63 6b  c = sqliteOsLock
24b0: 28 70 50 61 67 65 72 2d 3e 66 64 2c 20 30 29 3b  (pPager->fd, 0);
24c0: 0a 20 20 73 71 6c 69 74 65 4f 73 43 6c 6f 73 65  .  sqliteOsClose
24d0: 28 70 50 61 67 65 72 2d 3e 6a 66 64 29 3b 0a 20  (pPager->jfd);. 
24e0: 20 70 50 61 67 65 72 2d 3e 6a 6f 75 72 6e 61 6c   pPager->journal
24f0: 4f 70 65 6e 20 3d 20 30 3b 0a 20 20 73 71 6c 69  Open = 0;.  sqli
2500: 74 65 4f 73 44 65 6c 65 74 65 28 70 50 61 67 65  teOsDelete(pPage
2510: 72 2d 3e 7a 4a 6f 75 72 6e 61 6c 29 3b 0a 20 20  r->zJournal);.  
2520: 73 71 6c 69 74 65 46 72 65 65 28 20 70 50 61 67  sqliteFree( pPag
2530: 65 72 2d 3e 61 49 6e 4a 6f 75 72 6e 61 6c 20 29  er->aInJournal )
2540: 3b 0a 20 20 70 50 61 67 65 72 2d 3e 61 49 6e 4a  ;.  pPager->aInJ
2550: 6f 75 72 6e 61 6c 20 3d 20 30 3b 0a 20 20 66 6f  ournal = 0;.  fo
2560: 72 28 70 50 67 3d 70 50 61 67 65 72 2d 3e 70 41  r(pPg=pPager->pA
2570: 6c 6c 3b 20 70 50 67 3b 20 70 50 67 3d 70 50 67  ll; pPg; pPg=pPg
2580: 2d 3e 70 4e 65 78 74 41 6c 6c 29 7b 0a 20 20 20  ->pNextAll){.   
2590: 20 70 50 67 2d 3e 69 6e 4a 6f 75 72 6e 61 6c 20   pPg->inJournal 
25a0: 3d 20 30 3b 0a 20 20 20 20 70 50 67 2d 3e 64 69  = 0;.    pPg->di
25b0: 72 74 79 20 3d 20 30 3b 0a 20 20 7d 0a 20 20 69  rty = 0;.  }.  i
25c0: 66 28 20 72 63 21 3d 53 51 4c 49 54 45 5f 4f 4b  f( rc!=SQLITE_OK
25d0: 20 29 7b 0a 20 20 20 20 70 50 61 67 65 72 2d 3e   ){.    pPager->
25e0: 73 74 61 74 65 20 3d 20 53 51 4c 49 54 45 5f 55  state = SQLITE_U
25f0: 4e 4c 4f 43 4b 3b 0a 20 20 20 20 72 63 20 3d 20  NLOCK;.    rc = 
2600: 53 51 4c 49 54 45 5f 50 52 4f 54 4f 43 4f 4c 3b  SQLITE_PROTOCOL;
2610: 0a 20 20 20 20 70 50 61 67 65 72 2d 3e 65 72 72  .    pPager->err
2620: 4d 61 73 6b 20 7c 3d 20 50 41 47 45 52 5f 45 52  Mask |= PAGER_ER
2630: 52 5f 4c 4f 43 4b 3b 0a 20 20 7d 65 6c 73 65 7b  R_LOCK;.  }else{
2640: 0a 20 20 20 20 72 63 20 3d 20 53 51 4c 49 54 45  .    rc = SQLITE
2650: 5f 4f 4b 3b 0a 20 20 20 20 70 50 61 67 65 72 2d  _OK;.    pPager-
2660: 3e 73 74 61 74 65 20 3d 20 53 51 4c 49 54 45 5f  >state = SQLITE_
2670: 52 45 41 44 4c 4f 43 4b 3b 0a 20 20 7d 0a 20 20  READLOCK;.  }.  
2680: 72 65 74 75 72 6e 20 72 63 3b 0a 7d 0a 0a 2f 2a  return rc;.}../*
2690: 0a 2a 2a 20 50 6c 61 79 62 61 63 6b 20 74 68 65  .** Playback the
26a0: 20 6a 6f 75 72 6e 61 6c 20 61 6e 64 20 74 68 75   journal and thu
26b0: 73 20 72 65 73 74 6f 72 65 20 74 68 65 20 64 61  s restore the da
26c0: 74 61 62 61 73 65 20 66 69 6c 65 20 74 6f 0a 2a  tabase file to.*
26d0: 2a 20 74 68 65 20 73 74 61 74 65 20 69 74 20 77  * the state it w
26e0: 61 73 20 69 6e 20 62 65 66 6f 72 65 20 77 65 20  as in before we 
26f0: 73 74 61 72 74 65 64 20 6d 61 6b 69 6e 67 20 63  started making c
2700: 68 61 6e 67 65 73 2e 20 20 0a 2a 2a 0a 2a 2a 20  hanges.  .**.** 
2710: 54 68 65 20 6a 6f 75 72 6e 61 6c 20 66 69 6c 65  The journal file
2720: 20 66 6f 72 6d 61 74 20 69 73 20 61 73 20 66 6f   format is as fo
2730: 6c 6c 6f 77 73 3a 20 20 54 68 65 72 65 20 69 73  llows:  There is
2740: 20 61 6e 20 69 6e 69 74 69 61 6c 0a 2a 2a 20 66   an initial.** f
2750: 69 6c 65 2d 74 79 70 65 20 73 74 72 69 6e 67 20  ile-type string 
2760: 66 6f 72 20 73 61 6e 69 74 79 20 63 68 65 63 6b  for sanity check
2770: 69 6e 67 2e 20 20 54 68 65 6e 20 74 68 65 72 65  ing.  Then there
2780: 20 69 73 20 61 20 73 69 6e 67 6c 65 0a 2a 2a 20   is a single.** 
2790: 50 67 6e 6f 20 6e 75 6d 62 65 72 20 77 68 69 63  Pgno number whic
27a0: 68 20 69 73 20 74 68 65 20 6e 75 6d 62 65 72 20  h is the number 
27b0: 6f 66 20 70 61 67 65 73 20 69 6e 20 74 68 65 20  of pages in the 
27c0: 64 61 74 61 62 61 73 65 20 62 65 66 6f 72 65 0a  database before.
27d0: 2a 2a 20 63 68 61 6e 67 65 73 20 77 65 72 65 20  ** changes were 
27e0: 6d 61 64 65 2e 20 20 54 68 65 20 64 61 74 61 62  made.  The datab
27f0: 61 73 65 20 69 73 20 74 72 75 6e 63 61 74 65 64  ase is truncated
2800: 20 74 6f 20 74 68 69 73 20 73 69 7a 65 2e 0a 2a   to this size..*
2810: 2a 20 4e 65 78 74 20 63 6f 6d 65 20 7a 65 72 6f  * Next come zero
2820: 20 6f 72 20 6d 6f 72 65 20 70 61 67 65 20 72 65   or more page re
2830: 63 6f 72 64 73 20 77 68 65 72 65 20 65 61 63 68  cords where each
2840: 20 70 61 67 65 20 72 65 63 6f 72 64 0a 2a 2a 20   page record.** 
2850: 63 6f 6e 73 69 73 74 73 20 6f 66 20 61 20 50 67  consists of a Pg
2860: 6e 6f 20 61 6e 64 20 53 51 4c 49 54 45 5f 50 41  no and SQLITE_PA
2870: 47 45 5f 53 49 5a 45 20 62 79 74 65 73 20 6f 66  GE_SIZE bytes of
2880: 20 64 61 74 61 2e 20 20 53 65 65 0a 2a 2a 20 74   data.  See.** t
2890: 68 65 20 50 61 67 65 52 65 63 6f 72 64 20 73 74  he PageRecord st
28a0: 72 75 63 74 75 72 65 20 66 6f 72 20 64 65 74 61  ructure for deta
28b0: 69 6c 73 2e 0a 2a 2a 0a 2a 2a 20 46 6f 72 20 70  ils..**.** For p
28c0: 6c 61 79 62 61 63 6b 2c 20 74 68 65 20 70 61 67  layback, the pag
28d0: 65 73 20 68 61 76 65 20 74 6f 20 62 65 20 72 65  es have to be re
28e0: 61 64 20 66 72 6f 6d 20 74 68 65 20 6a 6f 75 72  ad from the jour
28f0: 6e 61 6c 20 69 6e 0a 2a 2a 20 72 65 76 65 72 73  nal in.** revers
2900: 65 20 6f 72 64 65 72 20 61 6e 64 20 70 75 74 20  e order and put 
2910: 62 61 63 6b 20 69 6e 74 6f 20 74 68 65 20 6f 72  back into the or
2920: 69 67 69 6e 61 6c 20 64 61 74 61 62 61 73 65 20  iginal database 
2930: 66 69 6c 65 2e 0a 2a 2a 0a 2a 2a 20 49 66 20 74  file..**.** If t
2940: 68 65 20 66 69 6c 65 20 6f 70 65 6e 65 64 20 61  he file opened a
2950: 73 20 74 68 65 20 6a 6f 75 72 6e 61 6c 20 66 69  s the journal fi
2960: 6c 65 20 69 73 20 6e 6f 74 20 61 20 77 65 6c 6c  le is not a well
2970: 2d 66 6f 72 6d 65 64 0a 2a 2a 20 6a 6f 75 72 6e  -formed.** journ
2980: 61 6c 20 66 69 6c 65 20 28 61 73 20 64 65 74 65  al file (as dete
2990: 72 6d 69 6e 65 64 20 62 79 20 6c 6f 6f 6b 69 6e  rmined by lookin
29a0: 67 20 61 74 20 74 68 65 20 6d 61 67 69 63 20 6e  g at the magic n
29b0: 75 6d 62 65 72 0a 2a 2a 20 61 74 20 74 68 65 20  umber.** at the 
29c0: 62 65 67 69 6e 6e 69 6e 67 29 20 74 68 65 6e 20  beginning) then 
29d0: 74 68 69 73 20 72 6f 75 74 69 6e 65 20 72 65 74  this routine ret
29e0: 75 72 6e 73 20 53 51 4c 49 54 45 5f 50 52 4f 54  urns SQLITE_PROT
29f0: 4f 43 4f 4c 2e 0a 2a 2a 20 49 66 20 61 6e 79 20  OCOL..** If any 
2a00: 6f 74 68 65 72 20 65 72 72 6f 72 73 20 6f 63 63  other errors occ
2a10: 75 72 20 64 75 72 69 6e 67 20 70 6c 61 79 62 61  ur during playba
2a20: 63 6b 2c 20 74 68 65 20 64 61 74 61 62 61 73 65  ck, the database
2a30: 20 77 69 6c 6c 0a 2a 2a 20 6c 69 6b 65 6c 79 20   will.** likely 
2a40: 62 65 20 63 6f 72 72 75 70 74 65 64 2c 20 73 6f  be corrupted, so
2a50: 20 74 68 65 20 50 41 47 45 52 5f 45 52 52 5f 43   the PAGER_ERR_C
2a60: 4f 52 52 55 50 54 20 62 69 74 20 69 73 20 73 65  ORRUPT bit is se
2a70: 74 20 69 6e 0a 2a 2a 20 70 50 61 67 65 72 2d 3e  t in.** pPager->
2a80: 65 72 72 4d 61 73 6b 20 61 6e 64 20 53 51 4c 49  errMask and SQLI
2a90: 54 45 5f 43 4f 52 52 55 50 54 20 69 73 20 72 65  TE_CORRUPT is re
2aa0: 74 75 72 6e 65 64 2e 20 20 49 66 20 69 74 20 61  turned.  If it a
2ab0: 6c 6c 0a 2a 2a 20 77 6f 72 6b 73 2c 20 74 68 65  ll.** works, the
2ac0: 6e 20 74 68 69 73 20 72 6f 75 74 69 6e 65 20 72  n this routine r
2ad0: 65 74 75 72 6e 73 20 53 51 4c 49 54 45 5f 4f 4b  eturns SQLITE_OK
2ae0: 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74 20  ..*/.static int 
2af0: 70 61 67 65 72 5f 70 6c 61 79 62 61 63 6b 28 50  pager_playback(P
2b00: 61 67 65 72 20 2a 70 50 61 67 65 72 29 7b 0a 20  ager *pPager){. 
2b10: 20 69 6e 74 20 6e 52 65 63 3b 20 20 20 20 20 20   int nRec;      
2b20: 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4e 75 6d            /* Num
2b30: 62 65 72 20 6f 66 20 52 65 63 6f 72 64 73 20 2a  ber of Records *
2b40: 2f 0a 20 20 69 6e 74 20 69 3b 20 20 20 20 20 20  /.  int i;      
2b50: 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20               /* 
2b60: 4c 6f 6f 70 20 63 6f 75 6e 74 65 72 20 2a 2f 0a  Loop counter */.
2b70: 20 20 50 67 6e 6f 20 6d 78 50 67 20 3d 20 30 3b    Pgno mxPg = 0;
2b80: 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 53 69             /* Si
2b90: 7a 65 20 6f 66 20 74 68 65 20 6f 72 69 67 69 6e  ze of the origin
2ba0: 61 6c 20 66 69 6c 65 20 69 6e 20 70 61 67 65 73  al file in pages
2bb0: 20 2a 2f 0a 20 20 50 67 48 64 72 20 2a 70 50 67   */.  PgHdr *pPg
2bc0: 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f  ;              /
2bd0: 2a 20 41 6e 20 65 78 69 73 74 69 6e 67 20 70 61  * An existing pa
2be0: 67 65 20 69 6e 20 74 68 65 20 63 61 63 68 65 20  ge in the cache 
2bf0: 2a 2f 0a 20 20 50 61 67 65 52 65 63 6f 72 64 20  */.  PageRecord 
2c00: 70 67 52 65 63 3b 0a 20 20 75 6e 73 69 67 6e 65  pgRec;.  unsigne
2c10: 64 20 63 68 61 72 20 61 4d 61 67 69 63 5b 73 69  d char aMagic[si
2c20: 7a 65 6f 66 28 61 4a 6f 75 72 6e 61 6c 4d 61 67  zeof(aJournalMag
2c30: 69 63 29 5d 3b 0a 20 20 69 6e 74 20 72 63 3b 0a  ic)];.  int rc;.
2c40: 0a 20 20 2f 2a 20 52 65 61 64 20 74 68 65 20 62  .  /* Read the b
2c50: 65 67 69 6e 6e 69 6e 67 20 6f 66 20 74 68 65 20  eginning of the 
2c60: 6a 6f 75 72 6e 61 6c 20 61 6e 64 20 74 72 75 6e  journal and trun
2c70: 63 61 74 65 20 74 68 65 0a 20 20 2a 2a 20 64 61  cate the.  ** da
2c80: 74 61 62 61 73 65 20 66 69 6c 65 20 62 61 63 6b  tabase file back
2c90: 20 74 6f 20 69 74 73 20 6f 72 69 67 69 6e 61 6c   to its original
2ca0: 20 73 69 7a 65 2e 0a 20 20 2a 2f 0a 20 20 61 73   size..  */.  as
2cb0: 73 65 72 74 28 20 70 50 61 67 65 72 2d 3e 6a 6f  sert( pPager->jo
2cc0: 75 72 6e 61 6c 4f 70 65 6e 20 29 3b 0a 20 20 73  urnalOpen );.  s
2cd0: 71 6c 69 74 65 4f 73 53 65 65 6b 28 70 50 61 67  qliteOsSeek(pPag
2ce0: 65 72 2d 3e 6a 66 64 2c 20 30 29 3b 0a 20 20 72  er->jfd, 0);.  r
2cf0: 63 20 3d 20 73 71 6c 69 74 65 4f 73 52 65 61 64  c = sqliteOsRead
2d00: 28 70 50 61 67 65 72 2d 3e 6a 66 64 2c 20 61 4d  (pPager->jfd, aM
2d10: 61 67 69 63 2c 20 73 69 7a 65 6f 66 28 61 4d 61  agic, sizeof(aMa
2d20: 67 69 63 29 29 3b 0a 20 20 69 66 28 20 72 63 21  gic));.  if( rc!
2d30: 3d 53 51 4c 49 54 45 5f 4f 4b 20 7c 7c 20 6d 65  =SQLITE_OK || me
2d40: 6d 63 6d 70 28 61 4d 61 67 69 63 2c 61 4a 6f 75  mcmp(aMagic,aJou
2d50: 72 6e 61 6c 4d 61 67 69 63 2c 73 69 7a 65 6f 66  rnalMagic,sizeof
2d60: 28 61 4d 61 67 69 63 29 29 21 3d 30 20 29 7b 0a  (aMagic))!=0 ){.
2d70: 20 20 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54      return SQLIT
2d80: 45 5f 50 52 4f 54 4f 43 4f 4c 3b 0a 20 20 7d 0a  E_PROTOCOL;.  }.
2d90: 20 20 72 63 20 3d 20 73 71 6c 69 74 65 4f 73 52    rc = sqliteOsR
2da0: 65 61 64 28 70 50 61 67 65 72 2d 3e 6a 66 64 2c  ead(pPager->jfd,
2db0: 20 26 6d 78 50 67 2c 20 73 69 7a 65 6f 66 28 6d   &mxPg, sizeof(m
2dc0: 78 50 67 29 29 3b 0a 20 20 69 66 28 20 72 63 21  xPg));.  if( rc!
2dd0: 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20  =SQLITE_OK ){.  
2de0: 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f    return SQLITE_
2df0: 50 52 4f 54 4f 43 4f 4c 3b 0a 20 20 7d 0a 20 20  PROTOCOL;.  }.  
2e00: 73 71 6c 69 74 65 4f 73 54 72 75 6e 63 61 74 65  sqliteOsTruncate
2e10: 28 70 50 61 67 65 72 2d 3e 66 64 2c 20 6d 78 50  (pPager->fd, mxP
2e20: 67 2a 53 51 4c 49 54 45 5f 50 41 47 45 5f 53 49  g*SQLITE_PAGE_SI
2e30: 5a 45 29 3b 0a 20 20 70 50 61 67 65 72 2d 3e 64  ZE);.  pPager->d
2e40: 62 53 69 7a 65 20 3d 20 6d 78 50 67 3b 0a 20 20  bSize = mxPg;.  
2e50: 0a 20 20 2f 2a 20 42 65 67 69 6e 20 72 65 61 64  .  /* Begin read
2e60: 69 6e 67 20 74 68 65 20 6a 6f 75 72 6e 61 6c 20  ing the journal 
2e70: 62 65 67 69 6e 6e 69 6e 67 20 61 74 20 74 68 65  beginning at the
2e80: 20 65 6e 64 20 61 6e 64 20 6d 6f 76 69 6e 67 0a   end and moving.
2e90: 20 20 2a 2a 20 74 6f 77 61 72 64 20 74 68 65 20    ** toward the 
2ea0: 62 65 67 69 6e 6e 69 6e 67 2e 0a 20 20 2a 2f 0a  beginning..  */.
2eb0: 20 20 69 66 28 20 73 71 6c 69 74 65 4f 73 46 69    if( sqliteOsFi
2ec0: 6c 65 53 69 7a 65 28 70 50 61 67 65 72 2d 3e 6a  leSize(pPager->j
2ed0: 66 64 2c 20 26 6e 52 65 63 29 21 3d 53 51 4c 49  fd, &nRec)!=SQLI
2ee0: 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 72 65 74  TE_OK ){.    ret
2ef0: 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20  urn SQLITE_OK;. 
2f00: 20 7d 0a 20 20 6e 52 65 63 20 3d 20 28 6e 52 65   }.  nRec = (nRe
2f10: 63 20 2d 20 28 73 69 7a 65 6f 66 28 61 4d 61 67  c - (sizeof(aMag
2f20: 69 63 29 2b 73 69 7a 65 6f 66 28 50 67 6e 6f 29  ic)+sizeof(Pgno)
2f30: 29 29 20 2f 20 73 69 7a 65 6f 66 28 50 61 67 65  )) / sizeof(Page
2f40: 52 65 63 6f 72 64 29 3b 0a 0a 20 20 2f 2a 20 50  Record);..  /* P
2f50: 72 6f 63 65 73 73 20 73 65 67 6d 65 6e 74 73 20  rocess segments 
2f60: 62 65 67 69 6e 6e 69 6e 67 20 77 69 74 68 20 74  beginning with t
2f70: 68 65 20 6c 61 73 74 20 61 6e 64 20 77 6f 72 6b  he last and work
2f80: 69 6e 67 20 62 61 63 6b 77 61 72 64 73 0a 20 20  ing backwards.  
2f90: 2a 2a 20 74 6f 20 74 68 65 20 66 69 72 73 74 2e  ** to the first.
2fa0: 0a 20 20 2a 2f 0a 20 20 66 6f 72 28 69 3d 6e 52  .  */.  for(i=nR
2fb0: 65 63 2d 31 3b 20 69 3e 3d 30 3b 20 69 2d 2d 29  ec-1; i>=0; i--)
2fc0: 7b 0a 20 20 20 20 2f 2a 20 53 65 65 6b 20 74 6f  {.    /* Seek to
2fd0: 20 74 68 65 20 62 65 67 69 6e 6e 69 6e 67 20 6f   the beginning o
2fe0: 66 20 74 68 65 20 73 65 67 6d 65 6e 74 20 2a 2f  f the segment */
2ff0: 0a 20 20 20 20 6f 66 66 5f 74 20 6f 66 73 74 3b  .    off_t ofst;
3000: 0a 20 20 20 20 6f 66 73 74 20 3d 20 69 2a 73 69  .    ofst = i*si
3010: 7a 65 6f 66 28 50 61 67 65 52 65 63 6f 72 64 29  zeof(PageRecord)
3020: 20 2b 20 73 69 7a 65 6f 66 28 61 4d 61 67 69 63   + sizeof(aMagic
3030: 29 20 2b 20 73 69 7a 65 6f 66 28 50 67 6e 6f 29  ) + sizeof(Pgno)
3040: 3b 0a 20 20 20 20 72 63 20 3d 20 73 71 6c 69 74  ;.    rc = sqlit
3050: 65 4f 73 53 65 65 6b 28 70 50 61 67 65 72 2d 3e  eOsSeek(pPager->
3060: 6a 66 64 2c 20 6f 66 73 74 29 3b 0a 20 20 20 20  jfd, ofst);.    
3070: 69 66 28 20 72 63 21 3d 53 51 4c 49 54 45 5f 4f  if( rc!=SQLITE_O
3080: 4b 20 29 20 62 72 65 61 6b 3b 0a 20 20 20 20 72  K ) break;.    r
3090: 63 20 3d 20 73 71 6c 69 74 65 4f 73 52 65 61 64  c = sqliteOsRead
30a0: 28 70 50 61 67 65 72 2d 3e 6a 66 64 2c 20 26 70  (pPager->jfd, &p
30b0: 67 52 65 63 2c 20 73 69 7a 65 6f 66 28 70 67 52  gRec, sizeof(pgR
30c0: 65 63 29 29 3b 0a 20 20 20 20 69 66 28 20 72 63  ec));.    if( rc
30d0: 21 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 20 62 72  !=SQLITE_OK ) br
30e0: 65 61 6b 3b 0a 0a 20 20 20 20 2f 2a 20 53 61 6e  eak;..    /* San
30f0: 69 74 79 20 63 68 65 63 6b 69 6e 67 20 6f 6e 20  ity checking on 
3100: 74 68 65 20 70 61 67 65 20 2a 2f 0a 20 20 20 20  the page */.    
3110: 69 66 28 20 70 67 52 65 63 2e 70 67 6e 6f 3e 6d  if( pgRec.pgno>m
3120: 78 50 67 20 7c 7c 20 70 67 52 65 63 2e 70 67 6e  xPg || pgRec.pgn
3130: 6f 3d 3d 30 20 29 7b 0a 20 20 20 20 20 20 72 63  o==0 ){.      rc
3140: 20 3d 20 53 51 4c 49 54 45 5f 43 4f 52 52 55 50   = SQLITE_CORRUP
3150: 54 3b 0a 20 20 20 20 20 20 62 72 65 61 6b 3b 0a  T;.      break;.
3160: 20 20 20 20 7d 0a 0a 20 20 20 20 2f 2a 20 50 6c      }..    /* Pl
3170: 61 79 62 61 63 6b 20 74 68 65 20 70 61 67 65 2e  ayback the page.
3180: 20 20 55 70 64 61 74 65 20 74 68 65 20 69 6e 2d    Update the in-
3190: 6d 65 6d 6f 72 79 20 63 6f 70 79 20 6f 66 20 74  memory copy of t
31a0: 68 65 20 70 61 67 65 0a 20 20 20 20 2a 2a 20 61  he page.    ** a
31b0: 74 20 74 68 65 20 73 61 6d 65 20 74 69 6d 65 2c  t the same time,
31c0: 20 69 66 20 74 68 65 72 65 20 69 73 20 6f 6e 65   if there is one
31d0: 2e 0a 20 20 20 20 2a 2f 0a 20 20 20 20 70 50 67  ..    */.    pPg
31e0: 20 3d 20 70 61 67 65 72 5f 6c 6f 6f 6b 75 70 28   = pager_lookup(
31f0: 70 50 61 67 65 72 2c 20 70 67 52 65 63 2e 70 67  pPager, pgRec.pg
3200: 6e 6f 29 3b 0a 20 20 20 20 69 66 28 20 70 50 67  no);.    if( pPg
3210: 20 29 7b 0a 20 20 20 20 20 20 6d 65 6d 63 70 79   ){.      memcpy
3220: 28 50 47 48 44 52 5f 54 4f 5f 44 41 54 41 28 70  (PGHDR_TO_DATA(p
3230: 50 67 29 2c 20 70 67 52 65 63 2e 61 44 61 74 61  Pg), pgRec.aData
3240: 2c 20 53 51 4c 49 54 45 5f 50 41 47 45 5f 53 49  , SQLITE_PAGE_SI
3250: 5a 45 29 3b 0a 20 20 20 20 20 20 6d 65 6d 73 65  ZE);.      memse
3260: 74 28 50 47 48 44 52 5f 54 4f 5f 45 58 54 52 41  t(PGHDR_TO_EXTRA
3270: 28 70 50 67 29 2c 20 30 2c 20 70 50 61 67 65 72  (pPg), 0, pPager
3280: 2d 3e 6e 45 78 74 72 61 29 3b 0a 20 20 20 20 7d  ->nExtra);.    }
3290: 0a 20 20 20 20 72 63 20 3d 20 73 71 6c 69 74 65  .    rc = sqlite
32a0: 4f 73 53 65 65 6b 28 70 50 61 67 65 72 2d 3e 66  OsSeek(pPager->f
32b0: 64 2c 20 28 70 67 52 65 63 2e 70 67 6e 6f 2d 31  d, (pgRec.pgno-1
32c0: 29 2a 53 51 4c 49 54 45 5f 50 41 47 45 5f 53 49  )*SQLITE_PAGE_SI
32d0: 5a 45 29 3b 0a 20 20 20 20 69 66 28 20 72 63 21  ZE);.    if( rc!
32e0: 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 20 62 72 65  =SQLITE_OK ) bre
32f0: 61 6b 3b 0a 20 20 20 20 72 63 20 3d 20 73 71 6c  ak;.    rc = sql
3300: 69 74 65 4f 73 57 72 69 74 65 28 70 50 61 67 65  iteOsWrite(pPage
3310: 72 2d 3e 66 64 2c 20 70 67 52 65 63 2e 61 44 61  r->fd, pgRec.aDa
3320: 74 61 2c 20 53 51 4c 49 54 45 5f 50 41 47 45 5f  ta, SQLITE_PAGE_
3330: 53 49 5a 45 29 3b 0a 20 20 20 20 69 66 28 20 72  SIZE);.    if( r
3340: 63 21 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 20 62  c!=SQLITE_OK ) b
3350: 72 65 61 6b 3b 0a 20 20 7d 0a 20 20 69 66 28 20  reak;.  }.  if( 
3360: 72 63 21 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b  rc!=SQLITE_OK ){
3370: 0a 20 20 20 20 70 61 67 65 72 5f 75 6e 77 72 69  .    pager_unwri
3380: 74 65 6c 6f 63 6b 28 70 50 61 67 65 72 29 3b 0a  telock(pPager);.
3390: 20 20 20 20 70 50 61 67 65 72 2d 3e 65 72 72 4d      pPager->errM
33a0: 61 73 6b 20 7c 3d 20 50 41 47 45 52 5f 45 52 52  ask |= PAGER_ERR
33b0: 5f 43 4f 52 52 55 50 54 3b 0a 20 20 20 20 72 63  _CORRUPT;.    rc
33c0: 20 3d 20 53 51 4c 49 54 45 5f 43 4f 52 52 55 50   = SQLITE_CORRUP
33d0: 54 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20  T;.  }else{.    
33e0: 72 63 20 3d 20 70 61 67 65 72 5f 75 6e 77 72 69  rc = pager_unwri
33f0: 74 65 6c 6f 63 6b 28 70 50 61 67 65 72 29 3b 0a  telock(pPager);.
3400: 20 20 7d 0a 20 20 72 65 74 75 72 6e 20 72 63 3b    }.  return rc;
3410: 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 43 68 61 6e 67 65  .}../*.** Change
3420: 20 74 68 65 20 6d 61 78 69 6d 75 6d 20 6e 75 6d   the maximum num
3430: 62 65 72 20 6f 66 20 69 6e 2d 6d 65 6d 6f 72 79  ber of in-memory
3440: 20 70 61 67 65 73 20 74 68 61 74 20 61 72 65 20   pages that are 
3450: 61 6c 6c 6f 77 65 64 2e 0a 2a 2f 0a 76 6f 69 64  allowed..*/.void
3460: 20 73 71 6c 69 74 65 70 61 67 65 72 5f 73 65 74   sqlitepager_set
3470: 5f 63 61 63 68 65 73 69 7a 65 28 50 61 67 65 72  _cachesize(Pager
3480: 20 2a 70 50 61 67 65 72 2c 20 69 6e 74 20 6d 78   *pPager, int mx
3490: 50 61 67 65 29 7b 0a 20 20 69 66 28 20 6d 78 50  Page){.  if( mxP
34a0: 61 67 65 3e 31 30 20 29 7b 0a 20 20 20 20 70 50  age>10 ){.    pP
34b0: 61 67 65 72 2d 3e 6d 78 50 61 67 65 20 3d 20 6d  ager->mxPage = m
34c0: 78 50 61 67 65 3b 0a 20 20 7d 0a 7d 0a 0a 2f 2a  xPage;.  }.}../*
34d0: 0a 2a 2a 20 43 72 65 61 74 65 20 61 20 6e 65 77  .** Create a new
34e0: 20 70 61 67 65 20 63 61 63 68 65 20 61 6e 64 20   page cache and 
34f0: 70 75 74 20 61 20 70 6f 69 6e 74 65 72 20 74 6f  put a pointer to
3500: 20 74 68 65 20 70 61 67 65 20 63 61 63 68 65 20   the page cache 
3510: 69 6e 20 2a 70 70 50 61 67 65 72 2e 0a 2a 2a 20  in *ppPager..** 
3520: 54 68 65 20 66 69 6c 65 20 74 6f 20 62 65 20 63  The file to be c
3530: 61 63 68 65 64 20 6e 65 65 64 20 6e 6f 74 20 65  ached need not e
3540: 78 69 73 74 2e 20 20 54 68 65 20 66 69 6c 65 20  xist.  The file 
3550: 69 73 20 6e 6f 74 20 6c 6f 63 6b 65 64 20 75 6e  is not locked un
3560: 74 69 6c 0a 2a 2a 20 74 68 65 20 66 69 72 73 74  til.** the first
3570: 20 63 61 6c 6c 20 74 6f 20 73 71 6c 69 74 65 70   call to sqlitep
3580: 61 67 65 72 5f 67 65 74 28 29 20 61 6e 64 20 69  ager_get() and i
3590: 73 20 6f 6e 6c 79 20 68 65 6c 64 20 6f 70 65 6e  s only held open
35a0: 20 75 6e 74 69 6c 20 74 68 65 0a 2a 2a 20 6c 61   until the.** la
35b0: 73 74 20 70 61 67 65 20 69 73 20 72 65 6c 65 61  st page is relea
35c0: 73 65 64 20 75 73 69 6e 67 20 73 71 6c 69 74 65  sed using sqlite
35d0: 70 61 67 65 72 5f 75 6e 72 65 66 28 29 2e 0a 2a  pager_unref()..*
35e0: 2f 0a 69 6e 74 20 73 71 6c 69 74 65 70 61 67 65  /.int sqlitepage
35f0: 72 5f 6f 70 65 6e 28 0a 20 20 50 61 67 65 72 20  r_open(.  Pager 
3600: 2a 2a 70 70 50 61 67 65 72 2c 20 20 20 20 20 20  **ppPager,      
3610: 20 20 20 2f 2a 20 52 65 74 75 72 6e 20 74 68 65     /* Return the
3620: 20 50 61 67 65 72 20 73 74 72 75 63 74 75 72 65   Pager structure
3630: 20 68 65 72 65 20 2a 2f 0a 20 20 63 6f 6e 73 74   here */.  const
3640: 20 63 68 61 72 20 2a 7a 46 69 6c 65 6e 61 6d 65   char *zFilename
3650: 2c 20 20 20 2f 2a 20 4e 61 6d 65 20 6f 66 20 74  ,   /* Name of t
3660: 68 65 20 64 61 74 61 62 61 73 65 20 66 69 6c 65  he database file
3670: 20 74 6f 20 6f 70 65 6e 20 2a 2f 0a 20 20 69 6e   to open */.  in
3680: 74 20 6d 78 50 61 67 65 2c 20 20 20 20 20 20 20  t mxPage,       
3690: 20 20 20 20 20 20 20 2f 2a 20 4d 61 78 20 6e 75         /* Max nu
36a0: 6d 62 65 72 20 6f 66 20 69 6e 2d 6d 65 6d 6f 72  mber of in-memor
36b0: 79 20 63 61 63 68 65 20 70 61 67 65 73 20 2a 2f  y cache pages */
36c0: 0a 20 20 69 6e 74 20 6e 45 78 74 72 61 20 20 20  .  int nExtra   
36d0: 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 45              /* E
36e0: 78 74 72 61 20 62 79 74 65 73 20 61 70 70 65 6e  xtra bytes appen
36f0: 64 20 74 6f 20 65 61 63 68 20 69 6e 2d 6d 65 6d  d to each in-mem
3700: 6f 72 79 20 70 61 67 65 20 2a 2f 0a 29 7b 0a 20  ory page */.){. 
3710: 20 50 61 67 65 72 20 2a 70 50 61 67 65 72 3b 0a   Pager *pPager;.
3720: 20 20 69 6e 74 20 6e 61 6d 65 4c 65 6e 3b 0a 20    int nameLen;. 
3730: 20 4f 73 46 69 6c 65 20 66 64 3b 0a 20 20 69 6e   OsFile fd;.  in
3740: 74 20 72 63 3b 0a 20 20 69 6e 74 20 74 65 6d 70  t rc;.  int temp
3750: 46 69 6c 65 3b 0a 20 20 69 6e 74 20 72 65 61 64  File;.  int read
3760: 4f 6e 6c 79 20 3d 20 30 3b 0a 20 20 63 68 61 72  Only = 0;.  char
3770: 20 7a 54 65 6d 70 5b 53 51 4c 49 54 45 5f 54 45   zTemp[SQLITE_TE
3780: 4d 50 4e 41 4d 45 5f 53 49 5a 45 5d 3b 0a 0a 20  MPNAME_SIZE];.. 
3790: 20 2a 70 70 50 61 67 65 72 20 3d 20 30 3b 0a 20   *ppPager = 0;. 
37a0: 20 69 66 28 20 73 71 6c 69 74 65 5f 6d 61 6c 6c   if( sqlite_mall
37b0: 6f 63 5f 66 61 69 6c 65 64 20 29 7b 0a 20 20 20  oc_failed ){.   
37c0: 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4e   return SQLITE_N
37d0: 4f 4d 45 4d 3b 0a 20 20 7d 0a 20 20 69 66 28 20  OMEM;.  }.  if( 
37e0: 7a 46 69 6c 65 6e 61 6d 65 20 29 7b 0a 20 20 20  zFilename ){.   
37f0: 20 72 63 20 3d 20 73 71 6c 69 74 65 4f 73 4f 70   rc = sqliteOsOp
3800: 65 6e 52 65 61 64 57 72 69 74 65 28 7a 46 69 6c  enReadWrite(zFil
3810: 65 6e 61 6d 65 2c 20 26 66 64 2c 20 26 72 65 61  ename, &fd, &rea
3820: 64 4f 6e 6c 79 29 3b 0a 20 20 20 20 74 65 6d 70  dOnly);.    temp
3830: 46 69 6c 65 20 3d 20 30 3b 0a 20 20 7d 65 6c 73  File = 0;.  }els
3840: 65 7b 0a 20 20 20 20 69 6e 74 20 63 6e 74 20 3d  e{.    int cnt =
3850: 20 38 3b 0a 20 20 20 20 73 71 6c 69 74 65 4f 73   8;.    sqliteOs
3860: 54 65 6d 70 46 69 6c 65 4e 61 6d 65 28 7a 54 65  TempFileName(zTe
3870: 6d 70 29 3b 0a 20 20 20 20 64 6f 7b 0a 20 20 20  mp);.    do{.   
3880: 20 20 20 63 6e 74 2d 2d 3b 0a 20 20 20 20 20 20     cnt--;.      
3890: 73 71 6c 69 74 65 4f 73 54 65 6d 70 46 69 6c 65  sqliteOsTempFile
38a0: 4e 61 6d 65 28 7a 54 65 6d 70 29 3b 0a 20 20 20  Name(zTemp);.   
38b0: 20 20 20 72 63 20 3d 20 73 71 6c 69 74 65 4f 73     rc = sqliteOs
38c0: 4f 70 65 6e 45 78 63 6c 75 73 69 76 65 28 7a 54  OpenExclusive(zT
38d0: 65 6d 70 2c 20 26 66 64 29 3b 0a 20 20 20 20 7d  emp, &fd);.    }
38e0: 77 68 69 6c 65 28 20 63 6e 74 3e 30 20 26 26 20  while( cnt>0 && 
38f0: 72 63 21 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 3b  rc!=SQLITE_OK );
3900: 0a 20 20 20 20 7a 46 69 6c 65 6e 61 6d 65 20 3d  .    zFilename =
3910: 20 7a 54 65 6d 70 3b 0a 20 20 20 20 74 65 6d 70   zTemp;.    temp
3920: 46 69 6c 65 20 3d 20 31 3b 0a 20 20 7d 0a 20 20  File = 1;.  }.  
3930: 69 66 28 20 72 63 21 3d 53 51 4c 49 54 45 5f 4f  if( rc!=SQLITE_O
3940: 4b 20 29 7b 0a 20 20 20 20 72 65 74 75 72 6e 20  K ){.    return 
3950: 53 51 4c 49 54 45 5f 43 41 4e 54 4f 50 45 4e 3b  SQLITE_CANTOPEN;
3960: 0a 20 20 7d 0a 20 20 6e 61 6d 65 4c 65 6e 20 3d  .  }.  nameLen =
3970: 20 73 74 72 6c 65 6e 28 7a 46 69 6c 65 6e 61 6d   strlen(zFilenam
3980: 65 29 3b 0a 20 20 70 50 61 67 65 72 20 3d 20 73  e);.  pPager = s
3990: 71 6c 69 74 65 4d 61 6c 6c 6f 63 28 20 73 69 7a  qliteMalloc( siz
39a0: 65 6f 66 28 2a 70 50 61 67 65 72 29 20 2b 20 6e  eof(*pPager) + n
39b0: 61 6d 65 4c 65 6e 2a 32 20 2b 20 33 30 20 29 3b  ameLen*2 + 30 );
39c0: 0a 20 20 69 66 28 20 70 50 61 67 65 72 3d 3d 30  .  if( pPager==0
39d0: 20 29 7b 0a 20 20 20 20 73 71 6c 69 74 65 4f 73   ){.    sqliteOs
39e0: 43 6c 6f 73 65 28 66 64 29 3b 0a 20 20 20 20 72  Close(fd);.    r
39f0: 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4e 4f 4d  eturn SQLITE_NOM
3a00: 45 4d 3b 0a 20 20 7d 0a 20 20 70 50 61 67 65 72  EM;.  }.  pPager
3a10: 2d 3e 7a 46 69 6c 65 6e 61 6d 65 20 3d 20 28 63  ->zFilename = (c
3a20: 68 61 72 2a 29 26 70 50 61 67 65 72 5b 31 5d 3b  har*)&pPager[1];
3a30: 0a 20 20 70 50 61 67 65 72 2d 3e 7a 4a 6f 75 72  .  pPager->zJour
3a40: 6e 61 6c 20 3d 20 26 70 50 61 67 65 72 2d 3e 7a  nal = &pPager->z
3a50: 46 69 6c 65 6e 61 6d 65 5b 6e 61 6d 65 4c 65 6e  Filename[nameLen
3a60: 2b 31 5d 3b 0a 20 20 73 74 72 63 70 79 28 70 50  +1];.  strcpy(pP
3a70: 61 67 65 72 2d 3e 7a 46 69 6c 65 6e 61 6d 65 2c  ager->zFilename,
3a80: 20 7a 46 69 6c 65 6e 61 6d 65 29 3b 0a 20 20 73   zFilename);.  s
3a90: 74 72 63 70 79 28 70 50 61 67 65 72 2d 3e 7a 4a  trcpy(pPager->zJ
3aa0: 6f 75 72 6e 61 6c 2c 20 7a 46 69 6c 65 6e 61 6d  ournal, zFilenam
3ab0: 65 29 3b 0a 20 20 73 74 72 63 70 79 28 26 70 50  e);.  strcpy(&pP
3ac0: 61 67 65 72 2d 3e 7a 4a 6f 75 72 6e 61 6c 5b 6e  ager->zJournal[n
3ad0: 61 6d 65 4c 65 6e 5d 2c 20 22 2d 6a 6f 75 72 6e  ameLen], "-journ
3ae0: 61 6c 22 29 3b 0a 20 20 70 50 61 67 65 72 2d 3e  al");.  pPager->
3af0: 66 64 20 3d 20 66 64 3b 0a 20 20 70 50 61 67 65  fd = fd;.  pPage
3b00: 72 2d 3e 6a 6f 75 72 6e 61 6c 4f 70 65 6e 20 3d  r->journalOpen =
3b10: 20 30 3b 0a 20 20 70 50 61 67 65 72 2d 3e 6e 52   0;.  pPager->nR
3b20: 65 66 20 3d 20 30 3b 0a 20 20 70 50 61 67 65 72  ef = 0;.  pPager
3b30: 2d 3e 64 62 53 69 7a 65 20 3d 20 2d 31 3b 0a 20  ->dbSize = -1;. 
3b40: 20 70 50 61 67 65 72 2d 3e 6e 50 61 67 65 20 3d   pPager->nPage =
3b50: 20 30 3b 0a 20 20 70 50 61 67 65 72 2d 3e 6d 78   0;.  pPager->mx
3b60: 50 61 67 65 20 3d 20 6d 78 50 61 67 65 3e 35 20  Page = mxPage>5 
3b70: 3f 20 6d 78 50 61 67 65 20 3a 20 31 30 3b 0a 20  ? mxPage : 10;. 
3b80: 20 70 50 61 67 65 72 2d 3e 73 74 61 74 65 20 3d   pPager->state =
3b90: 20 53 51 4c 49 54 45 5f 55 4e 4c 4f 43 4b 3b 0a   SQLITE_UNLOCK;.
3ba0: 20 20 70 50 61 67 65 72 2d 3e 65 72 72 4d 61 73    pPager->errMas
3bb0: 6b 20 3d 20 30 3b 0a 20 20 70 50 61 67 65 72 2d  k = 0;.  pPager-
3bc0: 3e 74 65 6d 70 46 69 6c 65 20 3d 20 74 65 6d 70  >tempFile = temp
3bd0: 46 69 6c 65 3b 0a 20 20 70 50 61 67 65 72 2d 3e  File;.  pPager->
3be0: 72 65 61 64 4f 6e 6c 79 20 3d 20 72 65 61 64 4f  readOnly = readO
3bf0: 6e 6c 79 3b 0a 20 20 70 50 61 67 65 72 2d 3e 6e  nly;.  pPager->n
3c00: 65 65 64 53 79 6e 63 20 3d 20 30 3b 0a 20 20 70  eedSync = 0;.  p
3c10: 50 61 67 65 72 2d 3e 70 46 69 72 73 74 20 3d 20  Pager->pFirst = 
3c20: 30 3b 0a 20 20 70 50 61 67 65 72 2d 3e 70 4c 61  0;.  pPager->pLa
3c30: 73 74 20 3d 20 30 3b 0a 20 20 70 50 61 67 65 72  st = 0;.  pPager
3c40: 2d 3e 6e 45 78 74 72 61 20 3d 20 6e 45 78 74 72  ->nExtra = nExtr
3c50: 61 3b 0a 20 20 6d 65 6d 73 65 74 28 70 50 61 67  a;.  memset(pPag
3c60: 65 72 2d 3e 61 48 61 73 68 2c 20 30 2c 20 73 69  er->aHash, 0, si
3c70: 7a 65 6f 66 28 70 50 61 67 65 72 2d 3e 61 48 61  zeof(pPager->aHa
3c80: 73 68 29 29 3b 0a 20 20 2a 70 70 50 61 67 65 72  sh));.  *ppPager
3c90: 20 3d 20 70 50 61 67 65 72 3b 0a 20 20 72 65 74   = pPager;.  ret
3ca0: 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 7d  urn SQLITE_OK;.}
3cb0: 0a 0a 2f 2a 0a 2a 2a 20 53 65 74 20 74 68 65 20  ../*.** Set the 
3cc0: 64 65 73 74 72 75 63 74 6f 72 20 66 6f 72 20 74  destructor for t
3cd0: 68 69 73 20 70 61 67 65 72 2e 20 20 49 66 20 6e  his pager.  If n
3ce0: 6f 74 20 4e 55 4c 4c 2c 20 74 68 65 20 64 65 73  ot NULL, the des
3cf0: 74 72 75 63 74 6f 72 20 69 73 20 63 61 6c 6c 65  tructor is calle
3d00: 64 0a 2a 2a 20 77 68 65 6e 20 74 68 65 20 72 65  d.** when the re
3d10: 66 65 72 65 6e 63 65 20 63 6f 75 6e 74 20 6f 6e  ference count on
3d20: 20 65 61 63 68 20 70 61 67 65 20 72 65 61 63 68   each page reach
3d30: 65 73 20 7a 65 72 6f 2e 20 20 54 68 65 20 64 65  es zero.  The de
3d40: 73 74 72 75 63 74 6f 72 20 63 61 6e 0a 2a 2a 20  structor can.** 
3d50: 62 65 20 75 73 65 64 20 74 6f 20 63 6c 65 61 6e  be used to clean
3d60: 20 75 70 20 69 6e 66 6f 72 6d 61 74 69 6f 6e 20   up information 
3d70: 69 6e 20 74 68 65 20 65 78 74 72 61 20 73 65 67  in the extra seg
3d80: 6d 65 6e 74 20 61 70 70 65 6e 64 65 64 20 74 6f  ment appended to
3d90: 20 65 61 63 68 20 70 61 67 65 2e 0a 2a 2a 0a 2a   each page..**.*
3da0: 2a 20 54 68 65 20 64 65 73 74 72 75 63 74 6f 72  * The destructor
3db0: 20 69 73 20 6e 6f 74 20 63 61 6c 6c 65 64 20 61   is not called a
3dc0: 73 20 61 20 72 65 73 75 6c 74 20 73 71 6c 69 74  s a result sqlit
3dd0: 65 70 61 67 65 72 5f 63 6c 6f 73 65 28 29 2e 20  epager_close(). 
3de0: 20 0a 2a 2a 20 44 65 73 74 72 75 63 74 6f 72 73   .** Destructors
3df0: 20 61 72 65 20 6f 6e 6c 79 20 63 61 6c 6c 65 64   are only called
3e00: 20 62 79 20 73 71 6c 69 74 65 70 61 67 65 72 5f   by sqlitepager_
3e10: 75 6e 72 65 66 28 29 2e 0a 2a 2f 0a 76 6f 69 64  unref()..*/.void
3e20: 20 73 71 6c 69 74 65 70 61 67 65 72 5f 73 65 74   sqlitepager_set
3e30: 5f 64 65 73 74 72 75 63 74 6f 72 28 50 61 67 65  _destructor(Page
3e40: 72 20 2a 70 50 61 67 65 72 2c 20 76 6f 69 64 20  r *pPager, void 
3e50: 28 2a 78 44 65 73 63 29 28 76 6f 69 64 2a 29 29  (*xDesc)(void*))
3e60: 7b 0a 20 20 70 50 61 67 65 72 2d 3e 78 44 65 73  {.  pPager->xDes
3e70: 74 72 75 63 74 6f 72 20 3d 20 78 44 65 73 63 3b  tructor = xDesc;
3e80: 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 52 65 74 75 72 6e  .}../*.** Return
3e90: 20 74 68 65 20 74 6f 74 61 6c 20 6e 75 6d 62 65   the total numbe
3ea0: 72 20 6f 66 20 70 61 67 65 73 20 69 6e 20 74 68  r of pages in th
3eb0: 65 20 64 69 73 6b 20 66 69 6c 65 20 61 73 73 6f  e disk file asso
3ec0: 63 69 61 74 65 64 20 77 69 74 68 0a 2a 2a 20 70  ciated with.** p
3ed0: 50 61 67 65 72 2e 0a 2a 2f 0a 69 6e 74 20 73 71  Pager..*/.int sq
3ee0: 6c 69 74 65 70 61 67 65 72 5f 70 61 67 65 63 6f  litepager_pageco
3ef0: 75 6e 74 28 50 61 67 65 72 20 2a 70 50 61 67 65  unt(Pager *pPage
3f00: 72 29 7b 0a 20 20 69 6e 74 20 6e 3b 0a 20 20 61  r){.  int n;.  a
3f10: 73 73 65 72 74 28 20 70 50 61 67 65 72 21 3d 30  ssert( pPager!=0
3f20: 20 29 3b 0a 20 20 69 66 28 20 70 50 61 67 65 72   );.  if( pPager
3f30: 2d 3e 64 62 53 69 7a 65 3e 3d 30 20 29 7b 0a 20  ->dbSize>=0 ){. 
3f40: 20 20 20 72 65 74 75 72 6e 20 70 50 61 67 65 72     return pPager
3f50: 2d 3e 64 62 53 69 7a 65 3b 0a 20 20 7d 0a 20 20  ->dbSize;.  }.  
3f60: 69 66 28 20 73 71 6c 69 74 65 4f 73 46 69 6c 65  if( sqliteOsFile
3f70: 53 69 7a 65 28 70 50 61 67 65 72 2d 3e 66 64 2c  Size(pPager->fd,
3f80: 20 26 6e 29 21 3d 53 51 4c 49 54 45 5f 4f 4b 20   &n)!=SQLITE_OK 
3f90: 29 7b 0a 20 20 20 20 72 65 74 75 72 6e 20 30 3b  ){.    return 0;
3fa0: 0a 20 20 7d 0a 20 20 6e 20 2f 3d 20 53 51 4c 49  .  }.  n /= SQLI
3fb0: 54 45 5f 50 41 47 45 5f 53 49 5a 45 3b 0a 20 20  TE_PAGE_SIZE;.  
3fc0: 69 66 28 20 70 50 61 67 65 72 2d 3e 73 74 61 74  if( pPager->stat
3fd0: 65 21 3d 53 51 4c 49 54 45 5f 55 4e 4c 4f 43 4b  e!=SQLITE_UNLOCK
3fe0: 20 29 7b 0a 20 20 20 20 70 50 61 67 65 72 2d 3e   ){.    pPager->
3ff0: 64 62 53 69 7a 65 20 3d 20 6e 3b 0a 20 20 7d 0a  dbSize = n;.  }.
4000: 20 20 72 65 74 75 72 6e 20 6e 3b 0a 7d 0a 0a 2f    return n;.}../
4010: 2a 0a 2a 2a 20 53 68 75 74 64 6f 77 6e 20 74 68  *.** Shutdown th
4020: 65 20 70 61 67 65 20 63 61 63 68 65 2e 20 20 46  e page cache.  F
4030: 72 65 65 20 61 6c 6c 20 6d 65 6d 6f 72 79 20 61  ree all memory a
4040: 6e 64 20 63 6c 6f 73 65 20 61 6c 6c 20 66 69 6c  nd close all fil
4050: 65 73 2e 0a 2a 2a 0a 2a 2a 20 49 66 20 61 20 74  es..**.** If a t
4060: 72 61 6e 73 61 63 74 69 6f 6e 20 77 61 73 20 69  ransaction was i
4070: 6e 20 70 72 6f 67 72 65 73 73 20 77 68 65 6e 20  n progress when 
4080: 74 68 69 73 20 72 6f 75 74 69 6e 65 20 69 73 20  this routine is 
4090: 63 61 6c 6c 65 64 2c 20 74 68 61 74 0a 2a 2a 20  called, that.** 
40a0: 74 72 61 6e 73 61 63 74 69 6f 6e 20 69 73 20 72  transaction is r
40b0: 6f 6c 6c 65 64 20 62 61 63 6b 2e 20 20 41 6c 6c  olled back.  All
40c0: 20 6f 75 74 73 74 61 6e 64 69 6e 67 20 70 61 67   outstanding pag
40d0: 65 73 20 61 72 65 20 69 6e 76 61 6c 69 64 61 74  es are invalidat
40e0: 65 64 0a 2a 2a 20 61 6e 64 20 74 68 65 69 72 20  ed.** and their 
40f0: 6d 65 6d 6f 72 79 20 69 73 20 66 72 65 65 64 2e  memory is freed.
4100: 20 20 41 6e 79 20 61 74 74 65 6d 70 74 20 74 6f    Any attempt to
4110: 20 75 73 65 20 61 20 70 61 67 65 20 61 73 73 6f   use a page asso
4120: 63 69 61 74 65 64 0a 2a 2a 20 77 69 74 68 20 74  ciated.** with t
4130: 68 69 73 20 70 61 67 65 20 63 61 63 68 65 20 61  his page cache a
4140: 66 74 65 72 20 74 68 69 73 20 66 75 6e 63 74 69  fter this functi
4150: 6f 6e 20 72 65 74 75 72 6e 73 20 77 69 6c 6c 20  on returns will 
4160: 6c 69 6b 65 6c 79 0a 2a 2a 20 72 65 73 75 6c 74  likely.** result
4170: 20 69 6e 20 61 20 63 6f 72 65 64 75 6d 70 2e 0a   in a coredump..
4180: 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 70 61 67  */.int sqlitepag
4190: 65 72 5f 63 6c 6f 73 65 28 50 61 67 65 72 20 2a  er_close(Pager *
41a0: 70 50 61 67 65 72 29 7b 0a 20 20 50 67 48 64 72  pPager){.  PgHdr
41b0: 20 2a 70 50 67 2c 20 2a 70 4e 65 78 74 3b 0a 20   *pPg, *pNext;. 
41c0: 20 73 77 69 74 63 68 28 20 70 50 61 67 65 72 2d   switch( pPager-
41d0: 3e 73 74 61 74 65 20 29 7b 0a 20 20 20 20 63 61  >state ){.    ca
41e0: 73 65 20 53 51 4c 49 54 45 5f 57 52 49 54 45 4c  se SQLITE_WRITEL
41f0: 4f 43 4b 3a 20 7b 0a 20 20 20 20 20 20 73 71 6c  OCK: {.      sql
4200: 69 74 65 70 61 67 65 72 5f 72 6f 6c 6c 62 61 63  itepager_rollbac
4210: 6b 28 70 50 61 67 65 72 29 3b 0a 20 20 20 20 20  k(pPager);.     
4220: 20 73 71 6c 69 74 65 4f 73 55 6e 6c 6f 63 6b 28   sqliteOsUnlock(
4230: 70 50 61 67 65 72 2d 3e 66 64 29 3b 0a 20 20 20  pPager->fd);.   
4240: 20 20 20 61 73 73 65 72 74 28 20 70 50 61 67 65     assert( pPage
4250: 72 2d 3e 6a 6f 75 72 6e 61 6c 4f 70 65 6e 3d 3d  r->journalOpen==
4260: 30 20 29 3b 0a 20 20 20 20 20 20 62 72 65 61 6b  0 );.      break
4270: 3b 0a 20 20 20 20 7d 0a 20 20 20 20 63 61 73 65  ;.    }.    case
4280: 20 53 51 4c 49 54 45 5f 52 45 41 44 4c 4f 43 4b   SQLITE_READLOCK
4290: 3a 20 7b 0a 20 20 20 20 20 20 73 71 6c 69 74 65  : {.      sqlite
42a0: 4f 73 55 6e 6c 6f 63 6b 28 70 50 61 67 65 72 2d  OsUnlock(pPager-
42b0: 3e 66 64 29 3b 0a 20 20 20 20 20 20 62 72 65 61  >fd);.      brea
42c0: 6b 3b 0a 20 20 20 20 7d 0a 20 20 20 20 64 65 66  k;.    }.    def
42d0: 61 75 6c 74 3a 20 7b 0a 20 20 20 20 20 20 2f 2a  ault: {.      /*
42e0: 20 44 6f 20 6e 6f 74 68 69 6e 67 20 2a 2f 0a 20   Do nothing */. 
42f0: 20 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 20       break;.    
4300: 7d 0a 20 20 7d 0a 20 20 66 6f 72 28 70 50 67 3d  }.  }.  for(pPg=
4310: 70 50 61 67 65 72 2d 3e 70 41 6c 6c 3b 20 70 50  pPager->pAll; pP
4320: 67 3b 20 70 50 67 3d 70 4e 65 78 74 29 7b 0a 20  g; pPg=pNext){. 
4330: 20 20 20 70 4e 65 78 74 20 3d 20 70 50 67 2d 3e     pNext = pPg->
4340: 70 4e 65 78 74 41 6c 6c 3b 0a 20 20 20 20 73 71  pNextAll;.    sq
4350: 6c 69 74 65 46 72 65 65 28 70 50 67 29 3b 0a 20  liteFree(pPg);. 
4360: 20 7d 0a 20 20 73 71 6c 69 74 65 4f 73 43 6c 6f   }.  sqliteOsClo
4370: 73 65 28 70 50 61 67 65 72 2d 3e 66 64 29 3b 0a  se(pPager->fd);.
4380: 20 20 61 73 73 65 72 74 28 20 70 50 61 67 65 72    assert( pPager
4390: 2d 3e 6a 6f 75 72 6e 61 6c 4f 70 65 6e 3d 3d 30  ->journalOpen==0
43a0: 20 29 3b 0a 20 20 69 66 28 20 70 50 61 67 65 72   );.  if( pPager
43b0: 2d 3e 74 65 6d 70 46 69 6c 65 20 29 7b 0a 20 20  ->tempFile ){.  
43c0: 20 20 73 71 6c 69 74 65 4f 73 44 65 6c 65 74 65    sqliteOsDelete
43d0: 28 70 50 61 67 65 72 2d 3e 7a 46 69 6c 65 6e 61  (pPager->zFilena
43e0: 6d 65 29 3b 0a 20 20 7d 0a 20 20 73 71 6c 69 74  me);.  }.  sqlit
43f0: 65 46 72 65 65 28 70 50 61 67 65 72 29 3b 0a 20  eFree(pPager);. 
4400: 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f   return SQLITE_O
4410: 4b 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 52 65 74 75  K;.}../*.** Retu
4420: 72 6e 20 74 68 65 20 70 61 67 65 20 6e 75 6d 62  rn the page numb
4430: 65 72 20 66 6f 72 20 74 68 65 20 67 69 76 65 6e  er for the given
4440: 20 70 61 67 65 20 64 61 74 61 2e 0a 2a 2f 0a 50   page data..*/.P
4450: 67 6e 6f 20 73 71 6c 69 74 65 70 61 67 65 72 5f  gno sqlitepager_
4460: 70 61 67 65 6e 75 6d 62 65 72 28 76 6f 69 64 20  pagenumber(void 
4470: 2a 70 44 61 74 61 29 7b 0a 20 20 50 67 48 64 72  *pData){.  PgHdr
4480: 20 2a 70 20 3d 20 44 41 54 41 5f 54 4f 5f 50 47   *p = DATA_TO_PG
4490: 48 44 52 28 70 44 61 74 61 29 3b 0a 20 20 72 65  HDR(pData);.  re
44a0: 74 75 72 6e 20 70 2d 3e 70 67 6e 6f 3b 0a 7d 0a  turn p->pgno;.}.
44b0: 0a 2f 2a 0a 2a 2a 20 49 6e 63 72 65 6d 65 6e 74  ./*.** Increment
44c0: 20 74 68 65 20 72 65 66 65 72 65 6e 63 65 20 63   the reference c
44d0: 6f 75 6e 74 20 66 6f 72 20 61 20 70 61 67 65 2e  ount for a page.
44e0: 20 20 49 66 20 74 68 65 20 70 61 67 65 20 69 73    If the page is
44f0: 0a 2a 2a 20 63 75 72 72 65 6e 74 6c 79 20 6f 6e  .** currently on
4500: 20 74 68 65 20 66 72 65 65 6c 69 73 74 20 28 74   the freelist (t
4510: 68 65 20 72 65 66 65 72 65 6e 63 65 20 63 6f 75  he reference cou
4520: 6e 74 20 69 73 20 7a 65 72 6f 29 20 74 68 65 6e  nt is zero) then
4530: 0a 2a 2a 20 72 65 6d 6f 76 65 20 69 74 20 66 72  .** remove it fr
4540: 6f 6d 20 74 68 65 20 66 72 65 65 6c 69 73 74 2e  om the freelist.
4550: 0a 2a 2f 0a 73 74 61 74 69 63 20 76 6f 69 64 20  .*/.static void 
4560: 70 61 67 65 5f 72 65 66 28 50 67 48 64 72 20 2a  page_ref(PgHdr *
4570: 70 50 67 29 7b 0a 20 20 69 66 28 20 70 50 67 2d  pPg){.  if( pPg-
4580: 3e 6e 52 65 66 3d 3d 30 20 29 7b 0a 20 20 20 20  >nRef==0 ){.    
4590: 2f 2a 20 54 68 65 20 70 61 67 65 20 69 73 20 63  /* The page is c
45a0: 75 72 72 65 6e 74 6c 79 20 6f 6e 20 74 68 65 20  urrently on the 
45b0: 66 72 65 65 6c 69 73 74 2e 20 20 52 65 6d 6f 76  freelist.  Remov
45c0: 65 20 69 74 2e 20 2a 2f 0a 20 20 20 20 69 66 28  e it. */.    if(
45d0: 20 70 50 67 2d 3e 70 50 72 65 76 46 72 65 65 20   pPg->pPrevFree 
45e0: 29 7b 0a 20 20 20 20 20 20 70 50 67 2d 3e 70 50  ){.      pPg->pP
45f0: 72 65 76 46 72 65 65 2d 3e 70 4e 65 78 74 46 72  revFree->pNextFr
4600: 65 65 20 3d 20 70 50 67 2d 3e 70 4e 65 78 74 46  ee = pPg->pNextF
4610: 72 65 65 3b 0a 20 20 20 20 7d 65 6c 73 65 7b 0a  ree;.    }else{.
4620: 20 20 20 20 20 20 70 50 67 2d 3e 70 50 61 67 65        pPg->pPage
4630: 72 2d 3e 70 46 69 72 73 74 20 3d 20 70 50 67 2d  r->pFirst = pPg-
4640: 3e 70 4e 65 78 74 46 72 65 65 3b 0a 20 20 20 20  >pNextFree;.    
4650: 7d 0a 20 20 20 20 69 66 28 20 70 50 67 2d 3e 70  }.    if( pPg->p
4660: 4e 65 78 74 46 72 65 65 20 29 7b 0a 20 20 20 20  NextFree ){.    
4670: 20 20 70 50 67 2d 3e 70 4e 65 78 74 46 72 65 65    pPg->pNextFree
4680: 2d 3e 70 50 72 65 76 46 72 65 65 20 3d 20 70 50  ->pPrevFree = pP
4690: 67 2d 3e 70 50 72 65 76 46 72 65 65 3b 0a 20 20  g->pPrevFree;.  
46a0: 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 20 20 70    }else{.      p
46b0: 50 67 2d 3e 70 50 61 67 65 72 2d 3e 70 4c 61 73  Pg->pPager->pLas
46c0: 74 20 3d 20 70 50 67 2d 3e 70 50 72 65 76 46 72  t = pPg->pPrevFr
46d0: 65 65 3b 0a 20 20 20 20 7d 0a 20 20 20 20 70 50  ee;.    }.    pP
46e0: 67 2d 3e 70 50 61 67 65 72 2d 3e 6e 52 65 66 2b  g->pPager->nRef+
46f0: 2b 3b 0a 20 20 7d 0a 20 20 70 50 67 2d 3e 6e 52  +;.  }.  pPg->nR
4700: 65 66 2b 2b 3b 0a 20 20 52 45 46 49 4e 46 4f 28  ef++;.  REFINFO(
4710: 70 50 67 29 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 49  pPg);.}../*.** I
4720: 6e 63 72 65 6d 65 6e 74 20 74 68 65 20 72 65 66  ncrement the ref
4730: 65 72 65 6e 63 65 20 63 6f 75 6e 74 20 66 6f 72  erence count for
4740: 20 61 20 70 61 67 65 2e 20 20 54 68 65 20 69 6e   a page.  The in
4750: 70 75 74 20 70 6f 69 6e 74 65 72 20 69 73 0a 2a  put pointer is.*
4760: 2a 20 61 20 72 65 66 65 72 65 6e 63 65 20 74 6f  * a reference to
4770: 20 74 68 65 20 70 61 67 65 20 64 61 74 61 2e 0a   the page data..
4780: 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 70 61 67  */.int sqlitepag
4790: 65 72 5f 72 65 66 28 76 6f 69 64 20 2a 70 44 61  er_ref(void *pDa
47a0: 74 61 29 7b 0a 20 20 50 67 48 64 72 20 2a 70 50  ta){.  PgHdr *pP
47b0: 67 20 3d 20 44 41 54 41 5f 54 4f 5f 50 47 48 44  g = DATA_TO_PGHD
47c0: 52 28 70 44 61 74 61 29 3b 0a 20 20 70 61 67 65  R(pData);.  page
47d0: 5f 72 65 66 28 70 50 67 29 3b 0a 20 20 72 65 74  _ref(pPg);.  ret
47e0: 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 7d  urn SQLITE_OK;.}
47f0: 0a 0a 2f 2a 0a 2a 2a 20 53 79 6e 63 20 74 68 65  ../*.** Sync the
4800: 20 6a 6f 75 72 6e 61 6c 20 61 6e 64 20 74 68 65   journal and the
4810: 6e 20 77 72 69 74 65 20 61 6c 6c 20 66 72 65 65  n write all free
4820: 20 64 69 72 74 79 20 70 61 67 65 73 20 74 6f 20   dirty pages to 
4830: 74 68 65 20 64 61 74 61 62 61 73 65 0a 2a 2a 20  the database.** 
4840: 66 69 6c 65 2e 0a 2a 2a 0a 2a 2a 20 57 72 69 74  file..**.** Writ
4850: 69 6e 67 20 61 6c 6c 20 66 72 65 65 20 64 69 72  ing all free dir
4860: 74 79 20 70 61 67 65 73 20 74 6f 20 74 68 65 20  ty pages to the 
4870: 64 61 74 61 62 61 73 65 20 61 66 74 65 72 20 74  database after t
4880: 68 65 20 73 79 6e 63 20 69 73 20 61 0a 2a 2a 20  he sync is a.** 
4890: 6e 6f 6e 2d 6f 62 76 69 6f 75 73 20 6f 70 74 69  non-obvious opti
48a0: 6d 69 7a 61 74 69 6f 6e 2e 20 20 66 73 79 6e 63  mization.  fsync
48b0: 28 29 20 69 73 20 61 6e 20 65 78 70 65 6e 73 69  () is an expensi
48c0: 76 65 20 6f 70 65 72 61 74 69 6f 6e 20 73 6f 20  ve operation so 
48d0: 77 65 0a 2a 2a 20 77 61 6e 74 20 74 6f 20 6d 69  we.** want to mi
48e0: 6e 69 6d 69 7a 65 20 74 68 65 20 6e 75 6d 62 65  nimize the numbe
48f0: 72 20 74 68 61 74 20 6f 63 63 75 72 2e 20 20 53  r that occur.  S
4900: 6f 20 61 66 74 65 72 20 61 6e 20 66 73 79 6e 63  o after an fsync
4910: 28 29 20 69 73 20 66 6f 72 63 65 64 0a 2a 2a 20  () is forced.** 
4920: 61 6e 64 20 77 65 20 61 72 65 20 66 72 65 65 20  and we are free 
4930: 74 6f 20 77 72 69 74 65 20 64 69 72 74 79 20 70  to write dirty p
4940: 61 67 65 73 20 62 61 63 6b 20 74 6f 20 74 68 65  ages back to the
4950: 20 64 61 74 61 62 61 73 65 2c 20 69 74 20 69 73   database, it is
4960: 20 62 65 73 74 0a 2a 2a 20 74 6f 20 67 6f 20 61   best.** to go a
4970: 68 65 61 64 20 61 6e 64 20 64 6f 20 61 73 20 6d  head and do as m
4980: 75 63 68 20 6f 66 20 74 68 61 74 20 61 73 20 70  uch of that as p
4990: 6f 73 73 69 62 6c 65 20 74 6f 20 6d 69 6e 69 6d  ossible to minim
49a0: 69 7a 65 20 74 68 65 20 63 68 61 6e 63 65 0a 2a  ize the chance.*
49b0: 2a 20 6f 66 20 68 61 76 69 6e 67 20 74 6f 20 64  * of having to d
49c0: 6f 20 61 6e 6f 74 68 65 72 20 66 73 79 6e 63 28  o another fsync(
49d0: 29 20 6c 61 74 65 72 20 6f 6e 2e 20 20 57 72 69  ) later on.  Wri
49e0: 74 69 6e 67 20 64 69 72 74 79 20 66 72 65 65 20  ting dirty free 
49f0: 70 61 67 65 73 0a 2a 2a 20 69 6e 20 74 68 69 73  pages.** in this
4a00: 20 77 61 79 20 6d 61 6b 65 20 64 61 74 61 62 61   way make databa
4a10: 73 65 20 6f 70 65 72 61 74 69 6f 6e 73 20 67 6f  se operations go
4a20: 20 75 70 20 74 6f 20 31 30 20 74 69 6d 65 73 20   up to 10 times 
4a30: 66 61 73 74 65 72 2e 0a 2a 2f 0a 73 74 61 74 69  faster..*/.stati
4a40: 63 20 69 6e 74 20 73 79 6e 63 41 6c 6c 50 61 67  c int syncAllPag
4a50: 65 73 28 50 61 67 65 72 20 2a 70 50 61 67 65 72  es(Pager *pPager
4a60: 29 7b 0a 20 20 50 67 48 64 72 20 2a 70 50 67 3b  ){.  PgHdr *pPg;
4a70: 0a 20 20 69 6e 74 20 72 63 20 3d 20 53 51 4c 49  .  int rc = SQLI
4a80: 54 45 5f 4f 4b 3b 0a 20 20 69 66 28 20 70 50 61  TE_OK;.  if( pPa
4a90: 67 65 72 2d 3e 6e 65 65 64 53 79 6e 63 20 29 7b  ger->needSync ){
4aa0: 0a 20 20 20 20 72 63 20 3d 20 73 71 6c 69 74 65  .    rc = sqlite
4ab0: 4f 73 53 79 6e 63 28 70 50 61 67 65 72 2d 3e 6a  OsSync(pPager->j
4ac0: 66 64 29 3b 0a 20 20 20 20 69 66 28 20 72 63 21  fd);.    if( rc!
4ad0: 3d 30 20 29 20 72 65 74 75 72 6e 20 72 63 3b 0a  =0 ) return rc;.
4ae0: 20 20 20 20 70 50 61 67 65 72 2d 3e 6e 65 65 64      pPager->need
4af0: 53 79 6e 63 20 3d 20 30 3b 0a 20 20 7d 0a 20 20  Sync = 0;.  }.  
4b00: 66 6f 72 28 70 50 67 3d 70 50 61 67 65 72 2d 3e  for(pPg=pPager->
4b10: 70 46 69 72 73 74 3b 20 70 50 67 3b 20 70 50 67  pFirst; pPg; pPg
4b20: 3d 70 50 67 2d 3e 70 4e 65 78 74 46 72 65 65 29  =pPg->pNextFree)
4b30: 7b 0a 20 20 20 20 69 66 28 20 70 50 67 2d 3e 64  {.    if( pPg->d
4b40: 69 72 74 79 20 29 7b 0a 20 20 20 20 20 20 73 71  irty ){.      sq
4b50: 6c 69 74 65 4f 73 53 65 65 6b 28 70 50 61 67 65  liteOsSeek(pPage
4b60: 72 2d 3e 66 64 2c 20 28 70 50 67 2d 3e 70 67 6e  r->fd, (pPg->pgn
4b70: 6f 2d 31 29 2a 53 51 4c 49 54 45 5f 50 41 47 45  o-1)*SQLITE_PAGE
4b80: 5f 53 49 5a 45 29 3b 0a 20 20 20 20 20 20 72 63  _SIZE);.      rc
4b90: 20 3d 20 73 71 6c 69 74 65 4f 73 57 72 69 74 65   = sqliteOsWrite
4ba0: 28 70 50 61 67 65 72 2d 3e 66 64 2c 20 50 47 48  (pPager->fd, PGH
4bb0: 44 52 5f 54 4f 5f 44 41 54 41 28 70 50 67 29 2c  DR_TO_DATA(pPg),
4bc0: 20 53 51 4c 49 54 45 5f 50 41 47 45 5f 53 49 5a   SQLITE_PAGE_SIZ
4bd0: 45 29 3b 0a 20 20 20 20 20 20 69 66 28 20 72 63  E);.      if( rc
4be0: 21 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 20 62 72  !=SQLITE_OK ) br
4bf0: 65 61 6b 3b 0a 20 20 20 20 20 20 70 50 67 2d 3e  eak;.      pPg->
4c00: 64 69 72 74 79 20 3d 20 30 3b 0a 20 20 20 20 7d  dirty = 0;.    }
4c10: 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e 20 53 51  .  }.  return SQ
4c20: 4c 49 54 45 5f 4f 4b 3b 0a 7d 0a 0a 2f 2a 0a 2a  LITE_OK;.}../*.*
4c30: 2a 20 41 63 71 75 69 72 65 20 61 20 70 61 67 65  * Acquire a page
4c40: 2e 0a 2a 2a 0a 2a 2a 20 41 20 72 65 61 64 20 6c  ..**.** A read l
4c50: 6f 63 6b 20 6f 6e 20 74 68 65 20 64 69 73 6b 20  ock on the disk 
4c60: 66 69 6c 65 20 69 73 20 6f 62 74 61 69 6e 65 64  file is obtained
4c70: 20 77 68 65 6e 20 74 68 65 20 66 69 72 73 74 20   when the first 
4c80: 70 61 67 65 20 61 63 71 75 69 72 65 64 2e 20 0a  page acquired. .
4c90: 2a 2a 20 54 68 69 73 20 72 65 61 64 20 6c 6f 63  ** This read loc
4ca0: 6b 20 69 73 20 64 72 6f 70 70 65 64 20 77 68 65  k is dropped whe
4cb0: 6e 20 74 68 65 20 6c 61 73 74 20 70 61 67 65 20  n the last page 
4cc0: 69 73 20 72 65 6c 65 61 73 65 64 2e 0a 2a 2a 0a  is released..**.
4cd0: 2a 2a 20 41 20 5f 67 65 74 20 77 6f 72 6b 73 20  ** A _get works 
4ce0: 66 6f 72 20 61 6e 79 20 70 61 67 65 20 6e 75 6d  for any page num
4cf0: 62 65 72 20 67 72 65 61 74 65 72 20 74 68 61 6e  ber greater than
4d00: 20 30 2e 20 20 49 66 20 74 68 65 20 64 61 74 61   0.  If the data
4d10: 62 61 73 65 0a 2a 2a 20 66 69 6c 65 20 69 73 20  base.** file is 
4d20: 73 6d 61 6c 6c 65 72 20 74 68 61 6e 20 74 68 65  smaller than the
4d30: 20 72 65 71 75 65 73 74 65 64 20 70 61 67 65 2c   requested page,
4d40: 20 74 68 65 6e 20 6e 6f 20 61 63 74 75 61 6c 20   then no actual 
4d50: 64 69 73 6b 0a 2a 2a 20 72 65 61 64 20 6f 63 63  disk.** read occ
4d60: 75 72 73 20 61 6e 64 20 74 68 65 20 6d 65 6d 6f  urs and the memo
4d70: 72 79 20 69 6d 61 67 65 20 6f 66 20 74 68 65 20  ry image of the 
4d80: 70 61 67 65 20 69 73 20 69 6e 69 74 69 61 6c 69  page is initiali
4d90: 7a 65 64 20 74 6f 0a 2a 2a 20 61 6c 6c 20 7a 65  zed to.** all ze
4da0: 72 6f 73 2e 20 20 54 68 65 20 65 78 74 72 61 20  ros.  The extra 
4db0: 64 61 74 61 20 61 70 70 65 6e 64 65 64 20 74 6f  data appended to
4dc0: 20 61 20 70 61 67 65 20 69 73 20 61 6c 77 61 79   a page is alway
4dd0: 73 20 69 6e 69 74 69 61 6c 69 7a 65 64 0a 2a 2a  s initialized.**
4de0: 20 74 6f 20 7a 65 72 6f 73 20 74 68 65 20 66 69   to zeros the fi
4df0: 72 73 74 20 74 69 6d 65 20 61 20 70 61 67 65 20  rst time a page 
4e00: 69 73 20 6c 6f 61 64 65 64 20 69 6e 74 6f 20 6d  is loaded into m
4e10: 65 6d 6f 72 79 2e 0a 2a 2a 0a 2a 2a 20 54 68 65  emory..**.** The
4e20: 20 61 63 71 75 69 73 69 74 69 6f 6e 20 6d 69 67   acquisition mig
4e30: 68 74 20 66 61 69 6c 20 66 6f 72 20 73 65 76 65  ht fail for seve
4e40: 72 61 6c 20 72 65 61 73 6f 6e 73 2e 20 20 49 6e  ral reasons.  In
4e50: 20 61 6c 6c 20 63 61 73 65 73 2c 0a 2a 2a 20 61   all cases,.** a
4e60: 6e 20 61 70 70 72 6f 70 72 69 61 74 65 20 65 72  n appropriate er
4e70: 72 6f 72 20 63 6f 64 65 20 69 73 20 72 65 74 75  ror code is retu
4e80: 72 6e 65 64 20 61 6e 64 20 2a 70 70 50 61 67 65  rned and *ppPage
4e90: 20 69 73 20 73 65 74 20 74 6f 20 4e 55 4c 4c 2e   is set to NULL.
4ea0: 0a 2a 2a 0a 2a 2a 20 53 65 65 20 61 6c 73 6f 20  .**.** See also 
4eb0: 73 71 6c 69 74 65 70 61 67 65 72 5f 6c 6f 6f 6b  sqlitepager_look
4ec0: 75 70 28 29 2e 20 20 42 6f 74 68 20 74 68 69 73  up().  Both this
4ed0: 20 72 6f 75 74 69 6e 65 20 61 6e 64 20 5f 6c 6f   routine and _lo
4ee0: 6f 6b 75 70 28 29 20 61 74 74 65 6d 70 74 0a 2a  okup() attempt.*
4ef0: 2a 20 74 6f 20 66 69 6e 64 20 61 20 70 61 67 65  * to find a page
4f00: 20 69 6e 20 74 68 65 20 69 6e 2d 6d 65 6d 6f 72   in the in-memor
4f10: 79 20 63 61 63 68 65 20 66 69 72 73 74 2e 20 20  y cache first.  
4f20: 49 66 20 74 68 65 20 70 61 67 65 20 69 73 20 6e  If the page is n
4f30: 6f 74 20 61 6c 72 65 61 64 79 0a 2a 2a 20 69 6e  ot already.** in
4f40: 20 6d 65 6d 6f 72 79 2c 20 74 68 69 73 20 72 6f   memory, this ro
4f50: 75 74 69 6e 65 20 67 6f 65 73 20 74 6f 20 64 69  utine goes to di
4f60: 73 6b 20 74 6f 20 72 65 61 64 20 69 74 20 69 6e  sk to read it in
4f70: 20 77 68 65 72 65 61 73 20 5f 6c 6f 6f 6b 75 70   whereas _lookup
4f80: 28 29 0a 2a 2a 20 6a 75 73 74 20 72 65 74 75 72  ().** just retur
4f90: 6e 73 20 30 2e 20 20 54 68 69 73 20 72 6f 75 74  ns 0.  This rout
4fa0: 69 6e 65 20 61 63 71 75 69 72 65 73 20 61 20 72  ine acquires a r
4fb0: 65 61 64 2d 6c 6f 63 6b 20 74 68 65 20 66 69 72  ead-lock the fir
4fc0: 73 74 20 74 69 6d 65 20 69 74 0a 2a 2a 20 68 61  st time it.** ha
4fd0: 73 20 74 6f 20 67 6f 20 74 6f 20 64 69 73 6b 2c  s to go to disk,
4fe0: 20 61 6e 64 20 63 6f 75 6c 64 20 61 6c 73 6f 20   and could also 
4ff0: 70 6c 61 79 62 61 63 6b 20 61 6e 20 6f 6c 64 20  playback an old 
5000: 6a 6f 75 72 6e 61 6c 20 69 66 20 6e 65 63 65 73  journal if neces
5010: 73 61 72 79 2e 0a 2a 2a 20 53 69 6e 63 65 20 5f  sary..** Since _
5020: 6c 6f 6f 6b 75 70 28 29 20 6e 65 76 65 72 20 67  lookup() never g
5030: 6f 65 73 20 74 6f 20 64 69 73 6b 2c 20 69 74 20  oes to disk, it 
5040: 6e 65 76 65 72 20 68 61 73 20 74 6f 20 64 65 61  never has to dea
5050: 6c 20 77 69 74 68 20 6c 6f 63 6b 73 0a 2a 2a 20  l with locks.** 
5060: 6f 72 20 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 73  or journal files
5070: 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 70  ..*/.int sqlitep
5080: 61 67 65 72 5f 67 65 74 28 50 61 67 65 72 20 2a  ager_get(Pager *
5090: 70 50 61 67 65 72 2c 20 50 67 6e 6f 20 70 67 6e  pPager, Pgno pgn
50a0: 6f 2c 20 76 6f 69 64 20 2a 2a 70 70 50 61 67 65  o, void **ppPage
50b0: 29 7b 0a 20 20 50 67 48 64 72 20 2a 70 50 67 3b  ){.  PgHdr *pPg;
50c0: 0a 0a 20 20 2f 2a 20 4d 61 6b 65 20 73 75 72 65  ..  /* Make sure
50d0: 20 77 65 20 68 61 76 65 20 6e 6f 74 20 68 69 74   we have not hit
50e0: 20 61 6e 79 20 63 72 69 74 69 63 61 6c 20 65 72   any critical er
50f0: 72 6f 72 73 2e 0a 20 20 2a 2f 20 0a 20 20 69 66  rors..  */ .  if
5100: 28 20 70 50 61 67 65 72 3d 3d 30 20 7c 7c 20 70  ( pPager==0 || p
5110: 67 6e 6f 3d 3d 30 20 29 7b 0a 20 20 20 20 72 65  gno==0 ){.    re
5120: 74 75 72 6e 20 53 51 4c 49 54 45 5f 45 52 52 4f  turn SQLITE_ERRO
5130: 52 3b 0a 20 20 7d 0a 20 20 69 66 28 20 70 50 61  R;.  }.  if( pPa
5140: 67 65 72 2d 3e 65 72 72 4d 61 73 6b 20 26 20 7e  ger->errMask & ~
5150: 28 50 41 47 45 52 5f 45 52 52 5f 46 55 4c 4c 29  (PAGER_ERR_FULL)
5160: 20 29 7b 0a 20 20 20 20 72 65 74 75 72 6e 20 70   ){.    return p
5170: 61 67 65 72 5f 65 72 72 63 6f 64 65 28 70 50 61  ager_errcode(pPa
5180: 67 65 72 29 3b 0a 20 20 7d 0a 0a 20 20 2f 2a 20  ger);.  }..  /* 
5190: 49 66 20 74 68 69 73 20 69 73 20 74 68 65 20 66  If this is the f
51a0: 69 72 73 74 20 70 61 67 65 20 61 63 63 65 73 73  irst page access
51b0: 65 64 2c 20 74 68 65 6e 20 67 65 74 20 61 20 72  ed, then get a r
51c0: 65 61 64 20 6c 6f 63 6b 0a 20 20 2a 2a 20 6f 6e  ead lock.  ** on
51d0: 20 74 68 65 20 64 61 74 61 62 61 73 65 20 66 69   the database fi
51e0: 6c 65 2e 0a 20 20 2a 2f 0a 20 20 69 66 28 20 70  le..  */.  if( p
51f0: 50 61 67 65 72 2d 3e 6e 52 65 66 3d 3d 30 20 29  Pager->nRef==0 )
5200: 7b 0a 20 20 20 20 69 66 28 20 73 71 6c 69 74 65  {.    if( sqlite
5210: 4f 73 4c 6f 63 6b 28 70 50 61 67 65 72 2d 3e 66  OsLock(pPager->f
5220: 64 2c 20 30 29 21 3d 53 51 4c 49 54 45 5f 4f 4b  d, 0)!=SQLITE_OK
5230: 20 29 7b 0a 20 20 20 20 20 20 2a 70 70 50 61 67   ){.      *ppPag
5240: 65 20 3d 20 30 3b 0a 20 20 20 20 20 20 72 65 74  e = 0;.      ret
5250: 75 72 6e 20 53 51 4c 49 54 45 5f 42 55 53 59 3b  urn SQLITE_BUSY;
5260: 0a 20 20 20 20 7d 0a 20 20 20 20 70 50 61 67 65  .    }.    pPage
5270: 72 2d 3e 73 74 61 74 65 20 3d 20 53 51 4c 49 54  r->state = SQLIT
5280: 45 5f 52 45 41 44 4c 4f 43 4b 3b 0a 0a 20 20 20  E_READLOCK;..   
5290: 20 2f 2a 20 49 66 20 61 20 6a 6f 75 72 6e 61 6c   /* If a journal
52a0: 20 66 69 6c 65 20 65 78 69 73 74 73 2c 20 74 72   file exists, tr
52b0: 79 20 74 6f 20 70 6c 61 79 20 69 74 20 62 61 63  y to play it bac
52c0: 6b 2e 0a 20 20 20 20 2a 2f 0a 20 20 20 20 69 66  k..    */.    if
52d0: 28 20 73 71 6c 69 74 65 4f 73 46 69 6c 65 45 78  ( sqliteOsFileEx
52e0: 69 73 74 73 28 70 50 61 67 65 72 2d 3e 7a 4a 6f  ists(pPager->zJo
52f0: 75 72 6e 61 6c 29 20 29 7b 0a 20 20 20 20 20 20  urnal) ){.      
5300: 20 69 6e 74 20 72 63 3b 0a 0a 20 20 20 20 20 20   int rc;..      
5310: 20 2f 2a 20 4f 70 65 6e 20 74 68 65 20 6a 6f 75   /* Open the jou
5320: 72 6e 61 6c 20 66 6f 72 20 65 78 63 6c 75 73 69  rnal for exclusi
5330: 76 65 20 61 63 63 65 73 73 2e 20 20 52 65 74 75  ve access.  Retu
5340: 72 6e 20 53 51 4c 49 54 45 5f 42 55 53 59 20 69  rn SQLITE_BUSY i
5350: 66 0a 20 20 20 20 20 20 20 2a 2a 20 77 65 20 63  f.       ** we c
5360: 61 6e 6e 6f 74 20 67 65 74 20 65 78 63 6c 75 73  annot get exclus
5370: 69 76 65 20 61 63 63 65 73 73 20 74 6f 20 74 68  ive access to th
5380: 65 20 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 0a 20  e journal file. 
5390: 20 20 20 20 20 20 2a 2f 0a 20 20 20 20 20 20 20        */.       
53a0: 72 63 20 3d 20 73 71 6c 69 74 65 4f 73 4f 70 65  rc = sqliteOsOpe
53b0: 6e 52 65 61 64 4f 6e 6c 79 28 70 50 61 67 65 72  nReadOnly(pPager
53c0: 2d 3e 7a 4a 6f 75 72 6e 61 6c 2c 20 26 70 50 61  ->zJournal, &pPa
53d0: 67 65 72 2d 3e 6a 66 64 29 3b 0a 20 20 20 20 20  ger->jfd);.     
53e0: 20 20 69 66 28 20 72 63 3d 3d 53 51 4c 49 54 45    if( rc==SQLITE
53f0: 5f 4f 4b 20 29 7b 0a 20 20 20 20 20 20 20 20 20  _OK ){.         
5400: 70 50 61 67 65 72 2d 3e 6a 6f 75 72 6e 61 6c 4f  pPager->journalO
5410: 70 65 6e 20 3d 20 31 3b 0a 20 20 20 20 20 20 20  pen = 1;.       
5420: 7d 0a 20 20 20 20 20 20 20 69 66 28 20 72 63 21  }.       if( rc!
5430: 3d 53 51 4c 49 54 45 5f 4f 4b 20 7c 7c 20 73 71  =SQLITE_OK || sq
5440: 6c 69 74 65 4f 73 4c 6f 63 6b 28 70 50 61 67 65  liteOsLock(pPage
5450: 72 2d 3e 6a 66 64 2c 20 31 29 21 3d 53 51 4c 49  r->jfd, 1)!=SQLI
5460: 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 20 20 20  TE_OK ){.       
5470: 20 20 69 66 28 20 70 50 61 67 65 72 2d 3e 6a 6f    if( pPager->jo
5480: 75 72 6e 61 6c 4f 70 65 6e 20 29 7b 0a 20 20 20  urnalOpen ){.   
5490: 20 20 20 20 20 20 20 20 73 71 6c 69 74 65 4f 73          sqliteOs
54a0: 43 6c 6f 73 65 28 70 50 61 67 65 72 2d 3e 6a 66  Close(pPager->jf
54b0: 64 29 3b 0a 20 20 20 20 20 20 20 20 20 20 20 70  d);.           p
54c0: 50 61 67 65 72 2d 3e 6a 6f 75 72 6e 61 6c 4f 70  Pager->journalOp
54d0: 65 6e 20 3d 20 30 3b 0a 20 20 20 20 20 20 20 20  en = 0;.        
54e0: 20 7d 0a 20 20 20 20 20 20 20 20 20 73 71 6c 69   }.         sqli
54f0: 74 65 4f 73 55 6e 6c 6f 63 6b 28 70 50 61 67 65  teOsUnlock(pPage
5500: 72 2d 3e 66 64 29 3b 0a 20 20 20 20 20 20 20 20  r->fd);.        
5510: 20 2a 70 70 50 61 67 65 20 3d 20 30 3b 0a 20 20   *ppPage = 0;.  
5520: 20 20 20 20 20 20 20 72 65 74 75 72 6e 20 53 51         return SQ
5530: 4c 49 54 45 5f 42 55 53 59 3b 0a 20 20 20 20 20  LITE_BUSY;.     
5540: 20 20 7d 0a 0a 20 20 20 20 20 20 20 2f 2a 20 47    }..       /* G
5550: 65 74 20 61 20 77 72 69 74 65 20 6c 6f 63 6b 20  et a write lock 
5560: 6f 6e 20 74 68 65 20 64 61 74 61 62 61 73 65 20  on the database 
5570: 2a 2f 0a 20 20 20 20 20 20 20 73 71 6c 69 74 65  */.       sqlite
5580: 4f 73 55 6e 6c 6f 63 6b 28 70 50 61 67 65 72 2d  OsUnlock(pPager-
5590: 3e 66 64 29 3b 0a 20 20 20 20 20 20 20 69 66 28  >fd);.       if(
55a0: 20 73 71 6c 69 74 65 4f 73 4c 6f 63 6b 28 70 50   sqliteOsLock(pP
55b0: 61 67 65 72 2d 3e 66 64 2c 20 31 29 21 3d 53 51  ager->fd, 1)!=SQ
55c0: 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 20  LITE_OK ){.     
55d0: 20 20 20 20 73 71 6c 69 74 65 4f 73 43 6c 6f 73      sqliteOsClos
55e0: 65 28 70 50 61 67 65 72 2d 3e 6a 66 64 29 3b 0a  e(pPager->jfd);.
55f0: 20 20 20 20 20 20 20 20 20 70 50 61 67 65 72 2d           pPager-
5600: 3e 6a 6f 75 72 6e 61 6c 4f 70 65 6e 20 3d 20 30  >journalOpen = 0
5610: 3b 0a 20 20 20 20 20 20 20 20 20 2a 70 70 50 61  ;.         *ppPa
5620: 67 65 20 3d 20 30 3b 0a 20 20 20 20 20 20 20 20  ge = 0;.        
5630: 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 50   return SQLITE_P
5640: 52 4f 54 4f 43 4f 4c 3b 0a 20 20 20 20 20 20 20  ROTOCOL;.       
5650: 7d 0a 20 20 20 20 20 20 20 70 50 61 67 65 72 2d  }.       pPager-
5660: 3e 73 74 61 74 65 20 3d 20 53 51 4c 49 54 45 5f  >state = SQLITE_
5670: 57 52 49 54 45 4c 4f 43 4b 3b 0a 0a 20 20 20 20  WRITELOCK;..    
5680: 20 20 20 2f 2a 20 50 6c 61 79 62 61 63 6b 20 61     /* Playback a
5690: 6e 64 20 64 65 6c 65 74 65 20 74 68 65 20 6a 6f  nd delete the jo
56a0: 75 72 6e 61 6c 2e 20 20 44 72 6f 70 20 74 68 65  urnal.  Drop the
56b0: 20 64 61 74 61 62 61 73 65 20 77 72 69 74 65 0a   database write.
56c0: 20 20 20 20 20 20 20 2a 2a 20 6c 6f 63 6b 20 61         ** lock a
56d0: 6e 64 20 72 65 61 63 71 75 69 72 65 20 74 68 65  nd reacquire the
56e0: 20 72 65 61 64 20 6c 6f 63 6b 2e 0a 20 20 20 20   read lock..    
56f0: 20 20 20 2a 2f 0a 20 20 20 20 20 20 20 72 63 20     */.       rc 
5700: 3d 20 70 61 67 65 72 5f 70 6c 61 79 62 61 63 6b  = pager_playback
5710: 28 70 50 61 67 65 72 29 3b 0a 20 20 20 20 20 20  (pPager);.      
5720: 20 69 66 28 20 72 63 21 3d 53 51 4c 49 54 45 5f   if( rc!=SQLITE_
5730: 4f 4b 20 29 7b 0a 20 20 20 20 20 20 20 20 20 72  OK ){.         r
5740: 65 74 75 72 6e 20 72 63 3b 0a 20 20 20 20 20 20  eturn rc;.      
5750: 20 7d 0a 20 20 20 20 7d 0a 20 20 20 20 70 50 67   }.    }.    pPg
5760: 20 3d 20 30 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20   = 0;.  }else{. 
5770: 20 20 20 2f 2a 20 53 65 61 72 63 68 20 66 6f 72     /* Search for
5780: 20 70 61 67 65 20 69 6e 20 63 61 63 68 65 20 2a   page in cache *
5790: 2f 0a 20 20 20 20 70 50 67 20 3d 20 70 61 67 65  /.    pPg = page
57a0: 72 5f 6c 6f 6f 6b 75 70 28 70 50 61 67 65 72 2c  r_lookup(pPager,
57b0: 20 70 67 6e 6f 29 3b 0a 20 20 7d 0a 20 20 69 66   pgno);.  }.  if
57c0: 28 20 70 50 67 3d 3d 30 20 29 7b 0a 20 20 20 20  ( pPg==0 ){.    
57d0: 2f 2a 20 54 68 65 20 72 65 71 75 65 73 74 65 64  /* The requested
57e0: 20 70 61 67 65 20 69 73 20 6e 6f 74 20 69 6e 20   page is not in 
57f0: 74 68 65 20 70 61 67 65 20 63 61 63 68 65 2e 20  the page cache. 
5800: 2a 2f 0a 20 20 20 20 69 6e 74 20 68 3b 0a 20 20  */.    int h;.  
5810: 20 20 70 50 61 67 65 72 2d 3e 6e 4d 69 73 73 2b    pPager->nMiss+
5820: 2b 3b 0a 20 20 20 20 69 66 28 20 70 50 61 67 65  +;.    if( pPage
5830: 72 2d 3e 6e 50 61 67 65 3c 70 50 61 67 65 72 2d  r->nPage<pPager-
5840: 3e 6d 78 50 61 67 65 20 7c 7c 20 70 50 61 67 65  >mxPage || pPage
5850: 72 2d 3e 70 46 69 72 73 74 3d 3d 30 20 29 7b 0a  r->pFirst==0 ){.
5860: 20 20 20 20 20 20 2f 2a 20 43 72 65 61 74 65 20        /* Create 
5870: 61 20 6e 65 77 20 70 61 67 65 20 2a 2f 0a 20 20  a new page */.  
5880: 20 20 20 20 70 50 67 20 3d 20 73 71 6c 69 74 65      pPg = sqlite
5890: 4d 61 6c 6c 6f 63 28 20 73 69 7a 65 6f 66 28 2a  Malloc( sizeof(*
58a0: 70 50 67 29 20 2b 20 53 51 4c 49 54 45 5f 50 41  pPg) + SQLITE_PA
58b0: 47 45 5f 53 49 5a 45 20 2b 20 70 50 61 67 65 72  GE_SIZE + pPager
58c0: 2d 3e 6e 45 78 74 72 61 20 29 3b 0a 20 20 20 20  ->nExtra );.    
58d0: 20 20 69 66 28 20 70 50 67 3d 3d 30 20 29 7b 0a    if( pPg==0 ){.
58e0: 20 20 20 20 20 20 20 20 2a 70 70 50 61 67 65 20          *ppPage 
58f0: 3d 20 30 3b 0a 20 20 20 20 20 20 20 20 70 61 67  = 0;.        pag
5900: 65 72 5f 75 6e 77 72 69 74 65 6c 6f 63 6b 28 70  er_unwritelock(p
5910: 50 61 67 65 72 29 3b 0a 20 20 20 20 20 20 20 20  Pager);.        
5920: 70 50 61 67 65 72 2d 3e 65 72 72 4d 61 73 6b 20  pPager->errMask 
5930: 7c 3d 20 50 41 47 45 52 5f 45 52 52 5f 4d 45 4d  |= PAGER_ERR_MEM
5940: 3b 0a 20 20 20 20 20 20 20 20 72 65 74 75 72 6e  ;.        return
5950: 20 53 51 4c 49 54 45 5f 4e 4f 4d 45 4d 3b 0a 20   SQLITE_NOMEM;. 
5960: 20 20 20 20 20 7d 0a 20 20 20 20 20 20 70 50 67       }.      pPg
5970: 2d 3e 70 50 61 67 65 72 20 3d 20 70 50 61 67 65  ->pPager = pPage
5980: 72 3b 0a 20 20 20 20 20 20 70 50 67 2d 3e 70 4e  r;.      pPg->pN
5990: 65 78 74 41 6c 6c 20 3d 20 70 50 61 67 65 72 2d  extAll = pPager-
59a0: 3e 70 41 6c 6c 3b 0a 20 20 20 20 20 20 69 66 28  >pAll;.      if(
59b0: 20 70 50 61 67 65 72 2d 3e 70 41 6c 6c 20 29 7b   pPager->pAll ){
59c0: 0a 20 20 20 20 20 20 20 20 70 50 61 67 65 72 2d  .        pPager-
59d0: 3e 70 41 6c 6c 2d 3e 70 50 72 65 76 41 6c 6c 20  >pAll->pPrevAll 
59e0: 3d 20 70 50 67 3b 0a 20 20 20 20 20 20 7d 0a 20  = pPg;.      }. 
59f0: 20 20 20 20 20 70 50 67 2d 3e 70 50 72 65 76 41       pPg->pPrevA
5a00: 6c 6c 20 3d 20 30 3b 0a 20 20 20 20 20 20 70 50  ll = 0;.      pP
5a10: 61 67 65 72 2d 3e 70 41 6c 6c 20 3d 20 70 50 67  ager->pAll = pPg
5a20: 3b 0a 20 20 20 20 20 20 70 50 61 67 65 72 2d 3e  ;.      pPager->
5a30: 6e 50 61 67 65 2b 2b 3b 0a 20 20 20 20 7d 65 6c  nPage++;.    }el
5a40: 73 65 7b 0a 20 20 20 20 20 20 2f 2a 20 52 65 63  se{.      /* Rec
5a50: 79 63 6c 65 20 61 6e 20 6f 6c 64 65 72 20 70 61  ycle an older pa
5a60: 67 65 2e 20 20 46 69 72 73 74 20 6c 6f 63 61 74  ge.  First locat
5a70: 65 20 74 68 65 20 70 61 67 65 20 74 6f 20 62 65  e the page to be
5a80: 20 72 65 63 79 63 6c 65 64 2e 0a 20 20 20 20 20   recycled..     
5a90: 20 2a 2a 20 54 72 79 20 74 6f 20 66 69 6e 64 20   ** Try to find 
5aa0: 6f 6e 65 20 74 68 61 74 20 69 73 20 6e 6f 74 20  one that is not 
5ab0: 64 69 72 74 79 20 61 6e 64 20 69 73 20 6e 65 61  dirty and is nea
5ac0: 72 20 74 68 65 20 68 65 61 64 20 6f 66 0a 20 20  r the head of.  
5ad0: 20 20 20 20 2a 2a 20 6f 66 20 74 68 65 20 66 72      ** of the fr
5ae0: 65 65 20 6c 69 73 74 20 2a 2f 0a 20 20 20 20 20  ee list */.     
5af0: 20 69 6e 74 20 63 6e 74 20 3d 20 70 50 61 67 65   int cnt = pPage
5b00: 72 2d 3e 6d 78 50 61 67 65 2f 32 3b 0a 20 20 20  r->mxPage/2;.   
5b10: 20 20 20 70 50 67 20 3d 20 70 50 61 67 65 72 2d     pPg = pPager-
5b20: 3e 70 46 69 72 73 74 3b 0a 20 20 20 20 20 20 77  >pFirst;.      w
5b30: 68 69 6c 65 28 20 70 50 67 2d 3e 64 69 72 74 79  hile( pPg->dirty
5b40: 20 26 26 20 30 3c 63 6e 74 2d 2d 20 26 26 20 70   && 0<cnt-- && p
5b50: 50 67 2d 3e 70 4e 65 78 74 46 72 65 65 20 29 7b  Pg->pNextFree ){
5b60: 0a 20 20 20 20 20 20 20 20 70 50 67 20 3d 20 70  .        pPg = p
5b70: 50 67 2d 3e 70 4e 65 78 74 46 72 65 65 3b 0a 20  Pg->pNextFree;. 
5b80: 20 20 20 20 20 7d 0a 0a 20 20 20 20 20 20 2f 2a       }..      /*
5b90: 20 49 66 20 77 65 20 63 6f 75 6c 64 20 6e 6f 74   If we could not
5ba0: 20 66 69 6e 64 20 61 20 70 61 67 65 20 74 68 61   find a page tha
5bb0: 74 20 68 61 73 20 6e 6f 74 20 62 65 65 6e 20 75  t has not been u
5bc0: 73 65 64 20 72 65 63 65 6e 74 6c 79 0a 20 20 20  sed recently.   
5bd0: 20 20 20 2a 2a 20 61 6e 64 20 77 68 69 63 68 20     ** and which 
5be0: 69 73 20 6e 6f 74 20 64 69 72 74 79 2c 20 74 68  is not dirty, th
5bf0: 65 6e 20 73 79 6e 63 20 74 68 65 20 6a 6f 75 72  en sync the jour
5c00: 6e 61 6c 20 61 6e 64 20 77 72 69 74 65 20 61 6c  nal and write al
5c10: 6c 0a 20 20 20 20 20 20 2a 2a 20 64 69 72 74 79  l.      ** dirty
5c20: 20 66 72 65 65 20 70 61 67 65 73 20 69 6e 74 6f   free pages into
5c30: 20 74 68 65 20 64 61 74 61 62 61 73 65 20 66 69   the database fi
5c40: 6c 65 2c 20 74 68 75 73 20 6d 61 6b 69 6e 67 20  le, thus making 
5c50: 74 68 65 6d 0a 20 20 20 20 20 20 2a 2a 20 63 6c  them.      ** cl
5c60: 65 61 6e 20 70 61 67 65 73 20 61 6e 64 20 61 76  ean pages and av
5c70: 61 69 6c 61 62 6c 65 20 66 6f 72 20 72 65 63 79  ailable for recy
5c80: 63 6c 69 6e 67 2e 0a 20 20 20 20 20 20 2a 2a 0a  cling..      **.
5c90: 20 20 20 20 20 20 2a 2a 20 57 65 20 68 61 76 65        ** We have
5ca0: 20 74 6f 20 73 79 6e 63 20 74 68 65 20 6a 6f 75   to sync the jou
5cb0: 72 6e 61 6c 20 62 65 66 6f 72 65 20 77 72 69 74  rnal before writ
5cc0: 69 6e 67 20 61 20 70 61 67 65 20 74 6f 20 74 68  ing a page to th
5cd0: 65 20 6d 61 69 6e 0a 20 20 20 20 20 20 2a 2a 20  e main.      ** 
5ce0: 64 61 74 61 62 61 73 65 2e 20 20 42 75 74 20 73  database.  But s
5cf0: 79 6e 63 69 6e 67 20 69 73 20 61 20 76 65 72 79  yncing is a very
5d00: 20 73 6c 6f 77 20 6f 70 65 72 61 74 69 6f 6e 2e   slow operation.
5d10: 20 20 53 6f 20 61 66 74 65 72 20 61 0a 20 20 20    So after a.   
5d20: 20 20 20 2a 2a 20 73 79 6e 63 2c 20 69 74 20 69     ** sync, it i
5d30: 73 20 62 65 73 74 20 74 6f 20 77 72 69 74 65 20  s best to write 
5d40: 65 76 65 72 79 74 68 69 6e 67 20 77 65 20 63 61  everything we ca
5d50: 6e 20 62 61 63 6b 20 74 6f 20 74 68 65 20 6d 61  n back to the ma
5d60: 69 6e 0a 20 20 20 20 20 20 2a 2a 20 64 61 74 61  in.      ** data
5d70: 62 61 73 65 20 74 6f 20 6d 69 6e 69 6d 69 7a 65  base to minimize
5d80: 20 74 68 65 20 72 69 73 6b 20 6f 66 20 68 61 76   the risk of hav
5d90: 69 6e 67 20 74 6f 20 73 79 6e 63 20 61 67 61 69  ing to sync agai
5da0: 6e 20 69 6e 20 74 68 65 0a 20 20 20 20 20 20 2a  n in the.      *
5db0: 2a 20 6e 65 61 72 20 66 75 74 75 72 65 2e 20 20  * near future.  
5dc0: 54 68 61 74 20 69 73 20 77 61 79 20 77 65 20 77  That is way we w
5dd0: 72 69 74 65 20 61 6c 6c 20 64 69 72 74 79 20 70  rite all dirty p
5de0: 61 67 65 73 20 61 66 74 65 72 20 61 0a 20 20 20  ages after a.   
5df0: 20 20 20 2a 2a 20 73 79 6e 63 2e 0a 20 20 20 20     ** sync..    
5e00: 20 20 2a 2f 0a 20 20 20 20 20 20 69 66 28 20 70    */.      if( p
5e10: 50 67 3d 3d 30 20 7c 7c 20 70 50 67 2d 3e 64 69  Pg==0 || pPg->di
5e20: 72 74 79 20 29 7b 0a 20 20 20 20 20 20 20 20 69  rty ){.        i
5e30: 6e 74 20 72 63 20 3d 20 73 79 6e 63 41 6c 6c 50  nt rc = syncAllP
5e40: 61 67 65 73 28 70 50 61 67 65 72 29 3b 0a 20 20  ages(pPager);.  
5e50: 20 20 20 20 20 20 69 66 28 20 72 63 21 3d 30 20        if( rc!=0 
5e60: 29 7b 0a 20 20 20 20 20 20 20 20 20 20 73 71 6c  ){.          sql
5e70: 69 74 65 70 61 67 65 72 5f 72 6f 6c 6c 62 61 63  itepager_rollbac
5e80: 6b 28 70 50 61 67 65 72 29 3b 0a 20 20 20 20 20  k(pPager);.     
5e90: 20 20 20 20 20 2a 70 70 50 61 67 65 20 3d 20 30       *ppPage = 0
5ea0: 3b 0a 20 20 20 20 20 20 20 20 20 20 72 65 74 75  ;.          retu
5eb0: 72 6e 20 53 51 4c 49 54 45 5f 49 4f 45 52 52 3b  rn SQLITE_IOERR;
5ec0: 0a 20 20 20 20 20 20 20 20 7d 0a 20 20 20 20 20  .        }.     
5ed0: 20 20 20 70 50 67 20 3d 20 70 50 61 67 65 72 2d     pPg = pPager-
5ee0: 3e 70 46 69 72 73 74 3b 0a 20 20 20 20 20 20 7d  >pFirst;.      }
5ef0: 0a 20 20 20 20 20 20 61 73 73 65 72 74 28 20 70  .      assert( p
5f00: 50 67 2d 3e 6e 52 65 66 3d 3d 30 20 29 3b 0a 20  Pg->nRef==0 );. 
5f10: 20 20 20 20 20 61 73 73 65 72 74 28 20 70 50 67       assert( pPg
5f20: 2d 3e 64 69 72 74 79 3d 3d 30 20 29 3b 0a 0a 20  ->dirty==0 );.. 
5f30: 20 20 20 20 20 2f 2a 20 55 6e 6c 69 6e 6b 20 74       /* Unlink t
5f40: 68 65 20 6f 6c 64 20 70 61 67 65 20 66 72 6f 6d  he old page from
5f50: 20 74 68 65 20 66 72 65 65 20 6c 69 73 74 20 61   the free list a
5f60: 6e 64 20 74 68 65 20 68 61 73 68 20 74 61 62 6c  nd the hash tabl
5f70: 65 0a 20 20 20 20 20 20 2a 2f 0a 20 20 20 20 20  e.      */.     
5f80: 20 69 66 28 20 70 50 67 2d 3e 70 50 72 65 76 46   if( pPg->pPrevF
5f90: 72 65 65 20 29 7b 0a 20 20 20 20 20 20 20 20 70  ree ){.        p
5fa0: 50 67 2d 3e 70 50 72 65 76 46 72 65 65 2d 3e 70  Pg->pPrevFree->p
5fb0: 4e 65 78 74 46 72 65 65 20 3d 20 70 50 67 2d 3e  NextFree = pPg->
5fc0: 70 4e 65 78 74 46 72 65 65 3b 0a 20 20 20 20 20  pNextFree;.     
5fd0: 20 7d 65 6c 73 65 7b 0a 20 20 20 20 20 20 20 20   }else{.        
5fe0: 61 73 73 65 72 74 28 20 70 50 61 67 65 72 2d 3e  assert( pPager->
5ff0: 70 46 69 72 73 74 3d 3d 70 50 67 20 29 3b 0a 20  pFirst==pPg );. 
6000: 20 20 20 20 20 20 20 70 50 61 67 65 72 2d 3e 70         pPager->p
6010: 46 69 72 73 74 20 3d 20 70 50 67 2d 3e 70 4e 65  First = pPg->pNe
6020: 78 74 46 72 65 65 3b 0a 20 20 20 20 20 20 7d 0a  xtFree;.      }.
6030: 20 20 20 20 20 20 69 66 28 20 70 50 67 2d 3e 70        if( pPg->p
6040: 4e 65 78 74 46 72 65 65 20 29 7b 0a 20 20 20 20  NextFree ){.    
6050: 20 20 20 20 70 50 67 2d 3e 70 4e 65 78 74 46 72      pPg->pNextFr
6060: 65 65 2d 3e 70 50 72 65 76 46 72 65 65 20 3d 20  ee->pPrevFree = 
6070: 70 50 67 2d 3e 70 50 72 65 76 46 72 65 65 3b 0a  pPg->pPrevFree;.
6080: 20 20 20 20 20 20 7d 65 6c 73 65 7b 0a 20 20 20        }else{.   
6090: 20 20 20 20 20 61 73 73 65 72 74 28 20 70 50 61       assert( pPa
60a0: 67 65 72 2d 3e 70 4c 61 73 74 3d 3d 70 50 67 20  ger->pLast==pPg 
60b0: 29 3b 0a 20 20 20 20 20 20 20 20 70 50 61 67 65  );.        pPage
60c0: 72 2d 3e 70 4c 61 73 74 20 3d 20 70 50 67 2d 3e  r->pLast = pPg->
60d0: 70 50 72 65 76 46 72 65 65 3b 0a 20 20 20 20 20  pPrevFree;.     
60e0: 20 7d 0a 20 20 20 20 20 20 70 50 67 2d 3e 70 4e   }.      pPg->pN
60f0: 65 78 74 46 72 65 65 20 3d 20 70 50 67 2d 3e 70  extFree = pPg->p
6100: 50 72 65 76 46 72 65 65 20 3d 20 30 3b 0a 20 20  PrevFree = 0;.  
6110: 20 20 20 20 69 66 28 20 70 50 67 2d 3e 70 4e 65      if( pPg->pNe
6120: 78 74 48 61 73 68 20 29 7b 0a 20 20 20 20 20 20  xtHash ){.      
6130: 20 20 70 50 67 2d 3e 70 4e 65 78 74 48 61 73 68    pPg->pNextHash
6140: 2d 3e 70 50 72 65 76 48 61 73 68 20 3d 20 70 50  ->pPrevHash = pP
6150: 67 2d 3e 70 50 72 65 76 48 61 73 68 3b 0a 20 20  g->pPrevHash;.  
6160: 20 20 20 20 7d 0a 20 20 20 20 20 20 69 66 28 20      }.      if( 
6170: 70 50 67 2d 3e 70 50 72 65 76 48 61 73 68 20 29  pPg->pPrevHash )
6180: 7b 0a 20 20 20 20 20 20 20 20 70 50 67 2d 3e 70  {.        pPg->p
6190: 50 72 65 76 48 61 73 68 2d 3e 70 4e 65 78 74 48  PrevHash->pNextH
61a0: 61 73 68 20 3d 20 70 50 67 2d 3e 70 4e 65 78 74  ash = pPg->pNext
61b0: 48 61 73 68 3b 0a 20 20 20 20 20 20 7d 65 6c 73  Hash;.      }els
61c0: 65 7b 0a 20 20 20 20 20 20 20 20 68 20 3d 20 70  e{.        h = p
61d0: 61 67 65 72 5f 68 61 73 68 28 70 50 67 2d 3e 70  ager_hash(pPg->p
61e0: 67 6e 6f 29 3b 0a 20 20 20 20 20 20 20 20 61 73  gno);.        as
61f0: 73 65 72 74 28 20 70 50 61 67 65 72 2d 3e 61 48  sert( pPager->aH
6200: 61 73 68 5b 68 5d 3d 3d 70 50 67 20 29 3b 0a 20  ash[h]==pPg );. 
6210: 20 20 20 20 20 20 20 70 50 61 67 65 72 2d 3e 61         pPager->a
6220: 48 61 73 68 5b 68 5d 20 3d 20 70 50 67 2d 3e 70  Hash[h] = pPg->p
6230: 4e 65 78 74 48 61 73 68 3b 0a 20 20 20 20 20 20  NextHash;.      
6240: 7d 0a 20 20 20 20 20 20 70 50 67 2d 3e 70 4e 65  }.      pPg->pNe
6250: 78 74 48 61 73 68 20 3d 20 70 50 67 2d 3e 70 50  xtHash = pPg->pP
6260: 72 65 76 48 61 73 68 20 3d 20 30 3b 0a 20 20 20  revHash = 0;.   
6270: 20 20 20 70 50 61 67 65 72 2d 3e 6e 4f 76 66 6c     pPager->nOvfl
6280: 2b 2b 3b 0a 20 20 20 20 7d 0a 20 20 20 20 70 50  ++;.    }.    pP
6290: 67 2d 3e 70 67 6e 6f 20 3d 20 70 67 6e 6f 3b 0a  g->pgno = pgno;.
62a0: 20 20 20 20 69 66 28 20 70 50 61 67 65 72 2d 3e      if( pPager->
62b0: 61 49 6e 4a 6f 75 72 6e 61 6c 20 26 26 20 70 67  aInJournal && pg
62c0: 6e 6f 3c 3d 70 50 61 67 65 72 2d 3e 6f 72 69 67  no<=pPager->orig
62d0: 44 62 53 69 7a 65 20 29 7b 0a 20 20 20 20 20 20  DbSize ){.      
62e0: 70 50 67 2d 3e 69 6e 4a 6f 75 72 6e 61 6c 20 3d  pPg->inJournal =
62f0: 20 28 70 50 61 67 65 72 2d 3e 61 49 6e 4a 6f 75   (pPager->aInJou
6300: 72 6e 61 6c 5b 70 67 6e 6f 2f 38 5d 20 26 20 28  rnal[pgno/8] & (
6310: 31 3c 3c 28 70 67 6e 6f 26 37 29 29 29 21 3d 30  1<<(pgno&7)))!=0
6320: 3b 0a 20 20 20 20 7d 65 6c 73 65 7b 0a 20 20 20  ;.    }else{.   
6330: 20 20 20 70 50 67 2d 3e 69 6e 4a 6f 75 72 6e 61     pPg->inJourna
6340: 6c 20 3d 20 30 3b 0a 20 20 20 20 7d 0a 20 20 20  l = 0;.    }.   
6350: 20 70 50 67 2d 3e 64 69 72 74 79 20 3d 20 30 3b   pPg->dirty = 0;
6360: 0a 20 20 20 20 70 50 67 2d 3e 6e 52 65 66 20 3d  .    pPg->nRef =
6370: 20 31 3b 0a 20 20 20 20 52 45 46 49 4e 46 4f 28   1;.    REFINFO(
6380: 70 50 67 29 3b 0a 20 20 20 20 70 50 61 67 65 72  pPg);.    pPager
6390: 2d 3e 6e 52 65 66 2b 2b 3b 0a 20 20 20 20 68 20  ->nRef++;.    h 
63a0: 3d 20 70 61 67 65 72 5f 68 61 73 68 28 70 67 6e  = pager_hash(pgn
63b0: 6f 29 3b 0a 20 20 20 20 70 50 67 2d 3e 70 4e 65  o);.    pPg->pNe
63c0: 78 74 48 61 73 68 20 3d 20 70 50 61 67 65 72 2d  xtHash = pPager-
63d0: 3e 61 48 61 73 68 5b 68 5d 3b 0a 20 20 20 20 70  >aHash[h];.    p
63e0: 50 61 67 65 72 2d 3e 61 48 61 73 68 5b 68 5d 20  Pager->aHash[h] 
63f0: 3d 20 70 50 67 3b 0a 20 20 20 20 69 66 28 20 70  = pPg;.    if( p
6400: 50 67 2d 3e 70 4e 65 78 74 48 61 73 68 20 29 7b  Pg->pNextHash ){
6410: 0a 20 20 20 20 20 20 61 73 73 65 72 74 28 20 70  .      assert( p
6420: 50 67 2d 3e 70 4e 65 78 74 48 61 73 68 2d 3e 70  Pg->pNextHash->p
6430: 50 72 65 76 48 61 73 68 3d 3d 30 20 29 3b 0a 20  PrevHash==0 );. 
6440: 20 20 20 20 20 70 50 67 2d 3e 70 4e 65 78 74 48       pPg->pNextH
6450: 61 73 68 2d 3e 70 50 72 65 76 48 61 73 68 20 3d  ash->pPrevHash =
6460: 20 70 50 67 3b 0a 20 20 20 20 7d 0a 20 20 20 20   pPg;.    }.    
6470: 69 66 28 20 70 50 61 67 65 72 2d 3e 64 62 53 69  if( pPager->dbSi
6480: 7a 65 3c 30 20 29 20 73 71 6c 69 74 65 70 61 67  ze<0 ) sqlitepag
6490: 65 72 5f 70 61 67 65 63 6f 75 6e 74 28 70 50 61  er_pagecount(pPa
64a0: 67 65 72 29 3b 0a 20 20 20 20 69 66 28 20 70 50  ger);.    if( pP
64b0: 61 67 65 72 2d 3e 64 62 53 69 7a 65 3c 70 67 6e  ager->dbSize<pgn
64c0: 6f 20 29 7b 0a 20 20 20 20 20 20 6d 65 6d 73 65  o ){.      memse
64d0: 74 28 50 47 48 44 52 5f 54 4f 5f 44 41 54 41 28  t(PGHDR_TO_DATA(
64e0: 70 50 67 29 2c 20 30 2c 20 53 51 4c 49 54 45 5f  pPg), 0, SQLITE_
64f0: 50 41 47 45 5f 53 49 5a 45 29 3b 0a 20 20 20 20  PAGE_SIZE);.    
6500: 7d 65 6c 73 65 7b 0a 20 20 20 20 20 20 73 71 6c  }else{.      sql
6510: 69 74 65 4f 73 53 65 65 6b 28 70 50 61 67 65 72  iteOsSeek(pPager
6520: 2d 3e 66 64 2c 20 28 70 67 6e 6f 2d 31 29 2a 53  ->fd, (pgno-1)*S
6530: 51 4c 49 54 45 5f 50 41 47 45 5f 53 49 5a 45 29  QLITE_PAGE_SIZE)
6540: 3b 0a 20 20 20 20 20 20 73 71 6c 69 74 65 4f 73  ;.      sqliteOs
6550: 52 65 61 64 28 70 50 61 67 65 72 2d 3e 66 64 2c  Read(pPager->fd,
6560: 20 50 47 48 44 52 5f 54 4f 5f 44 41 54 41 28 70   PGHDR_TO_DATA(p
6570: 50 67 29 2c 20 53 51 4c 49 54 45 5f 50 41 47 45  Pg), SQLITE_PAGE
6580: 5f 53 49 5a 45 29 3b 0a 20 20 20 20 7d 0a 20 20  _SIZE);.    }.  
6590: 20 20 69 66 28 20 70 50 61 67 65 72 2d 3e 6e 45    if( pPager->nE
65a0: 78 74 72 61 3e 30 20 29 7b 0a 20 20 20 20 20 20  xtra>0 ){.      
65b0: 6d 65 6d 73 65 74 28 50 47 48 44 52 5f 54 4f 5f  memset(PGHDR_TO_
65c0: 45 58 54 52 41 28 70 50 67 29 2c 20 30 2c 20 70  EXTRA(pPg), 0, p
65d0: 50 61 67 65 72 2d 3e 6e 45 78 74 72 61 29 3b 0a  Pager->nExtra);.
65e0: 20 20 20 20 7d 0a 20 20 7d 65 6c 73 65 7b 0a 20      }.  }else{. 
65f0: 20 20 20 2f 2a 20 54 68 65 20 72 65 71 75 65 73     /* The reques
6600: 74 65 64 20 70 61 67 65 20 69 73 20 69 6e 20 74  ted page is in t
6610: 68 65 20 70 61 67 65 20 63 61 63 68 65 2e 20 2a  he page cache. *
6620: 2f 0a 20 20 20 20 70 50 61 67 65 72 2d 3e 6e 48  /.    pPager->nH
6630: 69 74 2b 2b 3b 0a 20 20 20 20 70 61 67 65 5f 72  it++;.    page_r
6640: 65 66 28 70 50 67 29 3b 0a 20 20 7d 0a 20 20 2a  ef(pPg);.  }.  *
6650: 70 70 50 61 67 65 20 3d 20 50 47 48 44 52 5f 54  ppPage = PGHDR_T
6660: 4f 5f 44 41 54 41 28 70 50 67 29 3b 0a 20 20 72  O_DATA(pPg);.  r
6670: 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b  eturn SQLITE_OK;
6680: 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 41 63 71 75 69 72  .}../*.** Acquir
6690: 65 20 61 20 70 61 67 65 20 69 66 20 69 74 20 69  e a page if it i
66a0: 73 20 61 6c 72 65 61 64 79 20 69 6e 20 74 68 65  s already in the
66b0: 20 69 6e 2d 6d 65 6d 6f 72 79 20 63 61 63 68 65   in-memory cache
66c0: 2e 20 20 44 6f 0a 2a 2a 20 6e 6f 74 20 72 65 61  .  Do.** not rea
66d0: 64 20 74 68 65 20 70 61 67 65 20 66 72 6f 6d 20  d the page from 
66e0: 64 69 73 6b 2e 20 20 52 65 74 75 72 6e 20 61 20  disk.  Return a 
66f0: 70 6f 69 6e 74 65 72 20 74 6f 20 74 68 65 20 70  pointer to the p
6700: 61 67 65 2c 0a 2a 2a 20 6f 72 20 30 20 69 66 20  age,.** or 0 if 
6710: 74 68 65 20 70 61 67 65 20 69 73 20 6e 6f 74 20  the page is not 
6720: 69 6e 20 63 61 63 68 65 2e 0a 2a 2a 0a 2a 2a 20  in cache..**.** 
6730: 53 65 65 20 61 6c 73 6f 20 73 71 6c 69 74 65 70  See also sqlitep
6740: 61 67 65 72 5f 67 65 74 28 29 2e 20 20 54 68 65  ager_get().  The
6750: 20 64 69 66 66 65 72 65 6e 63 65 20 62 65 74 77   difference betw
6760: 65 65 6e 20 74 68 69 73 20 72 6f 75 74 69 6e 65  een this routine
6770: 0a 2a 2a 20 61 6e 64 20 73 71 6c 69 74 65 70 61  .** and sqlitepa
6780: 67 65 72 5f 67 65 74 28 29 20 69 73 20 74 68 61  ger_get() is tha
6790: 74 20 5f 67 65 74 28 29 20 77 69 6c 6c 20 67 6f  t _get() will go
67a0: 20 74 6f 20 74 68 65 20 64 69 73 6b 20 61 6e 64   to the disk and
67b0: 20 72 65 61 64 0a 2a 2a 20 69 6e 20 74 68 65 20   read.** in the 
67c0: 70 61 67 65 20 69 66 20 74 68 65 20 70 61 67 65  page if the page
67d0: 20 69 73 20 6e 6f 74 20 61 6c 72 65 61 64 79 20   is not already 
67e0: 69 6e 20 63 61 63 68 65 2e 20 20 54 68 69 73 20  in cache.  This 
67f0: 72 6f 75 74 69 6e 65 0a 2a 2a 20 72 65 74 75 72  routine.** retur
6800: 6e 73 20 4e 55 4c 4c 20 69 66 20 74 68 65 20 70  ns NULL if the p
6810: 61 67 65 20 69 73 20 6e 6f 74 20 69 6e 20 63 61  age is not in ca
6820: 63 68 65 20 6f 72 20 69 66 20 61 20 64 69 73 6b  che or if a disk
6830: 20 49 2f 4f 20 65 72 72 6f 72 20 0a 2a 2a 20 68   I/O error .** h
6840: 61 73 20 65 76 65 72 20 68 61 70 70 65 6e 65 64  as ever happened
6850: 2e 0a 2a 2f 0a 76 6f 69 64 20 2a 73 71 6c 69 74  ..*/.void *sqlit
6860: 65 70 61 67 65 72 5f 6c 6f 6f 6b 75 70 28 50 61  epager_lookup(Pa
6870: 67 65 72 20 2a 70 50 61 67 65 72 2c 20 50 67 6e  ger *pPager, Pgn
6880: 6f 20 70 67 6e 6f 29 7b 0a 20 20 50 67 48 64 72  o pgno){.  PgHdr
6890: 20 2a 70 50 67 3b 0a 0a 20 20 2f 2a 20 4d 61 6b   *pPg;..  /* Mak
68a0: 65 20 73 75 72 65 20 77 65 20 68 61 76 65 20 6e  e sure we have n
68b0: 6f 74 20 68 69 74 20 61 6e 79 20 63 72 69 74 69  ot hit any criti
68c0: 63 61 6c 20 65 72 72 6f 72 73 2e 0a 20 20 2a 2f  cal errors..  */
68d0: 20 0a 20 20 69 66 28 20 70 50 61 67 65 72 3d 3d   .  if( pPager==
68e0: 30 20 7c 7c 20 70 67 6e 6f 3d 3d 30 20 29 7b 0a  0 || pgno==0 ){.
68f0: 20 20 20 20 72 65 74 75 72 6e 20 30 3b 0a 20 20      return 0;.  
6900: 7d 0a 20 20 69 66 28 20 70 50 61 67 65 72 2d 3e  }.  if( pPager->
6910: 65 72 72 4d 61 73 6b 20 26 20 7e 28 50 41 47 45  errMask & ~(PAGE
6920: 52 5f 45 52 52 5f 46 55 4c 4c 29 20 29 7b 0a 20  R_ERR_FULL) ){. 
6930: 20 20 20 72 65 74 75 72 6e 20 30 3b 0a 20 20 7d     return 0;.  }
6940: 0a 20 20 69 66 28 20 70 50 61 67 65 72 2d 3e 6e  .  if( pPager->n
6950: 52 65 66 3d 3d 30 20 29 7b 0a 20 20 20 20 72 65  Ref==0 ){.    re
6960: 74 75 72 6e 20 30 3b 0a 20 20 7d 0a 20 20 70 50  turn 0;.  }.  pP
6970: 67 20 3d 20 70 61 67 65 72 5f 6c 6f 6f 6b 75 70  g = pager_lookup
6980: 28 70 50 61 67 65 72 2c 20 70 67 6e 6f 29 3b 0a  (pPager, pgno);.
6990: 20 20 69 66 28 20 70 50 67 3d 3d 30 20 29 20 72    if( pPg==0 ) r
69a0: 65 74 75 72 6e 20 30 3b 0a 20 20 70 61 67 65 5f  eturn 0;.  page_
69b0: 72 65 66 28 70 50 67 29 3b 0a 20 20 72 65 74 75  ref(pPg);.  retu
69c0: 72 6e 20 50 47 48 44 52 5f 54 4f 5f 44 41 54 41  rn PGHDR_TO_DATA
69d0: 28 70 50 67 29 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20  (pPg);.}../*.** 
69e0: 52 65 6c 65 61 73 65 20 61 20 70 61 67 65 2e 0a  Release a page..
69f0: 2a 2a 0a 2a 2a 20 49 66 20 74 68 65 20 6e 75 6d  **.** If the num
6a00: 62 65 72 20 6f 66 20 72 65 66 65 72 65 6e 63 65  ber of reference
6a10: 73 20 74 6f 20 74 68 65 20 70 61 67 65 20 64 72  s to the page dr
6a20: 6f 70 20 74 6f 20 7a 65 72 6f 2c 20 74 68 65 6e  op to zero, then
6a30: 20 74 68 65 0a 2a 2a 20 70 61 67 65 20 69 73 20   the.** page is 
6a40: 61 64 64 65 64 20 74 6f 20 74 68 65 20 4c 52 55  added to the LRU
6a50: 20 6c 69 73 74 2e 20 20 57 68 65 6e 20 61 6c 6c   list.  When all
6a60: 20 72 65 66 65 72 65 6e 63 65 73 20 74 6f 20 61   references to a
6a70: 6c 6c 20 70 61 67 65 73 0a 2a 2a 20 61 72 65 20  ll pages.** are 
6a80: 72 65 6c 65 61 73 65 64 2c 20 61 20 72 6f 6c 6c  released, a roll
6a90: 62 61 63 6b 20 6f 63 63 75 72 73 20 61 6e 64 20  back occurs and 
6aa0: 74 68 65 20 6c 6f 63 6b 20 6f 6e 20 74 68 65 20  the lock on the 
6ab0: 64 61 74 61 62 61 73 65 20 69 73 0a 2a 2a 20 72  database is.** r
6ac0: 65 6d 6f 76 65 64 2e 0a 2a 2f 0a 69 6e 74 20 73  emoved..*/.int s
6ad0: 71 6c 69 74 65 70 61 67 65 72 5f 75 6e 72 65 66  qlitepager_unref
6ae0: 28 76 6f 69 64 20 2a 70 44 61 74 61 29 7b 0a 20  (void *pData){. 
6af0: 20 50 67 48 64 72 20 2a 70 50 67 3b 0a 0a 20 20   PgHdr *pPg;..  
6b00: 2f 2a 20 44 65 63 72 65 6d 65 6e 74 20 74 68 65  /* Decrement the
6b10: 20 72 65 66 65 72 65 6e 63 65 20 63 6f 75 6e 74   reference count
6b20: 20 66 6f 72 20 74 68 69 73 20 70 61 67 65 0a 20   for this page. 
6b30: 20 2a 2f 0a 20 20 70 50 67 20 3d 20 44 41 54 41   */.  pPg = DATA
6b40: 5f 54 4f 5f 50 47 48 44 52 28 70 44 61 74 61 29  _TO_PGHDR(pData)
6b50: 3b 0a 20 20 61 73 73 65 72 74 28 20 70 50 67 2d  ;.  assert( pPg-
6b60: 3e 6e 52 65 66 3e 30 20 29 3b 0a 20 20 70 50 67  >nRef>0 );.  pPg
6b70: 2d 3e 6e 52 65 66 2d 2d 3b 0a 20 20 52 45 46 49  ->nRef--;.  REFI
6b80: 4e 46 4f 28 70 50 67 29 3b 0a 0a 20 20 2f 2a 20  NFO(pPg);..  /* 
6b90: 57 68 65 6e 20 74 68 65 20 6e 75 6d 62 65 72 20  When the number 
6ba0: 6f 66 20 72 65 66 65 72 65 6e 63 65 73 20 74 6f  of references to
6bb0: 20 61 20 70 61 67 65 20 72 65 61 63 68 20 30 2c   a page reach 0,
6bc0: 20 63 61 6c 6c 20 74 68 65 0a 20 20 2a 2a 20 64   call the.  ** d
6bd0: 65 73 74 72 75 63 74 6f 72 20 61 6e 64 20 61 64  estructor and ad
6be0: 64 20 74 68 65 20 70 61 67 65 20 74 6f 20 74 68  d the page to th
6bf0: 65 20 66 72 65 65 6c 69 73 74 2e 0a 20 20 2a 2f  e freelist..  */
6c00: 0a 20 20 69 66 28 20 70 50 67 2d 3e 6e 52 65 66  .  if( pPg->nRef
6c10: 3d 3d 30 20 29 7b 0a 20 20 20 20 50 61 67 65 72  ==0 ){.    Pager
6c20: 20 2a 70 50 61 67 65 72 3b 0a 20 20 20 20 70 50   *pPager;.    pP
6c30: 61 67 65 72 20 3d 20 70 50 67 2d 3e 70 50 61 67  ager = pPg->pPag
6c40: 65 72 3b 0a 20 20 20 20 70 50 67 2d 3e 70 4e 65  er;.    pPg->pNe
6c50: 78 74 46 72 65 65 20 3d 20 30 3b 0a 20 20 20 20  xtFree = 0;.    
6c60: 70 50 67 2d 3e 70 50 72 65 76 46 72 65 65 20 3d  pPg->pPrevFree =
6c70: 20 70 50 61 67 65 72 2d 3e 70 4c 61 73 74 3b 0a   pPager->pLast;.
6c80: 20 20 20 20 70 50 61 67 65 72 2d 3e 70 4c 61 73      pPager->pLas
6c90: 74 20 3d 20 70 50 67 3b 0a 20 20 20 20 69 66 28  t = pPg;.    if(
6ca0: 20 70 50 67 2d 3e 70 50 72 65 76 46 72 65 65 20   pPg->pPrevFree 
6cb0: 29 7b 0a 20 20 20 20 20 20 70 50 67 2d 3e 70 50  ){.      pPg->pP
6cc0: 72 65 76 46 72 65 65 2d 3e 70 4e 65 78 74 46 72  revFree->pNextFr
6cd0: 65 65 20 3d 20 70 50 67 3b 0a 20 20 20 20 7d 65  ee = pPg;.    }e
6ce0: 6c 73 65 7b 0a 20 20 20 20 20 20 70 50 61 67 65  lse{.      pPage
6cf0: 72 2d 3e 70 46 69 72 73 74 20 3d 20 70 50 67 3b  r->pFirst = pPg;
6d00: 0a 20 20 20 20 7d 0a 20 20 20 20 69 66 28 20 70  .    }.    if( p
6d10: 50 61 67 65 72 2d 3e 78 44 65 73 74 72 75 63 74  Pager->xDestruct
6d20: 6f 72 20 29 7b 0a 20 20 20 20 20 20 70 50 61 67  or ){.      pPag
6d30: 65 72 2d 3e 78 44 65 73 74 72 75 63 74 6f 72 28  er->xDestructor(
6d40: 70 44 61 74 61 29 3b 0a 20 20 20 20 7d 0a 20 20  pData);.    }.  
6d50: 0a 20 20 20 20 2f 2a 20 57 68 65 6e 20 61 6c 6c  .    /* When all
6d60: 20 70 61 67 65 73 20 72 65 61 63 68 20 74 68 65   pages reach the
6d70: 20 66 72 65 65 6c 69 73 74 2c 20 64 72 6f 70 20   freelist, drop 
6d80: 74 68 65 20 72 65 61 64 20 6c 6f 63 6b 20 66 72  the read lock fr
6d90: 6f 6d 0a 20 20 20 20 2a 2a 20 74 68 65 20 64 61  om.    ** the da
6da0: 74 61 62 61 73 65 20 66 69 6c 65 2e 0a 20 20 20  tabase file..   
6db0: 20 2a 2f 0a 20 20 20 20 70 50 61 67 65 72 2d 3e   */.    pPager->
6dc0: 6e 52 65 66 2d 2d 3b 0a 20 20 20 20 61 73 73 65  nRef--;.    asse
6dd0: 72 74 28 20 70 50 61 67 65 72 2d 3e 6e 52 65 66  rt( pPager->nRef
6de0: 3e 3d 30 20 29 3b 0a 20 20 20 20 69 66 28 20 70  >=0 );.    if( p
6df0: 50 61 67 65 72 2d 3e 6e 52 65 66 3d 3d 30 20 29  Pager->nRef==0 )
6e00: 7b 0a 20 20 20 20 20 20 70 61 67 65 72 5f 72 65  {.      pager_re
6e10: 73 65 74 28 70 50 61 67 65 72 29 3b 0a 20 20 20  set(pPager);.   
6e20: 20 7d 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e 20   }.  }.  return 
6e30: 53 51 4c 49 54 45 5f 4f 4b 3b 0a 7d 0a 0a 2f 2a  SQLITE_OK;.}../*
6e40: 0a 2a 2a 20 4d 61 72 6b 20 61 20 64 61 74 61 20  .** Mark a data 
6e50: 70 61 67 65 20 61 73 20 77 72 69 74 65 61 62 6c  page as writeabl
6e60: 65 2e 20 20 54 68 65 20 70 61 67 65 20 69 73 20  e.  The page is 
6e70: 77 72 69 74 74 65 6e 20 69 6e 74 6f 20 74 68 65  written into the
6e80: 20 6a 6f 75 72 6e 61 6c 20 0a 2a 2a 20 69 66 20   journal .** if 
6e90: 69 74 20 69 73 20 6e 6f 74 20 74 68 65 72 65 20  it is not there 
6ea0: 61 6c 72 65 61 64 79 2e 20 20 54 68 69 73 20 72  already.  This r
6eb0: 6f 75 74 69 6e 65 20 6d 75 73 74 20 62 65 20 63  outine must be c
6ec0: 61 6c 6c 65 64 20 62 65 66 6f 72 65 20 6d 61 6b  alled before mak
6ed0: 69 6e 67 0a 2a 2a 20 63 68 61 6e 67 65 73 20 74  ing.** changes t
6ee0: 6f 20 61 20 70 61 67 65 2e 0a 2a 2a 0a 2a 2a 20  o a page..**.** 
6ef0: 54 68 65 20 66 69 72 73 74 20 74 69 6d 65 20 74  The first time t
6f00: 68 69 73 20 72 6f 75 74 69 6e 65 20 69 73 20 63  his routine is c
6f10: 61 6c 6c 65 64 2c 20 74 68 65 20 70 61 67 65 72  alled, the pager
6f20: 20 63 72 65 61 74 65 73 20 61 20 6e 65 77 0a 2a   creates a new.*
6f30: 2a 20 6a 6f 75 72 6e 61 6c 20 61 6e 64 20 61 63  * journal and ac
6f40: 71 75 69 72 65 73 20 61 20 77 72 69 74 65 20 6c  quires a write l
6f50: 6f 63 6b 20 6f 6e 20 74 68 65 20 64 61 74 61 62  ock on the datab
6f60: 61 73 65 2e 20 20 49 66 20 74 68 65 20 77 72 69  ase.  If the wri
6f70: 74 65 0a 2a 2a 20 6c 6f 63 6b 20 63 6f 75 6c 64  te.** lock could
6f80: 20 6e 6f 74 20 62 65 20 61 63 71 75 69 72 65 64   not be acquired
6f90: 2c 20 74 68 69 73 20 72 6f 75 74 69 6e 65 20 72  , this routine r
6fa0: 65 74 75 72 6e 73 20 53 51 4c 49 54 45 5f 42 55  eturns SQLITE_BU
6fb0: 53 59 2e 20 20 54 68 65 0a 2a 2a 20 63 61 6c 6c  SY.  The.** call
6fc0: 69 6e 67 20 72 6f 75 74 69 6e 65 20 6d 75 73 74  ing routine must
6fd0: 20 63 68 65 63 6b 20 66 6f 72 20 74 68 61 74 20   check for that 
6fe0: 72 65 74 75 72 6e 20 76 61 6c 75 65 20 61 6e 64  return value and
6ff0: 20 62 65 20 63 61 72 65 66 75 6c 20 6e 6f 74 20   be careful not 
7000: 74 6f 0a 2a 2a 20 63 68 61 6e 67 65 20 61 6e 79  to.** change any
7010: 20 70 61 67 65 20 64 61 74 61 20 75 6e 74 69 6c   page data until
7020: 20 74 68 69 73 20 72 6f 75 74 69 6e 65 20 72 65   this routine re
7030: 74 75 72 6e 73 20 53 51 4c 49 54 45 5f 4f 4b 2e  turns SQLITE_OK.
7040: 0a 2a 2a 0a 2a 2a 20 49 66 20 74 68 65 20 6a 6f  .**.** If the jo
7050: 75 72 6e 61 6c 20 66 69 6c 65 20 63 6f 75 6c 64  urnal file could
7060: 20 6e 6f 74 20 62 65 20 77 72 69 74 74 65 6e 20   not be written 
7070: 62 65 63 61 75 73 65 20 74 68 65 20 64 69 73 6b  because the disk
7080: 20 69 73 20 66 75 6c 6c 2c 0a 2a 2a 20 74 68 65   is full,.** the
7090: 6e 20 74 68 69 73 20 72 6f 75 74 69 6e 65 20 72  n this routine r
70a0: 65 74 75 72 6e 73 20 53 51 4c 49 54 45 5f 46 55  eturns SQLITE_FU
70b0: 4c 4c 20 61 6e 64 20 64 6f 65 73 20 61 6e 20 69  LL and does an i
70c0: 6d 6d 65 64 69 61 74 65 20 72 6f 6c 6c 62 61 63  mmediate rollbac
70d0: 6b 2e 0a 2a 2a 20 41 6c 6c 20 73 75 62 73 65 71  k..** All subseq
70e0: 75 65 6e 74 20 77 72 69 74 65 20 61 74 74 65 6d  uent write attem
70f0: 70 74 73 20 61 6c 73 6f 20 72 65 74 75 72 6e 20  pts also return 
7100: 53 51 4c 49 54 45 5f 46 55 4c 4c 20 75 6e 74 69  SQLITE_FULL unti
7110: 6c 20 74 68 65 72 65 0a 2a 2a 20 69 73 20 61 20  l there.** is a 
7120: 63 61 6c 6c 20 74 6f 20 73 71 6c 69 74 65 70 61  call to sqlitepa
7130: 67 65 72 5f 63 6f 6d 6d 69 74 28 29 20 6f 72 20  ger_commit() or 
7140: 73 71 6c 69 74 65 70 61 67 65 72 5f 72 6f 6c 6c  sqlitepager_roll
7150: 62 61 63 6b 28 29 20 74 6f 0a 2a 2a 20 72 65 73  back() to.** res
7160: 65 74 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74  et..*/.int sqlit
7170: 65 70 61 67 65 72 5f 77 72 69 74 65 28 76 6f 69  epager_write(voi
7180: 64 20 2a 70 44 61 74 61 29 7b 0a 20 20 50 67 48  d *pData){.  PgH
7190: 64 72 20 2a 70 50 67 20 3d 20 44 41 54 41 5f 54  dr *pPg = DATA_T
71a0: 4f 5f 50 47 48 44 52 28 70 44 61 74 61 29 3b 0a  O_PGHDR(pData);.
71b0: 20 20 50 61 67 65 72 20 2a 70 50 61 67 65 72 20    Pager *pPager 
71c0: 3d 20 70 50 67 2d 3e 70 50 61 67 65 72 3b 0a 20  = pPg->pPager;. 
71d0: 20 69 6e 74 20 72 63 20 3d 20 53 51 4c 49 54 45   int rc = SQLITE
71e0: 5f 4f 4b 3b 0a 0a 20 20 69 66 28 20 70 50 61 67  _OK;..  if( pPag
71f0: 65 72 2d 3e 65 72 72 4d 61 73 6b 20 29 7b 20 0a  er->errMask ){ .
7200: 20 20 20 20 72 65 74 75 72 6e 20 70 61 67 65 72      return pager
7210: 5f 65 72 72 63 6f 64 65 28 70 50 61 67 65 72 29  _errcode(pPager)
7220: 3b 0a 20 20 7d 0a 20 20 69 66 28 20 70 50 61 67  ;.  }.  if( pPag
7230: 65 72 2d 3e 72 65 61 64 4f 6e 6c 79 20 29 7b 0a  er->readOnly ){.
7240: 20 20 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54      return SQLIT
7250: 45 5f 50 45 52 4d 3b 0a 20 20 7d 0a 20 20 70 50  E_PERM;.  }.  pP
7260: 67 2d 3e 64 69 72 74 79 20 3d 20 31 3b 0a 20 20  g->dirty = 1;.  
7270: 69 66 28 20 70 50 67 2d 3e 69 6e 4a 6f 75 72 6e  if( pPg->inJourn
7280: 61 6c 20 29 7b 20 72 65 74 75 72 6e 20 53 51 4c  al ){ return SQL
7290: 49 54 45 5f 4f 4b 3b 20 7d 0a 20 20 61 73 73 65  ITE_OK; }.  asse
72a0: 72 74 28 20 70 50 61 67 65 72 2d 3e 73 74 61 74  rt( pPager->stat
72b0: 65 21 3d 53 51 4c 49 54 45 5f 55 4e 4c 4f 43 4b  e!=SQLITE_UNLOCK
72c0: 20 29 3b 0a 20 20 69 66 28 20 70 50 61 67 65 72   );.  if( pPager
72d0: 2d 3e 73 74 61 74 65 3d 3d 53 51 4c 49 54 45 5f  ->state==SQLITE_
72e0: 52 45 41 44 4c 4f 43 4b 20 29 7b 0a 20 20 20 20  READLOCK ){.    
72f0: 61 73 73 65 72 74 28 20 70 50 61 67 65 72 2d 3e  assert( pPager->
7300: 61 49 6e 4a 6f 75 72 6e 61 6c 3d 3d 30 20 29 3b  aInJournal==0 );
7310: 0a 20 20 20 20 70 50 61 67 65 72 2d 3e 61 49 6e  .    pPager->aIn
7320: 4a 6f 75 72 6e 61 6c 20 3d 20 73 71 6c 69 74 65  Journal = sqlite
7330: 4d 61 6c 6c 6f 63 28 20 70 50 61 67 65 72 2d 3e  Malloc( pPager->
7340: 64 62 53 69 7a 65 2f 38 20 2b 20 31 20 29 3b 0a  dbSize/8 + 1 );.
7350: 20 20 20 20 69 66 28 20 70 50 61 67 65 72 2d 3e      if( pPager->
7360: 61 49 6e 4a 6f 75 72 6e 61 6c 3d 3d 30 20 29 7b  aInJournal==0 ){
7370: 0a 20 20 20 20 20 20 72 65 74 75 72 6e 20 53 51  .      return SQ
7380: 4c 49 54 45 5f 4e 4f 4d 45 4d 3b 0a 20 20 20 20  LITE_NOMEM;.    
7390: 7d 0a 20 20 20 20 72 63 20 3d 20 73 71 6c 69 74  }.    rc = sqlit
73a0: 65 4f 73 4f 70 65 6e 45 78 63 6c 75 73 69 76 65  eOsOpenExclusive
73b0: 28 70 50 61 67 65 72 2d 3e 7a 4a 6f 75 72 6e 61  (pPager->zJourna
73c0: 6c 2c 20 26 70 50 61 67 65 72 2d 3e 6a 66 64 29  l, &pPager->jfd)
73d0: 3b 0a 20 20 20 20 69 66 28 20 72 63 21 3d 53 51  ;.    if( rc!=SQ
73e0: 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 20  LITE_OK ){.     
73f0: 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 43   return SQLITE_C
7400: 41 4e 54 4f 50 45 4e 3b 0a 20 20 20 20 7d 0a 20  ANTOPEN;.    }. 
7410: 20 20 20 70 50 61 67 65 72 2d 3e 6a 6f 75 72 6e     pPager->journ
7420: 61 6c 4f 70 65 6e 20 3d 20 31 3b 0a 20 20 20 20  alOpen = 1;.    
7430: 70 50 61 67 65 72 2d 3e 6e 65 65 64 53 79 6e 63  pPager->needSync
7440: 20 3d 20 30 3b 0a 20 20 20 20 69 66 28 20 73 71   = 0;.    if( sq
7450: 6c 69 74 65 4f 73 4c 6f 63 6b 28 70 50 61 67 65  liteOsLock(pPage
7460: 72 2d 3e 6a 66 64 2c 20 31 29 21 3d 53 51 4c 49  r->jfd, 1)!=SQLI
7470: 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 20 20 73  TE_OK ){.      s
7480: 71 6c 69 74 65 4f 73 43 6c 6f 73 65 28 70 50 61  qliteOsClose(pPa
7490: 67 65 72 2d 3e 6a 66 64 29 3b 0a 20 20 20 20 20  ger->jfd);.     
74a0: 20 70 50 61 67 65 72 2d 3e 6a 6f 75 72 6e 61 6c   pPager->journal
74b0: 4f 70 65 6e 20 3d 20 30 3b 0a 20 20 20 20 20 20  Open = 0;.      
74c0: 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 42 55  return SQLITE_BU
74d0: 53 59 3b 0a 20 20 20 20 7d 0a 20 20 20 20 73 71  SY;.    }.    sq
74e0: 6c 69 74 65 4f 73 55 6e 6c 6f 63 6b 28 70 50 61  liteOsUnlock(pPa
74f0: 67 65 72 2d 3e 66 64 29 3b 0a 20 20 20 20 69 66  ger->fd);.    if
7500: 28 20 73 71 6c 69 74 65 4f 73 4c 6f 63 6b 28 70  ( sqliteOsLock(p
7510: 50 61 67 65 72 2d 3e 66 64 2c 20 31 29 21 3d 53  Pager->fd, 1)!=S
7520: 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20  QLITE_OK ){.    
7530: 20 20 73 71 6c 69 74 65 4f 73 43 6c 6f 73 65 28    sqliteOsClose(
7540: 70 50 61 67 65 72 2d 3e 6a 66 64 29 3b 0a 20 20  pPager->jfd);.  
7550: 20 20 20 20 70 50 61 67 65 72 2d 3e 6a 6f 75 72      pPager->jour
7560: 6e 61 6c 4f 70 65 6e 20 3d 20 30 3b 0a 20 20 20  nalOpen = 0;.   
7570: 20 20 20 70 50 61 67 65 72 2d 3e 73 74 61 74 65     pPager->state
7580: 20 3d 20 53 51 4c 49 54 45 5f 55 4e 4c 4f 43 4b   = SQLITE_UNLOCK
7590: 3b 0a 20 20 20 20 20 20 70 50 61 67 65 72 2d 3e  ;.      pPager->
75a0: 65 72 72 4d 61 73 6b 20 7c 3d 20 50 41 47 45 52  errMask |= PAGER
75b0: 5f 45 52 52 5f 4c 4f 43 4b 3b 0a 20 20 20 20 20  _ERR_LOCK;.     
75c0: 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 50   return SQLITE_P
75d0: 52 4f 54 4f 43 4f 4c 3b 0a 20 20 20 20 7d 0a 20  ROTOCOL;.    }. 
75e0: 20 20 20 70 50 61 67 65 72 2d 3e 73 74 61 74 65     pPager->state
75f0: 20 3d 20 53 51 4c 49 54 45 5f 57 52 49 54 45 4c   = SQLITE_WRITEL
7600: 4f 43 4b 3b 0a 20 20 20 20 73 71 6c 69 74 65 70  OCK;.    sqlitep
7610: 61 67 65 72 5f 70 61 67 65 63 6f 75 6e 74 28 70  ager_pagecount(p
7620: 50 61 67 65 72 29 3b 0a 20 20 20 20 70 50 61 67  Pager);.    pPag
7630: 65 72 2d 3e 6f 72 69 67 44 62 53 69 7a 65 20 3d  er->origDbSize =
7640: 20 70 50 61 67 65 72 2d 3e 64 62 53 69 7a 65 3b   pPager->dbSize;
7650: 0a 20 20 20 20 72 63 20 3d 20 73 71 6c 69 74 65  .    rc = sqlite
7660: 4f 73 57 72 69 74 65 28 70 50 61 67 65 72 2d 3e  OsWrite(pPager->
7670: 6a 66 64 2c 20 61 4a 6f 75 72 6e 61 6c 4d 61 67  jfd, aJournalMag
7680: 69 63 2c 20 73 69 7a 65 6f 66 28 61 4a 6f 75 72  ic, sizeof(aJour
7690: 6e 61 6c 4d 61 67 69 63 29 29 3b 0a 20 20 20 20  nalMagic));.    
76a0: 69 66 28 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4f  if( rc==SQLITE_O
76b0: 4b 20 29 7b 0a 20 20 20 20 20 20 72 63 20 3d 20  K ){.      rc = 
76c0: 73 71 6c 69 74 65 4f 73 57 72 69 74 65 28 70 50  sqliteOsWrite(pP
76d0: 61 67 65 72 2d 3e 6a 66 64 2c 20 26 70 50 61 67  ager->jfd, &pPag
76e0: 65 72 2d 3e 64 62 53 69 7a 65 2c 20 73 69 7a 65  er->dbSize, size
76f0: 6f 66 28 50 67 6e 6f 29 29 3b 0a 20 20 20 20 7d  of(Pgno));.    }
7700: 0a 20 20 20 20 69 66 28 20 72 63 21 3d 53 51 4c  .    if( rc!=SQL
7710: 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 20 20  ITE_OK ){.      
7720: 72 63 20 3d 20 70 61 67 65 72 5f 75 6e 77 72 69  rc = pager_unwri
7730: 74 65 6c 6f 63 6b 28 70 50 61 67 65 72 29 3b 0a  telock(pPager);.
7740: 20 20 20 20 20 20 69 66 28 20 72 63 3d 3d 53 51        if( rc==SQ
7750: 4c 49 54 45 5f 4f 4b 20 29 20 72 63 20 3d 20 53  LITE_OK ) rc = S
7760: 51 4c 49 54 45 5f 46 55 4c 4c 3b 0a 20 20 20 20  QLITE_FULL;.    
7770: 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 20 20 20    return rc;.   
7780: 20 7d 0a 20 20 7d 0a 20 20 61 73 73 65 72 74 28   }.  }.  assert(
7790: 20 70 50 61 67 65 72 2d 3e 73 74 61 74 65 3d 3d   pPager->state==
77a0: 53 51 4c 49 54 45 5f 57 52 49 54 45 4c 4f 43 4b  SQLITE_WRITELOCK
77b0: 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 70 50   );.  assert( pP
77c0: 61 67 65 72 2d 3e 6a 6f 75 72 6e 61 6c 4f 70 65  ager->journalOpe
77d0: 6e 20 29 3b 0a 20 20 69 66 28 20 70 50 67 2d 3e  n );.  if( pPg->
77e0: 70 67 6e 6f 20 3c 3d 20 70 50 61 67 65 72 2d 3e  pgno <= pPager->
77f0: 6f 72 69 67 44 62 53 69 7a 65 20 29 7b 0a 20 20  origDbSize ){.  
7800: 20 20 72 63 20 3d 20 73 71 6c 69 74 65 4f 73 57    rc = sqliteOsW
7810: 72 69 74 65 28 70 50 61 67 65 72 2d 3e 6a 66 64  rite(pPager->jfd
7820: 2c 20 26 70 50 67 2d 3e 70 67 6e 6f 2c 20 73 69  , &pPg->pgno, si
7830: 7a 65 6f 66 28 50 67 6e 6f 29 29 3b 0a 20 20 20  zeof(Pgno));.   
7840: 20 69 66 28 20 72 63 3d 3d 53 51 4c 49 54 45 5f   if( rc==SQLITE_
7850: 4f 4b 20 29 7b 0a 20 20 20 20 20 20 72 63 20 3d  OK ){.      rc =
7860: 20 73 71 6c 69 74 65 4f 73 57 72 69 74 65 28 70   sqliteOsWrite(p
7870: 50 61 67 65 72 2d 3e 6a 66 64 2c 20 70 44 61 74  Pager->jfd, pDat
7880: 61 2c 20 53 51 4c 49 54 45 5f 50 41 47 45 5f 53  a, SQLITE_PAGE_S
7890: 49 5a 45 29 3b 0a 20 20 20 20 7d 0a 20 20 20 20  IZE);.    }.    
78a0: 69 66 28 20 72 63 21 3d 53 51 4c 49 54 45 5f 4f  if( rc!=SQLITE_O
78b0: 4b 20 29 7b 0a 20 20 20 20 20 20 73 71 6c 69 74  K ){.      sqlit
78c0: 65 70 61 67 65 72 5f 72 6f 6c 6c 62 61 63 6b 28  epager_rollback(
78d0: 70 50 61 67 65 72 29 3b 0a 20 20 20 20 20 20 70  pPager);.      p
78e0: 50 61 67 65 72 2d 3e 65 72 72 4d 61 73 6b 20 7c  Pager->errMask |
78f0: 3d 20 50 41 47 45 52 5f 45 52 52 5f 46 55 4c 4c  = PAGER_ERR_FULL
7900: 3b 0a 20 20 20 20 20 20 72 65 74 75 72 6e 20 72  ;.      return r
7910: 63 3b 0a 20 20 20 20 7d 0a 20 20 20 20 61 73 73  c;.    }.    ass
7920: 65 72 74 28 20 70 50 61 67 65 72 2d 3e 61 49 6e  ert( pPager->aIn
7930: 4a 6f 75 72 6e 61 6c 21 3d 30 20 29 3b 0a 20 20  Journal!=0 );.  
7940: 20 20 70 50 61 67 65 72 2d 3e 61 49 6e 4a 6f 75    pPager->aInJou
7950: 72 6e 61 6c 5b 70 50 67 2d 3e 70 67 6e 6f 2f 38  rnal[pPg->pgno/8
7960: 5d 20 7c 3d 20 31 3c 3c 28 70 50 67 2d 3e 70 67  ] |= 1<<(pPg->pg
7970: 6e 6f 26 37 29 3b 0a 20 20 20 20 70 50 61 67 65  no&7);.    pPage
7980: 72 2d 3e 6e 65 65 64 53 79 6e 63 20 3d 20 31 3b  r->needSync = 1;
7990: 0a 20 20 7d 0a 20 20 70 50 67 2d 3e 69 6e 4a 6f  .  }.  pPg->inJo
79a0: 75 72 6e 61 6c 20 3d 20 31 3b 0a 20 20 69 66 28  urnal = 1;.  if(
79b0: 20 70 50 61 67 65 72 2d 3e 64 62 53 69 7a 65 3c   pPager->dbSize<
79c0: 70 50 67 2d 3e 70 67 6e 6f 20 29 7b 0a 20 20 20  pPg->pgno ){.   
79d0: 20 70 50 61 67 65 72 2d 3e 64 62 53 69 7a 65 20   pPager->dbSize 
79e0: 3d 20 70 50 67 2d 3e 70 67 6e 6f 3b 0a 20 20 7d  = pPg->pgno;.  }
79f0: 0a 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 7d 0a  .  return rc;.}.
7a00: 0a 2f 2a 0a 2a 2a 20 52 65 74 75 72 6e 20 54 52  ./*.** Return TR
7a10: 55 45 20 69 66 20 74 68 65 20 70 61 67 65 20 67  UE if the page g
7a20: 69 76 65 6e 20 69 6e 20 74 68 65 20 61 72 67 75  iven in the argu
7a30: 6d 65 6e 74 20 77 61 73 20 70 72 65 76 69 6f 75  ment was previou
7a40: 73 20 70 61 73 73 65 64 0a 2a 2a 20 74 6f 20 73  s passed.** to s
7a50: 71 6c 69 74 65 70 61 67 65 72 5f 77 72 69 74 65  qlitepager_write
7a60: 28 29 2e 20 20 49 6e 20 6f 74 68 65 72 20 77 6f  ().  In other wo
7a70: 72 64 73 2c 20 72 65 74 75 72 6e 20 54 52 55 45  rds, return TRUE
7a80: 20 69 66 20 69 74 20 69 73 20 6f 6b 0a 2a 2a 20   if it is ok.** 
7a90: 74 6f 20 63 68 61 6e 67 65 20 74 68 65 20 63 6f  to change the co
7aa0: 6e 74 65 6e 74 20 6f 66 20 74 68 65 20 70 61 67  ntent of the pag
7ab0: 65 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65  e..*/.int sqlite
7ac0: 70 61 67 65 72 5f 69 73 77 72 69 74 65 61 62 6c  pager_iswriteabl
7ad0: 65 28 76 6f 69 64 20 2a 70 44 61 74 61 29 7b 0a  e(void *pData){.
7ae0: 20 20 50 67 48 64 72 20 2a 70 50 67 20 3d 20 44    PgHdr *pPg = D
7af0: 41 54 41 5f 54 4f 5f 50 47 48 44 52 28 70 44 61  ATA_TO_PGHDR(pDa
7b00: 74 61 29 3b 0a 20 20 72 65 74 75 72 6e 20 70 50  ta);.  return pP
7b10: 67 2d 3e 64 69 72 74 79 3b 0a 7d 0a 0a 2f 2a 0a  g->dirty;.}../*.
7b20: 2a 2a 20 43 6f 6d 6d 69 74 20 61 6c 6c 20 63 68  ** Commit all ch
7b30: 61 6e 67 65 73 20 74 6f 20 74 68 65 20 64 61 74  anges to the dat
7b40: 61 62 61 73 65 20 61 6e 64 20 72 65 6c 65 61 73  abase and releas
7b50: 65 20 74 68 65 20 77 72 69 74 65 20 6c 6f 63 6b  e the write lock
7b60: 2e 0a 2a 2a 0a 2a 2a 20 49 66 20 74 68 65 20 63  ..**.** If the c
7b70: 6f 6d 6d 69 74 20 66 61 69 6c 73 20 66 6f 72 20  ommit fails for 
7b80: 61 6e 79 20 72 65 61 73 6f 6e 2c 20 61 20 72 6f  any reason, a ro
7b90: 6c 6c 62 61 63 6b 20 61 74 74 65 6d 70 74 20 69  llback attempt i
7ba0: 73 20 6d 61 64 65 0a 2a 2a 20 61 6e 64 20 61 6e  s made.** and an
7bb0: 20 65 72 72 6f 72 20 63 6f 64 65 20 69 73 20 72   error code is r
7bc0: 65 74 75 72 6e 65 64 2e 20 20 49 66 20 74 68 65  eturned.  If the
7bd0: 20 63 6f 6d 6d 69 74 20 77 6f 72 6b 65 64 2c 20   commit worked, 
7be0: 53 51 4c 49 54 45 5f 4f 4b 0a 2a 2a 20 69 73 20  SQLITE_OK.** is 
7bf0: 72 65 74 75 72 6e 65 64 2e 0a 2a 2f 0a 69 6e 74  returned..*/.int
7c00: 20 73 71 6c 69 74 65 70 61 67 65 72 5f 63 6f 6d   sqlitepager_com
7c10: 6d 69 74 28 50 61 67 65 72 20 2a 70 50 61 67 65  mit(Pager *pPage
7c20: 72 29 7b 0a 20 20 69 6e 74 20 72 63 3b 0a 20 20  r){.  int rc;.  
7c30: 50 67 48 64 72 20 2a 70 50 67 3b 0a 0a 20 20 69  PgHdr *pPg;..  i
7c40: 66 28 20 70 50 61 67 65 72 2d 3e 65 72 72 4d 61  f( pPager->errMa
7c50: 73 6b 3d 3d 50 41 47 45 52 5f 45 52 52 5f 46 55  sk==PAGER_ERR_FU
7c60: 4c 4c 20 29 7b 0a 20 20 20 20 72 63 20 3d 20 73  LL ){.    rc = s
7c70: 71 6c 69 74 65 70 61 67 65 72 5f 72 6f 6c 6c 62  qlitepager_rollb
7c80: 61 63 6b 28 70 50 61 67 65 72 29 3b 0a 20 20 20  ack(pPager);.   
7c90: 20 69 66 28 20 72 63 3d 3d 53 51 4c 49 54 45 5f   if( rc==SQLITE_
7ca0: 4f 4b 20 29 20 72 63 20 3d 20 53 51 4c 49 54 45  OK ) rc = SQLITE
7cb0: 5f 46 55 4c 4c 3b 0a 20 20 20 20 72 65 74 75 72  _FULL;.    retur
7cc0: 6e 20 72 63 3b 0a 20 20 7d 0a 20 20 69 66 28 20  n rc;.  }.  if( 
7cd0: 70 50 61 67 65 72 2d 3e 65 72 72 4d 61 73 6b 21  pPager->errMask!
7ce0: 3d 30 20 29 7b 0a 20 20 20 20 72 63 20 3d 20 70  =0 ){.    rc = p
7cf0: 61 67 65 72 5f 65 72 72 63 6f 64 65 28 70 50 61  ager_errcode(pPa
7d00: 67 65 72 29 3b 0a 20 20 20 20 72 65 74 75 72 6e  ger);.    return
7d10: 20 72 63 3b 0a 20 20 7d 0a 20 20 69 66 28 20 70   rc;.  }.  if( p
7d20: 50 61 67 65 72 2d 3e 73 74 61 74 65 21 3d 53 51  Pager->state!=SQ
7d30: 4c 49 54 45 5f 57 52 49 54 45 4c 4f 43 4b 20 29  LITE_WRITELOCK )
7d40: 7b 0a 20 20 20 20 72 65 74 75 72 6e 20 53 51 4c  {.    return SQL
7d50: 49 54 45 5f 45 52 52 4f 52 3b 0a 20 20 7d 0a 20  ITE_ERROR;.  }. 
7d60: 20 61 73 73 65 72 74 28 20 70 50 61 67 65 72 2d   assert( pPager-
7d70: 3e 6a 6f 75 72 6e 61 6c 4f 70 65 6e 20 29 3b 0a  >journalOpen );.
7d80: 20 20 69 66 28 20 70 50 61 67 65 72 2d 3e 6e 65    if( pPager->ne
7d90: 65 64 53 79 6e 63 20 26 26 20 73 71 6c 69 74 65  edSync && sqlite
7da0: 4f 73 53 79 6e 63 28 70 50 61 67 65 72 2d 3e 6a  OsSync(pPager->j
7db0: 66 64 29 21 3d 53 51 4c 49 54 45 5f 4f 4b 20 29  fd)!=SQLITE_OK )
7dc0: 7b 0a 20 20 20 20 67 6f 74 6f 20 63 6f 6d 6d 69  {.    goto commi
7dd0: 74 5f 61 62 6f 72 74 3b 0a 20 20 7d 0a 20 20 66  t_abort;.  }.  f
7de0: 6f 72 28 70 50 67 3d 70 50 61 67 65 72 2d 3e 70  or(pPg=pPager->p
7df0: 41 6c 6c 3b 20 70 50 67 3b 20 70 50 67 3d 70 50  All; pPg; pPg=pP
7e00: 67 2d 3e 70 4e 65 78 74 41 6c 6c 29 7b 0a 20 20  g->pNextAll){.  
7e10: 20 20 69 66 28 20 70 50 67 2d 3e 64 69 72 74 79    if( pPg->dirty
7e20: 3d 3d 30 20 29 20 63 6f 6e 74 69 6e 75 65 3b 0a  ==0 ) continue;.
7e30: 20 20 20 20 72 63 20 3d 20 73 71 6c 69 74 65 4f      rc = sqliteO
7e40: 73 53 65 65 6b 28 70 50 61 67 65 72 2d 3e 66 64  sSeek(pPager->fd
7e50: 2c 20 28 70 50 67 2d 3e 70 67 6e 6f 2d 31 29 2a  , (pPg->pgno-1)*
7e60: 53 51 4c 49 54 45 5f 50 41 47 45 5f 53 49 5a 45  SQLITE_PAGE_SIZE
7e70: 29 3b 0a 20 20 20 20 69 66 28 20 72 63 21 3d 53  );.    if( rc!=S
7e80: 51 4c 49 54 45 5f 4f 4b 20 29 20 67 6f 74 6f 20  QLITE_OK ) goto 
7e90: 63 6f 6d 6d 69 74 5f 61 62 6f 72 74 3b 0a 20 20  commit_abort;.  
7ea0: 20 20 72 63 20 3d 20 73 71 6c 69 74 65 4f 73 57    rc = sqliteOsW
7eb0: 72 69 74 65 28 70 50 61 67 65 72 2d 3e 66 64 2c  rite(pPager->fd,
7ec0: 20 50 47 48 44 52 5f 54 4f 5f 44 41 54 41 28 70   PGHDR_TO_DATA(p
7ed0: 50 67 29 2c 20 53 51 4c 49 54 45 5f 50 41 47 45  Pg), SQLITE_PAGE
7ee0: 5f 53 49 5a 45 29 3b 0a 20 20 20 20 69 66 28 20  _SIZE);.    if( 
7ef0: 72 63 21 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 20  rc!=SQLITE_OK ) 
7f00: 67 6f 74 6f 20 63 6f 6d 6d 69 74 5f 61 62 6f 72  goto commit_abor
7f10: 74 3b 0a 20 20 7d 0a 20 20 69 66 28 20 73 71 6c  t;.  }.  if( sql
7f20: 69 74 65 4f 73 53 79 6e 63 28 70 50 61 67 65 72  iteOsSync(pPager
7f30: 2d 3e 66 64 29 21 3d 53 51 4c 49 54 45 5f 4f 4b  ->fd)!=SQLITE_OK
7f40: 20 29 20 67 6f 74 6f 20 63 6f 6d 6d 69 74 5f 61   ) goto commit_a
7f50: 62 6f 72 74 3b 0a 20 20 72 63 20 3d 20 70 61 67  bort;.  rc = pag
7f60: 65 72 5f 75 6e 77 72 69 74 65 6c 6f 63 6b 28 70  er_unwritelock(p
7f70: 50 61 67 65 72 29 3b 0a 20 20 70 50 61 67 65 72  Pager);.  pPager
7f80: 2d 3e 64 62 53 69 7a 65 20 3d 20 2d 31 3b 0a 20  ->dbSize = -1;. 
7f90: 20 72 65 74 75 72 6e 20 72 63 3b 0a 0a 20 20 2f   return rc;..  /
7fa0: 2a 20 4a 75 6d 70 20 68 65 72 65 20 69 66 20 61  * Jump here if a
7fb0: 6e 79 74 68 69 6e 67 20 67 6f 65 73 20 77 72 6f  nything goes wro
7fc0: 6e 67 20 64 75 72 69 6e 67 20 74 68 65 20 63 6f  ng during the co
7fd0: 6d 6d 69 74 20 70 72 6f 63 65 73 73 2e 0a 20 20  mmit process..  
7fe0: 2a 2f 0a 63 6f 6d 6d 69 74 5f 61 62 6f 72 74 3a  */.commit_abort:
7ff0: 0a 20 20 72 63 20 3d 20 73 71 6c 69 74 65 70 61  .  rc = sqlitepa
8000: 67 65 72 5f 72 6f 6c 6c 62 61 63 6b 28 70 50 61  ger_rollback(pPa
8010: 67 65 72 29 3b 0a 20 20 69 66 28 20 72 63 3d 3d  ger);.  if( rc==
8020: 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20  SQLITE_OK ){.   
8030: 20 72 63 20 3d 20 53 51 4c 49 54 45 5f 46 55 4c   rc = SQLITE_FUL
8040: 4c 3b 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e 20  L;.  }.  return 
8050: 72 63 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 52 6f 6c  rc;.}../*.** Rol
8060: 6c 62 61 63 6b 20 61 6c 6c 20 63 68 61 6e 67 65  lback all change
8070: 73 2e 20 20 54 68 65 20 64 61 74 61 62 61 73 65  s.  The database
8080: 20 66 61 6c 6c 73 20 62 61 63 6b 20 74 6f 20 72   falls back to r
8090: 65 61 64 2d 6f 6e 6c 79 20 6d 6f 64 65 2e 0a 2a  ead-only mode..*
80a0: 2a 20 41 6c 6c 20 69 6e 2d 6d 65 6d 6f 72 79 20  * All in-memory 
80b0: 63 61 63 68 65 20 70 61 67 65 73 20 72 65 76 65  cache pages reve
80c0: 72 74 20 74 6f 20 74 68 65 69 72 20 6f 72 69 67  rt to their orig
80d0: 69 6e 61 6c 20 64 61 74 61 20 63 6f 6e 74 65 6e  inal data conten
80e0: 74 73 2e 0a 2a 2a 20 54 68 65 20 6a 6f 75 72 6e  ts..** The journ
80f0: 61 6c 20 69 73 20 64 65 6c 65 74 65 64 2e 0a 2a  al is deleted..*
8100: 2a 0a 2a 2a 20 54 68 69 73 20 72 6f 75 74 69 6e  *.** This routin
8110: 65 20 63 61 6e 6e 6f 74 20 66 61 69 6c 20 75 6e  e cannot fail un
8120: 6c 65 73 73 20 73 6f 6d 65 20 6f 74 68 65 72 20  less some other 
8130: 70 72 6f 63 65 73 73 20 69 73 20 6e 6f 74 20 66  process is not f
8140: 6f 6c 6c 6f 77 69 6e 67 0a 2a 2a 20 74 68 65 20  ollowing.** the 
8150: 63 6f 72 72 65 63 74 20 6c 6f 63 6b 69 6e 67 20  correct locking 
8160: 70 72 6f 74 6f 63 6f 6c 20 28 53 51 4c 49 54 45  protocol (SQLITE
8170: 5f 50 52 4f 54 4f 43 4f 4c 29 20 6f 72 20 75 6e  _PROTOCOL) or un
8180: 6c 65 73 73 20 73 6f 6d 65 20 6f 74 68 65 72 0a  less some other.
8190: 2a 2a 20 70 72 6f 63 65 73 73 20 69 73 20 77 72  ** process is wr
81a0: 69 74 69 6e 67 20 74 72 61 73 68 20 69 6e 74 6f  iting trash into
81b0: 20 74 68 65 20 6a 6f 75 72 6e 61 6c 20 66 69 6c   the journal fil
81c0: 65 20 28 53 51 4c 49 54 45 5f 43 4f 52 52 55 50  e (SQLITE_CORRUP
81d0: 54 29 20 6f 72 0a 2a 2a 20 75 6e 6c 65 73 73 20  T) or.** unless 
81e0: 61 20 70 72 69 6f 72 20 6d 61 6c 6c 6f 63 28 29  a prior malloc()
81f0: 20 66 61 69 6c 65 64 20 28 53 51 4c 49 54 45 5f   failed (SQLITE_
8200: 4e 4f 4d 45 4d 29 2e 20 20 41 70 70 72 6f 70 72  NOMEM).  Appropr
8210: 69 61 74 65 20 65 72 72 6f 72 0a 2a 2a 20 63 6f  iate error.** co
8220: 64 65 73 20 61 72 65 20 72 65 74 75 72 6e 65 64  des are returned
8230: 20 66 6f 72 20 61 6c 6c 20 74 68 65 73 65 20 6f   for all these o
8240: 63 63 61 73 69 6f 6e 73 2e 20 20 4f 74 68 65 72  ccasions.  Other
8250: 77 69 73 65 2c 0a 2a 2a 20 53 51 4c 49 54 45 5f  wise,.** SQLITE_
8260: 4f 4b 20 69 73 20 72 65 74 75 72 6e 65 64 2e 0a  OK is returned..
8270: 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 70 61 67  */.int sqlitepag
8280: 65 72 5f 72 6f 6c 6c 62 61 63 6b 28 50 61 67 65  er_rollback(Page
8290: 72 20 2a 70 50 61 67 65 72 29 7b 0a 20 20 69 6e  r *pPager){.  in
82a0: 74 20 72 63 3b 0a 20 20 69 66 28 20 70 50 61 67  t rc;.  if( pPag
82b0: 65 72 2d 3e 65 72 72 4d 61 73 6b 21 3d 30 20 26  er->errMask!=0 &
82c0: 26 20 70 50 61 67 65 72 2d 3e 65 72 72 4d 61 73  & pPager->errMas
82d0: 6b 21 3d 50 41 47 45 52 5f 45 52 52 5f 46 55 4c  k!=PAGER_ERR_FUL
82e0: 4c 20 29 7b 0a 20 20 20 20 72 65 74 75 72 6e 20  L ){.    return 
82f0: 70 61 67 65 72 5f 65 72 72 63 6f 64 65 28 70 50  pager_errcode(pP
8300: 61 67 65 72 29 3b 0a 20 20 7d 0a 20 20 69 66 28  ager);.  }.  if(
8310: 20 70 50 61 67 65 72 2d 3e 73 74 61 74 65 21 3d   pPager->state!=
8320: 53 51 4c 49 54 45 5f 57 52 49 54 45 4c 4f 43 4b  SQLITE_WRITELOCK
8330: 20 29 7b 0a 20 20 20 20 72 65 74 75 72 6e 20 53   ){.    return S
8340: 51 4c 49 54 45 5f 4f 4b 3b 0a 20 20 7d 0a 20 20  QLITE_OK;.  }.  
8350: 72 63 20 3d 20 70 61 67 65 72 5f 70 6c 61 79 62  rc = pager_playb
8360: 61 63 6b 28 70 50 61 67 65 72 29 3b 0a 20 20 69  ack(pPager);.  i
8370: 66 28 20 72 63 21 3d 53 51 4c 49 54 45 5f 4f 4b  f( rc!=SQLITE_OK
8380: 20 29 7b 0a 20 20 20 20 72 63 20 3d 20 53 51 4c   ){.    rc = SQL
8390: 49 54 45 5f 43 4f 52 52 55 50 54 3b 0a 20 20 20  ITE_CORRUPT;.   
83a0: 20 70 50 61 67 65 72 2d 3e 65 72 72 4d 61 73 6b   pPager->errMask
83b0: 20 7c 3d 20 50 41 47 45 52 5f 45 52 52 5f 43 4f   |= PAGER_ERR_CO
83c0: 52 52 55 50 54 3b 0a 20 20 7d 0a 20 20 70 50 61  RRUPT;.  }.  pPa
83d0: 67 65 72 2d 3e 64 62 53 69 7a 65 20 3d 20 2d 31  ger->dbSize = -1
83e0: 3b 0a 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 7d  ;.  return rc;.}
83f0: 3b 0a 0a 2f 2a 0a 2a 2a 20 52 65 74 75 72 6e 20  ;../*.** Return 
8400: 54 52 55 45 20 69 66 20 74 68 65 20 64 61 74 61  TRUE if the data
8410: 62 61 73 65 20 66 69 6c 65 20 69 73 20 6f 70 65  base file is ope
8420: 6e 65 64 20 72 65 61 64 2d 6f 6e 6c 79 2e 20 20  ned read-only.  
8430: 52 65 74 75 72 6e 20 46 41 4c 53 45 0a 2a 2a 20  Return FALSE.** 
8440: 69 66 20 74 68 65 20 64 61 74 61 62 61 73 65 20  if the database 
8450: 69 73 20 28 69 6e 20 74 68 65 6f 72 79 29 20 77  is (in theory) w
8460: 72 69 74 61 62 6c 65 2e 0a 2a 2f 0a 69 6e 74 20  ritable..*/.int 
8470: 73 71 6c 69 74 65 70 61 67 65 72 5f 69 73 72 65  sqlitepager_isre
8480: 61 64 6f 6e 6c 79 28 50 61 67 65 72 20 2a 70 50  adonly(Pager *pP
8490: 61 67 65 72 29 7b 0a 20 20 72 65 74 75 72 6e 20  ager){.  return 
84a0: 70 50 61 67 65 72 2d 3e 72 65 61 64 4f 6e 6c 79  pPager->readOnly
84b0: 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 54 68 69 73 20  ;.}../*.** This 
84c0: 72 6f 75 74 69 6e 65 20 69 73 20 75 73 65 64 20  routine is used 
84d0: 66 6f 72 20 74 65 73 74 69 6e 67 20 61 6e 64 20  for testing and 
84e0: 61 6e 61 6c 79 73 69 73 20 6f 6e 6c 79 2e 0a 2a  analysis only..*
84f0: 2f 0a 69 6e 74 20 2a 73 71 6c 69 74 65 70 61 67  /.int *sqlitepag
8500: 65 72 5f 73 74 61 74 73 28 50 61 67 65 72 20 2a  er_stats(Pager *
8510: 70 50 61 67 65 72 29 7b 0a 20 20 73 74 61 74 69  pPager){.  stati
8520: 63 20 69 6e 74 20 61 5b 39 5d 3b 0a 20 20 61 5b  c int a[9];.  a[
8530: 30 5d 20 3d 20 70 50 61 67 65 72 2d 3e 6e 52 65  0] = pPager->nRe
8540: 66 3b 0a 20 20 61 5b 31 5d 20 3d 20 70 50 61 67  f;.  a[1] = pPag
8550: 65 72 2d 3e 6e 50 61 67 65 3b 0a 20 20 61 5b 32  er->nPage;.  a[2
8560: 5d 20 3d 20 70 50 61 67 65 72 2d 3e 6d 78 50 61  ] = pPager->mxPa
8570: 67 65 3b 0a 20 20 61 5b 33 5d 20 3d 20 70 50 61  ge;.  a[3] = pPa
8580: 67 65 72 2d 3e 64 62 53 69 7a 65 3b 0a 20 20 61  ger->dbSize;.  a
8590: 5b 34 5d 20 3d 20 70 50 61 67 65 72 2d 3e 73 74  [4] = pPager->st
85a0: 61 74 65 3b 0a 20 20 61 5b 35 5d 20 3d 20 70 50  ate;.  a[5] = pP
85b0: 61 67 65 72 2d 3e 65 72 72 4d 61 73 6b 3b 0a 20  ager->errMask;. 
85c0: 20 61 5b 36 5d 20 3d 20 70 50 61 67 65 72 2d 3e   a[6] = pPager->
85d0: 6e 48 69 74 3b 0a 20 20 61 5b 37 5d 20 3d 20 70  nHit;.  a[7] = p
85e0: 50 61 67 65 72 2d 3e 6e 4d 69 73 73 3b 0a 20 20  Pager->nMiss;.  
85f0: 61 5b 38 5d 20 3d 20 70 50 61 67 65 72 2d 3e 6e  a[8] = pPager->n
8600: 4f 76 66 6c 3b 0a 20 20 72 65 74 75 72 6e 20 61  Ovfl;.  return a
8610: 3b 0a 7d 0a 0a 23 69 66 20 53 51 4c 49 54 45 5f  ;.}..#if SQLITE_
8620: 54 45 53 54 0a 2f 2a 0a 2a 2a 20 50 72 69 6e 74  TEST./*.** Print
8630: 20 61 20 6c 69 73 74 69 6e 67 20 6f 66 20 61 6c   a listing of al
8640: 6c 20 72 65 66 65 72 65 6e 63 65 64 20 70 61 67  l referenced pag
8650: 65 73 20 61 6e 64 20 74 68 65 69 72 20 72 65 66  es and their ref
8660: 20 63 6f 75 6e 74 2e 0a 2a 2f 0a 76 6f 69 64 20   count..*/.void 
8670: 73 71 6c 69 74 65 70 61 67 65 72 5f 72 65 66 64  sqlitepager_refd
8680: 75 6d 70 28 50 61 67 65 72 20 2a 70 50 61 67 65  ump(Pager *pPage
8690: 72 29 7b 0a 20 20 50 67 48 64 72 20 2a 70 50 67  r){.  PgHdr *pPg
86a0: 3b 0a 20 20 66 6f 72 28 70 50 67 3d 70 50 61 67  ;.  for(pPg=pPag
86b0: 65 72 2d 3e 70 41 6c 6c 3b 20 70 50 67 3b 20 70  er->pAll; pPg; p
86c0: 50 67 3d 70 50 67 2d 3e 70 4e 65 78 74 41 6c 6c  Pg=pPg->pNextAll
86d0: 29 7b 0a 20 20 20 20 69 66 28 20 70 50 67 2d 3e  ){.    if( pPg->
86e0: 6e 52 65 66 3c 3d 30 20 29 20 63 6f 6e 74 69 6e  nRef<=0 ) contin
86f0: 75 65 3b 0a 20 20 20 20 70 72 69 6e 74 66 28 22  ue;.    printf("
8700: 50 41 47 45 20 25 33 64 20 61 64 64 72 3d 30 78  PAGE %3d addr=0x
8710: 25 30 38 78 20 6e 52 65 66 3d 25 64 5c 6e 22 2c  %08x nRef=%d\n",
8720: 20 0a 20 20 20 20 20 20 20 70 50 67 2d 3e 70 67   .       pPg->pg
8730: 6e 6f 2c 20 28 69 6e 74 29 50 47 48 44 52 5f 54  no, (int)PGHDR_T
8740: 4f 5f 44 41 54 41 28 70 50 67 29 2c 20 70 50 67  O_DATA(pPg), pPg
8750: 2d 3e 6e 52 65 66 29 3b 0a 20 20 7d 0a 7d 0a 23  ->nRef);.  }.}.#
8760: 65 6e 64 69 66 0a                                endif.