/ Hex Artifact Content
Login

Artifact ff79cb5eb797d0f1a244b4332c2d39cb5cfd066b:


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 36 20 32 30 30  che.c,v 1.26 200
01c0: 38 2f 30 39 2f 30 32 20 30 39 3a 33 38 3a 30 37  8/09/02 09:38:07
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 73 7a 29 7b  3PageMalloc(sz){
38e0: 0a 20 20 76 6f 69 64 20 2a 70 3b 0a 20 20 70 63  .  void *p;.  pc
38f0: 61 63 68 65 45 6e 74 65 72 4d 75 74 65 78 28 29  acheEnterMutex()
3900: 3b 0a 20 20 70 20 3d 20 70 63 61 63 68 65 4d 61  ;.  p = pcacheMa
3910: 6c 6c 6f 63 28 73 7a 2c 20 30 29 3b 0a 20 20 70  lloc(sz, 0);.  p
3920: 63 61 63 68 65 45 78 69 74 4d 75 74 65 78 28 29  cacheExitMutex()
3930: 3b 0a 20 20 72 65 74 75 72 6e 20 70 3b 0a 7d 0a  ;.  return p;.}.
3940: 0a 2f 2a 0a 2a 2a 20 52 65 6c 65 61 73 65 20 61  ./*.** Release a
3950: 20 70 61 67 65 72 20 6d 65 6d 6f 72 79 20 61 6c   pager memory al
3960: 6c 6f 63 61 74 69 6f 6e 0a 2a 2f 0a 76 6f 69 64  location.*/.void
3970: 20 70 63 61 63 68 65 46 72 65 65 28 76 6f 69 64   pcacheFree(void
3980: 20 2a 70 29 7b 0a 20 20 61 73 73 65 72 74 28 20   *p){.  assert( 
3990: 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 68 65  sqlite3_mutex_he
39a0: 6c 64 28 70 63 61 63 68 65 5f 67 2e 6d 75 74 65  ld(pcache_g.mute
39b0: 78 29 20 29 3b 0a 20 20 69 66 28 20 70 3d 3d 30  x) );.  if( p==0
39c0: 20 29 20 72 65 74 75 72 6e 3b 0a 20 20 69 66 28   ) return;.  if(
39d0: 20 70 3e 3d 70 63 61 63 68 65 5f 67 2e 70 53 74   p>=pcache_g.pSt
39e0: 61 72 74 20 26 26 20 70 3c 70 63 61 63 68 65 5f  art && p<pcache_
39f0: 67 2e 70 45 6e 64 20 29 7b 0a 20 20 20 20 50 67  g.pEnd ){.    Pg
3a00: 46 72 65 65 73 6c 6f 74 20 2a 70 53 6c 6f 74 3b  Freeslot *pSlot;
3a10: 0a 20 20 20 20 73 71 6c 69 74 65 33 53 74 61 74  .    sqlite3Stat
3a20: 75 73 41 64 64 28 53 51 4c 49 54 45 5f 53 54 41  usAdd(SQLITE_STA
3a30: 54 55 53 5f 50 41 47 45 43 41 43 48 45 5f 55 53  TUS_PAGECACHE_US
3a40: 45 44 2c 20 2d 31 29 3b 0a 20 20 20 20 70 53 6c  ED, -1);.    pSl
3a50: 6f 74 20 3d 20 28 50 67 46 72 65 65 73 6c 6f 74  ot = (PgFreeslot
3a60: 2a 29 70 3b 0a 20 20 20 20 70 53 6c 6f 74 2d 3e  *)p;.    pSlot->
3a70: 70 4e 65 78 74 20 3d 20 70 63 61 63 68 65 5f 67  pNext = pcache_g
3a80: 2e 70 46 72 65 65 3b 0a 20 20 20 20 70 63 61 63  .pFree;.    pcac
3a90: 68 65 5f 67 2e 70 46 72 65 65 20 3d 20 70 53 6c  he_g.pFree = pSl
3aa0: 6f 74 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 20  ot;.  }else{.   
3ab0: 20 69 6e 74 20 69 53 69 7a 65 20 3d 20 73 71 6c   int iSize = sql
3ac0: 69 74 65 33 4d 61 6c 6c 6f 63 53 69 7a 65 28 70  ite3MallocSize(p
3ad0: 29 3b 0a 20 20 20 20 73 71 6c 69 74 65 33 53 74  );.    sqlite3St
3ae0: 61 74 75 73 41 64 64 28 53 51 4c 49 54 45 5f 53  atusAdd(SQLITE_S
3af0: 54 41 54 55 53 5f 50 41 47 45 43 41 43 48 45 5f  TATUS_PAGECACHE_
3b00: 4f 56 45 52 46 4c 4f 57 2c 20 2d 69 53 69 7a 65  OVERFLOW, -iSize
3b10: 29 3b 0a 20 20 20 20 73 71 6c 69 74 65 33 5f 66  );.    sqlite3_f
3b20: 72 65 65 28 70 29 3b 0a 20 20 7d 0a 7d 0a 76 6f  ree(p);.  }.}.vo
3b30: 69 64 20 73 71 6c 69 74 65 33 50 61 67 65 46 72  id sqlite3PageFr
3b40: 65 65 28 76 6f 69 64 20 2a 70 29 7b 0a 20 20 70  ee(void *p){.  p
3b50: 63 61 63 68 65 45 6e 74 65 72 4d 75 74 65 78 28  cacheEnterMutex(
3b60: 29 3b 0a 20 20 70 63 61 63 68 65 46 72 65 65 28  );.  pcacheFree(
3b70: 70 29 3b 0a 20 20 70 63 61 63 68 65 45 78 69 74  p);.  pcacheExit
3b80: 4d 75 74 65 78 28 29 3b 0a 7d 0a 0a 2f 2a 0a 2a  Mutex();.}../*.*
3b90: 2a 20 41 6c 6c 6f 63 61 74 65 20 61 20 6e 65 77  * Allocate a new
3ba0: 20 70 61 67 65 2e 0a 2a 2f 0a 73 74 61 74 69 63   page..*/.static
3bb0: 20 50 67 48 64 72 20 2a 70 63 61 63 68 65 50 61   PgHdr *pcachePa
3bc0: 67 65 41 6c 6c 6f 63 28 50 43 61 63 68 65 20 2a  geAlloc(PCache *
3bd0: 70 43 61 63 68 65 29 7b 0a 20 20 50 67 48 64 72  pCache){.  PgHdr
3be0: 20 2a 70 3b 0a 20 20 69 6e 74 20 73 7a 20 3d 20   *p;.  int sz = 
3bf0: 73 69 7a 65 6f 66 28 2a 70 29 20 2b 20 70 43 61  sizeof(*p) + pCa
3c00: 63 68 65 2d 3e 73 7a 50 61 67 65 20 2b 20 70 43  che->szPage + pC
3c10: 61 63 68 65 2d 3e 73 7a 45 78 74 72 61 3b 0a 20  ache->szExtra;. 
3c20: 20 61 73 73 65 72 74 28 20 73 71 6c 69 74 65 33   assert( sqlite3
3c30: 5f 6d 75 74 65 78 5f 68 65 6c 64 28 70 63 61 63  _mutex_held(pcac
3c40: 68 65 5f 67 2e 6d 75 74 65 78 29 20 29 3b 0a 20  he_g.mutex) );. 
3c50: 20 70 20 3d 20 70 63 61 63 68 65 4d 61 6c 6c 6f   p = pcacheMallo
3c60: 63 28 73 7a 2c 20 70 43 61 63 68 65 29 3b 0a 20  c(sz, pCache);. 
3c70: 20 69 66 28 20 70 3d 3d 30 20 29 20 72 65 74 75   if( p==0 ) retu
3c80: 72 6e 20 30 3b 0a 20 20 6d 65 6d 73 65 74 28 70  rn 0;.  memset(p
3c90: 2c 20 30 2c 20 73 69 7a 65 6f 66 28 50 67 48 64  , 0, sizeof(PgHd
3ca0: 72 29 29 3b 0a 20 20 70 2d 3e 70 44 61 74 61 20  r));.  p->pData 
3cb0: 3d 20 28 76 6f 69 64 2a 29 26 70 5b 31 5d 3b 0a  = (void*)&p[1];.
3cc0: 20 20 70 2d 3e 70 45 78 74 72 61 20 3d 20 28 76    p->pExtra = (v
3cd0: 6f 69 64 2a 29 26 28 28 63 68 61 72 2a 29 70 2d  oid*)&((char*)p-
3ce0: 3e 70 44 61 74 61 29 5b 70 43 61 63 68 65 2d 3e  >pData)[pCache->
3cf0: 73 7a 50 61 67 65 5d 3b 0a 20 20 69 66 28 20 70  szPage];.  if( p
3d00: 43 61 63 68 65 2d 3e 62 50 75 72 67 65 61 62 6c  Cache->bPurgeabl
3d10: 65 20 29 7b 0a 20 20 20 20 70 63 61 63 68 65 5f  e ){.    pcache_
3d20: 67 2e 6e 43 75 72 72 65 6e 74 50 61 67 65 2b 2b  g.nCurrentPage++
3d30: 3b 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e 20 70  ;.  }.  return p
3d40: 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 44 65 61 6c 6c  ;.}../*.** Deall
3d50: 6f 63 61 74 65 20 61 20 70 61 67 65 0a 2a 2f 0a  ocate a page.*/.
3d60: 73 74 61 74 69 63 20 76 6f 69 64 20 70 63 61 63  static void pcac
3d70: 68 65 50 61 67 65 46 72 65 65 28 50 67 48 64 72  hePageFree(PgHdr
3d80: 20 2a 70 29 7b 0a 20 20 61 73 73 65 72 74 28 20   *p){.  assert( 
3d90: 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 68 65  sqlite3_mutex_he
3da0: 6c 64 28 70 63 61 63 68 65 5f 67 2e 6d 75 74 65  ld(pcache_g.mute
3db0: 78 29 20 29 3b 0a 20 20 69 66 28 20 70 2d 3e 70  x) );.  if( p->p
3dc0: 43 61 63 68 65 2d 3e 62 50 75 72 67 65 61 62 6c  Cache->bPurgeabl
3dd0: 65 20 29 7b 0a 20 20 20 20 70 63 61 63 68 65 5f  e ){.    pcache_
3de0: 67 2e 6e 43 75 72 72 65 6e 74 50 61 67 65 2d 2d  g.nCurrentPage--
3df0: 3b 0a 20 20 7d 0a 20 20 70 63 61 63 68 65 46 72  ;.  }.  pcacheFr
3e00: 65 65 28 70 2d 3e 61 70 53 61 76 65 5b 30 5d 29  ee(p->apSave[0])
3e10: 3b 0a 20 20 70 63 61 63 68 65 46 72 65 65 28 70  ;.  pcacheFree(p
3e20: 2d 3e 61 70 53 61 76 65 5b 31 5d 29 3b 0a 20 20  ->apSave[1]);.  
3e30: 70 63 61 63 68 65 46 72 65 65 28 70 29 3b 0a 7d  pcacheFree(p);.}
3e40: 0a 0a 23 69 66 64 65 66 20 53 51 4c 49 54 45 5f  ..#ifdef SQLITE_
3e50: 45 4e 41 42 4c 45 5f 4d 45 4d 4f 52 59 5f 4d 41  ENABLE_MEMORY_MA
3e60: 4e 41 47 45 4d 45 4e 54 0a 2f 2a 0a 2a 2a 20 52  NAGEMENT./*.** R
3e70: 65 74 75 72 6e 20 74 68 65 20 6e 75 6d 62 65 72  eturn the number
3e80: 20 6f 66 20 62 79 74 65 73 20 74 68 61 74 20 77   of bytes that w
3e90: 69 6c 6c 20 62 65 20 72 65 74 75 72 6e 65 64 20  ill be returned 
3ea0: 74 6f 20 74 68 65 20 68 65 61 70 20 77 68 65 6e  to the heap when
3eb0: 0a 2a 2a 20 74 68 65 20 61 72 67 75 6d 65 6e 74  .** the argument
3ec0: 20 69 73 20 70 61 73 73 65 64 20 74 6f 20 70 63   is passed to pc
3ed0: 61 63 68 65 50 61 67 65 46 72 65 65 28 29 2e 0a  achePageFree()..
3ee0: 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74 20 70 63  */.static int pc
3ef0: 61 63 68 65 50 61 67 65 53 69 7a 65 28 50 67 48  achePageSize(PgH
3f00: 64 72 20 2a 70 29 7b 0a 20 20 61 73 73 65 72 74  dr *p){.  assert
3f10: 28 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f  ( sqlite3_mutex_
3f20: 68 65 6c 64 28 70 63 61 63 68 65 5f 67 2e 6d 75  held(pcache_g.mu
3f30: 74 65 78 29 20 29 3b 0a 20 20 61 73 73 65 72 74  tex) );.  assert
3f40: 28 20 21 70 63 61 63 68 65 5f 67 2e 70 53 74 61  ( !pcache_g.pSta
3f50: 72 74 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20  rt );.  assert( 
3f60: 70 2d 3e 61 70 53 61 76 65 5b 30 5d 3d 3d 30 20  p->apSave[0]==0 
3f70: 29 3b 0a 20 20 61 73 73 65 72 74 28 20 70 2d 3e  );.  assert( p->
3f80: 61 70 53 61 76 65 5b 31 5d 3d 3d 30 20 29 3b 0a  apSave[1]==0 );.
3f90: 20 20 61 73 73 65 72 74 28 20 70 20 26 26 20 70    assert( p && p
3fa0: 2d 3e 70 43 61 63 68 65 20 29 3b 0a 20 20 72 65  ->pCache );.  re
3fb0: 74 75 72 6e 20 73 71 6c 69 74 65 33 4d 61 6c 6c  turn sqlite3Mall
3fc0: 6f 63 53 69 7a 65 28 70 29 3b 0a 7d 0a 23 65 6e  ocSize(p);.}.#en
3fd0: 64 69 66 0a 0a 2f 2a 0a 2a 2a 20 41 74 74 65 6d  dif../*.** Attem
3fe0: 70 74 20 74 6f 20 27 72 65 63 79 63 6c 65 27 20  pt to 'recycle' 
3ff0: 61 20 70 61 67 65 20 66 72 6f 6d 20 74 68 65 20  a page from the 
4000: 67 6c 6f 62 61 6c 20 4c 52 55 20 6c 69 73 74 2e  global LRU list.
4010: 20 4f 6e 6c 79 20 63 6c 65 61 6e 2c 0a 2a 2a 20   Only clean,.** 
4020: 75 6e 72 65 66 65 72 65 6e 63 65 64 20 70 61 67  unreferenced pag
4030: 65 73 20 66 72 6f 6d 20 70 75 72 67 65 61 62 6c  es from purgeabl
4040: 65 20 63 61 63 68 65 73 20 61 72 65 20 65 6c 69  e caches are eli
4050: 67 69 62 6c 65 20 66 6f 72 20 72 65 63 79 63 6c  gible for recycl
4060: 69 6e 67 2e 0a 2a 2a 0a 2a 2a 20 54 68 69 73 20  ing..**.** This 
4070: 66 75 6e 63 74 69 6f 6e 20 72 65 6d 6f 76 65 73  function removes
4080: 20 70 61 67 65 20 70 63 61 63 68 65 2e 70 4c 72   page pcache.pLr
4090: 75 54 61 69 6c 20 66 72 6f 6d 20 74 68 65 20 67  uTail from the g
40a0: 6c 6f 62 61 6c 20 4c 52 55 20 6c 69 73 74 2c 0a  lobal LRU list,.
40b0: 2a 2a 20 61 6e 64 20 66 72 6f 6d 20 74 68 65 20  ** and from the 
40c0: 68 61 73 68 2d 74 61 62 6c 65 20 61 6e 64 20 50  hash-table and P
40d0: 43 61 63 68 65 2e 70 43 6c 65 61 6e 20 6c 69 73  Cache.pClean lis
40e0: 74 20 6f 66 20 74 68 65 20 6f 77 6e 65 72 20 70  t of the owner p
40f0: 63 61 63 68 65 2e 0a 2a 2a 20 54 68 65 72 65 20  cache..** There 
4100: 73 68 6f 75 6c 64 20 62 65 20 6e 6f 20 6f 74 68  should be no oth
4110: 65 72 20 72 65 66 65 72 65 6e 63 65 73 20 74 6f  er references to
4120: 20 74 68 65 20 70 61 67 65 2e 0a 2a 2a 0a 2a 2a   the page..**.**
4130: 20 41 20 70 6f 69 6e 74 65 72 20 74 6f 20 74 68   A pointer to th
4140: 65 20 72 65 63 79 63 6c 65 64 20 70 61 67 65 20  e recycled page 
4150: 69 73 20 72 65 74 75 72 6e 65 64 2c 20 6f 72 20  is returned, or 
4160: 4e 55 4c 4c 20 69 66 20 6e 6f 20 70 61 67 65 20  NULL if no page 
4170: 69 73 0a 2a 2a 20 65 6c 69 67 69 62 6c 65 20 66  is.** eligible f
4180: 6f 72 20 72 65 63 79 63 6c 69 6e 67 2e 0a 2a 2f  or recycling..*/
4190: 0a 73 74 61 74 69 63 20 50 67 48 64 72 20 2a 70  .static PgHdr *p
41a0: 63 61 63 68 65 52 65 63 79 63 6c 65 50 61 67 65  cacheRecyclePage
41b0: 28 29 7b 0a 20 20 50 67 48 64 72 20 2a 70 20 3d  (){.  PgHdr *p =
41c0: 20 30 3b 0a 20 20 61 73 73 65 72 74 28 20 73 71   0;.  assert( sq
41d0: 6c 69 74 65 33 5f 6d 75 74 65 78 5f 68 65 6c 64  lite3_mutex_held
41e0: 28 70 63 61 63 68 65 5f 67 2e 6d 75 74 65 78 29  (pcache_g.mutex)
41f0: 20 29 3b 0a 0a 20 20 69 66 28 20 28 70 3d 70 63   );..  if( (p=pc
4200: 61 63 68 65 5f 67 2e 70 4c 72 75 54 61 69 6c 29  ache_g.pLruTail)
4210: 20 29 7b 0a 20 20 20 20 61 73 73 65 72 74 28 20   ){.    assert( 
4220: 28 70 2d 3e 66 6c 61 67 73 26 50 47 48 44 52 5f  (p->flags&PGHDR_
4230: 44 49 52 54 59 29 3d 3d 30 20 29 3b 0a 20 20 20  DIRTY)==0 );.   
4240: 20 70 63 61 63 68 65 52 65 6d 6f 76 65 46 72 6f   pcacheRemoveFro
4250: 6d 4c 72 75 4c 69 73 74 28 70 29 3b 0a 20 20 20  mLruList(p);.   
4260: 20 70 63 61 63 68 65 52 65 6d 6f 76 65 46 72 6f   pcacheRemoveFro
4270: 6d 48 61 73 68 28 70 29 3b 0a 20 20 20 20 70 63  mHash(p);.    pc
4280: 61 63 68 65 52 65 6d 6f 76 65 46 72 6f 6d 4c 69  acheRemoveFromLi
4290: 73 74 28 26 70 2d 3e 70 43 61 63 68 65 2d 3e 70  st(&p->pCache->p
42a0: 43 6c 65 61 6e 2c 20 70 29 3b 0a 20 20 7d 0a 0a  Clean, p);.  }..
42b0: 20 20 72 65 74 75 72 6e 20 70 3b 0a 7d 0a 0a 2f    return p;.}../
42c0: 2a 0a 2a 2a 20 4f 62 74 61 69 6e 20 73 70 61 63  *.** Obtain spac
42d0: 65 20 66 6f 72 20 61 20 70 61 67 65 2e 20 54 72  e for a page. Tr
42e0: 79 20 74 6f 20 72 65 63 79 63 6c 65 20 61 6e 20  y to recycle an 
42f0: 6f 6c 64 20 70 61 67 65 20 69 66 20 74 68 65 20  old page if the 
4300: 6c 69 6d 69 74 20 6f 6e 20 74 68 65 20 0a 2a 2a  limit on the .**
4310: 20 6e 75 6d 62 65 72 20 6f 66 20 70 61 67 65 73   number of pages
4320: 20 68 61 73 20 62 65 65 6e 20 72 65 61 63 68 65   has been reache
4330: 64 2e 20 49 66 20 74 68 65 20 6c 69 6d 69 74 20  d. If the limit 
4340: 68 61 73 20 6e 6f 74 20 62 65 65 6e 20 72 65 61  has not been rea
4350: 63 68 65 64 20 6f 72 0a 2a 2a 20 74 68 65 72 65  ched or.** there
4360: 20 61 72 65 20 6e 6f 20 70 61 67 65 73 20 65 6c   are no pages el
4370: 69 67 69 62 6c 65 20 66 6f 72 20 72 65 63 79 63  igible for recyc
4380: 6c 69 6e 67 2c 20 61 6c 6c 6f 63 61 74 65 20 61  ling, allocate a
4390: 20 6e 65 77 20 70 61 67 65 2e 0a 2a 2a 0a 2a 2a   new page..**.**
43a0: 20 52 65 74 75 72 6e 20 61 20 70 6f 69 6e 74 65   Return a pointe
43b0: 72 20 74 6f 20 74 68 65 20 6e 65 77 20 70 61 67  r to the new pag
43c0: 65 2c 20 6f 72 20 4e 55 4c 4c 20 69 66 20 61 6e  e, or NULL if an
43d0: 20 4f 4f 4d 20 63 6f 6e 64 69 74 69 6f 6e 20 6f   OOM condition o
43e0: 63 63 75 72 73 2e 0a 2a 2f 0a 73 74 61 74 69 63  ccurs..*/.static
43f0: 20 69 6e 74 20 70 63 61 63 68 65 52 65 63 79 63   int pcacheRecyc
4400: 6c 65 4f 72 41 6c 6c 6f 63 28 50 43 61 63 68 65  leOrAlloc(PCache
4410: 20 2a 70 43 61 63 68 65 2c 20 50 67 48 64 72 20   *pCache, PgHdr 
4420: 2a 2a 70 70 50 61 67 65 29 7b 0a 20 20 50 67 48  **ppPage){.  PgH
4430: 64 72 20 2a 70 20 3d 20 30 3b 0a 0a 20 20 69 6e  dr *p = 0;..  in
4440: 74 20 73 7a 50 61 67 65 20 3d 20 70 43 61 63 68  t szPage = pCach
4450: 65 2d 3e 73 7a 50 61 67 65 3b 0a 20 20 69 6e 74  e->szPage;.  int
4460: 20 73 7a 45 78 74 72 61 20 3d 20 70 43 61 63 68   szExtra = pCach
4470: 65 2d 3e 73 7a 45 78 74 72 61 3b 0a 0a 20 20 61  e->szExtra;..  a
4480: 73 73 65 72 74 28 20 70 63 61 63 68 65 5f 67 2e  ssert( pcache_g.
4490: 69 73 49 6e 69 74 20 29 3b 0a 20 20 61 73 73 65  isInit );.  asse
44a0: 72 74 28 20 73 71 6c 69 74 65 33 5f 6d 75 74 65  rt( sqlite3_mute
44b0: 78 5f 68 65 6c 64 28 70 63 61 63 68 65 5f 67 2e  x_held(pcache_g.
44c0: 6d 75 74 65 78 29 20 29 3b 0a 0a 20 20 2a 70 70  mutex) );..  *pp
44d0: 50 61 67 65 20 3d 20 30 3b 0a 0a 20 20 2f 2a 20  Page = 0;..  /* 
44e0: 49 66 20 77 65 20 68 61 76 65 20 72 65 61 63 68  If we have reach
44f0: 65 64 20 74 68 65 20 6c 69 6d 69 74 20 66 6f 72  ed the limit for
4500: 20 70 69 6e 6e 65 64 2f 64 69 72 74 79 20 70 61   pinned/dirty pa
4510: 67 65 73 2c 20 61 6e 64 20 74 68 65 72 65 20 69  ges, and there i
4520: 73 20 61 74 0a 20 20 2a 2a 20 6c 65 61 73 74 20  s at.  ** least 
4530: 6f 6e 65 20 64 69 72 74 79 20 70 61 67 65 2c 20  one dirty page, 
4540: 69 6e 76 6f 6b 65 20 74 68 65 20 78 53 74 72 65  invoke the xStre
4550: 73 73 20 63 61 6c 6c 62 61 63 6b 20 74 6f 20 63  ss callback to c
4560: 61 75 73 65 20 61 20 70 61 67 65 20 74 6f 0a 20  ause a page to. 
4570: 20 2a 2a 20 62 65 63 6f 6d 65 20 63 6c 65 61 6e   ** become clean
4580: 2e 0a 20 20 2a 2f 0a 20 20 65 78 70 65 6e 73 69  ..  */.  expensi
4590: 76 65 5f 61 73 73 65 72 74 28 20 70 43 61 63 68  ve_assert( pCach
45a0: 65 2d 3e 6e 50 69 6e 6e 65 64 3d 3d 70 63 61 63  e->nPinned==pcac
45b0: 68 65 50 69 6e 6e 65 64 43 6f 75 6e 74 28 70 43  hePinnedCount(pC
45c0: 61 63 68 65 29 20 29 3b 0a 20 20 65 78 70 65 6e  ache) );.  expen
45d0: 73 69 76 65 5f 61 73 73 65 72 74 28 20 70 63 61  sive_assert( pca
45e0: 63 68 65 43 68 65 63 6b 53 79 6e 63 65 64 28 70  cheCheckSynced(p
45f0: 43 61 63 68 65 29 20 29 3b 0a 20 20 69 66 28 20  Cache) );.  if( 
4600: 70 43 61 63 68 65 2d 3e 78 53 74 72 65 73 73 0a  pCache->xStress.
4610: 20 20 20 26 26 20 70 43 61 63 68 65 2d 3e 70 44     && pCache->pD
4620: 69 72 74 79 0a 20 20 20 26 26 20 70 43 61 63 68  irty.   && pCach
4630: 65 2d 3e 6e 50 69 6e 6e 65 64 3e 3d 28 70 63 61  e->nPinned>=(pca
4640: 63 68 65 5f 67 2e 6e 4d 61 78 50 61 67 65 2b 70  che_g.nMaxPage+p
4650: 43 61 63 68 65 2d 3e 6e 4d 69 6e 2d 70 63 61 63  Cache->nMin-pcac
4660: 68 65 5f 67 2e 6e 4d 69 6e 50 61 67 65 29 0a 20  he_g.nMinPage). 
4670: 20 29 7b 0a 20 20 20 20 50 67 48 64 72 20 2a 70   ){.    PgHdr *p
4680: 50 67 3b 0a 20 20 20 20 61 73 73 65 72 74 28 70  Pg;.    assert(p
4690: 43 61 63 68 65 2d 3e 70 44 69 72 74 79 54 61 69  Cache->pDirtyTai
46a0: 6c 29 3b 0a 0a 20 20 20 20 66 6f 72 28 70 50 67  l);..    for(pPg
46b0: 3d 70 43 61 63 68 65 2d 3e 70 53 79 6e 63 65 64  =pCache->pSynced
46c0: 3b 20 0a 20 20 20 20 20 20 20 20 70 50 67 20 26  ; .        pPg &
46d0: 26 20 28 70 50 67 2d 3e 6e 52 65 66 20 7c 7c 20  & (pPg->nRef || 
46e0: 28 70 50 67 2d 3e 66 6c 61 67 73 26 50 47 48 44  (pPg->flags&PGHD
46f0: 52 5f 4e 45 45 44 5f 53 59 4e 43 29 29 3b 20 0a  R_NEED_SYNC)); .
4700: 20 20 20 20 20 20 20 20 70 50 67 3d 70 50 67 2d          pPg=pPg-
4710: 3e 70 50 72 65 76 0a 20 20 20 20 29 3b 0a 20 20  >pPrev.    );.  
4720: 20 20 69 66 28 20 21 70 50 67 20 29 7b 0a 20 20    if( !pPg ){.  
4730: 20 20 20 20 66 6f 72 28 70 50 67 3d 70 43 61 63      for(pPg=pCac
4740: 68 65 2d 3e 70 44 69 72 74 79 54 61 69 6c 3b 20  he->pDirtyTail; 
4750: 70 50 67 20 26 26 20 70 50 67 2d 3e 6e 52 65 66  pPg && pPg->nRef
4760: 3b 20 70 50 67 3d 70 50 67 2d 3e 70 50 72 65 76  ; pPg=pPg->pPrev
4770: 29 3b 0a 20 20 20 20 7d 0a 20 20 20 20 69 66 28  );.    }.    if(
4780: 20 70 50 67 20 29 7b 0a 20 20 20 20 20 20 69 6e   pPg ){.      in
4790: 74 20 72 63 3b 0a 20 20 20 20 20 20 70 63 61 63  t rc;.      pcac
47a0: 68 65 45 78 69 74 4d 75 74 65 78 28 29 3b 0a 20  heExitMutex();. 
47b0: 20 20 20 20 20 72 63 20 3d 20 70 43 61 63 68 65       rc = pCache
47c0: 2d 3e 78 53 74 72 65 73 73 28 70 43 61 63 68 65  ->xStress(pCache
47d0: 2d 3e 70 53 74 72 65 73 73 2c 20 70 50 67 29 3b  ->pStress, pPg);
47e0: 0a 20 20 20 20 20 20 70 63 61 63 68 65 45 6e 74  .      pcacheEnt
47f0: 65 72 4d 75 74 65 78 28 29 3b 0a 20 20 20 20 20  erMutex();.     
4800: 20 69 66 28 20 72 63 21 3d 53 51 4c 49 54 45 5f   if( rc!=SQLITE_
4810: 4f 4b 20 26 26 20 72 63 21 3d 53 51 4c 49 54 45  OK && rc!=SQLITE
4820: 5f 42 55 53 59 20 29 7b 0a 20 20 20 20 20 20 20  _BUSY ){.       
4830: 20 72 65 74 75 72 6e 20 72 63 3b 0a 20 20 20 20   return rc;.    
4840: 20 20 7d 0a 20 20 20 20 7d 0a 20 20 7d 0a 0a 20    }.    }.  }.. 
4850: 20 2f 2a 20 49 66 20 74 68 65 20 67 6c 6f 62 61   /* If the globa
4860: 6c 20 70 61 67 65 20 6c 69 6d 69 74 20 68 61 73  l page limit has
4870: 20 62 65 65 6e 20 72 65 61 63 68 65 64 2c 20 74   been reached, t
4880: 72 79 20 74 6f 20 72 65 63 79 63 6c 65 20 61 20  ry to recycle a 
4890: 70 61 67 65 2e 20 2a 2f 0a 20 20 69 66 28 20 70  page. */.  if( p
48a0: 43 61 63 68 65 2d 3e 62 50 75 72 67 65 61 62 6c  Cache->bPurgeabl
48b0: 65 20 26 26 20 70 63 61 63 68 65 5f 67 2e 6e 43  e && pcache_g.nC
48c0: 75 72 72 65 6e 74 50 61 67 65 3e 3d 70 63 61 63  urrentPage>=pcac
48d0: 68 65 5f 67 2e 6e 4d 61 78 50 61 67 65 20 29 7b  he_g.nMaxPage ){
48e0: 0a 20 20 20 20 70 20 3d 20 70 63 61 63 68 65 52  .    p = pcacheR
48f0: 65 63 79 63 6c 65 50 61 67 65 28 29 3b 0a 20 20  ecyclePage();.  
4900: 7d 0a 0a 20 20 2f 2a 20 49 66 20 61 20 70 61 67  }..  /* If a pag
4910: 65 20 68 61 73 20 62 65 65 6e 20 72 65 63 79 63  e has been recyc
4920: 6c 65 64 20 62 75 74 20 69 74 20 69 73 20 74 68  led but it is th
4930: 65 20 77 72 6f 6e 67 20 73 69 7a 65 2c 20 66 72  e wrong size, fr
4940: 65 65 20 69 74 2e 20 2a 2f 0a 20 20 69 66 28 20  ee it. */.  if( 
4950: 70 20 26 26 20 28 70 2d 3e 70 43 61 63 68 65 2d  p && (p->pCache-
4960: 3e 73 7a 50 61 67 65 21 3d 73 7a 50 61 67 65 20  >szPage!=szPage 
4970: 7c 7c 20 70 2d 3e 70 43 61 63 68 65 2d 3e 73 7a  || p->pCache->sz
4980: 50 61 67 65 21 3d 73 7a 45 78 74 72 61 29 20 29  Page!=szExtra) )
4990: 7b 0a 20 20 20 20 70 63 61 63 68 65 50 61 67 65  {.    pcachePage
49a0: 46 72 65 65 28 70 29 3b 0a 20 20 20 20 70 20 3d  Free(p);.    p =
49b0: 20 30 3b 0a 20 20 7d 0a 0a 20 20 69 66 28 20 21   0;.  }..  if( !
49c0: 70 20 29 7b 0a 20 20 20 20 70 20 3d 20 70 63 61  p ){.    p = pca
49d0: 63 68 65 50 61 67 65 41 6c 6c 6f 63 28 70 43 61  chePageAlloc(pCa
49e0: 63 68 65 29 3b 0a 20 20 7d 0a 0a 20 20 2a 70 70  che);.  }..  *pp
49f0: 50 61 67 65 20 3d 20 70 3b 0a 20 20 72 65 74 75  Page = p;.  retu
4a00: 72 6e 20 28 70 3f 53 51 4c 49 54 45 5f 4f 4b 3a  rn (p?SQLITE_OK:
4a10: 53 51 4c 49 54 45 5f 4e 4f 4d 45 4d 29 3b 0a 7d  SQLITE_NOMEM);.}
4a20: 0a 0a 2f 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ../*************
4a30: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
4a40: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
4a50: 2a 2a 2a 2a 2a 2a 20 47 65 6e 65 72 61 6c 20 49  ****** General I
4a60: 6e 74 65 72 66 61 63 65 73 20 2a 2a 2a 2a 2a 2a  nterfaces ******
4a70: 0a 2a 2a 0a 2a 2a 20 49 6e 69 74 69 61 6c 69 7a  .**.** Initializ
4a80: 65 20 61 6e 64 20 73 68 75 74 64 6f 77 6e 20 74  e and shutdown t
4a90: 68 65 20 70 61 67 65 20 63 61 63 68 65 20 73 75  he page cache su
4aa0: 62 73 79 73 74 65 6d 2e 20 4e 65 69 74 68 65 72  bsystem. Neither
4ab0: 20 6f 66 20 74 68 65 73 65 20 0a 2a 2a 20 66 75   of these .** fu
4ac0: 6e 63 74 69 6f 6e 73 20 61 72 65 20 74 68 72 65  nctions are thre
4ad0: 61 64 73 61 66 65 2e 0a 2a 2f 0a 69 6e 74 20 73  adsafe..*/.int s
4ae0: 71 6c 69 74 65 33 50 63 61 63 68 65 49 6e 69 74  qlite3PcacheInit
4af0: 69 61 6c 69 7a 65 28 76 6f 69 64 29 7b 0a 20 20  ialize(void){.  
4b00: 61 73 73 65 72 74 28 20 70 63 61 63 68 65 5f 67  assert( pcache_g
4b10: 2e 69 73 49 6e 69 74 3d 3d 30 20 29 3b 0a 20 20  .isInit==0 );.  
4b20: 6d 65 6d 73 65 74 28 26 70 63 61 63 68 65 5f 67  memset(&pcache_g
4b30: 2c 20 30 2c 20 73 69 7a 65 6f 66 28 70 63 61 63  , 0, sizeof(pcac
4b40: 68 65 29 29 3b 0a 20 20 69 66 28 20 73 71 6c 69  he));.  if( sqli
4b50: 74 65 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e  te3GlobalConfig.
4b60: 62 43 6f 72 65 4d 75 74 65 78 20 29 7b 0a 20 20  bCoreMutex ){.  
4b70: 20 20 2f 2a 20 4e 6f 20 6e 65 65 64 20 74 6f 20    /* No need to 
4b80: 63 68 65 63 6b 20 74 68 65 20 72 65 74 75 72 6e  check the return
4b90: 20 76 61 6c 75 65 20 6f 66 20 73 71 6c 69 74 65   value of sqlite
4ba0: 33 5f 6d 75 74 65 78 5f 61 6c 6c 6f 63 28 29 2e  3_mutex_alloc().
4bb0: 20 0a 20 20 20 20 2a 2a 20 41 6c 6c 6f 63 61 74   .    ** Allocat
4bc0: 69 6e 67 20 61 20 73 74 61 74 69 63 20 6d 75 74  ing a static mut
4bd0: 65 78 20 63 61 6e 6e 6f 74 20 66 61 69 6c 2e 0a  ex cannot fail..
4be0: 20 20 20 20 2a 2f 0a 20 20 20 20 70 63 61 63 68      */.    pcach
4bf0: 65 5f 67 2e 6d 75 74 65 78 20 3d 20 73 71 6c 69  e_g.mutex = sqli
4c00: 74 65 33 5f 6d 75 74 65 78 5f 61 6c 6c 6f 63 28  te3_mutex_alloc(
4c10: 53 51 4c 49 54 45 5f 4d 55 54 45 58 5f 53 54 41  SQLITE_MUTEX_STA
4c20: 54 49 43 5f 4c 52 55 29 3b 0a 20 20 7d 0a 20 20  TIC_LRU);.  }.  
4c30: 70 63 61 63 68 65 5f 67 2e 69 73 49 6e 69 74 20  pcache_g.isInit 
4c40: 3d 20 31 3b 0a 20 20 72 65 74 75 72 6e 20 53 51  = 1;.  return SQ
4c50: 4c 49 54 45 5f 4f 4b 3b 0a 7d 0a 76 6f 69 64 20  LITE_OK;.}.void 
4c60: 73 71 6c 69 74 65 33 50 63 61 63 68 65 53 68 75  sqlite3PcacheShu
4c70: 74 64 6f 77 6e 28 76 6f 69 64 29 7b 0a 20 20 6d  tdown(void){.  m
4c80: 65 6d 73 65 74 28 26 70 63 61 63 68 65 5f 67 2c  emset(&pcache_g,
4c90: 20 30 2c 20 73 69 7a 65 6f 66 28 70 63 61 63 68   0, sizeof(pcach
4ca0: 65 29 29 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 52 65  e));.}../*.** Re
4cb0: 74 75 72 6e 20 74 68 65 20 73 69 7a 65 20 69 6e  turn the size in
4cc0: 20 62 79 74 65 73 20 6f 66 20 61 20 50 43 61 63   bytes of a PCac
4cd0: 68 65 20 6f 62 6a 65 63 74 2e 0a 2a 2f 0a 69 6e  he object..*/.in
4ce0: 74 20 73 71 6c 69 74 65 33 50 63 61 63 68 65 53  t sqlite3PcacheS
4cf0: 69 7a 65 28 76 6f 69 64 29 7b 20 72 65 74 75 72  ize(void){ retur
4d00: 6e 20 73 69 7a 65 6f 66 28 50 43 61 63 68 65 29  n sizeof(PCache)
4d10: 3b 20 7d 0a 0a 2f 2a 0a 2a 2a 20 43 72 65 61 74  ; }../*.** Creat
4d20: 65 20 61 20 6e 65 77 20 50 43 61 63 68 65 20 6f  e a new PCache o
4d30: 62 6a 65 63 74 2e 20 20 53 74 6f 72 61 67 65 20  bject.  Storage 
4d40: 73 70 61 63 65 20 74 6f 20 68 6f 6c 64 20 74 68  space to hold th
4d50: 65 20 6f 62 6a 65 63 74 0a 2a 2a 20 68 61 73 20  e object.** has 
4d60: 61 6c 72 65 61 64 79 20 62 65 65 6e 20 61 6c 6c  already been all
4d70: 6f 63 61 74 65 64 20 61 6e 64 20 69 73 20 70 61  ocated and is pa
4d80: 73 73 65 64 20 69 6e 20 61 73 20 74 68 65 20 70  ssed in as the p
4d90: 20 70 6f 69 6e 74 65 72 2e 0a 2a 2f 0a 76 6f 69   pointer..*/.voi
4da0: 64 20 73 71 6c 69 74 65 33 50 63 61 63 68 65 4f  d sqlite3PcacheO
4db0: 70 65 6e 28 0a 20 20 69 6e 74 20 73 7a 50 61 67  pen(.  int szPag
4dc0: 65 2c 20 20 20 20 20 20 20 20 20 20 20 20 20 20  e,              
4dd0: 20 20 20 20 2f 2a 20 53 69 7a 65 20 6f 66 20 65      /* Size of e
4de0: 76 65 72 79 20 70 61 67 65 20 2a 2f 0a 20 20 69  very page */.  i
4df0: 6e 74 20 73 7a 45 78 74 72 61 2c 20 20 20 20 20  nt szExtra,     
4e00: 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 45              /* E
4e10: 78 74 72 61 20 73 70 61 63 65 20 61 73 73 6f 63  xtra space assoc
4e20: 69 61 74 65 64 20 77 69 74 68 20 65 61 63 68 20  iated with each 
4e30: 70 61 67 65 20 2a 2f 0a 20 20 69 6e 74 20 62 50  page */.  int bP
4e40: 75 72 67 65 61 62 6c 65 2c 20 20 20 20 20 20 20  urgeable,       
4e50: 20 20 20 20 20 20 20 2f 2a 20 54 72 75 65 20 69         /* True i
4e60: 66 20 70 61 67 65 73 20 61 72 65 20 6f 6e 20 62  f pages are on b
4e70: 61 63 6b 69 6e 67 20 73 74 6f 72 65 20 2a 2f 0a  acking store */.
4e80: 20 20 76 6f 69 64 20 28 2a 78 44 65 73 74 72 6f    void (*xDestro
4e90: 79 29 28 50 67 48 64 72 2a 29 2c 20 20 20 20 2f  y)(PgHdr*),    /
4ea0: 2a 20 43 61 6c 6c 65 64 20 74 6f 20 64 65 73 74  * Called to dest
4eb0: 72 6f 79 20 61 20 70 61 67 65 20 2a 2f 0a 20 20  roy a page */.  
4ec0: 69 6e 74 20 28 2a 78 53 74 72 65 73 73 29 28 76  int (*xStress)(v
4ed0: 6f 69 64 2a 2c 50 67 48 64 72 2a 29 2c 2f 2a 20  oid*,PgHdr*),/* 
4ee0: 43 61 6c 6c 20 74 6f 20 74 72 79 20 74 6f 20 6d  Call to try to m
4ef0: 61 6b 65 20 70 61 67 65 73 20 63 6c 65 61 6e 20  ake pages clean 
4f00: 2a 2f 0a 20 20 76 6f 69 64 20 2a 70 53 74 72 65  */.  void *pStre
4f10: 73 73 2c 20 20 20 20 20 20 20 20 20 20 20 20 20  ss,             
4f20: 20 20 2f 2a 20 41 72 67 75 6d 65 6e 74 20 74 6f    /* Argument to
4f30: 20 78 53 74 72 65 73 73 20 2a 2f 0a 20 20 50 43   xStress */.  PC
4f40: 61 63 68 65 20 2a 70 20 20 20 20 20 20 20 20 20  ache *p         
4f50: 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 50 72             /* Pr
4f60: 65 61 6c 6c 6f 63 61 74 65 64 20 73 70 61 63 65  eallocated space
4f70: 20 66 6f 72 20 74 68 65 20 50 43 61 63 68 65 20   for the PCache 
4f80: 2a 2f 0a 29 7b 0a 20 20 61 73 73 65 72 74 28 20  */.){.  assert( 
4f90: 70 63 61 63 68 65 5f 67 2e 69 73 49 6e 69 74 20  pcache_g.isInit 
4fa0: 29 3b 0a 20 20 6d 65 6d 73 65 74 28 70 2c 20 30  );.  memset(p, 0
4fb0: 2c 20 73 69 7a 65 6f 66 28 50 43 61 63 68 65 29  , sizeof(PCache)
4fc0: 29 3b 0a 20 20 70 2d 3e 73 7a 50 61 67 65 20 3d  );.  p->szPage =
4fd0: 20 73 7a 50 61 67 65 3b 0a 20 20 70 2d 3e 73 7a   szPage;.  p->sz
4fe0: 45 78 74 72 61 20 3d 20 73 7a 45 78 74 72 61 3b  Extra = szExtra;
4ff0: 0a 20 20 70 2d 3e 62 50 75 72 67 65 61 62 6c 65  .  p->bPurgeable
5000: 20 3d 20 62 50 75 72 67 65 61 62 6c 65 3b 0a 20   = bPurgeable;. 
5010: 20 70 2d 3e 78 44 65 73 74 72 6f 79 20 3d 20 78   p->xDestroy = x
5020: 44 65 73 74 72 6f 79 3b 0a 20 20 70 2d 3e 78 53  Destroy;.  p->xS
5030: 74 72 65 73 73 20 3d 20 78 53 74 72 65 73 73 3b  tress = xStress;
5040: 0a 20 20 70 2d 3e 70 53 74 72 65 73 73 20 3d 20  .  p->pStress = 
5050: 70 53 74 72 65 73 73 3b 0a 20 20 70 2d 3e 6e 4d  pStress;.  p->nM
5060: 61 78 20 3d 20 31 30 30 3b 0a 20 20 70 2d 3e 6e  ax = 100;.  p->n
5070: 4d 69 6e 20 3d 20 31 30 3b 0a 0a 20 20 70 63 61  Min = 10;..  pca
5080: 63 68 65 45 6e 74 65 72 4d 75 74 65 78 28 29 3b  cheEnterMutex();
5090: 0a 20 20 69 66 28 20 62 50 75 72 67 65 61 62 6c  .  if( bPurgeabl
50a0: 65 20 29 7b 0a 20 20 20 20 70 63 61 63 68 65 5f  e ){.    pcache_
50b0: 67 2e 6e 4d 61 78 50 61 67 65 20 2b 3d 20 70 2d  g.nMaxPage += p-
50c0: 3e 6e 4d 61 78 3b 0a 20 20 20 20 70 63 61 63 68  >nMax;.    pcach
50d0: 65 5f 67 2e 6e 4d 69 6e 50 61 67 65 20 2b 3d 20  e_g.nMinPage += 
50e0: 70 2d 3e 6e 4d 69 6e 3b 0a 20 20 7d 0a 0a 20 20  p->nMin;.  }..  
50f0: 70 63 61 63 68 65 45 78 69 74 4d 75 74 65 78 28  pcacheExitMutex(
5100: 29 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 43 68 61 6e  );.}../*.** Chan
5110: 67 65 20 74 68 65 20 70 61 67 65 20 73 69 7a 65  ge the page size
5120: 20 66 6f 72 20 50 43 61 63 68 65 20 6f 62 6a 65   for PCache obje
5130: 63 74 2e 20 20 54 68 69 73 20 63 61 6e 20 6f 6e  ct.  This can on
5140: 6c 79 20 68 61 70 70 65 6e 0a 2a 2a 20 77 68 65  ly happen.** whe
5150: 6e 20 74 68 65 20 63 61 63 68 65 20 69 73 20 65  n the cache is e
5160: 6d 70 74 79 2e 0a 2a 2f 0a 76 6f 69 64 20 73 71  mpty..*/.void sq
5170: 6c 69 74 65 33 50 63 61 63 68 65 53 65 74 50 61  lite3PcacheSetPa
5180: 67 65 53 69 7a 65 28 50 43 61 63 68 65 20 2a 70  geSize(PCache *p
5190: 43 61 63 68 65 2c 20 69 6e 74 20 73 7a 50 61 67  Cache, int szPag
51a0: 65 29 7b 0a 20 20 61 73 73 65 72 74 28 70 43 61  e){.  assert(pCa
51b0: 63 68 65 2d 3e 6e 50 61 67 65 3d 3d 30 29 3b 0a  che->nPage==0);.
51c0: 20 20 70 43 61 63 68 65 2d 3e 73 7a 50 61 67 65    pCache->szPage
51d0: 20 3d 20 73 7a 50 61 67 65 3b 0a 7d 0a 0a 2f 2a   = szPage;.}../*
51e0: 0a 2a 2a 20 54 72 79 20 74 6f 20 6f 62 74 61 69  .** Try to obtai
51f0: 6e 20 61 20 70 61 67 65 20 66 72 6f 6d 20 74 68  n a page from th
5200: 65 20 63 61 63 68 65 2e 0a 2a 2f 0a 69 6e 74 20  e cache..*/.int 
5210: 73 71 6c 69 74 65 33 50 63 61 63 68 65 46 65 74  sqlite3PcacheFet
5220: 63 68 28 0a 20 20 50 43 61 63 68 65 20 2a 70 43  ch(.  PCache *pC
5230: 61 63 68 65 2c 20 20 20 20 20 20 20 2f 2a 20 4f  ache,       /* O
5240: 62 74 61 69 6e 20 74 68 65 20 70 61 67 65 20 66  btain the page f
5250: 72 6f 6d 20 74 68 69 73 20 63 61 63 68 65 20 2a  rom this cache *
5260: 2f 0a 20 20 50 67 6e 6f 20 70 67 6e 6f 2c 20 20  /.  Pgno pgno,  
5270: 20 20 20 20 20 20 20 20 20 20 2f 2a 20 50 61 67            /* Pag
5280: 65 20 6e 75 6d 62 65 72 20 74 6f 20 6f 62 74 61  e number to obta
5290: 69 6e 20 2a 2f 0a 20 20 69 6e 74 20 63 72 65 61  in */.  int crea
52a0: 74 65 46 6c 61 67 2c 20 20 20 20 20 20 20 2f 2a  teFlag,       /*
52b0: 20 49 66 20 74 72 75 65 2c 20 63 72 65 61 74 65   If true, create
52c0: 20 70 61 67 65 20 69 66 20 69 74 20 64 6f 65 73   page if it does
52d0: 20 6e 6f 74 20 65 78 69 73 74 20 61 6c 72 65 61   not exist alrea
52e0: 64 79 20 2a 2f 0a 20 20 50 67 48 64 72 20 2a 2a  dy */.  PgHdr **
52f0: 70 70 50 61 67 65 20 20 20 20 20 20 20 20 2f 2a  ppPage        /*
5300: 20 57 72 69 74 65 20 74 68 65 20 70 61 67 65 20   Write the page 
5310: 68 65 72 65 20 2a 2f 0a 29 7b 0a 20 20 69 6e 74  here */.){.  int
5320: 20 72 63 20 3d 20 53 51 4c 49 54 45 5f 4f 4b 3b   rc = SQLITE_OK;
5330: 0a 20 20 50 67 48 64 72 20 2a 70 50 61 67 65 20  .  PgHdr *pPage 
5340: 3d 20 30 3b 0a 0a 20 20 61 73 73 65 72 74 28 20  = 0;..  assert( 
5350: 70 63 61 63 68 65 5f 67 2e 69 73 49 6e 69 74 20  pcache_g.isInit 
5360: 29 3b 0a 20 20 61 73 73 65 72 74 28 20 70 43 61  );.  assert( pCa
5370: 63 68 65 21 3d 30 20 29 3b 0a 20 20 61 73 73 65  che!=0 );.  asse
5380: 72 74 28 20 70 67 6e 6f 3e 30 20 29 3b 0a 20 20  rt( pgno>0 );.  
5390: 65 78 70 65 6e 73 69 76 65 5f 61 73 73 65 72 74  expensive_assert
53a0: 28 20 70 43 61 63 68 65 2d 3e 6e 50 69 6e 6e 65  ( pCache->nPinne
53b0: 64 3d 3d 70 63 61 63 68 65 50 69 6e 6e 65 64 43  d==pcachePinnedC
53c0: 6f 75 6e 74 28 70 43 61 63 68 65 29 20 29 3b 0a  ount(pCache) );.
53d0: 0a 20 20 70 63 61 63 68 65 45 6e 74 65 72 4d 75  .  pcacheEnterMu
53e0: 74 65 78 28 29 3b 0a 0a 20 20 2f 2a 20 53 65 61  tex();..  /* Sea
53f0: 72 63 68 20 74 68 65 20 68 61 73 68 20 74 61 62  rch the hash tab
5400: 6c 65 20 66 6f 72 20 74 68 65 20 72 65 71 75 65  le for the reque
5410: 73 74 65 64 20 70 61 67 65 2e 20 45 78 69 74 20  sted page. Exit 
5420: 65 61 72 6c 79 20 69 66 20 69 74 20 69 73 20 66  early if it is f
5430: 6f 75 6e 64 2e 20 2a 2f 0a 20 20 69 66 28 20 70  ound. */.  if( p
5440: 43 61 63 68 65 2d 3e 61 70 48 61 73 68 20 29 7b  Cache->apHash ){
5450: 0a 20 20 20 20 75 33 32 20 68 20 3d 20 70 67 6e  .    u32 h = pgn
5460: 6f 20 25 20 70 43 61 63 68 65 2d 3e 6e 48 61 73  o % pCache->nHas
5470: 68 3b 0a 20 20 20 20 66 6f 72 28 70 50 61 67 65  h;.    for(pPage
5480: 3d 70 43 61 63 68 65 2d 3e 61 70 48 61 73 68 5b  =pCache->apHash[
5490: 68 5d 3b 20 70 50 61 67 65 3b 20 70 50 61 67 65  h]; pPage; pPage
54a0: 3d 70 50 61 67 65 2d 3e 70 4e 65 78 74 48 61 73  =pPage->pNextHas
54b0: 68 29 7b 0a 20 20 20 20 20 20 69 66 28 20 70 50  h){.      if( pP
54c0: 61 67 65 2d 3e 70 67 6e 6f 3d 3d 70 67 6e 6f 20  age->pgno==pgno 
54d0: 29 7b 0a 20 20 20 20 20 20 20 20 69 66 28 20 70  ){.        if( p
54e0: 50 61 67 65 2d 3e 6e 52 65 66 3d 3d 30 20 29 7b  Page->nRef==0 ){
54f0: 0a 20 20 20 20 20 20 20 20 20 20 69 66 28 20 30  .          if( 0
5500: 3d 3d 28 70 50 61 67 65 2d 3e 66 6c 61 67 73 26  ==(pPage->flags&
5510: 50 47 48 44 52 5f 44 49 52 54 59 29 20 29 7b 0a  PGHDR_DIRTY) ){.
5520: 20 20 20 20 20 20 20 20 20 20 20 20 70 63 61 63              pcac
5530: 68 65 52 65 6d 6f 76 65 46 72 6f 6d 4c 72 75 4c  heRemoveFromLruL
5540: 69 73 74 28 70 50 61 67 65 29 3b 0a 20 20 20 20  ist(pPage);.    
5550: 20 20 20 20 20 20 20 20 70 43 61 63 68 65 2d 3e          pCache->
5560: 6e 50 69 6e 6e 65 64 2b 2b 3b 0a 20 20 20 20 20  nPinned++;.     
5570: 20 20 20 20 20 7d 0a 20 20 20 20 20 20 20 20 20       }.         
5580: 20 70 43 61 63 68 65 2d 3e 6e 52 65 66 2b 2b 3b   pCache->nRef++;
5590: 0a 20 20 20 20 20 20 20 20 7d 0a 20 20 20 20 20  .        }.     
55a0: 20 20 20 70 50 61 67 65 2d 3e 6e 52 65 66 2b 2b     pPage->nRef++
55b0: 3b 0a 20 20 20 20 20 20 20 20 62 72 65 61 6b 3b  ;.        break;
55c0: 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 7d 0a 20  .      }.    }. 
55d0: 20 7d 0a 0a 20 20 69 66 28 20 21 70 50 61 67 65   }..  if( !pPage
55e0: 20 26 26 20 63 72 65 61 74 65 46 6c 61 67 20 29   && createFlag )
55f0: 7b 0a 20 20 20 20 69 66 28 20 70 43 61 63 68 65  {.    if( pCache
5600: 2d 3e 6e 48 61 73 68 3c 3d 70 43 61 63 68 65 2d  ->nHash<=pCache-
5610: 3e 6e 50 61 67 65 20 29 7b 0a 20 20 20 20 20 20  >nPage ){.      
5620: 72 63 20 3d 20 70 63 61 63 68 65 52 65 73 69 7a  rc = pcacheResiz
5630: 65 48 61 73 68 28 70 43 61 63 68 65 2c 20 70 43  eHash(pCache, pC
5640: 61 63 68 65 2d 3e 6e 48 61 73 68 3c 32 35 36 20  ache->nHash<256 
5650: 3f 20 32 35 36 20 3a 20 70 43 61 63 68 65 2d 3e  ? 256 : pCache->
5660: 6e 48 61 73 68 2a 32 29 3b 0a 20 20 20 20 7d 0a  nHash*2);.    }.
5670: 20 20 20 20 69 66 28 20 72 63 3d 3d 53 51 4c 49      if( rc==SQLI
5680: 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 20 20 72  TE_OK ){.      r
5690: 63 20 3d 20 70 63 61 63 68 65 52 65 63 79 63 6c  c = pcacheRecycl
56a0: 65 4f 72 41 6c 6c 6f 63 28 70 43 61 63 68 65 2c  eOrAlloc(pCache,
56b0: 20 26 70 50 61 67 65 29 3b 0a 20 20 20 20 7d 0a   &pPage);.    }.
56c0: 20 20 20 20 69 66 28 20 72 63 3d 3d 53 51 4c 49      if( rc==SQLI
56d0: 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 20 20 70  TE_OK ){.      p
56e0: 50 61 67 65 2d 3e 70 50 61 67 65 72 20 3d 20 30  Page->pPager = 0
56f0: 3b 0a 20 20 20 20 20 20 70 50 61 67 65 2d 3e 66  ;.      pPage->f
5700: 6c 61 67 73 20 3d 20 30 3b 0a 20 20 20 20 20 20  lags = 0;.      
5710: 70 50 61 67 65 2d 3e 70 44 69 72 74 79 20 3d 20  pPage->pDirty = 
5720: 30 3b 0a 20 20 20 20 20 20 70 50 61 67 65 2d 3e  0;.      pPage->
5730: 70 67 6e 6f 20 3d 20 70 67 6e 6f 3b 0a 20 20 20  pgno = pgno;.   
5740: 20 20 20 70 50 61 67 65 2d 3e 70 43 61 63 68 65     pPage->pCache
5750: 20 3d 20 70 43 61 63 68 65 3b 0a 20 20 20 20 20   = pCache;.     
5760: 20 70 50 61 67 65 2d 3e 6e 52 65 66 20 3d 20 31   pPage->nRef = 1
5770: 3b 0a 20 20 20 20 20 20 70 43 61 63 68 65 2d 3e  ;.      pCache->
5780: 6e 52 65 66 2b 2b 3b 0a 20 20 20 20 20 20 70 43  nRef++;.      pC
5790: 61 63 68 65 2d 3e 6e 50 69 6e 6e 65 64 2b 2b 3b  ache->nPinned++;
57a0: 0a 20 20 20 20 20 20 70 63 61 63 68 65 41 64 64  .      pcacheAdd
57b0: 54 6f 4c 69 73 74 28 26 70 43 61 63 68 65 2d 3e  ToList(&pCache->
57c0: 70 43 6c 65 61 6e 2c 20 70 50 61 67 65 29 3b 0a  pClean, pPage);.
57d0: 20 20 20 20 20 20 70 63 61 63 68 65 41 64 64 54        pcacheAddT
57e0: 6f 48 61 73 68 28 70 50 61 67 65 29 3b 0a 20 20  oHash(pPage);.  
57f0: 20 20 7d 0a 20 20 7d 0a 0a 20 20 70 63 61 63 68    }.  }..  pcach
5800: 65 45 78 69 74 4d 75 74 65 78 28 29 3b 0a 0a 20  eExitMutex();.. 
5810: 20 2a 70 70 50 61 67 65 20 3d 20 70 50 61 67 65   *ppPage = pPage
5820: 3b 0a 20 20 65 78 70 65 6e 73 69 76 65 5f 61 73  ;.  expensive_as
5830: 73 65 72 74 28 20 70 43 61 63 68 65 2d 3e 6e 50  sert( pCache->nP
5840: 69 6e 6e 65 64 3d 3d 70 63 61 63 68 65 50 69 6e  inned==pcachePin
5850: 6e 65 64 43 6f 75 6e 74 28 70 43 61 63 68 65 29  nedCount(pCache)
5860: 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 70 50   );.  assert( pP
5870: 61 67 65 20 7c 7c 20 21 63 72 65 61 74 65 46 6c  age || !createFl
5880: 61 67 20 7c 7c 20 72 63 21 3d 53 51 4c 49 54 45  ag || rc!=SQLITE
5890: 5f 4f 4b 20 29 3b 0a 20 20 72 65 74 75 72 6e 20  _OK );.  return 
58a0: 72 63 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 44 65 72  rc;.}../*.** Der
58b0: 65 66 65 72 65 6e 63 65 20 61 20 70 61 67 65 2e  eference a page.
58c0: 20 20 57 68 65 6e 20 74 68 65 20 72 65 66 65 72    When the refer
58d0: 65 6e 63 65 20 63 6f 75 6e 74 20 72 65 61 63 68  ence count reach
58e0: 65 73 20 7a 65 72 6f 2c 0a 2a 2a 20 6d 6f 76 65  es zero,.** move
58f0: 20 74 68 65 20 70 61 67 65 20 74 6f 20 74 68 65   the page to the
5900: 20 4c 52 55 20 6c 69 73 74 20 69 66 20 69 74 20   LRU list if it 
5910: 69 73 20 63 6c 65 61 6e 2e 0a 2a 2f 0a 76 6f 69  is clean..*/.voi
5920: 64 20 73 71 6c 69 74 65 33 50 63 61 63 68 65 52  d sqlite3PcacheR
5930: 65 6c 65 61 73 65 28 50 67 48 64 72 20 2a 70 29  elease(PgHdr *p)
5940: 7b 0a 20 20 61 73 73 65 72 74 28 20 70 2d 3e 6e  {.  assert( p->n
5950: 52 65 66 3e 30 20 29 3b 0a 20 20 70 2d 3e 6e 52  Ref>0 );.  p->nR
5960: 65 66 2d 2d 3b 0a 20 20 69 66 28 20 70 2d 3e 6e  ef--;.  if( p->n
5970: 52 65 66 3d 3d 30 20 29 7b 0a 20 20 20 20 50 43  Ref==0 ){.    PC
5980: 61 63 68 65 20 2a 70 43 61 63 68 65 20 3d 20 70  ache *pCache = p
5990: 2d 3e 70 43 61 63 68 65 3b 0a 20 20 20 20 69 66  ->pCache;.    if
59a0: 28 20 70 2d 3e 70 43 61 63 68 65 2d 3e 78 44 65  ( p->pCache->xDe
59b0: 73 74 72 6f 79 20 29 7b 0a 20 20 20 20 20 20 70  stroy ){.      p
59c0: 2d 3e 70 43 61 63 68 65 2d 3e 78 44 65 73 74 72  ->pCache->xDestr
59d0: 6f 79 28 70 29 3b 0a 20 20 20 20 7d 0a 20 20 20  oy(p);.    }.   
59e0: 20 70 43 61 63 68 65 2d 3e 6e 52 65 66 2d 2d 3b   pCache->nRef--;
59f0: 0a 20 20 20 20 69 66 28 20 28 70 2d 3e 66 6c 61  .    if( (p->fla
5a00: 67 73 26 50 47 48 44 52 5f 44 49 52 54 59 29 3d  gs&PGHDR_DIRTY)=
5a10: 3d 30 20 29 7b 0a 20 20 20 20 20 20 70 43 61 63  =0 ){.      pCac
5a20: 68 65 2d 3e 6e 50 69 6e 6e 65 64 2d 2d 3b 0a 20  he->nPinned--;. 
5a30: 20 20 20 20 20 70 63 61 63 68 65 45 6e 74 65 72       pcacheEnter
5a40: 4d 75 74 65 78 28 29 3b 0a 20 20 20 20 20 20 69  Mutex();.      i
5a50: 66 28 20 70 63 61 63 68 65 5f 67 2e 6e 43 75 72  f( pcache_g.nCur
5a60: 72 65 6e 74 50 61 67 65 3e 70 63 61 63 68 65 5f  rentPage>pcache_
5a70: 67 2e 6e 4d 61 78 50 61 67 65 20 29 7b 0a 20 20  g.nMaxPage ){.  
5a80: 20 20 20 20 20 20 70 63 61 63 68 65 52 65 6d 6f        pcacheRemo
5a90: 76 65 46 72 6f 6d 4c 69 73 74 28 26 70 43 61 63  veFromList(&pCac
5aa0: 68 65 2d 3e 70 43 6c 65 61 6e 2c 20 70 29 3b 0a  he->pClean, p);.
5ab0: 20 20 20 20 20 20 20 20 70 63 61 63 68 65 52 65          pcacheRe
5ac0: 6d 6f 76 65 46 72 6f 6d 48 61 73 68 28 70 29 3b  moveFromHash(p);
5ad0: 0a 20 20 20 20 20 20 20 20 70 63 61 63 68 65 50  .        pcacheP
5ae0: 61 67 65 46 72 65 65 28 70 29 3b 0a 20 20 20 20  ageFree(p);.    
5af0: 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 20 20 20    }else{.       
5b00: 20 70 63 61 63 68 65 41 64 64 54 6f 4c 72 75 4c   pcacheAddToLruL
5b10: 69 73 74 28 70 29 3b 0a 20 20 20 20 20 20 7d 0a  ist(p);.      }.
5b20: 20 20 20 20 20 20 70 63 61 63 68 65 45 78 69 74        pcacheExit
5b30: 4d 75 74 65 78 28 29 3b 0a 20 20 20 20 7d 65 6c  Mutex();.    }el
5b40: 73 65 7b 0a 20 20 20 20 20 20 2f 2a 20 4d 6f 76  se{.      /* Mov
5b50: 65 20 74 68 65 20 70 61 67 65 20 74 6f 20 74 68  e the page to th
5b60: 65 20 68 65 61 64 20 6f 66 20 74 68 65 20 63 61  e head of the ca
5b70: 63 68 65 73 20 64 69 72 74 79 20 6c 69 73 74 2e  ches dirty list.
5b80: 20 2a 2f 0a 20 20 20 20 20 20 70 63 61 63 68 65   */.      pcache
5b90: 52 65 6d 6f 76 65 46 72 6f 6d 4c 69 73 74 28 26  RemoveFromList(&
5ba0: 70 43 61 63 68 65 2d 3e 70 44 69 72 74 79 2c 20  pCache->pDirty, 
5bb0: 70 29 3b 0a 20 20 20 20 20 20 70 63 61 63 68 65  p);.      pcache
5bc0: 41 64 64 54 6f 4c 69 73 74 28 26 70 43 61 63 68  AddToList(&pCach
5bd0: 65 2d 3e 70 44 69 72 74 79 2c 20 70 29 3b 0a 20  e->pDirty, p);. 
5be0: 20 20 20 7d 0a 20 20 7d 0a 7d 0a 0a 76 6f 69 64     }.  }.}..void
5bf0: 20 73 71 6c 69 74 65 33 50 63 61 63 68 65 52 65   sqlite3PcacheRe
5c00: 66 28 50 67 48 64 72 20 2a 70 29 7b 0a 20 20 61  f(PgHdr *p){.  a
5c10: 73 73 65 72 74 28 70 2d 3e 6e 52 65 66 3e 30 29  ssert(p->nRef>0)
5c20: 3b 0a 20 20 70 2d 3e 6e 52 65 66 2b 2b 3b 0a 7d  ;.  p->nRef++;.}
5c30: 0a 0a 2f 2a 0a 2a 2a 20 44 72 6f 70 20 61 20 70  ../*.** Drop a p
5c40: 61 67 65 20 66 72 6f 6d 20 74 68 65 20 63 61 63  age from the cac
5c50: 68 65 2e 20 54 68 65 72 65 20 6d 75 73 74 20 62  he. There must b
5c60: 65 20 65 78 61 63 74 6c 79 20 6f 6e 65 20 72 65  e exactly one re
5c70: 66 65 72 65 6e 63 65 20 74 6f 20 74 68 65 0a 2a  ference to the.*
5c80: 2a 20 70 61 67 65 2e 20 54 68 69 73 20 66 75 6e  * page. This fun
5c90: 63 74 69 6f 6e 20 64 65 6c 65 74 65 73 20 74 68  ction deletes th
5ca0: 61 74 20 72 65 66 65 72 65 6e 63 65 2c 20 73 6f  at reference, so
5cb0: 20 61 66 74 65 72 20 69 74 20 72 65 74 75 72 6e   after it return
5cc0: 73 20 74 68 65 0a 2a 2a 20 70 61 67 65 20 70 6f  s the.** page po
5cd0: 69 6e 74 65 64 20 74 6f 20 62 79 20 70 20 69 73  inted to by p is
5ce0: 20 69 6e 76 61 6c 69 64 2e 0a 2a 2f 0a 76 6f 69   invalid..*/.voi
5cf0: 64 20 73 71 6c 69 74 65 33 50 63 61 63 68 65 44  d sqlite3PcacheD
5d00: 72 6f 70 28 50 67 48 64 72 20 2a 70 29 7b 0a 20  rop(PgHdr *p){. 
5d10: 20 50 43 61 63 68 65 20 2a 70 43 61 63 68 65 3b   PCache *pCache;
5d20: 0a 20 20 61 73 73 65 72 74 28 20 70 2d 3e 6e 52  .  assert( p->nR
5d30: 65 66 3d 3d 31 20 29 3b 0a 20 20 61 73 73 65 72  ef==1 );.  asser
5d40: 74 28 20 30 3d 3d 28 70 2d 3e 66 6c 61 67 73 26  t( 0==(p->flags&
5d50: 50 47 48 44 52 5f 44 49 52 54 59 29 20 29 3b 0a  PGHDR_DIRTY) );.
5d60: 20 20 70 43 61 63 68 65 20 3d 20 70 2d 3e 70 43    pCache = p->pC
5d70: 61 63 68 65 3b 0a 20 20 70 43 61 63 68 65 2d 3e  ache;.  pCache->
5d80: 6e 52 65 66 2d 2d 3b 0a 20 20 70 43 61 63 68 65  nRef--;.  pCache
5d90: 2d 3e 6e 50 69 6e 6e 65 64 2d 2d 3b 0a 20 20 70  ->nPinned--;.  p
5da0: 63 61 63 68 65 45 6e 74 65 72 4d 75 74 65 78 28  cacheEnterMutex(
5db0: 29 3b 0a 20 20 70 63 61 63 68 65 52 65 6d 6f 76  );.  pcacheRemov
5dc0: 65 46 72 6f 6d 4c 69 73 74 28 26 70 43 61 63 68  eFromList(&pCach
5dd0: 65 2d 3e 70 43 6c 65 61 6e 2c 20 70 29 3b 0a 20  e->pClean, p);. 
5de0: 20 70 63 61 63 68 65 52 65 6d 6f 76 65 46 72 6f   pcacheRemoveFro
5df0: 6d 48 61 73 68 28 70 29 3b 0a 20 20 70 63 61 63  mHash(p);.  pcac
5e00: 68 65 50 61 67 65 46 72 65 65 28 70 29 3b 0a 20  hePageFree(p);. 
5e10: 20 70 63 61 63 68 65 45 78 69 74 4d 75 74 65 78   pcacheExitMutex
5e20: 28 29 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 4d 61 6b  ();.}../*.** Mak
5e30: 65 20 73 75 72 65 20 74 68 65 20 70 61 67 65 20  e sure the page 
5e40: 69 73 20 6d 61 72 6b 65 64 20 61 73 20 64 69 72  is marked as dir
5e50: 74 79 2e 20 20 49 66 20 69 74 20 69 73 6e 27 74  ty.  If it isn't
5e60: 20 64 69 72 74 79 20 61 6c 72 65 61 64 79 2c 0a   dirty already,.
5e70: 2a 2a 20 6d 61 6b 65 20 69 74 20 73 6f 2e 0a 2a  ** make it so..*
5e80: 2f 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 50 63  /.void sqlite3Pc
5e90: 61 63 68 65 4d 61 6b 65 44 69 72 74 79 28 50 67  acheMakeDirty(Pg
5ea0: 48 64 72 20 2a 70 29 7b 0a 20 20 50 43 61 63 68  Hdr *p){.  PCach
5eb0: 65 20 2a 70 43 61 63 68 65 3b 0a 20 20 70 2d 3e  e *pCache;.  p->
5ec0: 66 6c 61 67 73 20 26 3d 20 7e 50 47 48 44 52 5f  flags &= ~PGHDR_
5ed0: 44 4f 4e 54 5f 57 52 49 54 45 3b 0a 20 20 69 66  DONT_WRITE;.  if
5ee0: 28 20 70 2d 3e 66 6c 61 67 73 20 26 20 50 47 48  ( p->flags & PGH
5ef0: 44 52 5f 44 49 52 54 59 20 29 20 72 65 74 75 72  DR_DIRTY ) retur
5f00: 6e 3b 0a 20 20 61 73 73 65 72 74 28 20 28 70 2d  n;.  assert( (p-
5f10: 3e 66 6c 61 67 73 20 26 20 50 47 48 44 52 5f 44  >flags & PGHDR_D
5f20: 49 52 54 59 29 3d 3d 30 20 29 3b 0a 20 20 61 73  IRTY)==0 );.  as
5f30: 73 65 72 74 28 20 70 2d 3e 6e 52 65 66 3e 30 20  sert( p->nRef>0 
5f40: 29 3b 0a 20 20 70 43 61 63 68 65 20 3d 20 70 2d  );.  pCache = p-
5f50: 3e 70 43 61 63 68 65 3b 0a 20 20 70 63 61 63 68  >pCache;.  pcach
5f60: 65 45 6e 74 65 72 4d 75 74 65 78 28 29 3b 0a 20  eEnterMutex();. 
5f70: 20 70 63 61 63 68 65 52 65 6d 6f 76 65 46 72 6f   pcacheRemoveFro
5f80: 6d 4c 69 73 74 28 26 70 43 61 63 68 65 2d 3e 70  mList(&pCache->p
5f90: 43 6c 65 61 6e 2c 20 70 29 3b 0a 20 20 70 63 61  Clean, p);.  pca
5fa0: 63 68 65 41 64 64 54 6f 4c 69 73 74 28 26 70 43  cheAddToList(&pC
5fb0: 61 63 68 65 2d 3e 70 44 69 72 74 79 2c 20 70 29  ache->pDirty, p)
5fc0: 3b 0a 20 20 70 63 61 63 68 65 45 78 69 74 4d 75  ;.  pcacheExitMu
5fd0: 74 65 78 28 29 3b 0a 20 20 70 2d 3e 66 6c 61 67  tex();.  p->flag
5fe0: 73 20 7c 3d 20 50 47 48 44 52 5f 44 49 52 54 59  s |= PGHDR_DIRTY
5ff0: 3b 0a 7d 0a 0a 76 6f 69 64 20 70 63 61 63 68 65  ;.}..void pcache
6000: 4d 61 6b 65 43 6c 65 61 6e 28 50 67 48 64 72 20  MakeClean(PgHdr 
6010: 2a 70 29 7b 0a 20 20 50 43 61 63 68 65 20 2a 70  *p){.  PCache *p
6020: 43 61 63 68 65 20 3d 20 70 2d 3e 70 43 61 63 68  Cache = p->pCach
6030: 65 3b 0a 20 20 61 73 73 65 72 74 28 20 70 2d 3e  e;.  assert( p->
6040: 61 70 53 61 76 65 5b 30 5d 3d 3d 30 20 26 26 20  apSave[0]==0 && 
6050: 70 2d 3e 61 70 53 61 76 65 5b 31 5d 3d 3d 30 20  p->apSave[1]==0 
6060: 29 3b 0a 20 20 61 73 73 65 72 74 28 20 70 2d 3e  );.  assert( p->
6070: 66 6c 61 67 73 20 26 20 50 47 48 44 52 5f 44 49  flags & PGHDR_DI
6080: 52 54 59 20 29 3b 0a 20 20 70 63 61 63 68 65 52  RTY );.  pcacheR
6090: 65 6d 6f 76 65 46 72 6f 6d 4c 69 73 74 28 26 70  emoveFromList(&p
60a0: 43 61 63 68 65 2d 3e 70 44 69 72 74 79 2c 20 70  Cache->pDirty, p
60b0: 29 3b 0a 20 20 70 63 61 63 68 65 41 64 64 54 6f  );.  pcacheAddTo
60c0: 4c 69 73 74 28 26 70 43 61 63 68 65 2d 3e 70 43  List(&pCache->pC
60d0: 6c 65 61 6e 2c 20 70 29 3b 0a 20 20 70 2d 3e 66  lean, p);.  p->f
60e0: 6c 61 67 73 20 26 3d 20 7e 50 47 48 44 52 5f 44  lags &= ~PGHDR_D
60f0: 49 52 54 59 3b 0a 20 20 69 66 28 20 70 2d 3e 6e  IRTY;.  if( p->n
6100: 52 65 66 3d 3d 30 20 29 7b 0a 20 20 20 20 70 63  Ref==0 ){.    pc
6110: 61 63 68 65 41 64 64 54 6f 4c 72 75 4c 69 73 74  acheAddToLruList
6120: 28 70 29 3b 0a 20 20 20 20 70 43 61 63 68 65 2d  (p);.    pCache-
6130: 3e 6e 50 69 6e 6e 65 64 2d 2d 3b 0a 20 20 7d 0a  >nPinned--;.  }.
6140: 20 20 65 78 70 65 6e 73 69 76 65 5f 61 73 73 65    expensive_asse
6150: 72 74 28 20 70 43 61 63 68 65 2d 3e 6e 50 69 6e  rt( pCache->nPin
6160: 6e 65 64 3d 3d 70 63 61 63 68 65 50 69 6e 6e 65  ned==pcachePinne
6170: 64 43 6f 75 6e 74 28 70 43 61 63 68 65 29 20 29  dCount(pCache) )
6180: 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 4d 61 6b 65 20  ;.}../*.** Make 
6190: 73 75 72 65 20 74 68 65 20 70 61 67 65 20 69 73  sure the page is
61a0: 20 6d 61 72 6b 65 64 20 61 73 20 63 6c 65 61 6e   marked as clean
61b0: 2e 20 20 49 66 20 69 74 20 69 73 6e 27 74 20 63  .  If it isn't c
61c0: 6c 65 61 6e 20 61 6c 72 65 61 64 79 2c 0a 2a 2a  lean already,.**
61d0: 20 6d 61 6b 65 20 69 74 20 73 6f 2e 0a 2a 2f 0a   make it so..*/.
61e0: 76 6f 69 64 20 73 71 6c 69 74 65 33 50 63 61 63  void sqlite3Pcac
61f0: 68 65 4d 61 6b 65 43 6c 65 61 6e 28 50 67 48 64  heMakeClean(PgHd
6200: 72 20 2a 70 29 7b 0a 20 20 69 66 28 20 28 70 2d  r *p){.  if( (p-
6210: 3e 66 6c 61 67 73 20 26 20 50 47 48 44 52 5f 44  >flags & PGHDR_D
6220: 49 52 54 59 29 20 29 7b 0a 20 20 20 20 70 63 61  IRTY) ){.    pca
6230: 63 68 65 45 6e 74 65 72 4d 75 74 65 78 28 29 3b  cheEnterMutex();
6240: 0a 20 20 20 20 70 63 61 63 68 65 4d 61 6b 65 43  .    pcacheMakeC
6250: 6c 65 61 6e 28 70 29 3b 0a 20 20 20 20 70 63 61  lean(p);.    pca
6260: 63 68 65 45 78 69 74 4d 75 74 65 78 28 29 3b 0a  cheExitMutex();.
6270: 20 20 7d 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 4d 61 6b    }.}../*.** Mak
6280: 65 20 65 76 65 72 79 20 70 61 67 65 20 69 6e 20  e every page in 
6290: 74 68 65 20 63 61 63 68 65 20 63 6c 65 61 6e 2e  the cache clean.
62a0: 0a 2a 2f 0a 76 6f 69 64 20 73 71 6c 69 74 65 33  .*/.void sqlite3
62b0: 50 63 61 63 68 65 43 6c 65 61 6e 41 6c 6c 28 50  PcacheCleanAll(P
62c0: 43 61 63 68 65 20 2a 70 43 61 63 68 65 29 7b 0a  Cache *pCache){.
62d0: 20 20 50 67 48 64 72 20 2a 70 3b 0a 20 20 70 63    PgHdr *p;.  pc
62e0: 61 63 68 65 45 6e 74 65 72 4d 75 74 65 78 28 29  acheEnterMutex()
62f0: 3b 0a 20 20 77 68 69 6c 65 28 20 28 70 20 3d 20  ;.  while( (p = 
6300: 70 43 61 63 68 65 2d 3e 70 44 69 72 74 79 29 21  pCache->pDirty)!
6310: 3d 30 20 29 7b 0a 20 20 20 20 61 73 73 65 72 74  =0 ){.    assert
6320: 28 20 70 2d 3e 61 70 53 61 76 65 5b 30 5d 3d 3d  ( p->apSave[0]==
6330: 30 20 26 26 20 70 2d 3e 61 70 53 61 76 65 5b 31  0 && p->apSave[1
6340: 5d 3d 3d 30 20 29 3b 0a 20 20 20 20 70 63 61 63  ]==0 );.    pcac
6350: 68 65 52 65 6d 6f 76 65 46 72 6f 6d 4c 69 73 74  heRemoveFromList
6360: 28 26 70 43 61 63 68 65 2d 3e 70 44 69 72 74 79  (&pCache->pDirty
6370: 2c 20 70 29 3b 0a 20 20 20 20 70 2d 3e 66 6c 61  , p);.    p->fla
6380: 67 73 20 26 3d 20 7e 50 47 48 44 52 5f 44 49 52  gs &= ~PGHDR_DIR
6390: 54 59 3b 0a 20 20 20 20 70 63 61 63 68 65 41 64  TY;.    pcacheAd
63a0: 64 54 6f 4c 69 73 74 28 26 70 43 61 63 68 65 2d  dToList(&pCache-
63b0: 3e 70 43 6c 65 61 6e 2c 20 70 29 3b 0a 20 20 20  >pClean, p);.   
63c0: 20 69 66 28 20 70 2d 3e 6e 52 65 66 3d 3d 30 20   if( p->nRef==0 
63d0: 29 7b 0a 20 20 20 20 20 20 70 63 61 63 68 65 41  ){.      pcacheA
63e0: 64 64 54 6f 4c 72 75 4c 69 73 74 28 70 29 3b 0a  ddToLruList(p);.
63f0: 20 20 20 20 20 20 70 43 61 63 68 65 2d 3e 6e 50        pCache->nP
6400: 69 6e 6e 65 64 2d 2d 3b 0a 20 20 20 20 7d 0a 20  inned--;.    }. 
6410: 20 7d 0a 20 20 73 71 6c 69 74 65 33 50 63 61 63   }.  sqlite3Pcac
6420: 68 65 41 73 73 65 72 74 46 6c 61 67 73 28 70 43  heAssertFlags(pC
6430: 61 63 68 65 2c 20 30 2c 20 50 47 48 44 52 5f 44  ache, 0, PGHDR_D
6440: 49 52 54 59 29 3b 0a 20 20 65 78 70 65 6e 73 69  IRTY);.  expensi
6450: 76 65 5f 61 73 73 65 72 74 28 20 70 43 61 63 68  ve_assert( pCach
6460: 65 2d 3e 6e 50 69 6e 6e 65 64 3d 3d 70 63 61 63  e->nPinned==pcac
6470: 68 65 50 69 6e 6e 65 64 43 6f 75 6e 74 28 70 43  hePinnedCount(pC
6480: 61 63 68 65 29 20 29 3b 0a 20 20 70 63 61 63 68  ache) );.  pcach
6490: 65 45 78 69 74 4d 75 74 65 78 28 29 3b 0a 7d 0a  eExitMutex();.}.
64a0: 0a 2f 2a 0a 2a 2a 20 43 68 61 6e 67 65 20 74 68  ./*.** Change th
64b0: 65 20 70 61 67 65 20 6e 75 6d 62 65 72 20 6f 66  e page number of
64c0: 20 70 61 67 65 20 70 20 74 6f 20 6e 65 77 50 67   page p to newPg
64d0: 6e 6f 2e 20 49 66 20 6e 65 77 50 67 6e 6f 20 69  no. If newPgno i
64e0: 73 20 30 2c 20 74 68 65 6e 20 74 68 65 0a 2a 2a  s 0, then the.**
64f0: 20 70 61 67 65 20 6f 62 6a 65 63 74 20 69 73 20   page object is 
6500: 61 64 64 65 64 20 74 6f 20 74 68 65 20 63 6c 65  added to the cle
6510: 61 6e 2d 6c 69 73 74 20 61 6e 64 20 74 68 65 20  an-list and the 
6520: 50 47 48 44 52 5f 52 45 55 53 45 5f 55 4e 4c 49  PGHDR_REUSE_UNLI
6530: 4b 45 4c 59 20 0a 2a 2a 20 66 6c 61 67 20 73 65  KELY .** flag se
6540: 74 2e 0a 2a 2f 0a 76 6f 69 64 20 73 71 6c 69 74  t..*/.void sqlit
6550: 65 33 50 63 61 63 68 65 4d 6f 76 65 28 50 67 48  e3PcacheMove(PgH
6560: 64 72 20 2a 70 2c 20 50 67 6e 6f 20 6e 65 77 50  dr *p, Pgno newP
6570: 67 6e 6f 29 7b 0a 20 20 61 73 73 65 72 74 28 20  gno){.  assert( 
6580: 70 2d 3e 6e 52 65 66 3e 30 20 29 3b 0a 20 20 70  p->nRef>0 );.  p
6590: 63 61 63 68 65 45 6e 74 65 72 4d 75 74 65 78 28  cacheEnterMutex(
65a0: 29 3b 0a 20 20 70 63 61 63 68 65 52 65 6d 6f 76  );.  pcacheRemov
65b0: 65 46 72 6f 6d 48 61 73 68 28 70 29 3b 0a 20 20  eFromHash(p);.  
65c0: 70 2d 3e 70 67 6e 6f 20 3d 20 6e 65 77 50 67 6e  p->pgno = newPgn
65d0: 6f 3b 0a 20 20 69 66 28 20 6e 65 77 50 67 6e 6f  o;.  if( newPgno
65e0: 3d 3d 30 20 29 7b 0a 20 20 20 20 70 2d 3e 66 6c  ==0 ){.    p->fl
65f0: 61 67 73 20 7c 3d 20 50 47 48 44 52 5f 52 45 55  ags |= PGHDR_REU
6600: 53 45 5f 55 4e 4c 49 4b 45 4c 59 3b 0a 20 20 20  SE_UNLIKELY;.   
6610: 20 70 63 61 63 68 65 46 72 65 65 28 70 2d 3e 61   pcacheFree(p->a
6620: 70 53 61 76 65 5b 30 5d 29 3b 0a 20 20 20 20 70  pSave[0]);.    p
6630: 63 61 63 68 65 46 72 65 65 28 70 2d 3e 61 70 53  cacheFree(p->apS
6640: 61 76 65 5b 31 5d 29 3b 0a 20 20 20 20 70 2d 3e  ave[1]);.    p->
6650: 61 70 53 61 76 65 5b 30 5d 20 3d 20 30 3b 0a 20  apSave[0] = 0;. 
6660: 20 20 20 70 2d 3e 61 70 53 61 76 65 5b 31 5d 20     p->apSave[1] 
6670: 3d 20 30 3b 0a 20 20 20 20 69 66 28 20 28 70 2d  = 0;.    if( (p-
6680: 3e 66 6c 61 67 73 20 26 20 50 47 48 44 52 5f 44  >flags & PGHDR_D
6690: 49 52 54 59 29 20 29 7b 0a 20 20 20 20 20 20 70  IRTY) ){.      p
66a0: 63 61 63 68 65 4d 61 6b 65 43 6c 65 61 6e 28 70  cacheMakeClean(p
66b0: 29 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a 20 20 70  );.    }.  }.  p
66c0: 63 61 63 68 65 41 64 64 54 6f 48 61 73 68 28 70  cacheAddToHash(p
66d0: 29 3b 0a 20 20 70 63 61 63 68 65 45 78 69 74 4d  );.  pcacheExitM
66e0: 75 74 65 78 28 29 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a  utex();.}../*.**
66f0: 20 52 65 6d 6f 76 65 20 61 6c 6c 20 63 6f 6e 74   Remove all cont
6700: 65 6e 74 20 66 72 6f 6d 20 61 20 70 61 67 65 20  ent from a page 
6710: 63 61 63 68 65 0a 2a 2f 0a 76 6f 69 64 20 70 63  cache.*/.void pc
6720: 61 63 68 65 43 6c 65 61 72 28 50 43 61 63 68 65  acheClear(PCache
6730: 20 2a 70 43 61 63 68 65 29 7b 0a 20 20 50 67 48   *pCache){.  PgH
6740: 64 72 20 2a 70 2c 20 2a 70 4e 65 78 74 3b 0a 20  dr *p, *pNext;. 
6750: 20 61 73 73 65 72 74 28 20 73 71 6c 69 74 65 33   assert( sqlite3
6760: 5f 6d 75 74 65 78 5f 68 65 6c 64 28 70 63 61 63  _mutex_held(pcac
6770: 68 65 5f 67 2e 6d 75 74 65 78 29 20 29 3b 0a 20  he_g.mutex) );. 
6780: 20 66 6f 72 28 70 3d 70 43 61 63 68 65 2d 3e 70   for(p=pCache->p
6790: 43 6c 65 61 6e 3b 20 70 3b 20 70 3d 70 4e 65 78  Clean; p; p=pNex
67a0: 74 29 7b 0a 20 20 20 20 70 4e 65 78 74 20 3d 20  t){.    pNext = 
67b0: 70 2d 3e 70 4e 65 78 74 3b 0a 20 20 20 20 70 63  p->pNext;.    pc
67c0: 61 63 68 65 52 65 6d 6f 76 65 46 72 6f 6d 4c 72  acheRemoveFromLr
67d0: 75 4c 69 73 74 28 70 29 3b 0a 20 20 20 20 70 63  uList(p);.    pc
67e0: 61 63 68 65 50 61 67 65 46 72 65 65 28 70 29 3b  achePageFree(p);
67f0: 0a 20 20 7d 0a 20 20 66 6f 72 28 70 3d 70 43 61  .  }.  for(p=pCa
6800: 63 68 65 2d 3e 70 44 69 72 74 79 3b 20 70 3b 20  che->pDirty; p; 
6810: 70 3d 70 4e 65 78 74 29 7b 0a 20 20 20 20 70 4e  p=pNext){.    pN
6820: 65 78 74 20 3d 20 70 2d 3e 70 4e 65 78 74 3b 0a  ext = p->pNext;.
6830: 20 20 20 20 70 63 61 63 68 65 50 61 67 65 46 72      pcachePageFr
6840: 65 65 28 70 29 3b 0a 20 20 7d 0a 20 20 70 43 61  ee(p);.  }.  pCa
6850: 63 68 65 2d 3e 70 43 6c 65 61 6e 20 3d 20 30 3b  che->pClean = 0;
6860: 0a 20 20 70 43 61 63 68 65 2d 3e 70 44 69 72 74  .  pCache->pDirt
6870: 79 20 3d 20 30 3b 0a 20 20 70 43 61 63 68 65 2d  y = 0;.  pCache-
6880: 3e 70 44 69 72 74 79 54 61 69 6c 20 3d 20 30 3b  >pDirtyTail = 0;
6890: 0a 20 20 70 43 61 63 68 65 2d 3e 6e 50 61 67 65  .  pCache->nPage
68a0: 20 3d 20 30 3b 0a 20 20 70 43 61 63 68 65 2d 3e   = 0;.  pCache->
68b0: 6e 50 69 6e 6e 65 64 20 3d 20 30 3b 0a 20 20 6d  nPinned = 0;.  m
68c0: 65 6d 73 65 74 28 70 43 61 63 68 65 2d 3e 61 70  emset(pCache->ap
68d0: 48 61 73 68 2c 20 30 2c 20 70 43 61 63 68 65 2d  Hash, 0, pCache-
68e0: 3e 6e 48 61 73 68 2a 73 69 7a 65 6f 66 28 70 43  >nHash*sizeof(pC
68f0: 61 63 68 65 2d 3e 61 70 48 61 73 68 5b 30 5d 29  ache->apHash[0])
6900: 29 3b 0a 7d 0a 0a 0a 2f 2a 0a 2a 2a 20 44 72 6f  );.}.../*.** Dro
6910: 70 20 65 76 65 72 79 20 63 61 63 68 65 20 65 6e  p every cache en
6920: 74 72 79 20 77 68 6f 73 65 20 70 61 67 65 20 6e  try whose page n
6930: 75 6d 62 65 72 20 69 73 20 67 72 65 61 74 65 72  umber is greater
6940: 20 74 68 61 6e 20 22 70 67 6e 6f 22 2e 0a 2a 2f   than "pgno"..*/
6950: 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 50 63 61  .void sqlite3Pca
6960: 63 68 65 54 72 75 6e 63 61 74 65 28 50 43 61 63  cheTruncate(PCac
6970: 68 65 20 2a 70 43 61 63 68 65 2c 20 50 67 6e 6f  he *pCache, Pgno
6980: 20 70 67 6e 6f 29 7b 0a 20 20 50 67 48 64 72 20   pgno){.  PgHdr 
6990: 2a 70 2c 20 2a 70 4e 65 78 74 3b 0a 20 20 50 67  *p, *pNext;.  Pg
69a0: 48 64 72 20 2a 70 44 69 72 74 79 20 3d 20 70 43  Hdr *pDirty = pC
69b0: 61 63 68 65 2d 3e 70 44 69 72 74 79 3b 0a 20 20  ache->pDirty;.  
69c0: 70 63 61 63 68 65 45 6e 74 65 72 4d 75 74 65 78  pcacheEnterMutex
69d0: 28 29 3b 0a 20 20 66 6f 72 28 70 3d 70 43 61 63  ();.  for(p=pCac
69e0: 68 65 2d 3e 70 43 6c 65 61 6e 3b 20 70 7c 7c 70  he->pClean; p||p
69f0: 44 69 72 74 79 3b 20 70 3d 70 4e 65 78 74 29 7b  Dirty; p=pNext){
6a00: 0a 20 20 20 20 69 66 28 20 21 70 20 29 7b 0a 20  .    if( !p ){. 
6a10: 20 20 20 20 20 70 20 3d 20 70 44 69 72 74 79 3b       p = pDirty;
6a20: 0a 20 20 20 20 20 20 70 44 69 72 74 79 20 3d 20  .      pDirty = 
6a30: 30 3b 0a 20 20 20 20 7d 0a 20 20 20 20 70 4e 65  0;.    }.    pNe
6a40: 78 74 20 3d 20 70 2d 3e 70 4e 65 78 74 3b 0a 20  xt = p->pNext;. 
6a50: 20 20 20 69 66 28 20 70 2d 3e 70 67 6e 6f 3e 70     if( p->pgno>p
6a60: 67 6e 6f 20 29 7b 0a 20 20 20 20 20 20 69 66 28  gno ){.      if(
6a70: 20 70 2d 3e 6e 52 65 66 3d 3d 30 20 29 7b 0a 20   p->nRef==0 ){. 
6a80: 20 20 20 20 20 20 20 70 63 61 63 68 65 52 65 6d         pcacheRem
6a90: 6f 76 65 46 72 6f 6d 48 61 73 68 28 70 29 3b 0a  oveFromHash(p);.
6aa0: 20 20 20 20 20 20 20 20 69 66 28 20 70 2d 3e 66          if( p->f
6ab0: 6c 61 67 73 26 50 47 48 44 52 5f 44 49 52 54 59  lags&PGHDR_DIRTY
6ac0: 20 29 7b 0a 20 20 20 20 20 20 20 20 20 20 70 63   ){.          pc
6ad0: 61 63 68 65 52 65 6d 6f 76 65 46 72 6f 6d 4c 69  acheRemoveFromLi
6ae0: 73 74 28 26 70 43 61 63 68 65 2d 3e 70 44 69 72  st(&pCache->pDir
6af0: 74 79 2c 20 70 29 3b 0a 20 20 20 20 20 20 20 20  ty, p);.        
6b00: 20 20 70 43 61 63 68 65 2d 3e 6e 50 69 6e 6e 65    pCache->nPinne
6b10: 64 2d 2d 3b 0a 20 20 20 20 20 20 20 20 7d 65 6c  d--;.        }el
6b20: 73 65 7b 0a 20 20 20 20 20 20 20 20 20 20 70 63  se{.          pc
6b30: 61 63 68 65 52 65 6d 6f 76 65 46 72 6f 6d 4c 69  acheRemoveFromLi
6b40: 73 74 28 26 70 43 61 63 68 65 2d 3e 70 43 6c 65  st(&pCache->pCle
6b50: 61 6e 2c 20 70 29 3b 0a 20 20 20 20 20 20 20 20  an, p);.        
6b60: 20 20 70 63 61 63 68 65 52 65 6d 6f 76 65 46 72    pcacheRemoveFr
6b70: 6f 6d 4c 72 75 4c 69 73 74 28 70 29 3b 0a 20 20  omLruList(p);.  
6b80: 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 20 20        }.        
6b90: 70 63 61 63 68 65 50 61 67 65 46 72 65 65 28 70  pcachePageFree(p
6ba0: 29 3b 0a 20 20 20 20 20 20 7d 65 6c 73 65 7b 0a  );.      }else{.
6bb0: 20 20 20 20 20 20 20 20 2f 2a 20 49 66 20 74 68          /* If th
6bc0: 65 72 65 20 61 72 65 20 72 65 66 65 72 65 6e 63  ere are referenc
6bd0: 65 73 20 74 6f 20 74 68 65 20 70 61 67 65 2c 20  es to the page, 
6be0: 69 74 20 63 61 6e 6e 6f 74 20 62 65 20 66 72 65  it cannot be fre
6bf0: 65 64 2e 20 49 6e 20 74 68 69 73 0a 20 20 20 20  ed. In this.    
6c00: 20 20 20 20 2a 2a 20 63 61 73 65 2c 20 7a 65 72      ** case, zer
6c10: 6f 20 74 68 65 20 70 61 67 65 20 63 6f 6e 74 65  o the page conte
6c20: 6e 74 20 69 6e 73 74 65 61 64 2e 0a 20 20 20 20  nt instead..    
6c30: 20 20 20 20 2a 2f 0a 20 20 20 20 20 20 20 20 6d      */.        m
6c40: 65 6d 73 65 74 28 70 2d 3e 70 44 61 74 61 2c 20  emset(p->pData, 
6c50: 30 2c 20 70 43 61 63 68 65 2d 3e 73 7a 50 61 67  0, pCache->szPag
6c60: 65 29 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20 20  e);.      }.    
6c70: 7d 0a 20 20 7d 0a 20 20 70 63 61 63 68 65 45 78  }.  }.  pcacheEx
6c80: 69 74 4d 75 74 65 78 28 29 3b 0a 7d 0a 0a 2f 2a  itMutex();.}../*
6c90: 0a 2a 2a 20 49 66 20 74 68 65 72 65 20 61 72 65  .** If there are
6ca0: 20 63 75 72 72 65 6e 74 6c 79 20 6d 6f 72 65 20   currently more 
6cb0: 74 68 61 6e 20 70 63 61 63 68 65 2e 6e 4d 61 78  than pcache.nMax
6cc0: 50 61 67 65 20 70 61 67 65 73 20 61 6c 6c 6f 63  Page pages alloc
6cd0: 61 74 65 64 2c 20 74 72 79 0a 2a 2a 20 74 6f 20  ated, try.** to 
6ce0: 72 65 63 79 63 6c 65 20 70 61 67 65 73 20 74 6f  recycle pages to
6cf0: 20 72 65 64 75 63 65 20 74 68 65 20 6e 75 6d 62   reduce the numb
6d00: 65 72 20 61 6c 6c 6f 63 61 74 65 64 20 74 6f 20  er allocated to 
6d10: 70 63 61 63 68 65 2e 6e 4d 61 78 50 61 67 65 2e  pcache.nMaxPage.
6d20: 0a 2a 2f 0a 73 74 61 74 69 63 20 76 6f 69 64 20  .*/.static void 
6d30: 70 63 61 63 68 65 45 6e 66 6f 72 63 65 4d 61 78  pcacheEnforceMax
6d40: 50 61 67 65 28 29 7b 0a 20 20 50 67 48 64 72 20  Page(){.  PgHdr 
6d50: 2a 70 3b 0a 20 20 61 73 73 65 72 74 28 20 73 71  *p;.  assert( sq
6d60: 6c 69 74 65 33 5f 6d 75 74 65 78 5f 68 65 6c 64  lite3_mutex_held
6d70: 28 70 63 61 63 68 65 5f 67 2e 6d 75 74 65 78 29  (pcache_g.mutex)
6d80: 20 29 3b 0a 20 20 77 68 69 6c 65 28 20 70 63 61   );.  while( pca
6d90: 63 68 65 5f 67 2e 6e 43 75 72 72 65 6e 74 50 61  che_g.nCurrentPa
6da0: 67 65 3e 70 63 61 63 68 65 5f 67 2e 6e 4d 61 78  ge>pcache_g.nMax
6db0: 50 61 67 65 20 26 26 20 28 70 20 3d 20 70 63 61  Page && (p = pca
6dc0: 63 68 65 52 65 63 79 63 6c 65 50 61 67 65 28 29  cheRecyclePage()
6dd0: 29 20 29 7b 0a 20 20 20 20 70 63 61 63 68 65 50  ) ){.    pcacheP
6de0: 61 67 65 46 72 65 65 28 70 29 3b 0a 20 20 7d 0a  ageFree(p);.  }.
6df0: 7d 0a 0a 2f 2a 0a 2a 2a 20 43 6c 6f 73 65 20 61  }../*.** Close a
6e00: 20 63 61 63 68 65 2e 0a 2a 2f 0a 76 6f 69 64 20   cache..*/.void 
6e10: 73 71 6c 69 74 65 33 50 63 61 63 68 65 43 6c 6f  sqlite3PcacheClo
6e20: 73 65 28 50 43 61 63 68 65 20 2a 70 43 61 63 68  se(PCache *pCach
6e30: 65 29 7b 0a 20 20 70 63 61 63 68 65 45 6e 74 65  e){.  pcacheEnte
6e40: 72 4d 75 74 65 78 28 29 3b 0a 0a 20 20 2f 2a 20  rMutex();..  /* 
6e50: 46 72 65 65 20 61 6c 6c 20 74 68 65 20 70 61 67  Free all the pag
6e60: 65 73 20 75 73 65 64 20 62 79 20 74 68 69 73 20  es used by this 
6e70: 70 61 67 65 72 20 61 6e 64 20 72 65 6d 6f 76 65  pager and remove
6e80: 20 74 68 65 6d 20 66 72 6f 6d 20 74 68 65 20 4c   them from the L
6e90: 52 55 20 6c 69 73 74 2e 20 2a 2f 0a 20 20 70 63  RU list. */.  pc
6ea0: 61 63 68 65 43 6c 65 61 72 28 70 43 61 63 68 65  acheClear(pCache
6eb0: 29 3b 0a 20 20 69 66 28 20 70 43 61 63 68 65 2d  );.  if( pCache-
6ec0: 3e 62 50 75 72 67 65 61 62 6c 65 20 29 7b 0a 20  >bPurgeable ){. 
6ed0: 20 20 20 70 63 61 63 68 65 5f 67 2e 6e 4d 61 78     pcache_g.nMax
6ee0: 50 61 67 65 20 2d 3d 20 70 43 61 63 68 65 2d 3e  Page -= pCache->
6ef0: 6e 4d 61 78 3b 0a 20 20 20 20 70 63 61 63 68 65  nMax;.    pcache
6f00: 5f 67 2e 6e 4d 69 6e 50 61 67 65 20 2d 3d 20 70  _g.nMinPage -= p
6f10: 43 61 63 68 65 2d 3e 6e 4d 69 6e 3b 0a 20 20 20  Cache->nMin;.   
6f20: 20 70 63 61 63 68 65 45 6e 66 6f 72 63 65 4d 61   pcacheEnforceMa
6f30: 78 50 61 67 65 28 29 3b 0a 20 20 7d 0a 20 20 73  xPage();.  }.  s
6f40: 71 6c 69 74 65 33 5f 66 72 65 65 28 70 43 61 63  qlite3_free(pCac
6f50: 68 65 2d 3e 61 70 48 61 73 68 29 3b 0a 20 20 70  he->apHash);.  p
6f60: 63 61 63 68 65 45 78 69 74 4d 75 74 65 78 28 29  cacheExitMutex()
6f70: 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 50 72 65 73 65  ;.}../*.** Prese
6f80: 72 76 65 20 74 68 65 20 63 6f 6e 74 65 6e 74 20  rve the content 
6f90: 6f 66 20 74 68 65 20 70 61 67 65 2e 20 20 49 74  of the page.  It
6fa0: 20 69 73 20 61 73 73 75 6d 65 64 20 74 68 61 74   is assumed that
6fb0: 20 74 68 65 20 63 6f 6e 74 65 6e 74 0a 2a 2a 20   the content.** 
6fc0: 68 61 73 20 6e 6f 74 20 62 65 65 6e 20 70 72 65  has not been pre
6fd0: 73 65 72 76 65 64 20 61 6c 72 65 61 64 79 2e 0a  served already..
6fe0: 2a 2a 0a 2a 2a 20 49 66 20 69 64 4a 6f 75 72 6e  **.** If idJourn
6ff0: 61 6c 3d 3d 30 20 74 68 65 6e 20 74 68 69 73 20  al==0 then this 
7000: 69 73 20 66 6f 72 20 74 68 65 20 6f 76 65 72 61  is for the overa
7010: 6c 6c 20 74 72 61 6e 73 61 63 74 69 6f 6e 2e 0a  ll transaction..
7020: 2a 2a 20 49 66 20 69 64 4a 6f 75 72 6e 61 6c 3d  ** If idJournal=
7030: 3d 31 20 74 68 65 6e 20 74 68 69 73 20 69 73 20  =1 then this is 
7040: 66 6f 72 20 74 68 65 20 73 74 61 74 65 6d 65 6e  for the statemen
7050: 74 20 6a 6f 75 72 6e 61 6c 2e 0a 2a 2a 0a 2a 2a  t journal..**.**
7060: 20 54 68 69 73 20 72 6f 75 74 69 6e 65 20 69 73   This routine is
7070: 20 75 73 65 64 20 66 6f 72 20 69 6e 2d 6d 65 6d   used for in-mem
7080: 6f 72 79 20 64 61 74 61 62 61 73 65 73 20 6f 6e  ory databases on
7090: 6c 79 2e 0a 2a 2a 0a 2a 2a 20 52 65 74 75 72 6e  ly..**.** Return
70a0: 20 53 51 4c 49 54 45 5f 4f 4b 20 6f 72 20 53 51   SQLITE_OK or SQ
70b0: 4c 49 54 45 5f 4e 4f 4d 45 4d 20 69 66 20 61 20  LITE_NOMEM if a 
70c0: 6d 65 6d 6f 72 79 20 61 6c 6c 6f 63 61 74 69 6f  memory allocatio
70d0: 6e 20 66 61 69 6c 73 2e 0a 2a 2f 0a 69 6e 74 20  n fails..*/.int 
70e0: 73 71 6c 69 74 65 33 50 63 61 63 68 65 50 72 65  sqlite3PcachePre
70f0: 73 65 72 76 65 28 50 67 48 64 72 20 2a 70 2c 20  serve(PgHdr *p, 
7100: 69 6e 74 20 69 64 4a 6f 75 72 6e 61 6c 29 7b 0a  int idJournal){.
7110: 20 20 76 6f 69 64 20 2a 78 3b 0a 20 20 69 6e 74    void *x;.  int
7120: 20 73 7a 3b 0a 20 20 61 73 73 65 72 74 28 20 70   sz;.  assert( p
7130: 2d 3e 70 43 61 63 68 65 2d 3e 62 50 75 72 67 65  ->pCache->bPurge
7140: 61 62 6c 65 3d 3d 30 20 29 3b 0a 20 20 61 73 73  able==0 );.  ass
7150: 65 72 74 28 20 70 2d 3e 61 70 53 61 76 65 5b 69  ert( p->apSave[i
7160: 64 4a 6f 75 72 6e 61 6c 5d 3d 3d 30 20 29 3b 0a  dJournal]==0 );.
7170: 20 20 73 7a 20 3d 20 70 2d 3e 70 43 61 63 68 65    sz = p->pCache
7180: 2d 3e 73 7a 50 61 67 65 3b 0a 20 20 70 2d 3e 61  ->szPage;.  p->a
7190: 70 53 61 76 65 5b 69 64 4a 6f 75 72 6e 61 6c 5d  pSave[idJournal]
71a0: 20 3d 20 78 20 3d 20 73 71 6c 69 74 65 33 50 61   = x = sqlite3Pa
71b0: 67 65 4d 61 6c 6c 6f 63 28 20 73 7a 20 29 3b 0a  geMalloc( sz );.
71c0: 20 20 69 66 28 20 78 3d 3d 30 20 29 20 72 65 74    if( x==0 ) ret
71d0: 75 72 6e 20 53 51 4c 49 54 45 5f 4e 4f 4d 45 4d  urn SQLITE_NOMEM
71e0: 3b 0a 20 20 6d 65 6d 63 70 79 28 78 2c 20 70 2d  ;.  memcpy(x, p-
71f0: 3e 70 44 61 74 61 2c 20 73 7a 29 3b 0a 20 20 72  >pData, sz);.  r
7200: 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b  eturn SQLITE_OK;
7210: 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 43 6f 6d 6d 69 74  .}../*.** Commit
7220: 20 61 20 63 68 61 6e 67 65 20 70 72 65 76 69 6f   a change previo
7230: 75 73 6c 79 20 70 72 65 73 65 72 76 65 64 2e 0a  usly preserved..
7240: 2a 2f 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 50  */.void sqlite3P
7250: 63 61 63 68 65 43 6f 6d 6d 69 74 28 50 43 61 63  cacheCommit(PCac
7260: 68 65 20 2a 70 43 61 63 68 65 2c 20 69 6e 74 20  he *pCache, int 
7270: 69 64 4a 6f 75 72 6e 61 6c 29 7b 0a 20 20 50 67  idJournal){.  Pg
7280: 48 64 72 20 2a 70 3b 0a 20 20 70 63 61 63 68 65  Hdr *p;.  pcache
7290: 45 6e 74 65 72 4d 75 74 65 78 28 29 3b 20 20 20  EnterMutex();   
72a0: 20 20 2f 2a 20 4d 75 74 65 78 20 69 73 20 72 65    /* Mutex is re
72b0: 71 75 69 72 65 64 20 74 6f 20 63 61 6c 6c 20 70  quired to call p
72c0: 63 61 63 68 65 46 72 65 65 28 29 20 2a 2f 0a 20  cacheFree() */. 
72d0: 20 66 6f 72 28 70 3d 70 43 61 63 68 65 2d 3e 70   for(p=pCache->p
72e0: 44 69 72 74 79 3b 20 70 3b 20 70 3d 70 2d 3e 70  Dirty; p; p=p->p
72f0: 4e 65 78 74 29 7b 0a 20 20 20 20 69 66 28 20 70  Next){.    if( p
7300: 2d 3e 61 70 53 61 76 65 5b 69 64 4a 6f 75 72 6e  ->apSave[idJourn
7310: 61 6c 5d 20 29 7b 0a 20 20 20 20 20 20 70 63 61  al] ){.      pca
7320: 63 68 65 46 72 65 65 28 70 2d 3e 61 70 53 61 76  cheFree(p->apSav
7330: 65 5b 69 64 4a 6f 75 72 6e 61 6c 5d 29 3b 0a 20  e[idJournal]);. 
7340: 20 20 20 20 20 70 2d 3e 61 70 53 61 76 65 5b 69       p->apSave[i
7350: 64 4a 6f 75 72 6e 61 6c 5d 20 3d 20 30 3b 0a 20  dJournal] = 0;. 
7360: 20 20 20 7d 0a 20 20 7d 0a 20 20 70 63 61 63 68     }.  }.  pcach
7370: 65 45 78 69 74 4d 75 74 65 78 28 29 3b 0a 7d 0a  eExitMutex();.}.
7380: 0a 2f 2a 0a 2a 2a 20 52 6f 6c 6c 62 61 63 6b 20  ./*.** Rollback 
7390: 61 20 63 68 61 6e 67 65 20 70 72 65 76 69 6f 75  a change previou
73a0: 73 6c 79 20 70 72 65 73 65 72 76 65 64 2e 0a 2a  sly preserved..*
73b0: 2f 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 50 63  /.void sqlite3Pc
73c0: 61 63 68 65 52 6f 6c 6c 62 61 63 6b 28 50 43 61  acheRollback(PCa
73d0: 63 68 65 20 2a 70 43 61 63 68 65 2c 20 69 6e 74  che *pCache, int
73e0: 20 69 64 4a 6f 75 72 6e 61 6c 29 7b 0a 20 20 50   idJournal){.  P
73f0: 67 48 64 72 20 2a 70 3b 0a 20 20 69 6e 74 20 73  gHdr *p;.  int s
7400: 7a 3b 0a 20 20 70 63 61 63 68 65 45 6e 74 65 72  z;.  pcacheEnter
7410: 4d 75 74 65 78 28 29 3b 20 20 20 20 20 2f 2a 20  Mutex();     /* 
7420: 4d 75 74 65 78 20 69 73 20 72 65 71 75 69 72 65  Mutex is require
7430: 64 20 74 6f 20 63 61 6c 6c 20 70 63 61 63 68 65  d to call pcache
7440: 46 72 65 65 28 29 20 2a 2f 0a 20 20 73 7a 20 3d  Free() */.  sz =
7450: 20 70 43 61 63 68 65 2d 3e 73 7a 50 61 67 65 3b   pCache->szPage;
7460: 0a 20 20 66 6f 72 28 70 3d 70 43 61 63 68 65 2d  .  for(p=pCache-
7470: 3e 70 44 69 72 74 79 3b 20 70 3b 20 70 3d 70 2d  >pDirty; p; p=p-
7480: 3e 70 4e 65 78 74 29 7b 0a 20 20 20 20 69 66 28  >pNext){.    if(
7490: 20 70 2d 3e 61 70 53 61 76 65 5b 69 64 4a 6f 75   p->apSave[idJou
74a0: 72 6e 61 6c 5d 20 29 7b 0a 20 20 20 20 20 20 6d  rnal] ){.      m
74b0: 65 6d 63 70 79 28 70 2d 3e 70 44 61 74 61 2c 20  emcpy(p->pData, 
74c0: 70 2d 3e 61 70 53 61 76 65 5b 69 64 4a 6f 75 72  p->apSave[idJour
74d0: 6e 61 6c 5d 2c 20 73 7a 29 3b 0a 20 20 20 20 20  nal], sz);.     
74e0: 20 70 63 61 63 68 65 46 72 65 65 28 70 2d 3e 61   pcacheFree(p->a
74f0: 70 53 61 76 65 5b 69 64 4a 6f 75 72 6e 61 6c 5d  pSave[idJournal]
7500: 29 3b 0a 20 20 20 20 20 20 70 2d 3e 61 70 53 61  );.      p->apSa
7510: 76 65 5b 69 64 4a 6f 75 72 6e 61 6c 5d 20 3d 20  ve[idJournal] = 
7520: 30 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a 20 20 70  0;.    }.  }.  p
7530: 63 61 63 68 65 45 78 69 74 4d 75 74 65 78 28 29  cacheExitMutex()
7540: 3b 0a 7d 0a 0a 2f 2a 20 0a 2a 2a 20 41 73 73 65  ;.}../* .** Asse
7550: 72 74 20 66 6c 61 67 73 20 73 65 74 74 69 6e 67  rt flags setting
7560: 73 20 6f 6e 20 61 6c 6c 20 70 61 67 65 73 2e 20  s on all pages. 
7570: 20 44 65 62 75 67 67 69 6e 67 20 6f 6e 6c 79 2e   Debugging only.
7580: 0a 2a 2f 0a 76 6f 69 64 20 73 71 6c 69 74 65 33  .*/.void sqlite3
7590: 50 63 61 63 68 65 41 73 73 65 72 74 46 6c 61 67  PcacheAssertFlag
75a0: 73 28 50 43 61 63 68 65 20 2a 70 43 61 63 68 65  s(PCache *pCache
75b0: 2c 20 69 6e 74 20 74 72 75 65 4d 61 73 6b 2c 20  , int trueMask, 
75c0: 69 6e 74 20 66 61 6c 73 65 4d 61 73 6b 29 7b 0a  int falseMask){.
75d0: 20 20 50 67 48 64 72 20 2a 70 3b 0a 20 20 66 6f    PgHdr *p;.  fo
75e0: 72 28 70 3d 70 43 61 63 68 65 2d 3e 70 44 69 72  r(p=pCache->pDir
75f0: 74 79 3b 20 70 3b 20 70 3d 70 2d 3e 70 4e 65 78  ty; p; p=p->pNex
7600: 74 29 7b 0a 20 20 20 20 61 73 73 65 72 74 28 20  t){.    assert( 
7610: 28 70 2d 3e 66 6c 61 67 73 26 74 72 75 65 4d 61  (p->flags&trueMa
7620: 73 6b 29 3d 3d 74 72 75 65 4d 61 73 6b 20 29 3b  sk)==trueMask );
7630: 0a 20 20 20 20 61 73 73 65 72 74 28 20 28 70 2d  .    assert( (p-
7640: 3e 66 6c 61 67 73 26 66 61 6c 73 65 4d 61 73 6b  >flags&falseMask
7650: 29 3d 3d 30 20 29 3b 0a 20 20 7d 0a 20 20 66 6f  )==0 );.  }.  fo
7660: 72 28 70 3d 70 43 61 63 68 65 2d 3e 70 43 6c 65  r(p=pCache->pCle
7670: 61 6e 3b 20 70 3b 20 70 3d 70 2d 3e 70 4e 65 78  an; p; p=p->pNex
7680: 74 29 7b 0a 20 20 20 20 61 73 73 65 72 74 28 20  t){.    assert( 
7690: 28 70 2d 3e 66 6c 61 67 73 26 74 72 75 65 4d 61  (p->flags&trueMa
76a0: 73 6b 29 3d 3d 74 72 75 65 4d 61 73 6b 20 29 3b  sk)==trueMask );
76b0: 0a 20 20 20 20 61 73 73 65 72 74 28 20 28 70 2d  .    assert( (p-
76c0: 3e 66 6c 61 67 73 26 66 61 6c 73 65 4d 61 73 6b  >flags&falseMask
76d0: 29 3d 3d 30 20 29 3b 0a 20 20 7d 0a 7d 0a 0a 2f  )==0 );.  }.}../
76e0: 2a 20 0a 2a 2a 20 44 69 73 63 61 72 64 20 74 68  * .** Discard th
76f0: 65 20 63 6f 6e 74 65 6e 74 73 20 6f 66 20 74 68  e contents of th
7700: 65 20 63 61 63 68 65 2e 0a 2a 2f 0a 69 6e 74 20  e cache..*/.int 
7710: 73 71 6c 69 74 65 33 50 63 61 63 68 65 43 6c 65  sqlite3PcacheCle
7720: 61 72 28 50 43 61 63 68 65 20 2a 70 43 61 63 68  ar(PCache *pCach
7730: 65 29 7b 0a 20 20 61 73 73 65 72 74 28 70 43 61  e){.  assert(pCa
7740: 63 68 65 2d 3e 6e 52 65 66 3d 3d 30 29 3b 0a 20  che->nRef==0);. 
7750: 20 70 63 61 63 68 65 45 6e 74 65 72 4d 75 74 65   pcacheEnterMute
7760: 78 28 29 3b 0a 20 20 70 63 61 63 68 65 43 6c 65  x();.  pcacheCle
7770: 61 72 28 70 43 61 63 68 65 29 3b 0a 20 20 70 63  ar(pCache);.  pc
7780: 61 63 68 65 45 78 69 74 4d 75 74 65 78 28 29 3b  acheExitMutex();
7790: 0a 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45  .  return SQLITE
77a0: 5f 4f 4b 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 4d 65  _OK;.}../*.** Me
77b0: 72 67 65 20 74 77 6f 20 6c 69 73 74 73 20 6f 66  rge two lists of
77c0: 20 70 61 67 65 73 20 63 6f 6e 6e 65 63 74 65 64   pages connected
77d0: 20 62 79 20 70 44 69 72 74 79 20 61 6e 64 20 69   by pDirty and i
77e0: 6e 20 70 67 6e 6f 20 6f 72 64 65 72 2e 0a 2a 2a  n pgno order..**
77f0: 20 44 6f 20 6e 6f 74 20 62 6f 74 68 20 66 69 78   Do not both fix
7800: 69 6e 67 20 74 68 65 20 70 50 72 65 76 44 69 72  ing the pPrevDir
7810: 74 79 20 70 6f 69 6e 74 65 72 73 2e 0a 2a 2f 0a  ty pointers..*/.
7820: 73 74 61 74 69 63 20 50 67 48 64 72 20 2a 70 63  static PgHdr *pc
7830: 61 63 68 65 4d 65 72 67 65 44 69 72 74 79 4c 69  acheMergeDirtyLi
7840: 73 74 28 50 67 48 64 72 20 2a 70 41 2c 20 50 67  st(PgHdr *pA, Pg
7850: 48 64 72 20 2a 70 42 29 7b 0a 20 20 50 67 48 64  Hdr *pB){.  PgHd
7860: 72 20 72 65 73 75 6c 74 2c 20 2a 70 54 61 69 6c  r result, *pTail
7870: 3b 0a 20 20 70 54 61 69 6c 20 3d 20 26 72 65 73  ;.  pTail = &res
7880: 75 6c 74 3b 0a 20 20 77 68 69 6c 65 28 20 70 41  ult;.  while( pA
7890: 20 26 26 20 70 42 20 29 7b 0a 20 20 20 20 69 66   && pB ){.    if
78a0: 28 20 70 41 2d 3e 70 67 6e 6f 3c 70 42 2d 3e 70  ( pA->pgno<pB->p
78b0: 67 6e 6f 20 29 7b 0a 20 20 20 20 20 20 70 54 61  gno ){.      pTa
78c0: 69 6c 2d 3e 70 44 69 72 74 79 20 3d 20 70 41 3b  il->pDirty = pA;
78d0: 0a 20 20 20 20 20 20 70 54 61 69 6c 20 3d 20 70  .      pTail = p
78e0: 41 3b 0a 20 20 20 20 20 20 70 41 20 3d 20 70 41  A;.      pA = pA
78f0: 2d 3e 70 44 69 72 74 79 3b 0a 20 20 20 20 7d 65  ->pDirty;.    }e
7900: 6c 73 65 7b 0a 20 20 20 20 20 20 70 54 61 69 6c  lse{.      pTail
7910: 2d 3e 70 44 69 72 74 79 20 3d 20 70 42 3b 0a 20  ->pDirty = pB;. 
7920: 20 20 20 20 20 70 54 61 69 6c 20 3d 20 70 42 3b       pTail = pB;
7930: 0a 20 20 20 20 20 20 70 42 20 3d 20 70 42 2d 3e  .      pB = pB->
7940: 70 44 69 72 74 79 3b 0a 20 20 20 20 7d 0a 20 20  pDirty;.    }.  
7950: 7d 0a 20 20 69 66 28 20 70 41 20 29 7b 0a 20 20  }.  if( pA ){.  
7960: 20 20 70 54 61 69 6c 2d 3e 70 44 69 72 74 79 20    pTail->pDirty 
7970: 3d 20 70 41 3b 0a 20 20 7d 65 6c 73 65 20 69 66  = pA;.  }else if
7980: 28 20 70 42 20 29 7b 0a 20 20 20 20 70 54 61 69  ( pB ){.    pTai
7990: 6c 2d 3e 70 44 69 72 74 79 20 3d 20 70 42 3b 0a  l->pDirty = pB;.
79a0: 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 70 54 61    }else{.    pTa
79b0: 69 6c 2d 3e 70 44 69 72 74 79 20 3d 20 30 3b 0a  il->pDirty = 0;.
79c0: 20 20 7d 0a 20 20 72 65 74 75 72 6e 20 72 65 73    }.  return res
79d0: 75 6c 74 2e 70 44 69 72 74 79 3b 0a 7d 0a 0a 2f  ult.pDirty;.}../
79e0: 2a 0a 2a 2a 20 53 6f 72 74 20 74 68 65 20 6c 69  *.** Sort the li
79f0: 73 74 20 6f 66 20 70 61 67 65 73 20 69 6e 20 61  st of pages in a
7a00: 63 63 65 6e 64 69 6e 67 20 6f 72 64 65 72 20 62  ccending order b
7a10: 79 20 70 67 6e 6f 2e 20 20 50 61 67 65 73 20 61  y pgno.  Pages a
7a20: 72 65 0a 2a 2a 20 63 6f 6e 6e 65 63 74 65 64 20  re.** connected 
7a30: 62 79 20 70 44 69 72 74 79 20 70 6f 69 6e 74 65  by pDirty pointe
7a40: 72 73 2e 20 20 54 68 65 20 70 50 72 65 76 44 69  rs.  The pPrevDi
7a50: 72 74 79 20 70 6f 69 6e 74 65 72 73 20 61 72 65  rty pointers are
7a60: 0a 2a 2a 20 63 6f 72 72 75 70 74 65 64 20 62 79  .** corrupted by
7a70: 20 74 68 69 73 20 73 6f 72 74 2e 0a 2a 2f 0a 23   this sort..*/.#
7a80: 64 65 66 69 6e 65 20 4e 5f 53 4f 52 54 5f 42 55  define N_SORT_BU
7a90: 43 4b 45 54 5f 41 4c 4c 4f 43 20 32 35 0a 23 64  CKET_ALLOC 25.#d
7aa0: 65 66 69 6e 65 20 4e 5f 53 4f 52 54 5f 42 55 43  efine N_SORT_BUC
7ab0: 4b 45 54 20 20 20 20 20 20 20 32 35 0a 23 69 66  KET       25.#if
7ac0: 64 65 66 20 53 51 4c 49 54 45 5f 54 45 53 54 0a  def SQLITE_TEST.
7ad0: 20 20 69 6e 74 20 73 71 6c 69 74 65 33 5f 70 61    int sqlite3_pa
7ae0: 67 65 72 5f 6e 5f 73 6f 72 74 5f 62 75 63 6b 65  ger_n_sort_bucke
7af0: 74 20 3d 20 30 3b 0a 20 20 23 75 6e 64 65 66 20  t = 0;.  #undef 
7b00: 4e 5f 53 4f 52 54 5f 42 55 43 4b 45 54 0a 20 20  N_SORT_BUCKET.  
7b10: 23 64 65 66 69 6e 65 20 4e 5f 53 4f 52 54 5f 42  #define N_SORT_B
7b20: 55 43 4b 45 54 20 5c 0a 20 20 20 28 73 71 6c 69  UCKET \.   (sqli
7b30: 74 65 33 5f 70 61 67 65 72 5f 6e 5f 73 6f 72 74  te3_pager_n_sort
7b40: 5f 62 75 63 6b 65 74 3f 73 71 6c 69 74 65 33 5f  _bucket?sqlite3_
7b50: 70 61 67 65 72 5f 6e 5f 73 6f 72 74 5f 62 75 63  pager_n_sort_buc
7b60: 6b 65 74 3a 4e 5f 53 4f 52 54 5f 42 55 43 4b 45  ket:N_SORT_BUCKE
7b70: 54 5f 41 4c 4c 4f 43 29 0a 23 65 6e 64 69 66 0a  T_ALLOC).#endif.
7b80: 73 74 61 74 69 63 20 50 67 48 64 72 20 2a 70 63  static PgHdr *pc
7b90: 61 63 68 65 53 6f 72 74 44 69 72 74 79 4c 69 73  acheSortDirtyLis
7ba0: 74 28 50 67 48 64 72 20 2a 70 49 6e 29 7b 0a 20  t(PgHdr *pIn){. 
7bb0: 20 50 67 48 64 72 20 2a 61 5b 4e 5f 53 4f 52 54   PgHdr *a[N_SORT
7bc0: 5f 42 55 43 4b 45 54 5f 41 4c 4c 4f 43 5d 2c 20  _BUCKET_ALLOC], 
7bd0: 2a 70 3b 0a 20 20 69 6e 74 20 69 3b 0a 20 20 6d  *p;.  int i;.  m
7be0: 65 6d 73 65 74 28 61 2c 20 30 2c 20 73 69 7a 65  emset(a, 0, size
7bf0: 6f 66 28 61 29 29 3b 0a 20 20 77 68 69 6c 65 28  of(a));.  while(
7c00: 20 70 49 6e 20 29 7b 0a 20 20 20 20 70 20 3d 20   pIn ){.    p = 
7c10: 70 49 6e 3b 0a 20 20 20 20 70 49 6e 20 3d 20 70  pIn;.    pIn = p
7c20: 2d 3e 70 44 69 72 74 79 3b 0a 20 20 20 20 70 2d  ->pDirty;.    p-
7c30: 3e 70 44 69 72 74 79 20 3d 20 30 3b 0a 20 20 20  >pDirty = 0;.   
7c40: 20 66 6f 72 28 69 3d 30 3b 20 69 3c 4e 5f 53 4f   for(i=0; i<N_SO
7c50: 52 54 5f 42 55 43 4b 45 54 2d 31 3b 20 69 2b 2b  RT_BUCKET-1; i++
7c60: 29 7b 0a 20 20 20 20 20 20 69 66 28 20 61 5b 69  ){.      if( a[i
7c70: 5d 3d 3d 30 20 29 7b 0a 20 20 20 20 20 20 20 20  ]==0 ){.        
7c80: 61 5b 69 5d 20 3d 20 70 3b 0a 20 20 20 20 20 20  a[i] = p;.      
7c90: 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 20 20 7d    break;.      }
7ca0: 65 6c 73 65 7b 0a 20 20 20 20 20 20 20 20 70 20  else{.        p 
7cb0: 3d 20 70 63 61 63 68 65 4d 65 72 67 65 44 69 72  = pcacheMergeDir
7cc0: 74 79 4c 69 73 74 28 61 5b 69 5d 2c 20 70 29 3b  tyList(a[i], p);
7cd0: 0a 20 20 20 20 20 20 20 20 61 5b 69 5d 20 3d 20  .        a[i] = 
7ce0: 30 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 7d  0;.      }.    }
7cf0: 0a 20 20 20 20 69 66 28 20 69 3d 3d 4e 5f 53 4f  .    if( i==N_SO
7d00: 52 54 5f 42 55 43 4b 45 54 2d 31 20 29 7b 0a 20  RT_BUCKET-1 ){. 
7d10: 20 20 20 20 20 2f 2a 20 43 6f 76 65 72 61 67 65       /* Coverage
7d20: 3a 20 54 6f 20 67 65 74 20 68 65 72 65 2c 20 74  : To get here, t
7d30: 68 65 72 65 20 6e 65 65 64 20 74 6f 20 62 65 20  here need to be 
7d40: 32 5e 28 4e 5f 53 4f 52 54 5f 42 55 43 4b 45 54  2^(N_SORT_BUCKET
7d50: 29 20 0a 20 20 20 20 20 20 2a 2a 20 65 6c 65 6d  ) .      ** elem
7d60: 65 6e 74 73 20 69 6e 20 74 68 65 20 69 6e 70 75  ents in the inpu
7d70: 74 20 6c 69 73 74 2e 20 54 68 69 73 20 69 73 20  t list. This is 
7d80: 70 6f 73 73 69 62 6c 65 2c 20 62 75 74 20 69 6d  possible, but im
7d90: 70 72 61 63 74 69 63 61 6c 2e 0a 20 20 20 20 20  practical..     
7da0: 20 2a 2a 20 54 65 73 74 69 6e 67 20 74 68 69 73   ** Testing this
7db0: 20 6c 69 6e 65 20 69 73 20 74 68 65 20 70 6f 69   line is the poi
7dc0: 6e 74 20 6f 66 20 67 6c 6f 62 61 6c 20 76 61 72  nt of global var
7dd0: 69 61 62 6c 65 0a 20 20 20 20 20 20 2a 2a 20 73  iable.      ** s
7de0: 71 6c 69 74 65 33 5f 70 61 67 65 72 5f 6e 5f 73  qlite3_pager_n_s
7df0: 6f 72 74 5f 62 75 63 6b 65 74 2e 0a 20 20 20 20  ort_bucket..    
7e00: 20 20 2a 2f 0a 20 20 20 20 20 20 61 5b 69 5d 20    */.      a[i] 
7e10: 3d 20 70 63 61 63 68 65 4d 65 72 67 65 44 69 72  = pcacheMergeDir
7e20: 74 79 4c 69 73 74 28 61 5b 69 5d 2c 20 70 29 3b  tyList(a[i], p);
7e30: 0a 20 20 20 20 7d 0a 20 20 7d 0a 20 20 70 20 3d  .    }.  }.  p =
7e40: 20 61 5b 30 5d 3b 0a 20 20 66 6f 72 28 69 3d 31   a[0];.  for(i=1
7e50: 3b 20 69 3c 4e 5f 53 4f 52 54 5f 42 55 43 4b 45  ; i<N_SORT_BUCKE
7e60: 54 3b 20 69 2b 2b 29 7b 0a 20 20 20 20 70 20 3d  T; i++){.    p =
7e70: 20 70 63 61 63 68 65 4d 65 72 67 65 44 69 72 74   pcacheMergeDirt
7e80: 79 4c 69 73 74 28 70 2c 20 61 5b 69 5d 29 3b 0a  yList(p, a[i]);.
7e90: 20 20 7d 0a 20 20 72 65 74 75 72 6e 20 70 3b 0a    }.  return p;.
7ea0: 7d 0a 0a 2f 2a 0a 2a 2a 20 52 65 74 75 72 6e 20  }../*.** Return 
7eb0: 61 20 6c 69 73 74 20 6f 66 20 61 6c 6c 20 64 69  a list of all di
7ec0: 72 74 79 20 70 61 67 65 73 20 69 6e 20 74 68 65  rty pages in the
7ed0: 20 63 61 63 68 65 2c 20 73 6f 72 74 65 64 20 62   cache, sorted b
7ee0: 79 20 70 61 67 65 20 6e 75 6d 62 65 72 2e 0a 2a  y page number..*
7ef0: 2f 0a 50 67 48 64 72 20 2a 73 71 6c 69 74 65 33  /.PgHdr *sqlite3
7f00: 50 63 61 63 68 65 44 69 72 74 79 4c 69 73 74 28  PcacheDirtyList(
7f10: 50 43 61 63 68 65 20 2a 70 43 61 63 68 65 29 7b  PCache *pCache){
7f20: 0a 20 20 50 67 48 64 72 20 2a 70 3b 0a 20 20 66  .  PgHdr *p;.  f
7f30: 6f 72 28 70 3d 70 43 61 63 68 65 2d 3e 70 44 69  or(p=pCache->pDi
7f40: 72 74 79 3b 20 70 3b 20 70 3d 70 2d 3e 70 4e 65  rty; p; p=p->pNe
7f50: 78 74 29 7b 0a 20 20 20 20 70 2d 3e 70 44 69 72  xt){.    p->pDir
7f60: 74 79 20 3d 20 70 2d 3e 70 4e 65 78 74 3b 0a 20  ty = p->pNext;. 
7f70: 20 7d 0a 20 20 72 65 74 75 72 6e 20 70 63 61 63   }.  return pcac
7f80: 68 65 53 6f 72 74 44 69 72 74 79 4c 69 73 74 28  heSortDirtyList(
7f90: 70 43 61 63 68 65 2d 3e 70 44 69 72 74 79 29 3b  pCache->pDirty);
7fa0: 0a 7d 0a 0a 2f 2a 20 0a 2a 2a 20 52 65 74 75 72  .}../* .** Retur
7fb0: 6e 20 74 68 65 20 74 6f 74 61 6c 20 6e 75 6d 62  n the total numb
7fc0: 65 72 20 6f 66 20 6f 75 74 73 74 61 6e 64 69 6e  er of outstandin
7fd0: 67 20 70 61 67 65 20 72 65 66 65 72 65 6e 63 65  g page reference
7fe0: 73 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65  s..*/.int sqlite
7ff0: 33 50 63 61 63 68 65 52 65 66 43 6f 75 6e 74 28  3PcacheRefCount(
8000: 50 43 61 63 68 65 20 2a 70 43 61 63 68 65 29 7b  PCache *pCache){
8010: 0a 20 20 72 65 74 75 72 6e 20 70 43 61 63 68 65  .  return pCache
8020: 2d 3e 6e 52 65 66 3b 0a 7d 0a 0a 2f 2a 20 0a 2a  ->nRef;.}../* .*
8030: 2a 20 52 65 74 75 72 6e 20 74 68 65 20 74 6f 74  * Return the tot
8040: 61 6c 20 6e 75 6d 62 65 72 20 6f 66 20 70 61 67  al number of pag
8050: 65 73 20 69 6e 20 74 68 65 20 63 61 63 68 65 2e  es in the cache.
8060: 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 50  .*/.int sqlite3P
8070: 63 61 63 68 65 50 61 67 65 63 6f 75 6e 74 28 50  cachePagecount(P
8080: 43 61 63 68 65 20 2a 70 43 61 63 68 65 29 7b 0a  Cache *pCache){.
8090: 20 20 61 73 73 65 72 74 28 20 70 43 61 63 68 65    assert( pCache
80a0: 2d 3e 6e 50 61 67 65 3e 3d 30 20 29 3b 0a 20 20  ->nPage>=0 );.  
80b0: 72 65 74 75 72 6e 20 70 43 61 63 68 65 2d 3e 6e  return pCache->n
80c0: 50 61 67 65 3b 0a 7d 0a 0a 23 69 66 64 65 66 20  Page;.}..#ifdef 
80d0: 53 51 4c 49 54 45 5f 43 48 45 43 4b 5f 50 41 47  SQLITE_CHECK_PAG
80e0: 45 53 0a 2f 2a 0a 2a 2a 20 54 68 69 73 20 66 75  ES./*.** This fu
80f0: 6e 63 74 69 6f 6e 20 69 73 20 75 73 65 64 20 62  nction is used b
8100: 79 20 74 68 65 20 70 61 67 65 72 2e 63 20 6d 6f  y the pager.c mo
8110: 64 75 6c 65 20 74 6f 20 69 74 65 72 61 74 65 20  dule to iterate 
8120: 74 68 72 6f 75 67 68 20 61 6c 6c 20 0a 2a 2a 20  through all .** 
8130: 70 61 67 65 73 20 69 6e 20 74 68 65 20 63 61 63  pages in the cac
8140: 68 65 2e 20 41 74 20 70 72 65 73 65 6e 74 2c 20  he. At present, 
8150: 74 68 69 73 20 69 73 20 6f 6e 6c 79 20 72 65 71  this is only req
8160: 75 69 72 65 64 20 69 66 20 74 68 65 0a 2a 2a 20  uired if the.** 
8170: 53 51 4c 49 54 45 5f 43 48 45 43 4b 5f 50 41 47  SQLITE_CHECK_PAG
8180: 45 53 20 6d 61 63 72 6f 20 28 75 73 65 64 20 66  ES macro (used f
8190: 6f 72 20 64 65 62 75 67 67 69 6e 67 29 20 69 73  or debugging) is
81a0: 20 73 70 65 63 69 66 69 65 64 2e 0a 2a 2f 0a 76   specified..*/.v
81b0: 6f 69 64 20 73 71 6c 69 74 65 33 50 63 61 63 68  oid sqlite3Pcach
81c0: 65 49 74 65 72 61 74 65 28 50 43 61 63 68 65 20  eIterate(PCache 
81d0: 2a 70 43 61 63 68 65 2c 20 76 6f 69 64 20 28 2a  *pCache, void (*
81e0: 78 49 74 65 72 29 28 50 67 48 64 72 20 2a 29 29  xIter)(PgHdr *))
81f0: 7b 0a 20 20 50 67 48 64 72 20 2a 70 3b 0a 20 20  {.  PgHdr *p;.  
8200: 66 6f 72 28 70 3d 70 43 61 63 68 65 2d 3e 70 43  for(p=pCache->pC
8210: 6c 65 61 6e 3b 20 70 3b 20 70 3d 70 2d 3e 70 4e  lean; p; p=p->pN
8220: 65 78 74 29 7b 0a 20 20 20 20 78 49 74 65 72 28  ext){.    xIter(
8230: 70 29 3b 0a 20 20 7d 0a 20 20 66 6f 72 28 70 3d  p);.  }.  for(p=
8240: 70 43 61 63 68 65 2d 3e 70 44 69 72 74 79 3b 20  pCache->pDirty; 
8250: 70 3b 20 70 3d 70 2d 3e 70 4e 65 78 74 29 7b 0a  p; p=p->pNext){.
8260: 20 20 20 20 78 49 74 65 72 28 70 29 3b 0a 20 20      xIter(p);.  
8270: 7d 0a 7d 0a 23 65 6e 64 69 66 0a 0a 2f 2a 20 0a  }.}.#endif../* .
8280: 2a 2a 20 53 65 74 20 66 6c 61 67 73 20 6f 6e 20  ** Set flags on 
8290: 61 6c 6c 20 70 61 67 65 73 20 69 6e 20 74 68 65  all pages in the
82a0: 20 70 61 67 65 20 63 61 63 68 65 20 0a 2a 2f 0a   page cache .*/.
82b0: 76 6f 69 64 20 73 71 6c 69 74 65 33 50 63 61 63  void sqlite3Pcac
82c0: 68 65 53 65 74 46 6c 61 67 73 28 50 43 61 63 68  heSetFlags(PCach
82d0: 65 20 2a 70 43 61 63 68 65 2c 20 69 6e 74 20 61  e *pCache, int a
82e0: 6e 64 4d 61 73 6b 2c 20 69 6e 74 20 6f 72 4d 61  ndMask, int orMa
82f0: 73 6b 29 7b 0a 20 20 50 67 48 64 72 20 2a 70 3b  sk){.  PgHdr *p;
8300: 0a 0a 20 20 61 73 73 65 72 74 28 20 28 6f 72 4d  ..  assert( (orM
8310: 61 73 6b 26 50 47 48 44 52 5f 4e 45 45 44 5f 53  ask&PGHDR_NEED_S
8320: 59 4e 43 29 3d 3d 30 20 29 3b 0a 0a 20 20 2f 2a  YNC)==0 );..  /*
8330: 20 4f 62 74 61 69 6e 20 74 68 65 20 67 6c 6f 62   Obtain the glob
8340: 61 6c 20 6d 75 74 65 78 20 62 65 66 6f 72 65 20  al mutex before 
8350: 6d 6f 64 69 66 79 69 6e 67 20 61 6e 79 20 50 67  modifying any Pg
8360: 48 64 72 2e 66 6c 61 67 73 20 76 61 72 69 61 62  Hdr.flags variab
8370: 6c 65 73 20 0a 20 20 2a 2a 20 6f 72 20 74 72 61  les .  ** or tra
8380: 76 65 72 73 69 6e 67 20 74 68 65 20 4c 52 55 20  versing the LRU 
8390: 6c 69 73 74 2e 0a 20 20 2a 2f 20 0a 20 20 70 63  list..  */ .  pc
83a0: 61 63 68 65 45 6e 74 65 72 4d 75 74 65 78 28 29  acheEnterMutex()
83b0: 3b 0a 0a 20 20 66 6f 72 28 70 3d 70 43 61 63 68  ;..  for(p=pCach
83c0: 65 2d 3e 70 44 69 72 74 79 3b 20 70 3b 20 70 3d  e->pDirty; p; p=
83d0: 70 2d 3e 70 4e 65 78 74 29 7b 0a 20 20 20 20 70  p->pNext){.    p
83e0: 2d 3e 66 6c 61 67 73 20 3d 20 28 70 2d 3e 66 6c  ->flags = (p->fl
83f0: 61 67 73 26 61 6e 64 4d 61 73 6b 29 7c 6f 72 4d  ags&andMask)|orM
8400: 61 73 6b 3b 0a 20 20 7d 0a 20 20 66 6f 72 28 70  ask;.  }.  for(p
8410: 3d 70 43 61 63 68 65 2d 3e 70 43 6c 65 61 6e 3b  =pCache->pClean;
8420: 20 70 3b 20 70 3d 70 2d 3e 70 4e 65 78 74 29 7b   p; p=p->pNext){
8430: 0a 20 20 20 20 70 2d 3e 66 6c 61 67 73 20 3d 20  .    p->flags = 
8440: 28 70 2d 3e 66 6c 61 67 73 26 61 6e 64 4d 61 73  (p->flags&andMas
8450: 6b 29 7c 6f 72 4d 61 73 6b 3b 0a 20 20 7d 0a 0a  k)|orMask;.  }..
8460: 20 20 69 66 28 20 30 3d 3d 28 61 6e 64 4d 61 73    if( 0==(andMas
8470: 6b 26 50 47 48 44 52 5f 4e 45 45 44 5f 53 59 4e  k&PGHDR_NEED_SYN
8480: 43 29 20 29 7b 0a 20 20 20 20 70 43 61 63 68 65  C) ){.    pCache
8490: 2d 3e 70 53 79 6e 63 65 64 20 3d 20 70 43 61 63  ->pSynced = pCac
84a0: 68 65 2d 3e 70 44 69 72 74 79 54 61 69 6c 3b 0a  he->pDirtyTail;.
84b0: 20 20 20 20 61 73 73 65 72 74 28 20 21 70 43 61      assert( !pCa
84c0: 63 68 65 2d 3e 70 53 79 6e 63 65 64 20 7c 7c 20  che->pSynced || 
84d0: 28 70 43 61 63 68 65 2d 3e 70 53 79 6e 63 65 64  (pCache->pSynced
84e0: 2d 3e 66 6c 61 67 73 26 50 47 48 44 52 5f 4e 45  ->flags&PGHDR_NE
84f0: 45 44 5f 53 59 4e 43 29 3d 3d 30 20 29 3b 0a 20  ED_SYNC)==0 );. 
8500: 20 7d 0a 0a 20 20 70 63 61 63 68 65 45 78 69 74   }..  pcacheExit
8510: 4d 75 74 65 78 28 29 3b 0a 7d 0a 0a 2f 2a 0a 2a  Mutex();.}../*.*
8520: 2a 20 53 65 74 20 74 68 65 20 73 75 67 67 65 73  * Set the sugges
8530: 74 65 64 20 63 61 63 68 65 2d 73 69 7a 65 20 76  ted cache-size v
8540: 61 6c 75 65 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c  alue..*/.int sql
8550: 69 74 65 33 50 63 61 63 68 65 47 65 74 43 61 63  ite3PcacheGetCac
8560: 68 65 73 69 7a 65 28 50 43 61 63 68 65 20 2a 70  hesize(PCache *p
8570: 43 61 63 68 65 29 7b 0a 20 20 72 65 74 75 72 6e  Cache){.  return
8580: 20 70 43 61 63 68 65 2d 3e 6e 4d 61 78 3b 0a 7d   pCache->nMax;.}
8590: 0a 0a 2f 2a 0a 2a 2a 20 53 65 74 20 74 68 65 20  ../*.** Set the 
85a0: 73 75 67 67 65 73 74 65 64 20 63 61 63 68 65 2d  suggested cache-
85b0: 73 69 7a 65 20 76 61 6c 75 65 2e 0a 2a 2f 0a 76  size value..*/.v
85c0: 6f 69 64 20 73 71 6c 69 74 65 33 50 63 61 63 68  oid sqlite3Pcach
85d0: 65 53 65 74 43 61 63 68 65 73 69 7a 65 28 50 43  eSetCachesize(PC
85e0: 61 63 68 65 20 2a 70 43 61 63 68 65 2c 20 69 6e  ache *pCache, in
85f0: 74 20 6d 78 50 61 67 65 29 7b 0a 20 20 69 66 28  t mxPage){.  if(
8600: 20 6d 78 50 61 67 65 3c 31 30 20 29 7b 0a 20 20   mxPage<10 ){.  
8610: 20 20 6d 78 50 61 67 65 20 3d 20 31 30 3b 0a 20    mxPage = 10;. 
8620: 20 7d 0a 20 20 69 66 28 20 70 43 61 63 68 65 2d   }.  if( pCache-
8630: 3e 62 50 75 72 67 65 61 62 6c 65 20 29 7b 0a 20  >bPurgeable ){. 
8640: 20 20 20 70 63 61 63 68 65 45 6e 74 65 72 4d 75     pcacheEnterMu
8650: 74 65 78 28 29 3b 0a 20 20 20 20 70 63 61 63 68  tex();.    pcach
8660: 65 5f 67 2e 6e 4d 61 78 50 61 67 65 20 2d 3d 20  e_g.nMaxPage -= 
8670: 70 43 61 63 68 65 2d 3e 6e 4d 61 78 3b 0a 20 20  pCache->nMax;.  
8680: 20 20 70 63 61 63 68 65 5f 67 2e 6e 4d 61 78 50    pcache_g.nMaxP
8690: 61 67 65 20 2b 3d 20 6d 78 50 61 67 65 3b 0a 20  age += mxPage;. 
86a0: 20 20 20 70 63 61 63 68 65 45 6e 66 6f 72 63 65     pcacheEnforce
86b0: 4d 61 78 50 61 67 65 28 29 3b 0a 20 20 20 20 70  MaxPage();.    p
86c0: 63 61 63 68 65 45 78 69 74 4d 75 74 65 78 28 29  cacheExitMutex()
86d0: 3b 0a 20 20 7d 0a 20 20 70 43 61 63 68 65 2d 3e  ;.  }.  pCache->
86e0: 6e 4d 61 78 20 3d 20 6d 78 50 61 67 65 3b 0a 7d  nMax = mxPage;.}
86f0: 0a 0a 23 69 66 64 65 66 20 53 51 4c 49 54 45 5f  ..#ifdef SQLITE_
8700: 45 4e 41 42 4c 45 5f 4d 45 4d 4f 52 59 5f 4d 41  ENABLE_MEMORY_MA
8710: 4e 41 47 45 4d 45 4e 54 0a 2f 2a 0a 2a 2a 20 54  NAGEMENT./*.** T
8720: 68 69 73 20 66 75 6e 63 74 69 6f 6e 20 69 73 20  his function is 
8730: 63 61 6c 6c 65 64 20 74 6f 20 66 72 65 65 20 73  called to free s
8740: 75 70 65 72 66 6c 75 6f 75 73 20 64 79 6e 61 6d  uperfluous dynam
8750: 69 63 61 6c 6c 79 20 61 6c 6c 6f 63 61 74 65 64  ically allocated
8760: 20 6d 65 6d 6f 72 79 0a 2a 2a 20 68 65 6c 64 20   memory.** held 
8770: 62 79 20 74 68 65 20 70 61 67 65 72 20 73 79 73  by the pager sys
8780: 74 65 6d 2e 20 4d 65 6d 6f 72 79 20 69 6e 20 75  tem. Memory in u
8790: 73 65 20 62 79 20 61 6e 79 20 53 51 4c 69 74 65  se by any SQLite
87a0: 20 70 61 67 65 72 20 61 6c 6c 6f 63 61 74 65 64   pager allocated
87b0: 0a 2a 2a 20 62 79 20 74 68 65 20 63 75 72 72 65  .** by the curre
87c0: 6e 74 20 74 68 72 65 61 64 20 6d 61 79 20 62 65  nt thread may be
87d0: 20 73 71 6c 69 74 65 33 5f 66 72 65 65 28 29 65   sqlite3_free()e
87e0: 64 2e 0a 2a 2a 0a 2a 2a 20 6e 52 65 71 20 69 73  d..**.** nReq is
87f0: 20 74 68 65 20 6e 75 6d 62 65 72 20 6f 66 20 62   the number of b
8800: 79 74 65 73 20 6f 66 20 6d 65 6d 6f 72 79 20 72  ytes of memory r
8810: 65 71 75 69 72 65 64 2e 20 4f 6e 63 65 20 74 68  equired. Once th
8820: 69 73 20 6d 75 63 68 20 68 61 73 0a 2a 2a 20 62  is much has.** b
8830: 65 65 6e 20 72 65 6c 65 61 73 65 64 2c 20 74 68  een released, th
8840: 65 20 66 75 6e 63 74 69 6f 6e 20 72 65 74 75 72  e function retur
8850: 6e 73 2e 20 54 68 65 20 72 65 74 75 72 6e 20 76  ns. The return v
8860: 61 6c 75 65 20 69 73 20 74 68 65 20 74 6f 74 61  alue is the tota
8870: 6c 20 6e 75 6d 62 65 72 20 0a 2a 2a 20 6f 66 20  l number .** of 
8880: 62 79 74 65 73 20 6f 66 20 6d 65 6d 6f 72 79 20  bytes of memory 
8890: 72 65 6c 65 61 73 65 64 2e 0a 2a 2f 0a 69 6e 74  released..*/.int
88a0: 20 73 71 6c 69 74 65 33 50 63 61 63 68 65 52 65   sqlite3PcacheRe
88b0: 6c 65 61 73 65 4d 65 6d 6f 72 79 28 69 6e 74 20  leaseMemory(int 
88c0: 6e 52 65 71 29 7b 0a 20 20 69 6e 74 20 6e 46 72  nReq){.  int nFr
88d0: 65 65 20 3d 20 30 3b 0a 20 20 69 66 28 20 70 63  ee = 0;.  if( pc
88e0: 61 63 68 65 5f 67 2e 70 53 74 61 72 74 3d 3d 30  ache_g.pStart==0
88f0: 20 29 7b 0a 20 20 20 20 50 67 48 64 72 20 2a 70   ){.    PgHdr *p
8900: 3b 0a 20 20 20 20 70 63 61 63 68 65 45 6e 74 65  ;.    pcacheEnte
8910: 72 4d 75 74 65 78 28 29 3b 0a 20 20 20 20 77 68  rMutex();.    wh
8920: 69 6c 65 28 20 28 6e 52 65 71 3c 30 20 7c 7c 20  ile( (nReq<0 || 
8930: 6e 46 72 65 65 3c 6e 52 65 71 29 20 26 26 20 28  nFree<nReq) && (
8940: 70 3d 70 63 61 63 68 65 52 65 63 79 63 6c 65 50  p=pcacheRecycleP
8950: 61 67 65 28 29 29 20 29 7b 0a 20 20 20 20 20 20  age()) ){.      
8960: 6e 46 72 65 65 20 2b 3d 20 70 63 61 63 68 65 50  nFree += pcacheP
8970: 61 67 65 53 69 7a 65 28 70 29 3b 0a 20 20 20 20  ageSize(p);.    
8980: 20 20 70 63 61 63 68 65 50 61 67 65 46 72 65 65    pcachePageFree
8990: 28 70 29 3b 0a 20 20 20 20 7d 0a 20 20 20 20 70  (p);.    }.    p
89a0: 63 61 63 68 65 45 78 69 74 4d 75 74 65 78 28 29  cacheExitMutex()
89b0: 3b 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e 20 6e  ;.  }.  return n
89c0: 46 72 65 65 3b 0a 7d 0a 23 65 6e 64 69 66 20 2f  Free;.}.#endif /
89d0: 2a 20 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45 5f  * SQLITE_ENABLE_
89e0: 4d 45 4d 4f 52 59 5f 4d 41 4e 41 47 45 4d 45 4e  MEMORY_MANAGEMEN
89f0: 54 20 2a 2f 0a 0a 23 69 66 64 65 66 20 53 51 4c  T */..#ifdef SQL
8a00: 49 54 45 5f 54 45 53 54 0a 76 6f 69 64 20 73 71  ITE_TEST.void sq
8a10: 6c 69 74 65 33 50 63 61 63 68 65 53 74 61 74 73  lite3PcacheStats
8a20: 28 0a 20 20 69 6e 74 20 2a 70 6e 43 75 72 72 65  (.  int *pnCurre
8a30: 6e 74 2c 0a 20 20 69 6e 74 20 2a 70 6e 4d 61 78  nt,.  int *pnMax
8a40: 2c 0a 20 20 69 6e 74 20 2a 70 6e 4d 69 6e 2c 0a  ,.  int *pnMin,.
8a50: 20 20 69 6e 74 20 2a 70 6e 52 65 63 79 63 6c 61    int *pnRecycla
8a60: 62 6c 65 0a 29 7b 0a 20 20 50 67 48 64 72 20 2a  ble.){.  PgHdr *
8a70: 70 3b 0a 20 20 69 6e 74 20 6e 52 65 63 79 63 6c  p;.  int nRecycl
8a80: 61 62 6c 65 20 3d 20 30 3b 0a 20 20 66 6f 72 28  able = 0;.  for(
8a90: 70 3d 70 63 61 63 68 65 5f 67 2e 70 4c 72 75 48  p=pcache_g.pLruH
8aa0: 65 61 64 3b 20 70 3b 20 70 3d 70 2d 3e 70 4e 65  ead; p; p=p->pNe
8ab0: 78 74 4c 72 75 29 7b 0a 20 20 20 20 6e 52 65 63  xtLru){.    nRec
8ac0: 79 63 6c 61 62 6c 65 2b 2b 3b 0a 20 20 7d 0a 0a  yclable++;.  }..
8ad0: 20 20 2a 70 6e 43 75 72 72 65 6e 74 20 3d 20 70    *pnCurrent = p
8ae0: 63 61 63 68 65 5f 67 2e 6e 43 75 72 72 65 6e 74  cache_g.nCurrent
8af0: 50 61 67 65 3b 0a 20 20 2a 70 6e 4d 61 78 20 3d  Page;.  *pnMax =
8b00: 20 70 63 61 63 68 65 5f 67 2e 6e 4d 61 78 50 61   pcache_g.nMaxPa
8b10: 67 65 3b 0a 20 20 2a 70 6e 4d 69 6e 20 3d 20 70  ge;.  *pnMin = p
8b20: 63 61 63 68 65 5f 67 2e 6e 4d 69 6e 50 61 67 65  cache_g.nMinPage
8b30: 3b 0a 20 20 2a 70 6e 52 65 63 79 63 6c 61 62 6c  ;.  *pnRecyclabl
8b40: 65 20 3d 20 6e 52 65 63 79 63 6c 61 62 6c 65 3b  e = nRecyclable;
8b50: 0a 7d 0a 23 65 6e 64 69 66 0a 0a                 .}.#endif..