/ Hex Artifact Content
Login

Artifact a39908e73cf5001dec2cc7a55a477fe8e8611db9:


0000: 2f 2a 0a 2a 2a 20 32 30 30 38 20 41 75 67 75 73  /*.** 2008 Augus
0010: 74 20 30 35 0a 2a 2a 0a 2a 2a 20 54 68 65 20 61  t 05.**.** The a
0020: 75 74 68 6f 72 20 64 69 73 63 6c 61 69 6d 73 20  uthor disclaims 
0030: 63 6f 70 79 72 69 67 68 74 20 74 6f 20 74 68 69  copyright to thi
0040: 73 20 73 6f 75 72 63 65 20 63 6f 64 65 2e 20 20  s source code.  
0050: 49 6e 20 70 6c 61 63 65 20 6f 66 0a 2a 2a 20 61  In place of.** a
0060: 20 6c 65 67 61 6c 20 6e 6f 74 69 63 65 2c 20 68   legal notice, h
0070: 65 72 65 20 69 73 20 61 20 62 6c 65 73 73 69 6e  ere is a blessin
0080: 67 3a 0a 2a 2a 0a 2a 2a 20 20 20 20 4d 61 79 20  g:.**.**    May 
0090: 79 6f 75 20 64 6f 20 67 6f 6f 64 20 61 6e 64 20  you do good and 
00a0: 6e 6f 74 20 65 76 69 6c 2e 0a 2a 2a 20 20 20 20  not evil..**    
00b0: 4d 61 79 20 79 6f 75 20 66 69 6e 64 20 66 6f 72  May you find for
00c0: 67 69 76 65 6e 65 73 73 20 66 6f 72 20 79 6f 75  giveness for you
00d0: 72 73 65 6c 66 20 61 6e 64 20 66 6f 72 67 69 76  rself and forgiv
00e0: 65 20 6f 74 68 65 72 73 2e 0a 2a 2a 20 20 20 20  e others..**    
00f0: 4d 61 79 20 79 6f 75 20 73 68 61 72 65 20 66 72  May you share fr
0100: 65 65 6c 79 2c 20 6e 65 76 65 72 20 74 61 6b 69  eely, never taki
0110: 6e 67 20 6d 6f 72 65 20 74 68 61 6e 20 79 6f 75  ng more than you
0120: 20 67 69 76 65 2e 0a 2a 2a 0a 2a 2a 2a 2a 2a 2a   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 0a 2a 2a 20 54 68 69 73 20 66 69 6c 65  ***.** This file
0180: 20 69 6d 70 6c 65 6d 65 6e 74 73 20 74 68 61 74   implements that
0190: 20 70 61 67 65 20 63 61 63 68 65 2e 0a 2a 2a 0a   page cache..**.
01a0: 2a 2a 20 40 28 23 29 20 24 49 64 3a 20 70 63 61  ** @(#) $Id: pca
01b0: 63 68 65 2e 63 2c 76 20 31 2e 32 38 20 32 30 30  che.c,v 1.28 200
01c0: 38 2f 30 39 2f 31 37 20 31 31 3a 30 32 3a 35 37  8/09/17 11:02:57
01d0: 20 64 61 6e 69 65 6c 6b 31 39 37 37 20 45 78 70   danielk1977 Exp
01e0: 20 24 0a 2a 2f 0a 23 69 6e 63 6c 75 64 65 20 22   $.*/.#include "
01f0: 73 71 6c 69 74 65 49 6e 74 2e 68 22 0a 0a 2f 2a  sqliteInt.h"../*
0200: 0a 2a 2a 20 41 20 63 6f 6d 70 6c 65 74 65 20 70  .** A complete p
0210: 61 67 65 20 63 61 63 68 65 20 69 73 20 61 6e 20  age cache is an 
0220: 69 6e 73 74 61 6e 63 65 20 6f 66 20 74 68 69 73  instance of this
0230: 20 73 74 72 75 63 74 75 72 65 2e 0a 2a 2a 0a 2a   structure..**.*
0240: 2a 20 41 20 63 61 63 68 65 20 6d 61 79 20 6f 6e  * A cache may on
0250: 6c 79 20 62 65 20 64 65 6c 65 74 65 64 20 62 79  ly be deleted by
0260: 20 69 74 73 20 6f 77 6e 65 72 20 61 6e 64 20 77   its owner and w
0270: 68 69 6c 65 20 68 6f 6c 64 69 6e 67 20 74 68 65  hile holding the
0280: 0a 2a 2a 20 53 51 4c 49 54 45 5f 4d 55 54 45 58  .** SQLITE_MUTEX
0290: 5f 53 54 41 54 55 53 5f 4c 52 55 20 6d 75 74 65  _STATUS_LRU mute
02a0: 78 2e 0a 2a 2f 0a 73 74 72 75 63 74 20 50 43 61  x..*/.struct PCa
02b0: 63 68 65 20 7b 0a 20 20 2f 2a 2a 2a 2a 2a 2a 2a  che {.  /*******
02c0: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
02d0: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
02e0: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
02f0: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 0a 20  **************. 
0300: 20 2a 2a 20 54 68 65 20 66 69 72 73 74 20 67 72   ** The first gr
0310: 6f 75 70 20 6f 66 20 65 6c 65 6d 65 6e 74 73 20  oup of elements 
0320: 6d 61 79 20 62 65 20 72 65 61 64 20 6f 72 20 77  may be read or w
0330: 72 69 74 74 65 6e 20 61 74 20 61 6e 79 20 74 69  ritten at any ti
0340: 6d 65 20 62 79 0a 20 20 2a 2a 20 74 68 65 20 63  me by.  ** the c
0350: 61 63 68 65 20 6f 77 6e 65 72 20 77 69 74 68 6f  ache owner witho
0360: 75 74 20 68 6f 6c 64 69 6e 67 20 74 68 65 20 6d  ut holding the m
0370: 75 74 65 78 2e 20 20 4e 6f 20 74 68 72 65 61 64  utex.  No thread
0380: 20 6f 74 68 65 72 20 74 68 61 6e 20 74 68 65 0a   other than the.
0390: 20 20 2a 2a 20 63 61 63 68 65 20 6f 77 6e 65 72    ** cache owner
03a0: 20 69 73 20 70 65 72 6d 69 74 74 65 64 20 74 6f   is permitted to
03b0: 20 61 63 63 65 73 73 20 74 68 65 73 65 20 65 6c   access these el
03c0: 65 6d 65 6e 74 73 20 61 74 20 61 6e 79 20 74 69  ements at any ti
03d0: 6d 65 2e 0a 20 20 2a 2f 0a 20 20 50 67 48 64 72  me..  */.  PgHdr
03e0: 20 2a 70 44 69 72 74 79 2c 20 2a 70 44 69 72 74   *pDirty, *pDirt
03f0: 79 54 61 69 6c 3b 20 20 20 20 20 20 20 20 20 2f  yTail;         /
0400: 2a 20 4c 69 73 74 20 6f 66 20 64 69 72 74 79 20  * List of dirty 
0410: 70 61 67 65 73 20 69 6e 20 4c 52 55 20 6f 72 64  pages in LRU ord
0420: 65 72 20 2a 2f 0a 20 20 50 67 48 64 72 20 2a 70  er */.  PgHdr *p
0430: 53 79 6e 63 65 64 3b 20 20 20 20 20 20 20 20 20  Synced;         
0440: 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4c              /* L
0450: 61 73 74 20 73 79 6e 63 65 64 20 70 61 67 65 20  ast synced page 
0460: 69 6e 20 64 69 72 74 79 20 70 61 67 65 20 6c 69  in dirty page li
0470: 73 74 20 2a 2f 0a 20 20 69 6e 74 20 6e 52 65 66  st */.  int nRef
0480: 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20  ;               
0490: 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4e              /* N
04a0: 75 6d 62 65 72 20 6f 66 20 70 69 6e 6e 65 64 20  umber of pinned 
04b0: 70 61 67 65 73 20 2a 2f 0a 20 20 69 6e 74 20 6e  pages */.  int n
04c0: 50 69 6e 6e 65 64 3b 20 20 20 20 20 20 20 20 20  Pinned;         
04d0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f                 /
04e0: 2a 20 4e 75 6d 62 65 72 20 6f 66 20 70 69 6e 6e  * Number of pinn
04f0: 65 64 20 61 6e 64 2f 6f 72 20 64 69 72 74 79 20  ed and/or dirty 
0500: 70 61 67 65 73 20 2a 2f 0a 20 20 69 6e 74 20 6e  pages */.  int n
0510: 4d 61 78 3b 20 20 20 20 20 20 20 20 20 20 20 20  Max;            
0520: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f                 /
0530: 2a 20 43 6f 6e 66 69 67 75 72 65 64 20 63 61 63  * Configured cac
0540: 68 65 20 73 69 7a 65 20 2a 2f 0a 20 20 69 6e 74  he size */.  int
0550: 20 6e 4d 69 6e 3b 20 20 20 20 20 20 20 20 20 20   nMin;          
0560: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
0570: 20 2f 2a 20 43 6f 6e 66 69 67 75 72 65 64 20 6d   /* Configured m
0580: 69 6e 69 6d 75 6d 20 63 61 63 68 65 20 73 69 7a  inimum cache siz
0590: 65 20 2a 2f 0a 20 20 2f 2a 2a 2a 2a 2a 2a 2a 2a  e */.  /********
05a0: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
05b0: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
05c0: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
05d0: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 0a 20  **************. 
05e0: 20 2a 2a 20 54 68 65 20 6e 65 78 74 20 67 72 6f   ** The next gro
05f0: 75 70 20 6f 66 20 65 6c 65 6d 65 6e 74 73 20 61  up of elements a
0600: 72 65 20 66 69 78 65 64 20 77 68 65 6e 20 74 68  re fixed when th
0610: 65 20 63 61 63 68 65 20 69 73 20 63 72 65 61 74  e cache is creat
0620: 65 64 20 61 6e 64 0a 20 20 2a 2a 20 6d 61 79 20  ed and.  ** may 
0630: 6e 6f 74 20 62 65 20 63 68 61 6e 67 65 64 20 61  not be changed a
0640: 66 74 65 72 77 61 72 64 73 2e 20 20 54 68 65 73  fterwards.  Thes
0650: 65 20 65 6c 65 6d 65 6e 74 73 20 63 61 6e 20 72  e elements can r
0660: 65 61 64 20 61 74 20 61 6e 79 20 74 69 6d 65 20  ead at any time 
0670: 62 79 0a 20 20 2a 2a 20 74 68 65 20 63 61 63 68  by.  ** the cach
0680: 65 20 6f 77 6e 65 72 20 6f 72 20 62 79 20 61 6e  e owner or by an
0690: 79 20 74 68 72 65 61 64 20 68 6f 6c 64 69 6e 67  y thread holding
06a0: 20 74 68 65 20 74 68 65 20 6d 75 74 65 78 2e 20   the the mutex. 
06b0: 20 4e 6f 6e 2d 6f 77 6e 65 72 0a 20 20 2a 2a 20   Non-owner.  ** 
06c0: 74 68 72 65 61 64 73 20 6d 75 73 74 20 68 6f 6c  threads must hol
06d0: 64 20 74 68 65 20 6d 75 74 65 78 20 77 68 65 6e  d the mutex when
06e0: 20 72 65 61 64 69 6e 67 20 74 68 65 73 65 20 65   reading these e
06f0: 6c 65 6d 65 6e 74 73 20 74 6f 20 70 72 65 76 65  lements to preve
0700: 6e 74 0a 20 20 2a 2a 20 74 68 65 20 65 6e 74 69  nt.  ** the enti
0710: 72 65 20 50 43 61 63 68 65 20 6f 62 6a 65 63 74  re PCache object
0720: 20 66 72 6f 6d 20 62 65 69 6e 67 20 64 65 6c 65   from being dele
0730: 74 65 64 20 64 75 72 69 6e 67 20 74 68 65 20 72  ted during the r
0740: 65 61 64 2e 0a 20 20 2a 2f 0a 20 20 69 6e 74 20  ead..  */.  int 
0750: 73 7a 50 61 67 65 3b 20 20 20 20 20 20 20 20 20  szPage;         
0760: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
0770: 2f 2a 20 53 69 7a 65 20 6f 66 20 65 76 65 72 79  /* Size of every
0780: 20 70 61 67 65 20 69 6e 20 74 68 69 73 20 63 61   page in this ca
0790: 63 68 65 20 2a 2f 0a 20 20 69 6e 74 20 73 7a 45  che */.  int szE
07a0: 78 74 72 61 3b 20 20 20 20 20 20 20 20 20 20 20  xtra;           
07b0: 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20               /* 
07c0: 53 69 7a 65 20 6f 66 20 65 78 74 72 61 20 73 70  Size of extra sp
07d0: 61 63 65 20 66 6f 72 20 65 61 63 68 20 70 61 67  ace for each pag
07e0: 65 20 2a 2f 0a 20 20 69 6e 74 20 62 50 75 72 67  e */.  int bPurg
07f0: 65 61 62 6c 65 3b 20 20 20 20 20 20 20 20 20 20  eable;          
0800: 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 54 72             /* Tr
0810: 75 65 20 69 66 20 70 61 67 65 73 20 61 72 65 20  ue if pages are 
0820: 6f 6e 20 62 61 63 6b 69 6e 67 20 73 74 6f 72 65  on backing store
0830: 20 2a 2f 0a 20 20 76 6f 69 64 20 28 2a 78 44 65   */.  void (*xDe
0840: 73 74 72 6f 79 29 28 50 67 48 64 72 2a 29 3b 20  stroy)(PgHdr*); 
0850: 20 20 20 20 20 20 20 20 20 20 2f 2a 20 43 61 6c            /* Cal
0860: 6c 65 64 20 77 68 65 6e 20 72 65 66 63 6e 74 20  led when refcnt 
0870: 67 6f 65 73 20 31 2d 3e 30 20 2a 2f 0a 20 20 69  goes 1->0 */.  i
0880: 6e 74 20 28 2a 78 53 74 72 65 73 73 29 28 76 6f  nt (*xStress)(vo
0890: 69 64 2a 2c 50 67 48 64 72 2a 29 3b 20 20 20 20  id*,PgHdr*);    
08a0: 20 20 20 2f 2a 20 43 61 6c 6c 20 74 6f 20 74 72     /* Call to tr
08b0: 79 20 6d 61 6b 65 20 61 20 70 61 67 65 20 63 6c  y make a page cl
08c0: 65 61 6e 20 2a 2f 0a 20 20 76 6f 69 64 20 2a 70  ean */.  void *p
08d0: 53 74 72 65 73 73 3b 20 20 20 20 20 20 20 20 20  Stress;         
08e0: 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20               /* 
08f0: 41 72 67 75 6d 65 6e 74 20 74 6f 20 78 53 74 72  Argument to xStr
0900: 65 73 73 20 2a 2f 0a 20 20 2f 2a 2a 2a 2a 2a 2a  ess */.  /******
0910: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
0920: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
0930: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
0940: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
0950: 0a 20 20 2a 2a 20 54 68 65 20 66 69 6e 61 6c 20  .  ** The final 
0960: 67 72 6f 75 70 20 6f 66 20 65 6c 65 6d 65 6e 74  group of element
0970: 73 20 63 61 6e 20 6f 6e 6c 79 20 62 65 20 61 63  s can only be ac
0980: 63 65 73 73 65 64 20 77 68 69 6c 65 20 68 6f 6c  cessed while hol
0990: 64 69 6e 67 20 74 68 65 0a 20 20 2a 2a 20 6d 75  ding the.  ** mu
09a0: 74 65 78 2e 20 20 42 6f 74 68 20 74 68 65 20 63  tex.  Both the c
09b0: 61 63 68 65 20 6f 77 6e 65 72 20 61 6e 64 20 61  ache owner and a
09c0: 6e 79 20 6f 74 68 65 72 20 74 68 72 65 61 64 20  ny other thread 
09d0: 6d 75 73 74 20 68 6f 6c 64 20 74 68 65 20 6d 75  must hold the mu
09e0: 74 65 78 0a 20 20 2a 2a 20 74 6f 20 72 65 61 64  tex.  ** to read
09f0: 20 6f 72 20 77 72 69 74 65 20 61 6e 79 20 6f 66   or write any of
0a00: 20 74 68 65 73 65 20 65 6c 65 6d 65 6e 74 73 2e   these elements.
0a10: 0a 20 20 2a 2f 0a 20 20 69 6e 74 20 6e 50 61 67  .  */.  int nPag
0a20: 65 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20  e;              
0a30: 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 54              /* T
0a40: 6f 74 61 6c 20 6e 75 6d 62 65 72 20 6f 66 20 70  otal number of p
0a50: 61 67 65 73 20 69 6e 20 61 70 48 61 73 68 20 2a  ages in apHash *
0a60: 2f 0a 20 20 69 6e 74 20 6e 48 61 73 68 3b 20 20  /.  int nHash;  
0a70: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
0a80: 20 20 20 20 20 20 20 20 2f 2a 20 4e 75 6d 62 65          /* Numbe
0a90: 72 20 6f 66 20 73 6c 6f 74 73 20 69 6e 20 61 70  r of slots in ap
0aa0: 48 61 73 68 5b 5d 20 2a 2f 0a 20 20 50 67 48 64  Hash[] */.  PgHd
0ab0: 72 20 2a 2a 61 70 48 61 73 68 3b 20 20 20 20 20  r **apHash;     
0ac0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
0ad0: 2f 2a 20 48 61 73 68 20 74 61 62 6c 65 20 66 6f  /* Hash table fo
0ae0: 72 20 66 61 73 74 20 6c 6f 6f 6b 75 70 20 62 79  r fast lookup by
0af0: 20 70 67 6e 6f 20 2a 2f 0a 20 20 50 67 48 64 72   pgno */.  PgHdr
0b00: 20 2a 70 43 6c 65 61 6e 3b 20 20 20 20 20 20 20   *pClean;       
0b10: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f                 /
0b20: 2a 20 4c 69 73 74 20 6f 66 20 63 6c 65 61 6e 20  * List of clean 
0b30: 70 61 67 65 73 20 69 6e 20 75 73 65 20 2a 2f 0a  pages in use */.
0b40: 7d 3b 0a 0a 2f 2a 0a 2a 2a 20 46 72 65 65 20 73  };../*.** Free s
0b50: 6c 6f 74 73 20 69 6e 20 74 68 65 20 70 61 67 65  lots in the page
0b60: 20 62 6c 6f 63 6b 20 61 6c 6c 6f 63 61 74 6f 72   block allocator
0b70: 0a 2a 2f 0a 74 79 70 65 64 65 66 20 73 74 72 75  .*/.typedef stru
0b80: 63 74 20 50 67 46 72 65 65 73 6c 6f 74 20 50 67  ct PgFreeslot Pg
0b90: 46 72 65 65 73 6c 6f 74 3b 0a 73 74 72 75 63 74  Freeslot;.struct
0ba0: 20 50 67 46 72 65 65 73 6c 6f 74 20 7b 0a 20 20   PgFreeslot {.  
0bb0: 50 67 46 72 65 65 73 6c 6f 74 20 2a 70 4e 65 78  PgFreeslot *pNex
0bc0: 74 3b 20 20 2f 2a 20 4e 65 78 74 20 66 72 65 65  t;  /* Next free
0bd0: 20 73 6c 6f 74 20 2a 2f 0a 7d 3b 0a 0a 2f 2a 0a   slot */.};../*.
0be0: 2a 2a 20 47 6c 6f 62 61 6c 20 64 61 74 61 20 66  ** Global data f
0bf0: 6f 72 20 74 68 65 20 70 61 67 65 20 63 61 63 68  or the page cach
0c00: 65 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 53 51 4c  e..*/.static SQL
0c10: 49 54 45 5f 57 53 44 20 73 74 72 75 63 74 20 50  ITE_WSD struct P
0c20: 43 61 63 68 65 47 6c 6f 62 61 6c 20 7b 0a 20 20  CacheGlobal {.  
0c30: 69 6e 74 20 69 73 49 6e 69 74 3b 20 20 20 20 20  int isInit;     
0c40: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
0c50: 20 20 20 20 2f 2a 20 54 72 75 65 20 77 68 65 6e      /* True when
0c60: 20 69 6e 69 74 69 61 6c 69 7a 65 64 20 2a 2f 0a   initialized */.
0c70: 20 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 20    sqlite3_mutex 
0c80: 2a 6d 75 74 65 78 3b 20 20 20 20 20 20 20 20 20  *mutex;         
0c90: 20 20 20 20 20 20 2f 2a 20 73 74 61 74 69 63 20        /* static 
0ca0: 6d 75 74 65 78 20 4d 55 54 45 58 5f 53 54 41 54  mutex MUTEX_STAT
0cb0: 49 43 5f 4c 52 55 20 2a 2f 0a 0a 20 20 69 6e 74  IC_LRU */..  int
0cc0: 20 6e 4d 61 78 50 61 67 65 3b 20 20 20 20 20 20   nMaxPage;      
0cd0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
0ce0: 20 2f 2a 20 53 75 6d 20 6f 66 20 6e 4d 61 78 50   /* Sum of nMaxP
0cf0: 61 67 65 20 66 6f 72 20 70 75 72 67 65 61 62 6c  age for purgeabl
0d00: 65 20 63 61 63 68 65 73 20 2a 2f 0a 20 20 69 6e  e caches */.  in
0d10: 74 20 6e 4d 69 6e 50 61 67 65 3b 20 20 20 20 20  t nMinPage;     
0d20: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
0d30: 20 20 2f 2a 20 53 75 6d 20 6f 66 20 6e 4d 69 6e    /* Sum of nMin
0d40: 50 61 67 65 20 66 6f 72 20 70 75 72 67 65 61 62  Page for purgeab
0d50: 6c 65 20 63 61 63 68 65 73 20 2a 2f 0a 20 20 69  le caches */.  i
0d60: 6e 74 20 6e 43 75 72 72 65 6e 74 50 61 67 65 3b  nt nCurrentPage;
0d70: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
0d80: 20 20 20 2f 2a 20 4e 75 6d 62 65 72 20 6f 66 20     /* Number of 
0d90: 70 75 72 67 65 61 62 6c 65 20 70 61 67 65 73 20  purgeable pages 
0da0: 61 6c 6c 6f 63 61 74 65 64 20 2a 2f 0a 20 20 50  allocated */.  P
0db0: 67 48 64 72 20 2a 70 4c 72 75 48 65 61 64 2c 20  gHdr *pLruHead, 
0dc0: 2a 70 4c 72 75 54 61 69 6c 3b 20 20 20 20 20 20  *pLruTail;      
0dd0: 20 20 20 2f 2a 20 4c 52 55 20 6c 69 73 74 20 6f     /* LRU list o
0de0: 66 20 75 6e 75 73 65 64 20 63 6c 65 61 6e 20 70  f unused clean p
0df0: 67 73 20 2a 2f 0a 0a 20 20 2f 2a 20 56 61 72 69  gs */..  /* Vari
0e00: 61 62 6c 65 73 20 72 65 6c 61 74 65 64 20 74 6f  ables related to
0e10: 20 53 51 4c 49 54 45 5f 43 4f 4e 46 49 47 5f 50   SQLITE_CONFIG_P
0e20: 41 47 45 43 41 43 48 45 20 73 65 74 74 69 6e 67  AGECACHE setting
0e30: 73 2e 20 2a 2f 0a 20 20 69 6e 74 20 73 7a 53 6c  s. */.  int szSl
0e40: 6f 74 3b 20 20 20 20 20 20 20 20 20 20 20 20 20  ot;             
0e50: 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 53              /* S
0e60: 69 7a 65 20 6f 66 20 65 61 63 68 20 66 72 65 65  ize of each free
0e70: 20 73 6c 6f 74 20 2a 2f 0a 20 20 76 6f 69 64 20   slot */.  void 
0e80: 2a 70 53 74 61 72 74 2c 20 2a 70 45 6e 64 3b 20  *pStart, *pEnd; 
0e90: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f                 /
0ea0: 2a 20 42 6f 75 6e 64 73 20 6f 66 20 70 61 67 65  * Bounds of page
0eb0: 63 61 63 68 65 20 6d 61 6c 6c 6f 63 20 72 61 6e  cache malloc ran
0ec0: 67 65 20 2a 2f 0a 20 20 50 67 46 72 65 65 73 6c  ge */.  PgFreesl
0ed0: 6f 74 20 2a 70 46 72 65 65 3b 20 20 20 20 20 20  ot *pFree;      
0ee0: 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 46              /* F
0ef0: 72 65 65 20 70 61 67 65 20 62 6c 6f 63 6b 73 20  ree page blocks 
0f00: 2a 2f 0a 7d 20 70 63 61 63 68 65 20 3d 20 7b 30  */.} pcache = {0
0f10: 7d 3b 0a 0a 2f 2a 0a 2a 2a 20 41 6c 6c 20 63 6f  };../*.** All co
0f20: 64 65 20 69 6e 20 74 68 69 73 20 66 69 6c 65 20  de in this file 
0f30: 73 68 6f 75 6c 64 20 61 63 63 65 73 73 20 74 68  should access th
0f40: 65 20 67 6c 6f 62 61 6c 20 70 63 61 63 68 65 20  e global pcache 
0f50: 73 74 72 75 63 74 75 72 65 20 76 69 61 20 74 68  structure via th
0f60: 65 0a 2a 2a 20 61 6c 69 61 73 20 22 70 63 61 63  e.** alias "pcac
0f70: 68 65 5f 67 22 2e 20 54 68 69 73 20 65 6e 73 75  he_g". This ensu
0f80: 72 65 73 20 74 68 61 74 20 74 68 65 20 57 53 44  res that the WSD
0f90: 20 65 6d 75 6c 61 74 69 6f 6e 20 69 73 20 75 73   emulation is us
0fa0: 65 64 20 77 68 65 6e 0a 2a 2a 20 63 6f 6d 70 69  ed when.** compi
0fb0: 6c 69 6e 67 20 66 6f 72 20 73 79 73 74 65 6d 73  ling for systems
0fc0: 20 74 68 61 74 20 64 6f 20 6e 6f 74 20 73 75 70   that do not sup
0fd0: 70 6f 72 74 20 72 65 61 6c 20 57 53 44 2e 0a 2a  port real WSD..*
0fe0: 2f 0a 23 64 65 66 69 6e 65 20 70 63 61 63 68 65  /.#define pcache
0ff0: 5f 67 20 28 47 4c 4f 42 41 4c 28 73 74 72 75 63  _g (GLOBAL(struc
1000: 74 20 50 43 61 63 68 65 47 6c 6f 62 61 6c 2c 20  t PCacheGlobal, 
1010: 70 63 61 63 68 65 29 29 0a 0a 2f 2a 0a 2a 2a 20  pcache))../*.** 
1020: 41 6c 6c 20 67 6c 6f 62 61 6c 20 76 61 72 69 61  All global varia
1030: 62 6c 65 73 20 75 73 65 64 20 62 79 20 74 68 69  bles used by thi
1040: 73 20 6d 6f 64 75 6c 65 20 28 61 6c 6c 20 6f 66  s module (all of
1050: 20 77 68 69 63 68 20 61 72 65 20 67 72 6f 75 70   which are group
1060: 65 64 20 0a 2a 2a 20 74 6f 67 65 74 68 65 72 20  ed .** together 
1070: 69 6e 20 67 6c 6f 62 61 6c 20 73 74 72 75 63 74  in global struct
1080: 75 72 65 20 22 70 63 61 63 68 65 22 20 61 62 6f  ure "pcache" abo
1090: 76 65 29 20 61 72 65 20 70 72 6f 74 65 63 74 65  ve) are protecte
10a0: 64 20 62 79 20 74 68 65 20 73 74 61 74 69 63 20  d by the static 
10b0: 0a 2a 2a 20 53 51 4c 49 54 45 5f 4d 55 54 45 58  .** SQLITE_MUTEX
10c0: 5f 53 54 41 54 49 43 5f 4c 52 55 20 6d 75 74 65  _STATIC_LRU mute
10d0: 78 2e 20 41 20 70 6f 69 6e 74 65 72 20 74 6f 20  x. A pointer to 
10e0: 74 68 69 73 20 6d 75 74 65 78 20 69 73 20 73 74  this mutex is st
10f0: 6f 72 65 64 20 69 6e 0a 2a 2a 20 76 61 72 69 61  ored in.** varia
1100: 62 6c 65 20 22 70 63 61 63 68 65 2e 6d 75 74 65  ble "pcache.mute
1110: 78 22 2e 0a 2a 2a 0a 2a 2a 20 53 6f 6d 65 20 65  x"..**.** Some e
1120: 6c 65 6d 65 6e 74 73 20 6f 66 20 74 68 65 20 50  lements of the P
1130: 43 61 63 68 65 20 61 6e 64 20 50 67 48 64 72 20  Cache and PgHdr 
1140: 73 74 72 75 63 74 75 72 65 73 20 61 72 65 20 70  structures are p
1150: 72 6f 74 65 63 74 65 64 20 62 79 20 74 68 65 20  rotected by the 
1160: 0a 2a 2a 20 53 51 4c 49 54 45 5f 4d 55 54 45 58  .** SQLITE_MUTEX
1170: 5f 53 54 41 54 55 53 5f 4c 52 55 20 6d 75 74 65  _STATUS_LRU mute
1180: 78 20 61 6e 64 20 6f 74 68 65 72 20 61 72 65 20  x and other are 
1190: 6e 6f 74 2e 20 20 54 68 65 20 70 72 6f 74 65 63  not.  The protec
11a0: 74 65 64 0a 2a 2a 20 65 6c 65 6d 65 6e 74 73 20  ted.** elements 
11b0: 61 72 65 20 67 72 6f 75 70 65 64 20 61 74 20 74  are grouped at t
11c0: 68 65 20 65 6e 64 20 6f 66 20 74 68 65 20 73 74  he end of the st
11d0: 72 75 63 74 75 72 65 73 20 61 6e 64 20 61 72 65  ructures and are
11e0: 20 63 6c 65 61 72 6c 79 0a 2a 2a 20 6d 61 72 6b   clearly.** mark
11f0: 65 64 2e 0a 2a 2a 0a 2a 2a 20 55 73 65 20 74 68  ed..**.** Use th
1200: 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 6d 61 63 72  e following macr
1210: 6f 73 20 6d 75 73 74 20 73 75 72 72 6f 75 6e 64  os must surround
1220: 20 61 6c 6c 20 61 63 63 65 73 73 20 28 72 65 61   all access (rea
1230: 64 20 6f 72 20 77 72 69 74 65 29 0a 2a 2a 20 6f  d or write).** o
1240: 66 20 70 72 6f 74 65 63 74 65 64 20 65 6c 65 6d  f protected elem
1250: 65 6e 74 73 2e 20 20 54 68 65 20 6d 75 74 65 78  ents.  The mutex
1260: 20 69 73 20 6e 6f 74 20 72 65 63 75 72 73 69 76   is not recursiv
1270: 65 20 61 6e 64 20 6d 61 79 20 6e 6f 74 20 62 65  e and may not be
1280: 0a 2a 2a 20 65 6e 74 65 72 65 64 20 6d 6f 72 65  .** entered more
1290: 20 74 68 61 6e 20 6f 6e 63 65 2e 20 20 54 68 65   than once.  The
12a0: 20 70 63 61 63 68 65 4d 75 74 65 78 48 65 6c 64   pcacheMutexHeld
12b0: 28 29 20 6d 61 63 72 6f 20 73 68 6f 75 6c 64 20  () macro should 
12c0: 6f 6e 6c 79 20 62 65 0a 2a 2a 20 75 73 65 64 20  only be.** used 
12d0: 77 69 74 68 69 6e 20 61 6e 20 61 73 73 65 72 74  within an assert
12e0: 28 29 20 74 6f 20 76 65 72 69 66 79 20 74 68 61  () to verify tha
12f0: 74 20 74 68 65 20 6d 75 74 65 78 20 69 73 20 62  t the mutex is b
1300: 65 69 6e 67 20 68 65 6c 64 2e 0a 2a 2f 0a 23 64  eing held..*/.#d
1310: 65 66 69 6e 65 20 70 63 61 63 68 65 45 6e 74 65  efine pcacheEnte
1320: 72 4d 75 74 65 78 28 29 20 73 71 6c 69 74 65 33  rMutex() sqlite3
1330: 5f 6d 75 74 65 78 5f 65 6e 74 65 72 28 70 63 61  _mutex_enter(pca
1340: 63 68 65 5f 67 2e 6d 75 74 65 78 29 0a 23 64 65  che_g.mutex).#de
1350: 66 69 6e 65 20 70 63 61 63 68 65 45 78 69 74 4d  fine pcacheExitM
1360: 75 74 65 78 28 29 20 20 73 71 6c 69 74 65 33 5f  utex()  sqlite3_
1370: 6d 75 74 65 78 5f 6c 65 61 76 65 28 70 63 61 63  mutex_leave(pcac
1380: 68 65 5f 67 2e 6d 75 74 65 78 29 0a 23 64 65 66  he_g.mutex).#def
1390: 69 6e 65 20 70 63 61 63 68 65 4d 75 74 65 78 48  ine pcacheMutexH
13a0: 65 6c 64 28 29 20 20 73 71 6c 69 74 65 33 5f 6d  eld()  sqlite3_m
13b0: 75 74 65 78 5f 68 65 6c 64 28 70 63 61 63 68 65  utex_held(pcache
13c0: 5f 67 2e 6d 75 74 65 78 29 0a 0a 2f 2a 0a 2a 2a  _g.mutex)../*.**
13d0: 20 53 6f 6d 65 20 6f 66 20 74 68 65 20 61 73 73   Some of the ass
13e0: 65 72 74 28 29 20 6d 61 63 72 6f 73 20 69 6e 20  ert() macros in 
13f0: 74 68 69 73 20 63 6f 64 65 20 61 72 65 20 74 6f  this code are to
1400: 6f 20 65 78 70 65 6e 73 69 76 65 20 74 6f 20 72  o expensive to r
1410: 75 6e 0a 2a 2a 20 65 76 65 6e 20 64 75 72 69 6e  un.** even durin
1420: 67 20 6e 6f 72 6d 61 6c 20 64 65 62 75 67 67 69  g normal debuggi
1430: 6e 67 2e 20 20 55 73 65 20 74 68 65 6d 20 6f 6e  ng.  Use them on
1440: 6c 79 20 72 61 72 65 6c 79 20 6f 6e 20 6c 6f 6e  ly rarely on lon
1450: 67 2d 72 75 6e 6e 69 6e 67 0a 2a 2a 20 74 65 73  g-running.** tes
1460: 74 73 2e 20 20 45 6e 61 62 6c 65 20 74 68 65 20  ts.  Enable the 
1470: 65 78 70 65 6e 73 69 76 65 20 61 73 73 65 72 74  expensive assert
1480: 73 20 75 73 69 6e 67 20 74 68 65 0a 2a 2a 20 2d  s using the.** -
1490: 44 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45 5f 45  DSQLITE_ENABLE_E
14a0: 58 50 45 4e 53 49 56 45 5f 41 53 53 45 52 54 3d  XPENSIVE_ASSERT=
14b0: 31 20 63 6f 6d 70 69 6c 65 2d 74 69 6d 65 20 6f  1 compile-time o
14c0: 70 74 69 6f 6e 2e 0a 2a 2f 0a 23 69 66 64 65 66  ption..*/.#ifdef
14d0: 20 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45 5f 45   SQLITE_ENABLE_E
14e0: 58 50 45 4e 53 49 56 45 5f 41 53 53 45 52 54 0a  XPENSIVE_ASSERT.
14f0: 23 20 64 65 66 69 6e 65 20 65 78 70 65 6e 73 69  # define expensi
1500: 76 65 5f 61 73 73 65 72 74 28 58 29 20 20 61 73  ve_assert(X)  as
1510: 73 65 72 74 28 58 29 0a 23 65 6c 73 65 0a 23 20  sert(X).#else.# 
1520: 64 65 66 69 6e 65 20 65 78 70 65 6e 73 69 76 65  define expensive
1530: 5f 61 73 73 65 72 74 28 58 29 0a 23 65 6e 64 69  _assert(X).#endi
1540: 66 0a 0a 2f 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  f../************
1550: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
1560: 2a 2a 2a 2a 2a 2a 20 4c 69 6e 6b 65 64 20 4c 69  ****** Linked Li
1570: 73 74 20 4d 61 6e 61 67 65 6d 65 6e 74 20 2a 2a  st Management **
1580: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
1590: 2a 2a 2f 0a 0a 23 69 66 20 21 64 65 66 69 6e 65  **/..#if !define
15a0: 64 28 4e 44 45 42 55 47 29 20 26 26 20 64 65 66  d(NDEBUG) && def
15b0: 69 6e 65 64 28 53 51 4c 49 54 45 5f 45 4e 41 42  ined(SQLITE_ENAB
15c0: 4c 45 5f 45 58 50 45 4e 53 49 56 45 5f 41 53 53  LE_EXPENSIVE_ASS
15d0: 45 52 54 29 0a 2f 2a 0a 2a 2a 20 54 68 69 73 20  ERT)./*.** This 
15e0: 72 6f 75 74 69 6e 65 20 76 65 72 69 66 69 65 73  routine verifies
15f0: 20 74 68 61 74 20 74 68 65 20 6e 75 6d 62 65 72   that the number
1600: 20 6f 66 20 65 6e 74 72 69 65 73 20 69 6e 20 74   of entries in t
1610: 68 65 20 68 61 73 68 20 74 61 62 6c 65 0a 2a 2a  he hash table.**
1620: 20 69 73 20 70 43 61 63 68 65 2d 3e 6e 50 61 67   is pCache->nPag
1630: 65 2e 20 20 54 68 69 73 20 72 6f 75 74 69 6e 65  e.  This routine
1640: 20 69 73 20 75 73 65 64 20 77 69 74 68 69 6e 20   is used within 
1650: 61 73 73 65 72 74 28 29 20 73 74 61 74 65 6d 65  assert() stateme
1660: 6e 74 73 0a 2a 2a 20 6f 6e 6c 79 20 61 6e 64 20  nts.** only and 
1670: 69 73 20 74 68 65 72 65 66 6f 72 65 20 64 69 73  is therefore dis
1680: 61 62 6c 65 64 20 64 75 72 69 6e 67 20 70 72 6f  abled during pro
1690: 64 75 63 74 69 6f 6e 20 62 75 69 6c 64 73 2e 0a  duction builds..
16a0: 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74 20 70 63  */.static int pc
16b0: 61 63 68 65 43 68 65 63 6b 48 61 73 68 43 6f 75  acheCheckHashCou
16c0: 6e 74 28 50 43 61 63 68 65 20 2a 70 43 61 63 68  nt(PCache *pCach
16d0: 65 29 7b 0a 20 20 69 6e 74 20 69 3b 0a 20 20 69  e){.  int i;.  i
16e0: 6e 74 20 6e 50 61 67 65 20 3d 20 30 3b 0a 20 20  nt nPage = 0;.  
16f0: 66 6f 72 28 69 3d 30 3b 20 69 3c 70 43 61 63 68  for(i=0; i<pCach
1700: 65 2d 3e 6e 48 61 73 68 3b 20 69 2b 2b 29 7b 0a  e->nHash; i++){.
1710: 20 20 20 20 50 67 48 64 72 20 2a 70 3b 0a 20 20      PgHdr *p;.  
1720: 20 20 66 6f 72 28 70 3d 70 43 61 63 68 65 2d 3e    for(p=pCache->
1730: 61 70 48 61 73 68 5b 69 5d 3b 20 70 3b 20 70 3d  apHash[i]; p; p=
1740: 70 2d 3e 70 4e 65 78 74 48 61 73 68 29 7b 0a 20  p->pNextHash){. 
1750: 20 20 20 20 20 6e 50 61 67 65 2b 2b 3b 0a 20 20       nPage++;.  
1760: 20 20 7d 0a 20 20 7d 0a 20 20 61 73 73 65 72 74    }.  }.  assert
1770: 28 20 6e 50 61 67 65 3d 3d 70 43 61 63 68 65 2d  ( nPage==pCache-
1780: 3e 6e 50 61 67 65 20 29 3b 0a 20 20 72 65 74 75  >nPage );.  retu
1790: 72 6e 20 31 3b 0a 7d 0a 23 65 6e 64 69 66 20 2f  rn 1;.}.#endif /
17a0: 2a 20 21 4e 44 45 42 55 47 20 26 26 20 53 51 4c  * !NDEBUG && SQL
17b0: 49 54 45 5f 45 4e 41 42 4c 45 5f 45 58 50 45 4e  ITE_ENABLE_EXPEN
17c0: 53 49 56 45 5f 41 53 53 45 52 54 20 2a 2f 0a 0a  SIVE_ASSERT */..
17d0: 0a 23 69 66 20 21 64 65 66 69 6e 65 64 28 4e 44  .#if !defined(ND
17e0: 45 42 55 47 29 20 26 26 20 64 65 66 69 6e 65 64  EBUG) && defined
17f0: 28 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45 5f 45  (SQLITE_ENABLE_E
1800: 58 50 45 4e 53 49 56 45 5f 41 53 53 45 52 54 29  XPENSIVE_ASSERT)
1810: 0a 2f 2a 0a 2a 2a 20 42 61 73 65 64 20 6f 6e 20  ./*.** Based on 
1820: 74 68 65 20 63 75 72 72 65 6e 74 20 76 61 6c 75  the current valu
1830: 65 20 6f 66 20 50 43 61 63 68 65 2e 6e 52 65 66  e of PCache.nRef
1840: 20 61 6e 64 20 74 68 65 20 63 6f 6e 74 65 6e 74   and the content
1850: 73 20 6f 66 20 74 68 65 0a 2a 2a 20 50 43 61 63  s of the.** PCac
1860: 68 65 2e 70 44 69 72 74 79 20 6c 69 73 74 2c 20  he.pDirty list, 
1870: 72 65 74 75 72 6e 20 74 68 65 20 65 78 70 65 63  return the expec
1880: 74 65 64 20 76 61 6c 75 65 20 6f 66 20 74 68 65  ted value of the
1890: 20 50 43 61 63 68 65 2e 6e 50 69 6e 6e 65 64 0a   PCache.nPinned.
18a0: 2a 2a 20 63 6f 75 6e 74 65 72 2e 20 54 68 69 73  ** counter. This
18b0: 20 69 73 20 6f 6e 6c 79 20 75 73 65 64 20 69 6e   is only used in
18c0: 20 64 65 62 75 67 67 69 6e 67 20 62 75 69 6c 64   debugging build
18d0: 73 2c 20 61 73 20 66 6f 6c 6c 6f 77 73 3a 0a 2a  s, as follows:.*
18e0: 2a 0a 2a 2a 20 20 20 65 78 70 65 6e 73 69 76 65  *.**   expensive
18f0: 5f 61 73 73 65 72 74 28 20 70 43 61 63 68 65 2d  _assert( pCache-
1900: 3e 6e 50 69 6e 6e 65 64 3d 3d 70 63 61 63 68 65  >nPinned==pcache
1910: 50 69 6e 6e 65 64 43 6f 75 6e 74 28 70 43 61 63  PinnedCount(pCac
1920: 68 65 29 20 29 3b 0a 2a 2f 0a 73 74 61 74 69 63  he) );.*/.static
1930: 20 69 6e 74 20 70 63 61 63 68 65 50 69 6e 6e 65   int pcachePinne
1940: 64 43 6f 75 6e 74 28 50 43 61 63 68 65 20 2a 70  dCount(PCache *p
1950: 43 61 63 68 65 29 7b 0a 20 20 50 67 48 64 72 20  Cache){.  PgHdr 
1960: 2a 70 3b 0a 20 20 69 6e 74 20 6e 50 69 6e 6e 65  *p;.  int nPinne
1970: 64 20 3d 20 70 43 61 63 68 65 2d 3e 6e 52 65 66  d = pCache->nRef
1980: 3b 0a 20 20 66 6f 72 28 70 3d 70 43 61 63 68 65  ;.  for(p=pCache
1990: 2d 3e 70 44 69 72 74 79 3b 20 70 3b 20 70 3d 70  ->pDirty; p; p=p
19a0: 2d 3e 70 4e 65 78 74 29 7b 0a 20 20 20 20 69 66  ->pNext){.    if
19b0: 28 20 70 2d 3e 6e 52 65 66 3d 3d 30 20 29 7b 0a  ( p->nRef==0 ){.
19c0: 20 20 20 20 20 20 6e 50 69 6e 6e 65 64 2b 2b 3b        nPinned++;
19d0: 0a 20 20 20 20 7d 0a 20 20 7d 0a 20 20 72 65 74  .    }.  }.  ret
19e0: 75 72 6e 20 6e 50 69 6e 6e 65 64 3b 0a 7d 0a 23  urn nPinned;.}.#
19f0: 65 6e 64 69 66 20 2f 2a 20 21 4e 44 45 42 55 47  endif /* !NDEBUG
1a00: 20 26 26 20 53 51 4c 49 54 45 5f 45 4e 41 42 4c   && SQLITE_ENABL
1a10: 45 5f 45 58 50 45 4e 53 49 56 45 5f 41 53 53 45  E_EXPENSIVE_ASSE
1a20: 52 54 20 2a 2f 0a 0a 0a 23 69 66 20 21 64 65 66  RT */...#if !def
1a30: 69 6e 65 64 28 4e 44 45 42 55 47 29 20 26 26 20  ined(NDEBUG) && 
1a40: 64 65 66 69 6e 65 64 28 53 51 4c 49 54 45 5f 45  defined(SQLITE_E
1a50: 4e 41 42 4c 45 5f 45 58 50 45 4e 53 49 56 45 5f  NABLE_EXPENSIVE_
1a60: 41 53 53 45 52 54 29 0a 2f 2a 0a 2a 2a 20 43 68  ASSERT)./*.** Ch
1a70: 65 63 6b 20 74 68 61 74 20 74 68 65 20 70 43 61  eck that the pCa
1a80: 63 68 65 2d 3e 70 53 79 6e 63 65 64 20 76 61 72  che->pSynced var
1a90: 69 61 62 6c 65 20 69 73 20 73 65 74 20 63 6f 72  iable is set cor
1aa0: 72 65 63 74 6c 79 2e 20 49 66 20 69 74 0a 2a 2a  rectly. If it.**
1ab0: 20 69 73 20 6e 6f 74 2c 20 65 69 74 68 65 72 20   is not, either 
1ac0: 66 61 69 6c 20 61 6e 20 61 73 73 65 72 74 20 6f  fail an assert o
1ad0: 72 20 72 65 74 75 72 6e 20 7a 65 72 6f 2e 20 4f  r return zero. O
1ae0: 74 68 65 72 77 69 73 65 2c 20 72 65 74 75 72 6e  therwise, return
1af0: 0a 2a 2a 20 6e 6f 6e 2d 7a 65 72 6f 2e 20 54 68  .** non-zero. Th
1b00: 69 73 20 69 73 20 6f 6e 6c 79 20 75 73 65 64 20  is is only used 
1b10: 69 6e 20 64 65 62 75 67 67 69 6e 67 20 62 75 69  in debugging bui
1b20: 6c 64 73 2c 20 61 73 20 66 6f 6c 6c 6f 77 73 3a  lds, as follows:
1b30: 0a 2a 2a 0a 2a 2a 20 20 20 65 78 70 65 6e 73 69  .**.**   expensi
1b40: 76 65 5f 61 73 73 65 72 74 28 20 70 63 61 63 68  ve_assert( pcach
1b50: 65 43 68 65 63 6b 53 79 6e 63 65 64 28 70 43 61  eCheckSynced(pCa
1b60: 63 68 65 29 20 29 3b 0a 2a 2f 0a 73 74 61 74 69  che) );.*/.stati
1b70: 63 20 69 6e 74 20 70 63 61 63 68 65 43 68 65 63  c int pcacheChec
1b80: 6b 53 79 6e 63 65 64 28 50 43 61 63 68 65 20 2a  kSynced(PCache *
1b90: 70 43 61 63 68 65 29 7b 0a 20 20 50 67 48 64 72  pCache){.  PgHdr
1ba0: 20 2a 70 20 3d 20 70 43 61 63 68 65 2d 3e 70 44   *p = pCache->pD
1bb0: 69 72 74 79 54 61 69 6c 3b 0a 20 20 66 6f 72 28  irtyTail;.  for(
1bc0: 70 3d 70 43 61 63 68 65 2d 3e 70 44 69 72 74 79  p=pCache->pDirty
1bd0: 54 61 69 6c 3b 20 70 21 3d 70 43 61 63 68 65 2d  Tail; p!=pCache-
1be0: 3e 70 53 79 6e 63 65 64 3b 20 70 3d 70 2d 3e 70  >pSynced; p=p->p
1bf0: 50 72 65 76 29 7b 0a 20 20 20 20 61 73 73 65 72  Prev){.    asser
1c00: 74 28 20 70 2d 3e 6e 52 65 66 20 7c 7c 20 28 70  t( p->nRef || (p
1c10: 2d 3e 66 6c 61 67 73 26 50 47 48 44 52 5f 4e 45  ->flags&PGHDR_NE
1c20: 45 44 5f 53 59 4e 43 29 20 29 3b 0a 20 20 7d 0a  ED_SYNC) );.  }.
1c30: 20 20 72 65 74 75 72 6e 20 28 70 3d 3d 30 20 7c    return (p==0 |
1c40: 7c 20 70 2d 3e 6e 52 65 66 20 7c 7c 20 28 70 2d  | p->nRef || (p-
1c50: 3e 66 6c 61 67 73 26 50 47 48 44 52 5f 4e 45 45  >flags&PGHDR_NEE
1c60: 44 5f 53 59 4e 43 29 3d 3d 30 29 3b 0a 7d 0a 23  D_SYNC)==0);.}.#
1c70: 65 6e 64 69 66 20 2f 2a 20 21 4e 44 45 42 55 47  endif /* !NDEBUG
1c80: 20 26 26 20 53 51 4c 49 54 45 5f 45 4e 41 42 4c   && SQLITE_ENABL
1c90: 45 5f 45 58 50 45 4e 53 49 56 45 5f 41 53 53 45  E_EXPENSIVE_ASSE
1ca0: 52 54 20 2a 2f 0a 0a 0a 0a 2f 2a 0a 2a 2a 20 52  RT */..../*.** R
1cb0: 65 6d 6f 76 65 20 61 20 70 61 67 65 20 66 72 6f  emove a page fro
1cc0: 6d 20 69 74 73 20 68 61 73 68 20 74 61 62 6c 65  m its hash table
1cd0: 20 28 50 43 61 63 68 65 2e 61 70 48 61 73 68 5b   (PCache.apHash[
1ce0: 5d 29 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 76 6f  ])..*/.static vo
1cf0: 69 64 20 70 63 61 63 68 65 52 65 6d 6f 76 65 46  id pcacheRemoveF
1d00: 72 6f 6d 48 61 73 68 28 50 67 48 64 72 20 2a 70  romHash(PgHdr *p
1d10: 50 61 67 65 29 7b 0a 20 20 61 73 73 65 72 74 28  Page){.  assert(
1d20: 20 70 63 61 63 68 65 4d 75 74 65 78 48 65 6c 64   pcacheMutexHeld
1d30: 28 29 20 29 3b 0a 20 20 69 66 28 20 70 50 61 67  () );.  if( pPag
1d40: 65 2d 3e 70 50 72 65 76 48 61 73 68 20 29 7b 0a  e->pPrevHash ){.
1d50: 20 20 20 20 70 50 61 67 65 2d 3e 70 50 72 65 76      pPage->pPrev
1d60: 48 61 73 68 2d 3e 70 4e 65 78 74 48 61 73 68 20  Hash->pNextHash 
1d70: 3d 20 70 50 61 67 65 2d 3e 70 4e 65 78 74 48 61  = pPage->pNextHa
1d80: 73 68 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 20  sh;.  }else{.   
1d90: 20 50 43 61 63 68 65 20 2a 70 43 61 63 68 65 20   PCache *pCache 
1da0: 3d 20 70 50 61 67 65 2d 3e 70 43 61 63 68 65 3b  = pPage->pCache;
1db0: 0a 20 20 20 20 75 33 32 20 68 20 3d 20 70 50 61  .    u32 h = pPa
1dc0: 67 65 2d 3e 70 67 6e 6f 20 25 20 70 43 61 63 68  ge->pgno % pCach
1dd0: 65 2d 3e 6e 48 61 73 68 3b 0a 20 20 20 20 61 73  e->nHash;.    as
1de0: 73 65 72 74 28 20 70 43 61 63 68 65 2d 3e 61 70  sert( pCache->ap
1df0: 48 61 73 68 5b 68 5d 3d 3d 70 50 61 67 65 20 29  Hash[h]==pPage )
1e00: 3b 0a 20 20 20 20 70 43 61 63 68 65 2d 3e 61 70  ;.    pCache->ap
1e10: 48 61 73 68 5b 68 5d 20 3d 20 70 50 61 67 65 2d  Hash[h] = pPage-
1e20: 3e 70 4e 65 78 74 48 61 73 68 3b 0a 20 20 7d 0a  >pNextHash;.  }.
1e30: 20 20 69 66 28 20 70 50 61 67 65 2d 3e 70 4e 65    if( pPage->pNe
1e40: 78 74 48 61 73 68 20 29 7b 0a 20 20 20 20 70 50  xtHash ){.    pP
1e50: 61 67 65 2d 3e 70 4e 65 78 74 48 61 73 68 2d 3e  age->pNextHash->
1e60: 70 50 72 65 76 48 61 73 68 20 3d 20 70 50 61 67  pPrevHash = pPag
1e70: 65 2d 3e 70 50 72 65 76 48 61 73 68 3b 0a 20 20  e->pPrevHash;.  
1e80: 7d 0a 20 20 70 50 61 67 65 2d 3e 70 43 61 63 68  }.  pPage->pCach
1e90: 65 2d 3e 6e 50 61 67 65 2d 2d 3b 0a 20 20 65 78  e->nPage--;.  ex
1ea0: 70 65 6e 73 69 76 65 5f 61 73 73 65 72 74 28 20  pensive_assert( 
1eb0: 70 63 61 63 68 65 43 68 65 63 6b 48 61 73 68 43  pcacheCheckHashC
1ec0: 6f 75 6e 74 28 70 50 61 67 65 2d 3e 70 43 61 63  ount(pPage->pCac
1ed0: 68 65 29 20 29 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20  he) );.}../*.** 
1ee0: 49 6e 73 65 72 74 20 61 20 70 61 67 65 20 69 6e  Insert a page in
1ef0: 74 6f 20 74 68 65 20 68 61 73 68 20 74 61 62 6c  to the hash tabl
1f00: 65 0a 2a 2a 0a 2a 2a 20 54 68 65 20 6d 75 74 65  e.**.** The mute
1f10: 78 20 6d 75 73 74 20 62 65 20 68 65 6c 64 20 62  x must be held b
1f20: 79 20 74 68 65 20 63 61 6c 6c 65 72 2e 0a 2a 2f  y the caller..*/
1f30: 0a 73 74 61 74 69 63 20 76 6f 69 64 20 70 63 61  .static void pca
1f40: 63 68 65 41 64 64 54 6f 48 61 73 68 28 50 67 48  cheAddToHash(PgH
1f50: 64 72 20 2a 70 50 61 67 65 29 7b 0a 20 20 50 43  dr *pPage){.  PC
1f60: 61 63 68 65 20 2a 70 43 61 63 68 65 20 3d 20 70  ache *pCache = p
1f70: 50 61 67 65 2d 3e 70 43 61 63 68 65 3b 0a 20 20  Page->pCache;.  
1f80: 75 33 32 20 68 20 3d 20 70 50 61 67 65 2d 3e 70  u32 h = pPage->p
1f90: 67 6e 6f 20 25 20 70 43 61 63 68 65 2d 3e 6e 48  gno % pCache->nH
1fa0: 61 73 68 3b 0a 20 20 61 73 73 65 72 74 28 20 70  ash;.  assert( p
1fb0: 63 61 63 68 65 4d 75 74 65 78 48 65 6c 64 28 29  cacheMutexHeld()
1fc0: 20 29 3b 0a 20 20 70 50 61 67 65 2d 3e 70 4e 65   );.  pPage->pNe
1fd0: 78 74 48 61 73 68 20 3d 20 70 43 61 63 68 65 2d  xtHash = pCache-
1fe0: 3e 61 70 48 61 73 68 5b 68 5d 3b 0a 20 20 70 50  >apHash[h];.  pP
1ff0: 61 67 65 2d 3e 70 50 72 65 76 48 61 73 68 20 3d  age->pPrevHash =
2000: 20 30 3b 0a 20 20 69 66 28 20 70 43 61 63 68 65   0;.  if( pCache
2010: 2d 3e 61 70 48 61 73 68 5b 68 5d 20 29 7b 0a 20  ->apHash[h] ){. 
2020: 20 20 20 70 43 61 63 68 65 2d 3e 61 70 48 61 73     pCache->apHas
2030: 68 5b 68 5d 2d 3e 70 50 72 65 76 48 61 73 68 20  h[h]->pPrevHash 
2040: 3d 20 70 50 61 67 65 3b 0a 20 20 7d 0a 20 20 70  = pPage;.  }.  p
2050: 43 61 63 68 65 2d 3e 61 70 48 61 73 68 5b 68 5d  Cache->apHash[h]
2060: 20 3d 20 70 50 61 67 65 3b 0a 20 20 70 43 61 63   = pPage;.  pCac
2070: 68 65 2d 3e 6e 50 61 67 65 2b 2b 3b 0a 20 20 65  he->nPage++;.  e
2080: 78 70 65 6e 73 69 76 65 5f 61 73 73 65 72 74 28  xpensive_assert(
2090: 20 70 63 61 63 68 65 43 68 65 63 6b 48 61 73 68   pcacheCheckHash
20a0: 43 6f 75 6e 74 28 70 43 61 63 68 65 29 20 29 3b  Count(pCache) );
20b0: 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 41 74 74 65 6d 70  .}../*.** Attemp
20c0: 74 20 74 6f 20 69 6e 63 72 65 61 73 65 20 74 68  t to increase th
20d0: 65 20 73 69 7a 65 20 74 68 65 20 68 61 73 68 20  e size the hash 
20e0: 74 61 62 6c 65 20 74 6f 20 63 6f 6e 74 61 69 6e  table to contain
20f0: 0a 2a 2a 20 61 74 20 6c 65 61 73 74 20 6e 48 61  .** at least nHa
2100: 73 68 20 62 75 63 6b 65 74 73 2e 0a 2a 2f 0a 73  sh buckets..*/.s
2110: 74 61 74 69 63 20 69 6e 74 20 70 63 61 63 68 65  tatic int pcache
2120: 52 65 73 69 7a 65 48 61 73 68 28 50 43 61 63 68  ResizeHash(PCach
2130: 65 20 2a 70 43 61 63 68 65 2c 20 69 6e 74 20 6e  e *pCache, int n
2140: 48 61 73 68 29 7b 0a 20 20 50 67 48 64 72 20 2a  Hash){.  PgHdr *
2150: 70 3b 0a 20 20 50 67 48 64 72 20 2a 2a 70 4e 65  p;.  PgHdr **pNe
2160: 77 3b 0a 20 20 61 73 73 65 72 74 28 20 70 63 61  w;.  assert( pca
2170: 63 68 65 4d 75 74 65 78 48 65 6c 64 28 29 20 29  cheMutexHeld() )
2180: 3b 0a 23 69 66 64 65 66 20 53 51 4c 49 54 45 5f  ;.#ifdef SQLITE_
2190: 4d 41 4c 4c 4f 43 5f 53 4f 46 54 5f 4c 49 4d 49  MALLOC_SOFT_LIMI
21a0: 54 0a 20 20 69 66 28 20 6e 48 61 73 68 2a 73 69  T.  if( nHash*si
21b0: 7a 65 6f 66 28 50 67 48 64 72 2a 29 3e 53 51 4c  zeof(PgHdr*)>SQL
21c0: 49 54 45 5f 4d 41 4c 4c 4f 43 5f 53 4f 46 54 5f  ITE_MALLOC_SOFT_
21d0: 4c 49 4d 49 54 20 29 7b 0a 20 20 20 20 6e 48 61  LIMIT ){.    nHa
21e0: 73 68 20 3d 20 53 51 4c 49 54 45 5f 4d 41 4c 4c  sh = SQLITE_MALL
21f0: 4f 43 5f 53 4f 46 54 5f 4c 49 4d 49 54 2f 73 69  OC_SOFT_LIMIT/si
2200: 7a 65 6f 66 28 50 67 48 64 72 20 2a 29 3b 0a 20  zeof(PgHdr *);. 
2210: 20 7d 0a 23 65 6e 64 69 66 0a 20 20 70 63 61 63   }.#endif.  pcac
2220: 68 65 45 78 69 74 4d 75 74 65 78 28 29 3b 0a 20  heExitMutex();. 
2230: 20 70 4e 65 77 20 3d 20 28 50 67 48 64 72 20 2a   pNew = (PgHdr *
2240: 2a 29 73 71 6c 69 74 65 33 4d 61 6c 6c 6f 63 28  *)sqlite3Malloc(
2250: 73 69 7a 65 6f 66 28 50 67 48 64 72 2a 29 2a 6e  sizeof(PgHdr*)*n
2260: 48 61 73 68 29 3b 0a 20 20 70 63 61 63 68 65 45  Hash);.  pcacheE
2270: 6e 74 65 72 4d 75 74 65 78 28 29 3b 0a 20 20 69  nterMutex();.  i
2280: 66 28 20 21 70 4e 65 77 20 29 7b 0a 20 20 20 20  f( !pNew ){.    
2290: 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4e 4f  return SQLITE_NO
22a0: 4d 45 4d 3b 0a 20 20 7d 0a 20 20 6d 65 6d 73 65  MEM;.  }.  memse
22b0: 74 28 70 4e 65 77 2c 20 30 2c 20 73 69 7a 65 6f  t(pNew, 0, sizeo
22c0: 66 28 50 67 48 64 72 20 2a 29 2a 6e 48 61 73 68  f(PgHdr *)*nHash
22d0: 29 3b 0a 20 20 73 71 6c 69 74 65 33 5f 66 72 65  );.  sqlite3_fre
22e0: 65 28 70 43 61 63 68 65 2d 3e 61 70 48 61 73 68  e(pCache->apHash
22f0: 29 3b 0a 20 20 70 43 61 63 68 65 2d 3e 61 70 48  );.  pCache->apH
2300: 61 73 68 20 3d 20 70 4e 65 77 3b 0a 20 20 70 43  ash = pNew;.  pC
2310: 61 63 68 65 2d 3e 6e 48 61 73 68 20 3d 20 6e 48  ache->nHash = nH
2320: 61 73 68 3b 0a 20 20 70 43 61 63 68 65 2d 3e 6e  ash;.  pCache->n
2330: 50 61 67 65 20 3d 20 30 3b 0a 20 0a 20 20 66 6f  Page = 0;. .  fo
2340: 72 28 70 3d 70 43 61 63 68 65 2d 3e 70 43 6c 65  r(p=pCache->pCle
2350: 61 6e 3b 20 70 3b 20 70 3d 70 2d 3e 70 4e 65 78  an; p; p=p->pNex
2360: 74 29 7b 0a 20 20 20 20 70 63 61 63 68 65 41 64  t){.    pcacheAd
2370: 64 54 6f 48 61 73 68 28 70 29 3b 0a 20 20 7d 0a  dToHash(p);.  }.
2380: 20 20 66 6f 72 28 70 3d 70 43 61 63 68 65 2d 3e    for(p=pCache->
2390: 70 44 69 72 74 79 3b 20 70 3b 20 70 3d 70 2d 3e  pDirty; p; p=p->
23a0: 70 4e 65 78 74 29 7b 0a 20 20 20 20 70 63 61 63  pNext){.    pcac
23b0: 68 65 41 64 64 54 6f 48 61 73 68 28 70 29 3b 0a  heAddToHash(p);.
23c0: 20 20 7d 0a 20 20 72 65 74 75 72 6e 20 53 51 4c    }.  return SQL
23d0: 49 54 45 5f 4f 4b 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a  ITE_OK;.}../*.**
23e0: 20 52 65 6d 6f 76 65 20 61 20 70 61 67 65 20 66   Remove a page f
23f0: 72 6f 6d 20 61 20 6c 69 6e 6b 65 64 20 6c 69 73  rom a linked lis
2400: 74 20 74 68 61 74 20 69 73 20 68 65 61 64 65 64  t that is headed
2410: 20 62 79 20 2a 70 70 48 65 61 64 2e 0a 2a 2a 20   by *ppHead..** 
2420: 2a 70 70 48 65 61 64 20 69 73 20 65 69 74 68 65  *ppHead is eithe
2430: 72 20 50 43 61 63 68 65 2e 70 43 6c 65 61 6e 20  r PCache.pClean 
2440: 6f 72 20 50 43 61 63 68 65 2e 70 44 69 72 74 79  or PCache.pDirty
2450: 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 76 6f 69 64  ..*/.static void
2460: 20 70 63 61 63 68 65 52 65 6d 6f 76 65 46 72 6f   pcacheRemoveFro
2470: 6d 4c 69 73 74 28 50 67 48 64 72 20 2a 2a 70 70  mList(PgHdr **pp
2480: 48 65 61 64 2c 20 50 67 48 64 72 20 2a 70 50 61  Head, PgHdr *pPa
2490: 67 65 29 7b 0a 20 20 69 6e 74 20 69 73 44 69 72  ge){.  int isDir
24a0: 74 79 4c 69 73 74 20 3d 20 28 70 70 48 65 61 64  tyList = (ppHead
24b0: 3d 3d 26 70 50 61 67 65 2d 3e 70 43 61 63 68 65  ==&pPage->pCache
24c0: 2d 3e 70 44 69 72 74 79 29 3b 0a 20 20 61 73 73  ->pDirty);.  ass
24d0: 65 72 74 28 20 70 70 48 65 61 64 3d 3d 26 70 50  ert( ppHead==&pP
24e0: 61 67 65 2d 3e 70 43 61 63 68 65 2d 3e 70 43 6c  age->pCache->pCl
24f0: 65 61 6e 20 7c 7c 20 70 70 48 65 61 64 3d 3d 26  ean || ppHead==&
2500: 70 50 61 67 65 2d 3e 70 43 61 63 68 65 2d 3e 70  pPage->pCache->p
2510: 44 69 72 74 79 20 29 3b 0a 20 20 61 73 73 65 72  Dirty );.  asser
2520: 74 28 20 70 63 61 63 68 65 4d 75 74 65 78 48 65  t( pcacheMutexHe
2530: 6c 64 28 29 20 7c 7c 20 70 70 48 65 61 64 21 3d  ld() || ppHead!=
2540: 26 70 50 61 67 65 2d 3e 70 43 61 63 68 65 2d 3e  &pPage->pCache->
2550: 70 43 6c 65 61 6e 20 29 3b 0a 0a 20 20 69 66 28  pClean );..  if(
2560: 20 70 50 61 67 65 2d 3e 70 50 72 65 76 20 29 7b   pPage->pPrev ){
2570: 0a 20 20 20 20 70 50 61 67 65 2d 3e 70 50 72 65  .    pPage->pPre
2580: 76 2d 3e 70 4e 65 78 74 20 3d 20 70 50 61 67 65  v->pNext = pPage
2590: 2d 3e 70 4e 65 78 74 3b 0a 20 20 7d 65 6c 73 65  ->pNext;.  }else
25a0: 7b 0a 20 20 20 20 61 73 73 65 72 74 28 20 2a 70  {.    assert( *p
25b0: 70 48 65 61 64 3d 3d 70 50 61 67 65 20 29 3b 0a  pHead==pPage );.
25c0: 20 20 20 20 2a 70 70 48 65 61 64 20 3d 20 70 50      *ppHead = pP
25d0: 61 67 65 2d 3e 70 4e 65 78 74 3b 0a 20 20 7d 0a  age->pNext;.  }.
25e0: 20 20 69 66 28 20 70 50 61 67 65 2d 3e 70 4e 65    if( pPage->pNe
25f0: 78 74 20 29 7b 0a 20 20 20 20 70 50 61 67 65 2d  xt ){.    pPage-
2600: 3e 70 4e 65 78 74 2d 3e 70 50 72 65 76 20 3d 20  >pNext->pPrev = 
2610: 70 50 61 67 65 2d 3e 70 50 72 65 76 3b 0a 20 20  pPage->pPrev;.  
2620: 7d 0a 0a 20 20 69 66 28 20 69 73 44 69 72 74 79  }..  if( isDirty
2630: 4c 69 73 74 20 29 7b 0a 20 20 20 20 50 43 61 63  List ){.    PCac
2640: 68 65 20 2a 70 43 61 63 68 65 20 3d 20 70 50 61  he *pCache = pPa
2650: 67 65 2d 3e 70 43 61 63 68 65 3b 0a 20 20 20 20  ge->pCache;.    
2660: 61 73 73 65 72 74 28 20 70 50 61 67 65 2d 3e 70  assert( pPage->p
2670: 4e 65 78 74 20 7c 7c 20 70 43 61 63 68 65 2d 3e  Next || pCache->
2680: 70 44 69 72 74 79 54 61 69 6c 3d 3d 70 50 61 67  pDirtyTail==pPag
2690: 65 20 29 3b 0a 20 20 20 20 69 66 28 20 21 70 50  e );.    if( !pP
26a0: 61 67 65 2d 3e 70 4e 65 78 74 20 29 7b 0a 20 20  age->pNext ){.  
26b0: 20 20 20 20 70 43 61 63 68 65 2d 3e 70 44 69 72      pCache->pDir
26c0: 74 79 54 61 69 6c 20 3d 20 70 50 61 67 65 2d 3e  tyTail = pPage->
26d0: 70 50 72 65 76 3b 0a 20 20 20 20 7d 0a 20 20 20  pPrev;.    }.   
26e0: 20 69 66 28 20 70 43 61 63 68 65 2d 3e 70 53 79   if( pCache->pSy
26f0: 6e 63 65 64 3d 3d 70 50 61 67 65 20 29 7b 0a 20  nced==pPage ){. 
2700: 20 20 20 20 20 50 67 48 64 72 20 2a 70 53 79 6e       PgHdr *pSyn
2710: 63 65 64 20 3d 20 70 50 61 67 65 2d 3e 70 50 72  ced = pPage->pPr
2720: 65 76 3b 0a 20 20 20 20 20 20 77 68 69 6c 65 28  ev;.      while(
2730: 20 70 53 79 6e 63 65 64 20 26 26 20 28 70 53 79   pSynced && (pSy
2740: 6e 63 65 64 2d 3e 66 6c 61 67 73 26 50 47 48 44  nced->flags&PGHD
2750: 52 5f 4e 45 45 44 5f 53 59 4e 43 29 20 29 7b 0a  R_NEED_SYNC) ){.
2760: 20 20 20 20 20 20 20 20 70 53 79 6e 63 65 64 20          pSynced 
2770: 3d 20 70 53 79 6e 63 65 64 2d 3e 70 50 72 65 76  = pSynced->pPrev
2780: 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20  ;.      }.      
2790: 70 43 61 63 68 65 2d 3e 70 53 79 6e 63 65 64 20  pCache->pSynced 
27a0: 3d 20 70 53 79 6e 63 65 64 3b 0a 20 20 20 20 7d  = pSynced;.    }
27b0: 0a 20 20 7d 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 41 64  .  }.}../*.** Ad
27c0: 64 20 61 20 70 61 67 65 20 66 72 6f 6d 20 61 20  d a page from a 
27d0: 6c 69 6e 6b 65 64 20 6c 69 73 74 20 74 68 61 74  linked list that
27e0: 20 69 73 20 68 65 61 64 65 64 20 62 79 20 2a 70   is headed by *p
27f0: 70 48 65 61 64 2e 0a 2a 2a 20 2a 70 70 48 65 61  pHead..** *ppHea
2800: 64 20 69 73 20 65 69 74 68 65 72 20 50 43 61 63  d is either PCac
2810: 68 65 2e 70 43 6c 65 61 6e 20 6f 72 20 50 43 61  he.pClean or PCa
2820: 63 68 65 2e 70 44 69 72 74 79 2e 0a 2a 2f 0a 73  che.pDirty..*/.s
2830: 74 61 74 69 63 20 76 6f 69 64 20 70 63 61 63 68  tatic void pcach
2840: 65 41 64 64 54 6f 4c 69 73 74 28 50 67 48 64 72  eAddToList(PgHdr
2850: 20 2a 2a 70 70 48 65 61 64 2c 20 50 67 48 64 72   **ppHead, PgHdr
2860: 20 2a 70 50 61 67 65 29 7b 0a 20 20 69 6e 74 20   *pPage){.  int 
2870: 69 73 44 69 72 74 79 4c 69 73 74 20 3d 20 28 70  isDirtyList = (p
2880: 70 48 65 61 64 3d 3d 26 70 50 61 67 65 2d 3e 70  pHead==&pPage->p
2890: 43 61 63 68 65 2d 3e 70 44 69 72 74 79 29 3b 0a  Cache->pDirty);.
28a0: 20 20 61 73 73 65 72 74 28 20 70 70 48 65 61 64    assert( ppHead
28b0: 3d 3d 26 70 50 61 67 65 2d 3e 70 43 61 63 68 65  ==&pPage->pCache
28c0: 2d 3e 70 43 6c 65 61 6e 20 7c 7c 20 70 70 48 65  ->pClean || ppHe
28d0: 61 64 3d 3d 26 70 50 61 67 65 2d 3e 70 43 61 63  ad==&pPage->pCac
28e0: 68 65 2d 3e 70 44 69 72 74 79 20 29 3b 0a 0a 20  he->pDirty );.. 
28f0: 20 69 66 28 20 28 2a 70 70 48 65 61 64 29 20 29   if( (*ppHead) )
2900: 7b 0a 20 20 20 20 28 2a 70 70 48 65 61 64 29 2d  {.    (*ppHead)-
2910: 3e 70 50 72 65 76 20 3d 20 70 50 61 67 65 3b 0a  >pPrev = pPage;.
2920: 20 20 7d 0a 20 20 70 50 61 67 65 2d 3e 70 4e 65    }.  pPage->pNe
2930: 78 74 20 3d 20 2a 70 70 48 65 61 64 3b 0a 20 20  xt = *ppHead;.  
2940: 70 50 61 67 65 2d 3e 70 50 72 65 76 20 3d 20 30  pPage->pPrev = 0
2950: 3b 0a 20 20 2a 70 70 48 65 61 64 20 3d 20 70 50  ;.  *ppHead = pP
2960: 61 67 65 3b 0a 0a 20 20 69 66 28 20 69 73 44 69  age;..  if( isDi
2970: 72 74 79 4c 69 73 74 20 29 7b 0a 20 20 20 20 50  rtyList ){.    P
2980: 43 61 63 68 65 20 2a 70 43 61 63 68 65 20 3d 20  Cache *pCache = 
2990: 70 50 61 67 65 2d 3e 70 43 61 63 68 65 3b 0a 20  pPage->pCache;. 
29a0: 20 20 20 69 66 28 20 21 70 43 61 63 68 65 2d 3e     if( !pCache->
29b0: 70 44 69 72 74 79 54 61 69 6c 20 29 7b 0a 20 20  pDirtyTail ){.  
29c0: 20 20 20 20 61 73 73 65 72 74 28 20 70 50 61 67      assert( pPag
29d0: 65 2d 3e 70 4e 65 78 74 3d 3d 30 20 29 3b 0a 20  e->pNext==0 );. 
29e0: 20 20 20 20 20 70 43 61 63 68 65 2d 3e 70 44 69       pCache->pDi
29f0: 72 74 79 54 61 69 6c 20 3d 20 70 50 61 67 65 3b  rtyTail = pPage;
2a00: 0a 20 20 20 20 7d 0a 20 20 20 20 69 66 28 20 21  .    }.    if( !
2a10: 70 43 61 63 68 65 2d 3e 70 53 79 6e 63 65 64 20  pCache->pSynced 
2a20: 26 26 20 30 3d 3d 28 70 50 61 67 65 2d 3e 66 6c  && 0==(pPage->fl
2a30: 61 67 73 26 50 47 48 44 52 5f 4e 45 45 44 5f 53  ags&PGHDR_NEED_S
2a40: 59 4e 43 29 20 29 7b 0a 20 20 20 20 20 20 70 43  YNC) ){.      pC
2a50: 61 63 68 65 2d 3e 70 53 79 6e 63 65 64 20 3d 20  ache->pSynced = 
2a60: 70 50 61 67 65 3b 0a 20 20 20 20 7d 0a 20 20 7d  pPage;.    }.  }
2a70: 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 52 65 6d 6f 76 65  .}../*.** Remove
2a80: 20 61 20 70 61 67 65 20 66 72 6f 6d 20 74 68 65   a page from the
2a90: 20 67 6c 6f 62 61 6c 20 4c 52 55 20 6c 69 73 74   global LRU list
2aa0: 0a 2a 2f 0a 73 74 61 74 69 63 20 76 6f 69 64 20  .*/.static void 
2ab0: 70 63 61 63 68 65 52 65 6d 6f 76 65 46 72 6f 6d  pcacheRemoveFrom
2ac0: 4c 72 75 4c 69 73 74 28 50 67 48 64 72 20 2a 70  LruList(PgHdr *p
2ad0: 50 61 67 65 29 7b 0a 20 20 61 73 73 65 72 74 28  Page){.  assert(
2ae0: 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 68   sqlite3_mutex_h
2af0: 65 6c 64 28 70 63 61 63 68 65 5f 67 2e 6d 75 74  eld(pcache_g.mut
2b00: 65 78 29 20 29 3b 0a 20 20 61 73 73 65 72 74 28  ex) );.  assert(
2b10: 20 28 70 50 61 67 65 2d 3e 66 6c 61 67 73 26 50   (pPage->flags&P
2b20: 47 48 44 52 5f 44 49 52 54 59 29 3d 3d 30 20 29  GHDR_DIRTY)==0 )
2b30: 3b 0a 20 20 69 66 28 20 70 50 61 67 65 2d 3e 70  ;.  if( pPage->p
2b40: 43 61 63 68 65 2d 3e 62 50 75 72 67 65 61 62 6c  Cache->bPurgeabl
2b50: 65 3d 3d 30 20 29 20 72 65 74 75 72 6e 3b 0a 20  e==0 ) return;. 
2b60: 20 69 66 28 20 70 50 61 67 65 2d 3e 70 4e 65 78   if( pPage->pNex
2b70: 74 4c 72 75 20 29 7b 0a 20 20 20 20 61 73 73 65  tLru ){.    asse
2b80: 72 74 28 20 70 63 61 63 68 65 5f 67 2e 70 4c 72  rt( pcache_g.pLr
2b90: 75 54 61 69 6c 21 3d 70 50 61 67 65 20 29 3b 0a  uTail!=pPage );.
2ba0: 20 20 20 20 70 50 61 67 65 2d 3e 70 4e 65 78 74      pPage->pNext
2bb0: 4c 72 75 2d 3e 70 50 72 65 76 4c 72 75 20 3d 20  Lru->pPrevLru = 
2bc0: 70 50 61 67 65 2d 3e 70 50 72 65 76 4c 72 75 3b  pPage->pPrevLru;
2bd0: 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 61 73  .  }else{.    as
2be0: 73 65 72 74 28 20 70 63 61 63 68 65 5f 67 2e 70  sert( pcache_g.p
2bf0: 4c 72 75 54 61 69 6c 3d 3d 70 50 61 67 65 20 29  LruTail==pPage )
2c00: 3b 0a 20 20 20 20 70 63 61 63 68 65 5f 67 2e 70  ;.    pcache_g.p
2c10: 4c 72 75 54 61 69 6c 20 3d 20 70 50 61 67 65 2d  LruTail = pPage-
2c20: 3e 70 50 72 65 76 4c 72 75 3b 0a 20 20 7d 0a 20  >pPrevLru;.  }. 
2c30: 20 69 66 28 20 70 50 61 67 65 2d 3e 70 50 72 65   if( pPage->pPre
2c40: 76 4c 72 75 20 29 7b 0a 20 20 20 20 61 73 73 65  vLru ){.    asse
2c50: 72 74 28 20 70 63 61 63 68 65 5f 67 2e 70 4c 72  rt( pcache_g.pLr
2c60: 75 48 65 61 64 21 3d 70 50 61 67 65 20 29 3b 0a  uHead!=pPage );.
2c70: 20 20 20 20 70 50 61 67 65 2d 3e 70 50 72 65 76      pPage->pPrev
2c80: 4c 72 75 2d 3e 70 4e 65 78 74 4c 72 75 20 3d 20  Lru->pNextLru = 
2c90: 70 50 61 67 65 2d 3e 70 4e 65 78 74 4c 72 75 3b  pPage->pNextLru;
2ca0: 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 61 73  .  }else{.    as
2cb0: 73 65 72 74 28 20 70 63 61 63 68 65 5f 67 2e 70  sert( pcache_g.p
2cc0: 4c 72 75 48 65 61 64 3d 3d 70 50 61 67 65 20 29  LruHead==pPage )
2cd0: 3b 0a 20 20 20 20 70 63 61 63 68 65 5f 67 2e 70  ;.    pcache_g.p
2ce0: 4c 72 75 48 65 61 64 20 3d 20 70 50 61 67 65 2d  LruHead = pPage-
2cf0: 3e 70 4e 65 78 74 4c 72 75 3b 0a 20 20 7d 0a 7d  >pNextLru;.  }.}
2d00: 0a 0a 2f 2a 0a 2a 2a 20 41 64 64 20 61 20 70 61  ../*.** Add a pa
2d10: 67 65 20 74 6f 20 74 68 65 20 67 6c 6f 62 61 6c  ge to the global
2d20: 20 4c 52 55 20 6c 69 73 74 2e 20 20 54 68 65 20   LRU list.  The 
2d30: 70 61 67 65 20 69 73 20 6e 6f 72 6d 61 6c 6c 79  page is normally
2d40: 20 61 64 64 65 64 0a 2a 2a 20 74 6f 20 74 68 65   added.** to the
2d50: 20 66 72 6f 6e 74 20 6f 66 20 74 68 65 20 6c 69   front of the li
2d60: 73 74 20 73 6f 20 74 68 61 74 20 69 74 20 77 69  st so that it wi
2d70: 6c 6c 20 62 65 20 74 68 65 20 6c 61 73 74 20 70  ll be the last p
2d80: 61 67 65 20 72 65 63 79 63 6c 65 64 2e 0a 2a 2a  age recycled..**
2d90: 20 48 6f 77 65 76 65 72 2c 20 69 66 20 74 68 65   However, if the
2da0: 20 50 47 48 44 52 5f 52 45 55 53 45 5f 55 4e 4c   PGHDR_REUSE_UNL
2db0: 49 4b 45 4c 59 20 62 69 74 20 69 73 20 73 65 74  IKELY bit is set
2dc0: 2c 20 74 68 65 20 70 61 67 65 20 69 73 20 61 64  , the page is ad
2dd0: 64 65 64 0a 2a 2a 20 74 6f 20 74 68 65 20 65 6e  ded.** to the en
2de0: 64 20 6f 66 20 74 68 65 20 4c 52 55 20 6c 69 73  d of the LRU lis
2df0: 74 20 73 6f 20 74 68 61 74 20 69 74 20 77 69 6c  t so that it wil
2e00: 6c 20 62 65 20 74 68 65 20 6e 65 78 74 20 74 6f  l be the next to
2e10: 20 62 65 20 72 65 63 79 63 6c 65 64 2e 0a 2a 2f   be recycled..*/
2e20: 0a 73 74 61 74 69 63 20 76 6f 69 64 20 70 63 61  .static void pca
2e30: 63 68 65 41 64 64 54 6f 4c 72 75 4c 69 73 74 28  cheAddToLruList(
2e40: 50 67 48 64 72 20 2a 70 50 61 67 65 29 7b 0a 20  PgHdr *pPage){. 
2e50: 20 61 73 73 65 72 74 28 20 73 71 6c 69 74 65 33   assert( sqlite3
2e60: 5f 6d 75 74 65 78 5f 68 65 6c 64 28 70 63 61 63  _mutex_held(pcac
2e70: 68 65 5f 67 2e 6d 75 74 65 78 29 20 29 3b 0a 20  he_g.mutex) );. 
2e80: 20 61 73 73 65 72 74 28 20 28 70 50 61 67 65 2d   assert( (pPage-
2e90: 3e 66 6c 61 67 73 26 50 47 48 44 52 5f 44 49 52  >flags&PGHDR_DIR
2ea0: 54 59 29 3d 3d 30 20 29 3b 0a 20 20 69 66 28 20  TY)==0 );.  if( 
2eb0: 70 50 61 67 65 2d 3e 70 43 61 63 68 65 2d 3e 62  pPage->pCache->b
2ec0: 50 75 72 67 65 61 62 6c 65 3d 3d 30 20 29 20 72  Purgeable==0 ) r
2ed0: 65 74 75 72 6e 3b 0a 20 20 69 66 28 20 70 63 61  eturn;.  if( pca
2ee0: 63 68 65 5f 67 2e 70 4c 72 75 54 61 69 6c 20 26  che_g.pLruTail &
2ef0: 26 20 28 70 50 61 67 65 2d 3e 66 6c 61 67 73 20  & (pPage->flags 
2f00: 26 20 50 47 48 44 52 5f 52 45 55 53 45 5f 55 4e  & PGHDR_REUSE_UN
2f10: 4c 49 4b 45 4c 59 29 21 3d 30 20 29 7b 0a 20 20  LIKELY)!=0 ){.  
2f20: 20 20 2f 2a 20 49 66 20 72 65 75 73 65 20 69 73    /* If reuse is
2f30: 20 75 6e 6c 69 6b 65 6c 79 2e 20 20 50 75 74 20   unlikely.  Put 
2f40: 74 68 65 20 70 61 67 65 20 61 74 20 74 68 65 20  the page at the 
2f50: 65 6e 64 20 6f 66 20 74 68 65 20 4c 52 55 20 6c  end of the LRU l
2f60: 69 73 74 0a 20 20 20 20 2a 2a 20 77 68 65 72 65  ist.    ** where
2f70: 20 69 74 20 77 69 6c 6c 20 62 65 20 72 65 63 79   it will be recy
2f80: 63 6c 65 64 20 73 6f 6f 6e 65 72 20 72 61 74 68  cled sooner rath
2f90: 65 72 20 74 68 61 6e 20 6c 61 74 65 72 2e 20 0a  er than later. .
2fa0: 20 20 20 20 2a 2f 0a 20 20 20 20 61 73 73 65 72      */.    asser
2fb0: 74 28 20 70 63 61 63 68 65 5f 67 2e 70 4c 72 75  t( pcache_g.pLru
2fc0: 48 65 61 64 20 29 3b 0a 20 20 20 20 70 50 61 67  Head );.    pPag
2fd0: 65 2d 3e 70 4e 65 78 74 4c 72 75 20 3d 20 30 3b  e->pNextLru = 0;
2fe0: 0a 20 20 20 20 70 50 61 67 65 2d 3e 70 50 72 65  .    pPage->pPre
2ff0: 76 4c 72 75 20 3d 20 70 63 61 63 68 65 5f 67 2e  vLru = pcache_g.
3000: 70 4c 72 75 54 61 69 6c 3b 0a 20 20 20 20 70 63  pLruTail;.    pc
3010: 61 63 68 65 5f 67 2e 70 4c 72 75 54 61 69 6c 2d  ache_g.pLruTail-
3020: 3e 70 4e 65 78 74 4c 72 75 20 3d 20 70 50 61 67  >pNextLru = pPag
3030: 65 3b 0a 20 20 20 20 70 63 61 63 68 65 5f 67 2e  e;.    pcache_g.
3040: 70 4c 72 75 54 61 69 6c 20 3d 20 70 50 61 67 65  pLruTail = pPage
3050: 3b 0a 20 20 20 20 70 50 61 67 65 2d 3e 66 6c 61  ;.    pPage->fla
3060: 67 73 20 26 3d 20 7e 50 47 48 44 52 5f 52 45 55  gs &= ~PGHDR_REU
3070: 53 45 5f 55 4e 4c 49 4b 45 4c 59 3b 0a 20 20 7d  SE_UNLIKELY;.  }
3080: 65 6c 73 65 7b 0a 20 20 20 20 2f 2a 20 49 66 20  else{.    /* If 
3090: 72 65 75 73 65 20 69 73 20 70 6f 73 73 69 62 6c  reuse is possibl
30a0: 65 2e 20 74 68 65 20 70 61 67 65 20 67 6f 65 73  e. the page goes
30b0: 20 61 74 20 74 68 65 20 62 65 67 69 6e 6e 69 6e   at the beginnin
30c0: 67 20 6f 66 20 74 68 65 20 4c 52 55 0a 20 20 20  g of the LRU.   
30d0: 20 2a 2a 20 6c 69 73 74 20 73 6f 20 74 68 61 74   ** list so that
30e0: 20 69 74 20 77 69 6c 6c 20 62 65 20 74 68 65 20   it will be the 
30f0: 6c 61 73 74 20 74 6f 20 62 65 20 72 65 63 79 63  last to be recyc
3100: 6c 65 64 2e 0a 20 20 20 20 2a 2f 0a 20 20 20 20  led..    */.    
3110: 69 66 28 20 70 63 61 63 68 65 5f 67 2e 70 4c 72  if( pcache_g.pLr
3120: 75 48 65 61 64 20 29 7b 0a 20 20 20 20 20 20 70  uHead ){.      p
3130: 63 61 63 68 65 5f 67 2e 70 4c 72 75 48 65 61 64  cache_g.pLruHead
3140: 2d 3e 70 50 72 65 76 4c 72 75 20 3d 20 70 50 61  ->pPrevLru = pPa
3150: 67 65 3b 0a 20 20 20 20 7d 0a 20 20 20 20 70 50  ge;.    }.    pP
3160: 61 67 65 2d 3e 70 4e 65 78 74 4c 72 75 20 3d 20  age->pNextLru = 
3170: 70 63 61 63 68 65 5f 67 2e 70 4c 72 75 48 65 61  pcache_g.pLruHea
3180: 64 3b 0a 20 20 20 20 70 63 61 63 68 65 5f 67 2e  d;.    pcache_g.
3190: 70 4c 72 75 48 65 61 64 20 3d 20 70 50 61 67 65  pLruHead = pPage
31a0: 3b 0a 20 20 20 20 70 50 61 67 65 2d 3e 70 50 72  ;.    pPage->pPr
31b0: 65 76 4c 72 75 20 3d 20 30 3b 0a 20 20 20 20 69  evLru = 0;.    i
31c0: 66 28 20 70 63 61 63 68 65 5f 67 2e 70 4c 72 75  f( pcache_g.pLru
31d0: 54 61 69 6c 3d 3d 30 20 29 7b 0a 20 20 20 20 20  Tail==0 ){.     
31e0: 20 70 63 61 63 68 65 5f 67 2e 70 4c 72 75 54 61   pcache_g.pLruTa
31f0: 69 6c 20 3d 20 70 50 61 67 65 3b 0a 20 20 20 20  il = pPage;.    
3200: 7d 0a 20 20 7d 0a 7d 0a 0a 2f 2a 2a 2a 2a 2a 2a  }.  }.}../******
3210: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
3220: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
3230: 2a 2a 2a 2a 2a 2a 2a 2a 2a 20 4d 65 6d 6f 72 79  ********* Memory
3240: 20 41 6c 6c 6f 63 61 74 69 6f 6e 20 2a 2a 2a 2a   Allocation ****
3250: 2a 2a 2a 2a 2a 2a 2a 0a 2a 2a 0a 2a 2a 20 49 6e  *******.**.** In
3260: 69 74 69 61 6c 69 7a 65 20 74 68 65 20 70 61 67  itialize the pag
3270: 65 20 63 61 63 68 65 20 6d 65 6d 6f 72 79 20 70  e cache memory p
3280: 6f 6f 6c 2e 0a 2a 2a 0a 2a 2a 20 54 68 69 73 20  ool..**.** This 
3290: 6d 75 73 74 20 62 65 20 63 61 6c 6c 65 64 20 61  must be called a
32a0: 74 20 73 74 61 72 74 2d 74 69 6d 65 20 77 68 65  t start-time whe
32b0: 6e 20 6e 6f 20 70 61 67 65 20 63 61 63 68 65 20  n no page cache 
32c0: 6c 69 6e 65 73 20 61 72 65 0a 2a 2a 20 63 68 65  lines are.** che
32d0: 63 6b 65 64 20 6f 75 74 2e 20 54 68 69 73 20 66  cked out. This f
32e0: 75 6e 63 74 69 6f 6e 20 69 73 20 6e 6f 74 20 74  unction is not t
32f0: 68 72 65 61 64 73 61 66 65 2e 0a 2a 2f 0a 76 6f  hreadsafe..*/.vo
3300: 69 64 20 73 71 6c 69 74 65 33 50 43 61 63 68 65  id sqlite3PCache
3310: 42 75 66 66 65 72 53 65 74 75 70 28 76 6f 69 64  BufferSetup(void
3320: 20 2a 70 42 75 66 2c 20 69 6e 74 20 73 7a 2c 20   *pBuf, int sz, 
3330: 69 6e 74 20 6e 29 7b 0a 20 20 50 67 46 72 65 65  int n){.  PgFree
3340: 73 6c 6f 74 20 2a 70 3b 0a 20 20 73 7a 20 26 3d  slot *p;.  sz &=
3350: 20 7e 37 3b 0a 20 20 70 63 61 63 68 65 5f 67 2e   ~7;.  pcache_g.
3360: 73 7a 53 6c 6f 74 20 3d 20 73 7a 3b 0a 20 20 70  szSlot = sz;.  p
3370: 63 61 63 68 65 5f 67 2e 70 53 74 61 72 74 20 3d  cache_g.pStart =
3380: 20 70 42 75 66 3b 0a 20 20 70 63 61 63 68 65 5f   pBuf;.  pcache_
3390: 67 2e 70 46 72 65 65 20 3d 20 30 3b 0a 20 20 77  g.pFree = 0;.  w
33a0: 68 69 6c 65 28 20 6e 2d 2d 20 29 7b 0a 20 20 20  hile( n-- ){.   
33b0: 20 70 20 3d 20 28 50 67 46 72 65 65 73 6c 6f 74   p = (PgFreeslot
33c0: 2a 29 70 42 75 66 3b 0a 20 20 20 20 70 2d 3e 70  *)pBuf;.    p->p
33d0: 4e 65 78 74 20 3d 20 70 63 61 63 68 65 5f 67 2e  Next = pcache_g.
33e0: 70 46 72 65 65 3b 0a 20 20 20 20 70 63 61 63 68  pFree;.    pcach
33f0: 65 5f 67 2e 70 46 72 65 65 20 3d 20 70 3b 0a 20  e_g.pFree = p;. 
3400: 20 20 20 70 42 75 66 20 3d 20 28 76 6f 69 64 2a     pBuf = (void*
3410: 29 26 28 28 63 68 61 72 2a 29 70 42 75 66 29 5b  )&((char*)pBuf)[
3420: 73 7a 5d 3b 0a 20 20 7d 0a 20 20 70 63 61 63 68  sz];.  }.  pcach
3430: 65 5f 67 2e 70 45 6e 64 20 3d 20 70 42 75 66 3b  e_g.pEnd = pBuf;
3440: 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 41 6c 6c 6f 63 61  .}../*.** Alloca
3450: 74 65 20 61 20 70 61 67 65 20 63 61 63 68 65 20  te a page cache 
3460: 6c 69 6e 65 2e 20 20 4c 6f 6f 6b 20 69 6e 20 74  line.  Look in t
3470: 68 65 20 70 61 67 65 20 63 61 63 68 65 20 6d 65  he page cache me
3480: 6d 6f 72 79 20 70 6f 6f 6c 20 66 69 72 73 74 0a  mory pool first.
3490: 2a 2a 20 61 6e 64 20 75 73 65 20 61 6e 20 65 6c  ** and use an el
34a0: 65 6d 65 6e 74 20 66 72 6f 6d 20 69 74 20 66 69  ement from it fi
34b0: 72 73 74 20 69 66 20 61 76 61 69 6c 61 62 6c 65  rst if available
34c0: 2e 20 20 49 66 20 6e 6f 74 68 69 6e 67 20 69 73  .  If nothing is
34d0: 20 61 76 61 69 6c 61 62 6c 65 0a 2a 2a 20 69 6e   available.** in
34e0: 20 74 68 65 20 70 61 67 65 20 63 61 63 68 65 20   the page cache 
34f0: 6d 65 6d 6f 72 79 20 70 6f 6f 6c 2c 20 67 6f 20  memory pool, go 
3500: 74 6f 20 74 68 65 20 67 65 6e 65 72 61 6c 20 70  to the general p
3510: 75 72 70 6f 73 65 20 6d 65 6d 6f 72 79 20 61 6c  urpose memory al
3520: 6c 6f 63 61 74 6f 72 2e 0a 2a 2f 0a 76 6f 69 64  locator..*/.void
3530: 20 2a 70 63 61 63 68 65 4d 61 6c 6c 6f 63 28 69   *pcacheMalloc(i
3540: 6e 74 20 73 7a 2c 20 50 43 61 63 68 65 20 2a 70  nt sz, PCache *p
3550: 43 61 63 68 65 29 7b 0a 20 20 61 73 73 65 72 74  Cache){.  assert
3560: 28 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f  ( sqlite3_mutex_
3570: 68 65 6c 64 28 70 63 61 63 68 65 5f 67 2e 6d 75  held(pcache_g.mu
3580: 74 65 78 29 20 29 3b 0a 20 20 69 66 28 20 73 7a  tex) );.  if( sz
3590: 3c 3d 70 63 61 63 68 65 5f 67 2e 73 7a 53 6c 6f  <=pcache_g.szSlo
35a0: 74 20 26 26 20 70 63 61 63 68 65 5f 67 2e 70 46  t && pcache_g.pF
35b0: 72 65 65 20 29 7b 0a 20 20 20 20 50 67 46 72 65  ree ){.    PgFre
35c0: 65 73 6c 6f 74 20 2a 70 20 3d 20 70 63 61 63 68  eslot *p = pcach
35d0: 65 5f 67 2e 70 46 72 65 65 3b 0a 20 20 20 20 70  e_g.pFree;.    p
35e0: 63 61 63 68 65 5f 67 2e 70 46 72 65 65 20 3d 20  cache_g.pFree = 
35f0: 70 2d 3e 70 4e 65 78 74 3b 0a 20 20 20 20 73 71  p->pNext;.    sq
3600: 6c 69 74 65 33 53 74 61 74 75 73 53 65 74 28 53  lite3StatusSet(S
3610: 51 4c 49 54 45 5f 53 54 41 54 55 53 5f 50 41 47  QLITE_STATUS_PAG
3620: 45 43 41 43 48 45 5f 53 49 5a 45 2c 20 73 7a 29  ECACHE_SIZE, sz)
3630: 3b 0a 20 20 20 20 73 71 6c 69 74 65 33 53 74 61  ;.    sqlite3Sta
3640: 74 75 73 41 64 64 28 53 51 4c 49 54 45 5f 53 54  tusAdd(SQLITE_ST
3650: 41 54 55 53 5f 50 41 47 45 43 41 43 48 45 5f 55  ATUS_PAGECACHE_U
3660: 53 45 44 2c 20 31 29 3b 0a 20 20 20 20 72 65 74  SED, 1);.    ret
3670: 75 72 6e 20 28 76 6f 69 64 2a 29 70 3b 0a 20 20  urn (void*)p;.  
3680: 7d 65 6c 73 65 7b 0a 20 20 20 20 76 6f 69 64 20  }else{.    void 
3690: 2a 70 3b 0a 0a 20 20 20 20 2f 2a 20 41 6c 6c 6f  *p;..    /* Allo
36a0: 63 61 74 65 20 61 20 6e 65 77 20 62 75 66 66 65  cate a new buffe
36b0: 72 20 75 73 69 6e 67 20 73 71 6c 69 74 65 33 4d  r using sqlite3M
36c0: 61 6c 6c 6f 63 2e 20 42 65 66 6f 72 65 20 64 6f  alloc. Before do
36d0: 69 6e 67 20 73 6f 2c 20 65 78 69 74 20 74 68 65  ing so, exit the
36e0: 0a 20 20 20 20 2a 2a 20 67 6c 6f 62 61 6c 20 70  .    ** global p
36f0: 63 61 63 68 65 20 6d 75 74 65 78 20 61 6e 64 20  cache mutex and 
3700: 75 6e 6c 6f 63 6b 20 74 68 65 20 70 61 67 65 72  unlock the pager
3710: 2d 63 61 63 68 65 20 6f 62 6a 65 63 74 20 70 43  -cache object pC
3720: 61 63 68 65 2e 20 54 68 69 73 20 69 73 20 0a 20  ache. This is . 
3730: 20 20 20 2a 2a 20 73 6f 20 74 68 61 74 20 69 66     ** so that if
3740: 20 74 68 65 20 61 74 74 65 6d 70 74 20 74 6f 20   the attempt to 
3750: 61 6c 6c 6f 63 61 74 65 20 61 20 6e 65 77 20 62  allocate a new b
3760: 75 66 66 65 72 20 63 61 75 73 65 73 20 74 68 65  uffer causes the
3770: 20 74 68 65 20 0a 20 20 20 20 2a 2a 20 63 6f 6e   the .    ** con
3780: 66 69 67 75 72 65 64 20 73 6f 66 74 2d 68 65 61  figured soft-hea
3790: 70 2d 6c 69 6d 69 74 20 74 6f 20 62 65 20 62 72  p-limit to be br
37a0: 65 61 63 68 65 64 2c 20 69 74 20 77 69 6c 6c 20  eached, it will 
37b0: 62 65 20 70 6f 73 73 69 62 6c 65 20 74 6f 0a 20  be possible to. 
37c0: 20 20 20 2a 2a 20 72 65 63 6c 61 69 6d 20 6d 65     ** reclaim me
37d0: 6d 6f 72 79 20 66 72 6f 6d 20 74 68 69 73 20 70  mory from this p
37e0: 61 67 65 72 2d 63 61 63 68 65 2e 0a 20 20 20 20  ager-cache..    
37f0: 2a 2f 0a 20 20 20 20 70 63 61 63 68 65 45 78 69  */.    pcacheExi
3800: 74 4d 75 74 65 78 28 29 3b 0a 20 20 20 20 70 20  tMutex();.    p 
3810: 3d 20 73 71 6c 69 74 65 33 4d 61 6c 6c 6f 63 28  = sqlite3Malloc(
3820: 73 7a 29 3b 0a 20 20 20 20 70 63 61 63 68 65 45  sz);.    pcacheE
3830: 6e 74 65 72 4d 75 74 65 78 28 29 3b 0a 0a 20 20  nterMutex();..  
3840: 20 20 69 66 28 20 70 20 29 7b 0a 20 20 20 20 20    if( p ){.     
3850: 20 73 7a 20 3d 20 73 71 6c 69 74 65 33 4d 61 6c   sz = sqlite3Mal
3860: 6c 6f 63 53 69 7a 65 28 70 29 3b 0a 20 20 20 20  locSize(p);.    
3870: 20 20 73 71 6c 69 74 65 33 53 74 61 74 75 73 41    sqlite3StatusA
3880: 64 64 28 53 51 4c 49 54 45 5f 53 54 41 54 55 53  dd(SQLITE_STATUS
3890: 5f 50 41 47 45 43 41 43 48 45 5f 4f 56 45 52 46  _PAGECACHE_OVERF
38a0: 4c 4f 57 2c 20 73 7a 29 3b 0a 20 20 20 20 7d 0a  LOW, sz);.    }.
38b0: 20 20 20 20 72 65 74 75 72 6e 20 70 3b 0a 20 20      return p;.  
38c0: 7d 0a 7d 0a 76 6f 69 64 20 2a 73 71 6c 69 74 65  }.}.void *sqlite
38d0: 33 50 61 67 65 4d 61 6c 6c 6f 63 28 69 6e 74 20  3PageMalloc(int 
38e0: 73 7a 29 7b 0a 20 20 76 6f 69 64 20 2a 70 3b 0a  sz){.  void *p;.
38f0: 20 20 70 63 61 63 68 65 45 6e 74 65 72 4d 75 74    pcacheEnterMut
3900: 65 78 28 29 3b 0a 20 20 70 20 3d 20 70 63 61 63  ex();.  p = pcac
3910: 68 65 4d 61 6c 6c 6f 63 28 73 7a 2c 20 30 29 3b  heMalloc(sz, 0);
3920: 0a 20 20 70 63 61 63 68 65 45 78 69 74 4d 75 74  .  pcacheExitMut
3930: 65 78 28 29 3b 0a 20 20 72 65 74 75 72 6e 20 70  ex();.  return p
3940: 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 52 65 6c 65 61  ;.}../*.** Relea
3950: 73 65 20 61 20 70 61 67 65 72 20 6d 65 6d 6f 72  se a pager memor
3960: 79 20 61 6c 6c 6f 63 61 74 69 6f 6e 0a 2a 2f 0a  y allocation.*/.
3970: 76 6f 69 64 20 70 63 61 63 68 65 46 72 65 65 28  void pcacheFree(
3980: 76 6f 69 64 20 2a 70 29 7b 0a 20 20 61 73 73 65  void *p){.  asse
3990: 72 74 28 20 73 71 6c 69 74 65 33 5f 6d 75 74 65  rt( sqlite3_mute
39a0: 78 5f 68 65 6c 64 28 70 63 61 63 68 65 5f 67 2e  x_held(pcache_g.
39b0: 6d 75 74 65 78 29 20 29 3b 0a 20 20 69 66 28 20  mutex) );.  if( 
39c0: 70 3d 3d 30 20 29 20 72 65 74 75 72 6e 3b 0a 20  p==0 ) return;. 
39d0: 20 69 66 28 20 70 3e 3d 70 63 61 63 68 65 5f 67   if( p>=pcache_g
39e0: 2e 70 53 74 61 72 74 20 26 26 20 70 3c 70 63 61  .pStart && p<pca
39f0: 63 68 65 5f 67 2e 70 45 6e 64 20 29 7b 0a 20 20  che_g.pEnd ){.  
3a00: 20 20 50 67 46 72 65 65 73 6c 6f 74 20 2a 70 53    PgFreeslot *pS
3a10: 6c 6f 74 3b 0a 20 20 20 20 73 71 6c 69 74 65 33  lot;.    sqlite3
3a20: 53 74 61 74 75 73 41 64 64 28 53 51 4c 49 54 45  StatusAdd(SQLITE
3a30: 5f 53 54 41 54 55 53 5f 50 41 47 45 43 41 43 48  _STATUS_PAGECACH
3a40: 45 5f 55 53 45 44 2c 20 2d 31 29 3b 0a 20 20 20  E_USED, -1);.   
3a50: 20 70 53 6c 6f 74 20 3d 20 28 50 67 46 72 65 65   pSlot = (PgFree
3a60: 73 6c 6f 74 2a 29 70 3b 0a 20 20 20 20 70 53 6c  slot*)p;.    pSl
3a70: 6f 74 2d 3e 70 4e 65 78 74 20 3d 20 70 63 61 63  ot->pNext = pcac
3a80: 68 65 5f 67 2e 70 46 72 65 65 3b 0a 20 20 20 20  he_g.pFree;.    
3a90: 70 63 61 63 68 65 5f 67 2e 70 46 72 65 65 20 3d  pcache_g.pFree =
3aa0: 20 70 53 6c 6f 74 3b 0a 20 20 7d 65 6c 73 65 7b   pSlot;.  }else{
3ab0: 0a 20 20 20 20 69 6e 74 20 69 53 69 7a 65 20 3d  .    int iSize =
3ac0: 20 73 71 6c 69 74 65 33 4d 61 6c 6c 6f 63 53 69   sqlite3MallocSi
3ad0: 7a 65 28 70 29 3b 0a 20 20 20 20 73 71 6c 69 74  ze(p);.    sqlit
3ae0: 65 33 53 74 61 74 75 73 41 64 64 28 53 51 4c 49  e3StatusAdd(SQLI
3af0: 54 45 5f 53 54 41 54 55 53 5f 50 41 47 45 43 41  TE_STATUS_PAGECA
3b00: 43 48 45 5f 4f 56 45 52 46 4c 4f 57 2c 20 2d 69  CHE_OVERFLOW, -i
3b10: 53 69 7a 65 29 3b 0a 20 20 20 20 73 71 6c 69 74  Size);.    sqlit
3b20: 65 33 5f 66 72 65 65 28 70 29 3b 0a 20 20 7d 0a  e3_free(p);.  }.
3b30: 7d 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 50 61  }.void sqlite3Pa
3b40: 67 65 46 72 65 65 28 76 6f 69 64 20 2a 70 29 7b  geFree(void *p){
3b50: 0a 20 20 70 63 61 63 68 65 45 6e 74 65 72 4d 75  .  pcacheEnterMu
3b60: 74 65 78 28 29 3b 0a 20 20 70 63 61 63 68 65 46  tex();.  pcacheF
3b70: 72 65 65 28 70 29 3b 0a 20 20 70 63 61 63 68 65  ree(p);.  pcache
3b80: 45 78 69 74 4d 75 74 65 78 28 29 3b 0a 7d 0a 0a  ExitMutex();.}..
3b90: 2f 2a 0a 2a 2a 20 41 6c 6c 6f 63 61 74 65 20 61  /*.** Allocate a
3ba0: 20 6e 65 77 20 70 61 67 65 2e 0a 2a 2f 0a 73 74   new page..*/.st
3bb0: 61 74 69 63 20 50 67 48 64 72 20 2a 70 63 61 63  atic PgHdr *pcac
3bc0: 68 65 50 61 67 65 41 6c 6c 6f 63 28 50 43 61 63  hePageAlloc(PCac
3bd0: 68 65 20 2a 70 43 61 63 68 65 29 7b 0a 20 20 50  he *pCache){.  P
3be0: 67 48 64 72 20 2a 70 3b 0a 20 20 69 6e 74 20 73  gHdr *p;.  int s
3bf0: 7a 20 3d 20 73 69 7a 65 6f 66 28 2a 70 29 20 2b  z = sizeof(*p) +
3c00: 20 70 43 61 63 68 65 2d 3e 73 7a 50 61 67 65 20   pCache->szPage 
3c10: 2b 20 70 43 61 63 68 65 2d 3e 73 7a 45 78 74 72  + pCache->szExtr
3c20: 61 3b 0a 20 20 61 73 73 65 72 74 28 20 73 71 6c  a;.  assert( sql
3c30: 69 74 65 33 5f 6d 75 74 65 78 5f 68 65 6c 64 28  ite3_mutex_held(
3c40: 70 63 61 63 68 65 5f 67 2e 6d 75 74 65 78 29 20  pcache_g.mutex) 
3c50: 29 3b 0a 20 20 70 20 3d 20 70 63 61 63 68 65 4d  );.  p = pcacheM
3c60: 61 6c 6c 6f 63 28 73 7a 2c 20 70 43 61 63 68 65  alloc(sz, pCache
3c70: 29 3b 0a 20 20 69 66 28 20 70 3d 3d 30 20 29 20  );.  if( p==0 ) 
3c80: 72 65 74 75 72 6e 20 30 3b 0a 20 20 6d 65 6d 73  return 0;.  mems
3c90: 65 74 28 70 2c 20 30 2c 20 73 69 7a 65 6f 66 28  et(p, 0, sizeof(
3ca0: 50 67 48 64 72 29 29 3b 0a 20 20 70 2d 3e 70 44  PgHdr));.  p->pD
3cb0: 61 74 61 20 3d 20 28 76 6f 69 64 2a 29 26 70 5b  ata = (void*)&p[
3cc0: 31 5d 3b 0a 20 20 70 2d 3e 70 45 78 74 72 61 20  1];.  p->pExtra 
3cd0: 3d 20 28 76 6f 69 64 2a 29 26 28 28 63 68 61 72  = (void*)&((char
3ce0: 2a 29 70 2d 3e 70 44 61 74 61 29 5b 70 43 61 63  *)p->pData)[pCac
3cf0: 68 65 2d 3e 73 7a 50 61 67 65 5d 3b 0a 20 20 69  he->szPage];.  i
3d00: 66 28 20 70 43 61 63 68 65 2d 3e 62 50 75 72 67  f( pCache->bPurg
3d10: 65 61 62 6c 65 20 29 7b 0a 20 20 20 20 70 63 61  eable ){.    pca
3d20: 63 68 65 5f 67 2e 6e 43 75 72 72 65 6e 74 50 61  che_g.nCurrentPa
3d30: 67 65 2b 2b 3b 0a 20 20 7d 0a 20 20 72 65 74 75  ge++;.  }.  retu
3d40: 72 6e 20 70 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 44  rn p;.}../*.** D
3d50: 65 61 6c 6c 6f 63 61 74 65 20 61 20 70 61 67 65  eallocate a page
3d60: 0a 2a 2f 0a 73 74 61 74 69 63 20 76 6f 69 64 20  .*/.static void 
3d70: 70 63 61 63 68 65 50 61 67 65 46 72 65 65 28 50  pcachePageFree(P
3d80: 67 48 64 72 20 2a 70 29 7b 0a 20 20 61 73 73 65  gHdr *p){.  asse
3d90: 72 74 28 20 73 71 6c 69 74 65 33 5f 6d 75 74 65  rt( sqlite3_mute
3da0: 78 5f 68 65 6c 64 28 70 63 61 63 68 65 5f 67 2e  x_held(pcache_g.
3db0: 6d 75 74 65 78 29 20 29 3b 0a 20 20 69 66 28 20  mutex) );.  if( 
3dc0: 70 2d 3e 70 43 61 63 68 65 2d 3e 62 50 75 72 67  p->pCache->bPurg
3dd0: 65 61 62 6c 65 20 29 7b 0a 20 20 20 20 70 63 61  eable ){.    pca
3de0: 63 68 65 5f 67 2e 6e 43 75 72 72 65 6e 74 50 61  che_g.nCurrentPa
3df0: 67 65 2d 2d 3b 0a 20 20 7d 0a 20 20 70 63 61 63  ge--;.  }.  pcac
3e00: 68 65 46 72 65 65 28 70 2d 3e 61 70 53 61 76 65  heFree(p->apSave
3e10: 5b 30 5d 29 3b 0a 20 20 70 63 61 63 68 65 46 72  [0]);.  pcacheFr
3e20: 65 65 28 70 2d 3e 61 70 53 61 76 65 5b 31 5d 29  ee(p->apSave[1])
3e30: 3b 0a 20 20 70 63 61 63 68 65 46 72 65 65 28 70  ;.  pcacheFree(p
3e40: 29 3b 0a 7d 0a 0a 23 69 66 64 65 66 20 53 51 4c  );.}..#ifdef SQL
3e50: 49 54 45 5f 45 4e 41 42 4c 45 5f 4d 45 4d 4f 52  ITE_ENABLE_MEMOR
3e60: 59 5f 4d 41 4e 41 47 45 4d 45 4e 54 0a 2f 2a 0a  Y_MANAGEMENT./*.
3e70: 2a 2a 20 52 65 74 75 72 6e 20 74 68 65 20 6e 75  ** Return the nu
3e80: 6d 62 65 72 20 6f 66 20 62 79 74 65 73 20 74 68  mber of bytes th
3e90: 61 74 20 77 69 6c 6c 20 62 65 20 72 65 74 75 72  at will be retur
3ea0: 6e 65 64 20 74 6f 20 74 68 65 20 68 65 61 70 20  ned to the heap 
3eb0: 77 68 65 6e 0a 2a 2a 20 74 68 65 20 61 72 67 75  when.** the argu
3ec0: 6d 65 6e 74 20 69 73 20 70 61 73 73 65 64 20 74  ment is passed t
3ed0: 6f 20 70 63 61 63 68 65 50 61 67 65 46 72 65 65  o pcachePageFree
3ee0: 28 29 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e  ()..*/.static in
3ef0: 74 20 70 63 61 63 68 65 50 61 67 65 53 69 7a 65  t pcachePageSize
3f00: 28 50 67 48 64 72 20 2a 70 29 7b 0a 20 20 61 73  (PgHdr *p){.  as
3f10: 73 65 72 74 28 20 73 71 6c 69 74 65 33 5f 6d 75  sert( sqlite3_mu
3f20: 74 65 78 5f 68 65 6c 64 28 70 63 61 63 68 65 5f  tex_held(pcache_
3f30: 67 2e 6d 75 74 65 78 29 20 29 3b 0a 20 20 61 73  g.mutex) );.  as
3f40: 73 65 72 74 28 20 21 70 63 61 63 68 65 5f 67 2e  sert( !pcache_g.
3f50: 70 53 74 61 72 74 20 29 3b 0a 20 20 61 73 73 65  pStart );.  asse
3f60: 72 74 28 20 70 2d 3e 61 70 53 61 76 65 5b 30 5d  rt( p->apSave[0]
3f70: 3d 3d 30 20 29 3b 0a 20 20 61 73 73 65 72 74 28  ==0 );.  assert(
3f80: 20 70 2d 3e 61 70 53 61 76 65 5b 31 5d 3d 3d 30   p->apSave[1]==0
3f90: 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 70 20   );.  assert( p 
3fa0: 26 26 20 70 2d 3e 70 43 61 63 68 65 20 29 3b 0a  && p->pCache );.
3fb0: 20 20 72 65 74 75 72 6e 20 73 71 6c 69 74 65 33    return sqlite3
3fc0: 4d 61 6c 6c 6f 63 53 69 7a 65 28 70 29 3b 0a 7d  MallocSize(p);.}
3fd0: 0a 23 65 6e 64 69 66 0a 0a 2f 2a 0a 2a 2a 20 41  .#endif../*.** A
3fe0: 74 74 65 6d 70 74 20 74 6f 20 27 72 65 63 79 63  ttempt to 'recyc
3ff0: 6c 65 27 20 61 20 70 61 67 65 20 66 72 6f 6d 20  le' a page from 
4000: 74 68 65 20 67 6c 6f 62 61 6c 20 4c 52 55 20 6c  the global LRU l
4010: 69 73 74 2e 20 4f 6e 6c 79 20 63 6c 65 61 6e 2c  ist. Only clean,
4020: 0a 2a 2a 20 75 6e 72 65 66 65 72 65 6e 63 65 64  .** unreferenced
4030: 20 70 61 67 65 73 20 66 72 6f 6d 20 70 75 72 67   pages from purg
4040: 65 61 62 6c 65 20 63 61 63 68 65 73 20 61 72 65  eable caches are
4050: 20 65 6c 69 67 69 62 6c 65 20 66 6f 72 20 72 65   eligible for re
4060: 63 79 63 6c 69 6e 67 2e 0a 2a 2a 0a 2a 2a 20 54  cycling..**.** T
4070: 68 69 73 20 66 75 6e 63 74 69 6f 6e 20 72 65 6d  his function rem
4080: 6f 76 65 73 20 70 61 67 65 20 70 63 61 63 68 65  oves page pcache
4090: 2e 70 4c 72 75 54 61 69 6c 20 66 72 6f 6d 20 74  .pLruTail from t
40a0: 68 65 20 67 6c 6f 62 61 6c 20 4c 52 55 20 6c 69  he global LRU li
40b0: 73 74 2c 0a 2a 2a 20 61 6e 64 20 66 72 6f 6d 20  st,.** and from 
40c0: 74 68 65 20 68 61 73 68 2d 74 61 62 6c 65 20 61  the hash-table a
40d0: 6e 64 20 50 43 61 63 68 65 2e 70 43 6c 65 61 6e  nd PCache.pClean
40e0: 20 6c 69 73 74 20 6f 66 20 74 68 65 20 6f 77 6e   list of the own
40f0: 65 72 20 70 63 61 63 68 65 2e 0a 2a 2a 20 54 68  er pcache..** Th
4100: 65 72 65 20 73 68 6f 75 6c 64 20 62 65 20 6e 6f  ere should be no
4110: 20 6f 74 68 65 72 20 72 65 66 65 72 65 6e 63 65   other reference
4120: 73 20 74 6f 20 74 68 65 20 70 61 67 65 2e 0a 2a  s to the page..*
4130: 2a 0a 2a 2a 20 41 20 70 6f 69 6e 74 65 72 20 74  *.** A pointer t
4140: 6f 20 74 68 65 20 72 65 63 79 63 6c 65 64 20 70  o the recycled p
4150: 61 67 65 20 69 73 20 72 65 74 75 72 6e 65 64 2c  age is returned,
4160: 20 6f 72 20 4e 55 4c 4c 20 69 66 20 6e 6f 20 70   or NULL if no p
4170: 61 67 65 20 69 73 0a 2a 2a 20 65 6c 69 67 69 62  age is.** eligib
4180: 6c 65 20 66 6f 72 20 72 65 63 79 63 6c 69 6e 67  le for recycling
4190: 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 50 67 48 64  ..*/.static PgHd
41a0: 72 20 2a 70 63 61 63 68 65 52 65 63 79 63 6c 65  r *pcacheRecycle
41b0: 50 61 67 65 28 29 7b 0a 20 20 50 67 48 64 72 20  Page(){.  PgHdr 
41c0: 2a 70 20 3d 20 30 3b 0a 20 20 61 73 73 65 72 74  *p = 0;.  assert
41d0: 28 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f  ( sqlite3_mutex_
41e0: 68 65 6c 64 28 70 63 61 63 68 65 5f 67 2e 6d 75  held(pcache_g.mu
41f0: 74 65 78 29 20 29 3b 0a 0a 20 20 69 66 28 20 28  tex) );..  if( (
4200: 70 3d 70 63 61 63 68 65 5f 67 2e 70 4c 72 75 54  p=pcache_g.pLruT
4210: 61 69 6c 29 20 29 7b 0a 20 20 20 20 61 73 73 65  ail) ){.    asse
4220: 72 74 28 20 28 70 2d 3e 66 6c 61 67 73 26 50 47  rt( (p->flags&PG
4230: 48 44 52 5f 44 49 52 54 59 29 3d 3d 30 20 29 3b  HDR_DIRTY)==0 );
4240: 0a 20 20 20 20 70 63 61 63 68 65 52 65 6d 6f 76  .    pcacheRemov
4250: 65 46 72 6f 6d 4c 72 75 4c 69 73 74 28 70 29 3b  eFromLruList(p);
4260: 0a 20 20 20 20 70 63 61 63 68 65 52 65 6d 6f 76  .    pcacheRemov
4270: 65 46 72 6f 6d 48 61 73 68 28 70 29 3b 0a 20 20  eFromHash(p);.  
4280: 20 20 70 63 61 63 68 65 52 65 6d 6f 76 65 46 72    pcacheRemoveFr
4290: 6f 6d 4c 69 73 74 28 26 70 2d 3e 70 43 61 63 68  omList(&p->pCach
42a0: 65 2d 3e 70 43 6c 65 61 6e 2c 20 70 29 3b 0a 20  e->pClean, p);. 
42b0: 20 7d 0a 0a 20 20 72 65 74 75 72 6e 20 70 3b 0a   }..  return p;.
42c0: 7d 0a 0a 2f 2a 0a 2a 2a 20 4f 62 74 61 69 6e 20  }../*.** Obtain 
42d0: 73 70 61 63 65 20 66 6f 72 20 61 20 70 61 67 65  space for a page
42e0: 2e 20 54 72 79 20 74 6f 20 72 65 63 79 63 6c 65  . Try to recycle
42f0: 20 61 6e 20 6f 6c 64 20 70 61 67 65 20 69 66 20   an old page if 
4300: 74 68 65 20 6c 69 6d 69 74 20 6f 6e 20 74 68 65  the limit on the
4310: 20 0a 2a 2a 20 6e 75 6d 62 65 72 20 6f 66 20 70   .** number of p
4320: 61 67 65 73 20 68 61 73 20 62 65 65 6e 20 72 65  ages has been re
4330: 61 63 68 65 64 2e 20 49 66 20 74 68 65 20 6c 69  ached. If the li
4340: 6d 69 74 20 68 61 73 20 6e 6f 74 20 62 65 65 6e  mit has not been
4350: 20 72 65 61 63 68 65 64 20 6f 72 0a 2a 2a 20 74   reached or.** t
4360: 68 65 72 65 20 61 72 65 20 6e 6f 20 70 61 67 65  here are no page
4370: 73 20 65 6c 69 67 69 62 6c 65 20 66 6f 72 20 72  s eligible for r
4380: 65 63 79 63 6c 69 6e 67 2c 20 61 6c 6c 6f 63 61  ecycling, alloca
4390: 74 65 20 61 20 6e 65 77 20 70 61 67 65 2e 0a 2a  te a new page..*
43a0: 2a 0a 2a 2a 20 52 65 74 75 72 6e 20 61 20 70 6f  *.** Return a po
43b0: 69 6e 74 65 72 20 74 6f 20 74 68 65 20 6e 65 77  inter to the new
43c0: 20 70 61 67 65 2c 20 6f 72 20 4e 55 4c 4c 20 69   page, or NULL i
43d0: 66 20 61 6e 20 4f 4f 4d 20 63 6f 6e 64 69 74 69  f an OOM conditi
43e0: 6f 6e 20 6f 63 63 75 72 73 2e 0a 2a 2f 0a 73 74  on occurs..*/.st
43f0: 61 74 69 63 20 69 6e 74 20 70 63 61 63 68 65 52  atic int pcacheR
4400: 65 63 79 63 6c 65 4f 72 41 6c 6c 6f 63 28 50 43  ecycleOrAlloc(PC
4410: 61 63 68 65 20 2a 70 43 61 63 68 65 2c 20 50 67  ache *pCache, Pg
4420: 48 64 72 20 2a 2a 70 70 50 61 67 65 29 7b 0a 20  Hdr **ppPage){. 
4430: 20 50 67 48 64 72 20 2a 70 20 3d 20 30 3b 0a 0a   PgHdr *p = 0;..
4440: 20 20 69 6e 74 20 73 7a 50 61 67 65 20 3d 20 70    int szPage = p
4450: 43 61 63 68 65 2d 3e 73 7a 50 61 67 65 3b 0a 20  Cache->szPage;. 
4460: 20 69 6e 74 20 73 7a 45 78 74 72 61 20 3d 20 70   int szExtra = p
4470: 43 61 63 68 65 2d 3e 73 7a 45 78 74 72 61 3b 0a  Cache->szExtra;.
4480: 0a 20 20 61 73 73 65 72 74 28 20 70 63 61 63 68  .  assert( pcach
4490: 65 5f 67 2e 69 73 49 6e 69 74 20 29 3b 0a 20 20  e_g.isInit );.  
44a0: 61 73 73 65 72 74 28 20 73 71 6c 69 74 65 33 5f  assert( sqlite3_
44b0: 6d 75 74 65 78 5f 68 65 6c 64 28 70 63 61 63 68  mutex_held(pcach
44c0: 65 5f 67 2e 6d 75 74 65 78 29 20 29 3b 0a 0a 20  e_g.mutex) );.. 
44d0: 20 2a 70 70 50 61 67 65 20 3d 20 30 3b 0a 0a 20   *ppPage = 0;.. 
44e0: 20 2f 2a 20 49 66 20 77 65 20 68 61 76 65 20 72   /* If we have r
44f0: 65 61 63 68 65 64 20 65 69 74 68 65 72 20 74 68  eached either th
4500: 65 20 67 6c 6f 62 61 6c 20 6f 72 20 74 68 65 20  e global or the 
4510: 6c 6f 63 61 6c 20 6c 69 6d 69 74 20 66 6f 72 20  local limit for 
4520: 0a 20 20 2a 2a 20 70 69 6e 6e 65 64 2b 64 69 72  .  ** pinned+dir
4530: 74 79 20 70 61 67 65 73 2c 20 61 6e 64 20 74 68  ty pages, and th
4540: 65 72 65 20 69 73 20 61 74 20 6c 65 61 73 74 20  ere is at least 
4550: 6f 6e 65 20 64 69 72 74 79 20 70 61 67 65 2c 0a  one dirty page,.
4560: 20 20 2a 2a 20 69 6e 76 6f 6b 65 20 74 68 65 20    ** invoke the 
4570: 78 53 74 72 65 73 73 20 63 61 6c 6c 62 61 63 6b  xStress callback
4580: 20 74 6f 20 63 61 75 73 65 20 61 20 70 61 67 65   to cause a page
4590: 20 74 6f 20 62 65 63 6f 6d 65 20 63 6c 65 61 6e   to become clean
45a0: 2e 0a 20 20 2a 2f 0a 20 20 65 78 70 65 6e 73 69  ..  */.  expensi
45b0: 76 65 5f 61 73 73 65 72 74 28 20 70 43 61 63 68  ve_assert( pCach
45c0: 65 2d 3e 6e 50 69 6e 6e 65 64 3d 3d 70 63 61 63  e->nPinned==pcac
45d0: 68 65 50 69 6e 6e 65 64 43 6f 75 6e 74 28 70 43  hePinnedCount(pC
45e0: 61 63 68 65 29 20 29 3b 0a 20 20 65 78 70 65 6e  ache) );.  expen
45f0: 73 69 76 65 5f 61 73 73 65 72 74 28 20 70 63 61  sive_assert( pca
4600: 63 68 65 43 68 65 63 6b 53 79 6e 63 65 64 28 70  cheCheckSynced(p
4610: 43 61 63 68 65 29 20 29 3b 0a 20 20 69 66 28 20  Cache) );.  if( 
4620: 70 43 61 63 68 65 2d 3e 78 53 74 72 65 73 73 0a  pCache->xStress.
4630: 20 20 20 26 26 20 70 43 61 63 68 65 2d 3e 70 44     && pCache->pD
4640: 69 72 74 79 0a 20 20 20 26 26 20 28 70 43 61 63  irty.   && (pCac
4650: 68 65 2d 3e 6e 50 69 6e 6e 65 64 3e 3d 28 70 63  he->nPinned>=(pc
4660: 61 63 68 65 5f 67 2e 6e 4d 61 78 50 61 67 65 2b  ache_g.nMaxPage+
4670: 70 43 61 63 68 65 2d 3e 6e 4d 69 6e 2d 70 63 61  pCache->nMin-pca
4680: 63 68 65 5f 67 2e 6e 4d 69 6e 50 61 67 65 29 0a  che_g.nMinPage).
4690: 20 20 20 20 20 20 20 20 20 20 20 7c 7c 20 70 43             || pC
46a0: 61 63 68 65 2d 3e 6e 50 69 6e 6e 65 64 3e 3d 70  ache->nPinned>=p
46b0: 43 61 63 68 65 2d 3e 6e 4d 61 78 29 0a 20 20 29  Cache->nMax).  )
46c0: 7b 0a 20 20 20 20 50 67 48 64 72 20 2a 70 50 67  {.    PgHdr *pPg
46d0: 3b 0a 20 20 20 20 61 73 73 65 72 74 28 70 43 61  ;.    assert(pCa
46e0: 63 68 65 2d 3e 70 44 69 72 74 79 54 61 69 6c 29  che->pDirtyTail)
46f0: 3b 0a 0a 20 20 20 20 66 6f 72 28 70 50 67 3d 70  ;..    for(pPg=p
4700: 43 61 63 68 65 2d 3e 70 53 79 6e 63 65 64 3b 20  Cache->pSynced; 
4710: 0a 20 20 20 20 20 20 20 20 70 50 67 20 26 26 20  .        pPg && 
4720: 28 70 50 67 2d 3e 6e 52 65 66 20 7c 7c 20 28 70  (pPg->nRef || (p
4730: 50 67 2d 3e 66 6c 61 67 73 26 50 47 48 44 52 5f  Pg->flags&PGHDR_
4740: 4e 45 45 44 5f 53 59 4e 43 29 29 3b 20 0a 20 20  NEED_SYNC)); .  
4750: 20 20 20 20 20 20 70 50 67 3d 70 50 67 2d 3e 70        pPg=pPg->p
4760: 50 72 65 76 0a 20 20 20 20 29 3b 0a 20 20 20 20  Prev.    );.    
4770: 69 66 28 20 21 70 50 67 20 29 7b 0a 20 20 20 20  if( !pPg ){.    
4780: 20 20 66 6f 72 28 70 50 67 3d 70 43 61 63 68 65    for(pPg=pCache
4790: 2d 3e 70 44 69 72 74 79 54 61 69 6c 3b 20 70 50  ->pDirtyTail; pP
47a0: 67 20 26 26 20 70 50 67 2d 3e 6e 52 65 66 3b 20  g && pPg->nRef; 
47b0: 70 50 67 3d 70 50 67 2d 3e 70 50 72 65 76 29 3b  pPg=pPg->pPrev);
47c0: 0a 20 20 20 20 7d 0a 20 20 20 20 69 66 28 20 70  .    }.    if( p
47d0: 50 67 20 29 7b 0a 20 20 20 20 20 20 69 6e 74 20  Pg ){.      int 
47e0: 72 63 3b 0a 20 20 20 20 20 20 70 63 61 63 68 65  rc;.      pcache
47f0: 45 78 69 74 4d 75 74 65 78 28 29 3b 0a 20 20 20  ExitMutex();.   
4800: 20 20 20 72 63 20 3d 20 70 43 61 63 68 65 2d 3e     rc = pCache->
4810: 78 53 74 72 65 73 73 28 70 43 61 63 68 65 2d 3e  xStress(pCache->
4820: 70 53 74 72 65 73 73 2c 20 70 50 67 29 3b 0a 20  pStress, pPg);. 
4830: 20 20 20 20 20 70 63 61 63 68 65 45 6e 74 65 72       pcacheEnter
4840: 4d 75 74 65 78 28 29 3b 0a 20 20 20 20 20 20 69  Mutex();.      i
4850: 66 28 20 72 63 21 3d 53 51 4c 49 54 45 5f 4f 4b  f( rc!=SQLITE_OK
4860: 20 26 26 20 72 63 21 3d 53 51 4c 49 54 45 5f 42   && rc!=SQLITE_B
4870: 55 53 59 20 29 7b 0a 20 20 20 20 20 20 20 20 72  USY ){.        r
4880: 65 74 75 72 6e 20 72 63 3b 0a 20 20 20 20 20 20  eturn rc;.      
4890: 7d 0a 20 20 20 20 7d 0a 20 20 7d 0a 0a 20 20 2f  }.    }.  }..  /
48a0: 2a 20 49 66 20 65 69 74 68 65 72 20 74 68 65 20  * If either the 
48b0: 6c 6f 63 61 6c 20 6f 72 20 74 68 65 20 67 6c 6f  local or the glo
48c0: 62 61 6c 20 70 61 67 65 20 6c 69 6d 69 74 20 68  bal page limit h
48d0: 61 73 20 62 65 65 6e 20 72 65 61 63 68 65 64 2c  as been reached,
48e0: 20 0a 20 20 2a 2a 20 74 72 79 20 74 6f 20 72 65   .  ** try to re
48f0: 63 79 63 6c 65 20 61 20 70 61 67 65 2e 20 0a 20  cycle a page. . 
4900: 20 2a 2f 0a 20 20 69 66 28 20 70 43 61 63 68 65   */.  if( pCache
4910: 2d 3e 62 50 75 72 67 65 61 62 6c 65 20 26 26 20  ->bPurgeable && 
4920: 28 70 43 61 63 68 65 2d 3e 6e 50 61 67 65 3e 3d  (pCache->nPage>=
4930: 70 43 61 63 68 65 2d 3e 6e 4d 61 78 2d 31 20 7c  pCache->nMax-1 |
4940: 7c 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20  |.              
4950: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 70                 p
4960: 63 61 63 68 65 5f 67 2e 6e 43 75 72 72 65 6e 74  cache_g.nCurrent
4970: 50 61 67 65 3e 3d 70 63 61 63 68 65 5f 67 2e 6e  Page>=pcache_g.n
4980: 4d 61 78 50 61 67 65 29 20 29 7b 0a 20 20 20 20  MaxPage) ){.    
4990: 70 20 3d 20 70 63 61 63 68 65 52 65 63 79 63 6c  p = pcacheRecycl
49a0: 65 50 61 67 65 28 29 3b 0a 20 20 7d 0a 0a 20 20  ePage();.  }..  
49b0: 2f 2a 20 49 66 20 61 20 70 61 67 65 20 68 61 73  /* If a page has
49c0: 20 62 65 65 6e 20 72 65 63 79 63 6c 65 64 20 62   been recycled b
49d0: 75 74 20 69 74 20 69 73 20 74 68 65 20 77 72 6f  ut it is the wro
49e0: 6e 67 20 73 69 7a 65 2c 20 66 72 65 65 20 69 74  ng size, free it
49f0: 2e 20 2a 2f 0a 20 20 69 66 28 20 70 20 26 26 20  . */.  if( p && 
4a00: 28 70 2d 3e 70 43 61 63 68 65 2d 3e 73 7a 50 61  (p->pCache->szPa
4a10: 67 65 21 3d 73 7a 50 61 67 65 20 7c 7c 20 70 2d  ge!=szPage || p-
4a20: 3e 70 43 61 63 68 65 2d 3e 73 7a 50 61 67 65 21  >pCache->szPage!
4a30: 3d 73 7a 45 78 74 72 61 29 20 29 7b 0a 20 20 20  =szExtra) ){.   
4a40: 20 70 63 61 63 68 65 50 61 67 65 46 72 65 65 28   pcachePageFree(
4a50: 70 29 3b 0a 20 20 20 20 70 20 3d 20 30 3b 0a 20  p);.    p = 0;. 
4a60: 20 7d 0a 0a 20 20 69 66 28 20 21 70 20 29 7b 0a   }..  if( !p ){.
4a70: 20 20 20 20 70 20 3d 20 70 63 61 63 68 65 50 61      p = pcachePa
4a80: 67 65 41 6c 6c 6f 63 28 70 43 61 63 68 65 29 3b  geAlloc(pCache);
4a90: 0a 20 20 7d 0a 0a 20 20 2a 70 70 50 61 67 65 20  .  }..  *ppPage 
4aa0: 3d 20 70 3b 0a 20 20 72 65 74 75 72 6e 20 28 70  = p;.  return (p
4ab0: 3f 53 51 4c 49 54 45 5f 4f 4b 3a 53 51 4c 49 54  ?SQLITE_OK:SQLIT
4ac0: 45 5f 4e 4f 4d 45 4d 29 3b 0a 7d 0a 0a 2f 2a 2a  E_NOMEM);.}../**
4ad0: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
4ae0: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
4af0: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
4b00: 2a 20 47 65 6e 65 72 61 6c 20 49 6e 74 65 72 66  * General Interf
4b10: 61 63 65 73 20 2a 2a 2a 2a 2a 2a 0a 2a 2a 0a 2a  aces ******.**.*
4b20: 2a 20 49 6e 69 74 69 61 6c 69 7a 65 20 61 6e 64  * Initialize and
4b30: 20 73 68 75 74 64 6f 77 6e 20 74 68 65 20 70 61   shutdown the pa
4b40: 67 65 20 63 61 63 68 65 20 73 75 62 73 79 73 74  ge cache subsyst
4b50: 65 6d 2e 20 4e 65 69 74 68 65 72 20 6f 66 20 74  em. Neither of t
4b60: 68 65 73 65 20 0a 2a 2a 20 66 75 6e 63 74 69 6f  hese .** functio
4b70: 6e 73 20 61 72 65 20 74 68 72 65 61 64 73 61 66  ns are threadsaf
4b80: 65 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65  e..*/.int sqlite
4b90: 33 50 63 61 63 68 65 49 6e 69 74 69 61 6c 69 7a  3PcacheInitializ
4ba0: 65 28 76 6f 69 64 29 7b 0a 20 20 61 73 73 65 72  e(void){.  asser
4bb0: 74 28 20 70 63 61 63 68 65 5f 67 2e 69 73 49 6e  t( pcache_g.isIn
4bc0: 69 74 3d 3d 30 20 29 3b 0a 20 20 6d 65 6d 73 65  it==0 );.  memse
4bd0: 74 28 26 70 63 61 63 68 65 5f 67 2c 20 30 2c 20  t(&pcache_g, 0, 
4be0: 73 69 7a 65 6f 66 28 70 63 61 63 68 65 29 29 3b  sizeof(pcache));
4bf0: 0a 20 20 69 66 28 20 73 71 6c 69 74 65 33 47 6c  .  if( sqlite3Gl
4c00: 6f 62 61 6c 43 6f 6e 66 69 67 2e 62 43 6f 72 65  obalConfig.bCore
4c10: 4d 75 74 65 78 20 29 7b 0a 20 20 20 20 2f 2a 20  Mutex ){.    /* 
4c20: 4e 6f 20 6e 65 65 64 20 74 6f 20 63 68 65 63 6b  No need to check
4c30: 20 74 68 65 20 72 65 74 75 72 6e 20 76 61 6c 75   the return valu
4c40: 65 20 6f 66 20 73 71 6c 69 74 65 33 5f 6d 75 74  e of sqlite3_mut
4c50: 65 78 5f 61 6c 6c 6f 63 28 29 2e 20 0a 20 20 20  ex_alloc(). .   
4c60: 20 2a 2a 20 41 6c 6c 6f 63 61 74 69 6e 67 20 61   ** Allocating a
4c70: 20 73 74 61 74 69 63 20 6d 75 74 65 78 20 63 61   static mutex ca
4c80: 6e 6e 6f 74 20 66 61 69 6c 2e 0a 20 20 20 20 2a  nnot fail..    *
4c90: 2f 0a 20 20 20 20 70 63 61 63 68 65 5f 67 2e 6d  /.    pcache_g.m
4ca0: 75 74 65 78 20 3d 20 73 71 6c 69 74 65 33 5f 6d  utex = sqlite3_m
4cb0: 75 74 65 78 5f 61 6c 6c 6f 63 28 53 51 4c 49 54  utex_alloc(SQLIT
4cc0: 45 5f 4d 55 54 45 58 5f 53 54 41 54 49 43 5f 4c  E_MUTEX_STATIC_L
4cd0: 52 55 29 3b 0a 20 20 7d 0a 20 20 70 63 61 63 68  RU);.  }.  pcach
4ce0: 65 5f 67 2e 69 73 49 6e 69 74 20 3d 20 31 3b 0a  e_g.isInit = 1;.
4cf0: 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f    return SQLITE_
4d00: 4f 4b 3b 0a 7d 0a 76 6f 69 64 20 73 71 6c 69 74  OK;.}.void sqlit
4d10: 65 33 50 63 61 63 68 65 53 68 75 74 64 6f 77 6e  e3PcacheShutdown
4d20: 28 76 6f 69 64 29 7b 0a 20 20 6d 65 6d 73 65 74  (void){.  memset
4d30: 28 26 70 63 61 63 68 65 5f 67 2c 20 30 2c 20 73  (&pcache_g, 0, s
4d40: 69 7a 65 6f 66 28 70 63 61 63 68 65 29 29 3b 0a  izeof(pcache));.
4d50: 7d 0a 0a 2f 2a 0a 2a 2a 20 52 65 74 75 72 6e 20  }../*.** Return 
4d60: 74 68 65 20 73 69 7a 65 20 69 6e 20 62 79 74 65  the size in byte
4d70: 73 20 6f 66 20 61 20 50 43 61 63 68 65 20 6f 62  s of a PCache ob
4d80: 6a 65 63 74 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c  ject..*/.int sql
4d90: 69 74 65 33 50 63 61 63 68 65 53 69 7a 65 28 76  ite3PcacheSize(v
4da0: 6f 69 64 29 7b 20 72 65 74 75 72 6e 20 73 69 7a  oid){ return siz
4db0: 65 6f 66 28 50 43 61 63 68 65 29 3b 20 7d 0a 0a  eof(PCache); }..
4dc0: 2f 2a 0a 2a 2a 20 43 72 65 61 74 65 20 61 20 6e  /*.** Create a n
4dd0: 65 77 20 50 43 61 63 68 65 20 6f 62 6a 65 63 74  ew PCache object
4de0: 2e 20 20 53 74 6f 72 61 67 65 20 73 70 61 63 65  .  Storage space
4df0: 20 74 6f 20 68 6f 6c 64 20 74 68 65 20 6f 62 6a   to hold the obj
4e00: 65 63 74 0a 2a 2a 20 68 61 73 20 61 6c 72 65 61  ect.** has alrea
4e10: 64 79 20 62 65 65 6e 20 61 6c 6c 6f 63 61 74 65  dy been allocate
4e20: 64 20 61 6e 64 20 69 73 20 70 61 73 73 65 64 20  d and is passed 
4e30: 69 6e 20 61 73 20 74 68 65 20 70 20 70 6f 69 6e  in as the p poin
4e40: 74 65 72 2e 0a 2a 2f 0a 76 6f 69 64 20 73 71 6c  ter..*/.void sql
4e50: 69 74 65 33 50 63 61 63 68 65 4f 70 65 6e 28 0a  ite3PcacheOpen(.
4e60: 20 20 69 6e 74 20 73 7a 50 61 67 65 2c 20 20 20    int szPage,   
4e70: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f                 /
4e80: 2a 20 53 69 7a 65 20 6f 66 20 65 76 65 72 79 20  * Size of every 
4e90: 70 61 67 65 20 2a 2f 0a 20 20 69 6e 74 20 73 7a  page */.  int sz
4ea0: 45 78 74 72 61 2c 20 20 20 20 20 20 20 20 20 20  Extra,          
4eb0: 20 20 20 20 20 20 20 2f 2a 20 45 78 74 72 61 20         /* Extra 
4ec0: 73 70 61 63 65 20 61 73 73 6f 63 69 61 74 65 64  space associated
4ed0: 20 77 69 74 68 20 65 61 63 68 20 70 61 67 65 20   with each page 
4ee0: 2a 2f 0a 20 20 69 6e 74 20 62 50 75 72 67 65 61  */.  int bPurgea
4ef0: 62 6c 65 2c 20 20 20 20 20 20 20 20 20 20 20 20  ble,            
4f00: 20 20 2f 2a 20 54 72 75 65 20 69 66 20 70 61 67    /* True if pag
4f10: 65 73 20 61 72 65 20 6f 6e 20 62 61 63 6b 69 6e  es are on backin
4f20: 67 20 73 74 6f 72 65 20 2a 2f 0a 20 20 76 6f 69  g store */.  voi
4f30: 64 20 28 2a 78 44 65 73 74 72 6f 79 29 28 50 67  d (*xDestroy)(Pg
4f40: 48 64 72 2a 29 2c 20 20 20 20 2f 2a 20 43 61 6c  Hdr*),    /* Cal
4f50: 6c 65 64 20 74 6f 20 64 65 73 74 72 6f 79 20 61  led to destroy a
4f60: 20 70 61 67 65 20 2a 2f 0a 20 20 69 6e 74 20 28   page */.  int (
4f70: 2a 78 53 74 72 65 73 73 29 28 76 6f 69 64 2a 2c  *xStress)(void*,
4f80: 50 67 48 64 72 2a 29 2c 2f 2a 20 43 61 6c 6c 20  PgHdr*),/* Call 
4f90: 74 6f 20 74 72 79 20 74 6f 20 6d 61 6b 65 20 70  to try to make p
4fa0: 61 67 65 73 20 63 6c 65 61 6e 20 2a 2f 0a 20 20  ages clean */.  
4fb0: 76 6f 69 64 20 2a 70 53 74 72 65 73 73 2c 20 20  void *pStress,  
4fc0: 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20               /* 
4fd0: 41 72 67 75 6d 65 6e 74 20 74 6f 20 78 53 74 72  Argument to xStr
4fe0: 65 73 73 20 2a 2f 0a 20 20 50 43 61 63 68 65 20  ess */.  PCache 
4ff0: 2a 70 20 20 20 20 20 20 20 20 20 20 20 20 20 20  *p              
5000: 20 20 20 20 20 20 2f 2a 20 50 72 65 61 6c 6c 6f        /* Preallo
5010: 63 61 74 65 64 20 73 70 61 63 65 20 66 6f 72 20  cated space for 
5020: 74 68 65 20 50 43 61 63 68 65 20 2a 2f 0a 29 7b  the PCache */.){
5030: 0a 20 20 61 73 73 65 72 74 28 20 70 63 61 63 68  .  assert( pcach
5040: 65 5f 67 2e 69 73 49 6e 69 74 20 29 3b 0a 20 20  e_g.isInit );.  
5050: 6d 65 6d 73 65 74 28 70 2c 20 30 2c 20 73 69 7a  memset(p, 0, siz
5060: 65 6f 66 28 50 43 61 63 68 65 29 29 3b 0a 20 20  eof(PCache));.  
5070: 70 2d 3e 73 7a 50 61 67 65 20 3d 20 73 7a 50 61  p->szPage = szPa
5080: 67 65 3b 0a 20 20 70 2d 3e 73 7a 45 78 74 72 61  ge;.  p->szExtra
5090: 20 3d 20 73 7a 45 78 74 72 61 3b 0a 20 20 70 2d   = szExtra;.  p-
50a0: 3e 62 50 75 72 67 65 61 62 6c 65 20 3d 20 62 50  >bPurgeable = bP
50b0: 75 72 67 65 61 62 6c 65 3b 0a 20 20 70 2d 3e 78  urgeable;.  p->x
50c0: 44 65 73 74 72 6f 79 20 3d 20 78 44 65 73 74 72  Destroy = xDestr
50d0: 6f 79 3b 0a 20 20 70 2d 3e 78 53 74 72 65 73 73  oy;.  p->xStress
50e0: 20 3d 20 78 53 74 72 65 73 73 3b 0a 20 20 70 2d   = xStress;.  p-
50f0: 3e 70 53 74 72 65 73 73 20 3d 20 70 53 74 72 65  >pStress = pStre
5100: 73 73 3b 0a 20 20 70 2d 3e 6e 4d 61 78 20 3d 20  ss;.  p->nMax = 
5110: 31 30 30 3b 0a 20 20 70 2d 3e 6e 4d 69 6e 20 3d  100;.  p->nMin =
5120: 20 31 30 3b 0a 0a 20 20 70 63 61 63 68 65 45 6e   10;..  pcacheEn
5130: 74 65 72 4d 75 74 65 78 28 29 3b 0a 20 20 69 66  terMutex();.  if
5140: 28 20 62 50 75 72 67 65 61 62 6c 65 20 29 7b 0a  ( bPurgeable ){.
5150: 20 20 20 20 70 63 61 63 68 65 5f 67 2e 6e 4d 61      pcache_g.nMa
5160: 78 50 61 67 65 20 2b 3d 20 70 2d 3e 6e 4d 61 78  xPage += p->nMax
5170: 3b 0a 20 20 20 20 70 63 61 63 68 65 5f 67 2e 6e  ;.    pcache_g.n
5180: 4d 69 6e 50 61 67 65 20 2b 3d 20 70 2d 3e 6e 4d  MinPage += p->nM
5190: 69 6e 3b 0a 20 20 7d 0a 0a 20 20 70 63 61 63 68  in;.  }..  pcach
51a0: 65 45 78 69 74 4d 75 74 65 78 28 29 3b 0a 7d 0a  eExitMutex();.}.
51b0: 0a 2f 2a 0a 2a 2a 20 43 68 61 6e 67 65 20 74 68  ./*.** Change th
51c0: 65 20 70 61 67 65 20 73 69 7a 65 20 66 6f 72 20  e page size for 
51d0: 50 43 61 63 68 65 20 6f 62 6a 65 63 74 2e 20 20  PCache object.  
51e0: 54 68 69 73 20 63 61 6e 20 6f 6e 6c 79 20 68 61  This can only ha
51f0: 70 70 65 6e 0a 2a 2a 20 77 68 65 6e 20 74 68 65  ppen.** when the
5200: 20 63 61 63 68 65 20 69 73 20 65 6d 70 74 79 2e   cache is empty.
5210: 0a 2a 2f 0a 76 6f 69 64 20 73 71 6c 69 74 65 33  .*/.void sqlite3
5220: 50 63 61 63 68 65 53 65 74 50 61 67 65 53 69 7a  PcacheSetPageSiz
5230: 65 28 50 43 61 63 68 65 20 2a 70 43 61 63 68 65  e(PCache *pCache
5240: 2c 20 69 6e 74 20 73 7a 50 61 67 65 29 7b 0a 20  , int szPage){. 
5250: 20 61 73 73 65 72 74 28 70 43 61 63 68 65 2d 3e   assert(pCache->
5260: 6e 50 61 67 65 3d 3d 30 29 3b 0a 20 20 70 43 61  nPage==0);.  pCa
5270: 63 68 65 2d 3e 73 7a 50 61 67 65 20 3d 20 73 7a  che->szPage = sz
5280: 50 61 67 65 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 54  Page;.}../*.** T
5290: 72 79 20 74 6f 20 6f 62 74 61 69 6e 20 61 20 70  ry to obtain a p
52a0: 61 67 65 20 66 72 6f 6d 20 74 68 65 20 63 61 63  age from the cac
52b0: 68 65 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74  he..*/.int sqlit
52c0: 65 33 50 63 61 63 68 65 46 65 74 63 68 28 0a 20  e3PcacheFetch(. 
52d0: 20 50 43 61 63 68 65 20 2a 70 43 61 63 68 65 2c   PCache *pCache,
52e0: 20 20 20 20 20 20 20 2f 2a 20 4f 62 74 61 69 6e         /* Obtain
52f0: 20 74 68 65 20 70 61 67 65 20 66 72 6f 6d 20 74   the page from t
5300: 68 69 73 20 63 61 63 68 65 20 2a 2f 0a 20 20 50  his cache */.  P
5310: 67 6e 6f 20 70 67 6e 6f 2c 20 20 20 20 20 20 20  gno pgno,       
5320: 20 20 20 20 20 2f 2a 20 50 61 67 65 20 6e 75 6d       /* Page num
5330: 62 65 72 20 74 6f 20 6f 62 74 61 69 6e 20 2a 2f  ber to obtain */
5340: 0a 20 20 69 6e 74 20 63 72 65 61 74 65 46 6c 61  .  int createFla
5350: 67 2c 20 20 20 20 20 20 20 2f 2a 20 49 66 20 74  g,       /* If t
5360: 72 75 65 2c 20 63 72 65 61 74 65 20 70 61 67 65  rue, create page
5370: 20 69 66 20 69 74 20 64 6f 65 73 20 6e 6f 74 20   if it does not 
5380: 65 78 69 73 74 20 61 6c 72 65 61 64 79 20 2a 2f  exist already */
5390: 0a 20 20 50 67 48 64 72 20 2a 2a 70 70 50 61 67  .  PgHdr **ppPag
53a0: 65 20 20 20 20 20 20 20 20 2f 2a 20 57 72 69 74  e        /* Writ
53b0: 65 20 74 68 65 20 70 61 67 65 20 68 65 72 65 20  e the page here 
53c0: 2a 2f 0a 29 7b 0a 20 20 69 6e 74 20 72 63 20 3d  */.){.  int rc =
53d0: 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20 20 50 67   SQLITE_OK;.  Pg
53e0: 48 64 72 20 2a 70 50 61 67 65 20 3d 20 30 3b 0a  Hdr *pPage = 0;.
53f0: 0a 20 20 61 73 73 65 72 74 28 20 70 63 61 63 68  .  assert( pcach
5400: 65 5f 67 2e 69 73 49 6e 69 74 20 29 3b 0a 20 20  e_g.isInit );.  
5410: 61 73 73 65 72 74 28 20 70 43 61 63 68 65 21 3d  assert( pCache!=
5420: 30 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 70  0 );.  assert( p
5430: 67 6e 6f 3e 30 20 29 3b 0a 20 20 65 78 70 65 6e  gno>0 );.  expen
5440: 73 69 76 65 5f 61 73 73 65 72 74 28 20 70 43 61  sive_assert( pCa
5450: 63 68 65 2d 3e 6e 50 69 6e 6e 65 64 3d 3d 70 63  che->nPinned==pc
5460: 61 63 68 65 50 69 6e 6e 65 64 43 6f 75 6e 74 28  achePinnedCount(
5470: 70 43 61 63 68 65 29 20 29 3b 0a 0a 20 20 70 63  pCache) );..  pc
5480: 61 63 68 65 45 6e 74 65 72 4d 75 74 65 78 28 29  acheEnterMutex()
5490: 3b 0a 0a 20 20 2f 2a 20 53 65 61 72 63 68 20 74  ;..  /* Search t
54a0: 68 65 20 68 61 73 68 20 74 61 62 6c 65 20 66 6f  he hash table fo
54b0: 72 20 74 68 65 20 72 65 71 75 65 73 74 65 64 20  r the requested 
54c0: 70 61 67 65 2e 20 45 78 69 74 20 65 61 72 6c 79  page. Exit early
54d0: 20 69 66 20 69 74 20 69 73 20 66 6f 75 6e 64 2e   if it is found.
54e0: 20 2a 2f 0a 20 20 69 66 28 20 70 43 61 63 68 65   */.  if( pCache
54f0: 2d 3e 61 70 48 61 73 68 20 29 7b 0a 20 20 20 20  ->apHash ){.    
5500: 75 33 32 20 68 20 3d 20 70 67 6e 6f 20 25 20 70  u32 h = pgno % p
5510: 43 61 63 68 65 2d 3e 6e 48 61 73 68 3b 0a 20 20  Cache->nHash;.  
5520: 20 20 66 6f 72 28 70 50 61 67 65 3d 70 43 61 63    for(pPage=pCac
5530: 68 65 2d 3e 61 70 48 61 73 68 5b 68 5d 3b 20 70  he->apHash[h]; p
5540: 50 61 67 65 3b 20 70 50 61 67 65 3d 70 50 61 67  Page; pPage=pPag
5550: 65 2d 3e 70 4e 65 78 74 48 61 73 68 29 7b 0a 20  e->pNextHash){. 
5560: 20 20 20 20 20 69 66 28 20 70 50 61 67 65 2d 3e       if( pPage->
5570: 70 67 6e 6f 3d 3d 70 67 6e 6f 20 29 7b 0a 20 20  pgno==pgno ){.  
5580: 20 20 20 20 20 20 69 66 28 20 70 50 61 67 65 2d        if( pPage-
5590: 3e 6e 52 65 66 3d 3d 30 20 29 7b 0a 20 20 20 20  >nRef==0 ){.    
55a0: 20 20 20 20 20 20 69 66 28 20 30 3d 3d 28 70 50        if( 0==(pP
55b0: 61 67 65 2d 3e 66 6c 61 67 73 26 50 47 48 44 52  age->flags&PGHDR
55c0: 5f 44 49 52 54 59 29 20 29 7b 0a 20 20 20 20 20  _DIRTY) ){.     
55d0: 20 20 20 20 20 20 20 70 63 61 63 68 65 52 65 6d         pcacheRem
55e0: 6f 76 65 46 72 6f 6d 4c 72 75 4c 69 73 74 28 70  oveFromLruList(p
55f0: 50 61 67 65 29 3b 0a 20 20 20 20 20 20 20 20 20  Page);.         
5600: 20 20 20 70 43 61 63 68 65 2d 3e 6e 50 69 6e 6e     pCache->nPinn
5610: 65 64 2b 2b 3b 0a 20 20 20 20 20 20 20 20 20 20  ed++;.          
5620: 7d 0a 20 20 20 20 20 20 20 20 20 20 70 43 61 63  }.          pCac
5630: 68 65 2d 3e 6e 52 65 66 2b 2b 3b 0a 20 20 20 20  he->nRef++;.    
5640: 20 20 20 20 7d 0a 20 20 20 20 20 20 20 20 70 50      }.        pP
5650: 61 67 65 2d 3e 6e 52 65 66 2b 2b 3b 0a 20 20 20  age->nRef++;.   
5660: 20 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 20       break;.    
5670: 20 20 7d 0a 20 20 20 20 7d 0a 20 20 7d 0a 0a 20    }.    }.  }.. 
5680: 20 69 66 28 20 21 70 50 61 67 65 20 26 26 20 63   if( !pPage && c
5690: 72 65 61 74 65 46 6c 61 67 20 29 7b 0a 20 20 20  reateFlag ){.   
56a0: 20 69 66 28 20 70 43 61 63 68 65 2d 3e 6e 48 61   if( pCache->nHa
56b0: 73 68 3c 3d 70 43 61 63 68 65 2d 3e 6e 50 61 67  sh<=pCache->nPag
56c0: 65 20 29 7b 0a 20 20 20 20 20 20 72 63 20 3d 20  e ){.      rc = 
56d0: 70 63 61 63 68 65 52 65 73 69 7a 65 48 61 73 68  pcacheResizeHash
56e0: 28 70 43 61 63 68 65 2c 20 70 43 61 63 68 65 2d  (pCache, pCache-
56f0: 3e 6e 48 61 73 68 3c 32 35 36 20 3f 20 32 35 36  >nHash<256 ? 256
5700: 20 3a 20 70 43 61 63 68 65 2d 3e 6e 48 61 73 68   : pCache->nHash
5710: 2a 32 29 3b 0a 20 20 20 20 7d 0a 20 20 20 20 69  *2);.    }.    i
5720: 66 28 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b  f( rc==SQLITE_OK
5730: 20 29 7b 0a 20 20 20 20 20 20 72 63 20 3d 20 70   ){.      rc = p
5740: 63 61 63 68 65 52 65 63 79 63 6c 65 4f 72 41 6c  cacheRecycleOrAl
5750: 6c 6f 63 28 70 43 61 63 68 65 2c 20 26 70 50 61  loc(pCache, &pPa
5760: 67 65 29 3b 0a 20 20 20 20 7d 0a 20 20 20 20 69  ge);.    }.    i
5770: 66 28 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b  f( rc==SQLITE_OK
5780: 20 29 7b 0a 20 20 20 20 20 20 70 50 61 67 65 2d   ){.      pPage-
5790: 3e 70 50 61 67 65 72 20 3d 20 30 3b 0a 20 20 20  >pPager = 0;.   
57a0: 20 20 20 70 50 61 67 65 2d 3e 66 6c 61 67 73 20     pPage->flags 
57b0: 3d 20 30 3b 0a 20 20 20 20 20 20 70 50 61 67 65  = 0;.      pPage
57c0: 2d 3e 70 44 69 72 74 79 20 3d 20 30 3b 0a 20 20  ->pDirty = 0;.  
57d0: 20 20 20 20 70 50 61 67 65 2d 3e 70 67 6e 6f 20      pPage->pgno 
57e0: 3d 20 70 67 6e 6f 3b 0a 20 20 20 20 20 20 70 50  = pgno;.      pP
57f0: 61 67 65 2d 3e 70 43 61 63 68 65 20 3d 20 70 43  age->pCache = pC
5800: 61 63 68 65 3b 0a 20 20 20 20 20 20 70 50 61 67  ache;.      pPag
5810: 65 2d 3e 6e 52 65 66 20 3d 20 31 3b 0a 20 20 20  e->nRef = 1;.   
5820: 20 20 20 70 43 61 63 68 65 2d 3e 6e 52 65 66 2b     pCache->nRef+
5830: 2b 3b 0a 20 20 20 20 20 20 70 43 61 63 68 65 2d  +;.      pCache-
5840: 3e 6e 50 69 6e 6e 65 64 2b 2b 3b 0a 20 20 20 20  >nPinned++;.    
5850: 20 20 70 63 61 63 68 65 41 64 64 54 6f 4c 69 73    pcacheAddToLis
5860: 74 28 26 70 43 61 63 68 65 2d 3e 70 43 6c 65 61  t(&pCache->pClea
5870: 6e 2c 20 70 50 61 67 65 29 3b 0a 20 20 20 20 20  n, pPage);.     
5880: 20 70 63 61 63 68 65 41 64 64 54 6f 48 61 73 68   pcacheAddToHash
5890: 28 70 50 61 67 65 29 3b 0a 20 20 20 20 7d 0a 20  (pPage);.    }. 
58a0: 20 7d 0a 0a 20 20 70 63 61 63 68 65 45 78 69 74   }..  pcacheExit
58b0: 4d 75 74 65 78 28 29 3b 0a 0a 20 20 2a 70 70 50  Mutex();..  *ppP
58c0: 61 67 65 20 3d 20 70 50 61 67 65 3b 0a 20 20 65  age = pPage;.  e
58d0: 78 70 65 6e 73 69 76 65 5f 61 73 73 65 72 74 28  xpensive_assert(
58e0: 20 70 43 61 63 68 65 2d 3e 6e 50 69 6e 6e 65 64   pCache->nPinned
58f0: 3d 3d 70 63 61 63 68 65 50 69 6e 6e 65 64 43 6f  ==pcachePinnedCo
5900: 75 6e 74 28 70 43 61 63 68 65 29 20 29 3b 0a 20  unt(pCache) );. 
5910: 20 61 73 73 65 72 74 28 20 70 50 61 67 65 20 7c   assert( pPage |
5920: 7c 20 21 63 72 65 61 74 65 46 6c 61 67 20 7c 7c  | !createFlag ||
5930: 20 72 63 21 3d 53 51 4c 49 54 45 5f 4f 4b 20 29   rc!=SQLITE_OK )
5940: 3b 0a 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 7d  ;.  return rc;.}
5950: 0a 0a 2f 2a 0a 2a 2a 20 44 65 72 65 66 65 72 65  ../*.** Derefere
5960: 6e 63 65 20 61 20 70 61 67 65 2e 20 20 57 68 65  nce a page.  Whe
5970: 6e 20 74 68 65 20 72 65 66 65 72 65 6e 63 65 20  n the reference 
5980: 63 6f 75 6e 74 20 72 65 61 63 68 65 73 20 7a 65  count reaches ze
5990: 72 6f 2c 0a 2a 2a 20 6d 6f 76 65 20 74 68 65 20  ro,.** move the 
59a0: 70 61 67 65 20 74 6f 20 74 68 65 20 4c 52 55 20  page to the LRU 
59b0: 6c 69 73 74 20 69 66 20 69 74 20 69 73 20 63 6c  list if it is cl
59c0: 65 61 6e 2e 0a 2a 2f 0a 76 6f 69 64 20 73 71 6c  ean..*/.void sql
59d0: 69 74 65 33 50 63 61 63 68 65 52 65 6c 65 61 73  ite3PcacheReleas
59e0: 65 28 50 67 48 64 72 20 2a 70 29 7b 0a 20 20 61  e(PgHdr *p){.  a
59f0: 73 73 65 72 74 28 20 70 2d 3e 6e 52 65 66 3e 30  ssert( p->nRef>0
5a00: 20 29 3b 0a 20 20 70 2d 3e 6e 52 65 66 2d 2d 3b   );.  p->nRef--;
5a10: 0a 20 20 69 66 28 20 70 2d 3e 6e 52 65 66 3d 3d  .  if( p->nRef==
5a20: 30 20 29 7b 0a 20 20 20 20 50 43 61 63 68 65 20  0 ){.    PCache 
5a30: 2a 70 43 61 63 68 65 20 3d 20 70 2d 3e 70 43 61  *pCache = p->pCa
5a40: 63 68 65 3b 0a 20 20 20 20 69 66 28 20 70 2d 3e  che;.    if( p->
5a50: 70 43 61 63 68 65 2d 3e 78 44 65 73 74 72 6f 79  pCache->xDestroy
5a60: 20 29 7b 0a 20 20 20 20 20 20 70 2d 3e 70 43 61   ){.      p->pCa
5a70: 63 68 65 2d 3e 78 44 65 73 74 72 6f 79 28 70 29  che->xDestroy(p)
5a80: 3b 0a 20 20 20 20 7d 0a 20 20 20 20 70 43 61 63  ;.    }.    pCac
5a90: 68 65 2d 3e 6e 52 65 66 2d 2d 3b 0a 20 20 20 20  he->nRef--;.    
5aa0: 69 66 28 20 28 70 2d 3e 66 6c 61 67 73 26 50 47  if( (p->flags&PG
5ab0: 48 44 52 5f 44 49 52 54 59 29 3d 3d 30 20 29 7b  HDR_DIRTY)==0 ){
5ac0: 0a 20 20 20 20 20 20 70 43 61 63 68 65 2d 3e 6e  .      pCache->n
5ad0: 50 69 6e 6e 65 64 2d 2d 3b 0a 20 20 20 20 20 20  Pinned--;.      
5ae0: 70 63 61 63 68 65 45 6e 74 65 72 4d 75 74 65 78  pcacheEnterMutex
5af0: 28 29 3b 0a 20 20 20 20 20 20 69 66 28 20 70 63  ();.      if( pc
5b00: 61 63 68 65 5f 67 2e 6e 43 75 72 72 65 6e 74 50  ache_g.nCurrentP
5b10: 61 67 65 3e 70 63 61 63 68 65 5f 67 2e 6e 4d 61  age>pcache_g.nMa
5b20: 78 50 61 67 65 20 29 7b 0a 20 20 20 20 20 20 20  xPage ){.       
5b30: 20 70 63 61 63 68 65 52 65 6d 6f 76 65 46 72 6f   pcacheRemoveFro
5b40: 6d 4c 69 73 74 28 26 70 43 61 63 68 65 2d 3e 70  mList(&pCache->p
5b50: 43 6c 65 61 6e 2c 20 70 29 3b 0a 20 20 20 20 20  Clean, p);.     
5b60: 20 20 20 70 63 61 63 68 65 52 65 6d 6f 76 65 46     pcacheRemoveF
5b70: 72 6f 6d 48 61 73 68 28 70 29 3b 0a 20 20 20 20  romHash(p);.    
5b80: 20 20 20 20 70 63 61 63 68 65 50 61 67 65 46 72      pcachePageFr
5b90: 65 65 28 70 29 3b 0a 20 20 20 20 20 20 7d 65 6c  ee(p);.      }el
5ba0: 73 65 7b 0a 20 20 20 20 20 20 20 20 70 63 61 63  se{.        pcac
5bb0: 68 65 41 64 64 54 6f 4c 72 75 4c 69 73 74 28 70  heAddToLruList(p
5bc0: 29 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 20  );.      }.     
5bd0: 20 70 63 61 63 68 65 45 78 69 74 4d 75 74 65 78   pcacheExitMutex
5be0: 28 29 3b 0a 20 20 20 20 7d 65 6c 73 65 7b 0a 20  ();.    }else{. 
5bf0: 20 20 20 20 20 2f 2a 20 4d 6f 76 65 20 74 68 65       /* Move the
5c00: 20 70 61 67 65 20 74 6f 20 74 68 65 20 68 65 61   page to the hea
5c10: 64 20 6f 66 20 74 68 65 20 63 61 63 68 65 73 20  d of the caches 
5c20: 64 69 72 74 79 20 6c 69 73 74 2e 20 2a 2f 0a 20  dirty list. */. 
5c30: 20 20 20 20 20 70 63 61 63 68 65 52 65 6d 6f 76       pcacheRemov
5c40: 65 46 72 6f 6d 4c 69 73 74 28 26 70 43 61 63 68  eFromList(&pCach
5c50: 65 2d 3e 70 44 69 72 74 79 2c 20 70 29 3b 0a 20  e->pDirty, p);. 
5c60: 20 20 20 20 20 70 63 61 63 68 65 41 64 64 54 6f       pcacheAddTo
5c70: 4c 69 73 74 28 26 70 43 61 63 68 65 2d 3e 70 44  List(&pCache->pD
5c80: 69 72 74 79 2c 20 70 29 3b 0a 20 20 20 20 7d 0a  irty, p);.    }.
5c90: 20 20 7d 0a 7d 0a 0a 76 6f 69 64 20 73 71 6c 69    }.}..void sqli
5ca0: 74 65 33 50 63 61 63 68 65 52 65 66 28 50 67 48  te3PcacheRef(PgH
5cb0: 64 72 20 2a 70 29 7b 0a 20 20 61 73 73 65 72 74  dr *p){.  assert
5cc0: 28 70 2d 3e 6e 52 65 66 3e 30 29 3b 0a 20 20 70  (p->nRef>0);.  p
5cd0: 2d 3e 6e 52 65 66 2b 2b 3b 0a 7d 0a 0a 2f 2a 0a  ->nRef++;.}../*.
5ce0: 2a 2a 20 44 72 6f 70 20 61 20 70 61 67 65 20 66  ** Drop a page f
5cf0: 72 6f 6d 20 74 68 65 20 63 61 63 68 65 2e 20 54  rom the cache. T
5d00: 68 65 72 65 20 6d 75 73 74 20 62 65 20 65 78 61  here must be exa
5d10: 63 74 6c 79 20 6f 6e 65 20 72 65 66 65 72 65 6e  ctly one referen
5d20: 63 65 20 74 6f 20 74 68 65 0a 2a 2a 20 70 61 67  ce to the.** pag
5d30: 65 2e 20 54 68 69 73 20 66 75 6e 63 74 69 6f 6e  e. This function
5d40: 20 64 65 6c 65 74 65 73 20 74 68 61 74 20 72 65   deletes that re
5d50: 66 65 72 65 6e 63 65 2c 20 73 6f 20 61 66 74 65  ference, so afte
5d60: 72 20 69 74 20 72 65 74 75 72 6e 73 20 74 68 65  r it returns the
5d70: 0a 2a 2a 20 70 61 67 65 20 70 6f 69 6e 74 65 64  .** page pointed
5d80: 20 74 6f 20 62 79 20 70 20 69 73 20 69 6e 76 61   to by p is inva
5d90: 6c 69 64 2e 0a 2a 2f 0a 76 6f 69 64 20 73 71 6c  lid..*/.void sql
5da0: 69 74 65 33 50 63 61 63 68 65 44 72 6f 70 28 50  ite3PcacheDrop(P
5db0: 67 48 64 72 20 2a 70 29 7b 0a 20 20 50 43 61 63  gHdr *p){.  PCac
5dc0: 68 65 20 2a 70 43 61 63 68 65 3b 0a 20 20 61 73  he *pCache;.  as
5dd0: 73 65 72 74 28 20 70 2d 3e 6e 52 65 66 3d 3d 31  sert( p->nRef==1
5de0: 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 30 3d   );.  assert( 0=
5df0: 3d 28 70 2d 3e 66 6c 61 67 73 26 50 47 48 44 52  =(p->flags&PGHDR
5e00: 5f 44 49 52 54 59 29 20 29 3b 0a 20 20 70 43 61  _DIRTY) );.  pCa
5e10: 63 68 65 20 3d 20 70 2d 3e 70 43 61 63 68 65 3b  che = p->pCache;
5e20: 0a 20 20 70 43 61 63 68 65 2d 3e 6e 52 65 66 2d  .  pCache->nRef-
5e30: 2d 3b 0a 20 20 70 43 61 63 68 65 2d 3e 6e 50 69  -;.  pCache->nPi
5e40: 6e 6e 65 64 2d 2d 3b 0a 20 20 70 63 61 63 68 65  nned--;.  pcache
5e50: 45 6e 74 65 72 4d 75 74 65 78 28 29 3b 0a 20 20  EnterMutex();.  
5e60: 70 63 61 63 68 65 52 65 6d 6f 76 65 46 72 6f 6d  pcacheRemoveFrom
5e70: 4c 69 73 74 28 26 70 43 61 63 68 65 2d 3e 70 43  List(&pCache->pC
5e80: 6c 65 61 6e 2c 20 70 29 3b 0a 20 20 70 63 61 63  lean, p);.  pcac
5e90: 68 65 52 65 6d 6f 76 65 46 72 6f 6d 48 61 73 68  heRemoveFromHash
5ea0: 28 70 29 3b 0a 20 20 70 63 61 63 68 65 50 61 67  (p);.  pcachePag
5eb0: 65 46 72 65 65 28 70 29 3b 0a 20 20 70 63 61 63  eFree(p);.  pcac
5ec0: 68 65 45 78 69 74 4d 75 74 65 78 28 29 3b 0a 7d  heExitMutex();.}
5ed0: 0a 0a 2f 2a 0a 2a 2a 20 4d 61 6b 65 20 73 75 72  ../*.** Make sur
5ee0: 65 20 74 68 65 20 70 61 67 65 20 69 73 20 6d 61  e the page is ma
5ef0: 72 6b 65 64 20 61 73 20 64 69 72 74 79 2e 20 20  rked as dirty.  
5f00: 49 66 20 69 74 20 69 73 6e 27 74 20 64 69 72 74  If it isn't dirt
5f10: 79 20 61 6c 72 65 61 64 79 2c 0a 2a 2a 20 6d 61  y already,.** ma
5f20: 6b 65 20 69 74 20 73 6f 2e 0a 2a 2f 0a 76 6f 69  ke it so..*/.voi
5f30: 64 20 73 71 6c 69 74 65 33 50 63 61 63 68 65 4d  d sqlite3PcacheM
5f40: 61 6b 65 44 69 72 74 79 28 50 67 48 64 72 20 2a  akeDirty(PgHdr *
5f50: 70 29 7b 0a 20 20 50 43 61 63 68 65 20 2a 70 43  p){.  PCache *pC
5f60: 61 63 68 65 3b 0a 20 20 70 2d 3e 66 6c 61 67 73  ache;.  p->flags
5f70: 20 26 3d 20 7e 50 47 48 44 52 5f 44 4f 4e 54 5f   &= ~PGHDR_DONT_
5f80: 57 52 49 54 45 3b 0a 20 20 69 66 28 20 70 2d 3e  WRITE;.  if( p->
5f90: 66 6c 61 67 73 20 26 20 50 47 48 44 52 5f 44 49  flags & PGHDR_DI
5fa0: 52 54 59 20 29 20 72 65 74 75 72 6e 3b 0a 20 20  RTY ) return;.  
5fb0: 61 73 73 65 72 74 28 20 28 70 2d 3e 66 6c 61 67  assert( (p->flag
5fc0: 73 20 26 20 50 47 48 44 52 5f 44 49 52 54 59 29  s & PGHDR_DIRTY)
5fd0: 3d 3d 30 20 29 3b 0a 20 20 61 73 73 65 72 74 28  ==0 );.  assert(
5fe0: 20 70 2d 3e 6e 52 65 66 3e 30 20 29 3b 0a 20 20   p->nRef>0 );.  
5ff0: 70 43 61 63 68 65 20 3d 20 70 2d 3e 70 43 61 63  pCache = p->pCac
6000: 68 65 3b 0a 20 20 70 63 61 63 68 65 45 6e 74 65  he;.  pcacheEnte
6010: 72 4d 75 74 65 78 28 29 3b 0a 20 20 70 63 61 63  rMutex();.  pcac
6020: 68 65 52 65 6d 6f 76 65 46 72 6f 6d 4c 69 73 74  heRemoveFromList
6030: 28 26 70 43 61 63 68 65 2d 3e 70 43 6c 65 61 6e  (&pCache->pClean
6040: 2c 20 70 29 3b 0a 20 20 70 63 61 63 68 65 41 64  , p);.  pcacheAd
6050: 64 54 6f 4c 69 73 74 28 26 70 43 61 63 68 65 2d  dToList(&pCache-
6060: 3e 70 44 69 72 74 79 2c 20 70 29 3b 0a 20 20 70  >pDirty, p);.  p
6070: 63 61 63 68 65 45 78 69 74 4d 75 74 65 78 28 29  cacheExitMutex()
6080: 3b 0a 20 20 70 2d 3e 66 6c 61 67 73 20 7c 3d 20  ;.  p->flags |= 
6090: 50 47 48 44 52 5f 44 49 52 54 59 3b 0a 7d 0a 0a  PGHDR_DIRTY;.}..
60a0: 76 6f 69 64 20 70 63 61 63 68 65 4d 61 6b 65 43  void pcacheMakeC
60b0: 6c 65 61 6e 28 50 67 48 64 72 20 2a 70 29 7b 0a  lean(PgHdr *p){.
60c0: 20 20 50 43 61 63 68 65 20 2a 70 43 61 63 68 65    PCache *pCache
60d0: 20 3d 20 70 2d 3e 70 43 61 63 68 65 3b 0a 20 20   = p->pCache;.  
60e0: 61 73 73 65 72 74 28 20 70 2d 3e 61 70 53 61 76  assert( p->apSav
60f0: 65 5b 30 5d 3d 3d 30 20 26 26 20 70 2d 3e 61 70  e[0]==0 && p->ap
6100: 53 61 76 65 5b 31 5d 3d 3d 30 20 29 3b 0a 20 20  Save[1]==0 );.  
6110: 61 73 73 65 72 74 28 20 70 2d 3e 66 6c 61 67 73  assert( p->flags
6120: 20 26 20 50 47 48 44 52 5f 44 49 52 54 59 20 29   & PGHDR_DIRTY )
6130: 3b 0a 20 20 70 63 61 63 68 65 52 65 6d 6f 76 65  ;.  pcacheRemove
6140: 46 72 6f 6d 4c 69 73 74 28 26 70 43 61 63 68 65  FromList(&pCache
6150: 2d 3e 70 44 69 72 74 79 2c 20 70 29 3b 0a 20 20  ->pDirty, p);.  
6160: 70 63 61 63 68 65 41 64 64 54 6f 4c 69 73 74 28  pcacheAddToList(
6170: 26 70 43 61 63 68 65 2d 3e 70 43 6c 65 61 6e 2c  &pCache->pClean,
6180: 20 70 29 3b 0a 20 20 70 2d 3e 66 6c 61 67 73 20   p);.  p->flags 
6190: 26 3d 20 7e 50 47 48 44 52 5f 44 49 52 54 59 3b  &= ~PGHDR_DIRTY;
61a0: 0a 20 20 69 66 28 20 70 2d 3e 6e 52 65 66 3d 3d  .  if( p->nRef==
61b0: 30 20 29 7b 0a 20 20 20 20 70 63 61 63 68 65 41  0 ){.    pcacheA
61c0: 64 64 54 6f 4c 72 75 4c 69 73 74 28 70 29 3b 0a  ddToLruList(p);.
61d0: 20 20 20 20 70 43 61 63 68 65 2d 3e 6e 50 69 6e      pCache->nPin
61e0: 6e 65 64 2d 2d 3b 0a 20 20 7d 0a 20 20 65 78 70  ned--;.  }.  exp
61f0: 65 6e 73 69 76 65 5f 61 73 73 65 72 74 28 20 70  ensive_assert( p
6200: 43 61 63 68 65 2d 3e 6e 50 69 6e 6e 65 64 3d 3d  Cache->nPinned==
6210: 70 63 61 63 68 65 50 69 6e 6e 65 64 43 6f 75 6e  pcachePinnedCoun
6220: 74 28 70 43 61 63 68 65 29 20 29 3b 0a 7d 0a 0a  t(pCache) );.}..
6230: 2f 2a 0a 2a 2a 20 4d 61 6b 65 20 73 75 72 65 20  /*.** Make sure 
6240: 74 68 65 20 70 61 67 65 20 69 73 20 6d 61 72 6b  the page is mark
6250: 65 64 20 61 73 20 63 6c 65 61 6e 2e 20 20 49 66  ed as clean.  If
6260: 20 69 74 20 69 73 6e 27 74 20 63 6c 65 61 6e 20   it isn't clean 
6270: 61 6c 72 65 61 64 79 2c 0a 2a 2a 20 6d 61 6b 65  already,.** make
6280: 20 69 74 20 73 6f 2e 0a 2a 2f 0a 76 6f 69 64 20   it so..*/.void 
6290: 73 71 6c 69 74 65 33 50 63 61 63 68 65 4d 61 6b  sqlite3PcacheMak
62a0: 65 43 6c 65 61 6e 28 50 67 48 64 72 20 2a 70 29  eClean(PgHdr *p)
62b0: 7b 0a 20 20 69 66 28 20 28 70 2d 3e 66 6c 61 67  {.  if( (p->flag
62c0: 73 20 26 20 50 47 48 44 52 5f 44 49 52 54 59 29  s & PGHDR_DIRTY)
62d0: 20 29 7b 0a 20 20 20 20 70 63 61 63 68 65 45 6e   ){.    pcacheEn
62e0: 74 65 72 4d 75 74 65 78 28 29 3b 0a 20 20 20 20  terMutex();.    
62f0: 70 63 61 63 68 65 4d 61 6b 65 43 6c 65 61 6e 28  pcacheMakeClean(
6300: 70 29 3b 0a 20 20 20 20 70 63 61 63 68 65 45 78  p);.    pcacheEx
6310: 69 74 4d 75 74 65 78 28 29 3b 0a 20 20 7d 0a 7d  itMutex();.  }.}
6320: 0a 0a 2f 2a 0a 2a 2a 20 4d 61 6b 65 20 65 76 65  ../*.** Make eve
6330: 72 79 20 70 61 67 65 20 69 6e 20 74 68 65 20 63  ry page in the c
6340: 61 63 68 65 20 63 6c 65 61 6e 2e 0a 2a 2f 0a 76  ache clean..*/.v
6350: 6f 69 64 20 73 71 6c 69 74 65 33 50 63 61 63 68  oid sqlite3Pcach
6360: 65 43 6c 65 61 6e 41 6c 6c 28 50 43 61 63 68 65  eCleanAll(PCache
6370: 20 2a 70 43 61 63 68 65 29 7b 0a 20 20 50 67 48   *pCache){.  PgH
6380: 64 72 20 2a 70 3b 0a 20 20 70 63 61 63 68 65 45  dr *p;.  pcacheE
6390: 6e 74 65 72 4d 75 74 65 78 28 29 3b 0a 20 20 77  nterMutex();.  w
63a0: 68 69 6c 65 28 20 28 70 20 3d 20 70 43 61 63 68  hile( (p = pCach
63b0: 65 2d 3e 70 44 69 72 74 79 29 21 3d 30 20 29 7b  e->pDirty)!=0 ){
63c0: 0a 20 20 20 20 61 73 73 65 72 74 28 20 70 2d 3e  .    assert( p->
63d0: 61 70 53 61 76 65 5b 30 5d 3d 3d 30 20 26 26 20  apSave[0]==0 && 
63e0: 70 2d 3e 61 70 53 61 76 65 5b 31 5d 3d 3d 30 20  p->apSave[1]==0 
63f0: 29 3b 0a 20 20 20 20 70 63 61 63 68 65 52 65 6d  );.    pcacheRem
6400: 6f 76 65 46 72 6f 6d 4c 69 73 74 28 26 70 43 61  oveFromList(&pCa
6410: 63 68 65 2d 3e 70 44 69 72 74 79 2c 20 70 29 3b  che->pDirty, p);
6420: 0a 20 20 20 20 70 2d 3e 66 6c 61 67 73 20 26 3d  .    p->flags &=
6430: 20 7e 50 47 48 44 52 5f 44 49 52 54 59 3b 0a 20   ~PGHDR_DIRTY;. 
6440: 20 20 20 70 63 61 63 68 65 41 64 64 54 6f 4c 69     pcacheAddToLi
6450: 73 74 28 26 70 43 61 63 68 65 2d 3e 70 43 6c 65  st(&pCache->pCle
6460: 61 6e 2c 20 70 29 3b 0a 20 20 20 20 69 66 28 20  an, p);.    if( 
6470: 70 2d 3e 6e 52 65 66 3d 3d 30 20 29 7b 0a 20 20  p->nRef==0 ){.  
6480: 20 20 20 20 70 63 61 63 68 65 41 64 64 54 6f 4c      pcacheAddToL
6490: 72 75 4c 69 73 74 28 70 29 3b 0a 20 20 20 20 20  ruList(p);.     
64a0: 20 70 43 61 63 68 65 2d 3e 6e 50 69 6e 6e 65 64   pCache->nPinned
64b0: 2d 2d 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a 20 20  --;.    }.  }.  
64c0: 73 71 6c 69 74 65 33 50 63 61 63 68 65 41 73 73  sqlite3PcacheAss
64d0: 65 72 74 46 6c 61 67 73 28 70 43 61 63 68 65 2c  ertFlags(pCache,
64e0: 20 30 2c 20 50 47 48 44 52 5f 44 49 52 54 59 29   0, PGHDR_DIRTY)
64f0: 3b 0a 20 20 65 78 70 65 6e 73 69 76 65 5f 61 73  ;.  expensive_as
6500: 73 65 72 74 28 20 70 43 61 63 68 65 2d 3e 6e 50  sert( pCache->nP
6510: 69 6e 6e 65 64 3d 3d 70 63 61 63 68 65 50 69 6e  inned==pcachePin
6520: 6e 65 64 43 6f 75 6e 74 28 70 43 61 63 68 65 29  nedCount(pCache)
6530: 20 29 3b 0a 20 20 70 63 61 63 68 65 45 78 69 74   );.  pcacheExit
6540: 4d 75 74 65 78 28 29 3b 0a 7d 0a 0a 2f 2a 0a 2a  Mutex();.}../*.*
6550: 2a 20 43 68 61 6e 67 65 20 74 68 65 20 70 61 67  * Change the pag
6560: 65 20 6e 75 6d 62 65 72 20 6f 66 20 70 61 67 65  e number of page
6570: 20 70 20 74 6f 20 6e 65 77 50 67 6e 6f 2e 20 49   p to newPgno. I
6580: 66 20 6e 65 77 50 67 6e 6f 20 69 73 20 30 2c 20  f newPgno is 0, 
6590: 74 68 65 6e 20 74 68 65 0a 2a 2a 20 70 61 67 65  then the.** page
65a0: 20 6f 62 6a 65 63 74 20 69 73 20 61 64 64 65 64   object is added
65b0: 20 74 6f 20 74 68 65 20 63 6c 65 61 6e 2d 6c 69   to the clean-li
65c0: 73 74 20 61 6e 64 20 74 68 65 20 50 47 48 44 52  st and the PGHDR
65d0: 5f 52 45 55 53 45 5f 55 4e 4c 49 4b 45 4c 59 20  _REUSE_UNLIKELY 
65e0: 0a 2a 2a 20 66 6c 61 67 20 73 65 74 2e 0a 2a 2f  .** flag set..*/
65f0: 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 50 63 61  .void sqlite3Pca
6600: 63 68 65 4d 6f 76 65 28 50 67 48 64 72 20 2a 70  cheMove(PgHdr *p
6610: 2c 20 50 67 6e 6f 20 6e 65 77 50 67 6e 6f 29 7b  , Pgno newPgno){
6620: 0a 20 20 61 73 73 65 72 74 28 20 70 2d 3e 6e 52  .  assert( p->nR
6630: 65 66 3e 30 20 29 3b 0a 20 20 70 63 61 63 68 65  ef>0 );.  pcache
6640: 45 6e 74 65 72 4d 75 74 65 78 28 29 3b 0a 20 20  EnterMutex();.  
6650: 70 63 61 63 68 65 52 65 6d 6f 76 65 46 72 6f 6d  pcacheRemoveFrom
6660: 48 61 73 68 28 70 29 3b 0a 20 20 70 2d 3e 70 67  Hash(p);.  p->pg
6670: 6e 6f 20 3d 20 6e 65 77 50 67 6e 6f 3b 0a 20 20  no = newPgno;.  
6680: 69 66 28 20 6e 65 77 50 67 6e 6f 3d 3d 30 20 29  if( newPgno==0 )
6690: 7b 0a 20 20 20 20 70 2d 3e 66 6c 61 67 73 20 7c  {.    p->flags |
66a0: 3d 20 50 47 48 44 52 5f 52 45 55 53 45 5f 55 4e  = PGHDR_REUSE_UN
66b0: 4c 49 4b 45 4c 59 3b 0a 20 20 20 20 70 63 61 63  LIKELY;.    pcac
66c0: 68 65 46 72 65 65 28 70 2d 3e 61 70 53 61 76 65  heFree(p->apSave
66d0: 5b 30 5d 29 3b 0a 20 20 20 20 70 63 61 63 68 65  [0]);.    pcache
66e0: 46 72 65 65 28 70 2d 3e 61 70 53 61 76 65 5b 31  Free(p->apSave[1
66f0: 5d 29 3b 0a 20 20 20 20 70 2d 3e 61 70 53 61 76  ]);.    p->apSav
6700: 65 5b 30 5d 20 3d 20 30 3b 0a 20 20 20 20 70 2d  e[0] = 0;.    p-
6710: 3e 61 70 53 61 76 65 5b 31 5d 20 3d 20 30 3b 0a  >apSave[1] = 0;.
6720: 20 20 20 20 69 66 28 20 28 70 2d 3e 66 6c 61 67      if( (p->flag
6730: 73 20 26 20 50 47 48 44 52 5f 44 49 52 54 59 29  s & PGHDR_DIRTY)
6740: 20 29 7b 0a 20 20 20 20 20 20 70 63 61 63 68 65   ){.      pcache
6750: 4d 61 6b 65 43 6c 65 61 6e 28 70 29 3b 0a 20 20  MakeClean(p);.  
6760: 20 20 7d 0a 20 20 7d 0a 20 20 70 63 61 63 68 65    }.  }.  pcache
6770: 41 64 64 54 6f 48 61 73 68 28 70 29 3b 0a 20 20  AddToHash(p);.  
6780: 70 63 61 63 68 65 45 78 69 74 4d 75 74 65 78 28  pcacheExitMutex(
6790: 29 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 52 65 6d 6f  );.}../*.** Remo
67a0: 76 65 20 61 6c 6c 20 63 6f 6e 74 65 6e 74 20 66  ve all content f
67b0: 72 6f 6d 20 61 20 70 61 67 65 20 63 61 63 68 65  rom a page cache
67c0: 0a 2a 2f 0a 76 6f 69 64 20 70 63 61 63 68 65 43  .*/.void pcacheC
67d0: 6c 65 61 72 28 50 43 61 63 68 65 20 2a 70 43 61  lear(PCache *pCa
67e0: 63 68 65 29 7b 0a 20 20 50 67 48 64 72 20 2a 70  che){.  PgHdr *p
67f0: 2c 20 2a 70 4e 65 78 74 3b 0a 20 20 61 73 73 65  , *pNext;.  asse
6800: 72 74 28 20 73 71 6c 69 74 65 33 5f 6d 75 74 65  rt( sqlite3_mute
6810: 78 5f 68 65 6c 64 28 70 63 61 63 68 65 5f 67 2e  x_held(pcache_g.
6820: 6d 75 74 65 78 29 20 29 3b 0a 20 20 66 6f 72 28  mutex) );.  for(
6830: 70 3d 70 43 61 63 68 65 2d 3e 70 43 6c 65 61 6e  p=pCache->pClean
6840: 3b 20 70 3b 20 70 3d 70 4e 65 78 74 29 7b 0a 20  ; p; p=pNext){. 
6850: 20 20 20 70 4e 65 78 74 20 3d 20 70 2d 3e 70 4e     pNext = p->pN
6860: 65 78 74 3b 0a 20 20 20 20 70 63 61 63 68 65 52  ext;.    pcacheR
6870: 65 6d 6f 76 65 46 72 6f 6d 4c 72 75 4c 69 73 74  emoveFromLruList
6880: 28 70 29 3b 0a 20 20 20 20 70 63 61 63 68 65 50  (p);.    pcacheP
6890: 61 67 65 46 72 65 65 28 70 29 3b 0a 20 20 7d 0a  ageFree(p);.  }.
68a0: 20 20 66 6f 72 28 70 3d 70 43 61 63 68 65 2d 3e    for(p=pCache->
68b0: 70 44 69 72 74 79 3b 20 70 3b 20 70 3d 70 4e 65  pDirty; p; p=pNe
68c0: 78 74 29 7b 0a 20 20 20 20 70 4e 65 78 74 20 3d  xt){.    pNext =
68d0: 20 70 2d 3e 70 4e 65 78 74 3b 0a 20 20 20 20 70   p->pNext;.    p
68e0: 63 61 63 68 65 50 61 67 65 46 72 65 65 28 70 29  cachePageFree(p)
68f0: 3b 0a 20 20 7d 0a 20 20 70 43 61 63 68 65 2d 3e  ;.  }.  pCache->
6900: 70 43 6c 65 61 6e 20 3d 20 30 3b 0a 20 20 70 43  pClean = 0;.  pC
6910: 61 63 68 65 2d 3e 70 44 69 72 74 79 20 3d 20 30  ache->pDirty = 0
6920: 3b 0a 20 20 70 43 61 63 68 65 2d 3e 70 44 69 72  ;.  pCache->pDir
6930: 74 79 54 61 69 6c 20 3d 20 30 3b 0a 20 20 70 43  tyTail = 0;.  pC
6940: 61 63 68 65 2d 3e 6e 50 61 67 65 20 3d 20 30 3b  ache->nPage = 0;
6950: 0a 20 20 70 43 61 63 68 65 2d 3e 6e 50 69 6e 6e  .  pCache->nPinn
6960: 65 64 20 3d 20 30 3b 0a 20 20 6d 65 6d 73 65 74  ed = 0;.  memset
6970: 28 70 43 61 63 68 65 2d 3e 61 70 48 61 73 68 2c  (pCache->apHash,
6980: 20 30 2c 20 70 43 61 63 68 65 2d 3e 6e 48 61 73   0, pCache->nHas
6990: 68 2a 73 69 7a 65 6f 66 28 70 43 61 63 68 65 2d  h*sizeof(pCache-
69a0: 3e 61 70 48 61 73 68 5b 30 5d 29 29 3b 0a 7d 0a  >apHash[0]));.}.
69b0: 0a 0a 2f 2a 0a 2a 2a 20 44 72 6f 70 20 65 76 65  ../*.** Drop eve
69c0: 72 79 20 63 61 63 68 65 20 65 6e 74 72 79 20 77  ry cache entry w
69d0: 68 6f 73 65 20 70 61 67 65 20 6e 75 6d 62 65 72  hose page number
69e0: 20 69 73 20 67 72 65 61 74 65 72 20 74 68 61 6e   is greater than
69f0: 20 22 70 67 6e 6f 22 2e 0a 2a 2f 0a 76 6f 69 64   "pgno"..*/.void
6a00: 20 73 71 6c 69 74 65 33 50 63 61 63 68 65 54 72   sqlite3PcacheTr
6a10: 75 6e 63 61 74 65 28 50 43 61 63 68 65 20 2a 70  uncate(PCache *p
6a20: 43 61 63 68 65 2c 20 50 67 6e 6f 20 70 67 6e 6f  Cache, Pgno pgno
6a30: 29 7b 0a 20 20 50 67 48 64 72 20 2a 70 2c 20 2a  ){.  PgHdr *p, *
6a40: 70 4e 65 78 74 3b 0a 20 20 50 67 48 64 72 20 2a  pNext;.  PgHdr *
6a50: 70 44 69 72 74 79 20 3d 20 70 43 61 63 68 65 2d  pDirty = pCache-
6a60: 3e 70 44 69 72 74 79 3b 0a 20 20 70 63 61 63 68  >pDirty;.  pcach
6a70: 65 45 6e 74 65 72 4d 75 74 65 78 28 29 3b 0a 20  eEnterMutex();. 
6a80: 20 66 6f 72 28 70 3d 70 43 61 63 68 65 2d 3e 70   for(p=pCache->p
6a90: 43 6c 65 61 6e 3b 20 70 7c 7c 70 44 69 72 74 79  Clean; p||pDirty
6aa0: 3b 20 70 3d 70 4e 65 78 74 29 7b 0a 20 20 20 20  ; p=pNext){.    
6ab0: 69 66 28 20 21 70 20 29 7b 0a 20 20 20 20 20 20  if( !p ){.      
6ac0: 70 20 3d 20 70 44 69 72 74 79 3b 0a 20 20 20 20  p = pDirty;.    
6ad0: 20 20 70 44 69 72 74 79 20 3d 20 30 3b 0a 20 20    pDirty = 0;.  
6ae0: 20 20 7d 0a 20 20 20 20 70 4e 65 78 74 20 3d 20    }.    pNext = 
6af0: 70 2d 3e 70 4e 65 78 74 3b 0a 20 20 20 20 69 66  p->pNext;.    if
6b00: 28 20 70 2d 3e 70 67 6e 6f 3e 70 67 6e 6f 20 29  ( p->pgno>pgno )
6b10: 7b 0a 20 20 20 20 20 20 69 66 28 20 70 2d 3e 6e  {.      if( p->n
6b20: 52 65 66 3d 3d 30 20 29 7b 0a 20 20 20 20 20 20  Ref==0 ){.      
6b30: 20 20 70 63 61 63 68 65 52 65 6d 6f 76 65 46 72    pcacheRemoveFr
6b40: 6f 6d 48 61 73 68 28 70 29 3b 0a 20 20 20 20 20  omHash(p);.     
6b50: 20 20 20 69 66 28 20 70 2d 3e 66 6c 61 67 73 26     if( p->flags&
6b60: 50 47 48 44 52 5f 44 49 52 54 59 20 29 7b 0a 20  PGHDR_DIRTY ){. 
6b70: 20 20 20 20 20 20 20 20 20 70 63 61 63 68 65 52           pcacheR
6b80: 65 6d 6f 76 65 46 72 6f 6d 4c 69 73 74 28 26 70  emoveFromList(&p
6b90: 43 61 63 68 65 2d 3e 70 44 69 72 74 79 2c 20 70  Cache->pDirty, p
6ba0: 29 3b 0a 20 20 20 20 20 20 20 20 20 20 70 43 61  );.          pCa
6bb0: 63 68 65 2d 3e 6e 50 69 6e 6e 65 64 2d 2d 3b 0a  che->nPinned--;.
6bc0: 20 20 20 20 20 20 20 20 7d 65 6c 73 65 7b 0a 20          }else{. 
6bd0: 20 20 20 20 20 20 20 20 20 70 63 61 63 68 65 52           pcacheR
6be0: 65 6d 6f 76 65 46 72 6f 6d 4c 69 73 74 28 26 70  emoveFromList(&p
6bf0: 43 61 63 68 65 2d 3e 70 43 6c 65 61 6e 2c 20 70  Cache->pClean, p
6c00: 29 3b 0a 20 20 20 20 20 20 20 20 20 20 70 63 61  );.          pca
6c10: 63 68 65 52 65 6d 6f 76 65 46 72 6f 6d 4c 72 75  cheRemoveFromLru
6c20: 4c 69 73 74 28 70 29 3b 0a 20 20 20 20 20 20 20  List(p);.       
6c30: 20 7d 0a 20 20 20 20 20 20 20 20 70 63 61 63 68   }.        pcach
6c40: 65 50 61 67 65 46 72 65 65 28 70 29 3b 0a 20 20  ePageFree(p);.  
6c50: 20 20 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 20      }else{.     
6c60: 20 20 20 2f 2a 20 49 66 20 74 68 65 72 65 20 61     /* If there a
6c70: 72 65 20 72 65 66 65 72 65 6e 63 65 73 20 74 6f  re references to
6c80: 20 74 68 65 20 70 61 67 65 2c 20 69 74 20 63 61   the page, it ca
6c90: 6e 6e 6f 74 20 62 65 20 66 72 65 65 64 2e 20 49  nnot be freed. I
6ca0: 6e 20 74 68 69 73 0a 20 20 20 20 20 20 20 20 2a  n this.        *
6cb0: 2a 20 63 61 73 65 2c 20 7a 65 72 6f 20 74 68 65  * case, zero the
6cc0: 20 70 61 67 65 20 63 6f 6e 74 65 6e 74 20 69 6e   page content in
6cd0: 73 74 65 61 64 2e 0a 20 20 20 20 20 20 20 20 2a  stead..        *
6ce0: 2f 0a 20 20 20 20 20 20 20 20 6d 65 6d 73 65 74  /.        memset
6cf0: 28 70 2d 3e 70 44 61 74 61 2c 20 30 2c 20 70 43  (p->pData, 0, pC
6d00: 61 63 68 65 2d 3e 73 7a 50 61 67 65 29 3b 0a 20  ache->szPage);. 
6d10: 20 20 20 20 20 7d 0a 20 20 20 20 7d 0a 20 20 7d       }.    }.  }
6d20: 0a 20 20 70 63 61 63 68 65 45 78 69 74 4d 75 74  .  pcacheExitMut
6d30: 65 78 28 29 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 49  ex();.}../*.** I
6d40: 66 20 74 68 65 72 65 20 61 72 65 20 63 75 72 72  f there are curr
6d50: 65 6e 74 6c 79 20 6d 6f 72 65 20 74 68 61 6e 20  ently more than 
6d60: 70 63 61 63 68 65 2e 6e 4d 61 78 50 61 67 65 20  pcache.nMaxPage 
6d70: 70 61 67 65 73 20 61 6c 6c 6f 63 61 74 65 64 2c  pages allocated,
6d80: 20 74 72 79 0a 2a 2a 20 74 6f 20 72 65 63 79 63   try.** to recyc
6d90: 6c 65 20 70 61 67 65 73 20 74 6f 20 72 65 64 75  le pages to redu
6da0: 63 65 20 74 68 65 20 6e 75 6d 62 65 72 20 61 6c  ce the number al
6db0: 6c 6f 63 61 74 65 64 20 74 6f 20 70 63 61 63 68  located to pcach
6dc0: 65 2e 6e 4d 61 78 50 61 67 65 2e 0a 2a 2f 0a 73  e.nMaxPage..*/.s
6dd0: 74 61 74 69 63 20 76 6f 69 64 20 70 63 61 63 68  tatic void pcach
6de0: 65 45 6e 66 6f 72 63 65 4d 61 78 50 61 67 65 28  eEnforceMaxPage(
6df0: 29 7b 0a 20 20 50 67 48 64 72 20 2a 70 3b 0a 20  ){.  PgHdr *p;. 
6e00: 20 61 73 73 65 72 74 28 20 73 71 6c 69 74 65 33   assert( sqlite3
6e10: 5f 6d 75 74 65 78 5f 68 65 6c 64 28 70 63 61 63  _mutex_held(pcac
6e20: 68 65 5f 67 2e 6d 75 74 65 78 29 20 29 3b 0a 20  he_g.mutex) );. 
6e30: 20 77 68 69 6c 65 28 20 70 63 61 63 68 65 5f 67   while( pcache_g
6e40: 2e 6e 43 75 72 72 65 6e 74 50 61 67 65 3e 70 63  .nCurrentPage>pc
6e50: 61 63 68 65 5f 67 2e 6e 4d 61 78 50 61 67 65 20  ache_g.nMaxPage 
6e60: 26 26 20 28 70 20 3d 20 70 63 61 63 68 65 52 65  && (p = pcacheRe
6e70: 63 79 63 6c 65 50 61 67 65 28 29 29 20 29 7b 0a  cyclePage()) ){.
6e80: 20 20 20 20 70 63 61 63 68 65 50 61 67 65 46 72      pcachePageFr
6e90: 65 65 28 70 29 3b 0a 20 20 7d 0a 7d 0a 0a 2f 2a  ee(p);.  }.}../*
6ea0: 0a 2a 2a 20 43 6c 6f 73 65 20 61 20 63 61 63 68  .** Close a cach
6eb0: 65 2e 0a 2a 2f 0a 76 6f 69 64 20 73 71 6c 69 74  e..*/.void sqlit
6ec0: 65 33 50 63 61 63 68 65 43 6c 6f 73 65 28 50 43  e3PcacheClose(PC
6ed0: 61 63 68 65 20 2a 70 43 61 63 68 65 29 7b 0a 20  ache *pCache){. 
6ee0: 20 70 63 61 63 68 65 45 6e 74 65 72 4d 75 74 65   pcacheEnterMute
6ef0: 78 28 29 3b 0a 0a 20 20 2f 2a 20 46 72 65 65 20  x();..  /* Free 
6f00: 61 6c 6c 20 74 68 65 20 70 61 67 65 73 20 75 73  all the pages us
6f10: 65 64 20 62 79 20 74 68 69 73 20 70 61 67 65 72  ed by this pager
6f20: 20 61 6e 64 20 72 65 6d 6f 76 65 20 74 68 65 6d   and remove them
6f30: 20 66 72 6f 6d 20 74 68 65 20 4c 52 55 20 6c 69   from the LRU li
6f40: 73 74 2e 20 2a 2f 0a 20 20 70 63 61 63 68 65 43  st. */.  pcacheC
6f50: 6c 65 61 72 28 70 43 61 63 68 65 29 3b 0a 20 20  lear(pCache);.  
6f60: 69 66 28 20 70 43 61 63 68 65 2d 3e 62 50 75 72  if( pCache->bPur
6f70: 67 65 61 62 6c 65 20 29 7b 0a 20 20 20 20 70 63  geable ){.    pc
6f80: 61 63 68 65 5f 67 2e 6e 4d 61 78 50 61 67 65 20  ache_g.nMaxPage 
6f90: 2d 3d 20 70 43 61 63 68 65 2d 3e 6e 4d 61 78 3b  -= pCache->nMax;
6fa0: 0a 20 20 20 20 70 63 61 63 68 65 5f 67 2e 6e 4d  .    pcache_g.nM
6fb0: 69 6e 50 61 67 65 20 2d 3d 20 70 43 61 63 68 65  inPage -= pCache
6fc0: 2d 3e 6e 4d 69 6e 3b 0a 20 20 20 20 70 63 61 63  ->nMin;.    pcac
6fd0: 68 65 45 6e 66 6f 72 63 65 4d 61 78 50 61 67 65  heEnforceMaxPage
6fe0: 28 29 3b 0a 20 20 7d 0a 20 20 73 71 6c 69 74 65  ();.  }.  sqlite
6ff0: 33 5f 66 72 65 65 28 70 43 61 63 68 65 2d 3e 61  3_free(pCache->a
7000: 70 48 61 73 68 29 3b 0a 20 20 70 63 61 63 68 65  pHash);.  pcache
7010: 45 78 69 74 4d 75 74 65 78 28 29 3b 0a 7d 0a 0a  ExitMutex();.}..
7020: 2f 2a 0a 2a 2a 20 50 72 65 73 65 72 76 65 20 74  /*.** Preserve t
7030: 68 65 20 63 6f 6e 74 65 6e 74 20 6f 66 20 74 68  he content of th
7040: 65 20 70 61 67 65 2e 20 20 49 74 20 69 73 20 61  e page.  It is a
7050: 73 73 75 6d 65 64 20 74 68 61 74 20 74 68 65 20  ssumed that the 
7060: 63 6f 6e 74 65 6e 74 0a 2a 2a 20 68 61 73 20 6e  content.** has n
7070: 6f 74 20 62 65 65 6e 20 70 72 65 73 65 72 76 65  ot been preserve
7080: 64 20 61 6c 72 65 61 64 79 2e 0a 2a 2a 0a 2a 2a  d already..**.**
7090: 20 49 66 20 69 64 4a 6f 75 72 6e 61 6c 3d 3d 30   If idJournal==0
70a0: 20 74 68 65 6e 20 74 68 69 73 20 69 73 20 66 6f   then this is fo
70b0: 72 20 74 68 65 20 6f 76 65 72 61 6c 6c 20 74 72  r the overall tr
70c0: 61 6e 73 61 63 74 69 6f 6e 2e 0a 2a 2a 20 49 66  ansaction..** If
70d0: 20 69 64 4a 6f 75 72 6e 61 6c 3d 3d 31 20 74 68   idJournal==1 th
70e0: 65 6e 20 74 68 69 73 20 69 73 20 66 6f 72 20 74  en this is for t
70f0: 68 65 20 73 74 61 74 65 6d 65 6e 74 20 6a 6f 75  he statement jou
7100: 72 6e 61 6c 2e 0a 2a 2a 0a 2a 2a 20 54 68 69 73  rnal..**.** This
7110: 20 72 6f 75 74 69 6e 65 20 69 73 20 75 73 65 64   routine is used
7120: 20 66 6f 72 20 69 6e 2d 6d 65 6d 6f 72 79 20 64   for in-memory d
7130: 61 74 61 62 61 73 65 73 20 6f 6e 6c 79 2e 0a 2a  atabases only..*
7140: 2a 0a 2a 2a 20 52 65 74 75 72 6e 20 53 51 4c 49  *.** Return SQLI
7150: 54 45 5f 4f 4b 20 6f 72 20 53 51 4c 49 54 45 5f  TE_OK or SQLITE_
7160: 4e 4f 4d 45 4d 20 69 66 20 61 20 6d 65 6d 6f 72  NOMEM if a memor
7170: 79 20 61 6c 6c 6f 63 61 74 69 6f 6e 20 66 61 69  y allocation fai
7180: 6c 73 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74  ls..*/.int sqlit
7190: 65 33 50 63 61 63 68 65 50 72 65 73 65 72 76 65  e3PcachePreserve
71a0: 28 50 67 48 64 72 20 2a 70 2c 20 69 6e 74 20 69  (PgHdr *p, int i
71b0: 64 4a 6f 75 72 6e 61 6c 29 7b 0a 20 20 76 6f 69  dJournal){.  voi
71c0: 64 20 2a 78 3b 0a 20 20 69 6e 74 20 73 7a 3b 0a  d *x;.  int sz;.
71d0: 20 20 61 73 73 65 72 74 28 20 70 2d 3e 70 43 61    assert( p->pCa
71e0: 63 68 65 2d 3e 62 50 75 72 67 65 61 62 6c 65 3d  che->bPurgeable=
71f0: 3d 30 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20  =0 );.  assert( 
7200: 70 2d 3e 61 70 53 61 76 65 5b 69 64 4a 6f 75 72  p->apSave[idJour
7210: 6e 61 6c 5d 3d 3d 30 20 29 3b 0a 20 20 73 7a 20  nal]==0 );.  sz 
7220: 3d 20 70 2d 3e 70 43 61 63 68 65 2d 3e 73 7a 50  = p->pCache->szP
7230: 61 67 65 3b 0a 20 20 70 2d 3e 61 70 53 61 76 65  age;.  p->apSave
7240: 5b 69 64 4a 6f 75 72 6e 61 6c 5d 20 3d 20 78 20  [idJournal] = x 
7250: 3d 20 73 71 6c 69 74 65 33 50 61 67 65 4d 61 6c  = sqlite3PageMal
7260: 6c 6f 63 28 20 73 7a 20 29 3b 0a 20 20 69 66 28  loc( sz );.  if(
7270: 20 78 3d 3d 30 20 29 20 72 65 74 75 72 6e 20 53   x==0 ) return S
7280: 51 4c 49 54 45 5f 4e 4f 4d 45 4d 3b 0a 20 20 6d  QLITE_NOMEM;.  m
7290: 65 6d 63 70 79 28 78 2c 20 70 2d 3e 70 44 61 74  emcpy(x, p->pDat
72a0: 61 2c 20 73 7a 29 3b 0a 20 20 72 65 74 75 72 6e  a, sz);.  return
72b0: 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 7d 0a 0a 2f   SQLITE_OK;.}../
72c0: 2a 0a 2a 2a 20 43 6f 6d 6d 69 74 20 61 20 63 68  *.** Commit a ch
72d0: 61 6e 67 65 20 70 72 65 76 69 6f 75 73 6c 79 20  ange previously 
72e0: 70 72 65 73 65 72 76 65 64 2e 0a 2a 2f 0a 76 6f  preserved..*/.vo
72f0: 69 64 20 73 71 6c 69 74 65 33 50 63 61 63 68 65  id sqlite3Pcache
7300: 43 6f 6d 6d 69 74 28 50 43 61 63 68 65 20 2a 70  Commit(PCache *p
7310: 43 61 63 68 65 2c 20 69 6e 74 20 69 64 4a 6f 75  Cache, int idJou
7320: 72 6e 61 6c 29 7b 0a 20 20 50 67 48 64 72 20 2a  rnal){.  PgHdr *
7330: 70 3b 0a 20 20 70 63 61 63 68 65 45 6e 74 65 72  p;.  pcacheEnter
7340: 4d 75 74 65 78 28 29 3b 20 20 20 20 20 2f 2a 20  Mutex();     /* 
7350: 4d 75 74 65 78 20 69 73 20 72 65 71 75 69 72 65  Mutex is require
7360: 64 20 74 6f 20 63 61 6c 6c 20 70 63 61 63 68 65  d to call pcache
7370: 46 72 65 65 28 29 20 2a 2f 0a 20 20 66 6f 72 28  Free() */.  for(
7380: 70 3d 70 43 61 63 68 65 2d 3e 70 44 69 72 74 79  p=pCache->pDirty
7390: 3b 20 70 3b 20 70 3d 70 2d 3e 70 4e 65 78 74 29  ; p; p=p->pNext)
73a0: 7b 0a 20 20 20 20 69 66 28 20 70 2d 3e 61 70 53  {.    if( p->apS
73b0: 61 76 65 5b 69 64 4a 6f 75 72 6e 61 6c 5d 20 29  ave[idJournal] )
73c0: 7b 0a 20 20 20 20 20 20 70 63 61 63 68 65 46 72  {.      pcacheFr
73d0: 65 65 28 70 2d 3e 61 70 53 61 76 65 5b 69 64 4a  ee(p->apSave[idJ
73e0: 6f 75 72 6e 61 6c 5d 29 3b 0a 20 20 20 20 20 20  ournal]);.      
73f0: 70 2d 3e 61 70 53 61 76 65 5b 69 64 4a 6f 75 72  p->apSave[idJour
7400: 6e 61 6c 5d 20 3d 20 30 3b 0a 20 20 20 20 7d 0a  nal] = 0;.    }.
7410: 20 20 7d 0a 20 20 70 63 61 63 68 65 45 78 69 74    }.  pcacheExit
7420: 4d 75 74 65 78 28 29 3b 0a 7d 0a 0a 2f 2a 0a 2a  Mutex();.}../*.*
7430: 2a 20 52 6f 6c 6c 62 61 63 6b 20 61 20 63 68 61  * Rollback a cha
7440: 6e 67 65 20 70 72 65 76 69 6f 75 73 6c 79 20 70  nge previously p
7450: 72 65 73 65 72 76 65 64 2e 0a 2a 2f 0a 76 6f 69  reserved..*/.voi
7460: 64 20 73 71 6c 69 74 65 33 50 63 61 63 68 65 52  d sqlite3PcacheR
7470: 6f 6c 6c 62 61 63 6b 28 50 43 61 63 68 65 20 2a  ollback(PCache *
7480: 70 43 61 63 68 65 2c 20 69 6e 74 20 69 64 4a 6f  pCache, int idJo
7490: 75 72 6e 61 6c 29 7b 0a 20 20 50 67 48 64 72 20  urnal){.  PgHdr 
74a0: 2a 70 3b 0a 20 20 69 6e 74 20 73 7a 3b 0a 20 20  *p;.  int sz;.  
74b0: 70 63 61 63 68 65 45 6e 74 65 72 4d 75 74 65 78  pcacheEnterMutex
74c0: 28 29 3b 20 20 20 20 20 2f 2a 20 4d 75 74 65 78  ();     /* Mutex
74d0: 20 69 73 20 72 65 71 75 69 72 65 64 20 74 6f 20   is required to 
74e0: 63 61 6c 6c 20 70 63 61 63 68 65 46 72 65 65 28  call pcacheFree(
74f0: 29 20 2a 2f 0a 20 20 73 7a 20 3d 20 70 43 61 63  ) */.  sz = pCac
7500: 68 65 2d 3e 73 7a 50 61 67 65 3b 0a 20 20 66 6f  he->szPage;.  fo
7510: 72 28 70 3d 70 43 61 63 68 65 2d 3e 70 44 69 72  r(p=pCache->pDir
7520: 74 79 3b 20 70 3b 20 70 3d 70 2d 3e 70 4e 65 78  ty; p; p=p->pNex
7530: 74 29 7b 0a 20 20 20 20 69 66 28 20 70 2d 3e 61  t){.    if( p->a
7540: 70 53 61 76 65 5b 69 64 4a 6f 75 72 6e 61 6c 5d  pSave[idJournal]
7550: 20 29 7b 0a 20 20 20 20 20 20 6d 65 6d 63 70 79   ){.      memcpy
7560: 28 70 2d 3e 70 44 61 74 61 2c 20 70 2d 3e 61 70  (p->pData, p->ap
7570: 53 61 76 65 5b 69 64 4a 6f 75 72 6e 61 6c 5d 2c  Save[idJournal],
7580: 20 73 7a 29 3b 0a 20 20 20 20 20 20 70 63 61 63   sz);.      pcac
7590: 68 65 46 72 65 65 28 70 2d 3e 61 70 53 61 76 65  heFree(p->apSave
75a0: 5b 69 64 4a 6f 75 72 6e 61 6c 5d 29 3b 0a 20 20  [idJournal]);.  
75b0: 20 20 20 20 70 2d 3e 61 70 53 61 76 65 5b 69 64      p->apSave[id
75c0: 4a 6f 75 72 6e 61 6c 5d 20 3d 20 30 3b 0a 20 20  Journal] = 0;.  
75d0: 20 20 7d 0a 20 20 7d 0a 20 20 70 63 61 63 68 65    }.  }.  pcache
75e0: 45 78 69 74 4d 75 74 65 78 28 29 3b 0a 7d 0a 0a  ExitMutex();.}..
75f0: 2f 2a 20 0a 2a 2a 20 41 73 73 65 72 74 20 66 6c  /* .** Assert fl
7600: 61 67 73 20 73 65 74 74 69 6e 67 73 20 6f 6e 20  ags settings on 
7610: 61 6c 6c 20 70 61 67 65 73 2e 20 20 44 65 62 75  all pages.  Debu
7620: 67 67 69 6e 67 20 6f 6e 6c 79 2e 0a 2a 2f 0a 76  gging only..*/.v
7630: 6f 69 64 20 73 71 6c 69 74 65 33 50 63 61 63 68  oid sqlite3Pcach
7640: 65 41 73 73 65 72 74 46 6c 61 67 73 28 50 43 61  eAssertFlags(PCa
7650: 63 68 65 20 2a 70 43 61 63 68 65 2c 20 69 6e 74  che *pCache, int
7660: 20 74 72 75 65 4d 61 73 6b 2c 20 69 6e 74 20 66   trueMask, int f
7670: 61 6c 73 65 4d 61 73 6b 29 7b 0a 20 20 50 67 48  alseMask){.  PgH
7680: 64 72 20 2a 70 3b 0a 20 20 66 6f 72 28 70 3d 70  dr *p;.  for(p=p
7690: 43 61 63 68 65 2d 3e 70 44 69 72 74 79 3b 20 70  Cache->pDirty; p
76a0: 3b 20 70 3d 70 2d 3e 70 4e 65 78 74 29 7b 0a 20  ; p=p->pNext){. 
76b0: 20 20 20 61 73 73 65 72 74 28 20 28 70 2d 3e 66     assert( (p->f
76c0: 6c 61 67 73 26 74 72 75 65 4d 61 73 6b 29 3d 3d  lags&trueMask)==
76d0: 74 72 75 65 4d 61 73 6b 20 29 3b 0a 20 20 20 20  trueMask );.    
76e0: 61 73 73 65 72 74 28 20 28 70 2d 3e 66 6c 61 67  assert( (p->flag
76f0: 73 26 66 61 6c 73 65 4d 61 73 6b 29 3d 3d 30 20  s&falseMask)==0 
7700: 29 3b 0a 20 20 7d 0a 20 20 66 6f 72 28 70 3d 70  );.  }.  for(p=p
7710: 43 61 63 68 65 2d 3e 70 43 6c 65 61 6e 3b 20 70  Cache->pClean; p
7720: 3b 20 70 3d 70 2d 3e 70 4e 65 78 74 29 7b 0a 20  ; p=p->pNext){. 
7730: 20 20 20 61 73 73 65 72 74 28 20 28 70 2d 3e 66     assert( (p->f
7740: 6c 61 67 73 26 74 72 75 65 4d 61 73 6b 29 3d 3d  lags&trueMask)==
7750: 74 72 75 65 4d 61 73 6b 20 29 3b 0a 20 20 20 20  trueMask );.    
7760: 61 73 73 65 72 74 28 20 28 70 2d 3e 66 6c 61 67  assert( (p->flag
7770: 73 26 66 61 6c 73 65 4d 61 73 6b 29 3d 3d 30 20  s&falseMask)==0 
7780: 29 3b 0a 20 20 7d 0a 7d 0a 0a 2f 2a 20 0a 2a 2a  );.  }.}../* .**
7790: 20 44 69 73 63 61 72 64 20 74 68 65 20 63 6f 6e   Discard the con
77a0: 74 65 6e 74 73 20 6f 66 20 74 68 65 20 63 61 63  tents of the cac
77b0: 68 65 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74  he..*/.int sqlit
77c0: 65 33 50 63 61 63 68 65 43 6c 65 61 72 28 50 43  e3PcacheClear(PC
77d0: 61 63 68 65 20 2a 70 43 61 63 68 65 29 7b 0a 20  ache *pCache){. 
77e0: 20 61 73 73 65 72 74 28 70 43 61 63 68 65 2d 3e   assert(pCache->
77f0: 6e 52 65 66 3d 3d 30 29 3b 0a 20 20 70 63 61 63  nRef==0);.  pcac
7800: 68 65 45 6e 74 65 72 4d 75 74 65 78 28 29 3b 0a  heEnterMutex();.
7810: 20 20 70 63 61 63 68 65 43 6c 65 61 72 28 70 43    pcacheClear(pC
7820: 61 63 68 65 29 3b 0a 20 20 70 63 61 63 68 65 45  ache);.  pcacheE
7830: 78 69 74 4d 75 74 65 78 28 29 3b 0a 20 20 72 65  xitMutex();.  re
7840: 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a  turn SQLITE_OK;.
7850: 7d 0a 0a 2f 2a 0a 2a 2a 20 4d 65 72 67 65 20 74  }../*.** Merge t
7860: 77 6f 20 6c 69 73 74 73 20 6f 66 20 70 61 67 65  wo lists of page
7870: 73 20 63 6f 6e 6e 65 63 74 65 64 20 62 79 20 70  s connected by p
7880: 44 69 72 74 79 20 61 6e 64 20 69 6e 20 70 67 6e  Dirty and in pgn
7890: 6f 20 6f 72 64 65 72 2e 0a 2a 2a 20 44 6f 20 6e  o order..** Do n
78a0: 6f 74 20 62 6f 74 68 20 66 69 78 69 6e 67 20 74  ot both fixing t
78b0: 68 65 20 70 50 72 65 76 44 69 72 74 79 20 70 6f  he pPrevDirty po
78c0: 69 6e 74 65 72 73 2e 0a 2a 2f 0a 73 74 61 74 69  inters..*/.stati
78d0: 63 20 50 67 48 64 72 20 2a 70 63 61 63 68 65 4d  c PgHdr *pcacheM
78e0: 65 72 67 65 44 69 72 74 79 4c 69 73 74 28 50 67  ergeDirtyList(Pg
78f0: 48 64 72 20 2a 70 41 2c 20 50 67 48 64 72 20 2a  Hdr *pA, PgHdr *
7900: 70 42 29 7b 0a 20 20 50 67 48 64 72 20 72 65 73  pB){.  PgHdr res
7910: 75 6c 74 2c 20 2a 70 54 61 69 6c 3b 0a 20 20 70  ult, *pTail;.  p
7920: 54 61 69 6c 20 3d 20 26 72 65 73 75 6c 74 3b 0a  Tail = &result;.
7930: 20 20 77 68 69 6c 65 28 20 70 41 20 26 26 20 70    while( pA && p
7940: 42 20 29 7b 0a 20 20 20 20 69 66 28 20 70 41 2d  B ){.    if( pA-
7950: 3e 70 67 6e 6f 3c 70 42 2d 3e 70 67 6e 6f 20 29  >pgno<pB->pgno )
7960: 7b 0a 20 20 20 20 20 20 70 54 61 69 6c 2d 3e 70  {.      pTail->p
7970: 44 69 72 74 79 20 3d 20 70 41 3b 0a 20 20 20 20  Dirty = pA;.    
7980: 20 20 70 54 61 69 6c 20 3d 20 70 41 3b 0a 20 20    pTail = pA;.  
7990: 20 20 20 20 70 41 20 3d 20 70 41 2d 3e 70 44 69      pA = pA->pDi
79a0: 72 74 79 3b 0a 20 20 20 20 7d 65 6c 73 65 7b 0a  rty;.    }else{.
79b0: 20 20 20 20 20 20 70 54 61 69 6c 2d 3e 70 44 69        pTail->pDi
79c0: 72 74 79 20 3d 20 70 42 3b 0a 20 20 20 20 20 20  rty = pB;.      
79d0: 70 54 61 69 6c 20 3d 20 70 42 3b 0a 20 20 20 20  pTail = pB;.    
79e0: 20 20 70 42 20 3d 20 70 42 2d 3e 70 44 69 72 74    pB = pB->pDirt
79f0: 79 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a 20 20 69  y;.    }.  }.  i
7a00: 66 28 20 70 41 20 29 7b 0a 20 20 20 20 70 54 61  f( pA ){.    pTa
7a10: 69 6c 2d 3e 70 44 69 72 74 79 20 3d 20 70 41 3b  il->pDirty = pA;
7a20: 0a 20 20 7d 65 6c 73 65 20 69 66 28 20 70 42 20  .  }else if( pB 
7a30: 29 7b 0a 20 20 20 20 70 54 61 69 6c 2d 3e 70 44  ){.    pTail->pD
7a40: 69 72 74 79 20 3d 20 70 42 3b 0a 20 20 7d 65 6c  irty = pB;.  }el
7a50: 73 65 7b 0a 20 20 20 20 70 54 61 69 6c 2d 3e 70  se{.    pTail->p
7a60: 44 69 72 74 79 20 3d 20 30 3b 0a 20 20 7d 0a 20  Dirty = 0;.  }. 
7a70: 20 72 65 74 75 72 6e 20 72 65 73 75 6c 74 2e 70   return result.p
7a80: 44 69 72 74 79 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20  Dirty;.}../*.** 
7a90: 53 6f 72 74 20 74 68 65 20 6c 69 73 74 20 6f 66  Sort the list of
7aa0: 20 70 61 67 65 73 20 69 6e 20 61 63 63 65 6e 64   pages in accend
7ab0: 69 6e 67 20 6f 72 64 65 72 20 62 79 20 70 67 6e  ing order by pgn
7ac0: 6f 2e 20 20 50 61 67 65 73 20 61 72 65 0a 2a 2a  o.  Pages are.**
7ad0: 20 63 6f 6e 6e 65 63 74 65 64 20 62 79 20 70 44   connected by pD
7ae0: 69 72 74 79 20 70 6f 69 6e 74 65 72 73 2e 20 20  irty pointers.  
7af0: 54 68 65 20 70 50 72 65 76 44 69 72 74 79 20 70  The pPrevDirty p
7b00: 6f 69 6e 74 65 72 73 20 61 72 65 0a 2a 2a 20 63  ointers are.** c
7b10: 6f 72 72 75 70 74 65 64 20 62 79 20 74 68 69 73  orrupted by this
7b20: 20 73 6f 72 74 2e 0a 2a 2f 0a 23 64 65 66 69 6e   sort..*/.#defin
7b30: 65 20 4e 5f 53 4f 52 54 5f 42 55 43 4b 45 54 5f  e N_SORT_BUCKET_
7b40: 41 4c 4c 4f 43 20 32 35 0a 23 64 65 66 69 6e 65  ALLOC 25.#define
7b50: 20 4e 5f 53 4f 52 54 5f 42 55 43 4b 45 54 20 20   N_SORT_BUCKET  
7b60: 20 20 20 20 20 32 35 0a 23 69 66 64 65 66 20 53       25.#ifdef S
7b70: 51 4c 49 54 45 5f 54 45 53 54 0a 20 20 69 6e 74  QLITE_TEST.  int
7b80: 20 73 71 6c 69 74 65 33 5f 70 61 67 65 72 5f 6e   sqlite3_pager_n
7b90: 5f 73 6f 72 74 5f 62 75 63 6b 65 74 20 3d 20 30  _sort_bucket = 0
7ba0: 3b 0a 20 20 23 75 6e 64 65 66 20 4e 5f 53 4f 52  ;.  #undef N_SOR
7bb0: 54 5f 42 55 43 4b 45 54 0a 20 20 23 64 65 66 69  T_BUCKET.  #defi
7bc0: 6e 65 20 4e 5f 53 4f 52 54 5f 42 55 43 4b 45 54  ne N_SORT_BUCKET
7bd0: 20 5c 0a 20 20 20 28 73 71 6c 69 74 65 33 5f 70   \.   (sqlite3_p
7be0: 61 67 65 72 5f 6e 5f 73 6f 72 74 5f 62 75 63 6b  ager_n_sort_buck
7bf0: 65 74 3f 73 71 6c 69 74 65 33 5f 70 61 67 65 72  et?sqlite3_pager
7c00: 5f 6e 5f 73 6f 72 74 5f 62 75 63 6b 65 74 3a 4e  _n_sort_bucket:N
7c10: 5f 53 4f 52 54 5f 42 55 43 4b 45 54 5f 41 4c 4c  _SORT_BUCKET_ALL
7c20: 4f 43 29 0a 23 65 6e 64 69 66 0a 73 74 61 74 69  OC).#endif.stati
7c30: 63 20 50 67 48 64 72 20 2a 70 63 61 63 68 65 53  c PgHdr *pcacheS
7c40: 6f 72 74 44 69 72 74 79 4c 69 73 74 28 50 67 48  ortDirtyList(PgH
7c50: 64 72 20 2a 70 49 6e 29 7b 0a 20 20 50 67 48 64  dr *pIn){.  PgHd
7c60: 72 20 2a 61 5b 4e 5f 53 4f 52 54 5f 42 55 43 4b  r *a[N_SORT_BUCK
7c70: 45 54 5f 41 4c 4c 4f 43 5d 2c 20 2a 70 3b 0a 20  ET_ALLOC], *p;. 
7c80: 20 69 6e 74 20 69 3b 0a 20 20 6d 65 6d 73 65 74   int i;.  memset
7c90: 28 61 2c 20 30 2c 20 73 69 7a 65 6f 66 28 61 29  (a, 0, sizeof(a)
7ca0: 29 3b 0a 20 20 77 68 69 6c 65 28 20 70 49 6e 20  );.  while( pIn 
7cb0: 29 7b 0a 20 20 20 20 70 20 3d 20 70 49 6e 3b 0a  ){.    p = pIn;.
7cc0: 20 20 20 20 70 49 6e 20 3d 20 70 2d 3e 70 44 69      pIn = p->pDi
7cd0: 72 74 79 3b 0a 20 20 20 20 70 2d 3e 70 44 69 72  rty;.    p->pDir
7ce0: 74 79 20 3d 20 30 3b 0a 20 20 20 20 66 6f 72 28  ty = 0;.    for(
7cf0: 69 3d 30 3b 20 69 3c 4e 5f 53 4f 52 54 5f 42 55  i=0; i<N_SORT_BU
7d00: 43 4b 45 54 2d 31 3b 20 69 2b 2b 29 7b 0a 20 20  CKET-1; i++){.  
7d10: 20 20 20 20 69 66 28 20 61 5b 69 5d 3d 3d 30 20      if( a[i]==0 
7d20: 29 7b 0a 20 20 20 20 20 20 20 20 61 5b 69 5d 20  ){.        a[i] 
7d30: 3d 20 70 3b 0a 20 20 20 20 20 20 20 20 62 72 65  = p;.        bre
7d40: 61 6b 3b 0a 20 20 20 20 20 20 7d 65 6c 73 65 7b  ak;.      }else{
7d50: 0a 20 20 20 20 20 20 20 20 70 20 3d 20 70 63 61  .        p = pca
7d60: 63 68 65 4d 65 72 67 65 44 69 72 74 79 4c 69 73  cheMergeDirtyLis
7d70: 74 28 61 5b 69 5d 2c 20 70 29 3b 0a 20 20 20 20  t(a[i], p);.    
7d80: 20 20 20 20 61 5b 69 5d 20 3d 20 30 3b 0a 20 20      a[i] = 0;.  
7d90: 20 20 20 20 7d 0a 20 20 20 20 7d 0a 20 20 20 20      }.    }.    
7da0: 69 66 28 20 69 3d 3d 4e 5f 53 4f 52 54 5f 42 55  if( i==N_SORT_BU
7db0: 43 4b 45 54 2d 31 20 29 7b 0a 20 20 20 20 20 20  CKET-1 ){.      
7dc0: 2f 2a 20 43 6f 76 65 72 61 67 65 3a 20 54 6f 20  /* Coverage: To 
7dd0: 67 65 74 20 68 65 72 65 2c 20 74 68 65 72 65 20  get here, there 
7de0: 6e 65 65 64 20 74 6f 20 62 65 20 32 5e 28 4e 5f  need to be 2^(N_
7df0: 53 4f 52 54 5f 42 55 43 4b 45 54 29 20 0a 20 20  SORT_BUCKET) .  
7e00: 20 20 20 20 2a 2a 20 65 6c 65 6d 65 6e 74 73 20      ** elements 
7e10: 69 6e 20 74 68 65 20 69 6e 70 75 74 20 6c 69 73  in the input lis
7e20: 74 2e 20 54 68 69 73 20 69 73 20 70 6f 73 73 69  t. This is possi
7e30: 62 6c 65 2c 20 62 75 74 20 69 6d 70 72 61 63 74  ble, but impract
7e40: 69 63 61 6c 2e 0a 20 20 20 20 20 20 2a 2a 20 54  ical..      ** T
7e50: 65 73 74 69 6e 67 20 74 68 69 73 20 6c 69 6e 65  esting this line
7e60: 20 69 73 20 74 68 65 20 70 6f 69 6e 74 20 6f 66   is the point of
7e70: 20 67 6c 6f 62 61 6c 20 76 61 72 69 61 62 6c 65   global variable
7e80: 0a 20 20 20 20 20 20 2a 2a 20 73 71 6c 69 74 65  .      ** sqlite
7e90: 33 5f 70 61 67 65 72 5f 6e 5f 73 6f 72 74 5f 62  3_pager_n_sort_b
7ea0: 75 63 6b 65 74 2e 0a 20 20 20 20 20 20 2a 2f 0a  ucket..      */.
7eb0: 20 20 20 20 20 20 61 5b 69 5d 20 3d 20 70 63 61        a[i] = pca
7ec0: 63 68 65 4d 65 72 67 65 44 69 72 74 79 4c 69 73  cheMergeDirtyLis
7ed0: 74 28 61 5b 69 5d 2c 20 70 29 3b 0a 20 20 20 20  t(a[i], p);.    
7ee0: 7d 0a 20 20 7d 0a 20 20 70 20 3d 20 61 5b 30 5d  }.  }.  p = a[0]
7ef0: 3b 0a 20 20 66 6f 72 28 69 3d 31 3b 20 69 3c 4e  ;.  for(i=1; i<N
7f00: 5f 53 4f 52 54 5f 42 55 43 4b 45 54 3b 20 69 2b  _SORT_BUCKET; i+
7f10: 2b 29 7b 0a 20 20 20 20 70 20 3d 20 70 63 61 63  +){.    p = pcac
7f20: 68 65 4d 65 72 67 65 44 69 72 74 79 4c 69 73 74  heMergeDirtyList
7f30: 28 70 2c 20 61 5b 69 5d 29 3b 0a 20 20 7d 0a 20  (p, a[i]);.  }. 
7f40: 20 72 65 74 75 72 6e 20 70 3b 0a 7d 0a 0a 2f 2a   return p;.}../*
7f50: 0a 2a 2a 20 52 65 74 75 72 6e 20 61 20 6c 69 73  .** Return a lis
7f60: 74 20 6f 66 20 61 6c 6c 20 64 69 72 74 79 20 70  t of all dirty p
7f70: 61 67 65 73 20 69 6e 20 74 68 65 20 63 61 63 68  ages in the cach
7f80: 65 2c 20 73 6f 72 74 65 64 20 62 79 20 70 61 67  e, sorted by pag
7f90: 65 20 6e 75 6d 62 65 72 2e 0a 2a 2f 0a 50 67 48  e number..*/.PgH
7fa0: 64 72 20 2a 73 71 6c 69 74 65 33 50 63 61 63 68  dr *sqlite3Pcach
7fb0: 65 44 69 72 74 79 4c 69 73 74 28 50 43 61 63 68  eDirtyList(PCach
7fc0: 65 20 2a 70 43 61 63 68 65 29 7b 0a 20 20 50 67  e *pCache){.  Pg
7fd0: 48 64 72 20 2a 70 3b 0a 20 20 66 6f 72 28 70 3d  Hdr *p;.  for(p=
7fe0: 70 43 61 63 68 65 2d 3e 70 44 69 72 74 79 3b 20  pCache->pDirty; 
7ff0: 70 3b 20 70 3d 70 2d 3e 70 4e 65 78 74 29 7b 0a  p; p=p->pNext){.
8000: 20 20 20 20 70 2d 3e 70 44 69 72 74 79 20 3d 20      p->pDirty = 
8010: 70 2d 3e 70 4e 65 78 74 3b 0a 20 20 7d 0a 20 20  p->pNext;.  }.  
8020: 72 65 74 75 72 6e 20 70 63 61 63 68 65 53 6f 72  return pcacheSor
8030: 74 44 69 72 74 79 4c 69 73 74 28 70 43 61 63 68  tDirtyList(pCach
8040: 65 2d 3e 70 44 69 72 74 79 29 3b 0a 7d 0a 0a 2f  e->pDirty);.}../
8050: 2a 20 0a 2a 2a 20 52 65 74 75 72 6e 20 74 68 65  * .** Return the
8060: 20 74 6f 74 61 6c 20 6e 75 6d 62 65 72 20 6f 66   total number of
8070: 20 6f 75 74 73 74 61 6e 64 69 6e 67 20 70 61 67   outstanding pag
8080: 65 20 72 65 66 65 72 65 6e 63 65 73 2e 0a 2a 2f  e references..*/
8090: 0a 69 6e 74 20 73 71 6c 69 74 65 33 50 63 61 63  .int sqlite3Pcac
80a0: 68 65 52 65 66 43 6f 75 6e 74 28 50 43 61 63 68  heRefCount(PCach
80b0: 65 20 2a 70 43 61 63 68 65 29 7b 0a 20 20 72 65  e *pCache){.  re
80c0: 74 75 72 6e 20 70 43 61 63 68 65 2d 3e 6e 52 65  turn pCache->nRe
80d0: 66 3b 0a 7d 0a 0a 2f 2a 20 0a 2a 2a 20 52 65 74  f;.}../* .** Ret
80e0: 75 72 6e 20 74 68 65 20 74 6f 74 61 6c 20 6e 75  urn the total nu
80f0: 6d 62 65 72 20 6f 66 20 70 61 67 65 73 20 69 6e  mber of pages in
8100: 20 74 68 65 20 63 61 63 68 65 2e 0a 2a 2f 0a 69   the cache..*/.i
8110: 6e 74 20 73 71 6c 69 74 65 33 50 63 61 63 68 65  nt sqlite3Pcache
8120: 50 61 67 65 63 6f 75 6e 74 28 50 43 61 63 68 65  Pagecount(PCache
8130: 20 2a 70 43 61 63 68 65 29 7b 0a 20 20 61 73 73   *pCache){.  ass
8140: 65 72 74 28 20 70 43 61 63 68 65 2d 3e 6e 50 61  ert( pCache->nPa
8150: 67 65 3e 3d 30 20 29 3b 0a 20 20 72 65 74 75 72  ge>=0 );.  retur
8160: 6e 20 70 43 61 63 68 65 2d 3e 6e 50 61 67 65 3b  n pCache->nPage;
8170: 0a 7d 0a 0a 23 69 66 64 65 66 20 53 51 4c 49 54  .}..#ifdef SQLIT
8180: 45 5f 43 48 45 43 4b 5f 50 41 47 45 53 0a 2f 2a  E_CHECK_PAGES./*
8190: 0a 2a 2a 20 54 68 69 73 20 66 75 6e 63 74 69 6f  .** This functio
81a0: 6e 20 69 73 20 75 73 65 64 20 62 79 20 74 68 65  n is used by the
81b0: 20 70 61 67 65 72 2e 63 20 6d 6f 64 75 6c 65 20   pager.c module 
81c0: 74 6f 20 69 74 65 72 61 74 65 20 74 68 72 6f 75  to iterate throu
81d0: 67 68 20 61 6c 6c 20 0a 2a 2a 20 70 61 67 65 73  gh all .** pages
81e0: 20 69 6e 20 74 68 65 20 63 61 63 68 65 2e 20 41   in the cache. A
81f0: 74 20 70 72 65 73 65 6e 74 2c 20 74 68 69 73 20  t present, this 
8200: 69 73 20 6f 6e 6c 79 20 72 65 71 75 69 72 65 64  is only required
8210: 20 69 66 20 74 68 65 0a 2a 2a 20 53 51 4c 49 54   if the.** SQLIT
8220: 45 5f 43 48 45 43 4b 5f 50 41 47 45 53 20 6d 61  E_CHECK_PAGES ma
8230: 63 72 6f 20 28 75 73 65 64 20 66 6f 72 20 64 65  cro (used for de
8240: 62 75 67 67 69 6e 67 29 20 69 73 20 73 70 65 63  bugging) is spec
8250: 69 66 69 65 64 2e 0a 2a 2f 0a 76 6f 69 64 20 73  ified..*/.void s
8260: 71 6c 69 74 65 33 50 63 61 63 68 65 49 74 65 72  qlite3PcacheIter
8270: 61 74 65 28 50 43 61 63 68 65 20 2a 70 43 61 63  ate(PCache *pCac
8280: 68 65 2c 20 76 6f 69 64 20 28 2a 78 49 74 65 72  he, void (*xIter
8290: 29 28 50 67 48 64 72 20 2a 29 29 7b 0a 20 20 50  )(PgHdr *)){.  P
82a0: 67 48 64 72 20 2a 70 3b 0a 20 20 66 6f 72 28 70  gHdr *p;.  for(p
82b0: 3d 70 43 61 63 68 65 2d 3e 70 43 6c 65 61 6e 3b  =pCache->pClean;
82c0: 20 70 3b 20 70 3d 70 2d 3e 70 4e 65 78 74 29 7b   p; p=p->pNext){
82d0: 0a 20 20 20 20 78 49 74 65 72 28 70 29 3b 0a 20  .    xIter(p);. 
82e0: 20 7d 0a 20 20 66 6f 72 28 70 3d 70 43 61 63 68   }.  for(p=pCach
82f0: 65 2d 3e 70 44 69 72 74 79 3b 20 70 3b 20 70 3d  e->pDirty; p; p=
8300: 70 2d 3e 70 4e 65 78 74 29 7b 0a 20 20 20 20 78  p->pNext){.    x
8310: 49 74 65 72 28 70 29 3b 0a 20 20 7d 0a 7d 0a 23  Iter(p);.  }.}.#
8320: 65 6e 64 69 66 0a 0a 2f 2a 20 0a 2a 2a 20 53 65  endif../* .** Se
8330: 74 20 66 6c 61 67 73 20 6f 6e 20 61 6c 6c 20 70  t flags on all p
8340: 61 67 65 73 20 69 6e 20 74 68 65 20 70 61 67 65  ages in the page
8350: 20 63 61 63 68 65 20 0a 2a 2f 0a 76 6f 69 64 20   cache .*/.void 
8360: 73 71 6c 69 74 65 33 50 63 61 63 68 65 53 65 74  sqlite3PcacheSet
8370: 46 6c 61 67 73 28 50 43 61 63 68 65 20 2a 70 43  Flags(PCache *pC
8380: 61 63 68 65 2c 20 69 6e 74 20 61 6e 64 4d 61 73  ache, int andMas
8390: 6b 2c 20 69 6e 74 20 6f 72 4d 61 73 6b 29 7b 0a  k, int orMask){.
83a0: 20 20 50 67 48 64 72 20 2a 70 3b 0a 0a 20 20 61    PgHdr *p;..  a
83b0: 73 73 65 72 74 28 20 28 6f 72 4d 61 73 6b 26 50  ssert( (orMask&P
83c0: 47 48 44 52 5f 4e 45 45 44 5f 53 59 4e 43 29 3d  GHDR_NEED_SYNC)=
83d0: 3d 30 20 29 3b 0a 0a 20 20 2f 2a 20 4f 62 74 61  =0 );..  /* Obta
83e0: 69 6e 20 74 68 65 20 67 6c 6f 62 61 6c 20 6d 75  in the global mu
83f0: 74 65 78 20 62 65 66 6f 72 65 20 6d 6f 64 69 66  tex before modif
8400: 79 69 6e 67 20 61 6e 79 20 50 67 48 64 72 2e 66  ying any PgHdr.f
8410: 6c 61 67 73 20 76 61 72 69 61 62 6c 65 73 20 0a  lags variables .
8420: 20 20 2a 2a 20 6f 72 20 74 72 61 76 65 72 73 69    ** or traversi
8430: 6e 67 20 74 68 65 20 4c 52 55 20 6c 69 73 74 2e  ng the LRU list.
8440: 0a 20 20 2a 2f 20 0a 20 20 70 63 61 63 68 65 45  .  */ .  pcacheE
8450: 6e 74 65 72 4d 75 74 65 78 28 29 3b 0a 0a 20 20  nterMutex();..  
8460: 66 6f 72 28 70 3d 70 43 61 63 68 65 2d 3e 70 44  for(p=pCache->pD
8470: 69 72 74 79 3b 20 70 3b 20 70 3d 70 2d 3e 70 4e  irty; p; p=p->pN
8480: 65 78 74 29 7b 0a 20 20 20 20 70 2d 3e 66 6c 61  ext){.    p->fla
8490: 67 73 20 3d 20 28 70 2d 3e 66 6c 61 67 73 26 61  gs = (p->flags&a
84a0: 6e 64 4d 61 73 6b 29 7c 6f 72 4d 61 73 6b 3b 0a  ndMask)|orMask;.
84b0: 20 20 7d 0a 20 20 66 6f 72 28 70 3d 70 43 61 63    }.  for(p=pCac
84c0: 68 65 2d 3e 70 43 6c 65 61 6e 3b 20 70 3b 20 70  he->pClean; p; p
84d0: 3d 70 2d 3e 70 4e 65 78 74 29 7b 0a 20 20 20 20  =p->pNext){.    
84e0: 70 2d 3e 66 6c 61 67 73 20 3d 20 28 70 2d 3e 66  p->flags = (p->f
84f0: 6c 61 67 73 26 61 6e 64 4d 61 73 6b 29 7c 6f 72  lags&andMask)|or
8500: 4d 61 73 6b 3b 0a 20 20 7d 0a 0a 20 20 69 66 28  Mask;.  }..  if(
8510: 20 30 3d 3d 28 61 6e 64 4d 61 73 6b 26 50 47 48   0==(andMask&PGH
8520: 44 52 5f 4e 45 45 44 5f 53 59 4e 43 29 20 29 7b  DR_NEED_SYNC) ){
8530: 0a 20 20 20 20 70 43 61 63 68 65 2d 3e 70 53 79  .    pCache->pSy
8540: 6e 63 65 64 20 3d 20 70 43 61 63 68 65 2d 3e 70  nced = pCache->p
8550: 44 69 72 74 79 54 61 69 6c 3b 0a 20 20 20 20 61  DirtyTail;.    a
8560: 73 73 65 72 74 28 20 21 70 43 61 63 68 65 2d 3e  ssert( !pCache->
8570: 70 53 79 6e 63 65 64 20 7c 7c 20 28 70 43 61 63  pSynced || (pCac
8580: 68 65 2d 3e 70 53 79 6e 63 65 64 2d 3e 66 6c 61  he->pSynced->fla
8590: 67 73 26 50 47 48 44 52 5f 4e 45 45 44 5f 53 59  gs&PGHDR_NEED_SY
85a0: 4e 43 29 3d 3d 30 20 29 3b 0a 20 20 7d 0a 0a 20  NC)==0 );.  }.. 
85b0: 20 70 63 61 63 68 65 45 78 69 74 4d 75 74 65 78   pcacheExitMutex
85c0: 28 29 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 53 65 74  ();.}../*.** Set
85d0: 20 74 68 65 20 73 75 67 67 65 73 74 65 64 20 63   the suggested c
85e0: 61 63 68 65 2d 73 69 7a 65 20 76 61 6c 75 65 2e  ache-size value.
85f0: 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 50  .*/.int sqlite3P
8600: 63 61 63 68 65 47 65 74 43 61 63 68 65 73 69 7a  cacheGetCachesiz
8610: 65 28 50 43 61 63 68 65 20 2a 70 43 61 63 68 65  e(PCache *pCache
8620: 29 7b 0a 20 20 72 65 74 75 72 6e 20 70 43 61 63  ){.  return pCac
8630: 68 65 2d 3e 6e 4d 61 78 3b 0a 7d 0a 0a 2f 2a 0a  he->nMax;.}../*.
8640: 2a 2a 20 53 65 74 20 74 68 65 20 73 75 67 67 65  ** Set the sugge
8650: 73 74 65 64 20 63 61 63 68 65 2d 73 69 7a 65 20  sted cache-size 
8660: 76 61 6c 75 65 2e 0a 2a 2f 0a 76 6f 69 64 20 73  value..*/.void s
8670: 71 6c 69 74 65 33 50 63 61 63 68 65 53 65 74 43  qlite3PcacheSetC
8680: 61 63 68 65 73 69 7a 65 28 50 43 61 63 68 65 20  achesize(PCache 
8690: 2a 70 43 61 63 68 65 2c 20 69 6e 74 20 6d 78 50  *pCache, int mxP
86a0: 61 67 65 29 7b 0a 20 20 69 66 28 20 6d 78 50 61  age){.  if( mxPa
86b0: 67 65 3c 31 30 20 29 7b 0a 20 20 20 20 6d 78 50  ge<10 ){.    mxP
86c0: 61 67 65 20 3d 20 31 30 3b 0a 20 20 7d 0a 20 20  age = 10;.  }.  
86d0: 69 66 28 20 70 43 61 63 68 65 2d 3e 62 50 75 72  if( pCache->bPur
86e0: 67 65 61 62 6c 65 20 29 7b 0a 20 20 20 20 70 63  geable ){.    pc
86f0: 61 63 68 65 45 6e 74 65 72 4d 75 74 65 78 28 29  acheEnterMutex()
8700: 3b 0a 20 20 20 20 70 63 61 63 68 65 5f 67 2e 6e  ;.    pcache_g.n
8710: 4d 61 78 50 61 67 65 20 2d 3d 20 70 43 61 63 68  MaxPage -= pCach
8720: 65 2d 3e 6e 4d 61 78 3b 0a 20 20 20 20 70 63 61  e->nMax;.    pca
8730: 63 68 65 5f 67 2e 6e 4d 61 78 50 61 67 65 20 2b  che_g.nMaxPage +
8740: 3d 20 6d 78 50 61 67 65 3b 0a 20 20 20 20 70 63  = mxPage;.    pc
8750: 61 63 68 65 45 6e 66 6f 72 63 65 4d 61 78 50 61  acheEnforceMaxPa
8760: 67 65 28 29 3b 0a 20 20 20 20 70 63 61 63 68 65  ge();.    pcache
8770: 45 78 69 74 4d 75 74 65 78 28 29 3b 0a 20 20 7d  ExitMutex();.  }
8780: 0a 20 20 70 43 61 63 68 65 2d 3e 6e 4d 61 78 20  .  pCache->nMax 
8790: 3d 20 6d 78 50 61 67 65 3b 0a 7d 0a 0a 23 69 66  = mxPage;.}..#if
87a0: 64 65 66 20 53 51 4c 49 54 45 5f 45 4e 41 42 4c  def SQLITE_ENABL
87b0: 45 5f 4d 45 4d 4f 52 59 5f 4d 41 4e 41 47 45 4d  E_MEMORY_MANAGEM
87c0: 45 4e 54 0a 2f 2a 0a 2a 2a 20 54 68 69 73 20 66  ENT./*.** This f
87d0: 75 6e 63 74 69 6f 6e 20 69 73 20 63 61 6c 6c 65  unction is calle
87e0: 64 20 74 6f 20 66 72 65 65 20 73 75 70 65 72 66  d to free superf
87f0: 6c 75 6f 75 73 20 64 79 6e 61 6d 69 63 61 6c 6c  luous dynamicall
8800: 79 20 61 6c 6c 6f 63 61 74 65 64 20 6d 65 6d 6f  y allocated memo
8810: 72 79 0a 2a 2a 20 68 65 6c 64 20 62 79 20 74 68  ry.** held by th
8820: 65 20 70 61 67 65 72 20 73 79 73 74 65 6d 2e 20  e pager system. 
8830: 4d 65 6d 6f 72 79 20 69 6e 20 75 73 65 20 62 79  Memory in use by
8840: 20 61 6e 79 20 53 51 4c 69 74 65 20 70 61 67 65   any SQLite page
8850: 72 20 61 6c 6c 6f 63 61 74 65 64 0a 2a 2a 20 62  r allocated.** b
8860: 79 20 74 68 65 20 63 75 72 72 65 6e 74 20 74 68  y the current th
8870: 72 65 61 64 20 6d 61 79 20 62 65 20 73 71 6c 69  read may be sqli
8880: 74 65 33 5f 66 72 65 65 28 29 65 64 2e 0a 2a 2a  te3_free()ed..**
8890: 0a 2a 2a 20 6e 52 65 71 20 69 73 20 74 68 65 20  .** nReq is the 
88a0: 6e 75 6d 62 65 72 20 6f 66 20 62 79 74 65 73 20  number of bytes 
88b0: 6f 66 20 6d 65 6d 6f 72 79 20 72 65 71 75 69 72  of memory requir
88c0: 65 64 2e 20 4f 6e 63 65 20 74 68 69 73 20 6d 75  ed. Once this mu
88d0: 63 68 20 68 61 73 0a 2a 2a 20 62 65 65 6e 20 72  ch has.** been r
88e0: 65 6c 65 61 73 65 64 2c 20 74 68 65 20 66 75 6e  eleased, the fun
88f0: 63 74 69 6f 6e 20 72 65 74 75 72 6e 73 2e 20 54  ction returns. T
8900: 68 65 20 72 65 74 75 72 6e 20 76 61 6c 75 65 20  he return value 
8910: 69 73 20 74 68 65 20 74 6f 74 61 6c 20 6e 75 6d  is the total num
8920: 62 65 72 20 0a 2a 2a 20 6f 66 20 62 79 74 65 73  ber .** of bytes
8930: 20 6f 66 20 6d 65 6d 6f 72 79 20 72 65 6c 65 61   of memory relea
8940: 73 65 64 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69  sed..*/.int sqli
8950: 74 65 33 50 63 61 63 68 65 52 65 6c 65 61 73 65  te3PcacheRelease
8960: 4d 65 6d 6f 72 79 28 69 6e 74 20 6e 52 65 71 29  Memory(int nReq)
8970: 7b 0a 20 20 69 6e 74 20 6e 46 72 65 65 20 3d 20  {.  int nFree = 
8980: 30 3b 0a 20 20 69 66 28 20 70 63 61 63 68 65 5f  0;.  if( pcache_
8990: 67 2e 70 53 74 61 72 74 3d 3d 30 20 29 7b 0a 20  g.pStart==0 ){. 
89a0: 20 20 20 50 67 48 64 72 20 2a 70 3b 0a 20 20 20     PgHdr *p;.   
89b0: 20 70 63 61 63 68 65 45 6e 74 65 72 4d 75 74 65   pcacheEnterMute
89c0: 78 28 29 3b 0a 20 20 20 20 77 68 69 6c 65 28 20  x();.    while( 
89d0: 28 6e 52 65 71 3c 30 20 7c 7c 20 6e 46 72 65 65  (nReq<0 || nFree
89e0: 3c 6e 52 65 71 29 20 26 26 20 28 70 3d 70 63 61  <nReq) && (p=pca
89f0: 63 68 65 52 65 63 79 63 6c 65 50 61 67 65 28 29  cheRecyclePage()
8a00: 29 20 29 7b 0a 20 20 20 20 20 20 6e 46 72 65 65  ) ){.      nFree
8a10: 20 2b 3d 20 70 63 61 63 68 65 50 61 67 65 53 69   += pcachePageSi
8a20: 7a 65 28 70 29 3b 0a 20 20 20 20 20 20 70 63 61  ze(p);.      pca
8a30: 63 68 65 50 61 67 65 46 72 65 65 28 70 29 3b 0a  chePageFree(p);.
8a40: 20 20 20 20 7d 0a 20 20 20 20 70 63 61 63 68 65      }.    pcache
8a50: 45 78 69 74 4d 75 74 65 78 28 29 3b 0a 20 20 7d  ExitMutex();.  }
8a60: 0a 20 20 72 65 74 75 72 6e 20 6e 46 72 65 65 3b  .  return nFree;
8a70: 0a 7d 0a 23 65 6e 64 69 66 20 2f 2a 20 53 51 4c  .}.#endif /* SQL
8a80: 49 54 45 5f 45 4e 41 42 4c 45 5f 4d 45 4d 4f 52  ITE_ENABLE_MEMOR
8a90: 59 5f 4d 41 4e 41 47 45 4d 45 4e 54 20 2a 2f 0a  Y_MANAGEMENT */.
8aa0: 0a 23 69 66 64 65 66 20 53 51 4c 49 54 45 5f 54  .#ifdef SQLITE_T
8ab0: 45 53 54 0a 76 6f 69 64 20 73 71 6c 69 74 65 33  EST.void sqlite3
8ac0: 50 63 61 63 68 65 53 74 61 74 73 28 0a 20 20 69  PcacheStats(.  i
8ad0: 6e 74 20 2a 70 6e 43 75 72 72 65 6e 74 2c 0a 20  nt *pnCurrent,. 
8ae0: 20 69 6e 74 20 2a 70 6e 4d 61 78 2c 0a 20 20 69   int *pnMax,.  i
8af0: 6e 74 20 2a 70 6e 4d 69 6e 2c 0a 20 20 69 6e 74  nt *pnMin,.  int
8b00: 20 2a 70 6e 52 65 63 79 63 6c 61 62 6c 65 0a 29   *pnRecyclable.)
8b10: 7b 0a 20 20 50 67 48 64 72 20 2a 70 3b 0a 20 20  {.  PgHdr *p;.  
8b20: 69 6e 74 20 6e 52 65 63 79 63 6c 61 62 6c 65 20  int nRecyclable 
8b30: 3d 20 30 3b 0a 20 20 66 6f 72 28 70 3d 70 63 61  = 0;.  for(p=pca
8b40: 63 68 65 5f 67 2e 70 4c 72 75 48 65 61 64 3b 20  che_g.pLruHead; 
8b50: 70 3b 20 70 3d 70 2d 3e 70 4e 65 78 74 4c 72 75  p; p=p->pNextLru
8b60: 29 7b 0a 20 20 20 20 6e 52 65 63 79 63 6c 61 62  ){.    nRecyclab
8b70: 6c 65 2b 2b 3b 0a 20 20 7d 0a 0a 20 20 2a 70 6e  le++;.  }..  *pn
8b80: 43 75 72 72 65 6e 74 20 3d 20 70 63 61 63 68 65  Current = pcache
8b90: 5f 67 2e 6e 43 75 72 72 65 6e 74 50 61 67 65 3b  _g.nCurrentPage;
8ba0: 0a 20 20 2a 70 6e 4d 61 78 20 3d 20 70 63 61 63  .  *pnMax = pcac
8bb0: 68 65 5f 67 2e 6e 4d 61 78 50 61 67 65 3b 0a 20  he_g.nMaxPage;. 
8bc0: 20 2a 70 6e 4d 69 6e 20 3d 20 70 63 61 63 68 65   *pnMin = pcache
8bd0: 5f 67 2e 6e 4d 69 6e 50 61 67 65 3b 0a 20 20 2a  _g.nMinPage;.  *
8be0: 70 6e 52 65 63 79 63 6c 61 62 6c 65 20 3d 20 6e  pnRecyclable = n
8bf0: 52 65 63 79 63 6c 61 62 6c 65 3b 0a 7d 0a 23 65  Recyclable;.}.#e
8c00: 6e 64 69 66 0a                                   ndif.